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 20 20 63 68 61 dex key */. cha
6720: 72 20 61 53 70 61 63 65 5b 33 38 34 5d 3b 20 20 r aSpace[384];
6730: 20 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 /* Temp
6740: 73 70 61 63 65 20 66 6f 72 20 70 49 64 78 4b 65 space for pIdxKe
6750: 79 20 2d 20 74 6f 20 61 76 6f 69 64 20 61 20 6d y - to avoid a m
6760: 61 6c 6c 6f 63 20 2a 2f 0a 20 20 63 68 61 72 20 alloc */. char
6770: 2a 70 46 72 65 65 20 3d 20 30 3b 0a 0a 20 20 69 *pFree = 0;.. i
6780: 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 61 f( pKey ){. a
6790: 73 73 65 72 74 28 20 6e 4b 65 79 3d 3d 28 69 36 ssert( nKey==(i6
67a0: 34 29 28 69 6e 74 29 6e 4b 65 79 20 29 3b 0a 20 4)(int)nKey );.
67b0: 20 20 20 70 49 64 78 4b 65 79 20 3d 20 73 71 6c pIdxKey = sql
67c0: 69 74 65 33 56 64 62 65 41 6c 6c 6f 63 55 6e 70 ite3VdbeAllocUnp
67d0: 61 63 6b 65 64 52 65 63 6f 72 64 28 0a 20 20 20 ackedRecord(.
67e0: 20 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 pCur->pKeyI
67f0: 6e 66 6f 2c 20 61 53 70 61 63 65 2c 20 73 69 7a nfo, aSpace, siz
6800: 65 6f 66 28 61 53 70 61 63 65 29 2c 20 26 70 46 eof(aSpace), &pF
6810: 72 65 65 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 ree. );. i
6820: 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 20 29 20 f( pIdxKey==0 )
6830: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
6840: 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 73 71 MEM_BKPT;. sq
6850: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 55 lite3VdbeRecordU
6860: 6e 70 61 63 6b 28 70 43 75 72 2d 3e 70 4b 65 79 npack(pCur->pKey
6870: 49 6e 66 6f 2c 20 28 69 6e 74 29 6e 4b 65 79 2c Info, (int)nKey,
6880: 20 70 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 3b pKey, pIdxKey);
6890: 0a 20 20 20 20 69 66 28 20 70 49 64 78 4b 65 79 . if( pIdxKey
68a0: 2d 3e 6e 46 69 65 6c 64 3d 3d 30 20 29 7b 0a 20 ->nField==0 ){.
68b0: 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 sqlite3DbFr
68c0: 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 ee(pCur->pKeyInf
68d0: 6f 2d 3e 64 62 2c 20 70 46 72 65 65 29 3b 0a 20 o->db, pFree);.
68e0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
68f0: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
6900: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a . }. }else{.
6910: 20 20 20 20 70 49 64 78 4b 65 79 20 3d 20 30 3b pIdxKey = 0;
6920: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
6930: 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e te3BtreeMovetoUn
6940: 70 61 63 6b 65 64 28 70 43 75 72 2c 20 70 49 64 packed(pCur, pId
6950: 78 4b 65 79 2c 20 6e 4b 65 79 2c 20 62 69 61 73 xKey, nKey, bias
6960: 2c 20 70 52 65 73 29 3b 0a 20 20 69 66 28 20 70 , pRes);. if( p
6970: 46 72 65 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 Free ){. sqli
6980: 74 65 33 44 62 46 72 65 65 28 70 43 75 72 2d 3e te3DbFree(pCur->
6990: 70 4b 65 79 49 6e 66 6f 2d 3e 64 62 2c 20 70 46 pKeyInfo->db, pF
69a0: 72 65 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 ree);. }. retu
69b0: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
69c0: 52 65 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 Restore the curs
69d0: 6f 72 20 74 6f 20 74 68 65 20 70 6f 73 69 74 69 or to the positi
69e0: 6f 6e 20 69 74 20 77 61 73 20 69 6e 20 28 6f 72 on it was in (or
69f0: 20 61 73 20 63 6c 6f 73 65 20 74 6f 20 61 73 20 as close to as
6a00: 70 6f 73 73 69 62 6c 65 29 0a 2a 2a 20 77 68 65 possible).** whe
6a10: 6e 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 n saveCursorPosi
6a20: 74 69 6f 6e 28 29 20 77 61 73 20 63 61 6c 6c 65 tion() was calle
6a30: 64 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 d. Note that thi
6a40: 73 20 63 61 6c 6c 20 64 65 6c 65 74 65 73 20 74 s call deletes t
6a50: 68 65 20 0a 2a 2a 20 73 61 76 65 64 20 70 6f 73 he .** saved pos
6a60: 69 74 69 6f 6e 20 69 6e 66 6f 20 73 74 6f 72 65 ition info store
6a70: 64 20 62 79 20 73 61 76 65 43 75 72 73 6f 72 50 d by saveCursorP
6a80: 6f 73 69 74 69 6f 6e 28 29 2c 20 73 6f 20 74 68 osition(), so th
6a90: 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 61 74 ere can be.** at
6aa0: 20 6d 6f 73 74 20 6f 6e 65 20 65 66 66 65 63 74 most one effect
6ab0: 69 76 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f ive restoreCurso
6ac0: 72 50 6f 73 69 74 69 6f 6e 28 29 20 63 61 6c 6c rPosition() call
6ad0: 20 61 66 74 65 72 20 65 61 63 68 20 0a 2a 2a 20 after each .**
6ae0: 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 saveCursorPositi
6af0: 6f 6e 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 on()..*/.static
6b00: 69 6e 74 20 62 74 72 65 65 52 65 73 74 6f 72 65 int btreeRestore
6b10: 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 42 CursorPosition(B
6b20: 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
6b30: 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
6b40: 73 6b 69 70 4e 65 78 74 3b 0a 20 20 61 73 73 65 skipNext;. asse
6b50: 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 rt( cursorOwnsBt
6b60: 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a Shared(pCur) );.
6b70: 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
6b80: 65 53 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 eState>=CURSOR_R
6b90: 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
6ba0: 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
6bb0: 3d 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 ==CURSOR_FAULT )
6bc0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 70 43 75 {. return pCu
6bd0: 72 2d 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 20 7d r->skipNext;. }
6be0: 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 . pCur->eState
6bf0: 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
6c00: 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 4d 6f ;. rc = btreeMo
6c10: 76 65 74 6f 28 70 43 75 72 2c 20 70 43 75 72 2d veto(pCur, pCur-
6c20: 3e 70 4b 65 79 2c 20 70 43 75 72 2d 3e 6e 4b 65 >pKey, pCur->nKe
6c30: 79 2c 20 30 2c 20 26 73 6b 69 70 4e 65 78 74 29 y, 0, &skipNext)
6c40: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
6c50: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
6c60: 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e ite3_free(pCur->
6c70: 70 4b 65 79 29 3b 0a 20 20 20 20 70 43 75 72 2d pKey);. pCur-
6c80: 3e 70 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 61 >pKey = 0;. a
6c90: 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
6ca0: 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
6cb0: 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 D || pCur->eStat
6cc0: 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 e==CURSOR_INVALI
6cd0: 44 20 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 73 D );. pCur->s
6ce0: 6b 69 70 4e 65 78 74 20 7c 3d 20 73 6b 69 70 4e kipNext |= skipN
6cf0: 65 78 74 3b 0a 20 20 20 20 69 66 28 20 70 43 75 ext;. if( pCu
6d00: 72 2d 3e 73 6b 69 70 4e 65 78 74 20 26 26 20 70 r->skipNext && p
6d10: 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
6d20: 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 SOR_VALID ){.
6d30: 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
6d40: 3d 20 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 = CURSOR_SKIPNEX
6d50: 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 T;. }. }. r
6d60: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 64 65 eturn rc;.}..#de
6d70: 66 69 6e 65 20 72 65 73 74 6f 72 65 43 75 72 73 fine restoreCurs
6d80: 6f 72 50 6f 73 69 74 69 6f 6e 28 70 29 20 5c 0a orPosition(p) \.
6d90: 20 20 28 70 2d 3e 65 53 74 61 74 65 3e 3d 43 55 (p->eState>=CU
6da0: 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
6db0: 20 3f 20 5c 0a 20 20 20 20 20 20 20 20 20 62 74 ? \. bt
6dc0: 72 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 reeRestoreCursor
6dd0: 50 6f 73 69 74 69 6f 6e 28 70 29 20 3a 20 5c 0a Position(p) : \.
6de0: 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f SQLITE_
6df0: 4f 4b 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 OK)../*.** Deter
6e00: 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 mine whether or
6e10: 6e 6f 74 20 61 20 63 75 72 73 6f 72 20 68 61 73 not a cursor has
6e20: 20 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 moved from the
6e30: 70 6f 73 69 74 69 6f 6e 20 77 68 65 72 65 0a 2a position where.*
6e40: 2a 20 69 74 20 77 61 73 20 6c 61 73 74 20 70 6c * it was last pl
6e50: 61 63 65 64 2c 20 6f 72 20 68 61 73 20 62 65 65 aced, or has bee
6e60: 6e 20 69 6e 76 61 6c 69 64 61 74 65 64 20 66 6f n invalidated fo
6e70: 72 20 61 6e 79 20 6f 74 68 65 72 20 72 65 61 73 r any other reas
6e80: 6f 6e 2e 0a 2a 2a 20 43 75 72 73 6f 72 73 20 63 on..** Cursors c
6e90: 61 6e 20 6d 6f 76 65 20 77 68 65 6e 20 74 68 65 an move when the
6ea0: 20 72 6f 77 20 74 68 65 79 20 61 72 65 20 70 6f row they are po
6eb0: 69 6e 74 69 6e 67 20 61 74 20 69 73 20 64 65 6c inting at is del
6ec0: 65 74 65 64 20 6f 75 74 0a 2a 2a 20 66 72 6f 6d eted out.** from
6ed0: 20 75 6e 64 65 72 20 74 68 65 6d 2c 20 66 6f 72 under them, for
6ee0: 20 65 78 61 6d 70 6c 65 2e 20 20 43 75 72 73 6f example. Curso
6ef0: 72 20 6d 69 67 68 74 20 61 6c 73 6f 20 6d 6f 76 r might also mov
6f00: 65 20 69 66 20 61 20 62 74 72 65 65 0a 2a 2a 20 e if a btree.**
6f10: 69 73 20 72 65 62 61 6c 61 6e 63 65 64 2e 0a 2a is rebalanced..*
6f20: 2a 0a 2a 2a 20 43 61 6c 6c 69 6e 67 20 74 68 69 *.** Calling thi
6f30: 73 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 61 s routine with a
6f40: 20 4e 55 4c 4c 20 63 75 72 73 6f 72 20 70 6f 69 NULL cursor poi
6f50: 6e 74 65 72 20 72 65 74 75 72 6e 73 20 66 61 6c nter returns fal
6f60: 73 65 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 se..**.** Use th
6f70: 65 20 73 65 70 61 72 61 74 65 20 73 71 6c 69 74 e separate sqlit
6f80: 65 33 42 74 72 65 65 43 75 72 73 6f 72 52 65 73 e3BtreeCursorRes
6f90: 74 6f 72 65 28 29 20 72 6f 75 74 69 6e 65 20 74 tore() routine t
6fa0: 6f 20 72 65 73 74 6f 72 65 20 61 20 63 75 72 73 o restore a curs
6fb0: 6f 72 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 77 68 or.** back to wh
6fc0: 65 72 65 20 69 74 20 6f 75 67 68 74 20 74 6f 20 ere it ought to
6fd0: 62 65 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 be if this routi
6fe0: 6e 65 20 72 65 74 75 72 6e 73 20 74 72 75 65 2e ne returns true.
6ff0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
7000: 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 6f 76 treeCursorHasMov
7010: 65 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ed(BtCursor *pCu
7020: 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 r){. return pCu
7030: 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
7040: 52 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a R_VALID;.}../*.*
7050: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 * This routine r
7060: 65 73 74 6f 72 65 73 20 61 20 63 75 72 73 6f 72 estores a cursor
7070: 20 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 back to its ori
7080: 67 69 6e 61 6c 20 70 6f 73 69 74 69 6f 6e 20 61 ginal position a
7090: 66 74 65 72 20 69 74 0a 2a 2a 20 68 61 73 20 62 fter it.** has b
70a0: 65 65 6e 20 6d 6f 76 65 64 20 62 79 20 73 6f 6d een moved by som
70b0: 65 20 6f 75 74 73 69 64 65 20 61 63 74 69 76 69 e outside activi
70c0: 74 79 20 28 73 75 63 68 20 61 73 20 61 20 62 74 ty (such as a bt
70d0: 72 65 65 20 72 65 62 61 6c 61 6e 63 65 20 6f 72 ree rebalance or
70e0: 0a 2a 2a 20 61 20 72 6f 77 20 68 61 76 69 6e 67 .** a row having
70f0: 20 62 65 65 6e 20 64 65 6c 65 74 65 64 20 6f 75 been deleted ou
7100: 74 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 t from under the
7110: 20 63 75 72 73 6f 72 29 2e 20 20 0a 2a 2a 0a 2a cursor). .**.*
7120: 2a 20 4f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 * On success, th
7130: 65 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 e *pDifferentRow
7140: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 66 61 parameter is fa
7150: 6c 73 65 20 69 66 20 74 68 65 20 63 75 72 73 6f lse if the curso
7160: 72 20 69 73 20 6c 65 66 74 0a 2a 2a 20 70 6f 69 r is left.** poi
7170: 6e 74 69 6e 67 20 61 74 20 65 78 61 63 74 6c 79 nting at exactly
7180: 20 74 68 65 20 73 61 6d 65 20 72 6f 77 2e 20 20 the same row.
7190: 2a 70 44 69 66 66 65 72 6e 74 52 6f 77 20 69 73 *pDifferntRow is
71a0: 20 74 68 65 20 72 6f 77 20 74 68 65 20 63 75 72 the row the cur
71b0: 73 6f 72 0a 2a 2a 20 77 61 73 20 70 6f 69 6e 74 sor.** was point
71c0: 69 6e 67 20 74 6f 20 68 61 73 20 62 65 65 6e 20 ing to has been
71d0: 64 65 6c 65 74 65 64 2c 20 66 6f 72 63 69 6e 67 deleted, forcing
71e0: 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 the cursor to p
71f0: 6f 69 6e 74 20 74 6f 20 73 6f 6d 65 0a 2a 2a 20 oint to some.**
7200: 6e 65 61 72 62 79 20 72 6f 77 2e 0a 2a 2a 0a 2a nearby row..**.*
7210: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 * This routine s
7220: 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 hould only be ca
7230: 6c 6c 65 64 20 66 6f 72 20 61 20 63 75 72 73 6f lled for a curso
7240: 72 20 74 68 61 74 20 6a 75 73 74 20 72 65 74 75 r that just retu
7250: 72 6e 65 64 0a 2a 2a 20 54 52 55 45 20 66 72 6f rned.** TRUE fro
7260: 6d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 m sqlite3BtreeCu
7270: 72 73 6f 72 48 61 73 4d 6f 76 65 64 28 29 2e 0a rsorHasMoved()..
7280: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
7290: 72 65 65 43 75 72 73 6f 72 52 65 73 74 6f 72 65 reeCursorRestore
72a0: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
72b0: 20 69 6e 74 20 2a 70 44 69 66 66 65 72 65 6e 74 int *pDifferent
72c0: 52 6f 77 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Row){. int rc;.
72d0: 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 21 . assert( pCur!
72e0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
72f0: 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
7300: 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
7310: 72 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 rc = restoreCurs
7320: 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 orPosition(pCur)
7330: 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
7340: 20 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 *pDifferentRow
7350: 20 3d 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e = 1;. return
7360: 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 rc;. }. if( p
7370: 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
7380: 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 SOR_VALID ){.
7390: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
73a0: 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 = 1;. }else{.
73b0: 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
73c0: 73 6b 69 70 4e 65 78 74 3d 3d 30 20 29 3b 0a 20 skipNext==0 );.
73d0: 20 20 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f *pDifferentRo
73e0: 77 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 w = 0;. }. ret
73f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
7400: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
7410: 45 4e 41 42 4c 45 5f 43 55 52 53 4f 52 5f 48 49 ENABLE_CURSOR_HI
7420: 4e 54 53 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 NTS./*.** Provid
7430: 65 20 68 69 6e 74 73 20 74 6f 20 74 68 65 20 63 e hints to the c
7440: 75 72 73 6f 72 2e 20 20 54 68 65 20 70 61 72 74 ursor. The part
7450: 69 63 75 6c 61 72 20 68 69 6e 74 20 67 69 76 65 icular hint give
7460: 6e 20 28 61 6e 64 20 74 68 65 20 74 79 70 65 0a n (and the type.
7470: 2a 2a 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f 66 ** and number of
7480: 20 74 68 65 20 76 61 72 61 72 67 73 20 70 61 72 the varargs par
7490: 61 6d 65 74 65 72 73 29 20 69 73 20 64 65 74 65 ameters) is dete
74a0: 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 65 48 rmined by the eH
74b0: 69 6e 74 54 79 70 65 0a 2a 2a 20 70 61 72 61 6d intType.** param
74c0: 65 74 65 72 2e 20 20 53 65 65 20 74 68 65 20 64 eter. See the d
74d0: 65 66 69 6e 69 74 69 6f 6e 73 20 6f 66 20 74 68 efinitions of th
74e0: 65 20 42 54 52 45 45 5f 48 49 4e 54 5f 2a 20 6d e BTREE_HINT_* m
74f0: 61 63 72 6f 73 20 66 6f 72 20 64 65 74 61 69 6c acros for detail
7500: 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 s..*/.void sqlit
7510: 65 33 42 74 72 65 65 43 75 72 73 6f 72 48 69 6e e3BtreeCursorHin
7520: 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 t(BtCursor *pCur
7530: 2c 20 69 6e 74 20 65 48 69 6e 74 54 79 70 65 2c , int eHintType,
7540: 20 2e 2e 2e 29 7b 0a 20 20 2f 2a 20 55 73 65 64 ...){. /* Used
7550: 20 6f 6e 6c 79 20 62 79 20 73 79 73 74 65 6d 20 only by system
7560: 74 68 61 74 20 73 75 62 73 74 69 74 75 74 65 20 that substitute
7570: 74 68 65 69 72 20 6f 77 6e 20 73 74 6f 72 61 67 their own storag
7580: 65 20 65 6e 67 69 6e 65 20 2a 2f 0a 7d 0a 23 65 e engine */.}.#e
7590: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 ndif../*.** Prov
75a0: 69 64 65 20 66 6c 61 67 20 68 69 6e 74 73 20 74 ide flag hints t
75b0: 6f 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2f o the cursor..*/
75c0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 .void sqlite3Btr
75d0: 65 65 43 75 72 73 6f 72 48 69 6e 74 46 6c 61 67 eeCursorHintFlag
75e0: 73 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 s(BtCursor *pCur
75f0: 2c 20 75 6e 73 69 67 6e 65 64 20 78 29 7b 0a 20 , unsigned x){.
7600: 20 61 73 73 65 72 74 28 20 78 3d 3d 42 54 52 45 assert( x==BTRE
7610: 45 5f 53 45 45 4b 5f 45 51 20 7c 7c 20 78 3d 3d E_SEEK_EQ || x==
7620: 42 54 52 45 45 5f 42 55 4c 4b 4c 4f 41 44 20 7c BTREE_BULKLOAD |
7630: 7c 20 78 3d 3d 30 20 29 3b 0a 20 20 70 43 75 72 | x==0 );. pCur
7640: 2d 3e 68 69 6e 74 73 20 3d 20 78 3b 0a 7d 0a 0a ->hints = x;.}..
7650: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
7660: 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
7670: 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 20 70 61 /*.** Given a pa
7680: 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 72 ge number of a r
7690: 65 67 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 egular database
76a0: 70 61 67 65 2c 20 72 65 74 75 72 6e 20 74 68 65 page, return the
76b0: 20 70 61 67 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 page.** number
76c0: 66 6f 72 20 74 68 65 20 70 6f 69 6e 74 65 72 2d for the pointer-
76d0: 6d 61 70 20 70 61 67 65 20 74 68 61 74 20 63 6f map page that co
76e0: 6e 74 61 69 6e 73 20 74 68 65 20 65 6e 74 72 79 ntains the entry
76f0: 20 66 6f 72 20 74 68 65 0a 2a 2a 20 69 6e 70 75 for the.** inpu
7700: 74 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a t page number..*
7710: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 30 20 28 6e *.** Return 0 (n
7720: 6f 74 20 61 20 76 61 6c 69 64 20 70 61 67 65 29 ot a valid page)
7730: 20 66 6f 72 20 70 67 6e 6f 3d 3d 31 20 73 69 6e for pgno==1 sin
7740: 63 65 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 6e ce there is.** n
7750: 6f 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 61 73 o pointer map as
7760: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 61 sociated with pa
7770: 67 65 20 31 2e 20 20 54 68 65 20 69 6e 74 65 67 ge 1. The integ
7780: 72 69 74 79 5f 63 68 65 63 6b 20 6c 6f 67 69 63 rity_check logic
7790: 0a 2a 2a 20 72 65 71 75 69 72 65 73 20 74 68 61 .** requires tha
77a0: 74 20 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 2a t ptrmapPageno(*
77b0: 2c 31 29 21 3d 31 2e 0a 2a 2f 0a 73 74 61 74 69 ,1)!=1..*/.stati
77c0: 63 20 50 67 6e 6f 20 70 74 72 6d 61 70 50 61 67 c Pgno ptrmapPag
77d0: 65 6e 6f 28 42 74 53 68 61 72 65 64 20 2a 70 42 eno(BtShared *pB
77e0: 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 t, Pgno pgno){.
77f0: 20 69 6e 74 20 6e 50 61 67 65 73 50 65 72 4d 61 int nPagesPerMa
7800: 70 50 61 67 65 3b 0a 20 20 50 67 6e 6f 20 69 50 pPage;. Pgno iP
7810: 74 72 4d 61 70 2c 20 72 65 74 3b 0a 20 20 61 73 trMap, ret;. as
7820: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
7830: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
7840: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 67 tex) );. if( pg
7850: 6e 6f 3c 32 20 29 20 72 65 74 75 72 6e 20 30 3b no<2 ) return 0;
7860: 0a 20 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 . nPagesPerMapP
7870: 61 67 65 20 3d 20 28 70 42 74 2d 3e 75 73 61 62 age = (pBt->usab
7880: 6c 65 53 69 7a 65 2f 35 29 2b 31 3b 0a 20 20 69 leSize/5)+1;. i
7890: 50 74 72 4d 61 70 20 3d 20 28 70 67 6e 6f 2d 32 PtrMap = (pgno-2
78a0: 29 2f 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 )/nPagesPerMapPa
78b0: 67 65 3b 0a 20 20 72 65 74 20 3d 20 28 69 50 74 ge;. ret = (iPt
78c0: 72 4d 61 70 2a 6e 50 61 67 65 73 50 65 72 4d 61 rMap*nPagesPerMa
78d0: 70 50 61 67 65 29 20 2b 20 32 3b 20 0a 20 20 69 pPage) + 2; . i
78e0: 66 28 20 72 65 74 3d 3d 50 45 4e 44 49 4e 47 5f f( ret==PENDING_
78f0: 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 BYTE_PAGE(pBt) )
7900: 7b 0a 20 20 20 20 72 65 74 2b 2b 3b 0a 20 20 7d {. ret++;. }
7910: 0a 20 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d . return ret;.}
7920: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 6e ../*.** Write an
7930: 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 68 65 20 entry into the
7940: 70 6f 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a pointer map..**.
7950: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
7960: 75 70 64 61 74 65 73 20 74 68 65 20 70 6f 69 6e updates the poin
7970: 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f ter map entry fo
7980: 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 27 6b r page number 'k
7990: 65 79 27 0a 2a 2a 20 73 6f 20 74 68 61 74 20 69 ey'.** so that i
79a0: 74 20 6d 61 70 73 20 74 6f 20 74 79 70 65 20 27 t maps to type '
79b0: 65 54 79 70 65 27 20 61 6e 64 20 70 61 72 65 6e eType' and paren
79c0: 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 27 70 t page number 'p
79d0: 67 6e 6f 27 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 2a gno'..**.** If *
79e0: 70 52 43 20 69 73 20 69 6e 69 74 69 61 6c 6c 79 pRC is initially
79f0: 20 6e 6f 6e 2d 7a 65 72 6f 20 28 6e 6f 6e 2d 53 non-zero (non-S
7a00: 51 4c 49 54 45 5f 4f 4b 29 20 74 68 65 6e 20 74 QLITE_OK) then t
7a10: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 0a 2a his routine is.*
7a20: 2a 20 61 20 6e 6f 2d 6f 70 2e 20 20 49 66 20 61 * a no-op. If a
7a30: 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 n error occurs,
7a40: 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 the appropriate
7a50: 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 77 72 error code is wr
7a60: 69 74 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 2a 70 itten.** into *p
7a70: 52 43 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f RC..*/.static vo
7a80: 69 64 20 70 74 72 6d 61 70 50 75 74 28 42 74 53 id ptrmapPut(BtS
7a90: 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f hared *pBt, Pgno
7aa0: 20 6b 65 79 2c 20 75 38 20 65 54 79 70 65 2c 20 key, u8 eType,
7ab0: 50 67 6e 6f 20 70 61 72 65 6e 74 2c 20 69 6e 74 Pgno parent, int
7ac0: 20 2a 70 52 43 29 7b 0a 20 20 44 62 50 61 67 65 *pRC){. DbPage
7ad0: 20 2a 70 44 62 50 61 67 65 3b 20 20 2f 2a 20 54 *pDbPage; /* T
7ae0: 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 he pointer map p
7af0: 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 age */. u8 *pPt
7b00: 72 6d 61 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 rmap; /* Th
7b10: 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 64 61 e pointer map da
7b20: 74 61 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 50 74 ta */. Pgno iPt
7b30: 72 6d 61 70 3b 20 20 20 20 20 2f 2a 20 54 68 65 rmap; /* The
7b40: 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 pointer map pag
7b50: 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 69 6e e number */. in
7b60: 74 20 6f 66 66 73 65 74 3b 20 20 20 20 20 20 20 t offset;
7b70: 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 70 6f 69 /* Offset in poi
7b80: 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f nter map page */
7b90: 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
7ba0: 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
7bb0: 6f 64 65 20 66 72 6f 6d 20 73 75 62 66 75 6e 63 ode from subfunc
7bc0: 74 69 6f 6e 73 20 2a 2f 0a 0a 20 20 69 66 28 20 tions */.. if(
7bd0: 2a 70 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 0a *pRC ) return;..
7be0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
7bf0: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
7c00: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a ->mutex) );. /*
7c10: 20 54 68 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 The master-jour
7c20: 6e 61 6c 20 70 61 67 65 20 6e 75 6d 62 65 72 20 nal page number
7c30: 6d 75 73 74 20 6e 65 76 65 72 20 62 65 20 75 73 must never be us
7c40: 65 64 20 61 73 20 61 20 70 6f 69 6e 74 65 72 20 ed as a pointer
7c50: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 61 73 map page */. as
7c60: 73 65 72 74 28 20 30 3d 3d 50 54 52 4d 41 50 5f sert( 0==PTRMAP_
7c70: 49 53 50 41 47 45 28 70 42 74 2c 20 50 45 4e 44 ISPAGE(pBt, PEND
7c80: 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 ING_BYTE_PAGE(pB
7c90: 74 29 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 t)) );.. assert
7ca0: 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ( pBt->autoVacuu
7cb0: 6d 20 29 3b 0a 20 20 69 66 28 20 6b 65 79 3d 3d m );. if( key==
7cc0: 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 0 ){. *pRC =
7cd0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
7ce0: 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b KPT;. return;
7cf0: 0a 20 20 7d 0a 20 20 69 50 74 72 6d 61 70 20 3d . }. iPtrmap =
7d00: 20 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 PTRMAP_PAGENO(p
7d10: 42 74 2c 20 6b 65 79 29 3b 0a 20 20 72 63 20 3d Bt, key);. rc =
7d20: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
7d30: 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 69 50 (pBt->pPager, iP
7d40: 74 72 6d 61 70 2c 20 26 70 44 62 50 61 67 65 2c trmap, &pDbPage,
7d50: 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 0);. if( rc!=S
7d60: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
7d70: 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 *pRC = rc;. r
7d80: 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 6f 66 66 eturn;. }. off
7d90: 73 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 set = PTRMAP_PTR
7da0: 4f 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 OFFSET(iPtrmap,
7db0: 6b 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 key);. if( offs
7dc0: 65 74 3c 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 et<0 ){. *pRC
7dd0: 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
7de0: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f T_BKPT;. goto
7df0: 20 70 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 20 ptrmap_exit;.
7e00: 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 }. assert( offs
7e10: 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e et <= (int)pBt->
7e20: 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a usableSize-5 );.
7e30: 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 pPtrmap = (u8
7e40: 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 *)sqlite3PagerGe
7e50: 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a tData(pDbPage);.
7e60: 0a 20 20 69 66 28 20 65 54 79 70 65 21 3d 70 50 . if( eType!=pP
7e70: 74 72 6d 61 70 5b 6f 66 66 73 65 74 5d 20 7c 7c trmap[offset] ||
7e80: 20 67 65 74 34 62 79 74 65 28 26 70 50 74 72 6d get4byte(&pPtrm
7e90: 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 21 3d 70 ap[offset+1])!=p
7ea0: 61 72 65 6e 74 20 29 7b 0a 20 20 20 20 54 52 41 arent ){. TRA
7eb0: 43 45 28 28 22 50 54 52 4d 41 50 5f 55 50 44 41 CE(("PTRMAP_UPDA
7ec0: 54 45 3a 20 25 64 2d 3e 28 25 64 2c 25 64 29 5c TE: %d->(%d,%d)\
7ed0: 6e 22 2c 20 6b 65 79 2c 20 65 54 79 70 65 2c 20 n", key, eType,
7ee0: 70 61 72 65 6e 74 29 29 3b 0a 20 20 20 20 2a 70 parent));. *p
7ef0: 52 43 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33 RC= rc = sqlite3
7f00: 50 61 67 65 72 57 72 69 74 65 28 70 44 62 50 61 PagerWrite(pDbPa
7f10: 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d ge);. if( rc=
7f20: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
7f30: 20 20 20 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 pPtrmap[offs
7f40: 65 74 5d 20 3d 20 65 54 79 70 65 3b 0a 20 20 20 et] = eType;.
7f50: 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 74 put4byte(&pPt
7f60: 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 2c 20 rmap[offset+1],
7f70: 70 61 72 65 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 parent);. }.
7f80: 20 7d 0a 0a 70 74 72 6d 61 70 5f 65 78 69 74 3a }..ptrmap_exit:
7f90: 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 . sqlite3PagerU
7fa0: 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 7d nref(pDbPage);.}
7fb0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 6e 20 ../*.** Read an
7fc0: 65 6e 74 72 79 20 66 72 6f 6d 20 74 68 65 20 70 entry from the p
7fd0: 6f 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a ointer map..**.*
7fe0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 * This routine r
7ff0: 65 74 72 69 65 76 65 73 20 74 68 65 20 70 6f 69 etrieves the poi
8000: 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 nter map entry f
8010: 6f 72 20 70 61 67 65 20 27 6b 65 79 27 2c 20 77 or page 'key', w
8020: 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 74 79 riting.** the ty
8030: 70 65 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 pe and parent pa
8040: 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 2a 70 45 ge number to *pE
8050: 54 79 70 65 20 61 6e 64 20 2a 70 50 67 6e 6f 20 Type and *pPgno
8060: 72 65 73 70 65 63 74 69 76 65 6c 79 2e 0a 2a 2a respectively..**
8070: 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 An error code i
8080: 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 73 6f s returned if so
8090: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
80a0: 6e 67 2c 20 6f 74 68 65 72 77 69 73 65 20 53 51 ng, otherwise SQ
80b0: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 LITE_OK..*/.stat
80c0: 69 63 20 69 6e 74 20 70 74 72 6d 61 70 47 65 74 ic int ptrmapGet
80d0: 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
80e0: 50 67 6e 6f 20 6b 65 79 2c 20 75 38 20 2a 70 45 Pgno key, u8 *pE
80f0: 54 79 70 65 2c 20 50 67 6e 6f 20 2a 70 50 67 6e Type, Pgno *pPgn
8100: 6f 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 o){. DbPage *pD
8110: 62 50 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 bPage; /* The
8120: 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 pointer map page
8130: 20 2a 2f 0a 20 20 69 6e 74 20 69 50 74 72 6d 61 */. int iPtrma
8140: 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e p; /* Poin
8150: 74 65 72 20 6d 61 70 20 70 61 67 65 20 69 6e 64 ter map page ind
8160: 65 78 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 ex */. u8 *pPtr
8170: 6d 61 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f map; /* Po
8180: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 64 inter map page d
8190: 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 ata */. int off
81a0: 73 65 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f set; /* O
81b0: 66 66 73 65 74 20 6f 66 20 65 6e 74 72 79 20 69 ffset of entry i
81c0: 6e 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 2a 2f n pointer map */
81d0: 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 . int rc;.. as
81e0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
81f0: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
8200: 74 65 78 29 20 29 3b 0a 0a 20 20 69 50 74 72 6d tex) );.. iPtrm
8210: 61 70 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 ap = PTRMAP_PAGE
8220: 4e 4f 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 NO(pBt, key);.
8230: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
8240: 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
8250: 2c 20 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 , iPtrmap, &pDbP
8260: 61 67 65 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 age, 0);. if( r
8270: 63 21 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 c!=0 ){. retu
8280: 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 50 74 rn rc;. }. pPt
8290: 72 6d 61 70 20 3d 20 28 75 38 20 2a 29 73 71 6c rmap = (u8 *)sql
82a0: 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
82b0: 28 70 44 62 50 61 67 65 29 3b 0a 0a 20 20 6f 66 (pDbPage);.. of
82c0: 66 73 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 fset = PTRMAP_PT
82d0: 52 4f 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c ROFFSET(iPtrmap,
82e0: 20 6b 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 key);. if( off
82f0: 73 65 74 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c set<0 ){. sql
8300: 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
8310: 44 62 50 61 67 65 29 3b 0a 20 20 20 20 72 65 74 DbPage);. ret
8320: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
8330: 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 PT_BKPT;. }. a
8340: 73 73 65 72 74 28 20 6f 66 66 73 65 74 20 3c 3d ssert( offset <=
8350: 20 28 69 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c (int)pBt->usabl
8360: 65 53 69 7a 65 2d 35 20 29 3b 0a 20 20 61 73 73 eSize-5 );. ass
8370: 65 72 74 28 20 70 45 54 79 70 65 21 3d 30 20 29 ert( pEType!=0 )
8380: 3b 0a 20 20 2a 70 45 54 79 70 65 20 3d 20 70 50 ;. *pEType = pP
8390: 74 72 6d 61 70 5b 6f 66 66 73 65 74 5d 3b 0a 20 trmap[offset];.
83a0: 20 69 66 28 20 70 50 67 6e 6f 20 29 20 2a 70 50 if( pPgno ) *pP
83b0: 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 gno = get4byte(&
83c0: 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 pPtrmap[offset+1
83d0: 5d 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 50 61 ]);.. sqlite3Pa
83e0: 67 65 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 gerUnref(pDbPage
83f0: 29 3b 0a 20 20 69 66 28 20 2a 70 45 54 79 70 65 );. if( *pEType
8400: 3c 31 20 7c 7c 20 2a 70 45 54 79 70 65 3e 35 20 <1 || *pEType>5
8410: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
8420: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
8430: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
8440: 3b 0a 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 ;.}..#else /* if
8450: 20 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f defined SQLITE_
8460: 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 OMIT_AUTOVACUUM
8470: 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 */. #define ptr
8480: 6d 61 70 50 75 74 28 77 2c 78 2c 79 2c 7a 2c 72 mapPut(w,x,y,z,r
8490: 63 29 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 c). #define ptr
84a0: 6d 61 70 47 65 74 28 77 2c 78 2c 79 2c 7a 29 20 mapGet(w,x,y,z)
84b0: 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 SQLITE_OK. #def
84c0: 69 6e 65 20 70 74 72 6d 61 70 50 75 74 4f 76 66 ine ptrmapPutOvf
84d0: 6c 50 74 72 28 78 2c 20 79 2c 20 72 63 29 0a 23 lPtr(x, y, rc).#
84e0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 endif../*.** Giv
84f0: 65 6e 20 61 20 62 74 72 65 65 20 70 61 67 65 20 en a btree page
8500: 61 6e 64 20 61 20 63 65 6c 6c 20 69 6e 64 65 78 and a cell index
8510: 20 28 30 20 6d 65 61 6e 73 20 74 68 65 20 66 69 (0 means the fi
8520: 72 73 74 20 63 65 6c 6c 20 6f 6e 0a 2a 2a 20 74 rst cell on.** t
8530: 68 65 20 70 61 67 65 2c 20 31 20 6d 65 61 6e 73 he page, 1 means
8540: 20 74 68 65 20 73 65 63 6f 6e 64 20 63 65 6c 6c the second cell
8550: 2c 20 61 6e 64 20 73 6f 20 66 6f 72 74 68 29 20 , and so forth)
8560: 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 return a pointer
8570: 0a 2a 2a 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 .** to the cell
8580: 63 6f 6e 74 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 66 content..**.** f
8590: 69 6e 64 43 65 6c 6c 50 61 73 74 50 74 72 28 29 indCellPastPtr()
85a0: 20 64 6f 65 73 20 74 68 65 20 73 61 6d 65 20 65 does the same e
85b0: 78 63 65 70 74 20 69 74 20 73 6b 69 70 73 20 70 xcept it skips p
85c0: 61 73 74 20 74 68 65 20 69 6e 69 74 69 61 6c 0a ast the initial.
85d0: 2a 2a 20 34 2d 62 79 74 65 20 63 68 69 6c 64 20 ** 4-byte child
85e0: 70 6f 69 6e 74 65 72 20 66 6f 75 6e 64 20 6f 6e pointer found on
85f0: 20 69 6e 74 65 72 69 6f 72 20 70 61 67 65 73 2c interior pages,
8600: 20 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e 65 if there is one
8610: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
8620: 74 69 6e 65 20 77 6f 72 6b 73 20 6f 6e 6c 79 20 tine works only
8630: 66 6f 72 20 70 61 67 65 73 20 74 68 61 74 20 64 for pages that d
8640: 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 6f 76 o not contain ov
8650: 65 72 66 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f erflow cells..*/
8660: 0a 23 64 65 66 69 6e 65 20 66 69 6e 64 43 65 6c .#define findCel
8670: 6c 28 50 2c 49 29 20 5c 0a 20 20 28 28 50 29 2d l(P,I) \. ((P)-
8680: 3e 61 44 61 74 61 20 2b 20 28 28 50 29 2d 3e 6d >aData + ((P)->m
8690: 61 73 6b 50 61 67 65 20 26 20 67 65 74 32 62 79 askPage & get2by
86a0: 74 65 41 6c 69 67 6e 65 64 28 26 28 50 29 2d 3e teAligned(&(P)->
86b0: 61 43 65 6c 6c 49 64 78 5b 32 2a 28 49 29 5d 29 aCellIdx[2*(I)])
86c0: 29 29 0a 23 64 65 66 69 6e 65 20 66 69 6e 64 43 )).#define findC
86d0: 65 6c 6c 50 61 73 74 50 74 72 28 50 2c 49 29 20 ellPastPtr(P,I)
86e0: 5c 0a 20 20 28 28 50 29 2d 3e 61 44 61 74 61 4f \. ((P)->aDataO
86f0: 66 73 74 20 2b 20 28 28 50 29 2d 3e 6d 61 73 6b fst + ((P)->mask
8700: 50 61 67 65 20 26 20 67 65 74 32 62 79 74 65 41 Page & get2byteA
8710: 6c 69 67 6e 65 64 28 26 28 50 29 2d 3e 61 43 65 ligned(&(P)->aCe
8720: 6c 6c 49 64 78 5b 32 2a 28 49 29 5d 29 29 29 0a llIdx[2*(I)]))).
8730: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 ../*.** This is
8740: 63 6f 6d 6d 6f 6e 20 74 61 69 6c 20 70 72 6f 63 common tail proc
8750: 65 73 73 69 6e 67 20 66 6f 72 20 62 74 72 65 65 essing for btree
8760: 50 61 72 73 65 43 65 6c 6c 50 74 72 28 29 20 61 ParseCellPtr() a
8770: 6e 64 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 nd.** btreeParse
8780: 43 65 6c 6c 50 74 72 49 6e 64 65 78 28 29 20 66 CellPtrIndex() f
8790: 6f 72 20 74 68 65 20 63 61 73 65 20 77 68 65 6e or the case when
87a0: 20 74 68 65 20 63 65 6c 6c 20 64 6f 65 73 20 6e the cell does n
87b0: 6f 74 20 66 69 74 20 65 6e 74 69 72 65 6c 79 0a ot fit entirely.
87c0: 2a 2a 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 42 ** on a single B
87d0: 2d 74 72 65 65 20 70 61 67 65 2e 20 20 4d 61 6b -tree page. Mak
87e0: 65 20 6e 65 63 65 73 73 61 72 79 20 61 64 6a 75 e necessary adju
87f0: 73 74 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 43 stments to the C
8800: 65 6c 6c 49 6e 66 6f 0a 2a 2a 20 73 74 72 75 63 ellInfo.** struc
8810: 74 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ture..*/.static
8820: 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 SQLITE_NOINLINE
8830: 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 void btreeParseC
8840: 65 6c 6c 41 64 6a 75 73 74 53 69 7a 65 46 6f 72 ellAdjustSizeFor
8850: 4f 76 65 72 66 6c 6f 77 28 0a 20 20 4d 65 6d 50 Overflow(. MemP
8860: 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 age *pPage,
8870: 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 /* Page cont
8880: 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 aining the cell
8890: 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 */. u8 *pCell,
88a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
88b0: 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 Pointer to the c
88c0: 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 ell text. */. C
88d0: 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 ellInfo *pInfo
88e0: 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 /* Fill i
88f0: 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 n this structure
8900: 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 49 66 20 74 */.){. /* If t
8910: 68 65 20 70 61 79 6c 6f 61 64 20 77 69 6c 6c 20 he payload will
8920: 6e 6f 74 20 66 69 74 20 63 6f 6d 70 6c 65 74 65 not fit complete
8930: 6c 79 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 ly on the local
8940: 70 61 67 65 2c 20 77 65 20 68 61 76 65 0a 20 20 page, we have.
8950: 2a 2a 20 74 6f 20 64 65 63 69 64 65 20 68 6f 77 ** to decide how
8960: 20 6d 75 63 68 20 74 6f 20 73 74 6f 72 65 20 6c much to store l
8970: 6f 63 61 6c 6c 79 20 61 6e 64 20 68 6f 77 20 6d ocally and how m
8980: 75 63 68 20 74 6f 20 73 70 69 6c 6c 20 6f 6e 74 uch to spill ont
8990: 6f 0a 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 o. ** overflow
89a0: 70 61 67 65 73 2e 20 20 54 68 65 20 73 74 72 61 pages. The stra
89b0: 74 65 67 79 20 69 73 20 74 6f 20 6d 69 6e 69 6d tegy is to minim
89c0: 69 7a 65 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f ize the amount o
89d0: 66 20 75 6e 75 73 65 64 0a 20 20 2a 2a 20 73 70 f unused. ** sp
89e0: 61 63 65 20 6f 6e 20 6f 76 65 72 66 6c 6f 77 20 ace on overflow
89f0: 70 61 67 65 73 20 77 68 69 6c 65 20 6b 65 65 70 pages while keep
8a00: 69 6e 67 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f ing the amount o
8a10: 66 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 0a f local storage.
8a20: 20 20 2a 2a 20 69 6e 20 62 65 74 77 65 65 6e 20 ** in between
8a30: 6d 69 6e 4c 6f 63 61 6c 20 61 6e 64 20 6d 61 78 minLocal and max
8a40: 4c 6f 63 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a Local.. **. **
8a50: 20 57 61 72 6e 69 6e 67 3a 20 20 63 68 61 6e 67 Warning: chang
8a60: 69 6e 67 20 74 68 65 20 77 61 79 20 6f 76 65 72 ing the way over
8a70: 66 6c 6f 77 20 70 61 79 6c 6f 61 64 20 69 73 20 flow payload is
8a80: 64 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 61 distributed in a
8a90: 6e 79 0a 20 20 2a 2a 20 77 61 79 20 77 69 6c 6c ny. ** way will
8aa0: 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 69 6e result in an in
8ab0: 63 6f 6d 70 61 74 69 62 6c 65 20 66 69 6c 65 20 compatible file
8ac0: 66 6f 72 6d 61 74 2e 0a 20 20 2a 2f 0a 20 20 69 format.. */. i
8ad0: 6e 74 20 6d 69 6e 4c 6f 63 61 6c 3b 20 20 2f 2a nt minLocal; /*
8ae0: 20 4d 69 6e 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 Minimum amount
8af0: 6f 66 20 70 61 79 6c 6f 61 64 20 68 65 6c 64 20 of payload held
8b00: 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 20 69 6e 74 locally */. int
8b10: 20 6d 61 78 4c 6f 63 61 6c 3b 20 20 2f 2a 20 4d maxLocal; /* M
8b20: 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 aximum amount of
8b30: 20 70 61 79 6c 6f 61 64 20 68 65 6c 64 20 6c 6f payload held lo
8b40: 63 61 6c 6c 79 20 2a 2f 0a 20 20 69 6e 74 20 73 cally */. int s
8b50: 75 72 70 6c 75 73 3b 20 20 20 2f 2a 20 4f 76 65 urplus; /* Ove
8b60: 72 66 6c 6f 77 20 70 61 79 6c 6f 61 64 20 61 76 rflow payload av
8b70: 61 69 6c 61 62 6c 65 20 66 6f 72 20 6c 6f 63 61 ailable for loca
8b80: 6c 20 73 74 6f 72 61 67 65 20 2a 2f 0a 0a 20 20 l storage */..
8b90: 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 minLocal = pPage
8ba0: 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 6d 61 ->minLocal;. ma
8bb0: 78 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e xLocal = pPage->
8bc0: 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 73 75 72 70 maxLocal;. surp
8bd0: 6c 75 73 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b lus = minLocal +
8be0: 20 28 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 (pInfo->nPayloa
8bf0: 64 20 2d 20 6d 69 6e 4c 6f 63 61 6c 29 25 28 70 d - minLocal)%(p
8c00: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
8c10: 65 53 69 7a 65 2d 34 29 3b 0a 20 20 74 65 73 74 eSize-4);. test
8c20: 63 61 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d case( surplus==m
8c30: 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 axLocal );. tes
8c40: 74 63 61 73 65 28 20 73 75 72 70 6c 75 73 3d 3d tcase( surplus==
8c50: 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 maxLocal+1 );.
8c60: 69 66 28 20 73 75 72 70 6c 75 73 20 3c 3d 20 6d if( surplus <= m
8c70: 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 70 axLocal ){. p
8c80: 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 Info->nLocal = (
8c90: 75 31 36 29 73 75 72 70 6c 75 73 3b 0a 20 20 7d u16)surplus;. }
8ca0: 65 6c 73 65 7b 0a 20 20 20 20 70 49 6e 66 6f 2d else{. pInfo-
8cb0: 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 6d >nLocal = (u16)m
8cc0: 69 6e 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 70 inLocal;. }. p
8cd0: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 28 75 Info->nSize = (u
8ce0: 31 36 29 28 26 70 49 6e 66 6f 2d 3e 70 50 61 79 16)(&pInfo->pPay
8cf0: 6c 6f 61 64 5b 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 load[pInfo->nLoc
8d00: 61 6c 5d 20 2d 20 70 43 65 6c 6c 29 20 2b 20 34 al] - pCell) + 4
8d10: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 ;.}../*.** The f
8d20: 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 ollowing routine
8d30: 73 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 61 s are implementa
8d40: 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 4d 65 6d tions of the Mem
8d50: 50 61 67 65 2e 78 50 61 72 73 65 43 65 6c 6c 28 Page.xParseCell(
8d60: 29 0a 2a 2a 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a ).** method..**.
8d70: 2a 2a 20 50 61 72 73 65 20 61 20 63 65 6c 6c 20 ** Parse a cell
8d80: 63 6f 6e 74 65 6e 74 20 62 6c 6f 63 6b 20 61 6e content block an
8d90: 64 20 66 69 6c 6c 20 69 6e 20 74 68 65 20 43 65 d fill in the Ce
8da0: 6c 6c 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 llInfo structure
8db0: 2e 0a 2a 2a 0a 2a 2a 20 62 74 72 65 65 50 61 72 ..**.** btreePar
8dc0: 73 65 43 65 6c 6c 50 74 72 28 29 20 20 20 20 20 seCellPtr()
8dd0: 20 20 20 3d 3e 20 20 20 74 61 62 6c 65 20 62 74 => table bt
8de0: 72 65 65 20 6c 65 61 66 20 6e 6f 64 65 73 0a 2a ree leaf nodes.*
8df0: 2a 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c * btreeParseCell
8e00: 4e 6f 50 61 79 6c 6f 61 64 28 29 20 20 3d 3e 20 NoPayload() =>
8e10: 20 20 74 61 62 6c 65 20 62 74 72 65 65 20 69 6e table btree in
8e20: 74 65 72 6e 61 6c 20 6e 6f 64 65 73 0a 2a 2a 20 ternal nodes.**
8e30: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 btreeParseCellPt
8e40: 72 49 6e 64 65 78 28 29 20 20 20 3d 3e 20 20 20 rIndex() =>
8e50: 69 6e 64 65 78 20 62 74 72 65 65 20 6e 6f 64 65 index btree node
8e60: 73 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73 s.**.** There is
8e70: 20 61 6c 73 6f 20 61 20 77 72 61 70 70 65 72 20 also a wrapper
8e80: 66 75 6e 63 74 69 6f 6e 20 62 74 72 65 65 50 61 function btreePa
8e90: 72 73 65 43 65 6c 6c 28 29 20 74 68 61 74 20 77 rseCell() that w
8ea0: 6f 72 6b 73 20 66 6f 72 0a 2a 2a 20 61 6c 6c 20 orks for.** all
8eb0: 4d 65 6d 50 61 67 65 20 74 79 70 65 73 20 61 6e MemPage types an
8ec0: 64 20 74 68 61 74 20 72 65 66 65 72 65 6e 63 65 d that reference
8ed0: 73 20 74 68 65 20 63 65 6c 6c 20 62 79 20 69 6e s the cell by in
8ee0: 64 65 78 20 72 61 74 68 65 72 20 74 68 61 6e 0a dex rather than.
8ef0: 2a 2a 20 62 79 20 70 6f 69 6e 74 65 72 2e 0a 2a ** by pointer..*
8f00: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 /.static void bt
8f10: 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 4e reeParseCellPtrN
8f20: 6f 50 61 79 6c 6f 61 64 28 0a 20 20 4d 65 6d 50 oPayload(. MemP
8f30: 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 age *pPage,
8f40: 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 /* Page cont
8f50: 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 aining the cell
8f60: 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 */. u8 *pCell,
8f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8f80: 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 Pointer to the c
8f90: 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 ell text. */. C
8fa0: 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 ellInfo *pInfo
8fb0: 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 /* Fill i
8fc0: 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 n this structure
8fd0: 20 2a 2f 0a 29 7b 0a 20 20 61 73 73 65 72 74 28 */.){. assert(
8fe0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
8ff0: 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
9000: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
9010: 72 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d rt( pPage->leaf=
9020: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
9030: 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
9040: 69 7a 65 3d 3d 34 20 29 3b 0a 23 69 66 6e 64 65 ize==4 );.#ifnde
9050: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
9060: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
9070: 52 28 70 50 61 67 65 29 3b 0a 23 65 6e 64 69 66 R(pPage);.#endif
9080: 0a 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 . pInfo->nSize
9090: 3d 20 34 20 2b 20 67 65 74 56 61 72 69 6e 74 28 = 4 + getVarint(
90a0: 26 70 43 65 6c 6c 5b 34 5d 2c 20 28 75 36 34 2a &pCell[4], (u64*
90b0: 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b 0a )&pInfo->nKey);.
90c0: 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 pInfo->nPayloa
90d0: 64 20 3d 20 30 3b 0a 20 20 70 49 6e 66 6f 2d 3e d = 0;. pInfo->
90e0: 6e 4c 6f 63 61 6c 20 3d 20 30 3b 0a 20 20 70 49 nLocal = 0;. pI
90f0: 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 nfo->pPayload =
9100: 30 3b 0a 20 20 72 65 74 75 72 6e 3b 0a 7d 0a 73 0;. return;.}.s
9110: 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
9120: 50 61 72 73 65 43 65 6c 6c 50 74 72 28 0a 20 20 ParseCellPtr(.
9130: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
9140: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
9150: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
9160: 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 ell */. u8 *pCe
9170: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
9180: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 /* Pointer to t
9190: 68 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f he cell text. */
91a0: 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e . CellInfo *pIn
91b0: 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 fo /* Fi
91c0: 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 ll in this struc
91d0: 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 38 20 ture */.){. u8
91e0: 2a 70 49 74 65 72 3b 20 20 20 20 20 20 20 20 20 *pIter;
91f0: 20 20 20 20 20 2f 2a 20 46 6f 72 20 73 63 61 6e /* For scan
9200: 6e 69 6e 67 20 74 68 72 6f 75 67 68 20 70 43 65 ning through pCe
9210: 6c 6c 20 2a 2f 0a 20 20 75 33 32 20 6e 50 61 79 ll */. u32 nPay
9220: 6c 6f 61 64 3b 20 20 20 20 20 20 20 20 20 20 20 load;
9230: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 /* Number of byt
9240: 65 73 20 6f 66 20 63 65 6c 6c 20 70 61 79 6c 6f es of cell paylo
9250: 61 64 20 2a 2f 0a 20 20 75 36 34 20 69 4b 65 79 ad */. u64 iKey
9260: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
9270: 2f 2a 20 45 78 74 72 61 63 74 65 64 20 4b 65 79 /* Extracted Key
9280: 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 20 61 73 73 value */.. ass
9290: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
92a0: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
92b0: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
92c0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6c assert( pPage->l
92d0: 65 61 66 3d 3d 30 20 7c 7c 20 70 50 61 67 65 2d eaf==0 || pPage-
92e0: 3e 6c 65 61 66 3d 3d 31 20 29 3b 0a 20 20 61 73 >leaf==1 );. as
92f0: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 6e 74 sert( pPage->int
9300: 4b 65 79 4c 65 61 66 20 29 3b 0a 20 20 61 73 73 KeyLeaf );. ass
9310: 65 72 74 28 20 70 50 61 67 65 2d 3e 63 68 69 6c ert( pPage->chil
9320: 64 50 74 72 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 dPtrSize==0 );.
9330: 20 70 49 74 65 72 20 3d 20 70 43 65 6c 6c 3b 0a pIter = pCell;.
9340: 0a 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 62 . /* The next b
9350: 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 69 73 20 lock of code is
9360: 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 3a 0a 20 equivalent to:.
9370: 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 70 49 74 **. ** pIt
9380: 65 72 20 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 er += getVarint3
9390: 32 28 70 49 74 65 72 2c 20 6e 50 61 79 6c 6f 61 2(pIter, nPayloa
93a0: 64 29 3b 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 d);. **. ** Th
93b0: 65 20 63 6f 64 65 20 69 73 20 69 6e 6c 69 6e 65 e code is inline
93c0: 64 20 74 6f 20 61 76 6f 69 64 20 61 20 66 75 6e d to avoid a fun
93d0: 63 74 69 6f 6e 20 63 61 6c 6c 2e 0a 20 20 2a 2f ction call.. */
93e0: 0a 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 2a 70 . nPayload = *p
93f0: 49 74 65 72 3b 0a 20 20 69 66 28 20 6e 50 61 79 Iter;. if( nPay
9400: 6c 6f 61 64 3e 3d 30 78 38 30 20 29 7b 0a 20 20 load>=0x80 ){.
9410: 20 20 75 38 20 2a 70 45 6e 64 20 3d 20 26 70 49 u8 *pEnd = &pI
9420: 74 65 72 5b 38 5d 3b 0a 20 20 20 20 6e 50 61 79 ter[8];. nPay
9430: 6c 6f 61 64 20 26 3d 20 30 78 37 66 3b 0a 20 20 load &= 0x7f;.
9440: 20 20 64 6f 7b 0a 20 20 20 20 20 20 6e 50 61 79 do{. nPay
9450: 6c 6f 61 64 20 3d 20 28 6e 50 61 79 6c 6f 61 64 load = (nPayload
9460: 3c 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 <<7) | (*++pIter
9470: 20 26 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 & 0x7f);. }w
9480: 68 69 6c 65 28 20 28 2a 70 49 74 65 72 29 3e 3d hile( (*pIter)>=
9490: 30 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 0x80 && pIter<pE
94a0: 6e 64 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 nd );. }. pIte
94b0: 72 2b 2b 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 6e r++;.. /* The n
94c0: 65 78 74 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 ext block of cod
94d0: 65 20 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 e is equivalent
94e0: 74 6f 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 to:. **. **
94f0: 20 20 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 pIter += getVa
9500: 72 69 6e 74 28 70 49 74 65 72 2c 20 28 75 36 34 rint(pIter, (u64
9510: 2a 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 79 29 3b *)&pInfo->nKey);
9520: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 63 . **. ** The c
9530: 6f 64 65 20 69 73 20 69 6e 6c 69 6e 65 64 20 74 ode is inlined t
9540: 6f 20 61 76 6f 69 64 20 61 20 66 75 6e 63 74 69 o avoid a functi
9550: 6f 6e 20 63 61 6c 6c 2e 0a 20 20 2a 2f 0a 20 20 on call.. */.
9560: 69 4b 65 79 20 3d 20 2a 70 49 74 65 72 3b 0a 20 iKey = *pIter;.
9570: 20 69 66 28 20 69 4b 65 79 3e 3d 30 78 38 30 20 if( iKey>=0x80
9580: 29 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 64 20 ){. u8 *pEnd
9590: 3d 20 26 70 49 74 65 72 5b 37 5d 3b 0a 20 20 20 = &pIter[7];.
95a0: 20 69 4b 65 79 20 26 3d 20 30 78 37 66 3b 0a 20 iKey &= 0x7f;.
95b0: 20 20 20 77 68 69 6c 65 28 31 29 7b 0a 20 20 20 while(1){.
95c0: 20 20 20 69 4b 65 79 20 3d 20 28 69 4b 65 79 3c iKey = (iKey<
95d0: 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 <7) | (*++pIter
95e0: 26 20 30 78 37 66 29 3b 0a 20 20 20 20 20 20 69 & 0x7f);. i
95f0: 66 28 20 28 2a 70 49 74 65 72 29 3c 30 78 38 30 f( (*pIter)<0x80
9600: 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 ) break;.
9610: 69 66 28 20 70 49 74 65 72 3e 3d 70 45 6e 64 20 if( pIter>=pEnd
9620: 29 7b 0a 20 20 20 20 20 20 20 20 69 4b 65 79 20 ){. iKey
9630: 3d 20 28 69 4b 65 79 3c 3c 38 29 20 7c 20 2a 2b = (iKey<<8) | *+
9640: 2b 70 49 74 65 72 3b 0a 20 20 20 20 20 20 20 20 +pIter;.
9650: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 break;. }.
9660: 20 20 20 7d 0a 20 20 7d 0a 20 20 70 49 74 65 72 }. }. pIter
9670: 2b 2b 3b 0a 0a 20 20 70 49 6e 66 6f 2d 3e 6e 4b ++;.. pInfo->nK
9680: 65 79 20 3d 20 2a 28 69 36 34 2a 29 26 69 4b 65 ey = *(i64*)&iKe
9690: 79 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 y;. pInfo->nPay
96a0: 6c 6f 61 64 20 3d 20 6e 50 61 79 6c 6f 61 64 3b load = nPayload;
96b0: 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f . pInfo->pPaylo
96c0: 61 64 20 3d 20 70 49 74 65 72 3b 0a 20 20 74 65 ad = pIter;. te
96d0: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
96e0: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
96f0: 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 l );. testcase(
9700: 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 nPayload==pPage
9710: 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a ->maxLocal+1 );.
9720: 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d if( nPayload<=
9730: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pPage->maxLocal
9740: 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 ){. /* This i
9750: 73 20 74 68 65 20 28 65 61 73 79 29 20 63 6f 6d s the (easy) com
9760: 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 mon case where t
9770: 68 65 20 65 6e 74 69 72 65 20 70 61 79 6c 6f 61 he entire payloa
9780: 64 20 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f 6e d fits. ** on
9790: 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2e the local page.
97a0: 20 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 73 No overflow is
97b0: 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 2a required.. *
97c0: 2f 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 /. pInfo->nSi
97d0: 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 64 20 2b 20 ze = nPayload +
97e0: 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 (u16)(pIter - pC
97f0: 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 70 49 ell);. if( pI
9800: 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 20 29 20 70 nfo->nSize<4 ) p
9810: 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 3b Info->nSize = 4;
9820: 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 . pInfo->nLoc
9830: 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 79 6c 6f al = (u16)nPaylo
9840: 61 64 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ad;. }else{.
9850: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 41 btreeParseCellA
9860: 64 6a 75 73 74 53 69 7a 65 46 6f 72 4f 76 65 72 djustSizeForOver
9870: 66 6c 6f 77 28 70 50 61 67 65 2c 20 70 43 65 6c flow(pPage, pCel
9880: 6c 2c 20 70 49 6e 66 6f 29 3b 0a 20 20 7d 0a 7d l, pInfo);. }.}
9890: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 .static void btr
98a0: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 49 6e eeParseCellPtrIn
98b0: 64 65 78 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a dex(. MemPage *
98c0: 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 2f pPage, /
98d0: 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e * Page containin
98e0: 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 g the cell */.
98f0: 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 u8 *pCell,
9900: 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
9910: 65 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 er to the cell t
9920: 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e ext. */. CellIn
9930: 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 fo *pInfo
9940: 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 /* Fill in thi
9950: 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 s structure */.)
9960: 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 3b 20 20 {. u8 *pIter;
9970: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
9980: 6f 72 20 73 63 61 6e 6e 69 6e 67 20 74 68 72 6f or scanning thro
9990: 75 67 68 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 ugh pCell */. u
99a0: 33 32 20 6e 50 61 79 6c 6f 61 64 3b 20 20 20 20 32 nPayload;
99b0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
99c0: 20 6f 66 20 62 79 74 65 73 20 6f 66 20 63 65 6c of bytes of cel
99d0: 6c 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 0a 20 20 l payload */..
99e0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
99f0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
9a00: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
9a10: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
9a20: 2d 3e 6c 65 61 66 3d 3d 30 20 7c 7c 20 70 50 61 ->leaf==0 || pPa
9a30: 67 65 2d 3e 6c 65 61 66 3d 3d 31 20 29 3b 0a 20 ge->leaf==1 );.
9a40: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
9a50: 69 6e 74 4b 65 79 4c 65 61 66 3d 3d 30 20 29 3b intKeyLeaf==0 );
9a60: 0a 20 20 70 49 74 65 72 20 3d 20 70 43 65 6c 6c . pIter = pCell
9a70: 20 2b 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 + pPage->childP
9a80: 74 72 53 69 7a 65 3b 0a 20 20 6e 50 61 79 6c 6f trSize;. nPaylo
9a90: 61 64 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 ad = *pIter;. i
9aa0: 66 28 20 6e 50 61 79 6c 6f 61 64 3e 3d 30 78 38 f( nPayload>=0x8
9ab0: 30 20 29 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 0 ){. u8 *pEn
9ac0: 64 20 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 d = &pIter[8];.
9ad0: 20 20 20 6e 50 61 79 6c 6f 61 64 20 26 3d 20 30 nPayload &= 0
9ae0: 78 37 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 x7f;. do{.
9af0: 20 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 6e nPayload = (n
9b00: 50 61 79 6c 6f 61 64 3c 3c 37 29 20 7c 20 28 2a Payload<<7) | (*
9b10: 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b ++pIter & 0x7f);
9b20: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 . }while( *(p
9b30: 49 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 Iter)>=0x80 && p
9b40: 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d Iter<pEnd );. }
9b50: 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 20 20 70 49 . pIter++;. pI
9b60: 6e 66 6f 2d 3e 6e 4b 65 79 20 3d 20 6e 50 61 79 nfo->nKey = nPay
9b70: 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e load;. pInfo->n
9b80: 50 61 79 6c 6f 61 64 20 3d 20 6e 50 61 79 6c 6f Payload = nPaylo
9b90: 61 64 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 ad;. pInfo->pPa
9ba0: 79 6c 6f 61 64 20 3d 20 70 49 74 65 72 3b 0a 20 yload = pIter;.
9bb0: 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 79 6c testcase( nPayl
9bc0: 6f 61 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c oad==pPage->maxL
9bd0: 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 ocal );. testca
9be0: 73 65 28 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 se( nPayload==pP
9bf0: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 age->maxLocal+1
9c00: 29 3b 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 );. if( nPayloa
9c10: 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 d<=pPage->maxLoc
9c20: 61 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 al ){. /* Thi
9c30: 73 20 69 73 20 74 68 65 20 28 65 61 73 79 29 20 s is the (easy)
9c40: 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 common case wher
9c50: 65 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 79 e the entire pay
9c60: 6c 6f 61 64 20 66 69 74 73 0a 20 20 20 20 2a 2a load fits. **
9c70: 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 on the local pa
9c80: 67 65 2e 20 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 ge. No overflow
9c90: 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 20 20 is required..
9ca0: 20 20 2a 2f 0a 20 20 20 20 70 49 6e 66 6f 2d 3e */. pInfo->
9cb0: 6e 53 69 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 64 nSize = nPayload
9cc0: 20 2b 20 28 75 31 36 29 28 70 49 74 65 72 20 2d + (u16)(pIter -
9cd0: 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 pCell);. if(
9ce0: 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 20 pInfo->nSize<4
9cf0: 29 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d ) pInfo->nSize =
9d00: 20 34 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4;. pInfo->n
9d10: 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 Local = (u16)nPa
9d20: 79 6c 6f 61 64 3b 0a 20 20 7d 65 6c 73 65 7b 0a yload;. }else{.
9d30: 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
9d40: 6c 6c 41 64 6a 75 73 74 53 69 7a 65 46 6f 72 4f llAdjustSizeForO
9d50: 76 65 72 66 6c 6f 77 28 70 50 61 67 65 2c 20 70 verflow(pPage, p
9d60: 43 65 6c 6c 2c 20 70 49 6e 66 6f 29 3b 0a 20 20 Cell, pInfo);.
9d70: 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 }.}.static void
9d80: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 0a btreeParseCell(.
9d90: 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
9da0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 , /* Pag
9db0: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
9dc0: 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 cell */. int i
9dd0: 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 Cell,
9de0: 20 20 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 69 /* The cell i
9df0: 6e 64 65 78 2e 20 20 46 69 72 73 74 20 63 65 6c ndex. First cel
9e00: 6c 20 69 73 20 30 20 2a 2f 0a 20 20 43 65 6c 6c l is 0 */. Cell
9e10: 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 Info *pInfo
9e20: 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 /* Fill in t
9e30: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f his structure */
9e40: 0a 29 7b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 .){. pPage->xPa
9e50: 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 66 rseCell(pPage, f
9e60: 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 indCell(pPage, i
9e70: 43 65 6c 6c 29 2c 20 70 49 6e 66 6f 29 3b 0a 7d Cell), pInfo);.}
9e80: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
9e90: 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 61 owing routines a
9ea0: 72 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f re implementatio
9eb0: 6e 73 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 ns of the MemPag
9ec0: 65 2e 78 43 65 6c 6c 53 69 7a 65 0a 2a 2a 20 6d e.xCellSize.** m
9ed0: 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 43 6f 6d ethod..**.** Com
9ee0: 70 75 74 65 20 74 68 65 20 74 6f 74 61 6c 20 6e pute the total n
9ef0: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 umber of bytes t
9f00: 68 61 74 20 61 20 43 65 6c 6c 20 6e 65 65 64 73 hat a Cell needs
9f10: 20 69 6e 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 in the cell.**
9f20: 64 61 74 61 20 61 72 65 61 20 6f 66 20 74 68 65 data area of the
9f30: 20 62 74 72 65 65 2d 70 61 67 65 2e 20 20 54 68 btree-page. Th
9f40: 65 20 72 65 74 75 72 6e 20 6e 75 6d 62 65 72 20 e return number
9f50: 69 6e 63 6c 75 64 65 73 20 74 68 65 20 63 65 6c includes the cel
9f60: 6c 0a 2a 2a 20 64 61 74 61 20 68 65 61 64 65 72 l.** data header
9f70: 20 61 6e 64 20 74 68 65 20 6c 6f 63 61 6c 20 70 and the local p
9f80: 61 79 6c 6f 61 64 2c 20 62 75 74 20 6e 6f 74 20 ayload, but not
9f90: 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 any overflow pag
9fa0: 65 20 6f 72 0a 2a 2a 20 74 68 65 20 73 70 61 63 e or.** the spac
9fb0: 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 65 e used by the ce
9fc0: 6c 6c 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a ll pointer..**.*
9fd0: 2a 20 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 * cellSizePtrNoP
9fe0: 61 79 6c 6f 61 64 28 29 20 20 20 20 3d 3e 20 20 ayload() =>
9ff0: 20 74 61 62 6c 65 20 69 6e 74 65 72 6e 61 6c 20 table internal
a000: 6e 6f 64 65 73 0a 2a 2a 20 63 65 6c 6c 53 69 7a nodes.** cellSiz
a010: 65 50 74 72 28 29 20 20 20 20 20 20 20 20 20 20 ePtr()
a020: 20 20 20 3d 3e 20 20 20 61 6c 6c 20 69 6e 64 65 => all inde
a030: 78 20 6e 6f 64 65 73 20 26 20 74 61 62 6c 65 20 x nodes & table
a040: 6c 65 61 66 20 6e 6f 64 65 73 0a 2a 2f 0a 73 74 leaf nodes.*/.st
a050: 61 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a atic u16 cellSiz
a060: 65 50 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 ePtr(MemPage *pP
a070: 61 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c 29 7b age, u8 *pCell){
a080: 0a 20 20 75 38 20 2a 70 49 74 65 72 20 3d 20 70 . u8 *pIter = p
a090: 43 65 6c 6c 20 2b 20 70 50 61 67 65 2d 3e 63 68 Cell + pPage->ch
a0a0: 69 6c 64 50 74 72 53 69 7a 65 3b 20 2f 2a 20 46 ildPtrSize; /* F
a0b0: 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 or looping over
a0c0: 62 79 74 65 73 20 6f 66 20 70 43 65 6c 6c 20 2a bytes of pCell *
a0d0: 2f 0a 20 20 75 38 20 2a 70 45 6e 64 3b 20 20 20 /. u8 *pEnd;
a0e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a0f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
a100: 45 6e 64 20 6d 61 72 6b 20 66 6f 72 20 61 20 76 End mark for a v
a110: 61 72 69 6e 74 20 2a 2f 0a 20 20 75 33 32 20 6e arint */. u32 n
a120: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 Size;
a130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a140: 20 20 20 20 2f 2a 20 53 69 7a 65 20 76 61 6c 75 /* Size valu
a150: 65 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 0a e to return */..
a160: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
a170: 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 61 6c BUG. /* The val
a180: 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 ue returned by t
a190: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f his function sho
a1a0: 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 74 68 uld always be th
a1b0: 65 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a 20 74 e same as. ** t
a1c0: 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e 53 69 he (CellInfo.nSi
a1d0: 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 6e 64 20 ze) value found
a1e0: 62 79 20 64 6f 69 6e 67 20 61 20 66 75 6c 6c 20 by doing a full
a1f0: 70 61 72 73 65 20 6f 66 20 74 68 65 0a 20 20 2a parse of the. *
a200: 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c 49 54 * cell. If SQLIT
a210: 45 5f 44 45 42 55 47 20 69 73 20 64 65 66 69 6e E_DEBUG is defin
a220: 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 29 20 ed, an assert()
a230: 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 at the bottom of
a240: 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 . ** this funct
a250: 69 6f 6e 20 76 65 72 69 66 69 65 73 20 74 68 61 ion verifies tha
a260: 74 20 74 68 69 73 20 69 6e 76 61 72 69 61 6e 74 t this invariant
a270: 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 65 64 is not violated
a280: 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 . */. CellInfo
a290: 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 70 50 61 debuginfo;. pPa
a2a0: 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 ge->xParseCell(p
a2b0: 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 64 65 Page, pCell, &de
a2c0: 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6e 64 69 66 buginfo);.#endif
a2d0: 0a 0a 20 20 6e 53 69 7a 65 20 3d 20 2a 70 49 74 .. nSize = *pIt
a2e0: 65 72 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 3e er;. if( nSize>
a2f0: 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 70 45 6e =0x80 ){. pEn
a300: 64 20 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 d = &pIter[8];.
a310: 20 20 20 6e 53 69 7a 65 20 26 3d 20 30 78 37 66 nSize &= 0x7f
a320: 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 ;. do{.
a330: 6e 53 69 7a 65 20 3d 20 28 6e 53 69 7a 65 3c 3c nSize = (nSize<<
a340: 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 7) | (*++pIter &
a350: 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 69 0x7f);. }whi
a360: 6c 65 28 20 2a 28 70 49 74 65 72 29 3e 3d 30 78 le( *(pIter)>=0x
a370: 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 80 && pIter<pEnd
a380: 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b );. }. pIter+
a390: 2b 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e +;. if( pPage->
a3a0: 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 2f 2a intKey ){. /*
a3b0: 20 70 49 74 65 72 20 6e 6f 77 20 70 6f 69 6e 74 pIter now point
a3c0: 73 20 61 74 20 74 68 65 20 36 34 2d 62 69 74 20 s at the 64-bit
a3d0: 69 6e 74 65 67 65 72 20 6b 65 79 20 76 61 6c 75 integer key valu
a3e0: 65 2c 20 61 20 76 61 72 69 61 62 6c 65 20 6c 65 e, a variable le
a3f0: 6e 67 74 68 20 0a 20 20 20 20 2a 2a 20 69 6e 74 ngth . ** int
a400: 65 67 65 72 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 eger. The follow
a410: 69 6e 67 20 62 6c 6f 63 6b 20 6d 6f 76 65 73 20 ing block moves
a420: 70 49 74 65 72 20 74 6f 20 70 6f 69 6e 74 20 61 pIter to point a
a430: 74 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 t the first byte
a440: 0a 20 20 20 20 2a 2a 20 70 61 73 74 20 74 68 65 . ** past the
a450: 20 65 6e 64 20 6f 66 20 74 68 65 20 6b 65 79 20 end of the key
a460: 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 70 45 value. */. pE
a470: 6e 64 20 3d 20 26 70 49 74 65 72 5b 39 5d 3b 0a nd = &pIter[9];.
a480: 20 20 20 20 77 68 69 6c 65 28 20 28 2a 70 49 74 while( (*pIt
a490: 65 72 2b 2b 29 26 30 78 38 30 20 26 26 20 70 49 er++)&0x80 && pI
a4a0: 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a ter<pEnd );. }.
a4b0: 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a testcase( nSiz
a4c0: 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 e==pPage->maxLoc
a4d0: 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 al );. testcase
a4e0: 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e ( nSize==pPage->
a4f0: 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 maxLocal+1 );.
a500: 69 66 28 20 6e 53 69 7a 65 3c 3d 70 50 61 67 65 if( nSize<=pPage
a510: 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 ->maxLocal ){.
a520: 20 20 6e 53 69 7a 65 20 2b 3d 20 28 75 33 32 29 nSize += (u32)
a530: 28 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b (pIter - pCell);
a540: 0a 20 20 20 20 69 66 28 20 6e 53 69 7a 65 3c 34 . if( nSize<4
a550: 20 29 20 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 20 ) nSize = 4;.
a560: 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6d }else{. int m
a570: 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 61 67 65 2d inLocal = pPage-
a580: 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 20 20 6e >minLocal;. n
a590: 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 Size = minLocal
a5a0: 2b 20 28 6e 53 69 7a 65 20 2d 20 6d 69 6e 4c 6f + (nSize - minLo
a5b0: 63 61 6c 29 20 25 20 28 70 50 61 67 65 2d 3e 70 cal) % (pPage->p
a5c0: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
a5d0: 20 34 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 4);. testcas
a5e0: 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d e( nSize==pPage-
a5f0: 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 20 >maxLocal );.
a600: 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 testcase( nSize
a610: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
a620: 6c 2b 31 20 29 3b 0a 20 20 20 20 69 66 28 20 6e l+1 );. if( n
a630: 53 69 7a 65 3e 70 50 61 67 65 2d 3e 6d 61 78 4c Size>pPage->maxL
a640: 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 6e 53 ocal ){. nS
a650: 69 7a 65 20 3d 20 6d 69 6e 4c 6f 63 61 6c 3b 0a ize = minLocal;.
a660: 20 20 20 20 7d 0a 20 20 20 20 6e 53 69 7a 65 20 }. nSize
a670: 2b 3d 20 34 20 2b 20 28 75 31 36 29 28 70 49 74 += 4 + (u16)(pIt
a680: 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 7d er - pCell);. }
a690: 0a 20 20 61 73 73 65 72 74 28 20 6e 53 69 7a 65 . assert( nSize
a6a0: 3d 3d 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 7a ==debuginfo.nSiz
a6b0: 65 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 e || CORRUPT_DB
a6c0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 75 31 36 );. return (u16
a6d0: 29 6e 53 69 7a 65 3b 0a 7d 0a 73 74 61 74 69 63 )nSize;.}.static
a6e0: 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 50 74 72 u16 cellSizePtr
a6f0: 4e 6f 50 61 79 6c 6f 61 64 28 4d 65 6d 50 61 67 NoPayload(MemPag
a700: 65 20 2a 70 50 61 67 65 2c 20 75 38 20 2a 70 43 e *pPage, u8 *pC
a710: 65 6c 6c 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 ell){. u8 *pIte
a720: 72 20 3d 20 70 43 65 6c 6c 20 2b 20 34 3b 20 2f r = pCell + 4; /
a730: 2a 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 * For looping ov
a740: 65 72 20 62 79 74 65 73 20 6f 66 20 70 43 65 6c er bytes of pCel
a750: 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 45 6e 64 3b l */. u8 *pEnd;
a760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
a770: 20 45 6e 64 20 6d 61 72 6b 20 66 6f 72 20 61 20 End mark for a
a780: 76 61 72 69 6e 74 20 2a 2f 0a 0a 23 69 66 64 65 varint */..#ifde
a790: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
a7a0: 20 2f 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 /* The value re
a7b0: 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 20 66 turned by this f
a7c0: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 unction should a
a7d0: 6c 77 61 79 73 20 62 65 20 74 68 65 20 73 61 6d lways be the sam
a7e0: 65 20 61 73 0a 20 20 2a 2a 20 74 68 65 20 28 43 e as. ** the (C
a7f0: 65 6c 6c 49 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 ellInfo.nSize) v
a800: 61 6c 75 65 20 66 6f 75 6e 64 20 62 79 20 64 6f alue found by do
a810: 69 6e 67 20 61 20 66 75 6c 6c 20 70 61 72 73 65 ing a full parse
a820: 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 63 65 6c of the. ** cel
a830: 6c 2e 20 49 66 20 53 51 4c 49 54 45 5f 44 45 42 l. If SQLITE_DEB
a840: 55 47 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 UG is defined, a
a850: 6e 20 61 73 73 65 72 74 28 29 20 61 74 20 74 68 n assert() at th
a860: 65 20 62 6f 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a e bottom of. **
a870: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 76 this function v
a880: 65 72 69 66 69 65 73 20 74 68 61 74 20 74 68 69 erifies that thi
a890: 73 20 69 6e 76 61 72 69 61 6e 74 20 69 73 20 6e s invariant is n
a8a0: 6f 74 20 76 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a ot violated. */.
a8b0: 20 20 43 65 6c 6c 49 6e 66 6f 20 64 65 62 75 67 CellInfo debug
a8c0: 69 6e 66 6f 3b 0a 20 20 70 50 61 67 65 2d 3e 78 info;. pPage->x
a8d0: 50 61 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c ParseCell(pPage,
a8e0: 20 70 43 65 6c 6c 2c 20 26 64 65 62 75 67 69 6e pCell, &debugin
a8f0: 66 6f 29 3b 0a 23 65 6c 73 65 0a 20 20 55 4e 55 fo);.#else. UNU
a900: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 70 50 SED_PARAMETER(pP
a910: 61 67 65 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 age);.#endif..
a920: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 assert( pPage->c
a930: 68 69 6c 64 50 74 72 53 69 7a 65 3d 3d 34 20 29 hildPtrSize==4 )
a940: 3b 0a 20 20 70 45 6e 64 20 3d 20 70 49 74 65 72 ;. pEnd = pIter
a950: 20 2b 20 39 3b 0a 20 20 77 68 69 6c 65 28 20 28 + 9;. while( (
a960: 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 30 20 26 *pIter++)&0x80 &
a970: 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a & pIter<pEnd );.
a980: 20 20 61 73 73 65 72 74 28 20 64 65 62 75 67 69 assert( debugi
a990: 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 28 75 31 36 29 nfo.nSize==(u16)
a9a0: 28 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 20 (pIter - pCell)
a9b0: 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
a9c0: 0a 20 20 72 65 74 75 72 6e 20 28 75 31 36 29 28 . return (u16)(
a9d0: 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a pIter - pCell);.
a9e0: 7d 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 }...#ifdef SQLIT
a9f0: 45 5f 44 45 42 55 47 0a 2f 2a 20 54 68 69 73 20 E_DEBUG./* This
aa00: 76 61 72 69 61 74 69 6f 6e 20 6f 6e 20 63 65 6c variation on cel
aa10: 6c 53 69 7a 65 50 74 72 28 29 20 69 73 20 75 73 lSizePtr() is us
aa20: 65 64 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 ed inside of ass
aa30: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
aa40: 0a 2a 2a 20 6f 6e 6c 79 2e 20 2a 2f 0a 73 74 61 .** only. */.sta
aa50: 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 tic u16 cellSize
aa60: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
aa70: 20 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 20 72 int iCell){. r
aa80: 65 74 75 72 6e 20 70 50 61 67 65 2d 3e 78 43 65 eturn pPage->xCe
aa90: 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 66 69 llSize(pPage, fi
aaa0: 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 ndCell(pPage, iC
aab0: 65 6c 6c 29 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a ell));.}.#endif.
aac0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
aad0: 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
aae0: 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 65 6c /*.** If the cel
aaf0: 6c 20 70 43 65 6c 6c 2c 20 70 61 72 74 20 6f 66 l pCell, part of
ab00: 20 70 61 67 65 20 70 50 61 67 65 20 63 6f 6e 74 page pPage cont
ab10: 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 0a 2a ains a pointer.*
ab20: 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 * to an overflow
ab30: 20 70 61 67 65 2c 20 69 6e 73 65 72 74 20 61 6e page, insert an
ab40: 20 65 6e 74 72 79 20 69 6e 74 6f 20 74 68 65 20 entry into the
ab50: 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 2a 2a 20 66 pointer-map.** f
ab60: 6f 72 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 or the overflow
ab70: 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 page..*/.static
ab80: 76 6f 69 64 20 70 74 72 6d 61 70 50 75 74 4f 76 void ptrmapPutOv
ab90: 66 6c 50 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 flPtr(MemPage *p
aba0: 50 61 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c 2c Page, u8 *pCell,
abb0: 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 43 65 int *pRC){. Ce
abc0: 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 69 llInfo info;. i
abd0: 66 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e f( *pRC ) return
abe0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 65 6c ;. assert( pCel
abf0: 6c 21 3d 30 20 29 3b 0a 20 20 70 50 61 67 65 2d l!=0 );. pPage-
ac00: 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 61 67 >xParseCell(pPag
ac10: 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 e, pCell, &info)
ac20: 3b 0a 20 20 69 66 28 20 69 6e 66 6f 2e 6e 4c 6f ;. if( info.nLo
ac30: 63 61 6c 3c 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 cal<info.nPayloa
ac40: 64 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6f 76 d ){. Pgno ov
ac50: 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 fl = get4byte(&p
ac60: 43 65 6c 6c 5b 69 6e 66 6f 2e 6e 53 69 7a 65 2d Cell[info.nSize-
ac70: 34 5d 29 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 4]);. ptrmapP
ac80: 75 74 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 6f ut(pPage->pBt, o
ac90: 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 vfl, PTRMAP_OVER
aca0: 46 4c 4f 57 31 2c 20 70 50 61 67 65 2d 3e 70 67 FLOW1, pPage->pg
acb0: 6e 6f 2c 20 70 52 43 29 3b 0a 20 20 7d 0a 7d 0a no, pRC);. }.}.
acc0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 #endif.../*.** D
acd0: 65 66 72 61 67 6d 65 6e 74 20 74 68 65 20 70 61 efragment the pa
ace0: 67 65 20 67 69 76 65 6e 2e 20 20 41 6c 6c 20 43 ge given. All C
acf0: 65 6c 6c 73 20 61 72 65 20 6d 6f 76 65 64 20 74 ells are moved t
ad00: 6f 20 74 68 65 0a 2a 2a 20 65 6e 64 20 6f 66 20 o the.** end of
ad10: 74 68 65 20 70 61 67 65 20 61 6e 64 20 61 6c 6c the page and all
ad20: 20 66 72 65 65 20 73 70 61 63 65 20 69 73 20 63 free space is c
ad30: 6f 6c 6c 65 63 74 65 64 20 69 6e 74 6f 20 6f 6e ollected into on
ad40: 65 0a 2a 2a 20 62 69 67 20 46 72 65 65 42 6c 6b e.** big FreeBlk
ad50: 20 74 68 61 74 20 6f 63 63 75 72 73 20 69 6e 20 that occurs in
ad60: 62 65 74 77 65 65 6e 20 74 68 65 20 68 65 61 64 between the head
ad70: 65 72 20 61 6e 64 20 63 65 6c 6c 0a 2a 2a 20 70 er and cell.** p
ad80: 6f 69 6e 74 65 72 20 61 72 72 61 79 20 61 6e 64 ointer array and
ad90: 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e the cell conten
ada0: 74 20 61 72 65 61 2e 0a 2a 2a 0a 2a 2a 20 45 56 t area..**.** EV
adb0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 34 35 IDENCE-OF: R-445
adc0: 38 32 2d 36 30 31 33 38 20 53 51 4c 69 74 65 20 82-60138 SQLite
add0: 6d 61 79 20 66 72 6f 6d 20 74 69 6d 65 20 74 6f may from time to
ade0: 20 74 69 6d 65 20 72 65 6f 72 67 61 6e 69 7a 65 time reorganize
adf0: 20 61 0a 2a 2a 20 62 2d 74 72 65 65 20 70 61 67 a.** b-tree pag
ae00: 65 20 73 6f 20 74 68 61 74 20 74 68 65 72 65 20 e so that there
ae10: 61 72 65 20 6e 6f 20 66 72 65 65 62 6c 6f 63 6b are no freeblock
ae20: 73 20 6f 72 20 66 72 61 67 6d 65 6e 74 20 62 79 s or fragment by
ae30: 74 65 73 2c 20 61 6c 6c 0a 2a 2a 20 75 6e 75 73 tes, all.** unus
ae40: 65 64 20 62 79 74 65 73 20 61 72 65 20 63 6f 6e ed bytes are con
ae50: 74 61 69 6e 65 64 20 69 6e 20 74 68 65 20 75 6e tained in the un
ae60: 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 20 allocated space
ae70: 72 65 67 69 6f 6e 2c 20 61 6e 64 20 61 6c 6c 0a region, and all.
ae80: 2a 2a 20 63 65 6c 6c 73 20 61 72 65 20 70 61 63 ** cells are pac
ae90: 6b 65 64 20 74 69 67 68 74 6c 79 20 61 74 20 74 ked tightly at t
aea0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 he end of the pa
aeb0: 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ge..*/.static in
aec0: 74 20 64 65 66 72 61 67 6d 65 6e 74 50 61 67 65 t defragmentPage
aed0: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
aee0: 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 {. int i;
aef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
af00: 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
af10: 2f 0a 20 20 69 6e 74 20 70 63 3b 20 20 20 20 20 /. int pc;
af20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
af30: 2a 20 41 64 64 72 65 73 73 20 6f 66 20 74 68 65 * Address of the
af40: 20 69 2d 74 68 20 63 65 6c 6c 20 2a 2f 0a 20 20 i-th cell */.
af50: 69 6e 74 20 68 64 72 3b 20 20 20 20 20 20 20 20 int hdr;
af60: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 /* Of
af70: 66 73 65 74 20 74 6f 20 74 68 65 20 70 61 67 65 fset to the page
af80: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74 header */. int
af90: 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 size;
afa0: 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
afb0: 6f 66 20 61 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 of a cell */. i
afc0: 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b 20 20 nt usableSize;
afd0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
afe0: 62 65 72 20 6f 66 20 75 73 61 62 6c 65 20 62 79 ber of usable by
aff0: 74 65 73 20 6f 6e 20 61 20 70 61 67 65 20 2a 2f tes on a page */
b000: 0a 20 20 69 6e 74 20 63 65 6c 6c 4f 66 66 73 65 . int cellOffse
b010: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t; /*
b020: 20 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 Offset to the c
b030: 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 ell pointer arra
b040: 79 20 2a 2f 0a 20 20 69 6e 74 20 63 62 72 6b 3b y */. int cbrk;
b050: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b060: 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 /* Offset to t
b070: 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
b080: 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 area */. int nC
b090: 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
b0a0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
b0b0: 66 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 70 f cells on the p
b0c0: 61 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 age */. unsigne
b0d0: 64 20 63 68 61 72 20 2a 64 61 74 61 3b 20 20 20 d char *data;
b0e0: 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 /* The page
b0f0: 64 61 74 61 20 2a 2f 0a 20 20 75 6e 73 69 67 6e data */. unsign
b100: 65 64 20 63 68 61 72 20 2a 74 65 6d 70 3b 20 20 ed char *temp;
b110: 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 61 72 65 /* Temp are
b120: 61 20 66 6f 72 20 63 65 6c 6c 20 63 6f 6e 74 65 a for cell conte
b130: 6e 74 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 nt */. unsigned
b140: 20 63 68 61 72 20 2a 73 72 63 3b 20 20 20 20 20 char *src;
b150: 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 6f 66 20 /* Source of
b160: 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 content */. int
b170: 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 20 20 20 iCellFirst;
b180: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
b190: 20 61 6c 6c 6f 77 61 62 6c 65 20 63 65 6c 6c 20 allowable cell
b1a0: 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 69 index */. int i
b1b0: 43 65 6c 6c 4c 61 73 74 3b 20 20 20 20 20 20 20 CellLast;
b1c0: 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 70 6f /* Last po
b1d0: 73 73 69 62 6c 65 20 63 65 6c 6c 20 69 6e 64 65 ssible cell inde
b1e0: 78 20 2a 2f 0a 0a 0a 20 20 61 73 73 65 72 74 28 x */... assert(
b1f0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
b200: 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
b210: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
b220: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 sert( pPage->pBt
b230: 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
b240: 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 pPage->pBt->usa
b250: 62 6c 65 53 69 7a 65 20 3c 3d 20 53 51 4c 49 54 bleSize <= SQLIT
b260: 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 E_MAX_PAGE_SIZE
b270: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
b280: 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 ge->nOverflow==0
b290: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
b2a0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
b2b0: 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
b2c0: 65 78 29 20 29 3b 0a 20 20 74 65 6d 70 20 3d 20 ex) );. temp =
b2d0: 30 3b 0a 20 20 73 72 63 20 3d 20 64 61 74 61 20 0;. src = data
b2e0: 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a = pPage->aData;.
b2f0: 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 hdr = pPage->h
b300: 64 72 4f 66 66 73 65 74 3b 0a 20 20 63 65 6c 6c drOffset;. cell
b310: 4f 66 66 73 65 74 20 3d 20 70 50 61 67 65 2d 3e Offset = pPage->
b320: 63 65 6c 6c 4f 66 66 73 65 74 3b 0a 20 20 6e 43 cellOffset;. nC
b330: 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 ell = pPage->nCe
b340: 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 43 ll;. assert( nC
b350: 65 6c 6c 3d 3d 67 65 74 32 62 79 74 65 28 26 64 ell==get2byte(&d
b360: 61 74 61 5b 68 64 72 2b 33 5d 29 20 29 3b 0a 20 ata[hdr+3]) );.
b370: 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 usableSize = pP
b380: 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
b390: 53 69 7a 65 3b 0a 20 20 63 62 72 6b 20 3d 20 75 Size;. cbrk = u
b3a0: 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 69 43 65 sableSize;. iCe
b3b0: 6c 6c 46 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 llFirst = cellOf
b3c0: 66 73 65 74 20 2b 20 32 2a 6e 43 65 6c 6c 3b 0a fset + 2*nCell;.
b3d0: 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 iCellLast = us
b3e0: 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
b3f0: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c for(i=0; i<nCell
b400: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a ; i++){. u8 *
b410: 70 41 64 64 72 3b 20 20 20 20 20 2f 2a 20 54 68 pAddr; /* Th
b420: 65 20 69 2d 74 68 20 63 65 6c 6c 20 70 6f 69 6e e i-th cell poin
b430: 74 65 72 20 2a 2f 0a 20 20 20 20 70 41 64 64 72 ter */. pAddr
b440: 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 = &data[cellOff
b450: 73 65 74 20 2b 20 69 2a 32 5d 3b 0a 20 20 20 20 set + i*2];.
b460: 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 70 41 pc = get2byte(pA
b470: 64 64 72 29 3b 0a 20 20 20 20 74 65 73 74 63 61 ddr);. testca
b480: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 se( pc==iCellFir
b490: 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 st );. testca
b4a0: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 se( pc==iCellLas
b4b0: 74 20 29 3b 0a 20 20 20 20 2f 2a 20 54 68 65 73 t );. /* Thes
b4c0: 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 68 61 76 e conditions hav
b4d0: 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 76 e already been v
b4e0: 65 72 69 66 69 65 64 20 69 6e 20 62 74 72 65 65 erified in btree
b4f0: 49 6e 69 74 50 61 67 65 28 29 0a 20 20 20 20 2a InitPage(). *
b500: 2a 20 69 66 20 50 52 41 47 4d 41 20 63 65 6c 6c * if PRAGMA cell
b510: 5f 73 69 7a 65 5f 63 68 65 63 6b 3d 4f 4e 2e 0a _size_check=ON..
b520: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 */. if( p
b530: 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 c<iCellFirst ||
b540: 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
b550: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
b560: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
b570: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
b580: 72 74 28 20 70 63 3e 3d 69 43 65 6c 6c 46 69 72 rt( pc>=iCellFir
b590: 73 74 20 26 26 20 70 63 3c 3d 69 43 65 6c 6c 4c st && pc<=iCellL
b5a0: 61 73 74 20 29 3b 0a 20 20 20 20 73 69 7a 65 20 ast );. size
b5b0: 3d 20 70 50 61 67 65 2d 3e 78 43 65 6c 6c 53 69 = pPage->xCellSi
b5c0: 7a 65 28 70 50 61 67 65 2c 20 26 73 72 63 5b 70 ze(pPage, &src[p
b5d0: 63 5d 29 3b 0a 20 20 20 20 63 62 72 6b 20 2d 3d c]);. cbrk -=
b5e0: 20 73 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 63 size;. if( c
b5f0: 62 72 6b 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c brk<iCellFirst |
b600: 7c 20 70 63 2b 73 69 7a 65 3e 75 73 61 62 6c 65 | pc+size>usable
b610: 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72 65 Size ){. re
b620: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
b630: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a UPT_BKPT;. }.
b640: 20 20 20 20 61 73 73 65 72 74 28 20 63 62 72 6b assert( cbrk
b650: 2b 73 69 7a 65 3c 3d 75 73 61 62 6c 65 53 69 7a +size<=usableSiz
b660: 65 20 26 26 20 63 62 72 6b 3e 3d 69 43 65 6c 6c e && cbrk>=iCell
b670: 46 69 72 73 74 20 29 3b 0a 20 20 20 20 74 65 73 First );. tes
b680: 74 63 61 73 65 28 20 63 62 72 6b 2b 73 69 7a 65 tcase( cbrk+size
b690: 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ==usableSize );.
b6a0: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
b6b0: 2b 73 69 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a +size==usableSiz
b6c0: 65 20 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 e );. put2byt
b6d0: 65 28 70 41 64 64 72 2c 20 63 62 72 6b 29 3b 0a e(pAddr, cbrk);.
b6e0: 20 20 20 20 69 66 28 20 74 65 6d 70 3d 3d 30 20 if( temp==0
b6f0: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 78 3b 0a ){. int x;.
b700: 20 20 20 20 20 20 69 66 28 20 63 62 72 6b 3d 3d if( cbrk==
b710: 70 63 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 pc ) continue;.
b720: 20 20 20 20 20 74 65 6d 70 20 3d 20 73 71 6c 69 temp = sqli
b730: 74 65 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 te3PagerTempSpac
b740: 65 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 50 e(pPage->pBt->pP
b750: 61 67 65 72 29 3b 0a 20 20 20 20 20 20 78 20 3d ager);. x =
b760: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
b770: 68 64 72 2b 35 5d 29 3b 0a 20 20 20 20 20 20 6d hdr+5]);. m
b780: 65 6d 63 70 79 28 26 74 65 6d 70 5b 78 5d 2c 20 emcpy(&temp[x],
b790: 26 64 61 74 61 5b 78 5d 2c 20 28 63 62 72 6b 2b &data[x], (cbrk+
b7a0: 73 69 7a 65 29 20 2d 20 78 29 3b 0a 20 20 20 20 size) - x);.
b7b0: 20 20 73 72 63 20 3d 20 74 65 6d 70 3b 0a 20 20 src = temp;.
b7c0: 20 20 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 }. memcpy(&
b7d0: 64 61 74 61 5b 63 62 72 6b 5d 2c 20 26 73 72 63 data[cbrk], &src
b7e0: 5b 70 63 5d 2c 20 73 69 7a 65 29 3b 0a 20 20 7d [pc], size);. }
b7f0: 0a 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 3e . assert( cbrk>
b800: 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 =iCellFirst );.
b810: 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b put2byte(&data[
b820: 68 64 72 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a 20 hdr+5], cbrk);.
b830: 20 64 61 74 61 5b 68 64 72 2b 31 5d 20 3d 20 30 data[hdr+1] = 0
b840: 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 32 5d 20 ;. data[hdr+2]
b850: 3d 20 30 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b = 0;. data[hdr+
b860: 37 5d 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 7] = 0;. memset
b870: 28 26 64 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 (&data[iCellFirs
b880: 74 5d 2c 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c t], 0, cbrk-iCel
b890: 6c 46 69 72 73 74 29 3b 0a 20 20 61 73 73 65 72 lFirst);. asser
b8a0: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
b8b0: 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
b8c0: 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
b8d0: 69 66 28 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 if( cbrk-iCellFi
b8e0: 72 73 74 21 3d 70 50 61 67 65 2d 3e 6e 46 72 65 rst!=pPage->nFre
b8f0: 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 e ){. return
b900: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
b910: 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 KPT;. }. retur
b920: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
b930: 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 74 68 65 /*.** Search the
b940: 20 66 72 65 65 2d 6c 69 73 74 20 6f 6e 20 70 61 free-list on pa
b950: 67 65 20 70 50 67 20 66 6f 72 20 73 70 61 63 65 ge pPg for space
b960: 20 74 6f 20 73 74 6f 72 65 20 61 20 63 65 6c 6c to store a cell
b970: 20 6e 42 79 74 65 20 62 79 74 65 73 20 69 6e 0a nByte bytes in.
b980: 2a 2a 20 73 69 7a 65 2e 20 49 66 20 6f 6e 65 20 ** size. If one
b990: 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 72 65 can be found, re
b9a0: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 turn a pointer t
b9b0: 6f 20 74 68 65 20 73 70 61 63 65 20 61 6e 64 20 o the space and
b9c0: 72 65 6d 6f 76 65 20 69 74 0a 2a 2a 20 66 72 6f remove it.** fro
b9d0: 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e m the free-list.
b9e0: 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 73 75 69 .**.** If no sui
b9f0: 74 61 62 6c 65 20 73 70 61 63 65 20 63 61 6e 20 table space can
ba00: 62 65 20 66 6f 75 6e 64 20 6f 6e 20 74 68 65 20 be found on the
ba10: 66 72 65 65 2d 6c 69 73 74 2c 20 72 65 74 75 72 free-list, retur
ba20: 6e 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 54 68 n NULL..**.** Th
ba30: 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 is function may
ba40: 64 65 74 65 63 74 20 63 6f 72 72 75 70 74 69 6f detect corruptio
ba50: 6e 20 77 69 74 68 69 6e 20 70 50 67 2e 20 20 49 n within pPg. I
ba60: 66 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 73 0a f corruption is.
ba70: 2a 2a 20 64 65 74 65 63 74 65 64 20 74 68 65 6e ** detected then
ba80: 20 2a 70 52 63 20 69 73 20 73 65 74 20 74 6f 20 *pRc is set to
ba90: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 61 SQLITE_CORRUPT a
baa0: 6e 64 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 nd NULL is retur
bab0: 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 6c 6f 74 73 ned..**.** Slots
bac0: 20 6f 6e 20 74 68 65 20 66 72 65 65 20 6c 69 73 on the free lis
bad0: 74 20 74 68 61 74 20 61 72 65 20 62 65 74 77 65 t that are betwe
bae0: 65 6e 20 31 20 61 6e 64 20 33 20 62 79 74 65 73 en 1 and 3 bytes
baf0: 20 6c 61 72 67 65 72 20 74 68 61 6e 20 6e 42 79 larger than nBy
bb00: 74 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 20 69 67 te.** will be ig
bb10: 6e 6f 72 65 64 20 69 66 20 61 64 64 69 6e 67 20 nored if adding
bb20: 74 68 65 20 65 78 74 72 61 20 73 70 61 63 65 20 the extra space
bb30: 74 6f 20 74 68 65 20 66 72 61 67 6d 65 6e 74 61 to the fragmenta
bb40: 74 69 6f 6e 20 63 6f 75 6e 74 0a 2a 2a 20 63 61 tion count.** ca
bb50: 75 73 65 73 20 74 68 65 20 66 72 61 67 6d 65 6e uses the fragmen
bb60: 74 61 74 69 6f 6e 20 63 6f 75 6e 74 20 74 6f 20 tation count to
bb70: 65 78 63 65 65 64 20 36 30 2e 0a 2a 2f 0a 73 74 exceed 60..*/.st
bb80: 61 74 69 63 20 75 38 20 2a 70 61 67 65 46 69 6e atic u8 *pageFin
bb90: 64 53 6c 6f 74 28 4d 65 6d 50 61 67 65 20 2a 70 dSlot(MemPage *p
bba0: 50 67 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 69 Pg, int nByte, i
bbb0: 6e 74 20 2a 70 52 63 29 7b 0a 20 20 63 6f 6e 73 nt *pRc){. cons
bbc0: 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 67 2d t int hdr = pPg-
bbd0: 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 75 38 >hdrOffset;. u8
bbe0: 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 61 20 3d * const aData =
bbf0: 20 70 50 67 2d 3e 61 44 61 74 61 3b 0a 20 20 69 pPg->aData;. i
bc00: 6e 74 20 69 41 64 64 72 20 3d 20 68 64 72 20 2b nt iAddr = hdr +
bc10: 20 31 3b 0a 20 20 69 6e 74 20 70 63 20 3d 20 67 1;. int pc = g
bc20: 65 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 69 et2byte(&aData[i
bc30: 41 64 64 72 5d 29 3b 0a 20 20 69 6e 74 20 78 3b Addr]);. int x;
bc40: 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a . int usableSiz
bc50: 65 20 3d 20 70 50 67 2d 3e 70 42 74 2d 3e 75 73 e = pPg->pBt->us
bc60: 61 62 6c 65 53 69 7a 65 3b 0a 0a 20 20 61 73 73 ableSize;.. ass
bc70: 65 72 74 28 20 70 63 3e 30 20 29 3b 0a 20 20 64 ert( pc>0 );. d
bc80: 6f 7b 0a 20 20 20 20 69 6e 74 20 73 69 7a 65 3b o{. int size;
bc90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
bca0: 69 7a 65 20 6f 66 20 74 68 65 20 66 72 65 65 20 ize of the free
bcb0: 73 6c 6f 74 20 2a 2f 0a 20 20 20 20 2f 2a 20 45 slot */. /* E
bcc0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 36 VIDENCE-OF: R-06
bcd0: 38 36 36 2d 33 39 31 32 35 20 46 72 65 65 62 6c 866-39125 Freebl
bce0: 6f 63 6b 73 20 61 72 65 20 61 6c 77 61 79 73 20 ocks are always
bcf0: 63 6f 6e 6e 65 63 74 65 64 20 69 6e 20 6f 72 64 connected in ord
bd00: 65 72 20 6f 66 0a 20 20 20 20 2a 2a 20 69 6e 63 er of. ** inc
bd10: 72 65 61 73 69 6e 67 20 6f 66 66 73 65 74 2e 20 reasing offset.
bd20: 2a 2f 0a 20 20 20 20 69 66 28 20 70 63 3e 75 73 */. if( pc>us
bd30: 61 62 6c 65 53 69 7a 65 2d 34 20 7c 7c 20 70 63 ableSize-4 || pc
bd40: 3c 69 41 64 64 72 2b 34 20 29 7b 0a 20 20 20 20 <iAddr+4 ){.
bd50: 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 5f *pRc = SQLITE_
bd60: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
bd70: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
bd80: 20 20 7d 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 }. /* EVIDE
bd90: 4e 43 45 2d 4f 46 3a 20 52 2d 32 32 37 31 30 2d NCE-OF: R-22710-
bda0: 35 33 33 32 38 20 54 68 65 20 74 68 69 72 64 20 53328 The third
bdb0: 61 6e 64 20 66 6f 75 72 74 68 20 62 79 74 65 73 and fourth bytes
bdc0: 20 6f 66 20 65 61 63 68 0a 20 20 20 20 2a 2a 20 of each. **
bdd0: 66 72 65 65 62 6c 6f 63 6b 20 66 6f 72 6d 20 61 freeblock form a
bde0: 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 big-endian inte
bdf0: 67 65 72 20 77 68 69 63 68 20 69 73 20 74 68 65 ger which is the
be00: 20 73 69 7a 65 20 6f 66 20 74 68 65 20 66 72 65 size of the fre
be10: 65 62 6c 6f 63 6b 0a 20 20 20 20 2a 2a 20 69 6e eblock. ** in
be20: 20 62 79 74 65 73 2c 20 69 6e 63 6c 75 64 69 6e bytes, includin
be30: 67 20 74 68 65 20 34 2d 62 79 74 65 20 68 65 61 g the 4-byte hea
be40: 64 65 72 2e 20 2a 2f 0a 20 20 20 20 73 69 7a 65 der. */. size
be50: 20 3d 20 67 65 74 32 62 79 74 65 28 26 61 44 61 = get2byte(&aDa
be60: 74 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 20 69 ta[pc+2]);. i
be70: 66 28 20 28 78 20 3d 20 73 69 7a 65 20 2d 20 6e f( (x = size - n
be80: 42 79 74 65 29 3e 3d 30 20 29 7b 0a 20 20 20 20 Byte)>=0 ){.
be90: 20 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d 34 testcase( x==4
bea0: 20 29 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 );. testca
beb0: 73 65 28 20 78 3d 3d 33 20 29 3b 0a 20 20 20 20 se( x==3 );.
bec0: 20 20 69 66 28 20 70 63 20 3c 20 70 50 67 2d 3e if( pc < pPg->
bed0: 63 65 6c 6c 4f 66 66 73 65 74 2b 32 2a 70 50 67 cellOffset+2*pPg
bee0: 2d 3e 6e 43 65 6c 6c 20 7c 7c 20 73 69 7a 65 2b ->nCell || size+
bef0: 70 63 20 3e 20 75 73 61 62 6c 65 53 69 7a 65 20 pc > usableSize
bf00: 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 52 63 20 ){. *pRc
bf10: 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
bf20: 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 72 _BKPT;. r
bf30: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 20 20 7d eturn 0;. }
bf40: 65 6c 73 65 20 69 66 28 20 78 3c 34 20 29 7b 0a else if( x<4 ){.
bf50: 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 /* EVIDE
bf60: 4e 43 45 2d 4f 46 3a 20 52 2d 31 31 34 39 38 2d NCE-OF: R-11498-
bf70: 35 38 30 32 32 20 49 6e 20 61 20 77 65 6c 6c 2d 58022 In a well-
bf80: 66 6f 72 6d 65 64 20 62 2d 74 72 65 65 20 70 61 formed b-tree pa
bf90: 67 65 2c 20 74 68 65 20 74 6f 74 61 6c 0a 20 20 ge, the total.
bfa0: 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 ** number
bfb0: 6f 66 20 62 79 74 65 73 20 69 6e 20 66 72 61 67 of bytes in frag
bfc0: 6d 65 6e 74 73 20 6d 61 79 20 6e 6f 74 20 65 78 ments may not ex
bfd0: 63 65 65 64 20 36 30 2e 20 2a 2f 0a 20 20 20 20 ceed 60. */.
bfe0: 20 20 20 20 69 66 28 20 61 44 61 74 61 5b 68 64 if( aData[hd
bff0: 72 2b 37 5d 3e 35 37 20 29 20 72 65 74 75 72 6e r+7]>57 ) return
c000: 20 30 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 0;.. /*
c010: 52 65 6d 6f 76 65 20 74 68 65 20 73 6c 6f 74 20 Remove the slot
c020: 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 from the free-li
c030: 73 74 2e 20 55 70 64 61 74 65 20 74 68 65 20 6e st. Update the n
c040: 75 6d 62 65 72 20 6f 66 0a 20 20 20 20 20 20 20 umber of.
c050: 20 2a 2a 20 66 72 61 67 6d 65 6e 74 65 64 20 62 ** fragmented b
c060: 79 74 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 ytes within the
c070: 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 page. */.
c080: 20 6d 65 6d 63 70 79 28 26 61 44 61 74 61 5b 69 memcpy(&aData[i
c090: 41 64 64 72 5d 2c 20 26 61 44 61 74 61 5b 70 63 Addr], &aData[pc
c0a0: 5d 2c 20 32 29 3b 0a 20 20 20 20 20 20 20 20 61 ], 2);. a
c0b0: 44 61 74 61 5b 68 64 72 2b 37 5d 20 2b 3d 20 28 Data[hdr+7] += (
c0c0: 75 38 29 78 3b 0a 20 20 20 20 20 20 7d 65 6c 73 u8)x;. }els
c0d0: 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 e{. /* Th
c0e0: 65 20 73 6c 6f 74 20 72 65 6d 61 69 6e 73 20 6f e slot remains o
c0f0: 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e n the free-list.
c100: 20 52 65 64 75 63 65 20 69 74 73 20 73 69 7a 65 Reduce its size
c110: 20 74 6f 20 61 63 63 6f 75 6e 74 0a 20 20 20 20 to account.
c120: 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 68 65 20 ** for the
c130: 70 6f 72 74 69 6f 6e 20 75 73 65 64 20 62 79 20 portion used by
c140: 74 68 65 20 6e 65 77 20 61 6c 6c 6f 63 61 74 69 the new allocati
c150: 6f 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 on. */. p
c160: 75 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 ut2byte(&aData[p
c170: 63 2b 32 5d 2c 20 78 29 3b 0a 20 20 20 20 20 20 c+2], x);.
c180: 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 26 }. return &
c190: 61 44 61 74 61 5b 70 63 20 2b 20 78 5d 3b 0a 20 aData[pc + x];.
c1a0: 20 20 20 7d 0a 20 20 20 20 69 41 64 64 72 20 3d }. iAddr =
c1b0: 20 70 63 3b 0a 20 20 20 20 70 63 20 3d 20 67 65 pc;. pc = ge
c1c0: 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 63 t2byte(&aData[pc
c1d0: 5d 29 3b 0a 20 20 7d 77 68 69 6c 65 28 20 70 63 ]);. }while( pc
c1e0: 20 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 30 3b );.. return 0;
c1f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 .}../*.** Alloca
c200: 74 65 20 6e 42 79 74 65 20 62 79 74 65 73 20 6f te nByte bytes o
c210: 66 20 73 70 61 63 65 20 66 72 6f 6d 20 77 69 74 f space from wit
c220: 68 69 6e 20 74 68 65 20 42 2d 54 72 65 65 20 70 hin the B-Tree p
c230: 61 67 65 20 70 61 73 73 65 64 0a 2a 2a 20 61 73 age passed.** as
c240: 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d the first argum
c250: 65 6e 74 2e 20 57 72 69 74 65 20 69 6e 74 6f 20 ent. Write into
c260: 2a 70 49 64 78 20 74 68 65 20 69 6e 64 65 78 20 *pIdx the index
c270: 69 6e 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 into pPage->aDat
c280: 61 5b 5d 0a 2a 2a 20 6f 66 20 74 68 65 20 66 69 a[].** of the fi
c290: 72 73 74 20 62 79 74 65 20 6f 66 20 61 6c 6c 6f rst byte of allo
c2a0: 63 61 74 65 64 20 73 70 61 63 65 2e 20 52 65 74 cated space. Ret
c2b0: 75 72 6e 20 65 69 74 68 65 72 20 53 51 4c 49 54 urn either SQLIT
c2c0: 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 61 6e 20 65 72 E_OK or.** an er
c2d0: 72 6f 72 20 63 6f 64 65 20 28 75 73 75 61 6c 6c ror code (usuall
c2e0: 79 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 y SQLITE_CORRUPT
c2f0: 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c )..**.** The cal
c300: 6c 65 72 20 67 75 61 72 61 6e 74 65 65 73 20 74 ler guarantees t
c310: 68 61 74 20 74 68 65 72 65 20 69 73 20 73 75 66 hat there is suf
c320: 66 69 63 69 65 6e 74 20 73 70 61 63 65 20 74 6f ficient space to
c330: 20 6d 61 6b 65 20 74 68 65 0a 2a 2a 20 61 6c 6c make the.** all
c340: 6f 63 61 74 69 6f 6e 2e 20 20 54 68 69 73 20 72 ocation. This r
c350: 6f 75 74 69 6e 65 20 6d 69 67 68 74 20 6e 65 65 outine might nee
c360: 64 20 74 6f 20 64 65 66 72 61 67 6d 65 6e 74 20 d to defragment
c370: 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 72 69 6e in order to brin
c380: 67 0a 2a 2a 20 61 6c 6c 20 74 68 65 20 73 70 61 g.** all the spa
c390: 63 65 20 74 6f 67 65 74 68 65 72 2c 20 68 6f 77 ce together, how
c3a0: 65 76 65 72 2e 20 20 54 68 69 73 20 72 6f 75 74 ever. This rout
c3b0: 69 6e 65 20 77 69 6c 6c 20 61 76 6f 69 64 20 75 ine will avoid u
c3c0: 73 69 6e 67 0a 2a 2a 20 74 68 65 20 66 69 72 73 sing.** the firs
c3d0: 74 20 74 77 6f 20 62 79 74 65 73 20 70 61 73 74 t two bytes past
c3e0: 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 the cell pointe
c3f0: 72 20 61 72 65 61 20 73 69 6e 63 65 20 70 72 65 r area since pre
c400: 73 75 6d 61 62 6c 79 20 74 68 69 73 0a 2a 2a 20 sumably this.**
c410: 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 62 65 allocation is be
c420: 69 6e 67 20 6d 61 64 65 20 69 6e 20 6f 72 64 65 ing made in orde
c430: 72 20 74 6f 20 69 6e 73 65 72 74 20 61 20 6e 65 r to insert a ne
c440: 77 20 63 65 6c 6c 2c 20 73 6f 20 77 65 20 77 69 w cell, so we wi
c450: 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 65 6e 64 20 75 ll.** also end u
c460: 70 20 6e 65 65 64 69 6e 67 20 61 20 6e 65 77 20 p needing a new
c470: 63 65 6c 6c 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f cell pointer..*/
c480: 0a 73 74 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f .static int allo
c490: 63 61 74 65 53 70 61 63 65 28 4d 65 6d 50 61 67 cateSpace(MemPag
c4a0: 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 6e 42 e *pPage, int nB
c4b0: 79 74 65 2c 20 69 6e 74 20 2a 70 49 64 78 29 7b yte, int *pIdx){
c4c0: 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 64 72 . const int hdr
c4d0: 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 = pPage->hdrOff
c4e0: 73 65 74 3b 20 20 20 20 2f 2a 20 4c 6f 63 61 6c set; /* Local
c4f0: 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 65 2d cache of pPage-
c500: 3e 68 64 72 4f 66 66 73 65 74 20 2a 2f 0a 20 20 >hdrOffset */.
c510: 75 38 20 2a 20 63 6f 6e 73 74 20 64 61 74 61 20 u8 * const data
c520: 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 = pPage->aData;
c530: 20 20 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 63 61 /* Local ca
c540: 63 68 65 20 6f 66 20 70 50 61 67 65 2d 3e 61 44 che of pPage->aD
c550: 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 74 6f 70 ata */. int top
c560: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
c570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c580: 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 63 First byte of c
c590: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
c5a0: 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 */. int rc = S
c5b0: 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 QLITE_OK;
c5c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
c5d0: 74 65 67 65 72 20 72 65 74 75 72 6e 20 63 6f 64 teger return cod
c5e0: 65 20 2a 2f 0a 20 20 69 6e 74 20 67 61 70 3b 20 e */. int gap;
c5f0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
c600: 62 79 74 65 20 6f 66 20 67 61 70 20 62 65 74 77 byte of gap betw
c610: 65 65 6e 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 een cell pointer
c620: 73 20 61 6e 64 20 63 65 6c 6c 20 63 6f 6e 74 65 s and cell conte
c630: 6e 74 20 2a 2f 0a 20 20 0a 20 20 61 73 73 65 72 nt */. . asser
c640: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
c650: 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
c660: 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
c670: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 assert( pPage->p
c680: 42 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 Bt );. assert(
c690: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
c6a0: 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d ld(pPage->pBt->m
c6b0: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
c6c0: 74 28 20 6e 42 79 74 65 3e 3d 30 20 29 3b 20 20 t( nByte>=0 );
c6d0: 2f 2a 20 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 /* Minimum cell
c6e0: 73 69 7a 65 20 69 73 20 34 20 2a 2f 0a 20 20 61 size is 4 */. a
c6f0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 46 ssert( pPage->nF
c700: 72 65 65 3e 3d 6e 42 79 74 65 20 29 3b 0a 20 20 ree>=nByte );.
c710: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e assert( pPage->n
c720: 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 Overflow==0 );.
c730: 20 61 73 73 65 72 74 28 20 6e 42 79 74 65 20 3c assert( nByte <
c740: 20 28 69 6e 74 29 28 70 50 61 67 65 2d 3e 70 42 (int)(pPage->pB
c750: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 38 29 t->usableSize-8)
c760: 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 );.. assert( p
c770: 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 Page->cellOffset
c780: 20 3d 3d 20 68 64 72 20 2b 20 31 32 20 2d 20 34 == hdr + 12 - 4
c790: 2a 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 3b 0a *pPage->leaf );.
c7a0: 20 20 67 61 70 20 3d 20 70 50 61 67 65 2d 3e 63 gap = pPage->c
c7b0: 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 50 ellOffset + 2*pP
c7c0: 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 61 73 age->nCell;. as
c7d0: 73 65 72 74 28 20 67 61 70 3c 3d 36 35 35 33 36 sert( gap<=65536
c7e0: 20 29 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 );. /* EVIDENC
c7f0: 45 2d 4f 46 3a 20 52 2d 32 39 33 35 36 2d 30 32 E-OF: R-29356-02
c800: 33 39 31 20 49 66 20 74 68 65 20 64 61 74 61 62 391 If the datab
c810: 61 73 65 20 75 73 65 73 20 61 20 36 35 35 33 36 ase uses a 65536
c820: 2d 62 79 74 65 20 70 61 67 65 20 73 69 7a 65 0a -byte page size.
c830: 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 72 65 73 ** and the res
c840: 65 72 76 65 64 20 73 70 61 63 65 20 69 73 20 7a erved space is z
c850: 65 72 6f 20 28 74 68 65 20 75 73 75 61 6c 20 76 ero (the usual v
c860: 61 6c 75 65 20 66 6f 72 20 72 65 73 65 72 76 65 alue for reserve
c870: 64 20 73 70 61 63 65 29 0a 20 20 2a 2a 20 74 68 d space). ** th
c880: 65 6e 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 en the cell cont
c890: 65 6e 74 20 6f 66 66 73 65 74 20 6f 66 20 61 6e ent offset of an
c8a0: 20 65 6d 70 74 79 20 70 61 67 65 20 77 61 6e 74 empty page want
c8b0: 73 20 74 6f 20 62 65 20 36 35 35 33 36 2e 0a 20 s to be 65536..
c8c0: 20 2a 2a 20 48 6f 77 65 76 65 72 2c 20 74 68 61 ** However, tha
c8d0: 74 20 69 6e 74 65 67 65 72 20 69 73 20 74 6f 6f t integer is too
c8e0: 20 6c 61 72 67 65 20 74 6f 20 62 65 20 73 74 6f large to be sto
c8f0: 72 65 64 20 69 6e 20 61 20 32 2d 62 79 74 65 20 red in a 2-byte
c900: 75 6e 73 69 67 6e 65 64 0a 20 20 2a 2a 20 69 6e unsigned. ** in
c910: 74 65 67 65 72 2c 20 73 6f 20 61 20 76 61 6c 75 teger, so a valu
c920: 65 20 6f 66 20 30 20 69 73 20 75 73 65 64 20 69 e of 0 is used i
c930: 6e 20 69 74 73 20 70 6c 61 63 65 2e 20 2a 2f 0a n its place. */.
c940: 20 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 top = get2byte
c950: 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a (&data[hdr+5]);.
c960: 20 20 61 73 73 65 72 74 28 20 74 6f 70 3c 3d 28 assert( top<=(
c970: 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e int)pPage->pBt->
c980: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 20 2f 2a usableSize ); /*
c990: 20 50 72 65 76 65 6e 74 20 62 79 20 67 65 74 41 Prevent by getA
c9a0: 6e 64 49 6e 69 74 50 61 67 65 28 29 20 2a 2f 0a ndInitPage() */.
c9b0: 20 20 69 66 28 20 67 61 70 3e 74 6f 70 20 29 7b if( gap>top ){
c9c0: 0a 20 20 20 20 69 66 28 20 74 6f 70 3d 3d 30 20 . if( top==0
c9d0: 26 26 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 && pPage->pBt->u
c9e0: 73 61 62 6c 65 53 69 7a 65 3d 3d 36 35 35 33 36 sableSize==65536
c9f0: 20 29 7b 0a 20 20 20 20 20 20 74 6f 70 20 3d 20 ){. top =
ca00: 36 35 35 33 36 3b 0a 20 20 20 20 7d 65 6c 73 65 65536;. }else
ca10: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
ca20: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
ca30: 50 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 PT;. }. }..
ca40: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 /* If there is
ca50: 65 6e 6f 75 67 68 20 73 70 61 63 65 20 62 65 74 enough space bet
ca60: 77 65 65 6e 20 67 61 70 20 61 6e 64 20 74 6f 70 ween gap and top
ca70: 20 66 6f 72 20 6f 6e 65 20 6d 6f 72 65 20 63 65 for one more ce
ca80: 6c 6c 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 ll pointer. **
ca90: 61 72 72 61 79 20 65 6e 74 72 79 20 6f 66 66 73 array entry offs
caa0: 65 74 2c 20 61 6e 64 20 69 66 20 74 68 65 20 66 et, and if the f
cab0: 72 65 65 6c 69 73 74 20 69 73 20 6e 6f 74 20 65 reelist is not e
cac0: 6d 70 74 79 2c 20 74 68 65 6e 20 73 65 61 72 63 mpty, then searc
cad0: 68 20 74 68 65 0a 20 20 2a 2a 20 66 72 65 65 6c h the. ** freel
cae0: 69 73 74 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 ist looking for
caf0: 61 20 66 72 65 65 20 73 6c 6f 74 20 62 69 67 20 a free slot big
cb00: 65 6e 6f 75 67 68 20 74 6f 20 73 61 74 69 73 66 enough to satisf
cb10: 79 20 74 68 65 20 72 65 71 75 65 73 74 2e 0a 20 y the request..
cb20: 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 */. testcase(
cb30: 67 61 70 2b 32 3d 3d 74 6f 70 20 29 3b 0a 20 20 gap+2==top );.
cb40: 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 31 3d testcase( gap+1=
cb50: 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 61 =top );. testca
cb60: 73 65 28 20 67 61 70 3d 3d 74 6f 70 20 29 3b 0a se( gap==top );.
cb70: 20 20 69 66 28 20 28 64 61 74 61 5b 68 64 72 2b if( (data[hdr+
cb80: 32 5d 20 7c 7c 20 64 61 74 61 5b 68 64 72 2b 31 2] || data[hdr+1
cb90: 5d 29 20 26 26 20 67 61 70 2b 32 3c 3d 74 6f 70 ]) && gap+2<=top
cba0: 20 29 7b 0a 20 20 20 20 75 38 20 2a 70 53 70 61 ){. u8 *pSpa
cbb0: 63 65 20 3d 20 70 61 67 65 46 69 6e 64 53 6c 6f ce = pageFindSlo
cbc0: 74 28 70 50 61 67 65 2c 20 6e 42 79 74 65 2c 20 t(pPage, nByte,
cbd0: 26 72 63 29 3b 0a 20 20 20 20 69 66 28 20 70 53 &rc);. if( pS
cbe0: 70 61 63 65 20 29 7b 0a 20 20 20 20 20 20 61 73 pace ){. as
cbf0: 73 65 72 74 28 20 70 53 70 61 63 65 3e 3d 64 61 sert( pSpace>=da
cc00: 74 61 20 26 26 20 28 70 53 70 61 63 65 20 2d 20 ta && (pSpace -
cc10: 64 61 74 61 29 3c 36 35 35 33 36 20 29 3b 0a 20 data)<65536 );.
cc20: 20 20 20 20 20 2a 70 49 64 78 20 3d 20 28 69 6e *pIdx = (in
cc30: 74 29 28 70 53 70 61 63 65 20 2d 20 64 61 74 61 t)(pSpace - data
cc40: 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
cc50: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
cc60: 65 6c 73 65 20 69 66 28 20 72 63 20 29 7b 0a 20 else if( rc ){.
cc70: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
cc80: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 }. }.. /*
cc90: 54 68 65 20 72 65 71 75 65 73 74 20 63 6f 75 6c The request coul
cca0: 64 20 6e 6f 74 20 62 65 20 66 75 6c 66 69 6c 6c d not be fulfill
ccb0: 65 64 20 75 73 69 6e 67 20 61 20 66 72 65 65 6c ed using a freel
ccc0: 69 73 74 20 73 6c 6f 74 2e 20 20 43 68 65 63 6b ist slot. Check
ccd0: 0a 20 20 2a 2a 20 74 6f 20 73 65 65 20 69 66 20 . ** to see if
cce0: 64 65 66 72 61 67 6d 65 6e 74 61 74 69 6f 6e 20 defragmentation
ccf0: 69 73 20 6e 65 63 65 73 73 61 72 79 2e 0a 20 20 is necessary..
cd00: 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 */. testcase( g
cd10: 61 70 2b 32 2b 6e 42 79 74 65 3d 3d 74 6f 70 20 ap+2+nByte==top
cd20: 29 3b 0a 20 20 69 66 28 20 67 61 70 2b 32 2b 6e );. if( gap+2+n
cd30: 42 79 74 65 3e 74 6f 70 20 29 7b 0a 20 20 20 20 Byte>top ){.
cd40: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e assert( pPage->n
cd50: 43 65 6c 6c 3e 30 20 7c 7c 20 43 4f 52 52 55 50 Cell>0 || CORRUP
cd60: 54 5f 44 42 20 29 3b 0a 20 20 20 20 72 63 20 3d T_DB );. rc =
cd70: 20 64 65 66 72 61 67 6d 65 6e 74 50 61 67 65 28 defragmentPage(
cd80: 70 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 pPage);. if(
cd90: 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
cda0: 20 20 20 20 74 6f 70 20 3d 20 67 65 74 32 62 79 top = get2by
cdb0: 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b teNotZero(&data[
cdc0: 68 64 72 2b 35 5d 29 3b 0a 20 20 20 20 61 73 73 hdr+5]);. ass
cdd0: 65 72 74 28 20 67 61 70 2b 6e 42 79 74 65 3c 3d ert( gap+nByte<=
cde0: 74 6f 70 20 29 3b 0a 20 20 7d 0a 0a 0a 20 20 2f top );. }... /
cdf0: 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 * Allocate memor
ce00: 79 20 66 72 6f 6d 20 74 68 65 20 67 61 70 20 69 y from the gap i
ce10: 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 63 65 n between the ce
ce20: 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 ll pointer array
ce30: 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 63 65 . ** and the ce
ce40: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e ll content area.
ce50: 20 20 54 68 65 20 62 74 72 65 65 49 6e 69 74 50 The btreeInitP
ce60: 61 67 65 28 29 20 63 61 6c 6c 20 68 61 73 20 61 age() call has a
ce70: 6c 72 65 61 64 79 0a 20 20 2a 2a 20 76 61 6c 69 lready. ** vali
ce80: 64 61 74 65 64 20 74 68 65 20 66 72 65 65 6c 69 dated the freeli
ce90: 73 74 2e 20 20 47 69 76 65 6e 20 74 68 61 74 20 st. Given that
cea0: 74 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 the freelist is
ceb0: 76 61 6c 69 64 2c 20 74 68 65 72 65 0a 20 20 2a valid, there. *
cec0: 2a 20 69 73 20 6e 6f 20 77 61 79 20 74 68 61 74 * is no way that
ced0: 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 the allocation
cee0: 63 61 6e 20 65 78 74 65 6e 64 20 6f 66 66 20 74 can extend off t
cef0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 he end of the pa
cf00: 67 65 2e 0a 20 20 2a 2a 20 54 68 65 20 61 73 73 ge.. ** The ass
cf10: 65 72 74 28 29 20 62 65 6c 6f 77 20 76 65 72 69 ert() below veri
cf20: 66 69 65 73 20 74 68 65 20 70 72 65 76 69 6f 75 fies the previou
cf30: 73 20 73 65 6e 74 65 6e 63 65 2e 0a 20 20 2a 2f s sentence.. */
cf40: 0a 20 20 74 6f 70 20 2d 3d 20 6e 42 79 74 65 3b . top -= nByte;
cf50: 0a 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 . put2byte(&dat
cf60: 61 5b 68 64 72 2b 35 5d 2c 20 74 6f 70 29 3b 0a a[hdr+5], top);.
cf70: 20 20 61 73 73 65 72 74 28 20 74 6f 70 2b 6e 42 assert( top+nB
cf80: 79 74 65 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 yte <= (int)pPag
cf90: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
cfa0: 7a 65 20 29 3b 0a 20 20 2a 70 49 64 78 20 3d 20 ze );. *pIdx =
cfb0: 74 6f 70 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 top;. return SQ
cfc0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
cfd0: 2a 20 52 65 74 75 72 6e 20 61 20 73 65 63 74 69 * Return a secti
cfe0: 6f 6e 20 6f 66 20 74 68 65 20 70 50 61 67 65 2d on of the pPage-
cff0: 3e 61 44 61 74 61 20 74 6f 20 74 68 65 20 66 72 >aData to the fr
d000: 65 65 6c 69 73 74 2e 0a 2a 2a 20 54 68 65 20 66 eelist..** The f
d010: 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 irst byte of the
d020: 20 6e 65 77 20 66 72 65 65 20 62 6c 6f 63 6b 20 new free block
d030: 69 73 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b is pPage->aData[
d040: 69 53 74 61 72 74 5d 0a 2a 2a 20 61 6e 64 20 74 iStart].** and t
d050: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 he size of the b
d060: 6c 6f 63 6b 20 69 73 20 69 53 69 7a 65 20 62 79 lock is iSize by
d070: 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 41 64 6a 61 63 tes..**.** Adjac
d080: 65 6e 74 20 66 72 65 65 62 6c 6f 63 6b 73 20 61 ent freeblocks a
d090: 72 65 20 63 6f 61 6c 65 73 63 65 64 2e 0a 2a 2a re coalesced..**
d0a0: 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 65 76 .** Note that ev
d0b0: 65 6e 20 74 68 6f 75 67 68 20 74 68 65 20 66 72 en though the fr
d0c0: 65 65 62 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 eeblock list was
d0d0: 20 63 68 65 63 6b 65 64 20 62 79 20 62 74 72 65 checked by btre
d0e0: 65 49 6e 69 74 50 61 67 65 28 29 2c 0a 2a 2a 20 eInitPage(),.**
d0f0: 74 68 61 74 20 72 6f 75 74 69 6e 65 20 77 69 6c that routine wil
d100: 6c 20 6e 6f 74 20 64 65 74 65 63 74 20 6f 76 65 l not detect ove
d110: 72 6c 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c rlap between cel
d120: 6c 73 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b 73 ls or freeblocks
d130: 2e 20 20 4e 6f 72 0a 2a 2a 20 64 6f 65 73 20 69 . Nor.** does i
d140: 74 20 64 65 74 65 63 74 20 63 65 6c 6c 73 20 6f t detect cells o
d150: 72 20 66 72 65 65 62 6c 6f 63 6b 73 20 74 68 61 r freeblocks tha
d160: 74 20 65 6e 63 72 6f 75 63 68 20 69 6e 74 6f 20 t encrouch into
d170: 74 68 65 20 72 65 73 65 72 76 65 64 20 62 79 74 the reserved byt
d180: 65 73 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 es.** at the end
d190: 20 6f 66 20 74 68 65 20 70 61 67 65 2e 20 20 53 of the page. S
d1a0: 6f 20 64 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 o do additional
d1b0: 63 6f 72 72 75 70 74 69 6f 6e 20 63 68 65 63 6b corruption check
d1c0: 73 20 69 6e 73 69 64 65 20 74 68 69 73 0a 2a 2a s inside this.**
d1d0: 20 72 6f 75 74 69 6e 65 20 61 6e 64 20 72 65 74 routine and ret
d1e0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
d1f0: 50 54 20 69 66 20 61 6e 79 20 70 72 6f 62 6c 65 PT if any proble
d200: 6d 73 20 61 72 65 20 66 6f 75 6e 64 2e 0a 2a 2f ms are found..*/
d210: 0a 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 65 .static int free
d220: 53 70 61 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 Space(MemPage *p
d230: 50 61 67 65 2c 20 75 31 36 20 69 53 74 61 72 74 Page, u16 iStart
d240: 2c 20 75 31 36 20 69 53 69 7a 65 29 7b 0a 20 20 , u16 iSize){.
d250: 75 31 36 20 69 50 74 72 3b 20 20 20 20 20 20 20 u16 iPtr;
d260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d270: 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 /* Address
d280: 20 6f 66 20 70 74 72 20 74 6f 20 6e 65 78 74 20 of ptr to next
d290: 66 72 65 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 freeblock */. u
d2a0: 31 36 20 69 46 72 65 65 42 6c 6b 3b 20 20 20 20 16 iFreeBlk;
d2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d2c0: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
d2d0: 6f 66 20 74 68 65 20 6e 65 78 74 20 66 72 65 65 of the next free
d2e0: 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 38 20 68 64 block */. u8 hd
d2f0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
d300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d310: 20 2f 2a 20 50 61 67 65 20 68 65 61 64 65 72 20 /* Page header
d320: 73 69 7a 65 2e 20 20 30 20 6f 72 20 31 30 30 20 size. 0 or 100
d330: 2a 2f 0a 20 20 75 38 20 6e 46 72 61 67 20 3d 20 */. u8 nFrag =
d340: 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
d350: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
d360: 64 75 63 74 69 6f 6e 20 69 6e 20 66 72 61 67 6d duction in fragm
d370: 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 entation */. u1
d380: 36 20 69 4f 72 69 67 53 69 7a 65 20 3d 20 69 53 6 iOrigSize = iS
d390: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ize;
d3a0: 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 /* Original
d3b0: 76 61 6c 75 65 20 6f 66 20 69 53 69 7a 65 20 2a value of iSize *
d3c0: 2f 0a 20 20 75 33 32 20 69 4c 61 73 74 20 3d 20 /. u32 iLast =
d3d0: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
d3e0: 6c 65 53 69 7a 65 2d 34 3b 20 2f 2a 20 4c 61 72 leSize-4; /* Lar
d3f0: 67 65 73 74 20 70 6f 73 73 69 62 6c 65 20 66 72 gest possible fr
d400: 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a eeblock offset *
d410: 2f 0a 20 20 75 33 32 20 69 45 6e 64 20 3d 20 69 /. u32 iEnd = i
d420: 53 74 61 72 74 20 2b 20 69 53 69 7a 65 3b 20 20 Start + iSize;
d430: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
d440: 73 74 20 62 79 74 65 20 70 61 73 74 20 74 68 65 st byte past the
d450: 20 69 53 74 61 72 74 20 62 75 66 66 65 72 20 2a iStart buffer *
d460: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
d470: 72 20 2a 64 61 74 61 20 3d 20 70 50 61 67 65 2d r *data = pPage-
d480: 3e 61 44 61 74 61 3b 20 20 20 2f 2a 20 50 61 67 >aData; /* Pag
d490: 65 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 0a 20 20 e content */..
d4a0: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 assert( pPage->p
d4b0: 42 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 Bt!=0 );. asser
d4c0: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
d4d0: 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
d4e0: 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
d4f0: 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f assert( CORRUPT_
d500: 44 42 20 7c 7c 20 69 53 74 61 72 74 3e 3d 70 50 DB || iStart>=pP
d510: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 36 age->hdrOffset+6
d520: 2b 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 +pPage->childPtr
d530: 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 65 72 74 Size );. assert
d540: 28 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 ( CORRUPT_DB ||
d550: 69 45 6e 64 20 3c 3d 20 70 50 61 67 65 2d 3e 70 iEnd <= pPage->p
d560: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 Bt->usableSize )
d570: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
d580: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
d590: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
d5a0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 ) );. assert( i
d5b0: 53 69 7a 65 3e 3d 34 20 29 3b 20 20 20 2f 2a 20 Size>=4 ); /*
d5c0: 4d 69 6e 69 6d 75 6d 20 63 65 6c 6c 20 73 69 7a Minimum cell siz
d5d0: 65 20 69 73 20 34 20 2a 2f 0a 20 20 61 73 73 65 e is 4 */. asse
d5e0: 72 74 28 20 69 53 74 61 72 74 3c 3d 69 4c 61 73 rt( iStart<=iLas
d5f0: 74 20 29 3b 0a 0a 20 20 2f 2a 20 4f 76 65 72 77 t );.. /* Overw
d600: 72 69 74 65 20 64 65 6c 65 74 65 64 20 69 6e 66 rite deleted inf
d610: 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 ormation with ze
d620: 72 6f 73 20 77 68 65 6e 20 74 68 65 20 73 65 63 ros when the sec
d630: 75 72 65 5f 64 65 6c 65 74 65 0a 20 20 2a 2a 20 ure_delete. **
d640: 6f 70 74 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 option is enable
d650: 64 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 d */. if( pPage
d660: 2d 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 ->pBt->btsFlags
d670: 26 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c & BTS_SECURE_DEL
d680: 45 54 45 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 ETE ){. memse
d690: 74 28 26 64 61 74 61 5b 69 53 74 61 72 74 5d 2c t(&data[iStart],
d6a0: 20 30 2c 20 69 53 69 7a 65 29 3b 0a 20 20 7d 0a 0, iSize);. }.
d6b0: 0a 20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 6f . /* The list o
d6c0: 66 20 66 72 65 65 62 6c 6f 63 6b 73 20 6d 75 73 f freeblocks mus
d6d0: 74 20 62 65 20 69 6e 20 61 73 63 65 6e 64 69 6e t be in ascendin
d6e0: 67 20 6f 72 64 65 72 2e 20 20 46 69 6e 64 20 74 g order. Find t
d6f0: 68 65 20 0a 20 20 2a 2a 20 73 70 6f 74 20 6f 6e he . ** spot on
d700: 20 74 68 65 20 6c 69 73 74 20 77 68 65 72 65 20 the list where
d710: 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 65 iStart should be
d720: 20 69 6e 73 65 72 74 65 64 2e 0a 20 20 2a 2f 0a inserted.. */.
d730: 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 hdr = pPage->h
d740: 64 72 4f 66 66 73 65 74 3b 0a 20 20 69 50 74 72 drOffset;. iPtr
d750: 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 66 = hdr + 1;. if
d760: 28 20 64 61 74 61 5b 69 50 74 72 2b 31 5d 3d 3d ( data[iPtr+1]==
d770: 30 20 26 26 20 64 61 74 61 5b 69 50 74 72 5d 3d 0 && data[iPtr]=
d780: 3d 30 20 29 7b 0a 20 20 20 20 69 46 72 65 65 42 =0 ){. iFreeB
d790: 6c 6b 20 3d 20 30 3b 20 20 2f 2a 20 53 68 6f 72 lk = 0; /* Shor
d7a0: 74 63 75 74 20 66 6f 72 20 74 68 65 20 63 61 73 tcut for the cas
d7b0: 65 20 77 68 65 6e 20 74 68 65 20 66 72 65 65 6c e when the freel
d7c0: 69 73 74 20 69 73 20 65 6d 70 74 79 20 2a 2f 0a ist is empty */.
d7d0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 77 68 69 }else{. whi
d7e0: 6c 65 28 20 28 69 46 72 65 65 42 6c 6b 20 3d 20 le( (iFreeBlk =
d7f0: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 get2byte(&data[i
d800: 50 74 72 5d 29 29 3c 69 53 74 61 72 74 20 29 7b Ptr]))<iStart ){
d810: 0a 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 . if( iFree
d820: 42 6c 6b 3c 69 50 74 72 2b 34 20 29 7b 0a 20 20 Blk<iPtr+4 ){.
d830: 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 42 if( iFreeB
d840: 6c 6b 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 lk==0 ) break;.
d850: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
d860: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
d870: 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 T;. }.
d880: 20 69 50 74 72 20 3d 20 69 46 72 65 65 42 6c 6b iPtr = iFreeBlk
d890: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
d8a0: 69 46 72 65 65 42 6c 6b 3e 69 4c 61 73 74 20 29 iFreeBlk>iLast )
d8b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
d8c0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
d8d0: 20 61 73 73 65 72 74 28 20 69 46 72 65 65 42 6c assert( iFreeBl
d8e0: 6b 3e 69 50 74 72 20 7c 7c 20 69 46 72 65 65 42 k>iPtr || iFreeB
d8f0: 6c 6b 3d 3d 30 20 29 3b 0a 20 20 0a 20 20 20 20 lk==0 );. .
d900: 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 /* At this point
d910: 3a 0a 20 20 20 20 2a 2a 20 20 20 20 69 46 72 65 :. ** iFre
d920: 65 42 6c 6b 3a 20 20 20 46 69 72 73 74 20 66 72 eBlk: First fr
d930: 65 65 62 6c 6f 63 6b 20 61 66 74 65 72 20 69 53 eeblock after iS
d940: 74 61 72 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 tart, or zero if
d950: 20 6e 6f 6e 65 0a 20 20 20 20 2a 2a 20 20 20 20 none. **
d960: 69 50 74 72 3a 20 20 20 20 20 20 20 54 68 65 20 iPtr: The
d970: 61 64 64 72 65 73 73 20 6f 66 20 61 20 70 6f 69 address of a poi
d980: 6e 74 65 72 20 74 6f 20 69 46 72 65 65 42 6c 6b nter to iFreeBlk
d990: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 . **. ** C
d9a0: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 69 heck to see if i
d9b0: 46 72 65 65 42 6c 6b 20 73 68 6f 75 6c 64 20 62 FreeBlk should b
d9c0: 65 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f e coalesced onto
d9d0: 20 74 68 65 20 65 6e 64 20 6f 66 20 69 53 74 61 the end of iSta
d9e0: 72 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 rt.. */. i
d9f0: 66 28 20 69 46 72 65 65 42 6c 6b 20 26 26 20 69 f( iFreeBlk && i
da00: 45 6e 64 2b 33 3e 3d 69 46 72 65 65 42 6c 6b 20 End+3>=iFreeBlk
da10: 29 7b 0a 20 20 20 20 20 20 6e 46 72 61 67 20 3d ){. nFrag =
da20: 20 69 46 72 65 65 42 6c 6b 20 2d 20 69 45 6e 64 iFreeBlk - iEnd
da30: 3b 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e 64 ;. if( iEnd
da40: 3e 69 46 72 65 65 42 6c 6b 20 29 20 72 65 74 75 >iFreeBlk ) retu
da50: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
da60: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 69 45 T_BKPT;. iE
da70: 6e 64 20 3d 20 69 46 72 65 65 42 6c 6b 20 2b 20 nd = iFreeBlk +
da80: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 get2byte(&data[i
da90: 46 72 65 65 42 6c 6b 2b 32 5d 29 3b 0a 20 20 20 FreeBlk+2]);.
daa0: 20 20 20 69 66 28 20 69 45 6e 64 20 3e 20 70 50 if( iEnd > pP
dab0: 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
dac0: 53 69 7a 65 20 29 20 72 65 74 75 72 6e 20 53 51 Size ) return SQ
dad0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
dae0: 54 3b 0a 20 20 20 20 20 20 69 53 69 7a 65 20 3d T;. iSize =
daf0: 20 69 45 6e 64 20 2d 20 69 53 74 61 72 74 3b 0a iEnd - iStart;.
db00: 20 20 20 20 20 20 69 46 72 65 65 42 6c 6b 20 3d iFreeBlk =
db10: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
db20: 69 46 72 65 65 42 6c 6b 5d 29 3b 0a 20 20 20 20 iFreeBlk]);.
db30: 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 69 }. . /* If i
db40: 50 74 72 20 69 73 20 61 6e 6f 74 68 65 72 20 66 Ptr is another f
db50: 72 65 65 62 6c 6f 63 6b 20 28 74 68 61 74 20 69 reeblock (that i
db60: 73 2c 20 69 66 20 69 50 74 72 20 69 73 20 6e 6f s, if iPtr is no
db70: 74 20 74 68 65 20 66 72 65 65 6c 69 73 74 0a 20 t the freelist.
db80: 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 20 69 6e ** pointer in
db90: 20 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 the page header
dba0: 29 20 74 68 65 6e 20 63 68 65 63 6b 20 74 6f 20 ) then check to
dbb0: 73 65 65 20 69 66 20 69 53 74 61 72 74 20 73 68 see if iStart sh
dbc0: 6f 75 6c 64 20 62 65 0a 20 20 20 20 2a 2a 20 63 ould be. ** c
dbd0: 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 oalesced onto th
dbe0: 65 20 65 6e 64 20 6f 66 20 69 50 74 72 2e 0a 20 e end of iPtr..
dbf0: 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 */. if( iP
dc00: 74 72 3e 68 64 72 2b 31 20 29 7b 0a 20 20 20 20 tr>hdr+1 ){.
dc10: 20 20 69 6e 74 20 69 50 74 72 45 6e 64 20 3d 20 int iPtrEnd =
dc20: 69 50 74 72 20 2b 20 67 65 74 32 62 79 74 65 28 iPtr + get2byte(
dc30: 26 64 61 74 61 5b 69 50 74 72 2b 32 5d 29 3b 0a &data[iPtr+2]);.
dc40: 20 20 20 20 20 20 69 66 28 20 69 50 74 72 45 6e if( iPtrEn
dc50: 64 2b 33 3e 3d 69 53 74 61 72 74 20 29 7b 0a 20 d+3>=iStart ){.
dc60: 20 20 20 20 20 20 20 69 66 28 20 69 50 74 72 45 if( iPtrE
dc70: 6e 64 3e 69 53 74 61 72 74 20 29 20 72 65 74 75 nd>iStart ) retu
dc80: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
dc90: 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 T_BKPT;.
dca0: 6e 46 72 61 67 20 2b 3d 20 69 53 74 61 72 74 20 nFrag += iStart
dcb0: 2d 20 69 50 74 72 45 6e 64 3b 0a 20 20 20 20 20 - iPtrEnd;.
dcc0: 20 20 20 69 53 69 7a 65 20 3d 20 69 45 6e 64 20 iSize = iEnd
dcd0: 2d 20 69 50 74 72 3b 0a 20 20 20 20 20 20 20 20 - iPtr;.
dce0: 69 53 74 61 72 74 20 3d 20 69 50 74 72 3b 0a 20 iStart = iPtr;.
dcf0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
dd00: 20 69 66 28 20 6e 46 72 61 67 3e 64 61 74 61 5b if( nFrag>data[
dd10: 68 64 72 2b 37 5d 20 29 20 72 65 74 75 72 6e 20 hdr+7] ) return
dd20: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
dd30: 4b 50 54 3b 0a 20 20 20 20 64 61 74 61 5b 68 64 KPT;. data[hd
dd40: 72 2b 37 5d 20 2d 3d 20 6e 46 72 61 67 3b 0a 20 r+7] -= nFrag;.
dd50: 20 7d 0a 20 20 69 66 28 20 69 53 74 61 72 74 3d }. if( iStart=
dd60: 3d 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b =get2byte(&data[
dd70: 68 64 72 2b 35 5d 29 20 29 7b 0a 20 20 20 20 2f hdr+5]) ){. /
dd80: 2a 20 54 68 65 20 6e 65 77 20 66 72 65 65 62 6c * The new freebl
dd90: 6f 63 6b 20 69 73 20 61 74 20 74 68 65 20 62 65 ock is at the be
dda0: 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 63 ginning of the c
ddb0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
ddc0: 2c 0a 20 20 20 20 2a 2a 20 73 6f 20 6a 75 73 74 ,. ** so just
ddd0: 20 65 78 74 65 6e 64 20 74 68 65 20 63 65 6c 6c extend the cell
dde0: 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 72 61 content area ra
ddf0: 74 68 65 72 20 74 68 61 6e 20 63 72 65 61 74 65 ther than create
de00: 20 61 6e 6f 74 68 65 72 0a 20 20 20 20 2a 2a 20 another. **
de10: 66 72 65 65 6c 69 73 74 20 65 6e 74 72 79 20 2a freelist entry *
de20: 2f 0a 20 20 20 20 69 66 28 20 69 50 74 72 21 3d /. if( iPtr!=
de30: 68 64 72 2b 31 20 29 20 72 65 74 75 72 6e 20 53 hdr+1 ) return S
de40: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
de50: 50 54 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 PT;. put2byte
de60: 28 26 64 61 74 61 5b 68 64 72 2b 31 5d 2c 20 69 (&data[hdr+1], i
de70: 46 72 65 65 42 6c 6b 29 3b 0a 20 20 20 20 70 75 FreeBlk);. pu
de80: 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 t2byte(&data[hdr
de90: 2b 35 5d 2c 20 69 45 6e 64 29 3b 0a 20 20 7d 65 +5], iEnd);. }e
dea0: 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 6e 73 65 lse{. /* Inse
deb0: 72 74 20 74 68 65 20 6e 65 77 20 66 72 65 65 62 rt the new freeb
dec0: 6c 6f 63 6b 20 69 6e 74 6f 20 74 68 65 20 66 72 lock into the fr
ded0: 65 65 6c 69 73 74 20 2a 2f 0a 20 20 20 20 70 75 eelist */. pu
dee0: 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 50 74 t2byte(&data[iPt
def0: 72 5d 2c 20 69 53 74 61 72 74 29 3b 0a 20 20 20 r], iStart);.
df00: 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b put2byte(&data[
df10: 69 53 74 61 72 74 5d 2c 20 69 46 72 65 65 42 6c iStart], iFreeBl
df20: 6b 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 k);. put2byte
df30: 28 26 64 61 74 61 5b 69 53 74 61 72 74 2b 32 5d (&data[iStart+2]
df40: 2c 20 69 53 69 7a 65 29 3b 0a 20 20 7d 0a 20 20 , iSize);. }.
df50: 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 pPage->nFree +=
df60: 69 4f 72 69 67 53 69 7a 65 3b 0a 20 20 72 65 74 iOrigSize;. ret
df70: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
df80: 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6f 64 65 20 74 ../*.** Decode t
df90: 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 28 74 he flags byte (t
dfa0: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
dfb0: 20 74 68 65 20 68 65 61 64 65 72 29 20 66 6f 72 the header) for
dfc0: 20 61 20 70 61 67 65 0a 2a 2a 20 61 6e 64 20 69 a page.** and i
dfd0: 6e 69 74 69 61 6c 69 7a 65 20 66 69 65 6c 64 73 nitialize fields
dfe0: 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 20 of the MemPage
dff0: 73 74 72 75 63 74 75 72 65 20 61 63 63 6f 72 64 structure accord
e000: 69 6e 67 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c ingly..**.** Onl
e010: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
e020: 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 61 72 65 combinations are
e030: 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 supported. Any
e040: 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e 74 0a thing different.
e050: 2a 2a 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 ** indicates a c
e060: 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 orrupt database
e070: 66 69 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 files:.**.**
e080: 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 PTF_ZERODAT
e090: 41 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 A.** PTF
e0a0: 5f 5a 45 52 4f 44 41 54 41 20 7c 20 50 54 46 5f _ZERODATA | PTF_
e0b0: 4c 45 41 46 0a 2a 2a 20 20 20 20 20 20 20 20 20 LEAF.**
e0c0: 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 PTF_LEAFDATA | P
e0d0: 54 46 5f 49 4e 54 4b 45 59 0a 2a 2a 20 20 20 20 TF_INTKEY.**
e0e0: 20 20 20 20 20 50 54 46 5f 4c 45 41 46 44 41 54 PTF_LEAFDAT
e0f0: 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 20 7c A | PTF_INTKEY |
e100: 20 50 54 46 5f 4c 45 41 46 0a 2a 2f 0a 73 74 61 PTF_LEAF.*/.sta
e110: 74 69 63 20 69 6e 74 20 64 65 63 6f 64 65 46 6c tic int decodeFl
e120: 61 67 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ags(MemPage *pPa
e130: 67 65 2c 20 69 6e 74 20 66 6c 61 67 42 79 74 65 ge, int flagByte
e140: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
e150: 42 74 3b 20 20 20 20 20 2f 2a 20 41 20 63 6f 70 Bt; /* A cop
e160: 79 20 6f 66 20 70 50 61 67 65 2d 3e 70 42 74 20 y of pPage->pBt
e170: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
e180: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d age->hdrOffset==
e190: 28 70 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 (pPage->pgno==1
e1a0: 3f 20 31 30 30 20 3a 20 30 29 20 29 3b 0a 20 20 ? 100 : 0) );.
e1b0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
e1c0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
e1d0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
e1e0: 0a 20 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 3d . pPage->leaf =
e1f0: 20 28 75 38 29 28 66 6c 61 67 42 79 74 65 3e 3e (u8)(flagByte>>
e200: 33 29 3b 20 20 61 73 73 65 72 74 28 20 50 54 46 3); assert( PTF
e210: 5f 4c 45 41 46 20 3d 3d 20 31 3c 3c 33 20 29 3b _LEAF == 1<<3 );
e220: 0a 20 20 66 6c 61 67 42 79 74 65 20 26 3d 20 7e . flagByte &= ~
e230: 50 54 46 5f 4c 45 41 46 3b 0a 20 20 70 50 61 67 PTF_LEAF;. pPag
e240: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 e->childPtrSize
e250: 3d 20 34 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 = 4-4*pPage->lea
e260: 66 3b 0a 20 20 70 50 61 67 65 2d 3e 78 43 65 6c f;. pPage->xCel
e270: 6c 53 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 lSize = cellSize
e280: 50 74 72 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 Ptr;. pBt = pPa
e290: 67 65 2d 3e 70 42 74 3b 0a 20 20 69 66 28 20 66 ge->pBt;. if( f
e2a0: 6c 61 67 42 79 74 65 3d 3d 28 50 54 46 5f 4c 45 lagByte==(PTF_LE
e2b0: 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 AFDATA | PTF_INT
e2c0: 4b 45 59 29 20 29 7b 0a 20 20 20 20 2f 2a 20 45 KEY) ){. /* E
e2d0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 37 VIDENCE-OF: R-07
e2e0: 32 39 31 2d 33 35 33 32 38 20 41 20 76 61 6c 75 291-35328 A valu
e2f0: 65 20 6f 66 20 35 20 28 30 78 30 35 29 20 6d 65 e of 5 (0x05) me
e300: 61 6e 73 20 74 68 65 20 70 61 67 65 20 69 73 20 ans the page is
e310: 61 6e 0a 20 20 20 20 2a 2a 20 69 6e 74 65 72 69 an. ** interi
e320: 6f 72 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 or table b-tree
e330: 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 page. */. ass
e340: 65 72 74 28 20 28 50 54 46 5f 4c 45 41 46 44 41 ert( (PTF_LEAFDA
e350: 54 41 7c 50 54 46 5f 49 4e 54 4b 45 59 29 3d 3d TA|PTF_INTKEY)==
e360: 35 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 5 );. /* EVID
e370: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 36 39 30 30 ENCE-OF: R-26900
e380: 2d 30 39 31 37 36 20 41 20 76 61 6c 75 65 20 6f -09176 A value o
e390: 66 20 31 33 20 28 30 78 30 64 29 20 6d 65 61 6e f 13 (0x0d) mean
e3a0: 73 20 74 68 65 20 70 61 67 65 20 69 73 20 61 0a s the page is a.
e3b0: 20 20 20 20 2a 2a 20 6c 65 61 66 20 74 61 62 6c ** leaf tabl
e3c0: 65 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a e b-tree page. *
e3d0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
e3e0: 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f TF_LEAFDATA|PTF_
e3f0: 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 29 INTKEY|PTF_LEAF)
e400: 3d 3d 31 33 20 29 3b 0a 20 20 20 20 70 50 61 67 ==13 );. pPag
e410: 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 31 3b 0a 20 e->intKey = 1;.
e420: 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 if( pPage->le
e430: 61 66 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 af ){. pPag
e440: 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 e->intKeyLeaf =
e450: 31 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e 1;. pPage->
e460: 78 50 61 72 73 65 43 65 6c 6c 20 3d 20 62 74 72 xParseCell = btr
e470: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 3b 0a eeParseCellPtr;.
e480: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
e490: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 pPage->intKeyLe
e4a0: 61 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 af = 0;. pP
e4b0: 61 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 20 3d age->xCellSize =
e4c0: 20 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 61 cellSizePtrNoPa
e4d0: 79 6c 6f 61 64 3b 0a 20 20 20 20 20 20 70 50 61 yload;. pPa
e4e0: 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 20 3d ge->xParseCell =
e4f0: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
e500: 74 72 4e 6f 50 61 79 6c 6f 61 64 3b 0a 20 20 20 trNoPayload;.
e510: 20 7d 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 }. pPage->ma
e520: 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 xLocal = pBt->ma
e530: 78 4c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 xLeaf;. pPage
e540: 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 ->minLocal = pBt
e550: 2d 3e 6d 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c ->minLeaf;. }el
e560: 73 65 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d se if( flagByte=
e570: 3d 50 54 46 5f 5a 45 52 4f 44 41 54 41 20 29 7b =PTF_ZERODATA ){
e580: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
e590: 2d 4f 46 3a 20 52 2d 34 33 33 31 36 2d 33 37 33 -OF: R-43316-373
e5a0: 30 38 20 41 20 76 61 6c 75 65 20 6f 66 20 32 20 08 A value of 2
e5b0: 28 30 78 30 32 29 20 6d 65 61 6e 73 20 74 68 65 (0x02) means the
e5c0: 20 70 61 67 65 20 69 73 20 61 6e 0a 20 20 20 20 page is an.
e5d0: 2a 2a 20 69 6e 74 65 72 69 6f 72 20 69 6e 64 65 ** interior inde
e5e0: 78 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a x b-tree page. *
e5f0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
e600: 54 46 5f 5a 45 52 4f 44 41 54 41 29 3d 3d 32 20 TF_ZERODATA)==2
e610: 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e );. /* EVIDEN
e620: 43 45 2d 4f 46 3a 20 52 2d 35 39 36 31 35 2d 34 CE-OF: R-59615-4
e630: 32 38 32 38 20 41 20 76 61 6c 75 65 20 6f 66 20 2828 A value of
e640: 31 30 20 28 30 78 30 61 29 20 6d 65 61 6e 73 20 10 (0x0a) means
e650: 74 68 65 20 70 61 67 65 20 69 73 20 61 0a 20 20 the page is a.
e660: 20 20 2a 2a 20 6c 65 61 66 20 69 6e 64 65 78 20 ** leaf index
e670: 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a b-tree page. */.
e680: 20 20 20 20 61 73 73 65 72 74 28 20 28 50 54 46 assert( (PTF
e690: 5f 5a 45 52 4f 44 41 54 41 7c 50 54 46 5f 4c 45 _ZERODATA|PTF_LE
e6a0: 41 46 29 3d 3d 31 30 20 29 3b 0a 20 20 20 20 70 AF)==10 );. p
e6b0: 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 30 Page->intKey = 0
e6c0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 ;. pPage->int
e6d0: 4b 65 79 4c 65 61 66 20 3d 20 30 3b 0a 20 20 20 KeyLeaf = 0;.
e6e0: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
e6f0: 6c 6c 20 3d 20 62 74 72 65 65 50 61 72 73 65 43 ll = btreeParseC
e700: 65 6c 6c 50 74 72 49 6e 64 65 78 3b 0a 20 20 20 ellPtrIndex;.
e710: 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c pPage->maxLocal
e720: 20 3d 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c = pBt->maxLocal
e730: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e ;. pPage->min
e740: 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e Local = pBt->min
e750: 4c 6f 63 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a Local;. }else{.
e760: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
e770: 4f 46 3a 20 52 2d 34 37 36 30 38 2d 35 36 34 36 OF: R-47608-5646
e780: 39 20 41 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 9 Any other valu
e790: 65 20 66 6f 72 20 74 68 65 20 62 2d 74 72 65 65 e for the b-tree
e7a0: 20 70 61 67 65 20 74 79 70 65 20 69 73 0a 20 20 page type is.
e7b0: 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 2e 20 2a ** an error. *
e7c0: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
e7d0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
e7e0: 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d 3e 6d ;. }. pPage->m
e7f0: 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 20 3d ax1bytePayload =
e800: 20 70 42 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 pBt->max1bytePa
e810: 79 6c 6f 61 64 3b 0a 20 20 72 65 74 75 72 6e 20 yload;. return
e820: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
e830: 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 .** Initialize t
e840: 68 65 20 61 75 78 69 6c 69 61 72 79 20 69 6e 66 he auxiliary inf
e850: 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 20 61 20 64 ormation for a d
e860: 69 73 6b 20 62 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a isk block..**.**
e870: 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
e880: 4b 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 49 K on success. I
e890: 66 20 77 65 20 73 65 65 20 74 68 61 74 20 74 68 f we see that th
e8a0: 65 20 70 61 67 65 20 64 6f 65 73 0a 2a 2a 20 6e e page does.** n
e8b0: 6f 74 20 63 6f 6e 74 61 69 6e 20 61 20 77 65 6c ot contain a wel
e8c0: 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 l-formed databas
e8d0: 65 20 70 61 67 65 2c 20 74 68 65 6e 20 72 65 74 e page, then ret
e8e0: 75 72 6e 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 urn .** SQLITE_C
e8f0: 4f 52 52 55 50 54 2e 20 20 4e 6f 74 65 20 74 68 ORRUPT. Note th
e900: 61 74 20 61 20 72 65 74 75 72 6e 20 6f 66 20 53 at a return of S
e910: 51 4c 49 54 45 5f 4f 4b 20 64 6f 65 73 20 6e 6f QLITE_OK does no
e920: 74 0a 2a 2a 20 67 75 61 72 61 6e 74 65 65 20 74 t.** guarantee t
e930: 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 hat the page is
e940: 77 65 6c 6c 2d 66 6f 72 6d 65 64 2e 20 20 49 74 well-formed. It
e950: 20 6f 6e 6c 79 20 73 68 6f 77 73 20 74 68 61 74 only shows that
e960: 0a 2a 2a 20 77 65 20 66 61 69 6c 65 64 20 74 6f .** we failed to
e970: 20 64 65 74 65 63 74 20 61 6e 79 20 63 6f 72 72 detect any corr
e980: 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 uption..*/.stati
e990: 63 20 69 6e 74 20 62 74 72 65 65 49 6e 69 74 50 c int btreeInitP
e9a0: 61 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 age(MemPage *pPa
e9b0: 67 65 29 7b 0a 0a 20 20 61 73 73 65 72 74 28 20 ge){.. assert(
e9c0: 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b pPage->pBt!=0 );
e9d0: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
e9e0: 2d 3e 70 42 74 2d 3e 64 62 21 3d 30 20 29 3b 0a ->pBt->db!=0 );.
e9f0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
ea00: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
ea10: 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
ea20: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
ea30: 67 65 2d 3e 70 67 6e 6f 3d 3d 73 71 6c 69 74 65 ge->pgno==sqlite
ea40: 33 50 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 3PagerPagenumber
ea50: 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
ea60: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
ea70: 61 67 65 20 3d 3d 20 73 71 6c 69 74 65 33 50 61 age == sqlite3Pa
ea80: 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 67 gerGetExtra(pPag
ea90: 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
eaa0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
eab0: 61 44 61 74 61 20 3d 3d 20 73 71 6c 69 74 65 33 aData == sqlite3
eac0: 50 61 67 65 72 47 65 74 44 61 74 61 28 70 50 61 PagerGetData(pPa
ead0: 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
eae0: 0a 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 69 . if( !pPage->i
eaf0: 73 49 6e 69 74 20 29 7b 0a 20 20 20 20 75 31 36 sInit ){. u16
eb00: 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 pc;
eb10: 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 61 20 /* Address of a
eb20: 66 72 65 65 62 6c 6f 63 6b 20 77 69 74 68 69 6e freeblock within
eb30: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d 20 pPage->aData[]
eb40: 2a 2f 0a 20 20 20 20 75 38 20 68 64 72 3b 20 20 */. u8 hdr;
eb50: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 /* Off
eb60: 73 65 74 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 set to beginning
eb70: 20 6f 66 20 70 61 67 65 20 68 65 61 64 65 72 20 of page header
eb80: 2a 2f 0a 20 20 20 20 75 38 20 2a 64 61 74 61 3b */. u8 *data;
eb90: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 71 75 /* Equ
eba0: 61 6c 20 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 al to pPage->aDa
ebb0: 74 61 20 2a 2f 0a 20 20 20 20 42 74 53 68 61 72 ta */. BtShar
ebc0: 65 64 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 ed *pBt;
ebd0: 2f 2a 20 54 68 65 20 6d 61 69 6e 20 62 74 72 65 /* The main btre
ebe0: 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 e structure */.
ebf0: 20 20 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a int usableSiz
ec00: 65 3b 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 e; /* Amount
ec10: 6f 66 20 75 73 61 62 6c 65 20 73 70 61 63 65 20 of usable space
ec20: 6f 6e 20 65 61 63 68 20 70 61 67 65 20 2a 2f 0a on each page */.
ec30: 20 20 20 20 75 31 36 20 63 65 6c 6c 4f 66 66 73 u16 cellOffs
ec40: 65 74 3b 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 et; /* Offset
ec50: 20 66 72 6f 6d 20 73 74 61 72 74 20 6f 66 20 70 from start of p
ec60: 61 67 65 20 74 6f 20 66 69 72 73 74 20 63 65 6c age to first cel
ec70: 6c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 20 l pointer */.
ec80: 20 69 6e 74 20 6e 46 72 65 65 3b 20 20 20 20 20 int nFree;
ec90: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
eca0: 20 75 6e 75 73 65 64 20 62 79 74 65 73 20 6f 6e unused bytes on
ecb0: 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 20 the page */.
ecc0: 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 20 20 20 int top;
ecd0: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 /* First byt
ece0: 65 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f e of the cell co
ecf0: 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 ntent area */.
ed00: 20 20 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 int iCellFirst
ed10: 3b 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 6c ; /* First al
ed20: 6c 6f 77 61 62 6c 65 20 63 65 6c 6c 20 6f 72 20 lowable cell or
ed30: 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 74 freeblock offset
ed40: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 65 6c */. int iCel
ed50: 6c 4c 61 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 lLast; /* La
ed60: 73 74 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c st possible cell
ed70: 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 or freeblock of
ed80: 66 73 65 74 20 2a 2f 0a 0a 20 20 20 20 70 42 74 fset */.. pBt
ed90: 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 0a = pPage->pBt;..
eda0: 20 20 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d hdr = pPage-
edb0: 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 20 20 >hdrOffset;.
edc0: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
edd0: 61 74 61 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 ata;. /* EVID
ede0: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 38 35 39 34 ENCE-OF: R-28594
edf0: 2d 30 32 38 39 30 20 54 68 65 20 6f 6e 65 2d 62 -02890 The one-b
ee00: 79 74 65 20 66 6c 61 67 20 61 74 20 6f 66 66 73 yte flag at offs
ee10: 65 74 20 30 20 69 6e 64 69 63 61 74 69 6e 67 0a et 0 indicating.
ee20: 20 20 20 20 2a 2a 20 74 68 65 20 62 2d 74 72 65 ** the b-tre
ee30: 65 20 70 61 67 65 20 74 79 70 65 2e 20 2a 2f 0a e page type. */.
ee40: 20 20 20 20 69 66 28 20 64 65 63 6f 64 65 46 6c if( decodeFl
ee50: 61 67 73 28 70 50 61 67 65 2c 20 64 61 74 61 5b ags(pPage, data[
ee60: 68 64 72 5d 29 20 29 20 72 65 74 75 72 6e 20 53 hdr]) ) return S
ee70: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
ee80: 50 54 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 PT;. assert(
ee90: 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 pBt->pageSize>=5
eea0: 31 32 20 26 26 20 70 42 74 2d 3e 70 61 67 65 53 12 && pBt->pageS
eeb0: 69 7a 65 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 ize<=65536 );.
eec0: 20 20 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 pPage->maskPag
eed0: 65 20 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 70 e = (u16)(pBt->p
eee0: 61 67 65 53 69 7a 65 20 2d 20 31 29 3b 0a 20 20 ageSize - 1);.
eef0: 20 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c pPage->nOverfl
ef00: 6f 77 20 3d 20 30 3b 0a 20 20 20 20 75 73 61 62 ow = 0;. usab
ef10: 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 leSize = pBt->us
ef20: 61 62 6c 65 53 69 7a 65 3b 0a 20 20 20 20 70 50 ableSize;. pP
ef30: 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 age->cellOffset
ef40: 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 68 = cellOffset = h
ef50: 64 72 20 2b 20 38 20 2b 20 70 50 61 67 65 2d 3e dr + 8 + pPage->
ef60: 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 childPtrSize;.
ef70: 20 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e pPage->aDataEn
ef80: 64 20 3d 20 26 64 61 74 61 5b 75 73 61 62 6c 65 d = &data[usable
ef90: 53 69 7a 65 5d 3b 0a 20 20 20 20 70 50 61 67 65 Size];. pPage
efa0: 2d 3e 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 ->aCellIdx = &da
efb0: 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a ta[cellOffset];.
efc0: 20 20 20 20 70 50 61 67 65 2d 3e 61 44 61 74 61 pPage->aData
efd0: 4f 66 73 74 20 3d 20 26 64 61 74 61 5b 70 50 61 Ofst = &data[pPa
efe0: 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 ge->childPtrSize
eff0: 5d 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e ];. /* EVIDEN
f000: 43 45 2d 4f 46 3a 20 52 2d 35 38 30 31 35 2d 34 CE-OF: R-58015-4
f010: 38 31 37 35 20 54 68 65 20 74 77 6f 2d 62 79 74 8175 The two-byt
f020: 65 20 69 6e 74 65 67 65 72 20 61 74 20 6f 66 66 e integer at off
f030: 73 65 74 20 35 20 64 65 73 69 67 6e 61 74 65 73 set 5 designates
f040: 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 74 61 72 . ** the star
f050: 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 6f t of the cell co
f060: 6e 74 65 6e 74 20 61 72 65 61 2e 20 41 20 7a 65 ntent area. A ze
f070: 72 6f 20 76 61 6c 75 65 20 66 6f 72 20 74 68 69 ro value for thi
f080: 73 20 69 6e 74 65 67 65 72 20 69 73 0a 20 20 20 s integer is.
f090: 20 2a 2a 20 69 6e 74 65 72 70 72 65 74 65 64 20 ** interpreted
f0a0: 61 73 20 36 35 35 33 36 2e 20 2a 2f 0a 20 20 20 as 65536. */.
f0b0: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
f0c0: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
f0d0: 2b 35 5d 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 +5]);. /* EVI
f0e0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 30 30 DENCE-OF: R-3700
f0f0: 32 2d 33 32 37 37 34 20 54 68 65 20 74 77 6f 2d 2-32774 The two-
f100: 62 79 74 65 20 69 6e 74 65 67 65 72 20 61 74 20 byte integer at
f110: 6f 66 66 73 65 74 20 33 20 67 69 76 65 73 20 74 offset 3 gives t
f120: 68 65 0a 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 he. ** number
f130: 20 6f 66 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 of cells on the
f140: 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 70 50 page. */. pP
f150: 61 67 65 2d 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 age->nCell = get
f160: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
f170: 33 5d 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 3]);. if( pPa
f180: 67 65 2d 3e 6e 43 65 6c 6c 3e 4d 58 5f 43 45 4c ge->nCell>MX_CEL
f190: 4c 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 L(pBt) ){.
f1a0: 2f 2a 20 54 6f 20 6d 61 6e 79 20 63 65 6c 6c 73 /* To many cells
f1b0: 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 70 61 for a single pa
f1c0: 67 65 2e 20 20 54 68 65 20 70 61 67 65 20 6d 75 ge. The page mu
f1d0: 73 74 20 62 65 20 63 6f 72 72 75 70 74 20 2a 2f st be corrupt */
f1e0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
f1f0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
f200: 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 74 65 73 T;. }. tes
f210: 74 63 61 73 65 28 20 70 50 61 67 65 2d 3e 6e 43 tcase( pPage->nC
f220: 65 6c 6c 3d 3d 4d 58 5f 43 45 4c 4c 28 70 42 74 ell==MX_CELL(pBt
f230: 29 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 ) );. /* EVID
f240: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 34 30 38 39 ENCE-OF: R-24089
f250: 2d 35 37 39 37 39 20 49 66 20 61 20 70 61 67 65 -57979 If a page
f260: 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 63 65 6c contains no cel
f270: 6c 73 20 28 77 68 69 63 68 20 69 73 20 6f 6e 6c ls (which is onl
f280: 79 0a 20 20 20 20 2a 2a 20 70 6f 73 73 69 62 6c y. ** possibl
f290: 65 20 66 6f 72 20 61 20 72 6f 6f 74 20 70 61 67 e for a root pag
f2a0: 65 20 6f 66 20 61 20 74 61 62 6c 65 20 74 68 61 e of a table tha
f2b0: 74 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 72 6f t contains no ro
f2c0: 77 73 29 20 74 68 65 6e 20 74 68 65 0a 20 20 20 ws) then the.
f2d0: 20 2a 2a 20 6f 66 66 73 65 74 20 74 6f 20 74 68 ** offset to th
f2e0: 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 e cell content a
f2f0: 72 65 61 20 77 69 6c 6c 20 65 71 75 61 6c 20 74 rea will equal t
f300: 68 65 20 70 61 67 65 20 73 69 7a 65 20 6d 69 6e he page size min
f310: 75 73 20 74 68 65 0a 20 20 20 20 2a 2a 20 62 79 us the. ** by
f320: 74 65 73 20 6f 66 20 72 65 73 65 72 76 65 64 20 tes of reserved
f330: 73 70 61 63 65 2e 20 2a 2f 0a 20 20 20 20 61 73 space. */. as
f340: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 sert( pPage->nCe
f350: 6c 6c 3e 30 20 7c 7c 20 74 6f 70 3d 3d 75 73 61 ll>0 || top==usa
f360: 62 6c 65 53 69 7a 65 20 7c 7c 20 43 4f 52 52 55 bleSize || CORRU
f370: 50 54 5f 44 42 20 29 3b 0a 0a 20 20 20 20 2f 2a PT_DB );.. /*
f380: 20 41 20 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 A malformed dat
f390: 61 62 61 73 65 20 70 61 67 65 20 6d 69 67 68 74 abase page might
f3a0: 20 63 61 75 73 65 20 75 73 20 74 6f 20 72 65 61 cause us to rea
f3b0: 64 20 70 61 73 74 20 74 68 65 20 65 6e 64 0a 20 d past the end.
f3c0: 20 20 20 2a 2a 20 6f 66 20 70 61 67 65 20 77 68 ** of page wh
f3d0: 65 6e 20 70 61 72 73 69 6e 67 20 61 20 63 65 6c en parsing a cel
f3e0: 6c 2e 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 l. . **.
f3f0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
f400: 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 63 block of code c
f410: 68 65 63 6b 73 20 65 61 72 6c 79 20 74 6f 20 73 hecks early to s
f420: 65 65 20 69 66 20 61 20 63 65 6c 6c 20 65 78 74 ee if a cell ext
f430: 65 6e 64 73 0a 20 20 20 20 2a 2a 20 70 61 73 74 ends. ** past
f440: 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 70 61 the end of a pa
f450: 67 65 20 62 6f 75 6e 64 61 72 79 20 61 6e 64 20 ge boundary and
f460: 63 61 75 73 65 73 20 53 51 4c 49 54 45 5f 43 4f causes SQLITE_CO
f470: 52 52 55 50 54 20 74 6f 20 62 65 20 0a 20 20 20 RRUPT to be .
f480: 20 2a 2a 20 72 65 74 75 72 6e 65 64 20 69 66 20 ** returned if
f490: 69 74 20 64 6f 65 73 2e 0a 20 20 20 20 2a 2f 0a it does.. */.
f4a0: 20 20 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d iCellFirst =
f4b0: 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a cellOffset + 2*
f4c0: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
f4d0: 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 iCellLast = us
f4e0: 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
f4f0: 20 20 69 66 28 20 70 42 74 2d 3e 64 62 2d 3e 66 if( pBt->db->f
f500: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 43 65 lags & SQLITE_Ce
f510: 6c 6c 53 69 7a 65 43 6b 20 29 7b 0a 20 20 20 20 llSizeCk ){.
f520: 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 int i;
f530: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 6e 74 /* Index int
f540: 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 o the cell point
f550: 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 20 20 er array */.
f560: 20 20 69 6e 74 20 73 7a 3b 20 20 20 20 20 20 20 int sz;
f570: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 /* Size of a
f580: 20 63 65 6c 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 cell */..
f590: 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 if( !pPage->leaf
f5a0: 20 29 20 69 43 65 6c 6c 4c 61 73 74 2d 2d 3b 0a ) iCellLast--;.
f5b0: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 for(i=0; i
f5c0: 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 20 69 <pPage->nCell; i
f5d0: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 63 20 ++){. pc
f5e0: 3d 20 67 65 74 32 62 79 74 65 41 6c 69 67 6e 65 = get2byteAligne
f5f0: 64 28 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 d(&data[cellOffs
f600: 65 74 2b 69 2a 32 5d 29 3b 0a 20 20 20 20 20 20 et+i*2]);.
f610: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
f620: 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
f630: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
f640: 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b pc==iCellLast );
f650: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 63 3c . if( pc<
f660: 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 iCellFirst || pc
f670: 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 >iCellLast ){.
f680: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
f690: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
f6a0: 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 PT;. }.
f6b0: 20 20 20 20 20 20 73 7a 20 3d 20 70 50 61 67 65 sz = pPage
f6c0: 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 ->xCellSize(pPag
f6d0: 65 2c 20 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 e, &data[pc]);.
f6e0: 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
f6f0: 20 70 63 2b 73 7a 3d 3d 75 73 61 62 6c 65 53 69 pc+sz==usableSi
f700: 7a 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 ze );. if
f710: 28 20 70 63 2b 73 7a 3e 75 73 61 62 6c 65 53 69 ( pc+sz>usableSi
f720: 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ze ){.
f730: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
f740: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
f750: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
f760: 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e if( !pPage->
f770: 6c 65 61 66 20 29 20 69 43 65 6c 6c 4c 61 73 74 leaf ) iCellLast
f780: 2b 2b 3b 0a 20 20 20 20 7d 20 20 0a 0a 20 20 20 ++;. } ..
f790: 20 2f 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 /* Compute the
f7a0: 74 6f 74 61 6c 20 66 72 65 65 20 73 70 61 63 65 total free space
f7b0: 20 6f 6e 20 74 68 65 20 70 61 67 65 0a 20 20 20 on the page.
f7c0: 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a ** EVIDENCE-OF:
f7d0: 20 52 2d 32 33 35 38 38 2d 33 34 34 35 30 20 54 R-23588-34450 T
f7e0: 68 65 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 he two-byte inte
f7f0: 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 31 20 ger at offset 1
f800: 67 69 76 65 73 20 74 68 65 0a 20 20 20 20 2a 2a gives the. **
f810: 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 66 69 start of the fi
f820: 72 73 74 20 66 72 65 65 62 6c 6f 63 6b 20 6f 6e rst freeblock on
f830: 20 74 68 65 20 70 61 67 65 2c 20 6f 72 20 69 73 the page, or is
f840: 20 7a 65 72 6f 20 69 66 20 74 68 65 72 65 20 61 zero if there a
f850: 72 65 20 6e 6f 0a 20 20 20 20 2a 2a 20 66 72 65 re no. ** fre
f860: 65 62 6c 6f 63 6b 73 2e 20 2a 2f 0a 20 20 20 20 eblocks. */.
f870: 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 pc = get2byte(&d
f880: 61 74 61 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 ata[hdr+1]);.
f890: 20 6e 46 72 65 65 20 3d 20 64 61 74 61 5b 68 64 nFree = data[hd
f8a0: 72 2b 37 5d 20 2b 20 74 6f 70 3b 20 20 2f 2a 20 r+7] + top; /*
f8b0: 49 6e 69 74 20 6e 46 72 65 65 20 74 6f 20 6e 6f Init nFree to no
f8c0: 6e 2d 66 72 65 65 62 6c 6f 63 6b 20 66 72 65 65 n-freeblock free
f8d0: 20 73 70 61 63 65 20 2a 2f 0a 20 20 20 20 77 68 space */. wh
f8e0: 69 6c 65 28 20 70 63 3e 30 20 29 7b 0a 20 20 20 ile( pc>0 ){.
f8f0: 20 20 20 75 31 36 20 6e 65 78 74 2c 20 73 69 7a u16 next, siz
f900: 65 3b 0a 20 20 20 20 20 20 69 66 28 20 70 63 3c e;. if( pc<
f910: 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 iCellFirst || pc
f920: 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 >iCellLast ){.
f930: 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
f940: 45 2d 4f 46 3a 20 52 2d 35 35 35 33 30 2d 35 32 E-OF: R-55530-52
f950: 39 33 30 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 930 In a well-fo
f960: 72 6d 65 64 20 62 2d 74 72 65 65 20 70 61 67 65 rmed b-tree page
f970: 2c 20 74 68 65 72 65 20 77 69 6c 6c 0a 20 20 20 , there will.
f980: 20 20 20 20 20 2a 2a 20 61 6c 77 61 79 73 20 62 ** always b
f990: 65 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 63 e at least one c
f9a0: 65 6c 6c 20 62 65 66 6f 72 65 20 74 68 65 20 66 ell before the f
f9b0: 69 72 73 74 20 66 72 65 65 62 6c 6f 63 6b 2e 0a irst freeblock..
f9c0: 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 **.
f9d0: 20 20 20 2a 2a 20 4f 72 2c 20 74 68 65 20 66 72 ** Or, the fr
f9e0: 65 65 62 6c 6f 63 6b 20 69 73 20 6f 66 66 20 74 eeblock is off t
f9f0: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 he end of the pa
fa00: 67 65 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 ge. */.
fa10: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
fa20: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
fa30: 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 ; . }.
fa40: 20 6e 65 78 74 20 3d 20 67 65 74 32 62 79 74 65 next = get2byte
fa50: 28 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 (&data[pc]);.
fa60: 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 79 size = get2by
fa70: 74 65 28 26 64 61 74 61 5b 70 63 2b 32 5d 29 3b te(&data[pc+2]);
fa80: 0a 20 20 20 20 20 20 69 66 28 20 28 6e 65 78 74 . if( (next
fa90: 3e 30 20 26 26 20 6e 65 78 74 3c 3d 70 63 2b 73 >0 && next<=pc+s
faa0: 69 7a 65 2b 33 29 20 7c 7c 20 70 63 2b 73 69 7a ize+3) || pc+siz
fab0: 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a e>usableSize ){.
fac0: 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 /* Free
fad0: 62 6c 6f 63 6b 73 20 6d 75 73 74 20 62 65 20 69 blocks must be i
fae0: 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 n ascending orde
faf0: 72 2e 20 41 6e 64 20 74 68 65 20 6c 61 73 74 20 r. And the last
fb00: 62 79 74 65 20 6f 66 0a 20 20 20 20 20 20 20 20 byte of.
fb10: 2a 2a 20 74 68 65 20 66 72 65 65 2d 62 6c 6f 63 ** the free-bloc
fb20: 6b 20 6d 75 73 74 20 6c 69 65 20 6f 6e 20 74 68 k must lie on th
fb30: 65 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2e e database page.
fb40: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 65 74 */. ret
fb50: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
fb60: 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 20 20 20 PT_BKPT; .
fb70: 7d 0a 20 20 20 20 20 20 6e 46 72 65 65 20 3d 20 }. nFree =
fb80: 6e 46 72 65 65 20 2b 20 73 69 7a 65 3b 0a 20 20 nFree + size;.
fb90: 20 20 20 20 70 63 20 3d 20 6e 65 78 74 3b 0a 20 pc = next;.
fba0: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 74 20 }.. /* At
fbb0: 74 68 69 73 20 70 6f 69 6e 74 2c 20 6e 46 72 65 this point, nFre
fbc0: 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 e contains the s
fbd0: 75 6d 20 6f 66 20 74 68 65 20 6f 66 66 73 65 74 um of the offset
fbe0: 20 74 6f 20 74 68 65 20 73 74 61 72 74 0a 20 20 to the start.
fbf0: 20 20 2a 2a 20 6f 66 20 74 68 65 20 63 65 6c 6c ** of the cell
fc00: 2d 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 70 6c -content area pl
fc10: 75 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 us the number of
fc20: 20 66 72 65 65 20 62 79 74 65 73 20 77 69 74 68 free bytes with
fc30: 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 63 65 in. ** the ce
fc40: 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e ll-content area.
fc50: 20 49 66 20 74 68 69 73 20 69 73 20 67 72 65 61 If this is grea
fc60: 74 65 72 20 74 68 61 6e 20 74 68 65 20 75 73 61 ter than the usa
fc70: 62 6c 65 2d 73 69 7a 65 0a 20 20 20 20 2a 2a 20 ble-size. **
fc80: 6f 66 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 of the page, the
fc90: 6e 20 74 68 65 20 70 61 67 65 20 6d 75 73 74 20 n the page must
fca0: 62 65 20 63 6f 72 72 75 70 74 65 64 2e 20 54 68 be corrupted. Th
fcb0: 69 73 20 63 68 65 63 6b 20 61 6c 73 6f 0a 20 20 is check also.
fcc0: 20 20 2a 2a 20 73 65 72 76 65 73 20 74 6f 20 76 ** serves to v
fcd0: 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 6f erify that the o
fce0: 66 66 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 ffset to the sta
fcf0: 72 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 rt of the cell-c
fd00: 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 61 72 ontent. ** ar
fd10: 65 61 2c 20 61 63 63 6f 72 64 69 6e 67 20 74 6f ea, according to
fd20: 20 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 the page header
fd30: 2c 20 6c 69 65 73 20 77 69 74 68 69 6e 20 74 68 , lies within th
fd40: 65 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 e page.. */.
fd50: 20 20 20 69 66 28 20 6e 46 72 65 65 3e 75 73 61 if( nFree>usa
fd60: 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 bleSize ){.
fd70: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
fd80: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 ORRUPT_BKPT; .
fd90: 20 20 7d 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e }. pPage->n
fda0: 46 72 65 65 20 3d 20 28 75 31 36 29 28 6e 46 72 Free = (u16)(nFr
fdb0: 65 65 20 2d 20 69 43 65 6c 6c 46 69 72 73 74 29 ee - iCellFirst)
fdc0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 ;. pPage->isI
fdd0: 6e 69 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 nit = 1;. }. r
fde0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
fdf0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 75 70 .}../*.** Set up
fe00: 20 61 20 72 61 77 20 70 61 67 65 20 73 6f 20 74 a raw page so t
fe10: 68 61 74 20 69 74 20 6c 6f 6f 6b 73 20 6c 69 6b hat it looks lik
fe20: 65 20 61 20 64 61 74 61 62 61 73 65 20 70 61 67 e a database pag
fe30: 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6e 6f 20 e holding.** no
fe40: 65 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 74 61 74 entries..*/.stat
fe50: 69 63 20 76 6f 69 64 20 7a 65 72 6f 50 61 67 65 ic void zeroPage
fe60: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
fe70: 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 75 int flags){. u
fe80: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 nsigned char *da
fe90: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
fea0: 61 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 a;. BtShared *p
feb0: 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b Bt = pPage->pBt;
fec0: 0a 20 20 75 38 20 68 64 72 20 3d 20 70 50 61 67 . u8 hdr = pPag
fed0: 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 e->hdrOffset;.
fee0: 75 31 36 20 66 69 72 73 74 3b 0a 0a 20 20 61 73 u16 first;.. as
fef0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
ff00: 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 50 61 erPagenumber(pPa
ff10: 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 50 ge->pDbPage)==pP
ff20: 61 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a 20 20 61 age->pgno );. a
ff30: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
ff40: 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 67 gerGetExtra(pPag
ff50: 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 28 e->pDbPage) == (
ff60: 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a 20 void*)pPage );.
ff70: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
ff80: 50 61 67 65 72 47 65 74 44 61 74 61 28 70 50 61 PagerGetData(pPa
ff90: 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 ge->pDbPage) ==
ffa0: 64 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 data );. assert
ffb0: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
ffc0: 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
ffd0: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 >pDbPage) );. a
ffe0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
fff0: 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
10000 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 utex) );. if( p
10010 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
10020 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 TS_SECURE_DELETE
10030 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 ){. memset(&
10040 64 61 74 61 5b 68 64 72 5d 2c 20 30 2c 20 70 42 data[hdr], 0, pB
10050 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
10060 68 64 72 29 3b 0a 20 20 7d 0a 20 20 64 61 74 61 hdr);. }. data
10070 5b 68 64 72 5d 20 3d 20 28 63 68 61 72 29 66 6c [hdr] = (char)fl
10080 61 67 73 3b 0a 20 20 66 69 72 73 74 20 3d 20 68 ags;. first = h
10090 64 72 20 2b 20 28 28 66 6c 61 67 73 26 50 54 46 dr + ((flags&PTF
100a0 5f 4c 45 41 46 29 3d 3d 30 20 3f 20 31 32 20 3a _LEAF)==0 ? 12 :
100b0 20 38 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 8);. memset(&d
100c0 61 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 ata[hdr+1], 0, 4
100d0 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d );. data[hdr+7]
100e0 20 3d 20 30 3b 0a 20 20 70 75 74 32 62 79 74 65 = 0;. put2byte
100f0 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 (&data[hdr+5], p
10100 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b Bt->usableSize);
10110 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 . pPage->nFree
10120 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 = (u16)(pBt->usa
10130 62 6c 65 53 69 7a 65 20 2d 20 66 69 72 73 74 29 bleSize - first)
10140 3b 0a 20 20 64 65 63 6f 64 65 46 6c 61 67 73 28 ;. decodeFlags(
10150 70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 pPage, flags);.
10160 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
10170 65 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 et = first;. pP
10180 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 age->aDataEnd =
10190 26 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c &data[pBt->usabl
101a0 65 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d eSize];. pPage-
101b0 3e 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 >aCellIdx = &dat
101c0 61 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 a[first];. pPag
101d0 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 3d 20 26 e->aDataOfst = &
101e0 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 68 69 6c data[pPage->chil
101f0 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 70 50 61 dPtrSize];. pPa
10200 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 ge->nOverflow =
10210 30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 0;. assert( pBt
10220 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 ->pageSize>=512
10230 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 && pBt->pageSize
10240 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 70 50 61 <=65536 );. pPa
10250 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 ge->maskPage = (
10260 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 u16)(pBt->pageSi
10270 7a 65 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 65 ze - 1);. pPage
10280 2d 3e 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 ->nCell = 0;. p
10290 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 Page->isInit = 1
102a0 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 ;.}.../*.** Conv
102b0 65 72 74 20 61 20 44 62 50 61 67 65 20 6f 62 74 ert a DbPage obt
102c0 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 70 ained from the p
102d0 61 67 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d 50 ager into a MemP
102e0 61 67 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 74 age used by.** t
102f0 68 65 20 62 74 72 65 65 20 6c 61 79 65 72 2e 0a he btree layer..
10300 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 */.static MemPag
10310 65 20 2a 62 74 72 65 65 50 61 67 65 46 72 6f 6d e *btreePageFrom
10320 44 62 50 61 67 65 28 44 62 50 61 67 65 20 2a 70 DbPage(DbPage *p
10330 44 62 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 6e DbPage, Pgno pgn
10340 6f 2c 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 o, BtShared *pBt
10350 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
10360 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 age = (MemPage*)
10370 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 sqlite3PagerGetE
10380 78 74 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 xtra(pDbPage);.
10390 20 69 66 28 20 70 67 6e 6f 21 3d 70 50 61 67 65 if( pgno!=pPage
103a0 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50 ->pgno ){. pP
103b0 61 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c age->aData = sql
103c0 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
103d0 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 70 (pDbPage);. p
103e0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 Page->pDbPage =
103f0 70 44 62 50 61 67 65 3b 0a 20 20 20 20 70 50 61 pDbPage;. pPa
10400 67 65 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 ge->pBt = pBt;.
10410 20 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20 3d pPage->pgno =
10420 20 70 67 6e 6f 3b 0a 20 20 20 20 70 50 61 67 65 pgno;. pPage
10430 2d 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 70 67 ->hdrOffset = pg
10440 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b no==1 ? 100 : 0;
10450 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
10460 50 61 67 65 2d 3e 61 44 61 74 61 3d 3d 73 71 6c Page->aData==sql
10470 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
10480 28 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 (pDbPage) );. r
10490 65 74 75 72 6e 20 70 50 61 67 65 3b 20 0a 7d 0a eturn pPage; .}.
104a0 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 67 ./*.** Get a pag
104b0 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 e from the pager
104c0 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 . Initialize th
104d0 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 6e e MemPage.pBt an
104e0 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 61 d.** MemPage.aDa
104f0 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 6e ta elements if n
10500 65 65 64 65 64 2e 20 20 53 65 65 20 61 6c 73 6f eeded. See also
10510 3a 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 : btreeGetUnused
10520 50 61 67 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 Page()..**.** If
10530 20 74 68 65 20 50 41 47 45 52 5f 47 45 54 5f 4e the PAGER_GET_N
10540 4f 43 4f 4e 54 45 4e 54 20 66 6c 61 67 20 69 73 OCONTENT flag is
10550 20 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 set, it means t
10560 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 hat we do not ca
10570 72 65 0a 2a 2a 20 61 62 6f 75 74 20 74 68 65 20 re.** about the
10580 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
10590 61 67 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 age at this time
105a0 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 . So do not go
105b0 74 6f 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 74 to the disk.** t
105c0 6f 20 66 65 74 63 68 20 74 68 65 20 63 6f 6e 74 o fetch the cont
105d0 65 6e 74 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 ent. Just fill
105e0 69 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 in the content w
105f0 69 74 68 20 7a 65 72 6f 73 20 66 6f 72 20 6e 6f ith zeros for no
10600 77 2e 0a 2a 2a 20 49 66 20 69 6e 20 74 68 65 20 w..** If in the
10610 66 75 74 75 72 65 20 77 65 20 63 61 6c 6c 20 73 future we call s
10620 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
10630 28 29 20 6f 6e 20 74 68 69 73 20 70 61 67 65 2c () on this page,
10640 20 74 68 61 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 that.** means w
10650 65 20 68 61 76 65 20 73 74 61 72 74 65 64 20 74 e have started t
10660 6f 20 62 65 20 63 6f 6e 63 65 72 6e 65 64 20 61 o be concerned a
10670 62 6f 75 74 20 63 6f 6e 74 65 6e 74 20 61 6e 64 bout content and
10680 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 72 65 61 the disk.** rea
10690 64 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 d should occur a
106a0 74 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f t that point..*/
106b0 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
106c0 65 47 65 74 50 61 67 65 28 0a 20 20 42 74 53 68 eGetPage(. BtSh
106d0 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
106e0 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
106f0 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 . Pgno pgno,
10700 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
10710 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f r of the page to
10720 20 66 65 74 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 fetch */. MemP
10730 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
10740 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 70 /* Return the p
10750 61 67 65 20 69 6e 20 74 68 69 73 20 70 61 72 61 age in this para
10760 6d 65 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 66 meter */. int f
10770 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 lags
10780 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 /* PAGER_GET_NOC
10790 4f 4e 54 45 4e 54 20 6f 72 20 50 41 47 45 52 5f ONTENT or PAGER_
107a0 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a GET_READONLY */.
107b0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 ){. int rc;. D
107c0 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a bPage *pDbPage;.
107d0 0a 20 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 . assert( flags
107e0 3d 3d 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 ==0 || flags==PA
107f0 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e GER_GET_NOCONTEN
10800 54 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 45 T || flags==PAGE
10810 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 29 R_GET_READONLY )
10820 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
10830 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
10840 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
10850 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
10860 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
10870 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 2a , pgno, (DbPage*
10880 2a 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 67 *)&pDbPage, flag
10890 73 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 s);. if( rc ) r
108a0 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 eturn rc;. *ppP
108b0 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 age = btreePageF
108c0 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 romDbPage(pDbPag
108d0 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 e, pgno, pBt);.
108e0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
108f0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 K;.}../*.** Retr
10900 69 65 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d ieve a page from
10910 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
10920 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 74 . If the request
10930 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a ed page is not.*
10940 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 * already in the
10950 20 70 61 67 65 72 20 63 61 63 68 65 20 72 65 74 pager cache ret
10960 75 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 urn NULL. Initia
10970 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 lize the MemPage
10980 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 .pBt and.** MemP
10990 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e age.aData elemen
109a0 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f ts if needed..*/
109b0 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 .static MemPage
109c0 2a 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 *btreePageLookup
109d0 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
109e0 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 Pgno pgno){. Db
109f0 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 Page *pDbPage;.
10a00 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
10a10 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
10a20 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 >mutex) );. pDb
10a30 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 Page = sqlite3Pa
10a40 67 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 gerLookup(pBt->p
10a50 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 Pager, pgno);.
10a60 69 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 if( pDbPage ){.
10a70 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 return btreeP
10a80 61 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 ageFromDbPage(pD
10a90 62 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 bPage, pgno, pBt
10aa0 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
10ab0 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
10ac0 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 rn the size of t
10ad0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
10ae0 20 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 in pages. If th
10af0 65 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 ere is any kind
10b00 6f 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 of.** error, ret
10b10 75 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 urn ((unsigned i
10b20 6e 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 nt)-1)..*/.stati
10b30 63 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 c Pgno btreePage
10b40 63 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a count(BtShared *
10b50 70 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 pBt){. return p
10b60 42 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 Bt->nPage;.}.u32
10b70 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 sqlite3BtreeLas
10b80 74 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b tPage(Btree *p){
10b90 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
10ba0 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
10bb0 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
10bc0 28 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 ( ((p->pBt->nPag
10bd0 65 29 26 30 78 38 30 30 30 30 30 30 29 3d 3d 30 e)&0x8000000)==0
10be0 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 74 72 );. return btr
10bf0 65 65 50 61 67 65 63 6f 75 6e 74 28 70 2d 3e 70 eePagecount(p->p
10c00 42 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 Bt);.}../*.** Ge
10c10 74 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 68 t a page from th
10c20 65 20 70 61 67 65 72 20 61 6e 64 20 69 6e 69 74 e pager and init
10c30 69 61 6c 69 7a 65 20 69 74 2e 0a 2a 2a 0a 2a 2a ialize it..**.**
10c40 20 49 66 20 70 43 75 72 21 3d 30 20 74 68 65 6e If pCur!=0 then
10c50 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65 69 the page is bei
10c60 6e 67 20 66 65 74 63 68 65 64 20 61 73 20 70 61 ng fetched as pa
10c70 72 74 20 6f 66 20 61 20 6d 6f 76 65 54 6f 43 68 rt of a moveToCh
10c80 69 6c 64 28 29 0a 2a 2a 20 63 61 6c 6c 2e 20 20 ild().** call.
10c90 44 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 61 Do additional sa
10ca0 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e nity checking on
10cb0 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 69 the page in thi
10cc0 73 20 63 61 73 65 2e 0a 2a 2a 20 41 6e 64 20 69 s case..** And i
10cd0 66 20 74 68 65 20 66 65 74 63 68 20 66 61 69 6c f the fetch fail
10ce0 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 s, this routine
10cf0 6d 75 73 74 20 64 65 63 72 65 6d 65 6e 74 20 70 must decrement p
10d00 43 75 72 2d 3e 69 50 61 67 65 2e 0a 2a 2a 0a 2a Cur->iPage..**.*
10d10 2a 20 54 68 65 20 70 61 67 65 20 69 73 20 66 65 * The page is fe
10d20 74 63 68 65 64 20 61 73 20 72 65 61 64 2d 77 72 tched as read-wr
10d30 69 74 65 20 75 6e 6c 65 73 73 20 70 43 75 72 20 ite unless pCur
10d40 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 20 is not NULL and
10d50 69 73 0a 2a 2a 20 61 20 72 65 61 64 2d 6f 6e 6c is.** a read-onl
10d60 79 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 y cursor..**.**
10d70 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 If an error occu
10d80 72 73 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 65 rs, then *ppPage
10d90 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 49 is undefined. I
10da0 74 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e 20 t.** may remain
10db0 75 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 74 unchanged, or it
10dc0 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 61 may be set to a
10dd0 6e 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 2e n invalid value.
10de0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 .*/.static int g
10df0 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a 20 etAndInitPage(.
10e00 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 BtShared *pBt,
10e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10e20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
10e30 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
10e40 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
10e50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
10e60 6d 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 65 mber of the page
10e70 20 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 6d to get */. Mem
10e80 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 Page **ppPage,
10e90 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10ea0 57 72 69 74 65 20 74 68 65 20 70 61 67 65 20 70 Write the page p
10eb0 6f 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a 20 ointer here */.
10ec0 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c BtCursor *pCur,
10ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ee0 20 2f 2a 20 43 75 72 73 6f 72 20 74 6f 20 72 65 /* Cursor to re
10ef0 63 65 69 76 65 20 74 68 65 20 70 61 67 65 2c 20 ceive the page,
10f00 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 69 6e 74 or NULL */. int
10f10 20 62 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 20 bReadOnly
10f20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10f30 54 72 75 65 20 66 6f 72 20 61 20 72 65 61 64 2d True for a read-
10f40 6f 6e 6c 79 20 70 61 67 65 20 2a 2f 0a 29 7b 0a only page */.){.
10f50 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 50 61 int rc;. DbPa
10f60 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 61 ge *pDbPage;. a
10f70 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
10f80 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
10f90 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
10fa0 74 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 70 70 t( pCur==0 || pp
10fb0 50 61 67 65 3d 3d 26 70 43 75 72 2d 3e 61 70 50 Page==&pCur->apP
10fc0 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
10fd0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
10fe0 75 72 3d 3d 30 20 7c 7c 20 62 52 65 61 64 4f 6e ur==0 || bReadOn
10ff0 6c 79 3d 3d 70 43 75 72 2d 3e 63 75 72 50 61 67 ly==pCur->curPag
11000 65 72 46 6c 61 67 73 20 29 3b 0a 20 20 61 73 73 erFlags );. ass
11010 65 72 74 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 ert( pCur==0 ||
11020 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 29 3b pCur->iPage>0 );
11030 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 74 72 .. if( pgno>btr
11040 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 eePagecount(pBt)
11050 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
11060 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
11070 3b 0a 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e ;. goto getAn
11080 64 49 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b dInitPage_error;
11090 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 . }. rc = sqli
110a0 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d te3PagerGet(pBt-
110b0 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f 2c 20 28 >pPager, pgno, (
110c0 44 62 50 61 67 65 2a 2a 29 26 70 44 62 50 61 67 DbPage**)&pDbPag
110d0 65 2c 20 62 52 65 61 64 4f 6e 6c 79 29 3b 0a 20 e, bReadOnly);.
110e0 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 67 if( rc ){. g
110f0 6f 74 6f 20 67 65 74 41 6e 64 49 6e 69 74 50 61 oto getAndInitPa
11100 67 65 5f 65 72 72 6f 72 3b 0a 20 20 7d 0a 20 20 ge_error;. }.
11110 2a 70 70 50 61 67 65 20 3d 20 28 4d 65 6d 50 61 *ppPage = (MemPa
11120 67 65 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 ge*)sqlite3Pager
11130 47 65 74 45 78 74 72 61 28 70 44 62 50 61 67 65 GetExtra(pDbPage
11140 29 3b 0a 20 20 69 66 28 20 28 2a 70 70 50 61 67 );. if( (*ppPag
11150 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 7b e)->isInit==0 ){
11160 0a 20 20 20 20 62 74 72 65 65 50 61 67 65 46 72 . btreePageFr
11170 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 omDbPage(pDbPage
11180 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 , pgno, pBt);.
11190 20 20 72 63 20 3d 20 62 74 72 65 65 49 6e 69 74 rc = btreeInit
111a0 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 Page(*ppPage);.
111b0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
111c0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
111d0 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 leasePage(*ppPag
111e0 65 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 67 e);. goto g
111f0 65 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 etAndInitPage_er
11200 72 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 ror;. }. }.
11210 20 61 73 73 65 72 74 28 20 28 2a 70 70 50 61 67 assert( (*ppPag
11220 65 29 2d 3e 70 67 6e 6f 3d 3d 70 67 6e 6f 20 29 e)->pgno==pgno )
11230 3b 0a 20 20 61 73 73 65 72 74 28 20 28 2a 70 70 ;. assert( (*pp
11240 50 61 67 65 29 2d 3e 61 44 61 74 61 3d 3d 73 71 Page)->aData==sq
11250 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 lite3PagerGetDat
11260 61 28 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 a(pDbPage) );..
11270 20 2f 2a 20 49 66 20 6f 62 74 61 69 6e 69 6e 67 /* If obtaining
11280 20 61 20 63 68 69 6c 64 20 70 61 67 65 20 66 6f a child page fo
11290 72 20 61 20 63 75 72 73 6f 72 2c 20 77 65 20 6d r a cursor, we m
112a0 75 73 74 20 76 65 72 69 66 79 20 74 68 61 74 20 ust verify that
112b0 74 68 65 20 70 61 67 65 20 69 73 0a 20 20 2a 2a the page is. **
112c0 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 74 68 compatible with
112d0 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 2e 20 the root page.
112e0 2a 2f 0a 20 20 69 66 28 20 70 43 75 72 20 26 26 */. if( pCur &&
112f0 20 28 28 2a 70 70 50 61 67 65 29 2d 3e 6e 43 65 ((*ppPage)->nCe
11300 6c 6c 3c 31 20 7c 7c 20 28 2a 70 70 50 61 67 65 ll<1 || (*ppPage
11310 29 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 75 72 2d )->intKey!=pCur-
11320 3e 63 75 72 49 6e 74 4b 65 79 29 20 29 7b 0a 20 >curIntKey) ){.
11330 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
11340 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
11350 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 releasePage(*pp
11360 50 61 67 65 29 3b 0a 20 20 20 20 67 6f 74 6f 20 Page);. goto
11370 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 getAndInitPage_e
11380 72 72 6f 72 3b 0a 20 20 7d 0a 20 20 72 65 74 75 rror;. }. retu
11390 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 67 rn SQLITE_OK;..g
113a0 65 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 etAndInitPage_er
113b0 72 6f 72 3a 0a 20 20 69 66 28 20 70 43 75 72 20 ror:. if( pCur
113c0 29 20 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 3b ) pCur->iPage--;
113d0 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e . testcase( pgn
113e0 6f 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 o==0 );. assert
113f0 28 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d ( pgno!=0 || rc=
11400 3d 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 =SQLITE_CORRUPT
11410 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
11420 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 }../*.** Release
11430 20 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 a MemPage. Thi
11440 73 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c s should be call
11450 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 ed once for each
11460 20 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 prior.** call t
11470 6f 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a o btreeGetPage..
11480 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 */.static void r
11490 65 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c eleasePageNotNul
114a0 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 l(MemPage *pPage
114b0 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 ){. assert( pPa
114c0 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 61 ge->aData );. a
114d0 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 70 42 ssert( pPage->pB
114e0 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 t );. assert( p
114f0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 21 3d 30 Page->pDbPage!=0
11500 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 );. assert( sq
11510 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
11520 72 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ra(pPage->pDbPag
11530 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 70 50 61 e) == (void*)pPa
11540 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ge );. assert(
11550 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 sqlite3PagerGetD
11560 61 74 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ata(pPage->pDbPa
11570 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 44 61 74 ge)==pPage->aDat
11580 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 a );. assert( s
11590 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
115a0 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
115b0 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 tex) );. sqlite
115c0 33 50 61 67 65 72 55 6e 72 65 66 4e 6f 74 4e 75 3PagerUnrefNotNu
115d0 6c 6c 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ll(pPage->pDbPag
115e0 65 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 e);.}.static voi
115f0 64 20 72 65 6c 65 61 73 65 50 61 67 65 28 4d 65 d releasePage(Me
11600 6d 50 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 mPage *pPage){.
11610 20 69 66 28 20 70 50 61 67 65 20 29 20 72 65 6c if( pPage ) rel
11620 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 easePageNotNull(
11630 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a pPage);.}../*.**
11640 20 47 65 74 20 61 6e 20 75 6e 75 73 65 64 20 70 Get an unused p
11650 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 age..**.** This
11660 77 6f 72 6b 73 20 6a 75 73 74 20 6c 69 6b 65 20 works just like
11670 62 74 72 65 65 47 65 74 50 61 67 65 28 29 20 77 btreeGetPage() w
11680 69 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e ith the addition
11690 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 49 66 20 :.**.** * If
116a0 74 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 the page is alre
116b0 61 64 79 20 69 6e 20 75 73 65 20 66 6f 72 20 73 ady in use for s
116c0 6f 6d 65 20 6f 74 68 65 72 20 70 75 72 70 6f 73 ome other purpos
116d0 65 2c 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a e, immediately.*
116e0 2a 20 20 20 20 20 20 72 65 6c 65 61 73 65 20 69 * release i
116f0 74 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 t and return an
11700 53 51 4c 49 54 45 5f 43 55 52 52 55 50 54 20 65 SQLITE_CURRUPT e
11710 72 72 6f 72 2e 0a 2a 2a 20 20 20 2a 20 20 4d 61 rror..** * Ma
11720 6b 65 20 73 75 72 65 20 74 68 65 20 69 73 49 6e ke sure the isIn
11730 69 74 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 it flag is clear
11740 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 .*/.static int b
11750 74 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 treeGetUnusedPag
11760 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 e(. BtShared *p
11770 42 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 Bt, /* The
11780 20 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f btree */. Pgno
11790 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pgno,
117a0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 /* Number of th
117b0 65 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 e page to fetch
117c0 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 */. MemPage **p
117d0 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 pPage, /* Ret
117e0 75 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 urn the page in
117f0 74 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a this parameter *
11800 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 /. int flags
11810 20 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 /* PAGE
11820 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 R_GET_NOCONTENT
11830 6f 72 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 or PAGER_GET_REA
11840 44 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e DONLY */.){. in
11850 74 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 t rc = btreeGetP
11860 61 67 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 age(pBt, pgno, p
11870 70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 pPage, flags);.
11880 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
11890 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 73 71 OK ){. if( sq
118a0 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 52 65 lite3PagerPageRe
118b0 66 63 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 fcount((*ppPage)
118c0 2d 3e 70 44 62 50 61 67 65 29 3e 31 20 29 7b 0a ->pDbPage)>1 ){.
118d0 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
118e0 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 e(*ppPage);.
118f0 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 *ppPage = 0;.
11900 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
11910 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
11920 0a 20 20 20 20 7d 0a 20 20 20 20 28 2a 70 70 50 . }. (*ppP
11930 61 67 65 29 2d 3e 69 73 49 6e 69 74 20 3d 20 30 age)->isInit = 0
11940 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a ;. }else{. *
11950 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a ppPage = 0;. }.
11960 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
11970 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 20 ./*.** During a
11980 72 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 74 rollback, when t
11990 68 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 73 he pager reloads
119a0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 information int
119b0 6f 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 73 o the cache.** s
119c0 6f 20 74 68 61 74 20 74 68 65 20 63 61 63 68 65 o that the cache
119d0 20 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 is restored to
119e0 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 its original sta
119f0 74 65 20 61 74 20 74 68 65 20 73 74 61 72 74 20 te at the start
11a00 6f 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 of.** the transa
11a10 63 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 20 ction, for each
11a20 70 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 68 page restored th
11a30 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 is routine is ca
11a40 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 lled..**.** This
11a50 20 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 routine needs t
11a60 6f 20 72 65 73 65 74 20 74 68 65 20 65 78 74 72 o reset the extr
11a70 61 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 61 a data section a
11a80 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
11a90 0a 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 65 .** page to agre
11aa0 65 20 77 69 74 68 20 74 68 65 20 72 65 73 74 6f e with the resto
11ab0 72 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 red data..*/.sta
11ac0 74 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 69 tic void pageRei
11ad0 6e 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 74 nit(DbPage *pDat
11ae0 61 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 a){. MemPage *p
11af0 50 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d 20 Page;. pPage =
11b00 28 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 74 (MemPage *)sqlit
11b10 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 e3PagerGetExtra(
11b20 70 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74 pData);. assert
11b30 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ( sqlite3PagerPa
11b40 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 geRefcount(pData
11b50 29 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 61 )>0 );. if( pPa
11b60 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 ge->isInit ){.
11b70 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
11b80 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
11b90 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
11ba0 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 );. pPage->is
11bb0 49 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 Init = 0;. if
11bc0 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 ( sqlite3PagerPa
11bd0 67 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 geRefcount(pData
11be0 29 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 )>1 ){. /*
11bf0 70 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 20 pPage might not
11c00 62 65 20 61 20 62 74 72 65 65 20 70 61 67 65 3b be a btree page;
11c10 20 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 6e it might be an
11c20 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 overflow page.
11c30 20 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d 61 ** or ptrma
11c40 70 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 65 p page or a free
11c50 20 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 65 page. In those
11c60 20 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c 6c cases, the foll
11c70 6f 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 63 owing. ** c
11c80 61 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 74 all to btreeInit
11c90 50 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b 65 Page() will like
11ca0 6c 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ly return SQLITE
11cb0 5f 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 20 _CORRUPT..
11cc0 2a 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 69 ** But no harm i
11cd0 73 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e 20 s done by this.
11ce0 20 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 20 And it is very
11cf0 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a 20 important that.
11d00 20 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e 69 ** btreeIni
11d10 74 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c 65 tPage() be calle
11d20 64 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 65 d on every btree
11d30 20 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b 65 page so we make
11d40 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 61 . ** the ca
11d50 6c 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 67 ll for every pag
11d60 65 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e 20 e that comes in
11d70 66 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e 20 for re-initing.
11d80 2a 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 6e */. btreeIn
11d90 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 itPage(pPage);.
11da0 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a }. }.}../*.*
11db0 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 * Invoke the bus
11dc0 79 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 20 y handler for a
11dd0 62 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 btree..*/.static
11de0 20 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b 65 int btreeInvoke
11df0 42 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64 BusyHandler(void
11e00 20 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 61 *pArg){. BtSha
11e10 72 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 68 red *pBt = (BtSh
11e20 61 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 73 ared*)pArg;. as
11e30 73 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 3b sert( pBt->db );
11e40 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
11e50 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
11e60 74 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b t->db->mutex) );
11e70 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 . return sqlite
11e80 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 3InvokeBusyHandl
11e90 65 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 73 er(&pBt->db->bus
11ea0 79 48 61 6e 64 6c 65 72 29 3b 0a 7d 0a 0a 2f 2a yHandler);.}../*
11eb0 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 62 .** Open a datab
11ec0 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a ase file..** .**
11ed0 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 zFilename is th
11ee0 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 e name of the da
11ef0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
11f00 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 zFilename is NU
11f10 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 70 LL.** then an ep
11f20 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 hemeral database
11f30 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 is created. Th
11f40 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 e ephemeral data
11f50 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 65 base might.** be
11f60 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e 20 exclusively in
11f70 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d 69 memory, or it mi
11f80 67 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d 62 ght use a disk-b
11f90 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 68 ased memory cach
11fa0 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 79 e..** Either way
11fb0 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c 20 , the ephemeral
11fc0 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 database will be
11fd0 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
11fe0 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e 20 eleted .** when
11ff0 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
12000 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a e() is called..*
12010 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d *.** If zFilenam
12020 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 e is ":memory:"
12030 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 then an in-memor
12040 79 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 y database is cr
12050 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 73 eated.** that is
12060 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
12070 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 74 estroyed when it
12080 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a is closed..**.*
12090 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 61 * The "flags" pa
120a0 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 74 rameter is a bit
120b0 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 20 mask that might
120c0 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 6b contain bits lik
120d0 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 5f e.** BTREE_OMIT_
120e0 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 42 JOURNAL and/or B
120f0 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a 0a TREE_MEMORY..**.
12100 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
12110 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 se is already op
12120 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 ened in the same
12130 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
12140 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 61 tion.** and we a
12150 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 re in shared cac
12160 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 he mode, then th
12170 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 6c e open will fail
12180 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c 49 with an.** SQLI
12190 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 72 TE_CONSTRAINT er
121a0 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 20 ror. We cannot
121b0 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f 72 allow two or mor
121c0 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f 62 e BtShared.** ob
121d0 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 6d jects in the sam
121e0 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
121f0 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 6e ction since doin
12200 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a 2a g so will lead.*
12210 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 69 * to problems wi
12220 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 th locking..*/.i
12230 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f nt sqlite3BtreeO
12240 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 pen(. sqlite3_v
12250 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 2f fs *pVfs, /
12260 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f 72 * VFS to use for
12270 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f 0a this b-tree */.
12280 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
12290 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 6d ilename, /* Nam
122a0 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f e of the file co
122b0 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 ntaining the BTr
122c0 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ee database */.
122d0 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
122e0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 6f /* Asso
122f0 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 ciated database
12300 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65 handle */. Btre
12310 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 20 e **ppBtree,
12320 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
12330 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 o new Btree obje
12340 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 ct written here
12350 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 */. int flags,
12360 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
12370 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 Options */. int
12380 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 20 vfsFlags
12390 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 /* Flags pa
123a0 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 ssed through to
123b0 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
123c0 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 n() */.){. BtSh
123d0 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 20 ared *pBt = 0;
123e0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
123f0 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 72 ared part of btr
12400 65 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a ee structure */.
12410 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 20 Btree *p;
12420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12430 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 65 /* Handle to re
12440 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 turn */. sqlite
12450 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f 70 3_mutex *mutexOp
12460 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 76 en = 0; /* Prev
12470 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e 64 ents a race cond
12480 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 33 ition. Ticket #3
12490 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 537 */. int rc
124a0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
124b0 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c /* Resul
124c0 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 73 t code from this
124d0 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 function */. u
124e0 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 8 nReserve;
124f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
12500 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 20 Byte of unused
12510 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 space on each pa
12520 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ge */. unsigned
12530 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 5b char zDbHeader[
12540 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 61 100]; /* Databa
12550 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 6e se header conten
12560 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 20 t */.. /* True
12570 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 70 if opening an ep
12580 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 61 hemeral, tempora
12590 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ry database */.
125a0 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 6d const int isTem
125b0 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3d pDb = zFilename=
125c0 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b =0 || zFilename[
125d0 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 74 0]==0;.. /* Set
125e0 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 the variable is
125f0 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 6f Memdb to true fo
12600 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 r an in-memory d
12610 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 2a atabase, or . *
12620 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 69 * false for a fi
12630 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 73 le-based databas
12640 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 e.. */.#ifdef S
12650 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
12660 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 YDB. const int
12670 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 6c isMemdb = 0;.#el
12680 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 se. const int i
12690 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 6e sMemdb = (zFilen
126a0 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a 46 ame && strcmp(zF
126b0 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f 72 ilename, ":memor
126c0 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 20 y:")==0).
126d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
126e0 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 20 || (isTempDb &&
126f0 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d sqlite3TempInMem
12700 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 20 ory(db)).
12710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12720 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 53 || (vfsFlags & S
12730 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
12740 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 Y)!=0;.#endif..
12750 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 assert( db!=0 )
12760 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 73 ;. assert( pVfs
12770 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
12780 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
12790 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
127a0 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 ;. assert( (fla
127b0 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 20 gs&0xff)==flags
127c0 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 ); /* flags fi
127d0 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a 0a t in 8 bits */..
127e0 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 45 /* Only a BTRE
127f0 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 E_SINGLE databas
12800 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f 55 e can be BTREE_U
12810 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 73 NORDERED */. as
12820 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 sert( (flags & B
12830 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 3d TREE_UNORDERED)=
12840 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 42 =0 || (flags & B
12850 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 20 TREE_SINGLE)!=0
12860 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 45 );.. /* A BTREE
12870 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 _SINGLE database
12880 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 6d is always a tem
12890 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 70 porary and/or ep
128a0 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 73 hemeral */. ass
128b0 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 ert( (flags & BT
128c0 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 7c REE_SINGLE)==0 |
128d0 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a 20 | isTempDb );..
128e0 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a if( isMemdb ){.
128f0 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 52 flags |= BTR
12900 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 20 EE_MEMORY;. }.
12910 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 if( (vfsFlags &
12920 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
12930 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 4d N_DB)!=0 && (isM
12940 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 62 emdb || isTempDb
12950 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 ) ){. vfsFlag
12960 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 s = (vfsFlags &
12970 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 ~SQLITE_OPEN_MAI
12980 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f N_DB) | SQLITE_O
12990 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d PEN_TEMP_DB;. }
129a0 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 . p = sqlite3Ma
129b0 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 llocZero(sizeof(
129c0 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 21 Btree));. if( !
129d0 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 p ){. return
129e0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
129f0 54 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 T;. }. p->inTr
12a00 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 ans = TRANS_NONE
12a10 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a ;. p->db = db;.
12a20 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
12a30 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
12a40 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 . p->lock.pBtre
12a50 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b e = p;. p->lock
12a60 2e 69 54 61 62 6c 65 20 3d 20 31 3b 0a 23 65 6e .iTable = 1;.#en
12a70 64 69 66 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 dif..#if !define
12a80 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 d(SQLITE_OMIT_SH
12a90 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 ARED_CACHE) && !
12aa0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
12ab0 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a MIT_DISKIO). /*
12ac0 0a 20 20 2a 2a 20 49 66 20 74 68 69 73 20 42 74 . ** If this Bt
12ad0 72 65 65 20 69 73 20 61 20 63 61 6e 64 69 64 61 ree is a candida
12ae0 74 65 20 66 6f 72 20 73 68 61 72 65 64 20 63 61 te for shared ca
12af0 63 68 65 2c 20 74 72 79 20 74 6f 20 66 69 6e 64 che, try to find
12b00 20 61 6e 0a 20 20 2a 2a 20 65 78 69 73 74 69 6e an. ** existin
12b10 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 g BtShared objec
12b20 74 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 68 t that we can sh
12b30 61 72 65 20 77 69 74 68 0a 20 20 2a 2f 0a 20 20 are with. */.
12b40 69 66 28 20 69 73 54 65 6d 70 44 62 3d 3d 30 20 if( isTempDb==0
12b50 26 26 20 28 69 73 4d 65 6d 64 62 3d 3d 30 20 7c && (isMemdb==0 |
12b60 7c 20 28 76 66 73 46 6c 61 67 73 26 53 51 4c 49 | (vfsFlags&SQLI
12b70 54 45 5f 4f 50 45 4e 5f 55 52 49 29 21 3d 30 29 TE_OPEN_URI)!=0)
12b80 20 29 7b 0a 20 20 20 20 69 66 28 20 76 66 73 46 ){. if( vfsF
12b90 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
12ba0 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 29 EN_SHAREDCACHE )
12bb0 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 69 6c {. int nFil
12bc0 65 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 ename = sqlite3S
12bd0 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d trlen30(zFilenam
12be0 65 29 2b 31 3b 0a 20 20 20 20 20 20 69 6e 74 20 e)+1;. int
12bf0 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 nFullPathname =
12c00 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 pVfs->mxPathname
12c10 2b 31 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a +1;. char *
12c20 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 zFullPathname =
12c30 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 4d 41 sqlite3Malloc(MA
12c40 58 28 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c X(nFullPathname,
12c50 6e 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 20 nFilename));.
12c60 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
12c70 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
12c80 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 0a 20 utexShared; )..
12c90 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 p->sharable
12ca0 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 = 1;. if(
12cb0 21 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 !zFullPathname )
12cc0 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
12cd0 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 3_free(p);.
12ce0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
12cf0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
12d00 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 69 }. if( i
12d10 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 20 20 sMemdb ){.
12d20 20 20 6d 65 6d 63 70 79 28 7a 46 75 6c 6c 50 61 memcpy(zFullPa
12d30 74 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 6e 61 6d thname, zFilenam
12d40 65 2c 20 6e 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 e, nFilename);.
12d50 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
12d60 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
12d70 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 OsFullPathname(p
12d80 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a Vfs, zFilename,.
12d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12db0 20 20 20 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 nFullPathname
12dc0 2c 20 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 , zFullPathname)
12dd0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
12de0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
12df0 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c lite3_free(zFull
12e00 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 Pathname);.
12e10 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
12e20 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 e(p);.
12e30 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
12e40 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 69 66 }. }.#if
12e50 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
12e60 46 45 0a 20 20 20 20 20 20 6d 75 74 65 78 4f 70 FE. mutexOp
12e70 65 6e 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 en = sqlite3Mute
12e80 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
12e90 54 45 58 5f 53 54 41 54 49 43 5f 4f 50 45 4e 29 TEX_STATIC_OPEN)
12ea0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
12eb0 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
12ec0 78 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 6d 75 xOpen);. mu
12ed0 74 65 78 53 68 61 72 65 64 20 3d 20 73 71 6c 69 texShared = sqli
12ee0 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
12ef0 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
12f00 43 5f 4d 41 53 54 45 52 29 3b 0a 20 20 20 20 20 C_MASTER);.
12f10 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
12f20 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 nter(mutexShared
12f30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 );.#endif.
12f40 66 6f 72 28 70 42 74 3d 47 4c 4f 42 41 4c 28 42 for(pBt=GLOBAL(B
12f50 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 tShared*,sqlite3
12f60 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 SharedCacheList)
12f70 3b 20 70 42 74 3b 20 70 42 74 3d 70 42 74 2d 3e ; pBt; pBt=pBt->
12f80 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 pNext){.
12f90 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 52 65 assert( pBt->nRe
12fa0 66 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 f>0 );. i
12fb0 66 28 20 30 3d 3d 73 74 72 63 6d 70 28 7a 46 75 f( 0==strcmp(zFu
12fc0 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 73 71 6c 69 llPathname, sqli
12fd0 74 65 33 50 61 67 65 72 46 69 6c 65 6e 61 6d 65 te3PagerFilename
12fe0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 30 29 (pBt->pPager, 0)
12ff0 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
13000 20 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 && sqlite3Pag
13010 65 72 56 66 73 28 70 42 74 2d 3e 70 50 61 67 65 erVfs(pBt->pPage
13020 72 29 3d 3d 70 56 66 73 20 29 7b 0a 20 20 20 20 r)==pVfs ){.
13030 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 int iDb;.
13040 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 44 62 for(iDb
13050 3d 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 44 62 3e =db->nDb-1; iDb>
13060 3d 30 3b 20 69 44 62 2d 2d 29 7b 0a 20 20 20 20 =0; iDb--){.
13070 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 Btree *p
13080 45 78 69 73 74 69 6e 67 20 3d 20 64 62 2d 3e 61 Existing = db->a
13090 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 Db[iDb].pBt;.
130a0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 45 78 if( pEx
130b0 69 73 74 69 6e 67 20 26 26 20 70 45 78 69 73 74 isting && pExist
130c0 69 6e 67 2d 3e 70 42 74 3d 3d 70 42 74 20 29 7b ing->pBt==pBt ){
130d0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
130e0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
130f0 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b ve(mutexShared);
13100 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
13110 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
13120 76 65 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 ve(mutexOpen);.
13130 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c sql
13140 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 ite3_free(zFullP
13150 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 athname);.
13160 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
13170 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 free(p);.
13180 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
13190 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3b LITE_CONSTRAINT;
131a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
131b0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
131c0 20 20 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 p->pBt = pB
131d0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 70 42 74 t;. pBt
131e0 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 ->nRef++;.
131f0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
13200 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
13210 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
13220 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 61 72 _leave(mutexShar
13230 65 64 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ed);. sqlit
13240 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 e3_free(zFullPat
13250 68 6e 61 6d 65 29 3b 0a 20 20 20 20 7d 0a 23 69 hname);. }.#i
13260 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
13270 47 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 G. else{.
13280 20 20 2f 2a 20 49 6e 20 64 65 62 75 67 20 6d 6f /* In debug mo
13290 64 65 2c 20 77 65 20 6d 61 72 6b 20 61 6c 6c 20 de, we mark all
132a0 70 65 72 73 69 73 74 65 6e 74 20 64 61 74 61 62 persistent datab
132b0 61 73 65 73 20 61 73 20 73 68 61 72 61 62 6c 65 ases as sharable
132c0 0a 20 20 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 . ** even w
132d0 68 65 6e 20 74 68 65 79 20 61 72 65 20 6e 6f 74 hen they are not
132e0 2e 20 20 54 68 69 73 20 65 78 65 72 63 69 73 65 . This exercise
132f0 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f s the locking co
13300 64 65 20 61 6e 64 0a 20 20 20 20 20 20 2a 2a 20 de and. **
13310 67 69 76 65 73 20 6d 6f 72 65 20 6f 70 70 6f 72 gives more oppor
13320 74 75 6e 69 74 79 20 66 6f 72 20 61 73 73 65 72 tunity for asser
13330 74 73 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 ts(sqlite3_mutex
13340 5f 68 65 6c 64 28 29 29 0a 20 20 20 20 20 20 2a _held()). *
13350 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 * statements to
13360 66 69 6e 64 20 6c 6f 63 6b 69 6e 67 20 70 72 6f find locking pro
13370 62 6c 65 6d 73 2e 0a 20 20 20 20 20 20 2a 2f 0a blems.. */.
13380 20 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c p->sharabl
13390 65 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e e = 1;. }.#en
133a0 64 69 66 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 dif. }.#endif.
133b0 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 if( pBt==0 ){.
133c0 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 /*. ** The
133d0 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 following asser
133e0 74 73 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 ts make sure tha
133f0 74 20 73 74 72 75 63 74 75 72 65 73 20 75 73 65 t structures use
13400 64 20 62 79 20 74 68 65 20 62 74 72 65 65 20 61 d by the btree a
13410 72 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 72 69 re. ** the ri
13420 67 68 74 20 73 69 7a 65 2e 20 20 54 68 69 73 20 ght size. This
13430 69 73 20 74 6f 20 67 75 61 72 64 20 61 67 61 69 is to guard agai
13440 6e 73 74 20 73 69 7a 65 20 63 68 61 6e 67 65 73 nst size changes
13450 20 74 68 61 74 20 72 65 73 75 6c 74 0a 20 20 20 that result.
13460 20 2a 2a 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 ** when compili
13470 6e 67 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e ng on a differen
13480 74 20 61 72 63 68 69 74 65 63 74 75 72 65 2e 0a t architecture..
13490 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 */. asser
134a0 74 28 20 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d t( sizeof(i64)==
134b0 38 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 8 );. assert(
134c0 20 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 sizeof(u64)==8
134d0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
134e0 69 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 3b izeof(u32)==4 );
134f0 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a . assert( siz
13500 65 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a 20 eof(u16)==2 );.
13510 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f assert( sizeo
13520 66 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 20 f(Pgno)==4 );.
13530 0a 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 74 . pBt = sqlit
13540 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 e3MallocZero( si
13550 7a 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 20 zeof(*pBt) );.
13560 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a if( pBt==0 ){.
13570 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
13580 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
13590 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f goto btree_o
135a0 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 pen_out;. }.
135b0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
135c0 61 67 65 72 4f 70 65 6e 28 70 56 66 73 2c 20 26 agerOpen(pVfs, &
135d0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a 46 69 pBt->pPager, zFi
135e0 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 lename,.
135f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13600 20 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 sizeof(MemPage
13610 29 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 ), flags, vfsFla
13620 67 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b gs, pageReinit);
13630 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
13640 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
13650 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d sqlite3PagerSetM
13660 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 mapLimit(pBt->pP
13670 61 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 ager, db->szMmap
13680 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
13690 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 lite3PagerReadFi
136a0 6c 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 leheader(pBt->pP
136b0 61 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 ager,sizeof(zDbH
136c0 65 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 eader),zDbHeader
136d0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
136e0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
136f0 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 {. goto btr
13700 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
13710 20 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e }. pBt->open
13720 46 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 Flags = (u8)flag
13730 73 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d s;. pBt->db =
13740 20 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 db;. sqlite3
13750 50 61 67 65 72 53 65 74 42 75 73 79 68 61 6e 64 PagerSetBusyhand
13760 6c 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ler(pBt->pPager,
13770 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
13780 48 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 Handler, pBt);.
13790 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b p->pBt = pBt;
137a0 0a 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 . . pBt->pCu
137b0 72 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 rsor = 0;. pB
137c0 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 t->pPage1 = 0;.
137d0 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 if( sqlite3Pa
137e0 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 gerIsreadonly(pB
137f0 74 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 t->pPager) ) pBt
13800 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
13810 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 S_READ_ONLY;.#if
13820 64 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 52 def SQLITE_SECUR
13830 45 5f 44 45 4c 45 54 45 0a 20 20 20 20 70 42 74 E_DELETE. pBt
13840 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
13850 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b S_SECURE_DELETE;
13860 0a 23 65 6e 64 69 66 0a 20 20 20 20 2f 2a 20 45 .#endif. /* E
13870 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 31 VIDENCE-OF: R-51
13880 38 37 33 2d 33 39 36 31 38 20 54 68 65 20 70 61 873-39618 The pa
13890 67 65 20 73 69 7a 65 20 66 6f 72 20 61 20 64 61 ge size for a da
138a0 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 0a 20 tabase file is.
138b0 20 20 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 ** determined
138c0 20 62 79 20 74 68 65 20 32 2d 62 79 74 65 20 69 by the 2-byte i
138d0 6e 74 65 67 65 72 20 6c 6f 63 61 74 65 64 20 61 nteger located a
138e0 74 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 20 31 t an offset of 1
138f0 36 20 62 79 74 65 73 20 66 72 6f 6d 0a 20 20 20 6 bytes from.
13900 20 2a 2a 20 74 68 65 20 62 65 67 69 6e 6e 69 6e ** the beginnin
13910 67 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 g of the databas
13920 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 70 e file. */. p
13930 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 Bt->pageSize = (
13940 7a 44 62 48 65 61 64 65 72 5b 31 36 5d 3c 3c 38 zDbHeader[16]<<8
13950 29 20 7c 20 28 7a 44 62 48 65 61 64 65 72 5b 31 ) | (zDbHeader[1
13960 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 69 66 28 7]<<16);. if(
13970 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 35 pBt->pageSize<5
13980 31 32 20 7c 7c 20 70 42 74 2d 3e 70 61 67 65 53 12 || pBt->pageS
13990 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 ize>SQLITE_MAX_P
139a0 41 47 45 5f 53 49 5a 45 0a 20 20 20 20 20 20 20 AGE_SIZE.
139b0 20 20 7c 7c 20 28 28 70 42 74 2d 3e 70 61 67 65 || ((pBt->page
139c0 53 69 7a 65 2d 31 29 26 70 42 74 2d 3e 70 61 67 Size-1)&pBt->pag
139d0 65 53 69 7a 65 29 21 3d 30 20 29 7b 0a 20 20 20 eSize)!=0 ){.
139e0 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 pBt->pageSize
139f0 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 20 53 51 = 0;.#ifndef SQ
13a00 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
13a10 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 CUUM. /* If
13a20 20 74 68 65 20 6d 61 67 69 63 20 6e 61 6d 65 20 the magic name
13a30 22 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 6c 6c 20 ":memory:" will
13a40 63 72 65 61 74 65 20 61 6e 20 69 6e 2d 6d 65 6d create an in-mem
13a50 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 74 68 ory database, th
13a60 65 6e 0a 20 20 20 20 20 20 2a 2a 20 6c 65 61 76 en. ** leav
13a70 65 20 74 68 65 20 61 75 74 6f 56 61 63 75 75 6d e the autoVacuum
13a80 20 6d 6f 64 65 20 61 74 20 30 20 28 64 6f 20 6e mode at 0 (do n
13a90 6f 74 20 61 75 74 6f 2d 76 61 63 75 75 6d 29 2c ot auto-vacuum),
13aa0 20 65 76 65 6e 20 69 66 0a 20 20 20 20 20 20 2a even if. *
13ab0 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 * SQLITE_DEFAULT
13ac0 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 73 20 74 _AUTOVACUUM is t
13ad0 72 75 65 2e 20 4f 6e 20 74 68 65 20 6f 74 68 65 rue. On the othe
13ae0 72 20 68 61 6e 64 2c 20 69 66 0a 20 20 20 20 20 r hand, if.
13af0 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ** SQLITE_OMIT_
13b00 4d 45 4d 4f 52 59 44 42 20 68 61 73 20 62 65 65 MEMORYDB has bee
13b10 6e 20 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 n defined, then
13b20 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 20 6a 75 ":memory:" is ju
13b30 73 74 20 61 0a 20 20 20 20 20 20 2a 2a 20 72 65 st a. ** re
13b40 67 75 6c 61 72 20 66 69 6c 65 2d 6e 61 6d 65 2e gular file-name.
13b50 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 In this case th
13b60 65 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 61 70 e auto-vacuum ap
13b70 70 6c 69 65 73 20 61 73 20 70 65 72 20 6e 6f 72 plies as per nor
13b80 6d 61 6c 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 mal.. */.
13b90 20 20 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d if( zFilenam
13ba0 65 20 26 26 20 21 69 73 4d 65 6d 64 62 20 29 7b e && !isMemdb ){
13bb0 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 61 75 . pBt->au
13bc0 74 6f 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 toVacuum = (SQLI
13bd0 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 TE_DEFAULT_AUTOV
13be0 41 43 55 55 4d 20 3f 20 31 20 3a 20 30 29 3b 0a ACUUM ? 1 : 0);.
13bf0 20 20 20 20 20 20 20 20 70 42 74 2d 3e 69 6e 63 pBt->inc
13c00 72 56 61 63 75 75 6d 20 3d 20 28 53 51 4c 49 54 rVacuum = (SQLIT
13c10 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 E_DEFAULT_AUTOVA
13c20 43 55 55 4d 3d 3d 32 20 3f 20 31 20 3a 20 30 29 CUUM==2 ? 1 : 0)
13c30 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 ;. }.#endif
13c40 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 . nReserve
13c50 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a = 0;. }else{.
13c60 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 /* EVIDENC
13c70 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 2d 34 32 E-OF: R-37497-42
13c80 34 31 32 20 54 68 65 20 73 69 7a 65 20 6f 66 20 412 The size of
13c90 74 68 65 20 72 65 73 65 72 76 65 64 20 72 65 67 the reserved reg
13ca0 69 6f 6e 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 ion is. **
13cb0 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
13cc0 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e 73 69 67 e one-byte unsig
13cd0 6e 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 6e ned integer foun
13ce0 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f d at an offset o
13cf0 66 20 32 30 0a 20 20 20 20 20 20 2a 2a 20 69 6e f 20. ** in
13d00 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
13d10 66 69 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a file header. */.
13d20 20 20 20 20 20 20 6e 52 65 73 65 72 76 65 20 3d nReserve =
13d30 20 7a 44 62 48 65 61 64 65 72 5b 32 30 5d 3b 0a zDbHeader[20];.
13d40 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c pBt->btsFl
13d50 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 ags |= BTS_PAGES
13d60 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 IZE_FIXED;.#ifnd
13d70 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
13d80 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 UTOVACUUM.
13d90 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
13da0 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 = (get4byte(&zDb
13db0 48 65 61 64 65 72 5b 33 36 20 2b 20 34 2a 34 5d Header[36 + 4*4]
13dc0 29 3f 31 3a 30 29 3b 0a 20 20 20 20 20 20 70 42 )?1:0);. pB
13dd0 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 t->incrVacuum =
13de0 28 67 65 74 34 62 79 74 65 28 26 7a 44 62 48 65 (get4byte(&zDbHe
13df0 61 64 65 72 5b 33 36 20 2b 20 37 2a 34 5d 29 3f ader[36 + 7*4])?
13e00 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 1:0);.#endif.
13e10 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 }. rc = sqli
13e20 74 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 te3PagerSetPages
13e30 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ize(pBt->pPager,
13e40 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c &pBt->pageSize,
13e50 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 20 20 nReserve);.
13e60 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 62 74 if( rc ) goto bt
13e70 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 ree_open_out;.
13e80 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a pBt->usableSiz
13e90 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a e = pBt->pageSiz
13ea0 65 20 2d 20 6e 52 65 73 65 72 76 65 3b 0a 20 20 e - nReserve;.
13eb0 20 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e assert( (pBt->
13ec0 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d 3d 30 pageSize & 7)==0
13ed0 20 29 3b 20 20 2f 2a 20 38 2d 62 79 74 65 20 61 ); /* 8-byte a
13ee0 6c 69 67 6e 6d 65 6e 74 20 6f 66 20 70 61 67 65 lignment of page
13ef0 53 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 69 66 20 Size */. .#if
13f00 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
13f10 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
13f20 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 E) && !defined(S
13f30 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 QLITE_OMIT_DISKI
13f40 4f 29 0a 20 20 20 20 2f 2a 20 41 64 64 20 74 68 O). /* Add th
13f50 65 20 6e 65 77 20 42 74 53 68 61 72 65 64 20 6f e new BtShared o
13f60 62 6a 65 63 74 20 74 6f 20 74 68 65 20 6c 69 6e bject to the lin
13f70 6b 65 64 20 6c 69 73 74 20 73 68 61 72 61 62 6c ked list sharabl
13f80 65 20 42 74 53 68 61 72 65 64 73 2e 0a 20 20 20 e BtShareds..
13f90 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 6e 52 65 */. pBt->nRe
13fa0 66 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 70 f = 1;. if( p
13fb0 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 ->sharable ){.
13fc0 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 MUTEX_LOGIC(
13fd0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a sqlite3_mutex *
13fe0 6d 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 20 mutexShared; ).
13ff0 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 MUTEX_LOGIC
14000 28 20 6d 75 74 65 78 53 68 61 72 65 64 20 3d 20 ( mutexShared =
14010 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f sqlite3MutexAllo
14020 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 c(SQLITE_MUTEX_S
14030 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 29 0a TATIC_MASTER);).
14040 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 if( SQLITE
14050 5f 54 48 52 45 41 44 53 41 46 45 20 26 26 20 73 _THREADSAFE && s
14060 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
14070 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 20 29 7b ig.bCoreMutex ){
14080 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 6d 75 . pBt->mu
14090 74 65 78 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 tex = sqlite3Mut
140a0 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d exAlloc(SQLITE_M
140b0 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 UTEX_FAST);.
140c0 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6d 75 74 if( pBt->mut
140d0 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ex==0 ){.
140e0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
140f0 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 OMEM_BKPT;.
14100 20 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f goto btree_
14110 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 20 20 open_out;.
14120 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
14130 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
14140 65 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 enter(mutexShare
14150 64 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 d);. pBt->p
14160 4e 65 78 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 Next = GLOBAL(Bt
14170 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
14180 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b haredCacheList);
14190 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 . GLOBAL(Bt
141a0 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
141b0 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 20 haredCacheList)
141c0 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 73 71 6c = pBt;. sql
141d0 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
141e0 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 (mutexShared);.
141f0 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 7d 0a }.#endif. }.
14200 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 .#if !defined(SQ
14210 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
14220 5f 43 41 43 48 45 29 20 26 26 20 21 64 65 66 69 _CACHE) && !defi
14230 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
14240 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 20 49 66 20 DISKIO). /* If
14250 74 68 65 20 6e 65 77 20 42 74 72 65 65 20 75 73 the new Btree us
14260 65 73 20 61 20 73 68 61 72 61 62 6c 65 20 70 42 es a sharable pB
14270 74 53 68 61 72 65 64 2c 20 74 68 65 6e 20 6c 69 tShared, then li
14280 6e 6b 20 74 68 65 20 6e 65 77 0a 20 20 2a 2a 20 nk the new. **
14290 42 74 72 65 65 20 69 6e 74 6f 20 74 68 65 20 6c Btree into the l
142a0 69 73 74 20 6f 66 20 61 6c 6c 20 73 68 61 72 61 ist of all shara
142b0 62 6c 65 20 42 74 72 65 65 73 20 66 6f 72 20 74 ble Btrees for t
142c0 68 65 20 73 61 6d 65 20 63 6f 6e 6e 65 63 74 69 he same connecti
142d0 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 6c 69 73 on.. ** The lis
142e0 74 20 69 73 20 6b 65 70 74 20 69 6e 20 61 73 63 t is kept in asc
142f0 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 62 79 20 ending order by
14300 70 42 74 20 61 64 64 72 65 73 73 2e 0a 20 20 2a pBt address.. *
14310 2f 0a 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 /. if( p->shara
14320 62 6c 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 ble ){. int i
14330 3b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 53 69 ;. Btree *pSi
14340 62 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 b;. for(i=0;
14350 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b i<db->nDb; i++){
14360 0a 20 20 20 20 20 20 69 66 28 20 28 70 53 69 62 . if( (pSib
14370 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 = db->aDb[i].pB
14380 74 29 21 3d 30 20 26 26 20 70 53 69 62 2d 3e 73 t)!=0 && pSib->s
14390 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 harable ){.
143a0 20 20 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e while( pSib->
143b0 70 50 72 65 76 20 29 7b 20 70 53 69 62 20 3d 20 pPrev ){ pSib =
143c0 70 53 69 62 2d 3e 70 50 72 65 76 3b 20 7d 0a 20 pSib->pPrev; }.
143d0 20 20 20 20 20 20 20 69 66 28 20 28 75 70 74 72 if( (uptr
143e0 29 70 2d 3e 70 42 74 3c 28 75 70 74 72 29 70 53 )p->pBt<(uptr)pS
143f0 69 62 2d 3e 70 42 74 20 29 7b 0a 20 20 20 20 20 ib->pBt ){.
14400 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 p->pNext =
14410 70 53 69 62 3b 0a 20 20 20 20 20 20 20 20 20 20 pSib;.
14420 70 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 p->pPrev = 0;.
14430 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 50 pSib->pP
14440 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 rev = p;.
14450 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
14460 20 20 77 68 69 6c 65 28 20 70 53 69 62 2d 3e 70 while( pSib->p
14470 4e 65 78 74 20 26 26 20 28 75 70 74 72 29 70 53 Next && (uptr)pS
14480 69 62 2d 3e 70 4e 65 78 74 2d 3e 70 42 74 3c 28 ib->pNext->pBt<(
14490 75 70 74 72 29 70 2d 3e 70 42 74 20 29 7b 0a 20 uptr)p->pBt ){.
144a0 20 20 20 20 20 20 20 20 20 20 20 70 53 69 62 20 pSib
144b0 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 = pSib->pNext;.
144c0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
144d0 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 p->pNext =
144e0 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 pSib->pNext;.
144f0 20 20 20 20 20 20 20 70 2d 3e 70 50 72 65 76 20 p->pPrev
14500 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 20 = pSib;.
14510 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 if( p->pNext )
14520 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 2d {. p-
14530 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 >pNext->pPrev =
14540 70 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 p;. }.
14550 20 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 pSib->p
14560 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 20 20 20 Next = p;.
14570 20 20 7d 0a 20 20 20 20 20 20 20 20 62 72 65 61 }. brea
14580 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
14590 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 2a 70 . }.#endif. *p
145a0 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a 62 74 72 pBtree = p;..btr
145b0 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a 20 20 69 ee_open_out:. i
145c0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
145d0 20 29 7b 0a 20 20 20 20 69 66 28 20 70 42 74 20 ){. if( pBt
145e0 26 26 20 70 42 74 2d 3e 70 50 61 67 65 72 20 29 && pBt->pPager )
145f0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
14600 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e 70 agerClose(pBt->p
14610 50 61 67 65 72 2c 20 30 29 3b 0a 20 20 20 20 7d Pager, 0);. }
14620 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
14630 65 28 70 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 e(pBt);. sqli
14640 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 te3_free(p);.
14650 20 2a 70 70 42 74 72 65 65 20 3d 20 30 3b 0a 20 *ppBtree = 0;.
14660 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 }else{. sqli
14670 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 3b te3_file *pFile;
14680 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 .. /* If the
14690 42 2d 54 72 65 65 20 77 61 73 20 73 75 63 63 65 B-Tree was succe
146a0 73 73 66 75 6c 6c 79 20 6f 70 65 6e 65 64 2c 20 ssfully opened,
146b0 73 65 74 20 74 68 65 20 70 61 67 65 72 2d 63 61 set the pager-ca
146c0 63 68 65 20 73 69 7a 65 20 74 6f 20 74 68 65 0a che size to the.
146d0 20 20 20 20 2a 2a 20 64 65 66 61 75 6c 74 20 76 ** default v
146e0 61 6c 75 65 2e 20 45 78 63 65 70 74 2c 20 77 68 alue. Except, wh
146f0 65 6e 20 6f 70 65 6e 69 6e 67 20 6f 6e 20 61 6e en opening on an
14700 20 65 78 69 73 74 69 6e 67 20 73 68 61 72 65 64 existing shared
14710 20 70 61 67 65 72 2d 63 61 63 68 65 2c 0a 20 20 pager-cache,.
14720 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 63 68 61 6e ** do not chan
14730 67 65 20 74 68 65 20 70 61 67 65 72 2d 63 61 63 ge the pager-cac
14740 68 65 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a he size.. */.
14750 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 42 if( sqlite3B
14760 74 72 65 65 53 63 68 65 6d 61 28 70 2c 20 30 2c treeSchema(p, 0,
14770 20 30 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 0)==0 ){.
14780 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 sqlite3PagerSetC
14790 61 63 68 65 73 69 7a 65 28 70 2d 3e 70 42 74 2d achesize(p->pBt-
147a0 3e 70 50 61 67 65 72 2c 20 53 51 4c 49 54 45 5f >pPager, SQLITE_
147b0 44 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 DEFAULT_CACHE_SI
147c0 5a 45 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 ZE);. }..
147d0 70 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 50 pFile = sqlite3P
147e0 61 67 65 72 46 69 6c 65 28 70 42 74 2d 3e 70 50 agerFile(pBt->pP
147f0 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 70 ager);. if( p
14800 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29 File->pMethods )
14810 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f {. sqlite3O
14820 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 sFileControlHint
14830 28 70 46 69 6c 65 2c 20 53 51 4c 49 54 45 5f 46 (pFile, SQLITE_F
14840 43 4e 54 4c 5f 50 44 42 2c 20 28 76 6f 69 64 2a CNTL_PDB, (void*
14850 29 26 70 42 74 2d 3e 64 62 29 3b 0a 20 20 20 20 )&pBt->db);.
14860 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6d 75 74 65 }. }. if( mute
14870 78 4f 70 65 6e 20 29 7b 0a 20 20 20 20 61 73 73 xOpen ){. ass
14880 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
14890 65 78 5f 68 65 6c 64 28 6d 75 74 65 78 4f 70 65 ex_held(mutexOpe
148a0 6e 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 n) );. sqlite
148b0 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 3_mutex_leave(mu
148c0 74 65 78 4f 70 65 6e 29 3b 0a 20 20 7d 0a 20 20 texOpen);. }.
148d0 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
148e0 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 74 65 33 TE_OK || sqlite3
148f0 42 74 72 65 65 43 6f 6e 6e 65 63 74 69 6f 6e 43 BtreeConnectionC
14900 6f 75 6e 74 28 2a 70 70 42 74 72 65 65 29 3e 30 ount(*ppBtree)>0
14910 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
14920 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 72 65 6d .}../*.** Decrem
14930 65 6e 74 20 74 68 65 20 42 74 53 68 61 72 65 64 ent the BtShared
14940 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 2e 20 20 .nRef counter.
14950 57 68 65 6e 20 69 74 20 72 65 61 63 68 65 73 20 When it reaches
14960 7a 65 72 6f 2c 0a 2a 2a 20 72 65 6d 6f 76 65 20 zero,.** remove
14970 74 68 65 20 42 74 53 68 61 72 65 64 20 73 74 72 the BtShared str
14980 75 63 74 75 72 65 20 66 72 6f 6d 20 74 68 65 20 ucture from the
14990 73 68 61 72 69 6e 67 20 6c 69 73 74 2e 20 20 52 sharing list. R
149a0 65 74 75 72 6e 0a 2a 2a 20 74 72 75 65 20 69 66 eturn.** true if
149b0 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 6e 52 the BtShared.nR
149c0 65 66 20 63 6f 75 6e 74 65 72 20 72 65 61 63 68 ef counter reach
149d0 65 73 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 es zero and retu
149e0 72 6e 0a 2a 2a 20 66 61 6c 73 65 20 69 66 20 69 rn.** false if i
149f0 74 20 69 73 20 73 74 69 6c 6c 20 70 6f 73 69 74 t is still posit
14a00 69 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ive..*/.static i
14a10 6e 74 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 nt removeFromSha
14a20 72 69 6e 67 4c 69 73 74 28 42 74 53 68 61 72 65 ringList(BtShare
14a30 64 20 2a 70 42 74 29 7b 0a 23 69 66 6e 64 65 66 d *pBt){.#ifndef
14a40 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
14a50 52 45 44 5f 43 41 43 48 45 0a 20 20 4d 55 54 45 RED_CACHE. MUTE
14a60 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 X_LOGIC( sqlite3
14a70 5f 6d 75 74 65 78 20 2a 70 4d 61 73 74 65 72 3b _mutex *pMaster;
14a80 20 29 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ). BtShared *p
14a90 4c 69 73 74 3b 0a 20 20 69 6e 74 20 72 65 6d 6f List;. int remo
14aa0 76 65 64 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 ved = 0;.. asse
14ab0 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
14ac0 78 5f 6e 6f 74 68 65 6c 64 28 70 42 74 2d 3e 6d x_notheld(pBt->m
14ad0 75 74 65 78 29 20 29 3b 0a 20 20 4d 55 54 45 58 utex) );. MUTEX
14ae0 5f 4c 4f 47 49 43 28 20 70 4d 61 73 74 65 72 20 _LOGIC( pMaster
14af0 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
14b00 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
14b10 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b _STATIC_MASTER);
14b20 20 29 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 ). sqlite3_mut
14b30 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 74 65 72 ex_enter(pMaster
14b40 29 3b 0a 20 20 70 42 74 2d 3e 6e 52 65 66 2d 2d );. pBt->nRef--
14b50 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 52 65 ;. if( pBt->nRe
14b60 66 3c 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 f<=0 ){. if(
14b70 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a GLOBAL(BtShared*
14b80 2c 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 ,sqlite3SharedCa
14b90 63 68 65 4c 69 73 74 29 3d 3d 70 42 74 20 29 7b cheList)==pBt ){
14ba0 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c 28 42 74 . GLOBAL(Bt
14bb0 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
14bc0 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 20 haredCacheList)
14bd0 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 = pBt->pNext;.
14be0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 }else{. p
14bf0 4c 69 73 74 20 3d 20 47 4c 4f 42 41 4c 28 42 74 List = GLOBAL(Bt
14c00 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 Shared*,sqlite3S
14c10 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b haredCacheList);
14c20 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 41 4c . while( AL
14c30 57 41 59 53 28 70 4c 69 73 74 29 20 26 26 20 70 WAYS(pList) && p
14c40 4c 69 73 74 2d 3e 70 4e 65 78 74 21 3d 70 42 74 List->pNext!=pBt
14c50 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4c 69 73 ){. pLis
14c60 74 3d 70 4c 69 73 74 2d 3e 70 4e 65 78 74 3b 0a t=pList->pNext;.
14c70 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
14c80 28 20 41 4c 57 41 59 53 28 70 4c 69 73 74 29 20 ( ALWAYS(pList)
14c90 29 7b 0a 20 20 20 20 20 20 20 20 70 4c 69 73 74 ){. pList
14ca0 2d 3e 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 ->pNext = pBt->p
14cb0 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 Next;. }.
14cc0 20 20 7d 0a 20 20 20 20 69 66 28 20 53 51 4c 49 }. if( SQLI
14cd0 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 29 7b TE_THREADSAFE ){
14ce0 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d . sqlite3_m
14cf0 75 74 65 78 5f 66 72 65 65 28 70 42 74 2d 3e 6d utex_free(pBt->m
14d00 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 utex);. }.
14d10 20 72 65 6d 6f 76 65 64 20 3d 20 31 3b 0a 20 20 removed = 1;.
14d20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 }. sqlite3_mute
14d30 78 5f 6c 65 61 76 65 28 70 4d 61 73 74 65 72 29 x_leave(pMaster)
14d40 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 6d 6f 76 ;. return remov
14d50 65 64 3b 0a 23 65 6c 73 65 0a 20 20 72 65 74 75 ed;.#else. retu
14d60 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a rn 1;.#endif.}..
14d70 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 /*.** Make sure
14d80 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 70 pBt->pTmpSpace p
14d90 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 6c 6c 6f oints to an allo
14da0 63 61 74 69 6f 6e 20 6f 66 20 0a 2a 2a 20 4d 58 cation of .** MX
14db0 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 _CELL_SIZE(pBt)
14dc0 62 79 74 65 73 20 77 69 74 68 20 61 20 34 2d 62 bytes with a 4-b
14dd0 79 74 65 20 70 72 65 66 69 78 20 66 6f 72 20 61 yte prefix for a
14de0 20 6c 65 66 74 2d 63 68 69 6c 64 0a 2a 2a 20 70 left-child.** p
14df0 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 ointer..*/.stati
14e00 63 20 76 6f 69 64 20 61 6c 6c 6f 63 61 74 65 54 c void allocateT
14e10 65 6d 70 53 70 61 63 65 28 42 74 53 68 61 72 65 empSpace(BtShare
14e20 64 20 2a 70 42 74 29 7b 0a 20 20 69 66 28 20 21 d *pBt){. if( !
14e30 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 29 pBt->pTmpSpace )
14e40 7b 0a 20 20 20 20 70 42 74 2d 3e 70 54 6d 70 53 {. pBt->pTmpS
14e50 70 61 63 65 20 3d 20 73 71 6c 69 74 65 33 50 61 pace = sqlite3Pa
14e60 67 65 4d 61 6c 6c 6f 63 28 20 70 42 74 2d 3e 70 geMalloc( pBt->p
14e70 61 67 65 53 69 7a 65 20 29 3b 0a 0a 20 20 20 20 ageSize );..
14e80 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 75 73 /* One of the us
14e90 65 73 20 6f 66 20 70 42 74 2d 3e 70 54 6d 70 53 es of pBt->pTmpS
14ea0 70 61 63 65 20 69 73 20 74 6f 20 66 6f 72 6d 61 pace is to forma
14eb0 74 20 63 65 6c 6c 73 20 62 65 66 6f 72 65 0a 20 t cells before.
14ec0 20 20 20 2a 2a 20 69 6e 73 65 72 74 69 6e 67 20 ** inserting
14ed0 74 68 65 6d 20 69 6e 74 6f 20 61 20 6c 65 61 66 them into a leaf
14ee0 20 70 61 67 65 20 28 66 75 6e 63 74 69 6f 6e 20 page (function
14ef0 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 29 2e 20 49 fillInCell()). I
14f00 66 0a 20 20 20 20 2a 2a 20 61 20 63 65 6c 6c 20 f. ** a cell
14f10 69 73 20 6c 65 73 73 20 74 68 61 6e 20 34 20 62 is less than 4 b
14f20 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 69 74 ytes in size, it
14f30 20 69 73 20 72 6f 75 6e 64 65 64 20 75 70 20 74 is rounded up t
14f40 6f 20 34 20 62 79 74 65 73 0a 20 20 20 20 2a 2a o 4 bytes. **
14f50 20 62 79 20 74 68 65 20 76 61 72 69 6f 75 73 20 by the various
14f60 72 6f 75 74 69 6e 65 73 20 74 68 61 74 20 6d 61 routines that ma
14f70 6e 69 70 75 6c 61 74 65 20 62 69 6e 61 72 79 20 nipulate binary
14f80 63 65 6c 6c 73 2e 20 57 68 69 63 68 0a 20 20 20 cells. Which.
14f90 20 2a 2a 20 63 61 6e 20 6d 65 61 6e 20 74 68 61 ** can mean tha
14fa0 74 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f t fillInCell() o
14fb0 6e 6c 79 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 nly initializes
14fc0 74 68 65 20 66 69 72 73 74 20 32 20 6f 72 20 33 the first 2 or 3
14fd0 0a 20 20 20 20 2a 2a 20 62 79 74 65 73 20 6f 66 . ** bytes of
14fe0 20 70 54 6d 70 53 70 61 63 65 2c 20 62 75 74 20 pTmpSpace, but
14ff0 74 68 61 74 20 74 68 65 20 66 69 72 73 74 20 34 that the first 4
15000 20 62 79 74 65 73 20 61 72 65 20 63 6f 70 69 65 bytes are copie
15010 64 20 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 69 74 d from. ** it
15020 20 69 6e 74 6f 20 61 20 64 61 74 61 62 61 73 65 into a database
15030 20 70 61 67 65 2e 20 54 68 69 73 20 69 73 20 6e page. This is n
15040 6f 74 20 61 63 74 75 61 6c 6c 79 20 61 20 70 72 ot actually a pr
15050 6f 62 6c 65 6d 2c 20 62 75 74 20 69 74 0a 20 20 oblem, but it.
15060 20 20 2a 2a 20 64 6f 65 73 20 63 61 75 73 65 20 ** does cause
15070 61 20 76 61 6c 67 72 69 6e 64 20 65 72 72 6f 72 a valgrind error
15080 20 77 68 65 6e 20 74 68 65 20 31 20 6f 72 20 32 when the 1 or 2
15090 20 62 79 74 65 73 20 6f 66 20 75 6e 69 74 69 61 bytes of unitia
150a0 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a 20 64 61 lized . ** da
150b0 74 61 20 69 73 20 70 61 73 73 65 64 20 74 6f 20 ta is passed to
150c0 73 79 73 74 65 6d 20 63 61 6c 6c 20 77 72 69 74 system call writ
150d0 65 28 29 2e 20 53 6f 20 74 6f 20 61 76 6f 69 64 e(). So to avoid
150e0 20 74 68 69 73 20 65 72 72 6f 72 2c 0a 20 20 20 this error,.
150f0 20 2a 2a 20 7a 65 72 6f 20 74 68 65 20 66 69 72 ** zero the fir
15100 73 74 20 34 20 62 79 74 65 73 20 6f 66 20 74 65 st 4 bytes of te
15110 6d 70 20 73 70 61 63 65 20 68 65 72 65 2e 0a 20 mp space here..
15120 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 41 6c 73 **. ** Als
15130 6f 3a 20 20 50 72 6f 76 69 64 65 20 66 6f 75 72 o: Provide four
15140 20 62 79 74 65 73 20 6f 66 20 69 6e 69 74 69 61 bytes of initia
15150 6c 69 7a 65 64 20 73 70 61 63 65 20 62 65 66 6f lized space befo
15160 72 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 62 65 re the. ** be
15170 67 69 6e 6e 69 6e 67 20 6f 66 20 70 54 6d 70 53 ginning of pTmpS
15180 70 61 63 65 20 61 73 20 61 6e 20 61 72 65 61 20 pace as an area
15190 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 70 72 65 available to pre
151a0 70 65 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 pend the. **
151b0 6c 65 66 74 2d 63 68 69 6c 64 20 70 6f 69 6e 74 left-child point
151c0 65 72 20 74 6f 20 74 68 65 20 62 65 67 69 6e 6e er to the beginn
151d0 69 6e 67 20 6f 66 20 61 20 63 65 6c 6c 2e 0a 20 ing of a cell..
151e0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 42 */. if( pB
151f0 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 29 7b 0a t->pTmpSpace ){.
15200 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 42 74 memset(pBt
15210 2d 3e 70 54 6d 70 53 70 61 63 65 2c 20 30 2c 20 ->pTmpSpace, 0,
15220 38 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 8);. pBt->p
15230 54 6d 70 53 70 61 63 65 20 2b 3d 20 34 3b 0a 20 TmpSpace += 4;.
15240 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a }. }.}../*.*
15250 2a 20 46 72 65 65 20 74 68 65 20 70 42 74 2d 3e * Free the pBt->
15260 70 54 6d 70 53 70 61 63 65 20 61 6c 6c 6f 63 61 pTmpSpace alloca
15270 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 tion.*/.static v
15280 6f 69 64 20 66 72 65 65 54 65 6d 70 53 70 61 63 oid freeTempSpac
15290 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 e(BtShared *pBt)
152a0 7b 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 54 6d {. if( pBt->pTm
152b0 70 53 70 61 63 65 20 29 7b 0a 20 20 20 20 70 42 pSpace ){. pB
152c0 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 2d 3d 20 t->pTmpSpace -=
152d0 34 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 4;. sqlite3Pa
152e0 67 65 46 72 65 65 28 70 42 74 2d 3e 70 54 6d 70 geFree(pBt->pTmp
152f0 53 70 61 63 65 29 3b 0a 20 20 20 20 70 42 74 2d Space);. pBt-
15300 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 30 3b 0a >pTmpSpace = 0;.
15310 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f }.}../*.** Clo
15320 73 65 20 61 6e 20 6f 70 65 6e 20 64 61 74 61 62 se an open datab
15330 61 73 65 20 61 6e 64 20 69 6e 76 61 6c 69 64 61 ase and invalida
15340 74 65 20 61 6c 6c 20 63 75 72 73 6f 72 73 2e 0a te all cursors..
15350 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
15360 72 65 65 43 6c 6f 73 65 28 42 74 72 65 65 20 2a reeClose(Btree *
15370 70 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a p){. BtShared *
15380 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
15390 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a BtCursor *pCur;.
153a0 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 . /* Close all
153b0 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 64 20 76 cursors opened v
153c0 69 61 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 20 ia this handle.
153d0 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 71 */. assert( sq
153e0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
153f0 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 (p->db->mutex) )
15400 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
15410 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 43 75 72 Enter(p);. pCur
15420 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b = pBt->pCursor;
15430 0a 20 20 77 68 69 6c 65 28 20 70 43 75 72 20 29 . while( pCur )
15440 7b 0a 20 20 20 20 42 74 43 75 72 73 6f 72 20 2a {. BtCursor *
15450 70 54 6d 70 20 3d 20 70 43 75 72 3b 0a 20 20 20 pTmp = pCur;.
15460 20 70 43 75 72 20 3d 20 70 43 75 72 2d 3e 70 4e pCur = pCur->pN
15470 65 78 74 3b 0a 20 20 20 20 69 66 28 20 70 54 6d ext;. if( pTm
15480 70 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 7b 0a p->pBtree==p ){.
15490 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
154a0 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 70 54 eeCloseCursor(pT
154b0 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a mp);. }. }..
154c0 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6e /* Rollback an
154d0 79 20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 y active transac
154e0 74 69 6f 6e 20 61 6e 64 20 66 72 65 65 20 74 68 tion and free th
154f0 65 20 68 61 6e 64 6c 65 20 73 74 72 75 63 74 75 e handle structu
15500 72 65 2e 0a 20 20 2a 2a 20 54 68 65 20 63 61 6c re.. ** The cal
15510 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 l to sqlite3Btre
15520 65 52 6f 6c 6c 62 61 63 6b 28 29 20 64 72 6f 70 eRollback() drop
15530 73 20 61 6e 79 20 74 61 62 6c 65 2d 6c 6f 63 6b s any table-lock
15540 73 20 68 65 6c 64 20 62 79 0a 20 20 2a 2a 20 74 s held by. ** t
15550 68 69 73 20 68 61 6e 64 6c 65 2e 0a 20 20 2a 2f his handle.. */
15560 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 . sqlite3BtreeR
15570 6f 6c 6c 62 61 63 6b 28 70 2c 20 53 51 4c 49 54 ollback(p, SQLIT
15580 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 73 71 6c 69 E_OK, 0);. sqli
15590 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
155a0 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 ;.. /* If there
155b0 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 68 65 72 are still other
155c0 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 outstanding ref
155d0 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 73 erences to the s
155e0 68 61 72 65 64 2d 62 74 72 65 65 0a 20 20 2a 2a hared-btree. **
155f0 20 73 74 72 75 63 74 75 72 65 2c 20 72 65 74 75 structure, retu
15600 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 65 6d 61 rn now. The rema
15610 69 6e 64 65 72 20 6f 66 20 74 68 69 73 20 70 72 inder of this pr
15620 6f 63 65 64 75 72 65 20 63 6c 65 61 6e 73 20 0a ocedure cleans .
15630 20 20 2a 2a 20 75 70 20 74 68 65 20 73 68 61 72 ** up the shar
15640 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a 2f 0a 20 ed-btree.. */.
15650 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e 74 assert( p->want
15660 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 70 2d 3e ToLock==0 && p->
15670 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 69 locked==0 );. i
15680 66 28 20 21 70 2d 3e 73 68 61 72 61 62 6c 65 20 f( !p->sharable
15690 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 || removeFromSha
156a0 72 69 6e 67 4c 69 73 74 28 70 42 74 29 20 29 7b ringList(pBt) ){
156b0 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 42 74 20 . /* The pBt
156c0 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6f 6e 20 is no longer on
156d0 74 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 the sharing list
156e0 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 63 63 65 , so we can acce
156f0 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 77 69 74 ss. ** it wit
15700 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 68 hout having to h
15710 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 2e 0a 20 old the mutex..
15720 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 6c 65 **. ** Cle
15730 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 6c 65 74 an out and delet
15740 65 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6f e the BtShared o
15750 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 bject.. */.
15760 20 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e assert( !pBt->
15770 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 20 73 pCursor );. s
15780 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 qlite3PagerClose
15790 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 2d (pBt->pPager, p-
157a0 3e 64 62 29 3b 0a 20 20 20 20 69 66 28 20 70 42 >db);. if( pB
157b0 74 2d 3e 78 46 72 65 65 53 63 68 65 6d 61 20 26 t->xFreeSchema &
157c0 26 20 70 42 74 2d 3e 70 53 63 68 65 6d 61 20 29 & pBt->pSchema )
157d0 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 78 46 72 {. pBt->xFr
157e0 65 65 53 63 68 65 6d 61 28 70 42 74 2d 3e 70 53 eeSchema(pBt->pS
157f0 63 68 65 6d 61 29 3b 0a 20 20 20 20 7d 0a 20 20 chema);. }.
15800 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
15810 30 2c 20 70 42 74 2d 3e 70 53 63 68 65 6d 61 29 0, pBt->pSchema)
15820 3b 0a 20 20 20 20 66 72 65 65 54 65 6d 70 53 70 ;. freeTempSp
15830 61 63 65 28 70 42 74 29 3b 0a 20 20 20 20 73 71 ace(pBt);. sq
15840 6c 69 74 65 33 5f 66 72 65 65 28 70 42 74 29 3b lite3_free(pBt);
15850 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 . }..#ifndef SQ
15860 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
15870 5f 43 41 43 48 45 0a 20 20 61 73 73 65 72 74 28 _CACHE. assert(
15880 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 6b 3d 3d p->wantToLock==
15890 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
158a0 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 ->locked==0 );.
158b0 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29 20 if( p->pPrev )
158c0 70 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 p->pPrev->pNext
158d0 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 69 66 = p->pNext;. if
158e0 28 20 70 2d 3e 70 4e 65 78 74 20 29 20 70 2d 3e ( p->pNext ) p->
158f0 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 pNext->pPrev = p
15900 2d 3e 70 50 72 65 76 3b 0a 23 65 6e 64 69 66 0a ->pPrev;.#endif.
15910 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
15920 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c p);. return SQL
15930 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
15940 20 43 68 61 6e 67 65 20 74 68 65 20 22 73 6f 66 Change the "sof
15950 74 22 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 t" limit on the
15960 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
15970 69 6e 20 74 68 65 20 63 61 63 68 65 2e 0a 2a 2a in the cache..**
15980 20 55 6e 75 73 65 64 20 61 6e 64 20 75 6e 6d 6f Unused and unmo
15990 64 69 66 69 65 64 20 70 61 67 65 73 20 77 69 6c dified pages wil
159a0 6c 20 62 65 20 72 65 63 79 63 6c 65 64 20 77 68 l be recycled wh
159b0 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 en the number of
159c0 0a 2a 2a 20 70 61 67 65 73 20 69 6e 20 74 68 65 .** pages in the
159d0 20 63 61 63 68 65 20 65 78 63 65 65 64 73 20 74 cache exceeds t
159e0 68 69 73 20 73 6f 66 74 20 6c 69 6d 69 74 2e 20 his soft limit.
159f0 20 42 75 74 20 74 68 65 20 73 69 7a 65 20 6f 66 But the size of
15a00 20 74 68 65 0a 2a 2a 20 63 61 63 68 65 20 69 73 the.** cache is
15a10 20 61 6c 6c 6f 77 65 64 20 74 6f 20 67 72 6f 77 allowed to grow
15a20 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 68 69 larger than thi
15a30 73 20 6c 69 6d 69 74 20 69 66 20 69 74 20 63 6f s limit if it co
15a40 6e 74 61 69 6e 73 0a 2a 2a 20 64 69 72 74 79 20 ntains.** dirty
15a50 70 61 67 65 73 20 6f 72 20 70 61 67 65 73 20 73 pages or pages s
15a60 74 69 6c 6c 20 69 6e 20 61 63 74 69 76 65 20 75 till in active u
15a70 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 se..*/.int sqlit
15a80 65 33 42 74 72 65 65 53 65 74 43 61 63 68 65 53 e3BtreeSetCacheS
15a90 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e ize(Btree *p, in
15aa0 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 74 53 t mxPage){. BtS
15ab0 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
15ac0 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 pBt;. assert( s
15ad0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
15ae0 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 d(p->db->mutex)
15af0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
15b00 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c eEnter(p);. sql
15b10 69 74 65 33 50 61 67 65 72 53 65 74 43 61 63 68 ite3PagerSetCach
15b20 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 esize(pBt->pPage
15b30 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 r, mxPage);. sq
15b40 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
15b50 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c p);. return SQL
15b60 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
15b70 20 43 68 61 6e 67 65 20 74 68 65 20 22 73 70 69 Change the "spi
15b80 6c 6c 22 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 ll" limit on the
15b90 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
15ba0 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e 0a 2a in the cache..*
15bb0 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 65 72 20 * If the number
15bc0 6f 66 20 70 61 67 65 73 20 65 78 63 65 65 64 73 of pages exceeds
15bd0 20 74 68 69 73 20 6c 69 6d 69 74 20 64 75 72 69 this limit duri
15be0 6e 67 20 61 20 77 72 69 74 65 20 74 72 61 6e 73 ng a write trans
15bf0 61 63 74 69 6f 6e 2c 0a 2a 2a 20 74 68 65 20 70 action,.** the p
15c00 61 67 65 72 20 6d 69 67 68 74 20 61 74 74 65 6d ager might attem
15c10 70 74 20 74 6f 20 22 73 70 69 6c 6c 22 20 70 61 pt to "spill" pa
15c20 67 65 73 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e ges to the journ
15c30 61 6c 20 65 61 72 6c 79 20 69 6e 0a 2a 2a 20 6f al early in.** o
15c40 72 64 65 72 20 74 6f 20 66 72 65 65 20 75 70 20 rder to free up
15c50 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 memory..**.** Th
15c60 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 e value returned
15c70 20 69 73 20 74 68 65 20 63 75 72 72 65 6e 74 20 is the current
15c80 73 70 69 6c 6c 20 73 69 7a 65 2e 20 20 49 66 20 spill size. If
15c90 7a 65 72 6f 20 69 73 20 70 61 73 73 65 64 0a 2a zero is passed.*
15ca0 2a 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 * as an argument
15cb0 2c 20 6e 6f 20 63 68 61 6e 67 65 73 20 61 72 65 , no changes are
15cc0 20 6d 61 64 65 20 74 6f 20 74 68 65 20 73 70 69 made to the spi
15cd0 6c 6c 20 73 69 7a 65 20 73 65 74 74 69 6e 67 2c ll size setting,
15ce0 20 73 6f 0a 2a 2a 20 75 73 69 6e 67 20 6d 78 50 so.** using mxP
15cf0 61 67 65 20 6f 66 20 30 20 69 73 20 61 20 77 61 age of 0 is a wa
15d00 79 20 74 6f 20 71 75 65 72 79 20 74 68 65 20 63 y to query the c
15d10 75 72 72 65 6e 74 20 73 70 69 6c 6c 20 73 69 7a urrent spill siz
15d20 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
15d30 33 42 74 72 65 65 53 65 74 53 70 69 6c 6c 53 69 3BtreeSetSpillSi
15d40 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 ze(Btree *p, int
15d50 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 74 53 68 mxPage){. BtSh
15d60 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
15d70 42 74 3b 0a 20 20 69 6e 74 20 72 65 73 3b 0a 20 Bt;. int res;.
15d80 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
15d90 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 _mutex_held(p->d
15da0 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 b->mutex) );. s
15db0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
15dc0 28 70 29 3b 0a 20 20 72 65 73 20 3d 20 73 71 6c (p);. res = sql
15dd0 69 74 65 33 50 61 67 65 72 53 65 74 53 70 69 6c ite3PagerSetSpil
15de0 6c 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 lsize(pBt->pPage
15df0 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 r, mxPage);. sq
15e00 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
15e10 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 73 p);. return res
15e20 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f ;.}..#if SQLITE_
15e30 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a MAX_MMAP_SIZE>0.
15e40 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 /*.** Change the
15e50 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 20 61 6d limit on the am
15e60 6f 75 6e 74 20 6f 66 20 74 68 65 20 64 61 74 61 ount of the data
15e70 62 61 73 65 20 66 69 6c 65 20 74 68 61 74 20 6d base file that m
15e80 61 79 20 62 65 0a 2a 2a 20 6d 65 6d 6f 72 79 20 ay be.** memory
15e90 6d 61 70 70 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 mapped..*/.int s
15ea0 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 4d 6d qlite3BtreeSetMm
15eb0 61 70 4c 69 6d 69 74 28 42 74 72 65 65 20 2a 70 apLimit(Btree *p
15ec0 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 , sqlite3_int64
15ed0 73 7a 4d 6d 61 70 29 7b 0a 20 20 42 74 53 68 61 szMmap){. BtSha
15ee0 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
15ef0 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c t;. assert( sql
15f00 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
15f10 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b p->db->mutex) );
15f20 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
15f30 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 nter(p);. sqlit
15f40 65 33 50 61 67 65 72 53 65 74 4d 6d 61 70 4c 69 e3PagerSetMmapLi
15f50 6d 69 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c mit(pBt->pPager,
15f60 20 73 7a 4d 6d 61 70 29 3b 0a 20 20 73 71 6c 69 szMmap);. sqli
15f70 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
15f80 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
15f90 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f E_OK;.}.#endif /
15fa0 2a 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 * SQLITE_MAX_MMA
15fb0 50 5f 53 49 5a 45 3e 30 20 2a 2f 0a 0a 2f 2a 0a P_SIZE>0 */../*.
15fc0 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 77 61 ** Change the wa
15fd0 79 20 64 61 74 61 20 69 73 20 73 79 6e 63 65 64 y data is synced
15fe0 20 74 6f 20 64 69 73 6b 20 69 6e 20 6f 72 64 65 to disk in orde
15ff0 72 20 74 6f 20 69 6e 63 72 65 61 73 65 20 6f 72 r to increase or
16000 20 64 65 63 72 65 61 73 65 0a 2a 2a 20 68 6f 77 decrease.** how
16010 20 77 65 6c 6c 20 74 68 65 20 64 61 74 61 62 61 well the databa
16020 73 65 20 72 65 73 69 73 74 73 20 64 61 6d 61 67 se resists damag
16030 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72 61 73 e due to OS cras
16040 68 65 73 20 61 6e 64 20 70 6f 77 65 72 0a 2a 2a hes and power.**
16050 20 66 61 69 6c 75 72 65 73 2e 20 20 4c 65 76 65 failures. Leve
16060 6c 20 31 20 69 73 20 74 68 65 20 73 61 6d 65 20 l 1 is the same
16070 61 73 20 61 73 79 6e 63 68 72 6f 6e 6f 75 73 20 as asynchronous
16080 28 6e 6f 20 73 79 6e 63 73 28 29 20 6f 63 63 75 (no syncs() occu
16090 72 20 61 6e 64 0a 2a 2a 20 74 68 65 72 65 20 69 r and.** there i
160a0 73 20 61 20 68 69 67 68 20 70 72 6f 62 61 62 69 s a high probabi
160b0 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 65 29 20 lity of damage)
160c0 20 4c 65 76 65 6c 20 32 20 69 73 20 74 68 65 20 Level 2 is the
160d0 64 65 66 61 75 6c 74 2e 20 20 54 68 65 72 65 0a default. There.
160e0 2a 2a 20 69 73 20 61 20 76 65 72 79 20 6c 6f 77 ** is a very low
160f0 20 62 75 74 20 6e 6f 6e 2d 7a 65 72 6f 20 70 72 but non-zero pr
16100 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d obability of dam
16110 61 67 65 2e 20 20 4c 65 76 65 6c 20 33 20 72 65 age. Level 3 re
16120 64 75 63 65 73 20 74 68 65 0a 2a 2a 20 70 72 6f duces the.** pro
16130 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 bability of dama
16140 67 65 20 74 6f 20 6e 65 61 72 20 7a 65 72 6f 20 ge to near zero
16150 62 75 74 20 77 69 74 68 20 61 20 77 72 69 74 65 but with a write
16160 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 72 65 64 performance red
16170 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 uction..*/.#ifnd
16180 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 ef SQLITE_OMIT_P
16190 41 47 45 52 5f 50 52 41 47 4d 41 53 0a 69 6e 74 AGER_PRAGMAS.int
161a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 sqlite3BtreeSet
161b0 50 61 67 65 72 46 6c 61 67 73 28 0a 20 20 42 74 PagerFlags(. Bt
161c0 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 ree *p,
161d0 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 /* The btre
161e0 65 20 74 6f 20 73 65 74 20 74 68 65 20 73 61 66 e to set the saf
161f0 65 74 79 20 6c 65 76 65 6c 20 6f 6e 20 2a 2f 0a ety level on */.
16200 20 20 75 6e 73 69 67 6e 65 64 20 70 67 46 6c 61 unsigned pgFla
16210 67 73 20 20 20 20 20 20 20 2f 2a 20 56 61 72 69 gs /* Vari
16220 6f 75 73 20 50 41 47 45 52 5f 2a 20 66 6c 61 67 ous PAGER_* flag
16230 73 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 s */.){. BtShar
16240 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
16250 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
16260 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
16270 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
16280 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
16290 74 65 72 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 ter(p);. sqlite
162a0 33 50 61 67 65 72 53 65 74 46 6c 61 67 73 28 70 3PagerSetFlags(p
162b0 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 46 6c Bt->pPager, pgFl
162c0 61 67 73 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 ags);. sqlite3B
162d0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
162e0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
162f0 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a ;.}.#endif../*.*
16300 2a 20 43 68 61 6e 67 65 20 74 68 65 20 64 65 66 * Change the def
16310 61 75 6c 74 20 70 61 67 65 73 20 73 69 7a 65 20 ault pages size
16320 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 72 20 6f and the number o
16330 66 20 72 65 73 65 72 76 65 64 20 62 79 74 65 73 f reserved bytes
16340 20 70 65 72 20 70 61 67 65 2e 0a 2a 2a 20 4f 72 per page..** Or
16350 2c 20 69 66 20 74 68 65 20 70 61 67 65 20 73 69 , if the page si
16360 7a 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 ze has already b
16370 65 65 6e 20 66 69 78 65 64 2c 20 72 65 74 75 72 een fixed, retur
16380 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c n SQLITE_READONL
16390 59 20 0a 2a 2a 20 77 69 74 68 6f 75 74 20 63 68 Y .** without ch
163a0 61 6e 67 69 6e 67 20 61 6e 79 74 68 69 6e 67 2e anging anything.
163b0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 .**.** The page
163c0 73 69 7a 65 20 6d 75 73 74 20 62 65 20 61 20 70 size must be a p
163d0 6f 77 65 72 20 6f 66 20 32 20 62 65 74 77 65 65 ower of 2 betwee
163e0 6e 20 35 31 32 20 61 6e 64 20 36 35 35 33 36 2e n 512 and 65536.
163f0 20 20 49 66 20 74 68 65 20 70 61 67 65 0a 2a 2a If the page.**
16400 20 73 69 7a 65 20 73 75 70 70 6c 69 65 64 20 64 size supplied d
16410 6f 65 73 20 6e 6f 74 20 6d 65 65 74 20 74 68 69 oes not meet thi
16420 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 74 68 65 s constraint the
16430 6e 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 n the page size
16440 69 73 20 6e 6f 74 0a 2a 2a 20 63 68 61 6e 67 65 is not.** change
16450 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 20 73 69 d..**.** Page si
16460 7a 65 73 20 61 72 65 20 63 6f 6e 73 74 72 61 69 zes are constrai
16470 6e 65 64 20 74 6f 20 62 65 20 61 20 70 6f 77 65 ned to be a powe
16480 72 20 6f 66 20 74 77 6f 20 73 6f 20 74 68 61 74 r of two so that
16490 20 74 68 65 20 72 65 67 69 6f 6e 0a 2a 2a 20 6f the region.** o
164a0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
164b0 69 6c 65 20 75 73 65 64 20 66 6f 72 20 6c 6f 63 ile used for loc
164c0 6b 69 6e 67 20 28 62 65 67 69 6e 6e 69 6e 67 20 king (beginning
164d0 61 74 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 2c at PENDING_BYTE,
164e0 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 62 79 .** the first by
164f0 74 65 20 70 61 73 74 20 74 68 65 20 31 47 42 20 te past the 1GB
16500 62 6f 75 6e 64 61 72 79 2c 20 30 78 34 30 30 30 boundary, 0x4000
16510 30 30 30 30 29 20 6e 65 65 64 73 20 74 6f 20 6f 0000) needs to o
16520 63 63 75 72 0a 2a 2a 20 61 74 20 74 68 65 20 62 ccur.** at the b
16530 65 67 69 6e 6e 69 6e 67 20 6f 66 20 61 20 70 61 eginning of a pa
16540 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 72 ge..**.** If par
16550 61 6d 65 74 65 72 20 6e 52 65 73 65 72 76 65 20 ameter nReserve
16560 69 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 is less than zer
16570 6f 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 o, then the numb
16580 65 72 20 6f 66 20 72 65 73 65 72 76 65 64 0a 2a er of reserved.*
16590 2a 20 62 79 74 65 73 20 70 65 72 20 70 61 67 65 * bytes per page
165a0 20 69 73 20 6c 65 66 74 20 75 6e 63 68 61 6e 67 is left unchang
165b0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
165c0 20 69 46 69 78 21 3d 30 20 74 68 65 6e 20 74 68 iFix!=0 then th
165d0 65 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 e BTS_PAGESIZE_F
165e0 49 58 45 44 20 66 6c 61 67 20 69 73 20 73 65 74 IXED flag is set
165f0 20 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 67 so that the pag
16600 65 20 73 69 7a 65 0a 2a 2a 20 61 6e 64 20 61 75 e size.** and au
16610 74 6f 76 61 63 75 75 6d 20 6d 6f 64 65 20 63 61 tovacuum mode ca
16620 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 65 20 63 n no longer be c
16630 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 hanged..*/.int s
16640 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 50 61 qlite3BtreeSetPa
16650 67 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c geSize(Btree *p,
16660 20 69 6e 74 20 70 61 67 65 53 69 7a 65 2c 20 69 int pageSize, i
16670 6e 74 20 6e 52 65 73 65 72 76 65 2c 20 69 6e 74 nt nReserve, int
16680 20 69 46 69 78 29 7b 0a 20 20 69 6e 74 20 72 63 iFix){. int rc
16690 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
166a0 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
166b0 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 p->pBt;. assert
166c0 28 20 6e 52 65 73 65 72 76 65 3e 3d 2d 31 20 26 ( nReserve>=-1 &
166d0 26 20 6e 52 65 73 65 72 76 65 3c 3d 32 35 35 20 & nReserve<=255
166e0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
166f0 65 45 6e 74 65 72 28 70 29 3b 0a 23 69 66 20 53 eEnter(p);.#if S
16700 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a QLITE_HAS_CODEC.
16710 20 20 69 66 28 20 6e 52 65 73 65 72 76 65 3e 70 if( nReserve>p
16720 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 73 65 72 Bt->optimalReser
16730 76 65 20 29 20 70 42 74 2d 3e 6f 70 74 69 6d 61 ve ) pBt->optima
16740 6c 52 65 73 65 72 76 65 20 3d 20 28 75 38 29 6e lReserve = (u8)n
16750 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 69 66 0a Reserve;.#endif.
16760 20 20 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c if( pBt->btsFl
16770 61 67 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 ags & BTS_PAGESI
16780 5a 45 5f 46 49 58 45 44 20 29 7b 0a 20 20 20 20 ZE_FIXED ){.
16790 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
167a0 65 28 70 29 3b 0a 20 20 20 20 72 65 74 75 72 6e e(p);. return
167b0 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 SQLITE_READONLY
167c0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 52 65 73 ;. }. if( nRes
167d0 65 72 76 65 3c 30 20 29 7b 0a 20 20 20 20 6e 52 erve<0 ){. nR
167e0 65 73 65 72 76 65 20 3d 20 70 42 74 2d 3e 70 61 eserve = pBt->pa
167f0 67 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 geSize - pBt->us
16800 61 62 6c 65 53 69 7a 65 3b 0a 20 20 7d 0a 20 20 ableSize;. }.
16810 61 73 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 assert( nReserve
16820 3e 3d 30 20 26 26 20 6e 52 65 73 65 72 76 65 3c >=0 && nReserve<
16830 3d 32 35 35 20 29 3b 0a 20 20 69 66 28 20 70 61 =255 );. if( pa
16840 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 geSize>=512 && p
16850 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 54 45 5f ageSize<=SQLITE_
16860 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 26 26 MAX_PAGE_SIZE &&
16870 0a 20 20 20 20 20 20 20 20 28 28 70 61 67 65 53 . ((pageS
16880 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 ize-1)&pageSize)
16890 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ==0 ){. asser
168a0 74 28 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 t( (pageSize & 7
168b0 29 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 )==0 );. asse
168c0 72 74 28 20 21 70 42 74 2d 3e 70 43 75 72 73 6f rt( !pBt->pCurso
168d0 72 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 61 r );. pBt->pa
168e0 67 65 53 69 7a 65 20 3d 20 28 75 33 32 29 70 61 geSize = (u32)pa
168f0 67 65 53 69 7a 65 3b 0a 20 20 20 20 66 72 65 65 geSize;. free
16900 54 65 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a TempSpace(pBt);.
16910 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
16920 65 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 e3PagerSetPagesi
16930 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 ze(pBt->pPager,
16940 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 &pBt->pageSize,
16950 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 70 42 74 nReserve);. pBt
16960 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 ->usableSize = p
16970 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 28 Bt->pageSize - (
16980 75 31 36 29 6e 52 65 73 65 72 76 65 3b 0a 20 20 u16)nReserve;.
16990 69 66 28 20 69 46 69 78 20 29 20 70 42 74 2d 3e if( iFix ) pBt->
169a0 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
169b0 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a PAGESIZE_FIXED;.
169c0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
169d0 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
169e0 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 rc;.}../*.** Re
169f0 74 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 turn the current
16a00 6c 79 20 64 65 66 69 6e 65 64 20 70 61 67 65 20 ly defined page
16a10 73 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 size.*/.int sqli
16a20 74 65 33 42 74 72 65 65 47 65 74 50 61 67 65 53 te3BtreeGetPageS
16a30 69 7a 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 ize(Btree *p){.
16a40 20 72 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e return p->pBt->
16a50 70 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a 2f 2a 0a pageSize;.}../*.
16a60 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
16a70 20 69 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 73 is similar to s
16a80 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 52 65 qlite3BtreeGetRe
16a90 73 65 72 76 65 28 29 2c 20 65 78 63 65 70 74 20 serve(), except
16aa0 74 68 61 74 20 69 74 0a 2a 2a 20 6d 61 79 20 6f that it.** may o
16ab0 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 69 66 nly be called if
16ac0 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 it is guarantee
16ad0 64 20 74 68 61 74 20 74 68 65 20 62 2d 74 72 65 d that the b-tre
16ae0 65 20 6d 75 74 65 78 20 69 73 20 61 6c 72 65 61 e mutex is alrea
16af0 64 79 0a 2a 2a 20 68 65 6c 64 2e 0a 2a 2a 0a 2a dy.** held..**.*
16b00 2a 20 54 68 69 73 20 69 73 20 75 73 65 66 75 6c * This is useful
16b10 20 69 6e 20 6f 6e 65 20 73 70 65 63 69 61 6c 20 in one special
16b20 63 61 73 65 20 69 6e 20 74 68 65 20 62 61 63 6b case in the back
16b30 75 70 20 41 50 49 20 63 6f 64 65 20 77 68 65 72 up API code wher
16b40 65 20 69 74 20 69 73 0a 2a 2a 20 6b 6e 6f 77 6e e it is.** known
16b50 20 74 68 61 74 20 74 68 65 20 73 68 61 72 65 64 that the shared
16b60 20 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 73 b-tree mutex is
16b70 20 68 65 6c 64 2c 20 62 75 74 20 74 68 65 20 6d held, but the m
16b80 75 74 65 78 20 6f 6e 20 74 68 65 20 0a 2a 2a 20 utex on the .**
16b90 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 database handle
16ba0 74 68 61 74 20 6f 77 6e 73 20 2a 70 20 69 73 20 that owns *p is
16bb0 6e 6f 74 2e 20 49 6e 20 74 68 69 73 20 63 61 73 not. In this cas
16bc0 65 20 69 66 20 73 71 6c 69 74 65 33 42 74 72 65 e if sqlite3Btre
16bd0 65 45 6e 74 65 72 28 29 0a 2a 2a 20 77 65 72 65 eEnter().** were
16be0 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 2c 20 69 to be called, i
16bf0 74 20 6d 69 67 68 74 20 63 6f 6c 6c 69 64 65 20 t might collide
16c00 77 69 74 68 20 73 6f 6d 65 20 6f 74 68 65 72 20 with some other
16c10 6f 70 65 72 61 74 69 6f 6e 20 6f 6e 20 74 68 65 operation on the
16c20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e .** database han
16c30 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a 70 dle that owns *p
16c40 2c 20 63 61 75 73 69 6e 67 20 75 6e 64 65 66 69 , causing undefi
16c50 6e 65 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2f ned behavior..*/
16c60 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
16c70 65 47 65 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 eGetReserveNoMut
16c80 65 78 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ex(Btree *p){.
16c90 69 6e 74 20 6e 3b 0a 20 20 61 73 73 65 72 74 28 int n;. assert(
16ca0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
16cb0 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 eld(p->pBt->mute
16cc0 78 29 20 29 3b 0a 20 20 6e 20 3d 20 70 2d 3e 70 x) );. n = p->p
16cd0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 Bt->pageSize - p
16ce0 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
16cf0 65 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d e;. return n;.}
16d00 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
16d10 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
16d20 65 73 20 6f 66 20 73 70 61 63 65 20 61 74 20 74 es of space at t
16d30 68 65 20 65 6e 64 20 6f 66 20 65 76 65 72 79 20 he end of every
16d40 70 61 67 65 20 74 68 61 74 0a 2a 2a 20 61 72 65 page that.** are
16d50 20 69 6e 74 65 6e 74 75 61 6c 6c 79 20 6c 65 66 intentually lef
16d60 74 20 75 6e 75 73 65 64 2e 20 20 54 68 69 73 20 t unused. This
16d70 69 73 20 74 68 65 20 22 72 65 73 65 72 76 65 64 is the "reserved
16d80 22 20 73 70 61 63 65 20 74 68 61 74 20 69 73 0a " space that is.
16d90 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 75 73 65 ** sometimes use
16da0 64 20 62 79 20 65 78 74 65 6e 73 69 6f 6e 73 2e d by extensions.
16db0 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 .**.** If SQLITE
16dc0 5f 48 41 53 5f 4d 55 54 45 58 20 69 73 20 64 65 _HAS_MUTEX is de
16dd0 66 69 6e 65 64 20 74 68 65 6e 20 74 68 65 20 6e fined then the n
16de0 75 6d 62 65 72 20 72 65 74 75 72 6e 65 64 20 69 umber returned i
16df0 73 20 74 68 65 0a 2a 2a 20 67 72 65 61 74 65 72 s the.** greater
16e00 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 of the current
16e10 72 65 73 65 72 76 65 64 20 73 70 61 63 65 20 61 reserved space a
16e20 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 72 nd the maximum r
16e30 65 71 75 65 73 74 65 64 0a 2a 2a 20 72 65 73 65 equested.** rese
16e40 72 76 65 20 73 70 61 63 65 2e 0a 2a 2f 0a 69 6e rve space..*/.in
16e50 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 t sqlite3BtreeGe
16e60 74 4f 70 74 69 6d 61 6c 52 65 73 65 72 76 65 28 tOptimalReserve(
16e70 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 Btree *p){. int
16e80 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 n;. sqlite3Btr
16e90 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 6e 20 eeEnter(p);. n
16ea0 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 = sqlite3BtreeGe
16eb0 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 65 78 28 tReserveNoMutex(
16ec0 70 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 p);.#ifdef SQLIT
16ed0 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 69 66 E_HAS_CODEC. if
16ee0 28 20 6e 3c 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 ( n<p->pBt->opti
16ef0 6d 61 6c 52 65 73 65 72 76 65 20 29 20 6e 20 3d malReserve ) n =
16f00 20 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 6d 61 6c p->pBt->optimal
16f10 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 69 66 0a Reserve;.#endif.
16f20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 sqlite3BtreeLe
16f30 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e ave(p);. return
16f40 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 53 65 n;.}.../*.** Se
16f50 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 t the maximum pa
16f60 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 20 64 ge count for a d
16f70 61 74 61 62 61 73 65 20 69 66 20 6d 78 50 61 67 atabase if mxPag
16f80 65 20 69 73 20 70 6f 73 69 74 69 76 65 2e 0a 2a e is positive..*
16f90 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 61 72 65 * No changes are
16fa0 20 6d 61 64 65 20 69 66 20 6d 78 50 61 67 65 20 made if mxPage
16fb0 69 73 20 30 20 6f 72 20 6e 65 67 61 74 69 76 65 is 0 or negative
16fc0 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 20 ..** Regardless
16fd0 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 of the value of
16fe0 6d 78 50 61 67 65 2c 20 72 65 74 75 72 6e 20 74 mxPage, return t
16ff0 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 he maximum page
17000 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 count..*/.int sq
17010 6c 69 74 65 33 42 74 72 65 65 4d 61 78 50 61 67 lite3BtreeMaxPag
17020 65 43 6f 75 6e 74 28 42 74 72 65 65 20 2a 70 2c eCount(Btree *p,
17030 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 int mxPage){.
17040 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 int n;. sqlite3
17050 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
17060 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 n = sqlite3Page
17070 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 70 2d rMaxPageCount(p-
17080 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d 78 >pBt->pPager, mx
17090 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 33 Page);. sqlite3
170a0 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
170b0 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a return n;.}../*
170c0 0a 2a 2a 20 53 65 74 20 74 68 65 20 42 54 53 5f .** Set the BTS_
170d0 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 66 6c SECURE_DELETE fl
170e0 61 67 20 69 66 20 6e 65 77 46 6c 61 67 20 69 73 ag if newFlag is
170f0 20 30 20 6f 72 20 31 2e 20 20 49 66 20 6e 65 77 0 or 1. If new
17100 46 6c 61 67 20 69 73 20 2d 31 2c 0a 2a 2a 20 74 Flag is -1,.** t
17110 68 65 6e 20 6d 61 6b 65 20 6e 6f 20 63 68 61 6e hen make no chan
17120 67 65 73 2e 20 20 41 6c 77 61 79 73 20 72 65 74 ges. Always ret
17130 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 urn the value of
17140 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 45 5f the BTS_SECURE_
17150 44 45 4c 45 54 45 0a 2a 2a 20 73 65 74 74 69 6e DELETE.** settin
17160 67 20 61 66 74 65 72 20 74 68 65 20 63 68 61 6e g after the chan
17170 67 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ge..*/.int sqlit
17180 65 33 42 74 72 65 65 53 65 63 75 72 65 44 65 6c e3BtreeSecureDel
17190 65 74 65 28 42 74 72 65 65 20 2a 70 2c 20 69 6e ete(Btree *p, in
171a0 74 20 6e 65 77 46 6c 61 67 29 7b 0a 20 20 69 6e t newFlag){. in
171b0 74 20 62 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 t b;. if( p==0
171c0 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 ) return 0;. sq
171d0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
171e0 70 29 3b 0a 20 20 69 66 28 20 6e 65 77 46 6c 61 p);. if( newFla
171f0 67 3e 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e 70 g>=0 ){. p->p
17200 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 Bt->btsFlags &=
17210 7e 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 ~BTS_SECURE_DELE
17220 54 45 3b 0a 20 20 20 20 69 66 28 20 6e 65 77 46 TE;. if( newF
17230 6c 61 67 20 29 20 70 2d 3e 70 42 74 2d 3e 62 74 lag ) p->pBt->bt
17240 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 53 45 sFlags |= BTS_SE
17250 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 7d CURE_DELETE;. }
17260 20 0a 20 20 62 20 3d 20 28 70 2d 3e 70 42 74 2d . b = (p->pBt-
17270 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
17280 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 21 3d SECURE_DELETE)!=
17290 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 0;. sqlite3Btre
172a0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
172b0 75 72 6e 20 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn b;.}../*.**
172c0 43 68 61 6e 67 65 20 74 68 65 20 27 61 75 74 6f Change the 'auto
172d0 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 -vacuum' propert
172e0 79 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 y of the databas
172f0 65 2e 20 49 66 20 74 68 65 20 27 61 75 74 6f 56 e. If the 'autoV
17300 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 6d 65 acuum'.** parame
17310 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c ter is non-zero,
17320 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 75 75 then auto-vacuu
17330 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 6c 65 m mode is enable
17340 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 0a 2a d. If zero, it.*
17350 2a 20 69 73 20 64 69 73 61 62 6c 65 64 2e 20 54 * is disabled. T
17360 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 he default value
17370 20 66 6f 72 20 74 68 65 20 61 75 74 6f 2d 76 61 for the auto-va
17380 63 75 75 6d 20 70 72 6f 70 65 72 74 79 20 69 73 cuum property is
17390 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 .** determined
173a0 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 44 45 by the SQLITE_DE
173b0 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d FAULT_AUTOVACUUM
173c0 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 73 macro..*/.int s
173d0 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 41 75 qlite3BtreeSetAu
173e0 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 20 2a toVacuum(Btree *
173f0 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 75 75 p, int autoVacuu
17400 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 m){.#ifdef SQLIT
17410 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
17420 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 M. return SQLIT
17430 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 6c 73 E_READONLY;.#els
17440 65 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 e. BtShared *pB
17450 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 6e t = p->pBt;. in
17460 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
17470 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 75 38 29 ;. u8 av = (u8)
17480 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 20 73 autoVacuum;.. s
17490 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
174a0 28 70 29 3b 0a 20 20 69 66 28 20 28 70 42 74 2d (p);. if( (pBt-
174b0 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
174c0 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 29 21 PAGESIZE_FIXED)!
174d0 3d 30 20 26 26 20 28 61 76 20 3f 31 3a 30 29 21 =0 && (av ?1:0)!
174e0 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d =pBt->autoVacuum
174f0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ){. rc = SQL
17500 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 ITE_READONLY;.
17510 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 2d 3e }else{. pBt->
17520 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 76 20 autoVacuum = av
17530 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d 3e 69 ?1:0;. pBt->i
17540 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 76 3d 3d ncrVacuum = av==
17550 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 73 71 2 ?1:0;. }. sq
17560 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
17570 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
17580 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
17590 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c 75 Return the valu
175a0 65 20 6f 66 20 74 68 65 20 27 61 75 74 6f 2d 76 e of the 'auto-v
175b0 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 79 2e acuum' property.
175c0 20 49 66 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 If auto-vacuum
175d0 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 20 31 is .** enabled 1
175e0 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
175f0 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a 69 6e herwise 0..*/.in
17600 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 t sqlite3BtreeGe
17610 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 tAutoVacuum(Btre
17620 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 e *p){.#ifdef SQ
17630 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
17640 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 42 54 CUUM. return BT
17650 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 4e REE_AUTOVACUUM_N
17660 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 ONE;.#else. int
17670 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 rc;. sqlite3Bt
17680 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 reeEnter(p);. r
17690 63 20 3d 20 28 0a 20 20 20 20 28 21 70 2d 3e 70 c = (. (!p->p
176a0 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 3f Bt->autoVacuum)?
176b0 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d BTREE_AUTOVACUUM
176c0 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 2d 3e _NONE:. (!p->
176d0 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 pBt->incrVacuum)
176e0 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 ?BTREE_AUTOVACUU
176f0 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 52 45 M_FULL:. BTRE
17700 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 4e 43 E_AUTOVACUUM_INC
17710 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 R. );. sqlite3
17720 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
17730 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e 64 return rc;.#end
17740 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 if.}.../*.** Get
17750 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
17760 70 50 61 67 65 31 20 6f 66 20 74 68 65 20 64 61 pPage1 of the da
17770 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68 tabase file. Th
17780 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 is will.** also
17790 61 63 71 75 69 72 65 20 61 20 72 65 61 64 6c 6f acquire a readlo
177a0 63 6b 20 6f 6e 20 74 68 61 74 20 66 69 6c 65 2e ck on that file.
177b0 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
177c0 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 is returned on
177d0 73 75 63 63 65 73 73 2e 20 20 49 66 20 74 68 65 success. If the
177e0 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 0a 2a file is not a.*
177f0 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 * well-formed da
17800 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 tabase file, the
17810 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
17820 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a is returned..**
17830 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 73 20 SQLITE_BUSY is
17840 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 returned if the
17850 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63 6b database is lock
17860 65 64 2e 20 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 ed. SQLITE_NOME
17870 4d 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 M.** is returned
17880 20 69 66 20 77 65 20 72 75 6e 20 6f 75 74 20 6f if we run out o
17890 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a 2f 0a 73 74 f memory. .*/.st
178a0 61 74 69 63 20 69 6e 74 20 6c 6f 63 6b 42 74 72 atic int lockBtr
178b0 65 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 ee(BtShared *pBt
178c0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
178d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 /* Res
178e0 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 73 75 ult code from su
178f0 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 bfunctions */.
17900 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 3b MemPage *pPage1;
17910 20 20 20 20 20 2f 2a 20 50 61 67 65 20 31 20 6f /* Page 1 o
17920 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
17930 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 ile */. int nPa
17940 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ge; /*
17950 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
17960 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
17970 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 46 */. int nPageF
17980 69 6c 65 20 3d 20 30 3b 20 20 20 2f 2a 20 4e 75 ile = 0; /* Nu
17990 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
179a0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
179b0 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 le */. int nPag
179c0 65 48 65 61 64 65 72 3b 20 20 20 20 20 2f 2a 20 eHeader; /*
179d0 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
179e0 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
179f0 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 68 64 72 according to hdr
17a00 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
17a10 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
17a20 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
17a30 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
17a40 70 50 61 67 65 31 3d 3d 30 20 29 3b 0a 20 20 72 pPage1==0 );. r
17a50 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
17a60 53 68 61 72 65 64 4c 6f 63 6b 28 70 42 74 2d 3e SharedLock(pBt->
17a70 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 72 pPager);. if( r
17a80 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 c!=SQLITE_OK ) r
17a90 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 20 3d eturn rc;. rc =
17aa0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
17ab0 74 2c 20 31 2c 20 26 70 50 61 67 65 31 2c 20 30 t, 1, &pPage1, 0
17ac0 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
17ad0 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
17ae0 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 73 6f 6d rc;.. /* Do som
17af0 65 20 63 68 65 63 6b 69 6e 67 20 74 6f 20 68 65 e checking to he
17b00 6c 70 20 69 6e 73 75 72 65 20 74 68 65 20 66 69 lp insure the fi
17b10 6c 65 20 77 65 20 6f 70 65 6e 65 64 20 72 65 61 le we opened rea
17b20 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 61 20 76 61 lly is. ** a va
17b30 6c 69 64 20 64 61 74 61 62 61 73 65 20 66 69 6c lid database fil
17b40 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 61 67 65 e. . */. nPage
17b50 20 3d 20 6e 50 61 67 65 48 65 61 64 65 72 20 3d = nPageHeader =
17b60 20 67 65 74 34 62 79 74 65 28 32 38 2b 28 75 38 get4byte(28+(u8
17b70 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 *)pPage1->aData)
17b80 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
17b90 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d 3e 70 Pagecount(pBt->p
17ba0 50 61 67 65 72 2c 20 26 6e 50 61 67 65 46 69 6c Pager, &nPageFil
17bb0 65 29 3b 0a 20 20 69 66 28 20 6e 50 61 67 65 3d e);. if( nPage=
17bc0 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 32 34 2b =0 || memcmp(24+
17bd0 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 (u8*)pPage1->aDa
17be0 74 61 2c 20 39 32 2b 28 75 38 2a 29 70 50 61 67 ta, 92+(u8*)pPag
17bf0 65 31 2d 3e 61 44 61 74 61 2c 34 29 21 3d 30 20 e1->aData,4)!=0
17c00 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 6e ){. nPage = n
17c10 50 61 67 65 46 69 6c 65 3b 0a 20 20 7d 0a 20 20 PageFile;. }.
17c20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b 0a 20 if( nPage>0 ){.
17c30 20 20 20 75 33 32 20 70 61 67 65 53 69 7a 65 3b u32 pageSize;
17c40 0a 20 20 20 20 75 33 32 20 75 73 61 62 6c 65 53 . u32 usableS
17c50 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 61 67 ize;. u8 *pag
17c60 65 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 44 61 e1 = pPage1->aDa
17c70 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c ta;. rc = SQL
17c80 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 20 ITE_NOTADB;.
17c90 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
17ca0 52 2d 34 33 37 33 37 2d 33 39 39 39 39 20 45 76 R-43737-39999 Ev
17cb0 65 72 79 20 76 61 6c 69 64 20 53 51 4c 69 74 65 ery valid SQLite
17cc0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 database file b
17cd0 65 67 69 6e 73 0a 20 20 20 20 2a 2a 20 77 69 74 egins. ** wit
17ce0 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 h the following
17cf0 31 36 20 62 79 74 65 73 20 28 69 6e 20 68 65 78 16 bytes (in hex
17d00 29 3a 20 35 33 20 35 31 20 34 63 20 36 39 20 37 ): 53 51 4c 69 7
17d10 34 20 36 35 20 32 30 20 36 36 20 36 66 20 37 32 4 65 20 66 6f 72
17d20 20 36 64 0a 20 20 20 20 2a 2a 20 36 31 20 37 34 6d. ** 61 74
17d30 20 32 30 20 33 33 20 30 30 2e 20 2a 2f 0a 20 20 20 33 00. */.
17d40 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 70 61 67 if( memcmp(pag
17d50 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 e1, zMagicHeader
17d60 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 20 20 20 , 16)!=0 ){.
17d70 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
17d80 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
17d90 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
17da0 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 66 28 20 MIT_WAL. if(
17db0 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 7b 0a 20 page1[18]>1 ){.
17dc0 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
17dd0 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f gs |= BTS_READ_O
17de0 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 NLY;. }. i
17df0 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 31 20 29 f( page1[19]>1 )
17e00 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
17e10 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
17e20 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 }.#else.
17e30 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 32 20 if( page1[18]>2
17e40 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ){. pBt->bt
17e50 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 sFlags |= BTS_RE
17e60 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 AD_ONLY;. }.
17e70 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
17e80 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f >2 ){. goto
17e90 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
17ea0 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ed;. }.. /
17eb0 2a 20 49 66 20 74 68 65 20 77 72 69 74 65 20 76 * If the write v
17ec0 65 72 73 69 6f 6e 20 69 73 20 73 65 74 20 74 6f ersion is set to
17ed0 20 32 2c 20 74 68 69 73 20 64 61 74 61 62 61 73 2, this databas
17ee0 65 20 73 68 6f 75 6c 64 20 62 65 20 61 63 63 65 e should be acce
17ef0 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 6e 20 57 ssed. ** in W
17f00 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 AL mode. If the
17f10 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 log is not alrea
17f20 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 74 dy open, open it
17f30 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 20 20 20 now. Then .
17f40 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ** return SQLITE
17f50 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 6e 20 77 _OK and return w
17f60 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 74 69 6e ithout populatin
17f70 67 20 42 74 53 68 61 72 65 64 2e 70 50 61 67 65 g BtShared.pPage
17f80 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 63 61 1.. ** The ca
17f90 6c 6c 65 72 20 64 65 74 65 63 74 73 20 74 68 69 ller detects thi
17fa0 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 68 69 73 s and calls this
17fb0 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 2e function again.
17fc0 20 54 68 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 This is. **
17fd0 72 65 71 75 69 72 65 64 20 61 73 20 74 68 65 20 required as the
17fe0 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 65 20 version of page
17ff0 31 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 1 currently in t
18000 68 65 20 70 61 67 65 31 20 62 75 66 66 65 72 0a he page1 buffer.
18010 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 62 ** may not b
18020 65 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 e the latest ver
18030 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 6d 61 79 sion - there may
18040 20 62 65 20 61 20 6e 65 77 65 72 20 6f 6e 65 20 be a newer one
18050 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 20 20 2a in the log. *
18060 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 * file.. */.
18070 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
18080 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 62 74 73 ==2 && (pBt->bts
18090 46 6c 61 67 73 20 26 20 42 54 53 5f 4e 4f 5f 57 Flags & BTS_NO_W
180a0 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 AL)==0 ){.
180b0 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 30 3b 0a int isOpen = 0;.
180c0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
180d0 65 33 50 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 e3PagerOpenWal(p
180e0 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 69 73 4f Bt->pPager, &isO
180f0 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pen);. if(
18100 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
18110 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 . goto pa
18120 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
18130 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 23 69 . }else{.#i
18140 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 f SQLITE_DEFAULT
18150 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 21 3d 53 51 _SYNCHRONOUS!=SQ
18160 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c LITE_DEFAULT_WAL
18170 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 20 20 20 _SYNCHRONOUS.
18180 20 20 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 sqlite3 *db
18190 3b 0a 20 20 20 20 20 20 20 20 44 62 20 2a 70 44 ;. Db *pD
181a0 62 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 b;. if( (
181b0 64 62 3d 70 42 74 2d 3e 64 62 29 21 3d 30 20 26 db=pBt->db)!=0 &
181c0 26 20 28 70 44 62 3d 64 62 2d 3e 61 44 62 29 21 & (pDb=db->aDb)!
181d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
181e0 77 68 69 6c 65 28 20 70 44 62 2d 3e 70 42 74 3d while( pDb->pBt=
181f0 3d 30 20 7c 7c 20 70 44 62 2d 3e 70 42 74 2d 3e =0 || pDb->pBt->
18200 70 42 74 21 3d 70 42 74 20 29 7b 20 70 44 62 2b pBt!=pBt ){ pDb+
18210 2b 3b 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 +; }. i
18220 66 28 20 70 44 62 2d 3e 62 53 79 6e 63 53 65 74 f( pDb->bSyncSet
18230 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 26 ==0. &
18240 26 20 70 44 62 2d 3e 73 61 66 65 74 79 5f 6c 65 & pDb->safety_le
18250 76 65 6c 3d 3d 53 51 4c 49 54 45 5f 44 45 46 41 vel==SQLITE_DEFA
18260 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 2b ULT_SYNCHRONOUS+
18270 31 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a 20 1. ){.
18280 20 20 20 20 20 20 20 20 20 20 20 70 44 62 2d 3e pDb->
18290 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 53 safety_level = S
182a0 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 QLITE_DEFAULT_WA
182b0 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 2b 31 3b L_SYNCHRONOUS+1;
182c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
182d0 69 74 65 33 50 61 67 65 72 53 65 74 46 6c 61 67 ite3PagerSetFlag
182e0 73 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 0a 20 s(pBt->pPager,.
182f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 44 pD
18300 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 b->safety_level
18310 7c 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 50 | (db->flags & P
18320 41 47 45 52 5f 46 4c 41 47 53 5f 4d 41 53 4b 29 AGER_FLAGS_MASK)
18330 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
18340 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a }.#endif.
18350 20 20 20 20 20 20 20 20 69 66 28 20 69 73 4f 70 if( isOp
18360 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 en==0 ){.
18370 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
18380 50 61 67 65 31 29 3b 0a 20 20 20 20 20 20 20 20 Page1);.
18390 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
183a0 4f 4b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 OK;. }.
183b0 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 20 3d }. rc =
183c0 20 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a SQLITE_NOTADB;.
183d0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }.#endif..
183e0 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
183f0 3a 20 52 2d 31 35 34 36 35 2d 32 30 38 31 33 20 : R-15465-20813
18400 54 68 65 20 6d 61 78 69 6d 75 6d 20 61 6e 64 20 The maximum and
18410 6d 69 6e 69 6d 75 6d 20 65 6d 62 65 64 64 65 64 minimum embedded
18420 20 70 61 79 6c 6f 61 64 0a 20 20 20 20 2a 2a 20 payload. **
18430 66 72 61 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 fractions and th
18440 65 20 6c 65 61 66 20 70 61 79 6c 6f 61 64 20 66 e leaf payload f
18450 72 61 63 74 69 6f 6e 20 76 61 6c 75 65 73 20 6d raction values m
18460 75 73 74 20 62 65 20 36 34 2c 20 33 32 2c 20 61 ust be 64, 32, a
18470 6e 64 20 33 32 2e 0a 20 20 20 20 2a 2a 0a 20 20 nd 32.. **.
18480 20 20 2a 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 ** The origina
18490 6c 20 64 65 73 69 67 6e 20 61 6c 6c 6f 77 65 64 l design allowed
184a0 20 74 68 65 73 65 20 61 6d 6f 75 6e 74 73 20 74 these amounts t
184b0 6f 20 76 61 72 79 2c 20 62 75 74 20 61 73 20 6f o vary, but as o
184c0 66 0a 20 20 20 20 2a 2a 20 76 65 72 73 69 6f 6e f. ** version
184d0 20 33 2e 36 2e 30 2c 20 77 65 20 72 65 71 75 69 3.6.0, we requi
184e0 72 65 20 74 68 65 6d 20 74 6f 20 62 65 20 66 69 re them to be fi
184f0 78 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 xed.. */.
18500 69 66 28 20 6d 65 6d 63 6d 70 28 26 70 61 67 65 if( memcmp(&page
18510 31 5b 32 31 5d 2c 20 22 5c 31 30 30 5c 30 34 30 1[21], "\100\040
18520 5c 30 34 30 22 2c 33 29 21 3d 30 20 29 7b 0a 20 \040",3)!=0 ){.
18530 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f goto page1_
18540 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 init_failed;.
18550 20 7d 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e }. /* EVIDEN
18560 43 45 2d 4f 46 3a 20 52 2d 35 31 38 37 33 2d 33 CE-OF: R-51873-3
18570 39 36 31 38 20 54 68 65 20 70 61 67 65 20 73 69 9618 The page si
18580 7a 65 20 66 6f 72 20 61 20 64 61 74 61 62 61 73 ze for a databas
18590 65 20 66 69 6c 65 20 69 73 0a 20 20 20 20 2a 2a e file is. **
185a0 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 determined by t
185b0 68 65 20 32 2d 62 79 74 65 20 69 6e 74 65 67 65 he 2-byte intege
185c0 72 20 6c 6f 63 61 74 65 64 20 61 74 20 61 6e 20 r located at an
185d0 6f 66 66 73 65 74 20 6f 66 20 31 36 20 62 79 74 offset of 16 byt
185e0 65 73 20 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 74 es from. ** t
185f0 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
18600 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
18610 65 2e 20 2a 2f 0a 20 20 20 20 70 61 67 65 53 69 e. */. pageSi
18620 7a 65 20 3d 20 28 70 61 67 65 31 5b 31 36 5d 3c ze = (page1[16]<
18630 3c 38 29 20 7c 20 28 70 61 67 65 31 5b 31 37 5d <8) | (page1[17]
18640 3c 3c 31 36 29 3b 0a 20 20 20 20 2f 2a 20 45 56 <<16);. /* EV
18650 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 30 IDENCE-OF: R-250
18660 30 38 2d 32 31 36 38 38 20 54 68 65 20 73 69 7a 08-21688 The siz
18670 65 20 6f 66 20 61 20 70 61 67 65 20 69 73 20 61 e of a page is a
18680 20 70 6f 77 65 72 20 6f 66 20 74 77 6f 0a 20 20 power of two.
18690 20 20 2a 2a 20 62 65 74 77 65 65 6e 20 35 31 32 ** between 512
186a0 20 61 6e 64 20 36 35 35 33 36 20 69 6e 63 6c 75 and 65536 inclu
186b0 73 69 76 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 sive. */. if(
186c0 20 28 28 70 61 67 65 53 69 7a 65 2d 31 29 26 70 ((pageSize-1)&p
186d0 61 67 65 53 69 7a 65 29 21 3d 30 0a 20 20 20 20 ageSize)!=0.
186e0 20 7c 7c 20 70 61 67 65 53 69 7a 65 3e 53 51 4c || pageSize>SQL
186f0 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a ITE_MAX_PAGE_SIZ
18700 45 20 0a 20 20 20 20 20 7c 7c 20 70 61 67 65 53 E . || pageS
18710 69 7a 65 3c 3d 32 35 36 20 0a 20 20 20 20 29 7b ize<=256 . ){
18720 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
18730 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 1_init_failed;.
18740 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 }. assert(
18750 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d (pageSize & 7)=
18760 3d 30 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 =0 );. /* EVI
18770 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 39 33 31 DENCE-OF: R-5931
18780 30 2d 35 31 32 30 35 20 54 68 65 20 22 72 65 73 0-51205 The "res
18790 65 72 76 65 64 20 73 70 61 63 65 22 20 73 69 7a erved space" siz
187a0 65 20 69 6e 20 74 68 65 20 31 2d 62 79 74 65 0a e in the 1-byte.
187b0 20 20 20 20 2a 2a 20 69 6e 74 65 67 65 72 20 61 ** integer a
187c0 74 20 6f 66 66 73 65 74 20 32 30 20 69 73 20 74 t offset 20 is t
187d0 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
187e0 65 73 20 6f 66 20 73 70 61 63 65 20 61 74 20 74 es of space at t
187f0 68 65 20 65 6e 64 20 6f 66 0a 20 20 20 20 2a 2a he end of. **
18800 20 65 61 63 68 20 70 61 67 65 20 74 6f 20 72 65 each page to re
18810 73 65 72 76 65 20 66 6f 72 20 65 78 74 65 6e 73 serve for extens
18820 69 6f 6e 73 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 ions. . **.
18830 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 ** EVIDENCE-OF
18840 3a 20 52 2d 33 37 34 39 37 2d 34 32 34 31 32 20 : R-37497-42412
18850 54 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 The size of the
18860 72 65 73 65 72 76 65 64 20 72 65 67 69 6f 6e 20 reserved region
18870 69 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 6d is. ** determ
18880 69 6e 65 64 20 62 79 20 74 68 65 20 6f 6e 65 2d ined by the one-
18890 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 69 6e byte unsigned in
188a0 74 65 67 65 72 20 66 6f 75 6e 64 20 61 74 20 61 teger found at a
188b0 6e 20 6f 66 66 73 65 74 20 6f 66 20 32 30 0a 20 n offset of 20.
188c0 20 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 20 64 ** into the d
188d0 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 65 61 atabase file hea
188e0 64 65 72 2e 20 2a 2f 0a 20 20 20 20 75 73 61 62 der. */. usab
188f0 6c 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a leSize = pageSiz
18900 65 20 2d 20 70 61 67 65 31 5b 32 30 5d 3b 0a 20 e - page1[20];.
18910 20 20 20 69 66 28 20 28 75 33 32 29 70 61 67 65 if( (u32)page
18920 53 69 7a 65 21 3d 70 42 74 2d 3e 70 61 67 65 53 Size!=pBt->pageS
18930 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 ize ){. /*
18940 41 66 74 65 72 20 72 65 61 64 69 6e 67 20 74 68 After reading th
18950 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 e first page of
18960 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73 73 the database ass
18970 75 6d 69 6e 67 20 61 20 70 61 67 65 20 73 69 7a uming a page siz
18980 65 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 42 74 e. ** of Bt
18990 53 68 61 72 65 64 2e 70 61 67 65 53 69 7a 65 2c Shared.pageSize,
189a0 20 77 65 20 68 61 76 65 20 64 69 73 63 6f 76 65 we have discove
189b0 72 65 64 20 74 68 61 74 20 74 68 65 20 70 61 67 red that the pag
189c0 65 2d 73 69 7a 65 20 69 73 0a 20 20 20 20 20 20 e-size is.
189d0 2a 2a 20 61 63 74 75 61 6c 6c 79 20 70 61 67 65 ** actually page
189e0 53 69 7a 65 2e 20 55 6e 6c 6f 63 6b 20 74 68 65 Size. Unlock the
189f0 20 64 61 74 61 62 61 73 65 2c 20 6c 65 61 76 65 database, leave
18a00 20 70 42 74 2d 3e 70 50 61 67 65 31 20 61 74 0a pBt->pPage1 at.
18a10 20 20 20 20 20 20 2a 2a 20 7a 65 72 6f 20 61 6e ** zero an
18a20 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f d return SQLITE_
18a30 4f 4b 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 OK. The caller w
18a40 69 6c 6c 20 63 61 6c 6c 20 74 68 69 73 20 66 75 ill call this fu
18a50 6e 63 74 69 6f 6e 0a 20 20 20 20 20 20 2a 2a 20 nction. **
18a60 61 67 61 69 6e 20 77 69 74 68 20 74 68 65 20 63 again with the c
18a70 6f 72 72 65 63 74 20 70 61 67 65 2d 73 69 7a 65 orrect page-size
18a80 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
18a90 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 releasePage(pPa
18aa0 67 65 31 29 3b 0a 20 20 20 20 20 20 70 42 74 2d ge1);. pBt-
18ab0 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 75 73 >usableSize = us
18ac0 61 62 6c 65 53 69 7a 65 3b 0a 20 20 20 20 20 20 ableSize;.
18ad0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 pBt->pageSize =
18ae0 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 20 20 pageSize;.
18af0 66 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 freeTempSpace(pB
18b00 74 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 t);. rc = s
18b10 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
18b20 67 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 gesize(pBt->pPag
18b30 65 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 er, &pBt->pageSi
18b40 7a 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ze,.
18b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18b60 20 20 20 20 20 20 20 70 61 67 65 53 69 7a 65 2d pageSize-
18b70 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 20 usableSize);.
18b80 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
18b90 20 20 7d 0a 20 20 20 20 69 66 28 20 28 70 42 74 }. if( (pBt
18ba0 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 ->db->flags & SQ
18bb0 4c 49 54 45 5f 52 65 63 6f 76 65 72 79 4d 6f 64 LITE_RecoveryMod
18bc0 65 29 3d 3d 30 20 26 26 20 6e 50 61 67 65 3e 6e e)==0 && nPage>n
18bd0 50 61 67 65 46 69 6c 65 20 29 7b 0a 20 20 20 20 PageFile ){.
18be0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f rc = SQLITE_CO
18bf0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
18c00 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
18c10 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
18c20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
18c30 4f 46 3a 20 52 2d 32 38 33 31 32 2d 36 34 37 30 OF: R-28312-6470
18c40 34 20 48 6f 77 65 76 65 72 2c 20 74 68 65 20 75 4 However, the u
18c50 73 61 62 6c 65 20 73 69 7a 65 20 69 73 20 6e 6f sable size is no
18c60 74 20 61 6c 6c 6f 77 65 64 20 74 6f 0a 20 20 20 t allowed to.
18c70 20 2a 2a 20 62 65 20 6c 65 73 73 20 74 68 61 6e ** be less than
18c80 20 34 38 30 2e 20 49 6e 20 6f 74 68 65 72 20 77 480. In other w
18c90 6f 72 64 73 2c 20 69 66 20 74 68 65 20 70 61 67 ords, if the pag
18ca0 65 20 73 69 7a 65 20 69 73 20 35 31 32 2c 20 74 e size is 512, t
18cb0 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 72 hen the. ** r
18cc0 65 73 65 72 76 65 64 20 73 70 61 63 65 20 73 69 eserved space si
18cd0 7a 65 20 63 61 6e 6e 6f 74 20 65 78 63 65 65 64 ze cannot exceed
18ce0 20 33 32 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 32. */. if(
18cf0 75 73 61 62 6c 65 53 69 7a 65 3c 34 38 30 20 29 usableSize<480 )
18d00 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
18d10 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
18d20 20 20 20 20 7d 0a 20 20 20 20 70 42 74 2d 3e 70 }. pBt->p
18d30 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 ageSize = pageSi
18d40 7a 65 3b 0a 20 20 20 20 70 42 74 2d 3e 75 73 61 ze;. pBt->usa
18d50 62 6c 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 bleSize = usable
18d60 53 69 7a 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 Size;.#ifndef SQ
18d70 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
18d80 43 55 55 4d 0a 20 20 20 20 70 42 74 2d 3e 61 75 CUUM. pBt->au
18d90 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 65 74 34 toVacuum = (get4
18da0 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 20 2b byte(&page1[36 +
18db0 20 34 2a 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 4*4])?1:0);.
18dc0 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
18dd0 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 70 61 = (get4byte(&pa
18de0 67 65 31 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 ge1[36 + 7*4])?1
18df0 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a :0);.#endif. }.
18e00 0a 20 20 2f 2a 20 6d 61 78 4c 6f 63 61 6c 20 69 . /* maxLocal i
18e10 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 6d s the maximum am
18e20 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 ount of payload
18e30 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 6c 6c 79 to store locally
18e40 20 66 6f 72 0a 20 20 2a 2a 20 61 20 63 65 6c 6c for. ** a cell
18e50 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 69 74 20 . Make sure it
18e60 69 73 20 73 6d 61 6c 6c 20 65 6e 6f 75 67 68 20 is small enough
18e70 73 6f 20 74 68 61 74 20 61 74 20 6c 65 61 73 74 so that at least
18e80 20 6d 69 6e 46 61 6e 6f 75 74 0a 20 20 2a 2a 20 minFanout. **
18e90 63 65 6c 6c 73 20 63 61 6e 20 77 69 6c 6c 20 66 cells can will f
18ea0 69 74 20 6f 6e 20 6f 6e 65 20 70 61 67 65 2e 20 it on one page.
18eb0 20 57 65 20 61 73 73 75 6d 65 20 61 20 31 30 2d We assume a 10-
18ec0 62 79 74 65 20 70 61 67 65 20 68 65 61 64 65 72 byte page header
18ed0 2e 0a 20 20 2a 2a 20 42 65 73 69 64 65 73 20 74 .. ** Besides t
18ee0 68 65 20 70 61 79 6c 6f 61 64 2c 20 74 68 65 20 he payload, the
18ef0 63 65 6c 6c 20 6d 75 73 74 20 73 74 6f 72 65 3a cell must store:
18f00 0a 20 20 2a 2a 20 20 20 20 20 32 2d 62 79 74 65 . ** 2-byte
18f10 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
18f20 63 65 6c 6c 0a 20 20 2a 2a 20 20 20 20 20 34 2d cell. ** 4-
18f30 62 79 74 65 20 63 68 69 6c 64 20 70 6f 69 6e 74 byte child point
18f40 65 72 0a 20 20 2a 2a 20 20 20 20 20 39 2d 62 79 er. ** 9-by
18f50 74 65 20 6e 4b 65 79 20 76 61 6c 75 65 0a 20 20 te nKey value.
18f60 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 6e 44 ** 4-byte nD
18f70 61 74 61 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 ata value. **
18f80 20 20 20 34 2d 62 79 74 65 20 6f 76 65 72 66 6c 4-byte overfl
18f90 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 0a ow page pointer.
18fa0 20 20 2a 2a 20 53 6f 20 61 20 63 65 6c 6c 20 63 ** So a cell c
18fb0 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 32 2d 62 onsists of a 2-b
18fc0 79 74 65 20 70 6f 69 6e 74 65 72 2c 20 61 20 68 yte pointer, a h
18fd0 65 61 64 65 72 20 77 68 69 63 68 20 69 73 20 61 eader which is a
18fe0 73 20 6d 75 63 68 20 61 73 0a 20 20 2a 2a 20 31 s much as. ** 1
18ff0 37 20 62 79 74 65 73 20 6c 6f 6e 67 2c 20 30 20 7 bytes long, 0
19000 74 6f 20 4e 20 62 79 74 65 73 20 6f 66 20 70 61 to N bytes of pa
19010 79 6c 6f 61 64 2c 20 61 6e 64 20 61 6e 20 6f 70 yload, and an op
19020 74 69 6f 6e 61 6c 20 34 20 62 79 74 65 20 6f 76 tional 4 byte ov
19030 65 72 66 6c 6f 77 0a 20 20 2a 2a 20 70 61 67 65 erflow. ** page
19040 20 70 6f 69 6e 74 65 72 2e 0a 20 20 2a 2f 0a 20 pointer.. */.
19050 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d pBt->maxLocal =
19060 20 28 75 31 36 29 28 28 70 42 74 2d 3e 75 73 61 (u16)((pBt->usa
19070 62 6c 65 53 69 7a 65 2d 31 32 29 2a 36 34 2f 32 bleSize-12)*64/2
19080 35 35 20 2d 20 32 33 29 3b 0a 20 20 70 42 74 2d 55 - 23);. pBt-
19090 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 >minLocal = (u16
190a0 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 )((pBt->usableSi
190b0 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d 20 ze-12)*32/255 -
190c0 32 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 61 78 4c 23);. pBt->maxL
190d0 65 61 66 20 3d 20 28 75 31 36 29 28 70 42 74 2d eaf = (u16)(pBt-
190e0 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 33 35 >usableSize - 35
190f0 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 65 61 );. pBt->minLea
19100 66 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d 3e f = (u16)((pBt->
19110 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a 33 usableSize-12)*3
19120 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 69 2/255 - 23);. i
19130 66 28 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c f( pBt->maxLocal
19140 3e 31 32 37 20 29 7b 0a 20 20 20 20 70 42 74 2d >127 ){. pBt-
19150 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 >max1bytePayload
19160 20 3d 20 31 32 37 3b 0a 20 20 7d 65 6c 73 65 7b = 127;. }else{
19170 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 . pBt->max1by
19180 74 65 50 61 79 6c 6f 61 64 20 3d 20 28 75 38 29 tePayload = (u8)
19190 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 pBt->maxLocal;.
191a0 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 }. assert( pBt
191b0 2d 3e 6d 61 78 4c 65 61 66 20 2b 20 32 33 20 3c ->maxLeaf + 23 <
191c0 3d 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 = MX_CELL_SIZE(p
191d0 42 74 29 20 29 3b 0a 20 20 70 42 74 2d 3e 70 50 Bt) );. pBt->pP
191e0 61 67 65 31 20 3d 20 70 50 61 67 65 31 3b 0a 20 age1 = pPage1;.
191f0 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 pBt->nPage = nP
19200 61 67 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 age;. return SQ
19210 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 31 5f LITE_OK;..page1_
19220 69 6e 69 74 5f 66 61 69 6c 65 64 3a 0a 20 20 72 init_failed:. r
19230 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
19240 31 29 3b 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 1);. pBt->pPage
19250 31 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 1 = 0;. return
19260 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e rc;.}..#ifndef N
19270 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 DEBUG./*.** Retu
19280 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 rn the number of
19290 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 20 6f 6e cursors open on
192a0 20 70 42 74 2e 20 54 68 69 73 20 69 73 20 66 6f pBt. This is fo
192b0 72 20 75 73 65 0a 2a 2a 20 69 6e 20 61 73 73 65 r use.** in asse
192c0 72 74 28 29 20 65 78 70 72 65 73 73 69 6f 6e 73 rt() expressions
192d0 2c 20 73 6f 20 69 74 20 69 73 20 6f 6e 6c 79 20 , so it is only
192e0 63 6f 6d 70 69 6c 65 64 20 69 66 20 4e 44 45 42 compiled if NDEB
192f0 55 47 20 69 73 20 6e 6f 74 0a 2a 2a 20 64 65 66 UG is not.** def
19300 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 ined..**.** Only
19310 20 77 72 69 74 65 20 63 75 72 73 6f 72 73 20 61 write cursors a
19320 72 65 20 63 6f 75 6e 74 65 64 20 69 66 20 77 72 re counted if wr
19330 4f 6e 6c 79 20 69 73 20 74 72 75 65 2e 20 20 49 Only is true. I
19340 66 20 77 72 4f 6e 6c 79 20 69 73 0a 2a 2a 20 66 f wrOnly is.** f
19350 61 6c 73 65 20 74 68 65 6e 20 61 6c 6c 20 63 75 alse then all cu
19360 72 73 6f 72 73 20 61 72 65 20 63 6f 75 6e 74 65 rsors are counte
19370 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 d..**.** For the
19380 20 70 75 72 70 6f 73 65 73 20 6f 66 20 74 68 69 purposes of thi
19390 73 20 72 6f 75 74 69 6e 65 2c 20 61 20 63 75 72 s routine, a cur
193a0 73 6f 72 20 69 73 20 61 6e 79 20 63 75 72 73 6f sor is any curso
193b0 72 20 74 68 61 74 0a 2a 2a 20 69 73 20 63 61 70 r that.** is cap
193c0 61 62 6c 65 20 6f 66 20 72 65 61 64 69 6e 67 20 able of reading
193d0 6f 72 20 77 72 69 74 69 6e 67 20 74 6f 20 74 68 or writing to th
193e0 65 20 64 61 74 61 62 61 73 65 2e 20 20 43 75 72 e database. Cur
193f0 73 6f 72 73 20 74 68 61 74 0a 2a 2a 20 68 61 76 sors that.** hav
19400 65 20 62 65 65 6e 20 74 72 69 70 70 65 64 20 69 e been tripped i
19410 6e 74 6f 20 74 68 65 20 43 55 52 53 4f 52 5f 46 nto the CURSOR_F
19420 41 55 4c 54 20 73 74 61 74 65 20 61 72 65 20 6e AULT state are n
19430 6f 74 20 63 6f 75 6e 74 65 64 2e 0a 2a 2f 0a 73 ot counted..*/.s
19440 74 61 74 69 63 20 69 6e 74 20 63 6f 75 6e 74 56 tatic int countV
19450 61 6c 69 64 43 75 72 73 6f 72 73 28 42 74 53 68 alidCursors(BtSh
19460 61 72 65 64 20 2a 70 42 74 2c 20 69 6e 74 20 77 ared *pBt, int w
19470 72 4f 6e 6c 79 29 7b 0a 20 20 42 74 43 75 72 73 rOnly){. BtCurs
19480 6f 72 20 2a 70 43 75 72 3b 0a 20 20 69 6e 74 20 or *pCur;. int
19490 72 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 43 75 r = 0;. for(pCu
194a0 72 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 r=pBt->pCursor;
194b0 70 43 75 72 3b 20 70 43 75 72 3d 70 43 75 72 2d pCur; pCur=pCur-
194c0 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 >pNext){. if(
194d0 20 28 77 72 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 28 (wrOnly==0 || (
194e0 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
194f0 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 67 29 BTCF_WriteFlag)
19500 21 3d 30 29 0a 20 20 20 20 20 26 26 20 70 43 75 !=0). && pCu
19510 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
19520 52 5f 46 41 55 4c 54 20 29 20 72 2b 2b 3b 20 0a R_FAULT ) r++; .
19530 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b 0a }. return r;.
19540 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
19550 49 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 If there are no
19560 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 75 72 73 outstanding curs
19570 6f 72 73 20 61 6e 64 20 77 65 20 61 72 65 20 6e ors and we are n
19580 6f 74 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 ot in the middle
19590 0a 2a 2a 20 6f 66 20 61 20 74 72 61 6e 73 61 63 .** of a transac
195a0 74 69 6f 6e 20 62 75 74 20 74 68 65 72 65 20 69 tion but there i
195b0 73 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e s a read lock on
195c0 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 74 the database, t
195d0 68 65 6e 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 hen.** this rout
195e0 69 6e 65 20 75 6e 72 65 66 73 20 74 68 65 20 66 ine unrefs the f
195f0 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 irst page of the
19600 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
19610 68 69 63 68 20 0a 2a 2a 20 68 61 73 20 74 68 65 hich .** has the
19620 20 65 66 66 65 63 74 20 6f 66 20 72 65 6c 65 61 effect of relea
19630 73 69 6e 67 20 74 68 65 20 72 65 61 64 20 6c 6f sing the read lo
19640 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ck..**.** If the
19650 72 65 20 69 73 20 61 20 74 72 61 6e 73 61 63 74 re is a transact
19660 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2c ion in progress,
19670 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
19680 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 a no-op..*/.sta
19690 74 69 63 20 76 6f 69 64 20 75 6e 6c 6f 63 6b 42 tic void unlockB
196a0 74 72 65 65 49 66 55 6e 75 73 65 64 28 42 74 53 treeIfUnused(BtS
196b0 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 61 hared *pBt){. a
196c0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
196d0 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
196e0 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 utex) );. asser
196f0 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 t( countValidCur
19700 73 6f 72 73 28 70 42 74 2c 30 29 3d 3d 30 20 7c sors(pBt,0)==0 |
19710 7c 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 | pBt->inTransac
19720 74 69 6f 6e 3e 54 52 41 4e 53 5f 4e 4f 4e 45 20 tion>TRANS_NONE
19730 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 69 6e );. if( pBt->in
19740 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 Transaction==TRA
19750 4e 53 5f 4e 4f 4e 45 20 26 26 20 70 42 74 2d 3e NS_NONE && pBt->
19760 70 50 61 67 65 31 21 3d 30 20 29 7b 0a 20 20 20 pPage1!=0 ){.
19770 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 MemPage *pPage1
19780 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a = pBt->pPage1;.
19790 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
197a0 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 20 e1->aData );.
197b0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
197c0 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 70 42 PagerRefcount(pB
197d0 74 2d 3e 70 50 61 67 65 72 29 3d 3d 31 20 29 3b t->pPager)==1 );
197e0 0a 20 20 20 20 70 42 74 2d 3e 70 50 61 67 65 31 . pBt->pPage1
197f0 20 3d 20 30 3b 0a 20 20 20 20 72 65 6c 65 61 73 = 0;. releas
19800 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 50 61 ePageNotNull(pPa
19810 67 65 31 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a ge1);. }.}../*.
19820 2a 2a 20 49 66 20 70 42 74 20 70 6f 69 6e 74 73 ** If pBt points
19830 20 74 6f 20 61 6e 20 65 6d 70 74 79 20 66 69 6c to an empty fil
19840 65 20 74 68 65 6e 20 63 6f 6e 76 65 72 74 20 74 e then convert t
19850 68 61 74 20 65 6d 70 74 79 20 66 69 6c 65 0a 2a hat empty file.*
19860 2a 20 69 6e 74 6f 20 61 20 6e 65 77 20 65 6d 70 * into a new emp
19870 74 79 20 64 61 74 61 62 61 73 65 20 62 79 20 69 ty database by i
19880 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 nitializing the
19890 66 69 72 73 74 20 70 61 67 65 20 6f 66 0a 2a 2a first page of.**
198a0 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a the database..*
198b0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 65 77 /.static int new
198c0 44 61 74 61 62 61 73 65 28 42 74 53 68 61 72 65 Database(BtShare
198d0 64 20 2a 70 42 74 29 7b 0a 20 20 4d 65 6d 50 61 d *pBt){. MemPa
198e0 67 65 20 2a 70 50 31 3b 0a 20 20 75 6e 73 69 67 ge *pP1;. unsig
198f0 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 3b 0a ned char *data;.
19900 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 int rc;.. ass
19910 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
19920 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
19930 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 74 ex) );. if( pBt
19940 2d 3e 6e 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 ->nPage>0 ){.
19950 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
19960 4b 3b 0a 20 20 7d 0a 20 20 70 50 31 20 3d 20 70 K;. }. pP1 = p
19970 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 61 73 Bt->pPage1;. as
19980 73 65 72 74 28 20 70 50 31 21 3d 30 20 29 3b 0a sert( pP1!=0 );.
19990 20 20 64 61 74 61 20 3d 20 70 50 31 2d 3e 61 44 data = pP1->aD
199a0 61 74 61 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ata;. rc = sqli
199b0 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
199c0 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 1->pDbPage);. i
199d0 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
199e0 63 3b 0a 20 20 6d 65 6d 63 70 79 28 64 61 74 61 c;. memcpy(data
199f0 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 2c 20 , zMagicHeader,
19a00 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 61 sizeof(zMagicHea
19a10 64 65 72 29 29 3b 0a 20 20 61 73 73 65 72 74 28 der));. assert(
19a20 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 sizeof(zMagicHe
19a30 61 64 65 72 29 3d 3d 31 36 20 29 3b 0a 20 20 64 ader)==16 );. d
19a40 61 74 61 5b 31 36 5d 20 3d 20 28 75 38 29 28 28 ata[16] = (u8)((
19a50 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 38 pBt->pageSize>>8
19a60 29 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b )&0xff);. data[
19a70 31 37 5d 20 3d 20 28 75 38 29 28 28 70 42 74 2d 17] = (u8)((pBt-
19a80 3e 70 61 67 65 53 69 7a 65 3e 3e 31 36 29 26 30 >pageSize>>16)&0
19a90 78 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 38 5d xff);. data[18]
19aa0 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 31 39 5d = 1;. data[19]
19ab0 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20 = 1;. assert(
19ac0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3c pBt->usableSize<
19ad0 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 26 =pBt->pageSize &
19ae0 26 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a & pBt->usableSiz
19af0 65 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 61 67 65 e+255>=pBt->page
19b00 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 30 Size);. data[20
19b10 5d 20 3d 20 28 75 38 29 28 70 42 74 2d 3e 70 61 ] = (u8)(pBt->pa
19b20 67 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 geSize - pBt->us
19b30 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 ableSize);. dat
19b40 61 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 20 64 61 a[21] = 64;. da
19b50 74 61 5b 32 32 5d 20 3d 20 33 32 3b 0a 20 20 64 ta[22] = 32;. d
19b60 61 74 61 5b 32 33 5d 20 3d 20 33 32 3b 0a 20 20 ata[23] = 32;.
19b70 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 32 34 5d memset(&data[24]
19b80 2c 20 30 2c 20 31 30 30 2d 32 34 29 3b 0a 20 20 , 0, 100-24);.
19b90 7a 65 72 6f 50 61 67 65 28 70 50 31 2c 20 50 54 zeroPage(pP1, PT
19ba0 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 F_INTKEY|PTF_LEA
19bb0 46 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 20 29 F|PTF_LEAFDATA )
19bc0 3b 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 ;. pBt->btsFlag
19bd0 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a s |= BTS_PAGESIZ
19be0 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 E_FIXED;.#ifndef
19bf0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
19c00 4f 56 41 43 55 55 4d 0a 20 20 61 73 73 65 72 74 OVACUUM. assert
19c10 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ( pBt->autoVacuu
19c20 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 61 75 74 m==1 || pBt->aut
19c30 6f 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 oVacuum==0 );.
19c40 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 63 assert( pBt->inc
19c50 72 56 61 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 rVacuum==1 || pB
19c60 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 3d 3d 30 t->incrVacuum==0
19c70 20 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 );. put4byte(&
19c80 64 61 74 61 5b 33 36 20 2b 20 34 2a 34 5d 2c 20 data[36 + 4*4],
19c90 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 pBt->autoVacuum)
19ca0 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 64 61 ;. put4byte(&da
19cb0 74 61 5b 33 36 20 2b 20 37 2a 34 5d 2c 20 70 42 ta[36 + 7*4], pB
19cc0 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 3b 0a t->incrVacuum);.
19cd0 23 65 6e 64 69 66 0a 20 20 70 42 74 2d 3e 6e 50 #endif. pBt->nP
19ce0 61 67 65 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b age = 1;. data[
19cf0 33 31 5d 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 31] = 1;. retur
19d00 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
19d10 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 /*.** Initialize
19d20 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 the first page
19d30 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
19d40 66 69 6c 65 20 28 63 72 65 61 74 69 6e 67 20 61 file (creating a
19d50 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
19d60 73 69 73 74 69 6e 67 20 6f 66 20 61 20 73 69 6e sisting of a sin
19d70 67 6c 65 20 70 61 67 65 20 61 6e 64 20 6e 6f 20 gle page and no
19d80 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 29 2e schema objects).
19d90 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
19da0 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 66 K.** if successf
19db0 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 ul, or an SQLite
19dc0 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 error code othe
19dd0 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 rwise..*/.int sq
19de0 6c 69 74 65 33 42 74 72 65 65 4e 65 77 44 62 28 lite3BtreeNewDb(
19df0 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 Btree *p){. int
19e00 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 rc;. sqlite3Bt
19e10 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
19e20 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 30 ->pBt->nPage = 0
19e30 3b 0a 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 ;. rc = newData
19e40 62 61 73 65 28 70 2d 3e 70 42 74 29 3b 0a 20 20 base(p->pBt);.
19e50 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
19e60 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
19e70 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 c;.}../*.** Atte
19e80 6d 70 74 20 74 6f 20 73 74 61 72 74 20 61 20 6e mpt to start a n
19e90 65 77 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ew transaction.
19ea0 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 A write-transact
19eb0 69 6f 6e 0a 2a 2a 20 69 73 20 73 74 61 72 74 65 ion.** is starte
19ec0 64 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 d if the second
19ed0 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 7a argument is nonz
19ee0 65 72 6f 2c 20 6f 74 68 65 72 77 69 73 65 20 61 ero, otherwise a
19ef0 20 72 65 61 64 2d 0a 2a 2a 20 74 72 61 6e 73 61 read-.** transa
19f00 63 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 73 ction. If the s
19f10 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 econd argument i
19f20 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 6e 64 20 s 2 or more and
19f30 65 78 63 6c 75 73 69 76 65 0a 2a 2a 20 74 72 61 exclusive.** tra
19f40 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 72 nsaction is star
19f50 74 65 64 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 ted, meaning tha
19f60 74 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 t no other proce
19f70 73 73 20 69 73 20 61 6c 6c 6f 77 65 64 0a 2a 2a ss is allowed.**
19f80 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 to access the d
19f90 61 74 61 62 61 73 65 2e 20 20 41 20 70 72 65 65 atabase. A pree
19fa0 78 69 73 74 69 6e 67 20 74 72 61 6e 73 61 63 74 xisting transact
19fb0 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 0a 2a ion may not be.*
19fc0 2a 20 75 70 67 72 61 64 65 64 20 74 6f 20 65 78 * upgraded to ex
19fd0 63 6c 75 73 69 76 65 20 62 79 20 63 61 6c 6c 69 clusive by calli
19fe0 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ng this routine
19ff0 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 20 2d 20 a second time -
1a000 74 68 65 0a 2a 2a 20 65 78 63 6c 75 73 69 76 69 the.** exclusivi
1a010 74 79 20 66 6c 61 67 20 6f 6e 6c 79 20 77 6f 72 ty flag only wor
1a020 6b 73 20 66 6f 72 20 61 20 6e 65 77 20 74 72 61 ks for a new tra
1a030 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 nsaction..**.**
1a040 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 A write-transact
1a050 69 6f 6e 20 6d 75 73 74 20 62 65 20 73 74 61 72 ion must be star
1a060 74 65 64 20 62 65 66 6f 72 65 20 61 74 74 65 6d ted before attem
1a070 70 74 69 6e 67 20 61 6e 79 20 0a 2a 2a 20 63 68 pting any .** ch
1a080 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 74 anges to the dat
1a090 61 62 61 73 65 2e 20 20 4e 6f 6e 65 20 6f 66 20 abase. None of
1a0a0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f the following ro
1a0b0 75 74 69 6e 65 73 20 0a 2a 2a 20 77 69 6c 6c 20 utines .** will
1a0c0 77 6f 72 6b 20 75 6e 6c 65 73 73 20 61 20 74 72 work unless a tr
1a0d0 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 ansaction is sta
1a0e0 72 74 65 64 20 66 69 72 73 74 3a 0a 2a 2a 0a 2a rted first:.**.*
1a0f0 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 * sqlite3Bt
1a100 72 65 65 43 72 65 61 74 65 54 61 62 6c 65 28 29 reeCreateTable()
1a110 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
1a120 42 74 72 65 65 43 72 65 61 74 65 49 6e 64 65 78 BtreeCreateIndex
1a130 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 ().** sqlit
1a140 65 33 42 74 72 65 65 43 6c 65 61 72 54 61 62 6c e3BtreeClearTabl
1a150 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 e().** sqli
1a160 74 65 33 42 74 72 65 65 44 72 6f 70 54 61 62 6c te3BtreeDropTabl
1a170 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 e().** sqli
1a180 74 65 33 42 74 72 65 65 49 6e 73 65 72 74 28 29 te3BtreeInsert()
1a190 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
1a1a0 42 74 72 65 65 44 65 6c 65 74 65 28 29 0a 2a 2a BtreeDelete().**
1a1b0 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1a1c0 65 65 55 70 64 61 74 65 4d 65 74 61 28 29 0a 2a eeUpdateMeta().*
1a1d0 2a 0a 2a 2a 20 49 66 20 61 6e 20 69 6e 69 74 69 *.** If an initi
1a1e0 61 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 61 63 al attempt to ac
1a1f0 71 75 69 72 65 20 74 68 65 20 6c 6f 63 6b 20 66 quire the lock f
1a200 61 69 6c 73 20 62 65 63 61 75 73 65 20 6f 66 20 ails because of
1a210 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 0a lock contention.
1a220 2a 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 ** and the datab
1a230 61 73 65 20 77 61 73 20 70 72 65 76 69 6f 75 73 ase was previous
1a240 6c 79 20 75 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 ly unlocked, the
1a250 6e 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 n invoke the bus
1a260 79 20 68 61 6e 64 6c 65 72 0a 2a 2a 20 69 66 20 y handler.** if
1a270 74 68 65 72 65 20 69 73 20 6f 6e 65 2e 20 20 42 there is one. B
1a280 75 74 20 69 66 20 74 68 65 72 65 20 77 61 73 20 ut if there was
1a290 70 72 65 76 69 6f 75 73 6c 79 20 61 20 72 65 61 previously a rea
1a2a0 64 2d 6c 6f 63 6b 2c 20 64 6f 20 6e 6f 74 0a 2a d-lock, do not.*
1a2b0 2a 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 * invoke the bus
1a2c0 79 20 68 61 6e 64 6c 65 72 20 2d 20 6a 75 73 74 y handler - just
1a2d0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
1a2e0 55 53 59 2e 20 20 53 51 4c 49 54 45 5f 42 55 53 USY. SQLITE_BUS
1a2f0 59 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 Y is .** returne
1a300 64 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 20 d when there is
1a310 61 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d 6c already a read-l
1a320 6f 63 6b 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ock in order to
1a330 61 76 6f 69 64 20 61 20 64 65 61 64 6c 6f 63 6b avoid a deadlock
1a340 2e 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20 ..**.** Suppose
1a350 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 72 there are two pr
1a360 6f 63 65 73 73 65 73 20 41 20 61 6e 64 20 42 2e ocesses A and B.
1a370 20 20 41 20 68 61 73 20 61 20 72 65 61 64 20 6c A has a read l
1a380 6f 63 6b 20 61 6e 64 20 42 20 68 61 73 0a 2a 2a ock and B has.**
1a390 20 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b a reserved lock
1a3a0 2e 20 20 42 20 74 72 69 65 73 20 74 6f 20 70 72 . B tries to pr
1a3b0 6f 6d 6f 74 65 20 74 6f 20 65 78 63 6c 75 73 69 omote to exclusi
1a3c0 76 65 20 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 ve but is blocke
1a3d0 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 6f 66 20 d because.** of
1a3e0 41 27 73 20 72 65 61 64 20 6c 6f 63 6b 2e 20 20 A's read lock.
1a3f0 41 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f A tries to promo
1a400 74 65 20 74 6f 20 72 65 73 65 72 76 65 64 20 62 te to reserved b
1a410 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 79 ut is blocked by
1a420 20 42 2e 0a 2a 2a 20 4f 6e 65 20 6f 72 20 74 68 B..** One or th
1a430 65 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 74 e other of the t
1a440 77 6f 20 70 72 6f 63 65 73 73 65 73 20 6d 75 73 wo processes mus
1a450 74 20 67 69 76 65 20 77 61 79 20 6f 72 20 74 68 t give way or th
1a460 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 6e 6f ere can be.** no
1a470 20 70 72 6f 67 72 65 73 73 2e 20 20 42 79 20 72 progress. By r
1a480 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f eturning SQLITE_
1a490 42 55 53 59 20 61 6e 64 20 6e 6f 74 20 69 6e 76 BUSY and not inv
1a4a0 6f 6b 69 6e 67 20 74 68 65 20 62 75 73 79 20 63 oking the busy c
1a4b0 61 6c 6c 62 61 63 6b 0a 2a 2a 20 77 68 65 6e 20 allback.** when
1a4c0 41 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 A already has a
1a4d0 72 65 61 64 20 6c 6f 63 6b 2c 20 77 65 20 65 6e read lock, we en
1a4e0 63 6f 75 72 61 67 65 20 41 20 74 6f 20 67 69 76 courage A to giv
1a4f0 65 20 75 70 20 61 6e 64 20 6c 65 74 20 42 0a 2a e up and let B.*
1a500 2a 20 70 72 6f 63 65 65 64 2e 0a 2a 2f 0a 69 6e * proceed..*/.in
1a510 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 t sqlite3BtreeBe
1a520 67 69 6e 54 72 61 6e 73 28 42 74 72 65 65 20 2a ginTrans(Btree *
1a530 70 2c 20 69 6e 74 20 77 72 66 6c 61 67 29 7b 0a p, int wrflag){.
1a540 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1a550 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 20 = p->pBt;. int
1a560 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1a570 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
1a580 6e 74 65 72 28 70 29 3b 0a 20 20 62 74 72 65 65 nter(p);. btree
1a590 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 Integrity(p);..
1a5a0 20 2f 2a 20 49 66 20 74 68 65 20 62 74 72 65 65 /* If the btree
1a5b0 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 61 is already in a
1a5c0 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 write-transacti
1a5d0 6f 6e 2c 20 6f 72 20 69 74 0a 20 20 2a 2a 20 69 on, or it. ** i
1a5e0 73 20 61 6c 72 65 61 64 79 20 69 6e 20 61 20 72 s already in a r
1a5f0 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ead-transaction
1a600 61 6e 64 20 61 20 72 65 61 64 2d 74 72 61 6e 73 and a read-trans
1a610 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 72 action. ** is r
1a620 65 71 75 65 73 74 65 64 2c 20 74 68 69 73 20 69 equested, this i
1a630 73 20 61 20 6e 6f 2d 6f 70 2e 0a 20 20 2a 2f 0a s a no-op.. */.
1a640 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 if( p->inTrans
1a650 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 7c 7c ==TRANS_WRITE ||
1a660 20 28 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 (p->inTrans==TR
1a670 41 4e 53 5f 52 45 41 44 20 26 26 20 21 77 72 66 ANS_READ && !wrf
1a680 6c 61 67 29 20 29 7b 0a 20 20 20 20 67 6f 74 6f lag) ){. goto
1a690 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 trans_begun;.
1a6a0 7d 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d }. assert( pBt-
1a6b0 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d >inTransaction==
1a6c0 54 52 41 4e 53 5f 57 52 49 54 45 20 7c 7c 20 49 TRANS_WRITE || I
1a6d0 66 4e 6f 74 4f 6d 69 74 41 56 28 70 42 74 2d 3e fNotOmitAV(pBt->
1a6e0 62 44 6f 54 72 75 6e 63 61 74 65 29 3d 3d 30 20 bDoTruncate)==0
1a6f0 29 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 74 );.. /* Write t
1a700 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 72 65 20 ransactions are
1a710 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 6f 6e 20 not possible on
1a720 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74 61 a read-only data
1a730 62 61 73 65 20 2a 2f 0a 20 20 69 66 28 20 28 70 base */. if( (p
1a740 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
1a750 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 TS_READ_ONLY)!=0
1a760 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 && wrflag ){.
1a770 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 rc = SQLITE_RE
1a780 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 67 6f 74 6f ADONLY;. goto
1a790 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 trans_begun;.
1a7a0 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
1a7b0 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
1a7c0 43 48 45 0a 20 20 7b 0a 20 20 20 20 73 71 6c 69 CHE. {. sqli
1a7d0 74 65 33 20 2a 70 42 6c 6f 63 6b 20 3d 20 30 3b te3 *pBlock = 0;
1a7e0 0a 20 20 20 20 2f 2a 20 49 66 20 61 6e 6f 74 68 . /* If anoth
1a7f0 65 72 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 er database hand
1a800 6c 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 6f le has already o
1a810 70 65 6e 65 64 20 61 20 77 72 69 74 65 20 74 72 pened a write tr
1a820 61 6e 73 61 63 74 69 6f 6e 20 0a 20 20 20 20 2a ansaction . *
1a830 2a 20 6f 6e 20 74 68 69 73 20 73 68 61 72 65 64 * on this shared
1a840 2d 62 74 72 65 65 20 73 74 72 75 63 74 75 72 65 -btree structure
1a850 20 61 6e 64 20 61 20 73 65 63 6f 6e 64 20 77 72 and a second wr
1a860 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite transaction
1a870 69 73 0a 20 20 20 20 2a 2a 20 72 65 71 75 65 73 is. ** reques
1a880 74 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 ted, return SQLI
1a890 54 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 20 20 2a TE_LOCKED.. *
1a8a0 2f 0a 20 20 20 20 69 66 28 20 28 77 72 66 6c 61 /. if( (wrfla
1a8b0 67 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e g && pBt->inTran
1a8c0 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 saction==TRANS_W
1a8d0 52 49 54 45 29 0a 20 20 20 20 20 7c 7c 20 28 70 RITE). || (p
1a8e0 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
1a8f0 54 53 5f 50 45 4e 44 49 4e 47 29 21 3d 30 0a 20 TS_PENDING)!=0.
1a900 20 20 20 29 7b 0a 20 20 20 20 20 20 70 42 6c 6f ){. pBlo
1a910 63 6b 20 3d 20 70 42 74 2d 3e 70 57 72 69 74 65 ck = pBt->pWrite
1a920 72 2d 3e 64 62 3b 0a 20 20 20 20 7d 65 6c 73 65 r->db;. }else
1a930 20 69 66 28 20 77 72 66 6c 61 67 3e 31 20 29 7b if( wrflag>1 ){
1a940 0a 20 20 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 . BtLock *p
1a950 49 74 65 72 3b 0a 20 20 20 20 20 20 66 6f 72 28 Iter;. for(
1a960 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b pIter=pBt->pLock
1a970 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 ; pIter; pIter=p
1a980 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 Iter->pNext){.
1a990 20 20 20 20 20 20 69 66 28 20 70 49 74 65 72 2d if( pIter-
1a9a0 3e 70 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 20 >pBtree!=p ){.
1a9b0 20 20 20 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d pBlock =
1a9c0 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 2d 3e pIter->pBtree->
1a9d0 64 62 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 db;. br
1a9e0 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 eak;. }.
1a9f0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
1aa00 20 69 66 28 20 70 42 6c 6f 63 6b 20 29 7b 0a 20 if( pBlock ){.
1aa10 20 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e sqlite3Conn
1aa20 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d ectionBlocked(p-
1aa30 3e 64 62 2c 20 70 42 6c 6f 63 6b 29 3b 0a 20 20 >db, pBlock);.
1aa40 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
1aa50 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 LOCKED_SHAREDCAC
1aa60 48 45 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 74 HE;. goto t
1aa70 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 20 20 rans_begun;.
1aa80 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }. }.#endif..
1aa90 2f 2a 20 41 6e 79 20 72 65 61 64 2d 6f 6e 6c 79 /* Any read-only
1aaa0 20 6f 72 20 72 65 61 64 2d 77 72 69 74 65 20 74 or read-write t
1aab0 72 61 6e 73 61 63 74 69 6f 6e 20 69 6d 70 6c 69 ransaction impli
1aac0 65 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 6f es a read-lock o
1aad0 6e 20 0a 20 20 2a 2a 20 70 61 67 65 20 31 2e 20 n . ** page 1.
1aae0 53 6f 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 So if some other
1aaf0 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 63 6c shared-cache cl
1ab00 69 65 6e 74 20 61 6c 72 65 61 64 79 20 68 61 73 ient already has
1ab10 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 0a 20 a write-lock .
1ab20 20 2a 2a 20 6f 6e 20 70 61 67 65 20 31 2c 20 74 ** on page 1, t
1ab30 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 he transaction c
1ab40 61 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 2e annot be opened.
1ab50 20 2a 2f 0a 20 20 72 63 20 3d 20 71 75 65 72 79 */. rc = query
1ab60 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
1ab70 4c 6f 63 6b 28 70 2c 20 4d 41 53 54 45 52 5f 52 Lock(p, MASTER_R
1ab80 4f 4f 54 2c 20 52 45 41 44 5f 4c 4f 43 4b 29 3b OOT, READ_LOCK);
1ab90 0a 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b . if( SQLITE_OK
1aba0 21 3d 72 63 20 29 20 67 6f 74 6f 20 74 72 61 6e !=rc ) goto tran
1abb0 73 5f 62 65 67 75 6e 3b 0a 0a 20 20 70 42 74 2d s_begun;.. pBt-
1abc0 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 >btsFlags &= ~BT
1abd0 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d 50 54 S_INITIALLY_EMPT
1abe0 59 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 Y;. if( pBt->nP
1abf0 61 67 65 3d 3d 30 20 29 20 70 42 74 2d 3e 62 74 age==0 ) pBt->bt
1ac00 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 49 4e sFlags |= BTS_IN
1ac10 49 54 49 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 ITIALLY_EMPTY;.
1ac20 20 64 6f 20 7b 0a 20 20 20 20 2f 2a 20 43 61 6c do {. /* Cal
1ac30 6c 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 75 6e l lockBtree() un
1ac40 74 69 6c 20 65 69 74 68 65 72 20 70 42 74 2d 3e til either pBt->
1ac50 70 50 61 67 65 31 20 69 73 20 70 6f 70 75 6c 61 pPage1 is popula
1ac60 74 65 64 20 6f 72 0a 20 20 20 20 2a 2a 20 6c 6f ted or. ** lo
1ac70 63 6b 42 74 72 65 65 28 29 20 72 65 74 75 72 6e ckBtree() return
1ac80 73 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 s something othe
1ac90 72 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b r than SQLITE_OK
1aca0 2e 20 6c 6f 63 6b 42 74 72 65 65 28 29 0a 20 20 . lockBtree().
1acb0 20 20 2a 2a 20 6d 61 79 20 72 65 74 75 72 6e 20 ** may return
1acc0 53 51 4c 49 54 45 5f 4f 4b 20 62 75 74 20 6c 65 SQLITE_OK but le
1acd0 61 76 65 20 70 42 74 2d 3e 70 50 61 67 65 31 20 ave pBt->pPage1
1ace0 73 65 74 20 74 6f 20 30 20 69 66 20 61 66 74 65 set to 0 if afte
1acf0 72 0a 20 20 20 20 2a 2a 20 72 65 61 64 69 6e 67 r. ** reading
1ad00 20 70 61 67 65 20 31 20 69 74 20 64 69 73 63 6f page 1 it disco
1ad10 76 65 72 73 20 74 68 61 74 20 74 68 65 20 70 61 vers that the pa
1ad20 67 65 2d 73 69 7a 65 20 6f 66 20 74 68 65 20 64 ge-size of the d
1ad30 61 74 61 62 61 73 65 20 0a 20 20 20 20 2a 2a 20 atabase . **
1ad40 66 69 6c 65 20 69 73 20 6e 6f 74 20 70 42 74 2d file is not pBt-
1ad50 3e 70 61 67 65 53 69 7a 65 2e 20 49 6e 20 74 68 >pageSize. In th
1ad60 69 73 20 63 61 73 65 20 6c 6f 63 6b 42 74 72 65 is case lockBtre
1ad70 65 28 29 20 77 69 6c 6c 20 75 70 64 61 74 65 0a e() will update.
1ad80 20 20 20 20 2a 2a 20 70 42 74 2d 3e 70 61 67 65 ** pBt->page
1ad90 53 69 7a 65 20 74 6f 20 74 68 65 20 70 61 67 65 Size to the page
1ada0 2d 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c -size of the fil
1adb0 65 20 6f 6e 20 64 69 73 6b 2e 0a 20 20 20 20 2a e on disk.. *
1adc0 2f 0a 20 20 20 20 77 68 69 6c 65 28 20 70 42 74 /. while( pBt
1add0 2d 3e 70 50 61 67 65 31 3d 3d 30 20 26 26 20 53 ->pPage1==0 && S
1ade0 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 QLITE_OK==(rc =
1adf0 6c 6f 63 6b 42 74 72 65 65 28 70 42 74 29 29 20 lockBtree(pBt))
1ae00 29 3b 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d );.. if( rc==
1ae10 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 77 72 66 SQLITE_OK && wrf
1ae20 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 69 66 28 lag ){. if(
1ae30 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
1ae40 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 & BTS_READ_ONLY)
1ae50 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 !=0 ){. r
1ae60 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 4f c = SQLITE_READO
1ae70 4e 4c 59 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 NLY;. }else
1ae80 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 {. rc = s
1ae90 71 6c 69 74 65 33 50 61 67 65 72 42 65 67 69 6e qlite3PagerBegin
1aea0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 77 72 66 (pBt->pPager,wrf
1aeb0 6c 61 67 3e 31 2c 73 71 6c 69 74 65 33 54 65 6d lag>1,sqlite3Tem
1aec0 70 49 6e 4d 65 6d 6f 72 79 28 70 2d 3e 64 62 29 pInMemory(p->db)
1aed0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
1aee0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
1aef0 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 6e rc = n
1af00 65 77 44 61 74 61 62 61 73 65 28 70 42 74 29 3b ewDatabase(pBt);
1af10 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
1af20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 }. }. .
1af30 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1af40 4b 20 29 7b 0a 20 20 20 20 20 20 75 6e 6c 6f 63 K ){. unloc
1af50 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 kBtreeIfUnused(p
1af60 42 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 77 68 Bt);. }. }wh
1af70 69 6c 65 28 20 28 72 63 26 30 78 46 46 29 3d 3d ile( (rc&0xFF)==
1af80 53 51 4c 49 54 45 5f 42 55 53 59 20 26 26 20 70 SQLITE_BUSY && p
1af90 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1afa0 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 n==TRANS_NONE &&
1afb0 0a 20 20 20 20 20 20 20 20 20 20 62 74 72 65 65 . btree
1afc0 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
1afd0 72 28 70 42 74 29 20 29 3b 0a 0a 20 20 69 66 28 r(pBt) );.. if(
1afe0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1aff0 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 {. if( p->inT
1b000 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 rans==TRANS_NONE
1b010 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e ){. pBt->n
1b020 54 72 61 6e 73 61 63 74 69 6f 6e 2b 2b 3b 0a 23 Transaction++;.#
1b030 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1b040 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
1b050 20 20 20 20 20 20 69 66 28 20 70 2d 3e 73 68 61 if( p->sha
1b060 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 rable ){.
1b070 20 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b assert( p->lock
1b080 2e 70 42 74 72 65 65 3d 3d 70 20 26 26 20 70 2d .pBtree==p && p-
1b090 3e 6c 6f 63 6b 2e 69 54 61 62 6c 65 3d 3d 31 20 >lock.iTable==1
1b0a0 29 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6c 6f );. p->lo
1b0b0 63 6b 2e 65 4c 6f 63 6b 20 3d 20 52 45 41 44 5f ck.eLock = READ_
1b0c0 4c 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 70 2d LOCK;. p-
1b0d0 3e 6c 6f 63 6b 2e 70 4e 65 78 74 20 3d 20 70 42 >lock.pNext = pB
1b0e0 74 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 20 20 20 t->pLock;.
1b0f0 20 20 70 42 74 2d 3e 70 4c 6f 63 6b 20 3d 20 26 pBt->pLock = &
1b100 70 2d 3e 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 7d p->lock;. }
1b110 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 .#endif. }.
1b120 20 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 28 p->inTrans = (
1b130 77 72 66 6c 61 67 3f 54 52 41 4e 53 5f 57 52 49 wrflag?TRANS_WRI
1b140 54 45 3a 54 52 41 4e 53 5f 52 45 41 44 29 3b 0a TE:TRANS_READ);.
1b150 20 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 if( p->inTra
1b160 6e 73 3e 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 ns>pBt->inTransa
1b170 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 70 ction ){. p
1b180 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1b190 6e 20 3d 20 70 2d 3e 69 6e 54 72 61 6e 73 3b 0a n = p->inTrans;.
1b1a0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 77 72 }. if( wr
1b1b0 66 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 4d 65 flag ){. Me
1b1c0 6d 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 mPage *pPage1 =
1b1d0 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 23 69 66 pBt->pPage1;.#if
1b1e0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
1b1f0 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 _SHARED_CACHE.
1b200 20 20 20 20 61 73 73 65 72 74 28 20 21 70 42 74 assert( !pBt
1b210 2d 3e 70 57 72 69 74 65 72 20 29 3b 0a 20 20 20 ->pWriter );.
1b220 20 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 pBt->pWriter
1b230 3d 20 70 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e = p;. pBt->
1b240 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 btsFlags &= ~BTS
1b250 5f 45 58 43 4c 55 53 49 56 45 3b 0a 20 20 20 20 _EXCLUSIVE;.
1b260 20 20 69 66 28 20 77 72 66 6c 61 67 3e 31 20 29 if( wrflag>1 )
1b270 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c pBt->btsFlags |
1b280 3d 20 42 54 53 5f 45 58 43 4c 55 53 49 56 45 3b = BTS_EXCLUSIVE;
1b290 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 2f .#endif.. /
1b2a0 2a 20 49 66 20 74 68 65 20 64 62 2d 73 69 7a 65 * If the db-size
1b2b0 20 68 65 61 64 65 72 20 66 69 65 6c 64 20 69 73 header field is
1b2c0 20 69 6e 63 6f 72 72 65 63 74 20 28 61 73 20 69 incorrect (as i
1b2d0 74 20 6d 61 79 20 62 65 20 69 66 20 61 6e 20 6f t may be if an o
1b2e0 6c 64 0a 20 20 20 20 20 20 2a 2a 20 63 6c 69 65 ld. ** clie
1b2f0 6e 74 20 68 61 73 20 62 65 65 6e 20 77 72 69 74 nt has been writ
1b300 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 ing the database
1b310 20 66 69 6c 65 29 2c 20 75 70 64 61 74 65 20 69 file), update i
1b320 74 20 6e 6f 77 2e 20 44 6f 69 6e 67 0a 20 20 20 t now. Doing.
1b330 20 20 20 2a 2a 20 74 68 69 73 20 73 6f 6f 6e 65 ** this soone
1b340 72 20 72 61 74 68 65 72 20 74 68 61 6e 20 6c 61 r rather than la
1b350 74 65 72 20 6d 65 61 6e 73 20 74 68 65 20 64 61 ter means the da
1b360 74 61 62 61 73 65 20 73 69 7a 65 20 63 61 6e 20 tabase size can
1b370 73 61 66 65 6c 79 20 0a 20 20 20 20 20 20 2a 2a safely . **
1b380 20 72 65 2d 72 65 61 64 20 74 68 65 20 64 61 74 re-read the dat
1b390 61 62 61 73 65 20 73 69 7a 65 20 66 72 6f 6d 20 abase size from
1b3a0 70 61 67 65 20 31 20 69 66 20 61 20 73 61 76 65 page 1 if a save
1b3b0 70 6f 69 6e 74 20 6f 72 20 74 72 61 6e 73 61 63 point or transac
1b3c0 74 69 6f 6e 0a 20 20 20 20 20 20 2a 2a 20 72 6f tion. ** ro
1b3d0 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 20 77 69 llback occurs wi
1b3e0 74 68 69 6e 20 74 68 65 20 74 72 61 6e 73 61 63 thin the transac
1b3f0 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 tion.. */.
1b400 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 if( pBt->nP
1b410 61 67 65 21 3d 67 65 74 34 62 79 74 65 28 26 70 age!=get4byte(&p
1b420 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d Page1->aData[28]
1b430 29 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 ) ){. rc
1b440 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
1b450 69 74 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 ite(pPage1->pDbP
1b460 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 age);. if
1b470 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1b480 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 ){. put
1b490 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 4byte(&pPage1->a
1b4a0 44 61 74 61 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e Data[28], pBt->n
1b4b0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d Page);. }
1b4c0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
1b4d0 20 7d 0a 0a 0a 74 72 61 6e 73 5f 62 65 67 75 6e }...trans_begun
1b4e0 3a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 :. if( rc==SQLI
1b4f0 54 45 5f 4f 4b 20 26 26 20 77 72 66 6c 61 67 20 TE_OK && wrflag
1b500 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 63 ){. /* This c
1b510 61 6c 6c 20 6d 61 6b 65 73 20 73 75 72 65 20 74 all makes sure t
1b520 68 61 74 20 74 68 65 20 70 61 67 65 72 20 68 61 hat the pager ha
1b530 73 20 74 68 65 20 63 6f 72 72 65 63 74 20 6e 75 s the correct nu
1b540 6d 62 65 72 20 6f 66 0a 20 20 20 20 2a 2a 20 6f mber of. ** o
1b550 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 2e 20 pen savepoints.
1b560 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61 If the second pa
1b570 72 61 6d 65 74 65 72 20 69 73 20 67 72 65 61 74 rameter is great
1b580 65 72 20 74 68 61 6e 20 30 20 61 6e 64 0a 20 20 er than 0 and.
1b590 20 20 2a 2a 20 74 68 65 20 73 75 62 2d 6a 6f 75 ** the sub-jou
1b5a0 72 6e 61 6c 20 69 73 20 6e 6f 74 20 61 6c 72 65 rnal is not alre
1b5b0 61 64 79 20 6f 70 65 6e 2c 20 74 68 65 6e 20 69 ady open, then i
1b5c0 74 20 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 t will be opened
1b5d0 20 68 65 72 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 here.. */.
1b5e0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1b5f0 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 69 6e 74 gerOpenSavepoint
1b600 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 2d (pBt->pPager, p-
1b610 3e 64 62 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 29 >db->nSavepoint)
1b620 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 49 6e ;. }.. btreeIn
1b630 74 65 67 72 69 74 79 28 70 29 3b 0a 20 20 73 71 tegrity(p);. sq
1b640 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
1b650 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
1b660 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .}..#ifndef SQLI
1b670 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
1b680 55 4d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 UM../*.** Set th
1b690 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e e pointer-map en
1b6a0 74 72 69 65 73 20 66 6f 72 20 61 6c 6c 20 63 68 tries for all ch
1b6b0 69 6c 64 72 65 6e 20 6f 66 20 70 61 67 65 20 70 ildren of page p
1b6c0 50 61 67 65 2e 20 41 6c 73 6f 2c 20 69 66 0a 2a Page. Also, if.*
1b6d0 2a 20 70 50 61 67 65 20 63 6f 6e 74 61 69 6e 73 * pPage contains
1b6e0 20 63 65 6c 6c 73 20 74 68 61 74 20 70 6f 69 6e cells that poin
1b6f0 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 t to overflow pa
1b700 67 65 73 2c 20 73 65 74 20 74 68 65 20 70 6f 69 ges, set the poi
1b710 6e 74 65 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 72 nter.** map entr
1b720 69 65 73 20 66 6f 72 20 74 68 65 20 6f 76 65 72 ies for the over
1b730 66 6c 6f 77 20 70 61 67 65 73 20 61 73 20 77 65 flow pages as we
1b740 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ll..*/.static in
1b750 74 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 70 t setChildPtrmap
1b760 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 s(MemPage *pPage
1b770 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 ){. int i;
1b780 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b790 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e 74 /* Count
1b7a0 65 72 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 er variable */.
1b7b0 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 20 int nCell;
1b7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b7d0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1b7e0 20 63 65 6c 6c 73 20 69 6e 20 70 61 67 65 20 70 cells in page p
1b7f0 50 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 Page */. int rc
1b800 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1b810 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1b820 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 Return code */.
1b830 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
1b840 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 75 pPage->pBt;. u
1b850 38 20 69 73 49 6e 69 74 4f 72 69 67 20 3d 20 70 8 isInitOrig = p
1b860 50 61 67 65 2d 3e 69 73 49 6e 69 74 3b 0a 20 20 Page->isInit;.
1b870 50 67 6e 6f 20 70 67 6e 6f 20 3d 20 70 50 61 67 Pgno pgno = pPag
1b880 65 2d 3e 70 67 6e 6f 3b 0a 0a 20 20 61 73 73 65 e->pgno;.. asse
1b890 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
1b8a0 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
1b8b0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 t->mutex) );. r
1b8c0 63 20 3d 20 62 74 72 65 65 49 6e 69 74 50 61 67 c = btreeInitPag
1b8d0 65 28 70 50 61 67 65 29 3b 0a 20 20 69 66 28 20 e(pPage);. if(
1b8e0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1b8f0 0a 20 20 20 20 67 6f 74 6f 20 73 65 74 5f 63 68 . goto set_ch
1b900 69 6c 64 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3b ild_ptrmaps_out;
1b910 0a 20 20 7d 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 . }. nCell = p
1b920 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 Page->nCell;..
1b930 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c for(i=0; i<nCell
1b940 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a ; i++){. u8 *
1b950 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c pCell = findCell
1b960 28 70 50 61 67 65 2c 20 69 29 3b 0a 0a 20 20 20 (pPage, i);..
1b970 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 ptrmapPutOvflPt
1b980 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 r(pPage, pCell,
1b990 26 72 63 29 3b 0a 0a 20 20 20 20 69 66 28 20 21 &rc);.. if( !
1b9a0 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 pPage->leaf ){.
1b9b0 20 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 50 Pgno childP
1b9c0 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 gno = get4byte(p
1b9d0 43 65 6c 6c 29 3b 0a 20 20 20 20 20 20 70 74 72 Cell);. ptr
1b9e0 6d 61 70 50 75 74 28 70 42 74 2c 20 63 68 69 6c mapPut(pBt, chil
1b9f0 64 50 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 54 dPgno, PTRMAP_BT
1ba00 52 45 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 3b REE, pgno, &rc);
1ba10 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 . }. }.. if
1ba20 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 ( !pPage->leaf )
1ba30 7b 0a 20 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 {. Pgno child
1ba40 50 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 Pgno = get4byte(
1ba50 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 &pPage->aData[pP
1ba60 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 age->hdrOffset+8
1ba70 5d 29 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 ]);. ptrmapPu
1ba80 74 28 70 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f t(pBt, childPgno
1ba90 2c 20 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 , PTRMAP_BTREE,
1baa0 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 7d 0a pgno, &rc);. }.
1bab0 0a 73 65 74 5f 63 68 69 6c 64 5f 70 74 72 6d 61 .set_child_ptrma
1bac0 70 73 5f 6f 75 74 3a 0a 20 20 70 50 61 67 65 2d ps_out:. pPage-
1bad0 3e 69 73 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 >isInit = isInit
1bae0 4f 72 69 67 3b 0a 20 20 72 65 74 75 72 6e 20 72 Orig;. return r
1baf0 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 c;.}../*.** Some
1bb00 77 68 65 72 65 20 6f 6e 20 70 50 61 67 65 20 69 where on pPage i
1bb10 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 70 s a pointer to p
1bb20 61 67 65 20 69 46 72 6f 6d 2e 20 20 4d 6f 64 69 age iFrom. Modi
1bb30 66 79 20 74 68 69 73 20 70 6f 69 6e 74 65 72 20 fy this pointer
1bb40 73 6f 0a 2a 2a 20 74 68 61 74 20 69 74 20 70 6f so.** that it po
1bb50 69 6e 74 73 20 74 6f 20 69 54 6f 2e 20 50 61 72 ints to iTo. Par
1bb60 61 6d 65 74 65 72 20 65 54 79 70 65 20 64 65 73 ameter eType des
1bb70 63 72 69 62 65 73 20 74 68 65 20 74 79 70 65 20 cribes the type
1bb80 6f 66 20 70 6f 69 6e 74 65 72 20 74 6f 0a 2a 2a of pointer to.**
1bb90 20 62 65 20 6d 6f 64 69 66 69 65 64 2c 20 61 73 be modified, as
1bba0 20 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a follows:.**.**
1bbb0 20 50 54 52 4d 41 50 5f 42 54 52 45 45 3a 20 20 PTRMAP_BTREE:
1bbc0 20 20 20 70 50 61 67 65 20 69 73 20 61 20 62 74 pPage is a bt
1bbd0 72 65 65 2d 70 61 67 65 2e 20 54 68 65 20 70 6f ree-page. The po
1bbe0 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 74 20 inter points at
1bbf0 61 20 63 68 69 6c 64 20 0a 2a 2a 20 20 20 20 20 a child .**
1bc00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 61 pa
1bc10 67 65 20 6f 66 20 70 50 61 67 65 2e 0a 2a 2a 0a ge of pPage..**.
1bc20 2a 2a 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c ** PTRMAP_OVERFL
1bc30 4f 57 31 3a 20 70 50 61 67 65 20 69 73 20 61 20 OW1: pPage is a
1bc40 62 74 72 65 65 2d 70 61 67 65 2e 20 54 68 65 20 btree-page. The
1bc50 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 pointer points a
1bc60 74 20 61 6e 20 6f 76 65 72 66 6c 6f 77 0a 2a 2a t an overflow.**
1bc70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bc80 20 20 20 70 61 67 65 20 70 6f 69 6e 74 65 64 20 page pointed
1bc90 74 6f 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 to by one of the
1bca0 20 63 65 6c 6c 73 20 6f 6e 20 70 50 61 67 65 2e cells on pPage.
1bcb0 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 4f 56 .**.** PTRMAP_OV
1bcc0 45 52 46 4c 4f 57 32 3a 20 70 50 61 67 65 20 69 ERFLOW2: pPage i
1bcd0 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 2d 70 61 s an overflow-pa
1bce0 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 ge. The pointer
1bcf0 70 6f 69 6e 74 73 20 61 74 20 74 68 65 20 6e 65 points at the ne
1bd00 78 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 xt.**
1bd10 20 20 20 20 20 20 20 20 6f 76 65 72 66 6c 6f 77 overflow
1bd20 20 70 61 67 65 20 69 6e 20 74 68 65 20 6c 69 73 page in the lis
1bd30 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 t..*/.static int
1bd40 20 6d 6f 64 69 66 79 50 61 67 65 50 6f 69 6e 74 modifyPagePoint
1bd50 65 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 er(MemPage *pPag
1bd60 65 2c 20 50 67 6e 6f 20 69 46 72 6f 6d 2c 20 50 e, Pgno iFrom, P
1bd70 67 6e 6f 20 69 54 6f 2c 20 75 38 20 65 54 79 70 gno iTo, u8 eTyp
1bd80 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 e){. assert( sq
1bd90 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
1bda0 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 (pPage->pBt->mut
1bdb0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
1bdc0 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
1bdd0 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
1bde0 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 69 66 pDbPage) );. if
1bdf0 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
1be00 4f 56 45 52 46 4c 4f 57 32 20 29 7b 0a 20 20 20 OVERFLOW2 ){.
1be10 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
1be20 69 73 20 61 6c 77 61 79 73 20 74 68 65 20 66 69 is always the fi
1be30 72 73 74 20 34 20 62 79 74 65 73 20 6f 66 20 74 rst 4 bytes of t
1be40 68 65 20 70 61 67 65 20 69 6e 20 74 68 69 73 20 he page in this
1be50 63 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 69 66 case. */. if
1be60 28 20 67 65 74 34 62 79 74 65 28 70 50 61 67 65 ( get4byte(pPage
1be70 2d 3e 61 44 61 74 61 29 21 3d 69 46 72 6f 6d 20 ->aData)!=iFrom
1be80 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1be90 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1bea0 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 KPT;. }. p
1beb0 75 74 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 ut4byte(pPage->a
1bec0 44 61 74 61 2c 20 69 54 6f 29 3b 0a 20 20 7d 65 Data, iTo);. }e
1bed0 6c 73 65 7b 0a 20 20 20 20 75 38 20 69 73 49 6e lse{. u8 isIn
1bee0 69 74 4f 72 69 67 20 3d 20 70 50 61 67 65 2d 3e itOrig = pPage->
1bef0 69 73 49 6e 69 74 3b 0a 20 20 20 20 69 6e 74 20 isInit;. int
1bf00 69 3b 0a 20 20 20 20 69 6e 74 20 6e 43 65 6c 6c i;. int nCell
1bf10 3b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 0a 20 ;. int rc;..
1bf20 20 20 20 72 63 20 3d 20 62 74 72 65 65 49 6e 69 rc = btreeIni
1bf30 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 tPage(pPage);.
1bf40 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
1bf50 6e 20 72 63 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 n rc;. nCell
1bf60 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a = pPage->nCell;.
1bf70 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c . for(i=0; i<
1bf80 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 nCell; i++){.
1bf90 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 u8 *pCell = f
1bfa0 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 indCell(pPage, i
1bfb0 29 3b 0a 20 20 20 20 20 20 69 66 28 20 65 54 79 );. if( eTy
1bfc0 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 pe==PTRMAP_OVERF
1bfd0 4c 4f 57 31 20 29 7b 0a 20 20 20 20 20 20 20 20 LOW1 ){.
1bfe0 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 CellInfo info;.
1bff0 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e 78 50 pPage->xP
1c000 61 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 arseCell(pPage,
1c010 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 pCell, &info);.
1c020 20 20 20 20 20 20 20 69 66 28 20 69 6e 66 6f 2e if( info.
1c030 6e 4c 6f 63 61 6c 3c 69 6e 66 6f 2e 6e 50 61 79 nLocal<info.nPay
1c040 6c 6f 61 64 0a 20 20 20 20 20 20 20 20 20 26 26 load. &&
1c050 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e 6e 53 69 7a pCell+info.nSiz
1c060 65 2d 31 3c 3d 70 50 61 67 65 2d 3e 61 44 61 74 e-1<=pPage->aDat
1c070 61 2b 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 a+pPage->maskPag
1c080 65 0a 20 20 20 20 20 20 20 20 20 26 26 20 69 46 e. && iF
1c090 72 6f 6d 3d 3d 67 65 74 34 62 79 74 65 28 70 43 rom==get4byte(pC
1c0a0 65 6c 6c 2b 69 6e 66 6f 2e 6e 53 69 7a 65 2d 34 ell+info.nSize-4
1c0b0 29 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 ). ){.
1c0c0 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
1c0d0 70 43 65 6c 6c 2b 69 6e 66 6f 2e 6e 53 69 7a 65 pCell+info.nSize
1c0e0 2d 34 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 -4, iTo);.
1c0f0 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
1c100 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
1c110 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 67 65 {. if( ge
1c120 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3d 3d 69 t4byte(pCell)==i
1c130 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 From ){.
1c140 20 20 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c put4byte(pCell
1c150 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 , iTo);.
1c160 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
1c170 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
1c180 0a 20 20 0a 20 20 20 20 69 66 28 20 69 3d 3d 6e . . if( i==n
1c190 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 Cell ){. if
1c1a0 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f ( eType!=PTRMAP_
1c1b0 42 54 52 45 45 20 7c 7c 20 0a 20 20 20 20 20 20 BTREE || .
1c1c0 20 20 20 20 67 65 74 34 62 79 74 65 28 26 70 50 get4byte(&pP
1c1d0 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 age->aData[pPage
1c1e0 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 21 ->hdrOffset+8])!
1c1f0 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 =iFrom ){.
1c200 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1c210 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
1c220 20 20 20 20 7d 0a 20 20 20 20 20 20 70 75 74 34 }. put4
1c230 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 byte(&pPage->aDa
1c240 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 ta[pPage->hdrOff
1c250 73 65 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 20 set+8], iTo);.
1c260 20 20 7d 0a 0a 20 20 20 20 70 50 61 67 65 2d 3e }.. pPage->
1c270 69 73 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 4f isInit = isInitO
1c280 72 69 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 rig;. }. retur
1c290 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1c2a0 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
1c2b0 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20 70 61 open database pa
1c2c0 67 65 20 70 44 62 50 61 67 65 20 74 6f 20 6c 6f ge pDbPage to lo
1c2d0 63 61 74 69 6f 6e 20 69 46 72 65 65 50 61 67 65 cation iFreePage
1c2e0 20 69 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 in the .** data
1c2f0 62 61 73 65 2e 20 54 68 65 20 70 44 62 50 61 67 base. The pDbPag
1c300 65 20 72 65 66 65 72 65 6e 63 65 20 72 65 6d 61 e reference rema
1c310 69 6e 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a ins valid..**.**
1c320 20 54 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 6c The isCommit fl
1c330 61 67 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 ag indicates tha
1c340 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 t there is no ne
1c350 65 64 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 74 ed to remember t
1c360 68 61 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e hat.** the journ
1c370 61 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 al needs to be s
1c380 79 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 64 ync()ed before d
1c390 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
1c3a0 50 61 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 63 Page->pgno .** c
1c3b0 61 6e 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f an be written to
1c3c0 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 68 61 73 . The caller has
1c3d0 20 61 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 65 already promise
1c3e0 64 20 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 74 d not to write t
1c3f0 6f 20 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e 0a o that.** page..
1c400 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 */.static int re
1c410 6c 6f 63 61 74 65 50 61 67 65 28 0a 20 20 42 74 locatePage(. Bt
1c420 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 Shared *pBt,
1c430 20 20 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 /* Btree
1c440 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 44 */. MemPage *pD
1c450 62 50 61 67 65 2c 20 20 20 20 20 20 20 20 2f 2a bPage, /*
1c460 20 4f 70 65 6e 20 70 61 67 65 20 74 6f 20 6d 6f Open page to mo
1c470 76 65 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 65 ve */. u8 eType
1c480 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1c490 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
1c4a0 27 74 79 70 65 27 20 65 6e 74 72 79 20 66 6f 72 'type' entry for
1c4b0 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 pDbPage */. Pg
1c4c0 6e 6f 20 69 50 74 72 50 61 67 65 2c 20 20 20 20 no iPtrPage,
1c4d0 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
1c4e0 72 20 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 20 r map 'page-no'
1c4f0 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 61 67 entry for pDbPag
1c500 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 65 e */. Pgno iFre
1c510 65 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 ePage,
1c520 2f 2a 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e 20 /* The location
1c530 74 6f 20 6d 6f 76 65 20 70 44 62 50 61 67 65 20 to move pDbPage
1c540 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f to */. int isCo
1c550 6d 6d 69 74 20 20 20 20 20 20 20 20 20 20 20 20 mmit
1c560 20 2f 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 /* isCommit fla
1c570 67 20 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 g passed to sqli
1c580 74 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 te3PagerMovepage
1c590 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 */.){. MemPage
1c5a0 20 2a 70 50 74 72 50 61 67 65 3b 20 20 20 2f 2a *pPtrPage; /*
1c5b0 20 54 68 65 20 70 61 67 65 20 74 68 61 74 20 63 The page that c
1c5c0 6f 6e 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 ontains a pointe
1c5d0 72 20 74 6f 20 70 44 62 50 61 67 65 20 2a 2f 0a r to pDbPage */.
1c5e0 20 20 50 67 6e 6f 20 69 44 62 50 61 67 65 20 3d Pgno iDbPage =
1c5f0 20 70 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a pDbPage->pgno;.
1c600 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
1c610 3d 20 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 = pBt->pPager;.
1c620 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
1c630 72 74 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 rt( eType==PTRMA
1c640 50 5f 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 65 P_OVERFLOW2 || e
1c650 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 Type==PTRMAP_OVE
1c660 52 46 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 20 RFLOW1 || .
1c670 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 eType==PTRMAP_B
1c680 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 TREE || eType==P
1c690 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 TRMAP_ROOTPAGE )
1c6a0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
1c6b0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
1c6c0 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
1c6d0 61 73 73 65 72 74 28 20 70 44 62 50 61 67 65 2d assert( pDbPage-
1c6e0 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 20 >pBt==pBt );..
1c6f0 2f 2a 20 4d 6f 76 65 20 70 61 67 65 20 69 44 62 /* Move page iDb
1c700 50 61 67 65 20 66 72 6f 6d 20 69 74 73 20 63 75 Page from its cu
1c710 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 74 rrent location t
1c720 6f 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 46 o page number iF
1c730 72 65 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 41 reePage */. TRA
1c740 43 45 28 28 22 41 55 54 4f 56 41 43 55 55 4d 3a CE(("AUTOVACUUM:
1c750 20 4d 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 72 Moving %d to fr
1c760 65 65 20 70 61 67 65 20 25 64 20 28 70 74 72 20 ee page %d (ptr
1c770 70 61 67 65 20 25 64 20 74 79 70 65 20 25 64 29 page %d type %d)
1c780 5c 6e 22 2c 20 0a 20 20 20 20 20 20 69 44 62 50 \n", . iDbP
1c790 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 age, iFreePage,
1c7a0 69 50 74 72 50 61 67 65 2c 20 65 54 79 70 65 29 iPtrPage, eType)
1c7b0 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
1c7c0 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 70 3PagerMovepage(p
1c7d0 50 61 67 65 72 2c 20 70 44 62 50 61 67 65 2d 3e Pager, pDbPage->
1c7e0 70 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 pDbPage, iFreePa
1c7f0 67 65 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a 20 ge, isCommit);.
1c800 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1c810 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
1c820 20 72 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 61 rc;. }. pDbPa
1c830 67 65 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 65 ge->pgno = iFree
1c840 50 61 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 Page;.. /* If p
1c850 44 62 50 61 67 65 20 77 61 73 20 61 20 62 74 72 DbPage was a btr
1c860 65 65 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 74 ee-page, then it
1c870 20 6d 61 79 20 68 61 76 65 20 63 68 69 6c 64 20 may have child
1c880 70 61 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 6c pages and/or cel
1c890 6c 73 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f 69 ls. ** that poi
1c8a0 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 nt to overflow p
1c8b0 61 67 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 65 ages. The pointe
1c8c0 72 20 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f r map entries fo
1c8d0 72 20 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a 2a r all these. **
1c8e0 20 70 61 67 65 73 20 6e 65 65 64 20 74 6f 20 62 pages need to b
1c8f0 65 20 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a 0a e changed.. **.
1c900 20 20 2a 2a 20 49 66 20 70 44 62 50 61 67 65 20 ** If pDbPage
1c910 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 is an overflow p
1c920 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 66 69 age, then the fi
1c930 72 73 74 20 34 20 62 79 74 65 73 20 6d 61 79 20 rst 4 bytes may
1c940 73 74 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f 69 store a. ** poi
1c950 6e 74 65 72 20 74 6f 20 61 20 73 75 62 73 65 71 nter to a subseq
1c960 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 uent overflow pa
1c970 67 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 74 ge. If this is t
1c980 68 65 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 20 he case, then.
1c990 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d ** the pointer m
1c9a0 61 70 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 ap needs to be u
1c9b0 70 64 61 74 65 64 20 66 6f 72 20 74 68 65 20 73 pdated for the s
1c9c0 75 62 73 65 71 75 65 6e 74 20 6f 76 65 72 66 6c ubsequent overfl
1c9d0 6f 77 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 ow page.. */.
1c9e0 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
1c9f0 50 5f 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 P_BTREE || eType
1ca00 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 ==PTRMAP_ROOTPAG
1ca10 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 65 E ){. rc = se
1ca20 74 43 68 69 6c 64 50 74 72 6d 61 70 73 28 70 44 tChildPtrmaps(pD
1ca30 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 bPage);. if(
1ca40 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1ca50 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
1ca60 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b ;. }. }else{
1ca70 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f 76 . Pgno nextOv
1ca80 66 6c 20 3d 20 67 65 74 34 62 79 74 65 28 70 44 fl = get4byte(pD
1ca90 62 50 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a 20 bPage->aData);.
1caa0 20 20 20 69 66 28 20 6e 65 78 74 4f 76 66 6c 21 if( nextOvfl!
1cab0 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d =0 ){. ptrm
1cac0 61 70 50 75 74 28 70 42 74 2c 20 6e 65 78 74 4f apPut(pBt, nextO
1cad0 76 66 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 vfl, PTRMAP_OVER
1cae0 46 4c 4f 57 32 2c 20 69 46 72 65 65 50 61 67 65 FLOW2, iFreePage
1caf0 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 69 66 , &rc);. if
1cb00 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1cb10 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 ){. retur
1cb20 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 n rc;. }.
1cb30 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 }. }.. /* Fi
1cb40 78 20 74 68 65 20 64 61 74 61 62 61 73 65 20 70 x the database p
1cb50 6f 69 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 69 ointer on page i
1cb60 50 74 72 50 61 67 65 20 74 68 61 74 20 70 6f 69 PtrPage that poi
1cb70 6e 74 65 64 20 61 74 20 69 44 62 50 61 67 65 20 nted at iDbPage
1cb80 73 6f 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 20 so. ** that it
1cb90 70 6f 69 6e 74 73 20 61 74 20 69 46 72 65 65 50 points at iFreeP
1cba0 61 67 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 68 age. Also fix th
1cbb0 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e e pointer map en
1cbc0 74 72 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 74 try for. ** iPt
1cbd0 72 50 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 rPage.. */. if
1cbe0 28 20 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f ( eType!=PTRMAP_
1cbf0 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 ROOTPAGE ){.
1cc00 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
1cc10 65 28 70 42 74 2c 20 69 50 74 72 50 61 67 65 2c e(pBt, iPtrPage,
1cc20 20 26 70 50 74 72 50 61 67 65 2c 20 30 29 3b 0a &pPtrPage, 0);.
1cc30 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1cc40 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
1cc50 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
1cc60 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1cc70 50 61 67 65 72 57 72 69 74 65 28 70 50 74 72 50 PagerWrite(pPtrP
1cc80 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 age->pDbPage);.
1cc90 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1cca0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
1ccb0 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 50 61 leasePage(pPtrPa
1ccc0 67 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 ge);. retur
1ccd0 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
1cce0 72 63 20 3d 20 6d 6f 64 69 66 79 50 61 67 65 50 rc = modifyPageP
1ccf0 6f 69 6e 74 65 72 28 70 50 74 72 50 61 67 65 2c ointer(pPtrPage,
1cd00 20 69 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 iDbPage, iFreeP
1cd10 61 67 65 2c 20 65 54 79 70 65 29 3b 0a 20 20 20 age, eType);.
1cd20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 releasePage(pPt
1cd30 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 rPage);. if(
1cd40 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1cd50 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 . ptrmapPut
1cd60 28 70 42 74 2c 20 69 46 72 65 65 50 61 67 65 2c (pBt, iFreePage,
1cd70 20 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 eType, iPtrPage
1cd80 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 , &rc);. }.
1cd90 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
1cda0 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 63 ../* Forward dec
1cdb0 6c 61 72 61 74 69 6f 6e 20 72 65 71 75 69 72 65 laration require
1cdc0 64 20 62 79 20 69 6e 63 72 56 61 63 75 75 6d 53 d by incrVacuumS
1cdd0 74 65 70 28 29 2e 20 2a 2f 0a 73 74 61 74 69 63 tep(). */.static
1cde0 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 72 int allocateBtr
1cdf0 65 65 50 61 67 65 28 42 74 53 68 61 72 65 64 20 eePage(BtShared
1ce00 2a 2c 20 4d 65 6d 50 61 67 65 20 2a 2a 2c 20 50 *, MemPage **, P
1ce10 67 6e 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 38 29 gno *, Pgno, u8)
1ce20 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 72 6d ;../*.** Perform
1ce30 20 61 20 73 69 6e 67 6c 65 20 73 74 65 70 20 6f a single step o
1ce40 66 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c f an incremental
1ce50 2d 76 61 63 75 75 6d 2e 20 49 66 20 73 75 63 63 -vacuum. If succ
1ce60 65 73 73 66 75 6c 2c 20 72 65 74 75 72 6e 0a 2a essful, return.*
1ce70 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 20 * SQLITE_OK. If
1ce80 74 68 65 72 65 20 69 73 20 6e 6f 20 77 6f 72 6b there is no work
1ce90 20 74 6f 20 64 6f 20 28 61 6e 64 20 74 68 65 72 to do (and ther
1cea0 65 66 6f 72 65 20 6e 6f 20 70 6f 69 6e 74 20 69 efore no point i
1ceb0 6e 20 0a 2a 2a 20 63 61 6c 6c 69 6e 67 20 74 68 n .** calling th
1cec0 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 is function agai
1ced0 6e 29 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 n), return SQLIT
1cee0 45 5f 44 4f 4e 45 2e 20 4f 72 2c 20 69 66 20 61 E_DONE. Or, if a
1cef0 6e 20 65 72 72 6f 72 20 0a 2a 2a 20 6f 63 63 75 n error .** occu
1cf00 72 73 2c 20 72 65 74 75 72 6e 20 73 6f 6d 65 20 rs, return some
1cf10 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 other error code
1cf20 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 73 70 65 ..**.** More spe
1cf30 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 69 73 20 cifically, this
1cf40 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 function attempt
1cf50 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a 65 s to re-organize
1cf60 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 6f the database so
1cf70 20 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 6c 61 .** that the la
1cf80 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 66 st page of the f
1cf90 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 69 6e ile currently in
1cfa0 20 75 73 65 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 use is no longe
1cfb0 72 20 69 6e 20 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 r in use..**.**
1cfc0 50 61 72 61 6d 65 74 65 72 20 6e 46 69 6e 20 69 Parameter nFin i
1cfd0 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
1cfe0 70 61 67 65 73 20 74 68 61 74 20 74 68 69 73 20 pages that this
1cff0 64 61 74 61 62 61 73 65 20 77 6f 75 6c 64 20 63 database would c
1d000 6f 6e 74 61 69 6e 0a 2a 2a 20 77 65 72 65 20 74 ontain.** were t
1d010 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c his function cal
1d020 6c 65 64 20 75 6e 74 69 6c 20 69 74 20 72 65 74 led until it ret
1d030 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e 45 urns SQLITE_DONE
1d040 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 ..**.** If the b
1d050 43 6f 6d 6d 69 74 20 70 61 72 61 6d 65 74 65 72 Commit parameter
1d060 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 is non-zero, th
1d070 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 is function assu
1d080 6d 65 73 20 74 68 61 74 20 74 68 65 20 0a 2a 2a mes that the .**
1d090 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6b 65 65 caller will kee
1d0a0 70 20 63 61 6c 6c 69 6e 67 20 69 6e 63 72 56 61 p calling incrVa
1d0b0 63 75 75 6d 53 74 65 70 28 29 20 75 6e 74 69 6c cuumStep() until
1d0c0 20 69 74 20 72 65 74 75 72 6e 73 20 53 51 4c 49 it returns SQLI
1d0d0 54 45 5f 44 4f 4e 45 20 0a 2a 2a 20 6f 72 20 61 TE_DONE .** or a
1d0e0 6e 20 65 72 72 6f 72 2e 20 62 43 6f 6d 6d 69 74 n error. bCommit
1d0f0 20 69 73 20 70 61 73 73 65 64 20 74 72 75 65 20 is passed true
1d100 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 for an auto-vacu
1d110 75 6d 2d 6f 6e 2d 63 6f 6d 6d 69 74 20 0a 2a 2a um-on-commit .**
1d120 20 6f 70 65 72 61 74 69 6f 6e 2c 20 6f 72 20 66 operation, or f
1d130 61 6c 73 65 20 66 6f 72 20 61 6e 20 69 6e 63 72 alse for an incr
1d140 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e 0a emental vacuum..
1d150 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 69 6e */.static int in
1d160 63 72 56 61 63 75 75 6d 53 74 65 70 28 42 74 53 crVacuumStep(BtS
1d170 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f hared *pBt, Pgno
1d180 20 6e 46 69 6e 2c 20 50 67 6e 6f 20 69 4c 61 73 nFin, Pgno iLas
1d190 74 50 67 2c 20 69 6e 74 20 62 43 6f 6d 6d 69 74 tPg, int bCommit
1d1a0 29 7b 0a 20 20 50 67 6e 6f 20 6e 46 72 65 65 4c ){. Pgno nFreeL
1d1b0 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f ist; /
1d1c0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
1d1d0 73 20 73 74 69 6c 6c 20 6f 6e 20 74 68 65 20 66 s still on the f
1d1e0 72 65 65 2d 6c 69 73 74 20 2a 2f 0a 20 20 69 6e ree-list */. in
1d1f0 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 t rc;.. assert(
1d200 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
1d210 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
1d220 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 4c 61 );. assert( iLa
1d230 73 74 50 67 3e 6e 46 69 6e 20 29 3b 0a 0a 20 20 stPg>nFin );..
1d240 69 66 28 20 21 50 54 52 4d 41 50 5f 49 53 50 41 if( !PTRMAP_ISPA
1d250 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 67 29 GE(pBt, iLastPg)
1d260 20 26 26 20 69 4c 61 73 74 50 67 21 3d 50 45 4e && iLastPg!=PEN
1d270 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 DING_BYTE_PAGE(p
1d280 42 74 29 20 29 7b 0a 20 20 20 20 75 38 20 65 54 Bt) ){. u8 eT
1d290 79 70 65 3b 0a 20 20 20 20 50 67 6e 6f 20 69 50 ype;. Pgno iP
1d2a0 74 72 50 61 67 65 3b 0a 0a 20 20 20 20 6e 46 72 trPage;.. nFr
1d2b0 65 65 4c 69 73 74 20 3d 20 67 65 74 34 62 79 74 eeList = get4byt
1d2c0 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e e(&pBt->pPage1->
1d2d0 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 aData[36]);.
1d2e0 69 66 28 20 6e 46 72 65 65 4c 69 73 74 3d 3d 30 if( nFreeList==0
1d2f0 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1d300 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 SQLITE_DONE;.
1d310 20 20 7d 0a 0a 20 20 20 20 72 63 20 3d 20 70 74 }.. rc = pt
1d320 72 6d 61 70 47 65 74 28 70 42 74 2c 20 69 4c 61 rmapGet(pBt, iLa
1d330 73 74 50 67 2c 20 26 65 54 79 70 65 2c 20 26 69 stPg, &eType, &i
1d340 50 74 72 50 61 67 65 29 3b 0a 20 20 20 20 69 66 PtrPage);. if
1d350 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1d360 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1d370 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 rc;. }. if
1d380 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
1d390 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 ROOTPAGE ){.
1d3a0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1d3b0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
1d3c0 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 65 54 79 }.. if( eTy
1d3d0 70 65 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 50 pe==PTRMAP_FREEP
1d3e0 41 47 45 20 29 7b 0a 20 20 20 20 20 20 69 66 28 AGE ){. if(
1d3f0 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 bCommit==0 ){.
1d400 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 /* Remove
1d410 20 74 68 65 20 70 61 67 65 20 66 72 6f 6d 20 74 the page from t
1d420 68 65 20 66 69 6c 65 73 20 66 72 65 65 2d 6c 69 he files free-li
1d430 73 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 st. This is not
1d440 72 65 71 75 69 72 65 64 0a 20 20 20 20 20 20 20 required.
1d450 20 2a 2a 20 69 66 20 62 43 6f 6d 6d 69 74 20 69 ** if bCommit i
1d460 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 6e 20 74 s non-zero. In t
1d470 68 61 74 20 63 61 73 65 2c 20 74 68 65 20 66 72 hat case, the fr
1d480 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 0a ee-list will be.
1d490 20 20 20 20 20 20 20 20 2a 2a 20 74 72 75 6e 63 ** trunc
1d4a0 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 61 66 74 ated to zero aft
1d4b0 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
1d4c0 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 69 74 20 returns, so it
1d4d0 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 20 20 20 doesn't .
1d4e0 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 20 69 74 ** matter if it
1d4f0 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 6e 73 20 still contains
1d500 73 6f 6d 65 20 67 61 72 62 61 67 65 20 65 6e 74 some garbage ent
1d510 72 69 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f ries.. */
1d520 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 46 . Pgno iF
1d530 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 4d reePg;. M
1d540 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 67 3b emPage *pFreePg;
1d550 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 6c . rc = al
1d560 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 28 locateBtreePage(
1d570 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c 20 26 pBt, &pFreePg, &
1d580 69 46 72 65 65 50 67 2c 20 69 4c 61 73 74 50 67 iFreePg, iLastPg
1d590 2c 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 , BTALLOC_EXACT)
1d5a0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
1d5b0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
1d5c0 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 return
1d5d0 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 rc;. }.
1d5e0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 46 assert( iF
1d5f0 72 65 65 50 67 3d 3d 69 4c 61 73 74 50 67 20 29 reePg==iLastPg )
1d600 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 ;. releas
1d610 65 50 61 67 65 28 70 46 72 65 65 50 67 29 3b 0a ePage(pFreePg);.
1d620 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 65 6c }. } el
1d630 73 65 20 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 se {. Pgno
1d640 69 46 72 65 65 50 67 3b 20 20 20 20 20 20 20 20 iFreePg;
1d650 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
1d660 20 66 72 65 65 20 70 61 67 65 20 74 6f 20 6d 6f free page to mo
1d670 76 65 20 70 4c 61 73 74 50 67 20 74 6f 20 2a 2f ve pLastPg to */
1d680 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a . MemPage *
1d690 70 4c 61 73 74 50 67 3b 0a 20 20 20 20 20 20 75 pLastPg;. u
1d6a0 38 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f 8 eMode = BTALLO
1d6b0 43 5f 41 4e 59 3b 20 20 20 2f 2a 20 4d 6f 64 65 C_ANY; /* Mode
1d6c0 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 parameter for a
1d6d0 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
1d6e0 28 29 20 2a 2f 0a 20 20 20 20 20 20 50 67 6e 6f () */. Pgno
1d6f0 20 69 4e 65 61 72 20 3d 20 30 3b 20 20 20 20 20 iNear = 0;
1d700 20 20 20 20 20 20 2f 2a 20 6e 65 61 72 62 79 20 /* nearby
1d710 70 61 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6c parameter for al
1d720 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 28 locateBtreePage(
1d730 29 20 2a 2f 0a 0a 20 20 20 20 20 20 72 63 20 3d ) */.. rc =
1d740 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
1d750 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 70 4c 61 t, iLastPg, &pLa
1d760 73 74 50 67 2c 20 30 29 3b 0a 20 20 20 20 20 20 stPg, 0);.
1d770 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1d780 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 K ){. ret
1d790 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a urn rc;. }.
1d7a0 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 62 43 6f . /* If bCo
1d7b0 6d 6d 69 74 20 69 73 20 7a 65 72 6f 2c 20 74 68 mmit is zero, th
1d7c0 69 73 20 6c 6f 6f 70 20 72 75 6e 73 20 65 78 61 is loop runs exa
1d7d0 63 74 6c 79 20 6f 6e 63 65 20 61 6e 64 20 70 61 ctly once and pa
1d7e0 67 65 20 70 4c 61 73 74 50 67 0a 20 20 20 20 20 ge pLastPg.
1d7f0 20 2a 2a 20 69 73 20 73 77 61 70 70 65 64 20 77 ** is swapped w
1d800 69 74 68 20 74 68 65 20 66 69 72 73 74 20 66 72 ith the first fr
1d810 65 65 20 70 61 67 65 20 70 75 6c 6c 65 64 20 6f ee page pulled o
1d820 66 66 20 74 68 65 20 66 72 65 65 20 6c 69 73 74 ff the free list
1d830 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 .. **.
1d840 20 2a 2a 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 ** On the other
1d850 20 68 61 6e 64 2c 20 69 66 20 62 43 6f 6d 6d 69 hand, if bCommi
1d860 74 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 t is greater tha
1d870 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 6b 65 65 n zero, then kee
1d880 70 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 6f 70 69 p. ** loopi
1d890 6e 67 20 75 6e 74 69 6c 20 61 20 66 72 65 65 2d ng until a free-
1d8a0 70 61 67 65 20 6c 6f 63 61 74 65 64 20 77 69 74 page located wit
1d8b0 68 69 6e 20 74 68 65 20 66 69 72 73 74 20 6e 46 hin the first nF
1d8c0 69 6e 20 70 61 67 65 73 0a 20 20 20 20 20 20 2a in pages. *
1d8d0 2a 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 73 * of the file is
1d8e0 20 66 6f 75 6e 64 2e 0a 20 20 20 20 20 20 2a 2f found.. */
1d8f0 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f 6d 6d . if( bComm
1d900 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 it==0 ){.
1d910 20 65 4d 6f 64 65 20 3d 20 42 54 41 4c 4c 4f 43 eMode = BTALLOC
1d920 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 69 4e 65 _LE;. iNe
1d930 61 72 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 20 ar = nFin;.
1d940 20 7d 0a 20 20 20 20 20 20 64 6f 20 7b 0a 20 20 }. do {.
1d950 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 MemPage *p
1d960 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 20 20 FreePg;.
1d970 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 rc = allocateBtr
1d980 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 46 72 eePage(pBt, &pFr
1d990 65 65 50 67 2c 20 26 69 46 72 65 65 50 67 2c 20 eePg, &iFreePg,
1d9a0 69 4e 65 61 72 2c 20 65 4d 6f 64 65 29 3b 0a 20 iNear, eMode);.
1d9b0 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 if( rc!=S
1d9c0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1d9d0 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
1d9e0 65 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 20 e(pLastPg);.
1d9f0 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
1da00 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
1da10 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
1da20 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 20 7d FreePg);. }
1da30 77 68 69 6c 65 28 20 62 43 6f 6d 6d 69 74 20 26 while( bCommit &
1da40 26 20 69 46 72 65 65 50 67 3e 6e 46 69 6e 20 29 & iFreePg>nFin )
1da50 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
1da60 69 46 72 65 65 50 67 3c 69 4c 61 73 74 50 67 20 iFreePg<iLastPg
1da70 29 3b 0a 20 20 20 20 20 20 0a 20 20 20 20 20 20 );. .
1da80 72 63 20 3d 20 72 65 6c 6f 63 61 74 65 50 61 67 rc = relocatePag
1da90 65 28 70 42 74 2c 20 70 4c 61 73 74 50 67 2c 20 e(pBt, pLastPg,
1daa0 65 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 2c eType, iPtrPage,
1dab0 20 69 46 72 65 65 50 67 2c 20 62 43 6f 6d 6d 69 iFreePg, bCommi
1dac0 74 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 t);. releas
1dad0 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b 0a ePage(pLastPg);.
1dae0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
1daf0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1db00 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1db10 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
1db20 0a 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d 3d . if( bCommit==
1db30 30 20 29 7b 0a 20 20 20 20 64 6f 20 7b 0a 20 20 0 ){. do {.
1db40 20 20 20 20 69 4c 61 73 74 50 67 2d 2d 3b 0a 20 iLastPg--;.
1db50 20 20 20 7d 77 68 69 6c 65 28 20 69 4c 61 73 74 }while( iLast
1db60 50 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 Pg==PENDING_BYTE
1db70 5f 50 41 47 45 28 70 42 74 29 20 7c 7c 20 50 54 _PAGE(pBt) || PT
1db80 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c RMAP_ISPAGE(pBt,
1db90 20 69 4c 61 73 74 50 67 29 20 29 3b 0a 20 20 20 iLastPg) );.
1dba0 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 pBt->bDoTruncat
1dbb0 65 20 3d 20 31 3b 0a 20 20 20 20 70 42 74 2d 3e e = 1;. pBt->
1dbc0 6e 50 61 67 65 20 3d 20 69 4c 61 73 74 50 67 3b nPage = iLastPg;
1dbd0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
1dbe0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
1dbf0 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 6f * The database o
1dc00 70 65 6e 65 64 20 62 79 20 74 68 65 20 66 69 72 pened by the fir
1dc10 73 74 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 st argument is a
1dc20 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 20 64 61 n auto-vacuum da
1dc30 74 61 62 61 73 65 0a 2a 2a 20 6e 4f 72 69 67 20 tabase.** nOrig
1dc40 70 61 67 65 73 20 69 6e 20 73 69 7a 65 20 63 6f pages in size co
1dc50 6e 74 61 69 6e 69 6e 67 20 6e 46 72 65 65 20 66 ntaining nFree f
1dc60 72 65 65 20 70 61 67 65 73 2e 20 52 65 74 75 72 ree pages. Retur
1dc70 6e 20 74 68 65 20 65 78 70 65 63 74 65 64 20 0a n the expected .
1dc80 2a 2a 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 ** size of the d
1dc90 61 74 61 62 61 73 65 20 69 6e 20 70 61 67 65 73 atabase in pages
1dca0 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 6e 20 61 75 following an au
1dcb0 74 6f 2d 76 61 63 75 75 6d 20 6f 70 65 72 61 74 to-vacuum operat
1dcc0 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 ion..*/.static P
1dcd0 67 6e 6f 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 gno finalDbSize(
1dce0 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
1dcf0 67 6e 6f 20 6e 4f 72 69 67 2c 20 50 67 6e 6f 20 gno nOrig, Pgno
1dd00 6e 46 72 65 65 29 7b 0a 20 20 69 6e 74 20 6e 45 nFree){. int nE
1dd10 6e 74 72 79 3b 20 20 20 20 20 20 20 20 20 20 20 ntry;
1dd20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1dd30 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 6f ber of entries o
1dd40 6e 20 6f 6e 65 20 70 74 72 6d 61 70 20 70 61 67 n one ptrmap pag
1dd50 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 50 74 72 e */. Pgno nPtr
1dd60 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 map;
1dd70 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1dd80 20 6f 66 20 50 74 72 4d 61 70 20 70 61 67 65 73 of PtrMap pages
1dd90 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f 0a to be freed */.
1dda0 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 20 20 Pgno nFin;
1ddb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ddc0 20 20 2f 2a 20 52 65 74 75 72 6e 20 76 61 6c 75 /* Return valu
1ddd0 65 20 2a 2f 0a 0a 20 20 6e 45 6e 74 72 79 20 3d e */.. nEntry =
1dde0 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
1ddf0 2f 35 3b 0a 20 20 6e 50 74 72 6d 61 70 20 3d 20 /5;. nPtrmap =
1de00 28 6e 46 72 65 65 2d 6e 4f 72 69 67 2b 50 54 52 (nFree-nOrig+PTR
1de10 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
1de20 6e 4f 72 69 67 29 2b 6e 45 6e 74 72 79 29 2f 6e nOrig)+nEntry)/n
1de30 45 6e 74 72 79 3b 0a 20 20 6e 46 69 6e 20 3d 20 Entry;. nFin =
1de40 6e 4f 72 69 67 20 2d 20 6e 46 72 65 65 20 2d 20 nOrig - nFree -
1de50 6e 50 74 72 6d 61 70 3b 0a 20 20 69 66 28 20 6e nPtrmap;. if( n
1de60 4f 72 69 67 3e 50 45 4e 44 49 4e 47 5f 42 59 54 Orig>PENDING_BYT
1de70 45 5f 50 41 47 45 28 70 42 74 29 20 26 26 20 6e E_PAGE(pBt) && n
1de80 46 69 6e 3c 50 45 4e 44 49 4e 47 5f 42 59 54 45 Fin<PENDING_BYTE
1de90 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 _PAGE(pBt) ){.
1dea0 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 20 20 nFin--;. }.
1deb0 77 68 69 6c 65 28 20 50 54 52 4d 41 50 5f 49 53 while( PTRMAP_IS
1dec0 50 41 47 45 28 70 42 74 2c 20 6e 46 69 6e 29 20 PAGE(pBt, nFin)
1ded0 7c 7c 20 6e 46 69 6e 3d 3d 50 45 4e 44 49 4e 47 || nFin==PENDING
1dee0 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
1def0 29 7b 0a 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 ){. nFin--;.
1df00 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 6e 46 69 }.. return nFi
1df10 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 77 72 n;.}../*.** A wr
1df20 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
1df30 6d 75 73 74 20 62 65 20 6f 70 65 6e 65 64 20 62 must be opened b
1df40 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 68 efore calling th
1df50 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 is function..**
1df60 49 74 20 70 65 72 66 6f 72 6d 73 20 61 20 73 69 It performs a si
1df70 6e 67 6c 65 20 75 6e 69 74 20 6f 66 20 77 6f 72 ngle unit of wor
1df80 6b 20 74 6f 77 61 72 64 73 20 61 6e 20 69 6e 63 k towards an inc
1df90 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e remental vacuum.
1dfa0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e .**.** If the in
1dfb0 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
1dfc0 20 69 73 20 66 69 6e 69 73 68 65 64 20 61 66 74 is finished aft
1dfd0 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
1dfe0 20 68 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 51 4c has run,.** SQL
1dff0 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 75 ITE_DONE is retu
1e000 72 6e 65 64 2e 20 49 66 20 69 74 20 69 73 20 6e rned. If it is n
1e010 6f 74 20 66 69 6e 69 73 68 65 64 2c 20 62 75 74 ot finished, but
1e020 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 72 no error occurr
1e030 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b ed,.** SQLITE_OK
1e040 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
1e050 68 65 72 77 69 73 65 20 61 6e 20 53 51 4c 69 74 herwise an SQLit
1e060 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 0a 2a e error code. .*
1e070 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
1e080 65 65 49 6e 63 72 56 61 63 75 75 6d 28 42 74 72 eeIncrVacuum(Btr
1e090 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 ee *p){. int rc
1e0a0 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
1e0b0 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 20 73 t = p->pBt;.. s
1e0c0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1e0d0 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 (p);. assert( p
1e0e0 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
1e0f0 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 26 n==TRANS_WRITE &
1e100 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 & p->inTrans==TR
1e110 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 69 ANS_WRITE );. i
1e120 66 28 20 21 70 42 74 2d 3e 61 75 74 6f 56 61 63 f( !pBt->autoVac
1e130 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 uum ){. rc =
1e140 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d SQLITE_DONE;. }
1e150 65 6c 73 65 7b 0a 20 20 20 20 50 67 6e 6f 20 6e else{. Pgno n
1e160 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 65 Orig = btreePage
1e170 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 20 count(pBt);.
1e180 50 67 6e 6f 20 6e 46 72 65 65 20 3d 20 67 65 74 Pgno nFree = get
1e190 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 4byte(&pBt->pPag
1e1a0 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a e1->aData[36]);.
1e1b0 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 20 3d 20 Pgno nFin =
1e1c0 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 2c finalDbSize(pBt,
1e1d0 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b 0a nOrig, nFree);.
1e1e0 0a 20 20 20 20 69 66 28 20 6e 4f 72 69 67 3c 6e . if( nOrig<n
1e1f0 46 69 6e 20 29 7b 0a 20 20 20 20 20 20 72 63 20 Fin ){. rc
1e200 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
1e210 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 65 _BKPT;. }else
1e220 20 69 66 28 20 6e 46 72 65 65 3e 30 20 29 7b 0a if( nFree>0 ){.
1e230 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 41 rc = saveA
1e240 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 30 llCursors(pBt, 0
1e250 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 , 0);. if(
1e260 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1e270 0a 20 20 20 20 20 20 20 20 69 6e 76 61 6c 69 64 . invalid
1e280 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 ateAllOverflowCa
1e290 63 68 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 che(pBt);.
1e2a0 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 75 75 rc = incrVacuu
1e2b0 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 6e 2c mStep(pBt, nFin,
1e2c0 20 6e 4f 72 69 67 2c 20 30 29 3b 0a 20 20 20 20 nOrig, 0);.
1e2d0 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 }. if( rc
1e2e0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1e2f0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
1e300 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 42 te3PagerWrite(pB
1e310 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 t->pPage1->pDbPa
1e320 67 65 29 3b 0a 20 20 20 20 20 20 20 20 70 75 74 ge);. put
1e330 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 4byte(&pBt->pPag
1e340 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 70 e1->aData[28], p
1e350 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 Bt->nPage);.
1e360 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
1e370 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
1e380 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 7d _DONE;. }. }
1e390 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
1e3a0 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
1e3b0 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
1e3c0 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 his routine is c
1e3d0 61 6c 6c 65 64 20 70 72 69 6f 72 20 74 6f 20 73 alled prior to s
1e3e0 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 qlite3PagerCommi
1e3f0 74 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 t when a transac
1e400 74 69 6f 6e 0a 2a 2a 20 69 73 20 63 6f 6d 6d 69 tion.** is commi
1e410 74 74 65 64 20 66 6f 72 20 61 6e 20 61 75 74 6f tted for an auto
1e420 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 -vacuum database
1e430 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 ..**.** If SQLIT
1e440 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
1e450 2c 20 74 68 65 6e 20 2a 70 6e 54 72 75 6e 63 20 , then *pnTrunc
1e460 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6e 75 is set to the nu
1e470 6d 62 65 72 20 6f 66 20 70 61 67 65 73 0a 2a 2a mber of pages.**
1e480 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1e490 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 74 72 75 le should be tru
1e4a0 6e 63 61 74 65 64 20 74 6f 20 64 75 72 69 6e 67 ncated to during
1e4b0 20 74 68 65 20 63 6f 6d 6d 69 74 20 70 72 6f 63 the commit proc
1e4c0 65 73 73 2e 20 0a 2a 2a 20 69 2e 65 2e 20 74 68 ess. .** i.e. th
1e4d0 65 20 64 61 74 61 62 61 73 65 20 68 61 73 20 62 e database has b
1e4e0 65 65 6e 20 72 65 6f 72 67 61 6e 69 7a 65 64 20 een reorganized
1e4f0 73 6f 20 74 68 61 74 20 6f 6e 6c 79 20 74 68 65 so that only the
1e500 20 66 69 72 73 74 20 2a 70 6e 54 72 75 6e 63 0a first *pnTrunc.
1e510 2a 2a 20 70 61 67 65 73 20 61 72 65 20 69 6e 20 ** pages are in
1e520 75 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 use..*/.static i
1e530 6e 74 20 61 75 74 6f 56 61 63 75 75 6d 43 6f 6d nt autoVacuumCom
1e540 6d 69 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 mit(BtShared *pB
1e550 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 t){. int rc = S
1e560 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 67 65 QLITE_OK;. Page
1e570 72 20 2a 70 50 61 67 65 72 20 3d 20 70 42 74 2d r *pPager = pBt-
1e580 3e 70 50 61 67 65 72 3b 0a 20 20 56 56 41 5f 4f >pPager;. VVA_O
1e590 4e 4c 59 28 20 69 6e 74 20 6e 52 65 66 20 3d 20 NLY( int nRef =
1e5a0 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 sqlite3PagerRefc
1e5b0 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 20 29 0a ount(pPager); ).
1e5c0 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
1e5d0 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
1e5e0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 t->mutex) );. i
1e5f0 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 nvalidateAllOver
1e600 66 6c 6f 77 43 61 63 68 65 28 70 42 74 29 3b 0a flowCache(pBt);.
1e610 20 20 61 73 73 65 72 74 28 70 42 74 2d 3e 61 75 assert(pBt->au
1e620 74 6f 56 61 63 75 75 6d 29 3b 0a 20 20 69 66 28 toVacuum);. if(
1e630 20 21 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 !pBt->incrVacuu
1e640 6d 20 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 46 m ){. Pgno nF
1e650 69 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e in; /* N
1e660 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 umber of pages i
1e670 6e 20 64 61 74 61 62 61 73 65 20 61 66 74 65 72 n database after
1e680 20 61 75 74 6f 76 61 63 75 75 6d 69 6e 67 20 2a autovacuuming *
1e690 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 46 72 65 65 /. Pgno nFree
1e6a0 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ; /* Numb
1e6b0 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 er of pages on t
1e6c0 68 65 20 66 72 65 65 6c 69 73 74 20 69 6e 69 74 he freelist init
1e6d0 69 61 6c 6c 79 20 2a 2f 0a 20 20 20 20 50 67 6e ially */. Pgn
1e6e0 6f 20 69 46 72 65 65 3b 20 20 20 20 20 20 20 20 o iFree;
1e6f0 2f 2a 20 54 68 65 20 6e 65 78 74 20 70 61 67 65 /* The next page
1e700 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f 0a to be freed */.
1e710 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 3b 20 Pgno nOrig;
1e720 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
1e730 73 65 20 73 69 7a 65 20 62 65 66 6f 72 65 20 66 se size before f
1e740 72 65 65 69 6e 67 20 2a 2f 0a 0a 20 20 20 20 6e reeing */.. n
1e750 4f 72 69 67 20 3d 20 62 74 72 65 65 50 61 67 65 Orig = btreePage
1e760 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 20 20 count(pBt);.
1e770 69 66 28 20 50 54 52 4d 41 50 5f 49 53 50 41 47 if( PTRMAP_ISPAG
1e780 45 28 70 42 74 2c 20 6e 4f 72 69 67 29 20 7c 7c E(pBt, nOrig) ||
1e790 20 6e 4f 72 69 67 3d 3d 50 45 4e 44 49 4e 47 5f nOrig==PENDING_
1e7a0 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 BYTE_PAGE(pBt) )
1e7b0 7b 0a 20 20 20 20 20 20 2f 2a 20 49 74 20 69 73 {. /* It is
1e7c0 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f not possible to
1e7d0 20 63 72 65 61 74 65 20 61 20 64 61 74 61 62 61 create a databa
1e7e0 73 65 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 se for which the
1e7f0 20 66 69 6e 61 6c 20 70 61 67 65 0a 20 20 20 20 final page.
1e800 20 20 2a 2a 20 69 73 20 65 69 74 68 65 72 20 61 ** is either a
1e810 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 pointer-map pag
1e820 65 20 6f 72 20 74 68 65 20 70 65 6e 64 69 6e 67 e or the pending
1e830 2d 62 79 74 65 20 70 61 67 65 2e 20 49 66 20 6f -byte page. If o
1e840 6e 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 65 ne. ** is e
1e850 6e 63 6f 75 6e 74 65 72 65 64 2c 20 74 68 69 73 ncountered, this
1e860 20 69 6e 64 69 63 61 74 65 73 20 63 6f 72 72 75 indicates corru
1e870 70 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a ption.. */.
1e880 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
1e890 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
1e8a0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 6e 46 72 ;. }.. nFr
1e8b0 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 ee = get4byte(&p
1e8c0 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 Bt->pPage1->aDat
1e8d0 61 5b 33 36 5d 29 3b 0a 20 20 20 20 6e 46 69 6e a[36]);. nFin
1e8e0 20 3d 20 66 69 6e 61 6c 44 62 53 69 7a 65 28 70 = finalDbSize(p
1e8f0 42 74 2c 20 6e 4f 72 69 67 2c 20 6e 46 72 65 65 Bt, nOrig, nFree
1e900 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 6e 3e );. if( nFin>
1e910 6e 4f 72 69 67 20 29 20 72 65 74 75 72 6e 20 53 nOrig ) return S
1e920 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
1e930 50 54 3b 0a 20 20 20 20 69 66 28 20 6e 46 69 6e PT;. if( nFin
1e940 3c 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 20 <nOrig ){.
1e950 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 73 rc = saveAllCurs
1e960 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a ors(pBt, 0, 0);.
1e970 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 46 }. for(iF
1e980 72 65 65 3d 6e 4f 72 69 67 3b 20 69 46 72 65 65 ree=nOrig; iFree
1e990 3e 6e 46 69 6e 20 26 26 20 72 63 3d 3d 53 51 4c >nFin && rc==SQL
1e9a0 49 54 45 5f 4f 4b 3b 20 69 46 72 65 65 2d 2d 29 ITE_OK; iFree--)
1e9b0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 69 6e 63 {. rc = inc
1e9c0 72 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 2c rVacuumStep(pBt,
1e9d0 20 6e 46 69 6e 2c 20 69 46 72 65 65 2c 20 31 29 nFin, iFree, 1)
1e9e0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
1e9f0 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 (rc==SQLITE_DONE
1ea00 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f || rc==SQLITE_O
1ea10 4b 29 20 26 26 20 6e 46 72 65 65 3e 30 20 29 7b K) && nFree>0 ){
1ea20 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
1ea30 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 42 te3PagerWrite(pB
1ea40 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 t->pPage1->pDbPa
1ea50 67 65 29 3b 0a 20 20 20 20 20 20 70 75 74 34 62 ge);. put4b
1ea60 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 yte(&pBt->pPage1
1ea70 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 30 29 3b ->aData[32], 0);
1ea80 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 . put4byte(
1ea90 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 &pBt->pPage1->aD
1eaa0 61 74 61 5b 33 36 5d 2c 20 30 29 3b 0a 20 20 20 ata[36], 0);.
1eab0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 42 74 put4byte(&pBt
1eac0 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b ->pPage1->aData[
1ead0 32 38 5d 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 20 28], nFin);.
1eae0 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 pBt->bDoTrunca
1eaf0 74 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 70 42 te = 1;. pB
1eb00 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 46 69 6e 3b t->nPage = nFin;
1eb10 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
1eb20 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1eb30 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
1eb40 65 72 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65 erRollback(pPage
1eb50 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 r);. }. }..
1eb60 20 61 73 73 65 72 74 28 20 6e 52 65 66 3e 3d 73 assert( nRef>=s
1eb70 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 63 6f qlite3PagerRefco
1eb80 75 6e 74 28 70 50 61 67 65 72 29 20 29 3b 0a 20 unt(pPager) );.
1eb90 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 return rc;.}..#
1eba0 65 6c 73 65 20 2f 2a 20 69 66 6e 64 65 66 20 53 else /* ifndef S
1ebb0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
1ebc0 41 43 55 55 4d 20 2a 2f 0a 23 20 64 65 66 69 6e ACUUM */.# defin
1ebd0 65 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 70 e setChildPtrmap
1ebe0 73 28 78 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 s(x) SQLITE_OK.#
1ebf0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 endif../*.** Thi
1ec00 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 s routine does t
1ec10 68 65 20 66 69 72 73 74 20 70 68 61 73 65 20 6f he first phase o
1ec20 66 20 61 20 74 77 6f 2d 70 68 61 73 65 20 63 6f f a two-phase co
1ec30 6d 6d 69 74 2e 20 20 54 68 69 73 20 72 6f 75 74 mmit. This rout
1ec40 69 6e 65 0a 2a 2a 20 63 61 75 73 65 73 20 61 20 ine.** causes a
1ec50 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
1ec60 20 74 6f 20 62 65 20 63 72 65 61 74 65 64 20 28 to be created (
1ec70 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20 61 if it does not a
1ec80 6c 72 65 61 64 79 20 65 78 69 73 74 29 0a 2a 2a lready exist).**
1ec90 20 61 6e 64 20 70 6f 70 75 6c 61 74 65 64 20 77 and populated w
1eca0 69 74 68 20 65 6e 6f 75 67 68 20 69 6e 66 6f 72 ith enough infor
1ecb0 6d 61 74 69 6f 6e 20 73 6f 20 74 68 61 74 20 69 mation so that i
1ecc0 66 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 6f f a power loss o
1ecd0 63 63 75 72 73 0a 2a 2a 20 74 68 65 20 64 61 74 ccurs.** the dat
1ece0 61 62 61 73 65 20 63 61 6e 20 62 65 20 72 65 73 abase can be res
1ecf0 74 6f 72 65 64 20 74 6f 20 69 74 73 20 6f 72 69 tored to its ori
1ed00 67 69 6e 61 6c 20 73 74 61 74 65 20 62 79 20 70 ginal state by p
1ed10 6c 61 79 69 6e 67 20 62 61 63 6b 0a 2a 2a 20 74 laying back.** t
1ed20 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 65 he journal. The
1ed30 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f n the contents o
1ed40 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 72 f the journal ar
1ed50 65 20 66 6c 75 73 68 65 64 20 6f 75 74 20 74 6f e flushed out to
1ed60 0a 2a 2a 20 74 68 65 20 64 69 73 6b 2e 20 20 41 .** the disk. A
1ed70 66 74 65 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c fter the journal
1ed80 20 69 73 20 73 61 66 65 6c 79 20 6f 6e 20 6f 78 is safely on ox
1ed90 69 64 65 2c 20 74 68 65 20 63 68 61 6e 67 65 73 ide, the changes
1eda0 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 to the.** datab
1edb0 61 73 65 20 61 72 65 20 77 72 69 74 74 65 6e 20 ase are written
1edc0 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 into the databas
1edd0 65 20 66 69 6c 65 20 61 6e 64 20 66 6c 75 73 68 e file and flush
1ede0 65 64 20 74 6f 20 6f 78 69 64 65 2e 0a 2a 2a 20 ed to oxide..**
1edf0 41 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 At the end of th
1ee00 69 73 20 63 61 6c 6c 2c 20 74 68 65 20 72 6f 6c is call, the rol
1ee10 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 73 74 lback journal st
1ee20 69 6c 6c 20 65 78 69 73 74 73 20 6f 6e 20 74 68 ill exists on th
1ee30 65 0a 2a 2a 20 64 69 73 6b 20 61 6e 64 20 77 65 e.** disk and we
1ee40 20 61 72 65 20 73 74 69 6c 6c 20 68 6f 6c 64 69 are still holdi
1ee50 6e 67 20 61 6c 6c 20 6c 6f 63 6b 73 2c 20 73 6f ng all locks, so
1ee60 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
1ee70 20 68 61 73 20 6e 6f 74 0a 2a 2a 20 63 6f 6d 6d has not.** comm
1ee80 69 74 74 65 64 2e 20 20 53 65 65 20 73 71 6c 69 itted. See sqli
1ee90 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 te3BtreeCommitPh
1eea0 61 73 65 54 77 6f 28 29 20 66 6f 72 20 74 68 65 aseTwo() for the
1eeb0 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 6f 66 second phase of
1eec0 20 74 68 65 0a 2a 2a 20 63 6f 6d 6d 69 74 20 70 the.** commit p
1eed0 72 6f 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 rocess..**.** Th
1eee0 69 73 20 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d is call is a no-
1eef0 6f 70 20 69 66 20 6e 6f 20 77 72 69 74 65 2d 74 op if no write-t
1ef00 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 63 75 ransaction is cu
1ef10 72 72 65 6e 74 6c 79 20 61 63 74 69 76 65 20 6f rrently active o
1ef20 6e 20 70 42 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 n pBt..**.** Oth
1ef30 65 72 77 69 73 65 2c 20 73 79 6e 63 20 74 68 65 erwise, sync the
1ef40 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 66 database file f
1ef50 6f 72 20 74 68 65 20 62 74 72 65 65 20 70 42 74 or the btree pBt
1ef60 2e 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 73 . zMaster points
1ef70 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 61 6d 65 20 to.** the name
1ef80 6f 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 of a master jour
1ef90 6e 61 6c 20 66 69 6c 65 20 74 68 61 74 20 73 68 nal file that sh
1efa0 6f 75 6c 64 20 62 65 20 77 72 69 74 74 65 6e 20 ould be written
1efb0 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 69 6e 64 69 into the.** indi
1efc0 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66 vidual journal f
1efd0 69 6c 65 2c 20 6f 72 20 69 73 20 4e 55 4c 4c 2c ile, or is NULL,
1efe0 20 69 6e 64 69 63 61 74 69 6e 67 20 6e 6f 20 6d indicating no m
1eff0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
1f000 6c 65 20 0a 2a 2a 20 28 73 69 6e 67 6c 65 20 64 le .** (single d
1f010 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 74 atabase transact
1f020 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e ion)..**.** When
1f030 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 2c this is called,
1f040 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 the master jour
1f050 6e 61 6c 20 73 68 6f 75 6c 64 20 61 6c 72 65 61 nal should alrea
1f060 64 79 20 68 61 76 65 20 62 65 65 6e 0a 2a 2a 20 dy have been.**
1f070 63 72 65 61 74 65 64 2c 20 70 6f 70 75 6c 61 74 created, populat
1f080 65 64 20 77 69 74 68 20 74 68 69 73 20 6a 6f 75 ed with this jou
1f090 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 61 6e 64 rnal pointer and
1f0a0 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e synced to disk.
1f0b0 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 74 68 69 73 .**.** Once this
1f0c0 20 69 73 20 72 6f 75 74 69 6e 65 20 68 61 73 20 is routine has
1f0d0 72 65 74 75 72 6e 65 64 2c 20 74 68 65 20 6f 6e returned, the on
1f0e0 6c 79 20 74 68 69 6e 67 20 72 65 71 75 69 72 65 ly thing require
1f0f0 64 20 74 6f 20 63 6f 6d 6d 69 74 0a 2a 2a 20 74 d to commit.** t
1f100 68 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 he write-transac
1f110 74 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 64 61 tion for this da
1f120 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 74 tabase file is t
1f130 6f 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 o delete the jou
1f140 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c rnal..*/.int sql
1f150 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
1f160 68 61 73 65 4f 6e 65 28 42 74 72 65 65 20 2a 70 haseOne(Btree *p
1f170 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d , const char *zM
1f180 61 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 aster){. int rc
1f190 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1f1a0 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d if( p->inTrans==
1f1b0 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 TRANS_WRITE ){.
1f1c0 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 BtShared *pBt
1f1d0 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 73 = p->pBt;. s
1f1e0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1f1f0 28 70 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c (p);.#ifndef SQL
1f200 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
1f210 55 55 4d 0a 20 20 20 20 69 66 28 20 70 42 74 2d UUM. if( pBt-
1f220 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 >autoVacuum ){.
1f230 20 20 20 20 20 72 63 20 3d 20 61 75 74 6f 56 61 rc = autoVa
1f240 63 75 75 6d 43 6f 6d 6d 69 74 28 70 42 74 29 3b cuumCommit(pBt);
1f250 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
1f260 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1f270 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1f280 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 20 20 Leave(p);.
1f290 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
1f2a0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 }. }. i
1f2b0 66 28 20 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 f( pBt->bDoTrunc
1f2c0 61 74 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ate ){. sql
1f2d0 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 74 ite3PagerTruncat
1f2e0 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 50 61 67 eImage(pBt->pPag
1f2f0 65 72 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 3b er, pBt->nPage);
1f300 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
1f310 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1f320 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e gerCommitPhaseOn
1f330 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a e(pBt->pPager, z
1f340 4d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 20 Master, 0);.
1f350 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1f360 65 28 70 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 e(p);. }. retu
1f370 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1f380 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
1f390 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 62 6f 74 called from bot
1f3a0 68 20 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 h BtreeCommitPha
1f3b0 73 65 54 77 6f 28 29 20 61 6e 64 20 42 74 72 65 seTwo() and Btre
1f3c0 65 52 6f 6c 6c 62 61 63 6b 28 29 0a 2a 2a 20 61 eRollback().** a
1f3d0 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
1f3e0 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f of a transactio
1f3f0 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 n..*/.static voi
1f400 64 20 62 74 72 65 65 45 6e 64 54 72 61 6e 73 61 d btreeEndTransa
1f410 63 74 69 6f 6e 28 42 74 72 65 65 20 2a 70 29 7b ction(Btree *p){
1f420 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
1f430 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c = p->pBt;. sql
1f440 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62 ite3 *db = p->db
1f450 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
1f460 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 te3BtreeHoldsMut
1f470 65 78 28 70 29 20 29 3b 0a 0a 23 69 66 6e 64 65 ex(p) );..#ifnde
1f480 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
1f490 54 4f 56 41 43 55 55 4d 0a 20 20 70 42 74 2d 3e TOVACUUM. pBt->
1f4a0 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 30 3b bDoTruncate = 0;
1f4b0 0a 23 65 6e 64 69 66 0a 20 20 69 66 28 20 70 2d .#endif. if( p-
1f4c0 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f 4e >inTrans>TRANS_N
1f4d0 4f 4e 45 20 26 26 20 64 62 2d 3e 6e 56 64 62 65 ONE && db->nVdbe
1f4e0 52 65 61 64 3e 31 20 29 7b 0a 20 20 20 20 2f 2a Read>1 ){. /*
1f4f0 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6f 74 If there are ot
1f500 68 65 72 20 61 63 74 69 76 65 20 73 74 61 74 65 her active state
1f510 6d 65 6e 74 73 20 74 68 61 74 20 62 65 6c 6f 6e ments that belon
1f520 67 20 74 6f 20 74 68 69 73 20 64 61 74 61 62 61 g to this databa
1f530 73 65 0a 20 20 20 20 2a 2a 20 68 61 6e 64 6c 65 se. ** handle
1f540 2c 20 64 6f 77 6e 67 72 61 64 65 20 74 6f 20 61 , downgrade to a
1f550 20 72 65 61 64 2d 6f 6e 6c 79 20 74 72 61 6e 73 read-only trans
1f560 61 63 74 69 6f 6e 2e 20 54 68 65 20 6f 74 68 65 action. The othe
1f570 72 20 73 74 61 74 65 6d 65 6e 74 73 0a 20 20 20 r statements.
1f580 20 2a 2a 20 6d 61 79 20 73 74 69 6c 6c 20 62 65 ** may still be
1f590 20 72 65 61 64 69 6e 67 20 66 72 6f 6d 20 74 68 reading from th
1f5a0 65 20 64 61 74 61 62 61 73 65 2e 20 20 2a 2f 0a e database. */.
1f5b0 20 20 20 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c downgradeAll
1f5c0 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
1f5d0 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 20 70 2d Locks(p);. p-
1f5e0 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e 53 >inTrans = TRANS
1f5f0 5f 52 45 41 44 3b 0a 20 20 7d 65 6c 73 65 7b 0a _READ;. }else{.
1f600 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 68 61 /* If the ha
1f610 6e 64 6c 65 20 68 61 64 20 61 6e 79 20 6b 69 6e ndle had any kin
1f620 64 20 6f 66 20 74 72 61 6e 73 61 63 74 69 6f 6e d of transaction
1f630 20 6f 70 65 6e 2c 20 64 65 63 72 65 6d 65 6e 74 open, decrement
1f640 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 74 72 61 the . ** tra
1f650 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 6f nsaction count o
1f660 66 20 74 68 65 20 73 68 61 72 65 64 20 62 74 72 f the shared btr
1f670 65 65 2e 20 49 66 20 74 68 65 20 74 72 61 6e 73 ee. If the trans
1f680 61 63 74 69 6f 6e 20 63 6f 75 6e 74 20 0a 20 20 action count .
1f690 20 20 2a 2a 20 72 65 61 63 68 65 73 20 30 2c 20 ** reaches 0,
1f6a0 73 65 74 20 74 68 65 20 73 68 61 72 65 64 20 73 set the shared s
1f6b0 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f tate to TRANS_NO
1f6c0 4e 45 2e 20 54 68 65 20 75 6e 6c 6f 63 6b 42 74 NE. The unlockBt
1f6d0 72 65 65 49 66 55 6e 75 73 65 64 28 29 0a 20 20 reeIfUnused().
1f6e0 20 20 2a 2a 20 63 61 6c 6c 20 62 65 6c 6f 77 20 ** call below
1f6f0 77 69 6c 6c 20 75 6e 6c 6f 63 6b 20 74 68 65 20 will unlock the
1f700 70 61 67 65 72 2e 20 20 2a 2f 0a 20 20 20 20 69 pager. */. i
1f710 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 21 3d 54 f( p->inTrans!=T
1f720 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 RANS_NONE ){.
1f730 20 20 20 63 6c 65 61 72 41 6c 6c 53 68 61 72 65 clearAllShare
1f740 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 dCacheTableLocks
1f750 28 70 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e (p);. pBt->
1f760 6e 54 72 61 6e 73 61 63 74 69 6f 6e 2d 2d 3b 0a nTransaction--;.
1f770 20 20 20 20 20 20 69 66 28 20 30 3d 3d 70 42 74 if( 0==pBt
1f780 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 ->nTransaction )
1f790 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 69 {. pBt->i
1f7a0 6e 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 nTransaction = T
1f7b0 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 20 20 20 20 RANS_NONE;.
1f7c0 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a }. }.. /*
1f7d0 20 53 65 74 20 74 68 65 20 63 75 72 72 65 6e 74 Set the current
1f7e0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 61 transaction sta
1f7f0 74 65 20 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e 45 te to TRANS_NONE
1f800 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 and unlock the
1f810 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 69 66 . ** pager if
1f820 20 74 68 69 73 20 63 61 6c 6c 20 63 6c 6f 73 65 this call close
1f830 64 20 74 68 65 20 6f 6e 6c 79 20 72 65 61 64 20 d the only read
1f840 6f 72 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 or write transac
1f850 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 70 2d tion. */. p-
1f860 3e 69 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e 53 >inTrans = TRANS
1f870 5f 4e 4f 4e 45 3b 0a 20 20 20 20 75 6e 6c 6f 63 _NONE;. unloc
1f880 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 kBtreeIfUnused(p
1f890 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 Bt);. }.. btre
1f8a0 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 7d eIntegrity(p);.}
1f8b0 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 74 ../*.** Commit t
1f8c0 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 he transaction c
1f8d0 75 72 72 65 6e 74 6c 79 20 69 6e 20 70 72 6f 67 urrently in prog
1f8e0 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ress..**.** This
1f8f0 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 routine impleme
1f900 6e 74 73 20 74 68 65 20 73 65 63 6f 6e 64 20 70 nts the second p
1f910 68 61 73 65 20 6f 66 20 61 20 32 2d 70 68 61 73 hase of a 2-phas
1f920 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 65 0a 2a e commit. The.*
1f930 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f * sqlite3BtreeCo
1f940 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 20 72 mmitPhaseOne() r
1f950 6f 75 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 outine does the
1f960 66 69 72 73 74 20 70 68 61 73 65 20 61 6e 64 20 first phase and
1f970 73 68 6f 75 6c 64 0a 2a 2a 20 62 65 20 69 6e 76 should.** be inv
1f980 6f 6b 65 64 20 70 72 69 6f 72 20 74 6f 20 63 61 oked prior to ca
1f990 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 lling this routi
1f9a0 6e 65 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 ne. The sqlite3
1f9b0 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 BtreeCommitPhase
1f9c0 4f 6e 65 28 29 0a 2a 2a 20 72 6f 75 74 69 6e 65 One().** routine
1f9d0 20 64 69 64 20 61 6c 6c 20 74 68 65 20 77 6f 72 did all the wor
1f9e0 6b 20 6f 66 20 77 72 69 74 69 6e 67 20 69 6e 66 k of writing inf
1f9f0 6f 72 6d 61 74 69 6f 6e 20 6f 75 74 20 74 6f 20 ormation out to
1fa00 64 69 73 6b 20 61 6e 64 20 66 6c 75 73 68 69 6e disk and flushin
1fa10 67 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 g the.** content
1fa20 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 61 s so that they a
1fa30 72 65 20 77 72 69 74 74 65 6e 20 6f 6e 74 6f 20 re written onto
1fa40 74 68 65 20 64 69 73 6b 20 70 6c 61 74 74 65 72 the disk platter
1fa50 2e 20 20 41 6c 6c 20 74 68 69 73 0a 2a 2a 20 72 . All this.** r
1fa60 6f 75 74 69 6e 65 20 68 61 73 20 74 6f 20 64 6f outine has to do
1fa70 20 69 73 20 64 65 6c 65 74 65 20 6f 72 20 74 72 is delete or tr
1fa80 75 6e 63 61 74 65 20 6f 72 20 7a 65 72 6f 20 74 uncate or zero t
1fa90 68 65 20 68 65 61 64 65 72 20 69 6e 20 74 68 65 he header in the
1faa0 0a 2a 2a 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b .** the rollback
1fab0 20 6a 6f 75 72 6e 61 6c 20 28 77 68 69 63 68 20 journal (which
1fac0 63 61 75 73 65 73 20 74 68 65 20 74 72 61 6e 73 causes the trans
1fad0 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6d 6d 69 74 action to commit
1fae0 29 20 61 6e 64 0a 2a 2a 20 64 72 6f 70 20 6c 6f ) and.** drop lo
1faf0 63 6b 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 cks..**.** Norma
1fb00 6c 6c 79 2c 20 69 66 20 61 6e 20 65 72 72 6f 72 lly, if an error
1fb10 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 68 occurs while th
1fb20 65 20 70 61 67 65 72 20 6c 61 79 65 72 20 69 73 e pager layer is
1fb30 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 0a attempting to .
1fb40 2a 2a 20 66 69 6e 61 6c 69 7a 65 20 74 68 65 20 ** finalize the
1fb50 75 6e 64 65 72 6c 79 69 6e 67 20 6a 6f 75 72 6e underlying journ
1fb60 61 6c 20 66 69 6c 65 2c 20 74 68 69 73 20 66 75 al file, this fu
1fb70 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 61 nction returns a
1fb80 6e 20 65 72 72 6f 72 20 61 6e 64 0a 2a 2a 20 74 n error and.** t
1fb90 68 65 20 75 70 70 65 72 20 6c 61 79 65 72 20 77 he upper layer w
1fba0 69 6c 6c 20 61 74 74 65 6d 70 74 20 61 20 72 6f ill attempt a ro
1fbb0 6c 6c 62 61 63 6b 2e 20 48 6f 77 65 76 65 72 2c llback. However,
1fbc0 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 if the second a
1fbd0 72 67 75 6d 65 6e 74 0a 2a 2a 20 69 73 20 6e 6f rgument.** is no
1fbe0 6e 2d 7a 65 72 6f 20 74 68 65 6e 20 74 68 69 73 n-zero then this
1fbf0 20 62 2d 74 72 65 65 20 74 72 61 6e 73 61 63 74 b-tree transact
1fc00 69 6f 6e 20 69 73 20 70 61 72 74 20 6f 66 20 61 ion is part of a
1fc10 20 6d 75 6c 74 69 2d 66 69 6c 65 20 0a 2a 2a 20 multi-file .**
1fc20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 49 6e 20 transaction. In
1fc30 74 68 69 73 20 63 61 73 65 2c 20 74 68 65 20 74 this case, the t
1fc40 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 61 ransaction has a
1fc50 6c 72 65 61 64 79 20 62 65 65 6e 20 63 6f 6d 6d lready been comm
1fc60 69 74 74 65 64 20 0a 2a 2a 20 28 62 79 20 64 65 itted .** (by de
1fc70 6c 65 74 69 6e 67 20 61 20 6d 61 73 74 65 72 20 leting a master
1fc80 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 61 6e journal file) an
1fc90 64 20 74 68 65 20 63 61 6c 6c 65 72 20 77 69 6c d the caller wil
1fca0 6c 20 69 67 6e 6f 72 65 20 74 68 69 73 20 0a 2a l ignore this .*
1fcb0 2a 20 66 75 6e 63 74 69 6f 6e 73 20 72 65 74 75 * functions retu
1fcc0 72 6e 20 63 6f 64 65 2e 20 53 6f 2c 20 65 76 65 rn code. So, eve
1fcd0 6e 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 n if an error oc
1fce0 63 75 72 73 20 69 6e 20 74 68 65 20 70 61 67 65 curs in the page
1fcf0 72 20 6c 61 79 65 72 2c 0a 2a 2a 20 72 65 73 65 r layer,.** rese
1fd00 74 20 74 68 65 20 62 2d 74 72 65 65 20 6f 62 6a t the b-tree obj
1fd10 65 63 74 73 20 69 6e 74 65 72 6e 61 6c 20 73 74 ects internal st
1fd20 61 74 65 20 74 6f 20 69 6e 64 69 63 61 74 65 20 ate to indicate
1fd30 74 68 61 74 20 74 68 65 20 77 72 69 74 65 0a 2a that the write.*
1fd40 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 * transaction ha
1fd50 73 20 62 65 65 6e 20 63 6c 6f 73 65 64 2e 20 54 s been closed. T
1fd60 68 69 73 20 69 73 20 71 75 69 74 65 20 73 61 66 his is quite saf
1fd70 65 2c 20 61 73 20 74 68 65 20 70 61 67 65 72 20 e, as the pager
1fd80 77 69 6c 6c 20 68 61 76 65 0a 2a 2a 20 74 72 61 will have.** tra
1fd90 6e 73 69 74 69 6f 6e 65 64 20 74 6f 20 74 68 65 nsitioned to the
1fda0 20 65 72 72 6f 72 20 73 74 61 74 65 2e 0a 2a 2a error state..**
1fdb0 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c 20 72 65 .** This will re
1fdc0 6c 65 61 73 65 20 74 68 65 20 77 72 69 74 65 20 lease the write
1fdd0 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
1fde0 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 74 base file. If t
1fdf0 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 61 here.** are no a
1fe00 63 74 69 76 65 20 63 75 72 73 6f 72 73 2c 20 69 ctive cursors, i
1fe10 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 65 73 20 t also releases
1fe20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a the read lock..*
1fe30 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
1fe40 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f eeCommitPhaseTwo
1fe50 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 62 (Btree *p, int b
1fe60 43 6c 65 61 6e 75 70 29 7b 0a 0a 20 20 69 66 28 Cleanup){.. if(
1fe70 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 p->inTrans==TRA
1fe80 4e 53 5f 4e 4f 4e 45 20 29 20 72 65 74 75 72 6e NS_NONE ) return
1fe90 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 SQLITE_OK;. sq
1fea0 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
1feb0 70 29 3b 0a 20 20 62 74 72 65 65 49 6e 74 65 67 p);. btreeInteg
1fec0 72 69 74 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 rity(p);.. /* I
1fed0 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 61 73 f the handle has
1fee0 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 a write-transac
1fef0 74 69 6f 6e 20 6f 70 65 6e 2c 20 63 6f 6d 6d 69 tion open, commi
1ff00 74 20 74 68 65 20 73 68 61 72 65 64 2d 62 74 72 t the shared-btr
1ff10 65 65 73 20 0a 20 20 2a 2a 20 74 72 61 6e 73 61 ees . ** transa
1ff20 63 74 69 6f 6e 20 61 6e 64 20 73 65 74 20 74 68 ction and set th
1ff30 65 20 73 68 61 72 65 64 20 73 74 61 74 65 20 74 e shared state t
1ff40 6f 20 54 52 41 4e 53 5f 52 45 41 44 2e 0a 20 20 o TRANS_READ..
1ff50 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 */. if( p->inTr
1ff60 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
1ff70 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a ){. int rc;.
1ff80 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
1ff90 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 t = p->pBt;.
1ffa0 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 assert( pBt->inT
1ffb0 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
1ffc0 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 20 20 61 S_WRITE );. a
1ffd0 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 54 72 61 ssert( pBt->nTra
1ffe0 6e 73 61 63 74 69 6f 6e 3e 30 20 29 3b 0a 20 20 nsaction>0 );.
1fff0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
20000 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 gerCommitPhaseTw
20010 6f 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a o(pBt->pPager);.
20020 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
20030 54 45 5f 4f 4b 20 26 26 20 62 43 6c 65 61 6e 75 TE_OK && bCleanu
20040 70 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 p==0 ){. sq
20050 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
20060 70 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e p);. return
20070 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 rc;. }. p
20080 2d 3e 69 44 61 74 61 56 65 72 73 69 6f 6e 2d 2d ->iDataVersion--
20090 3b 20 20 2f 2a 20 43 6f 6d 70 65 6e 73 61 74 65 ; /* Compensate
200a0 20 66 6f 72 20 70 50 61 67 65 72 2d 3e 69 44 61 for pPager->iDa
200b0 74 61 56 65 72 73 69 6f 6e 2b 2b 3b 20 2a 2f 0a taVersion++; */.
200c0 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 pBt->inTrans
200d0 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 action = TRANS_R
200e0 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 43 6c EAD;. btreeCl
200f0 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 earHasContent(pB
20100 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 t);. }.. btree
20110 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 EndTransaction(p
20120 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
20130 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
20140 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
20150 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 6f 74 68 20 ../*.** Do both
20160 70 68 61 73 65 73 20 6f 66 20 61 20 63 6f 6d 6d phases of a comm
20170 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 it..*/.int sqlit
20180 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 42 74 e3BtreeCommit(Bt
20190 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 ree *p){. int r
201a0 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 c;. sqlite3Btre
201b0 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 20 eEnter(p);. rc
201c0 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f = sqlite3BtreeCo
201d0 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 2c 20 mmitPhaseOne(p,
201e0 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 0);. if( rc==SQ
201f0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
20200 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
20210 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70 CommitPhaseTwo(p
20220 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 , 0);. }. sqli
20230 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
20240 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
20250 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
20260 74 69 6e 65 20 73 65 74 73 20 74 68 65 20 73 74 tine sets the st
20270 61 74 65 20 74 6f 20 43 55 52 53 4f 52 5f 46 41 ate to CURSOR_FA
20280 55 4c 54 20 61 6e 64 20 74 68 65 20 65 72 72 6f ULT and the erro
20290 72 0a 2a 2a 20 63 6f 64 65 20 74 6f 20 65 72 72 r.** code to err
202a0 43 6f 64 65 20 66 6f 72 20 65 76 65 72 79 20 63 Code for every c
202b0 75 72 73 6f 72 20 6f 6e 20 61 6e 79 20 42 74 53 ursor on any BtS
202c0 68 61 72 65 64 20 74 68 61 74 20 70 42 74 72 65 hared that pBtre
202d0 65 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 2e e.** references.
202e0 20 20 4f 72 20 69 66 20 74 68 65 20 77 72 69 74 Or if the writ
202f0 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 65 eOnly flag is se
20300 74 20 74 6f 20 31 2c 20 74 68 65 6e 20 6f 6e 6c t to 1, then onl
20310 79 0a 2a 2a 20 74 72 69 70 20 77 72 69 74 65 20 y.** trip write
20320 63 75 72 73 6f 72 73 20 61 6e 64 20 6c 65 61 76 cursors and leav
20330 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 75 e read cursors u
20340 6e 63 68 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 nchanged..**.**
20350 45 76 65 72 79 20 63 75 72 73 6f 72 20 69 73 20 Every cursor is
20360 61 20 63 61 6e 64 69 64 61 74 65 20 74 6f 20 62 a candidate to b
20370 65 20 74 72 69 70 70 65 64 2c 20 69 6e 63 6c 75 e tripped, inclu
20380 64 69 6e 67 20 63 75 72 73 6f 72 73 0a 2a 2a 20 ding cursors.**
20390 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 6f that belong to o
203a0 74 68 65 72 20 64 61 74 61 62 61 73 65 20 63 6f ther database co
203b0 6e 6e 65 63 74 69 6f 6e 73 20 74 68 61 74 20 68 nnections that h
203c0 61 70 70 65 6e 20 74 6f 20 62 65 0a 2a 2a 20 73 appen to be.** s
203d0 68 61 72 69 6e 67 20 74 68 65 20 63 61 63 68 65 haring the cache
203e0 20 77 69 74 68 20 70 42 74 72 65 65 2e 0a 2a 2a with pBtree..**
203f0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
20400 20 67 65 74 73 20 63 61 6c 6c 65 64 20 77 68 65 gets called whe
20410 6e 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 n a rollback occ
20420 75 72 73 2e 20 49 66 20 74 68 65 20 77 72 69 74 urs. If the writ
20430 65 4f 6e 6c 79 0a 2a 2a 20 66 6c 61 67 20 69 73 eOnly.** flag is
20440 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e 6c 79 true, then only
20450 20 77 72 69 74 65 2d 63 75 72 73 6f 72 73 20 6e write-cursors n
20460 65 65 64 20 62 65 20 74 72 69 70 70 65 64 20 2d eed be tripped -
20470 20 72 65 61 64 2d 6f 6e 6c 79 0a 2a 2a 20 63 75 read-only.** cu
20480 72 73 6f 72 73 20 73 61 76 65 20 74 68 65 69 72 rsors save their
20490 20 63 75 72 72 65 6e 74 20 70 6f 73 69 74 69 6f current positio
204a0 6e 73 20 73 6f 20 74 68 61 74 20 74 68 65 79 20 ns so that they
204b0 6d 61 79 20 63 6f 6e 74 69 6e 75 65 20 0a 2a 2a may continue .**
204c0 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 65 20 72 following the r
204d0 6f 6c 6c 62 61 63 6b 2e 20 4f 72 2c 20 69 66 20 ollback. Or, if
204e0 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c writeOnly is fal
204f0 73 65 2c 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 se, all cursors
20500 61 72 65 20 0a 2a 2a 20 74 72 69 70 70 65 64 2e are .** tripped.
20510 20 49 6e 20 67 65 6e 65 72 61 6c 2c 20 77 72 69 In general, wri
20520 74 65 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 20 teOnly is false
20530 69 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 if the transacti
20540 6f 6e 20 62 65 69 6e 67 0a 2a 2a 20 72 6f 6c 6c on being.** roll
20550 65 64 20 62 61 63 6b 20 6d 6f 64 69 66 69 65 64 ed back modified
20560 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 the database sc
20570 68 65 6d 61 2e 20 49 6e 20 74 68 69 73 20 63 61 hema. In this ca
20580 73 65 20 62 2d 74 72 65 65 20 72 6f 6f 74 0a 2a se b-tree root.*
20590 2a 20 70 61 67 65 73 20 6d 61 79 20 62 65 20 6d * pages may be m
205a0 6f 76 65 64 20 6f 72 20 64 65 6c 65 74 65 64 20 oved or deleted
205b0 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
205c0 65 20 61 6c 74 6f 67 65 74 68 65 72 2c 20 6d 61 e altogether, ma
205d0 6b 69 6e 67 0a 2a 2a 20 69 74 20 75 6e 73 61 66 king.** it unsaf
205e0 65 20 66 6f 72 20 72 65 61 64 20 63 75 72 73 6f e for read curso
205f0 72 73 20 74 6f 20 63 6f 6e 74 69 6e 75 65 2e 0a rs to continue..
20600 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 77 72 69 **.** If the wri
20610 74 65 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 74 teOnly flag is t
20620 72 75 65 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 rue and an error
20630 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 is encountered
20640 77 68 69 6c 65 20 0a 2a 2a 20 73 61 76 69 6e 67 while .** saving
20650 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 6f 73 the current pos
20660 69 74 69 6f 6e 20 6f 66 20 61 20 72 65 61 64 2d ition of a read-
20670 6f 6e 6c 79 20 63 75 72 73 6f 72 2c 20 61 6c 6c only cursor, all
20680 20 63 75 72 73 6f 72 73 2c 20 0a 2a 2a 20 69 6e cursors, .** in
20690 63 6c 75 64 69 6e 67 20 61 6c 6c 20 72 65 61 64 cluding all read
206a0 2d 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 69 -cursors are tri
206b0 70 70 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 pped..**.** SQLI
206c0 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 TE_OK is returne
206d0 64 20 69 66 20 73 75 63 63 65 73 73 66 75 6c 2c d if successful,
206e0 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 or if an error
206f0 6f 63 63 75 72 73 20 77 68 69 6c 65 0a 2a 2a 20 occurs while.**
20700 73 61 76 69 6e 67 20 61 20 63 75 72 73 6f 72 20 saving a cursor
20710 70 6f 73 69 74 69 6f 6e 2c 20 61 6e 20 53 51 4c position, an SQL
20720 69 74 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a ite error code..
20730 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
20740 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 reeTripAllCursor
20750 73 28 42 74 72 65 65 20 2a 70 42 74 72 65 65 2c s(Btree *pBtree,
20760 20 69 6e 74 20 65 72 72 43 6f 64 65 2c 20 69 6e int errCode, in
20770 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b 0a 20 20 t writeOnly){.
20780 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 69 BtCursor *p;. i
20790 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
207a0 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 28 77 K;.. assert( (w
207b0 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 77 riteOnly==0 || w
207c0 72 69 74 65 4f 6e 6c 79 3d 3d 31 29 20 26 26 20 riteOnly==1) &&
207d0 42 54 43 46 5f 57 72 69 74 65 46 6c 61 67 3d 3d BTCF_WriteFlag==
207e0 31 20 29 3b 0a 20 20 69 66 28 20 70 42 74 72 65 1 );. if( pBtre
207f0 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 e ){. sqlite3
20800 42 74 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 BtreeEnter(pBtre
20810 65 29 3b 0a 20 20 20 20 66 6f 72 28 70 3d 70 42 e);. for(p=pB
20820 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 75 72 73 tree->pBt->pCurs
20830 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 or; p; p=p->pNex
20840 74 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b t){. int i;
20850 0a 20 20 20 20 20 20 69 66 28 20 77 72 69 74 65 . if( write
20860 4f 6e 6c 79 20 26 26 20 28 70 2d 3e 63 75 72 46 Only && (p->curF
20870 6c 61 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 lags & BTCF_Writ
20880 65 46 6c 61 67 29 3d 3d 30 20 29 7b 0a 20 20 20 eFlag)==0 ){.
20890 20 20 20 20 20 69 66 28 20 70 2d 3e 65 53 74 61 if( p->eSta
208a0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
208b0 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 || p->eState==C
208c0 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 URSOR_SKIPNEXT )
208d0 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d {. rc =
208e0 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 saveCursorPosit
208f0 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 20 20 20 ion(p);.
20900 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
20910 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
20920 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 (void)sqlite3
20930 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 BtreeTripAllCurs
20940 6f 72 73 28 70 42 74 72 65 65 2c 20 72 63 2c 20 ors(pBtree, rc,
20950 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 0);.
20960 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 break;.
20970 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
20980 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
20990 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c sqlite3BtreeCl
209a0 65 61 72 43 75 72 73 6f 72 28 70 29 3b 0a 20 20 earCursor(p);.
209b0 20 20 20 20 20 20 70 2d 3e 65 53 74 61 74 65 20 p->eState
209c0 3d 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 3b 0a = CURSOR_FAULT;.
209d0 20 20 20 20 20 20 20 20 70 2d 3e 73 6b 69 70 4e p->skipN
209e0 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b 0a 20 ext = errCode;.
209f0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 6f 72 }. for
20a00 28 69 3d 30 3b 20 69 3c 3d 70 2d 3e 69 50 61 67 (i=0; i<=p->iPag
20a10 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 e; i++){.
20a20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 2d 3e releasePage(p->
20a30 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 20 apPage[i]);.
20a40 20 20 20 20 70 2d 3e 61 70 50 61 67 65 5b 69 5d p->apPage[i]
20a50 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 0;. }.
20a60 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 }. sqlite3B
20a70 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 treeLeave(pBtree
20a80 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
20a90 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c rc;.}../*.** Rol
20aa0 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 61 lback the transa
20ab0 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 ction in progres
20ac0 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 72 69 70 s..**.** If trip
20ad0 43 6f 64 65 20 69 73 20 6e 6f 74 20 53 51 4c 49 Code is not SQLI
20ae0 54 45 5f 4f 4b 20 74 68 65 6e 20 63 75 72 73 6f TE_OK then curso
20af0 72 73 20 77 69 6c 6c 20 62 65 20 69 6e 76 61 6c rs will be inval
20b00 69 64 61 74 65 64 20 28 74 72 69 70 70 65 64 29 idated (tripped)
20b10 2e 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 74 65 20 ..** Only write
20b20 63 75 72 73 6f 72 73 20 61 72 65 20 74 72 69 70 cursors are trip
20b30 70 65 64 20 69 66 20 77 72 69 74 65 4f 6e 6c 79 ped if writeOnly
20b40 20 69 73 20 74 72 75 65 20 62 75 74 20 61 6c 6c is true but all
20b50 20 63 75 72 73 6f 72 73 20 61 72 65 0a 2a 2a 20 cursors are.**
20b60 74 72 69 70 70 65 64 20 69 66 20 77 72 69 74 65 tripped if write
20b70 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 2e 20 20 Only is false.
20b80 41 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 75 Any attempt to u
20b90 73 65 0a 2a 2a 20 61 20 74 72 69 70 70 65 64 20 se.** a tripped
20ba0 63 75 72 73 6f 72 20 77 69 6c 6c 20 72 65 73 75 cursor will resu
20bb0 6c 74 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e 0a lt in an error..
20bc0 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c 20 **.** This will
20bd0 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 74 release the writ
20be0 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 e lock on the da
20bf0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
20c00 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f there.** are no
20c10 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 2c active cursors,
20c20 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 65 it also release
20c30 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e s the read lock.
20c40 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
20c50 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 74 72 treeRollback(Btr
20c60 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 70 43 ee *p, int tripC
20c70 6f 64 65 2c 20 69 6e 74 20 77 72 69 74 65 4f 6e ode, int writeOn
20c80 6c 79 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ly){. int rc;.
20c90 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
20ca0 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d 50 61 p->pBt;. MemPa
20cb0 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 20 61 ge *pPage1;.. a
20cc0 73 73 65 72 74 28 20 77 72 69 74 65 4f 6e 6c 79 ssert( writeOnly
20cd0 3d 3d 31 20 7c 7c 20 77 72 69 74 65 4f 6e 6c 79 ==1 || writeOnly
20ce0 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
20cf0 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c 49 54 tripCode==SQLIT
20d00 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b E_ABORT_ROLLBACK
20d10 20 7c 7c 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 || tripCode==SQ
20d20 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 73 71 6c LITE_OK );. sql
20d30 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
20d40 29 3b 0a 20 20 69 66 28 20 74 72 69 70 43 6f 64 );. if( tripCod
20d50 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a e==SQLITE_OK ){.
20d60 20 20 20 20 72 63 20 3d 20 74 72 69 70 43 6f 64 rc = tripCod
20d70 65 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 73 6f e = saveAllCurso
20d80 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a 20 rs(pBt, 0, 0);.
20d90 20 20 20 69 66 28 20 72 63 20 29 20 77 72 69 74 if( rc ) writ
20da0 65 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 7d 65 6c eOnly = 0;. }el
20db0 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c se{. rc = SQL
20dc0 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 ITE_OK;. }. if
20dd0 28 20 74 72 69 70 43 6f 64 65 20 29 7b 0a 20 20 ( tripCode ){.
20de0 20 20 69 6e 74 20 72 63 32 20 3d 20 73 71 6c 69 int rc2 = sqli
20df0 74 65 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 te3BtreeTripAllC
20e00 75 72 73 6f 72 73 28 70 2c 20 74 72 69 70 43 6f ursors(p, tripCo
20e10 64 65 2c 20 77 72 69 74 65 4f 6e 6c 79 29 3b 0a de, writeOnly);.
20e20 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d assert( rc==
20e30 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 77 72 SQLITE_OK || (wr
20e40 69 74 65 4f 6e 6c 79 3d 3d 30 20 26 26 20 72 63 iteOnly==0 && rc
20e50 32 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 29 3b 2==SQLITE_OK) );
20e60 0a 20 20 20 20 69 66 28 20 72 63 32 21 3d 53 51 . if( rc2!=SQ
20e70 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d 20 72 LITE_OK ) rc = r
20e80 63 32 3b 0a 20 20 7d 0a 20 20 62 74 72 65 65 49 c2;. }. btreeI
20e90 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 ntegrity(p);..
20ea0 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d if( p->inTrans==
20eb0 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 TRANS_WRITE ){.
20ec0 20 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 20 20 int rc2;..
20ed0 20 61 73 73 65 72 74 28 20 54 52 41 4e 53 5f 57 assert( TRANS_W
20ee0 52 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 72 61 RITE==pBt->inTra
20ef0 6e 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 20 20 nsaction );.
20f00 72 63 32 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc2 = sqlite3Pag
20f10 65 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 2d 3e erRollback(pBt->
20f20 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 pPager);. if(
20f30 20 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 rc2!=SQLITE_OK
20f40 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 63 ){. rc = rc
20f50 32 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 2;. }.. /*
20f60 20 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6d 61 The rollback ma
20f70 79 20 68 61 76 65 20 64 65 73 74 72 6f 79 65 64 y have destroyed
20f80 20 74 68 65 20 70 50 61 67 65 31 2d 3e 61 44 61 the pPage1->aDa
20f90 74 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a 20 20 ta value. So.
20fa0 20 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 65 47 ** call btreeG
20fb0 65 74 50 61 67 65 28 29 20 6f 6e 20 70 61 67 65 etPage() on page
20fc0 20 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 6b 65 1 again to make
20fd0 0a 20 20 20 20 2a 2a 20 73 75 72 65 20 70 50 61 . ** sure pPa
20fe0 67 65 31 2d 3e 61 44 61 74 61 20 69 73 20 73 65 ge1->aData is se
20ff0 74 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a 2f 0a t correctly. */.
21000 20 20 20 20 69 66 28 20 62 74 72 65 65 47 65 74 if( btreeGet
21010 50 61 67 65 28 70 42 74 2c 20 31 2c 20 26 70 50 Page(pBt, 1, &pP
21020 61 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 54 45 age1, 0)==SQLITE
21030 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 _OK ){. int
21040 20 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 nPage = get4byt
21050 65 28 32 38 2b 28 75 38 2a 29 70 50 61 67 65 31 e(28+(u8*)pPage1
21060 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 ->aData);.
21070 74 65 73 74 63 61 73 65 28 20 6e 50 61 67 65 3d testcase( nPage=
21080 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 =0 );. if(
21090 6e 50 61 67 65 3d 3d 30 20 29 20 73 71 6c 69 74 nPage==0 ) sqlit
210a0 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 e3PagerPagecount
210b0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 6e (pBt->pPager, &n
210c0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 74 65 73 Page);. tes
210d0 74 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 61 67 tcase( pBt->nPag
210e0 65 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 20 20 e!=nPage );.
210f0 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e pBt->nPage = n
21100 50 61 67 65 3b 0a 20 20 20 20 20 20 72 65 6c 65 Page;. rele
21110 61 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b asePage(pPage1);
21120 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 . }. asser
21130 74 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 t( countValidCur
21140 73 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d 30 20 sors(pBt, 1)==0
21150 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 );. pBt->inTr
21160 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e ansaction = TRAN
21170 53 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 S_READ;. btre
21180 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 eClearHasContent
21190 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 (pBt);. }.. bt
211a0 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f reeEndTransactio
211b0 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 n(p);. sqlite3B
211c0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
211d0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
211e0 0a 2a 2a 20 53 74 61 72 74 20 61 20 73 74 61 74 .** Start a stat
211f0 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 ement subtransac
21200 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 61 tion. The subtra
21210 6e 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 nsaction can be
21220 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 69 rolled.** back i
21230 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 ndependently of
21240 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 63 the main transac
21250 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 73 tion. You must s
21260 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 74 69 tart a transacti
21270 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 74 on .** before st
21280 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 61 6e arting a subtran
21290 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 saction. The sub
212a0 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 transaction is e
212b0 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c nded automatical
212c0 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d 61 ly .** if the ma
212d0 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 in transaction c
212e0 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 20 ommits or rolls
212f0 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 back..**.** Stat
21300 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 ement subtransac
21310 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 61 tions are used a
21320 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 61 6c round individual
21330 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a SQL statements.
21340 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f 6e 74 ** that are cont
21350 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 20 42 ained within a B
21360 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 6c EGIN...COMMIT bl
21370 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 74 ock. If a const
21380 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 6f raint.** error o
21390 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 ccurs within the
213a0 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 20 statement, the
213b0 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 20 6f effect of that o
213c0 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 ne statement.**
213d0 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 can be rolled ba
213e0 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e ck without havin
213f0 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 g to rollback th
21400 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 e entire transac
21410 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 74 tion..**.** A st
21420 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 6e atement sub-tran
21430 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65 saction is imple
21440 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 6e 6f mented as an ano
21450 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 nymous savepoint
21460 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 70 . The.** value p
21470 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 assed as the sec
21480 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 ond parameter is
21490 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 the total numbe
214a0 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 2c r of savepoints,
214b0 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 .** including th
214c0 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 20 e new anonymous
214d0 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e 20 savepoint, open
214e0 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e 20 69 on the B-Tree. i
214f0 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 .e. if there.**
21500 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 73 61 are no active sa
21510 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f 20 vepoints and no
21520 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 2d other statement-
21530 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 65 transactions ope
21540 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e 74 n,.** iStatement
21550 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e 6f 6e is 1. This anon
21560 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 20 ymous savepoint
21570 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 64 20 can be released
21580 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 2a or rolled back.*
21590 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 * using the sqli
215a0 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e te3BtreeSavepoin
215b0 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f t() function..*/
215c0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
215d0 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 65 65 eBeginStmt(Btree
215e0 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 65 6d *p, int iStatem
215f0 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a ent){. int rc;.
21600 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
21610 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 = p->pBt;. sqli
21620 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
21630 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 ;. assert( p->i
21640 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 nTrans==TRANS_WR
21650 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ITE );. assert(
21660 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
21670 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 & BTS_READ_ONLY)
21680 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
21690 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 3b iStatement>0 );
216a0 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 74 . assert( iStat
216b0 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 61 ement>p->db->nSa
216c0 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 73 vepoint );. ass
216d0 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e ert( pBt->inTran
216e0 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 saction==TRANS_W
216f0 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 20 RITE );. /* At
21700 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 6c 2c the pager level,
21710 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 a statement tra
21720 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 73 61 nsaction is a sa
21730 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 2a vepoint with. *
21740 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 61 74 * an index great
21750 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 65 er than all save
21760 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 20 65 points created e
21770 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 0a xplicitly using.
21780 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 ** SQL stateme
21790 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 67 nts. It is illeg
217a0 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c 65 al to open, rele
217b0 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 ase or rollback
217c0 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 61 any. ** such sa
217d0 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 74 vepoints while t
217e0 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 he statement tra
217f0 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 nsaction savepoi
21800 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a 20 20 nt is active..
21810 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
21820 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 3PagerOpenSavepo
21830 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c int(pBt->pPager,
21840 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 20 iStatement);.
21850 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
21860 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
21870 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 c;.}../*.** The
21880 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 second argument
21890 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e to this function
218a0 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 20 , op, is always
218b0 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 SAVEPOINT_ROLLBA
218c0 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f 49 CK.** or SAVEPOI
218d0 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 73 NT_RELEASE. This
218e0 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 72 function either
218f0 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 6f 6c releases or rol
21900 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 73 ls back the.** s
21910 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 66 avepoint identif
21920 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 ied by parameter
21930 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 70 iSavepoint, dep
21940 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 ending on the va
21950 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a 2a lue .** of op..*
21960 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 *.** Normally, i
21970 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 72 65 Savepoint is gre
21980 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 ater than or equ
21990 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 65 al to zero. Howe
219a0 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a 2a ver, if op is.**
219b0 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 SAVEPOINT_ROLLB
219c0 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 70 ACK, then iSavep
219d0 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 oint may also be
219e0 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 61 73 -1. In this cas
219f0 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e e the .** conten
21a00 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 ts of the entire
21a10 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 transaction are
21a20 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 rolled back. Th
21a30 69 73 20 69 73 20 64 69 66 66 65 72 65 6e 74 0a is is different.
21a40 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c ** from a normal
21a50 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c transaction rol
21a60 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f 63 lback, as no loc
21a70 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 20 ks are released
21a80 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 and the.** trans
21a90 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 6f action remains o
21aa0 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 pen..*/.int sqli
21ab0 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e te3BtreeSavepoin
21ac0 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 t(Btree *p, int
21ad0 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 6f 69 op, int iSavepoi
21ae0 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 nt){. int rc =
21af0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 SQLITE_OK;. if(
21b00 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 p && p->inTrans
21b10 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b ==TRANS_WRITE ){
21b20 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 . BtShared *p
21b30 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 Bt = p->pBt;.
21b40 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 56 assert( op==SAV
21b50 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 7c EPOINT_RELEASE |
21b60 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 5f | op==SAVEPOINT_
21b70 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 20 ROLLBACK );.
21b80 61 73 73 65 72 74 28 20 69 53 61 76 65 70 6f 69 assert( iSavepoi
21b90 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 70 nt>=0 || (iSavep
21ba0 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d 3d oint==-1 && op==
21bb0 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 SAVEPOINT_ROLLBA
21bc0 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 CK) );. sqlit
21bd0 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
21be0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
21bf0 33 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 28 3PagerSavepoint(
21c00 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6f 70 2c pBt->pPager, op,
21c10 20 69 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 iSavepoint);.
21c20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
21c30 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 _OK ){. if(
21c40 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 iSavepoint<0 &&
21c50 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
21c60 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f & BTS_INITIALLY_
21c70 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 EMPTY)!=0 ){.
21c80 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 pBt->nPage
21c90 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 = 0;. }.
21ca0 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 rc = newDatab
21cb0 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 ase(pBt);.
21cc0 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 pBt->nPage = get
21cd0 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 4byte(28 + pBt->
21ce0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a pPage1->aData);.
21cf0 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 . /* The da
21d00 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 20 tabase size was
21d10 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
21d20 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 74 68 offset 28 of th
21d30 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 20 2a e header. *
21d40 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 * when the trans
21d50 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 action started,
21d60 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 so we know that
21d70 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f 66 66 the value at off
21d80 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 set. ** 28
21d90 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 is nonzero. */.
21da0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 assert( pBt
21db0 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 ->nPage>0 );.
21dc0 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 }. sqlite3Bt
21dd0 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d reeLeave(p);. }
21de0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
21df0 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 ./*.** Create a
21e00 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 20 74 new cursor for t
21e10 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 20 72 he BTree whose r
21e20 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 70 61 oot is on the pa
21e30 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 ge.** iTable. If
21e40 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 a read-only cur
21e50 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 sor is requested
21e60 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 64 20 , it is assumed
21e70 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c that.** the call
21e80 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 er already has a
21e90 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 2d 6f t least a read-o
21ea0 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 nly transaction
21eb0 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 open.** on the d
21ec0 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 79 2e atabase already.
21ed0 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 72 73 If a write-curs
21ee0 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 2c or is requested,
21ef0 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c then.** the cal
21f00 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 20 74 ler is assumed t
21f10 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 o have an open w
21f20 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
21f30 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 42 ..**.** If the B
21f40 54 52 45 45 5f 57 52 43 53 52 20 62 69 74 20 6f TREE_WRCSR bit o
21f50 66 20 77 72 46 6c 61 67 20 69 73 20 63 6c 65 61 f wrFlag is clea
21f60 72 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 r, then the curs
21f70 6f 72 20 63 61 6e 20 6f 6e 6c 79 0a 2a 2a 20 62 or can only.** b
21f80 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 64 69 e used for readi
21f90 6e 67 2e 20 20 49 66 20 74 68 65 20 42 54 52 45 ng. If the BTRE
21fa0 45 5f 57 52 43 53 52 20 62 69 74 20 69 73 20 73 E_WRCSR bit is s
21fb0 65 74 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 et, then the cur
21fc0 73 6f 72 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 sor.** can be us
21fd0 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f ed for reading o
21fe0 72 20 66 6f 72 20 77 72 69 74 69 6e 67 20 69 66 r for writing if
21ff0 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e other condition
22000 73 20 66 6f 72 20 77 72 69 74 69 6e 67 0a 2a 2a s for writing.**
22010 20 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 are also met.
22020 54 68 65 73 65 20 61 72 65 20 74 68 65 20 63 6f These are the co
22030 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 nditions that mu
22040 73 74 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 st be met in ord
22050 65 72 0a 2a 2a 20 66 6f 72 20 77 72 69 74 69 6e er.** for writin
22060 67 20 74 6f 20 62 65 20 61 6c 6c 6f 77 65 64 3a g to be allowed:
22070 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 .**.** 1: The c
22080 75 72 73 6f 72 20 6d 75 73 74 20 68 61 76 65 20 ursor must have
22090 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 been opened with
220a0 20 77 72 46 6c 61 67 20 63 6f 6e 74 61 69 6e 69 wrFlag containi
220b0 6e 67 20 42 54 52 45 45 5f 57 52 43 53 52 0a 2a ng BTREE_WRCSR.*
220c0 2a 0a 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 *.** 2: Other d
220d0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
220e0 6f 6e 73 20 74 68 61 74 20 73 68 61 72 65 20 74 ons that share t
220f0 68 65 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 he same pager ca
22100 63 68 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 che.** but w
22110 68 69 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 hich are not in
22120 74 68 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 the READ_UNCOMMI
22130 54 54 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e TTED state may n
22140 6f 74 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 ot have.** c
22150 75 72 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 ursors open with
22160 20 77 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 wrFlag==0 on th
22170 65 20 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f e same table. O
22180 74 68 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 therwise.**
22190 74 68 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 the changes made
221a0 20 62 79 20 74 68 69 73 20 77 72 69 74 65 20 63 by this write c
221b0 75 72 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 ursor would be v
221c0 69 73 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 isible to.**
221d0 20 74 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 the read cursor
221e0 73 20 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 s in the other d
221f0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
22200 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 on..**.** 3: Th
22210 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 e database must
22220 62 65 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 be writable (not
22230 20 6f 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 on read-only me
22240 64 69 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 dia).**.** 4: T
22250 68 65 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 here must be an
22260 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 active transacti
22270 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 54 on..**.** The BT
22280 52 45 45 5f 46 4f 52 44 45 4c 45 54 45 20 62 69 REE_FORDELETE bi
22290 74 20 6f 66 20 77 72 46 6c 61 67 20 6d 61 79 20 t of wrFlag may
222a0 6f 70 74 69 6f 6e 61 6c 6c 79 20 62 65 20 73 65 optionally be se
222b0 74 20 69 66 20 42 54 52 45 45 5f 57 52 43 53 52 t if BTREE_WRCSR
222c0 0a 2a 2a 20 69 73 20 73 65 74 2e 20 20 49 66 20 .** is set. If
222d0 46 4f 52 44 45 4c 45 54 45 20 69 73 20 73 65 74 FORDELETE is set
222e0 2c 20 74 68 61 74 20 69 73 20 61 20 68 69 6e 74 , that is a hint
222f0 20 74 6f 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e to the implemen
22300 74 61 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 tation that.** t
22310 68 69 73 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 his cursor will
22320 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 74 6f 20 only be used to
22330 73 65 65 6b 20 74 6f 20 61 6e 64 20 64 65 6c 65 seek to and dele
22340 74 65 20 65 6e 74 72 69 65 73 20 6f 66 20 61 6e te entries of an
22350 20 69 6e 64 65 78 0a 2a 2a 20 61 73 20 70 61 72 index.** as par
22360 74 20 6f 66 20 61 20 6c 61 72 67 65 72 20 44 45 t of a larger DE
22370 4c 45 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 LETE statement.
22380 20 54 68 65 20 46 4f 52 44 45 4c 45 54 45 20 68 The FORDELETE h
22390 69 6e 74 20 69 73 20 6e 6f 74 20 75 73 65 64 20 int is not used
223a0 62 79 0a 2a 2a 20 74 68 69 73 20 69 6d 70 6c 65 by.** this imple
223b0 6d 65 6e 74 61 74 69 6f 6e 2e 20 20 42 75 74 20 mentation. But
223c0 69 6e 20 61 20 68 79 70 6f 74 68 65 74 69 63 61 in a hypothetica
223d0 6c 20 61 6c 74 65 72 6e 61 74 69 76 65 20 73 74 l alternative st
223e0 6f 72 61 67 65 20 65 6e 67 69 6e 65 20 0a 2a 2a orage engine .**
223f0 20 69 6e 20 77 68 69 63 68 20 69 6e 64 65 78 20 in which index
22400 65 6e 74 72 69 65 73 20 61 72 65 20 61 75 74 6f entries are auto
22410 6d 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 matically delete
22420 64 20 77 68 65 6e 20 63 6f 72 72 65 73 70 6f 6e d when correspon
22430 64 69 6e 67 20 74 61 62 6c 65 0a 2a 2a 20 72 6f ding table.** ro
22440 77 73 20 61 72 65 20 64 65 6c 65 74 65 64 2c 20 ws are deleted,
22450 74 68 65 20 46 4f 52 44 45 4c 45 54 45 20 66 6c the FORDELETE fl
22460 61 67 20 69 73 20 61 20 68 69 6e 74 20 74 68 61 ag is a hint tha
22470 74 20 61 6c 6c 20 53 45 45 4b 20 61 6e 64 20 44 t all SEEK and D
22480 45 4c 45 54 45 0a 2a 2a 20 6f 70 65 72 61 74 69 ELETE.** operati
22490 6f 6e 73 20 6f 6e 20 74 68 69 73 20 63 75 72 73 ons on this curs
224a0 6f 72 20 63 61 6e 20 62 65 20 6e 6f 2d 6f 70 73 or can be no-ops
224b0 20 61 6e 64 20 61 6c 6c 20 52 45 41 44 20 6f 70 and all READ op
224c0 65 72 61 74 69 6f 6e 73 20 63 61 6e 20 0a 2a 2a erations can .**
224d0 20 72 65 74 75 72 6e 20 61 20 6e 75 6c 6c 20 72 return a null r
224e0 6f 77 20 28 32 2d 62 79 74 65 73 3a 20 30 78 30 ow (2-bytes: 0x0
224f0 31 20 30 78 30 30 29 2e 0a 2a 2a 0a 2a 2a 20 4e 1 0x00)..**.** N
22500 6f 20 63 68 65 63 6b 69 6e 67 20 69 73 20 64 6f o checking is do
22510 6e 65 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 ne to make sure
22520 74 68 61 74 20 70 61 67 65 20 69 54 61 62 6c 65 that page iTable
22530 20 72 65 61 6c 6c 79 20 69 73 20 74 68 65 0a 2a really is the.*
22540 2a 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 * root page of a
22550 20 62 2d 74 72 65 65 2e 20 20 49 66 20 69 74 20 b-tree. If it
22560 69 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 is not, then the
22570 20 63 75 72 73 6f 72 20 61 63 71 75 69 72 65 64 cursor acquired
22580 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 .** will not wor
22590 6b 20 63 6f 72 72 65 63 74 6c 79 2e 0a 2a 2a 0a k correctly..**.
225a0 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 ** It is assumed
225b0 20 74 68 61 74 20 74 68 65 20 73 71 6c 69 74 65 that the sqlite
225c0 33 42 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 3BtreeCursorZero
225d0 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c () has been call
225e0 65 64 0a 2a 2a 20 6f 6e 20 70 43 75 72 20 74 6f ed.** on pCur to
225f0 20 69 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 initialize the
22600 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 70 72 69 memory space pri
22610 6f 72 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 or to invoking t
22620 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a his routine..*/.
22630 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 static int btree
22640 43 75 72 73 6f 72 28 0a 20 20 42 74 72 65 65 20 Cursor(. Btree
22650 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 *p,
22660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22670 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
22680 0a 20 20 69 6e 74 20 69 54 61 62 6c 65 2c 20 20 . int iTable,
22690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
226a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f /* Roo
226b0 74 20 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 t page of table
226c0 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 to open */. int
226d0 20 77 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 wrFlag,
226e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
226f0 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 /* 1 to writ
22700 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a e. 0 read-only *
22710 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 79 49 6e /. struct KeyIn
22720 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 fo *pKeyInfo,
22730 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
22740 72 73 74 20 61 72 67 20 74 6f 20 63 6f 6d 70 61 rst arg to compa
22750 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a rison function *
22760 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 /. BtCursor *pC
22770 75 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ur
22780 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 /* Sp
22790 61 63 65 20 66 6f 72 20 6e 65 77 20 63 75 72 73 ace for new curs
227a0 6f 72 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 or */.){. BtSha
227b0 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
227c0 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
227d0 20 20 2f 2a 20 53 68 61 72 65 64 20 62 2d 74 72 /* Shared b-tr
227e0 65 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 ee handle */. B
227f0 74 43 75 72 73 6f 72 20 2a 70 58 3b 20 20 20 20 tCursor *pX;
22800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22810 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 69 6e 67 /* Looping
22820 20 6f 76 65 72 20 6f 74 68 65 72 20 61 6c 6c 20 over other all
22830 63 75 72 73 6f 72 73 20 2a 2f 0a 0a 20 20 61 73 cursors */.. as
22840 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 sert( sqlite3Btr
22850 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 eeHoldsMutex(p)
22860 29 3b 0a 20 20 61 73 73 65 72 74 28 20 77 72 46 );. assert( wrF
22870 6c 61 67 3d 3d 30 20 0a 20 20 20 20 20 20 20 7c lag==0 . |
22880 7c 20 77 72 46 6c 61 67 3d 3d 42 54 52 45 45 5f | wrFlag==BTREE_
22890 57 52 43 53 52 20 0a 20 20 20 20 20 20 20 7c 7c WRCSR . ||
228a0 20 77 72 46 6c 61 67 3d 3d 28 42 54 52 45 45 5f wrFlag==(BTREE_
228b0 57 52 43 53 52 7c 42 54 52 45 45 5f 46 4f 52 44 WRCSR|BTREE_FORD
228c0 45 4c 45 54 45 29 20 0a 20 20 29 3b 0a 0a 20 20 ELETE) . );..
228d0 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
228e0 20 61 73 73 65 72 74 20 73 74 61 74 65 6d 65 6e assert statemen
228f0 74 73 20 76 65 72 69 66 79 20 74 68 61 74 20 69 ts verify that i
22900 66 20 74 68 69 73 20 69 73 20 61 20 73 68 61 72 f this is a shar
22910 61 62 6c 65 20 0a 20 20 2a 2a 20 62 2d 74 72 65 able . ** b-tre
22920 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 e database, the
22930 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f connection is ho
22940 6c 64 69 6e 67 20 74 68 65 20 72 65 71 75 69 72 lding the requir
22950 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 2c 20 ed table locks,
22960 0a 20 20 2a 2a 20 61 6e 64 20 74 68 61 74 20 6e . ** and that n
22970 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 o other connecti
22980 6f 6e 20 68 61 73 20 61 6e 79 20 6f 70 65 6e 20 on has any open
22990 63 75 72 73 6f 72 20 74 68 61 74 20 63 6f 6e 66 cursor that conf
229a0 6c 69 63 74 73 20 77 69 74 68 20 0a 20 20 2a 2a licts with . **
229b0 20 74 68 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f 0a this lock. */.
229c0 20 20 61 73 73 65 72 74 28 20 68 61 73 53 68 61 assert( hasSha
229d0 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
229e0 6b 28 70 2c 20 69 54 61 62 6c 65 2c 20 70 4b 65 k(p, iTable, pKe
229f0 79 49 6e 66 6f 21 3d 30 2c 20 28 77 72 46 6c 61 yInfo!=0, (wrFla
22a00 67 3f 32 3a 31 29 29 20 29 3b 0a 20 20 61 73 73 g?2:1)) );. ass
22a10 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
22a20 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 | !hasReadConfli
22a30 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 20 29 cts(p, iTable) )
22a40 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 74 ;.. /* Assert t
22a50 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68 hat the caller h
22a60 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 72 65 as opened the re
22a70 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 74 69 quired transacti
22a80 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 on. */. assert(
22a90 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e p->inTrans>TRAN
22aa0 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 S_NONE );. asse
22ab0 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c rt( wrFlag==0 ||
22ac0 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 p->inTrans==TRA
22ad0 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 73 NS_WRITE );. as
22ae0 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 65 sert( pBt->pPage
22af0 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 1 && pBt->pPage1
22b00 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 61 73 73 ->aData );. ass
22b10 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
22b20 7c 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 | (pBt->btsFlags
22b30 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 & BTS_READ_ONLY
22b40 29 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 77 )==0 );.. if( w
22b50 72 46 6c 61 67 20 29 7b 0a 20 20 20 20 61 6c 6c rFlag ){. all
22b60 6f 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 70 ocateTempSpace(p
22b70 42 74 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 Bt);. if( pBt
22b80 2d 3e 70 54 6d 70 53 70 61 63 65 3d 3d 30 20 29 ->pTmpSpace==0 )
22b90 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
22ba0 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 OMEM_BKPT;. }.
22bb0 20 69 66 28 20 69 54 61 62 6c 65 3d 3d 31 20 26 if( iTable==1 &
22bc0 26 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 & btreePagecount
22bd0 28 70 42 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 (pBt)==0 ){.
22be0 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d assert( wrFlag==
22bf0 30 20 29 3b 0a 20 20 20 20 69 54 61 62 6c 65 20 0 );. iTable
22c00 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e = 0;. }.. /* N
22c10 6f 77 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 ow that no other
22c20 20 65 72 72 6f 72 73 20 63 61 6e 20 6f 63 63 75 errors can occu
22c30 72 2c 20 66 69 6e 69 73 68 20 66 69 6c 6c 69 6e r, finish fillin
22c40 67 20 69 6e 20 74 68 65 20 42 74 43 75 72 73 6f g in the BtCurso
22c50 72 0a 20 20 2a 2a 20 76 61 72 69 61 62 6c 65 73 r. ** variables
22c60 20 61 6e 64 20 6c 69 6e 6b 20 74 68 65 20 63 75 and link the cu
22c70 72 73 6f 72 20 69 6e 74 6f 20 74 68 65 20 42 74 rsor into the Bt
22c80 53 68 61 72 65 64 20 6c 69 73 74 2e 20 20 2a 2f Shared list. */
22c90 0a 20 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f . pCur->pgnoRoo
22ca0 74 20 3d 20 28 50 67 6e 6f 29 69 54 61 62 6c 65 t = (Pgno)iTable
22cb0 3b 0a 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 ;. pCur->iPage
22cc0 3d 20 2d 31 3b 0a 20 20 70 43 75 72 2d 3e 70 4b = -1;. pCur->pK
22cd0 65 79 49 6e 66 6f 20 3d 20 70 4b 65 79 49 6e 66 eyInfo = pKeyInf
22ce0 6f 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 72 65 o;. pCur->pBtre
22cf0 65 20 3d 20 70 3b 0a 20 20 70 43 75 72 2d 3e 70 e = p;. pCur->p
22d00 42 74 20 3d 20 70 42 74 3b 0a 20 20 70 43 75 72 Bt = pBt;. pCur
22d10 2d 3e 63 75 72 46 6c 61 67 73 20 3d 20 77 72 46 ->curFlags = wrF
22d20 6c 61 67 20 3f 20 42 54 43 46 5f 57 72 69 74 65 lag ? BTCF_Write
22d30 46 6c 61 67 20 3a 20 30 3b 0a 20 20 70 43 75 72 Flag : 0;. pCur
22d40 2d 3e 63 75 72 50 61 67 65 72 46 6c 61 67 73 20 ->curPagerFlags
22d50 3d 20 77 72 46 6c 61 67 20 3f 20 30 20 3a 20 50 = wrFlag ? 0 : P
22d60 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c AGER_GET_READONL
22d70 59 3b 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 Y;. /* If there
22d80 20 61 72 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 are two or more
22d90 20 63 75 72 73 6f 72 73 20 6f 6e 20 74 68 65 20 cursors on the
22da0 73 61 6d 65 20 62 74 72 65 65 2c 20 74 68 65 6e same btree, then
22db0 20 61 6c 6c 20 73 75 63 68 0a 20 20 2a 2a 20 63 all such. ** c
22dc0 75 72 73 6f 72 73 20 2a 6d 75 73 74 2a 20 68 61 ursors *must* ha
22dd0 76 65 20 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 ve the BTCF_Mult
22de0 69 70 6c 65 20 66 6c 61 67 20 73 65 74 2e 20 2a iple flag set. *
22df0 2f 0a 20 20 66 6f 72 28 70 58 3d 70 42 74 2d 3e /. for(pX=pBt->
22e00 70 43 75 72 73 6f 72 3b 20 70 58 3b 20 70 58 3d pCursor; pX; pX=
22e10 70 58 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 pX->pNext){.
22e20 69 66 28 20 70 58 2d 3e 70 67 6e 6f 52 6f 6f 74 if( pX->pgnoRoot
22e30 3d 3d 28 50 67 6e 6f 29 69 54 61 62 6c 65 20 29 ==(Pgno)iTable )
22e40 7b 0a 20 20 20 20 20 20 70 58 2d 3e 63 75 72 46 {. pX->curF
22e50 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 4d 75 6c lags |= BTCF_Mul
22e60 74 69 70 6c 65 3b 0a 20 20 20 20 20 20 70 43 75 tiple;. pCu
22e70 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 r->curFlags |= B
22e80 54 43 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a 20 20 TCF_Multiple;.
22e90 20 20 7d 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e }. }. pCur->
22ea0 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 43 75 pNext = pBt->pCu
22eb0 72 73 6f 72 3b 0a 20 20 70 42 74 2d 3e 70 43 75 rsor;. pBt->pCu
22ec0 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 rsor = pCur;. p
22ed0 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
22ee0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
22ef0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
22f00 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 ;.}.int sqlite3B
22f10 74 72 65 65 43 75 72 73 6f 72 28 0a 20 20 42 74 treeCursor(. Bt
22f20 72 65 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 ree *p,
22f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
22f50 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 btree */. int
22f60 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 iTable,
22f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f80 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 /* Root
22f90 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f page of table to
22fa0 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 open */. int w
22fb0 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 rFlag,
22fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22fd0 20 20 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 /* 1 to w
22fe0 72 69 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c rite. 0 read-onl
22ff0 79 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 y */. struct Ke
23000 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c yInfo *pKeyInfo,
23010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23020 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 /* First arg
23030 74 6f 20 78 43 6f 6d 70 61 72 65 28 29 20 2a 2f to xCompare() */
23040 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
23050 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
23060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23070 2a 20 57 72 69 74 65 20 6e 65 77 20 63 75 72 73 * Write new curs
23080 6f 72 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 or here */.){.
23090 69 6e 74 20 72 63 3b 0a 20 20 69 66 28 20 69 54 int rc;. if( iT
230a0 61 62 6c 65 3c 31 20 29 7b 0a 20 20 20 20 72 63 able<1 ){. rc
230b0 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
230c0 54 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 7b T_BKPT;. }else{
230d0 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
230e0 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 20 20 72 eEnter(p);. r
230f0 63 20 3d 20 62 74 72 65 65 43 75 72 73 6f 72 28 c = btreeCursor(
23100 70 2c 20 69 54 61 62 6c 65 2c 20 77 72 46 6c 61 p, iTable, wrFla
23110 67 2c 20 70 4b 65 79 49 6e 66 6f 2c 20 70 43 75 g, pKeyInfo, pCu
23120 72 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 r);. sqlite3B
23130 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
23140 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
23150 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
23160 68 65 20 73 69 7a 65 20 6f 66 20 61 20 42 74 43 he size of a BtC
23170 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 ursor object in
23180 62 79 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 bytes..**.** Thi
23190 73 20 69 6e 74 65 72 66 61 63 65 73 20 69 73 20 s interfaces is
231a0 6e 65 65 64 65 64 20 73 6f 20 74 68 61 74 20 75 needed so that u
231b0 73 65 72 73 20 6f 66 20 63 75 72 73 6f 72 73 20 sers of cursors
231c0 63 61 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a can preallocate.
231d0 2a 2a 20 73 75 66 66 69 63 69 65 6e 74 20 73 74 ** sufficient st
231e0 6f 72 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 orage to hold a
231f0 63 75 72 73 6f 72 2e 20 20 54 68 65 20 42 74 43 cursor. The BtC
23200 75 72 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 ursor object is
23210 6f 70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 opaque.** to use
23220 72 73 20 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f rs so they canno
23230 74 20 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 t do the sizeof(
23240 29 20 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 ) themselves - t
23250 68 65 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a hey must call.**
23260 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a this routine..*
23270 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
23280 65 65 43 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 eeCursorSize(voi
23290 64 29 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 d){. return ROU
232a0 4e 44 38 28 73 69 7a 65 6f 66 28 42 74 43 75 72 ND8(sizeof(BtCur
232b0 73 6f 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 sor));.}../*.**
232c0 49 6e 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 Initialize memor
232d0 79 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 63 y that will be c
232e0 6f 6e 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 onverted into a
232f0 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e BtCursor object.
23300 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c .**.** The simpl
23310 65 20 61 70 70 72 6f 61 63 68 20 68 65 72 65 20 e approach here
23320 77 6f 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 would be to mems
23330 65 74 28 29 20 74 68 65 20 65 6e 74 69 72 65 20 et() the entire
23340 6f 62 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 object.** to zer
23350 6f 2e 20 20 42 75 74 20 69 74 20 74 75 72 6e 73 o. But it turns
23360 20 6f 75 74 20 74 68 61 74 20 74 68 65 20 61 70 out that the ap
23370 50 61 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 Page[] and aiIdx
23380 5b 5d 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 [] arrays.** do
23390 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 7a not need to be z
233a0 65 72 6f 65 64 20 61 6e 64 20 74 68 65 79 20 61 eroed and they a
233b0 72 65 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 re large, so we
233c0 63 61 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a can save a lot.*
233d0 2a 20 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 * of run-time by
233e0 20 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 6e skipping the in
233f0 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 itialization of
23400 74 68 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a those elements..
23410 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 */.void sqlite3B
23420 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 treeCursorZero(B
23430 74 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d tCursor *p){. m
23440 65 6d 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 emset(p, 0, offs
23450 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 69 etof(BtCursor, i
23460 50 61 67 65 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Page));.}../*.**
23470 20 43 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 2e Close a cursor.
23480 20 20 54 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 The read lock
23490 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
234a0 66 69 6c 65 20 69 73 20 72 65 6c 65 61 73 65 64 file is released
234b0 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 .** when the las
234c0 74 20 63 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 t cursor is clos
234d0 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
234e0 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 e3BtreeCloseCurs
234f0 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 or(BtCursor *pCu
23500 72 29 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 r){. Btree *pBt
23510 72 65 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 ree = pCur->pBtr
23520 65 65 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 ee;. if( pBtree
23530 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
23540 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 BtShared *pBt
23550 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 20 20 = pCur->pBt;.
23560 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
23570 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 20 ter(pBtree);.
23580 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 sqlite3BtreeCle
23590 61 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a arCursor(pCur);.
235a0 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
235b0 3e 70 43 75 72 73 6f 72 21 3d 30 20 29 3b 0a 20 >pCursor!=0 );.
235c0 20 20 20 69 66 28 20 70 42 74 2d 3e 70 43 75 72 if( pBt->pCur
235d0 73 6f 72 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 sor==pCur ){.
235e0 20 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 pBt->pCursor
235f0 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 = pCur->pNext;.
23600 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
23610 42 74 43 75 72 73 6f 72 20 2a 70 50 72 65 76 20 BtCursor *pPrev
23620 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
23630 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 do{.
23640 20 20 69 66 28 20 70 50 72 65 76 2d 3e 70 4e 65 if( pPrev->pNe
23650 78 74 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 20 xt==pCur ){.
23660 20 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e 65 pPrev->pNe
23670 78 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 xt = pCur->pNext
23680 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 ;. brea
23690 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 k;. }.
236a0 20 20 20 20 20 70 50 72 65 76 20 3d 20 70 50 72 pPrev = pPr
236b0 65 76 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 ev->pNext;.
236c0 20 7d 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 }while( ALWAYS(
236d0 70 50 72 65 76 29 20 29 3b 0a 20 20 20 20 7d 0a pPrev) );. }.
236e0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d for(i=0; i<=
236f0 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b pCur->iPage; i++
23700 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 ){. release
23710 50 61 67 65 28 70 43 75 72 2d 3e 61 70 50 61 67 Page(pCur->apPag
23720 65 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 e[i]);. }.
23730 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e unlockBtreeIfUn
23740 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 20 73 used(pBt);. s
23750 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 qlite3_free(pCur
23760 2d 3e 61 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 20 ->aOverflow);.
23770 20 20 2f 2a 20 73 71 6c 69 74 65 33 5f 66 72 65 /* sqlite3_fre
23780 65 28 70 43 75 72 29 3b 20 2a 2f 0a 20 20 20 20 e(pCur); */.
23790 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
237a0 65 28 70 42 74 72 65 65 29 3b 0a 20 20 7d 0a 20 e(pBtree);. }.
237b0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
237c0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 K;.}../*.** Make
237d0 20 73 75 72 65 20 74 68 65 20 42 74 43 75 72 73 sure the BtCurs
237e0 6f 72 2a 20 67 69 76 65 6e 20 69 6e 20 74 68 65 or* given in the
237f0 20 61 72 67 75 6d 65 6e 74 20 68 61 73 20 61 20 argument has a
23800 76 61 6c 69 64 0a 2a 2a 20 42 74 43 75 72 73 6f valid.** BtCurso
23810 72 2e 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 r.info structure
23820 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 . If it is not
23830 61 6c 72 65 61 64 79 20 76 61 6c 69 64 2c 20 63 already valid, c
23840 61 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 all.** btreePars
23850 65 43 65 6c 6c 28 29 20 74 6f 20 66 69 6c 6c 20 eCell() to fill
23860 69 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 43 it in..**.** BtC
23870 75 72 73 6f 72 2e 69 6e 66 6f 20 69 73 20 61 20 ursor.info is a
23880 63 61 63 68 65 20 6f 66 20 74 68 65 20 69 6e 66 cache of the inf
23890 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 ormation in the
238a0 63 75 72 72 65 6e 74 20 63 65 6c 6c 2e 0a 2a 2a current cell..**
238b0 20 55 73 69 6e 67 20 74 68 69 73 20 63 61 63 68 Using this cach
238c0 65 20 72 65 64 75 63 65 73 20 74 68 65 20 6e 75 e reduces the nu
238d0 6d 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 74 6f mber of calls to
238e0 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 btreeParseCell(
238f0 29 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 )..*/.#ifndef ND
23900 45 42 55 47 0a 20 20 73 74 61 74 69 63 20 76 6f EBUG. static vo
23910 69 64 20 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 id assertCellInf
23920 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 o(BtCursor *pCur
23930 29 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 ){. CellInfo
23940 69 6e 66 6f 3b 0a 20 20 20 20 69 6e 74 20 69 50 info;. int iP
23950 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 67 age = pCur->iPag
23960 65 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 69 e;. memset(&i
23970 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 6f 66 28 69 nfo, 0, sizeof(i
23980 6e 66 6f 29 29 3b 0a 20 20 20 20 62 74 72 65 65 nfo));. btree
23990 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e ParseCell(pCur->
239a0 61 70 50 61 67 65 5b 69 50 61 67 65 5d 2c 20 70 apPage[iPage], p
239b0 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 67 65 Cur->aiIdx[iPage
239c0 5d 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 61 ], &info);. a
239d0 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 ssert( CORRUPT_D
239e0 42 20 7c 7c 20 6d 65 6d 63 6d 70 28 26 69 6e 66 B || memcmp(&inf
239f0 6f 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 2c 20 o, &pCur->info,
23a00 73 69 7a 65 6f 66 28 69 6e 66 6f 29 29 3d 3d 30 sizeof(info))==0
23a10 20 29 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 );. }.#else.
23a20 23 64 65 66 69 6e 65 20 61 73 73 65 72 74 43 65 #define assertCe
23a30 6c 6c 49 6e 66 6f 28 78 29 0a 23 65 6e 64 69 66 llInfo(x).#endif
23a40 0a 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e .static SQLITE_N
23a50 4f 49 4e 4c 49 4e 45 20 76 6f 69 64 20 67 65 74 OINLINE void get
23a60 43 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f CellInfo(BtCurso
23a70 72 20 2a 70 43 75 72 29 7b 0a 20 20 69 66 28 20 r *pCur){. if(
23a80 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
23a90 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 ==0 ){. int i
23aa0 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 Page = pCur->iPa
23ab0 67 65 3b 0a 20 20 20 20 70 43 75 72 2d 3e 63 75 ge;. pCur->cu
23ac0 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 rFlags |= BTCF_V
23ad0 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 20 20 62 74 alidNKey;. bt
23ae0 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 reeParseCell(pCu
23af0 72 2d 3e 61 70 50 61 67 65 5b 69 50 61 67 65 5d r->apPage[iPage]
23b00 2c 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 ,pCur->aiIdx[iPa
23b10 67 65 5d 2c 26 70 43 75 72 2d 3e 69 6e 66 6f 29 ge],&pCur->info)
23b20 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 ;. }else{. a
23b30 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 ssertCellInfo(pC
23b40 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e ur);. }.}..#ifn
23b50 64 65 66 20 4e 44 45 42 55 47 20 20 2f 2a 20 54 def NDEBUG /* T
23b60 68 65 20 6e 65 78 74 20 72 6f 75 74 69 6e 65 20 he next routine
23b70 75 73 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e used only within
23b80 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
23b90 65 6e 74 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 65 ents */./*.** Re
23ba0 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 turn true if the
23bb0 20 67 69 76 65 6e 20 42 74 43 75 72 73 6f 72 20 given BtCursor
23bc0 69 73 20 76 61 6c 69 64 2e 20 20 41 20 76 61 6c is valid. A val
23bd0 69 64 20 63 75 72 73 6f 72 20 69 73 20 6f 6e 65 id cursor is one
23be0 0a 2a 2a 20 74 68 61 74 20 69 73 20 63 75 72 72 .** that is curr
23bf0 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 ently pointing t
23c00 6f 20 61 20 72 6f 77 20 69 6e 20 61 20 28 6e 6f o a row in a (no
23c10 6e 2d 65 6d 70 74 79 29 20 74 61 62 6c 65 2e 0a n-empty) table..
23c20 2a 2a 20 54 68 69 73 20 69 73 20 61 20 76 65 72 ** This is a ver
23c30 69 66 69 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e ification routin
23c40 65 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 77 e is used only w
23c50 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20 73 ithin assert() s
23c60 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 69 6e tatements..*/.in
23c70 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 t sqlite3BtreeCu
23c80 72 73 6f 72 49 73 56 61 6c 69 64 28 42 74 43 75 rsorIsValid(BtCu
23c90 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 rsor *pCur){. r
23ca0 65 74 75 72 6e 20 70 43 75 72 20 26 26 20 70 43 eturn pCur && pC
23cb0 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
23cc0 4f 52 5f 56 41 4c 49 44 3b 0a 7d 0a 23 65 6e 64 OR_VALID;.}.#end
23cd0 69 66 20 2f 2a 20 4e 44 45 42 55 47 20 2a 2f 0a if /* NDEBUG */.
23ce0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
23cf0 43 75 72 73 6f 72 49 73 56 61 6c 69 64 4e 4e 28 CursorIsValidNN(
23d00 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
23d10 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 21 . assert( pCur!
23d20 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 =0 );. return p
23d30 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
23d40 53 4f 52 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a SOR_VALID;.}../*
23d50 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 .** Return the v
23d60 61 6c 75 65 20 6f 66 20 74 68 65 20 69 6e 74 65 alue of the inte
23d70 67 65 72 20 6b 65 79 20 6f 72 20 22 72 6f 77 69 ger key or "rowi
23d80 64 22 20 66 6f 72 20 61 20 74 61 62 6c 65 20 62 d" for a table b
23d90 74 72 65 65 2e 0a 2a 2a 20 54 68 69 73 20 72 6f tree..** This ro
23da0 75 74 69 6e 65 20 69 73 20 6f 6e 6c 79 20 76 61 utine is only va
23db0 6c 69 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 lid for a cursor
23dc0 20 74 68 61 74 20 69 73 20 70 6f 69 6e 74 69 6e that is pointin
23dd0 67 20 69 6e 74 6f 20 61 0a 2a 2a 20 6f 72 64 69 g into a.** ordi
23de0 6e 61 72 79 20 74 61 62 6c 65 20 62 74 72 65 65 nary table btree
23df0 2e 20 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 . If the cursor
23e00 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 69 6e points to an in
23e10 64 65 78 20 62 74 72 65 65 20 6f 72 0a 2a 2a 20 dex btree or.**
23e20 69 73 20 69 6e 76 61 6c 69 64 2c 20 74 68 65 20 is invalid, the
23e30 72 65 73 75 6c 74 20 6f 66 20 74 68 69 73 20 72 result of this r
23e40 6f 75 74 69 6e 65 20 69 73 20 75 6e 64 65 66 69 outine is undefi
23e50 6e 65 64 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 ned..*/.i64 sqli
23e60 74 65 33 42 74 72 65 65 49 6e 74 65 67 65 72 4b te3BtreeIntegerK
23e70 65 79 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ey(BtCursor *pCu
23e80 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 r){. assert( cu
23e90 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
23ea0 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
23eb0 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
23ec0 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
23ed0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
23ee0 63 75 72 49 6e 74 4b 65 79 20 29 3b 0a 20 20 67 curIntKey );. g
23ef0 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 etCellInfo(pCur)
23f00 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d ;. return pCur-
23f10 3e 69 6e 66 6f 2e 6e 4b 65 79 3b 0a 7d 0a 0a 2f >info.nKey;.}../
23f20 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
23f30 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
23f40 6f 66 20 70 61 79 6c 6f 61 64 20 66 6f 72 20 74 of payload for t
23f50 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 70 43 he entry that pC
23f60 75 72 20 69 73 0a 2a 2a 20 63 75 72 72 65 6e 74 ur is.** current
23f70 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 ly pointing to.
23f80 20 46 6f 72 20 74 61 62 6c 65 20 62 74 72 65 65 For table btree
23f90 73 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 20 s, this will be
23fa0 74 68 65 20 61 6d 6f 75 6e 74 0a 2a 2a 20 6f 66 the amount.** of
23fb0 20 64 61 74 61 2e 20 20 46 6f 72 20 69 6e 64 65 data. For inde
23fc0 78 20 62 74 72 65 65 73 2c 20 74 68 69 73 20 77 x btrees, this w
23fd0 69 6c 6c 20 62 65 20 74 68 65 20 73 69 7a 65 20 ill be the size
23fe0 6f 66 20 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a of the key..**.*
23ff0 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 * The caller mus
24000 74 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 74 t guarantee that
24010 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 70 the cursor is p
24020 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 6e 6f 6e ointing to a non
24030 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 64 20 65 -NULL.** valid e
24040 6e 74 72 79 2e 20 20 49 6e 20 6f 74 68 65 72 20 ntry. In other
24050 77 6f 72 64 73 2c 20 74 68 65 20 63 61 6c 6c 69 words, the calli
24060 6e 67 20 70 72 6f 63 65 64 75 72 65 20 6d 75 73 ng procedure mus
24070 74 20 67 75 61 72 61 6e 74 65 65 0a 2a 2a 20 74 t guarantee.** t
24080 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 68 hat the cursor h
24090 61 73 20 43 75 72 73 6f 72 2e 65 53 74 61 74 65 as Cursor.eState
240a0 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e 0a ==CURSOR_VALID..
240b0 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 42 74 */.u32 sqlite3Bt
240c0 72 65 65 50 61 79 6c 6f 61 64 53 69 7a 65 28 42 reePayloadSize(B
240d0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
240e0 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
240f0 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
24100 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
24110 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
24120 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 67 65 OR_VALID );. ge
24130 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
24140 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e . return pCur->
24150 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a 7d info.nPayload;.}
24160 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 68 ../*.** Given th
24170 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 e page number of
24180 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
24190 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 e in the databas
241a0 65 20 28 70 61 72 61 6d 65 74 65 72 0a 2a 2a 20 e (parameter.**
241b0 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 75 6e 63 ovfl), this func
241c0 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 65 20 70 tion finds the p
241d0 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 age number of th
241e0 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 e next page in t
241f0 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 6c 69 he .** linked li
24200 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 70 st of overflow p
24210 61 67 65 73 2e 20 49 66 20 70 6f 73 73 69 62 6c ages. If possibl
24220 65 2c 20 69 74 20 75 73 65 73 20 74 68 65 20 61 e, it uses the a
24230 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 70 6f uto-vacuum.** po
24240 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 61 20 69 inter-map data i
24250 6e 73 74 65 61 64 20 6f 66 20 72 65 61 64 69 6e nstead of readin
24260 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 g the content of
24270 20 70 61 67 65 20 6f 76 66 6c 20 74 6f 20 64 6f page ovfl to do
24280 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 so. .**.** If a
24290 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 61 n error occurs a
242a0 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 n SQLite error c
242b0 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e ode is returned.
242c0 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a 2a 0a 2a Otherwise:.**.*
242d0 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 * The page numbe
242e0 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 6f 76 r of the next ov
242f0 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 erflow page in t
24300 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 69 he linked list i
24310 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 6f s .** written to
24320 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 49 66 20 *pPgnoNext. If
24330 70 61 67 65 20 6f 76 66 6c 20 69 73 20 74 68 65 page ovfl is the
24340 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 69 74 last page in it
24350 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c 69 73 s linked .** lis
24360 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 20 69 73 t, *pPgnoNext is
24370 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 0a 2a set to zero. .*
24380 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 65 20 69 *.** If ppPage i
24390 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e 64 20 s not NULL, and
243a0 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 a reference to t
243b0 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 63 he MemPage objec
243c0 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 0a t corresponding.
243d0 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 65 ** to page numbe
243e0 72 20 70 4f 76 66 6c 20 77 61 73 20 6f 62 74 61 r pOvfl was obta
243f0 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 70 50 61 ined, then *ppPa
24400 67 65 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 ge is set to poi
24410 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a 20 72 65 nt to that.** re
24420 66 65 72 65 6e 63 65 2e 20 49 74 20 69 73 20 74 ference. It is t
24430 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 he responsibilit
24440 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
24450 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 73 65 50 to call releaseP
24460 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 70 50 age().** on *ppP
24470 61 67 65 20 74 6f 20 66 72 65 65 20 74 68 65 20 age to free the
24480 72 65 66 65 72 65 6e 63 65 2e 20 49 6e 20 6e 6f reference. In no
24490 20 72 65 66 65 72 65 6e 63 65 20 77 61 73 20 6f reference was o
244a0 62 74 61 69 6e 65 64 20 28 62 65 63 61 75 73 65 btained (because
244b0 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 2d .** the pointer-
244c0 6d 61 70 20 77 61 73 20 75 73 65 64 20 74 6f 20 map was used to
244d0 6f 62 74 61 69 6e 20 74 68 65 20 76 61 6c 75 65 obtain the value
244e0 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 74 29 for *pPgnoNext)
244f0 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 61 67 , then.** *ppPag
24500 65 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f e is set to zero
24510 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
24520 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 getOverflowPage(
24530 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
24540 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
24550 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 /* The database
24560 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6f file */. Pgno o
24570 76 66 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 vfl,
24580 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e /* Curren
24590 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 t overflow page
245a0 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 6d 50 number */. MemP
245b0 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
245c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a /* OUT:
245d0 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 6c 65 20 MemPage handle
245e0 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a 2f (may be NULL) */
245f0 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 4e 65 . Pgno *pPgnoNe
24600 78 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 xt
24610 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 6f 76 65 /* OUT: Next ove
24620 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 65 rflow page numbe
24630 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f 20 6e r */.){. Pgno n
24640 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 ext = 0;. MemPa
24650 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a 20 ge *pPage = 0;.
24660 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
24670 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 _OK;.. assert(
24680 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
24690 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
246a0 3b 0a 20 20 61 73 73 65 72 74 28 70 50 67 6e 6f ;. assert(pPgno
246b0 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 65 66 20 Next);..#ifndef
246c0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
246d0 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 72 79 20 VACUUM. /* Try
246e0 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 65 78 74 to find the next
246f0 20 70 61 67 65 20 69 6e 20 74 68 65 20 6f 76 65 page in the ove
24700 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 69 6e 67 rflow list using
24710 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 6f 76 61 the. ** autova
24720 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 70 cuum pointer-map
24730 20 70 61 67 65 73 2e 20 47 75 65 73 73 20 74 68 pages. Guess th
24740 61 74 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 at the next page
24750 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 20 6f 76 in . ** the ov
24760 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 73 20 70 erflow list is p
24770 61 67 65 20 6e 75 6d 62 65 72 20 28 6f 76 66 6c age number (ovfl
24780 2b 31 29 2e 20 49 66 20 74 68 61 74 20 67 75 65 +1). If that gue
24790 73 73 20 74 75 72 6e 73 20 0a 20 20 2a 2a 20 6f ss turns . ** o
247a0 75 74 20 74 6f 20 62 65 20 77 72 6f 6e 67 2c 20 ut to be wrong,
247b0 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 6c 6f 61 fall back to loa
247c0 64 69 6e 67 20 74 68 65 20 64 61 74 61 20 6f 66 ding the data of
247d0 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e 75 6d 62 page . ** numb
247e0 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 74 65 72 er ovfl to deter
247f0 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 20 70 61 mine the next pa
24800 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 2a 2f 0a ge number.. */.
24810 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 if( pBt->autoV
24820 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 6e acuum ){. Pgn
24830 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 67 6e 6f o pgno;. Pgno
24840 20 69 47 75 65 73 73 20 3d 20 6f 76 66 6c 2b 31 iGuess = ovfl+1
24850 3b 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a ;. u8 eType;.
24860 0a 20 20 20 20 77 68 69 6c 65 28 20 50 54 52 4d . while( PTRM
24870 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 69 AP_ISPAGE(pBt, i
24880 47 75 65 73 73 29 20 7c 7c 20 69 47 75 65 73 73 Guess) || iGuess
24890 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 ==PENDING_BYTE_P
248a0 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 AGE(pBt) ){.
248b0 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 20 20 20 iGuess++;.
248c0 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 75 65 73 }.. if( iGues
248d0 73 3c 3d 62 74 72 65 65 50 61 67 65 63 6f 75 6e s<=btreePagecoun
248e0 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 t(pBt) ){.
248f0 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 70 rc = ptrmapGet(p
24900 42 74 2c 20 69 47 75 65 73 73 2c 20 26 65 54 79 Bt, iGuess, &eTy
24910 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 20 20 pe, &pgno);.
24920 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
24930 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d 3d 50 54 _OK && eType==PT
24940 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 26 RMAP_OVERFLOW2 &
24950 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 7b 0a & pgno==ovfl ){.
24960 20 20 20 20 20 20 20 20 6e 65 78 74 20 3d 20 69 next = i
24970 47 75 65 73 73 3b 0a 20 20 20 20 20 20 20 20 72 Guess;. r
24980 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b c = SQLITE_DONE;
24990 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
249a0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 }.#endif.. ass
249b0 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 7c 7c 20 ert( next==0 ||
249c0 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 rc==SQLITE_DONE
249d0 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
249e0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 ITE_OK ){. rc
249f0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
24a00 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 50 61 67 pBt, ovfl, &pPag
24a10 65 2c 20 28 70 70 50 61 67 65 3d 3d 30 29 20 3f e, (ppPage==0) ?
24a20 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f PAGER_GET_READO
24a30 4e 4c 59 20 3a 20 30 29 3b 0a 20 20 20 20 61 73 NLY : 0);. as
24a40 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
24a50 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 3d 3d 30 20 _OK || pPage==0
24a60 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
24a70 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
24a80 20 20 6e 65 78 74 20 3d 20 67 65 74 34 62 79 74 next = get4byt
24a90 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 3b e(pPage->aData);
24aa0 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a 70 . }. }.. *p
24ab0 50 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 78 74 3b PgnoNext = next;
24ac0 0a 20 20 69 66 28 20 70 70 50 61 67 65 20 29 7b . if( ppPage ){
24ad0 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 . *ppPage = p
24ae0 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 Page;. }else{.
24af0 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
24b00 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 Page);. }. ret
24b10 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f urn (rc==SQLITE_
24b20 44 4f 4e 45 20 3f 20 53 51 4c 49 54 45 5f 4f 4b DONE ? SQLITE_OK
24b30 20 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a : rc);.}../*.**
24b40 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 Copy data from
24b50 61 20 62 75 66 66 65 72 20 74 6f 20 61 20 70 61 a buffer to a pa
24b60 67 65 2c 20 6f 72 20 66 72 6f 6d 20 61 20 70 61 ge, or from a pa
24b70 67 65 20 74 6f 20 61 20 62 75 66 66 65 72 2e 0a ge to a buffer..
24b80 2a 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 64 20 69 **.** pPayload i
24b90 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 64 s a pointer to d
24ba0 61 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 64 61 ata stored on da
24bb0 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 50 tabase page pDbP
24bc0 61 67 65 2e 0a 2a 2a 20 49 66 20 61 72 67 75 6d age..** If argum
24bd0 65 6e 74 20 65 4f 70 20 69 73 20 66 61 6c 73 65 ent eOp is false
24be0 2c 20 74 68 65 6e 20 6e 42 79 74 65 20 62 79 74 , then nByte byt
24bf0 65 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 63 es of data are c
24c00 6f 70 69 65 64 0a 2a 2a 20 66 72 6f 6d 20 70 50 opied.** from pP
24c10 61 79 6c 6f 61 64 20 74 6f 20 74 68 65 20 62 75 ayload to the bu
24c20 66 66 65 72 20 70 6f 69 6e 74 65 64 20 61 74 20 ffer pointed at
24c30 62 79 20 70 42 75 66 2e 20 49 66 20 65 4f 70 20 by pBuf. If eOp
24c40 69 73 20 74 72 75 65 2c 0a 2a 2a 20 74 68 65 6e is true,.** then
24c50 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
24c60 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f te() is called o
24c70 6e 20 70 44 62 50 61 67 65 20 61 6e 64 20 6e 42 n pDbPage and nB
24c80 79 74 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 20 yte bytes.** of
24c90 64 61 74 61 20 61 72 65 20 63 6f 70 69 65 64 20 data are copied
24ca0 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 20 from the buffer
24cb0 70 42 75 66 20 74 6f 20 70 50 61 79 6c 6f 61 64 pBuf to pPayload
24cc0 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f ..**.** SQLITE_O
24cd0 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e K is returned on
24ce0 20 73 75 63 63 65 73 73 2c 20 6f 74 68 65 72 77 success, otherw
24cf0 69 73 65 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 ise an error cod
24d00 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
24d10 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 0a 20 20 copyPayload(.
24d20 76 6f 69 64 20 2a 70 50 61 79 6c 6f 61 64 2c 20 void *pPayload,
24d30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 /* Poi
24d40 6e 74 65 72 20 74 6f 20 70 61 67 65 20 64 61 74 nter to page dat
24d50 61 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 a */. void *pBu
24d60 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f,
24d70 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 62 /* Pointer to b
24d80 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6e uffer */. int n
24d90 42 79 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 Byte,
24da0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
24db0 66 20 62 79 74 65 73 20 74 6f 20 63 6f 70 79 20 f bytes to copy
24dc0 2a 2f 0a 20 20 69 6e 74 20 65 4f 70 2c 20 20 20 */. int eOp,
24dd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24de0 2a 20 30 20 2d 3e 20 63 6f 70 79 20 66 72 6f 6d * 0 -> copy from
24df0 20 70 61 67 65 2c 20 31 20 2d 3e 20 63 6f 70 79 page, 1 -> copy
24e00 20 74 6f 20 70 61 67 65 20 2a 2f 0a 20 20 44 62 to page */. Db
24e10 50 61 67 65 20 2a 70 44 62 50 61 67 65 20 20 20 Page *pDbPage
24e20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
24e30 63 6f 6e 74 61 69 6e 69 6e 67 20 70 50 61 79 6c containing pPayl
24e40 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 oad */.){. if(
24e50 65 4f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6f eOp ){. /* Co
24e60 70 79 20 64 61 74 61 20 66 72 6f 6d 20 62 75 66 py data from buf
24e70 66 65 72 20 74 6f 20 70 61 67 65 20 28 61 20 77 fer to page (a w
24e80 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 29 20 rite operation)
24e90 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 */. int rc =
24ea0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
24eb0 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 e(pDbPage);.
24ec0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
24ed0 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 K ){. retur
24ee0 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
24ef0 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 2c memcpy(pPayload,
24f00 20 70 42 75 66 2c 20 6e 42 79 74 65 29 3b 0a 20 pBuf, nByte);.
24f10 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 43 }else{. /* C
24f20 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 70 61 opy data from pa
24f30 67 65 20 74 6f 20 62 75 66 66 65 72 20 28 61 20 ge to buffer (a
24f40 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 29 20 read operation)
24f50 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 42 */. memcpy(pB
24f60 75 66 2c 20 70 50 61 79 6c 6f 61 64 2c 20 6e 42 uf, pPayload, nB
24f70 79 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 yte);. }. retu
24f80 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
24f90 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
24fa0 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 tion is used to
24fb0 72 65 61 64 20 6f 72 20 6f 76 65 72 77 72 69 74 read or overwrit
24fc0 65 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 6d e payload inform
24fd0 61 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 74 68 65 ation.** for the
24fe0 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 20 entry that the
24ff0 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 20 70 pCur cursor is p
25000 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 54 68 65 20 ointing to. The
25010 65 4f 70 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 eOp.** argument
25020 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 is interpreted a
25030 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a s follows:.**.**
25040 20 20 20 30 3a 20 54 68 65 20 6f 70 65 72 61 74 0: The operat
25050 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e 20 50 ion is a read. P
25060 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 opulate the over
25070 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 20 flow cache..**
25080 20 31 3a 20 54 68 65 20 6f 70 65 72 61 74 69 6f 1: The operatio
25090 6e 20 69 73 20 61 20 77 72 69 74 65 2e 20 50 6f n is a write. Po
250a0 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 66 pulate the overf
250b0 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 20 20 low cache..**
250c0 32 3a 20 54 68 65 20 6f 70 65 72 61 74 69 6f 6e 2: The operation
250d0 20 69 73 20 61 20 72 65 61 64 2e 20 44 6f 20 6e is a read. Do n
250e0 6f 74 20 70 6f 70 75 6c 61 74 65 20 74 68 65 20 ot populate the
250f0 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a overflow cache..
25100 2a 2a 0a 2a 2a 20 41 20 74 6f 74 61 6c 20 6f 66 **.** A total of
25110 20 22 61 6d 74 22 20 62 79 74 65 73 20 61 72 65 "amt" bytes are
25120 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e read or written
25130 20 62 65 67 69 6e 6e 69 6e 67 20 61 74 20 22 6f beginning at "o
25140 66 66 73 65 74 22 2e 0a 2a 2a 20 44 61 74 61 20 ffset"..** Data
25150 69 73 20 72 65 61 64 20 74 6f 20 6f 72 20 66 72 is read to or fr
25160 6f 6d 20 74 68 65 20 62 75 66 66 65 72 20 70 42 om the buffer pB
25170 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f uf..**.** The co
25180 6e 74 65 6e 74 20 62 65 69 6e 67 20 72 65 61 64 ntent being read
25190 20 6f 72 20 77 72 69 74 74 65 6e 20 6d 69 67 68 or written migh
251a0 74 20 61 70 70 65 61 72 20 6f 6e 20 74 68 65 20 t appear on the
251b0 6d 61 69 6e 20 70 61 67 65 0a 2a 2a 20 6f 72 20 main page.** or
251c0 62 65 20 73 63 61 74 74 65 72 65 64 20 6f 75 74 be scattered out
251d0 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 6f 76 65 on multiple ove
251e0 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 2a 2a 0a rflow pages..**.
251f0 2a 2a 20 49 66 20 74 68 65 20 63 75 72 72 65 6e ** If the curren
25200 74 20 63 75 72 73 6f 72 20 65 6e 74 72 79 20 75 t cursor entry u
25210 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 ses one or more
25220 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
25230 6e 64 20 74 68 65 0a 2a 2a 20 65 4f 70 20 61 72 nd the.** eOp ar
25240 67 75 6d 65 6e 74 20 69 73 20 6e 6f 74 20 32 2c gument is not 2,
25250 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d this function m
25260 61 79 20 61 6c 6c 6f 63 61 74 65 20 73 70 61 63 ay allocate spac
25270 65 20 66 6f 72 20 61 6e 64 20 6c 61 7a 69 6c 79 e for and lazily
25280 20 0a 2a 2a 20 70 6f 70 75 6c 61 74 65 73 20 74 .** populates t
25290 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
252a0 2d 6c 69 73 74 20 63 61 63 68 65 20 61 72 72 61 -list cache arra
252b0 79 20 28 42 74 43 75 72 73 6f 72 2e 61 4f 76 65 y (BtCursor.aOve
252c0 72 66 6c 6f 77 29 2e 20 0a 2a 2a 20 53 75 62 73 rflow). .** Subs
252d0 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 75 73 65 equent calls use
252e0 20 74 68 69 73 20 63 61 63 68 65 20 74 6f 20 6d this cache to m
252f0 61 6b 65 20 73 65 65 6b 69 6e 67 20 74 6f 20 74 ake seeking to t
25300 68 65 20 73 75 70 70 6c 69 65 64 20 6f 66 66 73 he supplied offs
25310 65 74 20 0a 2a 2a 20 6d 6f 72 65 20 65 66 66 69 et .** more effi
25320 63 69 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 cient..**.** Onc
25330 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 e an overflow pa
25340 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 ge-list cache ha
25350 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 s been allocated
25360 2c 20 69 74 20 6d 61 79 20 62 65 0a 2a 2a 20 69 , it may be.** i
25370 6e 76 61 6c 69 64 61 74 65 64 20 69 66 20 73 6f nvalidated if so
25380 6d 65 20 6f 74 68 65 72 20 63 75 72 73 6f 72 20 me other cursor
25390 77 72 69 74 65 73 20 74 6f 20 74 68 65 20 73 61 writes to the sa
253a0 6d 65 20 74 61 62 6c 65 2c 20 6f 72 20 69 66 0a me table, or if.
253b0 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 ** the cursor is
253c0 20 6d 6f 76 65 64 20 74 6f 20 61 20 64 69 66 66 moved to a diff
253d0 65 72 65 6e 74 20 72 6f 77 2e 20 41 64 64 69 74 erent row. Addit
253e0 69 6f 6e 61 6c 6c 79 2c 20 69 6e 20 61 75 74 6f ionally, in auto
253f0 2d 76 61 63 75 75 6d 0a 2a 2a 20 6d 6f 64 65 2c -vacuum.** mode,
25400 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 the following e
25410 76 65 6e 74 73 20 6d 61 79 20 69 6e 76 61 6c 69 vents may invali
25420 64 61 74 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 date an overflow
25430 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 page-list cache
25440 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 6e 20 69 ..**.** * An i
25450 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 ncremental vacuu
25460 6d 2c 0a 2a 2a 20 20 20 2a 20 41 20 63 6f 6d 6d m,.** * A comm
25470 69 74 20 69 6e 20 61 75 74 6f 5f 76 61 63 75 75 it in auto_vacuu
25480 6d 3d 22 66 75 6c 6c 22 20 6d 6f 64 65 2c 0a 2a m="full" mode,.*
25490 2a 20 20 20 2a 20 43 72 65 61 74 69 6e 67 20 61 * * Creating a
254a0 20 74 61 62 6c 65 20 28 6d 61 79 20 72 65 71 75 table (may requ
254b0 69 72 65 20 6d 6f 76 69 6e 67 20 61 6e 20 6f 76 ire moving an ov
254c0 65 72 66 6c 6f 77 20 70 61 67 65 29 2e 0a 2a 2f erflow page)..*/
254d0 0a 73 74 61 74 69 63 20 69 6e 74 20 61 63 63 65 .static int acce
254e0 73 73 50 61 79 6c 6f 61 64 28 0a 20 20 42 74 43 ssPayload(. BtC
254f0 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 ursor *pCur,
25500 20 20 2f 2a 20 43 75 72 73 6f 72 20 70 6f 69 6e /* Cursor poin
25510 74 69 6e 67 20 74 6f 20 65 6e 74 72 79 20 74 6f ting to entry to
25520 20 72 65 61 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 read from */.
25530 75 33 32 20 6f 66 66 73 65 74 2c 20 20 20 20 20 u32 offset,
25540 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 72 65 /* Begin re
25550 61 64 69 6e 67 20 74 68 69 73 20 66 61 72 20 69 ading this far i
25560 6e 74 6f 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 nto payload */.
25570 20 75 33 32 20 61 6d 74 2c 20 20 20 20 20 20 20 u32 amt,
25580 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 /* Read th
25590 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 2a 2f is many bytes */
255a0 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
255b0 20 2a 70 42 75 66 2c 20 2f 2a 20 57 72 69 74 65 *pBuf, /* Write
255c0 20 74 68 65 20 62 79 74 65 73 20 69 6e 74 6f 20 the bytes into
255d0 74 68 69 73 20 62 75 66 66 65 72 20 2a 2f 20 0a this buffer */ .
255e0 20 20 69 6e 74 20 65 4f 70 20 20 20 20 20 20 20 int eOp
255f0 20 20 20 20 20 20 20 2f 2a 20 7a 65 72 6f 20 74 /* zero t
25600 6f 20 72 65 61 64 2e 20 6e 6f 6e 2d 7a 65 72 6f o read. non-zero
25610 20 74 6f 20 77 72 69 74 65 2e 20 2a 2f 0a 29 7b to write. */.){
25620 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
25630 20 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 20 69 6e *aPayload;. in
25640 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
25650 3b 0a 20 20 69 6e 74 20 69 49 64 78 20 3d 20 30 ;. int iIdx = 0
25660 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 ;. MemPage *pPa
25670 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
25680 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 20 e[pCur->iPage];
25690 2f 2a 20 42 74 72 65 65 20 70 61 67 65 20 6f 66 /* Btree page of
256a0 20 63 75 72 72 65 6e 74 20 65 6e 74 72 79 20 2a current entry *
256b0 2f 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 /. BtShared *pB
256c0 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 20 20 t = pCur->pBt;
256d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
256e0 2f 2a 20 42 74 72 65 65 20 74 68 69 73 20 63 75 /* Btree this cu
256f0 72 73 6f 72 20 62 65 6c 6f 6e 67 73 20 74 6f 20 rsor belongs to
25700 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
25710 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 _DIRECT_OVERFLOW
25720 5f 52 45 41 44 0a 20 20 75 6e 73 69 67 6e 65 64 _READ. unsigned
25730 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 20 70 42 char * const pB
25740 75 66 53 74 61 72 74 20 3d 20 70 42 75 66 3b 0a ufStart = pBuf;.
25750 20 20 69 6e 74 20 62 45 6e 64 3b 20 20 20 20 20 int bEnd;
25760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25770 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
25780 72 75 65 20 69 66 20 72 65 61 64 69 6e 67 20 74 rue if reading t
25790 6f 20 65 6e 64 20 6f 66 20 64 61 74 61 20 2a 2f o end of data */
257a0 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 .#endif.. asser
257b0 74 28 20 70 50 61 67 65 20 29 3b 0a 20 20 61 73 t( pPage );. as
257c0 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
257d0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
257e0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
257f0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
25800 69 50 61 67 65 5d 3c 70 50 61 67 65 2d 3e 6e 43 iPage]<pPage->nC
25810 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ell );. assert(
25820 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
25830 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 x(pCur) );. ass
25840 65 72 74 28 20 65 4f 70 21 3d 32 20 7c 7c 20 6f ert( eOp!=2 || o
25850 66 66 73 65 74 3d 3d 30 20 29 3b 20 20 20 20 2f ffset==0 ); /
25860 2a 20 41 6c 77 61 79 73 20 73 74 61 72 74 20 66 * Always start f
25870 72 6f 6d 20 62 65 67 69 6e 6e 69 6e 67 20 66 6f rom beginning fo
25880 72 20 65 4f 70 3d 3d 32 20 2a 2f 0a 0a 20 20 67 r eOp==2 */.. g
25890 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 etCellInfo(pCur)
258a0 3b 0a 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 70 ;. aPayload = p
258b0 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f Cur->info.pPaylo
258c0 61 64 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 ad;.#ifdef SQLIT
258d0 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f E_DIRECT_OVERFLO
258e0 57 5f 52 45 41 44 0a 20 20 62 45 6e 64 20 3d 20 W_READ. bEnd =
258f0 6f 66 66 73 65 74 2b 61 6d 74 3d 3d 70 43 75 72 offset+amt==pCur
25900 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b ->info.nPayload;
25910 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 65 72 74 .#endif. assert
25920 28 20 6f 66 66 73 65 74 2b 61 6d 74 20 3c 3d 20 ( offset+amt <=
25930 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c pCur->info.nPayl
25940 6f 61 64 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 oad );.. assert
25950 28 20 61 50 61 79 6c 6f 61 64 20 3e 20 70 50 61 ( aPayload > pPa
25960 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 20 69 ge->aData );. i
25970 66 28 20 28 75 70 74 72 29 28 61 50 61 79 6c 6f f( (uptr)(aPaylo
25980 61 64 20 2d 20 70 50 61 67 65 2d 3e 61 44 61 74 ad - pPage->aDat
25990 61 29 20 3e 20 28 70 42 74 2d 3e 75 73 61 62 6c a) > (pBt->usabl
259a0 65 53 69 7a 65 20 2d 20 70 43 75 72 2d 3e 69 6e eSize - pCur->in
259b0 66 6f 2e 6e 4c 6f 63 61 6c 29 20 29 7b 0a 20 20 fo.nLocal) ){.
259c0 20 20 2f 2a 20 54 72 79 69 6e 67 20 74 6f 20 72 /* Trying to r
259d0 65 61 64 20 6f 72 20 77 72 69 74 65 20 70 61 73 ead or write pas
259e0 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
259f0 20 64 61 74 61 20 69 73 20 61 6e 20 65 72 72 6f data is an erro
25a00 72 2e 20 20 54 68 65 0a 20 20 20 20 2a 2a 20 63 r. The. ** c
25a10 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 62 6f 76 65 onditional above
25a20 20 69 73 20 72 65 61 6c 6c 79 3a 0a 20 20 20 20 is really:.
25a30 2a 2a 20 20 20 20 26 61 50 61 79 6c 6f 61 64 5b ** &aPayload[
25a40 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
25a50 6c 5d 20 3e 20 26 70 50 61 67 65 2d 3e 61 44 61 l] > &pPage->aDa
25a60 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 ta[pBt->usableSi
25a70 7a 65 5d 0a 20 20 20 20 2a 2a 20 62 75 74 20 69 ze]. ** but i
25a80 73 20 72 65 63 61 73 74 20 69 6e 74 6f 20 69 74 s recast into it
25a90 73 20 63 75 72 72 65 6e 74 20 66 6f 72 6d 20 74 s current form t
25aa0 6f 20 61 76 6f 69 64 20 69 6e 74 65 67 65 72 20 o avoid integer
25ab0 6f 76 65 72 66 6c 6f 77 20 70 72 6f 62 6c 65 6d overflow problem
25ac0 73 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 65 74 s. */. ret
25ad0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
25ae0 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 20 20 PT_BKPT;. }..
25af0 2f 2a 20 43 68 65 63 6b 20 69 66 20 64 61 74 61 /* Check if data
25b00 20 6d 75 73 74 20 62 65 20 72 65 61 64 2f 77 72 must be read/wr
25b10 69 74 74 65 6e 20 74 6f 2f 66 72 6f 6d 20 74 68 itten to/from th
25b20 65 20 62 74 72 65 65 20 70 61 67 65 20 69 74 73 e btree page its
25b30 65 6c 66 2e 20 2a 2f 0a 20 20 69 66 28 20 6f 66 elf. */. if( of
25b40 66 73 65 74 3c 70 43 75 72 2d 3e 69 6e 66 6f 2e fset<pCur->info.
25b50 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 69 6e nLocal ){. in
25b60 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 69 t a = amt;. i
25b70 66 28 20 61 2b 6f 66 66 73 65 74 3e 70 43 75 72 f( a+offset>pCur
25b80 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 7b ->info.nLocal ){
25b90 0a 20 20 20 20 20 20 61 20 3d 20 70 43 75 72 2d . a = pCur-
25ba0 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d 20 6f >info.nLocal - o
25bb0 66 66 73 65 74 3b 0a 20 20 20 20 7d 0a 20 20 20 ffset;. }.
25bc0 20 72 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 rc = copyPayloa
25bd0 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 d(&aPayload[offs
25be0 65 74 5d 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 et], pBuf, a, (e
25bf0 4f 70 20 26 20 30 78 30 31 29 2c 20 70 50 61 67 Op & 0x01), pPag
25c00 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
25c10 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 offset = 0;.
25c20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 pBuf += a;.
25c30 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 amt -= a;. }els
25c40 65 7b 0a 20 20 20 20 6f 66 66 73 65 74 20 2d 3d e{. offset -=
25c50 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 pCur->info.nLoc
25c60 61 6c 3b 0a 20 20 7d 0a 0a 0a 20 20 69 66 28 20 al;. }... if(
25c70 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
25c80 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f amt>0 ){. co
25c90 6e 73 74 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 nst u32 ovflSize
25ca0 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 = pBt->usableSi
25cb0 7a 65 20 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 ze - 4; /* Byte
25cc0 73 20 63 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 s content per ov
25cd0 66 6c 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 fl page */. P
25ce0 67 6e 6f 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 gno nextPage;..
25cf0 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 nextPage = ge
25d00 74 34 62 79 74 65 28 26 61 50 61 79 6c 6f 61 64 t4byte(&aPayload
25d10 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 [pCur->info.nLoc
25d20 61 6c 5d 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 al]);.. /* If
25d30 20 74 68 65 20 42 74 43 75 72 73 6f 72 2e 61 4f the BtCursor.aO
25d40 76 65 72 66 6c 6f 77 5b 5d 20 68 61 73 20 6e 6f verflow[] has no
25d50 74 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 t been allocated
25d60 2c 20 61 6c 6c 6f 63 61 74 65 20 69 74 20 6e 6f , allocate it no
25d70 77 2e 0a 20 20 20 20 2a 2a 20 45 78 63 65 70 74 w.. ** Except
25d80 2c 20 64 6f 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 , do not allocat
25d90 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 66 6f e aOverflow[] fo
25da0 72 20 65 4f 70 3d 3d 32 2e 0a 20 20 20 20 2a 2a r eOp==2.. **
25db0 0a 20 20 20 20 2a 2a 20 54 68 65 20 61 4f 76 65 . ** The aOve
25dc0 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 20 69 73 rflow[] array is
25dd0 20 73 69 7a 65 64 20 61 74 20 6f 6e 65 20 65 6e sized at one en
25de0 74 72 79 20 66 6f 72 20 65 61 63 68 20 6f 76 65 try for each ove
25df0 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 20 20 2a rflow page. *
25e00 2a 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c 6f * in the overflo
25e10 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 67 w chain. The pag
25e20 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
25e30 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
25e40 61 67 65 20 69 73 0a 20 20 20 20 2a 2a 20 73 74 age is. ** st
25e50 6f 72 65 64 20 69 6e 20 61 4f 76 65 72 66 6c 6f ored in aOverflo
25e60 77 5b 30 5d 2c 20 65 74 63 2e 20 41 20 76 61 6c w[0], etc. A val
25e70 75 65 20 6f 66 20 30 20 69 6e 20 74 68 65 20 61 ue of 0 in the a
25e80 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 Overflow[] array
25e90 0a 20 20 20 20 2a 2a 20 6d 65 61 6e 73 20 22 6e . ** means "n
25ea0 6f 74 20 79 65 74 20 6b 6e 6f 77 6e 22 20 28 74 ot yet known" (t
25eb0 68 65 20 63 61 63 68 65 20 69 73 20 6c 61 7a 69 he cache is lazi
25ec0 6c 79 20 70 6f 70 75 6c 61 74 65 64 29 2e 0a 20 ly populated)..
25ed0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 65 4f */. if( eO
25ee0 70 21 3d 32 20 26 26 20 28 70 43 75 72 2d 3e 63 p!=2 && (pCur->c
25ef0 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 urFlags & BTCF_V
25f00 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 29 7b 0a alidOvfl)==0 ){.
25f10 20 20 20 20 20 20 69 6e 74 20 6e 4f 76 66 6c 20 int nOvfl
25f20 3d 20 28 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 = (pCur->info.nP
25f30 61 79 6c 6f 61 64 2d 70 43 75 72 2d 3e 69 6e 66 ayload-pCur->inf
25f40 6f 2e 6e 4c 6f 63 61 6c 2b 6f 76 66 6c 53 69 7a o.nLocal+ovflSiz
25f50 65 2d 31 29 2f 6f 76 66 6c 53 69 7a 65 3b 0a 20 e-1)/ovflSize;.
25f60 20 20 20 20 20 69 66 28 20 6e 4f 76 66 6c 3e 70 if( nOvfl>p
25f70 43 75 72 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 Cur->nOvflAlloc
25f80 29 7b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 ){. Pgno
25f90 2a 61 4e 65 77 20 3d 20 28 50 67 6e 6f 2a 29 73 *aNew = (Pgno*)s
25fa0 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 0a 20 qlite3Realloc(.
25fb0 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d pCur-
25fc0 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 6e 4f 76 66 >aOverflow, nOvf
25fd0 6c 2a 32 2a 73 69 7a 65 6f 66 28 50 67 6e 6f 29 l*2*sizeof(Pgno)
25fe0 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 . );.
25ff0 20 20 20 20 69 66 28 20 61 4e 65 77 3d 3d 30 20 if( aNew==0
26000 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
26010 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 = SQLITE_NOMEM_B
26020 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c KPT;. }el
26030 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 70 43 se{. pC
26040 75 72 2d 3e 6e 4f 76 66 6c 41 6c 6c 6f 63 20 3d ur->nOvflAlloc =
26050 20 6e 4f 76 66 6c 2a 32 3b 0a 20 20 20 20 20 20 nOvfl*2;.
26060 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 pCur->aOverf
26070 6c 6f 77 20 3d 20 61 4e 65 77 3b 0a 20 20 20 20 low = aNew;.
26080 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
26090 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
260a0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
260b0 20 6d 65 6d 73 65 74 28 70 43 75 72 2d 3e 61 4f memset(pCur->aO
260c0 76 65 72 66 6c 6f 77 2c 20 30 2c 20 6e 4f 76 66 verflow, 0, nOvf
260d0 6c 2a 73 69 7a 65 6f 66 28 50 67 6e 6f 29 29 3b l*sizeof(Pgno));
260e0 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 63 . pCur->c
260f0 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f urFlags |= BTCF_
26100 56 61 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 20 20 ValidOvfl;.
26110 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a }. }.. /*
26120 20 49 66 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 If the overflow
26130 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 page-list cache
26140 20 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 has been alloca
26150 74 65 64 20 61 6e 64 20 74 68 65 0a 20 20 20 20 ted and the.
26160 2a 2a 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 ** entry for the
26170 20 66 69 72 73 74 20 72 65 71 75 69 72 65 64 20 first required
26180 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 overflow page is
26190 20 76 61 6c 69 64 2c 20 73 6b 69 70 0a 20 20 20 valid, skip.
261a0 20 2a 2a 20 64 69 72 65 63 74 6c 79 20 74 6f 20 ** directly to
261b0 69 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 it.. */. i
261c0 66 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 f( (pCur->curFla
261d0 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f gs & BTCF_ValidO
261e0 76 66 6c 29 21 3d 30 0a 20 20 20 20 20 26 26 20 vfl)!=0. &&
261f0 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
26200 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 7a 65 5d offset/ovflSize]
26210 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 69 49 . ){. iI
26220 64 78 20 3d 20 28 6f 66 66 73 65 74 2f 6f 76 66 dx = (offset/ovf
26230 6c 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 6e 65 lSize);. ne
26240 78 74 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 xtPage = pCur->a
26250 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a Overflow[iIdx];.
26260 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 28 offset = (
26270 6f 66 66 73 65 74 25 6f 76 66 6c 53 69 7a 65 29 offset%ovflSize)
26280 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 66 6f 72 ;. }.. for
26290 28 20 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f ( ; rc==SQLITE_O
262a0 4b 20 26 26 20 61 6d 74 3e 30 20 26 26 20 6e 65 K && amt>0 && ne
262b0 78 74 50 61 67 65 3b 20 69 49 64 78 2b 2b 29 7b xtPage; iIdx++){
262c0 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 72 65 .. /* If re
262d0 71 75 69 72 65 64 2c 20 70 6f 70 75 6c 61 74 65 quired, populate
262e0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
262f0 67 65 2d 6c 69 73 74 20 63 61 63 68 65 2e 20 2a ge-list cache. *
26300 2f 0a 20 20 20 20 20 20 69 66 28 20 28 70 43 75 /. if( (pCu
26310 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 r->curFlags & BT
26320 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 21 3d 30 CF_ValidOvfl)!=0
26330 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 ){. asse
26340 72 74 28 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 rt( pCur->aOverf
26350 6c 6f 77 5b 69 49 64 78 5d 3d 3d 30 0a 20 20 20 low[iIdx]==0.
26360 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ||
26370 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
26380 69 49 64 78 5d 3d 3d 6e 65 78 74 50 61 67 65 0a iIdx]==nextPage.
26390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
263a0 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
263b0 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 . pCur->a
263c0 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 20 3d Overflow[iIdx] =
263d0 20 6e 65 78 74 50 61 67 65 3b 0a 20 20 20 20 20 nextPage;.
263e0 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 6f 66 }.. if( of
263f0 66 73 65 74 3e 3d 6f 76 66 6c 53 69 7a 65 20 29 fset>=ovflSize )
26400 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 {. /* The
26410 20 6f 6e 6c 79 20 72 65 61 73 6f 6e 20 74 6f 20 only reason to
26420 72 65 61 64 20 74 68 69 73 20 70 61 67 65 20 69 read this page i
26430 73 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 s to obtain the
26440 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 page. **
26450 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 65 20 6e number for the n
26460 65 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 ext page in the
26470 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e 20 overflow chain.
26480 54 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 The page.
26490 20 2a 2a 20 64 61 74 61 20 69 73 20 6e 6f 74 20 ** data is not
264a0 72 65 71 75 69 72 65 64 2e 20 53 6f 20 66 69 72 required. So fir
264b0 73 74 20 74 72 79 20 74 6f 20 6c 6f 6f 6b 75 70 st try to lookup
264c0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 0a 20 20 the overflow.
264d0 20 20 20 20 20 20 2a 2a 20 70 61 67 65 2d 6c 69 ** page-li
264e0 73 74 20 63 61 63 68 65 2c 20 69 66 20 61 6e 79 st cache, if any
264f0 2c 20 74 68 65 6e 20 66 61 6c 6c 20 62 61 63 6b , then fall back
26500 20 74 6f 20 74 68 65 20 67 65 74 4f 76 65 72 66 to the getOverf
26510 6c 6f 77 50 61 67 65 28 29 0a 20 20 20 20 20 20 lowPage().
26520 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 0a 20 ** function..
26530 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 **.
26540 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 ** Note that t
26550 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 he aOverflow[] a
26560 72 72 61 79 20 6d 75 73 74 20 62 65 20 61 6c 6c rray must be all
26570 6f 63 61 74 65 64 20 62 65 63 61 75 73 65 20 65 ocated because e
26580 4f 70 21 3d 32 0a 20 20 20 20 20 20 20 20 2a 2a Op!=2. **
26590 20 68 65 72 65 2e 20 20 49 66 20 65 4f 70 3d 3d here. If eOp==
265a0 32 2c 20 74 68 65 6e 20 6f 66 66 73 65 74 3d 3d 2, then offset==
265b0 30 20 61 6e 64 20 74 68 69 73 20 62 72 61 6e 63 0 and this branc
265c0 68 20 69 73 20 6e 65 76 65 72 20 74 61 6b 65 6e h is never taken
265d0 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
265e0 20 20 20 20 20 61 73 73 65 72 74 28 20 65 4f 70 assert( eOp
265f0 21 3d 32 20 29 3b 0a 20 20 20 20 20 20 20 20 61 !=2 );. a
26600 73 73 65 72 74 28 20 70 43 75 72 2d 3e 63 75 72 ssert( pCur->cur
26610 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c Flags & BTCF_Val
26620 69 64 4f 76 66 6c 20 29 3b 0a 20 20 20 20 20 20 idOvfl );.
26630 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
26640 70 42 74 72 65 65 2d 3e 64 62 3d 3d 70 42 74 2d pBtree->db==pBt-
26650 3e 64 62 20 29 3b 0a 20 20 20 20 20 20 20 20 69 >db );. i
26660 66 28 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c f( pCur->aOverfl
26670 6f 77 5b 69 49 64 78 2b 31 5d 20 29 7b 0a 20 20 ow[iIdx+1] ){.
26680 20 20 20 20 20 20 20 20 6e 65 78 74 50 61 67 65 nextPage
26690 20 3d 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c = pCur->aOverfl
266a0 6f 77 5b 69 49 64 78 2b 31 5d 3b 0a 20 20 20 20 ow[iIdx+1];.
266b0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
266c0 20 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 rc = getOve
266d0 72 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6e rflowPage(pBt, n
266e0 65 78 74 50 61 67 65 2c 20 30 2c 20 26 6e 65 78 extPage, 0, &nex
266f0 74 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 tPage);.
26700 7d 0a 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 }. offset
26710 20 2d 3d 20 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 -= ovflSize;.
26720 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
26730 20 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 72 65 /* Need to re
26740 61 64 20 74 68 69 73 20 70 61 67 65 20 70 72 6f ad this page pro
26750 70 65 72 6c 79 2e 20 49 74 20 63 6f 6e 74 61 69 perly. It contai
26760 6e 73 20 73 6f 6d 65 20 6f 66 20 74 68 65 0a 20 ns some of the.
26770 20 20 20 20 20 20 20 2a 2a 20 72 61 6e 67 65 20 ** range
26780 6f 66 20 64 61 74 61 20 74 68 61 74 20 69 73 20 of data that is
26790 62 65 69 6e 67 20 72 65 61 64 20 28 65 4f 70 3d being read (eOp=
267a0 3d 30 29 20 6f 72 20 77 72 69 74 74 65 6e 20 28 =0) or written (
267b0 65 4f 70 21 3d 30 29 2e 0a 20 20 20 20 20 20 20 eOp!=0)..
267c0 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
267d0 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 4c 4f E_DIRECT_OVERFLO
267e0 57 5f 52 45 41 44 0a 20 20 20 20 20 20 20 20 73 W_READ. s
267f0 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 3b qlite3_file *fd;
26800 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 20 20 .#endif.
26810 69 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 int a = amt;.
26820 20 20 20 20 20 69 66 28 20 61 20 2b 20 6f 66 66 if( a + off
26830 73 65 74 20 3e 20 6f 76 66 6c 53 69 7a 65 20 29 set > ovflSize )
26840 7b 0a 20 20 20 20 20 20 20 20 20 20 61 20 3d 20 {. a =
26850 6f 76 66 6c 53 69 7a 65 20 2d 20 6f 66 66 73 65 ovflSize - offse
26860 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a 23 69 t;. }..#i
26870 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 45 fdef SQLITE_DIRE
26880 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 CT_OVERFLOW_READ
26890 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 61 . /* If a
268a0 6c 6c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ll the following
268b0 20 61 72 65 20 74 72 75 65 3a 0a 20 20 20 20 20 are true:.
268c0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
268d0 20 20 20 31 29 20 74 68 69 73 20 69 73 20 61 20 1) this is a
268e0 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 2c 20 read operation,
268f0 61 6e 64 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 and . **
26900 20 20 32 29 20 64 61 74 61 20 69 73 20 72 65 71 2) data is req
26910 75 69 72 65 64 20 66 72 6f 6d 20 74 68 65 20 73 uired from the s
26920 74 61 72 74 20 6f 66 20 74 68 69 73 20 6f 76 65 tart of this ove
26930 72 66 6c 6f 77 20 70 61 67 65 2c 20 61 6e 64 0a rflow page, and.
26940 20 20 20 20 20 20 20 20 2a 2a 20 20 20 33 29 20 ** 3)
26950 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
26960 66 69 6c 65 2d 62 61 63 6b 65 64 2c 20 61 6e 64 file-backed, and
26970 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 34 29 . ** 4)
26980 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 70 65 there is no ope
26990 6e 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 n write-transact
269a0 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 ion, and.
269b0 20 2a 2a 20 20 20 35 29 20 74 68 65 20 64 61 74 ** 5) the dat
269c0 61 62 61 73 65 20 69 73 20 6e 6f 74 20 61 20 57 abase is not a W
269d0 41 4c 20 64 61 74 61 62 61 73 65 2c 0a 20 20 20 AL database,.
269e0 20 20 20 20 20 2a 2a 20 20 20 36 29 20 61 6c 6c ** 6) all
269f0 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 70 data from the p
26a00 61 67 65 20 69 73 20 62 65 69 6e 67 20 72 65 61 age is being rea
26a10 64 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 d.. **
26a20 37 29 20 61 74 20 6c 65 61 73 74 20 34 20 62 79 7) at least 4 by
26a30 74 65 73 20 68 61 76 65 20 61 6c 72 65 61 64 79 tes have already
26a40 20 62 65 65 6e 20 72 65 61 64 20 69 6e 74 6f 20 been read into
26a50 74 68 65 20 6f 75 74 70 75 74 20 62 75 66 66 65 the output buffe
26a60 72 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 r . **.
26a70 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 64 61 ** then da
26a80 74 61 20 63 61 6e 20 62 65 20 72 65 61 64 20 64 ta can be read d
26a90 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 irectly from the
26aa0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 database file i
26ab0 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 nto the.
26ac0 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 ** output buffer
26ad0 2c 20 62 79 70 61 73 73 69 6e 67 20 74 68 65 20 , bypassing the
26ae0 70 61 67 65 2d 63 61 63 68 65 20 61 6c 74 6f 67 page-cache altog
26af0 65 74 68 65 72 2e 20 54 68 69 73 20 73 70 65 65 ether. This spee
26b00 64 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 75 70 ds. ** up
26b10 20 6c 6f 61 64 69 6e 67 20 6c 61 72 67 65 20 72 loading large r
26b20 65 63 6f 72 64 73 20 74 68 61 74 20 73 70 61 6e ecords that span
26b30 20 6d 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 many overflow p
26b40 61 67 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f ages.. */
26b50 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 65 4f . if( (eO
26b60 70 26 30 78 30 31 29 3d 3d 30 20 20 20 20 20 20 p&0x01)==0
26b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26b90 2f 2a 20 28 31 29 20 2a 2f 0a 20 20 20 20 20 20 /* (1) */.
26ba0 20 20 20 26 26 20 6f 66 66 73 65 74 3d 3d 30 20 && offset==0
26bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26bd0 20 20 20 20 20 20 20 20 20 2f 2a 20 28 32 29 20 /* (2)
26be0 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 */. && (
26bf0 62 45 6e 64 20 7c 7c 20 61 3d 3d 6f 76 66 6c 53 bEnd || a==ovflS
26c00 69 7a 65 29 20 20 20 20 20 20 20 20 20 20 20 20 ize)
26c10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26c20 20 20 2f 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 /* (6) */.
26c30 20 20 20 20 20 26 26 20 70 42 74 2d 3e 69 6e 54 && pBt->inT
26c40 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e ransaction==TRAN
26c50 53 5f 52 45 41 44 20 20 20 20 20 20 20 20 20 20 S_READ
26c60 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 34 /* (4
26c70 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 ) */. &&
26c80 20 28 66 64 20 3d 20 73 71 6c 69 74 65 33 50 61 (fd = sqlite3Pa
26c90 67 65 72 46 69 6c 65 28 70 42 74 2d 3e 70 50 61 gerFile(pBt->pPa
26ca0 67 65 72 29 29 2d 3e 70 4d 65 74 68 6f 64 73 20 ger))->pMethods
26cb0 20 20 20 20 2f 2a 20 28 33 29 20 2a 2f 0a 20 20 /* (3) */.
26cc0 20 20 20 20 20 20 20 26 26 20 30 3d 3d 73 71 6c && 0==sql
26cd0 69 74 65 33 50 61 67 65 72 55 73 65 57 61 6c 28 ite3PagerUseWal(
26ce0 70 42 74 2d 3e 70 50 61 67 65 72 29 20 20 20 20 pBt->pPager)
26cf0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
26d00 28 35 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 (5) */.
26d10 26 26 20 26 70 42 75 66 5b 2d 34 5d 3e 3d 70 42 && &pBuf[-4]>=pB
26d20 75 66 53 74 61 72 74 20 20 20 20 20 20 20 20 20 ufStart
26d30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26d40 20 20 20 20 20 20 2f 2a 20 28 37 29 20 2a 2f 0a /* (7) */.
26d50 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ){.
26d60 20 20 20 20 20 75 38 20 61 53 61 76 65 5b 34 5d u8 aSave[4]
26d70 3b 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 2a ;. u8 *
26d80 61 57 72 69 74 65 20 3d 20 26 70 42 75 66 5b 2d aWrite = &pBuf[-
26d90 34 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 4];. as
26da0 73 65 72 74 28 20 61 57 72 69 74 65 3e 3d 70 42 sert( aWrite>=pB
26db0 75 66 53 74 61 72 74 20 29 3b 20 20 20 20 20 20 ufStart );
26dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26dd0 20 20 20 2f 2a 20 68 65 6e 63 65 20 28 37 29 20 /* hence (7)
26de0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d */. mem
26df0 63 70 79 28 61 53 61 76 65 2c 20 61 57 72 69 74 cpy(aSave, aWrit
26e00 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 e, 4);.
26e10 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
26e20 65 61 64 28 66 64 2c 20 61 57 72 69 74 65 2c 20 ead(fd, aWrite,
26e30 61 2b 34 2c 20 28 69 36 34 29 70 42 74 2d 3e 70 a+4, (i64)pBt->p
26e40 61 67 65 53 69 7a 65 2a 28 6e 65 78 74 50 61 67 ageSize*(nextPag
26e50 65 2d 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 e-1));.
26e60 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 nextPage = get4
26e70 62 79 74 65 28 61 57 72 69 74 65 29 3b 0a 20 20 byte(aWrite);.
26e80 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 memcpy(a
26e90 57 72 69 74 65 2c 20 61 53 61 76 65 2c 20 34 29 Write, aSave, 4)
26ea0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 0a ;. }else.
26eb0 23 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 20 20 #endif..
26ec0 7b 0a 20 20 20 20 20 20 20 20 20 20 44 62 50 61 {. DbPa
26ed0 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 20 ge *pDbPage;.
26ee0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
26ef0 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 2d te3PagerGet(pBt-
26f00 3e 70 50 61 67 65 72 2c 20 6e 65 78 74 50 61 67 >pPager, nextPag
26f10 65 2c 20 26 70 44 62 50 61 67 65 2c 0a 20 20 20 e, &pDbPage,.
26f20 20 20 20 20 20 20 20 20 20 20 20 28 28 65 4f 70 ((eOp
26f30 26 30 78 30 31 29 3d 3d 30 20 3f 20 50 41 47 45 &0x01)==0 ? PAGE
26f40 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a R_GET_READONLY :
26f50 20 30 29 0a 20 20 20 20 20 20 20 20 20 20 29 3b 0). );
26f60 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
26f70 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
26f80 20 20 20 20 20 20 20 20 20 20 20 20 61 50 61 79 aPay
26f90 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 33 50 61 load = sqlite3Pa
26fa0 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 61 gerGetData(pDbPa
26fb0 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ge);.
26fc0 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 34 nextPage = get4
26fd0 62 79 74 65 28 61 50 61 79 6c 6f 61 64 29 3b 0a byte(aPayload);.
26fe0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
26ff0 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 50 copyPayload(&aP
27000 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 2b 34 5d ayload[offset+4]
27010 2c 20 70 42 75 66 2c 20 61 2c 20 28 65 4f 70 26 , pBuf, a, (eOp&
27020 30 78 30 31 29 2c 20 70 44 62 50 61 67 65 29 3b 0x01), pDbPage);
27030 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
27040 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
27050 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
27060 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 30 3b offset = 0;
27070 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
27080 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 }. a
27090 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 20 20 20 mt -= a;.
270a0 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 pBuf += a;.
270b0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 }. }. }..
270c0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
270d0 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a 20 OK && amt>0 ){.
270e0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
270f0 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
27100 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
27110 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 61 }../*.** Read pa
27120 72 74 20 6f 66 20 74 68 65 20 70 61 79 6c 6f 61 rt of the payloa
27130 64 20 66 6f 72 20 74 68 65 20 72 6f 77 20 61 74 d for the row at
27140 20 77 68 69 63 68 20 74 68 61 74 20 63 75 72 73 which that curs
27150 6f 72 20 70 43 75 72 20 69 73 20 63 75 72 72 65 or pCur is curre
27160 6e 74 6c 79 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 ntly.** pointing
27170 2e 20 20 22 61 6d 74 22 20 62 79 74 65 73 20 77 . "amt" bytes w
27180 69 6c 6c 20 62 65 20 74 72 61 6e 73 66 65 72 72 ill be transferr
27190 65 64 20 69 6e 74 6f 20 70 42 75 66 5b 5d 2e 20 ed into pBuf[].
271a0 20 54 68 65 20 74 72 61 6e 73 66 65 72 0a 2a 2a The transfer.**
271b0 20 62 65 67 69 6e 73 20 61 74 20 22 6f 66 66 73 begins at "offs
271c0 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 20 et"..**.** pCur
271d0 63 61 6e 20 62 65 20 70 6f 69 6e 74 69 6e 67 20 can be pointing
271e0 74 6f 20 65 69 74 68 65 72 20 61 20 74 61 62 6c to either a tabl
271f0 65 20 6f 72 20 61 6e 20 69 6e 64 65 78 20 62 2d e or an index b-
27200 74 72 65 65 2e 0a 2a 2a 20 49 66 20 70 6f 69 6e tree..** If poin
27210 74 69 6e 67 20 74 6f 20 61 20 74 61 62 6c 65 20 ting to a table
27220 62 74 72 65 65 2c 20 74 68 65 6e 20 74 68 65 20 btree, then the
27230 63 6f 6e 74 65 6e 74 20 73 65 63 74 69 6f 6e 20 content section
27240 69 73 20 72 65 61 64 2e 20 20 49 66 0a 2a 2a 20 is read. If.**
27250 70 43 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 pCur is pointing
27260 20 74 6f 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 to an index b-t
27270 72 65 65 20 74 68 65 6e 20 74 68 65 20 6b 65 79 ree then the key
27280 20 73 65 63 74 69 6f 6e 20 69 73 20 72 65 61 64 section is read
27290 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 73 71 6c 69 ..**.** For sqli
272a0 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 te3BtreePayload(
272b0 29 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 6d 75 ), the caller mu
272c0 73 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 70 st ensure that p
272d0 43 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 0a Cur is pointing.
272e0 2a 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 72 6f ** to a valid ro
272f0 77 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 w in the table.
27300 20 46 6f 72 20 73 71 6c 69 74 65 33 42 74 72 65 For sqlite3Btre
27310 65 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 ePayloadChecked(
27320 29 2c 20 74 68 65 0a 2a 2a 20 63 75 72 73 6f 72 ), the.** cursor
27330 20 6d 69 67 68 74 20 62 65 20 69 6e 76 61 6c 69 might be invali
27340 64 20 6f 72 20 6d 69 67 68 74 20 6e 65 65 64 20 d or might need
27350 74 6f 20 62 65 20 72 65 73 74 6f 72 65 64 20 62 to be restored b
27360 65 66 6f 72 65 20 62 65 69 6e 67 20 72 65 61 64 efore being read
27370 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 ..**.** Return S
27380 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
27390 65 73 73 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 ess or an error
273a0 63 6f 64 65 20 69 66 20 61 6e 79 74 68 69 6e 67 code if anything
273b0 20 67 6f 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 goes.** wrong.
273c0 20 41 6e 20 65 72 72 6f 72 20 69 73 20 72 65 74 An error is ret
273d0 75 72 6e 65 64 20 69 66 20 22 6f 66 66 73 65 74 urned if "offset
273e0 2b 61 6d 74 22 20 69 73 20 6c 61 72 67 65 72 20 +amt" is larger
273f0 74 68 61 6e 0a 2a 2a 20 74 68 65 20 61 76 61 69 than.** the avai
27400 6c 61 62 6c 65 20 70 61 79 6c 6f 61 64 2e 0a 2a lable payload..*
27410 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
27420 65 65 50 61 79 6c 6f 61 64 28 42 74 43 75 72 73 eePayload(BtCurs
27430 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6f 66 or *pCur, u32 of
27440 66 73 65 74 2c 20 75 33 32 20 61 6d 74 2c 20 76 fset, u32 amt, v
27450 6f 69 64 20 2a 70 42 75 66 29 7b 0a 20 20 61 73 oid *pBuf){. as
27460 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
27470 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
27480 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
27490 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
274a0 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 ALID );. assert
274b0 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 ( pCur->iPage>=0
274c0 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 65 && pCur->apPage
274d0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b [pCur->iPage] );
274e0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
274f0 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
27500 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 ge]<pCur->apPage
27510 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
27520 43 65 6c 6c 20 29 3b 0a 20 20 72 65 74 75 72 6e Cell );. return
27530 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 accessPayload(p
27540 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 Cur, offset, amt
27550 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 , (unsigned char
27560 2a 29 70 42 75 66 2c 20 30 29 3b 0a 7d 0a 23 69 *)pBuf, 0);.}.#i
27570 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
27580 54 5f 49 4e 43 52 42 4c 4f 42 0a 69 6e 74 20 73 T_INCRBLOB.int s
27590 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f qlite3BtreePaylo
275a0 61 64 43 68 65 63 6b 65 64 28 42 74 43 75 72 73 adChecked(BtCurs
275b0 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6f 66 or *pCur, u32 of
275c0 66 73 65 74 2c 20 75 33 32 20 61 6d 74 2c 20 76 fset, u32 amt, v
275d0 6f 69 64 20 2a 70 42 75 66 29 7b 0a 20 20 69 6e oid *pBuf){. in
275e0 74 20 72 63 3b 0a 20 20 69 66 20 28 20 70 43 75 t rc;. if ( pCu
275f0 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
27600 52 5f 49 4e 56 41 4c 49 44 20 29 7b 0a 20 20 20 R_INVALID ){.
27610 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 41 return SQLITE_A
27620 42 4f 52 54 3b 0a 20 20 7d 0a 20 20 61 73 73 65 BORT;. }. asse
27630 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 rt( cursorOwnsBt
27640 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a Shared(pCur) );.
27650 20 20 72 63 20 3d 20 72 65 73 74 6f 72 65 43 75 rc = restoreCu
27660 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 rsorPosition(pCu
27670 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 r);. if( rc==SQ
27680 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 LITE_OK ){. a
27690 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
276a0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
276b0 44 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 D );. assert(
276c0 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 pCur->iPage>=0
276d0 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b && pCur->apPage[
276e0 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a pCur->iPage] );.
276f0 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
27700 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
27710 61 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 age]<pCur->apPag
27720 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e e[pCur->iPage]->
27730 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 72 63 20 nCell );. rc
27740 3d 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 = accessPayload(
27750 70 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d pCur, offset, am
27760 74 2c 20 70 42 75 66 2c 20 30 29 3b 0a 20 20 7d t, pBuf, 0);. }
27770 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
27780 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
27790 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a _OMIT_INCRBLOB *
277a0 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 /../*.** Return
277b0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 70 61 79 a pointer to pay
277c0 6c 6f 61 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e load information
277d0 20 66 72 6f 6d 20 74 68 65 20 65 6e 74 72 79 20 from the entry
277e0 74 68 61 74 20 74 68 65 20 0a 2a 2a 20 70 43 75 that the .** pCu
277f0 72 20 63 75 72 73 6f 72 20 69 73 20 70 6f 69 6e r cursor is poin
27800 74 69 6e 67 20 74 6f 2e 20 20 54 68 65 20 70 6f ting to. The po
27810 69 6e 74 65 72 20 69 73 20 74 6f 20 74 68 65 20 inter is to the
27820 62 65 67 69 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 beginning of.**
27830 74 68 65 20 6b 65 79 20 69 66 20 69 6e 64 65 78 the key if index
27840 20 62 74 72 65 65 73 20 28 70 50 61 67 65 2d 3e btrees (pPage->
27850 69 6e 74 4b 65 79 3d 3d 30 29 20 61 6e 64 20 69 intKey==0) and i
27860 73 20 74 68 65 20 64 61 74 61 20 66 6f 72 0a 2a s the data for.*
27870 2a 20 74 61 62 6c 65 20 62 74 72 65 65 73 20 28 * table btrees (
27880 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 31 pPage->intKey==1
27890 29 2e 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 ). The number of
278a0 20 62 79 74 65 73 20 6f 66 20 61 76 61 69 6c 61 bytes of availa
278b0 62 6c 65 0a 2a 2a 20 6b 65 79 2f 64 61 74 61 20 ble.** key/data
278c0 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
278d0 2a 70 41 6d 74 2e 20 20 49 66 20 2a 70 41 6d 74 *pAmt. If *pAmt
278e0 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 20 76 61 ==0, then the va
278f0 6c 75 65 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 lue.** returned
27900 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 20 76 61 will not be a va
27910 6c 69 64 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a lid pointer..**.
27920 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
27930 69 73 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 is an optimizati
27940 6f 6e 2e 20 20 49 74 20 69 73 20 63 6f 6d 6d 6f on. It is commo
27950 6e 20 66 6f 72 20 74 68 65 20 65 6e 74 69 72 65 n for the entire
27960 20 6b 65 79 0a 2a 2a 20 61 6e 64 20 64 61 74 61 key.** and data
27970 20 74 6f 20 66 69 74 20 6f 6e 20 74 68 65 20 6c to fit on the l
27980 6f 63 61 6c 20 70 61 67 65 20 61 6e 64 20 66 6f ocal page and fo
27990 72 20 74 68 65 72 65 20 74 6f 20 62 65 20 6e 6f r there to be no
279a0 20 6f 76 65 72 66 6c 6f 77 0a 2a 2a 20 70 61 67 overflow.** pag
279b0 65 73 2e 20 20 57 68 65 6e 20 74 68 61 74 20 69 es. When that i
279c0 73 20 73 6f 2c 20 74 68 69 73 20 72 6f 75 74 69 s so, this routi
279d0 6e 65 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 ne can be used t
279e0 6f 20 61 63 63 65 73 73 20 74 68 65 0a 2a 2a 20 o access the.**
279f0 6b 65 79 20 61 6e 64 20 64 61 74 61 20 77 69 74 key and data wit
27a00 68 6f 75 74 20 6d 61 6b 69 6e 67 20 61 20 63 6f hout making a co
27a10 70 79 2e 20 20 49 66 20 74 68 65 20 6b 65 79 20 py. If the key
27a20 61 6e 64 2f 6f 72 20 64 61 74 61 20 73 70 69 6c and/or data spil
27a30 6c 73 0a 2a 2a 20 6f 6e 74 6f 20 6f 76 65 72 66 ls.** onto overf
27a40 6c 6f 77 20 70 61 67 65 73 2c 20 74 68 65 6e 20 low pages, then
27a50 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 accessPayload()
27a60 6d 75 73 74 20 62 65 20 75 73 65 64 20 74 6f 20 must be used to
27a70 72 65 61 73 73 65 6d 62 6c 65 0a 2a 2a 20 74 68 reassemble.** th
27a80 65 20 6b 65 79 2f 64 61 74 61 20 61 6e 64 20 63 e key/data and c
27a90 6f 70 79 20 69 74 20 69 6e 74 6f 20 61 20 70 72 opy it into a pr
27aa0 65 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 eallocated buffe
27ab0 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 r..**.** The poi
27ac0 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 62 79 nter returned by
27ad0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 6c 6f this routine lo
27ae0 6f 6b 73 20 64 69 72 65 63 74 6c 79 20 69 6e 74 oks directly int
27af0 6f 20 74 68 65 20 63 61 63 68 65 64 0a 2a 2a 20 o the cached.**
27b00 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 page of the data
27b10 62 61 73 65 2e 20 20 54 68 65 20 64 61 74 61 20 base. The data
27b20 6d 69 67 68 74 20 63 68 61 6e 67 65 20 6f 72 20 might change or
27b30 6d 6f 76 65 20 74 68 65 20 6e 65 78 74 20 74 69 move the next ti
27b40 6d 65 0a 2a 2a 20 61 6e 79 20 62 74 72 65 65 20 me.** any btree
27b50 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
27b60 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e d..*/.static con
27b70 73 74 20 76 6f 69 64 20 2a 66 65 74 63 68 50 61 st void *fetchPa
27b80 79 6c 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f yload(. BtCurso
27b90 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a r *pCur, /*
27ba0 20 43 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 Cursor pointing
27bb0 20 74 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 to entry to rea
27bc0 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 d from */. u32
27bd0 2a 70 41 6d 74 20 20 20 20 20 20 20 20 20 20 20 *pAmt
27be0 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 /* Write the nu
27bf0 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c mber of availabl
27c00 65 20 62 79 74 65 73 20 68 65 72 65 20 2a 2f 0a e bytes here */.
27c10 29 7b 0a 20 20 75 33 32 20 61 6d 74 3b 0a 20 20 ){. u32 amt;.
27c20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 assert( pCur!=0
27c30 26 26 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d && pCur->iPage>=
27c40 30 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 0 && pCur->apPag
27c50 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b e[pCur->iPage]);
27c60 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
27c70 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
27c80 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
27c90 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
27ca0 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 _held(pCur->pBtr
27cb0 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ee->db->mutex) )
27cc0 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
27cd0 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
27ce0 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
27cf0 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
27d00 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d ur->iPage]<pCur-
27d10 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
27d20 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 age]->nCell );.
27d30 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
27d40 6e 66 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 nfo.nSize>0 );.
27d50 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
27d60 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3e 70 43 75 nfo.pPayload>pCu
27d70 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
27d80 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 20 7c 7c iPage]->aData ||
27d90 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 CORRUPT_DB );.
27da0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
27db0 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3c 70 43 75 nfo.pPayload<pCu
27dc0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
27dd0 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 45 6e 64 iPage]->aDataEnd
27de0 20 7c 7c 43 4f 52 52 55 50 54 5f 44 42 29 3b 0a ||CORRUPT_DB);.
27df0 20 20 61 6d 74 20 3d 20 28 69 6e 74 29 28 70 43 amt = (int)(pC
27e00 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
27e10 3e 69 50 61 67 65 5d 2d 3e 61 44 61 74 61 45 6e >iPage]->aDataEn
27e20 64 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 d - pCur->info.p
27e30 50 61 79 6c 6f 61 64 29 3b 0a 20 20 69 66 28 20 Payload);. if(
27e40 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
27e50 6c 3c 61 6d 74 20 29 20 61 6d 74 20 3d 20 70 43 l<amt ) amt = pC
27e60 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b ur->info.nLocal;
27e70 0a 20 20 2a 70 41 6d 74 20 3d 20 61 6d 74 3b 0a . *pAmt = amt;.
27e80 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 2a 29 return (void*)
27e90 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c pCur->info.pPayl
27ea0 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 46 oad;.}.../*.** F
27eb0 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 or the entry tha
27ec0 74 20 63 75 72 73 6f 72 20 70 43 75 72 20 69 73 t cursor pCur is
27ed0 20 70 6f 69 6e 74 20 74 6f 2c 20 72 65 74 75 72 point to, retur
27ee0 6e 20 61 73 0a 2a 2a 20 6d 61 6e 79 20 62 79 74 n as.** many byt
27ef0 65 73 20 6f 66 20 74 68 65 20 6b 65 79 20 6f 72 es of the key or
27f00 20 64 61 74 61 20 61 73 20 61 72 65 20 61 76 61 data as are ava
27f10 69 6c 61 62 6c 65 20 6f 6e 20 74 68 65 20 6c 6f ilable on the lo
27f20 63 61 6c 0a 2a 2a 20 62 2d 74 72 65 65 20 70 61 cal.** b-tree pa
27f30 67 65 2e 20 20 57 72 69 74 65 20 74 68 65 20 6e ge. Write the n
27f40 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 62 umber of availab
27f50 6c 65 20 62 79 74 65 73 20 69 6e 74 6f 20 2a 70 le bytes into *p
27f60 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 Amt..**.** The p
27f70 6f 69 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 ointer returned
27f80 69 73 20 65 70 68 65 6d 65 72 61 6c 2e 20 20 54 is ephemeral. T
27f90 68 65 20 6b 65 79 2f 64 61 74 61 20 6d 61 79 20 he key/data may
27fa0 6d 6f 76 65 0a 2a 2a 20 6f 72 20 62 65 20 64 65 move.** or be de
27fb0 73 74 72 6f 79 65 64 20 6f 6e 20 74 68 65 20 6e stroyed on the n
27fc0 65 78 74 20 63 61 6c 6c 20 74 6f 20 61 6e 79 20 ext call to any
27fd0 42 74 72 65 65 20 72 6f 75 74 69 6e 65 2c 0a 2a Btree routine,.*
27fe0 2a 20 69 6e 63 6c 75 64 69 6e 67 20 63 61 6c 6c * including call
27ff0 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 74 68 72 s from other thr
28000 65 61 64 73 20 61 67 61 69 6e 73 74 20 74 68 65 eads against the
28010 20 73 61 6d 65 20 63 61 63 68 65 2e 0a 2a 2a 20 same cache..**
28020 48 65 6e 63 65 2c 20 61 20 6d 75 74 65 78 20 6f Hence, a mutex o
28030 6e 20 74 68 65 20 42 74 53 68 61 72 65 64 20 73 n the BtShared s
28040 68 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 70 72 hould be held pr
28050 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 0a 2a ior to calling.*
28060 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a * this routine..
28070 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f 75 74 **.** These rout
28080 69 6e 65 73 20 69 73 20 75 73 65 64 20 74 6f 20 ines is used to
28090 67 65 74 20 71 75 69 63 6b 20 61 63 63 65 73 73 get quick access
280a0 20 74 6f 20 6b 65 79 20 61 6e 64 20 64 61 74 61 to key and data
280b0 0a 2a 2a 20 69 6e 20 74 68 65 20 63 6f 6d 6d 6f .** in the commo
280c0 6e 20 63 61 73 65 20 77 68 65 72 65 20 6e 6f 20 n case where no
280d0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
280e0 72 65 20 75 73 65 64 2e 0a 2a 2f 0a 63 6f 6e 73 re used..*/.cons
280f0 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 42 t void *sqlite3B
28100 74 72 65 65 50 61 79 6c 6f 61 64 46 65 74 63 68 treePayloadFetch
28110 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
28120 20 75 33 32 20 2a 70 41 6d 74 29 7b 0a 20 20 72 u32 *pAmt){. r
28130 65 74 75 72 6e 20 66 65 74 63 68 50 61 79 6c 6f eturn fetchPaylo
28140 61 64 28 70 43 75 72 2c 20 70 41 6d 74 29 3b 0a ad(pCur, pAmt);.
28150 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 }.../*.** Move t
28160 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 he cursor down t
28170 6f 20 61 20 6e 65 77 20 63 68 69 6c 64 20 70 61 o a new child pa
28180 67 65 2e 20 20 54 68 65 20 6e 65 77 50 67 6e 6f ge. The newPgno
28190 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 argument is the
281a0 0a 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 72 20 .** page number
281b0 6f 66 20 74 68 65 20 63 68 69 6c 64 20 70 61 67 of the child pag
281c0 65 20 74 6f 20 6d 6f 76 65 20 74 6f 2e 0a 2a 2a e to move to..**
281d0 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
281e0 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 n returns SQLITE
281f0 5f 43 4f 52 52 55 50 54 20 69 66 20 74 68 65 20 _CORRUPT if the
28200 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c 61 67 page-header flag
28210 73 20 66 69 65 6c 64 20 6f 66 0a 2a 2a 20 74 68 s field of.** th
28220 65 20 6e 65 77 20 63 68 69 6c 64 20 70 61 67 65 e new child page
28230 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 20 does not match
28240 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 the flags field
28250 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 28 69 of the parent (i
28260 2e 65 2e 0a 2a 2a 20 69 66 20 61 6e 20 69 6e 74 .e..** if an int
28270 6b 65 79 20 70 61 67 65 20 61 70 70 65 61 72 73 key page appears
28280 20 74 6f 20 62 65 20 74 68 65 20 70 61 72 65 6e to be the paren
28290 74 20 6f 66 20 61 20 6e 6f 6e 2d 69 6e 74 6b 65 t of a non-intke
282a0 79 20 70 61 67 65 2c 20 6f 72 0a 2a 2a 20 76 69 y page, or.** vi
282b0 63 65 2d 76 65 72 73 61 29 2e 0a 2a 2f 0a 73 74 ce-versa)..*/.st
282c0 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 43 atic int moveToC
282d0 68 69 6c 64 28 42 74 43 75 72 73 6f 72 20 2a 70 hild(BtCursor *p
282e0 43 75 72 2c 20 75 33 32 20 6e 65 77 50 67 6e 6f Cur, u32 newPgno
282f0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
28300 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a Bt = pCur->pBt;.
28310 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
28320 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
28330 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
28340 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
28350 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
28360 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
28370 50 61 67 65 3c 42 54 43 55 52 53 4f 52 5f 4d 41 Page<BTCURSOR_MA
28380 58 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 73 73 X_DEPTH );. ass
28390 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 ert( pCur->iPage
283a0 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 43 75 >=0 );. if( pCu
283b0 72 2d 3e 69 50 61 67 65 3e 3d 28 42 54 43 55 52 r->iPage>=(BTCUR
283c0 53 4f 52 5f 4d 41 58 5f 44 45 50 54 48 2d 31 29 SOR_MAX_DEPTH-1)
283d0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
283e0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
283f0 50 54 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e PT;. }. pCur->
28400 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
28410 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
28420 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 &= ~(BTCF_Valid
28430 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f NKey|BTCF_ValidO
28440 76 66 6c 29 3b 0a 20 20 70 43 75 72 2d 3e 69 50 vfl);. pCur->iP
28450 61 67 65 2b 2b 3b 0a 20 20 70 43 75 72 2d 3e 61 age++;. pCur->a
28460 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 iIdx[pCur->iPage
28470 5d 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 ] = 0;. return
28480 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 getAndInitPage(p
28490 42 74 2c 20 6e 65 77 50 67 6e 6f 2c 20 26 70 43 Bt, newPgno, &pC
284a0 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
284b0 3e 69 50 61 67 65 5d 2c 0a 20 20 20 20 20 20 20 >iPage],.
284c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
284d0 20 70 43 75 72 2c 20 70 43 75 72 2d 3e 63 75 72 pCur, pCur->cur
284e0 50 61 67 65 72 46 6c 61 67 73 29 3b 0a 7d 0a 0a PagerFlags);.}..
284f0 23 69 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 #if SQLITE_DEBUG
28500 0a 2f 2a 0a 2a 2a 20 50 61 67 65 20 70 50 61 72 ./*.** Page pPar
28510 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 65 72 6e ent is an intern
28520 61 6c 20 28 6e 6f 6e 2d 6c 65 61 66 29 20 74 72 al (non-leaf) tr
28530 65 65 20 70 61 67 65 2e 20 54 68 69 73 20 66 75 ee page. This fu
28540 6e 63 74 69 6f 6e 20 0a 2a 2a 20 61 73 73 65 72 nction .** asser
28550 74 73 20 74 68 61 74 20 70 61 67 65 20 6e 75 6d ts that page num
28560 62 65 72 20 69 43 68 69 6c 64 20 69 73 20 74 68 ber iChild is th
28570 65 20 6c 65 66 74 2d 63 68 69 6c 64 20 69 66 20 e left-child if
28580 74 68 65 20 69 49 64 78 27 74 68 0a 2a 2a 20 63 the iIdx'th.** c
28590 65 6c 6c 20 69 6e 20 70 61 67 65 20 70 50 61 72 ell in page pPar
285a0 65 6e 74 2e 20 4f 72 2c 20 69 66 20 69 49 64 78 ent. Or, if iIdx
285b0 20 69 73 20 65 71 75 61 6c 20 74 6f 20 74 68 65 is equal to the
285c0 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
285d0 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 70 50 61 .** cells in pPa
285e0 72 65 6e 74 2c 20 74 68 61 74 20 70 61 67 65 20 rent, that page
285f0 6e 75 6d 62 65 72 20 69 43 68 69 6c 64 20 69 73 number iChild is
28600 20 74 68 65 20 72 69 67 68 74 2d 63 68 69 6c 64 the right-child
28610 20 6f 66 0a 2a 2a 20 74 68 65 20 70 61 67 65 2e of.** the page.
28620 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
28630 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 65 assertParentInde
28640 78 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 72 65 x(MemPage *pPare
28650 6e 74 2c 20 69 6e 74 20 69 49 64 78 2c 20 50 67 nt, int iIdx, Pg
28660 6e 6f 20 69 43 68 69 6c 64 29 7b 0a 20 20 69 66 no iChild){. if
28670 28 20 43 4f 52 52 55 50 54 5f 44 42 20 29 20 72 ( CORRUPT_DB ) r
28680 65 74 75 72 6e 3b 20 20 2f 2a 20 54 68 65 20 63 eturn; /* The c
28690 6f 6e 64 69 74 69 6f 6e 73 20 74 65 73 74 65 64 onditions tested
286a0 20 62 65 6c 6f 77 20 6d 69 67 68 74 20 6e 6f 74 below might not
286b0 20 62 65 20 74 72 75 65 0a 20 20 20 20 20 20 20 be true.
286c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
286d0 20 20 20 20 20 2a 2a 20 69 6e 20 61 20 63 6f 72 ** in a cor
286e0 72 75 70 74 20 64 61 74 61 62 61 73 65 20 2a 2f rupt database */
286f0 0a 20 20 61 73 73 65 72 74 28 20 69 49 64 78 3c . assert( iIdx<
28700 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 20 =pParent->nCell
28710 29 3b 0a 20 20 69 66 28 20 69 49 64 78 3d 3d 70 );. if( iIdx==p
28720 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 20 29 7b Parent->nCell ){
28730 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 65 74 . assert( get
28740 34 62 79 74 65 28 26 70 50 61 72 65 6e 74 2d 3e 4byte(&pParent->
28750 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d 3e 68 aData[pParent->h
28760 64 72 4f 66 66 73 65 74 2b 38 5d 29 3d 3d 69 43 drOffset+8])==iC
28770 68 69 6c 64 20 29 3b 0a 20 20 7d 65 6c 73 65 7b hild );. }else{
28780 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 65 74 . assert( get
28790 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 70 4byte(findCell(p
287a0 50 61 72 65 6e 74 2c 20 69 49 64 78 29 29 3d 3d Parent, iIdx))==
287b0 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 0a 7d 0a iChild );. }.}.
287c0 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 #else.# define
287d0 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 65 assertParentInde
287e0 78 28 78 2c 79 2c 7a 29 20 0a 23 65 6e 64 69 66 x(x,y,z) .#endif
287f0 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 ../*.** Move the
28800 20 63 75 72 73 6f 72 20 75 70 20 74 6f 20 74 68 cursor up to th
28810 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 0a 2a e parent page..*
28820 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 64 78 20 69 *.** pCur->idx i
28830 73 20 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c s set to the cel
28840 6c 20 69 6e 64 65 78 20 74 68 61 74 20 63 6f 6e l index that con
28850 74 61 69 6e 73 20 74 68 65 20 70 6f 69 6e 74 65 tains the pointe
28860 72 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 65 r.** to the page
28870 20 77 65 20 61 72 65 20 63 6f 6d 69 6e 67 20 66 we are coming f
28880 72 6f 6d 2e 20 20 49 66 20 77 65 20 61 72 65 20 rom. If we are
28890 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 74 68 65 0a coming from the.
288a0 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 20 63 68 ** right-most ch
288b0 69 6c 64 20 70 61 67 65 20 74 68 65 6e 20 70 43 ild page then pC
288c0 75 72 2d 3e 69 64 78 20 69 73 20 73 65 74 20 74 ur->idx is set t
288d0 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 68 61 6e 0a o one more than.
288e0 2a 2a 20 74 68 65 20 6c 61 72 67 65 73 74 20 63 ** the largest c
288f0 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a 2f 0a 73 74 ell index..*/.st
28900 61 74 69 63 20 76 6f 69 64 20 6d 6f 76 65 54 6f atic void moveTo
28910 50 61 72 65 6e 74 28 42 74 43 75 72 73 6f 72 20 Parent(BtCursor
28920 2a 70 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 *pCur){. assert
28930 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 ( cursorOwnsBtSh
28940 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 ared(pCur) );.
28950 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
28960 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
28970 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ID );. assert(
28980 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 20 29 3b pCur->iPage>0 );
28990 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
289a0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
289b0 61 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 72 74 age] );. assert
289c0 50 61 72 65 6e 74 49 6e 64 65 78 28 0a 20 20 20 ParentIndex(.
289d0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
289e0 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2c 20 0a 20 ur->iPage-1], .
289f0 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 pCur->aiIdx[p
28a00 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2c 20 0a Cur->iPage-1], .
28a10 20 20 20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 pCur->apPage
28a20 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 70 [pCur->iPage]->p
28a30 67 6e 6f 0a 20 20 29 3b 0a 20 20 74 65 73 74 63 gno. );. testc
28a40 61 73 65 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ase( pCur->aiIdx
28a50 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 20 [pCur->iPage-1]
28a60 3e 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 > pCur->apPage[p
28a70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2d 3e 6e Cur->iPage-1]->n
28a80 43 65 6c 6c 20 29 3b 0a 20 20 70 43 75 72 2d 3e Cell );. pCur->
28a90 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
28aa0 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
28ab0 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 &= ~(BTCF_Valid
28ac0 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f NKey|BTCF_ValidO
28ad0 76 66 6c 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 vfl);. releaseP
28ae0 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 43 75 72 2d ageNotNull(pCur-
28af0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
28b00 61 67 65 2d 2d 5d 29 3b 0a 7d 0a 0a 2f 2a 0a 2a age--]);.}../*.*
28b10 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f * Move the curso
28b20 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 r to point to th
28b30 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 69 e root page of i
28b40 74 73 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 ts b-tree struct
28b50 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ure..**.** If th
28b60 65 20 74 61 62 6c 65 20 68 61 73 20 61 20 76 69 e table has a vi
28b70 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2c rtual root page,
28b80 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
28b90 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 70 6f 69 is moved to poi
28ba0 6e 74 0a 2a 2a 20 74 6f 20 74 68 65 20 76 69 72 nt.** to the vir
28bb0 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 69 tual root page i
28bc0 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 61 63 nstead of the ac
28bd0 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 tual root page.
28be0 41 20 74 61 62 6c 65 20 68 61 73 20 61 0a 2a 2a A table has a.**
28bf0 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 virtual root pa
28c00 67 65 20 77 68 65 6e 20 74 68 65 20 61 63 74 75 ge when the actu
28c10 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 63 6f 6e al root page con
28c20 74 61 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 61 tains no cells a
28c30 6e 64 20 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 20 nd a .** single
28c40 63 68 69 6c 64 20 70 61 67 65 2e 20 54 68 69 73 child page. This
28c50 20 63 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e can only happen
28c60 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 20 with the table
28c70 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 31 rooted at page 1
28c80 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 ..**.** If the b
28c90 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 -tree structure
28ca0 69 73 20 65 6d 70 74 79 2c 20 74 68 65 20 63 75 is empty, the cu
28cb0 72 73 6f 72 20 73 74 61 74 65 20 69 73 20 73 65 rsor state is se
28cc0 74 20 74 6f 20 0a 2a 2a 20 43 55 52 53 4f 52 5f t to .** CURSOR_
28cd0 49 4e 56 41 4c 49 44 2e 20 4f 74 68 65 72 77 69 INVALID. Otherwi
28ce0 73 65 2c 20 74 68 65 20 63 75 72 73 6f 72 20 69 se, the cursor i
28cf0 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 s set to point t
28d00 6f 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 63 o the first.** c
28d10 65 6c 6c 20 6c 6f 63 61 74 65 64 20 6f 6e 20 74 ell located on t
28d20 68 65 20 72 6f 6f 74 20 28 6f 72 20 76 69 72 74 he root (or virt
28d30 75 61 6c 20 72 6f 6f 74 29 20 70 61 67 65 20 61 ual root) page a
28d40 6e 64 20 74 68 65 20 63 75 72 73 6f 72 20 73 74 nd the cursor st
28d50 61 74 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f ate.** is set to
28d60 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e 0a 2a CURSOR_VALID..*
28d70 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 66 75 6e *.** If this fun
28d80 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 73 75 ction returns su
28d90 63 63 65 73 73 66 75 6c 6c 79 2c 20 69 74 20 6d ccessfully, it m
28da0 61 79 20 62 65 20 61 73 73 75 6d 65 64 20 74 68 ay be assumed th
28db0 61 74 20 74 68 65 0a 2a 2a 20 70 61 67 65 2d 68 at the.** page-h
28dc0 65 61 64 65 72 20 66 6c 61 67 73 20 69 6e 64 69 eader flags indi
28dd0 63 61 74 65 20 74 68 61 74 20 74 68 65 20 5b 76 cate that the [v
28de0 69 72 74 75 61 6c 5d 20 72 6f 6f 74 2d 70 61 67 irtual] root-pag
28df0 65 20 69 73 20 74 68 65 20 65 78 70 65 63 74 65 e is the expecte
28e00 64 20 0a 2a 2a 20 6b 69 6e 64 20 6f 66 20 62 2d d .** kind of b-
28e10 74 72 65 65 20 70 61 67 65 20 28 69 2e 65 2e 20 tree page (i.e.
28e20 69 66 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 if when opening
28e30 74 68 65 20 63 75 72 73 6f 72 20 74 68 65 20 63 the cursor the c
28e40 61 6c 6c 65 72 20 64 69 64 20 6e 6f 74 0a 2a 2a aller did not.**
28e50 20 73 70 65 63 69 66 79 20 61 20 4b 65 79 49 6e specify a KeyIn
28e60 66 6f 20 73 74 72 75 63 74 75 72 65 20 74 68 65 fo structure the
28e70 20 66 6c 61 67 73 20 62 79 74 65 20 69 73 20 73 flags byte is s
28e80 65 74 20 74 6f 20 30 78 30 35 20 6f 72 20 30 78 et to 0x05 or 0x
28e90 30 44 2c 0a 2a 2a 20 69 6e 64 69 63 61 74 69 6e 0D,.** indicatin
28ea0 67 20 61 20 74 61 62 6c 65 20 62 2d 74 72 65 65 g a table b-tree
28eb0 2c 20 6f 72 20 69 66 20 74 68 65 20 63 61 6c 6c , or if the call
28ec0 65 72 20 64 69 64 20 73 70 65 63 69 66 79 20 61 er did specify a
28ed0 20 4b 65 79 49 6e 66 6f 20 0a 2a 2a 20 73 74 72 KeyInfo .** str
28ee0 75 63 74 75 72 65 20 74 68 65 20 66 6c 61 67 73 ucture the flags
28ef0 20 62 79 74 65 20 69 73 20 73 65 74 20 74 6f 20 byte is set to
28f00 30 78 30 32 20 6f 72 20 30 78 30 41 2c 20 69 6e 0x02 or 0x0A, in
28f10 64 69 63 61 74 69 6e 67 20 61 6e 20 69 6e 64 65 dicating an inde
28f20 78 0a 2a 2a 20 62 2d 74 72 65 65 29 2e 0a 2a 2f x.** b-tree)..*/
28f30 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 .static int move
28f40 54 6f 52 6f 6f 74 28 42 74 43 75 72 73 6f 72 20 ToRoot(BtCursor
28f50 2a 70 43 75 72 29 7b 0a 20 20 4d 65 6d 50 61 67 *pCur){. MemPag
28f60 65 20 2a 70 52 6f 6f 74 3b 0a 20 20 69 6e 74 20 e *pRoot;. int
28f70 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
28f80 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
28f90 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
28fa0 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
28fb0 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 CURSOR_INVALID
28fc0 3c 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 < CURSOR_REQUIRE
28fd0 53 45 45 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 SEEK );. assert
28fe0 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 20 ( CURSOR_VALID
28ff0 20 3c 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 < CURSOR_REQUIR
29000 45 53 45 45 4b 20 29 3b 0a 20 20 61 73 73 65 72 ESEEK );. asser
29010 74 28 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 t( CURSOR_FAULT
29020 20 20 3e 20 43 55 52 53 4f 52 5f 52 45 51 55 49 > CURSOR_REQUI
29030 52 45 53 45 45 4b 20 29 3b 0a 20 20 69 66 28 20 RESEEK );. if(
29040 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d 43 55 pCur->eState>=CU
29050 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
29060 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 ){. if( pCur
29070 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
29080 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 20 20 20 _FAULT ){.
29090 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
290a0 69 70 4e 65 78 74 21 3d 53 51 4c 49 54 45 5f 4f ipNext!=SQLITE_O
290b0 4b 20 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 K );. retur
290c0 6e 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 n pCur->skipNext
290d0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
290e0 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 72 te3BtreeClearCur
290f0 73 6f 72 28 70 43 75 72 29 3b 0a 20 20 7d 0a 0a sor(pCur);. }..
29100 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 if( pCur->iPag
29110 65 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 e>=0 ){. if(
29120 70 43 75 72 2d 3e 69 50 61 67 65 20 29 7b 0a 20 pCur->iPage ){.
29130 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 20 do{.
29140 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 assert( pCur->a
29150 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
29160 65 5d 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 e]!=0 );.
29170 20 72 65 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e releasePageNotN
29180 75 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 ull(pCur->apPage
29190 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 5d 29 [pCur->iPage--])
291a0 3b 0a 20 20 20 20 20 20 7d 77 68 69 6c 65 28 20 ;. }while(
291b0 70 43 75 72 2d 3e 69 50 61 67 65 29 3b 0a 20 20 pCur->iPage);.
291c0 20 20 20 20 67 6f 74 6f 20 73 6b 69 70 5f 69 6e goto skip_in
291d0 69 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 it;. }. }els
291e0 65 20 69 66 28 20 70 43 75 72 2d 3e 70 67 6e 6f e if( pCur->pgno
291f0 52 6f 6f 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70 Root==0 ){. p
29200 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
29210 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 RSOR_INVALID;.
29220 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
29230 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 OK;. }else{.
29240 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
29250 50 61 67 65 3d 3d 28 2d 31 29 20 29 3b 0a 20 20 Page==(-1) );.
29260 20 20 72 63 20 3d 20 67 65 74 41 6e 64 49 6e 69 rc = getAndIni
29270 74 50 61 67 65 28 70 43 75 72 2d 3e 70 42 74 72 tPage(pCur->pBtr
29280 65 65 2d 3e 70 42 74 2c 20 70 43 75 72 2d 3e 70 ee->pBt, pCur->p
29290 67 6e 6f 52 6f 6f 74 2c 20 26 70 43 75 72 2d 3e gnoRoot, &pCur->
292a0 61 70 50 61 67 65 5b 30 5d 2c 0a 20 20 20 20 20 apPage[0],.
292b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
292c0 20 20 20 30 2c 20 70 43 75 72 2d 3e 63 75 72 50 0, pCur->curP
292d0 61 67 65 72 46 6c 61 67 73 29 3b 0a 20 20 20 20 agerFlags);.
292e0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
292f0 4b 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d K ){. pCur-
29300 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
29310 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 _INVALID;.
29320 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
29330 7d 0a 20 20 20 20 70 43 75 72 2d 3e 69 50 61 67 }. pCur->iPag
29340 65 20 3d 20 30 3b 0a 20 20 20 20 70 43 75 72 2d e = 0;. pCur-
29350 3e 63 75 72 49 6e 74 4b 65 79 20 3d 20 70 43 75 >curIntKey = pCu
29360 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e r->apPage[0]->in
29370 74 4b 65 79 3b 0a 20 20 7d 0a 20 20 70 52 6f 6f tKey;. }. pRoo
29380 74 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 t = pCur->apPage
29390 5b 30 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 70 [0];. assert( p
293a0 52 6f 6f 74 2d 3e 70 67 6e 6f 3d 3d 70 43 75 72 Root->pgno==pCur
293b0 2d 3e 70 67 6e 6f 52 6f 6f 74 20 29 3b 0a 0a 20 ->pgnoRoot );..
293c0 20 2f 2a 20 49 66 20 70 43 75 72 2d 3e 70 4b 65 /* If pCur->pKe
293d0 79 49 6e 66 6f 20 69 73 20 6e 6f 74 20 4e 55 4c yInfo is not NUL
293e0 4c 2c 20 74 68 65 6e 20 74 68 65 20 63 61 6c 6c L, then the call
293f0 65 72 20 74 68 61 74 20 6f 70 65 6e 65 64 20 74 er that opened t
29400 68 69 73 20 63 75 72 73 6f 72 0a 20 20 2a 2a 20 his cursor. **
29410 65 78 70 65 63 74 65 64 20 74 6f 20 6f 70 65 6e expected to open
29420 20 69 74 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 it on an index
29430 62 2d 74 72 65 65 2e 20 4f 74 68 65 72 77 69 73 b-tree. Otherwis
29440 65 2c 20 69 66 20 70 4b 65 79 49 6e 66 6f 20 69 e, if pKeyInfo i
29450 73 0a 20 20 2a 2a 20 4e 55 4c 4c 2c 20 74 68 65 s. ** NULL, the
29460 20 63 61 6c 6c 65 72 20 65 78 70 65 63 74 73 20 caller expects
29470 61 20 74 61 62 6c 65 20 62 2d 74 72 65 65 2e 20 a table b-tree.
29480 49 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 If this is not t
29490 68 65 20 63 61 73 65 2c 0a 20 20 2a 2a 20 72 65 he case,. ** re
294a0 74 75 72 6e 20 61 6e 20 53 51 4c 49 54 45 5f 43 turn an SQLITE_C
294b0 4f 52 52 55 50 54 20 65 72 72 6f 72 2e 20 0a 20 ORRUPT error. .
294c0 20 2a 2a 0a 20 20 2a 2a 20 45 61 72 6c 69 65 72 **. ** Earlier
294d0 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
294e0 69 74 65 20 61 73 73 75 6d 65 64 20 74 68 61 74 ite assumed that
294f0 20 74 68 69 73 20 74 65 73 74 20 63 6f 75 6c 64 this test could
29500 20 6e 6f 74 20 66 61 69 6c 0a 20 20 2a 2a 20 69 not fail. ** i
29510 66 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 f the root page
29520 77 61 73 20 61 6c 72 65 61 64 79 20 6c 6f 61 64 was already load
29530 65 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e ed when this fun
29540 63 74 69 6f 6e 20 77 61 73 20 63 61 6c 6c 65 64 ction was called
29550 20 28 69 2e 65 2e 0a 20 20 2a 2a 20 69 66 20 70 (i.e.. ** if p
29560 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 29 2e 20 Cur->iPage>=0).
29570 42 75 74 20 74 68 69 73 20 69 73 20 6e 6f 74 20 But this is not
29580 73 6f 20 69 66 20 74 68 65 20 64 61 74 61 62 61 so if the databa
29590 73 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 20 se is corrupted
295a0 0a 20 20 2a 2a 20 69 6e 20 73 75 63 68 20 61 20 . ** in such a
295b0 77 61 79 20 74 68 61 74 20 70 61 67 65 20 70 52 way that page pR
295c0 6f 6f 74 20 69 73 20 6c 69 6e 6b 65 64 20 69 6e oot is linked in
295d0 74 6f 20 61 20 73 65 63 6f 6e 64 20 62 2d 74 72 to a second b-tr
295e0 65 65 20 74 61 62 6c 65 20 0a 20 20 2a 2a 20 28 ee table . ** (
295f0 6f 72 20 74 68 65 20 66 72 65 65 6c 69 73 74 29 or the freelist)
29600 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
29610 70 52 6f 6f 74 2d 3e 69 6e 74 4b 65 79 3d 3d 31 pRoot->intKey==1
29620 20 7c 7c 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b 65 || pRoot->intKe
29630 79 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 52 y==0 );. if( pR
29640 6f 6f 74 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 7c oot->isInit==0 |
29650 7c 20 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 | (pCur->pKeyInf
29660 6f 3d 3d 30 29 21 3d 70 52 6f 6f 74 2d 3e 69 6e o==0)!=pRoot->in
29670 74 4b 65 79 20 29 7b 0a 20 20 20 20 72 65 74 75 tKey ){. retu
29680 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
29690 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a 73 6b 69 T_BKPT;. }..ski
296a0 70 5f 69 6e 69 74 3a 20 20 0a 20 20 70 43 75 72 p_init: . pCur
296b0 2d 3e 61 69 49 64 78 5b 30 5d 20 3d 20 30 3b 0a ->aiIdx[0] = 0;.
296c0 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 pCur->info.nSi
296d0 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ze = 0;. pCur->
296e0 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 curFlags &= ~(BT
296f0 43 46 5f 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 CF_AtLast|BTCF_V
29700 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 alidNKey|BTCF_Va
29710 6c 69 64 4f 76 66 6c 29 3b 0a 0a 20 20 70 52 6f lidOvfl);.. pRo
29720 6f 74 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ot = pCur->apPag
29730 65 5b 30 5d 3b 0a 20 20 69 66 28 20 70 52 6f 6f e[0];. if( pRoo
29740 74 2d 3e 6e 43 65 6c 6c 3e 30 20 29 7b 0a 20 20 t->nCell>0 ){.
29750 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
29760 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 CURSOR_VALID;.
29770 20 7d 65 6c 73 65 20 69 66 28 20 21 70 52 6f 6f }else if( !pRoo
29780 74 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 t->leaf ){. P
29790 67 6e 6f 20 73 75 62 70 61 67 65 3b 0a 20 20 20 gno subpage;.
297a0 20 69 66 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f if( pRoot->pgno
297b0 21 3d 31 20 29 20 72 65 74 75 72 6e 20 53 51 4c !=1 ) return SQL
297c0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
297d0 3b 0a 20 20 20 20 73 75 62 70 61 67 65 20 3d 20 ;. subpage =
297e0 67 65 74 34 62 79 74 65 28 26 70 52 6f 6f 74 2d get4byte(&pRoot-
297f0 3e 61 44 61 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 >aData[pRoot->hd
29800 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 rOffset+8]);.
29810 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
29820 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 CURSOR_VALID;.
29830 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
29840 6c 64 28 70 43 75 72 2c 20 73 75 62 70 61 67 65 ld(pCur, subpage
29850 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
29860 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
29870 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 URSOR_INVALID;.
29880 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
29890 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 }../*.** Move th
298a0 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f e cursor down to
298b0 20 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c the left-most l
298c0 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 eaf entry beneat
298d0 68 20 74 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 h the.** entry t
298e0 6f 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 o which it is cu
298f0 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 rrently pointing
29900 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 ..**.** The left
29910 2d 6d 6f 73 74 20 6c 65 61 66 20 69 73 20 74 68 -most leaf is th
29920 65 20 6f 6e 65 20 77 69 74 68 20 74 68 65 20 73 e one with the s
29930 6d 61 6c 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 mallest key - th
29940 65 20 66 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 e first.** in as
29950 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a cending order..*
29960 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 /.static int mov
29970 65 54 6f 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 eToLeftmost(BtCu
29980 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 rsor *pCur){. P
29990 67 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 gno pgno;. int
299a0 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
299b0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
299c0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
299d0 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
299e0 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
299f0 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
29a00 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
29a10 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 . while( rc==SQ
29a20 4c 49 54 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 LITE_OK && !(pPa
29a30 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
29a40 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d e[pCur->iPage])-
29a50 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 61 73 73 >leaf ){. ass
29a60 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ert( pCur->aiIdx
29a70 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 [pCur->iPage]<pP
29a80 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 age->nCell );.
29a90 20 20 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 pgno = get4byt
29aa0 65 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 e(findCell(pPage
29ab0 2c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 , pCur->aiIdx[pC
29ac0 75 72 2d 3e 69 50 61 67 65 5d 29 29 3b 0a 20 20 ur->iPage]));.
29ad0 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
29ae0 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a ld(pCur, pgno);.
29af0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
29b00 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 .}../*.** Move t
29b10 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 he cursor down t
29b20 6f 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 o the right-most
29b30 20 6c 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 leaf entry bene
29b40 61 74 68 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 ath the.** page
29b50 74 6f 20 77 68 69 63 68 20 69 74 20 69 73 20 63 to which it is c
29b60 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e urrently pointin
29b70 67 2e 20 20 4e 6f 74 69 63 65 20 74 68 65 20 64 g. Notice the d
29b80 69 66 66 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 ifference.** bet
29b90 77 65 65 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d ween moveToLeftm
29ba0 6f 73 74 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f ost() and moveTo
29bb0 52 69 67 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f Rightmost(). mo
29bc0 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a veToLeftmost().*
29bd0 2a 20 66 69 6e 64 73 20 74 68 65 20 6c 65 66 74 * finds the left
29be0 2d 6d 6f 73 74 20 65 6e 74 72 79 20 62 65 6e 65 -most entry bene
29bf0 61 74 68 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 ath the *entry*
29c00 77 68 65 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 whereas moveToRi
29c10 67 68 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e ghtmost().** fin
29c20 64 73 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 ds the right-mos
29c30 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 t entry beneath
29c40 74 68 65 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a the *page*..**.*
29c50 2a 20 54 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 * The right-most
29c60 20 65 6e 74 72 79 20 69 73 20 74 68 65 20 6f 6e entry is the on
29c70 65 20 77 69 74 68 20 74 68 65 20 6c 61 72 67 65 e with the large
29c80 73 74 20 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 st key - the las
29c90 74 0a 2a 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 t.** key in asce
29ca0 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a nding order..*/.
29cb0 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 static int moveT
29cc0 6f 52 69 67 68 74 6d 6f 73 74 28 42 74 43 75 72 oRightmost(BtCur
29cd0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 sor *pCur){. Pg
29ce0 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 no pgno;. int r
29cf0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
29d00 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 MemPage *pPage
29d10 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 = 0;.. assert(
29d20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
29d30 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
29d40 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
29d50 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
29d60 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 21 28 70 );. while( !(p
29d70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 Page = pCur->apP
29d80 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
29d90 29 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 70 )->leaf ){. p
29da0 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 gno = get4byte(&
29db0 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 pPage->aData[pPa
29dc0 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ge->hdrOffset+8]
29dd0 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 49 );. pCur->aiI
29de0 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 dx[pCur->iPage]
29df0 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a = pPage->nCell;.
29e00 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 rc = moveToC
29e10 68 69 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 hild(pCur, pgno)
29e20 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
29e30 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 eturn rc;. }.
29e40 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
29e50 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 67 65 ->iPage] = pPage
29e60 2d 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 61 73 73 ->nCell-1;. ass
29e70 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ert( pCur->info.
29e80 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 61 73 nSize==0 );. as
29e90 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 sert( (pCur->cur
29ea0 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c Flags & BTCF_Val
29eb0 69 64 4e 4b 65 79 29 3d 3d 30 20 29 3b 0a 20 20 idNKey)==0 );.
29ec0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
29ed0 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 ;.}../* Move the
29ee0 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 66 cursor to the f
29ef0 69 72 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 irst entry in th
29f00 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e e table. Return
29f10 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e SQLITE_OK.** on
29f20 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a success. Set *
29f30 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 pRes to 0 if the
29f40 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 cursor actually
29f50 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 points to somet
29f60 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a hing.** or set *
29f70 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 pRes to 1 if the
29f80 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e table is empty.
29f90 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
29fa0 74 72 65 65 46 69 72 73 74 28 42 74 43 75 72 73 treeFirst(BtCurs
29fb0 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
29fc0 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Res){. int rc;.
29fd0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
29fe0 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
29ff0 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
2a000 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2a010 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 eld(pCur->pBtree
2a020 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
2a030 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f rc = moveToRoo
2a040 74 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 t(pCur);. if( r
2a050 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
2a060 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 if( pCur->eS
2a070 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 tate==CURSOR_INV
2a080 41 4c 49 44 20 29 7b 0a 20 20 20 20 20 20 61 73 ALID ){. as
2a090 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f sert( pCur->pgno
2a0a0 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Root==0 || pCur-
2a0b0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2a0c0 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 age]->nCell==0 )
2a0d0 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
2a0e0 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 1;. }else{.
2a0f0 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
2a100 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
2a110 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 Page]->nCell>0 )
2a120 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
2a130 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 0;. rc = mo
2a140 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 veToLeftmost(pCu
2a150 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 r);. }. }.
2a160 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
2a170 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 Move the cursor
2a180 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 to the last ent
2a190 72 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e ry in the table.
2a1a0 20 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f Return SQLITE_
2a1b0 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 63 63 65 73 73 OK.** on success
2a1c0 2e 20 20 53 65 74 20 2a 70 52 65 73 20 74 6f 20 . Set *pRes to
2a1d0 30 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 0 if the cursor
2a1e0 61 63 74 75 61 6c 6c 79 20 70 6f 69 6e 74 73 20 actually points
2a1f0 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a 2a 2a 20 to something.**
2a200 6f 72 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 or set *pRes to
2a210 31 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 1 if the table i
2a220 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 20 s empty..*/.int
2a230 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 74 sqlite3BtreeLast
2a240 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
2a250 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a 20 20 69 int *pRes){. i
2a260 6e 74 20 72 63 3b 0a 20 0a 20 20 61 73 73 65 72 nt rc;. . asser
2a270 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
2a280 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
2a290 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
2a2a0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 _mutex_held(pCur
2a2b0 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 ->pBtree->db->mu
2a2c0 74 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 tex) );.. /* If
2a2d0 20 74 68 65 20 63 75 72 73 6f 72 20 61 6c 72 65 the cursor alre
2a2e0 61 64 79 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 ady points to th
2a2f0 65 20 6c 61 73 74 20 65 6e 74 72 79 2c 20 74 68 e last entry, th
2a300 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 2a is is a no-op. *
2a310 2f 0a 20 20 69 66 28 20 43 55 52 53 4f 52 5f 56 /. if( CURSOR_V
2a320 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 ALID==pCur->eSta
2a330 74 65 20 26 26 20 28 70 43 75 72 2d 3e 63 75 72 te && (pCur->cur
2a340 46 6c 61 67 73 20 26 20 42 54 43 46 5f 41 74 4c Flags & BTCF_AtL
2a350 61 73 74 29 21 3d 30 20 29 7b 0a 23 69 66 64 65 ast)!=0 ){.#ifde
2a360 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
2a370 20 20 20 2f 2a 20 54 68 69 73 20 62 6c 6f 63 6b /* This block
2a380 20 73 65 72 76 65 73 20 74 6f 20 61 73 73 65 72 serves to asser
2a390 74 28 29 20 74 68 61 74 20 74 68 65 20 63 75 72 t() that the cur
2a3a0 73 6f 72 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 sor really does
2a3b0 70 6f 69 6e 74 20 0a 20 20 20 20 2a 2a 20 74 6f point . ** to
2a3c0 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 the last entry
2a3d0 69 6e 20 74 68 65 20 62 2d 74 72 65 65 2e 20 2a in the b-tree. *
2a3e0 2f 0a 20 20 20 20 69 6e 74 20 69 69 3b 0a 20 20 /. int ii;.
2a3f0 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 for(ii=0; ii<p
2a400 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 69 2b 2b Cur->iPage; ii++
2a410 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
2a420 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 69 5d pCur->aiIdx[ii]
2a430 3d 3d 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 ==pCur->apPage[i
2a440 69 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 i]->nCell );.
2a450 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 }. assert( p
2a460 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
2a470 3e 69 50 61 67 65 5d 3d 3d 70 43 75 72 2d 3e 61 >iPage]==pCur->a
2a480 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2a490 65 5d 2d 3e 6e 43 65 6c 6c 2d 31 20 29 3b 0a 20 e]->nCell-1 );.
2a4a0 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
2a4b0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2a4c0 61 67 65 5d 2d 3e 6c 65 61 66 20 29 3b 0a 23 65 age]->leaf );.#e
2a4d0 6e 64 69 66 0a 20 20 20 20 72 65 74 75 72 6e 20 ndif. return
2a4e0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a SQLITE_OK;. }..
2a4f0 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f rc = moveToRoo
2a500 74 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 t(pCur);. if( r
2a510 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
2a520 20 20 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 if( CURSOR_I
2a530 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 NVALID==pCur->eS
2a540 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 61 73 tate ){. as
2a550 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f sert( pCur->pgno
2a560 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Root==0 || pCur-
2a570 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2a580 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 age]->nCell==0 )
2a590 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
2a5a0 31 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 1;. }else{.
2a5b0 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
2a5c0 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
2a5d0 5f 56 41 4c 49 44 20 29 3b 0a 20 20 20 20 20 20 _VALID );.
2a5e0 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 *pRes = 0;.
2a5f0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 69 67 68 rc = moveToRigh
2a600 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 tmost(pCur);.
2a610 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
2a620 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
2a630 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c pCur->curFlags |
2a640 3d 20 42 54 43 46 5f 41 74 4c 61 73 74 3b 0a 20 = BTCF_AtLast;.
2a650 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
2a660 20 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 pCur->curFla
2a670 67 73 20 26 3d 20 7e 42 54 43 46 5f 41 74 4c 61 gs &= ~BTCF_AtLa
2a680 73 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 0a st;. }. .
2a690 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
2a6a0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 rn rc;.}../* Mov
2a6b0 65 20 74 68 65 20 63 75 72 73 6f 72 20 73 6f 20 e the cursor so
2a6c0 74 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 that it points t
2a6d0 6f 20 61 6e 20 65 6e 74 72 79 20 6e 65 61 72 20 o an entry near
2a6e0 74 68 65 20 6b 65 79 20 0a 2a 2a 20 73 70 65 63 the key .** spec
2a6f0 69 66 69 65 64 20 62 79 20 70 49 64 78 4b 65 79 ified by pIdxKey
2a700 20 6f 72 20 69 6e 74 4b 65 79 2e 20 20 20 52 65 or intKey. Re
2a710 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 turn a success c
2a720 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 49 ode..**.** For I
2a730 4e 54 4b 45 59 20 74 61 62 6c 65 73 2c 20 74 68 NTKEY tables, th
2a740 65 20 69 6e 74 4b 65 79 20 70 61 72 61 6d 65 74 e intKey paramet
2a750 65 72 20 69 73 20 75 73 65 64 2e 20 20 70 49 64 er is used. pId
2a760 78 4b 65 79 20 0a 2a 2a 20 6d 75 73 74 20 62 65 xKey .** must be
2a770 20 4e 55 4c 4c 2e 20 20 46 6f 72 20 69 6e 64 65 NULL. For inde
2a780 78 20 74 61 62 6c 65 73 2c 20 70 49 64 78 4b 65 x tables, pIdxKe
2a790 79 20 69 73 20 75 73 65 64 20 61 6e 64 20 69 6e y is used and in
2a7a0 74 4b 65 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 tKey.** is ignor
2a7b0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 ed..**.** If an
2a7c0 65 78 61 63 74 20 6d 61 74 63 68 20 69 73 20 6e exact match is n
2a7d0 6f 74 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 74 ot found, then t
2a7e0 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 77 he cursor is alw
2a7f0 61 79 73 0a 2a 2a 20 6c 65 66 74 20 70 6f 69 6e ays.** left poin
2a800 74 69 6e 67 20 61 74 20 61 20 6c 65 61 66 20 70 ting at a leaf p
2a810 61 67 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 age which would
2a820 68 6f 6c 64 20 74 68 65 20 65 6e 74 72 79 20 69 hold the entry i
2a830 66 20 69 74 0a 2a 2a 20 77 65 72 65 20 70 72 65 f it.** were pre
2a840 73 65 6e 74 2e 20 20 54 68 65 20 63 75 72 73 6f sent. The curso
2a850 72 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 6f r might point to
2a860 20 61 6e 20 65 6e 74 72 79 20 74 68 61 74 20 63 an entry that c
2a870 6f 6d 65 73 0a 2a 2a 20 62 65 66 6f 72 65 20 6f omes.** before o
2a880 72 20 61 66 74 65 72 20 74 68 65 20 6b 65 79 2e r after the key.
2a890 0a 2a 2a 0a 2a 2a 20 41 6e 20 69 6e 74 65 67 65 .**.** An intege
2a8a0 72 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 r is written int
2a8b0 6f 20 2a 70 52 65 73 20 77 68 69 63 68 20 69 73 o *pRes which is
2a8c0 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a the result of.*
2a8d0 2a 20 63 6f 6d 70 61 72 69 6e 67 20 74 68 65 20 * comparing the
2a8e0 6b 65 79 20 77 69 74 68 20 74 68 65 20 65 6e 74 key with the ent
2a8f0 72 79 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 ry to which the
2a900 63 75 72 73 6f 72 20 69 73 20 0a 2a 2a 20 70 6f cursor is .** po
2a910 69 6e 74 69 6e 67 2e 20 20 54 68 65 20 6d 65 61 inting. The mea
2a920 6e 69 6e 67 20 6f 66 20 74 68 65 20 69 6e 74 65 ning of the inte
2a930 67 65 72 20 77 72 69 74 74 65 6e 20 69 6e 74 6f ger written into
2a940 0a 2a 2a 20 2a 70 52 65 73 20 69 73 20 61 73 20 .** *pRes is as
2a950 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 follows:.**.**
2a960 20 20 20 2a 70 52 65 73 3c 30 20 20 20 20 20 20 *pRes<0
2a970 54 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 The cursor is le
2a980 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ft pointing at a
2a990 6e 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 n entry that.**
2a9a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a9b0 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e is smaller than
2a9c0 20 69 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 20 intKey/pIdxKey
2a9d0 6f 72 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 or if the table
2a9e0 69 73 20 65 6d 70 74 79 0a 2a 2a 20 20 20 20 20 is empty.**
2a9f0 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 and
2aa00 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 74 the cursor is t
2aa10 68 65 72 65 66 6f 72 65 20 6c 65 66 74 20 70 6f herefore left po
2aa20 69 6e 74 20 74 6f 20 6e 6f 74 68 69 6e 67 2e 0a int to nothing..
2aa30 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3d **.** *pRes=
2aa40 3d 30 20 20 20 20 20 54 68 65 20 63 75 72 73 6f =0 The curso
2aa50 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
2aa60 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
2aa70 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
2aa80 20 20 20 20 20 20 20 20 65 78 61 63 74 6c 79 20 exactly
2aa90 6d 61 74 63 68 65 73 20 69 6e 74 4b 65 79 2f 70 matches intKey/p
2aaa0 49 64 78 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 IdxKey..**.**
2aab0 20 20 2a 70 52 65 73 3e 30 20 20 20 20 20 20 54 *pRes>0 T
2aac0 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 he cursor is lef
2aad0 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e t pointing at an
2aae0 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 entry that.**
2aaf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ab00 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 is larger than i
2ab10 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a ntKey/pIdxKey..*
2ab20 2a 0a 2a 2a 20 46 6f 72 20 69 6e 64 65 78 20 74 *.** For index t
2ab30 61 62 6c 65 73 2c 20 74 68 65 20 70 49 64 78 4b ables, the pIdxK
2ab40 65 79 2d 3e 65 71 53 65 65 6e 20 66 69 65 6c 64 ey->eqSeen field
2ab50 20 69 73 20 73 65 74 20 74 6f 20 31 20 69 66 20 is set to 1 if
2ab60 74 68 65 72 65 0a 2a 2a 20 65 78 69 73 74 73 20 there.** exists
2ab70 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 an entry in the
2ab80 74 61 62 6c 65 20 74 68 61 74 20 65 78 61 63 74 table that exact
2ab90 6c 79 20 6d 61 74 63 68 65 73 20 70 49 64 78 4b ly matches pIdxK
2aba0 65 79 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c ey. .*/.int sql
2abb0 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 ite3BtreeMovetoU
2abc0 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 43 75 72 npacked(. BtCur
2abd0 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 sor *pCur,
2abe0 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f /* The curso
2abf0 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 20 2a 2f r to be moved */
2ac00 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 . UnpackedRecor
2ac10 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f 2a 20 55 d *pIdxKey, /* U
2ac20 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 npacked index ke
2ac30 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e 74 4b 65 y */. i64 intKe
2ac40 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y,
2ac50 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 6b 65 79 /* The table key
2ac60 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 52 69 */. int biasRi
2ac70 67 68 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f ght, /
2ac80 2a 20 49 66 20 74 72 75 65 2c 20 62 69 61 73 20 * If true, bias
2ac90 74 68 65 20 73 65 61 72 63 68 20 74 6f 20 74 68 the search to th
2aca0 65 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 e high end */.
2acb0 69 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 int *pRes
2acc0 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 /* Writ
2acd0 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 e search results
2ace0 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
2acf0 74 20 72 63 3b 0a 20 20 52 65 63 6f 72 64 43 6f t rc;. RecordCo
2ad00 6d 70 61 72 65 20 78 52 65 63 6f 72 64 43 6f 6d mpare xRecordCom
2ad10 70 61 72 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 pare;.. assert(
2ad20 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2ad30 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2ad40 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
2ad50 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e utex_held(pCur->
2ad60 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 pBtree->db->mute
2ad70 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
2ad80 70 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 74 pRes );. assert
2ad90 28 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d ( (pIdxKey==0)==
2ada0 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d (pCur->pKeyInfo=
2adb0 3d 30 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 =0) );. assert(
2adc0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
2add0 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 28 URSOR_VALID || (
2ade0 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 70 43 pIdxKey==0)==(pC
2adf0 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 21 3d 30 ur->curIntKey!=0
2ae00 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 ) );.. /* If th
2ae10 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 e cursor is alre
2ae20 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 64 20 61 ady positioned a
2ae30 74 20 74 68 65 20 70 6f 69 6e 74 20 77 65 20 61 t the point we a
2ae40 72 65 20 74 72 79 69 6e 67 0a 20 20 2a 2a 20 74 re trying. ** t
2ae50 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 65 6e 20 o move to, then
2ae60 6a 75 73 74 20 72 65 74 75 72 6e 20 77 69 74 68 just return with
2ae70 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 20 77 6f out doing any wo
2ae80 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 49 64 78 rk */. if( pIdx
2ae90 4b 65 79 3d 3d 30 0a 20 20 20 26 26 20 70 43 75 Key==0. && pCu
2aea0 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
2aeb0 52 5f 56 41 4c 49 44 20 26 26 20 28 70 43 75 72 R_VALID && (pCur
2aec0 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2aed0 46 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d 30 0a F_ValidNKey)!=0.
2aee0 20 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 ){. if( pCu
2aef0 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e r->info.nKey==in
2af00 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 tKey ){. *p
2af10 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 Res = 0;. r
2af20 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2af30 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 28 . }. if( (
2af40 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 pCur->curFlags &
2af50 20 42 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 BTCF_AtLast)!=0
2af60 20 26 26 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e && pCur->info.n
2af70 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 Key<intKey ){.
2af80 20 20 20 20 2a 70 52 65 73 20 3d 20 2d 31 3b 0a *pRes = -1;.
2af90 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
2afa0 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 ITE_OK;. }.
2afb0 7d 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 }.. if( pIdxKey
2afc0 20 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 ){. xRecordC
2afd0 6f 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 33 ompare = sqlite3
2afe0 56 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 28 VdbeFindCompare(
2aff0 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 49 pIdxKey);. pI
2b000 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 3d dxKey->errCode =
2b010 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 0;. assert(
2b020 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c 74 pIdxKey->default
2b030 5f 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 20 _rc==1 .
2b040 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 || pIdxKey->def
2b050 61 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 20 ault_rc==0 .
2b060 20 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d || pIdxKey-
2b070 3e 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 0a >default_rc==-1.
2b080 20 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a );. }else{.
2b090 20 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 xRecordCompa
2b0a0 72 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 6b re = 0; /* All k
2b0b0 65 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 73 eys are integers
2b0c0 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 */. }.. rc =
2b0d0 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 moveToRoot(pCur)
2b0e0 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
2b0f0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
2b100 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2b110 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 >pgnoRoot==0 ||
2b120 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
2b130 72 2d 3e 69 50 61 67 65 5d 20 29 3b 0a 20 20 61 r->iPage] );. a
2b140 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e ssert( pCur->pgn
2b150 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 oRoot==0 || pCur
2b160 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
2b170 50 61 67 65 5d 2d 3e 69 73 49 6e 69 74 20 29 3b Page]->isInit );
2b180 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2b190 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
2b1a0 49 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d INVALID || pCur-
2b1b0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2b1c0 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b age]->nCell>0 );
2b1d0 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
2b1e0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 ate==CURSOR_INVA
2b1f0 4c 49 44 20 29 7b 0a 20 20 20 20 2a 70 52 65 73 LID ){. *pRes
2b200 20 3d 20 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 = -1;. asser
2b210 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f t( pCur->pgnoRoo
2b220 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 70 t==0 || pCur->ap
2b230 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
2b240 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 ]->nCell==0 );.
2b250 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2b260 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 _OK;. }. asser
2b270 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t( pCur->apPage[
2b280 30 5d 2d 3e 69 6e 74 4b 65 79 3d 3d 70 43 75 72 0]->intKey==pCur
2b290 2d 3e 63 75 72 49 6e 74 4b 65 79 20 29 3b 0a 20 ->curIntKey );.
2b2a0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 63 assert( pCur->c
2b2b0 75 72 49 6e 74 4b 65 79 20 7c 7c 20 70 49 64 78 urIntKey || pIdx
2b2c0 4b 65 79 20 29 3b 0a 20 20 66 6f 72 28 3b 3b 29 Key );. for(;;)
2b2d0 7b 0a 20 20 20 20 69 6e 74 20 6c 77 72 2c 20 75 {. int lwr, u
2b2e0 70 72 2c 20 69 64 78 2c 20 63 3b 0a 20 20 20 20 pr, idx, c;.
2b2f0 50 67 6e 6f 20 63 68 6c 64 50 67 3b 0a 20 20 20 Pgno chldPg;.
2b300 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 MemPage *pPage
2b310 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 = pCur->apPage[p
2b320 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 20 Cur->iPage];.
2b330 20 75 38 20 2a 70 43 65 6c 6c 3b 20 20 20 20 20 u8 *pCell;
2b340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b350 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
2b360 74 6f 20 63 75 72 72 65 6e 74 20 63 65 6c 6c 20 to current cell
2b370 69 6e 20 70 50 61 67 65 20 2a 2f 0a 0a 20 20 20 in pPage */..
2b380 20 2f 2a 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c /* pPage->nCell
2b390 20 6d 75 73 74 20 62 65 20 67 72 65 61 74 65 72 must be greater
2b3a0 20 74 68 61 6e 20 7a 65 72 6f 2e 20 49 66 20 74 than zero. If t
2b3b0 68 69 73 20 69 73 20 74 68 65 20 72 6f 6f 74 2d his is the root-
2b3c0 70 61 67 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 page. ** the
2b3d0 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 68 61 76 cursor would hav
2b3e0 65 20 62 65 65 6e 20 49 4e 56 41 4c 49 44 20 61 e been INVALID a
2b3f0 62 6f 76 65 20 61 6e 64 20 74 68 69 73 20 66 6f bove and this fo
2b400 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 20 20 20 2a r(;;) loop. *
2b410 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 66 20 74 68 * not run. If th
2b420 69 73 20 69 73 20 6e 6f 74 20 74 68 65 20 72 6f is is not the ro
2b430 6f 74 2d 70 61 67 65 2c 20 74 68 65 6e 20 74 68 ot-page, then th
2b440 65 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 e moveToChild()
2b450 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a 2a 20 77 routine. ** w
2b460 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 ould have alread
2b470 79 20 64 65 74 65 63 74 65 64 20 64 62 20 63 6f y detected db co
2b480 72 72 75 70 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 rruption. Simila
2b490 72 6c 79 2c 20 70 50 61 67 65 20 6d 75 73 74 0a rly, pPage must.
2b4a0 20 20 20 20 2a 2a 20 62 65 20 74 68 65 20 72 69 ** be the ri
2b4b0 67 68 74 20 6b 69 6e 64 20 28 69 6e 64 65 78 20 ght kind (index
2b4c0 6f 72 20 74 61 62 6c 65 29 20 6f 66 20 62 2d 74 or table) of b-t
2b4d0 72 65 65 20 70 61 67 65 2e 20 4f 74 68 65 72 77 ree page. Otherw
2b4e0 69 73 65 0a 20 20 20 20 2a 2a 20 61 20 6d 6f 76 ise. ** a mov
2b4f0 65 54 6f 43 68 69 6c 64 28 29 20 6f 72 20 6d 6f eToChild() or mo
2b500 76 65 54 6f 52 6f 6f 74 28 29 20 63 61 6c 6c 20 veToRoot() call
2b510 77 6f 75 6c 64 20 68 61 76 65 20 64 65 74 65 63 would have detec
2b520 74 65 64 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 ted corruption.
2b530 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
2b540 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 29 pPage->nCell>0 )
2b550 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
2b560 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 28 70 49 age->intKey==(pI
2b570 64 78 4b 65 79 3d 3d 30 29 20 29 3b 0a 20 20 20 dxKey==0) );.
2b580 20 6c 77 72 20 3d 20 30 3b 0a 20 20 20 20 75 70 lwr = 0;. up
2b590 72 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c r = pPage->nCell
2b5a0 2d 31 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 -1;. assert(
2b5b0 62 69 61 73 52 69 67 68 74 3d 3d 30 20 7c 7c 20 biasRight==0 ||
2b5c0 62 69 61 73 52 69 67 68 74 3d 3d 31 20 29 3b 0a biasRight==1 );.
2b5d0 20 20 20 20 69 64 78 20 3d 20 75 70 72 3e 3e 28 idx = upr>>(
2b5e0 31 2d 62 69 61 73 52 69 67 68 74 29 3b 20 2f 2a 1-biasRight); /*
2b5f0 20 69 64 78 20 3d 20 62 69 61 73 52 69 67 68 74 idx = biasRight
2b600 20 3f 20 75 70 72 20 3a 20 28 6c 77 72 2b 75 70 ? upr : (lwr+up
2b610 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 70 43 75 r)/2; */. pCu
2b620 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
2b630 50 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 Page] = (u16)idx
2b640 3b 0a 20 20 20 20 69 66 28 20 78 52 65 63 6f 72 ;. if( xRecor
2b650 64 43 6f 6d 70 61 72 65 3d 3d 30 20 29 7b 0a 20 dCompare==0 ){.
2b660 20 20 20 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 for(;;){.
2b670 20 20 20 20 20 20 69 36 34 20 6e 43 65 6c 6c 4b i64 nCellK
2b680 65 79 3b 0a 20 20 20 20 20 20 20 20 70 43 65 6c ey;. pCel
2b690 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 l = findCellPast
2b6a0 50 74 72 28 70 50 61 67 65 2c 20 69 64 78 29 3b Ptr(pPage, idx);
2b6b0 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50 61 . if( pPa
2b6c0 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 ge->intKeyLeaf )
2b6d0 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 69 6c {. whil
2b6e0 65 28 20 30 78 38 30 20 3c 3d 20 2a 28 70 43 65 e( 0x80 <= *(pCe
2b6f0 6c 6c 2b 2b 29 20 29 7b 0a 20 20 20 20 20 20 20 ll++) ){.
2b700 20 20 20 20 20 69 66 28 20 70 43 65 6c 6c 3e 3d if( pCell>=
2b710 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
2b720 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
2b730 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
2b740 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2b750 20 20 7d 0a 20 20 20 20 20 20 20 20 67 65 74 56 }. getV
2b760 61 72 69 6e 74 28 70 43 65 6c 6c 2c 20 28 75 36 arint(pCell, (u6
2b770 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 4*)&nCellKey);.
2b780 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c if( nCell
2b790 4b 65 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 Key<intKey ){.
2b7a0 20 20 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 lwr = id
2b7b0 78 2b 31 3b 0a 20 20 20 20 20 20 20 20 20 20 69 x+1;. i
2b7c0 66 28 20 6c 77 72 3e 75 70 72 20 29 7b 20 63 20 f( lwr>upr ){ c
2b7d0 3d 20 2d 31 3b 20 62 72 65 61 6b 3b 20 7d 0a 20 = -1; break; }.
2b7e0 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 }else if(
2b7f0 20 6e 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b 65 79 nCellKey>intKey
2b800 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 70 ){. up
2b810 72 20 3d 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 r = idx-1;.
2b820 20 20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 if( lwr>upr
2b830 20 29 7b 20 63 20 3d 20 2b 31 3b 20 62 72 65 61 ){ c = +1; brea
2b840 6b 3b 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c k; }. }el
2b850 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 se{. as
2b860 73 65 72 74 28 20 6e 43 65 6c 6c 4b 65 79 3d 3d sert( nCellKey==
2b870 69 6e 74 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 intKey );.
2b880 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b pCur->aiIdx[
2b890 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 pCur->iPage] = (
2b8a0 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 u16)idx;.
2b8b0 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c if( !pPage->l
2b8c0 65 61 66 20 29 7b 0a 20 20 20 20 20 20 20 20 20 eaf ){.
2b8d0 20 20 20 6c 77 72 20 3d 20 69 64 78 3b 0a 20 20 lwr = idx;.
2b8e0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d goto m
2b8f0 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c 61 79 65 72 oveto_next_layer
2b900 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 ;. }els
2b910 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 e{. p
2b920 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d Cur->curFlags |=
2b930 20 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 3b BTCF_ValidNKey;
2b940 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 . pCu
2b950 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 20 3d 20 6e r->info.nKey = n
2b960 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 CellKey;.
2b970 20 20 20 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e pCur->info.
2b980 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 20 20 20 nSize = 0;.
2b990 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 *pRes = 0
2b9a0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 ;. re
2b9b0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2b9c0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2b9d0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 }. as
2b9e0 73 65 72 74 28 20 6c 77 72 2b 75 70 72 3e 3d 30 sert( lwr+upr>=0
2b9f0 20 29 3b 0a 20 20 20 20 20 20 20 20 69 64 78 20 );. idx
2ba00 3d 20 28 6c 77 72 2b 75 70 72 29 3e 3e 31 3b 20 = (lwr+upr)>>1;
2ba10 20 2f 2a 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 /* idx = (lwr+u
2ba20 70 72 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 20 20 pr)/2; */.
2ba30 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
2ba40 20 20 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 for(;;){.
2ba50 20 20 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 int nCell;
2ba60 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 /* Size of the p
2ba70 43 65 6c 6c 20 63 65 6c 6c 20 69 6e 20 62 79 74 Cell cell in byt
2ba80 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 43 es */. pC
2ba90 65 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 50 61 ell = findCellPa
2baa0 73 74 50 74 72 28 70 50 61 67 65 2c 20 69 64 78 stPtr(pPage, idx
2bab0 29 3b 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 );.. /* T
2bac0 68 65 20 6d 61 78 69 6d 75 6d 20 73 75 70 70 6f he maximum suppo
2bad0 72 74 65 64 20 70 61 67 65 2d 73 69 7a 65 20 69 rted page-size i
2bae0 73 20 36 35 35 33 36 20 62 79 74 65 73 2e 20 54 s 65536 bytes. T
2baf0 68 69 73 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 his means that.
2bb00 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 ** the ma
2bb10 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 ximum number of
2bb20 72 65 63 6f 72 64 20 62 79 74 65 73 20 73 74 6f record bytes sto
2bb30 72 65 64 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 red on an index
2bb40 42 2d 54 72 65 65 0a 20 20 20 20 20 20 20 20 2a B-Tree. *
2bb50 2a 20 70 61 67 65 20 69 73 20 6c 65 73 73 20 74 * page is less t
2bb60 68 61 6e 20 31 36 33 38 34 20 62 79 74 65 73 20 han 16384 bytes
2bb70 61 6e 64 20 6d 61 79 20 62 65 20 73 74 6f 72 65 and may be store
2bb80 64 20 61 73 20 61 20 32 2d 62 79 74 65 0a 20 20 d as a 2-byte.
2bb90 20 20 20 20 20 20 2a 2a 20 76 61 72 69 6e 74 2e ** varint.
2bba0 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f This informatio
2bbb0 6e 20 69 73 20 75 73 65 64 20 74 6f 20 61 74 74 n is used to att
2bbc0 65 6d 70 74 20 74 6f 20 61 76 6f 69 64 20 70 61 empt to avoid pa
2bbd0 72 73 69 6e 67 20 0a 20 20 20 20 20 20 20 20 2a rsing . *
2bbe0 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 65 6c * the entire cel
2bbf0 6c 20 62 79 20 63 68 65 63 6b 69 6e 67 20 66 6f l by checking fo
2bc00 72 20 74 68 65 20 63 61 73 65 73 20 77 68 65 72 r the cases wher
2bc10 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 e the record is
2bc20 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 . ** stor
2bc30 65 64 20 65 6e 74 69 72 65 6c 79 20 77 69 74 68 ed entirely with
2bc40 69 6e 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 in the b-tree pa
2bc50 67 65 20 62 79 20 69 6e 73 70 65 63 74 69 6e 67 ge by inspecting
2bc60 20 74 68 65 20 66 69 72 73 74 20 0a 20 20 20 20 the first .
2bc70 20 20 20 20 2a 2a 20 32 20 62 79 74 65 73 20 6f ** 2 bytes o
2bc80 66 20 74 68 65 20 63 65 6c 6c 2e 0a 20 20 20 20 f the cell..
2bc90 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6e */. n
2bca0 43 65 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 5d 3b Cell = pCell[0];
2bcb0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 . if( nCe
2bcc0 6c 6c 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 31 62 ll<=pPage->max1b
2bcd0 79 74 65 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 ytePayload ){.
2bce0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 /* This
2bcf0 62 72 61 6e 63 68 20 72 75 6e 73 20 69 66 20 74 branch runs if t
2bd00 68 65 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 he record-size f
2bd10 69 65 6c 64 20 6f 66 20 74 68 65 20 63 65 6c 6c ield of the cell
2bd20 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 is a.
2bd30 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 65 20 76 ** single byte v
2bd40 61 72 69 6e 74 20 61 6e 64 20 74 68 65 20 72 65 arint and the re
2bd50 63 6f 72 64 20 66 69 74 73 20 65 6e 74 69 72 65 cord fits entire
2bd60 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 ly on the main.
2bd70 20 20 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 ** b-tr
2bd80 65 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 ee page. */.
2bd90 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
2bda0 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d pCell+nCell+1==
2bdb0 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 pPage->aDataEnd
2bdc0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d );. c =
2bdd0 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 xRecordCompare(
2bde0 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 nCell, (void*)&p
2bdf0 43 65 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b 65 79 Cell[1], pIdxKey
2be00 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 );. }else
2be10 20 69 66 28 20 21 28 70 43 65 6c 6c 5b 31 5d 20 if( !(pCell[1]
2be20 26 20 30 78 38 30 29 20 0a 20 20 20 20 20 20 20 & 0x80) .
2be30 20 20 20 26 26 20 28 6e 43 65 6c 6c 20 3d 20 28 && (nCell = (
2be40 28 6e 43 65 6c 6c 26 30 78 37 66 29 3c 3c 37 29 (nCell&0x7f)<<7)
2be50 20 2b 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 70 50 + pCell[1])<=pP
2be60 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a 20 20 age->maxLocal.
2be70 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
2be80 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 /* The record
2be90 2d 73 69 7a 65 20 66 69 65 6c 64 20 69 73 20 61 -size field is a
2bea0 20 32 20 62 79 74 65 20 76 61 72 69 6e 74 20 61 2 byte varint a
2beb0 6e 64 20 74 68 65 20 72 65 63 6f 72 64 20 0a 20 nd the record .
2bec0 20 20 20 20 20 20 20 20 20 2a 2a 20 66 69 74 73 ** fits
2bed0 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 entirely on the
2bee0 20 6d 61 69 6e 20 62 2d 74 72 65 65 20 70 61 67 main b-tree pag
2bef0 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 e. */.
2bf00 20 74 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c testcase( pCell
2bf10 2b 6e 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d +nCell+2==pPage-
2bf20 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 >aDataEnd );.
2bf30 20 20 20 20 20 20 20 63 20 3d 20 78 52 65 63 6f c = xReco
2bf40 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c rdCompare(nCell,
2bf50 20 28 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 32 (void*)&pCell[2
2bf60 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 ], pIdxKey);.
2bf70 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
2bf80 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 /* The rec
2bf90 6f 72 64 20 66 6c 6f 77 73 20 6f 76 65 72 20 6f ord flows over o
2bfa0 6e 74 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 nto one or more
2bfb0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 overflow pages.
2bfc0 49 6e 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 In. **
2bfd0 74 68 69 73 20 63 61 73 65 20 74 68 65 20 77 68 this case the wh
2bfe0 6f 6c 65 20 63 65 6c 6c 20 6e 65 65 64 73 20 74 ole cell needs t
2bff0 6f 20 62 65 20 70 61 72 73 65 64 2c 20 61 20 62 o be parsed, a b
2c000 75 66 66 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a uffer allocated.
2c010 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 ** and
2c020 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 accessPayload()
2c030 20 75 73 65 64 20 74 6f 20 72 65 74 72 69 65 76 used to retriev
2c040 65 20 74 68 65 20 72 65 63 6f 72 64 20 69 6e 74 e the record int
2c050 6f 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 o the.
2c060 2a 2a 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 ** buffer before
2c070 20 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 VdbeRecordCompa
2c080 72 65 28 29 20 63 61 6e 20 62 65 20 63 61 6c 6c re() can be call
2c090 65 64 2e 20 0a 20 20 20 20 20 20 20 20 20 20 2a ed. . *
2c0a0 2a 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 49 *. ** I
2c0b0 66 20 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 f the record is
2c0c0 63 6f 72 72 75 70 74 2c 20 74 68 65 20 78 52 65 corrupt, the xRe
2c0d0 63 6f 72 64 43 6f 6d 70 61 72 65 20 72 6f 75 74 cordCompare rout
2c0e0 69 6e 65 20 6d 61 79 20 72 65 61 64 0a 20 20 20 ine may read.
2c0f0 20 20 20 20 20 20 20 2a 2a 20 75 70 20 74 6f 20 ** up to
2c100 74 77 6f 20 76 61 72 69 6e 74 73 20 70 61 73 74 two varints past
2c110 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
2c120 62 75 66 66 65 72 2e 20 41 6e 20 65 78 74 72 61 buffer. An extra
2c130 20 31 38 20 0a 20 20 20 20 20 20 20 20 20 20 2a 18 . *
2c140 2a 20 62 79 74 65 73 20 6f 66 20 70 61 64 64 69 * bytes of paddi
2c150 6e 67 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 ng is allocated
2c160 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 at the end of th
2c170 65 20 62 75 66 66 65 72 20 69 6e 0a 20 20 20 20 e buffer in.
2c180 20 20 20 20 20 20 2a 2a 20 63 61 73 65 20 74 68 ** case th
2c190 69 73 20 68 61 70 70 65 6e 73 2e 20 20 2a 2f 0a is happens. */.
2c1a0 20 20 20 20 20 20 20 20 20 20 76 6f 69 64 20 2a void *
2c1b0 70 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 pCellKey;.
2c1c0 20 20 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 u8 * const p
2c1d0 43 65 6c 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c CellBody = pCell
2c1e0 20 2d 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 - pPage->childP
2c1f0 74 72 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 trSize;.
2c200 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 pPage->xParseC
2c210 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c ell(pPage, pCell
2c220 42 6f 64 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 Body, &pCur->inf
2c230 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 43 o);. nC
2c240 65 6c 6c 20 3d 20 28 69 6e 74 29 70 43 75 72 2d ell = (int)pCur-
2c250 3e 69 6e 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 >info.nKey;.
2c260 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
2c270 6e 43 65 6c 6c 3c 30 20 29 3b 20 20 20 2f 2a 20 nCell<0 ); /*
2c280 54 72 75 65 20 69 66 20 6b 65 79 20 73 69 7a 65 True if key size
2c290 20 69 73 20 32 5e 33 32 20 6f 72 20 6d 6f 72 65 is 2^32 or more
2c2a0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 */. te
2c2b0 73 74 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 30 stcase( nCell==0
2c2c0 20 29 3b 20 20 2f 2a 20 49 6e 76 61 6c 69 64 20 ); /* Invalid
2c2d0 6b 65 79 20 73 69 7a 65 3a 20 20 30 78 38 30 20 key size: 0x80
2c2e0 30 78 38 30 20 30 78 30 30 20 2a 2f 0a 20 20 20 0x80 0x00 */.
2c2f0 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
2c300 20 6e 43 65 6c 6c 3d 3d 31 20 29 3b 20 20 2f 2a nCell==1 ); /*
2c310 20 49 6e 76 61 6c 69 64 20 6b 65 79 20 73 69 7a Invalid key siz
2c320 65 3a 20 20 30 78 38 30 20 30 78 38 30 20 30 78 e: 0x80 0x80 0x
2c330 30 31 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 01 */.
2c340 74 65 73 74 63 61 73 65 28 20 6e 43 65 6c 6c 3d testcase( nCell=
2c350 3d 32 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 =2 ); /* Minimu
2c360 6d 20 6c 65 67 61 6c 20 69 6e 64 65 78 20 6b 65 m legal index ke
2c370 79 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20 y size */.
2c380 20 20 20 20 69 66 28 20 6e 43 65 6c 6c 3c 32 20 if( nCell<2
2c390 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 ){. r
2c3a0 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
2c3b0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 PT_BKPT;.
2c3c0 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f goto moveto
2c3d0 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 _finish;.
2c3e0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 }. p
2c3f0 43 65 6c 6c 4b 65 79 20 3d 20 73 71 6c 69 74 65 CellKey = sqlite
2c400 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 6c 6c 2b 31 3Malloc( nCell+1
2c410 38 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 8 );. i
2c420 66 28 20 70 43 65 6c 6c 4b 65 79 3d 3d 30 20 29 f( pCellKey==0 )
2c430 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 {. rc
2c440 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f = SQLITE_NOMEM_
2c450 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 BKPT;.
2c460 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 goto moveto_fi
2c470 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 nish;.
2c480 7d 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 72 }. pCur
2c490 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2c4a0 61 67 65 5d 20 3d 20 28 75 31 36 29 69 64 78 3b age] = (u16)idx;
2c4b0 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
2c4c0 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 43 accessPayload(pC
2c4d0 75 72 2c 20 30 2c 20 6e 43 65 6c 6c 2c 20 28 75 ur, 0, nCell, (u
2c4e0 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 29 70 43 nsigned char*)pC
2c4f0 65 6c 6c 4b 65 79 2c 20 32 29 3b 0a 20 20 20 20 ellKey, 2);.
2c500 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
2c510 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
2c520 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 te3_free(pCellKe
2c530 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 y);.
2c540 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 goto moveto_fini
2c550 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a sh;. }.
2c560 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 52 c = xR
2c570 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 ecordCompare(nCe
2c580 6c 6c 2c 20 70 43 65 6c 6c 4b 65 79 2c 20 70 49 ll, pCellKey, pI
2c590 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20 dxKey);.
2c5a0 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
2c5b0 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 20 20 CellKey);.
2c5c0 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 65 }. asse
2c5d0 72 74 28 20 0a 20 20 20 20 20 20 20 20 20 20 20 rt( .
2c5e0 20 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 6f (pIdxKey->errCo
2c5f0 64 65 21 3d 53 51 4c 49 54 45 5f 43 4f 52 52 55 de!=SQLITE_CORRU
2c600 50 54 20 7c 7c 20 63 3d 3d 30 29 0a 20 20 20 20 PT || c==0).
2c610 20 20 20 20 20 26 26 20 28 70 49 64 78 4b 65 79 && (pIdxKey
2c620 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 ->errCode!=SQLIT
2c630 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 70 43 75 72 2d E_NOMEM || pCur-
2c640 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 61 6c >pBtree->db->mal
2c650 6c 6f 63 46 61 69 6c 65 64 29 0a 20 20 20 20 20 locFailed).
2c660 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 );. if
2c670 28 20 63 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 ( c<0 ){.
2c680 20 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 3b 0a lwr = idx+1;.
2c690 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
2c6a0 28 20 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 ( c>0 ){.
2c6b0 20 20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b 0a upr = idx-1;.
2c6c0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
2c6d0 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 assert(
2c6e0 20 63 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 c==0 );.
2c6f0 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
2c700 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
2c710 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 ITE_OK;.
2c720 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 pCur->aiIdx[pC
2c730 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 ur->iPage] = (u1
2c740 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 6)idx;.
2c750 20 69 66 28 20 70 49 64 78 4b 65 79 2d 3e 65 72 if( pIdxKey->er
2c760 72 43 6f 64 65 20 29 20 72 63 20 3d 20 53 51 4c rCode ) rc = SQL
2c770 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 20 20 20 ITE_CORRUPT;.
2c780 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 goto move
2c790 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 to_finish;.
2c7a0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 }. if(
2c7b0 20 6c 77 72 3e 75 70 72 20 29 20 62 72 65 61 6b lwr>upr ) break
2c7c0 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 ;. assert
2c7d0 28 20 6c 77 72 2b 75 70 72 3e 3d 30 20 29 3b 0a ( lwr+upr>=0 );.
2c7e0 20 20 20 20 20 20 20 20 69 64 78 20 3d 20 28 6c idx = (l
2c7f0 77 72 2b 75 70 72 29 3e 3e 31 3b 20 20 2f 2a 20 wr+upr)>>1; /*
2c800 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 2f idx = (lwr+upr)/
2c810 32 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 2 */. }.
2c820 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 6c }. assert( l
2c830 77 72 3d 3d 75 70 72 2b 31 20 7c 7c 20 28 70 50 wr==upr+1 || (pP
2c840 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 20 21 age->intKey && !
2c850 70 50 61 67 65 2d 3e 6c 65 61 66 29 20 29 3b 0a pPage->leaf) );.
2c860 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
2c870 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a 20 20 20 e->isInit );.
2c880 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 if( pPage->leaf
2c890 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ){. assert
2c8a0 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 ( pCur->aiIdx[pC
2c8b0 75 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d ur->iPage]<pCur-
2c8c0 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2c8d0 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 age]->nCell );.
2c8e0 20 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 pCur->aiIdx
2c8f0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 [pCur->iPage] =
2c900 28 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 (u16)idx;.
2c910 2a 70 52 65 73 20 3d 20 63 3b 0a 20 20 20 20 20 *pRes = c;.
2c920 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
2c930 0a 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 . goto move
2c940 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 7d to_finish;. }
2c950 0a 6d 6f 76 65 74 6f 5f 6e 65 78 74 5f 6c 61 79 .moveto_next_lay
2c960 65 72 3a 0a 20 20 20 20 69 66 28 20 6c 77 72 3e er:. if( lwr>
2c970 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b =pPage->nCell ){
2c980 0a 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 . chldPg =
2c990 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d get4byte(&pPage-
2c9a0 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 >aData[pPage->hd
2c9b0 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 rOffset+8]);.
2c9c0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 63 68 }else{. ch
2c9d0 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 28 ldPg = get4byte(
2c9e0 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
2c9f0 6c 77 72 29 29 3b 0a 20 20 20 20 7d 0a 20 20 20 lwr));. }.
2ca00 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 pCur->aiIdx[pCu
2ca10 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 r->iPage] = (u16
2ca20 29 6c 77 72 3b 0a 20 20 20 20 72 63 20 3d 20 6d )lwr;. rc = m
2ca30 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c oveToChild(pCur,
2ca40 20 63 68 6c 64 50 67 29 3b 0a 20 20 20 20 69 66 chldPg);. if
2ca50 28 20 72 63 20 29 20 62 72 65 61 6b 3b 0a 20 20 ( rc ) break;.
2ca60 7d 0a 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3a }.moveto_finish:
2ca70 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 . pCur->info.nS
2ca80 69 7a 65 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 ize = 0;. asser
2ca90 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 t( (pCur->curFla
2caa0 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f gs & BTCF_ValidO
2cab0 76 66 6c 29 3d 3d 30 20 29 3b 0a 20 20 72 65 74 vfl)==0 );. ret
2cac0 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a urn rc;.}.../*.*
2cad0 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 * Return TRUE if
2cae0 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 6e the cursor is n
2caf0 6f 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ot pointing at a
2cb00 6e 20 65 6e 74 72 79 20 6f 66 20 74 68 65 20 74 n entry of the t
2cb10 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 52 55 45 able..**.** TRUE
2cb20 20 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 will be returne
2cb30 64 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20 74 d after a call t
2cb40 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 o sqlite3BtreeNe
2cb50 78 74 28 29 20 6d 6f 76 65 73 0a 2a 2a 20 70 61 xt() moves.** pa
2cb60 73 74 20 74 68 65 20 6c 61 73 74 20 65 6e 74 72 st the last entr
2cb70 79 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 6f y in the table o
2cb80 72 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 72 r sqlite3BtreePr
2cb90 65 76 28 29 20 6d 6f 76 65 73 20 70 61 73 74 0a ev() moves past.
2cba0 2a 2a 20 74 68 65 20 66 69 72 73 74 20 65 6e 74 ** the first ent
2cbb0 72 79 2e 20 20 54 52 55 45 20 69 73 20 61 6c 73 ry. TRUE is als
2cbc0 6f 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 o returned if th
2cbd0 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 e table is empty
2cbe0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
2cbf0 42 74 72 65 65 45 6f 66 28 42 74 43 75 72 73 6f BtreeEof(BtCurso
2cc00 72 20 2a 70 43 75 72 29 7b 0a 20 20 2f 2a 20 54 r *pCur){. /* T
2cc10 4f 44 4f 3a 20 57 68 61 74 20 69 66 20 74 68 65 ODO: What if the
2cc20 20 63 75 72 73 6f 72 20 69 73 20 69 6e 20 43 55 cursor is in CU
2cc30 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
2cc40 20 62 75 74 20 61 6c 6c 20 74 61 62 6c 65 20 65 but all table e
2cc50 6e 74 72 69 65 73 0a 20 20 2a 2a 20 68 61 76 65 ntries. ** have
2cc60 20 62 65 65 6e 20 64 65 6c 65 74 65 64 3f 20 54 been deleted? T
2cc70 68 69 73 20 41 50 49 20 77 69 6c 6c 20 6e 65 65 his API will nee
2cc80 64 20 74 6f 20 63 68 61 6e 67 65 20 74 6f 20 72 d to change to r
2cc90 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 eturn an error c
2cca0 6f 64 65 0a 20 20 2a 2a 20 61 73 20 77 65 6c 6c ode. ** as well
2ccb0 20 61 73 20 74 68 65 20 62 6f 6f 6c 65 61 6e 20 as the boolean
2ccc0 72 65 73 75 6c 74 20 76 61 6c 75 65 2e 0a 20 20 result value..
2ccd0 2a 2f 0a 20 20 72 65 74 75 72 6e 20 28 43 55 52 */. return (CUR
2cce0 53 4f 52 5f 56 41 4c 49 44 21 3d 70 43 75 72 2d SOR_VALID!=pCur-
2ccf0 3e 65 53 74 61 74 65 29 3b 0a 7d 0a 0a 2f 2a 0a >eState);.}../*.
2cd00 2a 2a 20 41 64 76 61 6e 63 65 20 74 68 65 20 63 ** Advance the c
2cd10 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6e 65 78 ursor to the nex
2cd20 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 t entry in the d
2cd30 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a 2a 20 atabase. If.**
2cd40 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 6e 20 successful then
2cd50 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 49 66 set *pRes=0. If
2cd60 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 the cursor.** w
2cd70 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 as already point
2cd80 69 6e 67 20 74 6f 20 74 68 65 20 6c 61 73 74 20 ing to the last
2cd90 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 entry in the dat
2cda0 61 62 61 73 65 20 62 65 66 6f 72 65 0a 2a 2a 20 abase before.**
2cdb0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 61 73 this routine was
2cdc0 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e 20 73 65 called, then se
2cdd0 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2a 0a 2a 2a t *pRes=1..**.**
2cde0 20 54 68 65 20 6d 61 69 6e 20 65 6e 74 72 79 20 The main entry
2cdf0 70 6f 69 6e 74 20 69 73 20 73 71 6c 69 74 65 33 point is sqlite3
2ce00 42 74 72 65 65 4e 65 78 74 28 29 2e 20 20 54 68 BtreeNext(). Th
2ce10 61 74 20 72 6f 75 74 69 6e 65 20 69 73 20 6f 70 at routine is op
2ce20 74 69 6d 69 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 timized.** for t
2ce30 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f he common case o
2ce40 66 20 6d 65 72 65 6c 79 20 69 6e 63 72 65 6d 65 f merely increme
2ce50 6e 74 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 63 nting the cell c
2ce60 6f 75 6e 74 65 72 20 42 74 43 75 72 73 6f 72 2e ounter BtCursor.
2ce70 61 69 49 64 78 0a 2a 2a 20 74 6f 20 74 68 65 20 aiIdx.** to the
2ce80 6e 65 78 74 20 63 65 6c 6c 20 6f 6e 20 74 68 65 next cell on the
2ce90 20 63 75 72 72 65 6e 74 20 70 61 67 65 2e 20 20 current page.
2cea0 54 68 65 20 28 73 6c 6f 77 65 72 29 20 62 74 72 The (slower) btr
2ceb0 65 65 4e 65 78 74 28 29 20 68 65 6c 70 65 72 0a eeNext() helper.
2cec0 2a 2a 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 ** routine is ca
2ced0 6c 6c 65 64 20 77 68 65 6e 20 69 74 20 69 73 20 lled when it is
2cee0 6e 65 63 65 73 73 61 72 79 20 74 6f 20 6d 6f 76 necessary to mov
2cef0 65 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e 74 e to a different
2cf00 20 70 61 67 65 20 6f 72 0a 2a 2a 20 74 6f 20 72 page or.** to r
2cf10 65 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 6f estore the curso
2cf20 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c r..**.** The cal
2cf30 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 77 69 ling function wi
2cf40 6c 6c 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 ll set *pRes to
2cf50 30 20 6f 72 20 31 2e 20 20 54 68 65 20 69 6e 69 0 or 1. The ini
2cf60 74 69 61 6c 20 2a 70 52 65 73 20 76 61 6c 75 65 tial *pRes value
2cf70 0a 2a 2a 20 77 69 6c 6c 20 62 65 20 31 20 69 66 .** will be 1 if
2cf80 20 74 68 65 20 63 75 72 73 6f 72 20 62 65 69 6e the cursor bein
2cf90 67 20 73 74 65 70 70 65 64 20 63 6f 72 72 65 73 g stepped corres
2cfa0 70 6f 6e 64 73 20 74 6f 20 61 6e 20 53 51 4c 20 ponds to an SQL
2cfb0 69 6e 64 65 78 20 61 6e 64 0a 2a 2a 20 69 66 20 index and.** if
2cfc0 74 68 69 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 this routine cou
2cfd0 6c 64 20 68 61 76 65 20 62 65 65 6e 20 73 6b 69 ld have been ski
2cfe0 70 70 65 64 20 69 66 20 74 68 61 74 20 53 51 4c pped if that SQL
2cff0 20 69 6e 64 65 78 20 68 61 64 20 62 65 65 6e 0a index had been.
2d000 2a 2a 20 61 20 75 6e 69 71 75 65 20 69 6e 64 65 ** a unique inde
2d010 78 2e 20 20 4f 74 68 65 72 77 69 73 65 20 74 68 x. Otherwise th
2d020 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 68 61 e caller will ha
2d030 76 65 20 73 65 74 20 2a 70 52 65 73 20 74 6f 20 ve set *pRes to
2d040 7a 65 72 6f 2e 0a 2a 2a 20 5a 65 72 6f 20 69 73 zero..** Zero is
2d050 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 the common case
2d060 2e 20 54 68 65 20 62 74 72 65 65 20 69 6d 70 6c . The btree impl
2d070 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 66 72 ementation is fr
2d080 65 65 20 74 6f 20 75 73 65 20 74 68 65 0a 2a 2a ee to use the.**
2d090 20 69 6e 69 74 69 61 6c 20 2a 70 52 65 73 20 76 initial *pRes v
2d0a0 61 6c 75 65 20 61 73 20 61 20 68 69 6e 74 20 74 alue as a hint t
2d0b0 6f 20 69 6d 70 72 6f 76 65 20 70 65 72 66 6f 72 o improve perfor
2d0c0 6d 61 6e 63 65 2c 20 62 75 74 20 74 68 65 20 63 mance, but the c
2d0d0 75 72 72 65 6e 74 0a 2a 2a 20 53 51 4c 69 74 65 urrent.** SQLite
2d0e0 20 62 74 72 65 65 20 69 6d 70 6c 65 6d 65 6e 74 btree implement
2d0f0 61 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 2e 20 ation does not.
2d100 28 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 63 (Note that the c
2d110 6f 6d 64 62 32 20 62 74 72 65 65 0a 2a 2a 20 69 omdb2 btree.** i
2d120 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f mplementation do
2d130 65 73 20 75 73 65 20 74 68 69 73 20 68 69 6e 74 es use this hint
2d140 2c 20 68 6f 77 65 76 65 72 2e 29 0a 2a 2f 0a 73 , however.).*/.s
2d150 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 tatic SQLITE_NOI
2d160 4e 4c 49 4e 45 20 69 6e 74 20 62 74 72 65 65 4e NLINE int btreeN
2d170 65 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 ext(BtCursor *pC
2d180 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 29 7b 0a ur, int *pRes){.
2d190 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
2d1a0 69 64 78 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a idx;. MemPage *
2d1b0 70 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 pPage;.. assert
2d1c0 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 ( cursorOwnsBtSh
2d1d0 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 ared(pCur) );.
2d1e0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
2d1f0 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 ipNext==0 || pCu
2d200 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
2d210 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
2d220 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 20 29 3b ert( *pRes==0 );
2d230 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
2d240 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
2d250 44 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 D ){. assert(
2d260 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 (pCur->curFlags
2d270 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 & BTCF_ValidOvf
2d280 6c 29 3d 3d 30 20 29 3b 0a 20 20 20 20 72 63 20 l)==0 );. rc
2d290 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 50 = restoreCursorP
2d2a0 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a 20 osition(pCur);.
2d2b0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
2d2c0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 E_OK ){. re
2d2d0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 turn rc;. }.
2d2e0 20 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 4e if( CURSOR_IN
2d2f0 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 VALID==pCur->eSt
2d300 61 74 65 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 ate ){. *pR
2d310 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 72 65 es = 1;. re
2d320 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2d330 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 }. if( pC
2d340 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 29 7b 0a ur->skipNext ){.
2d350 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 assert( pC
2d360 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
2d370 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 OR_VALID || pCur
2d380 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
2d390 5f 53 4b 49 50 4e 45 58 54 20 29 3b 0a 20 20 20 _SKIPNEXT );.
2d3a0 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
2d3b0 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a = CURSOR_VALID;.
2d3c0 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e if( pCur->
2d3d0 73 6b 69 70 4e 65 78 74 3e 30 20 29 7b 0a 20 20 skipNext>0 ){.
2d3e0 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 pCur->skip
2d3f0 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 Next = 0;.
2d400 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2d410 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 OK;. }.
2d420 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 pCur->skipNext
2d430 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a = 0;. }. }.
2d440 0a 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 2d . pPage = pCur-
2d450 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2d460 61 67 65 5d 3b 0a 20 20 69 64 78 20 3d 20 2b 2b age];. idx = ++
2d470 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
2d480 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 61 73 73 65 ->iPage];. asse
2d490 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 rt( pPage->isIni
2d4a0 74 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 t );.. /* If th
2d4b0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
2d4c0 69 73 20 63 6f 72 72 75 70 74 2c 20 69 74 20 69 is corrupt, it i
2d4d0 73 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 74 s possible for t
2d4e0 68 65 20 76 61 6c 75 65 20 6f 66 20 69 64 78 20 he value of idx
2d4f0 0a 20 20 2a 2a 20 74 6f 20 62 65 20 69 6e 76 61 . ** to be inva
2d500 6c 69 64 20 68 65 72 65 2e 20 54 68 69 73 20 63 lid here. This c
2d510 61 6e 20 6f 6e 6c 79 20 6f 63 63 75 72 20 69 66 an only occur if
2d520 20 61 20 73 65 63 6f 6e 64 20 63 75 72 73 6f 72 a second cursor
2d530 20 6d 6f 64 69 66 69 65 73 0a 20 20 2a 2a 20 74 modifies. ** t
2d540 68 65 20 70 61 67 65 20 77 68 69 6c 65 20 63 75 he page while cu
2d550 72 73 6f 72 20 70 43 75 72 20 69 73 20 68 6f 6c rsor pCur is hol
2d560 64 69 6e 67 20 61 20 72 65 66 65 72 65 6e 63 65 ding a reference
2d570 20 74 6f 20 69 74 2e 20 57 68 69 63 68 20 63 61 to it. Which ca
2d580 6e 0a 20 20 2a 2a 20 6f 6e 6c 79 20 68 61 70 70 n. ** only happ
2d590 65 6e 20 69 66 20 74 68 65 20 64 61 74 61 62 61 en if the databa
2d5a0 73 65 20 69 73 20 63 6f 72 72 75 70 74 20 69 6e se is corrupt in
2d5b0 20 73 75 63 68 20 61 20 77 61 79 20 61 73 20 74 such a way as t
2d5c0 6f 20 6c 69 6e 6b 20 74 68 65 0a 20 20 2a 2a 20 o link the. **
2d5d0 70 61 67 65 20 69 6e 74 6f 20 6d 6f 72 65 20 74 page into more t
2d5e0 68 61 6e 20 6f 6e 65 20 62 2d 74 72 65 65 20 73 han one b-tree s
2d5f0 74 72 75 63 74 75 72 65 2e 20 2a 2f 0a 20 20 74 tructure. */. t
2d600 65 73 74 63 61 73 65 28 20 69 64 78 3e 70 50 61 estcase( idx>pPa
2d610 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 0a 20 20 ge->nCell );..
2d620 69 66 28 20 69 64 78 3e 3d 70 50 61 67 65 2d 3e if( idx>=pPage->
2d630 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 69 66 28 nCell ){. if(
2d640 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
2d650 0a 20 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 . rc = move
2d660 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 65 ToChild(pCur, ge
2d670 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 t4byte(&pPage->a
2d680 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f Data[pPage->hdrO
2d690 66 66 73 65 74 2b 38 5d 29 29 3b 0a 20 20 20 20 ffset+8]));.
2d6a0 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
2d6b0 6e 20 72 63 3b 0a 20 20 20 20 20 20 72 65 74 75 n rc;. retu
2d6c0 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 rn moveToLeftmos
2d6d0 74 28 70 43 75 72 29 3b 0a 20 20 20 20 7d 0a 20 t(pCur);. }.
2d6e0 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 69 66 28 do{. if(
2d6f0 20 70 43 75 72 2d 3e 69 50 61 67 65 3d 3d 30 20 pCur->iPage==0
2d700 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 52 65 73 ){. *pRes
2d710 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 70 43 = 1;. pC
2d720 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
2d730 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 SOR_INVALID;.
2d740 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
2d750 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 TE_OK;. }.
2d760 20 20 20 20 20 6d 6f 76 65 54 6f 50 61 72 65 6e moveToParen
2d770 74 28 70 43 75 72 29 3b 0a 20 20 20 20 20 20 70 t(pCur);. p
2d780 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 Page = pCur->apP
2d790 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
2d7a0 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 70 43 ;. }while( pC
2d7b0 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
2d7c0 69 50 61 67 65 5d 3e 3d 70 50 61 67 65 2d 3e 6e iPage]>=pPage->n
2d7d0 43 65 6c 6c 20 29 3b 0a 20 20 20 20 69 66 28 20 Cell );. if(
2d7e0 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b pPage->intKey ){
2d7f0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 73 71 . return sq
2d800 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 lite3BtreeNext(p
2d810 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 20 20 Cur, pRes);.
2d820 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 }else{. ret
2d830 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2d840 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 }. }. if( p
2d850 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
2d860 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2d870 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 OK;. }else{.
2d880 20 72 65 74 75 72 6e 20 6d 6f 76 65 54 6f 4c 65 return moveToLe
2d890 66 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 ftmost(pCur);.
2d8a0 7d 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 }.}.int sqlite3B
2d8b0 74 72 65 65 4e 65 78 74 28 42 74 43 75 72 73 6f treeNext(BtCurso
2d8c0 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
2d8d0 65 73 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a es){. MemPage *
2d8e0 70 50 61 67 65 3b 0a 20 20 61 73 73 65 72 74 28 pPage;. assert(
2d8f0 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2d900 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2d910 73 73 65 72 74 28 20 70 52 65 73 21 3d 30 20 29 ssert( pRes!=0 )
2d920 3b 0a 20 20 61 73 73 65 72 74 28 20 2a 70 52 65 ;. assert( *pRe
2d930 73 3d 3d 30 20 7c 7c 20 2a 70 52 65 73 3d 3d 31 s==0 || *pRes==1
2d940 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
2d950 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 ur->skipNext==0
2d960 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 || pCur->eState!
2d970 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
2d980 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 . pCur->info.nS
2d990 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d ize = 0;. pCur-
2d9a0 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 >curFlags &= ~(B
2d9b0 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 TCF_ValidNKey|BT
2d9c0 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 CF_ValidOvfl);.
2d9d0 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 69 66 *pRes = 0;. if
2d9e0 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d ( pCur->eState!=
2d9f0 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 20 72 CURSOR_VALID ) r
2da00 65 74 75 72 6e 20 62 74 72 65 65 4e 65 78 74 28 eturn btreeNext(
2da10 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 70 pCur, pRes);. p
2da20 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 Page = pCur->apP
2da30 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
2da40 3b 0a 20 20 69 66 28 20 28 2b 2b 70 43 75 72 2d ;. if( (++pCur-
2da50 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
2da60 67 65 5d 29 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 ge])>=pPage->nCe
2da70 6c 6c 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e ll ){. pCur->
2da80 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2da90 65 5d 2d 2d 3b 0a 20 20 20 20 72 65 74 75 72 6e e]--;. return
2daa0 20 62 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c btreeNext(pCur,
2dab0 20 70 52 65 73 29 3b 0a 20 20 7d 0a 20 20 69 66 pRes);. }. if
2dac0 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b ( pPage->leaf ){
2dad0 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
2dae0 54 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a TE_OK;. }else{.
2daf0 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 65 54 return moveT
2db00 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b oLeftmost(pCur);
2db10 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 74 . }.}../*.** St
2db20 65 70 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f ep the cursor to
2db30 20 74 68 65 20 62 61 63 6b 20 74 6f 20 74 68 65 the back to the
2db40 20 70 72 65 76 69 6f 75 73 20 65 6e 74 72 79 20 previous entry
2db50 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e in the database.
2db60 20 20 49 66 0a 2a 2a 20 73 75 63 63 65 73 73 66 If.** successf
2db70 75 6c 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 ul then set *pRe
2db80 73 3d 30 2e 20 20 49 66 20 74 68 65 20 63 75 72 s=0. If the cur
2db90 73 6f 72 0a 2a 2a 20 77 61 73 20 61 6c 72 65 61 sor.** was alrea
2dba0 64 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 dy pointing to t
2dbb0 68 65 20 66 69 72 73 74 20 65 6e 74 72 79 20 69 he first entry i
2dbc0 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 n the database b
2dbd0 65 66 6f 72 65 0a 2a 2a 20 74 68 69 73 20 72 6f efore.** this ro
2dbe0 75 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 64 utine was called
2dbf0 2c 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 73 , then set *pRes
2dc00 3d 31 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 =1..**.** The ma
2dc10 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 69 in entry point i
2dc20 73 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 72 s sqlite3BtreePr
2dc30 65 76 69 6f 75 73 28 29 2e 20 20 54 68 61 74 20 evious(). That
2dc40 72 6f 75 74 69 6e 65 20 69 73 20 6f 70 74 69 6d routine is optim
2dc50 69 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 68 65 20 ized.** for the
2dc60 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f 66 20 6d common case of m
2dc70 65 72 65 6c 79 20 64 65 63 72 65 6d 65 6e 74 69 erely decrementi
2dc80 6e 67 20 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e ng the cell coun
2dc90 74 65 72 20 42 74 43 75 72 73 6f 72 2e 61 69 49 ter BtCursor.aiI
2dca0 64 78 0a 2a 2a 20 74 6f 20 74 68 65 20 70 72 65 dx.** to the pre
2dcb0 76 69 6f 75 73 20 63 65 6c 6c 20 6f 6e 20 74 68 vious cell on th
2dcc0 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 2e 20 e current page.
2dcd0 20 54 68 65 20 28 73 6c 6f 77 65 72 29 20 62 74 The (slower) bt
2dce0 72 65 65 50 72 65 76 69 6f 75 73 28 29 0a 2a 2a reePrevious().**
2dcf0 20 68 65 6c 70 65 72 20 72 6f 75 74 69 6e 65 20 helper routine
2dd00 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 is called when i
2dd10 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 t is necessary t
2dd20 6f 20 6d 6f 76 65 20 74 6f 20 61 20 64 69 66 66 o move to a diff
2dd30 65 72 65 6e 74 20 70 61 67 65 0a 2a 2a 20 6f 72 erent page.** or
2dd40 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 to restore the
2dd50 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 cursor..**.** Th
2dd60 65 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 e calling functi
2dd70 6f 6e 20 77 69 6c 6c 20 73 65 74 20 2a 70 52 65 on will set *pRe
2dd80 73 20 74 6f 20 30 20 6f 72 20 31 2e 20 20 54 68 s to 0 or 1. Th
2dd90 65 20 69 6e 69 74 69 61 6c 20 2a 70 52 65 73 20 e initial *pRes
2dda0 76 61 6c 75 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 value.** will be
2ddb0 20 31 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 1 if the cursor
2ddc0 20 62 65 69 6e 67 20 73 74 65 70 70 65 64 20 63 being stepped c
2ddd0 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 6e orresponds to an
2dde0 20 53 51 4c 20 69 6e 64 65 78 20 61 6e 64 0a 2a SQL index and.*
2ddf0 2a 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e * if this routin
2de00 65 20 63 6f 75 6c 64 20 68 61 76 65 20 62 65 65 e could have bee
2de10 6e 20 73 6b 69 70 70 65 64 20 69 66 20 74 68 61 n skipped if tha
2de20 74 20 53 51 4c 20 69 6e 64 65 78 20 68 61 64 20 t SQL index had
2de30 62 65 65 6e 0a 2a 2a 20 61 20 75 6e 69 71 75 65 been.** a unique
2de40 20 69 6e 64 65 78 2e 20 20 4f 74 68 65 72 77 69 index. Otherwi
2de50 73 65 20 74 68 65 20 63 61 6c 6c 65 72 20 77 69 se the caller wi
2de60 6c 6c 20 68 61 76 65 20 73 65 74 20 2a 70 52 65 ll have set *pRe
2de70 73 20 74 6f 20 7a 65 72 6f 2e 0a 2a 2a 20 5a 65 s to zero..** Ze
2de80 72 6f 20 69 73 20 74 68 65 20 63 6f 6d 6d 6f 6e ro is the common
2de90 20 63 61 73 65 2e 20 54 68 65 20 62 74 72 65 65 case. The btree
2dea0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
2deb0 69 73 20 66 72 65 65 20 74 6f 20 75 73 65 20 74 is free to use t
2dec0 68 65 0a 2a 2a 20 69 6e 69 74 69 61 6c 20 2a 70 he.** initial *p
2ded0 52 65 73 20 76 61 6c 75 65 20 61 73 20 61 20 68 Res value as a h
2dee0 69 6e 74 20 74 6f 20 69 6d 70 72 6f 76 65 20 70 int to improve p
2def0 65 72 66 6f 72 6d 61 6e 63 65 2c 20 62 75 74 20 erformance, but
2df00 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 53 the current.** S
2df10 51 4c 69 74 65 20 62 74 72 65 65 20 69 6d 70 6c QLite btree impl
2df20 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 ementation does
2df30 6e 6f 74 2e 20 28 4e 6f 74 65 20 74 68 61 74 20 not. (Note that
2df40 74 68 65 20 63 6f 6d 64 62 32 20 62 74 72 65 65 the comdb2 btree
2df50 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 .** implementati
2df60 6f 6e 20 64 6f 65 73 20 75 73 65 20 74 68 69 73 on does use this
2df70 20 68 69 6e 74 2c 20 68 6f 77 65 76 65 72 2e 29 hint, however.)
2df80 0a 2a 2f 0a 73 74 61 74 69 63 20 53 51 4c 49 54 .*/.static SQLIT
2df90 45 5f 4e 4f 49 4e 4c 49 4e 45 20 69 6e 74 20 62 E_NOINLINE int b
2dfa0 74 72 65 65 50 72 65 76 69 6f 75 73 28 42 74 43 treePrevious(BtC
2dfb0 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 ursor *pCur, int
2dfc0 20 2a 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 *pRes){. int r
2dfd0 63 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 c;. MemPage *pP
2dfe0 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 age;.. assert(
2dff0 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
2e000 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
2e010 73 65 72 74 28 20 70 52 65 73 21 3d 30 20 29 3b sert( pRes!=0 );
2e020 0a 20 20 61 73 73 65 72 74 28 20 2a 70 52 65 73 . assert( *pRes
2e030 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
2e040 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3d pCur->skipNext=
2e050 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 =0 || pCur->eSta
2e060 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
2e070 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 );. assert( (p
2e080 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 Cur->curFlags &
2e090 28 42 54 43 46 5f 41 74 4c 61 73 74 7c 42 54 43 (BTCF_AtLast|BTC
2e0a0 46 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 43 46 F_ValidOvfl|BTCF
2e0b0 5f 56 61 6c 69 64 4e 4b 65 79 29 29 3d 3d 30 20 _ValidNKey))==0
2e0c0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2e0d0 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
2e0e0 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e );. if( pCur->
2e0f0 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
2e100 41 4c 49 44 20 29 7b 0a 20 20 20 20 72 63 20 3d ALID ){. rc =
2e110 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f restoreCursorPo
2e120 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 sition(pCur);.
2e130 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
2e140 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 _OK ){. ret
2e150 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
2e160 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 4e 56 if( CURSOR_INV
2e170 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 74 61 ALID==pCur->eSta
2e180 74 65 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 65 te ){. *pRe
2e190 73 20 3d 20 31 3b 0a 20 20 20 20 20 20 72 65 74 s = 1;. ret
2e1a0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2e1b0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 75 }. if( pCu
2e1c0 72 2d 3e 73 6b 69 70 4e 65 78 74 20 29 7b 0a 20 r->skipNext ){.
2e1d0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
2e1e0 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
2e1f0 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d R_VALID || pCur-
2e200 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
2e210 53 4b 49 50 4e 45 58 54 20 29 3b 0a 20 20 20 20 SKIPNEXT );.
2e220 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
2e230 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 CURSOR_VALID;.
2e240 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 if( pCur->s
2e250 6b 69 70 4e 65 78 74 3c 30 20 29 7b 0a 20 20 20 kipNext<0 ){.
2e260 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e pCur->skipN
2e270 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ext = 0;.
2e280 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2e290 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 K;. }.
2e2a0 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
2e2b0 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a = 0;. }. }..
2e2c0 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e pPage = pCur->
2e2d0 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
2e2e0 67 65 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ge];. assert( p
2e2f0 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a Page->isInit );.
2e300 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 if( !pPage->le
2e310 61 66 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 64 af ){. int id
2e320 78 20 3d 20 70 43 75 72 2d 3e 61 69 49 64 78 5b x = pCur->aiIdx[
2e330 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
2e340 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
2e350 6c 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 74 ld(pCur, get4byt
2e360 65 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 e(findCell(pPage
2e370 2c 20 69 64 78 29 29 29 3b 0a 20 20 20 20 69 66 , idx)));. if
2e380 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
2e390 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 ;. rc = moveT
2e3a0 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 72 29 oRightmost(pCur)
2e3b0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 77 ;. }else{. w
2e3c0 68 69 6c 65 28 20 70 43 75 72 2d 3e 61 69 49 64 hile( pCur->aiId
2e3d0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d x[pCur->iPage]==
2e3e0 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 0 ){. if( p
2e3f0 43 75 72 2d 3e 69 50 61 67 65 3d 3d 30 20 29 7b Cur->iPage==0 ){
2e400 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 65 . pCur->e
2e410 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 State = CURSOR_I
2e420 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 NVALID;.
2e430 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 *pRes = 1;.
2e440 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2e450 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 _OK;. }.
2e460 20 20 20 6d 6f 76 65 54 6f 50 61 72 65 6e 74 28 moveToParent(
2e470 70 43 75 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 pCur);. }.
2e480 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
2e490 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a nfo.nSize==0 );.
2e4a0 20 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 assert( (pCu
2e4b0 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 28 42 r->curFlags & (B
2e4c0 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 29 3d TCF_ValidOvfl))=
2e4d0 3d 30 20 29 3b 0a 0a 20 20 20 20 70 43 75 72 2d =0 );.. pCur-
2e4e0 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
2e4f0 67 65 5d 2d 2d 3b 0a 20 20 20 20 70 50 61 67 65 ge]--;. pPage
2e500 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b = pCur->apPage[
2e510 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 pCur->iPage];.
2e520 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 if( pPage->int
2e530 4b 65 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c Key && !pPage->l
2e540 65 61 66 20 29 7b 0a 20 20 20 20 20 20 72 63 20 eaf ){. rc
2e550 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 72 = sqlite3BtreePr
2e560 65 76 69 6f 75 73 28 70 43 75 72 2c 20 70 52 65 evious(pCur, pRe
2e570 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 s);. }else{.
2e580 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
2e590 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 _OK;. }. }.
2e5a0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e return rc;.}.in
2e5b0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 72 t sqlite3BtreePr
2e5c0 65 76 69 6f 75 73 28 42 74 43 75 72 73 6f 72 20 evious(BtCursor
2e5d0 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 *pCur, int *pRes
2e5e0 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ){. assert( cur
2e5f0 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
2e600 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
2e610 74 28 20 70 52 65 73 21 3d 30 20 29 3b 0a 20 20 t( pRes!=0 );.
2e620 61 73 73 65 72 74 28 20 2a 70 52 65 73 3d 3d 30 assert( *pRes==0
2e630 20 7c 7c 20 2a 70 52 65 73 3d 3d 31 20 29 3b 0a || *pRes==1 );.
2e640 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2e650 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 skipNext==0 || p
2e660 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2e670 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 2a SOR_VALID );. *
2e680 70 52 65 73 20 3d 20 30 3b 0a 20 20 70 43 75 72 pRes = 0;. pCur
2e690 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 ->curFlags &= ~(
2e6a0 42 54 43 46 5f 41 74 4c 61 73 74 7c 42 54 43 46 BTCF_AtLast|BTCF
2e6b0 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 43 46 5f _ValidOvfl|BTCF_
2e6c0 56 61 6c 69 64 4e 4b 65 79 29 3b 0a 20 20 70 43 ValidNKey);. pC
2e6d0 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d ur->info.nSize =
2e6e0 20 30 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 0;. if( pCur->
2e6f0 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 eState!=CURSOR_V
2e700 41 4c 49 44 0a 20 20 20 7c 7c 20 70 43 75 72 2d ALID. || pCur-
2e710 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
2e720 67 65 5d 3d 3d 30 0a 20 20 20 7c 7c 20 70 43 75 ge]==0. || pCu
2e730 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
2e740 69 50 61 67 65 5d 2d 3e 6c 65 61 66 3d 3d 30 0a iPage]->leaf==0.
2e750 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ){. return
2e760 62 74 72 65 65 50 72 65 76 69 6f 75 73 28 70 43 btreePrevious(pC
2e770 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 7d 0a 20 ur, pRes);. }.
2e780 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 pCur->aiIdx[pCu
2e790 72 2d 3e 69 50 61 67 65 5d 2d 2d 3b 0a 20 20 72 r->iPage]--;. r
2e7a0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2e7b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 .}../*.** Alloca
2e7c0 74 65 20 61 20 6e 65 77 20 70 61 67 65 20 66 72 te a new page fr
2e7d0 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 20 om the database
2e7e0 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 file..**.** The
2e7f0 6e 65 77 20 70 61 67 65 20 69 73 20 6d 61 72 6b new page is mark
2e800 65 64 20 61 73 20 64 69 72 74 79 2e 20 20 28 49 ed as dirty. (I
2e810 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 73 n other words, s
2e820 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
2e830 28 29 0a 2a 2a 20 68 61 73 20 61 6c 72 65 61 64 ().** has alread
2e840 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 6f 6e y been called on
2e850 20 74 68 65 20 6e 65 77 20 70 61 67 65 2e 29 20 the new page.)
2e860 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 68 61 The new page ha
2e870 73 20 61 6c 73 6f 0a 2a 2a 20 62 65 65 6e 20 72 s also.** been r
2e880 65 66 65 72 65 6e 63 65 64 20 61 6e 64 20 74 68 eferenced and th
2e890 65 20 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e e calling routin
2e8a0 65 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 e is responsible
2e8b0 20 66 6f 72 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 for calling.**
2e8c0 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
2e8d0 66 28 29 20 6f 6e 20 74 68 65 20 6e 65 77 20 70 f() on the new p
2e8e0 61 67 65 20 77 68 65 6e 20 69 74 20 69 73 20 64 age when it is d
2e8f0 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 one..**.** SQLIT
2e900 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
2e910 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 41 6e on success. An
2e920 79 20 6f 74 68 65 72 20 72 65 74 75 72 6e 20 76 y other return v
2e930 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 0a 2a alue indicates.*
2e940 2a 20 61 6e 20 65 72 72 6f 72 2e 20 20 2a 70 70 * an error. *pp
2e950 50 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 4e Page is set to N
2e960 55 4c 4c 20 69 6e 20 74 68 65 20 65 76 65 6e 74 ULL in the event
2e970 20 6f 66 20 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a of an error..**
2e980 0a 2a 2a 20 49 66 20 74 68 65 20 22 6e 65 61 72 .** If the "near
2e990 62 79 22 20 70 61 72 61 6d 65 74 65 72 20 69 73 by" parameter is
2e9a0 20 6e 6f 74 20 30 2c 20 74 68 65 6e 20 61 6e 20 not 0, then an
2e9b0 65 66 66 6f 72 74 20 69 73 20 6d 61 64 65 20 74 effort is made t
2e9c0 6f 20 0a 2a 2a 20 6c 6f 63 61 74 65 20 61 20 70 o .** locate a p
2e9d0 61 67 65 20 63 6c 6f 73 65 20 74 6f 20 74 68 65 age close to the
2e9e0 20 70 61 67 65 20 6e 75 6d 62 65 72 20 22 6e 65 page number "ne
2e9f0 61 72 62 79 22 2e 20 20 54 68 69 73 20 63 61 6e arby". This can
2ea00 20 62 65 20 75 73 65 64 20 69 6e 20 61 6e 0a 2a be used in an.*
2ea10 2a 20 61 74 74 65 6d 70 74 20 74 6f 20 6b 65 65 * attempt to kee
2ea20 70 20 72 65 6c 61 74 65 64 20 70 61 67 65 73 20 p related pages
2ea30 63 6c 6f 73 65 20 74 6f 20 65 61 63 68 20 6f 74 close to each ot
2ea40 68 65 72 20 69 6e 20 74 68 65 20 64 61 74 61 62 her in the datab
2ea50 61 73 65 20 66 69 6c 65 2c 0a 2a 2a 20 77 68 69 ase file,.** whi
2ea60 63 68 20 69 6e 20 74 75 72 6e 20 63 61 6e 20 6d ch in turn can m
2ea70 61 6b 65 20 64 61 74 61 62 61 73 65 20 61 63 63 ake database acc
2ea80 65 73 73 20 66 61 73 74 65 72 2e 0a 2a 2a 0a 2a ess faster..**.*
2ea90 2a 20 49 66 20 74 68 65 20 65 4d 6f 64 65 20 70 * If the eMode p
2eaa0 61 72 61 6d 65 74 65 72 20 69 73 20 42 54 41 4c arameter is BTAL
2eab0 4c 4f 43 5f 45 58 41 43 54 20 61 6e 64 20 74 68 LOC_EXACT and th
2eac0 65 20 6e 65 61 72 62 79 20 70 61 67 65 20 65 78 e nearby page ex
2ead0 69 73 74 73 0a 2a 2a 20 61 6e 79 77 68 65 72 65 ists.** anywhere
2eae0 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 on the free-lis
2eaf0 74 2c 20 74 68 65 6e 20 69 74 20 69 73 20 67 75 t, then it is gu
2eb00 61 72 61 6e 74 65 65 64 20 74 6f 20 62 65 20 72 aranteed to be r
2eb10 65 74 75 72 6e 65 64 2e 20 20 49 66 0a 2a 2a 20 eturned. If.**
2eb20 65 4d 6f 64 65 20 69 73 20 42 54 41 4c 4c 4f 43 eMode is BTALLOC
2eb30 5f 4c 54 20 74 68 65 6e 20 74 68 65 20 70 61 67 _LT then the pag
2eb40 65 20 72 65 74 75 72 6e 65 64 20 77 69 6c 6c 20 e returned will
2eb50 62 65 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 be less than or
2eb60 65 71 75 61 6c 0a 2a 2a 20 74 6f 20 6e 65 61 72 equal.** to near
2eb70 62 79 20 69 66 20 61 6e 79 20 73 75 63 68 20 70 by if any such p
2eb80 61 67 65 20 65 78 69 73 74 73 2e 20 20 49 66 20 age exists. If
2eb90 65 4d 6f 64 65 20 69 73 20 42 54 41 4c 4c 4f 43 eMode is BTALLOC
2eba0 5f 41 4e 59 20 74 68 65 6e 20 74 68 65 72 65 0a _ANY then there.
2ebb0 2a 2a 20 61 72 65 20 6e 6f 20 72 65 73 74 72 69 ** are no restri
2ebc0 63 74 69 6f 6e 73 20 6f 6e 20 77 68 69 63 68 20 ctions on which
2ebd0 70 61 67 65 20 69 73 20 72 65 74 75 72 6e 65 64 page is returned
2ebe0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
2ebf0 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
2ec00 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 e(. BtShared *p
2ec10 42 74 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 54 Bt, /* T
2ec20 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 4d 65 he btree */. Me
2ec30 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 mPage **ppPage,
2ec40 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 70 6f /* Store po
2ec50 69 6e 74 65 72 20 74 6f 20 74 68 65 20 61 6c 6c inter to the all
2ec60 6f 63 61 74 65 64 20 70 61 67 65 20 68 65 72 65 ocated page here
2ec70 20 2a 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e */. Pgno *pPgn
2ec80 6f 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 o, /*
2ec90 53 74 6f 72 65 20 74 68 65 20 70 61 67 65 20 6e Store the page n
2eca0 75 6d 62 65 72 20 68 65 72 65 20 2a 2f 0a 20 20 umber here */.
2ecb0 50 67 6e 6f 20 6e 65 61 72 62 79 2c 20 20 20 20 Pgno nearby,
2ecc0 20 20 20 20 20 20 20 2f 2a 20 53 65 61 72 63 68 /* Search
2ecd0 20 66 6f 72 20 61 20 70 61 67 65 20 6e 65 61 72 for a page near
2ece0 20 74 68 69 73 20 6f 6e 65 20 2a 2f 0a 20 20 75 this one */. u
2ecf0 38 20 65 4d 6f 64 65 20 20 20 20 20 20 20 20 20 8 eMode
2ed00 20 20 20 20 20 20 2f 2a 20 42 54 41 4c 4c 4f 43 /* BTALLOC
2ed10 5f 45 58 41 43 54 2c 20 42 54 41 4c 4c 4f 43 5f _EXACT, BTALLOC_
2ed20 4c 54 2c 20 6f 72 20 42 54 41 4c 4c 4f 43 5f 41 LT, or BTALLOC_A
2ed30 4e 59 20 2a 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 NY */.){. MemPa
2ed40 67 65 20 2a 70 50 61 67 65 31 3b 0a 20 20 69 6e ge *pPage1;. in
2ed50 74 20 72 63 3b 0a 20 20 75 33 32 20 6e 3b 20 20 t rc;. u32 n;
2ed60 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
2ed70 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 pages on the fre
2ed80 65 6c 69 73 74 20 2a 2f 0a 20 20 75 33 32 20 6b elist */. u32 k
2ed90 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 ; /* Number
2eda0 6f 66 20 6c 65 61 76 65 73 20 6f 6e 20 74 68 65 of leaves on the
2edb0 20 74 72 75 6e 6b 20 6f 66 20 74 68 65 20 66 72 trunk of the fr
2edc0 65 65 6c 69 73 74 20 2a 2f 0a 20 20 4d 65 6d 50 eelist */. MemP
2edd0 61 67 65 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b age *pTrunk = 0;
2ede0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 72 65 . MemPage *pPre
2edf0 76 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 50 67 vTrunk = 0;. Pg
2ee00 6e 6f 20 6d 78 50 61 67 65 3b 20 20 20 20 20 2f no mxPage; /
2ee10 2a 20 54 6f 74 61 6c 20 73 69 7a 65 20 6f 66 20 * Total size of
2ee20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
2ee30 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 e */.. assert(
2ee40 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
2ee50 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
2ee60 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4d 6f 64 ;. assert( eMod
2ee70 65 3d 3d 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 7c e==BTALLOC_ANY |
2ee80 7c 20 28 6e 65 61 72 62 79 3e 30 20 26 26 20 49 | (nearby>0 && I
2ee90 66 4e 6f 74 4f 6d 69 74 41 56 28 70 42 74 2d 3e fNotOmitAV(pBt->
2eea0 61 75 74 6f 56 61 63 75 75 6d 29 29 20 29 3b 0a autoVacuum)) );.
2eeb0 20 20 70 50 61 67 65 31 20 3d 20 70 42 74 2d 3e pPage1 = pBt->
2eec0 70 50 61 67 65 31 3b 0a 20 20 6d 78 50 61 67 65 pPage1;. mxPage
2eed0 20 3d 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e = btreePagecoun
2eee0 74 28 70 42 74 29 3b 0a 20 20 2f 2a 20 45 56 49 t(pBt);. /* EVI
2eef0 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 35 31 31 DENCE-OF: R-0511
2ef00 39 2d 30 32 36 33 37 20 54 68 65 20 34 2d 62 79 9-02637 The 4-by
2ef10 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
2ef20 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
2ef30 33 36 0a 20 20 2a 2a 20 73 74 6f 72 65 73 20 73 36. ** stores s
2ef40 74 6f 72 65 73 20 74 68 65 20 74 6f 74 61 6c 20 tores the total
2ef50 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
2ef60 6f 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e on the freelist.
2ef70 20 2a 2f 0a 20 20 6e 20 3d 20 67 65 74 34 62 79 */. n = get4by
2ef80 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
2ef90 61 5b 33 36 5d 29 3b 0a 20 20 74 65 73 74 63 61 a[36]);. testca
2efa0 73 65 28 20 6e 3d 3d 6d 78 50 61 67 65 2d 31 20 se( n==mxPage-1
2efb0 29 3b 0a 20 20 69 66 28 20 6e 3e 3d 6d 78 50 61 );. if( n>=mxPa
2efc0 67 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ge ){. return
2efd0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2efe0 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 BKPT;. }. if(
2eff0 6e 3e 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 n>0 ){. /* Th
2f000 65 72 65 20 61 72 65 20 70 61 67 65 73 20 6f 6e ere are pages on
2f010 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e 20 20 the freelist.
2f020 52 65 75 73 65 20 6f 6e 65 20 6f 66 20 74 68 6f Reuse one of tho
2f030 73 65 20 70 61 67 65 73 2e 20 2a 2f 0a 20 20 20 se pages. */.
2f040 20 50 67 6e 6f 20 69 54 72 75 6e 6b 3b 0a 20 20 Pgno iTrunk;.
2f050 20 20 75 38 20 73 65 61 72 63 68 4c 69 73 74 20 u8 searchList
2f060 3d 20 30 3b 20 2f 2a 20 49 66 20 74 68 65 20 66 = 0; /* If the f
2f070 72 65 65 2d 6c 69 73 74 20 6d 75 73 74 20 62 65 ree-list must be
2f080 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 27 6e searched for 'n
2f090 65 61 72 62 79 27 20 2a 2f 0a 20 20 20 20 75 33 earby' */. u3
2f0a0 32 20 6e 53 65 61 72 63 68 20 3d 20 30 3b 20 20 2 nSearch = 0;
2f0b0 20 2f 2a 20 43 6f 75 6e 74 20 6f 66 20 74 68 65 /* Count of the
2f0c0 20 6e 75 6d 62 65 72 20 6f 66 20 73 65 61 72 63 number of searc
2f0d0 68 20 61 74 74 65 6d 70 74 73 20 2a 2f 0a 20 20 h attempts */.
2f0e0 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 65 4d 6f . /* If eMo
2f0f0 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 43 de==BTALLOC_EXAC
2f100 54 20 61 6e 64 20 61 20 71 75 65 72 79 20 6f 66 T and a query of
2f110 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 the pointer-map
2f120 0a 20 20 20 20 2a 2a 20 73 68 6f 77 73 20 74 68 . ** shows th
2f130 61 74 20 74 68 65 20 70 61 67 65 20 27 6e 65 61 at the page 'nea
2f140 72 62 79 27 20 69 73 20 73 6f 6d 65 77 68 65 72 rby' is somewher
2f150 65 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 e on the free-li
2f160 73 74 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 st, then. **
2f170 74 68 65 20 65 6e 74 69 72 65 2d 6c 69 73 74 20 the entire-list
2f180 77 69 6c 6c 20 62 65 20 73 65 61 72 63 68 65 64 will be searched
2f190 20 66 6f 72 20 74 68 61 74 20 70 61 67 65 2e 0a for that page..
2f1a0 20 20 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 */.#ifndef S
2f1b0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
2f1c0 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 65 4d ACUUM. if( eM
2f1d0 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 41 ode==BTALLOC_EXA
2f1e0 43 54 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 CT ){. if(
2f1f0 6e 65 61 72 62 79 3c 3d 6d 78 50 61 67 65 20 29 nearby<=mxPage )
2f200 7b 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 79 {. u8 eTy
2f210 70 65 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 pe;. asse
2f220 72 74 28 20 6e 65 61 72 62 79 3e 30 20 29 3b 0a rt( nearby>0 );.
2f230 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
2f240 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
2f250 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
2f260 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 6e ptrmapGet(pBt, n
2f270 65 61 72 62 79 2c 20 26 65 54 79 70 65 2c 20 30 earby, &eType, 0
2f280 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
2f290 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
2f2a0 20 20 20 20 20 20 20 69 66 28 20 65 54 79 70 65 if( eType
2f2b0 3d 3d 50 54 52 4d 41 50 5f 46 52 45 45 50 41 47 ==PTRMAP_FREEPAG
2f2c0 45 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 E ){. s
2f2d0 65 61 72 63 68 4c 69 73 74 20 3d 20 31 3b 0a 20 earchList = 1;.
2f2e0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
2f2f0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 65 . }else if( e
2f300 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 Mode==BTALLOC_LE
2f310 20 29 7b 0a 20 20 20 20 20 20 73 65 61 72 63 68 ){. search
2f320 4c 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a List = 1;. }.
2f330 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 44 #endif.. /* D
2f340 65 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 65 ecrement the fre
2f350 65 2d 6c 69 73 74 20 63 6f 75 6e 74 20 62 79 20 e-list count by
2f360 31 2e 20 53 65 74 20 69 54 72 75 6e 6b 20 74 6f 1. Set iTrunk to
2f370 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 the index of th
2f380 65 0a 20 20 20 20 2a 2a 20 66 69 72 73 74 20 66 e. ** first f
2f390 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
2f3a0 61 67 65 2e 20 69 50 72 65 76 54 72 75 6e 6b 20 age. iPrevTrunk
2f3b0 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 31 2e 0a is initially 1..
2f3c0 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 */. rc =
2f3d0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
2f3e0 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 e(pPage1->pDbPag
2f3f0 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 e);. if( rc )
2f400 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
2f410 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
2f420 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 6e 2d 31 ->aData[36], n-1
2f430 29 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 );.. /* The c
2f440 6f 64 65 20 77 69 74 68 69 6e 20 74 68 69 73 20 ode within this
2f450 6c 6f 6f 70 20 69 73 20 72 75 6e 20 6f 6e 6c 79 loop is run only
2f460 20 6f 6e 63 65 20 69 66 20 74 68 65 20 27 73 65 once if the 'se
2f470 61 72 63 68 4c 69 73 74 27 20 76 61 72 69 61 62 archList' variab
2f480 6c 65 0a 20 20 20 20 2a 2a 20 69 73 20 6e 6f 74 le. ** is not
2f490 20 74 72 75 65 2e 20 4f 74 68 65 72 77 69 73 65 true. Otherwise
2f4a0 2c 20 69 74 20 72 75 6e 73 20 6f 6e 63 65 20 66 , it runs once f
2f4b0 6f 72 20 65 61 63 68 20 74 72 75 6e 6b 2d 70 61 or each trunk-pa
2f4c0 67 65 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a ge on the. **
2f4d0 20 66 72 65 65 2d 6c 69 73 74 20 75 6e 74 69 6c free-list until
2f4e0 20 74 68 65 20 70 61 67 65 20 27 6e 65 61 72 62 the page 'nearb
2f4f0 79 27 20 69 73 20 6c 6f 63 61 74 65 64 20 28 65 y' is located (e
2f500 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 45 58 Mode==BTALLOC_EX
2f510 41 43 54 29 0a 20 20 20 20 2a 2a 20 6f 72 20 75 ACT). ** or u
2f520 6e 74 69 6c 20 61 20 70 61 67 65 20 6c 65 73 73 ntil a page less
2f530 20 74 68 61 6e 20 27 6e 65 61 72 62 79 27 20 69 than 'nearby' i
2f540 73 20 6c 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 s located (eMode
2f550 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 54 29 0a 20 20 ==BTALLOC_LT).
2f560 20 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 */. do {.
2f570 20 20 20 20 70 50 72 65 76 54 72 75 6e 6b 20 3d pPrevTrunk =
2f580 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 69 pTrunk;. i
2f590 66 28 20 70 50 72 65 76 54 72 75 6e 6b 20 29 7b f( pPrevTrunk ){
2f5a0 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 44 . /* EVID
2f5b0 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 31 35 30 36 ENCE-OF: R-01506
2f5c0 2d 31 31 30 35 33 20 54 68 65 20 66 69 72 73 74 -11053 The first
2f5d0 20 69 6e 74 65 67 65 72 20 6f 6e 20 61 20 66 72 integer on a fr
2f5e0 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 eelist trunk pag
2f5f0 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 73 20 e. ** is
2f600 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
2f610 6f 66 20 74 68 65 20 6e 65 78 74 20 66 72 65 65 of the next free
2f620 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 list trunk page
2f630 69 6e 20 74 68 65 20 6c 69 73 74 20 6f 72 0a 20 in the list or.
2f640 20 20 20 20 20 20 20 2a 2a 20 7a 65 72 6f 20 69 ** zero i
2f650 66 20 74 68 69 73 20 69 73 20 74 68 65 20 6c 61 f this is the la
2f660 73 74 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e st freelist trun
2f670 6b 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 20 k page. */.
2f680 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 iTrunk = get4
2f690 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b byte(&pPrevTrunk
2f6a0 2d 3e 61 44 61 74 61 5b 30 5d 29 3b 0a 20 20 20 ->aData[0]);.
2f6b0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2f6c0 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
2f6d0 3a 20 52 2d 35 39 38 34 31 2d 31 33 37 39 38 20 : R-59841-13798
2f6e0 54 68 65 20 34 2d 62 79 74 65 20 62 69 67 2d 65 The 4-byte big-e
2f6f0 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 61 74 ndian integer at
2f700 20 6f 66 66 73 65 74 20 33 32 0a 20 20 20 20 20 offset 32.
2f710 20 20 20 2a 2a 20 73 74 6f 72 65 73 20 74 68 65 ** stores the
2f720 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
2f730 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f the first page o
2f740 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 2c 20 f the freelist,
2f750 6f 72 20 7a 65 72 6f 20 69 66 0a 20 20 20 20 20 or zero if.
2f760 20 20 20 2a 2a 20 74 68 65 20 66 72 65 65 6c 69 ** the freeli
2f770 73 74 20 69 73 20 65 6d 70 74 79 2e 20 2a 2f 0a st is empty. */.
2f780 20 20 20 20 20 20 20 20 69 54 72 75 6e 6b 20 3d iTrunk =
2f790 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 get4byte(&pPage
2f7a0 31 2d 3e 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 1->aData[32]);.
2f7b0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 74 65 73 }. tes
2f7c0 74 63 61 73 65 28 20 69 54 72 75 6e 6b 3d 3d 6d tcase( iTrunk==m
2f7d0 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 69 xPage );. i
2f7e0 66 28 20 69 54 72 75 6e 6b 3e 6d 78 50 61 67 65 f( iTrunk>mxPage
2f7f0 20 7c 7c 20 6e 53 65 61 72 63 68 2b 2b 20 3e 20 || nSearch++ >
2f800 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 n ){. rc
2f810 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
2f820 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 65 6c _BKPT;. }el
2f830 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d se{. rc =
2f840 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 50 btreeGetUnusedP
2f850 61 67 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c age(pBt, iTrunk,
2f860 20 26 70 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 &pTrunk, 0);.
2f870 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
2f880 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 70 54 rc ){. pT
2f890 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 runk = 0;.
2f8a0 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
2f8b0 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
2f8c0 7d 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 }. assert(
2f8d0 70 54 72 75 6e 6b 21 3d 30 20 29 3b 0a 20 20 20 pTrunk!=0 );.
2f8e0 20 20 20 61 73 73 65 72 74 28 20 70 54 72 75 6e assert( pTrun
2f8f0 6b 2d 3e 61 44 61 74 61 21 3d 30 20 29 3b 0a 20 k->aData!=0 );.
2f900 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
2f910 2d 4f 46 3a 20 52 2d 31 33 35 32 33 2d 30 34 33 -OF: R-13523-043
2f920 39 34 20 54 68 65 20 73 65 63 6f 6e 64 20 69 6e 94 The second in
2f930 74 65 67 65 72 20 6f 6e 20 61 20 66 72 65 65 6c teger on a freel
2f940 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 0a 20 ist trunk page.
2f950 20 20 20 20 20 2a 2a 20 69 73 20 74 68 65 20 6e ** is the n
2f960 75 6d 62 65 72 20 6f 66 20 6c 65 61 66 20 70 61 umber of leaf pa
2f970 67 65 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 66 ge pointers to f
2f980 6f 6c 6c 6f 77 2e 20 2a 2f 0a 20 20 20 20 20 20 ollow. */.
2f990 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 54 k = get4byte(&pT
2f9a0 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 3b runk->aData[4]);
2f9b0 0a 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 20 . if( k==0
2f9c0 26 26 20 21 73 65 61 72 63 68 4c 69 73 74 20 29 && !searchList )
2f9d0 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 {. /* The
2f9e0 20 74 72 75 6e 6b 20 68 61 73 20 6e 6f 20 6c 65 trunk has no le
2f9f0 61 76 65 73 20 61 6e 64 20 74 68 65 20 6c 69 73 aves and the lis
2fa00 74 20 69 73 20 6e 6f 74 20 62 65 69 6e 67 20 73 t is not being s
2fa10 65 61 72 63 68 65 64 2e 20 0a 20 20 20 20 20 20 earched. .
2fa20 20 20 2a 2a 20 53 6f 20 65 78 74 72 61 63 74 20 ** So extract
2fa30 74 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 the trunk page i
2fa40 74 73 65 6c 66 20 61 6e 64 20 75 73 65 20 69 74 tself and use it
2fa50 20 61 73 20 74 68 65 20 6e 65 77 6c 79 20 0a 20 as the newly .
2fa60 20 20 20 20 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 ** alloca
2fa70 74 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 ted page */.
2fa80 20 20 20 20 61 73 73 65 72 74 28 20 70 50 72 65 assert( pPre
2fa90 76 54 72 75 6e 6b 3d 3d 30 20 29 3b 0a 20 20 20 vTrunk==0 );.
2faa0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
2fab0 33 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 3PagerWrite(pTru
2fac0 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 nk->pDbPage);.
2fad0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
2fae0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
2faf0 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
2fb00 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
2fb10 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 69 54 72 *pPgno = iTr
2fb20 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d unk;. mem
2fb30 63 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 cpy(&pPage1->aDa
2fb40 74 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d ta[32], &pTrunk-
2fb50 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 >aData[0], 4);.
2fb60 20 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d *ppPage =
2fb70 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 pTrunk;.
2fb80 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 pTrunk = 0;.
2fb90 20 20 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c TRACE(("ALL
2fba0 4f 43 41 54 45 3a 20 25 64 20 74 72 75 6e 6b 20 OCATE: %d trunk
2fbb0 2d 20 25 64 20 66 72 65 65 20 70 61 67 65 73 20 - %d free pages
2fbc0 6c 65 66 74 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c left\n", *pPgno,
2fbd0 20 6e 2d 31 29 29 3b 0a 20 20 20 20 20 20 7d 65 n-1));. }e
2fbe0 6c 73 65 20 69 66 28 20 6b 3e 28 75 33 32 29 28 lse if( k>(u32)(
2fbf0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f pBt->usableSize/
2fc00 34 20 2d 20 32 29 20 29 7b 0a 20 20 20 20 20 20 4 - 2) ){.
2fc10 20 20 2f 2a 20 56 61 6c 75 65 20 6f 66 20 6b 20 /* Value of k
2fc20 69 73 20 6f 75 74 20 6f 66 20 72 61 6e 67 65 2e is out of range.
2fc30 20 20 44 61 74 61 62 61 73 65 20 63 6f 72 72 75 Database corru
2fc40 70 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 20 20 20 ption */.
2fc50 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 rc = SQLITE_COR
2fc60 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 RUPT_BKPT;.
2fc70 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f goto end_allo
2fc80 63 61 74 65 5f 70 61 67 65 3b 0a 23 69 66 6e 64 cate_page;.#ifnd
2fc90 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
2fca0 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 UTOVACUUM.
2fcb0 7d 65 6c 73 65 20 69 66 28 20 73 65 61 72 63 68 }else if( search
2fcc0 4c 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 20 List .
2fcd0 20 20 26 26 20 28 6e 65 61 72 62 79 3d 3d 69 54 && (nearby==iT
2fce0 72 75 6e 6b 20 7c 7c 20 28 69 54 72 75 6e 6b 3c runk || (iTrunk<
2fcf0 6e 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d nearby && eMode=
2fd00 3d 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 =BTALLOC_LE)) .
2fd10 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 ){.
2fd20 2f 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 62 /* The list is b
2fd30 65 69 6e 67 20 73 65 61 72 63 68 65 64 20 61 6e eing searched an
2fd40 64 20 74 68 69 73 20 74 72 75 6e 6b 20 70 61 67 d this trunk pag
2fd50 65 20 69 73 20 74 68 65 20 70 61 67 65 0a 20 20 e is the page.
2fd60 20 20 20 20 20 20 2a 2a 20 74 6f 20 61 6c 6c 6f ** to allo
2fd70 63 61 74 65 2c 20 72 65 67 61 72 64 6c 65 73 73 cate, regardless
2fd80 20 6f 66 20 77 68 65 74 68 65 72 20 69 74 20 68 of whether it h
2fd90 61 73 20 6c 65 61 76 65 73 2e 0a 20 20 20 20 20 as leaves..
2fda0 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 2a 70 */. *p
2fdb0 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 Pgno = iTrunk;.
2fdc0 20 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d *ppPage =
2fdd0 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 pTrunk;.
2fde0 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b searchList = 0;
2fdf0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
2fe00 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
2fe10 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 pTrunk->pDbPage)
2fe20 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
2fe30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f ){. go
2fe40 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f to end_allocate_
2fe50 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a page;. }.
2fe60 20 20 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 if( k==0
2fe70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 ){. if
2fe80 28 20 21 70 50 72 65 76 54 72 75 6e 6b 20 29 7b ( !pPrevTrunk ){
2fe90 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d . mem
2fea0 63 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 cpy(&pPage1->aDa
2feb0 74 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d ta[32], &pTrunk-
2fec0 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 >aData[0], 4);.
2fed0 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }else{.
2fee0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
2fef0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
2ff00 74 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 te(pPrevTrunk->p
2ff10 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
2ff20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
2ff30 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2ff40 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
2ff50 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
2ff60 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
2ff70 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
2ff80 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 (&pPrevTrunk->aD
2ff90 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e 6b 2d ata[0], &pTrunk-
2ffa0 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 >aData[0], 4);.
2ffb0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2ffc0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2ffd0 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b /* The trunk
2ffe0 20 70 61 67 65 20 69 73 20 72 65 71 75 69 72 65 page is require
2fff0 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 20 d by the caller
30000 62 75 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 but it contains
30010 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 6f . ** po
30020 69 6e 74 65 72 73 20 74 6f 20 66 72 65 65 2d 6c inters to free-l
30030 69 73 74 20 6c 65 61 76 65 73 2e 20 54 68 65 20 ist leaves. The
30040 66 69 72 73 74 20 6c 65 61 66 20 62 65 63 6f 6d first leaf becom
30050 65 73 20 61 20 74 72 75 6e 6b 0a 20 20 20 20 20 es a trunk.
30060 20 20 20 20 20 2a 2a 20 70 61 67 65 20 69 6e 20 ** page in
30070 74 68 69 73 20 63 61 73 65 2e 0a 20 20 20 20 20 this case..
30080 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
30090 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 54 MemPage *pNewT
300a0 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 runk;.
300b0 50 67 6e 6f 20 69 4e 65 77 54 72 75 6e 6b 20 3d Pgno iNewTrunk =
300c0 20 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e get4byte(&pTrun
300d0 6b 2d 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 20 k->aData[8]);.
300e0 20 20 20 20 20 20 20 20 69 66 28 20 69 4e 65 77 if( iNew
300f0 54 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b 20 Trunk>mxPage ){
30100 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
30110 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
30120 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 _BKPT;.
30130 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f goto end_allo
30140 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 cate_page;.
30150 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
30160 20 74 65 73 74 63 61 73 65 28 20 69 4e 65 77 54 testcase( iNewT
30170 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a runk==mxPage );.
30180 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 rc = b
30190 74 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 treeGetUnusedPag
301a0 65 28 70 42 74 2c 20 69 4e 65 77 54 72 75 6e 6b e(pBt, iNewTrunk
301b0 2c 20 26 70 4e 65 77 54 72 75 6e 6b 2c 20 30 29 , &pNewTrunk, 0)
301c0 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
301d0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
301e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 . got
301f0 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 o end_allocate_p
30200 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d age;. }
30210 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
30220 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
30230 65 28 70 4e 65 77 54 72 75 6e 6b 2d 3e 70 44 62 e(pNewTrunk->pDb
30240 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
30250 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
30260 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
30270 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e releasePage(pN
30280 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
30290 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
302a0 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
302b0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
302c0 20 20 20 20 6d 65 6d 63 70 79 28 26 70 4e 65 77 memcpy(&pNew
302d0 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c Trunk->aData[0],
302e0 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
302f0 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 0], 4);.
30300 20 20 70 75 74 34 62 79 74 65 28 26 70 4e 65 77 put4byte(&pNew
30310 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c Trunk->aData[4],
30320 20 6b 2d 31 29 3b 0a 20 20 20 20 20 20 20 20 20 k-1);.
30330 20 6d 65 6d 63 70 79 28 26 70 4e 65 77 54 72 75 memcpy(&pNewTru
30340 6e 6b 2d 3e 61 44 61 74 61 5b 38 5d 2c 20 26 70 nk->aData[8], &p
30350 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 31 32 5d Trunk->aData[12]
30360 2c 20 28 6b 2d 31 29 2a 34 29 3b 0a 20 20 20 20 , (k-1)*4);.
30370 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
30380 65 28 70 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 e(pNewTrunk);.
30390 20 20 20 20 20 20 20 20 69 66 28 20 21 70 50 72 if( !pPr
303a0 65 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 evTrunk ){.
303b0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 assert( s
303c0 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
303d0 74 65 61 62 6c 65 28 70 50 61 67 65 31 2d 3e 70 teable(pPage1->p
303e0 44 62 50 61 67 65 29 20 29 3b 0a 20 20 20 20 20 DbPage) );.
303f0 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
30400 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
30410 32 5d 2c 20 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 2], iNewTrunk);.
30420 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }else{
30430 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
30440 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
30450 69 74 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e ite(pPrevTrunk->
30460 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
30470 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
30480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 67 6f go
30490 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f to end_allocate_
304a0 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 page;.
304b0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
304c0 70 75 74 34 62 79 74 65 28 26 70 50 72 65 76 54 put4byte(&pPrevT
304d0 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 runk->aData[0],
304e0 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 iNewTrunk);.
304f0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
30500 7d 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b }. pTrunk
30510 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 54 52 = 0;. TR
30520 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 ACE(("ALLOCATE:
30530 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 20 66 72 %d trunk - %d fr
30540 65 65 20 70 61 67 65 73 20 6c 65 66 74 5c 6e 22 ee pages left\n"
30550 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b , *pPgno, n-1));
30560 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 7d 65 .#endif. }e
30570 6c 73 65 20 69 66 28 20 6b 3e 30 20 29 7b 0a 20 lse if( k>0 ){.
30580 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 63 /* Extrac
30590 74 20 61 20 6c 65 61 66 20 66 72 6f 6d 20 74 68 t a leaf from th
305a0 65 20 74 72 75 6e 6b 20 2a 2f 0a 20 20 20 20 20 e trunk */.
305b0 20 20 20 75 33 32 20 63 6c 6f 73 65 73 74 3b 0a u32 closest;.
305c0 20 20 20 20 20 20 20 20 50 67 6e 6f 20 69 50 61 Pgno iPa
305d0 67 65 3b 0a 20 20 20 20 20 20 20 20 75 6e 73 69 ge;. unsi
305e0 67 6e 65 64 20 63 68 61 72 20 2a 61 44 61 74 61 gned char *aData
305f0 20 3d 20 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 = pTrunk->aData
30600 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 65 ;. if( ne
30610 61 72 62 79 3e 30 20 29 7b 0a 20 20 20 20 20 20 arby>0 ){.
30620 20 20 20 20 75 33 32 20 69 3b 0a 20 20 20 20 20 u32 i;.
30630 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 30 closest = 0
30640 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
30650 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c eMode==BTALLOC_L
30660 45 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 E ){.
30670 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6b 3b 20 69 for(i=0; i<k; i
30680 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ++){.
30690 20 20 20 69 50 61 67 65 20 3d 20 67 65 74 34 62 iPage = get4b
306a0 79 74 65 28 26 61 44 61 74 61 5b 38 2b 69 2a 34 yte(&aData[8+i*4
306b0 5d 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ]);.
306c0 20 20 69 66 28 20 69 50 61 67 65 3c 3d 6e 65 61 if( iPage<=nea
306d0 72 62 79 20 29 7b 0a 20 20 20 20 20 20 20 20 20 rby ){.
306e0 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d closest =
306f0 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 i;.
30700 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
30710 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
30720 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
30730 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
30740 20 20 20 20 20 20 69 6e 74 20 64 69 73 74 3b 0a int dist;.
30750 20 20 20 20 20 20 20 20 20 20 20 20 64 69 73 74 dist
30760 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 = sqlite3AbsInt
30770 33 32 28 67 65 74 34 62 79 74 65 28 26 61 44 61 32(get4byte(&aDa
30780 74 61 5b 38 5d 29 20 2d 20 6e 65 61 72 62 79 29 ta[8]) - nearby)
30790 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f ;. fo
307a0 72 28 69 3d 31 3b 20 69 3c 6b 3b 20 69 2b 2b 29 r(i=1; i<k; i++)
307b0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
307c0 69 6e 74 20 64 32 20 3d 20 73 71 6c 69 74 65 33 int d2 = sqlite3
307d0 41 62 73 49 6e 74 33 32 28 67 65 74 34 62 79 74 AbsInt32(get4byt
307e0 65 28 26 61 44 61 74 61 5b 38 2b 69 2a 34 5d 29 e(&aData[8+i*4])
307f0 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 20 20 - nearby);.
30800 20 20 20 20 20 20 20 20 20 20 69 66 28 20 64 32 if( d2
30810 3c 64 69 73 74 20 29 7b 0a 20 20 20 20 20 20 20 <dist ){.
30820 20 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 closest
30830 20 3d 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 = i;.
30840 20 20 20 20 20 20 64 69 73 74 20 3d 20 64 32 3b dist = d2;
30850 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d . }
30860 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
30870 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
30880 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
30890 20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 30 3b closest = 0;
308a0 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 . }..
308b0 20 20 20 20 69 50 61 67 65 20 3d 20 67 65 74 34 iPage = get4
308c0 62 79 74 65 28 26 61 44 61 74 61 5b 38 2b 63 6c byte(&aData[8+cl
308d0 6f 73 65 73 74 2a 34 5d 29 3b 0a 20 20 20 20 20 osest*4]);.
308e0 20 20 20 74 65 73 74 63 61 73 65 28 20 69 50 61 testcase( iPa
308f0 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 20 ge==mxPage );.
30900 20 20 20 20 20 20 69 66 28 20 69 50 61 67 65 3e if( iPage>
30910 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 mxPage ){.
30920 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
30930 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
30940 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
30950 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
30960 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
30970 20 20 74 65 73 74 63 61 73 65 28 20 69 50 61 67 testcase( iPag
30980 65 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 e==mxPage );.
30990 20 20 20 20 20 69 66 28 20 21 73 65 61 72 63 68 if( !search
309a0 4c 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 7c List . |
309b0 7c 20 28 69 50 61 67 65 3d 3d 6e 65 61 72 62 79 | (iPage==nearby
309c0 20 7c 7c 20 28 69 50 61 67 65 3c 6e 65 61 72 62 || (iPage<nearb
309d0 79 20 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 4c y && eMode==BTAL
309e0 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 20 LOC_LE)) .
309f0 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 ){. i
30a00 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 3b 0a 20 20 nt noContent;.
30a10 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 3d *pPgno =
30a20 20 69 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 iPage;.
30a30 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 TRACE(("ALLOCA
30a40 54 45 3a 20 25 64 20 77 61 73 20 6c 65 61 66 20 TE: %d was leaf
30a50 25 64 20 6f 66 20 25 64 20 6f 6e 20 74 72 75 6e %d of %d on trun
30a60 6b 20 25 64 22 0a 20 20 20 20 20 20 20 20 20 20 k %d".
30a70 20 20 20 20 20 20 20 22 3a 20 25 64 20 6d 6f 72 ": %d mor
30a80 65 20 66 72 65 65 20 70 61 67 65 73 5c 6e 22 2c e free pages\n",
30a90 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
30aa0 20 20 2a 70 50 67 6e 6f 2c 20 63 6c 6f 73 65 73 *pPgno, closes
30ab0 74 2b 31 2c 20 6b 2c 20 70 54 72 75 6e 6b 2d 3e t+1, k, pTrunk->
30ac0 70 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 20 20 20 pgno, n-1));.
30ad0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
30ae0 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 54 te3PagerWrite(pT
30af0 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a runk->pDbPage);.
30b00 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
30b10 20 29 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f ) goto end_allo
30b20 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 cate_page;.
30b30 20 20 20 20 20 69 66 28 20 63 6c 6f 73 65 73 74 if( closest
30b40 3c 6b 2d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 <k-1 ){.
30b50 20 20 20 20 6d 65 6d 63 70 79 28 26 61 44 61 74 memcpy(&aDat
30b60 61 5b 38 2b 63 6c 6f 73 65 73 74 2a 34 5d 2c 20 a[8+closest*4],
30b70 26 61 44 61 74 61 5b 34 2b 6b 2a 34 5d 2c 20 34 &aData[4+k*4], 4
30b80 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
30b90 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 put4byt
30ba0 65 28 26 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 e(&aData[4], k-1
30bb0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 6f 43 );. noC
30bc0 6f 6e 74 65 6e 74 20 3d 20 21 62 74 72 65 65 47 ontent = !btreeG
30bd0 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 74 etHasContent(pBt
30be0 2c 20 2a 70 50 67 6e 6f 29 3f 20 50 41 47 45 52 , *pPgno)? PAGER
30bf0 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 3a _GET_NOCONTENT :
30c00 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 0;. rc
30c10 20 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 = btreeGetUnuse
30c20 64 50 61 67 65 28 70 42 74 2c 20 2a 70 50 67 6e dPage(pBt, *pPgn
30c30 6f 2c 20 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e o, ppPage, noCon
30c40 74 65 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 20 tent);.
30c50 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
30c60 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
30c70 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
30c80 67 65 72 57 72 69 74 65 28 28 2a 70 70 50 61 67 gerWrite((*ppPag
30c90 65 29 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e)->pDbPage);.
30ca0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
30cb0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
30cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c rel
30cd0 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 65 easePage(*ppPage
30ce0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 );.
30cf0 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 *ppPage = 0;.
30d00 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
30d10 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
30d20 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 searchList = 0
30d30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
30d40 20 20 7d 0a 20 20 20 20 20 20 72 65 6c 65 61 73 }. releas
30d50 65 50 61 67 65 28 70 50 72 65 76 54 72 75 6e 6b ePage(pPrevTrunk
30d60 29 3b 0a 20 20 20 20 20 20 70 50 72 65 76 54 72 );. pPrevTr
30d70 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 7d 77 68 unk = 0;. }wh
30d80 69 6c 65 28 20 73 65 61 72 63 68 4c 69 73 74 20 ile( searchList
30d90 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
30da0 2f 2a 20 54 68 65 72 65 20 61 72 65 20 6e 6f 20 /* There are no
30db0 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 pages on the fre
30dc0 65 6c 69 73 74 2c 20 73 6f 20 61 70 70 65 6e 64 elist, so append
30dd0 20 61 20 6e 65 77 20 70 61 67 65 20 74 6f 20 74 a new page to t
30de0 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 he. ** databa
30df0 73 65 20 69 6d 61 67 65 2e 0a 20 20 20 20 2a 2a se image.. **
30e00 0a 20 20 20 20 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 . ** Normally
30e10 2c 20 6e 65 77 20 70 61 67 65 73 20 61 6c 6c 6f , new pages allo
30e20 63 61 74 65 64 20 62 79 20 74 68 69 73 20 62 6c cated by this bl
30e30 6f 63 6b 20 63 61 6e 20 62 65 20 72 65 71 75 65 ock can be reque
30e40 73 74 65 64 20 66 72 6f 6d 20 74 68 65 0a 20 20 sted from the.
30e50 20 20 2a 2a 20 70 61 67 65 72 20 6c 61 79 65 72 ** pager layer
30e60 20 77 69 74 68 20 74 68 65 20 27 6e 6f 2d 63 6f with the 'no-co
30e70 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 65 74 2e ntent' flag set.
30e80 20 54 68 69 73 20 70 72 65 76 65 6e 74 73 20 74 This prevents t
30e90 68 65 20 70 61 67 65 72 0a 20 20 20 20 2a 2a 20 he pager. **
30ea0 66 72 6f 6d 20 74 72 79 69 6e 67 20 74 6f 20 72 from trying to r
30eb0 65 61 64 20 74 68 65 20 70 61 67 65 73 20 63 6f ead the pages co
30ec0 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 73 6b 2e ntent from disk.
30ed0 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 65 However, if the
30ee0 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 . ** current
30ef0 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 transaction has
30f00 61 6c 72 65 61 64 79 20 72 75 6e 20 6f 6e 65 20 already run one
30f10 6f 72 20 6d 6f 72 65 20 69 6e 63 72 65 6d 65 6e or more incremen
30f20 74 61 6c 2d 76 61 63 75 75 6d 0a 20 20 20 20 2a tal-vacuum. *
30f30 2a 20 73 74 65 70 73 2c 20 74 68 65 6e 20 74 68 * steps, then th
30f40 65 20 70 61 67 65 20 77 65 20 61 72 65 20 61 62 e page we are ab
30f50 6f 75 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 out to allocate
30f60 6d 61 79 20 63 6f 6e 74 61 69 6e 20 63 6f 6e 74 may contain cont
30f70 65 6e 74 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 ent. ** that
30f80 69 73 20 72 65 71 75 69 72 65 64 20 69 6e 20 74 is required in t
30f90 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 72 6f he event of a ro
30fa0 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 68 69 73 20 llback. In this
30fb0 63 61 73 65 2c 20 64 6f 0a 20 20 20 20 2a 2a 20 case, do. **
30fc0 6e 6f 74 20 73 65 74 20 74 68 65 20 6e 6f 2d 63 not set the no-c
30fd0 6f 6e 74 65 6e 74 20 66 6c 61 67 2e 20 54 68 69 ontent flag. Thi
30fe0 73 20 63 61 75 73 65 73 20 74 68 65 20 70 61 67 s causes the pag
30ff0 65 72 20 74 6f 20 6c 6f 61 64 20 61 6e 64 20 6a er to load and j
31000 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 74 68 ournal. ** th
31010 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 20 63 e current page c
31020 6f 6e 74 65 6e 74 20 62 65 66 6f 72 65 20 6f 76 ontent before ov
31030 65 72 77 72 69 74 69 6e 67 20 69 74 2e 0a 20 20 erwriting it..
31040 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 74 65 **. ** Note
31050 20 74 68 61 74 20 74 68 65 20 70 61 67 65 72 20 that the pager
31060 77 69 6c 6c 20 6e 6f 74 20 61 63 74 75 61 6c 6c will not actuall
31070 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6c 6f 61 y attempt to loa
31080 64 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 d or journal .
31090 20 20 2a 2a 20 63 6f 6e 74 65 6e 74 20 66 6f 72 ** content for
310a0 20 61 6e 79 20 70 61 67 65 20 74 68 61 74 20 72 any page that r
310b0 65 61 6c 6c 79 20 64 6f 65 73 20 6c 69 65 20 70 eally does lie p
310c0 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ast the end of t
310d0 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 he database.
310e0 2a 2a 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2e ** file on disk.
310f0 20 53 6f 20 74 68 65 20 65 66 66 65 63 74 73 20 So the effects
31100 6f 66 20 64 69 73 61 62 6c 69 6e 67 20 74 68 65 of disabling the
31110 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 6f 70 74 69 no-content opti
31120 6d 69 7a 61 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 mization. **
31130 68 65 72 65 20 61 72 65 20 63 6f 6e 66 69 6e 65 here are confine
31140 64 20 74 6f 20 74 68 6f 73 65 20 70 61 67 65 73 d to those pages
31150 20 74 68 61 74 20 6c 69 65 20 62 65 74 77 65 65 that lie betwee
31160 6e 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 n the end of the
31170 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 . ** database
31180 20 69 6d 61 67 65 20 61 6e 64 20 74 68 65 20 65 image and the e
31190 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 nd of the databa
311a0 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a se file.. */.
311b0 20 20 20 20 69 6e 74 20 62 4e 6f 43 6f 6e 74 65 int bNoConte
311c0 6e 74 20 3d 20 28 30 3d 3d 49 66 4e 6f 74 4f 6d nt = (0==IfNotOm
311d0 69 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 75 itAV(pBt->bDoTru
311e0 6e 63 61 74 65 29 29 3f 20 50 41 47 45 52 5f 47 ncate))? PAGER_G
311f0 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 3a 30 3b 0a ET_NOCONTENT:0;.
31200 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
31210 33 50 61 67 65 72 57 72 69 74 65 28 70 42 74 2d 3PagerWrite(pBt-
31220 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 >pPage1->pDbPage
31230 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
31240 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 70 return rc;. p
31250 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 Bt->nPage++;.
31260 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 3d if( pBt->nPage=
31270 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 =PENDING_BYTE_PA
31280 47 45 28 70 42 74 29 20 29 20 70 42 74 2d 3e 6e GE(pBt) ) pBt->n
31290 50 61 67 65 2b 2b 3b 0a 0a 23 69 66 6e 64 65 66 Page++;..#ifndef
312a0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
312b0 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 20 OVACUUM. if(
312c0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
312d0 26 26 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 && PTRMAP_ISPAGE
312e0 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 65 (pBt, pBt->nPage
312f0 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 ) ){. /* If
31300 20 2a 70 50 67 6e 6f 20 72 65 66 65 72 73 20 74 *pPgno refers t
31310 6f 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 o a pointer-map
31320 70 61 67 65 2c 20 61 6c 6c 6f 63 61 74 65 20 74 page, allocate t
31330 77 6f 20 6e 65 77 20 70 61 67 65 73 0a 20 20 20 wo new pages.
31340 20 20 20 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 ** at the end
31350 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e 73 of the file ins
31360 74 65 61 64 20 6f 66 20 6f 6e 65 2e 20 54 68 65 tead of one. The
31370 20 66 69 72 73 74 20 61 6c 6c 6f 63 61 74 65 64 first allocated
31380 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 page. ** b
31390 65 63 6f 6d 65 73 20 61 20 6e 65 77 20 70 6f 69 ecomes a new poi
313a0 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 74 nter-map page, t
313b0 68 65 20 73 65 63 6f 6e 64 20 69 73 20 75 73 65 he second is use
313c0 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 2e d by the caller.
313d0 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
313e0 4d 65 6d 50 61 67 65 20 2a 70 50 67 20 3d 20 30 MemPage *pPg = 0
313f0 3b 0a 20 20 20 20 20 20 54 52 41 43 45 28 28 22 ;. TRACE(("
31400 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 72 6f ALLOCATE: %d fro
31410 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 20 28 70 m end of file (p
31420 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 29 ointer-map page)
31430 5c 6e 22 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 \n", pBt->nPage)
31440 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
31450 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 50 45 4e pBt->nPage!=PEN
31460 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 DING_BYTE_PAGE(p
31470 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72 63 20 Bt) );. rc
31480 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 = btreeGetUnused
31490 50 61 67 65 28 70 42 74 2c 20 70 42 74 2d 3e 6e Page(pBt, pBt->n
314a0 50 61 67 65 2c 20 26 70 50 67 2c 20 62 4e 6f 43 Page, &pPg, bNoC
314b0 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 20 69 ontent);. i
314c0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
314d0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
314e0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
314f0 74 65 28 70 50 67 2d 3e 70 44 62 50 61 67 65 29 te(pPg->pDbPage)
31500 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 ;. releas
31510 65 50 61 67 65 28 70 50 67 29 3b 0a 20 20 20 20 ePage(pPg);.
31520 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 }. if( rc
31530 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
31540 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b pBt->nPage++
31550 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 2d ;. if( pBt-
31560 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 4e 47 5f >nPage==PENDING_
31570 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 BYTE_PAGE(pBt) )
31580 7b 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 20 { pBt->nPage++;
31590 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
315a0 20 20 20 70 75 74 34 62 79 74 65 28 32 38 20 2b put4byte(28 +
315b0 20 28 75 38 2a 29 70 42 74 2d 3e 70 50 61 67 65 (u8*)pBt->pPage
315c0 31 2d 3e 61 44 61 74 61 2c 20 70 42 74 2d 3e 6e 1->aData, pBt->n
315d0 50 61 67 65 29 3b 0a 20 20 20 20 2a 70 50 67 6e Page);. *pPgn
315e0 6f 20 3d 20 70 42 74 2d 3e 6e 50 61 67 65 3b 0a o = pBt->nPage;.
315f0 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 50 . assert( *pP
31600 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 gno!=PENDING_BYT
31610 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a 20 E_PAGE(pBt) );.
31620 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
31630 55 6e 75 73 65 64 50 61 67 65 28 70 42 74 2c 20 UnusedPage(pBt,
31640 2a 70 50 67 6e 6f 2c 20 70 70 50 61 67 65 2c 20 *pPgno, ppPage,
31650 62 4e 6f 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 bNoContent);.
31660 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
31670 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 rc;. rc = sq
31680 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
31690 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 61 (*ppPage)->pDbPa
316a0 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 ge);. if( rc!
316b0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
316c0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
316d0 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 *ppPage);.
316e0 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 20 *ppPage = 0;.
316f0 20 7d 0a 20 20 20 20 54 52 41 43 45 28 28 22 41 }. TRACE(("A
31700 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 72 6f 6d LLOCATE: %d from
31710 20 65 6e 64 20 6f 66 20 66 69 6c 65 5c 6e 22 2c end of file\n",
31720 20 2a 70 50 67 6e 6f 29 29 3b 0a 20 20 7d 0a 0a *pPgno));. }..
31730 20 20 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f assert( *pPgno
31740 21 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 !=PENDING_BYTE_P
31750 41 47 45 28 70 42 74 29 20 29 3b 0a 0a 65 6e 64 AGE(pBt) );..end
31760 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3a 0a _allocate_page:.
31770 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 releasePage(pT
31780 72 75 6e 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65 runk);. release
31790 50 61 67 65 28 70 50 72 65 76 54 72 75 6e 6b 29 Page(pPrevTrunk)
317a0 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d ;. assert( rc!=
317b0 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c SQLITE_OK || sql
317c0 69 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 ite3PagerPageRef
317d0 63 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 2d count((*ppPage)-
317e0 3e 70 44 62 50 61 67 65 29 3c 3d 31 20 29 3b 0a >pDbPage)<=1 );.
317f0 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 assert( rc!=SQ
31800 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 2a 70 70 50 LITE_OK || (*ppP
31810 61 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 age)->isInit==0
31820 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
31830 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
31840 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 nction is used t
31850 6f 20 61 64 64 20 70 61 67 65 20 69 50 61 67 65 o add page iPage
31860 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
31870 20 66 69 6c 65 20 66 72 65 65 2d 6c 69 73 74 2e file free-list.
31880 20 0a 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d .** It is assum
31890 65 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 ed that the page
318a0 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
318b0 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 72 a part of the fr
318c0 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 ee-list..**.** T
318d0 68 65 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 he value passed
318e0 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 as the second ar
318f0 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 gument to this f
31900 75 6e 63 74 69 6f 6e 20 69 73 20 6f 70 74 69 6f unction is optio
31910 6e 61 6c 2e 0a 2a 2a 20 49 66 20 74 68 65 20 63 nal..** If the c
31920 61 6c 6c 65 72 20 68 61 70 70 65 6e 73 20 74 6f aller happens to
31930 20 68 61 76 65 20 61 20 70 6f 69 6e 74 65 72 20 have a pointer
31940 74 6f 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f to the MemPage o
31950 62 6a 65 63 74 20 0a 2a 2a 20 63 6f 72 72 65 73 bject .** corres
31960 70 6f 6e 64 69 6e 67 20 74 6f 20 70 61 67 65 20 ponding to page
31970 69 50 61 67 65 20 68 61 6e 64 79 2c 20 69 74 20 iPage handy, it
31980 6d 61 79 20 70 61 73 73 20 69 74 20 61 73 20 74 may pass it as t
31990 68 65 20 73 65 63 6f 6e 64 20 76 61 6c 75 65 2e he second value.
319a0 20 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 .** Otherwise,
319b0 69 74 20 6d 61 79 20 70 61 73 73 20 4e 55 4c 4c it may pass NULL
319c0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 70 6f 69 ..**.** If a poi
319d0 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 50 61 67 nter to a MemPag
319e0 65 20 6f 62 6a 65 63 74 20 69 73 20 70 61 73 73 e object is pass
319f0 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
31a00 20 61 72 67 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 argument,.** it
31a10 73 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e s reference coun
31a20 74 20 69 73 20 6e 6f 74 20 61 6c 74 65 72 65 64 t is not altered
31a30 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f by this functio
31a40 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 n..*/.static int
31a50 20 66 72 65 65 50 61 67 65 32 28 42 74 53 68 61 freePage2(BtSha
31a60 72 65 64 20 2a 70 42 74 2c 20 4d 65 6d 50 61 67 red *pBt, MemPag
31a70 65 20 2a 70 4d 65 6d 50 61 67 65 2c 20 50 67 6e e *pMemPage, Pgn
31a80 6f 20 69 50 61 67 65 29 7b 0a 20 20 4d 65 6d 50 o iPage){. MemP
31a90 61 67 65 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b age *pTrunk = 0;
31aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31ab0 2f 2a 20 46 72 65 65 2d 6c 69 73 74 20 74 72 75 /* Free-list tru
31ac0 6e 6b 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e nk page */. Pgn
31ad0 6f 20 69 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 o iTrunk = 0;
31ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31af0 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 /* Page number
31b00 6f 66 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 of free-list tru
31b10 6e 6b 20 70 61 67 65 20 2a 2f 20 0a 20 20 4d 65 nk page */ . Me
31b20 6d 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 mPage *pPage1 =
31b30 70 42 74 2d 3e 70 50 61 67 65 31 3b 20 20 20 20 pBt->pPage1;
31b40 20 20 2f 2a 20 4c 6f 63 61 6c 20 72 65 66 65 72 /* Local refer
31b50 65 6e 63 65 20 74 6f 20 70 61 67 65 20 31 20 2a ence to page 1 *
31b60 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 /. MemPage *pPa
31b70 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
31b80 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
31b90 62 65 69 6e 67 20 66 72 65 65 64 2e 20 4d 61 79 being freed. May
31ba0 20 62 65 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 be NULL. */. i
31bb0 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
31bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31bd0 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 /* Return Cod
31be0 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 e */. int nFree
31bf0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
31c00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
31c10 69 74 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 itial number of
31c20 70 61 67 65 73 20 6f 6e 20 66 72 65 65 2d 6c 69 pages on free-li
31c30 73 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 st */.. assert(
31c40 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
31c50 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
31c60 29 3b 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 );. assert( COR
31c70 52 55 50 54 5f 44 42 20 7c 7c 20 69 50 61 67 65 RUPT_DB || iPage
31c80 3e 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 >1 );. assert(
31c90 21 70 4d 65 6d 50 61 67 65 20 7c 7c 20 70 4d 65 !pMemPage || pMe
31ca0 6d 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 mPage->pgno==iPa
31cb0 67 65 20 29 3b 0a 0a 20 20 69 66 28 20 69 50 61 ge );.. if( iPa
31cc0 67 65 3c 32 20 29 20 72 65 74 75 72 6e 20 53 51 ge<2 ) return SQ
31cd0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
31ce0 54 3b 0a 20 20 69 66 28 20 70 4d 65 6d 50 61 67 T;. if( pMemPag
31cf0 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 20 3d e ){. pPage =
31d00 20 70 4d 65 6d 50 61 67 65 3b 0a 20 20 20 20 73 pMemPage;. s
31d10 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 28 70 qlite3PagerRef(p
31d20 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a Page->pDbPage);.
31d30 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 }else{. pPa
31d40 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 4c 6f ge = btreePageLo
31d50 6f 6b 75 70 28 70 42 74 2c 20 69 50 61 67 65 29 okup(pBt, iPage)
31d60 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 63 72 ;. }.. /* Incr
31d70 65 6d 65 6e 74 20 74 68 65 20 66 72 65 65 20 70 ement the free p
31d80 61 67 65 20 63 6f 75 6e 74 20 6f 6e 20 70 50 61 age count on pPa
31d90 67 65 31 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 ge1 */. rc = sq
31da0 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
31db0 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 pPage1->pDbPage)
31dc0 3b 0a 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 ;. if( rc ) got
31dd0 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
31de0 20 20 6e 46 72 65 65 20 3d 20 67 65 74 34 62 79 nFree = get4by
31df0 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
31e00 61 5b 33 36 5d 29 3b 0a 20 20 70 75 74 34 62 79 a[36]);. put4by
31e10 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
31e20 61 5b 33 36 5d 2c 20 6e 46 72 65 65 2b 31 29 3b a[36], nFree+1);
31e30 0a 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 73 .. if( pBt->bts
31e40 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 55 Flags & BTS_SECU
31e50 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 20 RE_DELETE ){.
31e60 20 2f 2a 20 49 66 20 74 68 65 20 73 65 63 75 72 /* If the secur
31e70 65 5f 64 65 6c 65 74 65 20 6f 70 74 69 6f 6e 20 e_delete option
31e80 69 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e is enabled, then
31e90 0a 20 20 20 20 2a 2a 20 61 6c 77 61 79 73 20 66 . ** always f
31ea0 75 6c 6c 79 20 6f 76 65 72 77 72 69 74 65 20 64 ully overwrite d
31eb0 65 6c 65 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 eleted informati
31ec0 6f 6e 20 77 69 74 68 20 7a 65 72 6f 73 2e 0a 20 on with zeros..
31ed0 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 21 */. if( (!
31ee0 70 50 61 67 65 20 26 26 20 28 28 72 63 20 3d 20 pPage && ((rc =
31ef0 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
31f00 2c 20 69 50 61 67 65 2c 20 26 70 50 61 67 65 2c , iPage, &pPage,
31f10 20 30 29 29 21 3d 30 29 20 29 0a 20 20 20 20 20 0))!=0) ).
31f20 7c 7c 20 20 20 20 20 20 20 20 20 20 20 20 28 28 || ((
31f30 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
31f40 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 rWrite(pPage->pD
31f50 62 50 61 67 65 29 29 21 3d 30 29 0a 20 20 20 20 bPage))!=0).
31f60 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 ){. goto fr
31f70 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 eepage_out;.
31f80 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 50 61 }. memset(pPa
31f90 67 65 2d 3e 61 44 61 74 61 2c 20 30 2c 20 70 50 ge->aData, 0, pP
31fa0 61 67 65 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 age->pBt->pageSi
31fb0 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 ze);. }.. /* I
31fc0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 f the database s
31fd0 75 70 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 upports auto-vac
31fe0 75 75 6d 2c 20 77 72 69 74 65 20 61 6e 20 65 6e uum, write an en
31ff0 74 72 79 20 69 6e 20 74 68 65 20 70 6f 69 6e 74 try in the point
32000 65 72 2d 6d 61 70 0a 20 20 2a 2a 20 74 6f 20 69 er-map. ** to i
32010 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 68 65 ndicate that the
32020 20 70 61 67 65 20 69 73 20 66 72 65 65 2e 0a 20 page is free..
32030 20 2a 2f 0a 20 20 69 66 28 20 49 53 41 55 54 4f */. if( ISAUTO
32040 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 70 74 VACUUM ){. pt
32050 72 6d 61 70 50 75 74 28 70 42 74 2c 20 69 50 61 rmapPut(pBt, iPa
32060 67 65 2c 20 50 54 52 4d 41 50 5f 46 52 45 45 50 ge, PTRMAP_FREEP
32070 41 47 45 2c 20 30 2c 20 26 72 63 29 3b 0a 20 20 AGE, 0, &rc);.
32080 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 if( rc ) goto
32090 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 freepage_out;.
320a0 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 6d 61 6e 69 }.. /* Now mani
320b0 70 75 6c 61 74 65 20 74 68 65 20 61 63 74 75 61 pulate the actua
320c0 6c 20 64 61 74 61 62 61 73 65 20 66 72 65 65 2d l database free-
320d0 6c 69 73 74 20 73 74 72 75 63 74 75 72 65 2e 20 list structure.
320e0 54 68 65 72 65 20 61 72 65 20 74 77 6f 0a 20 20 There are two.
320f0 2a 2a 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 ** possibilities
32100 2e 20 49 66 20 74 68 65 20 66 72 65 65 2d 6c 69 . If the free-li
32110 73 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 st is currently
32120 65 6d 70 74 79 2c 20 6f 72 20 69 66 20 74 68 65 empty, or if the
32130 20 66 69 72 73 74 0a 20 20 2a 2a 20 74 72 75 6e first. ** trun
32140 6b 20 70 61 67 65 20 69 6e 20 74 68 65 20 66 72 k page in the fr
32150 65 65 2d 6c 69 73 74 20 69 73 20 66 75 6c 6c 2c ee-list is full,
32160 20 74 68 65 6e 20 74 68 69 73 20 70 61 67 65 20 then this page
32170 77 69 6c 6c 20 62 65 63 6f 6d 65 20 61 0a 20 20 will become a.
32180 2a 2a 20 6e 65 77 20 66 72 65 65 2d 6c 69 73 74 ** new free-list
32190 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 4f 74 68 trunk page. Oth
321a0 65 72 77 69 73 65 2c 20 69 74 20 77 69 6c 6c 20 erwise, it will
321b0 62 65 63 6f 6d 65 20 61 20 6c 65 61 66 20 6f 66 become a leaf of
321c0 20 74 68 65 0a 20 20 2a 2a 20 66 69 72 73 74 20 the. ** first
321d0 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 trunk page in th
321e0 65 20 63 75 72 72 65 6e 74 20 66 72 65 65 2d 6c e current free-l
321f0 69 73 74 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 ist. This block
32200 74 65 73 74 73 20 69 66 20 69 74 0a 20 20 2a 2a tests if it. **
32210 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 is possible to
32220 61 64 64 20 74 68 65 20 70 61 67 65 20 61 73 20 add the page as
32230 61 20 6e 65 77 20 66 72 65 65 2d 6c 69 73 74 20 a new free-list
32240 6c 65 61 66 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 leaf.. */. if(
32250 20 6e 46 72 65 65 21 3d 30 20 29 7b 0a 20 20 20 nFree!=0 ){.
32260 20 75 33 32 20 6e 4c 65 61 66 3b 20 20 20 20 20 u32 nLeaf;
32270 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
32280 69 74 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 itial number of
32290 6c 65 61 66 20 63 65 6c 6c 73 20 6f 6e 20 74 72 leaf cells on tr
322a0 75 6e 6b 20 70 61 67 65 20 2a 2f 0a 0a 20 20 20 unk page */..
322b0 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 iTrunk = get4by
322c0 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
322d0 61 5b 33 32 5d 29 3b 0a 20 20 20 20 72 63 20 3d a[32]);. rc =
322e0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
322f0 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 t, iTrunk, &pTru
32300 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 nk, 0);. if(
32310 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
32320 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 65 65 . goto free
32330 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a page_out;. }.
32340 0a 20 20 20 20 6e 4c 65 61 66 20 3d 20 67 65 74 . nLeaf = get
32350 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
32360 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 20 61 73 Data[4]);. as
32370 73 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 6c sert( pBt->usabl
32380 65 53 69 7a 65 3e 33 32 20 29 3b 0a 20 20 20 20 eSize>32 );.
32390 69 66 28 20 6e 4c 65 61 66 20 3e 20 28 75 33 32 if( nLeaf > (u32
323a0 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 )pBt->usableSize
323b0 2f 34 20 2d 20 32 20 29 7b 0a 20 20 20 20 20 20 /4 - 2 ){.
323c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
323d0 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
323e0 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 goto freepage_ou
323f0 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 t;. }. if(
32400 20 6e 4c 65 61 66 20 3c 20 28 75 33 32 29 70 42 nLeaf < (u32)pB
32410 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 t->usableSize/4
32420 2d 20 38 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 - 8 ){. /*
32430 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
32440 72 65 20 69 73 20 72 6f 6f 6d 20 6f 6e 20 74 68 re is room on th
32450 65 20 74 72 75 6e 6b 20 70 61 67 65 20 74 6f 20 e trunk page to
32460 69 6e 73 65 72 74 20 74 68 65 20 70 61 67 65 0a insert the page.
32470 20 20 20 20 20 20 2a 2a 20 62 65 69 6e 67 20 66 ** being f
32480 72 65 65 64 20 61 73 20 61 20 6e 65 77 20 6c 65 reed as a new le
32490 61 66 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 af.. **.
324a0 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 ** Note that
324b0 74 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 the trunk page i
324c0 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 66 75 6c s not really ful
324d0 6c 20 75 6e 74 69 6c 20 69 74 20 63 6f 6e 74 61 l until it conta
324e0 69 6e 73 0a 20 20 20 20 20 20 2a 2a 20 75 73 61 ins. ** usa
324f0 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 20 65 6e bleSize/4 - 2 en
32500 74 72 69 65 73 2c 20 6e 6f 74 20 75 73 61 62 6c tries, not usabl
32510 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 6e 74 72 eSize/4 - 8 entr
32520 69 65 73 20 61 73 20 77 65 20 68 61 76 65 0a 20 ies as we have.
32530 20 20 20 20 20 2a 2a 20 63 6f 64 65 64 2e 20 20 ** coded.
32540 42 75 74 20 64 75 65 20 74 6f 20 61 20 63 6f 64 But due to a cod
32550 69 6e 67 20 65 72 72 6f 72 20 69 6e 20 76 65 72 ing error in ver
32560 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 sions of SQLite
32570 70 72 69 6f 72 20 74 6f 0a 20 20 20 20 20 20 2a prior to. *
32580 2a 20 33 2e 36 2e 30 2c 20 64 61 74 61 62 61 73 * 3.6.0, databas
32590 65 73 20 77 69 74 68 20 66 72 65 65 6c 69 73 74 es with freelist
325a0 20 74 72 75 6e 6b 20 70 61 67 65 73 20 68 6f 6c trunk pages hol
325b0 64 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 0a 20 ding more than.
325c0 20 20 20 20 20 2a 2a 20 75 73 61 62 6c 65 53 69 ** usableSi
325d0 7a 65 2f 34 20 2d 20 38 20 65 6e 74 72 69 65 73 ze/4 - 8 entries
325e0 20 77 69 6c 6c 20 62 65 20 72 65 70 6f 72 74 65 will be reporte
325f0 64 20 61 73 20 63 6f 72 72 75 70 74 2e 20 20 49 d as corrupt. I
32600 6e 20 6f 72 64 65 72 0a 20 20 20 20 20 20 2a 2a n order. **
32610 20 74 6f 20 6d 61 69 6e 74 61 69 6e 20 62 61 63 to maintain bac
32620 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 kwards compatibi
32630 6c 69 74 79 20 77 69 74 68 20 6f 6c 64 65 72 20 lity with older
32640 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 versions of SQLi
32650 74 65 2c 0a 20 20 20 20 20 20 2a 2a 20 77 65 20 te,. ** we
32660 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f will continue to
32670 20 72 65 73 74 72 69 63 74 20 74 68 65 20 6e 75 restrict the nu
32680 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 mber of entries
32690 74 6f 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 to usableSize/4
326a0 2d 20 38 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 - 8. ** for
326b0 20 6e 6f 77 2e 20 20 41 74 20 73 6f 6d 65 20 70 now. At some p
326c0 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74 75 oint in the futu
326d0 72 65 20 28 6f 6e 63 65 20 65 76 65 72 79 6f 6e re (once everyon
326e0 65 20 68 61 73 20 75 70 67 72 61 64 65 64 0a 20 e has upgraded.
326f0 20 20 20 20 20 2a 2a 20 74 6f 20 33 2e 36 2e 30 ** to 3.6.0
32700 20 6f 72 20 6c 61 74 65 72 29 20 77 65 20 73 68 or later) we sh
32710 6f 75 6c 64 20 63 6f 6e 73 69 64 65 72 20 66 69 ould consider fi
32720 78 69 6e 67 20 74 68 65 20 63 6f 6e 64 69 74 69 xing the conditi
32730 6f 6e 61 6c 20 61 62 6f 76 65 0a 20 20 20 20 20 onal above.
32740 20 2a 2a 20 74 6f 20 72 65 61 64 20 22 75 73 61 ** to read "usa
32750 62 6c 65 53 69 7a 65 2f 34 2d 32 22 20 69 6e 73 bleSize/4-2" ins
32760 74 65 61 64 20 6f 66 20 22 75 73 61 62 6c 65 53 tead of "usableS
32770 69 7a 65 2f 34 2d 38 22 2e 0a 20 20 20 20 20 20 ize/4-8"..
32780 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 45 56 49 44 **. ** EVID
32790 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 39 39 32 30 ENCE-OF: R-19920
327a0 2d 31 31 35 37 36 20 48 6f 77 65 76 65 72 2c 20 -11576 However,
327b0 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20 6f newer versions o
327c0 66 20 53 51 4c 69 74 65 20 73 74 69 6c 6c 0a 20 f SQLite still.
327d0 20 20 20 20 20 2a 2a 20 61 76 6f 69 64 20 75 73 ** avoid us
327e0 69 6e 67 20 74 68 65 20 6c 61 73 74 20 73 69 78 ing the last six
327f0 20 65 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 entries in the
32800 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 freelist trunk p
32810 61 67 65 20 61 72 72 61 79 20 69 6e 0a 20 20 20 age array in.
32820 20 20 20 2a 2a 20 6f 72 64 65 72 20 74 68 61 74 ** order that
32830 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 database files
32840 63 72 65 61 74 65 64 20 62 79 20 6e 65 77 65 72 created by newer
32850 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
32860 69 74 65 20 63 61 6e 20 62 65 0a 20 20 20 20 20 ite can be.
32870 20 2a 2a 20 72 65 61 64 20 62 79 20 6f 6c 64 65 ** read by olde
32880 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 r versions of SQ
32890 4c 69 74 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 Lite.. */.
328a0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
328b0 33 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 3PagerWrite(pTru
328c0 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 nk->pDbPage);.
328d0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
328e0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
328f0 20 70 75 74 34 62 79 74 65 28 26 70 54 72 75 6e put4byte(&pTrun
32900 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 6e 4c 65 k->aData[4], nLe
32910 61 66 2b 31 29 3b 0a 20 20 20 20 20 20 20 20 70 af+1);. p
32920 75 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d ut4byte(&pTrunk-
32930 3e 61 44 61 74 61 5b 38 2b 6e 4c 65 61 66 2a 34 >aData[8+nLeaf*4
32940 5d 2c 20 69 50 61 67 65 29 3b 0a 20 20 20 20 20 ], iPage);.
32950 20 20 20 69 66 28 20 70 50 61 67 65 20 26 26 20 if( pPage &&
32960 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
32970 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
32980 54 45 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 TE)==0 ){.
32990 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 sqlite3Pager
329a0 44 6f 6e 74 57 72 69 74 65 28 70 50 61 67 65 2d DontWrite(pPage-
329b0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
329c0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 72 63 20 }. rc
329d0 3d 20 62 74 72 65 65 53 65 74 48 61 73 43 6f 6e = btreeSetHasCon
329e0 74 65 6e 74 28 70 42 74 2c 20 69 50 61 67 65 29 tent(pBt, iPage)
329f0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
32a00 54 52 41 43 45 28 28 22 46 52 45 45 2d 50 41 47 TRACE(("FREE-PAG
32a10 45 3a 20 25 64 20 6c 65 61 66 20 6f 6e 20 74 72 E: %d leaf on tr
32a20 75 6e 6b 20 70 61 67 65 20 25 64 5c 6e 22 2c 70 unk page %d\n",p
32a30 50 61 67 65 2d 3e 70 67 6e 6f 2c 70 54 72 75 6e Page->pgno,pTrun
32a40 6b 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 20 20 k->pgno));.
32a50 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
32a60 75 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 ut;. }. }..
32a70 20 2f 2a 20 49 66 20 63 6f 6e 74 72 6f 6c 20 66 /* If control f
32a80 6c 6f 77 73 20 74 6f 20 74 68 69 73 20 70 6f 69 lows to this poi
32a90 6e 74 2c 20 74 68 65 6e 20 69 74 20 77 61 73 20 nt, then it was
32aa0 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 not possible to
32ab0 61 64 64 20 74 68 65 0a 20 20 2a 2a 20 74 68 65 add the. ** the
32ac0 20 70 61 67 65 20 62 65 69 6e 67 20 66 72 65 65 page being free
32ad0 64 20 61 73 20 61 20 6c 65 61 66 20 70 61 67 65 d as a leaf page
32ae0 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 72 of the first tr
32af0 75 6e 6b 20 69 6e 20 74 68 65 20 66 72 65 65 2d unk in the free-
32b00 6c 69 73 74 2e 0a 20 20 2a 2a 20 50 6f 73 73 69 list.. ** Possi
32b10 62 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20 bly because the
32b20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 65 6d 70 free-list is emp
32b30 74 79 2c 20 6f 72 20 70 6f 73 73 69 62 6c 79 20 ty, or possibly
32b40 62 65 63 61 75 73 65 20 74 68 65 20 0a 20 20 2a because the . *
32b50 2a 20 66 69 72 73 74 20 74 72 75 6e 6b 20 69 6e * first trunk in
32b60 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 the free-list i
32b70 73 20 66 75 6c 6c 2e 20 45 69 74 68 65 72 20 77 s full. Either w
32b80 61 79 2c 20 74 68 65 20 70 61 67 65 20 62 65 69 ay, the page bei
32b90 6e 67 20 66 72 65 65 64 0a 20 20 2a 2a 20 77 69 ng freed. ** wi
32ba0 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 6e 65 ll become the ne
32bb0 77 20 66 69 72 73 74 20 74 72 75 6e 6b 20 70 61 w first trunk pa
32bc0 67 65 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c ge in the free-l
32bd0 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ist.. */. if(
32be0 70 50 61 67 65 3d 3d 30 20 26 26 20 53 51 4c 49 pPage==0 && SQLI
32bf0 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 62 74 72 TE_OK!=(rc = btr
32c00 65 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 eeGetPage(pBt, i
32c10 50 61 67 65 2c 20 26 70 50 61 67 65 2c 20 30 29 Page, &pPage, 0)
32c20 29 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 ) ){. goto fr
32c30 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a eepage_out;. }.
32c40 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
32c50 67 65 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e gerWrite(pPage->
32c60 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 pDbPage);. if(
32c70 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
32c80 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 . goto freepa
32c90 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 70 75 ge_out;. }. pu
32ca0 74 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 t4byte(pPage->aD
32cb0 61 74 61 2c 20 69 54 72 75 6e 6b 29 3b 0a 20 20 ata, iTrunk);.
32cc0 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 2d put4byte(&pPage-
32cd0 3e 61 44 61 74 61 5b 34 5d 2c 20 30 29 3b 0a 20 >aData[4], 0);.
32ce0 20 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 put4byte(&pPage
32cf0 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 50 1->aData[32], iP
32d00 61 67 65 29 3b 0a 20 20 54 52 41 43 45 28 28 22 age);. TRACE(("
32d10 46 52 45 45 2d 50 41 47 45 3a 20 25 64 20 6e 65 FREE-PAGE: %d ne
32d20 77 20 74 72 75 6e 6b 20 70 61 67 65 20 72 65 70 w trunk page rep
32d30 6c 61 63 69 6e 67 20 25 64 5c 6e 22 2c 20 70 50 lacing %d\n", pP
32d40 61 67 65 2d 3e 70 67 6e 6f 2c 20 69 54 72 75 6e age->pgno, iTrun
32d50 6b 29 29 3b 0a 0a 66 72 65 65 70 61 67 65 5f 6f k));..freepage_o
32d60 75 74 3a 0a 20 20 69 66 28 20 70 50 61 67 65 20 ut:. if( pPage
32d70 29 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 ){. pPage->is
32d80 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Init = 0;. }.
32d90 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 releasePage(pPag
32da0 65 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 61 67 e);. releasePag
32db0 65 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 74 e(pTrunk);. ret
32dc0 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 urn rc;.}.static
32dd0 20 76 6f 69 64 20 66 72 65 65 50 61 67 65 28 4d void freePage(M
32de0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 emPage *pPage, i
32df0 6e 74 20 2a 70 52 43 29 7b 0a 20 20 69 66 28 20 nt *pRC){. if(
32e00 28 2a 70 52 43 29 3d 3d 53 51 4c 49 54 45 5f 4f (*pRC)==SQLITE_O
32e10 4b 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 K ){. *pRC =
32e20 66 72 65 65 50 61 67 65 32 28 70 50 61 67 65 2d freePage2(pPage-
32e30 3e 70 42 74 2c 20 70 50 61 67 65 2c 20 70 50 61 >pBt, pPage, pPa
32e40 67 65 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 7d ge->pgno);. }.}
32e50 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 79 ../*.** Free any
32e60 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 overflow pages
32e70 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
32e80 74 68 65 20 67 69 76 65 6e 20 43 65 6c 6c 2e 20 the given Cell.
32e90 20 57 72 69 74 65 20 74 68 65 0a 2a 2a 20 6c 6f Write the.** lo
32ea0 63 61 6c 20 43 65 6c 6c 20 73 69 7a 65 20 28 74 cal Cell size (t
32eb0 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
32ec0 65 73 20 6f 6e 20 74 68 65 20 6f 72 69 67 69 6e es on the origin
32ed0 61 6c 20 70 61 67 65 2c 20 6f 6d 69 74 74 69 6e al page, omittin
32ee0 67 0a 2a 2a 20 6f 76 65 72 66 6c 6f 77 29 20 69 g.** overflow) i
32ef0 6e 74 6f 20 2a 70 6e 53 69 7a 65 2e 0a 2a 2f 0a nto *pnSize..*/.
32f00 73 74 61 74 69 63 20 69 6e 74 20 63 6c 65 61 72 static int clear
32f10 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 Cell(. MemPage
32f20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 *pPage,
32f30 20 2f 2a 20 54 68 65 20 70 61 67 65 20 74 68 61 /* The page tha
32f40 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 43 t contains the C
32f50 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 ell */. unsigne
32f60 64 20 63 68 61 72 20 2a 70 43 65 6c 6c 2c 20 20 d char *pCell,
32f70 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
32f80 6f 66 20 74 68 65 20 43 65 6c 6c 20 2a 2f 0a 20 of the Cell */.
32f90 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f CellInfo *pInfo
32fa0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a /* Siz
32fb0 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 e information ab
32fc0 6f 75 74 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a out the cell */.
32fd0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
32fe0 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b Bt = pPage->pBt;
32ff0 0a 20 20 50 67 6e 6f 20 6f 76 66 6c 50 67 6e 6f . Pgno ovflPgno
33000 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e ;. int rc;. in
33010 74 20 6e 4f 76 66 6c 3b 0a 20 20 75 33 32 20 6f t nOvfl;. u32 o
33020 76 66 6c 50 61 67 65 53 69 7a 65 3b 0a 0a 20 20 vflPageSize;..
33030 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
33040 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
33050 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
33060 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 . pPage->xParse
33070 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c Cell(pPage, pCel
33080 6c 2c 20 70 49 6e 66 6f 29 3b 0a 20 20 69 66 28 l, pInfo);. if(
33090 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 3d 3d pInfo->nLocal==
330a0 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 pInfo->nPayload
330b0 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
330c0 4c 49 54 45 5f 4f 4b 3b 20 20 2f 2a 20 4e 6f 20 LITE_OK; /* No
330d0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 overflow pages.
330e0 52 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 64 Return without d
330f0 6f 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 2a 2f oing anything */
33100 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 65 6c 6c . }. if( pCell
33110 2b 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 2d 31 20 +pInfo->nSize-1
33120 3e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 2b 70 > pPage->aData+p
33130 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 29 Page->maskPage )
33140 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
33150 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
33160 3b 20 20 2f 2a 20 43 65 6c 6c 20 65 78 74 65 6e ; /* Cell exten
33170 64 73 20 70 61 73 74 20 65 6e 64 20 6f 66 20 70 ds past end of p
33180 61 67 65 20 2a 2f 0a 20 20 7d 0a 20 20 6f 76 66 age */. }. ovf
33190 6c 50 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 lPgno = get4byte
331a0 28 70 43 65 6c 6c 20 2b 20 70 49 6e 66 6f 2d 3e (pCell + pInfo->
331b0 6e 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 61 73 nSize - 4);. as
331c0 73 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 6c sert( pBt->usabl
331d0 65 53 69 7a 65 20 3e 20 34 20 29 3b 0a 20 20 6f eSize > 4 );. o
331e0 76 66 6c 50 61 67 65 53 69 7a 65 20 3d 20 70 42 vflPageSize = pB
331f0 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
33200 34 3b 0a 20 20 6e 4f 76 66 6c 20 3d 20 28 70 49 4;. nOvfl = (pI
33210 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 2d 20 nfo->nPayload -
33220 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 2b 20 pInfo->nLocal +
33230 6f 76 66 6c 50 61 67 65 53 69 7a 65 20 2d 20 31 ovflPageSize - 1
33240 29 2f 6f 76 66 6c 50 61 67 65 53 69 7a 65 3b 0a )/ovflPageSize;.
33250 20 20 61 73 73 65 72 74 28 20 6e 4f 76 66 6c 3e assert( nOvfl>
33260 30 20 7c 7c 20 0a 20 20 20 20 28 43 4f 52 52 55 0 || . (CORRU
33270 50 54 5f 44 42 20 26 26 20 28 70 49 6e 66 6f 2d PT_DB && (pInfo-
33280 3e 6e 50 61 79 6c 6f 61 64 20 2b 20 6f 76 66 6c >nPayload + ovfl
33290 50 61 67 65 53 69 7a 65 29 3c 6f 76 66 6c 50 61 PageSize)<ovflPa
332a0 67 65 53 69 7a 65 29 0a 20 20 29 3b 0a 20 20 77 geSize). );. w
332b0 68 69 6c 65 28 20 6e 4f 76 66 6c 2d 2d 20 29 7b hile( nOvfl-- ){
332c0 0a 20 20 20 20 50 67 6e 6f 20 69 4e 65 78 74 20 . Pgno iNext
332d0 3d 20 30 3b 0a 20 20 20 20 4d 65 6d 50 61 67 65 = 0;. MemPage
332e0 20 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 20 *pOvfl = 0;.
332f0 20 69 66 28 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 if( ovflPgno<2
33300 7c 7c 20 6f 76 66 6c 50 67 6e 6f 3e 62 74 72 65 || ovflPgno>btre
33310 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 20 ePagecount(pBt)
33320 29 7b 0a 20 20 20 20 20 20 2f 2a 20 30 20 69 73 ){. /* 0 is
33330 20 6e 6f 74 20 61 20 6c 65 67 61 6c 20 70 61 67 not a legal pag
33340 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 61 67 e number and pag
33350 65 20 31 20 63 61 6e 6e 6f 74 20 62 65 20 61 6e e 1 cannot be an
33360 20 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 66 . ** overf
33370 6c 6f 77 20 70 61 67 65 2e 20 54 68 65 72 65 66 low page. Theref
33380 6f 72 65 20 69 66 20 6f 76 66 6c 50 67 6e 6f 3c ore if ovflPgno<
33390 32 20 6f 72 20 70 61 73 74 20 74 68 65 20 65 6e 2 or past the en
333a0 64 20 6f 66 20 74 68 65 20 0a 20 20 20 20 20 20 d of the .
333b0 2a 2a 20 66 69 6c 65 20 74 68 65 20 64 61 74 61 ** file the data
333c0 62 61 73 65 20 6d 75 73 74 20 62 65 20 63 6f 72 base must be cor
333d0 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 20 20 72 rupt. */. r
333e0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
333f0 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
33400 0a 20 20 20 20 69 66 28 20 6e 4f 76 66 6c 20 29 . if( nOvfl )
33410 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 67 65 74 {. rc = get
33420 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 70 42 74 OverflowPage(pBt
33430 2c 20 6f 76 66 6c 50 67 6e 6f 2c 20 26 70 4f 76 , ovflPgno, &pOv
33440 66 6c 2c 20 26 69 4e 65 78 74 29 3b 0a 20 20 20 fl, &iNext);.
33450 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
33460 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 rn rc;. }..
33470 20 20 69 66 28 20 28 20 70 4f 76 66 6c 20 7c 7c if( ( pOvfl ||
33480 20 28 28 70 4f 76 66 6c 20 3d 20 62 74 72 65 65 ((pOvfl = btree
33490 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 PageLookup(pBt,
334a0 6f 76 66 6c 50 67 6e 6f 29 29 21 3d 30 29 20 29 ovflPgno))!=0) )
334b0 0a 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 . && sqlite3
334c0 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 6e PagerPageRefcoun
334d0 74 28 70 4f 76 66 6c 2d 3e 70 44 62 50 61 67 65 t(pOvfl->pDbPage
334e0 29 21 3d 31 0a 20 20 20 20 29 7b 0a 20 20 20 20 )!=1. ){.
334f0 20 20 2f 2a 20 54 68 65 72 65 20 69 73 20 6e 6f /* There is no
33500 20 72 65 61 73 6f 6e 20 61 6e 79 20 63 75 72 73 reason any curs
33510 6f 72 20 73 68 6f 75 6c 64 20 68 61 76 65 20 61 or should have a
33520 6e 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 n outstanding re
33530 66 65 72 65 6e 63 65 20 0a 20 20 20 20 20 20 2a ference . *
33540 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 * to an overflow
33550 20 70 61 67 65 20 62 65 6c 6f 6e 67 69 6e 67 20 page belonging
33560 74 6f 20 61 20 63 65 6c 6c 20 74 68 61 74 20 69 to a cell that i
33570 73 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 2f s being deleted/
33580 75 70 64 61 74 65 64 2e 0a 20 20 20 20 20 20 2a updated.. *
33590 2a 20 53 6f 20 69 66 20 74 68 65 72 65 20 65 78 * So if there ex
335a0 69 73 74 73 20 6d 6f 72 65 20 74 68 61 6e 20 6f ists more than o
335b0 6e 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 ne reference to
335c0 74 68 69 73 20 70 61 67 65 2c 20 74 68 65 6e 20 this page, then
335d0 69 74 20 0a 20 20 20 20 20 20 2a 2a 20 6d 75 73 it . ** mus
335e0 74 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 65 20 t not really be
335f0 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
33600 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 73 and the databas
33610 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 e must be corrup
33620 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 49 74 20 t. . ** It
33630 69 73 20 68 65 6c 70 66 75 6c 20 74 6f 20 64 65 is helpful to de
33640 74 65 63 74 20 74 68 69 73 20 62 65 66 6f 72 65 tect this before
33650 20 63 61 6c 6c 69 6e 67 20 66 72 65 65 50 61 67 calling freePag
33660 65 32 28 29 2c 20 61 73 20 0a 20 20 20 20 20 20 e2(), as .
33670 2a 2a 20 66 72 65 65 50 61 67 65 32 28 29 20 6d ** freePage2() m
33680 61 79 20 7a 65 72 6f 20 74 68 65 20 70 61 67 65 ay zero the page
33690 20 63 6f 6e 74 65 6e 74 73 20 69 66 20 73 65 63 contents if sec
336a0 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f 64 65 20 ure-delete mode
336b0 69 73 0a 20 20 20 20 20 20 2a 2a 20 65 6e 61 62 is. ** enab
336c0 6c 65 64 2e 20 49 66 20 74 68 69 73 20 27 6f 76 led. If this 'ov
336d0 65 72 66 6c 6f 77 27 20 70 61 67 65 20 68 61 70 erflow' page hap
336e0 70 65 6e 73 20 74 6f 20 62 65 20 61 20 70 61 67 pens to be a pag
336f0 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 20 e that the.
33700 20 2a 2a 20 63 61 6c 6c 65 72 20 69 73 20 69 74 ** caller is it
33710 65 72 61 74 69 6e 67 20 74 68 72 6f 75 67 68 20 erating through
33720 6f 72 20 75 73 69 6e 67 20 69 6e 20 73 6f 6d 65 or using in some
33730 20 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 73 other way, this
33740 0a 20 20 20 20 20 20 2a 2a 20 63 61 6e 20 62 65 . ** can be
33750 20 70 72 6f 62 6c 65 6d 61 74 69 63 2e 0a 20 20 problematic..
33760 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 */. rc
33770 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
33780 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 65 _BKPT;. }else
33790 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 72 65 {. rc = fre
337a0 65 50 61 67 65 32 28 70 42 74 2c 20 70 4f 76 66 ePage2(pBt, pOvf
337b0 6c 2c 20 6f 76 66 6c 50 67 6e 6f 29 3b 0a 20 20 l, ovflPgno);.
337c0 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 4f 76 }.. if( pOv
337d0 66 6c 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 fl ){. sqli
337e0 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 4f te3PagerUnref(pO
337f0 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 vfl->pDbPage);.
33800 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 20 }. if( rc
33810 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
33820 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 69 4e 65 78 ovflPgno = iNex
33830 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 t;. }. return
33840 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
33850 0a 2a 2a 20 43 72 65 61 74 65 20 74 68 65 20 62 .** Create the b
33860 79 74 65 20 73 65 71 75 65 6e 63 65 20 75 73 65 yte sequence use
33870 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 61 d to represent a
33880 20 63 65 6c 6c 20 6f 6e 20 70 61 67 65 20 70 50 cell on page pP
33890 61 67 65 0a 2a 2a 20 61 6e 64 20 77 72 69 74 65 age.** and write
338a0 20 74 68 61 74 20 62 79 74 65 20 73 65 71 75 65 that byte seque
338b0 6e 63 65 20 69 6e 74 6f 20 70 43 65 6c 6c 5b 5d nce into pCell[]
338c0 2e 20 20 4f 76 65 72 66 6c 6f 77 20 70 61 67 65 . Overflow page
338d0 73 20 61 72 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 s are.** allocat
338e0 65 64 20 61 6e 64 20 66 69 6c 6c 65 64 20 69 6e ed and filled in
338f0 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e 20 20 as necessary.
33900 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 The calling proc
33910 65 64 75 72 65 0a 2a 2a 20 69 73 20 72 65 73 70 edure.** is resp
33920 6f 6e 73 69 62 6c 65 20 66 6f 72 20 6d 61 6b 69 onsible for maki
33930 6e 67 20 73 75 72 65 20 73 75 66 66 69 63 69 65 ng sure sufficie
33940 6e 74 20 73 70 61 63 65 20 68 61 73 20 62 65 65 nt space has bee
33950 6e 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 66 n allocated.** f
33960 6f 72 20 70 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a or pCell[]..**.*
33970 2a 20 4e 6f 74 65 20 74 68 61 74 20 70 43 65 6c * Note that pCel
33980 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65 63 65 73 l does not neces
33990 73 61 72 79 20 6e 65 65 64 20 74 6f 20 70 6f 69 sary need to poi
339a0 6e 74 20 74 6f 20 74 68 65 20 70 50 61 67 65 2d nt to the pPage-
339b0 3e 61 44 61 74 61 0a 2a 2a 20 61 72 65 61 2e 20 >aData.** area.
339c0 20 70 43 65 6c 6c 20 6d 69 67 68 74 20 70 6f 69 pCell might poi
339d0 6e 74 20 74 6f 20 73 6f 6d 65 20 74 65 6d 70 6f nt to some tempo
339e0 72 61 72 79 20 73 74 6f 72 61 67 65 2e 20 20 54 rary storage. T
339f0 68 65 20 63 65 6c 6c 20 77 69 6c 6c 0a 2a 2a 20 he cell will.**
33a00 62 65 20 63 6f 6e 73 74 72 75 63 74 65 64 20 69 be constructed i
33a10 6e 20 74 68 69 73 20 74 65 6d 70 6f 72 61 72 79 n this temporary
33a20 20 61 72 65 61 20 74 68 65 6e 20 63 6f 70 69 65 area then copie
33a30 64 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e 61 44 d into pPage->aD
33a40 61 74 61 0a 2a 2a 20 6c 61 74 65 72 2e 0a 2a 2f ata.** later..*/
33a50 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69 6c 6c .static int fill
33a60 49 6e 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 InCell(. MemPag
33a70 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 e *pPage,
33a80 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
33a90 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 page that contai
33aa0 6e 73 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 ns the cell */.
33ab0 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
33ac0 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 pCell,
33ad0 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 74 65 78 74 /* Complete text
33ae0 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a of the cell */.
33af0 20 20 63 6f 6e 73 74 20 42 74 72 65 65 50 61 79 const BtreePay
33b00 6c 6f 61 64 20 2a 70 58 2c 20 20 20 20 20 20 20 load *pX,
33b10 20 2f 2a 20 50 61 79 6c 6f 61 64 20 77 69 74 68 /* Payload with
33b20 20 77 68 69 63 68 20 74 6f 20 63 6f 6e 73 74 72 which to constr
33b30 75 63 74 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a uct the cell */.
33b40 20 20 69 6e 74 20 2a 70 6e 53 69 7a 65 20 20 20 int *pnSize
33b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33b60 20 2f 2a 20 57 72 69 74 65 20 63 65 6c 6c 20 73 /* Write cell s
33b70 69 7a 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 ize here */.){.
33b80 20 69 6e 74 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 int nPayload;.
33b90 20 63 6f 6e 73 74 20 75 38 20 2a 70 53 72 63 3b const u8 *pSrc;
33ba0 0a 20 20 69 6e 74 20 6e 53 72 63 2c 20 6e 2c 20 . int nSrc, n,
33bb0 72 63 3b 0a 20 20 69 6e 74 20 73 70 61 63 65 4c rc;. int spaceL
33bc0 65 66 74 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a eft;. MemPage *
33bd0 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 4d 65 6d pOvfl = 0;. Mem
33be0 50 61 67 65 20 2a 70 54 6f 52 65 6c 65 61 73 65 Page *pToRelease
33bf0 20 3d 20 30 3b 0a 20 20 75 6e 73 69 67 6e 65 64 = 0;. unsigned
33c00 20 63 68 61 72 20 2a 70 50 72 69 6f 72 3b 0a 20 char *pPrior;.
33c10 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
33c20 70 50 61 79 6c 6f 61 64 3b 0a 20 20 42 74 53 68 pPayload;. BtSh
33c30 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 67 ared *pBt = pPag
33c40 65 2d 3e 70 42 74 3b 0a 20 20 50 67 6e 6f 20 70 e->pBt;. Pgno p
33c50 67 6e 6f 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 69 gnoOvfl = 0;. i
33c60 6e 74 20 6e 48 65 61 64 65 72 3b 0a 0a 20 20 61 nt nHeader;.. a
33c70 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
33c80 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
33c90 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
33ca0 0a 20 20 2f 2a 20 70 50 61 67 65 20 69 73 20 6e . /* pPage is n
33cb0 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 77 ot necessarily w
33cc0 72 69 74 65 61 62 6c 65 20 73 69 6e 63 65 20 70 riteable since p
33cd0 43 65 6c 6c 20 6d 69 67 68 74 20 62 65 20 61 75 Cell might be au
33ce0 78 69 6c 69 61 72 79 0a 20 20 2a 2a 20 62 75 66 xiliary. ** buf
33cf0 66 65 72 20 73 70 61 63 65 20 74 68 61 74 20 69 fer space that i
33d00 73 20 73 65 70 61 72 61 74 65 20 66 72 6f 6d 20 s separate from
33d10 74 68 65 20 70 50 61 67 65 20 62 75 66 66 65 72 the pPage buffer
33d20 20 61 72 65 61 20 2a 2f 0a 20 20 61 73 73 65 72 area */. asser
33d30 74 28 20 70 43 65 6c 6c 3c 70 50 61 67 65 2d 3e t( pCell<pPage->
33d40 61 44 61 74 61 20 7c 7c 20 70 43 65 6c 6c 3e 3d aData || pCell>=
33d50 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
33d60 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 t->pageSize].
33d70 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 || sqli
33d80 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
33d90 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
33da0 67 65 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c ge) );.. /* Fil
33db0 6c 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 2e l in the header.
33dc0 20 2a 2f 0a 20 20 6e 48 65 61 64 65 72 20 3d 20 */. nHeader =
33dd0 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
33de0 69 7a 65 3b 0a 20 20 69 66 28 20 70 50 61 67 65 ize;. if( pPage
33df0 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 ->intKey ){.
33e00 6e 50 61 79 6c 6f 61 64 20 3d 20 70 58 2d 3e 6e nPayload = pX->n
33e10 44 61 74 61 20 2b 20 70 58 2d 3e 6e 5a 65 72 6f Data + pX->nZero
33e20 3b 0a 20 20 20 20 70 53 72 63 20 3d 20 70 58 2d ;. pSrc = pX-
33e30 3e 70 44 61 74 61 3b 0a 20 20 20 20 6e 53 72 63 >pData;. nSrc
33e40 20 3d 20 70 58 2d 3e 6e 44 61 74 61 3b 0a 20 20 = pX->nData;.
33e50 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
33e60 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 3b 20 2f >intKeyLeaf ); /
33e70 2a 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f * fillInCell() o
33e80 6e 6c 79 20 63 61 6c 6c 65 64 20 66 6f 72 20 6c nly called for l
33e90 65 61 76 65 73 20 2a 2f 0a 20 20 20 20 6e 48 65 eaves */. nHe
33ea0 61 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 6e ader += putVarin
33eb0 74 33 32 28 26 70 43 65 6c 6c 5b 6e 48 65 61 64 t32(&pCell[nHead
33ec0 65 72 5d 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a er], nPayload);.
33ed0 20 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 nHeader += p
33ee0 75 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b utVarint(&pCell[
33ef0 6e 48 65 61 64 65 72 5d 2c 20 2a 28 75 36 34 2a nHeader], *(u64*
33f00 29 26 70 58 2d 3e 6e 4b 65 79 29 3b 0a 20 20 7d )&pX->nKey);. }
33f10 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 else{. assert
33f20 28 20 70 58 2d 3e 6e 4b 65 79 3c 3d 30 78 37 66 ( pX->nKey<=0x7f
33f30 66 66 66 66 66 66 20 26 26 20 70 58 2d 3e 70 4b ffffff && pX->pK
33f40 65 79 21 3d 30 20 29 3b 0a 20 20 20 20 6e 53 72 ey!=0 );. nSr
33f50 63 20 3d 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 c = nPayload = (
33f60 69 6e 74 29 70 58 2d 3e 6e 4b 65 79 3b 0a 20 20 int)pX->nKey;.
33f70 20 20 70 53 72 63 20 3d 20 70 58 2d 3e 70 4b 65 pSrc = pX->pKe
33f80 79 3b 0a 20 20 20 20 6e 48 65 61 64 65 72 20 2b y;. nHeader +
33f90 3d 20 70 75 74 56 61 72 69 6e 74 33 32 28 26 70 = putVarint32(&p
33fa0 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 6e Cell[nHeader], n
33fb0 50 61 79 6c 6f 61 64 29 3b 0a 20 20 7d 0a 20 20 Payload);. }.
33fc0 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 . /* Fill in th
33fd0 65 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 69 e payload */. i
33fe0 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 61 f( nPayload<=pPa
33ff0 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a ge->maxLocal ){.
34000 20 20 20 20 6e 20 3d 20 6e 48 65 61 64 65 72 20 n = nHeader
34010 2b 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 + nPayload;.
34020 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 33 20 29 testcase( n==3 )
34030 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
34040 6e 3d 3d 34 20 29 3b 0a 20 20 20 20 69 66 28 20 n==4 );. if(
34050 6e 3c 34 20 29 20 6e 20 3d 20 34 3b 0a 20 20 20 n<4 ) n = 4;.
34060 20 2a 70 6e 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 *pnSize = n;.
34070 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 6e 50 spaceLeft = nP
34080 61 79 6c 6f 61 64 3b 0a 20 20 20 20 70 50 72 69 ayload;. pPri
34090 6f 72 20 3d 20 70 43 65 6c 6c 3b 0a 20 20 7d 65 or = pCell;. }e
340a0 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6d 6e 20 lse{. int mn
340b0 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 = pPage->minLoca
340c0 6c 3b 0a 20 20 20 20 6e 20 3d 20 6d 6e 20 2b 20 l;. n = mn +
340d0 28 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 6e 29 20 (nPayload - mn)
340e0 25 20 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 % (pPage->pBt->u
340f0 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a sableSize - 4);.
34100 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d testcase( n=
34110 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
34120 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 );. testcase
34130 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c ( n==pPage->maxL
34140 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 69 66 ocal+1 );. if
34150 28 20 6e 20 3e 20 70 50 61 67 65 2d 3e 6d 61 78 ( n > pPage->max
34160 4c 6f 63 61 6c 20 29 20 6e 20 3d 20 6d 6e 3b 0a Local ) n = mn;.
34170 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 spaceLeft =
34180 6e 3b 0a 20 20 20 20 2a 70 6e 53 69 7a 65 20 3d n;. *pnSize =
34190 20 6e 20 2b 20 6e 48 65 61 64 65 72 20 2b 20 34 n + nHeader + 4
341a0 3b 0a 20 20 20 20 70 50 72 69 6f 72 20 3d 20 26 ;. pPrior = &
341b0 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 2b 6e 5d pCell[nHeader+n]
341c0 3b 0a 20 20 7d 0a 20 20 70 50 61 79 6c 6f 61 64 ;. }. pPayload
341d0 20 3d 20 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 = &pCell[nHeade
341e0 72 5d 3b 0a 0a 20 20 2f 2a 20 41 74 20 74 68 69 r];.. /* At thi
341f0 73 20 70 6f 69 6e 74 20 76 61 72 69 61 62 6c 65 s point variable
34200 73 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 s should be set
34210 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a as follows:. **
34220 0a 20 20 2a 2a 20 20 20 6e 50 61 79 6c 6f 61 64 . ** nPayload
34230 20 20 20 20 20 20 20 20 20 20 20 54 6f 74 61 6c Total
34240 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 20 69 6e payload size in
34250 20 62 79 74 65 73 0a 20 20 2a 2a 20 20 20 70 50 bytes. ** pP
34260 61 79 6c 6f 61 64 20 20 20 20 20 20 20 20 20 20 ayload
34270 20 42 65 67 69 6e 20 77 72 69 74 69 6e 67 20 70 Begin writing p
34280 61 79 6c 6f 61 64 20 68 65 72 65 0a 20 20 2a 2a ayload here. **
34290 20 20 20 73 70 61 63 65 4c 65 66 74 20 20 20 20 spaceLeft
342a0 20 20 20 20 20 20 53 70 61 63 65 20 61 76 61 69 Space avai
342b0 6c 61 62 6c 65 20 61 74 20 70 50 61 79 6c 6f 61 lable at pPayloa
342c0 64 2e 20 20 49 66 20 6e 50 61 79 6c 6f 61 64 3e d. If nPayload>
342d0 73 70 61 63 65 4c 65 66 74 2c 0a 20 20 2a 2a 20 spaceLeft,. **
342e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
342f0 20 20 20 20 20 74 68 61 74 20 6d 65 61 6e 73 20 that means
34300 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 73 70 69 content must spi
34310 6c 6c 20 69 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 ll into overflow
34320 20 70 61 67 65 73 2e 0a 20 20 2a 2a 20 20 20 2a pages.. ** *
34330 70 6e 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 pnSize
34340 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 6c 6f Size of the lo
34350 63 61 6c 20 63 65 6c 6c 20 28 6e 6f 74 20 63 6f cal cell (not co
34360 75 6e 74 69 6e 67 20 6f 76 65 72 66 6c 6f 77 20 unting overflow
34370 70 61 67 65 73 29 0a 20 20 2a 2a 20 20 20 70 50 pages). ** pP
34380 72 69 6f 72 20 20 20 20 20 20 20 20 20 20 20 20 rior
34390 20 57 68 65 72 65 20 74 6f 20 77 72 69 74 65 20 Where to write
343a0 74 68 65 20 70 67 6e 6f 20 6f 66 20 74 68 65 20 the pgno of the
343b0 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
343c0 61 67 65 0a 20 20 2a 2a 0a 20 20 2a 2a 20 55 73 age. **. ** Us
343d0 65 20 61 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 e a call to btre
343e0 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 29 20 eParseCellPtr()
343f0 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 to verify that t
34400 68 65 20 76 61 6c 75 65 73 20 61 62 6f 76 65 0a he values above.
34410 20 20 2a 2a 20 77 65 72 65 20 63 6f 6d 70 75 74 ** were comput
34420 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 0a 20 20 ed correctly..
34430 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 44 45 */.#if SQLITE_DE
34440 42 55 47 0a 20 20 7b 0a 20 20 20 20 43 65 6c 6c BUG. {. Cell
34450 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 70 Info info;. p
34460 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c Page->xParseCell
34470 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
34480 69 6e 66 6f 29 3b 0a 20 20 20 20 61 73 73 65 72 info);. asser
34490 74 28 20 6e 48 65 61 64 65 72 3d 3d 28 69 6e 74 t( nHeader==(int
344a0 29 28 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 20 )(info.pPayload
344b0 2d 20 70 43 65 6c 6c 29 20 29 3b 0a 20 20 20 20 - pCell) );.
344c0 61 73 73 65 72 74 28 20 69 6e 66 6f 2e 6e 4b 65 assert( info.nKe
344d0 79 3d 3d 70 58 2d 3e 6e 4b 65 79 20 29 3b 0a 20 y==pX->nKey );.
344e0 20 20 20 61 73 73 65 72 74 28 20 2a 70 6e 53 69 assert( *pnSi
344f0 7a 65 20 3d 3d 20 69 6e 66 6f 2e 6e 53 69 7a 65 ze == info.nSize
34500 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
34510 73 70 61 63 65 4c 65 66 74 20 3d 3d 20 69 6e 66 spaceLeft == inf
34520 6f 2e 6e 4c 6f 63 61 6c 20 29 3b 0a 20 20 7d 0a o.nLocal );. }.
34530 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 57 72 69 #endif.. /* Wri
34540 74 65 20 74 68 65 20 70 61 79 6c 6f 61 64 20 69 te the payload i
34550 6e 74 6f 20 74 68 65 20 6c 6f 63 61 6c 20 43 65 nto the local Ce
34560 6c 6c 20 61 6e 64 20 61 6e 79 20 65 78 74 72 61 ll and any extra
34570 20 69 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 into overflow p
34580 61 67 65 73 20 2a 2f 0a 20 20 77 68 69 6c 65 28 ages */. while(
34590 20 6e 50 61 79 6c 6f 61 64 3e 30 20 29 7b 0a 20 nPayload>0 ){.
345a0 20 20 20 69 66 28 20 73 70 61 63 65 4c 65 66 74 if( spaceLeft
345b0 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 ==0 ){.#ifndef S
345c0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
345d0 41 43 55 55 4d 0a 20 20 20 20 20 20 50 67 6e 6f ACUUM. Pgno
345e0 20 70 67 6e 6f 50 74 72 6d 61 70 20 3d 20 70 67 pgnoPtrmap = pg
345f0 6e 6f 4f 76 66 6c 3b 20 2f 2a 20 4f 76 65 72 66 noOvfl; /* Overf
34600 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 low page pointer
34610 2d 6d 61 70 20 65 6e 74 72 79 20 70 61 67 65 20 -map entry page
34620 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 */. if( pBt
34630 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a ->autoVacuum ){.
34640 20 20 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 do{.
34650 20 20 20 20 20 20 70 67 6e 6f 4f 76 66 6c 2b 2b pgnoOvfl++
34660 3b 0a 20 20 20 20 20 20 20 20 7d 20 77 68 69 6c ;. } whil
34670 65 28 20 0a 20 20 20 20 20 20 20 20 20 20 50 54 e( . PT
34680 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c RMAP_ISPAGE(pBt,
34690 20 70 67 6e 6f 4f 76 66 6c 29 20 7c 7c 20 70 67 pgnoOvfl) || pg
346a0 6e 6f 4f 76 66 6c 3d 3d 50 45 4e 44 49 4e 47 5f noOvfl==PENDING_
346b0 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 0a BYTE_PAGE(pBt) .
346c0 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 );.
346d0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 }.#endif.
346e0 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 rc = allocateBtr
346f0 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 4f 76 eePage(pBt, &pOv
34700 66 6c 2c 20 26 70 67 6e 6f 4f 76 66 6c 2c 20 70 fl, &pgnoOvfl, p
34710 67 6e 6f 4f 76 66 6c 2c 20 30 29 3b 0a 23 69 66 gnoOvfl, 0);.#if
34720 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
34730 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
34740 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
34750 62 61 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 base supports au
34760 74 6f 2d 76 61 63 75 75 6d 2c 20 61 6e 64 20 74 to-vacuum, and t
34770 68 65 20 73 65 63 6f 6e 64 20 6f 72 20 73 75 62 he second or sub
34780 73 65 71 75 65 6e 74 0a 20 20 20 20 20 20 2a 2a sequent. **
34790 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 overflow page i
347a0 73 20 62 65 69 6e 67 20 61 6c 6c 6f 63 61 74 65 s being allocate
347b0 64 2c 20 61 64 64 20 61 6e 20 65 6e 74 72 79 20 d, add an entry
347c0 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d to the pointer-m
347d0 61 70 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 ap. ** for
347e0 74 68 61 74 20 70 61 67 65 20 6e 6f 77 2e 20 0a that page now. .
347f0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
34800 2a 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 * If this is the
34810 20 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 first overflow
34820 70 61 67 65 2c 20 74 68 65 6e 20 77 72 69 74 65 page, then write
34830 20 61 20 70 61 72 74 69 61 6c 20 65 6e 74 72 79 a partial entry
34840 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 . ** to th
34850 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 20 49 e pointer-map. I
34860 66 20 77 65 20 77 72 69 74 65 20 6e 6f 74 68 69 f we write nothi
34870 6e 67 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 ng to this point
34880 65 72 2d 6d 61 70 20 73 6c 6f 74 2c 0a 20 20 20 er-map slot,.
34890 20 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 6f ** then the o
348a0 70 74 69 6d 69 73 74 69 63 20 6f 76 65 72 66 6c ptimistic overfl
348b0 6f 77 20 63 68 61 69 6e 20 70 72 6f 63 65 73 73 ow chain process
348c0 69 6e 67 20 69 6e 20 63 6c 65 61 72 43 65 6c 6c ing in clearCell
348d0 28 29 0a 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 (). ** may
348e0 6d 69 73 69 6e 74 65 72 70 72 65 74 20 74 68 65 misinterpret the
348f0 20 75 6e 69 6e 69 74 69 61 6c 69 7a 65 64 20 76 uninitialized v
34900 61 6c 75 65 73 20 61 6e 64 20 64 65 6c 65 74 65 alues and delete
34910 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 77 72 the. ** wr
34920 6f 6e 67 20 70 61 67 65 73 20 66 72 6f 6d 20 74 ong pages from t
34930 68 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 he database..
34940 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 */. if(
34950 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
34960 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b && rc==SQLITE_OK
34970 20 29 7b 0a 20 20 20 20 20 20 20 20 75 38 20 65 ){. u8 e
34980 54 79 70 65 20 3d 20 28 70 67 6e 6f 50 74 72 6d Type = (pgnoPtrm
34990 61 70 3f 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c ap?PTRMAP_OVERFL
349a0 4f 57 32 3a 50 54 52 4d 41 50 5f 4f 56 45 52 46 OW2:PTRMAP_OVERF
349b0 4c 4f 57 31 29 3b 0a 20 20 20 20 20 20 20 20 70 LOW1);. p
349c0 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 70 67 trmapPut(pBt, pg
349d0 6e 6f 4f 76 66 6c 2c 20 65 54 79 70 65 2c 20 70 noOvfl, eType, p
349e0 67 6e 6f 50 74 72 6d 61 70 2c 20 26 72 63 29 3b gnoPtrmap, &rc);
349f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 . if( rc
34a00 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c ){. rel
34a10 65 61 73 65 50 61 67 65 28 70 4f 76 66 6c 29 3b easePage(pOvfl);
34a20 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
34a30 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 }.#endif.
34a40 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
34a50 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 releasePage(pT
34a60 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 oRelease);.
34a70 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
34a80 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 }.. /*
34a90 49 66 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 If pToRelease is
34aa0 20 6e 6f 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 not zero than p
34ab0 50 72 69 6f 72 20 70 6f 69 6e 74 73 20 69 6e 74 Prior points int
34ac0 6f 20 74 68 65 20 64 61 74 61 20 61 72 65 61 0a o the data area.
34ad0 20 20 20 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 ** of pToR
34ae0 65 6c 65 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 elease. Make su
34af0 72 65 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 re pToRelease is
34b00 20 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 still writeable
34b10 2e 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 . */. asser
34b20 74 28 20 70 54 6f 52 65 6c 65 61 73 65 3d 3d 30 t( pToRelease==0
34b30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 || sqlite3Pager
34b40 49 73 77 72 69 74 65 61 62 6c 65 28 70 54 6f 52 Iswriteable(pToR
34b50 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 67 65 29 elease->pDbPage)
34b60 20 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 );.. /* If
34b70 20 70 50 72 69 6f 72 20 69 73 20 70 61 72 74 20 pPrior is part
34b80 6f 66 20 74 68 65 20 64 61 74 61 20 61 72 65 61 of the data area
34b90 20 6f 66 20 70 50 61 67 65 2c 20 74 68 65 6e 20 of pPage, then
34ba0 6d 61 6b 65 20 73 75 72 65 20 70 50 61 67 65 0a make sure pPage.
34bb0 20 20 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c ** is stil
34bc0 6c 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 l writeable */.
34bd0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 72 assert( pPr
34be0 69 6f 72 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 ior<pPage->aData
34bf0 20 7c 7c 20 70 50 72 69 6f 72 3e 3d 26 70 50 61 || pPrior>=&pPa
34c00 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 ge->aData[pBt->p
34c10 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 ageSize].
34c20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 || sqlite3P
34c30 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
34c40 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
34c50 29 3b 0a 0a 20 20 20 20 20 20 70 75 74 34 62 79 );.. put4by
34c60 74 65 28 70 50 72 69 6f 72 2c 20 70 67 6e 6f 4f te(pPrior, pgnoO
34c70 76 66 6c 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 vfl);. rele
34c80 61 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 asePage(pToRelea
34c90 73 65 29 3b 0a 20 20 20 20 20 20 70 54 6f 52 65 se);. pToRe
34ca0 6c 65 61 73 65 20 3d 20 70 4f 76 66 6c 3b 0a 20 lease = pOvfl;.
34cb0 20 20 20 20 20 70 50 72 69 6f 72 20 3d 20 70 4f pPrior = pO
34cc0 76 66 6c 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 vfl->aData;.
34cd0 20 20 70 75 74 34 62 79 74 65 28 70 50 72 69 6f put4byte(pPrio
34ce0 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 50 61 r, 0);. pPa
34cf0 79 6c 6f 61 64 20 3d 20 26 70 4f 76 66 6c 2d 3e yload = &pOvfl->
34d00 61 44 61 74 61 5b 34 5d 3b 0a 20 20 20 20 20 20 aData[4];.
34d10 73 70 61 63 65 4c 65 66 74 20 3d 20 70 42 74 2d spaceLeft = pBt-
34d20 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b >usableSize - 4;
34d30 0a 20 20 20 20 7d 0a 20 20 20 20 6e 20 3d 20 6e . }. n = n
34d40 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 69 66 28 Payload;. if(
34d50 20 6e 3e 73 70 61 63 65 4c 65 66 74 20 29 20 6e n>spaceLeft ) n
34d60 20 3d 20 73 70 61 63 65 4c 65 66 74 3b 0a 0a 20 = spaceLeft;..
34d70 20 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 /* If pToRele
34d80 61 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 ase is not zero
34d90 74 68 61 6e 20 70 50 61 79 6c 6f 61 64 20 70 6f than pPayload po
34da0 69 6e 74 73 20 69 6e 74 6f 20 74 68 65 20 64 61 ints into the da
34db0 74 61 20 61 72 65 61 0a 20 20 20 20 2a 2a 20 6f ta area. ** o
34dc0 66 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d f pToRelease. M
34dd0 61 6b 65 20 73 75 72 65 20 70 54 6f 52 65 6c 65 ake sure pToRele
34de0 61 73 65 20 69 73 20 73 74 69 6c 6c 20 77 72 69 ase is still wri
34df0 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 61 teable. */. a
34e00 73 73 65 72 74 28 20 70 54 6f 52 65 6c 65 61 73 ssert( pToReleas
34e10 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 e==0 || sqlite3P
34e20 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
34e30 70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 pToRelease->pDbP
34e40 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 age) );.. /*
34e50 49 66 20 70 50 61 79 6c 6f 61 64 20 69 73 20 70 If pPayload is p
34e60 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 art of the data
34e70 61 72 65 61 20 6f 66 20 70 50 61 67 65 2c 20 74 area of pPage, t
34e80 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 70 50 hen make sure pP
34e90 61 67 65 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 age. ** is st
34ea0 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 2a 2f ill writeable */
34eb0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
34ec0 79 6c 6f 61 64 3c 70 50 61 67 65 2d 3e 61 44 61 yload<pPage->aDa
34ed0 74 61 20 7c 7c 20 70 50 61 79 6c 6f 61 64 3e 3d ta || pPayload>=
34ee0 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
34ef0 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 t->pageSize].
34f00 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 || sqli
34f10 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
34f20 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
34f30 67 65 29 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 ge) );.. if(
34f40 6e 53 72 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 nSrc>0 ){.
34f50 69 66 28 20 6e 3e 6e 53 72 63 20 29 20 6e 20 3d if( n>nSrc ) n =
34f60 20 6e 53 72 63 3b 0a 20 20 20 20 20 20 61 73 73 nSrc;. ass
34f70 65 72 74 28 20 70 53 72 63 20 29 3b 0a 20 20 20 ert( pSrc );.
34f80 20 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f memcpy(pPaylo
34f90 61 64 2c 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 ad, pSrc, n);.
34fa0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d }else{. m
34fb0 65 6d 73 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 emset(pPayload,
34fc0 30 2c 20 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 0, n);. }.
34fd0 20 6e 50 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a nPayload -= n;.
34fe0 20 20 20 20 70 50 61 79 6c 6f 61 64 20 2b 3d 20 pPayload +=
34ff0 6e 3b 0a 20 20 20 20 70 53 72 63 20 2b 3d 20 6e n;. pSrc += n
35000 3b 0a 20 20 20 20 6e 53 72 63 20 2d 3d 20 6e 3b ;. nSrc -= n;
35010 0a 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 2d . spaceLeft -
35020 3d 20 6e 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 = n;. }. relea
35030 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 sePage(pToReleas
35040 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c e);. return SQL
35050 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
35060 20 52 65 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 Remove the i-th
35070 20 63 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 cell from pPage
35080 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
35090 65 66 66 65 63 74 73 20 70 50 61 67 65 20 6f 6e effects pPage on
350a0 6c 79 2e 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 ly..** The cell
350b0 63 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 content is not f
350c0 72 65 65 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 reed or dealloca
350d0 74 65 64 2e 20 20 49 74 20 69 73 20 61 73 73 75 ted. It is assu
350e0 6d 65 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 med that.** the
350f0 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 cell content has
35100 20 62 65 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d been copied som
35110 65 70 6c 61 63 65 20 65 6c 73 65 2e 20 20 54 68 eplace else. Th
35120 69 73 20 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a is routine just.
35130 2a 2a 20 72 65 6d 6f 76 65 73 20 74 68 65 20 72 ** removes the r
35140 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 eference to the
35150 63 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e cell from pPage.
35160 0a 2a 2a 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 .**.** "sz" must
35170 20 62 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f be the number o
35180 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 63 f bytes in the c
35190 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ell..*/.static v
351a0 6f 69 64 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d oid dropCell(Mem
351b0 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
351c0 20 69 64 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e idx, int sz, in
351d0 74 20 2a 70 52 43 29 7b 0a 20 20 75 33 32 20 70 t *pRC){. u32 p
351e0 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 c; /* Of
351f0 66 73 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e fset to cell con
35200 74 65 6e 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 tent of cell bei
35210 6e 67 20 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 ng deleted */.
35220 75 38 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 u8 *data;
35230 2f 2a 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 /* pPage->aData
35240 2a 2f 0a 20 20 75 38 20 2a 70 74 72 3b 20 20 20 */. u8 *ptr;
35250 20 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 /* Used to
35260 6d 6f 76 65 20 62 79 74 65 73 20 61 72 6f 75 6e move bytes aroun
35270 64 20 77 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 d within data[]
35280 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 */. int rc;
35290 20 20 20 20 20 2f 2a 20 54 68 65 20 72 65 74 75 /* The retu
352a0 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
352b0 20 68 64 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 hdr; /*
352c0 42 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 Beginning of the
352d0 20 68 65 61 64 65 72 2e 20 20 30 20 6d 6f 73 74 header. 0 most
352e0 20 70 61 67 65 73 2e 20 20 31 30 30 20 70 61 67 pages. 100 pag
352f0 65 20 31 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 e 1 */.. if( *p
35300 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 RC ) return;. a
35310 73 73 65 72 74 28 20 69 64 78 3e 3d 30 20 26 26 ssert( idx>=0 &&
35320 20 69 64 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c idx<pPage->nCel
35330 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 43 l );. assert( C
35340 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 73 7a 3d ORRUPT_DB || sz=
35350 3d 63 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c =cellSize(pPage,
35360 20 69 64 78 29 20 29 3b 0a 20 20 61 73 73 65 72 idx) );. asser
35370 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
35380 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
35390 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 ->pDbPage) );.
353a0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
353b0 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
353c0 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
353d0 0a 20 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d . data = pPage-
353e0 3e 61 44 61 74 61 3b 0a 20 20 70 74 72 20 3d 20 >aData;. ptr =
353f0 26 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 &pPage->aCellIdx
35400 5b 32 2a 69 64 78 5d 3b 0a 20 20 70 63 20 3d 20 [2*idx];. pc =
35410 67 65 74 32 62 79 74 65 28 70 74 72 29 3b 0a 20 get2byte(ptr);.
35420 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 hdr = pPage->hd
35430 72 4f 66 66 73 65 74 3b 0a 20 20 74 65 73 74 63 rOffset;. testc
35440 61 73 65 28 20 70 63 3d 3d 67 65 74 32 62 79 74 ase( pc==get2byt
35450 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 e(&data[hdr+5])
35460 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 );. testcase( p
35470 63 2b 73 7a 3d 3d 70 50 61 67 65 2d 3e 70 42 74 c+sz==pPage->pBt
35480 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ->usableSize );.
35490 20 20 69 66 28 20 70 63 20 3c 20 28 75 33 32 29 if( pc < (u32)
354a0 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 get2byte(&data[h
354b0 64 72 2b 35 5d 29 20 7c 7c 20 70 63 2b 73 7a 20 dr+5]) || pc+sz
354c0 3e 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 > pPage->pBt->us
354d0 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 ableSize ){.
354e0 2a 70 52 43 20 3d 20 53 51 4c 49 54 45 5f 43 4f *pRC = SQLITE_CO
354f0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
35500 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 72 63 return;. }. rc
35510 20 3d 20 66 72 65 65 53 70 61 63 65 28 70 50 61 = freeSpace(pPa
35520 67 65 2c 20 70 63 2c 20 73 7a 29 3b 0a 20 20 69 ge, pc, sz);. i
35530 66 28 20 72 63 20 29 7b 0a 20 20 20 20 2a 70 52 f( rc ){. *pR
35540 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 65 74 75 C = rc;. retu
35550 72 6e 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 2d rn;. }. pPage-
35560 3e 6e 43 65 6c 6c 2d 2d 3b 0a 20 20 69 66 28 20 >nCell--;. if(
35570 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 pPage->nCell==0
35580 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 64 ){. memset(&d
35590 61 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 ata[hdr+1], 0, 4
355a0 29 3b 0a 20 20 20 20 64 61 74 61 5b 68 64 72 2b );. data[hdr+
355b0 37 5d 20 3d 20 30 3b 0a 20 20 20 20 70 75 74 32 7] = 0;. put2
355c0 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
355d0 5d 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 ], pPage->pBt->u
355e0 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 20 20 sableSize);.
355f0 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 70 pPage->nFree = p
35600 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
35610 65 53 69 7a 65 20 2d 20 70 50 61 67 65 2d 3e 68 eSize - pPage->h
35620 64 72 4f 66 66 73 65 74 0a 20 20 20 20 20 20 20 drOffset.
35630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35640 2d 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 - pPage->childPt
35650 72 53 69 7a 65 20 2d 20 38 3b 0a 20 20 7d 65 6c rSize - 8;. }el
35660 73 65 7b 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 se{. memmove(
35670 70 74 72 2c 20 70 74 72 2b 32 2c 20 32 2a 28 70 ptr, ptr+2, 2*(p
35680 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 64 Page->nCell - id
35690 78 29 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 x));. put2byt
356a0 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 2c 20 e(&data[hdr+3],
356b0 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 pPage->nCell);.
356c0 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 pPage->nFree
356d0 2b 3d 20 32 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a += 2;. }.}../*.
356e0 2a 2a 20 49 6e 73 65 72 74 20 61 20 6e 65 77 20 ** Insert a new
356f0 63 65 6c 6c 20 6f 6e 20 70 50 61 67 65 20 61 74 cell on pPage at
35700 20 63 65 6c 6c 20 69 6e 64 65 78 20 22 69 22 2e cell index "i".
35710 20 20 70 43 65 6c 6c 20 70 6f 69 6e 74 73 20 74 pCell points t
35720 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 o the.** content
35730 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2a of the cell..**
35740 0a 2a 2a 20 49 66 20 74 68 65 20 63 65 6c 6c 20 .** If the cell
35750 63 6f 6e 74 65 6e 74 20 77 69 6c 6c 20 66 69 74 content will fit
35760 20 6f 6e 20 74 68 65 20 70 61 67 65 2c 20 74 68 on the page, th
35770 65 6e 20 70 75 74 20 69 74 20 74 68 65 72 65 2e en put it there.
35780 20 20 49 66 20 69 74 0a 2a 2a 20 77 69 6c 6c 20 If it.** will
35790 6e 6f 74 20 66 69 74 2c 20 74 68 65 6e 20 6d 61 not fit, then ma
357a0 6b 65 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 ke a copy of the
357b0 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e cell content in
357c0 74 6f 20 70 54 65 6d 70 20 69 66 0a 2a 2a 20 70 to pTemp if.** p
357d0 54 65 6d 70 20 69 73 20 6e 6f 74 20 6e 75 6c 6c Temp is not null
357e0 2e 20 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 . Regardless of
357f0 20 70 54 65 6d 70 2c 20 61 6c 6c 6f 63 61 74 65 pTemp, allocate
35800 20 61 20 6e 65 77 20 65 6e 74 72 79 0a 2a 2a 20 a new entry.**
35810 69 6e 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c in pPage->apOvfl
35820 5b 5d 20 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 [] and make it p
35830 6f 69 6e 74 20 74 6f 20 74 68 65 20 63 65 6c 6c oint to the cell
35840 20 63 6f 6e 74 65 6e 74 20 28 65 69 74 68 65 72 content (either
35850 0a 2a 2a 20 69 6e 20 70 54 65 6d 70 20 6f 72 20 .** in pTemp or
35860 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 43 65 the original pCe
35870 6c 6c 29 20 61 6e 64 20 61 6c 73 6f 20 72 65 63 ll) and also rec
35880 6f 72 64 20 69 74 73 20 69 6e 64 65 78 2e 20 0a ord its index. .
35890 2a 2a 20 41 6c 6c 6f 63 61 74 69 6e 67 20 61 20 ** Allocating a
358a0 6e 65 77 20 65 6e 74 72 79 20 69 6e 20 70 50 61 new entry in pPa
358b0 67 65 2d 3e 61 43 65 6c 6c 5b 5d 20 69 6d 70 6c ge->aCell[] impl
358c0 69 65 73 20 74 68 61 74 20 0a 2a 2a 20 70 50 61 ies that .** pPa
358d0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 69 73 ge->nOverflow is
358e0 20 69 6e 63 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a incremented..**
358f0 0a 2a 2a 20 2a 70 52 43 20 6d 75 73 74 20 62 65 .** *pRC must be
35900 20 53 51 4c 49 54 45 5f 4f 4b 20 77 68 65 6e 20 SQLITE_OK when
35910 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
35920 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
35930 63 20 76 6f 69 64 20 69 6e 73 65 72 74 43 65 6c c void insertCel
35940 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 l(. MemPage *pP
35950 61 67 65 2c 20 20 20 2f 2a 20 50 61 67 65 20 69 age, /* Page i
35960 6e 74 6f 20 77 68 69 63 68 20 77 65 20 61 72 65 nto which we are
35970 20 63 6f 70 79 69 6e 67 20 2a 2f 0a 20 20 69 6e copying */. in
35980 74 20 69 2c 20 20 20 20 20 20 20 20 20 20 20 20 t i,
35990 2f 2a 20 4e 65 77 20 63 65 6c 6c 20 62 65 63 6f /* New cell beco
359a0 6d 65 73 20 74 68 65 20 69 2d 74 68 20 63 65 6c mes the i-th cel
359b0 6c 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f l of the page */
359c0 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 . u8 *pCell,
359d0 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74 20 /* Content
359e0 6f 66 20 74 68 65 20 6e 65 77 20 63 65 6c 6c 20 of the new cell
359f0 2a 2f 0a 20 20 69 6e 74 20 73 7a 2c 20 20 20 20 */. int sz,
35a00 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 /* Bytes
35a10 6f 66 20 63 6f 6e 74 65 6e 74 20 69 6e 20 70 43 of content in pC
35a20 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 54 65 ell */. u8 *pTe
35a30 6d 70 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 65 mp, /* Te
35a40 6d 70 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 mp storage space
35a50 20 66 6f 72 20 70 43 65 6c 6c 2c 20 69 66 20 6e for pCell, if n
35a60 65 65 64 65 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 eeded */. Pgno
35a70 69 43 68 69 6c 64 2c 20 20 20 20 20 20 2f 2a 20 iChild, /*
35a80 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 72 65 70 If non-zero, rep
35a90 6c 61 63 65 20 66 69 72 73 74 20 34 20 62 79 74 lace first 4 byt
35aa0 65 73 20 77 69 74 68 20 74 68 69 73 20 76 61 6c es with this val
35ab0 75 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 43 ue */. int *pRC
35ac0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 /* Rea
35ad0 64 20 61 6e 64 20 77 72 69 74 65 20 72 65 74 75 d and write retu
35ae0 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 68 65 72 rn code from her
35af0 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 64 e */.){. int id
35b00 78 20 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 57 x = 0; /* W
35b10 68 65 72 65 20 74 6f 20 77 72 69 74 65 20 6e 65 here to write ne
35b20 77 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 w cell content i
35b30 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e n data[] */. in
35b40 74 20 6a 3b 20 20 20 20 20 20 20 20 20 20 20 20 t j;
35b50 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 /* Loop counter
35b60 2a 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 */. u8 *data;
35b70 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 6f /* The co
35b80 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 77 68 6f ntent of the who
35b90 6c 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 le page */. u8
35ba0 2a 70 49 6e 73 3b 20 20 20 20 20 20 20 20 20 2f *pIns; /
35bb0 2a 20 54 68 65 20 70 6f 69 6e 74 20 69 6e 20 70 * The point in p
35bc0 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 5d Page->aCellIdx[]
35bd0 20 77 68 65 72 65 20 6e 6f 20 63 65 6c 6c 20 69 where no cell i
35be0 6e 73 65 72 74 65 64 20 2a 2f 0a 0a 20 20 61 73 nserted */.. as
35bf0 73 65 72 74 28 20 2a 70 52 43 3d 3d 53 51 4c 49 sert( *pRC==SQLI
35c00 54 45 5f 4f 4b 20 29 3b 0a 20 20 61 73 73 65 72 TE_OK );. asser
35c10 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 t( i>=0 && i<=pP
35c20 61 67 65 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 age->nCell+pPage
35c30 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 ->nOverflow );.
35c40 20 61 73 73 65 72 74 28 20 4d 58 5f 43 45 4c 4c assert( MX_CELL
35c50 28 70 50 61 67 65 2d 3e 70 42 74 29 3c 3d 31 30 (pPage->pBt)<=10
35c60 39 32 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 921 );. assert(
35c70 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3c 3d 4d pPage->nCell<=M
35c80 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 X_CELL(pPage->pB
35c90 74 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 t) || CORRUPT_DB
35ca0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
35cb0 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3c 3d age->nOverflow<=
35cc0 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d ArraySize(pPage-
35cd0 3e 61 70 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 >apOvfl) );. as
35ce0 73 65 72 74 28 20 41 72 72 61 79 53 69 7a 65 28 sert( ArraySize(
35cf0 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 3d 3d pPage->apOvfl)==
35d00 41 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d ArraySize(pPage-
35d10 3e 61 69 4f 76 66 6c 29 20 29 3b 0a 20 20 61 73 >aiOvfl) );. as
35d20 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
35d30 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
35d40 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
35d50 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 73 68 6f /* The cell sho
35d60 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 20 62 65 20 uld normally be
35d70 73 69 7a 65 64 20 63 6f 72 72 65 63 74 6c 79 2e sized correctly.
35d80 20 20 48 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 However, when
35d90 6d 6f 76 69 6e 67 20 61 0a 20 20 2a 2a 20 6d 61 moving a. ** ma
35da0 6c 66 6f 72 6d 65 64 20 63 65 6c 6c 20 66 72 6f lformed cell fro
35db0 6d 20 61 20 6c 65 61 66 20 70 61 67 65 20 74 6f m a leaf page to
35dc0 20 61 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 67 an interior pag
35dd0 65 2c 20 69 66 20 74 68 65 20 63 65 6c 6c 20 73 e, if the cell s
35de0 69 7a 65 0a 20 20 2a 2a 20 77 61 6e 74 65 64 20 ize. ** wanted
35df0 74 6f 20 62 65 20 6c 65 73 73 20 74 68 61 6e 20 to be less than
35e00 34 20 62 75 74 20 67 6f 74 20 72 6f 75 6e 64 65 4 but got rounde
35e10 64 20 75 70 20 74 6f 20 34 20 6f 6e 20 74 68 65 d up to 4 on the
35e20 20 6c 65 61 66 2c 20 74 68 65 6e 20 73 69 7a 65 leaf, then size
35e30 0a 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 6c . ** might be l
35e40 65 73 73 20 74 68 61 6e 20 38 20 28 6c 65 61 66 ess than 8 (leaf
35e50 2d 73 69 7a 65 20 2b 20 70 6f 69 6e 74 65 72 29 -size + pointer)
35e60 20 6f 6e 20 74 68 65 20 69 6e 74 65 72 69 6f 72 on the interior
35e70 20 6e 6f 64 65 2e 20 20 48 65 6e 63 65 0a 20 20 node. Hence.
35e80 2a 2a 20 74 68 65 20 74 65 72 6d 20 61 66 74 65 ** the term afte
35e90 72 20 74 68 65 20 7c 7c 20 69 6e 20 74 68 65 20 r the || in the
35ea0 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 following assert
35eb0 28 29 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 (). */. assert(
35ec0 20 73 7a 3d 3d 70 50 61 67 65 2d 3e 78 43 65 6c sz==pPage->xCel
35ed0 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 70 43 65 lSize(pPage, pCe
35ee0 6c 6c 29 20 7c 7c 20 28 73 7a 3d 3d 38 20 26 26 ll) || (sz==8 &&
35ef0 20 69 43 68 69 6c 64 3e 30 29 20 29 3b 0a 20 20 iChild>0) );.
35f00 69 66 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 if( pPage->nOver
35f10 66 6c 6f 77 20 7c 7c 20 73 7a 2b 32 3e 70 50 61 flow || sz+2>pPa
35f20 67 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 ge->nFree ){.
35f30 20 69 66 28 20 70 54 65 6d 70 20 29 7b 0a 20 20 if( pTemp ){.
35f40 20 20 20 20 6d 65 6d 63 70 79 28 70 54 65 6d 70 memcpy(pTemp
35f50 2c 20 70 43 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 , pCell, sz);.
35f60 20 20 20 20 70 43 65 6c 6c 20 3d 20 70 54 65 6d pCell = pTem
35f70 70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 p;. }. if(
35f80 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 20 20 20 iChild ){.
35f90 20 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c 2c put4byte(pCell,
35fa0 20 69 43 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a iChild);. }.
35fb0 20 20 20 20 6a 20 3d 20 70 50 61 67 65 2d 3e 6e j = pPage->n
35fc0 4f 76 65 72 66 6c 6f 77 2b 2b 3b 0a 20 20 20 20 Overflow++;.
35fd0 2f 2a 20 43 6f 6d 70 61 72 69 73 6f 6e 20 61 67 /* Comparison ag
35fe0 61 69 6e 73 74 20 41 72 72 61 79 53 69 7a 65 2d ainst ArraySize-
35ff0 31 20 73 69 6e 63 65 20 77 65 20 68 6f 6c 64 20 1 since we hold
36000 62 61 63 6b 20 6f 6e 65 20 65 78 74 72 61 20 73 back one extra s
36010 6c 6f 74 0a 20 20 20 20 2a 2a 20 61 73 20 61 20 lot. ** as a
36020 63 6f 6e 74 69 6e 67 65 6e 63 79 2e 20 20 49 6e contingency. In
36030 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 6e 65 other words, ne
36040 76 65 72 20 6e 65 65 64 20 6d 6f 72 65 20 74 68 ver need more th
36050 61 6e 20 33 20 6f 76 65 72 66 6c 6f 77 0a 20 20 an 3 overflow.
36060 20 20 2a 2a 20 73 6c 6f 74 73 20 62 75 74 20 34 ** slots but 4
36070 20 61 72 65 20 61 6c 6c 6f 63 61 74 65 64 2c 20 are allocated,
36080 6a 75 73 74 20 74 6f 20 62 65 20 73 61 66 65 2e just to be safe.
36090 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
360a0 6a 20 3c 20 41 72 72 61 79 53 69 7a 65 28 70 50 j < ArraySize(pP
360b0 61 67 65 2d 3e 61 70 4f 76 66 6c 29 2d 31 20 29 age->apOvfl)-1 )
360c0 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 70 4f ;. pPage->apO
360d0 76 66 6c 5b 6a 5d 20 3d 20 70 43 65 6c 6c 3b 0a vfl[j] = pCell;.
360e0 20 20 20 20 70 50 61 67 65 2d 3e 61 69 4f 76 66 pPage->aiOvf
360f0 6c 5b 6a 5d 20 3d 20 28 75 31 36 29 69 3b 0a 0a l[j] = (u16)i;..
36100 20 20 20 20 2f 2a 20 57 68 65 6e 20 6d 75 6c 74 /* When mult
36110 69 70 6c 65 20 6f 76 65 72 66 6c 6f 77 73 20 6f iple overflows o
36120 63 63 75 72 2c 20 74 68 65 79 20 61 72 65 20 61 ccur, they are a
36130 6c 77 61 79 73 20 73 65 71 75 65 6e 74 69 61 6c lways sequential
36140 20 61 6e 64 20 69 6e 0a 20 20 20 20 2a 2a 20 73 and in. ** s
36150 6f 72 74 65 64 20 6f 72 64 65 72 2e 20 20 54 68 orted order. Th
36160 69 73 20 69 6e 76 61 72 69 61 6e 74 73 20 61 72 is invariants ar
36170 69 73 65 20 62 65 63 61 75 73 65 20 6d 75 6c 74 ise because mult
36180 69 70 6c 65 20 6f 76 65 72 66 6c 6f 77 73 20 63 iple overflows c
36190 61 6e 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 6f an. ** only o
361a0 63 63 75 72 20 77 68 65 6e 20 69 6e 73 65 72 74 ccur when insert
361b0 69 6e 67 20 64 69 76 69 64 65 72 20 63 65 6c 6c ing divider cell
361c0 73 20 69 6e 74 6f 20 74 68 65 20 70 61 72 65 6e s into the paren
361d0 74 20 70 61 67 65 20 64 75 72 69 6e 67 0a 20 20 t page during.
361e0 20 20 2a 2a 20 62 61 6c 61 6e 63 69 6e 67 2c 20 ** balancing,
361f0 61 6e 64 20 74 68 65 20 64 69 76 69 64 65 72 73 and the dividers
36200 20 61 72 65 20 61 64 6a 61 63 65 6e 74 20 61 6e are adjacent an
36210 64 20 73 6f 72 74 65 64 2e 0a 20 20 20 20 2a 2f d sorted.. */
36220 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a 3d 3d . assert( j==
36230 30 20 7c 7c 20 70 50 61 67 65 2d 3e 61 69 4f 76 0 || pPage->aiOv
36240 66 6c 5b 6a 2d 31 5d 3c 28 75 31 36 29 69 20 29 fl[j-1]<(u16)i )
36250 3b 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 73 20 69 ; /* Overflows i
36260 6e 20 73 6f 72 74 65 64 20 6f 72 64 65 72 20 2a n sorted order *
36270 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a 3d /. assert( j=
36280 3d 30 20 7c 7c 20 69 3d 3d 70 50 61 67 65 2d 3e =0 || i==pPage->
36290 61 69 4f 76 66 6c 5b 6a 2d 31 5d 2b 31 20 29 3b aiOvfl[j-1]+1 );
362a0 20 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 73 20 /* Overflows
362b0 61 72 65 20 73 65 71 75 65 6e 74 69 61 6c 20 2a are sequential *
362c0 2f 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 /. }else{. i
362d0 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 nt rc = sqlite3P
362e0 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 2d agerWrite(pPage-
362f0 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 >pDbPage);. i
36300 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
36310 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 43 20 3d ){. *pRC =
36320 20 72 63 3b 0a 20 20 20 20 20 20 72 65 74 75 72 rc;. retur
36330 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 n;. }. ass
36340 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
36350 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
36360 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
36370 20 20 20 20 64 61 74 61 20 3d 20 70 50 61 67 65 data = pPage
36380 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 61 73 73 ->aData;. ass
36390 65 72 74 28 20 26 64 61 74 61 5b 70 50 61 67 65 ert( &data[pPage
363a0 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 5d 3d 3d 70 ->cellOffset]==p
363b0 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 20 29 Page->aCellIdx )
363c0 3b 0a 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 ;. rc = alloc
363d0 61 74 65 53 70 61 63 65 28 70 50 61 67 65 2c 20 ateSpace(pPage,
363e0 73 7a 2c 20 26 69 64 78 29 3b 0a 20 20 20 20 69 sz, &idx);. i
363f0 66 28 20 72 63 20 29 7b 20 2a 70 52 43 20 3d 20 f( rc ){ *pRC =
36400 72 63 3b 20 72 65 74 75 72 6e 3b 20 7d 0a 20 20 rc; return; }.
36410 20 20 2f 2a 20 54 68 65 20 61 6c 6c 6f 63 61 74 /* The allocat
36420 65 53 70 61 63 65 28 29 20 72 6f 75 74 69 6e 65 eSpace() routine
36430 20 67 75 61 72 61 6e 74 65 65 73 20 74 68 65 20 guarantees the
36440 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 6f 70 65 72 following proper
36450 74 69 65 73 0a 20 20 20 20 2a 2a 20 69 66 20 69 ties. ** if i
36460 74 20 72 65 74 75 72 6e 73 20 73 75 63 63 65 73 t returns succes
36470 73 66 75 6c 6c 79 20 2a 2f 0a 20 20 20 20 61 73 sfully */. as
36480 73 65 72 74 28 20 69 64 78 20 3e 3d 20 30 20 29 sert( idx >= 0 )
36490 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 64 ;. assert( id
364a0 78 20 3e 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c x >= pPage->cell
364b0 4f 66 66 73 65 74 2b 32 2a 70 50 61 67 65 2d 3e Offset+2*pPage->
364c0 6e 43 65 6c 6c 2b 32 20 7c 7c 20 43 4f 52 52 55 nCell+2 || CORRU
364d0 50 54 5f 44 42 20 29 3b 0a 20 20 20 20 61 73 73 PT_DB );. ass
364e0 65 72 74 28 20 69 64 78 2b 73 7a 20 3c 3d 20 28 ert( idx+sz <= (
364f0 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e int)pPage->pBt->
36500 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
36510 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2d pPage->nFree -
36520 3d 20 28 75 31 36 29 28 32 20 2b 20 73 7a 29 3b = (u16)(2 + sz);
36530 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 . memcpy(&dat
36540 61 5b 69 64 78 5d 2c 20 70 43 65 6c 6c 2c 20 73 a[idx], pCell, s
36550 7a 29 3b 0a 20 20 20 20 69 66 28 20 69 43 68 69 z);. if( iChi
36560 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 75 74 34 ld ){. put4
36570 62 79 74 65 28 26 64 61 74 61 5b 69 64 78 5d 2c byte(&data[idx],
36580 20 69 43 68 69 6c 64 29 3b 0a 20 20 20 20 7d 0a iChild);. }.
36590 20 20 20 20 70 49 6e 73 20 3d 20 70 50 61 67 65 pIns = pPage
365a0 2d 3e 61 43 65 6c 6c 49 64 78 20 2b 20 69 2a 32 ->aCellIdx + i*2
365b0 3b 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 49 ;. memmove(pI
365c0 6e 73 2b 32 2c 20 70 49 6e 73 2c 20 32 2a 28 70 ns+2, pIns, 2*(p
365d0 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 69 29 Page->nCell - i)
365e0 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
365f0 70 49 6e 73 2c 20 69 64 78 29 3b 0a 20 20 20 20 pIns, idx);.
36600 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 2b 3b 0a pPage->nCell++;.
36610 20 20 20 20 2f 2a 20 69 6e 63 72 65 6d 65 6e 74 /* increment
36620 20 74 68 65 20 63 65 6c 6c 20 63 6f 75 6e 74 20 the cell count
36630 2a 2f 0a 20 20 20 20 69 66 28 20 28 2b 2b 64 61 */. if( (++da
36640 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 ta[pPage->hdrOff
36650 73 65 74 2b 34 5d 29 3d 3d 30 20 29 20 64 61 74 set+4])==0 ) dat
36660 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
36670 65 74 2b 33 5d 2b 2b 3b 0a 20 20 20 20 61 73 73 et+3]++;. ass
36680 65 72 74 28 20 67 65 74 32 62 79 74 65 28 26 64 ert( get2byte(&d
36690 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 ata[pPage->hdrOf
366a0 66 73 65 74 2b 33 5d 29 3d 3d 70 50 61 67 65 2d fset+3])==pPage-
366b0 3e 6e 43 65 6c 6c 20 29 3b 0a 23 69 66 6e 64 65 >nCell );.#ifnde
366c0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
366d0 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
366e0 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 61 75 74 pPage->pBt->aut
366f0 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 oVacuum ){.
36700 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 6d 61 79 /* The cell may
36710 20 63 6f 6e 74 61 69 6e 20 61 20 70 6f 69 6e 74 contain a point
36720 65 72 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f er to an overflo
36730 77 20 70 61 67 65 2e 20 49 66 20 73 6f 2c 20 77 w page. If so, w
36740 72 69 74 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 rite. ** th
36750 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 e entry for the
36760 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e overflow page in
36770 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d to the pointer m
36780 61 70 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ap.. */.
36790 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c ptrmapPutOvfl
367a0 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c Ptr(pPage, pCell
367b0 2c 20 70 52 43 29 3b 0a 20 20 20 20 7d 0a 23 65 , pRC);. }.#e
367c0 6e 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a ndif. }.}../*.*
367d0 2a 20 41 20 43 65 6c 6c 41 72 72 61 79 20 6f 62 * A CellArray ob
367e0 6a 65 63 74 20 63 6f 6e 74 61 69 6e 73 20 61 20 ject contains a
367f0 63 61 63 68 65 20 6f 66 20 70 6f 69 6e 74 65 72 cache of pointer
36800 73 20 61 6e 64 20 73 69 7a 65 73 20 66 6f 72 20 s and sizes for
36810 61 0a 2a 2a 20 63 6f 6e 73 65 63 75 74 69 76 65 a.** consecutive
36820 20 73 65 71 75 65 6e 63 65 20 6f 66 20 63 65 6c sequence of cel
36830 6c 73 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 ls that might be
36840 20 68 65 6c 64 20 6f 6e 20 6d 75 6c 74 69 70 6c held on multipl
36850 65 20 70 61 67 65 73 2e 0a 2a 2f 0a 74 79 70 65 e pages..*/.type
36860 64 65 66 20 73 74 72 75 63 74 20 43 65 6c 6c 41 def struct CellA
36870 72 72 61 79 20 43 65 6c 6c 41 72 72 61 79 3b 0a rray CellArray;.
36880 73 74 72 75 63 74 20 43 65 6c 6c 41 72 72 61 79 struct CellArray
36890 20 7b 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 {. int nCell;
368a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
368b0 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 Number of cells
368c0 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 in apCell[] */.
368d0 20 4d 65 6d 50 61 67 65 20 2a 70 52 65 66 3b 20 MemPage *pRef;
368e0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 66 65 /* Refe
368f0 72 65 6e 63 65 20 70 61 67 65 20 2a 2f 0a 20 20 rence page */.
36900 75 38 20 2a 2a 61 70 43 65 6c 6c 3b 20 20 20 20 u8 **apCell;
36910 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 63 /* All c
36920 65 6c 6c 73 20 62 65 67 69 6e 20 62 61 6c 61 6e ells begin balan
36930 63 65 64 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a ced */. u16 *sz
36940 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Cell;
36950 20 2f 2a 20 4c 6f 63 61 6c 20 73 69 7a 65 20 6f /* Local size o
36960 66 20 61 6c 6c 20 63 65 6c 6c 73 20 69 6e 20 61 f all cells in a
36970 70 43 65 6c 6c 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f pCell[] */.};../
36980 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 *.** Make sure t
36990 68 65 20 63 65 6c 6c 20 73 69 7a 65 73 20 61 74 he cell sizes at
369a0 20 69 64 78 2c 20 69 64 78 2b 31 2c 20 2e 2e 2e idx, idx+1, ...
369b0 2c 20 69 64 78 2b 4e 2d 31 20 68 61 76 65 20 62 , idx+N-1 have b
369c0 65 65 6e 0a 2a 2a 20 63 6f 6d 70 75 74 65 64 2e een.** computed.
369d0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
369e0 70 6f 70 75 6c 61 74 65 43 65 6c 6c 43 61 63 68 populateCellCach
369f0 65 28 43 65 6c 6c 41 72 72 61 79 20 2a 70 2c 20 e(CellArray *p,
36a00 69 6e 74 20 69 64 78 2c 20 69 6e 74 20 4e 29 7b int idx, int N){
36a10 0a 20 20 61 73 73 65 72 74 28 20 69 64 78 3e 3d . assert( idx>=
36a20 30 20 26 26 20 69 64 78 2b 4e 3c 3d 70 2d 3e 6e 0 && idx+N<=p->n
36a30 43 65 6c 6c 20 29 3b 0a 20 20 77 68 69 6c 65 28 Cell );. while(
36a40 20 4e 3e 30 20 29 7b 0a 20 20 20 20 61 73 73 65 N>0 ){. asse
36a50 72 74 28 20 70 2d 3e 61 70 43 65 6c 6c 5b 69 64 rt( p->apCell[id
36a60 78 5d 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 x]!=0 );. if(
36a70 20 70 2d 3e 73 7a 43 65 6c 6c 5b 69 64 78 5d 3d p->szCell[idx]=
36a80 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 73 =0 ){. p->s
36a90 7a 43 65 6c 6c 5b 69 64 78 5d 20 3d 20 70 2d 3e zCell[idx] = p->
36aa0 70 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 pRef->xCellSize(
36ab0 70 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 p->pRef, p->apCe
36ac0 6c 6c 5b 69 64 78 5d 29 3b 0a 20 20 20 20 7d 65 ll[idx]);. }e
36ad0 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
36ae0 74 28 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c t( CORRUPT_DB ||
36af0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 . p
36b00 2d 3e 73 7a 43 65 6c 6c 5b 69 64 78 5d 3d 3d 70 ->szCell[idx]==p
36b10 2d 3e 70 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a ->pRef->xCellSiz
36b20 65 28 70 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 e(p->pRef, p->ap
36b30 43 65 6c 6c 5b 69 64 78 5d 29 20 29 3b 0a 20 20 Cell[idx]) );.
36b40 20 20 7d 0a 20 20 20 20 69 64 78 2b 2b 3b 0a 20 }. idx++;.
36b50 20 20 20 4e 2d 2d 3b 0a 20 20 7d 0a 7d 0a 0a 2f N--;. }.}../
36b60 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
36b70 73 69 7a 65 20 6f 66 20 74 68 65 20 4e 74 68 20 size of the Nth
36b80 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 63 element of the c
36b90 65 6c 6c 20 61 72 72 61 79 0a 2a 2f 0a 73 74 61 ell array.*/.sta
36ba0 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c tic SQLITE_NOINL
36bb0 49 4e 45 20 75 31 36 20 63 6f 6d 70 75 74 65 43 INE u16 computeC
36bc0 65 6c 6c 53 69 7a 65 28 43 65 6c 6c 41 72 72 61 ellSize(CellArra
36bd0 79 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 y *p, int N){.
36be0 61 73 73 65 72 74 28 20 4e 3e 3d 30 20 26 26 20 assert( N>=0 &&
36bf0 4e 3c 70 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 N<p->nCell );.
36c00 61 73 73 65 72 74 28 20 70 2d 3e 73 7a 43 65 6c assert( p->szCel
36c10 6c 5b 4e 5d 3d 3d 30 20 29 3b 0a 20 20 70 2d 3e l[N]==0 );. p->
36c20 73 7a 43 65 6c 6c 5b 4e 5d 20 3d 20 70 2d 3e 70 szCell[N] = p->p
36c30 52 65 66 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 Ref->xCellSize(p
36c40 2d 3e 70 52 65 66 2c 20 70 2d 3e 61 70 43 65 6c ->pRef, p->apCel
36c50 6c 5b 4e 5d 29 3b 0a 20 20 72 65 74 75 72 6e 20 l[N]);. return
36c60 70 2d 3e 73 7a 43 65 6c 6c 5b 4e 5d 3b 0a 7d 0a p->szCell[N];.}.
36c70 73 74 61 74 69 63 20 75 31 36 20 63 61 63 68 65 static u16 cache
36c80 64 43 65 6c 6c 53 69 7a 65 28 43 65 6c 6c 41 72 dCellSize(CellAr
36c90 72 61 79 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a ray *p, int N){.
36ca0 20 20 61 73 73 65 72 74 28 20 4e 3e 3d 30 20 26 assert( N>=0 &
36cb0 26 20 4e 3c 70 2d 3e 6e 43 65 6c 6c 20 29 3b 0a & N<p->nCell );.
36cc0 20 20 69 66 28 20 70 2d 3e 73 7a 43 65 6c 6c 5b if( p->szCell[
36cd0 4e 5d 20 29 20 72 65 74 75 72 6e 20 70 2d 3e 73 N] ) return p->s
36ce0 7a 43 65 6c 6c 5b 4e 5d 3b 0a 20 20 72 65 74 75 zCell[N];. retu
36cf0 72 6e 20 63 6f 6d 70 75 74 65 43 65 6c 6c 53 69 rn computeCellSi
36d00 7a 65 28 70 2c 20 4e 29 3b 0a 7d 0a 0a 2f 2a 0a ze(p, N);.}../*.
36d10 2a 2a 20 41 72 72 61 79 20 61 70 43 65 6c 6c 5b ** Array apCell[
36d20 5d 20 63 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 ] contains point
36d30 65 72 73 20 74 6f 20 6e 43 65 6c 6c 20 62 2d 74 ers to nCell b-t
36d40 72 65 65 20 70 61 67 65 20 63 65 6c 6c 73 2e 20 ree page cells.
36d50 54 68 65 20 0a 2a 2a 20 73 7a 43 65 6c 6c 5b 5d The .** szCell[]
36d60 20 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 73 20 array contains
36d70 74 68 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65 the size in byte
36d80 73 20 6f 66 20 65 61 63 68 20 63 65 6c 6c 2e 20 s of each cell.
36d90 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a This function.**
36da0 20 72 65 70 6c 61 63 65 73 20 74 68 65 20 63 75 replaces the cu
36db0 72 72 65 6e 74 20 63 6f 6e 74 65 6e 74 73 20 6f rrent contents o
36dc0 66 20 70 61 67 65 20 70 50 67 20 77 69 74 68 20 f page pPg with
36dd0 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
36de0 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 61 72 72 61 the cell.** arra
36df0 79 2e 0a 2a 2a 0a 2a 2a 20 53 6f 6d 65 20 6f 66 y..**.** Some of
36e00 20 74 68 65 20 63 65 6c 6c 73 20 69 6e 20 61 70 the cells in ap
36e10 43 65 6c 6c 5b 5d 20 6d 61 79 20 63 75 72 72 65 Cell[] may curre
36e20 6e 74 6c 79 20 62 65 20 73 74 6f 72 65 64 20 69 ntly be stored i
36e30 6e 20 70 50 67 2e 20 54 68 69 73 0a 2a 2a 20 66 n pPg. This.** f
36e40 75 6e 63 74 69 6f 6e 20 77 6f 72 6b 73 20 61 72 unction works ar
36e50 6f 75 6e 64 20 70 72 6f 62 6c 65 6d 73 20 63 61 ound problems ca
36e60 75 73 65 64 20 62 79 20 74 68 69 73 20 62 79 20 used by this by
36e70 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 20 6f 66 making a copy of
36e80 20 61 6e 79 20 0a 2a 2a 20 73 75 63 68 20 63 65 any .** such ce
36e90 6c 6c 73 20 62 65 66 6f 72 65 20 6f 76 65 72 77 lls before overw
36ea0 72 69 74 69 6e 67 20 74 68 65 20 70 61 67 65 20 riting the page
36eb0 64 61 74 61 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 data..**.** The
36ec0 4d 65 6d 50 61 67 65 2e 6e 46 72 65 65 20 66 69 MemPage.nFree fi
36ed0 65 6c 64 20 69 73 20 69 6e 76 61 6c 69 64 61 74 eld is invalidat
36ee0 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
36ef0 69 6f 6e 2e 20 49 74 20 69 73 20 74 68 65 20 0a ion. It is the .
36f00 2a 2a 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 ** responsibilit
36f10 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
36f20 74 6f 20 73 65 74 20 69 74 20 63 6f 72 72 65 63 to set it correc
36f30 74 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 tly..*/.static i
36f40 6e 74 20 72 65 62 75 69 6c 64 50 61 67 65 28 0a nt rebuildPage(.
36f50 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 MemPage *pPg,
36f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36f70 20 20 2f 2a 20 45 64 69 74 20 74 68 69 73 20 70 /* Edit this p
36f80 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 age */. int nCe
36f90 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
36fa0 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6e 61 /* Fina
36fb0 6c 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c l number of cell
36fc0 73 20 6f 6e 20 70 61 67 65 20 2a 2f 0a 20 20 75 s on page */. u
36fd0 38 20 2a 2a 61 70 43 65 6c 6c 2c 20 20 20 20 20 8 **apCell,
36fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
36ff0 2a 20 41 72 72 61 79 20 6f 66 20 63 65 6c 6c 73 * Array of cells
37000 20 2a 2f 0a 20 20 75 31 36 20 2a 73 7a 43 65 6c */. u16 *szCel
37010 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l
37020 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f /* Array o
37030 66 20 63 65 6c 6c 20 73 69 7a 65 73 20 2a 2f 0a f cell sizes */.
37040 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 68 ){. const int h
37050 64 72 20 3d 20 70 50 67 2d 3e 68 64 72 4f 66 66 dr = pPg->hdrOff
37060 73 65 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a set; /*
37070 20 4f 66 66 73 65 74 20 6f 66 20 68 65 61 64 65 Offset of heade
37080 72 20 6f 6e 20 70 50 67 20 2a 2f 0a 20 20 75 38 r on pPg */. u8
37090 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 61 20 3d * const aData =
370a0 20 70 50 67 2d 3e 61 44 61 74 61 3b 20 20 20 20 pPg->aData;
370b0 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
370c0 72 20 74 6f 20 64 61 74 61 20 66 6f 72 20 70 50 r to data for pP
370d0 67 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 g */. const int
370e0 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 usableSize = pP
370f0 67 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 g->pBt->usableSi
37100 7a 65 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 ze;. u8 * const
37110 20 70 45 6e 64 20 3d 20 26 61 44 61 74 61 5b 75 pEnd = &aData[u
37120 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 69 6e sableSize];. in
37130 74 20 69 3b 0a 20 20 75 38 20 2a 70 43 65 6c 6c t i;. u8 *pCell
37140 70 74 72 20 3d 20 70 50 67 2d 3e 61 43 65 6c 6c ptr = pPg->aCell
37150 49 64 78 3b 0a 20 20 75 38 20 2a 70 54 6d 70 20 Idx;. u8 *pTmp
37160 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 65 = sqlite3PagerTe
37170 6d 70 53 70 61 63 65 28 70 50 67 2d 3e 70 42 74 mpSpace(pPg->pBt
37180 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 75 38 20 ->pPager);. u8
37190 2a 70 44 61 74 61 3b 0a 0a 20 20 69 20 3d 20 67 *pData;.. i = g
371a0 65 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 68 et2byte(&aData[h
371b0 64 72 2b 35 5d 29 3b 0a 20 20 6d 65 6d 63 70 79 dr+5]);. memcpy
371c0 28 26 70 54 6d 70 5b 69 5d 2c 20 26 61 44 61 74 (&pTmp[i], &aDat
371d0 61 5b 69 5d 2c 20 75 73 61 62 6c 65 53 69 7a 65 a[i], usableSize
371e0 20 2d 20 69 29 3b 0a 0a 20 20 70 44 61 74 61 20 - i);.. pData
371f0 3d 20 70 45 6e 64 3b 0a 20 20 66 6f 72 28 69 3d = pEnd;. for(i=
37200 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 0; i<nCell; i++)
37210 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 {. u8 *pCell
37220 3d 20 61 70 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 = apCell[i];.
37230 20 69 66 28 20 53 51 4c 49 54 45 5f 57 49 54 48 if( SQLITE_WITH
37240 49 4e 28 70 43 65 6c 6c 2c 61 44 61 74 61 2c 70 IN(pCell,aData,p
37250 45 6e 64 29 20 29 7b 0a 20 20 20 20 20 20 70 43 End) ){. pC
37260 65 6c 6c 20 3d 20 26 70 54 6d 70 5b 70 43 65 6c ell = &pTmp[pCel
37270 6c 20 2d 20 61 44 61 74 61 5d 3b 0a 20 20 20 20 l - aData];.
37280 7d 0a 20 20 20 20 70 44 61 74 61 20 2d 3d 20 73 }. pData -= s
37290 7a 43 65 6c 6c 5b 69 5d 3b 0a 20 20 20 20 70 75 zCell[i];. pu
372a0 74 32 62 79 74 65 28 70 43 65 6c 6c 70 74 72 2c t2byte(pCellptr,
372b0 20 28 70 44 61 74 61 20 2d 20 61 44 61 74 61 29 (pData - aData)
372c0 29 3b 0a 20 20 20 20 70 43 65 6c 6c 70 74 72 20 );. pCellptr
372d0 2b 3d 20 32 3b 0a 20 20 20 20 69 66 28 20 70 44 += 2;. if( pD
372e0 61 74 61 20 3c 20 70 43 65 6c 6c 70 74 72 20 29 ata < pCellptr )
372f0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
37300 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
37310 20 6d 65 6d 63 70 79 28 70 44 61 74 61 2c 20 70 memcpy(pData, p
37320 43 65 6c 6c 2c 20 73 7a 43 65 6c 6c 5b 69 5d 29 Cell, szCell[i])
37330 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 7a ;. assert( sz
37340 43 65 6c 6c 5b 69 5d 3d 3d 70 50 67 2d 3e 78 43 Cell[i]==pPg->xC
37350 65 6c 6c 53 69 7a 65 28 70 50 67 2c 20 70 43 65 ellSize(pPg, pCe
37360 6c 6c 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 ll) || CORRUPT_D
37370 42 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 B );. testcas
37380 65 28 20 73 7a 43 65 6c 6c 5b 69 5d 21 3d 70 50 e( szCell[i]!=pP
37390 67 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 67 g->xCellSize(pPg
373a0 2c 70 43 65 6c 6c 29 20 29 3b 0a 20 20 7d 0a 0a ,pCell) );. }..
373b0 20 20 2f 2a 20 54 68 65 20 70 50 67 2d 3e 6e 46 /* The pPg->nF
373c0 72 65 65 20 66 69 65 6c 64 20 69 73 20 6e 6f 77 ree field is now
373d0 20 73 65 74 20 69 6e 63 6f 72 72 65 63 74 6c 79 set incorrectly
373e0 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 77 69 6c . The caller wil
373f0 6c 20 66 69 78 20 69 74 2e 20 2a 2f 0a 20 20 70 l fix it. */. p
37400 50 67 2d 3e 6e 43 65 6c 6c 20 3d 20 6e 43 65 6c Pg->nCell = nCel
37410 6c 3b 0a 20 20 70 50 67 2d 3e 6e 4f 76 65 72 66 l;. pPg->nOverf
37420 6c 6f 77 20 3d 20 30 3b 0a 0a 20 20 70 75 74 32 low = 0;.. put2
37430 62 79 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b byte(&aData[hdr+
37440 31 5d 2c 20 30 29 3b 0a 20 20 70 75 74 32 62 79 1], 0);. put2by
37450 74 65 28 26 61 44 61 74 61 5b 68 64 72 2b 33 5d te(&aData[hdr+3]
37460 2c 20 70 50 67 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 , pPg->nCell);.
37470 20 70 75 74 32 62 79 74 65 28 26 61 44 61 74 61 put2byte(&aData
37480 5b 68 64 72 2b 35 5d 2c 20 70 44 61 74 61 20 2d [hdr+5], pData -
37490 20 61 44 61 74 61 29 3b 0a 20 20 61 44 61 74 61 aData);. aData
374a0 5b 68 64 72 2b 37 5d 20 3d 20 30 78 30 30 3b 0a [hdr+7] = 0x00;.
374b0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
374c0 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 72 72 OK;.}../*.** Arr
374d0 61 79 20 61 70 43 65 6c 6c 5b 5d 20 63 6f 6e 74 ay apCell[] cont
374e0 61 69 6e 73 20 6e 43 65 6c 6c 20 70 6f 69 6e 74 ains nCell point
374f0 65 72 73 20 74 6f 20 62 2d 74 72 65 65 20 63 65 ers to b-tree ce
37500 6c 6c 73 2e 20 41 72 72 61 79 20 73 7a 43 65 6c lls. Array szCel
37510 6c 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 l.** contains th
37520 65 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 e size in bytes
37530 6f 66 20 65 61 63 68 20 73 75 63 68 20 63 65 6c of each such cel
37540 6c 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e l. This function
37550 20 61 74 74 65 6d 70 74 73 20 74 6f 20 0a 2a 2a attempts to .**
37560 20 61 64 64 20 74 68 65 20 63 65 6c 6c 73 20 73 add the cells s
37570 74 6f 72 65 64 20 69 6e 20 74 68 65 20 61 72 72 tored in the arr
37580 61 79 20 74 6f 20 70 61 67 65 20 70 50 67 2e 20 ay to page pPg.
37590 49 66 20 69 74 20 63 61 6e 6e 6f 74 20 28 62 65 If it cannot (be
375a0 63 61 75 73 65 20 0a 2a 2a 20 74 68 65 20 70 61 cause .** the pa
375b0 67 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 64 ge needs to be d
375c0 65 66 72 61 67 6d 65 6e 74 65 64 20 62 65 66 6f efragmented befo
375d0 72 65 20 74 68 65 20 63 65 6c 6c 73 20 77 69 6c re the cells wil
375e0 6c 20 66 69 74 29 2c 20 6e 6f 6e 2d 7a 65 72 6f l fit), non-zero
375f0 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e .** is returned.
37600 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 Otherwise, if t
37610 68 65 20 63 65 6c 6c 73 20 61 72 65 20 61 64 64 he cells are add
37620 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2c ed successfully,
37630 20 7a 65 72 6f 20 69 73 0a 2a 2a 20 72 65 74 75 zero is.** retu
37640 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75 rned..**.** Argu
37650 6d 65 6e 74 20 70 43 65 6c 6c 70 74 72 20 70 6f ment pCellptr po
37660 69 6e 74 73 20 74 6f 20 74 68 65 20 66 69 72 73 ints to the firs
37670 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 63 t entry in the c
37680 65 6c 6c 2d 70 6f 69 6e 74 65 72 20 61 72 72 61 ell-pointer arra
37690 79 0a 2a 2a 20 28 70 61 72 74 20 6f 66 20 70 61 y.** (part of pa
376a0 67 65 20 70 50 67 29 20 74 6f 20 70 6f 70 75 6c ge pPg) to popul
376b0 61 74 65 2e 20 41 66 74 65 72 20 63 65 6c 6c 20 ate. After cell
376c0 61 70 43 65 6c 6c 5b 30 5d 20 69 73 20 77 72 69 apCell[0] is wri
376d0 74 74 65 6e 20 74 6f 20 74 68 65 0a 2a 2a 20 70 tten to the.** p
376e0 61 67 65 20 62 6f 64 79 2c 20 61 20 31 36 2d 62 age body, a 16-b
376f0 69 74 20 6f 66 66 73 65 74 20 69 73 20 77 72 69 it offset is wri
37700 74 74 65 6e 20 74 6f 20 70 43 65 6c 6c 70 74 72 tten to pCellptr
37710 2e 20 41 6e 64 20 73 6f 20 6f 6e 2c 20 66 6f 72 . And so on, for
37720 20 65 61 63 68 0a 2a 2a 20 63 65 6c 6c 20 69 6e each.** cell in
37730 20 74 68 65 20 61 72 72 61 79 2e 20 49 74 20 69 the array. It i
37740 73 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 s the responsibi
37750 6c 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c lity of the call
37760 65 72 20 74 6f 20 65 6e 73 75 72 65 0a 2a 2a 20 er to ensure.**
37770 74 68 61 74 20 69 74 20 69 73 20 73 61 66 65 20 that it is safe
37780 74 6f 20 6f 76 65 72 77 72 69 74 65 20 74 68 69 to overwrite thi
37790 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 65 s part of the ce
377a0 6c 6c 2d 70 6f 69 6e 74 65 72 20 61 72 72 61 79 ll-pointer array
377b0 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 ..**.** When thi
377c0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
377d0 6c 6c 65 64 2c 20 2a 70 70 44 61 74 61 20 70 6f lled, *ppData po
377e0 69 6e 74 73 20 74 6f 20 74 68 65 20 73 74 61 72 ints to the star
377f0 74 20 6f 66 20 74 68 65 20 0a 2a 2a 20 63 6f 6e t of the .** con
37800 74 65 6e 74 20 61 72 65 61 20 6f 6e 20 70 61 67 tent area on pag
37810 65 20 70 50 67 2e 20 49 66 20 74 68 65 20 73 69 e pPg. If the si
37820 7a 65 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 6e ze of the conten
37830 74 20 61 72 65 61 20 69 73 20 65 78 74 65 6e 64 t area is extend
37840 65 64 2c 0a 2a 2a 20 2a 70 70 44 61 74 61 20 69 ed,.** *ppData i
37850 73 20 75 70 64 61 74 65 64 20 74 6f 20 70 6f 69 s updated to poi
37860 6e 74 20 74 6f 20 74 68 65 20 6e 65 77 20 73 74 nt to the new st
37870 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 art of the conte
37880 6e 74 20 61 72 65 61 0a 2a 2a 20 62 65 66 6f 72 nt area.** befor
37890 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a e returning..**.
378a0 2a 2a 20 46 69 6e 61 6c 6c 79 2c 20 61 72 67 75 ** Finally, argu
378b0 6d 65 6e 74 20 70 42 65 67 69 6e 20 70 6f 69 6e ment pBegin poin
378c0 74 73 20 74 6f 20 74 68 65 20 62 79 74 65 20 69 ts to the byte i
378d0 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f mmediately follo
378e0 77 69 6e 67 20 74 68 65 0a 2a 2a 20 65 6e 64 20 wing the.** end
378f0 6f 66 20 74 68 65 20 73 70 61 63 65 20 72 65 71 of the space req
37900 75 69 72 65 64 20 62 79 20 74 68 69 73 20 70 61 uired by this pa
37910 67 65 20 66 6f 72 20 74 68 65 20 63 65 6c 6c 2d ge for the cell-
37920 70 6f 69 6e 74 65 72 20 61 72 65 61 20 28 66 6f pointer area (fo
37930 72 0a 2a 2a 20 61 6c 6c 20 63 65 6c 6c 73 20 2d r.** all cells -
37940 20 6e 6f 74 20 6a 75 73 74 20 74 68 6f 73 65 20 not just those
37950 69 6e 73 65 72 74 65 64 20 62 79 20 74 68 65 20 inserted by the
37960 63 75 72 72 65 6e 74 20 63 61 6c 6c 29 2e 20 49 current call). I
37970 66 20 74 68 65 20 63 6f 6e 74 65 6e 74 0a 2a 2a f the content.**
37980 20 61 72 65 61 20 6d 75 73 74 20 62 65 20 65 78 area must be ex
37990 74 65 6e 64 65 64 20 74 6f 20 62 65 66 6f 72 65 tended to before
379a0 20 74 68 69 73 20 70 6f 69 6e 74 20 69 6e 20 6f this point in o
379b0 72 64 65 72 20 74 6f 20 61 63 63 6f 6d 6f 64 61 rder to accomoda
379c0 74 65 20 61 6c 6c 0a 2a 2a 20 63 65 6c 6c 73 20 te all.** cells
379d0 69 6e 20 61 70 43 65 6c 6c 5b 5d 2c 20 74 68 65 in apCell[], the
379e0 6e 20 74 68 65 20 63 65 6c 6c 73 20 64 6f 20 6e n the cells do n
379f0 6f 74 20 66 69 74 20 61 6e 64 20 6e 6f 6e 2d 7a ot fit and non-z
37a00 65 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64 2e ero is returned.
37a10 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
37a20 61 67 65 49 6e 73 65 72 74 41 72 72 61 79 28 0a ageInsertArray(.
37a30 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 MemPage *pPg,
37a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37a50 20 20 2f 2a 20 50 61 67 65 20 74 6f 20 61 64 64 /* Page to add
37a60 20 63 65 6c 6c 73 20 74 6f 20 2a 2f 0a 20 20 75 cells to */. u
37a70 38 20 2a 70 42 65 67 69 6e 2c 20 20 20 20 20 20 8 *pBegin,
37a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
37a90 2a 20 45 6e 64 20 6f 66 20 63 65 6c 6c 2d 70 6f * End of cell-po
37aa0 69 6e 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 inter array */.
37ab0 20 75 38 20 2a 2a 70 70 44 61 74 61 2c 20 20 20 u8 **ppData,
37ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37ad0 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20 50 61 67 65 /* IN/OUT: Page
37ae0 20 63 6f 6e 74 65 6e 74 20 2d 61 72 65 61 20 70 content -area p
37af0 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 75 38 20 2a ointer */. u8 *
37b00 70 43 65 6c 6c 70 74 72 2c 20 20 20 20 20 20 20 pCellptr,
37b10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
37b20 6f 69 6e 74 65 72 20 74 6f 20 63 65 6c 6c 2d 70 ointer to cell-p
37b30 6f 69 6e 74 65 72 20 61 72 65 61 20 2a 2f 0a 20 ointer area */.
37b40 20 69 6e 74 20 69 46 69 72 73 74 2c 20 20 20 20 int iFirst,
37b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37b60 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 66 69 72 /* Index of fir
37b70 73 74 20 63 65 6c 6c 20 74 6f 20 61 64 64 20 2a st cell to add *
37b80 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 2c 20 20 /. int nCell,
37b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37ba0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
37bb0 20 63 65 6c 6c 73 20 74 6f 20 61 64 64 20 74 6f cells to add to
37bc0 20 70 50 67 20 2a 2f 0a 20 20 43 65 6c 6c 41 72 pPg */. CellAr
37bd0 72 61 79 20 2a 70 43 41 72 72 61 79 20 20 20 20 ray *pCArray
37be0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 /* Arr
37bf0 61 79 20 6f 66 20 63 65 6c 6c 73 20 2a 2f 0a 29 ay of cells */.)
37c00 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 75 38 20 {. int i;. u8
37c10 2a 61 44 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 *aData = pPg->aD
37c20 61 74 61 3b 0a 20 20 75 38 20 2a 70 44 61 74 61 ata;. u8 *pData
37c30 20 3d 20 2a 70 70 44 61 74 61 3b 0a 20 20 69 6e = *ppData;. in
37c40 74 20 69 45 6e 64 20 3d 20 69 46 69 72 73 74 20 t iEnd = iFirst
37c50 2b 20 6e 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 + nCell;. asser
37c60 74 28 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c t( CORRUPT_DB ||
37c70 20 70 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 3d pPg->hdrOffset=
37c80 3d 30 20 29 3b 20 20 20 20 2f 2a 20 4e 65 76 65 =0 ); /* Neve
37c90 72 20 63 61 6c 6c 65 64 20 6f 6e 20 70 61 67 65 r called on page
37ca0 20 31 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 69 46 1 */. for(i=iF
37cb0 69 72 73 74 3b 20 69 3c 69 45 6e 64 3b 20 69 2b irst; i<iEnd; i+
37cc0 2b 29 7b 0a 20 20 20 20 69 6e 74 20 73 7a 2c 20 +){. int sz,
37cd0 72 63 3b 0a 20 20 20 20 75 38 20 2a 70 53 6c 6f rc;. u8 *pSlo
37ce0 74 3b 0a 20 20 20 20 73 7a 20 3d 20 63 61 63 68 t;. sz = cach
37cf0 65 64 43 65 6c 6c 53 69 7a 65 28 70 43 41 72 72 edCellSize(pCArr
37d00 61 79 2c 20 69 29 3b 0a 20 20 20 20 69 66 28 20 ay, i);. if(
37d10 28 61 44 61 74 61 5b 31 5d 3d 3d 30 20 26 26 20 (aData[1]==0 &&
37d20 61 44 61 74 61 5b 32 5d 3d 3d 30 29 20 7c 7c 20 aData[2]==0) ||
37d30 28 70 53 6c 6f 74 20 3d 20 70 61 67 65 46 69 6e (pSlot = pageFin
37d40 64 53 6c 6f 74 28 70 50 67 2c 73 7a 2c 26 72 63 dSlot(pPg,sz,&rc
37d50 29 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 ))==0 ){. i
37d60 66 28 20 28 70 44 61 74 61 20 2d 20 70 42 65 67 f( (pData - pBeg
37d70 69 6e 29 3c 73 7a 20 29 20 72 65 74 75 72 6e 20 in)<sz ) return
37d80 31 3b 0a 20 20 20 20 20 20 70 44 61 74 61 20 2d 1;. pData -
37d90 3d 20 73 7a 3b 0a 20 20 20 20 20 20 70 53 6c 6f = sz;. pSlo
37da0 74 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 7d t = pData;. }
37db0 0a 20 20 20 20 2f 2a 20 70 53 6c 6f 74 20 61 6e . /* pSlot an
37dc0 64 20 70 43 41 72 72 61 79 2d 3e 61 70 43 65 6c d pCArray->apCel
37dd0 6c 5b 69 5d 20 77 69 6c 6c 20 6e 65 76 65 72 20 l[i] will never
37de0 6f 76 65 72 6c 61 70 20 6f 6e 20 61 20 77 65 6c overlap on a wel
37df0 6c 2d 66 6f 72 6d 65 64 0a 20 20 20 20 2a 2a 20 l-formed. **
37e00 64 61 74 61 62 61 73 65 2e 20 20 42 75 74 20 74 database. But t
37e10 68 65 79 20 6d 69 67 68 74 20 66 6f 72 20 61 20 hey might for a
37e20 63 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 corrupt database
37e30 2e 20 20 48 65 6e 63 65 20 75 73 65 20 6d 65 6d . Hence use mem
37e40 6d 6f 76 65 28 29 0a 20 20 20 20 2a 2a 20 73 69 move(). ** si
37e50 6e 63 65 20 6d 65 6d 63 70 79 28 29 20 73 65 6e nce memcpy() sen
37e60 64 73 20 53 49 47 41 42 4f 52 54 20 77 69 74 68 ds SIGABORT with
37e70 20 6f 76 65 72 6c 61 70 70 69 6e 67 20 62 75 66 overlapping buf
37e80 66 65 72 73 20 6f 6e 20 4f 70 65 6e 42 53 44 20 fers on OpenBSD
37e90 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 */. assert( (
37ea0 70 53 6c 6f 74 2b 73 7a 29 3c 3d 70 43 41 72 72 pSlot+sz)<=pCArr
37eb0 61 79 2d 3e 61 70 43 65 6c 6c 5b 69 5d 0a 20 20 ay->apCell[i].
37ec0 20 20 20 20 20 20 20 7c 7c 20 70 53 6c 6f 74 3e || pSlot>
37ed0 3d 28 70 43 41 72 72 61 79 2d 3e 61 70 43 65 6c =(pCArray->apCel
37ee0 6c 5b 69 5d 2b 73 7a 29 0a 20 20 20 20 20 20 20 l[i]+sz).
37ef0 20 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 || CORRUPT_DB
37f00 29 3b 0a 20 20 20 20 6d 65 6d 6d 6f 76 65 28 70 );. memmove(p
37f10 53 6c 6f 74 2c 20 70 43 41 72 72 61 79 2d 3e 61 Slot, pCArray->a
37f20 70 43 65 6c 6c 5b 69 5d 2c 20 73 7a 29 3b 0a 20 pCell[i], sz);.
37f30 20 20 20 70 75 74 32 62 79 74 65 28 70 43 65 6c put2byte(pCel
37f40 6c 70 74 72 2c 20 28 70 53 6c 6f 74 20 2d 20 61 lptr, (pSlot - a
37f50 44 61 74 61 29 29 3b 0a 20 20 20 20 70 43 65 6c Data));. pCel
37f60 6c 70 74 72 20 2b 3d 20 32 3b 0a 20 20 7d 0a 20 lptr += 2;. }.
37f70 20 2a 70 70 44 61 74 61 20 3d 20 70 44 61 74 61 *ppData = pData
37f80 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a ;. return 0;.}.
37f90 0a 2f 2a 0a 2a 2a 20 41 72 72 61 79 20 61 70 43 ./*.** Array apC
37fa0 65 6c 6c 5b 5d 20 63 6f 6e 74 61 69 6e 73 20 6e ell[] contains n
37fb0 43 65 6c 6c 20 70 6f 69 6e 74 65 72 73 20 74 6f Cell pointers to
37fc0 20 62 2d 74 72 65 65 20 63 65 6c 6c 73 2e 20 41 b-tree cells. A
37fd0 72 72 61 79 20 73 7a 43 65 6c 6c 20 0a 2a 2a 20 rray szCell .**
37fe0 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 73 69 7a contains the siz
37ff0 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 65 61 e in bytes of ea
38000 63 68 20 73 75 63 68 20 63 65 6c 6c 2e 20 54 68 ch such cell. Th
38010 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 64 64 73 is function adds
38020 20 74 68 65 0a 2a 2a 20 73 70 61 63 65 20 61 73 the.** space as
38030 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 65 61 sociated with ea
38040 63 68 20 63 65 6c 6c 20 69 6e 20 74 68 65 20 61 ch cell in the a
38050 72 72 61 79 20 74 68 61 74 20 69 73 20 63 75 72 rray that is cur
38060 72 65 6e 74 6c 79 20 73 74 6f 72 65 64 20 0a 2a rently stored .*
38070 2a 20 77 69 74 68 69 6e 20 74 68 65 20 62 6f 64 * within the bod
38080 79 20 6f 66 20 70 50 67 20 74 6f 20 74 68 65 20 y of pPg to the
38090 70 50 67 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 pPg free-list. T
380a0 68 65 20 63 65 6c 6c 2d 70 6f 69 6e 74 65 72 73 he cell-pointers
380b0 20 61 6e 64 20 6f 74 68 65 72 0a 2a 2a 20 66 69 and other.** fi
380c0 65 6c 64 73 20 6f 66 20 74 68 65 20 70 61 67 65 elds of the page
380d0 20 61 72 65 20 6e 6f 74 20 75 70 64 61 74 65 64 are not updated
380e0 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
380f0 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 ction returns th
38100 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
38110 66 20 63 65 6c 6c 73 20 61 64 64 65 64 20 74 6f f cells added to
38120 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a the free-list..
38130 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 */.static int pa
38140 67 65 46 72 65 65 41 72 72 61 79 28 0a 20 20 4d geFreeArray(. M
38150 65 6d 50 61 67 65 20 2a 70 50 67 2c 20 20 20 20 emPage *pPg,
38160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
38170 2a 20 50 61 67 65 20 74 6f 20 65 64 69 74 20 2a * Page to edit *
38180 2f 0a 20 20 69 6e 74 20 69 46 69 72 73 74 2c 20 /. int iFirst,
38190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
381a0 20 20 20 20 2f 2a 20 46 69 72 73 74 20 63 65 6c /* First cel
381b0 6c 20 74 6f 20 64 65 6c 65 74 65 20 2a 2f 0a 20 l to delete */.
381c0 20 69 6e 74 20 6e 43 65 6c 6c 2c 20 20 20 20 20 int nCell,
381d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
381e0 20 2f 2a 20 43 65 6c 6c 73 20 74 6f 20 64 65 6c /* Cells to del
381f0 65 74 65 20 2a 2f 0a 20 20 43 65 6c 6c 41 72 72 ete */. CellArr
38200 61 79 20 2a 70 43 41 72 72 61 79 20 20 20 20 20 ay *pCArray
38210 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 /* Arra
38220 79 20 6f 66 20 63 65 6c 6c 73 20 2a 2f 0a 29 7b y of cells */.){
38230 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 . u8 * const aD
38240 61 74 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 ata = pPg->aData
38250 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 ;. u8 * const p
38260 45 6e 64 20 3d 20 26 61 44 61 74 61 5b 70 50 67 End = &aData[pPg
38270 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
38280 65 5d 3b 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 e];. u8 * const
38290 20 70 53 74 61 72 74 20 3d 20 26 61 44 61 74 61 pStart = &aData
382a0 5b 70 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 20 [pPg->hdrOffset
382b0 2b 20 38 20 2b 20 70 50 67 2d 3e 63 68 69 6c 64 + 8 + pPg->child
382c0 50 74 72 53 69 7a 65 5d 3b 0a 20 20 69 6e 74 20 PtrSize];. int
382d0 6e 52 65 74 20 3d 20 30 3b 0a 20 20 69 6e 74 20 nRet = 0;. int
382e0 69 3b 0a 20 20 69 6e 74 20 69 45 6e 64 20 3d 20 i;. int iEnd =
382f0 69 46 69 72 73 74 20 2b 20 6e 43 65 6c 6c 3b 0a iFirst + nCell;.
38300 20 20 75 38 20 2a 70 46 72 65 65 20 3d 20 30 3b u8 *pFree = 0;
38310 0a 20 20 69 6e 74 20 73 7a 46 72 65 65 20 3d 20 . int szFree =
38320 30 3b 0a 0a 20 20 66 6f 72 28 69 3d 69 46 69 72 0;.. for(i=iFir
38330 73 74 3b 20 69 3c 69 45 6e 64 3b 20 69 2b 2b 29 st; i<iEnd; i++)
38340 7b 0a 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 {. u8 *pCell
38350 3d 20 70 43 41 72 72 61 79 2d 3e 61 70 43 65 6c = pCArray->apCel
38360 6c 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 53 51 l[i];. if( SQ
38370 4c 49 54 45 5f 57 49 54 48 49 4e 28 70 43 65 6c LITE_WITHIN(pCel
38380 6c 2c 20 70 53 74 61 72 74 2c 20 70 45 6e 64 29 l, pStart, pEnd)
38390 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 73 7a ){. int sz
383a0 3b 0a 20 20 20 20 20 20 2f 2a 20 4e 6f 20 6e 65 ;. /* No ne
383b0 65 64 20 74 6f 20 75 73 65 20 63 61 63 68 65 64 ed to use cached
383c0 43 65 6c 6c 53 69 7a 65 28 29 20 68 65 72 65 2e CellSize() here.
383d0 20 20 54 68 65 20 73 69 7a 65 73 20 6f 66 20 61 The sizes of a
383e0 6c 6c 20 63 65 6c 6c 73 20 74 68 61 74 0a 20 20 ll cells that.
383f0 20 20 20 20 2a 2a 20 61 72 65 20 74 6f 20 62 65 ** are to be
38400 20 66 72 65 65 64 20 68 61 76 65 20 61 6c 72 65 freed have alre
38410 61 64 79 20 62 65 65 6e 20 63 6f 6d 70 75 74 69 ady been computi
38420 6e 67 20 77 68 69 6c 65 20 64 65 63 69 64 69 6e ng while decidin
38430 67 20 77 68 69 63 68 0a 20 20 20 20 20 20 2a 2a g which. **
38440 20 63 65 6c 6c 73 20 6e 65 65 64 20 66 72 65 65 cells need free
38450 69 6e 67 20 2a 2f 0a 20 20 20 20 20 20 73 7a 20 ing */. sz
38460 3d 20 70 43 41 72 72 61 79 2d 3e 73 7a 43 65 6c = pC