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 2f 2a 0a 2a 2a 20 49 6d 70 endif../*.** Imp
0e90: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 lementation of t
0ea0: 68 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 he SQLITE_CORRUP
0eb0: 54 5f 50 41 47 45 28 29 20 6d 61 63 72 6f 2e 20 T_PAGE() macro.
0ec0: 54 61 6b 65 73 20 61 20 73 69 6e 67 6c 65 0a 2a Takes a single.*
0ed0: 2a 20 28 4d 65 6d 50 61 67 65 2a 29 20 61 73 20 * (MemPage*) as
0ee0: 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 65 an argument. The
0ef0: 20 28 4d 65 6d 50 61 67 65 2a 29 20 6d 75 73 74 (MemPage*) must
0f00: 20 6e 6f 74 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a not be NULL..**
0f10: 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 44 45 .** If SQLITE_DE
0f20: 42 55 47 20 69 73 20 6e 6f 74 20 64 65 66 69 6e BUG is not defin
0f30: 65 64 2c 20 74 68 65 6e 20 74 68 69 73 20 6d 61 ed, then this ma
0f40: 63 72 6f 20 69 73 20 65 71 75 69 76 61 6c 65 6e cro is equivalen
0f50: 74 20 74 6f 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 t to.** SQLITE_C
0f60: 4f 52 52 55 50 54 5f 42 4b 50 54 2e 20 4f 72 2c ORRUPT_BKPT. Or,
0f70: 20 69 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 if SQLITE_DEBUG
0f80: 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 74 68 is set, then th
0f90: 65 20 6c 6f 67 20 6d 65 73 73 61 67 65 0a 2a 2a e log message.**
0fa0: 20 6e 6f 72 6d 61 6c 6c 79 20 70 72 6f 64 75 63 normally produc
0fb0: 65 64 20 61 73 20 61 20 73 69 64 65 2d 65 66 66 ed as a side-eff
0fc0: 65 63 74 20 6f 66 20 53 51 4c 49 54 45 5f 43 4f ect of SQLITE_CO
0fd0: 52 52 55 50 54 5f 42 4b 50 54 20 69 73 20 61 75 RRUPT_BKPT is au
0fe0: 67 6d 65 6e 74 65 64 0a 2a 2a 20 77 69 74 68 20 gmented.** with
0ff0: 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
1000: 61 6e 64 20 66 69 6c 65 6e 61 6d 65 20 61 73 73 and filename ass
1010: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
1020: 20 28 4d 65 6d 50 61 67 65 2a 29 2e 0a 2a 2f 0a (MemPage*)..*/.
1030: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
1040: 42 55 47 0a 69 6e 74 20 63 6f 72 72 75 70 74 50 BUG.int corruptP
1050: 61 67 65 45 72 72 6f 72 28 69 6e 74 20 6c 69 6e ageError(int lin
1060: 65 6e 6f 2c 20 4d 65 6d 50 61 67 65 20 2a 70 29 eno, MemPage *p)
1070: 7b 0a 20 20 63 68 61 72 20 2a 7a 4d 73 67 3b 0a {. char *zMsg;.
1080: 20 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 sqlite3BeginBe
1090: 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 nignMalloc();.
10a0: 7a 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 5f 6d zMsg = sqlite3_m
10b0: 70 72 69 6e 74 66 28 22 64 61 74 61 62 61 73 65 printf("database
10c0: 20 63 6f 72 72 75 70 74 69 6f 6e 20 70 61 67 65 corruption page
10d0: 20 25 64 20 6f 66 20 25 73 22 2c 0a 20 20 20 20 %d of %s",.
10e0: 20 20 28 69 6e 74 29 70 2d 3e 70 67 6e 6f 2c 20 (int)p->pgno,
10f0: 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 6c 65 sqlite3PagerFile
1100: 6e 61 6d 65 28 70 2d 3e 70 42 74 2d 3e 70 50 61 name(p->pBt->pPa
1110: 67 65 72 2c 20 30 29 0a 20 20 29 3b 0a 20 20 73 ger, 0). );. s
1120: 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
1130: 61 6c 6c 6f 63 28 29 3b 0a 20 20 69 66 28 20 7a alloc();. if( z
1140: 4d 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 Msg ){. sqlit
1150: 65 33 52 65 70 6f 72 74 45 72 72 6f 72 28 53 51 e3ReportError(SQ
1160: 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c 20 6c 69 LITE_CORRUPT, li
1170: 6e 65 6e 6f 2c 20 7a 4d 73 67 29 3b 0a 20 20 7d neno, zMsg);. }
1180: 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 . sqlite3_free(
1190: 7a 4d 73 67 29 3b 0a 20 20 72 65 74 75 72 6e 20 zMsg);. return
11a0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
11b0: 4b 50 54 3b 0a 7d 0a 23 20 64 65 66 69 6e 65 20 KPT;.}.# define
11c0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 SQLITE_CORRUPT_P
11d0: 41 47 45 28 70 4d 65 6d 50 61 67 65 29 20 63 6f AGE(pMemPage) co
11e0: 72 72 75 70 74 50 61 67 65 45 72 72 6f 72 28 5f rruptPageError(_
11f0: 5f 4c 49 4e 45 5f 5f 2c 20 70 4d 65 6d 50 61 67 _LINE__, pMemPag
1200: 65 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e e).#else.# defin
1210: 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 e SQLITE_CORRUPT
1220: 5f 50 41 47 45 28 70 4d 65 6d 50 61 67 65 29 20 _PAGE(pMemPage)
1230: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 SQLITE_CORRUPT_P
1240: 47 4e 4f 28 70 4d 65 6d 50 61 67 65 2d 3e 70 67 GNO(pMemPage->pg
1250: 6e 6f 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e no).#endif..#ifn
1260: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1270: 53 48 41 52 45 44 5f 43 41 43 48 45 0a 0a 23 69 SHARED_CACHE..#i
1280: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
1290: 47 0a 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 73 20 66 G./*.**** This f
12a0: 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 unction is only
12b0: 75 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 used as part of
12c0: 61 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 an assert() stat
12d0: 65 6d 65 6e 74 2e 20 2a 2a 2a 0a 2a 2a 0a 2a 2a ement. ***.**.**
12e0: 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 Check to see if
12f0: 20 70 42 74 72 65 65 20 68 6f 6c 64 73 20 74 68 pBtree holds th
1300: 65 20 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 73 e required locks
1310: 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72 69 74 to read or writ
1320: 65 20 74 6f 20 74 68 65 20 0a 2a 2a 20 74 61 62 e to the .** tab
1330: 6c 65 20 77 69 74 68 20 72 6f 6f 74 20 70 61 67 le with root pag
1340: 65 20 69 52 6f 6f 74 2e 20 20 20 52 65 74 75 72 e iRoot. Retur
1350: 6e 20 31 20 69 66 20 69 74 20 64 6f 65 73 20 61 n 1 if it does a
1360: 6e 64 20 30 20 69 66 20 6e 6f 74 2e 0a 2a 2a 0a nd 0 if not..**.
1370: 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 ** For example,
1380: 77 68 65 6e 20 77 72 69 74 69 6e 67 20 74 6f 20 when writing to
1390: 61 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f 6f a table with roo
13a0: 74 2d 70 61 67 65 20 69 52 6f 6f 74 20 76 69 61 t-page iRoot via
13b0: 20 0a 2a 2a 20 42 74 72 65 65 20 63 6f 6e 6e 65 .** Btree conne
13c0: 63 74 69 6f 6e 20 70 42 74 72 65 65 3a 0a 2a 2a ction pBtree:.**
13d0: 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 28 20 68 .** assert( h
13e0: 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 62 asSharedCacheTab
13f0: 6c 65 4c 6f 63 6b 28 70 42 74 72 65 65 2c 20 69 leLock(pBtree, i
1400: 52 6f 6f 74 2c 20 30 2c 20 57 52 49 54 45 5f 4c Root, 0, WRITE_L
1410: 4f 43 4b 29 20 29 3b 0a 2a 2a 0a 2a 2a 20 57 68 OCK) );.**.** Wh
1420: 65 6e 20 77 72 69 74 69 6e 67 20 74 6f 20 61 6e en writing to an
1430: 20 69 6e 64 65 78 20 74 68 61 74 20 72 65 73 69 index that resi
1440: 64 65 73 20 69 6e 20 61 20 73 68 61 72 61 62 6c des in a sharabl
1450: 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 e database, the
1460: 0a 2a 2a 20 63 61 6c 6c 65 72 20 73 68 6f 75 6c .** caller shoul
1470: 64 20 68 61 76 65 20 66 69 72 73 74 20 6f 62 74 d have first obt
1480: 61 69 6e 65 64 20 61 20 6c 6f 63 6b 20 73 70 65 ained a lock spe
1490: 63 69 66 79 69 6e 67 20 74 68 65 20 72 6f 6f 74 cifying the root
14a0: 20 70 61 67 65 20 6f 66 0a 2a 2a 20 74 68 65 20 page of.** the
14b0: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 61 corresponding ta
14c0: 62 6c 65 2e 20 54 68 69 73 20 6d 61 6b 65 73 20 ble. This makes
14d0: 74 68 69 6e 67 73 20 61 20 62 69 74 20 6d 6f 72 things a bit mor
14e0: 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 2c 0a 2a e complicated,.*
14f0: 2a 20 61 73 20 74 68 69 73 20 6d 6f 64 75 6c 65 * as this module
1500: 20 74 72 65 61 74 73 20 65 61 63 68 20 74 61 62 treats each tab
1510: 6c 65 20 61 73 20 61 20 73 65 70 61 72 61 74 65 le as a separate
1520: 20 73 74 72 75 63 74 75 72 65 2e 20 54 6f 20 64 structure. To d
1530: 65 74 65 72 6d 69 6e 65 0a 2a 2a 20 74 68 65 20 etermine.** the
1540: 74 61 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 table correspond
1550: 69 6e 67 20 74 6f 20 74 68 65 20 69 6e 64 65 78 ing to the index
1560: 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e 2c 20 being written,
1570: 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e this.** function
1580: 20 68 61 73 20 74 6f 20 73 65 61 72 63 68 20 74 has to search t
1590: 68 72 6f 75 67 68 20 74 68 65 20 64 61 74 61 62 hrough the datab
15a0: 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a 2a 0a 2a ase schema..**.*
15b0: 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 61 20 6c * Instead of a l
15c0: 6f 63 6b 20 6f 6e 20 74 68 65 20 74 61 62 6c 65 ock on the table
15d0: 2f 69 6e 64 65 78 20 72 6f 6f 74 65 64 20 61 74 /index rooted at
15e0: 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 74 68 65 page iRoot, the
15f0: 20 63 61 6c 6c 65 72 20 6d 61 79 0a 2a 2a 20 68 caller may.** h
1600: 6f 6c 64 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b old a write-lock
1610: 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 20 74 on the schema t
1620: 61 62 6c 65 20 28 72 6f 6f 74 20 70 61 67 65 20 able (root page
1630: 31 29 2e 20 54 68 69 73 20 69 73 20 61 6c 73 6f 1). This is also
1640: 0a 2a 2a 20 61 63 63 65 70 74 61 62 6c 65 2e 0a .** acceptable..
1650: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 68 61 */.static int ha
1660: 73 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c sSharedCacheTabl
1670: 65 4c 6f 63 6b 28 0a 20 20 42 74 72 65 65 20 2a eLock(. Btree *
1680: 70 42 74 72 65 65 2c 20 20 20 20 20 20 20 20 20 pBtree,
1690: 2f 2a 20 48 61 6e 64 6c 65 20 74 68 61 74 20 6d /* Handle that m
16a0: 75 73 74 20 68 6f 6c 64 20 6c 6f 63 6b 20 2a 2f ust hold lock */
16b0: 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 20 . Pgno iRoot,
16c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f /* Roo
16d0: 74 20 70 61 67 65 20 6f 66 20 62 2d 74 72 65 65 t page of b-tree
16e0: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 64 65 */. int isInde
16f0: 78 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 x, /*
1700: 54 72 75 65 20 69 66 20 69 52 6f 6f 74 20 69 73 True if iRoot is
1710: 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 61 6e 20 the root of an
1720: 69 6e 64 65 78 20 62 2d 74 72 65 65 20 2a 2f 0a index b-tree */.
1730: 20 20 69 6e 74 20 65 4c 6f 63 6b 54 79 70 65 20 int eLockType
1740: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 71 75 /* Requ
1750: 69 72 65 64 20 6c 6f 63 6b 20 74 79 70 65 20 28 ired lock type (
1760: 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 57 52 49 READ_LOCK or WRI
1770: 54 45 5f 4c 4f 43 4b 29 20 2a 2f 0a 29 7b 0a 20 TE_LOCK) */.){.
1780: 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 Schema *pSchema
1790: 20 3d 20 28 53 63 68 65 6d 61 20 2a 29 70 42 74 = (Schema *)pBt
17a0: 72 65 65 2d 3e 70 42 74 2d 3e 70 53 63 68 65 6d ree->pBt->pSchem
17b0: 61 3b 0a 20 20 50 67 6e 6f 20 69 54 61 62 20 3d a;. Pgno iTab =
17c0: 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 0;. BtLock *pL
17d0: 6f 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 ock;.. /* If th
17e0: 69 73 20 64 61 74 61 62 61 73 65 20 69 73 20 6e is database is n
17f0: 6f 74 20 73 68 61 72 65 61 62 6c 65 2c 20 6f 72 ot shareable, or
1800: 20 69 66 20 74 68 65 20 63 6c 69 65 6e 74 20 69 if the client i
1810: 73 20 72 65 61 64 69 6e 67 0a 20 20 2a 2a 20 61 s reading. ** a
1820: 6e 64 20 68 61 73 20 74 68 65 20 72 65 61 64 2d nd has the read-
1830: 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c 61 67 uncommitted flag
1840: 20 73 65 74 2c 20 74 68 65 6e 20 6e 6f 20 6c 6f set, then no lo
1850: 63 6b 20 69 73 20 72 65 71 75 69 72 65 64 2e 20 ck is required.
1860: 0a 20 20 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 . ** Return tru
1870: 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 0a 20 e immediately..
1880: 20 2a 2f 0a 20 20 69 66 28 20 28 70 42 74 72 65 */. if( (pBtre
1890: 65 2d 3e 73 68 61 72 61 62 6c 65 3d 3d 30 29 0a e->sharable==0).
18a0: 20 20 20 7c 7c 20 28 65 4c 6f 63 6b 54 79 70 65 || (eLockType
18b0: 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 26 26 20 28 ==READ_LOCK && (
18c0: 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 6c 61 67 pBtree->db->flag
18d0: 73 20 26 20 53 51 4c 49 54 45 5f 52 65 61 64 55 s & SQLITE_ReadU
18e0: 6e 63 6f 6d 6d 69 74 29 29 0a 20 20 29 7b 0a 20 ncommit)). ){.
18f0: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d return 1;. }
1900: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 63 6c .. /* If the cl
1910: 69 65 6e 74 20 69 73 20 72 65 61 64 69 6e 67 20 ient is reading
1920: 20 6f 72 20 77 72 69 74 69 6e 67 20 61 6e 20 69 or writing an i
1930: 6e 64 65 78 20 61 6e 64 20 74 68 65 20 73 63 68 ndex and the sch
1940: 65 6d 61 20 69 73 0a 20 20 2a 2a 20 6e 6f 74 20 ema is. ** not
1950: 6c 6f 61 64 65 64 2c 20 74 68 65 6e 20 69 74 20 loaded, then it
1960: 69 73 20 74 6f 6f 20 64 69 66 66 69 63 75 6c 74 is too difficult
1970: 20 74 6f 20 61 63 74 75 61 6c 6c 79 20 63 68 65 to actually che
1980: 63 6b 20 74 6f 20 73 65 65 20 69 66 0a 20 20 2a ck to see if. *
1990: 2a 20 74 68 65 20 63 6f 72 72 65 63 74 20 6c 6f * the correct lo
19a0: 63 6b 73 20 61 72 65 20 68 65 6c 64 2e 20 20 53 cks are held. S
19b0: 6f 20 64 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 o do not bother
19c0: 2d 20 6a 75 73 74 20 72 65 74 75 72 6e 20 74 72 - just return tr
19d0: 75 65 2e 0a 20 20 2a 2a 20 54 68 69 73 20 63 61 ue.. ** This ca
19e0: 73 65 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6d 65 se does not come
19f0: 20 75 70 20 76 65 72 79 20 6f 66 74 65 6e 20 61 up very often a
1a00: 6e 79 68 6f 77 2e 0a 20 20 2a 2f 0a 20 20 69 66 nyhow.. */. if
1a10: 28 20 69 73 49 6e 64 65 78 20 26 26 20 28 21 70 ( isIndex && (!p
1a20: 53 63 68 65 6d 61 20 7c 7c 20 28 70 53 63 68 65 Schema || (pSche
1a30: 6d 61 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 ma->schemaFlags&
1a40: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 DB_SchemaLoaded)
1a50: 3d 3d 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 ==0) ){. retu
1a60: 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 rn 1;. }.. /*
1a70: 46 69 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 Figure out the r
1a80: 6f 6f 74 2d 70 61 67 65 20 74 68 61 74 20 74 68 oot-page that th
1a90: 65 20 6c 6f 63 6b 20 73 68 6f 75 6c 64 20 62 65 e lock should be
1aa0: 20 68 65 6c 64 20 6f 6e 2e 20 46 6f 72 20 74 61 held on. For ta
1ab0: 62 6c 65 0a 20 20 2a 2a 20 62 2d 74 72 65 65 73 ble. ** b-trees
1ac0: 2c 20 74 68 69 73 20 69 73 20 6a 75 73 74 20 74 , this is just t
1ad0: 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 he root page of
1ae0: 74 68 65 20 62 2d 74 72 65 65 20 62 65 69 6e 67 the b-tree being
1af0: 20 72 65 61 64 20 6f 72 0a 20 20 2a 2a 20 77 72 read or. ** wr
1b00: 69 74 74 65 6e 2e 20 46 6f 72 20 69 6e 64 65 78 itten. For index
1b10: 20 62 2d 74 72 65 65 73 2c 20 69 74 20 69 73 20 b-trees, it is
1b20: 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 the root page of
1b30: 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a the associated.
1b40: 20 20 2a 2a 20 74 61 62 6c 65 2e 20 20 2a 2f 0a ** table. */.
1b50: 20 20 69 66 28 20 69 73 49 6e 64 65 78 20 29 7b if( isIndex ){
1b60: 0a 20 20 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 . HashElem *p
1b70: 3b 0a 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 ;. for(p=sqli
1b80: 74 65 48 61 73 68 46 69 72 73 74 28 26 70 53 63 teHashFirst(&pSc
1b90: 68 65 6d 61 2d 3e 69 64 78 48 61 73 68 29 3b 20 hema->idxHash);
1ba0: 70 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e p; p=sqliteHashN
1bb0: 65 78 74 28 70 29 29 7b 0a 20 20 20 20 20 20 49 ext(p)){. I
1bc0: 6e 64 65 78 20 2a 70 49 64 78 20 3d 20 28 49 6e ndex *pIdx = (In
1bd0: 64 65 78 20 2a 29 73 71 6c 69 74 65 48 61 73 68 dex *)sqliteHash
1be0: 44 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 69 Data(p);. i
1bf0: 66 28 20 70 49 64 78 2d 3e 74 6e 75 6d 3d 3d 28 f( pIdx->tnum==(
1c00: 69 6e 74 29 69 52 6f 6f 74 20 29 7b 0a 20 20 20 int)iRoot ){.
1c10: 20 20 20 20 20 69 66 28 20 69 54 61 62 20 29 7b if( iTab ){
1c20: 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 77 . /* Tw
1c30: 6f 20 6f 72 20 6d 6f 72 65 20 69 6e 64 65 78 65 o or more indexe
1c40: 73 20 73 68 61 72 65 20 74 68 65 20 73 61 6d 65 s share the same
1c50: 20 72 6f 6f 74 20 70 61 67 65 2e 20 20 54 68 65 root page. The
1c60: 72 65 20 6d 75 73 74 0a 20 20 20 20 20 20 20 20 re must.
1c70: 20 20 2a 2a 20 62 65 20 69 6d 70 6f 73 74 65 72 ** be imposter
1c80: 20 74 61 62 6c 65 73 2e 20 20 53 6f 20 6a 75 73 tables. So jus
1c90: 74 20 72 65 74 75 72 6e 20 74 72 75 65 2e 20 20 t return true.
1ca0: 54 68 65 20 61 73 73 65 72 74 20 69 73 20 6e 6f The assert is no
1cb0: 74 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 75 t. ** u
1cc0: 73 65 66 75 6c 20 69 6e 20 74 68 61 74 20 63 61 seful in that ca
1cd0: 73 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 se. */.
1ce0: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 return 1;.
1cf0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 54 61 }. iTa
1d00: 62 20 3d 20 70 49 64 78 2d 3e 70 54 61 62 6c 65 b = pIdx->pTable
1d10: 2d 3e 74 6e 75 6d 3b 0a 20 20 20 20 20 20 7d 0a ->tnum;. }.
1d20: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
1d30: 20 20 20 69 54 61 62 20 3d 20 69 52 6f 6f 74 3b iTab = iRoot;
1d40: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 61 72 63 . }.. /* Searc
1d50: 68 20 66 6f 72 20 74 68 65 20 72 65 71 75 69 72 h for the requir
1d60: 65 64 20 6c 6f 63 6b 2e 20 45 69 74 68 65 72 20 ed lock. Either
1d70: 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 a write-lock on
1d80: 72 6f 6f 74 2d 70 61 67 65 20 69 54 61 62 2c 20 root-page iTab,
1d90: 61 20 0a 20 20 2a 2a 20 77 72 69 74 65 2d 6c 6f a . ** write-lo
1da0: 63 6b 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 ck on the schema
1db0: 20 74 61 62 6c 65 2c 20 6f 72 20 28 69 66 20 74 table, or (if t
1dc0: 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 he client is rea
1dd0: 64 69 6e 67 29 20 61 0a 20 20 2a 2a 20 72 65 61 ding) a. ** rea
1de0: 64 2d 6c 6f 63 6b 20 6f 6e 20 69 54 61 62 20 77 d-lock on iTab w
1df0: 69 6c 6c 20 73 75 66 66 69 63 65 2e 20 52 65 74 ill suffice. Ret
1e00: 75 72 6e 20 31 20 69 66 20 61 6e 79 20 6f 66 20 urn 1 if any of
1e10: 74 68 65 73 65 20 61 72 65 20 66 6f 75 6e 64 2e these are found.
1e20: 20 20 2a 2f 0a 20 20 66 6f 72 28 70 4c 6f 63 6b */. for(pLock
1e30: 3d 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 4c =pBtree->pBt->pL
1e40: 6f 63 6b 3b 20 70 4c 6f 63 6b 3b 20 70 4c 6f 63 ock; pLock; pLoc
1e50: 6b 3d 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 29 7b k=pLock->pNext){
1e60: 0a 20 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e . if( pLock->
1e70: 70 42 74 72 65 65 3d 3d 70 42 74 72 65 65 20 0a pBtree==pBtree .
1e80: 20 20 20 20 20 26 26 20 28 70 4c 6f 63 6b 2d 3e && (pLock->
1e90: 69 54 61 62 6c 65 3d 3d 69 54 61 62 20 7c 7c 20 iTable==iTab ||
1ea0: 28 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3d 3d 57 (pLock->eLock==W
1eb0: 52 49 54 45 5f 4c 4f 43 4b 20 26 26 20 70 4c 6f RITE_LOCK && pLo
1ec0: 63 6b 2d 3e 69 54 61 62 6c 65 3d 3d 31 29 29 0a ck->iTable==1)).
1ed0: 20 20 20 20 20 26 26 20 70 4c 6f 63 6b 2d 3e 65 && pLock->e
1ee0: 4c 6f 63 6b 3e 3d 65 4c 6f 63 6b 54 79 70 65 20 Lock>=eLockType
1ef0: 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 . ){. re
1f00: 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 turn 1;. }.
1f10: 7d 0a 0a 20 20 2f 2a 20 46 61 69 6c 65 64 20 74 }.. /* Failed t
1f20: 6f 20 66 69 6e 64 20 74 68 65 20 72 65 71 75 69 o find the requi
1f30: 72 65 64 20 6c 6f 63 6b 2e 20 2a 2f 0a 20 20 72 red lock. */. r
1f40: 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 6e 64 69 eturn 0;.}.#endi
1f50: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 f /* SQLITE_DEBU
1f60: 47 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c G */..#ifdef SQL
1f70: 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 2a ITE_DEBUG./*.***
1f80: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 * This function
1f90: 6d 61 79 20 62 65 20 75 73 65 64 20 61 73 20 70 may be used as p
1fa0: 61 72 74 20 6f 66 20 61 73 73 65 72 74 28 29 20 art of assert()
1fb0: 73 74 61 74 65 6d 65 6e 74 73 20 6f 6e 6c 79 2e statements only.
1fc0: 20 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 52 65 74 75 ****.**.** Retu
1fd0: 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 77 6f rn true if it wo
1fe0: 75 6c 64 20 62 65 20 69 6c 6c 65 67 61 6c 20 66 uld be illegal f
1ff0: 6f 72 20 70 42 74 72 65 65 20 74 6f 20 77 72 69 or pBtree to wri
2000: 74 65 20 69 6e 74 6f 20 74 68 65 0a 2a 2a 20 74 te into the.** t
2010: 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 20 72 6f able or index ro
2020: 6f 74 65 64 20 61 74 20 69 52 6f 6f 74 20 62 65 oted at iRoot be
2030: 63 61 75 73 65 20 6f 74 68 65 72 20 73 68 61 72 cause other shar
2040: 65 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 61 ed connections a
2050: 72 65 0a 2a 2a 20 73 69 6d 75 6c 74 61 6e 65 6f re.** simultaneo
2060: 75 73 6c 79 20 72 65 61 64 69 6e 67 20 74 68 61 usly reading tha
2070: 74 20 73 61 6d 65 20 74 61 62 6c 65 20 6f 72 20 t same table or
2080: 69 6e 64 65 78 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 index..**.** It
2090: 69 73 20 69 6c 6c 65 67 61 6c 20 66 6f 72 20 70 is illegal for p
20a0: 42 74 72 65 65 20 74 6f 20 77 72 69 74 65 20 69 Btree to write i
20b0: 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 42 74 72 f some other Btr
20c0: 65 65 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a ee object that.*
20d0: 2a 20 73 68 61 72 65 73 20 74 68 65 20 73 61 6d * shares the sam
20e0: 65 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 e BtShared objec
20f0: 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 72 t is currently r
2100: 65 61 64 69 6e 67 20 6f 72 20 77 72 69 74 69 6e eading or writin
2110: 67 0a 2a 2a 20 74 68 65 20 69 52 6f 6f 74 20 74 g.** the iRoot t
2120: 61 62 6c 65 2e 20 20 45 78 63 65 70 74 2c 20 69 able. Except, i
2130: 66 20 74 68 65 20 6f 74 68 65 72 20 42 74 72 65 f the other Btre
2140: 65 20 6f 62 6a 65 63 74 20 68 61 73 20 74 68 65 e object has the
2150: 0a 2a 2a 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 .** read-uncommi
2160: 74 74 65 64 20 66 6c 61 67 20 73 65 74 2c 20 74 tted flag set, t
2170: 68 65 6e 20 69 74 20 69 73 20 4f 4b 20 66 6f 72 hen it is OK for
2180: 20 74 68 65 20 6f 74 68 65 72 20 6f 62 6a 65 63 the other objec
2190: 74 20 74 6f 0a 2a 2a 20 68 61 76 65 20 61 20 72 t to.** have a r
21a0: 65 61 64 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a ead cursor..**.*
21b0: 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 62 * For example, b
21c0: 65 66 6f 72 65 20 77 72 69 74 69 6e 67 20 74 6f efore writing to
21d0: 20 61 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 any part of the
21e0: 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 0a table or index.
21f0: 2a 2a 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 ** rooted at pag
2200: 65 20 69 52 6f 6f 74 2c 20 6f 6e 65 20 73 68 6f e iRoot, one sho
2210: 75 6c 64 20 63 61 6c 6c 3a 0a 2a 2a 0a 2a 2a 20 uld call:.**.**
2220: 20 20 20 61 73 73 65 72 74 28 20 21 68 61 73 52 assert( !hasR
2230: 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 70 42 74 eadConflicts(pBt
2240: 72 65 65 2c 20 69 52 6f 6f 74 29 20 29 3b 0a 2a ree, iRoot) );.*
2250: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 68 61 73 /.static int has
2260: 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 42 74 ReadConflicts(Bt
2270: 72 65 65 20 2a 70 42 74 72 65 65 2c 20 50 67 6e ree *pBtree, Pgn
2280: 6f 20 69 52 6f 6f 74 29 7b 0a 20 20 42 74 43 75 o iRoot){. BtCu
2290: 72 73 6f 72 20 2a 70 3b 0a 20 20 66 6f 72 28 70 rsor *p;. for(p
22a0: 3d 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 43 =pBtree->pBt->pC
22b0: 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 ursor; p; p=p->p
22c0: 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 Next){. if( p
22d0: 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f 6f ->pgnoRoot==iRoo
22e0: 74 20 0a 20 20 20 20 20 26 26 20 70 2d 3e 70 42 t . && p->pB
22f0: 74 72 65 65 21 3d 70 42 74 72 65 65 0a 20 20 20 tree!=pBtree.
2300: 20 20 26 26 20 30 3d 3d 28 70 2d 3e 70 42 74 72 && 0==(p->pBtr
2310: 65 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 ee->db->flags &
2320: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d SQLITE_ReadUncom
2330: 6d 69 74 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 mit). ){.
2340: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 return 1;.
2350: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 }. }. return 0
2360: 3b 0a 7d 0a 23 65 6e 64 69 66 20 20 20 20 2f 2a ;.}.#endif /*
2370: 20 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifdef SQLITE_D
2380: 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 51 EBUG */../*.** Q
2390: 75 65 72 79 20 74 6f 20 73 65 65 20 69 66 20 42 uery to see if B
23a0: 74 72 65 65 20 68 61 6e 64 6c 65 20 70 20 6d 61 tree handle p ma
23b0: 79 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b 20 y obtain a lock
23c0: 6f 66 20 74 79 70 65 20 65 4c 6f 63 6b 20 0a 2a of type eLock .*
23d0: 2a 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 * (READ_LOCK or
23e0: 57 52 49 54 45 5f 4c 4f 43 4b 29 20 6f 6e 20 74 WRITE_LOCK) on t
23f0: 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f he table with ro
2400: 6f 74 2d 70 61 67 65 20 69 54 61 62 2e 20 52 65 ot-page iTab. Re
2410: 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f turn.** SQLITE_O
2420: 4b 20 69 66 20 74 68 65 20 6c 6f 63 6b 20 6d 61 K if the lock ma
2430: 79 20 62 65 20 6f 62 74 61 69 6e 65 64 20 28 62 y be obtained (b
2440: 79 20 63 61 6c 6c 69 6e 67 0a 2a 2a 20 73 65 74 y calling.** set
2450: 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 SharedCacheTable
2460: 4c 6f 63 6b 28 29 29 2c 20 6f 72 20 53 51 4c 49 Lock()), or SQLI
2470: 54 45 5f 4c 4f 43 4b 45 44 20 69 66 20 6e 6f 74 TE_LOCKED if not
2480: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
2490: 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 querySharedCache
24a0: 54 61 62 6c 65 4c 6f 63 6b 28 42 74 72 65 65 20 TableLock(Btree
24b0: 2a 70 2c 20 50 67 6e 6f 20 69 54 61 62 2c 20 75 *p, Pgno iTab, u
24c0: 38 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 68 8 eLock){. BtSh
24d0: 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
24e0: 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 49 Bt;. BtLock *pI
24f0: 74 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ter;.. assert(
2500: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 sqlite3BtreeHold
2510: 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 61 sMutex(p) );. a
2520: 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d 52 45 ssert( eLock==RE
2530: 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b AD_LOCK || eLock
2540: 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a ==WRITE_LOCK );.
2550: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64 62 21 assert( p->db!
2560: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
2570: 21 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 !(p->db->flags&S
2580: 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d QLITE_ReadUncomm
2590: 69 74 29 7c 7c 65 4c 6f 63 6b 3d 3d 57 52 49 54 it)||eLock==WRIT
25a0: 45 5f 4c 4f 43 4b 7c 7c 69 54 61 62 3d 3d 31 20 E_LOCK||iTab==1
25b0: 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 20 72 65 );. . /* If re
25c0: 71 75 65 73 74 69 6e 67 20 61 20 77 72 69 74 65 questing a write
25d0: 2d 6c 6f 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 -lock, then the
25e0: 42 74 72 65 65 20 6d 75 73 74 20 68 61 76 65 20 Btree must have
25f0: 61 6e 20 6f 70 65 6e 20 77 72 69 74 65 0a 20 20 an open write.
2600: 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f ** transaction o
2610: 6e 20 74 68 69 73 20 66 69 6c 65 2e 20 41 6e 64 n this file. And
2620: 2c 20 6f 62 76 69 6f 75 73 6c 79 2c 20 66 6f 72 , obviously, for
2630: 20 74 68 69 73 20 74 6f 20 62 65 20 73 6f 20 74 this to be so t
2640: 68 65 72 65 20 0a 20 20 2a 2a 20 6d 75 73 74 20 here . ** must
2650: 62 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 74 65 be an open write
2660: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 transaction on
2670: 74 68 65 20 66 69 6c 65 20 69 74 73 65 6c 66 2e the file itself.
2680: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
2690: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
26a0: 20 7c 7c 20 28 70 3d 3d 70 42 74 2d 3e 70 57 72 || (p==pBt->pWr
26b0: 69 74 65 72 20 26 26 20 70 2d 3e 69 6e 54 72 61 iter && p->inTra
26c0: 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 29 ns==TRANS_WRITE)
26d0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4c );. assert( eL
26e0: 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c ock==READ_LOCK |
26f0: 7c 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 | pBt->inTransac
2700: 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 tion==TRANS_WRIT
2710: 45 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 54 68 69 E );. . /* Thi
2720: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e s routine is a n
2730: 6f 2d 6f 70 20 69 66 20 74 68 65 20 73 68 61 72 o-op if the shar
2740: 65 64 2d 63 61 63 68 65 20 69 73 20 6e 6f 74 20 ed-cache is not
2750: 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 69 66 28 enabled */. if(
2760: 20 21 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b !p->sharable ){
2770: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
2780: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a TE_OK;. }.. /*
2790: 20 49 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 63 If some other c
27a0: 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f 6c onnection is hol
27b0: 64 69 6e 67 20 61 6e 20 65 78 63 6c 75 73 69 76 ding an exclusiv
27c0: 65 20 6c 6f 63 6b 2c 20 74 68 65 0a 20 20 2a 2a e lock, the. **
27d0: 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 requested lock
27e0: 6d 61 79 20 6e 6f 74 20 62 65 20 6f 62 74 61 69 may not be obtai
27f0: 6e 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ned.. */. if(
2800: 70 42 74 2d 3e 70 57 72 69 74 65 72 21 3d 70 20 pBt->pWriter!=p
2810: 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 && (pBt->btsFlag
2820: 73 20 26 20 42 54 53 5f 45 58 43 4c 55 53 49 56 s & BTS_EXCLUSIV
2830: 45 29 21 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c E)!=0 ){. sql
2840: 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c ite3ConnectionBl
2850: 6f 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 42 74 ocked(p->db, pBt
2860: 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 29 3b 0a ->pWriter->db);.
2870: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2880: 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 E_LOCKED_SHAREDC
2890: 41 43 48 45 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 ACHE;. }.. for
28a0: 28 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 (pIter=pBt->pLoc
28b0: 6b 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d k; pIter; pIter=
28c0: 70 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 pIter->pNext){.
28d0: 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e 64 69 74 /* The condit
28e0: 69 6f 6e 20 28 70 49 74 65 72 2d 3e 65 4c 6f 63 ion (pIter->eLoc
28f0: 6b 21 3d 65 4c 6f 63 6b 29 20 69 6e 20 74 68 65 k!=eLock) in the
2900: 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 66 28 2e 2e following if(..
2910: 2e 29 20 0a 20 20 20 20 2a 2a 20 73 74 61 74 65 .) . ** state
2920: 6d 65 6e 74 20 69 73 20 61 20 73 69 6d 70 6c 69 ment is a simpli
2930: 66 69 63 61 74 69 6f 6e 20 6f 66 3a 0a 20 20 20 fication of:.
2940: 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 28 65 4c **. ** (eL
2950: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 ock==WRITE_LOCK
2960: 7c 7c 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d || pIter->eLock=
2970: 3d 57 52 49 54 45 5f 4c 4f 43 4b 29 0a 20 20 20 =WRITE_LOCK).
2980: 20 2a 2a 0a 20 20 20 20 2a 2a 20 73 69 6e 63 65 **. ** since
2990: 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 69 66 we know that if
29a0: 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f eLock==WRITE_LO
29b0: 43 4b 2c 20 74 68 65 6e 20 6e 6f 20 6f 74 68 65 CK, then no othe
29c0: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 20 20 20 r connection.
29d0: 20 2a 2a 20 6d 61 79 20 68 6f 6c 64 20 61 20 57 ** may hold a W
29e0: 52 49 54 45 5f 4c 4f 43 4b 20 6f 6e 20 61 6e 79 RITE_LOCK on any
29f0: 20 74 61 62 6c 65 20 69 6e 20 74 68 69 73 20 66 table in this f
2a00: 69 6c 65 20 28 73 69 6e 63 65 20 74 68 65 72 65 ile (since there
2a10: 20 63 61 6e 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 can. ** only
2a20: 20 62 65 20 61 20 73 69 6e 67 6c 65 20 77 72 69 be a single wri
2a30: 74 65 72 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ter).. */.
2a40: 20 61 73 73 65 72 74 28 20 70 49 74 65 72 2d 3e assert( pIter->
2a50: 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b eLock==READ_LOCK
2a60: 20 7c 7c 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b || pIter->eLock
2a70: 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a ==WRITE_LOCK );.
2a80: 20 20 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 assert( eLoc
2a90: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
2aa0: 70 49 74 65 72 2d 3e 70 42 74 72 65 65 3d 3d 70 pIter->pBtree==p
2ab0: 20 7c 7c 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b || pIter->eLock
2ac0: 3d 3d 52 45 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 ==READ_LOCK);.
2ad0: 20 20 69 66 28 20 70 49 74 65 72 2d 3e 70 42 74 if( pIter->pBt
2ae0: 72 65 65 21 3d 70 20 26 26 20 70 49 74 65 72 2d ree!=p && pIter-
2af0: 3e 69 54 61 62 6c 65 3d 3d 69 54 61 62 20 26 26 >iTable==iTab &&
2b00: 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 pIter->eLock!=e
2b10: 4c 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 73 71 Lock ){. sq
2b20: 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 lite3ConnectionB
2b30: 6c 6f 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 49 locked(p->db, pI
2b40: 74 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 29 ter->pBtree->db)
2b50: 3b 0a 20 20 20 20 20 20 69 66 28 20 65 4c 6f 63 ;. if( eLoc
2b60: 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 29 7b k==WRITE_LOCK ){
2b70: 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
2b80: 20 70 3d 3d 70 42 74 2d 3e 70 57 72 69 74 65 72 p==pBt->pWriter
2b90: 20 29 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d );. pBt-
2ba0: 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
2bb0: 5f 50 45 4e 44 49 4e 47 3b 0a 20 20 20 20 20 20 _PENDING;.
2bc0: 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 }. return S
2bd0: 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 QLITE_LOCKED_SHA
2be0: 52 45 44 43 41 43 48 45 3b 0a 20 20 20 20 7d 0a REDCACHE;. }.
2bf0: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
2c00: 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 ITE_OK;.}.#endif
2c10: 20 2f 2a 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 /* !SQLITE_OMIT
2c20: 5f 53 48 41 52 45 44 5f 43 41 43 48 45 20 2a 2f _SHARED_CACHE */
2c30: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
2c40: 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
2c50: 48 45 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6c HE./*.** Add a l
2c60: 6f 63 6b 20 6f 6e 20 74 68 65 20 74 61 62 6c 65 ock on the table
2c70: 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 with root-page
2c80: 69 54 61 62 6c 65 20 74 6f 20 74 68 65 20 73 68 iTable to the sh
2c90: 61 72 65 64 2d 62 74 72 65 65 20 75 73 65 64 0a ared-btree used.
2ca0: 2a 2a 20 62 79 20 42 74 72 65 65 20 68 61 6e 64 ** by Btree hand
2cb0: 6c 65 20 70 2e 20 50 61 72 61 6d 65 74 65 72 20 le p. Parameter
2cc0: 65 4c 6f 63 6b 20 6d 75 73 74 20 62 65 20 65 69 eLock must be ei
2cd0: 74 68 65 72 20 52 45 41 44 5f 4c 4f 43 4b 20 6f ther READ_LOCK o
2ce0: 72 20 0a 2a 2a 20 57 52 49 54 45 5f 4c 4f 43 4b r .** WRITE_LOCK
2cf0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
2d00: 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 20 74 68 ction assumes th
2d10: 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a e following:.**.
2d20: 2a 2a 20 20 20 28 61 29 20 54 68 65 20 73 70 65 ** (a) The spe
2d30: 63 69 66 69 65 64 20 42 74 72 65 65 20 6f 62 6a cified Btree obj
2d40: 65 63 74 20 70 20 69 73 20 63 6f 6e 6e 65 63 74 ect p is connect
2d50: 65 64 20 74 6f 20 61 20 73 68 61 72 61 62 6c 65 ed to a sharable
2d60: 0a 2a 2a 20 20 20 20 20 20 20 64 61 74 61 62 61 .** databa
2d70: 73 65 20 28 6f 6e 65 20 77 69 74 68 20 74 68 65 se (one with the
2d80: 20 42 74 53 68 61 72 65 64 2e 73 68 61 72 61 62 BtShared.sharab
2d90: 6c 65 20 66 6c 61 67 20 73 65 74 29 2c 20 61 6e le flag set), an
2da0: 64 0a 2a 2a 0a 2a 2a 20 20 20 28 62 29 20 4e 6f d.**.** (b) No
2db0: 20 6f 74 68 65 72 20 42 74 72 65 65 20 6f 62 6a other Btree obj
2dc0: 65 63 74 73 20 68 6f 6c 64 20 61 20 6c 6f 63 6b ects hold a lock
2dd0: 20 74 68 61 74 20 63 6f 6e 66 6c 69 63 74 73 0a that conflicts.
2de0: 2a 2a 20 20 20 20 20 20 20 77 69 74 68 20 74 68 ** with th
2df0: 65 20 72 65 71 75 65 73 74 65 64 20 6c 6f 63 6b e requested lock
2e00: 20 28 69 2e 65 2e 20 71 75 65 72 79 53 68 61 72 (i.e. queryShar
2e10: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
2e20: 28 29 20 68 61 73 0a 2a 2a 20 20 20 20 20 20 20 () has.**
2e30: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 61 6c already been cal
2e40: 6c 65 64 20 61 6e 64 20 72 65 74 75 72 6e 65 64 led and returned
2e50: 20 53 51 4c 49 54 45 5f 4f 4b 29 2e 0a 2a 2a 0a SQLITE_OK)..**.
2e60: 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 ** SQLITE_OK is
2e70: 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 65 20 returned if the
2e80: 6c 6f 63 6b 20 69 73 20 61 64 64 65 64 20 73 75 lock is added su
2e90: 63 63 65 73 73 66 75 6c 6c 79 2e 20 53 51 4c 49 ccessfully. SQLI
2ea0: 54 45 5f 4e 4f 4d 45 4d 20 0a 2a 2a 20 69 73 20 TE_NOMEM .** is
2eb0: 72 65 74 75 72 6e 65 64 20 69 66 20 61 20 6d 61 returned if a ma
2ec0: 6c 6c 6f 63 20 61 74 74 65 6d 70 74 20 66 61 69 lloc attempt fai
2ed0: 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ls..*/.static in
2ee0: 74 20 73 65 74 53 68 61 72 65 64 43 61 63 68 65 t setSharedCache
2ef0: 54 61 62 6c 65 4c 6f 63 6b 28 42 74 72 65 65 20 TableLock(Btree
2f00: 2a 70 2c 20 50 67 6e 6f 20 69 54 61 62 6c 65 2c *p, Pgno iTable,
2f10: 20 75 38 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 u8 eLock){. Bt
2f20: 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
2f30: 3e 70 42 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a >pBt;. BtLock *
2f40: 70 4c 6f 63 6b 20 3d 20 30 3b 0a 20 20 42 74 4c pLock = 0;. BtL
2f50: 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 0a 20 20 61 ock *pIter;.. a
2f60: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 ssert( sqlite3Bt
2f70: 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 reeHoldsMutex(p)
2f80: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 4c );. assert( eL
2f90: 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c ock==READ_LOCK |
2fa0: 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c | eLock==WRITE_L
2fb0: 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 OCK );. assert(
2fc0: 20 70 2d 3e 64 62 21 3d 30 20 29 3b 0a 0a 20 20 p->db!=0 );..
2fd0: 2f 2a 20 41 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 /* A connection
2fe0: 77 69 74 68 20 74 68 65 20 72 65 61 64 2d 75 6e with the read-un
2ff0: 63 6f 6d 6d 69 74 74 65 64 20 66 6c 61 67 20 73 committed flag s
3000: 65 74 20 77 69 6c 6c 20 6e 65 76 65 72 20 74 72 et will never tr
3010: 79 20 74 6f 0a 20 20 2a 2a 20 6f 62 74 61 69 6e y to. ** obtain
3020: 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 75 73 69 a read-lock usi
3030: 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ng this function
3040: 2e 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 64 2d . The only read-
3050: 6c 6f 63 6b 20 6f 62 74 61 69 6e 65 64 0a 20 20 lock obtained.
3060: 2a 2a 20 62 79 20 61 20 63 6f 6e 6e 65 63 74 69 ** by a connecti
3070: 6f 6e 20 69 6e 20 72 65 61 64 2d 75 6e 63 6f 6d on in read-uncom
3080: 6d 69 74 74 65 64 20 6d 6f 64 65 20 69 73 20 6f mitted mode is o
3090: 6e 20 74 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 n the sqlite_mas
30a0: 74 65 72 20 0a 20 20 2a 2a 20 74 61 62 6c 65 2c ter . ** table,
30b0: 20 61 6e 64 20 74 68 61 74 20 6c 6f 63 6b 20 69 and that lock i
30c0: 73 20 6f 62 74 61 69 6e 65 64 20 69 6e 20 42 74 s obtained in Bt
30d0: 72 65 65 42 65 67 69 6e 54 72 61 6e 73 28 29 2e reeBeginTrans().
30e0: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 30 */. assert( 0
30f0: 3d 3d 28 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 ==(p->db->flags&
3100: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d SQLITE_ReadUncom
3110: 6d 69 74 29 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 mit) || eLock==W
3120: 52 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 RITE_LOCK );..
3130: 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e /* This function
3140: 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 should only be
3150: 63 61 6c 6c 65 64 20 6f 6e 20 61 20 73 68 61 72 called on a shar
3160: 61 62 6c 65 20 62 2d 74 72 65 65 20 61 66 74 65 able b-tree afte
3170: 72 20 69 74 20 0a 20 20 2a 2a 20 68 61 73 20 62 r it . ** has b
3180: 65 65 6e 20 64 65 74 65 72 6d 69 6e 65 64 20 74 een determined t
3190: 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 62 2d 74 hat no other b-t
31a0: 72 65 65 20 68 6f 6c 64 73 20 61 20 63 6f 6e 66 ree holds a conf
31b0: 6c 69 63 74 69 6e 67 20 6c 6f 63 6b 2e 20 20 2a licting lock. *
31c0: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 73 /. assert( p->s
31d0: 68 61 72 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 harable );. ass
31e0: 65 72 74 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d ert( SQLITE_OK==
31f0: 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 querySharedCache
3200: 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 TableLock(p, iTa
3210: 62 6c 65 2c 20 65 4c 6f 63 6b 29 20 29 3b 0a 0a ble, eLock) );..
3220: 20 20 2f 2a 20 46 69 72 73 74 20 73 65 61 72 63 /* First searc
3230: 68 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 61 h the list for a
3240: 6e 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 6b 20 n existing lock
3250: 6f 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a on this table. *
3260: 2f 0a 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 /. for(pIter=pB
3270: 74 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b t->pLock; pIter;
3280: 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e pIter=pIter->pN
3290: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49 ext){. if( pI
32a0: 74 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 ter->iTable==iTa
32b0: 62 6c 65 20 26 26 20 70 49 74 65 72 2d 3e 70 42 ble && pIter->pB
32c0: 74 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 tree==p ){.
32d0: 20 70 4c 6f 63 6b 20 3d 20 70 49 74 65 72 3b 0a pLock = pIter;.
32e0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
32f0: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 }. }.. /* If
3300: 74 68 65 20 61 62 6f 76 65 20 73 65 61 72 63 68 the above search
3310: 20 64 69 64 20 6e 6f 74 20 66 69 6e 64 20 61 20 did not find a
3320: 42 74 4c 6f 63 6b 20 73 74 72 75 63 74 20 61 73 BtLock struct as
3330: 73 6f 63 69 61 74 69 6e 67 20 42 74 72 65 65 20 sociating Btree
3340: 70 0a 20 20 2a 2a 20 77 69 74 68 20 74 61 62 6c p. ** with tabl
3350: 65 20 69 54 61 62 6c 65 2c 20 61 6c 6c 6f 63 61 e iTable, alloca
3360: 74 65 20 6f 6e 65 20 61 6e 64 20 6c 69 6e 6b 20 te one and link
3370: 69 74 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 it into the list
3380: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 4c .. */. if( !pL
3390: 6f 63 6b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b ock ){. pLock
33a0: 20 3d 20 28 42 74 4c 6f 63 6b 20 2a 29 73 71 6c = (BtLock *)sql
33b0: 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 ite3MallocZero(s
33c0: 69 7a 65 6f 66 28 42 74 4c 6f 63 6b 29 29 3b 0a izeof(BtLock));.
33d0: 20 20 20 20 69 66 28 20 21 70 4c 6f 63 6b 20 29 if( !pLock )
33e0: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
33f0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
3400: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4c 6f 63 ;. }. pLoc
3410: 6b 2d 3e 69 54 61 62 6c 65 20 3d 20 69 54 61 62 k->iTable = iTab
3420: 6c 65 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 70 le;. pLock->p
3430: 42 74 72 65 65 20 3d 20 70 3b 0a 20 20 20 20 70 Btree = p;. p
3440: 4c 6f 63 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 42 Lock->pNext = pB
3450: 74 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 20 70 42 t->pLock;. pB
3460: 74 2d 3e 70 4c 6f 63 6b 20 3d 20 70 4c 6f 63 6b t->pLock = pLock
3470: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 74 20 ;. }.. /* Set
3480: 74 68 65 20 42 74 4c 6f 63 6b 2e 65 4c 6f 63 6b the BtLock.eLock
3490: 20 76 61 72 69 61 62 6c 65 20 74 6f 20 74 68 65 variable to the
34a0: 20 6d 61 78 69 6d 75 6d 20 6f 66 20 74 68 65 20 maximum of the
34b0: 63 75 72 72 65 6e 74 20 6c 6f 63 6b 0a 20 20 2a current lock. *
34c0: 2a 20 61 6e 64 20 74 68 65 20 72 65 71 75 65 73 * and the reques
34d0: 74 65 64 20 6c 6f 63 6b 2e 20 54 68 69 73 20 6d ted lock. This m
34e0: 65 61 6e 73 20 69 66 20 61 20 77 72 69 74 65 2d eans if a write-
34f0: 6c 6f 63 6b 20 77 61 73 20 61 6c 72 65 61 64 79 lock was already
3500: 20 68 65 6c 64 0a 20 20 2a 2a 20 61 6e 64 20 61 held. ** and a
3510: 20 72 65 61 64 2d 6c 6f 63 6b 20 72 65 71 75 65 read-lock reque
3520: 73 74 65 64 2c 20 77 65 20 64 6f 6e 27 74 20 69 sted, we don't i
3530: 6e 63 6f 72 72 65 63 74 6c 79 20 64 6f 77 6e 67 ncorrectly downg
3540: 72 61 64 65 20 74 68 65 20 6c 6f 63 6b 2e 0a 20 rade the lock..
3550: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 57 52 */. assert( WR
3560: 49 54 45 5f 4c 4f 43 4b 3e 52 45 41 44 5f 4c 4f ITE_LOCK>READ_LO
3570: 43 4b 20 29 3b 0a 20 20 69 66 28 20 65 4c 6f 63 CK );. if( eLoc
3580: 6b 3e 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 29 k>pLock->eLock )
3590: 7b 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 65 4c 6f {. pLock->eLo
35a0: 63 6b 20 3d 20 65 4c 6f 63 6b 3b 0a 20 20 7d 0a ck = eLock;. }.
35b0: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
35c0: 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a _OK;.}.#endif /*
35d0: 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 !SQLITE_OMIT_SH
35e0: 41 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 ARED_CACHE */..#
35f0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
3600: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
3610: 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 6c /*.** Release al
3620: 6c 20 74 68 65 20 74 61 62 6c 65 20 6c 6f 63 6b l the table lock
3630: 73 20 28 6c 6f 63 6b 73 20 6f 62 74 61 69 6e 65 s (locks obtaine
3640: 64 20 76 69 61 20 63 61 6c 6c 73 20 74 6f 0a 2a d via calls to.*
3650: 2a 20 74 68 65 20 73 65 74 53 68 61 72 65 64 43 * the setSharedC
3660: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 20 acheTableLock()
3670: 70 72 6f 63 65 64 75 72 65 29 20 68 65 6c 64 20 procedure) held
3680: 62 79 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 by Btree object
3690: 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 p..**.** This fu
36a0: 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 20 74 nction assumes t
36b0: 68 61 74 20 42 74 72 65 65 20 70 20 68 61 73 20 hat Btree p has
36c0: 61 6e 20 6f 70 65 6e 20 72 65 61 64 20 6f 72 20 an open read or
36d0: 77 72 69 74 65 20 0a 2a 2a 20 74 72 61 6e 73 61 write .** transa
36e0: 63 74 69 6f 6e 2e 20 49 66 20 69 74 20 64 6f 65 ction. If it doe
36f0: 73 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 20 s not, then the
3700: 42 54 53 5f 50 45 4e 44 49 4e 47 20 66 6c 61 67 BTS_PENDING flag
3710: 0a 2a 2a 20 6d 61 79 20 62 65 20 69 6e 63 6f 72 .** may be incor
3720: 72 65 63 74 6c 79 20 63 6c 65 61 72 65 64 2e 0a rectly cleared..
3730: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 */.static void c
3740: 6c 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 learAllSharedCac
3750: 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 74 72 heTableLocks(Btr
3760: 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 ee *p){. BtShar
3770: 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
3780: 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 2a 70 70 49 ;. BtLock **ppI
3790: 74 65 72 20 3d 20 26 70 42 74 2d 3e 70 4c 6f 63 ter = &pBt->pLoc
37a0: 6b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 k;.. assert( sq
37b0: 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d lite3BtreeHoldsM
37c0: 75 74 65 78 28 70 29 20 29 3b 0a 20 20 61 73 73 utex(p) );. ass
37d0: 65 72 74 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 ert( p->sharable
37e0: 20 7c 7c 20 30 3d 3d 2a 70 70 49 74 65 72 20 29 || 0==*ppIter )
37f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 ;. assert( p->i
3800: 6e 54 72 61 6e 73 3e 30 20 29 3b 0a 0a 20 20 77 nTrans>0 );.. w
3810: 68 69 6c 65 28 20 2a 70 70 49 74 65 72 20 29 7b hile( *ppIter ){
3820: 0a 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f . BtLock *pLo
3830: 63 6b 20 3d 20 2a 70 70 49 74 65 72 3b 0a 20 20 ck = *ppIter;.
3840: 20 20 61 73 73 65 72 74 28 20 28 70 42 74 2d 3e assert( (pBt->
3850: 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 45 btsFlags & BTS_E
3860: 58 43 4c 55 53 49 56 45 29 3d 3d 30 20 7c 7c 20 XCLUSIVE)==0 ||
3870: 70 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d 70 4c pBt->pWriter==pL
3880: 6f 63 6b 2d 3e 70 42 74 72 65 65 20 29 3b 0a 20 ock->pBtree );.
3890: 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b assert( pLock
38a0: 2d 3e 70 42 74 72 65 65 2d 3e 69 6e 54 72 61 6e ->pBtree->inTran
38b0: 73 3e 3d 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 s>=pLock->eLock
38c0: 29 3b 0a 20 20 20 20 69 66 28 20 70 4c 6f 63 6b );. if( pLock
38d0: 2d 3e 70 42 74 72 65 65 3d 3d 70 20 29 7b 0a 20 ->pBtree==p ){.
38e0: 20 20 20 20 20 2a 70 70 49 74 65 72 20 3d 20 70 *ppIter = p
38f0: 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 Lock->pNext;.
3900: 20 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b assert( pLock
3910: 2d 3e 69 54 61 62 6c 65 21 3d 31 20 7c 7c 20 70 ->iTable!=1 || p
3920: 4c 6f 63 6b 3d 3d 26 70 2d 3e 6c 6f 63 6b 20 29 Lock==&p->lock )
3930: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4c 6f 63 ;. if( pLoc
3940: 6b 2d 3e 69 54 61 62 6c 65 21 3d 31 20 29 7b 0a k->iTable!=1 ){.
3950: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
3960: 66 72 65 65 28 70 4c 6f 63 6b 29 3b 0a 20 20 20 free(pLock);.
3970: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
3980: 20 20 20 20 20 20 70 70 49 74 65 72 20 3d 20 26 ppIter = &
3990: 70 4c 6f 63 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 pLock->pNext;.
39a0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 }. }.. asser
39b0: 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 t( (pBt->btsFlag
39c0: 73 20 26 20 42 54 53 5f 50 45 4e 44 49 4e 47 29 s & BTS_PENDING)
39d0: 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e 70 57 72 69 ==0 || pBt->pWri
39e0: 74 65 72 20 29 3b 0a 20 20 69 66 28 20 70 42 74 ter );. if( pBt
39f0: 2d 3e 70 57 72 69 74 65 72 3d 3d 70 20 29 7b 0a ->pWriter==p ){.
3a00: 20 20 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 pBt->pWriter
3a10: 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d 3e 62 = 0;. pBt->b
3a20: 74 73 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 53 tsFlags &= ~(BTS
3a30: 5f 45 58 43 4c 55 53 49 56 45 7c 42 54 53 5f 50 _EXCLUSIVE|BTS_P
3a40: 45 4e 44 49 4e 47 29 3b 0a 20 20 7d 65 6c 73 65 ENDING);. }else
3a50: 20 69 66 28 20 70 42 74 2d 3e 6e 54 72 61 6e 73 if( pBt->nTrans
3a60: 61 63 74 69 6f 6e 3d 3d 32 20 29 7b 0a 20 20 20 action==2 ){.
3a70: 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f /* This functio
3a80: 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e n is called when
3a90: 20 42 74 72 65 65 20 70 20 69 73 20 63 6f 6e 63 Btree p is conc
3aa0: 6c 75 64 69 6e 67 20 69 74 73 20 0a 20 20 20 20 luding its .
3ab0: 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ** transaction.
3ac0: 49 66 20 74 68 65 72 65 20 63 75 72 72 65 6e 74 If there current
3ad0: 6c 79 20 65 78 69 73 74 73 20 61 20 77 72 69 74 ly exists a writ
3ae0: 65 72 2c 20 61 6e 64 20 70 20 69 73 20 6e 6f 74 er, and p is not
3af0: 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 77 72 69 . ** that wri
3b00: 74 65 72 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 ter, then the nu
3b10: 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 68 65 mber of locks he
3b20: 6c 64 20 62 79 20 63 6f 6e 6e 65 63 74 69 6f 6e ld by connection
3b30: 73 20 6f 74 68 65 72 0a 20 20 20 20 2a 2a 20 74 s other. ** t
3b40: 68 61 6e 20 74 68 65 20 77 72 69 74 65 72 20 6d han the writer m
3b50: 75 73 74 20 62 65 20 61 62 6f 75 74 20 74 6f 20 ust be about to
3b60: 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2e 20 49 6e drop to zero. In
3b70: 20 74 68 69 73 20 63 61 73 65 0a 20 20 20 20 2a this case. *
3b80: 2a 20 73 65 74 20 74 68 65 20 42 54 53 5f 50 45 * set the BTS_PE
3b90: 4e 44 49 4e 47 20 66 6c 61 67 20 74 6f 20 30 2e NDING flag to 0.
3ba0: 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 . **. ** I
3bb0: 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 63 f there is not c
3bc0: 75 72 72 65 6e 74 6c 79 20 61 20 77 72 69 74 65 urrently a write
3bd0: 72 2c 20 74 68 65 6e 20 42 54 53 5f 50 45 4e 44 r, then BTS_PEND
3be0: 49 4e 47 20 6d 75 73 74 0a 20 20 20 20 2a 2a 20 ING must. **
3bf0: 62 65 20 7a 65 72 6f 20 61 6c 72 65 61 64 79 2e be zero already.
3c00: 20 53 6f 20 74 68 69 73 20 6e 65 78 74 20 6c 69 So this next li
3c10: 6e 65 20 69 73 20 68 61 72 6d 6c 65 73 73 20 69 ne is harmless i
3c20: 6e 20 74 68 61 74 20 63 61 73 65 2e 0a 20 20 20 n that case..
3c30: 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 */. pBt->bts
3c40: 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f 50 45 Flags &= ~BTS_PE
3c50: 4e 44 49 4e 47 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a NDING;. }.}../*
3c60: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
3c70: 6e 20 63 68 61 6e 67 65 73 20 61 6c 6c 20 77 72 n changes all wr
3c80: 69 74 65 2d 6c 6f 63 6b 73 20 68 65 6c 64 20 62 ite-locks held b
3c90: 79 20 42 74 72 65 65 20 70 20 69 6e 74 6f 20 72 y Btree p into r
3ca0: 65 61 64 2d 6c 6f 63 6b 73 2e 0a 2a 2f 0a 73 74 ead-locks..*/.st
3cb0: 61 74 69 63 20 76 6f 69 64 20 64 6f 77 6e 67 72 atic void downgr
3cc0: 61 64 65 41 6c 6c 53 68 61 72 65 64 43 61 63 68 adeAllSharedCach
3cd0: 65 54 61 62 6c 65 4c 6f 63 6b 73 28 42 74 72 65 eTableLocks(Btre
3ce0: 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
3cf0: 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
3d00: 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 57 72 69 . if( pBt->pWri
3d10: 74 65 72 3d 3d 70 20 29 7b 0a 20 20 20 20 42 74 ter==p ){. Bt
3d20: 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 3b 0a 20 20 20 Lock *pLock;.
3d30: 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 3d 20 pBt->pWriter =
3d40: 30 3b 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 0;. pBt->btsF
3d50: 6c 61 67 73 20 26 3d 20 7e 28 42 54 53 5f 45 58 lags &= ~(BTS_EX
3d60: 43 4c 55 53 49 56 45 7c 42 54 53 5f 50 45 4e 44 CLUSIVE|BTS_PEND
3d70: 49 4e 47 29 3b 0a 20 20 20 20 66 6f 72 28 70 4c ING);. for(pL
3d80: 6f 63 6b 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 ock=pBt->pLock;
3d90: 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b 3d 70 4c 6f pLock; pLock=pLo
3da0: 63 6b 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 ck->pNext){.
3db0: 20 20 61 73 73 65 72 74 28 20 70 4c 6f 63 6b 2d assert( pLock-
3dc0: 3e 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 >eLock==READ_LOC
3dd0: 4b 20 7c 7c 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 K || pLock->pBtr
3de0: 65 65 3d 3d 70 20 29 3b 0a 20 20 20 20 20 20 70 ee==p );. p
3df0: 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 52 45 Lock->eLock = RE
3e00: 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 7d 0a 20 AD_LOCK;. }.
3e10: 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 }.}..#endif /*
3e20: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
3e30: 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 73 74 61 ED_CACHE */..sta
3e40: 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 tic void release
3e50: 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 Page(MemPage *pP
3e60: 61 67 65 29 3b 20 20 20 20 20 20 20 20 20 2f 2a age); /*
3e70: 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 6e Forward referen
3e80: 63 65 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 ce */.static voi
3e90: 64 20 72 65 6c 65 61 73 65 50 61 67 65 4f 6e 65 d releasePageOne
3ea0: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 (MemPage *pPage)
3eb0: 3b 20 20 20 20 20 20 2f 2a 20 46 6f 72 77 61 72 ; /* Forwar
3ec0: 64 20 72 65 66 65 72 65 6e 63 65 20 2a 2f 0a 73 d reference */.s
3ed0: 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 tatic void relea
3ee0: 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 4d 65 sePageNotNull(Me
3ef0: 6d 50 61 67 65 20 2a 70 50 61 67 65 29 3b 20 20 mPage *pPage);
3f00: 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 /* Forward refer
3f10: 65 6e 63 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 2a 2a ence */../*.****
3f20: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 * This routine i
3f30: 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 6f 66 s used inside of
3f40: 20 61 73 73 65 72 74 28 29 20 6f 6e 6c 79 20 2a assert() only *
3f50: 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 56 65 72 69 66 79 ***.**.** Verify
3f60: 20 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 that the cursor
3f70: 20 68 6f 6c 64 73 20 74 68 65 20 6d 75 74 65 78 holds the mutex
3f80: 20 6f 6e 20 69 74 73 20 42 74 53 68 61 72 65 64 on its BtShared
3f90: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
3fa0: 45 5f 44 45 42 55 47 0a 73 74 61 74 69 63 20 69 E_DEBUG.static i
3fb0: 6e 74 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 nt cursorHoldsMu
3fc0: 74 65 78 28 42 74 43 75 72 73 6f 72 20 2a 70 29 tex(BtCursor *p)
3fd0: 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 {. return sqlit
3fe0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 2d e3_mutex_held(p-
3ff0: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a 7d 0a >pBt->mutex);.}.
4000: 0a 2f 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 ./* Verify that
4010: 74 68 65 20 63 75 72 73 6f 72 20 61 6e 64 20 74 the cursor and t
4020: 68 65 20 42 74 53 68 61 72 65 64 20 61 67 72 65 he BtShared agre
4030: 65 20 61 62 6f 75 74 20 77 68 61 74 20 69 73 20 e about what is
4040: 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 64 the current.** d
4050: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 74 69 6f atabase connetio
4060: 6e 2e 20 54 68 69 73 20 69 73 20 69 6d 70 6f 72 n. This is impor
4070: 74 61 6e 74 20 69 6e 20 73 68 61 72 65 64 2d 63 tant in shared-c
4080: 61 63 68 65 20 6d 6f 64 65 2e 20 49 66 20 74 68 ache mode. If th
4090: 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 63 e database .** c
40a0: 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 onnection pointe
40b0: 72 73 20 67 65 74 20 6f 75 74 2d 6f 66 2d 73 79 rs get out-of-sy
40c0: 6e 63 2c 20 69 74 20 69 73 20 70 6f 73 73 69 62 nc, it is possib
40d0: 6c 65 20 66 6f 72 20 72 6f 75 74 69 6e 65 73 20 le for routines
40e0: 6c 69 6b 65 0a 2a 2a 20 62 74 72 65 65 49 6e 69 like.** btreeIni
40f0: 74 50 61 67 65 28 29 20 74 6f 20 72 65 66 65 72 tPage() to refer
4100: 65 6e 63 65 20 61 6e 20 73 74 61 6c 65 20 63 6f ence an stale co
4110: 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 nnection pointer
4120: 20 74 68 61 74 20 72 65 66 65 72 65 6e 63 65 73 that references
4130: 20 61 0a 2a 2a 20 61 20 63 6f 6e 6e 65 63 74 69 a.** a connecti
4140: 6f 6e 20 74 68 61 74 20 68 61 73 20 61 6c 72 65 on that has alre
4150: 61 64 79 20 63 6c 6f 73 65 64 2e 20 20 54 68 69 ady closed. Thi
4160: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 s routine is use
4170: 64 20 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 d inside assert(
4180: 29 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 ).** statements
4190: 6f 6e 6c 79 20 61 6e 64 20 66 6f 72 20 74 68 65 only and for the
41a0: 20 70 75 72 70 6f 73 65 20 6f 66 20 64 6f 75 62 purpose of doub
41b0: 6c 65 2d 63 68 65 63 6b 69 6e 67 20 74 68 61 74 le-checking that
41c0: 20 74 68 65 20 62 74 72 65 65 20 63 6f 64 65 0a the btree code.
41d0: 2a 2a 20 64 6f 65 73 20 6b 65 65 70 20 74 68 65 ** does keep the
41e0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
41f0: 74 69 6f 6e 20 70 6f 69 6e 74 65 72 73 20 75 70 tion pointers up
4200: 2d 74 6f 2d 64 61 74 65 2e 0a 2a 2f 0a 73 74 61 -to-date..*/.sta
4210: 74 69 63 20 69 6e 74 20 63 75 72 73 6f 72 4f 77 tic int cursorOw
4220: 6e 73 42 74 53 68 61 72 65 64 28 42 74 43 75 72 nsBtShared(BtCur
4230: 73 6f 72 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 sor *p){. asser
4240: 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 t( cursorHoldsMu
4250: 74 65 78 28 70 29 20 29 3b 0a 20 20 72 65 74 75 tex(p) );. retu
4260: 72 6e 20 28 70 2d 3e 70 42 74 72 65 65 2d 3e 64 rn (p->pBtree->d
4270: 62 3d 3d 70 2d 3e 70 42 74 2d 3e 64 62 29 3b 0a b==p->pBt->db);.
4280: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
4290: 49 6e 76 61 6c 69 64 61 74 65 20 74 68 65 20 6f Invalidate the o
42a0: 76 65 72 66 6c 6f 77 20 63 61 63 68 65 20 6f 66 verflow cache of
42b0: 20 74 68 65 20 63 75 72 73 6f 72 20 70 61 73 73 the cursor pass
42c0: 65 64 20 61 73 20 74 68 65 20 66 69 72 73 74 20 ed as the first
42d0: 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 20 6f 6e 20 argument..** on
42e0: 74 68 65 20 73 68 61 72 65 64 20 62 74 72 65 65 the shared btree
42f0: 20 73 74 72 75 63 74 75 72 65 20 70 42 74 2e 0a structure pBt..
4300: 2a 2f 0a 23 64 65 66 69 6e 65 20 69 6e 76 61 6c */.#define inval
4310: 69 64 61 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 idateOverflowCac
4320: 68 65 28 70 43 75 72 29 20 28 70 43 75 72 2d 3e he(pCur) (pCur->
4330: 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 curFlags &= ~BTC
4340: 46 5f 56 61 6c 69 64 4f 76 66 6c 29 0a 0a 2f 2a F_ValidOvfl)../*
4350: 0a 2a 2a 20 49 6e 76 61 6c 69 64 61 74 65 20 74 .** Invalidate t
4360: 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
4370: 2d 6c 69 73 74 20 63 61 63 68 65 20 66 6f 72 20 -list cache for
4380: 61 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e all cursors open
4390: 65 64 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 68 61 ed.** on the sha
43a0: 72 65 64 20 62 74 72 65 65 20 73 74 72 75 63 74 red btree struct
43b0: 75 72 65 20 70 42 74 2e 0a 2a 2f 0a 73 74 61 74 ure pBt..*/.stat
43c0: 69 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 ic void invalida
43d0: 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 63 teAllOverflowCac
43e0: 68 65 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 he(BtShared *pBt
43f0: 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 ){. BtCursor *p
4400: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
4410: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
4420: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
4430: 66 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 for(p=pBt->pCurs
4440: 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 or; p; p=p->pNex
4450: 74 29 7b 0a 20 20 20 20 69 6e 76 61 6c 69 64 61 t){. invalida
4460: 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 teOverflowCache(
4470: 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 p);. }.}..#ifnd
4480: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 ef SQLITE_OMIT_I
4490: 4e 43 52 42 4c 4f 42 0a 2f 2a 0a 2a 2a 20 54 68 NCRBLOB./*.** Th
44a0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
44b0: 61 6c 6c 65 64 20 62 65 66 6f 72 65 20 6d 6f 64 alled before mod
44c0: 69 66 79 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 ifying the conte
44d0: 6e 74 73 20 6f 66 20 61 20 74 61 62 6c 65 0a 2a nts of a table.*
44e0: 2a 20 74 6f 20 69 6e 76 61 6c 69 64 61 74 65 20 * to invalidate
44f0: 61 6e 79 20 69 6e 63 72 62 6c 6f 62 20 63 75 72 any incrblob cur
4500: 73 6f 72 73 20 74 68 61 74 20 61 72 65 20 6f 70 sors that are op
4510: 65 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 72 6f 77 en on the.** row
4520: 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 72 or one of the r
4530: 6f 77 73 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 ows being modifi
4540: 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 72 67 ed..**.** If arg
4550: 75 6d 65 6e 74 20 69 73 43 6c 65 61 72 54 61 62 ument isClearTab
4560: 6c 65 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e le is true, then
4570: 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 the entire cont
4580: 65 6e 74 73 20 6f 66 20 74 68 65 0a 2a 2a 20 74 ents of the.** t
4590: 61 62 6c 65 20 69 73 20 61 62 6f 75 74 20 74 6f able is about to
45a0: 20 62 65 20 64 65 6c 65 74 65 64 2e 20 49 6e 20 be deleted. In
45b0: 74 68 69 73 20 63 61 73 65 20 69 6e 76 61 6c 69 this case invali
45c0: 64 61 74 65 20 61 6c 6c 20 69 6e 63 72 62 6c 6f date all incrblo
45d0: 62 0a 2a 2a 20 63 75 72 73 6f 72 73 20 6f 70 65 b.** cursors ope
45e0: 6e 20 6f 6e 20 61 6e 79 20 72 6f 77 20 77 69 74 n on any row wit
45f0: 68 69 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 hin the table wi
4600: 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 70 67 6e th root-page pgn
4610: 6f 52 6f 6f 74 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 oRoot..**.** Oth
4620: 65 72 77 69 73 65 2c 20 69 66 20 61 72 67 75 6d erwise, if argum
4630: 65 6e 74 20 69 73 43 6c 65 61 72 54 61 62 6c 65 ent isClearTable
4640: 20 69 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 is false, then
4650: 74 68 65 20 72 6f 77 20 77 69 74 68 0a 2a 2a 20 the row with.**
4660: 72 6f 77 69 64 20 69 52 6f 77 20 69 73 20 62 65 rowid iRow is be
4670: 69 6e 67 20 72 65 70 6c 61 63 65 64 20 6f 72 20 ing replaced or
4680: 64 65 6c 65 74 65 64 2e 20 49 6e 20 74 68 69 73 deleted. In this
4690: 20 63 61 73 65 20 69 6e 76 61 6c 69 64 61 74 65 case invalidate
46a0: 0a 2a 2a 20 6f 6e 6c 79 20 74 68 6f 73 65 20 69 .** only those i
46b0: 6e 63 72 62 6c 6f 62 20 63 75 72 73 6f 72 73 20 ncrblob cursors
46c0: 6f 70 65 6e 20 6f 6e 20 74 68 61 74 20 73 70 65 open on that spe
46d0: 63 69 66 69 63 20 72 6f 77 2e 0a 2a 2f 0a 73 74 cific row..*/.st
46e0: 61 74 69 63 20 76 6f 69 64 20 69 6e 76 61 6c 69 atic void invali
46f0: 64 61 74 65 49 6e 63 72 62 6c 6f 62 43 75 72 73 dateIncrblobCurs
4700: 6f 72 73 28 0a 20 20 42 74 72 65 65 20 2a 70 42 ors(. Btree *pB
4710: 74 72 65 65 2c 20 20 20 20 20 20 20 20 20 20 2f tree, /
4720: 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 66 * The database f
4730: 69 6c 65 20 74 6f 20 63 68 65 63 6b 20 2a 2f 0a ile to check */.
4740: 20 20 50 67 6e 6f 20 70 67 6e 6f 52 6f 6f 74 2c Pgno pgnoRoot,
4750: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
4760: 20 74 61 62 6c 65 20 74 68 61 74 20 6d 69 67 68 table that migh
4770: 74 20 62 65 20 63 68 61 6e 67 69 6e 67 20 2a 2f t be changing */
4780: 0a 20 20 69 36 34 20 69 52 6f 77 2c 20 20 20 20 . i64 iRow,
4790: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
47a0: 65 20 72 6f 77 69 64 20 74 68 61 74 20 6d 69 67 e rowid that mig
47b0: 68 74 20 62 65 20 63 68 61 6e 67 69 6e 67 20 2a ht be changing *
47c0: 2f 0a 20 20 69 6e 74 20 69 73 43 6c 65 61 72 54 /. int isClearT
47d0: 61 62 6c 65 20 20 20 20 20 20 20 20 2f 2a 20 54 able /* T
47e0: 72 75 65 20 69 66 20 61 6c 6c 20 72 6f 77 73 20 rue if all rows
47f0: 61 72 65 20 62 65 69 6e 67 20 64 65 6c 65 74 65 are being delete
4800: 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 43 75 72 73 d */.){. BtCurs
4810: 6f 72 20 2a 70 3b 0a 20 20 69 66 28 20 70 42 74 or *p;. if( pBt
4820: 72 65 65 2d 3e 68 61 73 49 6e 63 72 62 6c 6f 62 ree->hasIncrblob
4830: 43 75 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b Cur==0 ) return;
4840: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
4850: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
4860: 78 28 70 42 74 72 65 65 29 20 29 3b 0a 20 20 70 x(pBtree) );. p
4870: 42 74 72 65 65 2d 3e 68 61 73 49 6e 63 72 62 6c Btree->hasIncrbl
4880: 6f 62 43 75 72 20 3d 20 30 3b 0a 20 20 66 6f 72 obCur = 0;. for
4890: 28 70 3d 70 42 74 72 65 65 2d 3e 70 42 74 2d 3e (p=pBtree->pBt->
48a0: 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d pCursor; p; p=p-
48b0: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 >pNext){. if(
48c0: 20 28 70 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 (p->curFlags &
48d0: 42 54 43 46 5f 49 6e 63 72 62 6c 6f 62 29 21 3d BTCF_Incrblob)!=
48e0: 30 20 29 7b 0a 20 20 20 20 20 20 70 42 74 72 65 0 ){. pBtre
48f0: 65 2d 3e 68 61 73 49 6e 63 72 62 6c 6f 62 43 75 e->hasIncrblobCu
4900: 72 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 r = 1;. if(
4910: 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 70 67 p->pgnoRoot==pg
4920: 6e 6f 52 6f 6f 74 20 26 26 20 28 69 73 43 6c 65 noRoot && (isCle
4930: 61 72 54 61 62 6c 65 20 7c 7c 20 70 2d 3e 69 6e arTable || p->in
4940: 66 6f 2e 6e 4b 65 79 3d 3d 69 52 6f 77 29 20 29 fo.nKey==iRow) )
4950: 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 {. p->eSt
4960: 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
4970: 41 4c 49 44 3b 0a 20 20 20 20 20 20 7d 0a 20 20 ALID;. }.
4980: 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6c 73 65 }. }.}..#else
4990: 0a 20 20 2f 2a 20 53 74 75 62 20 66 75 6e 63 74 . /* Stub funct
49a0: 69 6f 6e 20 77 68 65 6e 20 49 4e 43 52 42 4c 4f ion when INCRBLO
49b0: 42 20 69 73 20 6f 6d 69 74 74 65 64 20 2a 2f 0a B is omitted */.
49c0: 20 20 23 64 65 66 69 6e 65 20 69 6e 76 61 6c 69 #define invali
49d0: 64 61 74 65 49 6e 63 72 62 6c 6f 62 43 75 72 73 dateIncrblobCurs
49e0: 6f 72 73 28 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e ors(w,x,y,z).#en
49f0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
4a00: 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a 0a IT_INCRBLOB */..
4a10: 2f 2a 0a 2a 2a 20 53 65 74 20 62 69 74 20 70 67 /*.** Set bit pg
4a20: 6e 6f 20 6f 66 20 74 68 65 20 42 74 53 68 61 72 no of the BtShar
4a30: 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 ed.pHasContent b
4a40: 69 74 76 65 63 2e 20 54 68 69 73 20 69 73 20 63 itvec. This is c
4a50: 61 6c 6c 65 64 20 0a 2a 2a 20 77 68 65 6e 20 61 alled .** when a
4a60: 20 70 61 67 65 20 74 68 61 74 20 70 72 65 76 69 page that previ
4a70: 6f 75 73 6c 79 20 63 6f 6e 74 61 69 6e 65 64 20 ously contained
4a80: 64 61 74 61 20 62 65 63 6f 6d 65 73 20 61 20 66 data becomes a f
4a90: 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 0a 2a ree-list leaf .*
4aa0: 2a 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 * page..**.** Th
4ab0: 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 e BtShared.pHasC
4ac0: 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 20 65 78 ontent bitvec ex
4ad0: 69 73 74 73 20 74 6f 20 77 6f 72 6b 20 61 72 6f ists to work aro
4ae0: 75 6e 64 20 61 6e 20 6f 62 73 63 75 72 65 0a 2a und an obscure.*
4af0: 2a 20 62 75 67 20 63 61 75 73 65 64 20 62 79 20 * bug caused by
4b00: 74 68 65 20 69 6e 74 65 72 61 63 74 69 6f 6e 20 the interaction
4b10: 6f 66 20 74 77 6f 20 75 73 65 66 75 6c 20 49 4f of two useful IO
4b20: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 73 optimizations s
4b30: 75 72 72 6f 75 6e 64 69 6e 67 0a 2a 2a 20 66 72 urrounding.** fr
4b40: 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 ee-list leaf pag
4b50: 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 57 es:.**.** 1) W
4b60: 68 65 6e 20 61 6c 6c 20 64 61 74 61 20 69 73 20 hen all data is
4b70: 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 61 20 70 deleted from a p
4b80: 61 67 65 20 61 6e 64 20 74 68 65 20 70 61 67 65 age and the page
4b90: 20 62 65 63 6f 6d 65 73 0a 2a 2a 20 20 20 20 20 becomes.**
4ba0: 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 a free-list lea
4bb0: 66 20 70 61 67 65 2c 20 74 68 65 20 70 61 67 65 f page, the page
4bc0: 20 69 73 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 is not written
4bd0: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 0a to the database.
4be0: 2a 2a 20 20 20 20 20 20 28 61 73 20 66 72 65 65 ** (as free
4bf0: 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 73 -list leaf pages
4c00: 20 63 6f 6e 74 61 69 6e 20 6e 6f 20 6d 65 61 6e contain no mean
4c10: 69 6e 67 66 75 6c 20 64 61 74 61 29 2e 20 53 6f ingful data). So
4c20: 6d 65 74 69 6d 65 73 0a 2a 2a 20 20 20 20 20 20 metimes.**
4c30: 73 75 63 68 20 61 20 70 61 67 65 20 69 73 20 6e such a page is n
4c40: 6f 74 20 65 76 65 6e 20 6a 6f 75 72 6e 61 6c 6c ot even journall
4c50: 65 64 20 28 61 73 20 69 74 20 77 69 6c 6c 20 6e ed (as it will n
4c60: 6f 74 20 62 65 20 6d 6f 64 69 66 69 65 64 2c 0a ot be modified,.
4c70: 2a 2a 20 20 20 20 20 20 77 68 79 20 62 6f 74 68 ** why both
4c80: 65 72 20 6a 6f 75 72 6e 61 6c 6c 69 6e 67 20 69 er journalling i
4c90: 74 3f 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 32 29 20 t?)..**.** 2)
4ca0: 57 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 74 When a free-list
4cb0: 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 65 leaf page is re
4cc0: 75 73 65 64 2c 20 69 74 73 20 63 6f 6e 74 65 6e used, its conten
4cd0: 74 20 69 73 20 6e 6f 74 20 72 65 61 64 0a 2a 2a t is not read.**
4ce0: 20 20 20 20 20 20 66 72 6f 6d 20 74 68 65 20 64 from the d
4cf0: 61 74 61 62 61 73 65 20 6f 72 20 77 72 69 74 74 atabase or writt
4d00: 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 en to the journa
4d10: 6c 20 66 69 6c 65 20 28 77 68 79 20 73 68 6f 75 l file (why shou
4d20: 6c 64 20 69 74 0a 2a 2a 20 20 20 20 20 20 62 65 ld it.** be
4d30: 2c 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 , if it is not a
4d40: 74 20 61 6c 6c 20 6d 65 61 6e 69 6e 67 66 75 6c t all meaningful
4d50: 3f 29 2e 0a 2a 2a 0a 2a 2a 20 42 79 20 74 68 65 ?)..**.** By the
4d60: 6d 73 65 6c 76 65 73 2c 20 74 68 65 73 65 20 6f mselves, these o
4d70: 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 77 6f 72 ptimizations wor
4d80: 6b 20 66 69 6e 65 20 61 6e 64 20 70 72 6f 76 69 k fine and provi
4d90: 64 65 20 61 20 68 61 6e 64 79 0a 2a 2a 20 70 65 de a handy.** pe
4da0: 72 66 6f 72 6d 61 6e 63 65 20 62 6f 6f 73 74 20 rformance boost
4db0: 74 6f 20 62 75 6c 6b 20 64 65 6c 65 74 65 20 6f to bulk delete o
4dc0: 72 20 69 6e 73 65 72 74 20 6f 70 65 72 61 74 69 r insert operati
4dd0: 6f 6e 73 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 ons. However, if
4de0: 0a 2a 2a 20 61 20 70 61 67 65 20 69 73 20 6d 6f .** a page is mo
4df0: 76 65 64 20 74 6f 20 74 68 65 20 66 72 65 65 2d ved to the free-
4e00: 6c 69 73 74 20 61 6e 64 20 74 68 65 6e 20 72 65 list and then re
4e10: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 used within the
4e20: 73 61 6d 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 same.** transact
4e30: 69 6f 6e 2c 20 61 20 70 72 6f 62 6c 65 6d 20 63 ion, a problem c
4e40: 6f 6d 65 73 20 75 70 2e 20 49 66 20 74 68 65 20 omes up. If the
4e50: 70 61 67 65 20 69 73 20 6e 6f 74 20 6a 6f 75 72 page is not jour
4e60: 6e 61 6c 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 69 nalled when.** i
4e70: 74 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 74 68 t is moved to th
4e80: 65 20 66 72 65 65 2d 6c 69 73 74 20 61 6e 64 20 e free-list and
4e90: 69 74 20 69 73 20 61 6c 73 6f 20 6e 6f 74 20 6a it is also not j
4ea0: 6f 75 72 6e 61 6c 6c 65 64 20 77 68 65 6e 20 69 ournalled when i
4eb0: 74 0a 2a 2a 20 69 73 20 65 78 74 72 61 63 74 65 t.** is extracte
4ec0: 64 20 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d d from the free-
4ed0: 6c 69 73 74 20 61 6e 64 20 72 65 75 73 65 64 2c list and reused,
4ee0: 20 74 68 65 6e 20 74 68 65 20 6f 72 69 67 69 6e then the origin
4ef0: 61 6c 20 64 61 74 61 0a 2a 2a 20 6d 61 79 20 62 al data.** may b
4f00: 65 20 6c 6f 73 74 2e 20 49 6e 20 74 68 65 20 65 e lost. In the e
4f10: 76 65 6e 74 20 6f 66 20 61 20 72 6f 6c 6c 62 61 vent of a rollba
4f20: 63 6b 2c 20 69 74 20 6d 61 79 20 6e 6f 74 20 62 ck, it may not b
4f30: 65 20 70 6f 73 73 69 62 6c 65 0a 2a 2a 20 74 6f e possible.** to
4f40: 20 72 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 restore the dat
4f50: 61 62 61 73 65 20 74 6f 20 69 74 73 20 6f 72 69 abase to its ori
4f60: 67 69 6e 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 ginal configurat
4f70: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 ion..**.** The s
4f80: 6f 6c 75 74 69 6f 6e 20 69 73 20 74 68 65 20 42 olution is the B
4f90: 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 tShared.pHasCont
4fa0: 65 6e 74 20 62 69 74 76 65 63 2e 20 57 68 65 6e ent bitvec. When
4fb0: 65 76 65 72 20 61 20 70 61 67 65 20 69 73 20 0a ever a page is .
4fc0: 2a 2a 20 6d 6f 76 65 64 20 74 6f 20 62 65 63 6f ** moved to beco
4fd0: 6d 65 20 61 20 66 72 65 65 2d 6c 69 73 74 20 6c me a free-list l
4fe0: 65 61 66 20 70 61 67 65 2c 20 74 68 65 20 63 6f eaf page, the co
4ff0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 rresponding bit
5000: 69 73 0a 2a 2a 20 73 65 74 20 69 6e 20 74 68 65 is.** set in the
5010: 20 62 69 74 76 65 63 2e 20 57 68 65 6e 65 76 65 bitvec. Wheneve
5020: 72 20 61 20 6c 65 61 66 20 70 61 67 65 20 69 73 r a leaf page is
5030: 20 65 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 extracted from
5040: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 0a 2a the free-list,.*
5050: 2a 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 32 * optimization 2
5060: 20 61 62 6f 76 65 20 69 73 20 6f 6d 69 74 74 65 above is omitte
5070: 64 20 69 66 20 74 68 65 20 63 6f 72 72 65 73 70 d if the corresp
5080: 6f 6e 64 69 6e 67 20 62 69 74 20 69 73 20 61 6c onding bit is al
5090: 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 69 6e 20 ready.** set in
50a0: 42 74 53 68 61 72 65 64 2e 70 48 61 73 43 6f 6e BtShared.pHasCon
50b0: 74 65 6e 74 2e 20 54 68 65 20 63 6f 6e 74 65 6e tent. The conten
50c0: 74 73 20 6f 66 20 74 68 65 20 62 69 74 76 65 63 ts of the bitvec
50d0: 20 61 72 65 20 63 6c 65 61 72 65 64 0a 2a 2a 20 are cleared.**
50e0: 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 at the end of ev
50f0: 65 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ery transaction.
5100: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 .*/.static int b
5110: 74 72 65 65 53 65 74 48 61 73 43 6f 6e 74 65 6e treeSetHasConten
5120: 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c t(BtShared *pBt,
5130: 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 Pgno pgno){. i
5140: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
5150: 4b 3b 0a 20 20 69 66 28 20 21 70 42 74 2d 3e 70 K;. if( !pBt->p
5160: 48 61 73 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 HasContent ){.
5170: 20 20 61 73 73 65 72 74 28 20 70 67 6e 6f 3c 3d assert( pgno<=
5180: 70 42 74 2d 3e 6e 50 61 67 65 20 29 3b 0a 20 20 pBt->nPage );.
5190: 20 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 pBt->pHasConte
51a0: 6e 74 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 nt = sqlite3Bitv
51b0: 65 63 43 72 65 61 74 65 28 70 42 74 2d 3e 6e 50 ecCreate(pBt->nP
51c0: 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 21 70 age);. if( !p
51d0: 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 Bt->pHasContent
51e0: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
51f0: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
5200: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 . }. }. if(
5210: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
5220: 26 20 70 67 6e 6f 3c 3d 73 71 6c 69 74 65 33 42 & pgno<=sqlite3B
5230: 69 74 76 65 63 53 69 7a 65 28 70 42 74 2d 3e 70 itvecSize(pBt->p
5240: 48 61 73 43 6f 6e 74 65 6e 74 29 20 29 7b 0a 20 HasContent) ){.
5250: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
5260: 69 74 76 65 63 53 65 74 28 70 42 74 2d 3e 70 48 itvecSet(pBt->pH
5270: 61 73 43 6f 6e 74 65 6e 74 2c 20 70 67 6e 6f 29 asContent, pgno)
5280: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 ;. }. return r
5290: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 c;.}../*.** Quer
52a0: 79 20 74 68 65 20 42 74 53 68 61 72 65 64 2e 70 y the BtShared.p
52b0: 48 61 73 43 6f 6e 74 65 6e 74 20 76 65 63 74 6f HasContent vecto
52c0: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 r..**.** This fu
52d0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
52e0: 20 77 68 65 6e 20 61 20 66 72 65 65 2d 6c 69 73 when a free-lis
52f0: 74 20 6c 65 61 66 20 70 61 67 65 20 69 73 20 72 t leaf page is r
5300: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 0a emoved from the.
5310: 2a 2a 20 66 72 65 65 2d 6c 69 73 74 20 66 6f 72 ** free-list for
5320: 20 72 65 75 73 65 2e 20 49 74 20 72 65 74 75 72 reuse. It retur
5330: 6e 73 20 66 61 6c 73 65 20 69 66 20 69 74 20 69 ns false if it i
5340: 73 20 73 61 66 65 20 74 6f 20 72 65 74 72 69 65 s safe to retrie
5350: 76 65 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 66 ve the.** page f
5360: 72 6f 6d 20 74 68 65 20 70 61 67 65 72 20 6c 61 rom the pager la
5370: 79 65 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f yer with the 'no
5380: 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 -content' flag s
5390: 65 74 2e 20 54 72 75 65 20 6f 74 68 65 72 77 69 et. True otherwi
53a0: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e se..*/.static in
53b0: 74 20 62 74 72 65 65 47 65 74 48 61 73 43 6f 6e t btreeGetHasCon
53c0: 74 65 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 tent(BtShared *p
53d0: 42 74 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a Bt, Pgno pgno){.
53e0: 20 20 42 69 74 76 65 63 20 2a 70 20 3d 20 70 42 Bitvec *p = pB
53f0: 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 3b 0a t->pHasContent;.
5400: 20 20 72 65 74 75 72 6e 20 28 70 20 26 26 20 28 return (p && (
5410: 70 67 6e 6f 3e 73 71 6c 69 74 65 33 42 69 74 76 pgno>sqlite3Bitv
5420: 65 63 53 69 7a 65 28 70 29 20 7c 7c 20 73 71 6c ecSize(p) || sql
5430: 69 74 65 33 42 69 74 76 65 63 54 65 73 74 28 70 ite3BitvecTest(p
5440: 2c 20 70 67 6e 6f 29 29 29 3b 0a 7d 0a 0a 2f 2a , pgno)));.}../*
5450: 0a 2a 2a 20 43 6c 65 61 72 20 28 64 65 73 74 72 .** Clear (destr
5460: 6f 79 29 20 74 68 65 20 42 74 53 68 61 72 65 64 oy) the BtShared
5470: 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 .pHasContent bit
5480: 76 65 63 2e 20 54 68 69 73 20 73 68 6f 75 6c 64 vec. This should
5490: 20 62 65 0a 2a 2a 20 69 6e 76 6f 6b 65 64 20 61 be.** invoked a
54a0: 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e t the conclusion
54b0: 20 6f 66 20 65 61 63 68 20 77 72 69 74 65 2d 74 of each write-t
54c0: 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 ransaction..*/.s
54d0: 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
54e0: 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
54f0: 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a BtShared *pBt){.
5500: 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 sqlite3BitvecD
5510: 65 73 74 72 6f 79 28 70 42 74 2d 3e 70 48 61 73 estroy(pBt->pHas
5520: 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 70 42 74 2d Content);. pBt-
5530: 3e 70 48 61 73 43 6f 6e 74 65 6e 74 20 3d 20 30 >pHasContent = 0
5540: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 ;.}../*.** Relea
5550: 73 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 70 se all of the ap
5560: 50 61 67 65 5b 5d 20 70 61 67 65 73 20 66 6f 72 Page[] pages for
5570: 20 61 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 73 74 a cursor..*/.st
5580: 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 52 atic void btreeR
5590: 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 eleaseAllCursorP
55a0: 61 67 65 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ages(BtCursor *p
55b0: 43 75 72 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 Cur){. int i;.
55c0: 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 if( pCur->iPage
55d0: 3e 3d 30 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 >=0 ){. for(i
55e0: 3d 30 3b 20 69 3c 70 43 75 72 2d 3e 69 50 61 67 =0; i<pCur->iPag
55f0: 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 e; i++){. r
5600: 65 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c eleasePageNotNul
5610: 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 l(pCur->apPage[i
5620: 5d 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 ]);. }. re
5630: 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c leasePageNotNull
5640: 28 70 43 75 72 2d 3e 70 50 61 67 65 29 3b 0a 20 (pCur->pPage);.
5650: 20 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d pCur->iPage =
5660: 20 2d 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a -1;. }.}../*.*
5670: 2a 20 54 68 65 20 63 75 72 73 6f 72 20 70 61 73 * The cursor pas
5680: 73 65 64 20 61 73 20 74 68 65 20 6f 6e 6c 79 20 sed as the only
5690: 61 72 67 75 6d 65 6e 74 20 6d 75 73 74 20 70 6f argument must po
56a0: 69 6e 74 20 74 6f 20 61 20 76 61 6c 69 64 20 65 int to a valid e
56b0: 6e 74 72 79 0a 2a 2a 20 77 68 65 6e 20 74 68 69 ntry.** when thi
56c0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
56d0: 6c 6c 65 64 20 28 69 2e 65 2e 20 68 61 76 65 20 lled (i.e. have
56e0: 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
56f0: 41 4c 49 44 29 2e 20 54 68 69 73 0a 2a 2a 20 66 ALID). This.** f
5700: 75 6e 63 74 69 6f 6e 20 73 61 76 65 73 20 74 68 unction saves th
5710: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
5720: 20 6b 65 79 20 69 6e 20 76 61 72 69 61 62 6c 65 key in variable
5730: 73 20 70 43 75 72 2d 3e 6e 4b 65 79 20 61 6e 64 s pCur->nKey and
5740: 0a 2a 2a 20 70 43 75 72 2d 3e 70 4b 65 79 2e 20 .** pCur->pKey.
5750: 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
5760: 75 72 6e 65 64 20 69 66 20 73 75 63 63 65 73 73 urned if success
5770: 66 75 6c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 ful or an SQLite
5780: 20 65 72 72 6f 72 20 0a 2a 2a 20 63 6f 64 65 20 error .** code
5790: 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2a 0a 2a 2a otherwise..**.**
57a0: 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 If the cursor i
57b0: 73 20 6f 70 65 6e 20 6f 6e 20 61 6e 20 69 6e 74 s open on an int
57c0: 6b 65 79 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 key table, then
57d0: 74 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 0a the integer key.
57e0: 2a 2a 20 28 74 68 65 20 72 6f 77 69 64 29 20 69 ** (the rowid) i
57f0: 73 20 73 74 6f 72 65 64 20 69 6e 20 70 43 75 72 s stored in pCur
5800: 2d 3e 6e 4b 65 79 20 61 6e 64 20 70 43 75 72 2d ->nKey and pCur-
5810: 3e 70 4b 65 79 20 69 73 20 6c 65 66 74 20 73 65 >pKey is left se
5820: 74 20 74 6f 0a 2a 2a 20 4e 55 4c 4c 2e 20 49 66 t to.** NULL. If
5830: 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 6f the cursor is o
5840: 70 65 6e 20 6f 6e 20 61 20 6e 6f 6e 2d 69 6e 74 pen on a non-int
5850: 6b 65 79 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 key table, then
5860: 70 43 75 72 2d 3e 70 4b 65 79 20 69 73 20 0a 2a pCur->pKey is .*
5870: 2a 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 * set to point t
5880: 6f 20 61 20 6d 61 6c 6c 6f 63 65 64 20 62 75 66 o a malloced buf
5890: 66 65 72 20 70 43 75 72 2d 3e 6e 4b 65 79 20 62 fer pCur->nKey b
58a0: 79 74 65 73 20 69 6e 20 73 69 7a 65 20 63 6f 6e ytes in size con
58b0: 74 61 69 6e 69 6e 67 20 0a 2a 2a 20 74 68 65 20 taining .** the
58c0: 6b 65 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 key..*/.static i
58d0: 6e 74 20 73 61 76 65 43 75 72 73 6f 72 4b 65 79 nt saveCursorKey
58e0: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
58f0: 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
5900: 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 ITE_OK;. assert
5910: 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d ( CURSOR_VALID==
5920: 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 3b 0a pCur->eState );.
5930: 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70 43 75 assert( 0==pCu
5940: 72 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 61 73 73 r->pKey );. ass
5950: 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
5960: 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 0a Mutex(pCur) );..
5970: 20 20 69 66 28 20 70 43 75 72 2d 3e 63 75 72 49 if( pCur->curI
5980: 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 2f 2a 20 ntKey ){. /*
5990: 4f 6e 6c 79 20 74 68 65 20 72 6f 77 69 64 20 69 Only the rowid i
59a0: 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 61 s required for a
59b0: 20 74 61 62 6c 65 20 62 74 72 65 65 20 2a 2f 0a table btree */.
59c0: 20 20 20 20 70 43 75 72 2d 3e 6e 4b 65 79 20 3d pCur->nKey =
59d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 6e 74 sqlite3BtreeInt
59e0: 65 67 65 72 4b 65 79 28 70 43 75 72 29 3b 0a 20 egerKey(pCur);.
59f0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 46 }else{. /* F
5a00: 6f 72 20 61 6e 20 69 6e 64 65 78 20 62 74 72 65 or an index btre
5a10: 65 2c 20 73 61 76 65 20 74 68 65 20 63 6f 6d 70 e, save the comp
5a20: 6c 65 74 65 20 6b 65 79 20 63 6f 6e 74 65 6e 74 lete key content
5a30: 2e 20 49 74 20 69 73 20 70 6f 73 73 69 62 6c 65 . It is possible
5a40: 0a 20 20 20 20 2a 2a 20 74 68 61 74 20 74 68 65 . ** that the
5a50: 20 63 75 72 72 65 6e 74 20 6b 65 79 20 69 73 20 current key is
5a60: 63 6f 72 72 75 70 74 2e 20 49 6e 20 74 68 61 74 corrupt. In that
5a70: 20 63 61 73 65 2c 20 69 74 20 69 73 20 70 6f 73 case, it is pos
5a80: 73 69 62 6c 65 20 74 68 61 74 0a 20 20 20 20 2a sible that. *
5a90: 2a 20 74 68 65 20 73 71 6c 69 74 65 33 56 64 62 * the sqlite3Vdb
5aa0: 65 52 65 63 6f 72 64 55 6e 70 61 63 6b 28 29 20 eRecordUnpack()
5ab0: 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 6f 76 65 function may ove
5ac0: 72 72 65 61 64 20 74 68 65 20 62 75 66 66 65 72 rread the buffer
5ad0: 20 62 79 0a 20 20 20 20 2a 2a 20 75 70 20 74 6f by. ** up to
5ae0: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 31 20 76 the size of 1 v
5af0: 61 72 69 6e 74 20 70 6c 75 73 20 31 20 38 2d 62 arint plus 1 8-b
5b00: 79 74 65 20 76 61 6c 75 65 20 77 68 65 6e 20 74 yte value when t
5b10: 68 65 20 63 75 72 73 6f 72 20 0a 20 20 20 20 2a he cursor . *
5b20: 2a 20 70 6f 73 69 74 69 6f 6e 20 69 73 20 72 65 * position is re
5b30: 73 74 6f 72 65 64 2e 20 48 65 6e 63 65 20 74 68 stored. Hence th
5b40: 65 20 31 37 20 62 79 74 65 73 20 6f 66 20 70 61 e 17 bytes of pa
5b50: 64 64 69 6e 67 20 61 6c 6c 6f 63 61 74 65 64 20 dding allocated
5b60: 0a 20 20 20 20 2a 2a 20 62 65 6c 6f 77 2e 20 2a . ** below. *
5b70: 2f 0a 20 20 20 20 76 6f 69 64 20 2a 70 4b 65 79 /. void *pKey
5b80: 3b 0a 20 20 20 20 70 43 75 72 2d 3e 6e 4b 65 79 ;. pCur->nKey
5b90: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 = sqlite3BtreeP
5ba0: 61 79 6c 6f 61 64 53 69 7a 65 28 70 43 75 72 29 ayloadSize(pCur)
5bb0: 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20 73 71 6c ;. pKey = sql
5bc0: 69 74 65 33 4d 61 6c 6c 6f 63 28 20 70 43 75 72 ite3Malloc( pCur
5bd0: 2d 3e 6e 4b 65 79 20 2b 20 39 20 2b 20 38 20 29 ->nKey + 9 + 8 )
5be0: 3b 0a 20 20 20 20 69 66 28 20 70 4b 65 79 20 29 ;. if( pKey )
5bf0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
5c00: 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 ite3BtreePayload
5c10: 28 70 43 75 72 2c 20 30 2c 20 28 69 6e 74 29 70 (pCur, 0, (int)p
5c20: 43 75 72 2d 3e 6e 4b 65 79 2c 20 70 4b 65 79 29 Cur->nKey, pKey)
5c30: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
5c40: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
5c50: 20 20 20 20 20 6d 65 6d 73 65 74 28 28 28 75 38 memset(((u8
5c60: 2a 29 70 4b 65 79 29 2b 70 43 75 72 2d 3e 6e 4b *)pKey)+pCur->nK
5c70: 65 79 2c 20 30 2c 20 39 2b 38 29 3b 0a 20 20 20 ey, 0, 9+8);.
5c80: 20 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 pCur->pKey
5c90: 3d 20 70 4b 65 79 3b 0a 20 20 20 20 20 20 7d 65 = pKey;. }e
5ca0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71 6c lse{. sql
5cb0: 69 74 65 33 5f 66 72 65 65 28 70 4b 65 79 29 3b ite3_free(pKey);
5cc0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c . }. }el
5cd0: 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 se{. rc = S
5ce0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
5cf0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 73 ;. }. }. as
5d00: 73 65 72 74 28 20 21 70 43 75 72 2d 3e 63 75 72 sert( !pCur->cur
5d10: 49 6e 74 4b 65 79 20 7c 7c 20 21 70 43 75 72 2d IntKey || !pCur-
5d20: 3e 70 4b 65 79 20 29 3b 0a 20 20 72 65 74 75 72 >pKey );. retur
5d30: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 n rc;.}../*.** S
5d40: 61 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 ave the current
5d50: 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e 20 cursor position
5d60: 69 6e 20 74 68 65 20 76 61 72 69 61 62 6c 65 73 in the variables
5d70: 20 42 74 43 75 72 73 6f 72 2e 6e 4b 65 79 20 0a BtCursor.nKey .
5d80: 2a 2a 20 61 6e 64 20 42 74 43 75 72 73 6f 72 2e ** and BtCursor.
5d90: 70 4b 65 79 2e 20 54 68 65 20 63 75 72 73 6f 72 pKey. The cursor
5da0: 27 73 20 73 74 61 74 65 20 69 73 20 73 65 74 20 's state is set
5db0: 74 6f 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 to CURSOR_REQUIR
5dc0: 45 53 45 45 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ESEEK..**.** The
5dd0: 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 6e 73 caller must ens
5de0: 75 72 65 20 74 68 61 74 20 74 68 65 20 63 75 72 ure that the cur
5df0: 73 6f 72 20 69 73 20 76 61 6c 69 64 20 28 68 61 sor is valid (ha
5e00: 73 20 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 s eState==CURSOR
5e10: 5f 56 41 4c 49 44 29 0a 2a 2a 20 70 72 69 6f 72 _VALID).** prior
5e20: 20 74 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 to calling this
5e30: 20 72 6f 75 74 69 6e 65 2e 20 20 0a 2a 2f 0a 73 routine. .*/.s
5e40: 74 61 74 69 63 20 69 6e 74 20 73 61 76 65 43 75 tatic int saveCu
5e50: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 42 74 43 rsorPosition(BtC
5e60: 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
5e70: 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
5e80: 74 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d t( CURSOR_VALID=
5e90: 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 7c 7c =pCur->eState ||
5ea0: 20 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 CURSOR_SKIPNEXT
5eb0: 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 ==pCur->eState )
5ec0: 3b 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70 ;. assert( 0==p
5ed0: 43 75 72 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 61 Cur->pKey );. a
5ee0: 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
5ef0: 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
5f00: 0a 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 .. if( pCur->eS
5f10: 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 tate==CURSOR_SKI
5f20: 50 4e 45 58 54 20 29 7b 0a 20 20 20 20 70 43 75 PNEXT ){. pCu
5f30: 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
5f40: 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 7d 65 6c 73 OR_VALID;. }els
5f50: 65 7b 0a 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 e{. pCur->ski
5f60: 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 7d 0a 0a pNext = 0;. }..
5f70: 20 20 72 63 20 3d 20 73 61 76 65 43 75 72 73 6f rc = saveCurso
5f80: 72 4b 65 79 28 70 43 75 72 29 3b 0a 20 20 69 66 rKey(pCur);. if
5f90: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
5fa0: 29 7b 0a 20 20 20 20 62 74 72 65 65 52 65 6c 65 ){. btreeRele
5fb0: 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 65 aseAllCursorPage
5fc0: 73 28 70 43 75 72 29 3b 0a 20 20 20 20 70 43 75 s(pCur);. pCu
5fd0: 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
5fe0: 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 3b 0a OR_REQUIRESEEK;.
5ff0: 20 20 7d 0a 0a 20 20 70 43 75 72 2d 3e 63 75 72 }.. pCur->cur
6000: 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f Flags &= ~(BTCF_
6010: 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 ValidNKey|BTCF_V
6020: 61 6c 69 64 4f 76 66 6c 7c 42 54 43 46 5f 41 74 alidOvfl|BTCF_At
6030: 4c 61 73 74 29 3b 0a 20 20 72 65 74 75 72 6e 20 Last);. return
6040: 72 63 3b 0a 7d 0a 0a 2f 2a 20 46 6f 72 77 61 72 rc;.}../* Forwar
6050: 64 20 72 65 66 65 72 65 6e 63 65 20 2a 2f 0a 73 d reference */.s
6060: 74 61 74 69 63 20 69 6e 74 20 53 51 4c 49 54 45 tatic int SQLITE
6070: 5f 4e 4f 49 4e 4c 49 4e 45 20 73 61 76 65 43 75 _NOINLINE saveCu
6080: 72 73 6f 72 73 4f 6e 4c 69 73 74 28 42 74 43 75 rsorsOnList(BtCu
6090: 72 73 6f 72 2a 2c 50 67 6e 6f 2c 42 74 43 75 72 rsor*,Pgno,BtCur
60a0: 73 6f 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 53 61 sor*);../*.** Sa
60b0: 76 65 20 74 68 65 20 70 6f 73 69 74 69 6f 6e 73 ve the positions
60c0: 20 6f 66 20 61 6c 6c 20 63 75 72 73 6f 72 73 20 of all cursors
60d0: 28 65 78 63 65 70 74 20 70 45 78 63 65 70 74 29 (except pExcept)
60e0: 20 74 68 61 74 20 61 72 65 20 6f 70 65 6e 20 6f that are open o
60f0: 6e 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 77 n.** the table w
6100: 69 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 52 ith root-page iR
6110: 6f 6f 74 2e 20 20 22 53 61 76 69 6e 67 20 74 68 oot. "Saving th
6120: 65 20 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f e cursor positio
6130: 6e 22 20 6d 65 61 6e 73 20 74 68 61 74 0a 2a 2a n" means that.**
6140: 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e 20 69 6e the location in
6150: 20 74 68 65 20 62 74 72 65 65 20 69 73 20 72 65 the btree is re
6160: 6d 65 6d 62 65 72 65 64 20 69 6e 20 73 75 63 68 membered in such
6170: 20 61 20 77 61 79 20 74 68 61 74 20 69 74 20 63 a way that it c
6180: 61 6e 20 62 65 0a 2a 2a 20 6d 6f 76 65 64 20 62 an be.** moved b
6190: 61 63 6b 20 74 6f 20 74 68 65 20 73 61 6d 65 20 ack to the same
61a0: 73 70 6f 74 20 61 66 74 65 72 20 74 68 65 20 62 spot after the b
61b0: 74 72 65 65 20 68 61 73 20 62 65 65 6e 20 6d 6f tree has been mo
61c0: 64 69 66 69 65 64 2e 20 20 54 68 69 73 0a 2a 2a dified. This.**
61d0: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c routine is call
61e0: 65 64 20 6a 75 73 74 20 62 65 66 6f 72 65 20 63 ed just before c
61f0: 75 72 73 6f 72 20 70 45 78 63 65 70 74 20 69 73 ursor pExcept is
6200: 20 75 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 used to modify
6210: 74 68 65 0a 2a 2a 20 74 61 62 6c 65 2c 20 66 6f the.** table, fo
6220: 72 20 65 78 61 6d 70 6c 65 20 69 6e 20 42 74 72 r example in Btr
6230: 65 65 44 65 6c 65 74 65 28 29 20 6f 72 20 42 74 eeDelete() or Bt
6240: 72 65 65 49 6e 73 65 72 74 28 29 2e 0a 2a 2a 0a reeInsert()..**.
6250: 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 ** If there are
6260: 74 77 6f 20 6f 72 20 6d 6f 72 65 20 63 75 72 73 two or more curs
6270: 6f 72 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 ors on the same
6280: 62 74 72 65 65 2c 20 74 68 65 6e 20 61 6c 6c 20 btree, then all
6290: 73 75 63 68 20 0a 2a 2a 20 63 75 72 73 6f 72 73 such .** cursors
62a0: 20 73 68 6f 75 6c 64 20 68 61 76 65 20 74 68 65 should have the
62b0: 69 72 20 42 54 43 46 5f 4d 75 6c 74 69 70 6c 65 ir BTCF_Multiple
62c0: 20 66 6c 61 67 20 73 65 74 2e 20 20 54 68 65 20 flag set. The
62d0: 62 74 72 65 65 43 75 72 73 6f 72 28 29 0a 2a 2a btreeCursor().**
62e0: 20 72 6f 75 74 69 6e 65 20 65 6e 66 6f 72 63 65 routine enforce
62f0: 73 20 74 68 61 74 20 72 75 6c 65 2e 20 20 54 68 s that rule. Th
6300: 69 73 20 72 6f 75 74 69 6e 65 20 6f 6e 6c 79 20 is routine only
6310: 6e 65 65 64 73 20 74 6f 20 62 65 20 63 61 6c 6c needs to be call
6320: 65 64 20 69 6e 0a 2a 2a 20 74 68 65 20 75 6e 63 ed in.** the unc
6330: 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 6e 20 ommon case when
6340: 70 45 78 70 65 63 74 20 68 61 73 20 74 68 65 20 pExpect has the
6350: 42 54 43 46 5f 4d 75 6c 74 69 70 6c 65 20 66 6c BTCF_Multiple fl
6360: 61 67 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 ag set..**.** If
6370: 20 70 45 78 70 65 63 74 21 3d 4e 55 4c 4c 20 61 pExpect!=NULL a
6380: 6e 64 20 69 66 20 6e 6f 20 6f 74 68 65 72 20 63 nd if no other c
6390: 75 72 73 6f 72 73 20 61 72 65 20 66 6f 75 6e 64 ursors are found
63a0: 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 72 6f 6f on the same roo
63b0: 74 2d 70 61 67 65 2c 0a 2a 2a 20 74 68 65 6e 20 t-page,.** then
63c0: 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 69 70 6c the BTCF_Multipl
63d0: 65 20 66 6c 61 67 20 6f 6e 20 70 45 78 70 65 63 e flag on pExpec
63e0: 74 20 69 73 20 63 6c 65 61 72 65 64 2c 20 74 6f t is cleared, to
63f0: 20 61 76 6f 69 64 20 61 6e 6f 74 68 65 72 0a 2a avoid another.*
6400: 2a 20 70 6f 69 6e 74 6c 65 73 73 20 63 61 6c 6c * pointless call
6410: 20 74 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 to this routine
6420: 2e 0a 2a 2a 0a 2a 2a 20 49 6d 70 6c 65 6d 65 6e ..**.** Implemen
6430: 74 61 74 69 6f 6e 20 6e 6f 74 65 3a 20 20 54 68 tation note: Th
6440: 69 73 20 72 6f 75 74 69 6e 65 20 6d 65 72 65 6c is routine merel
6450: 79 20 63 68 65 63 6b 73 20 74 6f 20 73 65 65 20 y checks to see
6460: 69 66 20 61 6e 79 20 63 75 72 73 6f 72 73 0a 2a if any cursors.*
6470: 2a 20 6e 65 65 64 20 74 6f 20 62 65 20 73 61 76 * need to be sav
6480: 65 64 2e 20 20 49 74 20 63 61 6c 6c 73 20 6f 75 ed. It calls ou
6490: 74 20 74 6f 20 73 61 76 65 43 75 72 73 6f 72 73 t to saveCursors
64a0: 4f 6e 4c 69 73 74 28 29 20 69 6e 20 74 68 65 20 OnList() in the
64b0: 28 75 6e 75 73 75 61 6c 29 0a 2a 2a 20 65 76 65 (unusual).** eve
64c0: 6e 74 20 74 68 61 74 20 63 75 72 73 6f 72 73 20 nt that cursors
64d0: 61 72 65 20 69 6e 20 6e 65 65 64 20 74 6f 20 62 are in need to b
64e0: 65 69 6e 67 20 73 61 76 65 64 2e 0a 2a 2f 0a 73 eing saved..*/.s
64f0: 74 61 74 69 63 20 69 6e 74 20 73 61 76 65 41 6c tatic int saveAl
6500: 6c 43 75 72 73 6f 72 73 28 42 74 53 68 61 72 65 lCursors(BtShare
6510: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 69 52 6f d *pBt, Pgno iRo
6520: 6f 74 2c 20 42 74 43 75 72 73 6f 72 20 2a 70 45 ot, BtCursor *pE
6530: 78 63 65 70 74 29 7b 0a 20 20 42 74 43 75 72 73 xcept){. BtCurs
6540: 6f 72 20 2a 70 3b 0a 20 20 61 73 73 65 72 74 28 or *p;. assert(
6550: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
6560: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
6570: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 45 78 );. assert( pEx
6580: 63 65 70 74 3d 3d 30 20 7c 7c 20 70 45 78 63 65 cept==0 || pExce
6590: 70 74 2d 3e 70 42 74 3d 3d 70 42 74 20 29 3b 0a pt->pBt==pBt );.
65a0: 20 20 66 6f 72 28 70 3d 70 42 74 2d 3e 70 43 75 for(p=pBt->pCu
65b0: 72 73 6f 72 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e rsor; p; p=p->pN
65c0: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 21 ext){. if( p!
65d0: 3d 70 45 78 63 65 70 74 20 26 26 20 28 30 3d 3d =pExcept && (0==
65e0: 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e 70 67 6e 6f iRoot || p->pgno
65f0: 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 20 29 20 62 Root==iRoot) ) b
6600: 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 reak;. }. if(
6610: 70 20 29 20 72 65 74 75 72 6e 20 73 61 76 65 43 p ) return saveC
6620: 75 72 73 6f 72 73 4f 6e 4c 69 73 74 28 70 2c 20 ursorsOnList(p,
6630: 69 52 6f 6f 74 2c 20 70 45 78 63 65 70 74 29 3b iRoot, pExcept);
6640: 0a 20 20 69 66 28 20 70 45 78 63 65 70 74 20 29 . if( pExcept )
6650: 20 70 45 78 63 65 70 74 2d 3e 63 75 72 46 6c 61 pExcept->curFla
6660: 67 73 20 26 3d 20 7e 42 54 43 46 5f 4d 75 6c 74 gs &= ~BTCF_Mult
6670: 69 70 6c 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 iple;. return S
6680: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 QLITE_OK;.}../*
6690: 54 68 69 73 20 68 65 6c 70 65 72 20 72 6f 75 74 This helper rout
66a0: 69 6e 65 20 74 6f 20 73 61 76 65 41 6c 6c 43 75 ine to saveAllCu
66b0: 72 73 6f 72 73 20 64 6f 65 73 20 74 68 65 20 61 rsors does the a
66c0: 63 74 75 61 6c 20 77 6f 72 6b 20 6f 66 20 73 61 ctual work of sa
66d0: 76 69 6e 67 0a 2a 2a 20 74 68 65 20 63 75 72 73 ving.** the curs
66e0: 6f 72 73 20 69 66 20 61 6e 64 20 77 68 65 6e 20 ors if and when
66f0: 61 20 63 75 72 73 6f 72 20 69 73 20 66 6f 75 6e a cursor is foun
6700: 64 20 74 68 61 74 20 61 63 74 75 61 6c 6c 79 20 d that actually
6710: 72 65 71 75 69 72 65 73 20 73 61 76 69 6e 67 2e requires saving.
6720: 0a 2a 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e 20 63 .** The common c
6730: 61 73 65 20 69 73 20 74 68 61 74 20 6e 6f 20 63 ase is that no c
6740: 75 72 73 6f 72 73 20 6e 65 65 64 20 74 6f 20 62 ursors need to b
6750: 65 20 73 61 76 65 64 2c 20 73 6f 20 74 68 69 73 e saved, so this
6760: 20 72 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 62 routine is.** b
6770: 72 6f 6b 65 6e 20 6f 75 74 20 66 72 6f 6d 20 69 roken out from i
6780: 74 73 20 63 61 6c 6c 65 72 20 74 6f 20 61 76 6f ts caller to avo
6790: 69 64 20 75 6e 6e 65 63 65 73 73 61 72 79 20 73 id unnecessary s
67a0: 74 61 63 6b 20 70 6f 69 6e 74 65 72 20 6d 6f 76 tack pointer mov
67b0: 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 ement..*/.static
67c0: 20 69 6e 74 20 53 51 4c 49 54 45 5f 4e 4f 49 4e int SQLITE_NOIN
67d0: 4c 49 4e 45 20 73 61 76 65 43 75 72 73 6f 72 73 LINE saveCursors
67e0: 4f 6e 4c 69 73 74 28 0a 20 20 42 74 43 75 72 73 OnList(. BtCurs
67f0: 6f 72 20 2a 70 2c 20 20 20 20 20 20 20 20 20 2f or *p, /
6800: 2a 20 54 68 65 20 66 69 72 73 74 20 63 75 72 73 * The first curs
6810: 6f 72 20 74 68 61 74 20 6e 65 65 64 73 20 73 61 or that needs sa
6820: 76 69 6e 67 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 ving */. Pgno i
6830: 52 6f 6f 74 2c 20 20 20 20 20 20 20 20 20 20 2f Root, /
6840: 2a 20 4f 6e 6c 79 20 73 61 76 65 20 63 75 72 73 * Only save curs
6850: 6f 72 20 77 69 74 68 20 74 68 69 73 20 69 52 6f or with this iRo
6860: 6f 74 2e 20 53 61 76 65 20 61 6c 6c 20 69 66 20 ot. Save all if
6870: 7a 65 72 6f 20 2a 2f 0a 20 20 42 74 43 75 72 73 zero */. BtCurs
6880: 6f 72 20 2a 70 45 78 63 65 70 74 20 20 20 20 2f or *pExcept /
6890: 2a 20 44 6f 20 6e 6f 74 20 73 61 76 65 20 74 68 * Do not save th
68a0: 69 73 20 63 75 72 73 6f 72 20 2a 2f 0a 29 7b 0a is cursor */.){.
68b0: 20 20 64 6f 7b 0a 20 20 20 20 69 66 28 20 70 21 do{. if( p!
68c0: 3d 70 45 78 63 65 70 74 20 26 26 20 28 30 3d 3d =pExcept && (0==
68d0: 69 52 6f 6f 74 20 7c 7c 20 70 2d 3e 70 67 6e 6f iRoot || p->pgno
68e0: 52 6f 6f 74 3d 3d 69 52 6f 6f 74 29 20 29 7b 0a Root==iRoot) ){.
68f0: 20 20 20 20 20 20 69 66 28 20 70 2d 3e 65 53 74 if( p->eSt
6900: 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
6910: 44 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d D || p->eState==
6920: 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 CURSOR_SKIPNEXT
6930: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 72 ){. int r
6940: 63 20 3d 20 73 61 76 65 43 75 72 73 6f 72 50 6f c = saveCursorPo
6950: 73 69 74 69 6f 6e 28 70 29 3b 0a 20 20 20 20 20 sition(p);.
6960: 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b if( SQLITE_OK
6970: 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 !=rc ){.
6980: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
6990: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c }. }el
69a0: 73 65 7b 0a 20 20 20 20 20 20 20 20 74 65 73 74 se{. test
69b0: 63 61 73 65 28 20 70 2d 3e 69 50 61 67 65 3e 3d case( p->iPage>=
69c0: 30 20 29 3b 0a 20 20 20 20 20 20 20 20 62 74 72 0 );. btr
69d0: 65 65 52 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 eeReleaseAllCurs
69e0: 6f 72 50 61 67 65 73 28 70 29 3b 0a 20 20 20 20 orPages(p);.
69f0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 20 }. }. p
6a00: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 77 = p->pNext;. }w
6a10: 68 69 6c 65 28 20 70 20 29 3b 0a 20 20 72 65 74 hile( p );. ret
6a20: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
6a30: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 74 68 ../*.** Clear th
6a40: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
6a50: 20 70 6f 73 69 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f position..*/.vo
6a60: 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 id sqlite3BtreeC
6a70: 6c 65 61 72 43 75 72 73 6f 72 28 42 74 43 75 72 learCursor(BtCur
6a80: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 sor *pCur){. as
6a90: 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
6aa0: 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
6ab0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
6ac0: 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 20 70 43 Cur->pKey);. pC
6ad0: 75 72 2d 3e 70 4b 65 79 20 3d 20 30 3b 0a 20 20 ur->pKey = 0;.
6ae0: 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
6af0: 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 7d URSOR_INVALID;.}
6b00: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 20 74 68 69 73 20 ../*.** In this
6b10: 76 65 72 73 69 6f 6e 20 6f 66 20 42 74 72 65 65 version of Btree
6b20: 4d 6f 76 65 74 6f 2c 20 70 4b 65 79 20 69 73 20 Moveto, pKey is
6b30: 61 20 70 61 63 6b 65 64 20 69 6e 64 65 78 20 72 a packed index r
6b40: 65 63 6f 72 64 0a 2a 2a 20 73 75 63 68 20 61 73 ecord.** such as
6b50: 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 is generated by
6b60: 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f the OP_MakeReco
6b70: 72 64 20 6f 70 63 6f 64 65 2e 20 20 55 6e 70 61 rd opcode. Unpa
6b80: 63 6b 20 74 68 65 0a 2a 2a 20 72 65 63 6f 72 64 ck the.** record
6b90: 20 61 6e 64 20 74 68 65 6e 20 63 61 6c 6c 20 42 and then call B
6ba0: 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 61 63 6b treeMovetoUnpack
6bb0: 65 64 28 29 20 74 6f 20 64 6f 20 74 68 65 20 77 ed() to do the w
6bc0: 6f 72 6b 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ork..*/.static i
6bd0: 6e 74 20 62 74 72 65 65 4d 6f 76 65 74 6f 28 0a nt btreeMoveto(.
6be0: 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
6bf0: 2c 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 , /* Cursor
6c00: 6f 70 65 6e 20 6f 6e 20 74 68 65 20 62 74 72 65 open on the btre
6c10: 65 20 74 6f 20 62 65 20 73 65 61 72 63 68 65 64 e to be searched
6c20: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 */. const void
6c30: 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 50 61 63 *pKey, /* Pac
6c40: 6b 65 64 20 6b 65 79 20 69 66 20 74 68 65 20 62 ked key if the b
6c50: 74 72 65 65 20 69 73 20 61 6e 20 69 6e 64 65 78 tree is an index
6c60: 20 2a 2f 0a 20 20 69 36 34 20 6e 4b 65 79 2c 20 */. i64 nKey,
6c70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 74 /* Int
6c80: 65 67 65 72 20 6b 65 79 20 66 6f 72 20 74 61 62 eger key for tab
6c90: 6c 65 73 2e 20 20 53 69 7a 65 20 6f 66 20 70 4b les. Size of pK
6ca0: 65 79 20 66 6f 72 20 69 6e 64 69 63 65 73 20 2a ey for indices *
6cb0: 2f 0a 20 20 69 6e 74 20 62 69 61 73 2c 20 20 20 /. int bias,
6cc0: 20 20 20 20 20 20 20 20 2f 2a 20 42 69 61 73 20 /* Bias
6cd0: 73 65 61 72 63 68 20 74 6f 20 74 68 65 20 68 69 search to the hi
6ce0: 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 6e 74 20 gh end */. int
6cf0: 2a 70 52 65 73 20 20 20 20 20 20 20 20 20 20 20 *pRes
6d00: 2f 2a 20 57 72 69 74 65 20 73 65 61 72 63 68 20 /* Write search
6d10: 72 65 73 75 6c 74 73 20 68 65 72 65 20 2a 2f 0a results here */.
6d20: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
6d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6d40: 2f 2a 20 53 74 61 74 75 73 20 63 6f 64 65 20 2a /* Status code *
6d50: 2f 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f /. UnpackedReco
6d60: 72 64 20 2a 70 49 64 78 4b 65 79 3b 20 20 20 2f rd *pIdxKey; /
6d70: 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 * Unpacked index
6d80: 20 6b 65 79 20 2a 2f 0a 0a 20 20 69 66 28 20 70 key */.. if( p
6d90: 4b 65 79 20 29 7b 0a 20 20 20 20 4b 65 79 49 6e Key ){. KeyIn
6da0: 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 70 fo *pKeyInfo = p
6db0: 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3b 0a 20 Cur->pKeyInfo;.
6dc0: 20 20 20 61 73 73 65 72 74 28 20 6e 4b 65 79 3d assert( nKey=
6dd0: 3d 28 69 36 34 29 28 69 6e 74 29 6e 4b 65 79 20 =(i64)(int)nKey
6de0: 29 3b 0a 20 20 20 20 70 49 64 78 4b 65 79 20 3d );. pIdxKey =
6df0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 6c 6c 6f sqlite3VdbeAllo
6e00: 63 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 28 cUnpackedRecord(
6e10: 70 4b 65 79 49 6e 66 6f 29 3b 0a 20 20 20 20 69 pKeyInfo);. i
6e20: 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 20 29 20 f( pIdxKey==0 )
6e30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
6e40: 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 73 71 MEM_BKPT;. sq
6e50: 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 55 lite3VdbeRecordU
6e60: 6e 70 61 63 6b 28 70 4b 65 79 49 6e 66 6f 2c 20 npack(pKeyInfo,
6e70: 28 69 6e 74 29 6e 4b 65 79 2c 20 70 4b 65 79 2c (int)nKey, pKey,
6e80: 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 69 pIdxKey);. i
6e90: 66 28 20 70 49 64 78 4b 65 79 2d 3e 6e 46 69 65 f( pIdxKey->nFie
6ea0: 6c 64 3d 3d 30 20 7c 7c 20 70 49 64 78 4b 65 79 ld==0 || pIdxKey
6eb0: 2d 3e 6e 46 69 65 6c 64 3e 70 4b 65 79 49 6e 66 ->nField>pKeyInf
6ec0: 6f 2d 3e 6e 41 6c 6c 46 69 65 6c 64 20 29 7b 0a o->nAllField ){.
6ed0: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
6ee0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
6ef0: 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
6f00: 6f 5f 64 6f 6e 65 3b 0a 20 20 20 20 7d 0a 20 20 o_done;. }.
6f10: 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 64 78 4b }else{. pIdxK
6f20: 65 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 63 ey = 0;. }. rc
6f30: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d = sqlite3BtreeM
6f40: 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 70 43 ovetoUnpacked(pC
6f50: 75 72 2c 20 70 49 64 78 4b 65 79 2c 20 6e 4b 65 ur, pIdxKey, nKe
6f60: 79 2c 20 62 69 61 73 2c 20 70 52 65 73 29 3b 0a y, bias, pRes);.
6f70: 6d 6f 76 65 74 6f 5f 64 6f 6e 65 3a 0a 20 20 69 moveto_done:. i
6f80: 66 28 20 70 49 64 78 4b 65 79 20 29 7b 0a 20 20 f( pIdxKey ){.
6f90: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
6fa0: 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2d 3e pCur->pKeyInfo->
6fb0: 64 62 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 db, pIdxKey);.
6fc0: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
6fd0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 74 6f 72 65 20 ../*.** Restore
6fe0: 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 the cursor to th
6ff0: 65 20 70 6f 73 69 74 69 6f 6e 20 69 74 20 77 61 e position it wa
7000: 73 20 69 6e 20 28 6f 72 20 61 73 20 63 6c 6f 73 s in (or as clos
7010: 65 20 74 6f 20 61 73 20 70 6f 73 73 69 62 6c 65 e to as possible
7020: 29 0a 2a 2a 20 77 68 65 6e 20 73 61 76 65 43 75 ).** when saveCu
7030: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 20 77 rsorPosition() w
7040: 61 73 20 63 61 6c 6c 65 64 2e 20 4e 6f 74 65 20 as called. Note
7050: 74 68 61 74 20 74 68 69 73 20 63 61 6c 6c 20 64 that this call d
7060: 65 6c 65 74 65 73 20 74 68 65 20 0a 2a 2a 20 73 eletes the .** s
7070: 61 76 65 64 20 70 6f 73 69 74 69 6f 6e 20 69 6e aved position in
7080: 66 6f 20 73 74 6f 72 65 64 20 62 79 20 73 61 76 fo stored by sav
7090: 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
70a0: 29 2c 20 73 6f 20 74 68 65 72 65 20 63 61 6e 20 ), so there can
70b0: 62 65 0a 2a 2a 20 61 74 20 6d 6f 73 74 20 6f 6e be.** at most on
70c0: 65 20 65 66 66 65 63 74 69 76 65 20 72 65 73 74 e effective rest
70d0: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
70e0: 6e 28 29 20 63 61 6c 6c 20 61 66 74 65 72 20 65 n() call after e
70f0: 61 63 68 20 0a 2a 2a 20 73 61 76 65 43 75 72 73 ach .** saveCurs
7100: 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2e 0a 2a 2f orPosition()..*/
7110: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
7120: 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f eRestoreCursorPo
7130: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
7140: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
7150: 3b 0a 20 20 69 6e 74 20 73 6b 69 70 4e 65 78 74 ;. int skipNext
7160: 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
7170: 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
7180: 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
7190: 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d ( pCur->eState>=
71a0: 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 CURSOR_REQUIRESE
71b0: 45 4b 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 EK );. if( pCur
71c0: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
71d0: 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 20 72 65 _FAULT ){. re
71e0: 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 4e turn pCur->skipN
71f0: 65 78 74 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d ext;. }. pCur-
7200: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
7210: 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 72 63 20 3d _INVALID;. rc =
7220: 20 62 74 72 65 65 4d 6f 76 65 74 6f 28 70 43 75 btreeMoveto(pCu
7230: 72 2c 20 70 43 75 72 2d 3e 70 4b 65 79 2c 20 70 r, pCur->pKey, p
7240: 43 75 72 2d 3e 6e 4b 65 79 2c 20 30 2c 20 26 73 Cur->nKey, 0, &s
7250: 6b 69 70 4e 65 78 74 29 3b 0a 20 20 69 66 28 20 kipNext);. if(
7260: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
7270: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 . sqlite3_fre
7280: 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 3b 0a 20 e(pCur->pKey);.
7290: 20 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d 20 pCur->pKey =
72a0: 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 0;. assert( p
72b0: 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
72c0: 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 SOR_VALID || pCu
72d0: 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
72e0: 52 5f 49 4e 56 41 4c 49 44 20 29 3b 0a 20 20 20 R_INVALID );.
72f0: 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
7300: 7c 3d 20 73 6b 69 70 4e 65 78 74 3b 0a 20 20 20 |= skipNext;.
7310: 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e if( pCur->skipN
7320: 65 78 74 20 26 26 20 70 43 75 72 2d 3e 65 53 74 ext && pCur->eSt
7330: 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
7340: 44 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d D ){. pCur-
7350: 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
7360: 5f 53 4b 49 50 4e 45 58 54 3b 0a 20 20 20 20 7d _SKIPNEXT;. }
7370: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
7380: 3b 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 72 65 73 ;.}..#define res
7390: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
73a0: 6f 6e 28 70 29 20 5c 0a 20 20 28 70 2d 3e 65 53 on(p) \. (p->eS
73b0: 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
73c0: 55 49 52 45 53 45 45 4b 20 3f 20 5c 0a 20 20 20 UIRESEEK ? \.
73d0: 20 20 20 20 20 20 62 74 72 65 65 52 65 73 74 6f btreeResto
73e0: 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e reCursorPosition
73f0: 28 70 29 20 3a 20 5c 0a 20 20 20 20 20 20 20 20 (p) : \.
7400: 20 53 51 4c 49 54 45 5f 4f 4b 29 0a 0a 2f 2a 0a SQLITE_OK)../*.
7410: 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 ** Determine whe
7420: 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 63 75 ther or not a cu
7430: 72 73 6f 72 20 68 61 73 20 6d 6f 76 65 64 20 66 rsor has moved f
7440: 72 6f 6d 20 74 68 65 20 70 6f 73 69 74 69 6f 6e rom the position
7450: 20 77 68 65 72 65 0a 2a 2a 20 69 74 20 77 61 73 where.** it was
7460: 20 6c 61 73 74 20 70 6c 61 63 65 64 2c 20 6f 72 last placed, or
7470: 20 68 61 73 20 62 65 65 6e 20 69 6e 76 61 6c 69 has been invali
7480: 64 61 74 65 64 20 66 6f 72 20 61 6e 79 20 6f 74 dated for any ot
7490: 68 65 72 20 72 65 61 73 6f 6e 2e 0a 2a 2a 20 43 her reason..** C
74a0: 75 72 73 6f 72 73 20 63 61 6e 20 6d 6f 76 65 20 ursors can move
74b0: 77 68 65 6e 20 74 68 65 20 72 6f 77 20 74 68 65 when the row the
74c0: 79 20 61 72 65 20 70 6f 69 6e 74 69 6e 67 20 61 y are pointing a
74d0: 74 20 69 73 20 64 65 6c 65 74 65 64 20 6f 75 74 t is deleted out
74e0: 0a 2a 2a 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 .** from under t
74f0: 68 65 6d 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 hem, for example
7500: 2e 20 20 43 75 72 73 6f 72 20 6d 69 67 68 74 20 . Cursor might
7510: 61 6c 73 6f 20 6d 6f 76 65 20 69 66 20 61 20 62 also move if a b
7520: 74 72 65 65 0a 2a 2a 20 69 73 20 72 65 62 61 6c tree.** is rebal
7530: 61 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c anced..**.** Cal
7540: 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e ling this routin
7550: 65 20 77 69 74 68 20 61 20 4e 55 4c 4c 20 63 75 e with a NULL cu
7560: 72 73 6f 72 20 70 6f 69 6e 74 65 72 20 72 65 74 rsor pointer ret
7570: 75 72 6e 73 20 66 61 6c 73 65 2e 0a 2a 2a 0a 2a urns false..**.*
7580: 2a 20 55 73 65 20 74 68 65 20 73 65 70 61 72 61 * Use the separa
7590: 74 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 te sqlite3BtreeC
75a0: 75 72 73 6f 72 52 65 73 74 6f 72 65 28 29 20 72 ursorRestore() r
75b0: 6f 75 74 69 6e 65 20 74 6f 20 72 65 73 74 6f 72 outine to restor
75c0: 65 20 61 20 63 75 72 73 6f 72 0a 2a 2a 20 62 61 e a cursor.** ba
75d0: 63 6b 20 74 6f 20 77 68 65 72 65 20 69 74 20 6f ck to where it o
75e0: 75 67 68 74 20 74 6f 20 62 65 20 69 66 20 74 68 ught to be if th
75f0: 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 is routine retur
7600: 6e 73 20 74 72 75 65 2e 0a 2a 2f 0a 69 6e 74 20 ns true..*/.int
7610: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
7620: 6f 72 48 61 73 4d 6f 76 65 64 28 42 74 43 75 72 orHasMoved(BtCur
7630: 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 sor *pCur){. as
7640: 73 65 72 74 28 20 45 49 47 48 54 5f 42 59 54 45 sert( EIGHT_BYTE
7650: 5f 41 4c 49 47 4e 4d 45 4e 54 28 70 43 75 72 29 _ALIGNMENT(pCur)
7660: 0a 20 20 20 20 20 20 20 7c 7c 20 70 43 75 72 3d . || pCur=
7670: 3d 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 6b =sqlite3BtreeFak
7680: 65 56 61 6c 69 64 43 75 72 73 6f 72 28 29 20 29 eValidCursor() )
7690: 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 ;. assert( offs
76a0: 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 65 etof(BtCursor, e
76b0: 53 74 61 74 65 29 3d 3d 30 20 29 3b 0a 20 20 61 State)==0 );. a
76c0: 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 70 43 ssert( sizeof(pC
76d0: 75 72 2d 3e 65 53 74 61 74 65 29 3d 3d 31 20 29 ur->eState)==1 )
76e0: 3b 0a 20 20 72 65 74 75 72 6e 20 43 55 52 53 4f ;. return CURSO
76f0: 52 5f 56 41 4c 49 44 20 21 3d 20 2a 28 75 38 2a R_VALID != *(u8*
7700: 29 70 43 75 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 )pCur;.}../*.**
7710: 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 Return a pointer
7720: 20 74 6f 20 61 20 66 61 6b 65 20 42 74 43 75 72 to a fake BtCur
7730: 73 6f 72 20 6f 62 6a 65 63 74 20 74 68 61 74 20 sor object that
7740: 77 69 6c 6c 20 61 6c 77 61 79 73 20 61 6e 73 77 will always answ
7750: 65 72 0a 2a 2a 20 66 61 6c 73 65 20 74 6f 20 74 er.** false to t
7760: 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 he sqlite3BtreeC
7770: 75 72 73 6f 72 48 61 73 4d 6f 76 65 64 28 29 20 ursorHasMoved()
7780: 72 6f 75 74 69 6e 65 20 61 62 6f 76 65 2e 20 20 routine above.
7790: 54 68 65 20 66 61 6b 65 0a 2a 2a 20 63 75 72 73 The fake.** curs
77a0: 6f 72 20 72 65 74 75 72 6e 65 64 20 6d 75 73 74 or returned must
77b0: 20 6e 6f 74 20 62 65 20 75 73 65 64 20 77 69 74 not be used wit
77c0: 68 20 61 6e 79 20 6f 74 68 65 72 20 42 74 72 65 h any other Btre
77d0: 65 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2f 0a e interface..*/.
77e0: 42 74 43 75 72 73 6f 72 20 2a 73 71 6c 69 74 65 BtCursor *sqlite
77f0: 33 42 74 72 65 65 46 61 6b 65 56 61 6c 69 64 43 3BtreeFakeValidC
7800: 75 72 73 6f 72 28 76 6f 69 64 29 7b 0a 20 20 73 ursor(void){. s
7810: 74 61 74 69 63 20 75 38 20 66 61 6b 65 43 75 72 tatic u8 fakeCur
7820: 73 6f 72 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c sor = CURSOR_VAL
7830: 49 44 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 66 ID;. assert( of
7840: 66 73 65 74 6f 66 28 42 74 43 75 72 73 6f 72 2c fsetof(BtCursor,
7850: 20 65 53 74 61 74 65 29 3d 3d 30 20 29 3b 0a 20 eState)==0 );.
7860: 20 72 65 74 75 72 6e 20 28 42 74 43 75 72 73 6f return (BtCurso
7870: 72 2a 29 26 66 61 6b 65 43 75 72 73 6f 72 3b 0a r*)&fakeCursor;.
7880: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
7890: 75 74 69 6e 65 20 72 65 73 74 6f 72 65 73 20 61 utine restores a
78a0: 20 63 75 72 73 6f 72 20 62 61 63 6b 20 74 6f 20 cursor back to
78b0: 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 70 6f 73 its original pos
78c0: 69 74 69 6f 6e 20 61 66 74 65 72 20 69 74 0a 2a ition after it.*
78d0: 2a 20 68 61 73 20 62 65 65 6e 20 6d 6f 76 65 64 * has been moved
78e0: 20 62 79 20 73 6f 6d 65 20 6f 75 74 73 69 64 65 by some outside
78f0: 20 61 63 74 69 76 69 74 79 20 28 73 75 63 68 20 activity (such
7900: 61 73 20 61 20 62 74 72 65 65 20 72 65 62 61 6c as a btree rebal
7910: 61 6e 63 65 20 6f 72 0a 2a 2a 20 61 20 72 6f 77 ance or.** a row
7920: 20 68 61 76 69 6e 67 20 62 65 65 6e 20 64 65 6c having been del
7930: 65 74 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e eted out from un
7940: 64 65 72 20 74 68 65 20 63 75 72 73 6f 72 29 2e der the cursor).
7950: 20 20 0a 2a 2a 0a 2a 2a 20 4f 6e 20 73 75 63 63 .**.** On succ
7960: 65 73 73 2c 20 74 68 65 20 2a 70 44 69 66 66 65 ess, the *pDiffe
7970: 72 65 6e 74 52 6f 77 20 70 61 72 61 6d 65 74 65 rentRow paramete
7980: 72 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 68 r is false if th
7990: 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
79a0: 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 .** pointing at
79b0: 65 78 61 63 74 6c 79 20 74 68 65 20 73 61 6d 65 exactly the same
79c0: 20 72 6f 77 2e 20 20 2a 70 44 69 66 66 65 72 6e row. *pDiffern
79d0: 74 52 6f 77 20 69 73 20 74 68 65 20 72 6f 77 20 tRow is the row
79e0: 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a 20 77 61 the cursor.** wa
79f0: 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 68 61 s pointing to ha
7a00: 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2c 20 s been deleted,
7a10: 66 6f 72 63 69 6e 67 20 74 68 65 20 63 75 72 73 forcing the curs
7a20: 6f 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 73 or to point to s
7a30: 6f 6d 65 0a 2a 2a 20 6e 65 61 72 62 79 20 72 6f ome.** nearby ro
7a40: 77 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f w..**.** This ro
7a50: 75 74 69 6e 65 20 73 68 6f 75 6c 64 20 6f 6e 6c utine should onl
7a60: 79 20 62 65 20 63 61 6c 6c 65 64 20 66 6f 72 20 y be called for
7a70: 61 20 63 75 72 73 6f 72 20 74 68 61 74 20 6a 75 a cursor that ju
7a80: 73 74 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20 54 st returned.** T
7a90: 52 55 45 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 RUE from sqlite3
7aa0: 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 6f BtreeCursorHasMo
7ab0: 76 65 64 28 29 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ved()..*/.int sq
7ac0: 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 lite3BtreeCursor
7ad0: 52 65 73 74 6f 72 65 28 42 74 43 75 72 73 6f 72 Restore(BtCursor
7ae0: 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 44 69 *pCur, int *pDi
7af0: 66 66 65 72 65 6e 74 52 6f 77 29 7b 0a 20 20 69 fferentRow){. i
7b00: 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
7b10: 28 20 70 43 75 72 21 3d 30 20 29 3b 0a 20 20 61 ( pCur!=0 );. a
7b20: 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
7b30: 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
7b40: 44 20 29 3b 0a 20 20 72 63 20 3d 20 72 65 73 74 D );. rc = rest
7b50: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
7b60: 6e 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 n(pCur);. if( r
7b70: 63 20 29 7b 0a 20 20 20 20 2a 70 44 69 66 66 65 c ){. *pDiffe
7b80: 72 65 6e 74 52 6f 77 20 3d 20 31 3b 0a 20 20 20 rentRow = 1;.
7b90: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a return rc;. }.
7ba0: 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 if( pCur->eSta
7bb0: 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te!=CURSOR_VALID
7bc0: 20 29 7b 0a 20 20 20 20 2a 70 44 69 66 66 65 72 ){. *pDiffer
7bd0: 65 6e 74 52 6f 77 20 3d 20 31 3b 0a 20 20 7d 65 entRow = 1;. }e
7be0: 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 lse{. assert(
7bf0: 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3d pCur->skipNext=
7c00: 3d 30 20 29 3b 0a 20 20 20 20 2a 70 44 69 66 66 =0 );. *pDiff
7c10: 65 72 65 6e 74 52 6f 77 20 3d 20 30 3b 0a 20 20 erentRow = 0;.
7c20: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
7c30: 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 E_OK;.}..#ifdef
7c40: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 55 SQLITE_ENABLE_CU
7c50: 52 53 4f 52 5f 48 49 4e 54 53 0a 2f 2a 0a 2a 2a RSOR_HINTS./*.**
7c60: 20 50 72 6f 76 69 64 65 20 68 69 6e 74 73 20 74 Provide hints t
7c70: 6f 20 74 68 65 20 63 75 72 73 6f 72 2e 20 20 54 o the cursor. T
7c80: 68 65 20 70 61 72 74 69 63 75 6c 61 72 20 68 69 he particular hi
7c90: 6e 74 20 67 69 76 65 6e 20 28 61 6e 64 20 74 68 nt given (and th
7ca0: 65 20 74 79 70 65 0a 2a 2a 20 61 6e 64 20 6e 75 e type.** and nu
7cb0: 6d 62 65 72 20 6f 66 20 74 68 65 20 76 61 72 61 mber of the vara
7cc0: 72 67 73 20 70 61 72 61 6d 65 74 65 72 73 29 20 rgs parameters)
7cd0: 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 is determined by
7ce0: 20 74 68 65 20 65 48 69 6e 74 54 79 70 65 0a 2a the eHintType.*
7cf0: 2a 20 70 61 72 61 6d 65 74 65 72 2e 20 20 53 65 * parameter. Se
7d00: 65 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e e the definition
7d10: 73 20 6f 66 20 74 68 65 20 42 54 52 45 45 5f 48 s of the BTREE_H
7d20: 49 4e 54 5f 2a 20 6d 61 63 72 6f 73 20 66 6f 72 INT_* macros for
7d30: 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 76 6f 69 details..*/.voi
7d40: 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 d sqlite3BtreeCu
7d50: 72 73 6f 72 48 69 6e 74 28 42 74 43 75 72 73 6f rsorHint(BtCurso
7d60: 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 65 48 69 r *pCur, int eHi
7d70: 6e 74 54 79 70 65 2c 20 2e 2e 2e 29 7b 0a 20 20 ntType, ...){.
7d80: 2f 2a 20 55 73 65 64 20 6f 6e 6c 79 20 62 79 20 /* Used only by
7d90: 73 79 73 74 65 6d 20 74 68 61 74 20 73 75 62 73 system that subs
7da0: 74 69 74 75 74 65 20 74 68 65 69 72 20 6f 77 6e titute their own
7db0: 20 73 74 6f 72 61 67 65 20 65 6e 67 69 6e 65 20 storage engine
7dc0: 2a 2f 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a */.}.#endif../*.
7dd0: 2a 2a 20 50 72 6f 76 69 64 65 20 66 6c 61 67 20 ** Provide flag
7de0: 68 69 6e 74 73 20 74 6f 20 74 68 65 20 63 75 72 hints to the cur
7df0: 73 6f 72 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c sor..*/.void sql
7e00: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 48 ite3BtreeCursorH
7e10: 69 6e 74 46 6c 61 67 73 28 42 74 43 75 72 73 6f intFlags(BtCurso
7e20: 72 20 2a 70 43 75 72 2c 20 75 6e 73 69 67 6e 65 r *pCur, unsigne
7e30: 64 20 78 29 7b 0a 20 20 61 73 73 65 72 74 28 20 d x){. assert(
7e40: 78 3d 3d 42 54 52 45 45 5f 53 45 45 4b 5f 45 51 x==BTREE_SEEK_EQ
7e50: 20 7c 7c 20 78 3d 3d 42 54 52 45 45 5f 42 55 4c || x==BTREE_BUL
7e60: 4b 4c 4f 41 44 20 7c 7c 20 78 3d 3d 30 20 29 3b KLOAD || x==0 );
7e70: 0a 20 20 70 43 75 72 2d 3e 68 69 6e 74 73 20 3d . pCur->hints =
7e80: 20 78 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 x;.}...#ifndef
7e90: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
7ea0: 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 47 69 76 VACUUM./*.** Giv
7eb0: 65 6e 20 61 20 70 61 67 65 20 6e 75 6d 62 65 72 en a page number
7ec0: 20 6f 66 20 61 20 72 65 67 75 6c 61 72 20 64 61 of a regular da
7ed0: 74 61 62 61 73 65 20 70 61 67 65 2c 20 72 65 74 tabase page, ret
7ee0: 75 72 6e 20 74 68 65 20 70 61 67 65 0a 2a 2a 20 urn the page.**
7ef0: 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 65 20 70 number for the p
7f00: 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 20 ointer-map page
7f10: 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
7f20: 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 0a e entry for the.
7f30: 2a 2a 20 69 6e 70 75 74 20 70 61 67 65 20 6e 75 ** input page nu
7f40: 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 mber..**.** Retu
7f50: 72 6e 20 30 20 28 6e 6f 74 20 61 20 76 61 6c 69 rn 0 (not a vali
7f60: 64 20 70 61 67 65 29 20 66 6f 72 20 70 67 6e 6f d page) for pgno
7f70: 3d 3d 31 20 73 69 6e 63 65 20 74 68 65 72 65 20 ==1 since there
7f80: 69 73 0a 2a 2a 20 6e 6f 20 70 6f 69 6e 74 65 72 is.** no pointer
7f90: 20 6d 61 70 20 61 73 73 6f 63 69 61 74 65 64 20 map associated
7fa0: 77 69 74 68 20 70 61 67 65 20 31 2e 20 20 54 68 with page 1. Th
7fb0: 65 20 69 6e 74 65 67 72 69 74 79 5f 63 68 65 63 e integrity_chec
7fc0: 6b 20 6c 6f 67 69 63 0a 2a 2a 20 72 65 71 75 69 k logic.** requi
7fd0: 72 65 73 20 74 68 61 74 20 70 74 72 6d 61 70 50 res that ptrmapP
7fe0: 61 67 65 6e 6f 28 2a 2c 31 29 21 3d 31 2e 0a 2a ageno(*,1)!=1..*
7ff0: 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f 20 70 74 /.static Pgno pt
8000: 72 6d 61 70 50 61 67 65 6e 6f 28 42 74 53 68 61 rmapPageno(BtSha
8010: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 red *pBt, Pgno p
8020: 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 6e 50 61 67 gno){. int nPag
8030: 65 73 50 65 72 4d 61 70 50 61 67 65 3b 0a 20 20 esPerMapPage;.
8040: 50 67 6e 6f 20 69 50 74 72 4d 61 70 2c 20 72 65 Pgno iPtrMap, re
8050: 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c t;. assert( sql
8060: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
8070: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
8080: 20 69 66 28 20 70 67 6e 6f 3c 32 20 29 20 72 65 if( pgno<2 ) re
8090: 74 75 72 6e 20 30 3b 0a 20 20 6e 50 61 67 65 73 turn 0;. nPages
80a0: 50 65 72 4d 61 70 50 61 67 65 20 3d 20 28 70 42 PerMapPage = (pB
80b0: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 35 29 t->usableSize/5)
80c0: 2b 31 3b 0a 20 20 69 50 74 72 4d 61 70 20 3d 20 +1;. iPtrMap =
80d0: 28 70 67 6e 6f 2d 32 29 2f 6e 50 61 67 65 73 50 (pgno-2)/nPagesP
80e0: 65 72 4d 61 70 50 61 67 65 3b 0a 20 20 72 65 74 erMapPage;. ret
80f0: 20 3d 20 28 69 50 74 72 4d 61 70 2a 6e 50 61 67 = (iPtrMap*nPag
8100: 65 73 50 65 72 4d 61 70 50 61 67 65 29 20 2b 20 esPerMapPage) +
8110: 32 3b 20 0a 20 20 69 66 28 20 72 65 74 3d 3d 50 2; . if( ret==P
8120: 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
8130: 28 70 42 74 29 20 29 7b 0a 20 20 20 20 72 65 74 (pBt) ){. ret
8140: 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ++;. }. return
8150: 20 72 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 ret;.}../*.** W
8160: 72 69 74 65 20 61 6e 20 65 6e 74 72 79 20 69 6e rite an entry in
8170: 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d to the pointer m
8180: 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ap..**.** This r
8190: 6f 75 74 69 6e 65 20 75 70 64 61 74 65 73 20 74 outine updates t
81a0: 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 he pointer map e
81b0: 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 6e 75 ntry for page nu
81c0: 6d 62 65 72 20 27 6b 65 79 27 0a 2a 2a 20 73 6f mber 'key'.** so
81d0: 20 74 68 61 74 20 69 74 20 6d 61 70 73 20 74 6f that it maps to
81e0: 20 74 79 70 65 20 27 65 54 79 70 65 27 20 61 6e type 'eType' an
81f0: 64 20 70 61 72 65 6e 74 20 70 61 67 65 20 6e 75 d parent page nu
8200: 6d 62 65 72 20 27 70 67 6e 6f 27 2e 0a 2a 2a 0a mber 'pgno'..**.
8210: 2a 2a 20 49 66 20 2a 70 52 43 20 69 73 20 69 6e ** If *pRC is in
8220: 69 74 69 61 6c 6c 79 20 6e 6f 6e 2d 7a 65 72 6f itially non-zero
8230: 20 28 6e 6f 6e 2d 53 51 4c 49 54 45 5f 4f 4b 29 (non-SQLITE_OK)
8240: 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 then this routi
8250: 6e 65 20 69 73 0a 2a 2a 20 61 20 6e 6f 2d 6f 70 ne is.** a no-op
8260: 2e 20 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f . If an error o
8270: 63 63 75 72 73 2c 20 74 68 65 20 61 70 70 72 6f ccurs, the appro
8280: 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 priate error cod
8290: 65 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 e is written.**
82a0: 69 6e 74 6f 20 2a 70 52 43 2e 0a 2a 2f 0a 73 74 into *pRC..*/.st
82b0: 61 74 69 63 20 76 6f 69 64 20 70 74 72 6d 61 70 atic void ptrmap
82c0: 50 75 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 Put(BtShared *pB
82d0: 74 2c 20 50 67 6e 6f 20 6b 65 79 2c 20 75 38 20 t, Pgno key, u8
82e0: 65 54 79 70 65 2c 20 50 67 6e 6f 20 70 61 72 65 eType, Pgno pare
82f0: 6e 74 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 nt, int *pRC){.
8300: 20 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 DbPage *pDbPage
8310: 3b 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 ; /* The pointe
8320: 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 r map page */.
8330: 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 20 u8 *pPtrmap;
8340: 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 /* The pointer
8350: 20 6d 61 70 20 64 61 74 61 20 2a 2f 0a 20 20 50 map data */. P
8360: 67 6e 6f 20 69 50 74 72 6d 61 70 3b 20 20 20 20 gno iPtrmap;
8370: 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
8380: 6d 61 70 20 70 61 67 65 20 6e 75 6d 62 65 72 20 map page number
8390: 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 73 65 74 3b */. int offset;
83a0: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 /* Offset
83b0: 20 69 6e 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 in pointer map
83c0: 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 page */. int rc
83d0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 ; /* R
83e0: 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 eturn code from
83f0: 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a subfunctions */.
8400: 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 . if( *pRC ) re
8410: 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 turn;.. assert(
8420: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
8430: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
8440: 29 3b 0a 20 20 2f 2a 20 54 68 65 20 6d 61 73 74 );. /* The mast
8450: 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 er-journal page
8460: 6e 75 6d 62 65 72 20 6d 75 73 74 20 6e 65 76 65 number must neve
8470: 72 20 62 65 20 75 73 65 64 20 61 73 20 61 20 70 r be used as a p
8480: 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 ointer map page
8490: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d */. assert( 0==
84a0: 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 PTRMAP_ISPAGE(pB
84b0: 74 2c 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f t, PENDING_BYTE_
84c0: 50 41 47 45 28 70 42 74 29 29 20 29 3b 0a 0a 20 PAGE(pBt)) );..
84d0: 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 75 assert( pBt->au
84e0: 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 69 66 toVacuum );. if
84f0: 28 20 6b 65 79 3d 3d 30 20 29 7b 0a 20 20 20 20 ( key==0 ){.
8500: 2a 70 52 43 20 3d 20 53 51 4c 49 54 45 5f 43 4f *pRC = SQLITE_CO
8510: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
8520: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 50 return;. }. iP
8530: 74 72 6d 61 70 20 3d 20 50 54 52 4d 41 50 5f 50 trmap = PTRMAP_P
8540: 41 47 45 4e 4f 28 70 42 74 2c 20 6b 65 79 29 3b AGENO(pBt, key);
8550: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
8560: 61 67 65 72 47 65 74 28 70 42 74 2d 3e 70 50 61 agerGet(pBt->pPa
8570: 67 65 72 2c 20 69 50 74 72 6d 61 70 2c 20 26 70 ger, iPtrmap, &p
8580: 44 62 50 61 67 65 2c 20 30 29 3b 0a 20 20 69 66 DbPage, 0);. if
8590: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
85a0: 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 72 63 ){. *pRC = rc
85b0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 ;. return;.
85c0: 7d 0a 20 20 69 66 28 20 28 28 63 68 61 72 2a 29 }. if( ((char*)
85d0: 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 sqlite3PagerGetE
85e0: 78 74 72 61 28 70 44 62 50 61 67 65 29 29 5b 30 xtra(pDbPage))[0
85f0: 5d 21 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 54 ]!=0 ){. /* T
8600: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
8610: 20 74 68 65 20 65 78 74 72 61 20 64 61 74 61 20 the extra data
8620: 69 73 20 74 68 65 20 4d 65 6d 50 61 67 65 2e 69 is the MemPage.i
8630: 73 49 6e 69 74 20 62 79 74 65 2e 0a 20 20 20 20 sInit byte..
8640: 2a 2a 20 49 66 20 74 68 61 74 20 62 79 74 65 20 ** If that byte
8650: 69 73 20 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 is set, it means
8660: 20 74 68 69 73 20 70 61 67 65 20 69 73 20 61 6c this page is al
8670: 73 6f 20 62 65 69 6e 67 20 75 73 65 64 0a 20 20 so being used.
8680: 20 20 2a 2a 20 61 73 20 61 20 62 74 72 65 65 20 ** as a btree
8690: 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 2a 70 52 page. */. *pR
86a0: 43 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 C = SQLITE_CORRU
86b0: 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 PT_BKPT;. got
86c0: 6f 20 70 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 o ptrmap_exit;.
86d0: 20 7d 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 }. offset = PT
86e0: 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 RMAP_PTROFFSET(i
86f0: 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 Ptrmap, key);.
8700: 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a if( offset<0 ){.
8710: 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
8720: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
8730: 20 20 20 20 67 6f 74 6f 20 70 74 72 6d 61 70 5f goto ptrmap_
8740: 65 78 69 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 exit;. }. asse
8750: 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 69 rt( offset <= (i
8760: 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 nt)pBt->usableSi
8770: 7a 65 2d 35 20 29 3b 0a 20 20 70 50 74 72 6d 61 ze-5 );. pPtrma
8780: 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 65 p = (u8 *)sqlite
8790: 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
87a0: 62 50 61 67 65 29 3b 0a 0a 20 20 69 66 28 20 65 bPage);.. if( e
87b0: 54 79 70 65 21 3d 70 50 74 72 6d 61 70 5b 6f 66 Type!=pPtrmap[of
87c0: 66 73 65 74 5d 20 7c 7c 20 67 65 74 34 62 79 74 fset] || get4byt
87d0: 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 e(&pPtrmap[offse
87e0: 74 2b 31 5d 29 21 3d 70 61 72 65 6e 74 20 29 7b t+1])!=parent ){
87f0: 0a 20 20 20 20 54 52 41 43 45 28 28 22 50 54 52 . TRACE(("PTR
8800: 4d 41 50 5f 55 50 44 41 54 45 3a 20 25 64 2d 3e MAP_UPDATE: %d->
8810: 28 25 64 2c 25 64 29 5c 6e 22 2c 20 6b 65 79 2c (%d,%d)\n", key,
8820: 20 65 54 79 70 65 2c 20 70 61 72 65 6e 74 29 29 eType, parent))
8830: 3b 0a 20 20 20 20 2a 70 52 43 3d 20 72 63 20 3d ;. *pRC= rc =
8840: 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
8850: 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
8860: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
8870: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 74 72 OK ){. pPtr
8880: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 3d 20 65 54 map[offset] = eT
8890: 79 70 65 3b 0a 20 20 20 20 20 20 70 75 74 34 62 ype;. put4b
88a0: 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 yte(&pPtrmap[off
88b0: 73 65 74 2b 31 5d 2c 20 70 61 72 65 6e 74 29 3b set+1], parent);
88c0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 70 74 72 6d . }. }..ptrm
88d0: 61 70 5f 65 78 69 74 3a 0a 20 20 73 71 6c 69 74 ap_exit:. sqlit
88e0: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
88f0: 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
8900: 52 65 61 64 20 61 6e 20 65 6e 74 72 79 20 66 72 Read an entry fr
8910: 6f 6d 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d om the pointer m
8920: 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 ap..**.** This r
8930: 6f 75 74 69 6e 65 20 72 65 74 72 69 65 76 65 73 outine retrieves
8940: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
8950: 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 20 entry for page
8960: 27 6b 65 79 27 2c 20 77 72 69 74 69 6e 67 0a 2a 'key', writing.*
8970: 2a 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 70 * the type and p
8980: 61 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 65 arent page numbe
8990: 72 20 74 6f 20 2a 70 45 54 79 70 65 20 61 6e 64 r to *pEType and
89a0: 20 2a 70 50 67 6e 6f 20 72 65 73 70 65 63 74 69 *pPgno respecti
89b0: 76 65 6c 79 2e 0a 2a 2a 20 41 6e 20 65 72 72 6f vely..** An erro
89c0: 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
89d0: 65 64 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 ed if something
89e0: 67 6f 65 73 20 77 72 6f 6e 67 2c 20 6f 74 68 65 goes wrong, othe
89f0: 72 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b 2e rwise SQLITE_OK.
8a00: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
8a10: 74 72 6d 61 70 47 65 74 28 42 74 53 68 61 72 65 trmapGet(BtShare
8a20: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 d *pBt, Pgno key
8a30: 2c 20 75 38 20 2a 70 45 54 79 70 65 2c 20 50 67 , u8 *pEType, Pg
8a40: 6e 6f 20 2a 70 50 67 6e 6f 29 7b 0a 20 20 44 62 no *pPgno){. Db
8a50: 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 20 Page *pDbPage;
8a60: 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 20 /* The pointer
8a70: 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e map page */. in
8a80: 74 20 69 50 74 72 6d 61 70 3b 20 20 20 20 20 20 t iPtrmap;
8a90: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
8aa0: 70 61 67 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 page index */.
8ab0: 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 20 u8 *pPtrmap;
8ac0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 /* Pointer ma
8ad0: 70 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 p page data */.
8ae0: 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 20 int offset;
8af0: 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
8b00: 20 65 6e 74 72 79 20 69 6e 20 70 6f 69 6e 74 65 entry in pointe
8b10: 72 20 6d 61 70 20 2a 2f 0a 20 20 69 6e 74 20 72 r map */. int r
8b20: 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 c;.. assert( sq
8b30: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
8b40: 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a (pBt->mutex) );.
8b50: 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 . iPtrmap = PTR
8b60: 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
8b70: 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c key);. rc = sql
8b80: 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 ite3PagerGet(pBt
8b90: 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 ->pPager, iPtrma
8ba0: 70 2c 20 26 70 44 62 50 61 67 65 2c 20 30 29 3b p, &pDbPage, 0);
8bb0: 0a 20 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a . if( rc!=0 ){.
8bc0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
8bd0: 20 7d 0a 20 20 70 50 74 72 6d 61 70 20 3d 20 28 }. pPtrmap = (
8be0: 75 38 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 u8 *)sqlite3Page
8bf0: 72 47 65 74 44 61 74 61 28 70 44 62 50 61 67 65 rGetData(pDbPage
8c00: 29 3b 0a 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 );.. offset = P
8c10: 54 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 TRMAP_PTROFFSET(
8c20: 69 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 iPtrmap, key);.
8c30: 20 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b if( offset<0 ){
8c40: 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 . sqlite3Page
8c50: 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b rUnref(pDbPage);
8c60: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
8c70: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
8c80: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6f . }. assert( o
8c90: 66 66 73 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 ffset <= (int)pB
8ca0: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 t->usableSize-5
8cb0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 45 54 );. assert( pET
8cc0: 79 70 65 21 3d 30 20 29 3b 0a 20 20 2a 70 45 54 ype!=0 );. *pET
8cd0: 79 70 65 20 3d 20 70 50 74 72 6d 61 70 5b 6f 66 ype = pPtrmap[of
8ce0: 66 73 65 74 5d 3b 0a 20 20 69 66 28 20 70 50 67 fset];. if( pPg
8cf0: 6e 6f 20 29 20 2a 70 50 67 6e 6f 20 3d 20 67 65 no ) *pPgno = ge
8d00: 74 34 62 79 74 65 28 26 70 50 74 72 6d 61 70 5b t4byte(&pPtrmap[
8d10: 6f 66 66 73 65 74 2b 31 5d 29 3b 0a 0a 20 20 73 offset+1]);.. s
8d20: 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
8d30: 28 70 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 (pDbPage);. if(
8d40: 20 2a 70 45 54 79 70 65 3c 31 20 7c 7c 20 2a 70 *pEType<1 || *p
8d50: 45 54 79 70 65 3e 35 20 29 20 72 65 74 75 72 6e EType>5 ) return
8d60: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
8d70: 50 47 4e 4f 28 69 50 74 72 6d 61 70 29 3b 0a 20 PGNO(iPtrmap);.
8d80: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
8d90: 4b 3b 0a 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 K;.}..#else /* i
8da0: 66 20 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45 f defined SQLITE
8db0: 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
8dc0: 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 70 74 */. #define pt
8dd0: 72 6d 61 70 50 75 74 28 77 2c 78 2c 79 2c 7a 2c rmapPut(w,x,y,z,
8de0: 72 63 29 0a 20 20 23 64 65 66 69 6e 65 20 70 74 rc). #define pt
8df0: 72 6d 61 70 47 65 74 28 77 2c 78 2c 79 2c 7a 29 rmapGet(w,x,y,z)
8e00: 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 SQLITE_OK. #de
8e10: 66 69 6e 65 20 70 74 72 6d 61 70 50 75 74 4f 76 fine ptrmapPutOv
8e20: 66 6c 50 74 72 28 78 2c 20 79 2c 20 7a 2c 20 72 flPtr(x, y, z, r
8e30: 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a c).#endif../*.**
8e40: 20 47 69 76 65 6e 20 61 20 62 74 72 65 65 20 70 Given a btree p
8e50: 61 67 65 20 61 6e 64 20 61 20 63 65 6c 6c 20 69 age and a cell i
8e60: 6e 64 65 78 20 28 30 20 6d 65 61 6e 73 20 74 68 ndex (0 means th
8e70: 65 20 66 69 72 73 74 20 63 65 6c 6c 20 6f 6e 0a e first cell on.
8e80: 2a 2a 20 74 68 65 20 70 61 67 65 2c 20 31 20 6d ** the page, 1 m
8e90: 65 61 6e 73 20 74 68 65 20 73 65 63 6f 6e 64 20 eans the second
8ea0: 63 65 6c 6c 2c 20 61 6e 64 20 73 6f 20 66 6f 72 cell, and so for
8eb0: 74 68 29 20 72 65 74 75 72 6e 20 61 20 70 6f 69 th) return a poi
8ec0: 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 63 nter.** to the c
8ed0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e 0a 2a 2a 0a ell content..**.
8ee0: 2a 2a 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 50 ** findCellPastP
8ef0: 74 72 28 29 20 64 6f 65 73 20 74 68 65 20 73 61 tr() does the sa
8f00: 6d 65 20 65 78 63 65 70 74 20 69 74 20 73 6b 69 me except it ski
8f10: 70 73 20 70 61 73 74 20 74 68 65 20 69 6e 69 74 ps past the init
8f20: 69 61 6c 0a 2a 2a 20 34 2d 62 79 74 65 20 63 68 ial.** 4-byte ch
8f30: 69 6c 64 20 70 6f 69 6e 74 65 72 20 66 6f 75 6e ild pointer foun
8f40: 64 20 6f 6e 20 69 6e 74 65 72 69 6f 72 20 70 61 d on interior pa
8f50: 67 65 73 2c 20 69 66 20 74 68 65 72 65 20 69 73 ges, if there is
8f60: 20 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 one..**.** This
8f70: 20 72 6f 75 74 69 6e 65 20 77 6f 72 6b 73 20 6f routine works o
8f80: 6e 6c 79 20 66 6f 72 20 70 61 67 65 73 20 74 68 nly for pages th
8f90: 61 74 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 at do not contai
8fa0: 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 n overflow cells
8fb0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 66 69 6e ..*/.#define fin
8fc0: 64 43 65 6c 6c 28 50 2c 49 29 20 5c 0a 20 20 28 dCell(P,I) \. (
8fd0: 28 50 29 2d 3e 61 44 61 74 61 20 2b 20 28 28 50 (P)->aData + ((P
8fe0: 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 20 67 65 )->maskPage & ge
8ff0: 74 32 62 79 74 65 41 6c 69 67 6e 65 64 28 26 28 t2byteAligned(&(
9000: 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 28 P)->aCellIdx[2*(
9010: 49 29 5d 29 29 29 0a 23 64 65 66 69 6e 65 20 66 I)]))).#define f
9020: 69 6e 64 43 65 6c 6c 50 61 73 74 50 74 72 28 50 indCellPastPtr(P
9030: 2c 49 29 20 5c 0a 20 20 28 28 50 29 2d 3e 61 44 ,I) \. ((P)->aD
9040: 61 74 61 4f 66 73 74 20 2b 20 28 28 50 29 2d 3e ataOfst + ((P)->
9050: 6d 61 73 6b 50 61 67 65 20 26 20 67 65 74 32 62 maskPage & get2b
9060: 79 74 65 41 6c 69 67 6e 65 64 28 26 28 50 29 2d yteAligned(&(P)-
9070: 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 28 49 29 5d >aCellIdx[2*(I)]
9080: 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ))).../*.** This
9090: 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 61 69 6c 20 is common tail
90a0: 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 62 processing for b
90b0: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
90c0: 28 29 20 61 6e 64 0a 2a 2a 20 62 74 72 65 65 50 () and.** btreeP
90d0: 61 72 73 65 43 65 6c 6c 50 74 72 49 6e 64 65 78 arseCellPtrIndex
90e0: 28 29 20 66 6f 72 20 74 68 65 20 63 61 73 65 20 () for the case
90f0: 77 68 65 6e 20 74 68 65 20 63 65 6c 6c 20 64 6f when the cell do
9100: 65 73 20 6e 6f 74 20 66 69 74 20 65 6e 74 69 72 es not fit entir
9110: 65 6c 79 0a 2a 2a 20 6f 6e 20 61 20 73 69 6e 67 ely.** on a sing
9120: 6c 65 20 42 2d 74 72 65 65 20 70 61 67 65 2e 20 le B-tree page.
9130: 20 4d 61 6b 65 20 6e 65 63 65 73 73 61 72 79 20 Make necessary
9140: 61 64 6a 75 73 74 6d 65 6e 74 73 20 74 6f 20 74 adjustments to t
9150: 68 65 20 43 65 6c 6c 49 6e 66 6f 0a 2a 2a 20 73 he CellInfo.** s
9160: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 61 tructure..*/.sta
9170: 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c tic SQLITE_NOINL
9180: 49 4e 45 20 76 6f 69 64 20 62 74 72 65 65 50 61 INE void btreePa
9190: 72 73 65 43 65 6c 6c 41 64 6a 75 73 74 53 69 7a rseCellAdjustSiz
91a0: 65 46 6f 72 4f 76 65 72 66 6c 6f 77 28 0a 20 20 eForOverflow(.
91b0: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
91c0: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
91d0: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
91e0: 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 ell */. u8 *pCe
91f0: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
9200: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 /* Pointer to t
9210: 68 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f he cell text. */
9220: 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e . CellInfo *pIn
9230: 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 fo /* Fi
9240: 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 ll in this struc
9250: 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 ture */.){. /*
9260: 49 66 20 74 68 65 20 70 61 79 6c 6f 61 64 20 77 If the payload w
9270: 69 6c 6c 20 6e 6f 74 20 66 69 74 20 63 6f 6d 70 ill not fit comp
9280: 6c 65 74 65 6c 79 20 6f 6e 20 74 68 65 20 6c 6f letely on the lo
9290: 63 61 6c 20 70 61 67 65 2c 20 77 65 20 68 61 76 cal page, we hav
92a0: 65 0a 20 20 2a 2a 20 74 6f 20 64 65 63 69 64 65 e. ** to decide
92b0: 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 74 6f how much to sto
92c0: 72 65 20 6c 6f 63 61 6c 6c 79 20 61 6e 64 20 68 re locally and h
92d0: 6f 77 20 6d 75 63 68 20 74 6f 20 73 70 69 6c 6c ow much to spill
92e0: 20 6f 6e 74 6f 0a 20 20 2a 2a 20 6f 76 65 72 66 onto. ** overf
92f0: 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 68 65 20 low pages. The
9300: 73 74 72 61 74 65 67 79 20 69 73 20 74 6f 20 6d strategy is to m
9310: 69 6e 69 6d 69 7a 65 20 74 68 65 20 61 6d 6f 75 inimize the amou
9320: 6e 74 20 6f 66 20 75 6e 75 73 65 64 0a 20 20 2a nt of unused. *
9330: 2a 20 73 70 61 63 65 20 6f 6e 20 6f 76 65 72 66 * space on overf
9340: 6c 6f 77 20 70 61 67 65 73 20 77 68 69 6c 65 20 low pages while
9350: 6b 65 65 70 69 6e 67 20 74 68 65 20 61 6d 6f 75 keeping the amou
9360: 6e 74 20 6f 66 20 6c 6f 63 61 6c 20 73 74 6f 72 nt of local stor
9370: 61 67 65 0a 20 20 2a 2a 20 69 6e 20 62 65 74 77 age. ** in betw
9380: 65 65 6e 20 6d 69 6e 4c 6f 63 61 6c 20 61 6e 64 een minLocal and
9390: 20 6d 61 78 4c 6f 63 61 6c 2e 0a 20 20 2a 2a 0a maxLocal.. **.
93a0: 20 20 2a 2a 20 57 61 72 6e 69 6e 67 3a 20 20 63 ** Warning: c
93b0: 68 61 6e 67 69 6e 67 20 74 68 65 20 77 61 79 20 hanging the way
93c0: 6f 76 65 72 66 6c 6f 77 20 70 61 79 6c 6f 61 64 overflow payload
93d0: 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 is distributed
93e0: 69 6e 20 61 6e 79 0a 20 20 2a 2a 20 77 61 79 20 in any. ** way
93f0: 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 will result in a
9400: 6e 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 66 n incompatible f
9410: 69 6c 65 20 66 6f 72 6d 61 74 2e 0a 20 20 2a 2f ile format.. */
9420: 0a 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 3b . int minLocal;
9430: 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 61 6d 6f /* Minimum amo
9440: 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 unt of payload h
9450: 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 eld locally */.
9460: 20 69 6e 74 20 6d 61 78 4c 6f 63 61 6c 3b 20 20 int maxLocal;
9470: 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e /* Maximum amoun
9480: 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 68 65 6c t of payload hel
9490: 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a 20 20 69 d locally */. i
94a0: 6e 74 20 73 75 72 70 6c 75 73 3b 20 20 20 2f 2a nt surplus; /*
94b0: 20 4f 76 65 72 66 6c 6f 77 20 70 61 79 6c 6f 61 Overflow payloa
94c0: 64 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 d available for
94d0: 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 20 2a 2f local storage */
94e0: 0a 0a 20 20 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 .. minLocal = p
94f0: 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a Page->minLocal;.
9500: 20 20 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 50 61 maxLocal = pPa
9510: 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 20 ge->maxLocal;.
9520: 73 75 72 70 6c 75 73 20 3d 20 6d 69 6e 4c 6f 63 surplus = minLoc
9530: 61 6c 20 2b 20 28 70 49 6e 66 6f 2d 3e 6e 50 61 al + (pInfo->nPa
9540: 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c 6f 63 61 6c yload - minLocal
9550: 29 25 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 )%(pPage->pBt->u
9560: 73 61 62 6c 65 53 69 7a 65 2d 34 29 3b 0a 20 20 sableSize-4);.
9570: 74 65 73 74 63 61 73 65 28 20 73 75 72 70 6c 75 testcase( surplu
9580: 73 3d 3d 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 s==maxLocal );.
9590: 20 74 65 73 74 63 61 73 65 28 20 73 75 72 70 6c testcase( surpl
95a0: 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 us==maxLocal+1 )
95b0: 3b 0a 20 20 69 66 28 20 73 75 72 70 6c 75 73 20 ;. if( surplus
95c0: 3c 3d 20 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 <= maxLocal ){.
95d0: 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c pInfo->nLocal
95e0: 20 3d 20 28 75 31 36 29 73 75 72 70 6c 75 73 3b = (u16)surplus;
95f0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 . }else{. pI
9600: 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 nfo->nLocal = (u
9610: 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 7d 16)minLocal;. }
9620: 0a 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 . pInfo->nSize
9630: 3d 20 28 75 31 36 29 28 26 70 49 6e 66 6f 2d 3e = (u16)(&pInfo->
9640: 70 50 61 79 6c 6f 61 64 5b 70 49 6e 66 6f 2d 3e pPayload[pInfo->
9650: 6e 4c 6f 63 61 6c 5d 20 2d 20 70 43 65 6c 6c 29 nLocal] - pCell)
9660: 20 2b 20 34 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 + 4;.}../*.** T
9670: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 he following rou
9680: 74 69 6e 65 73 20 61 72 65 20 69 6d 70 6c 65 6d tines are implem
9690: 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 entations of the
96a0: 20 4d 65 6d 50 61 67 65 2e 78 50 61 72 73 65 43 MemPage.xParseC
96b0: 65 6c 6c 28 29 0a 2a 2a 20 6d 65 74 68 6f 64 2e ell().** method.
96c0: 0a 2a 2a 0a 2a 2a 20 50 61 72 73 65 20 61 20 63 .**.** Parse a c
96d0: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 6c 6f 63 ell content bloc
96e0: 6b 20 61 6e 64 20 66 69 6c 6c 20 69 6e 20 74 68 k and fill in th
96f0: 65 20 43 65 6c 6c 49 6e 66 6f 20 73 74 72 75 63 e CellInfo struc
9700: 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 62 74 72 65 ture..**.** btre
9710: 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 29 20 eParseCellPtr()
9720: 20 20 20 20 20 20 20 3d 3e 20 20 20 74 61 62 6c => tabl
9730: 65 20 62 74 72 65 65 20 6c 65 61 66 20 6e 6f 64 e btree leaf nod
9740: 65 73 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 es.** btreeParse
9750: 43 65 6c 6c 4e 6f 50 61 79 6c 6f 61 64 28 29 20 CellNoPayload()
9760: 20 3d 3e 20 20 20 74 61 62 6c 65 20 62 74 72 65 => table btre
9770: 65 20 69 6e 74 65 72 6e 61 6c 20 6e 6f 64 65 73 e internal nodes
9780: 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 43 65 .** btreeParseCe
9790: 6c 6c 50 74 72 49 6e 64 65 78 28 29 20 20 20 3d llPtrIndex() =
97a0: 3e 20 20 20 69 6e 64 65 78 20 62 74 72 65 65 20 > index btree
97b0: 6e 6f 64 65 73 0a 2a 2a 0a 2a 2a 20 54 68 65 72 nodes.**.** Ther
97c0: 65 20 69 73 20 61 6c 73 6f 20 61 20 77 72 61 70 e is also a wrap
97d0: 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 62 74 72 per function btr
97e0: 65 65 50 61 72 73 65 43 65 6c 6c 28 29 20 74 68 eeParseCell() th
97f0: 61 74 20 77 6f 72 6b 73 20 66 6f 72 0a 2a 2a 20 at works for.**
9800: 61 6c 6c 20 4d 65 6d 50 61 67 65 20 74 79 70 65 all MemPage type
9810: 73 20 61 6e 64 20 74 68 61 74 20 72 65 66 65 72 s and that refer
9820: 65 6e 63 65 73 20 74 68 65 20 63 65 6c 6c 20 62 ences the cell b
9830: 79 20 69 6e 64 65 78 20 72 61 74 68 65 72 20 74 y index rather t
9840: 68 61 6e 0a 2a 2a 20 62 79 20 70 6f 69 6e 74 65 han.** by pointe
9850: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 r..*/.static voi
9860: 64 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c d btreeParseCell
9870: 50 74 72 4e 6f 50 61 79 6c 6f 61 64 28 0a 20 20 PtrNoPayload(.
9880: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
9890: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
98a0: 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 containing the c
98b0: 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 ell */. u8 *pCe
98c0: 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ll,
98d0: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 /* Pointer to t
98e0: 68 65 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f he cell text. */
98f0: 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e . CellInfo *pIn
9900: 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 fo /* Fi
9910: 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 ll in this struc
9920: 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 61 73 73 ture */.){. ass
9930: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
9940: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
9950: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
9960: 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6c assert( pPage->l
9970: 65 61 66 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 eaf==0 );. asse
9980: 72 74 28 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 rt( pPage->child
9990: 50 74 72 53 69 7a 65 3d 3d 34 20 29 3b 0a 23 69 PtrSize==4 );.#i
99a0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 fndef SQLITE_DEB
99b0: 55 47 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 UG. UNUSED_PARA
99c0: 4d 45 54 45 52 28 70 50 61 67 65 29 3b 0a 23 65 METER(pPage);.#e
99d0: 6e 64 69 66 0a 20 20 70 49 6e 66 6f 2d 3e 6e 53 ndif. pInfo->nS
99e0: 69 7a 65 20 3d 20 34 20 2b 20 67 65 74 56 61 72 ize = 4 + getVar
99f0: 69 6e 74 28 26 70 43 65 6c 6c 5b 34 5d 2c 20 28 int(&pCell[4], (
9a00: 75 36 34 2a 29 26 70 49 6e 66 6f 2d 3e 6e 4b 65 u64*)&pInfo->nKe
9a10: 79 29 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 50 61 y);. pInfo->nPa
9a20: 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 70 49 6e yload = 0;. pIn
9a30: 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 30 3b 0a fo->nLocal = 0;.
9a40: 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 6c 6f 61 pInfo->pPayloa
9a50: 64 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 3b d = 0;. return;
9a60: 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 .}.static void b
9a70: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
9a80: 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 (. MemPage *pPa
9a90: 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 ge, /* P
9aa0: 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 age containing t
9ab0: 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 he cell */. u8
9ac0: 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 *pCell,
9ad0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
9ae0: 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 to the cell text
9af0: 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 . */. CellInfo
9b00: 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f *pInfo /
9b10: 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 * Fill in this s
9b20: 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 tructure */.){.
9b30: 20 75 38 20 2a 70 49 74 65 72 3b 20 20 20 20 20 u8 *pIter;
9b40: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 /* For
9b50: 73 63 61 6e 6e 69 6e 67 20 74 68 72 6f 75 67 68 scanning through
9b60: 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 33 32 20 pCell */. u32
9b70: 6e 50 61 79 6c 6f 61 64 3b 20 20 20 20 20 20 20 nPayload;
9b80: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
9b90: 20 62 79 74 65 73 20 6f 66 20 63 65 6c 6c 20 70 bytes of cell p
9ba0: 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 75 36 34 20 ayload */. u64
9bb0: 69 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 iKey;
9bc0: 20 20 20 20 2f 2a 20 45 78 74 72 61 63 74 65 64 /* Extracted
9bd0: 20 4b 65 79 20 76 61 6c 75 65 20 2a 2f 0a 0a 20 Key value */..
9be0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
9bf0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
9c00: 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
9c10: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
9c20: 65 2d 3e 6c 65 61 66 3d 3d 30 20 7c 7c 20 70 50 e->leaf==0 || pP
9c30: 61 67 65 2d 3e 6c 65 61 66 3d 3d 31 20 29 3b 0a age->leaf==1 );.
9c40: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
9c50: 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 3b 0a 20 >intKeyLeaf );.
9c60: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
9c70: 63 68 69 6c 64 50 74 72 53 69 7a 65 3d 3d 30 20 childPtrSize==0
9c80: 29 3b 0a 20 20 70 49 74 65 72 20 3d 20 70 43 65 );. pIter = pCe
9c90: 6c 6c 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 6e 65 ll;.. /* The ne
9ca0: 78 74 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 xt block of code
9cb0: 20 69 73 20 65 71 75 69 76 61 6c 65 6e 74 20 74 is equivalent t
9cc0: 6f 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 o:. **. **
9cd0: 20 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 72 pIter += getVar
9ce0: 69 6e 74 33 32 28 70 49 74 65 72 2c 20 6e 50 61 int32(pIter, nPa
9cf0: 79 6c 6f 61 64 29 3b 0a 20 20 2a 2a 0a 20 20 2a yload);. **. *
9d00: 2a 20 54 68 65 20 63 6f 64 65 20 69 73 20 69 6e * The code is in
9d10: 6c 69 6e 65 64 20 74 6f 20 61 76 6f 69 64 20 61 lined to avoid a
9d20: 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 2e 0a function call..
9d30: 20 20 2a 2f 0a 20 20 6e 50 61 79 6c 6f 61 64 20 */. nPayload
9d40: 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 66 28 20 = *pIter;. if(
9d50: 6e 50 61 79 6c 6f 61 64 3e 3d 30 78 38 30 20 29 nPayload>=0x80 )
9d60: 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 64 20 3d {. u8 *pEnd =
9d70: 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 20 20 20 &pIter[8];.
9d80: 6e 50 61 79 6c 6f 61 64 20 26 3d 20 30 78 37 66 nPayload &= 0x7f
9d90: 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 ;. do{.
9da0: 6e 50 61 79 6c 6f 61 64 20 3d 20 28 6e 50 61 79 nPayload = (nPay
9db0: 6c 6f 61 64 3c 3c 37 29 20 7c 20 28 2a 2b 2b 70 load<<7) | (*++p
9dc0: 49 74 65 72 20 26 20 30 78 37 66 29 3b 0a 20 20 Iter & 0x7f);.
9dd0: 20 20 7d 77 68 69 6c 65 28 20 28 2a 70 49 74 65 }while( (*pIte
9de0: 72 29 3e 3d 30 78 38 30 20 26 26 20 70 49 74 65 r)>=0x80 && pIte
9df0: 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a 20 20 r<pEnd );. }.
9e00: 70 49 74 65 72 2b 2b 3b 0a 0a 20 20 2f 2a 20 54 pIter++;.. /* T
9e10: 68 65 20 6e 65 78 74 20 62 6c 6f 63 6b 20 6f 66 he next block of
9e20: 20 63 6f 64 65 20 69 73 20 65 71 75 69 76 61 6c code is equival
9e30: 65 6e 74 20 74 6f 3a 0a 20 20 2a 2a 0a 20 20 2a ent to:. **. *
9e40: 2a 20 20 20 20 20 70 49 74 65 72 20 2b 3d 20 67 * pIter += g
9e50: 65 74 56 61 72 69 6e 74 28 70 49 74 65 72 2c 20 etVarint(pIter,
9e60: 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d 3e 6e 4b (u64*)&pInfo->nK
9e70: 65 79 29 3b 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 ey);. **. ** T
9e80: 68 65 20 63 6f 64 65 20 69 73 20 69 6e 6c 69 6e he code is inlin
9e90: 65 64 20 74 6f 20 61 76 6f 69 64 20 61 20 66 75 ed to avoid a fu
9ea0: 6e 63 74 69 6f 6e 20 63 61 6c 6c 2e 0a 20 20 2a nction call.. *
9eb0: 2f 0a 20 20 69 4b 65 79 20 3d 20 2a 70 49 74 65 /. iKey = *pIte
9ec0: 72 3b 0a 20 20 69 66 28 20 69 4b 65 79 3e 3d 30 r;. if( iKey>=0
9ed0: 78 38 30 20 29 7b 0a 20 20 20 20 75 38 20 2a 70 x80 ){. u8 *p
9ee0: 45 6e 64 20 3d 20 26 70 49 74 65 72 5b 37 5d 3b End = &pIter[7];
9ef0: 0a 20 20 20 20 69 4b 65 79 20 26 3d 20 30 78 37 . iKey &= 0x7
9f00: 66 3b 0a 20 20 20 20 77 68 69 6c 65 28 31 29 7b f;. while(1){
9f10: 0a 20 20 20 20 20 20 69 4b 65 79 20 3d 20 28 69 . iKey = (i
9f20: 4b 65 79 3c 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 Key<<7) | (*++pI
9f30: 74 65 72 20 26 20 30 78 37 66 29 3b 0a 20 20 20 ter & 0x7f);.
9f40: 20 20 20 69 66 28 20 28 2a 70 49 74 65 72 29 3c if( (*pIter)<
9f50: 30 78 38 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 0x80 ) break;.
9f60: 20 20 20 20 69 66 28 20 70 49 74 65 72 3e 3d 70 if( pIter>=p
9f70: 45 6e 64 20 29 7b 0a 20 20 20 20 20 20 20 20 69 End ){. i
9f80: 4b 65 79 20 3d 20 28 69 4b 65 79 3c 3c 38 29 20 Key = (iKey<<8)
9f90: 7c 20 2a 2b 2b 70 49 74 65 72 3b 0a 20 20 20 20 | *++pIter;.
9fa0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
9fb0: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 70 }. }. }. p
9fc0: 49 74 65 72 2b 2b 3b 0a 0a 20 20 70 49 6e 66 6f Iter++;.. pInfo
9fd0: 2d 3e 6e 4b 65 79 20 3d 20 2a 28 69 36 34 2a 29 ->nKey = *(i64*)
9fe0: 26 69 4b 65 79 3b 0a 20 20 70 49 6e 66 6f 2d 3e &iKey;. pInfo->
9ff0: 6e 50 61 79 6c 6f 61 64 20 3d 20 6e 50 61 79 6c nPayload = nPayl
a000: 6f 61 64 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 oad;. pInfo->pP
a010: 61 79 6c 6f 61 64 20 3d 20 70 49 74 65 72 3b 0a ayload = pIter;.
a020: 20 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 79 testcase( nPay
a030: 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 load==pPage->max
a040: 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 63 Local );. testc
a050: 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 ase( nPayload==p
a060: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 Page->maxLocal+1
a070: 20 29 3b 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f );. if( nPaylo
a080: 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f ad<=pPage->maxLo
a090: 63 61 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 cal ){. /* Th
a0a0: 69 73 20 69 73 20 74 68 65 20 28 65 61 73 79 29 is is the (easy)
a0b0: 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 common case whe
a0c0: 72 65 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 re the entire pa
a0d0: 79 6c 6f 61 64 20 66 69 74 73 0a 20 20 20 20 2a yload fits. *
a0e0: 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c 20 70 * on the local p
a0f0: 61 67 65 2e 20 20 4e 6f 20 6f 76 65 72 66 6c 6f age. No overflo
a100: 77 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 20 w is required..
a110: 20 20 20 2a 2f 0a 20 20 20 20 70 49 6e 66 6f 2d */. pInfo-
a120: 3e 6e 53 69 7a 65 20 3d 20 6e 50 61 79 6c 6f 61 >nSize = nPayloa
a130: 64 20 2b 20 28 75 31 36 29 28 70 49 74 65 72 20 d + (u16)(pIter
a140: 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 - pCell);. if
a150: 28 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 3c 34 ( pInfo->nSize<4
a160: 20 29 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 ) pInfo->nSize
a170: 3d 20 34 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e = 4;. pInfo->
a180: 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 6e 50 nLocal = (u16)nP
a190: 61 79 6c 6f 61 64 3b 0a 20 20 7d 65 6c 73 65 7b ayload;. }else{
a1a0: 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 . btreeParseC
a1b0: 65 6c 6c 41 64 6a 75 73 74 53 69 7a 65 46 6f 72 ellAdjustSizeFor
a1c0: 4f 76 65 72 66 6c 6f 77 28 70 50 61 67 65 2c 20 Overflow(pPage,
a1d0: 70 43 65 6c 6c 2c 20 70 49 6e 66 6f 29 3b 0a 20 pCell, pInfo);.
a1e0: 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 }.}.static void
a1f0: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
a200: 74 72 49 6e 64 65 78 28 0a 20 20 4d 65 6d 50 61 trIndex(. MemPa
a210: 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 ge *pPage,
a220: 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 /* Page conta
a230: 69 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a ining the cell *
a240: 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c 20 20 /. u8 *pCell,
a250: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
a260: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 63 65 ointer to the ce
a270: 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 43 65 ll text. */. Ce
a280: 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 llInfo *pInfo
a290: 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 69 6e /* Fill in
a2a0: 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 this structure
a2b0: 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 */.){. u8 *pIte
a2c0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
a2d0: 2f 2a 20 46 6f 72 20 73 63 61 6e 6e 69 6e 67 20 /* For scanning
a2e0: 74 68 72 6f 75 67 68 20 70 43 65 6c 6c 20 2a 2f through pCell */
a2f0: 0a 20 20 75 33 32 20 6e 50 61 79 6c 6f 61 64 3b . u32 nPayload;
a300: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
a310: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 mber of bytes of
a320: 20 63 65 6c 6c 20 70 61 79 6c 6f 61 64 20 2a 2f cell payload */
a330: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
a340: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
a350: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
a360: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
a370: 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 20 7c 7c Page->leaf==0 ||
a380: 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 31 20 pPage->leaf==1
a390: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
a3a0: 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 3d 3d ge->intKeyLeaf==
a3b0: 30 20 29 3b 0a 20 20 70 49 74 65 72 20 3d 20 70 0 );. pIter = p
a3c0: 43 65 6c 6c 20 2b 20 70 50 61 67 65 2d 3e 63 68 Cell + pPage->ch
a3d0: 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 6e 50 ildPtrSize;. nP
a3e0: 61 79 6c 6f 61 64 20 3d 20 2a 70 49 74 65 72 3b ayload = *pIter;
a3f0: 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3e . if( nPayload>
a400: 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 75 38 20 =0x80 ){. u8
a410: 2a 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b 38 *pEnd = &pIter[8
a420: 5d 3b 0a 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 ];. nPayload
a430: 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 64 6f 7b &= 0x7f;. do{
a440: 0a 20 20 20 20 20 20 6e 50 61 79 6c 6f 61 64 20 . nPayload
a450: 3d 20 28 6e 50 61 79 6c 6f 61 64 3c 3c 37 29 20 = (nPayload<<7)
a460: 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 20 30 78 | (*++pIter & 0x
a470: 37 66 29 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 7f);. }while(
a480: 20 2a 28 70 49 74 65 72 29 3e 3d 30 78 38 30 20 *(pIter)>=0x80
a490: 26 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b && pIter<pEnd );
a4a0: 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b 2b 3b 0a . }. pIter++;.
a4b0: 20 20 70 49 6e 66 6f 2d 3e 6e 4b 65 79 20 3d 20 pInfo->nKey =
a4c0: 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 nPayload;. pInf
a4d0: 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 6e 50 o->nPayload = nP
a4e0: 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 6f 2d ayload;. pInfo-
a4f0: 3e 70 50 61 79 6c 6f 61 64 20 3d 20 70 49 74 65 >pPayload = pIte
a500: 72 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e r;. testcase( n
a510: 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e Payload==pPage->
a520: 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 maxLocal );. te
a530: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
a540: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
a550: 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 50 61 l+1 );. if( nPa
a560: 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 yload<=pPage->ma
a570: 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 2f 2a xLocal ){. /*
a580: 20 54 68 69 73 20 69 73 20 74 68 65 20 28 65 61 This is the (ea
a590: 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 sy) common case
a5a0: 77 68 65 72 65 20 74 68 65 20 65 6e 74 69 72 65 where the entire
a5b0: 20 70 61 79 6c 6f 61 64 20 66 69 74 73 0a 20 20 payload fits.
a5c0: 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 61 ** on the loca
a5d0: 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f 76 65 72 l page. No over
a5e0: 66 6c 6f 77 20 69 73 20 72 65 71 75 69 72 65 64 flow is required
a5f0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 49 6e .. */. pIn
a600: 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 6e 50 61 79 fo->nSize = nPay
a610: 6c 6f 61 64 20 2b 20 28 75 31 36 29 28 70 49 74 load + (u16)(pIt
a620: 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 er - pCell);.
a630: 20 69 66 28 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a if( pInfo->nSiz
a640: 65 3c 34 20 29 20 70 49 6e 66 6f 2d 3e 6e 53 69 e<4 ) pInfo->nSi
a650: 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 49 6e 66 ze = 4;. pInf
a660: 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 o->nLocal = (u16
a670: 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 7d 65 6c )nPayload;. }el
a680: 73 65 7b 0a 20 20 20 20 62 74 72 65 65 50 61 72 se{. btreePar
a690: 73 65 43 65 6c 6c 41 64 6a 75 73 74 53 69 7a 65 seCellAdjustSize
a6a0: 46 6f 72 4f 76 65 72 66 6c 6f 77 28 70 50 61 67 ForOverflow(pPag
a6b0: 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e 66 6f 29 e, pCell, pInfo)
a6c0: 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 ;. }.}.static v
a6d0: 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 65 oid btreeParseCe
a6e0: 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 ll(. MemPage *p
a6f0: 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 2f 2a Page, /*
a700: 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 Page containing
a710: 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 the cell */. i
a720: 6e 74 20 69 43 65 6c 6c 2c 20 20 20 20 20 20 20 nt iCell,
a730: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 65 /* The ce
a740: 6c 6c 20 69 6e 64 65 78 2e 20 20 46 69 72 73 74 ll index. First
a750: 20 63 65 6c 6c 20 69 73 20 30 20 2a 2f 0a 20 20 cell is 0 */.
a760: 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 CellInfo *pInfo
a770: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 /* Fill
a780: 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 72 in this structur
a790: 65 20 2a 2f 0a 29 7b 0a 20 20 70 50 61 67 65 2d e */.){. pPage-
a7a0: 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 61 67 >xParseCell(pPag
a7b0: 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 e, findCell(pPag
a7c0: 65 2c 20 69 43 65 6c 6c 29 2c 20 70 49 6e 66 6f e, iCell), pInfo
a7d0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 );.}../*.** The
a7e0: 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 6e following routin
a7f0: 65 73 20 61 72 65 20 69 6d 70 6c 65 6d 65 6e 74 es are implement
a800: 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 4d 65 ations of the Me
a810: 6d 50 61 67 65 2e 78 43 65 6c 6c 53 69 7a 65 0a mPage.xCellSize.
a820: 2a 2a 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a ** method..**.**
a830: 20 43 6f 6d 70 75 74 65 20 74 68 65 20 74 6f 74 Compute the tot
a840: 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 al number of byt
a850: 65 73 20 74 68 61 74 20 61 20 43 65 6c 6c 20 6e es that a Cell n
a860: 65 65 64 73 20 69 6e 20 74 68 65 20 63 65 6c 6c eeds in the cell
a870: 0a 2a 2a 20 64 61 74 61 20 61 72 65 61 20 6f 66 .** data area of
a880: 20 74 68 65 20 62 74 72 65 65 2d 70 61 67 65 2e the btree-page.
a890: 20 20 54 68 65 20 72 65 74 75 72 6e 20 6e 75 6d The return num
a8a0: 62 65 72 20 69 6e 63 6c 75 64 65 73 20 74 68 65 ber includes the
a8b0: 20 63 65 6c 6c 0a 2a 2a 20 64 61 74 61 20 68 65 cell.** data he
a8c0: 61 64 65 72 20 61 6e 64 20 74 68 65 20 6c 6f 63 ader and the loc
a8d0: 61 6c 20 70 61 79 6c 6f 61 64 2c 20 62 75 74 20 al payload, but
a8e0: 6e 6f 74 20 61 6e 79 20 6f 76 65 72 66 6c 6f 77 not any overflow
a8f0: 20 70 61 67 65 20 6f 72 0a 2a 2a 20 74 68 65 20 page or.** the
a900: 73 70 61 63 65 20 75 73 65 64 20 62 79 20 74 68 space used by th
a910: 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 2e 0a e cell pointer..
a920: 2a 2a 0a 2a 2a 20 63 65 6c 6c 53 69 7a 65 50 74 **.** cellSizePt
a930: 72 4e 6f 50 61 79 6c 6f 61 64 28 29 20 20 20 20 rNoPayload()
a940: 3d 3e 20 20 20 74 61 62 6c 65 20 69 6e 74 65 72 => table inter
a950: 6e 61 6c 20 6e 6f 64 65 73 0a 2a 2a 20 63 65 6c nal nodes.** cel
a960: 6c 53 69 7a 65 50 74 72 28 29 20 20 20 20 20 20 lSizePtr()
a970: 20 20 20 20 20 20 20 3d 3e 20 20 20 61 6c 6c 20 => all
a980: 69 6e 64 65 78 20 6e 6f 64 65 73 20 26 20 74 61 index nodes & ta
a990: 62 6c 65 20 6c 65 61 66 20 6e 6f 64 65 73 0a 2a ble leaf nodes.*
a9a0: 2f 0a 73 74 61 74 69 63 20 75 31 36 20 63 65 6c /.static u16 cel
a9b0: 6c 53 69 7a 65 50 74 72 28 4d 65 6d 50 61 67 65 lSizePtr(MemPage
a9c0: 20 2a 70 50 61 67 65 2c 20 75 38 20 2a 70 43 65 *pPage, u8 *pCe
a9d0: 6c 6c 29 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 ll){. u8 *pIter
a9e0: 20 3d 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 = pCell + pPage
a9f0: 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 20 ->childPtrSize;
aa00: 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f /* For looping o
aa10: 76 65 72 20 62 79 74 65 73 20 6f 66 20 70 43 65 ver bytes of pCe
aa20: 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 45 6e 64 ll */. u8 *pEnd
aa30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
aa40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
aa50: 20 2f 2a 20 45 6e 64 20 6d 61 72 6b 20 66 6f 72 /* End mark for
aa60: 20 61 20 76 61 72 69 6e 74 20 2a 2f 0a 20 20 75 a varint */. u
aa70: 33 32 20 6e 53 69 7a 65 3b 20 20 20 20 20 20 20 32 nSize;
aa80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
aa90: 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
aaa0: 76 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 value to return
aab0: 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */..#ifdef SQLIT
aac0: 45 5f 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 E_DEBUG. /* The
aad0: 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 value returned
aae0: 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
aaf0: 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 should always b
ab00: 65 20 74 68 65 20 73 61 6d 65 20 61 73 0a 20 20 e the same as.
ab10: 2a 2a 20 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f ** the (CellInfo
ab20: 2e 6e 53 69 7a 65 29 20 76 61 6c 75 65 20 66 6f .nSize) value fo
ab30: 75 6e 64 20 62 79 20 64 6f 69 6e 67 20 61 20 66 und by doing a f
ab40: 75 6c 6c 20 70 61 72 73 65 20 6f 66 20 74 68 65 ull parse of the
ab50: 0a 20 20 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 . ** cell. If S
ab60: 51 4c 49 54 45 5f 44 45 42 55 47 20 69 73 20 64 QLITE_DEBUG is d
ab70: 65 66 69 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 efined, an asser
ab80: 74 28 29 20 61 74 20 74 68 65 20 62 6f 74 74 6f t() at the botto
ab90: 6d 20 6f 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 m of. ** this f
aba0: 75 6e 63 74 69 6f 6e 20 76 65 72 69 66 69 65 73 unction verifies
abb0: 20 74 68 61 74 20 74 68 69 73 20 69 6e 76 61 72 that this invar
abc0: 69 61 6e 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c iant is not viol
abd0: 61 74 65 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 ated. */. CellI
abe0: 6e 66 6f 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 nfo debuginfo;.
abf0: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
ac00: 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c ll(pPage, pCell,
ac10: 20 26 64 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 &debuginfo);.#e
ac20: 6e 64 69 66 0a 0a 20 20 6e 53 69 7a 65 20 3d 20 ndif.. nSize =
ac30: 2a 70 49 74 65 72 3b 0a 20 20 69 66 28 20 6e 53 *pIter;. if( nS
ac40: 69 7a 65 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 ize>=0x80 ){.
ac50: 20 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b 38 pEnd = &pIter[8
ac60: 5d 3b 0a 20 20 20 20 6e 53 69 7a 65 20 26 3d 20 ];. nSize &=
ac70: 30 78 37 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 0x7f;. do{.
ac80: 20 20 20 20 6e 53 69 7a 65 20 3d 20 28 6e 53 69 nSize = (nSi
ac90: 7a 65 3c 3c 37 29 20 7c 20 28 2a 2b 2b 70 49 74 ze<<7) | (*++pIt
aca0: 65 72 20 26 20 30 78 37 66 29 3b 0a 20 20 20 20 er & 0x7f);.
acb0: 7d 77 68 69 6c 65 28 20 2a 28 70 49 74 65 72 29 }while( *(pIter)
acc0: 3e 3d 30 78 38 30 20 26 26 20 70 49 74 65 72 3c >=0x80 && pIter<
acd0: 70 45 6e 64 20 29 3b 0a 20 20 7d 0a 20 20 70 49 pEnd );. }. pI
ace0: 74 65 72 2b 2b 3b 0a 20 20 69 66 28 20 70 50 61 ter++;. if( pPa
acf0: 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 ge->intKey ){.
ad00: 20 20 2f 2a 20 70 49 74 65 72 20 6e 6f 77 20 70 /* pIter now p
ad10: 6f 69 6e 74 73 20 61 74 20 74 68 65 20 36 34 2d oints at the 64-
ad20: 62 69 74 20 69 6e 74 65 67 65 72 20 6b 65 79 20 bit integer key
ad30: 76 61 6c 75 65 2c 20 61 20 76 61 72 69 61 62 6c value, a variabl
ad40: 65 20 6c 65 6e 67 74 68 20 0a 20 20 20 20 2a 2a e length . **
ad50: 20 69 6e 74 65 67 65 72 2e 20 54 68 65 20 66 6f integer. The fo
ad60: 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6d 6f llowing block mo
ad70: 76 65 73 20 70 49 74 65 72 20 74 6f 20 70 6f 69 ves pIter to poi
ad80: 6e 74 20 61 74 20 74 68 65 20 66 69 72 73 74 20 nt at the first
ad90: 62 79 74 65 0a 20 20 20 20 2a 2a 20 70 61 73 74 byte. ** past
ada0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
adb0: 6b 65 79 20 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 key value. */.
adc0: 20 20 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b pEnd = &pIter[
add0: 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 9];. while( (
ade0: 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 30 20 26 *pIter++)&0x80 &
adf0: 26 20 70 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a & pIter<pEnd );.
ae00: 20 20 7d 0a 20 20 74 65 73 74 63 61 73 65 28 20 }. testcase(
ae10: 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 nSize==pPage->ma
ae20: 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 xLocal );. test
ae30: 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 case( nSize==pPa
ae40: 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 ge->maxLocal+1 )
ae50: 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 3c 3d 70 ;. if( nSize<=p
ae60: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 Page->maxLocal )
ae70: 7b 0a 20 20 20 20 6e 53 69 7a 65 20 2b 3d 20 28 {. nSize += (
ae80: 75 33 32 29 28 70 49 74 65 72 20 2d 20 70 43 65 u32)(pIter - pCe
ae90: 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 6e 53 69 ll);. if( nSi
aea0: 7a 65 3c 34 20 29 20 6e 53 69 7a 65 20 3d 20 34 ze<4 ) nSize = 4
aeb0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 ;. }else{. i
aec0: 6e 74 20 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 50 nt minLocal = pP
aed0: 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 age->minLocal;.
aee0: 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f nSize = minLo
aef0: 63 61 6c 20 2b 20 28 6e 53 69 7a 65 20 2d 20 6d cal + (nSize - m
af00: 69 6e 4c 6f 63 61 6c 29 20 25 20 28 70 50 61 67 inLocal) % (pPag
af10: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
af20: 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 74 65 73 ze - 4);. tes
af30: 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 50 tcase( nSize==pP
af40: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b age->maxLocal );
af50: 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e . testcase( n
af60: 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 Size==pPage->max
af70: 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 69 Local+1 );. i
af80: 66 28 20 6e 53 69 7a 65 3e 70 50 61 67 65 2d 3e f( nSize>pPage->
af90: 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 maxLocal ){.
afa0: 20 20 6e 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f 63 nSize = minLoc
afb0: 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e 53 al;. }. nS
afc0: 69 7a 65 20 2b 3d 20 34 20 2b 20 28 75 31 36 29 ize += 4 + (u16)
afd0: 28 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b (pIter - pCell);
afe0: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6e . }. assert( n
aff0: 53 69 7a 65 3d 3d 64 65 62 75 67 69 6e 66 6f 2e Size==debuginfo.
b000: 6e 53 69 7a 65 20 7c 7c 20 43 4f 52 52 55 50 54 nSize || CORRUPT
b010: 5f 44 42 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 _DB );. return
b020: 28 75 31 36 29 6e 53 69 7a 65 3b 0a 7d 0a 73 74 (u16)nSize;.}.st
b030: 61 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a atic u16 cellSiz
b040: 65 50 74 72 4e 6f 50 61 79 6c 6f 61 64 28 4d 65 ePtrNoPayload(Me
b050: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 mPage *pPage, u8
b060: 20 2a 70 43 65 6c 6c 29 7b 0a 20 20 75 38 20 2a *pCell){. u8 *
b070: 70 49 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b 20 pIter = pCell +
b080: 34 3b 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 6e 4; /* For loopin
b090: 67 20 6f 76 65 72 20 62 79 74 65 73 20 6f 66 20 g over bytes of
b0a0: 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 pCell */. u8 *p
b0b0: 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 End;
b0c0: 20 20 2f 2a 20 45 6e 64 20 6d 61 72 6b 20 66 6f /* End mark fo
b0d0: 72 20 61 20 76 61 72 69 6e 74 20 2a 2f 0a 0a 23 r a varint */..#
b0e0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
b0f0: 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 61 6c 75 UG. /* The valu
b100: 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 e returned by th
b110: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 is function shou
b120: 6c 64 20 61 6c 77 61 79 73 20 62 65 20 74 68 65 ld always be the
b130: 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a 20 74 68 same as. ** th
b140: 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e 53 69 7a e (CellInfo.nSiz
b150: 65 29 20 76 61 6c 75 65 20 66 6f 75 6e 64 20 62 e) value found b
b160: 79 20 64 6f 69 6e 67 20 61 20 66 75 6c 6c 20 70 y doing a full p
b170: 61 72 73 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a arse of the. **
b180: 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c 49 54 45 cell. If SQLITE
b190: 5f 44 45 42 55 47 20 69 73 20 64 65 66 69 6e 65 _DEBUG is define
b1a0: 64 2c 20 61 6e 20 61 73 73 65 72 74 28 29 20 61 d, an assert() a
b1b0: 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 6f 66 0a t the bottom of.
b1c0: 20 20 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 ** this functi
b1d0: 6f 6e 20 76 65 72 69 66 69 65 73 20 74 68 61 74 on verifies that
b1e0: 20 74 68 69 73 20 69 6e 76 61 72 69 61 6e 74 20 this invariant
b1f0: 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 65 64 2e is not violated.
b200: 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 64 */. CellInfo d
b210: 65 62 75 67 69 6e 66 6f 3b 0a 20 20 70 50 61 67 ebuginfo;. pPag
b220: 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 e->xParseCell(pP
b230: 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 64 65 62 age, pCell, &deb
b240: 75 67 69 6e 66 6f 29 3b 0a 23 65 6c 73 65 0a 20 uginfo);.#else.
b250: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
b260: 52 28 70 50 61 67 65 29 3b 0a 23 65 6e 64 69 66 R(pPage);.#endif
b270: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
b280: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
b290: 3d 34 20 29 3b 0a 20 20 70 45 6e 64 20 3d 20 70 =4 );. pEnd = p
b2a0: 49 74 65 72 20 2b 20 39 3b 0a 20 20 77 68 69 6c Iter + 9;. whil
b2b0: 65 28 20 28 2a 70 49 74 65 72 2b 2b 29 26 30 78 e( (*pIter++)&0x
b2c0: 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 80 && pIter<pEnd
b2d0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 65 );. assert( de
b2e0: 62 75 67 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 28 buginfo.nSize==(
b2f0: 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 65 u16)(pIter - pCe
b300: 6c 6c 29 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 ll) || CORRUPT_D
b310: 42 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 75 B );. return (u
b320: 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 65 6c 16)(pIter - pCel
b330: 6c 29 3b 0a 7d 0a 0a 0a 23 69 66 64 65 66 20 53 l);.}...#ifdef S
b340: 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 20 54 QLITE_DEBUG./* T
b350: 68 69 73 20 76 61 72 69 61 74 69 6f 6e 20 6f 6e his variation on
b360: 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 29 20 69 cellSizePtr() i
b370: 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 6f 66 s used inside of
b380: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
b390: 65 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 2e 20 2a 2f ents.** only. */
b3a0: 0a 73 74 61 74 69 63 20 75 31 36 20 63 65 6c 6c .static u16 cell
b3b0: 53 69 7a 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 Size(MemPage *pP
b3c0: 61 67 65 2c 20 69 6e 74 20 69 43 65 6c 6c 29 7b age, int iCell){
b3d0: 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 2d . return pPage-
b3e0: 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 >xCellSize(pPage
b3f0: 2c 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 , findCell(pPage
b400: 2c 20 69 43 65 6c 6c 29 29 3b 0a 7d 0a 23 65 6e , iCell));.}.#en
b410: 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c dif..#ifndef SQL
b420: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
b430: 55 55 4d 0a 2f 2a 0a 2a 2a 20 54 68 65 20 63 65 UUM./*.** The ce
b440: 6c 6c 20 70 43 65 6c 6c 20 69 73 20 63 75 72 72 ll pCell is curr
b450: 65 6e 74 6c 79 20 70 61 72 74 20 6f 66 20 70 61 ently part of pa
b460: 67 65 20 70 53 72 63 20 62 75 74 20 77 69 6c 6c ge pSrc but will
b470: 20 75 6c 74 69 6d 61 74 65 6c 79 20 62 65 20 70 ultimately be p
b480: 61 72 74 0a 2a 2a 20 6f 66 20 70 50 61 67 65 2e art.** of pPage.
b490: 20 20 28 70 53 72 63 20 61 6e 64 20 70 50 61 67 (pSrc and pPag
b4a0: 65 72 20 61 72 65 20 6f 66 74 65 6e 20 74 68 65 er are often the
b4b0: 20 73 61 6d 65 2e 29 20 20 49 66 20 70 43 65 6c same.) If pCel
b4c0: 6c 20 63 6f 6e 74 61 69 6e 73 20 61 0a 2a 2a 20 l contains a.**
b4d0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 6f 76 pointer to an ov
b4e0: 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 69 6e 73 erflow page, ins
b4f0: 65 72 74 20 61 6e 20 65 6e 74 72 79 20 69 6e 74 ert an entry int
b500: 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 o the pointer-ma
b510: 70 20 66 6f 72 0a 2a 2a 20 74 68 65 20 6f 76 65 p for.** the ove
b520: 72 66 6c 6f 77 20 70 61 67 65 20 74 68 61 74 20 rflow page that
b530: 77 69 6c 6c 20 62 65 20 76 61 6c 69 64 20 61 66 will be valid af
b540: 74 65 72 20 70 43 65 6c 6c 20 68 61 73 20 62 65 ter pCell has be
b550: 65 6e 20 6d 6f 76 65 64 20 74 6f 20 70 50 61 67 en moved to pPag
b560: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 e..*/.static voi
b570: 64 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 d ptrmapPutOvflP
b580: 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 tr(MemPage *pPag
b590: 65 2c 20 4d 65 6d 50 61 67 65 20 2a 70 53 72 63 e, MemPage *pSrc
b5a0: 2c 20 75 38 20 2a 70 43 65 6c 6c 2c 69 6e 74 20 , u8 *pCell,int
b5b0: 2a 70 52 43 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 *pRC){. CellInf
b5c0: 6f 20 69 6e 66 6f 3b 0a 20 20 69 66 28 20 2a 70 o info;. if( *p
b5d0: 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 RC ) return;. a
b5e0: 73 73 65 72 74 28 20 70 43 65 6c 6c 21 3d 30 20 ssert( pCell!=0
b5f0: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 72 );. pPage->xPar
b600: 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 seCell(pPage, pC
b610: 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 69 ell, &info);. i
b620: 66 28 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 f( info.nLocal<i
b630: 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 7b 0a nfo.nPayload ){.
b640: 20 20 20 20 50 67 6e 6f 20 6f 76 66 6c 3b 0a 20 Pgno ovfl;.
b650: 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 57 49 if( SQLITE_WI
b660: 54 48 49 4e 28 70 53 72 63 2d 3e 61 44 61 74 61 THIN(pSrc->aData
b670: 45 6e 64 2c 20 70 43 65 6c 6c 2c 20 70 43 65 6c End, pCell, pCel
b680: 6c 2b 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 29 20 29 l+info.nLocal) )
b690: 7b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 {. testcase
b6a0: 28 20 70 53 72 63 21 3d 70 50 61 67 65 20 29 3b ( pSrc!=pPage );
b6b0: 0a 20 20 20 20 20 20 2a 70 52 43 20 3d 20 53 51 . *pRC = SQ
b6c0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
b6d0: 54 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 3b T;. return;
b6e0: 0a 20 20 20 20 7d 0a 20 20 20 20 6f 76 66 6c 20 . }. ovfl
b6f0: 3d 20 67 65 74 34 62 79 74 65 28 26 70 43 65 6c = get4byte(&pCel
b700: 6c 5b 69 6e 66 6f 2e 6e 53 69 7a 65 2d 34 5d 29 l[info.nSize-4])
b710: 3b 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 ;. ptrmapPut(
b720: 70 50 61 67 65 2d 3e 70 42 74 2c 20 6f 76 66 6c pPage->pBt, ovfl
b730: 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f , PTRMAP_OVERFLO
b740: 57 31 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f 2c W1, pPage->pgno,
b750: 20 70 52 43 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e pRC);. }.}.#en
b760: 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 72 dif.../*.** Defr
b770: 61 67 6d 65 6e 74 20 74 68 65 20 70 61 67 65 20 agment the page
b780: 67 69 76 65 6e 2e 20 54 68 69 73 20 72 6f 75 74 given. This rout
b790: 69 6e 65 20 72 65 6f 72 67 61 6e 69 7a 65 73 20 ine reorganizes
b7a0: 63 65 6c 6c 73 20 77 69 74 68 69 6e 20 74 68 65 cells within the
b7b0: 0a 2a 2a 20 70 61 67 65 20 73 6f 20 74 68 61 74 .** page so that
b7c0: 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 66 72 there are no fr
b7d0: 65 65 2d 62 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 ee-blocks on the
b7e0: 20 66 72 65 65 2d 62 6c 6f 63 6b 20 6c 69 73 74 free-block list
b7f0: 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 ..**.** Paramete
b800: 72 20 6e 4d 61 78 46 72 61 67 20 69 73 20 74 68 r nMaxFrag is th
b810: 65 20 6d 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 e maximum amount
b820: 20 6f 66 20 66 72 61 67 6d 65 6e 74 65 64 20 73 of fragmented s
b830: 70 61 63 65 20 74 68 61 74 20 6d 61 79 20 62 65 pace that may be
b840: 0a 2a 2a 20 70 72 65 73 65 6e 74 20 69 6e 20 74 .** present in t
b850: 68 65 20 70 61 67 65 20 61 66 74 65 72 20 74 68 he page after th
b860: 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 is routine retur
b870: 6e 73 2e 0a 2a 2a 0a 2a 2a 20 45 56 49 44 45 4e ns..**.** EVIDEN
b880: 43 45 2d 4f 46 3a 20 52 2d 34 34 35 38 32 2d 36 CE-OF: R-44582-6
b890: 30 31 33 38 20 53 51 4c 69 74 65 20 6d 61 79 20 0138 SQLite may
b8a0: 66 72 6f 6d 20 74 69 6d 65 20 74 6f 20 74 69 6d from time to tim
b8b0: 65 20 72 65 6f 72 67 61 6e 69 7a 65 20 61 0a 2a e reorganize a.*
b8c0: 2a 20 62 2d 74 72 65 65 20 70 61 67 65 20 73 6f * b-tree page so
b8d0: 20 74 68 61 74 20 74 68 65 72 65 20 61 72 65 20 that there are
b8e0: 6e 6f 20 66 72 65 65 62 6c 6f 63 6b 73 20 6f 72 no freeblocks or
b8f0: 20 66 72 61 67 6d 65 6e 74 20 62 79 74 65 73 2c fragment bytes,
b900: 20 61 6c 6c 0a 2a 2a 20 75 6e 75 73 65 64 20 62 all.** unused b
b910: 79 74 65 73 20 61 72 65 20 63 6f 6e 74 61 69 6e ytes are contain
b920: 65 64 20 69 6e 20 74 68 65 20 75 6e 61 6c 6c 6f ed in the unallo
b930: 63 61 74 65 64 20 73 70 61 63 65 20 72 65 67 69 cated space regi
b940: 6f 6e 2c 20 61 6e 64 20 61 6c 6c 0a 2a 2a 20 63 on, and all.** c
b950: 65 6c 6c 73 20 61 72 65 20 70 61 63 6b 65 64 20 ells are packed
b960: 74 69 67 68 74 6c 79 20 61 74 20 74 68 65 20 65 tightly at the e
b970: 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 2e 0a nd of the page..
b980: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 64 65 */.static int de
b990: 66 72 61 67 6d 65 6e 74 50 61 67 65 28 4d 65 6d fragmentPage(Mem
b9a0: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
b9b0: 20 6e 4d 61 78 46 72 61 67 29 7b 0a 20 20 69 6e nMaxFrag){. in
b9c0: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
b9d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
b9e0: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 6e counter */. in
b9f0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 t pc;
ba00: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 /* Addr
ba10: 65 73 73 20 6f 66 20 74 68 65 20 69 2d 74 68 20 ess of the i-th
ba20: 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 68 64 cell */. int hd
ba30: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
ba40: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 /* Offset t
ba50: 6f 20 74 68 65 20 70 61 67 65 20 68 65 61 64 65 o the page heade
ba60: 72 20 2a 2f 0a 20 20 69 6e 74 20 73 69 7a 65 3b r */. int size;
ba70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ba80: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 63 /* Size of a c
ba90: 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 ell */. int usa
baa0: 62 6c 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 bleSize;
bab0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
bac0: 20 75 73 61 62 6c 65 20 62 79 74 65 73 20 6f 6e usable bytes on
bad0: 20 61 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 a page */. int
bae0: 20 63 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 cellOffset;
baf0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
bb00: 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f t to the cell po
bb10: 69 6e 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 inter array */.
bb20: 20 69 6e 74 20 63 62 72 6b 3b 20 20 20 20 20 20 int cbrk;
bb30: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
bb40: 66 66 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c ffset to the cel
bb50: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a l content area *
bb60: 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 /. int nCell;
bb70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
bb80: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c * Number of cell
bb90: 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a 2f s on the page */
bba0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
bbb0: 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a *data; /*
bbc0: 20 54 68 65 20 70 61 67 65 20 64 61 74 61 20 2a The page data *
bbd0: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
bbe0: 72 20 2a 74 65 6d 70 3b 20 20 20 20 20 20 20 2f r *temp; /
bbf0: 2a 20 54 65 6d 70 20 61 72 65 61 20 66 6f 72 20 * Temp area for
bc00: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a cell content */.
bc10: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
bc20: 2a 73 72 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 *src; /*
bc30: 53 6f 75 72 63 65 20 6f 66 20 63 6f 6e 74 65 6e Source of conten
bc40: 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c t */. int iCell
bc50: 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20 20 First;
bc60: 20 20 2f 2a 20 46 69 72 73 74 20 61 6c 6c 6f 77 /* First allow
bc70: 61 62 6c 65 20 63 65 6c 6c 20 69 6e 64 65 78 20 able cell index
bc80: 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c 4c 61 */. int iCellLa
bc90: 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 st;
bca0: 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 6c 65 /* Last possible
bcb0: 20 63 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 0a cell index */..
bcc0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
bcd0: 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
bce0: 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
bcf0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
bd00: 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b 0a Page->pBt!=0 );.
bd10: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
bd20: 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
bd30: 20 3c 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 50 <= SQLITE_MAX_P
bd40: 41 47 45 5f 53 49 5a 45 20 29 3b 0a 20 20 61 73 AGE_SIZE );. as
bd50: 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f 76 sert( pPage->nOv
bd60: 65 72 66 6c 6f 77 3d 3d 30 20 29 3b 0a 20 20 61 erflow==0 );. a
bd70: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
bd80: 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
bd90: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
bda0: 20 20 74 65 6d 70 20 3d 20 30 3b 0a 20 20 73 72 temp = 0;. sr
bdb0: 63 20 3d 20 64 61 74 61 20 3d 20 70 50 61 67 65 c = data = pPage
bdc0: 2d 3e 61 44 61 74 61 3b 0a 20 20 68 64 72 20 3d ->aData;. hdr =
bdd0: 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 pPage->hdrOffse
bde0: 74 3b 0a 20 20 63 65 6c 6c 4f 66 66 73 65 74 20 t;. cellOffset
bdf0: 3d 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 = pPage->cellOff
be00: 73 65 74 3b 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 set;. nCell = p
be10: 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 61 Page->nCell;. a
be20: 73 73 65 72 74 28 20 6e 43 65 6c 6c 3d 3d 67 65 ssert( nCell==ge
be30: 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 t2byte(&data[hdr
be40: 2b 33 5d 29 20 29 3b 0a 20 20 69 43 65 6c 6c 46 +3]) );. iCellF
be50: 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 irst = cellOffse
be60: 74 20 2b 20 32 2a 6e 43 65 6c 6c 3b 0a 20 20 75 t + 2*nCell;. u
be70: 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 50 61 67 sableSize = pPag
be80: 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
be90: 7a 65 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 62 ze;.. /* This b
bea0: 6c 6f 63 6b 20 68 61 6e 64 6c 65 73 20 70 61 67 lock handles pag
beb0: 65 73 20 77 69 74 68 20 74 77 6f 20 6f 72 20 66 es with two or f
bec0: 65 77 65 72 20 66 72 65 65 20 62 6c 6f 63 6b 73 ewer free blocks
bed0: 20 61 6e 64 20 6e 4d 61 78 46 72 61 67 0a 20 20 and nMaxFrag.
bee0: 2a 2a 20 6f 72 20 66 65 77 65 72 20 66 72 61 67 ** or fewer frag
bef0: 6d 65 6e 74 65 64 20 62 79 74 65 73 2e 20 49 6e mented bytes. In
bf00: 20 74 68 69 73 20 63 61 73 65 20 69 74 20 69 73 this case it is
bf10: 20 66 61 73 74 65 72 20 74 6f 20 6d 6f 76 65 20 faster to move
bf20: 74 68 65 0a 20 20 2a 2a 20 74 77 6f 20 28 6f 72 the. ** two (or
bf30: 20 6f 6e 65 29 20 62 6c 6f 63 6b 73 20 6f 66 20 one) blocks of
bf40: 63 65 6c 6c 73 20 75 73 69 6e 67 20 6d 65 6d 6d cells using memm
bf50: 6f 76 65 28 29 20 61 6e 64 20 61 64 64 20 74 68 ove() and add th
bf60: 65 20 72 65 71 75 69 72 65 64 0a 20 20 2a 2a 20 e required. **
bf70: 6f 66 66 73 65 74 73 20 74 6f 20 65 61 63 68 20 offsets to each
bf80: 70 6f 69 6e 74 65 72 20 69 6e 20 74 68 65 20 63 pointer in the c
bf90: 65 6c 6c 2d 70 6f 69 6e 74 65 72 20 61 72 72 61 ell-pointer arra
bfa0: 79 20 74 68 61 6e 20 69 74 20 69 73 20 74 6f 20 y than it is to
bfb0: 0a 20 20 2a 2a 20 72 65 63 6f 6e 73 74 72 75 63 . ** reconstruc
bfc0: 74 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 67 t the entire pag
bfd0: 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 28 69 6e e. */. if( (in
bfe0: 74 29 64 61 74 61 5b 68 64 72 2b 37 5d 3c 3d 6e t)data[hdr+7]<=n
bff0: 4d 61 78 46 72 61 67 20 29 7b 0a 20 20 20 20 69 MaxFrag ){. i
c000: 6e 74 20 69 46 72 65 65 20 3d 20 67 65 74 32 62 nt iFree = get2b
c010: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 31 5d yte(&data[hdr+1]
c020: 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 );.. /* If th
c030: 65 20 69 6e 69 74 69 61 6c 20 66 72 65 65 62 6c e initial freebl
c040: 6f 63 6b 20 6f 66 66 73 65 74 20 77 65 72 65 20 ock offset were
c050: 6f 75 74 20 6f 66 20 62 6f 75 6e 64 73 2c 20 74 out of bounds, t
c060: 68 61 74 20 77 6f 75 6c 64 0a 20 20 20 20 2a 2a hat would. **
c070: 20 68 61 76 65 20 62 65 65 6e 20 64 65 74 65 63 have been detec
c080: 74 65 64 20 62 79 20 62 74 72 65 65 49 6e 69 74 ted by btreeInit
c090: 50 61 67 65 28 29 20 77 68 65 6e 20 69 74 20 77 Page() when it w
c0a0: 61 73 20 63 6f 6d 70 75 74 69 6e 67 20 74 68 65 as computing the
c0b0: 0a 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f . ** number o
c0c0: 66 20 66 72 65 65 20 62 79 74 65 73 20 6f 6e 20 f free bytes on
c0d0: 74 68 65 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 the page. */.
c0e0: 20 61 73 73 65 72 74 28 20 69 46 72 65 65 3c 3d assert( iFree<=
c0f0: 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 29 3b 0a usableSize-4 );.
c100: 20 20 20 20 69 66 28 20 69 46 72 65 65 20 29 7b if( iFree ){
c110: 0a 20 20 20 20 20 20 69 6e 74 20 69 46 72 65 65 . int iFree
c120: 32 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 2 = get2byte(&da
c130: 74 61 5b 69 46 72 65 65 5d 29 3b 0a 20 20 20 20 ta[iFree]);.
c140: 20 20 69 66 28 20 69 46 72 65 65 32 3e 75 73 61 if( iFree2>usa
c150: 62 6c 65 53 69 7a 65 2d 34 20 29 20 72 65 74 75 bleSize-4 ) retu
c160: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
c170: 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 T_PAGE(pPage);.
c180: 20 20 20 20 20 69 66 28 20 30 3d 3d 69 46 72 65 if( 0==iFre
c190: 65 32 20 7c 7c 20 28 64 61 74 61 5b 69 46 72 65 e2 || (data[iFre
c1a0: 65 32 5d 3d 3d 30 20 26 26 20 64 61 74 61 5b 69 e2]==0 && data[i
c1b0: 46 72 65 65 32 2b 31 5d 3d 3d 30 29 20 29 7b 0a Free2+1]==0) ){.
c1c0: 20 20 20 20 20 20 20 20 75 38 20 2a 70 45 6e 64 u8 *pEnd
c1d0: 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 = &data[cellOff
c1e0: 73 65 74 20 2b 20 6e 43 65 6c 6c 2a 32 5d 3b 0a set + nCell*2];.
c1f0: 20 20 20 20 20 20 20 20 75 38 20 2a 70 41 64 64 u8 *pAdd
c200: 72 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 73 r;. int s
c210: 7a 32 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 z2 = 0;.
c220: 69 6e 74 20 73 7a 20 3d 20 67 65 74 32 62 79 74 int sz = get2byt
c230: 65 28 26 64 61 74 61 5b 69 46 72 65 65 2b 32 5d e(&data[iFree+2]
c240: 29 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 74 );. int t
c250: 6f 70 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 op = get2byte(&d
c260: 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 20 ata[hdr+5]);.
c270: 20 20 20 20 20 69 66 28 20 74 6f 70 3e 3d 69 46 if( top>=iF
c280: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ree ){.
c290: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
c2a0: 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 ORRUPT_PAGE(pPag
c2b0: 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 e);. }.
c2c0: 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 32 if( iFree2
c2d0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 ){. if
c2e0: 28 20 69 46 72 65 65 2b 73 7a 3e 69 46 72 65 65 ( iFree+sz>iFree
c2f0: 32 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 2 ) return SQLIT
c300: 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 E_CORRUPT_PAGE(p
c310: 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
c320: 20 73 7a 32 20 3d 20 67 65 74 32 62 79 74 65 28 sz2 = get2byte(
c330: 26 64 61 74 61 5b 69 46 72 65 65 32 2b 32 5d 29 &data[iFree2+2])
c340: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
c350: 69 46 72 65 65 32 2b 73 7a 32 20 3e 20 75 73 61 iFree2+sz2 > usa
c360: 62 6c 65 53 69 7a 65 20 29 20 72 65 74 75 72 6e bleSize ) return
c370: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
c380: 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
c390: 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 28 26 memmove(&
c3a0: 64 61 74 61 5b 69 46 72 65 65 2b 73 7a 2b 73 7a data[iFree+sz+sz
c3b0: 32 5d 2c 20 26 64 61 74 61 5b 69 46 72 65 65 2b 2], &data[iFree+
c3c0: 73 7a 5d 2c 20 69 46 72 65 65 32 2d 28 69 46 72 sz], iFree2-(iFr
c3d0: 65 65 2b 73 7a 29 29 3b 0a 20 20 20 20 20 20 20 ee+sz));.
c3e0: 20 20 20 73 7a 20 2b 3d 20 73 7a 32 3b 0a 20 20 sz += sz2;.
c3f0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
c400: 63 62 72 6b 20 3d 20 74 6f 70 2b 73 7a 3b 0a 20 cbrk = top+sz;.
c410: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 63 assert( c
c420: 62 72 6b 2b 28 69 46 72 65 65 2d 74 6f 70 29 20 brk+(iFree-top)
c430: 3c 3d 20 75 73 61 62 6c 65 53 69 7a 65 20 29 3b <= usableSize );
c440: 0a 20 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 . memmove
c450: 28 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 26 64 (&data[cbrk], &d
c460: 61 74 61 5b 74 6f 70 5d 2c 20 69 46 72 65 65 2d ata[top], iFree-
c470: 74 6f 70 29 3b 0a 20 20 20 20 20 20 20 20 66 6f top);. fo
c480: 72 28 70 41 64 64 72 3d 26 64 61 74 61 5b 63 65 r(pAddr=&data[ce
c490: 6c 6c 4f 66 66 73 65 74 5d 3b 20 70 41 64 64 72 llOffset]; pAddr
c4a0: 3c 70 45 6e 64 3b 20 70 41 64 64 72 2b 3d 32 29 <pEnd; pAddr+=2)
c4b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 70 63 20 3d {. pc =
c4c0: 20 67 65 74 32 62 79 74 65 28 70 41 64 64 72 29 get2byte(pAddr)
c4d0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
c4e0: 70 63 3c 69 46 72 65 65 20 29 7b 20 70 75 74 32 pc<iFree ){ put2
c4f0: 62 79 74 65 28 70 41 64 64 72 2c 20 70 63 2b 73 byte(pAddr, pc+s
c500: 7a 29 3b 20 7d 0a 20 20 20 20 20 20 20 20 20 20 z); }.
c510: 65 6c 73 65 20 69 66 28 20 70 63 3c 69 46 72 65 else if( pc<iFre
c520: 65 32 20 29 7b 20 70 75 74 32 62 79 74 65 28 70 e2 ){ put2byte(p
c530: 41 64 64 72 2c 20 70 63 2b 73 7a 32 29 3b 20 7d Addr, pc+sz2); }
c540: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
c550: 20 20 20 67 6f 74 6f 20 64 65 66 72 61 67 6d 65 goto defragme
c560: 6e 74 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a nt_out;. }.
c570: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 63 62 72 }. }.. cbr
c580: 6b 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a k = usableSize;.
c590: 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 iCellLast = us
c5a0: 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
c5b0: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c for(i=0; i<nCell
c5c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a ; i++){. u8 *
c5d0: 70 41 64 64 72 3b 20 20 20 20 20 2f 2a 20 54 68 pAddr; /* Th
c5e0: 65 20 69 2d 74 68 20 63 65 6c 6c 20 70 6f 69 6e e i-th cell poin
c5f0: 74 65 72 20 2a 2f 0a 20 20 20 20 70 41 64 64 72 ter */. pAddr
c600: 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 = &data[cellOff
c610: 73 65 74 20 2b 20 69 2a 32 5d 3b 0a 20 20 20 20 set + i*2];.
c620: 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 70 41 pc = get2byte(pA
c630: 64 64 72 29 3b 0a 20 20 20 20 74 65 73 74 63 61 ddr);. testca
c640: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 se( pc==iCellFir
c650: 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 st );. testca
c660: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 se( pc==iCellLas
c670: 74 20 29 3b 0a 20 20 20 20 2f 2a 20 54 68 65 73 t );. /* Thes
c680: 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 68 61 76 e conditions hav
c690: 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 76 e already been v
c6a0: 65 72 69 66 69 65 64 20 69 6e 20 62 74 72 65 65 erified in btree
c6b0: 49 6e 69 74 50 61 67 65 28 29 0a 20 20 20 20 2a InitPage(). *
c6c0: 2a 20 69 66 20 50 52 41 47 4d 41 20 63 65 6c 6c * if PRAGMA cell
c6d0: 5f 73 69 7a 65 5f 63 68 65 63 6b 3d 4f 4e 2e 0a _size_check=ON..
c6e0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 */. if( p
c6f0: 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 c<iCellFirst ||
c700: 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
c710: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
c720: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
c730: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 (pPage);. }.
c740: 20 20 20 61 73 73 65 72 74 28 20 70 63 3e 3d 69 assert( pc>=i
c750: 43 65 6c 6c 46 69 72 73 74 20 26 26 20 70 63 3c CellFirst && pc<
c760: 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 =iCellLast );.
c770: 20 20 73 69 7a 65 20 3d 20 70 50 61 67 65 2d 3e size = pPage->
c780: 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c xCellSize(pPage,
c790: 20 26 73 72 63 5b 70 63 5d 29 3b 0a 20 20 20 20 &src[pc]);.
c7a0: 63 62 72 6b 20 2d 3d 20 73 69 7a 65 3b 0a 20 20 cbrk -= size;.
c7b0: 20 20 69 66 28 20 63 62 72 6b 3c 69 43 65 6c 6c if( cbrk<iCell
c7c0: 46 69 72 73 74 20 7c 7c 20 70 63 2b 73 69 7a 65 First || pc+size
c7d0: 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
c7e0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
c7f0: 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 TE_CORRUPT_PAGE(
c800: 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 pPage);. }.
c810: 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 2b 73 assert( cbrk+s
c820: 69 7a 65 3c 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize<=usableSize
c830: 26 26 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 && cbrk>=iCellFi
c840: 72 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 rst );. testc
c850: 61 73 65 28 20 63 62 72 6b 2b 73 69 7a 65 3d 3d ase( cbrk+size==
c860: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
c870: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
c880: 69 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize==usableSize
c890: 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
c8a0: 70 41 64 64 72 2c 20 63 62 72 6b 29 3b 0a 20 20 pAddr, cbrk);.
c8b0: 20 20 69 66 28 20 74 65 6d 70 3d 3d 30 20 29 7b if( temp==0 ){
c8c0: 0a 20 20 20 20 20 20 69 6e 74 20 78 3b 0a 20 20 . int x;.
c8d0: 20 20 20 20 69 66 28 20 63 62 72 6b 3d 3d 70 63 if( cbrk==pc
c8e0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
c8f0: 20 20 20 74 65 6d 70 20 3d 20 73 71 6c 69 74 65 temp = sqlite
c900: 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 28 3PagerTempSpace(
c910: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 50 61 67 pPage->pBt->pPag
c920: 65 72 29 3b 0a 20 20 20 20 20 20 78 20 3d 20 67 er);. x = g
c930: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
c940: 72 2b 35 5d 29 3b 0a 20 20 20 20 20 20 6d 65 6d r+5]);. mem
c950: 63 70 79 28 26 74 65 6d 70 5b 78 5d 2c 20 26 64 cpy(&temp[x], &d
c960: 61 74 61 5b 78 5d 2c 20 28 63 62 72 6b 2b 73 69 ata[x], (cbrk+si
c970: 7a 65 29 20 2d 20 78 29 3b 0a 20 20 20 20 20 20 ze) - x);.
c980: 73 72 63 20 3d 20 74 65 6d 70 3b 0a 20 20 20 20 src = temp;.
c990: 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 }. memcpy(&da
c9a0: 74 61 5b 63 62 72 6b 5d 2c 20 26 73 72 63 5b 70 ta[cbrk], &src[p
c9b0: 63 5d 2c 20 73 69 7a 65 29 3b 0a 20 20 7d 0a 20 c], size);. }.
c9c0: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 data[hdr+7] = 0
c9d0: 3b 0a 0a 20 64 65 66 72 61 67 6d 65 6e 74 5f 6f ;.. defragment_o
c9e0: 75 74 3a 0a 20 20 69 66 28 20 64 61 74 61 5b 68 ut:. if( data[h
c9f0: 64 72 2b 37 5d 2b 63 62 72 6b 2d 69 43 65 6c 6c dr+7]+cbrk-iCell
ca00: 46 69 72 73 74 21 3d 70 50 61 67 65 2d 3e 6e 46 First!=pPage->nF
ca10: 72 65 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ree ){. retur
ca20: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
ca30: 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
ca40: 7d 0a 20 20 61 73 73 65 72 74 28 20 63 62 72 6b }. assert( cbrk
ca50: 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a >=iCellFirst );.
ca60: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
ca70: 5b 68 64 72 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a [hdr+5], cbrk);.
ca80: 20 20 64 61 74 61 5b 68 64 72 2b 31 5d 20 3d 20 data[hdr+1] =
ca90: 30 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 32 5d 0;. data[hdr+2]
caa0: 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 26 = 0;. memset(&
cab0: 64 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 74 5d data[iCellFirst]
cac0: 2c 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c 6c 46 , 0, cbrk-iCellF
cad0: 69 72 73 74 29 3b 0a 20 20 61 73 73 65 72 74 28 irst);. assert(
cae0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
caf0: 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
cb00: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 65 pDbPage) );. re
cb10: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
cb20: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 }../*.** Search
cb30: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 6f 6e the free-list on
cb40: 20 70 61 67 65 20 70 50 67 20 66 6f 72 20 73 70 page pPg for sp
cb50: 61 63 65 20 74 6f 20 73 74 6f 72 65 20 61 20 63 ace to store a c
cb60: 65 6c 6c 20 6e 42 79 74 65 20 62 79 74 65 73 20 ell nByte bytes
cb70: 69 6e 0a 2a 2a 20 73 69 7a 65 2e 20 49 66 20 6f in.** size. If o
cb80: 6e 65 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c ne can be found,
cb90: 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 return a pointe
cba0: 72 20 74 6f 20 74 68 65 20 73 70 61 63 65 20 61 r to the space a
cbb0: 6e 64 20 72 65 6d 6f 76 65 20 69 74 0a 2a 2a 20 nd remove it.**
cbc0: 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 from the free-li
cbd0: 73 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 st..**.** If no
cbe0: 73 75 69 74 61 62 6c 65 20 73 70 61 63 65 20 63 suitable space c
cbf0: 61 6e 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 74 an be found on t
cc00: 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 72 65 he free-list, re
cc10: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a turn NULL..**.**
cc20: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d This function m
cc30: 61 79 20 64 65 74 65 63 74 20 63 6f 72 72 75 70 ay detect corrup
cc40: 74 69 6f 6e 20 77 69 74 68 69 6e 20 70 50 67 2e tion within pPg.
cc50: 20 20 49 66 20 63 6f 72 72 75 70 74 69 6f 6e 20 If corruption
cc60: 69 73 0a 2a 2a 20 64 65 74 65 63 74 65 64 20 74 is.** detected t
cc70: 68 65 6e 20 2a 70 52 63 20 69 73 20 73 65 74 20 hen *pRc is set
cc80: 74 6f 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 to SQLITE_CORRUP
cc90: 54 20 61 6e 64 20 4e 55 4c 4c 20 69 73 20 72 65 T and NULL is re
cca0: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 6c turned..**.** Sl
ccb0: 6f 74 73 20 6f 6e 20 74 68 65 20 66 72 65 65 20 ots on the free
ccc0: 6c 69 73 74 20 74 68 61 74 20 61 72 65 20 62 65 list that are be
ccd0: 74 77 65 65 6e 20 31 20 61 6e 64 20 33 20 62 79 tween 1 and 3 by
cce0: 74 65 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 tes larger than
ccf0: 6e 42 79 74 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 nByte.** will be
cd00: 20 69 67 6e 6f 72 65 64 20 69 66 20 61 64 64 69 ignored if addi
cd10: 6e 67 20 74 68 65 20 65 78 74 72 61 20 73 70 61 ng the extra spa
cd20: 63 65 20 74 6f 20 74 68 65 20 66 72 61 67 6d 65 ce to the fragme
cd30: 6e 74 61 74 69 6f 6e 20 63 6f 75 6e 74 0a 2a 2a ntation count.**
cd40: 20 63 61 75 73 65 73 20 74 68 65 20 66 72 61 67 causes the frag
cd50: 6d 65 6e 74 61 74 69 6f 6e 20 63 6f 75 6e 74 20 mentation count
cd60: 74 6f 20 65 78 63 65 65 64 20 36 30 2e 0a 2a 2f to exceed 60..*/
cd70: 0a 73 74 61 74 69 63 20 75 38 20 2a 70 61 67 65 .static u8 *page
cd80: 46 69 6e 64 53 6c 6f 74 28 4d 65 6d 50 61 67 65 FindSlot(MemPage
cd90: 20 2a 70 50 67 2c 20 69 6e 74 20 6e 42 79 74 65 *pPg, int nByte
cda0: 2c 20 69 6e 74 20 2a 70 52 63 29 7b 0a 20 20 63 , int *pRc){. c
cdb0: 6f 6e 73 74 20 69 6e 74 20 68 64 72 20 3d 20 70 onst int hdr = p
cdc0: 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 Pg->hdrOffset;.
cdd0: 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 u8 * const aDat
cde0: 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 3b 0a a = pPg->aData;.
cdf0: 20 20 69 6e 74 20 69 41 64 64 72 20 3d 20 68 64 int iAddr = hd
ce00: 72 20 2b 20 31 3b 0a 20 20 69 6e 74 20 70 63 20 r + 1;. int pc
ce10: 3d 20 67 65 74 32 62 79 74 65 28 26 61 44 61 74 = get2byte(&aDat
ce20: 61 5b 69 41 64 64 72 5d 29 3b 0a 20 20 69 6e 74 a[iAddr]);. int
ce30: 20 78 3b 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 x;. int usable
ce40: 53 69 7a 65 20 3d 20 70 50 67 2d 3e 70 42 74 2d Size = pPg->pBt-
ce50: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 69 >usableSize;. i
ce60: 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 nt size;
ce70: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
ce80: 68 65 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a he free slot */.
ce90: 0a 20 20 61 73 73 65 72 74 28 20 70 63 3e 30 20 . assert( pc>0
cea0: 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 63 3c 3d );. while( pc<=
ceb0: 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 29 7b 0a usableSize-4 ){.
cec0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
ced0: 4f 46 3a 20 52 2d 32 32 37 31 30 2d 35 33 33 32 OF: R-22710-5332
cee0: 38 20 54 68 65 20 74 68 69 72 64 20 61 6e 64 20 8 The third and
cef0: 66 6f 75 72 74 68 20 62 79 74 65 73 20 6f 66 20 fourth bytes of
cf00: 65 61 63 68 0a 20 20 20 20 2a 2a 20 66 72 65 65 each. ** free
cf10: 62 6c 6f 63 6b 20 66 6f 72 6d 20 61 20 62 69 67 block form a big
cf20: 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 -endian integer
cf30: 77 68 69 63 68 20 69 73 20 74 68 65 20 73 69 7a which is the siz
cf40: 65 20 6f 66 20 74 68 65 20 66 72 65 65 62 6c 6f e of the freeblo
cf50: 63 6b 0a 20 20 20 20 2a 2a 20 69 6e 20 62 79 74 ck. ** in byt
cf60: 65 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 es, including th
cf70: 65 20 34 2d 62 79 74 65 20 68 65 61 64 65 72 2e e 4-byte header.
cf80: 20 2a 2f 0a 20 20 20 20 73 69 7a 65 20 3d 20 67 */. size = g
cf90: 65 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 et2byte(&aData[p
cfa0: 63 2b 32 5d 29 3b 0a 20 20 20 20 69 66 28 20 28 c+2]);. if( (
cfb0: 78 20 3d 20 73 69 7a 65 20 2d 20 6e 42 79 74 65 x = size - nByte
cfc0: 29 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 74 65 )>=0 ){. te
cfd0: 73 74 63 61 73 65 28 20 78 3d 3d 34 20 29 3b 0a stcase( x==4 );.
cfe0: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
cff0: 78 3d 3d 33 20 29 3b 0a 20 20 20 20 20 20 69 66 x==3 );. if
d000: 28 20 73 69 7a 65 2b 70 63 20 3e 20 75 73 61 62 ( size+pc > usab
d010: 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 leSize ){.
d020: 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 5f *pRc = SQLITE_
d030: 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 67 CORRUPT_PAGE(pPg
d040: 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 );. retur
d050: 6e 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 n 0;. }else
d060: 20 69 66 28 20 78 3c 34 20 29 7b 0a 20 20 20 20 if( x<4 ){.
d070: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
d080: 4f 46 3a 20 52 2d 31 31 34 39 38 2d 35 38 30 32 OF: R-11498-5802
d090: 32 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 2 In a well-form
d0a0: 65 64 20 62 2d 74 72 65 65 20 70 61 67 65 2c 20 ed b-tree page,
d0b0: 74 68 65 20 74 6f 74 61 6c 0a 20 20 20 20 20 20 the total.
d0c0: 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 62 ** number of b
d0d0: 79 74 65 73 20 69 6e 20 66 72 61 67 6d 65 6e 74 ytes in fragment
d0e0: 73 20 6d 61 79 20 6e 6f 74 20 65 78 63 65 65 64 s may not exceed
d0f0: 20 36 30 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 60. */.
d100: 69 66 28 20 61 44 61 74 61 5b 68 64 72 2b 37 5d if( aData[hdr+7]
d110: 3e 35 37 20 29 20 72 65 74 75 72 6e 20 30 3b 0a >57 ) return 0;.
d120: 0a 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f . /* Remo
d130: 76 65 20 74 68 65 20 73 6c 6f 74 20 66 72 6f 6d ve the slot from
d140: 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 the free-list.
d150: 55 70 64 61 74 65 20 74 68 65 20 6e 75 6d 62 65 Update the numbe
d160: 72 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 r of. **
d170: 66 72 61 67 6d 65 6e 74 65 64 20 62 79 74 65 73 fragmented bytes
d180: 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67 65 within the page
d190: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 6d . */. mem
d1a0: 63 70 79 28 26 61 44 61 74 61 5b 69 41 64 64 72 cpy(&aData[iAddr
d1b0: 5d 2c 20 26 61 44 61 74 61 5b 70 63 5d 2c 20 32 ], &aData[pc], 2
d1c0: 29 3b 0a 20 20 20 20 20 20 20 20 61 44 61 74 61 );. aData
d1d0: 5b 68 64 72 2b 37 5d 20 2b 3d 20 28 75 38 29 78 [hdr+7] += (u8)x
d1e0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
d1f0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 6c /* The sl
d200: 6f 74 20 72 65 6d 61 69 6e 73 20 6f 6e 20 74 68 ot remains on th
d210: 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 52 65 64 e free-list. Red
d220: 75 63 65 20 69 74 73 20 73 69 7a 65 20 74 6f 20 uce its size to
d230: 61 63 63 6f 75 6e 74 0a 20 20 20 20 20 20 20 20 account.
d240: 20 2a 2a 20 66 6f 72 20 74 68 65 20 70 6f 72 74 ** for the port
d250: 69 6f 6e 20 75 73 65 64 20 62 79 20 74 68 65 20 ion used by the
d260: 6e 65 77 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 new allocation.
d270: 2a 2f 0a 20 20 20 20 20 20 20 20 70 75 74 32 62 */. put2b
d280: 79 74 65 28 26 61 44 61 74 61 5b 70 63 2b 32 5d yte(&aData[pc+2]
d290: 2c 20 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 , x);. }.
d2a0: 20 20 20 20 72 65 74 75 72 6e 20 26 61 44 61 74 return &aDat
d2b0: 61 5b 70 63 20 2b 20 78 5d 3b 0a 20 20 20 20 7d a[pc + x];. }
d2c0: 0a 20 20 20 20 69 41 64 64 72 20 3d 20 70 63 3b . iAddr = pc;
d2d0: 0a 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 79 . pc = get2by
d2e0: 74 65 28 26 61 44 61 74 61 5b 70 63 5d 29 3b 0a te(&aData[pc]);.
d2f0: 20 20 20 20 69 66 28 20 70 63 3c 69 41 64 64 72 if( pc<iAddr
d300: 2b 73 69 7a 65 20 29 20 62 72 65 61 6b 3b 0a 20 +size ) break;.
d310: 20 7d 0a 20 20 69 66 28 20 70 63 20 29 7b 0a 20 }. if( pc ){.
d320: 20 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 *pRc = SQLITE
d330: 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 _CORRUPT_PAGE(pP
d340: 67 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 g);. }.. retur
d350: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c n 0;.}../*.** Al
d360: 6c 6f 63 61 74 65 20 6e 42 79 74 65 20 62 79 74 locate nByte byt
d370: 65 73 20 6f 66 20 73 70 61 63 65 20 66 72 6f 6d es of space from
d380: 20 77 69 74 68 69 6e 20 74 68 65 20 42 2d 54 72 within the B-Tr
d390: 65 65 20 70 61 67 65 20 70 61 73 73 65 64 0a 2a ee page passed.*
d3a0: 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 * as the first a
d3b0: 72 67 75 6d 65 6e 74 2e 20 57 72 69 74 65 20 69 rgument. Write i
d3c0: 6e 74 6f 20 2a 70 49 64 78 20 74 68 65 20 69 6e nto *pIdx the in
d3d0: 64 65 78 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e dex into pPage->
d3e0: 61 44 61 74 61 5b 5d 0a 2a 2a 20 6f 66 20 74 68 aData[].** of th
d3f0: 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
d400: 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 2e allocated space.
d410: 20 52 65 74 75 72 6e 20 65 69 74 68 65 72 20 53 Return either S
d420: 51 4c 49 54 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 61 QLITE_OK or.** a
d430: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 28 75 73 n error code (us
d440: 75 61 6c 6c 79 20 53 51 4c 49 54 45 5f 43 4f 52 ually SQLITE_COR
d450: 52 55 50 54 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 RUPT)..**.** The
d460: 20 63 61 6c 6c 65 72 20 67 75 61 72 61 6e 74 65 caller guarante
d470: 65 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 es that there is
d480: 20 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 sufficient spac
d490: 65 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a 2a e to make the.**
d4a0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 54 68 allocation. Th
d4b0: 69 73 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 74 is routine might
d4c0: 20 6e 65 65 64 20 74 6f 20 64 65 66 72 61 67 6d need to defragm
d4d0: 65 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ent in order to
d4e0: 62 72 69 6e 67 0a 2a 2a 20 61 6c 6c 20 74 68 65 bring.** all the
d4f0: 20 73 70 61 63 65 20 74 6f 67 65 74 68 65 72 2c space together,
d500: 20 68 6f 77 65 76 65 72 2e 20 20 54 68 69 73 20 however. This
d510: 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 76 6f routine will avo
d520: 69 64 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 id using.** the
d530: 66 69 72 73 74 20 74 77 6f 20 62 79 74 65 73 20 first two bytes
d540: 70 61 73 74 20 74 68 65 20 63 65 6c 6c 20 70 6f past the cell po
d550: 69 6e 74 65 72 20 61 72 65 61 20 73 69 6e 63 65 inter area since
d560: 20 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69 73 presumably this
d570: 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 .** allocation i
d580: 73 20 62 65 69 6e 67 20 6d 61 64 65 20 69 6e 20 s being made in
d590: 6f 72 64 65 72 20 74 6f 20 69 6e 73 65 72 74 20 order to insert
d5a0: 61 20 6e 65 77 20 63 65 6c 6c 2c 20 73 6f 20 77 a new cell, so w
d5b0: 65 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 65 e will.** also e
d5c0: 6e 64 20 75 70 20 6e 65 65 64 69 6e 67 20 61 20 nd up needing a
d5d0: 6e 65 77 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 new cell pointer
d5e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
d5f0: 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 4d 65 allocateSpace(Me
d600: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
d610: 74 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 49 t nByte, int *pI
d620: 64 78 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 dx){. const int
d630: 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 hdr = pPage->hd
d640: 72 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4c rOffset; /* L
d650: 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 50 ocal cache of pP
d660: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 2a age->hdrOffset *
d670: 2f 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 64 /. u8 * const d
d680: 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 ata = pPage->aDa
d690: 74 61 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 ta; /* Loca
d6a0: 6c 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 65 l cache of pPage
d6b0: 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 69 6e 74 ->aData */. int
d6c0: 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 top;
d6d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d6e0: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
d6f0: 6f 66 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 of cell content
d700: 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 72 63 area */. int rc
d710: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 = SQLITE_OK;
d720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
d730: 2a 20 49 6e 74 65 67 65 72 20 72 65 74 75 72 6e * Integer return
d740: 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 67 code */. int g
d750: 61 70 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 69 ap; /* Fi
d760: 72 73 74 20 62 79 74 65 20 6f 66 20 67 61 70 20 rst byte of gap
d770: 62 65 74 77 65 65 6e 20 63 65 6c 6c 20 70 6f 69 between cell poi
d780: 6e 74 65 72 73 20 61 6e 64 20 63 65 6c 6c 20 63 nters and cell c
d790: 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 0a 20 20 61 ontent */. . a
d7a0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
d7b0: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
d7c0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
d7d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
d7e0: 65 2d 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 65 e->pBt );. asse
d7f0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
d800: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
d810: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
d820: 73 73 65 72 74 28 20 6e 42 79 74 65 3e 3d 30 20 ssert( nByte>=0
d830: 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 63 ); /* Minimum c
d840: 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a 2f ell size is 4 */
d850: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
d860: 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 74 65 20 29 ->nFree>=nByte )
d870: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
d880: 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 e->nOverflow==0
d890: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 42 79 );. assert( nBy
d8a0: 74 65 20 3c 20 28 69 6e 74 29 28 70 50 61 67 65 te < (int)(pPage
d8b0: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
d8c0: 65 2d 38 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 e-8) );.. asser
d8d0: 74 28 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 t( pPage->cellOf
d8e0: 66 73 65 74 20 3d 3d 20 68 64 72 20 2b 20 31 32 fset == hdr + 12
d8f0: 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 65 61 66 - 4*pPage->leaf
d900: 20 29 3b 0a 20 20 67 61 70 20 3d 20 70 50 61 67 );. gap = pPag
d910: 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 e->cellOffset +
d920: 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 2*pPage->nCell;.
d930: 20 20 61 73 73 65 72 74 28 20 67 61 70 3c 3d 36 assert( gap<=6
d940: 35 35 33 36 20 29 3b 0a 20 20 2f 2a 20 45 56 49 5536 );. /* EVI
d950: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 39 33 35 DENCE-OF: R-2935
d960: 36 2d 30 32 33 39 31 20 49 66 20 74 68 65 20 64 6-02391 If the d
d970: 61 74 61 62 61 73 65 20 75 73 65 73 20 61 20 36 atabase uses a 6
d980: 35 35 33 36 2d 62 79 74 65 20 70 61 67 65 20 73 5536-byte page s
d990: 69 7a 65 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 ize. ** and the
d9a0: 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 20 reserved space
d9b0: 69 73 20 7a 65 72 6f 20 28 74 68 65 20 75 73 75 is zero (the usu
d9c0: 61 6c 20 76 61 6c 75 65 20 66 6f 72 20 72 65 73 al value for res
d9d0: 65 72 76 65 64 20 73 70 61 63 65 29 0a 20 20 2a erved space). *
d9e0: 2a 20 74 68 65 6e 20 74 68 65 20 63 65 6c 6c 20 * then the cell
d9f0: 63 6f 6e 74 65 6e 74 20 6f 66 66 73 65 74 20 6f content offset o
da00: 66 20 61 6e 20 65 6d 70 74 79 20 70 61 67 65 20 f an empty page
da10: 77 61 6e 74 73 20 74 6f 20 62 65 20 36 35 35 33 wants to be 6553
da20: 36 2e 0a 20 20 2a 2a 20 48 6f 77 65 76 65 72 2c 6.. ** However,
da30: 20 74 68 61 74 20 69 6e 74 65 67 65 72 20 69 73 that integer is
da40: 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f 20 62 65 too large to be
da50: 20 73 74 6f 72 65 64 20 69 6e 20 61 20 32 2d 62 stored in a 2-b
da60: 79 74 65 20 75 6e 73 69 67 6e 65 64 0a 20 20 2a yte unsigned. *
da70: 2a 20 69 6e 74 65 67 65 72 2c 20 73 6f 20 61 20 * integer, so a
da80: 76 61 6c 75 65 20 6f 66 20 30 20 69 73 20 75 73 value of 0 is us
da90: 65 64 20 69 6e 20 69 74 73 20 70 6c 61 63 65 2e ed in its place.
daa0: 20 2a 2f 0a 20 20 74 6f 70 20 3d 20 67 65 74 32 */. top = get2
dab0: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
dac0: 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20 74 6f ]);. assert( to
dad0: 70 3c 3d 28 69 6e 74 29 70 50 61 67 65 2d 3e 70 p<=(int)pPage->p
dae0: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 Bt->usableSize )
daf0: 3b 20 2f 2a 20 50 72 65 76 65 6e 74 20 62 79 20 ; /* Prevent by
db00: 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 29 getAndInitPage()
db10: 20 2a 2f 0a 20 20 69 66 28 20 67 61 70 3e 74 6f */. if( gap>to
db20: 70 20 29 7b 0a 20 20 20 20 69 66 28 20 74 6f 70 p ){. if( top
db30: 3d 3d 30 20 26 26 20 70 50 61 67 65 2d 3e 70 42 ==0 && pPage->pB
db40: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3d 3d 36 t->usableSize==6
db50: 35 35 33 36 20 29 7b 0a 20 20 20 20 20 20 74 6f 5536 ){. to
db60: 70 20 3d 20 36 35 35 33 36 3b 0a 20 20 20 20 7d p = 65536;. }
db70: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75 else{. retu
db80: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
db90: 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 T_PAGE(pPage);.
dba0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 }. }.. /* I
dbb0: 66 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 f there is enoug
dbc0: 68 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 h space between
dbd0: 67 61 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 gap and top for
dbe0: 6f 6e 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f one more cell po
dbf0: 69 6e 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 inter. ** array
dc00: 20 65 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 entry offset, a
dc10: 6e 64 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 nd if the freeli
dc20: 73 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c st is not empty,
dc30: 20 74 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 then search the
dc40: 0a 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c . ** freelist l
dc50: 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 ooking for a fre
dc60: 65 20 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 e slot big enoug
dc70: 68 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 h to satisfy the
dc80: 20 72 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 request.. */.
dc90: 20 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 testcase( gap+2
dca0: 3d 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 ==top );. testc
dcb0: 61 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 ase( gap+1==top
dcc0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 );. testcase( g
dcd0: 61 70 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 ap==top );. if(
dce0: 20 28 64 61 74 61 5b 68 64 72 2b 32 5d 20 7c 7c (data[hdr+2] ||
dcf0: 20 64 61 74 61 5b 68 64 72 2b 31 5d 29 20 26 26 data[hdr+1]) &&
dd00: 20 67 61 70 2b 32 3c 3d 74 6f 70 20 29 7b 0a 20 gap+2<=top ){.
dd10: 20 20 20 75 38 20 2a 70 53 70 61 63 65 20 3d 20 u8 *pSpace =
dd20: 70 61 67 65 46 69 6e 64 53 6c 6f 74 28 70 50 61 pageFindSlot(pPa
dd30: 67 65 2c 20 6e 42 79 74 65 2c 20 26 72 63 29 3b ge, nByte, &rc);
dd40: 0a 20 20 20 20 69 66 28 20 70 53 70 61 63 65 20 . if( pSpace
dd50: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
dd60: 20 70 53 70 61 63 65 3e 3d 64 61 74 61 20 26 26 pSpace>=data &&
dd70: 20 28 70 53 70 61 63 65 20 2d 20 64 61 74 61 29 (pSpace - data)
dd80: 3c 36 35 35 33 36 20 29 3b 0a 20 20 20 20 20 20 <65536 );.
dd90: 2a 70 49 64 78 20 3d 20 28 69 6e 74 29 28 70 53 *pIdx = (int)(pS
dda0: 70 61 63 65 20 2d 20 64 61 74 61 29 3b 0a 20 20 pace - data);.
ddb0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
ddc0: 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 E_OK;. }else
ddd0: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
dde0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
ddf0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 72 . }.. /* The r
de00: 65 71 75 65 73 74 20 63 6f 75 6c 64 20 6e 6f 74 equest could not
de10: 20 62 65 20 66 75 6c 66 69 6c 6c 65 64 20 75 73 be fulfilled us
de20: 69 6e 67 20 61 20 66 72 65 65 6c 69 73 74 20 73 ing a freelist s
de30: 6c 6f 74 2e 20 20 43 68 65 63 6b 0a 20 20 2a 2a lot. Check. **
de40: 20 74 6f 20 73 65 65 20 69 66 20 64 65 66 72 61 to see if defra
de50: 67 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6e 65 gmentation is ne
de60: 63 65 73 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 cessary.. */.
de70: 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 2b testcase( gap+2+
de80: 6e 42 79 74 65 3d 3d 74 6f 70 20 29 3b 0a 20 20 nByte==top );.
de90: 69 66 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3e if( gap+2+nByte>
dea0: 74 6f 70 20 29 7b 0a 20 20 20 20 61 73 73 65 72 top ){. asser
deb0: 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e t( pPage->nCell>
dec0: 30 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 0 || CORRUPT_DB
ded0: 29 3b 0a 20 20 20 20 72 63 20 3d 20 64 65 66 72 );. rc = defr
dee0: 61 67 6d 65 6e 74 50 61 67 65 28 70 50 61 67 65 agmentPage(pPage
def0: 2c 20 4d 49 4e 28 34 2c 20 70 50 61 67 65 2d 3e , MIN(4, pPage->
df00: 6e 46 72 65 65 20 2d 20 28 32 2b 6e 42 79 74 65 nFree - (2+nByte
df10: 29 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 )));. if( rc
df20: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
df30: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
df40: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
df50: 2b 35 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 +5]);. assert
df60: 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3c 3d 74 ( gap+2+nByte<=t
df70: 6f 70 20 29 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a op );. }... /*
df80: 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 Allocate memory
df90: 20 66 72 6f 6d 20 74 68 65 20 67 61 70 20 69 6e from the gap in
dfa0: 20 62 65 74 77 65 65 6e 20 74 68 65 20 63 65 6c between the cel
dfb0: 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 0a l pointer array.
dfc0: 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 63 65 6c ** and the cel
dfd0: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 l content area.
dfe0: 20 54 68 65 20 62 74 72 65 65 49 6e 69 74 50 61 The btreeInitPa
dff0: 67 65 28 29 20 63 61 6c 6c 20 68 61 73 20 61 6c ge() call has al
e000: 72 65 61 64 79 0a 20 20 2a 2a 20 76 61 6c 69 64 ready. ** valid
e010: 61 74 65 64 20 74 68 65 20 66 72 65 65 6c 69 73 ated the freelis
e020: 74 2e 20 20 47 69 76 65 6e 20 74 68 61 74 20 74 t. Given that t
e030: 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 76 he freelist is v
e040: 61 6c 69 64 2c 20 74 68 65 72 65 0a 20 20 2a 2a alid, there. **
e050: 20 69 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 is no way that
e060: 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 63 the allocation c
e070: 61 6e 20 65 78 74 65 6e 64 20 6f 66 66 20 74 68 an extend off th
e080: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 e end of the pag
e090: 65 2e 0a 20 20 2a 2a 20 54 68 65 20 61 73 73 65 e.. ** The asse
e0a0: 72 74 28 29 20 62 65 6c 6f 77 20 76 65 72 69 66 rt() below verif
e0b0: 69 65 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 ies the previous
e0c0: 20 73 65 6e 74 65 6e 63 65 2e 0a 20 20 2a 2f 0a sentence.. */.
e0d0: 20 20 74 6f 70 20 2d 3d 20 6e 42 79 74 65 3b 0a top -= nByte;.
e0e0: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
e0f0: 5b 68 64 72 2b 35 5d 2c 20 74 6f 70 29 3b 0a 20 [hdr+5], top);.
e100: 20 61 73 73 65 72 74 28 20 74 6f 70 2b 6e 42 79 assert( top+nBy
e110: 74 65 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 te <= (int)pPage
e120: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
e130: 65 20 29 3b 0a 20 20 2a 70 49 64 78 20 3d 20 74 e );. *pIdx = t
e140: 6f 70 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c op;. return SQL
e150: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
e160: 20 52 65 74 75 72 6e 20 61 20 73 65 63 74 69 6f Return a sectio
e170: 6e 20 6f 66 20 74 68 65 20 70 50 61 67 65 2d 3e n of the pPage->
e180: 61 44 61 74 61 20 74 6f 20 74 68 65 20 66 72 65 aData to the fre
e190: 65 6c 69 73 74 2e 0a 2a 2a 20 54 68 65 20 66 69 elist..** The fi
e1a0: 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 rst byte of the
e1b0: 6e 65 77 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 new free block i
e1c0: 73 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 69 s pPage->aData[i
e1d0: 53 74 61 72 74 5d 0a 2a 2a 20 61 6e 64 20 74 68 Start].** and th
e1e0: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 6c e size of the bl
e1f0: 6f 63 6b 20 69 73 20 69 53 69 7a 65 20 62 79 74 ock is iSize byt
e200: 65 73 2e 0a 2a 2a 0a 2a 2a 20 41 64 6a 61 63 65 es..**.** Adjace
e210: 6e 74 20 66 72 65 65 62 6c 6f 63 6b 73 20 61 72 nt freeblocks ar
e220: 65 20 63 6f 61 6c 65 73 63 65 64 2e 0a 2a 2a 0a e coalesced..**.
e230: 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 65 76 65 ** Note that eve
e240: 6e 20 74 68 6f 75 67 68 20 74 68 65 20 66 72 65 n though the fre
e250: 65 62 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 20 eblock list was
e260: 63 68 65 63 6b 65 64 20 62 79 20 62 74 72 65 65 checked by btree
e270: 49 6e 69 74 50 61 67 65 28 29 2c 0a 2a 2a 20 74 InitPage(),.** t
e280: 68 61 74 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c hat routine will
e290: 20 6e 6f 74 20 64 65 74 65 63 74 20 6f 76 65 72 not detect over
e2a0: 6c 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c lap between cell
e2b0: 73 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b 73 2e s or freeblocks.
e2c0: 20 20 4e 6f 72 0a 2a 2a 20 64 6f 65 73 20 69 74 Nor.** does it
e2d0: 20 64 65 74 65 63 74 20 63 65 6c 6c 73 20 6f 72 detect cells or
e2e0: 20 66 72 65 65 62 6c 6f 63 6b 73 20 74 68 61 74 freeblocks that
e2f0: 20 65 6e 63 72 6f 75 63 68 20 69 6e 74 6f 20 74 encrouch into t
e300: 68 65 20 72 65 73 65 72 76 65 64 20 62 79 74 65 he reserved byte
e310: 73 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 s.** at the end
e320: 6f 66 20 74 68 65 20 70 61 67 65 2e 20 20 53 6f of the page. So
e330: 20 64 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 do additional c
e340: 6f 72 72 75 70 74 69 6f 6e 20 63 68 65 63 6b 73 orruption checks
e350: 20 69 6e 73 69 64 65 20 74 68 69 73 0a 2a 2a 20 inside this.**
e360: 72 6f 75 74 69 6e 65 20 61 6e 64 20 72 65 74 75 routine and retu
e370: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
e380: 54 20 69 66 20 61 6e 79 20 70 72 6f 62 6c 65 6d T if any problem
e390: 73 20 61 72 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a s are found..*/.
e3a0: 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 65 53 static int freeS
e3b0: 70 61 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 pace(MemPage *pP
e3c0: 61 67 65 2c 20 75 31 36 20 69 53 74 61 72 74 2c age, u16 iStart,
e3d0: 20 75 31 36 20 69 53 69 7a 65 29 7b 0a 20 20 75 u16 iSize){. u
e3e0: 31 36 20 69 50 74 72 3b 20 20 20 20 20 20 20 20 16 iPtr;
e3f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e400: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
e410: 6f 66 20 70 74 72 20 74 6f 20 6e 65 78 74 20 66 of ptr to next f
e420: 72 65 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 31 reeblock */. u1
e430: 36 20 69 46 72 65 65 42 6c 6b 3b 20 20 20 20 20 6 iFreeBlk;
e440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e450: 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f /* Address o
e460: 66 20 74 68 65 20 6e 65 78 74 20 66 72 65 65 62 f the next freeb
e470: 6c 6f 63 6b 20 2a 2f 0a 20 20 75 38 20 68 64 72 lock */. u8 hdr
e480: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e4a0: 2f 2a 20 50 61 67 65 20 68 65 61 64 65 72 20 73 /* Page header s
e4b0: 69 7a 65 2e 20 20 30 20 6f 72 20 31 30 30 20 2a ize. 0 or 100 *
e4c0: 2f 0a 20 20 75 38 20 6e 46 72 61 67 20 3d 20 30 /. u8 nFrag = 0
e4d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e4e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 64 /* Red
e4f0: 75 63 74 69 6f 6e 20 69 6e 20 66 72 61 67 6d 65 uction in fragme
e500: 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 36 ntation */. u16
e510: 20 69 4f 72 69 67 53 69 7a 65 20 3d 20 69 53 69 iOrigSize = iSi
e520: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ze;
e530: 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 /* Original v
e540: 61 6c 75 65 20 6f 66 20 69 53 69 7a 65 20 2a 2f alue of iSize */
e550: 0a 20 20 75 31 36 20 78 3b 20 20 20 20 20 20 20 . u16 x;
e560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e570: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
e580: 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 65 et to cell conte
e590: 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 75 33 32 nt area */. u32
e5a0: 20 69 45 6e 64 20 3d 20 69 53 74 61 72 74 20 2b iEnd = iStart +
e5b0: 20 69 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 iSize;
e5c0: 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 /* First byte
e5d0: 20 70 61 73 74 20 74 68 65 20 69 53 74 61 72 74 past the iStart
e5e0: 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 75 6e 73 buffer */. uns
e5f0: 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 igned char *data
e600: 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b = pPage->aData;
e610: 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 65 /* Page conte
e620: 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 nt */.. assert(
e630: 20 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 pPage->pBt!=0 )
e640: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
e650: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
e660: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
e670: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
e680: 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 69 CORRUPT_DB || i
e690: 53 74 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 Start>=pPage->hd
e6a0: 72 4f 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d rOffset+6+pPage-
e6b0: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b >childPtrSize );
e6c0: 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 . assert( CORRU
e6d0: 50 54 5f 44 42 20 7c 7c 20 69 45 6e 64 20 3c 3d PT_DB || iEnd <=
e6e0: 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 pPage->pBt->usa
e6f0: 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 bleSize );. ass
e700: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
e710: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
e720: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
e730: 61 73 73 65 72 74 28 20 69 53 69 7a 65 3e 3d 34 assert( iSize>=4
e740: 20 29 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d ); /* Minimum
e750: 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 cell size is 4
e760: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 */. assert( iSt
e770: 61 72 74 3c 3d 70 50 61 67 65 2d 3e 70 42 74 2d art<=pPage->pBt-
e780: 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 29 3b >usableSize-4 );
e790: 0a 0a 20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 .. /* The list
e7a0: 6f 66 20 66 72 65 65 62 6c 6f 63 6b 73 20 6d 75 of freeblocks mu
e7b0: 73 74 20 62 65 20 69 6e 20 61 73 63 65 6e 64 69 st be in ascendi
e7c0: 6e 67 20 6f 72 64 65 72 2e 20 20 46 69 6e 64 20 ng order. Find
e7d0: 74 68 65 20 0a 20 20 2a 2a 20 73 70 6f 74 20 6f the . ** spot o
e7e0: 6e 20 74 68 65 20 6c 69 73 74 20 77 68 65 72 65 n the list where
e7f0: 20 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 iStart should b
e800: 65 20 69 6e 73 65 72 74 65 64 2e 0a 20 20 2a 2f e inserted.. */
e810: 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e . hdr = pPage->
e820: 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 69 50 74 hdrOffset;. iPt
e830: 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 r = hdr + 1;. i
e840: 66 28 20 64 61 74 61 5b 69 50 74 72 2b 31 5d 3d f( data[iPtr+1]=
e850: 3d 30 20 26 26 20 64 61 74 61 5b 69 50 74 72 5d =0 && data[iPtr]
e860: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 46 72 65 65 ==0 ){. iFree
e870: 42 6c 6b 20 3d 20 30 3b 20 20 2f 2a 20 53 68 6f Blk = 0; /* Sho
e880: 72 74 63 75 74 20 66 6f 72 20 74 68 65 20 63 61 rtcut for the ca
e890: 73 65 20 77 68 65 6e 20 74 68 65 20 66 72 65 65 se when the free
e8a0: 6c 69 73 74 20 69 73 20 65 6d 70 74 79 20 2a 2f list is empty */
e8b0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 77 68 . }else{. wh
e8c0: 69 6c 65 28 20 28 69 46 72 65 65 42 6c 6b 20 3d ile( (iFreeBlk =
e8d0: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
e8e0: 69 50 74 72 5d 29 29 3c 69 53 74 61 72 74 20 29 iPtr]))<iStart )
e8f0: 7b 0a 20 20 20 20 20 20 69 66 28 20 69 46 72 65 {. if( iFre
e900: 65 42 6c 6b 3c 69 50 74 72 2b 34 20 29 7b 0a 20 eBlk<iPtr+4 ){.
e910: 20 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 if( iFree
e920: 42 6c 6b 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a Blk==0 ) break;.
e930: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
e940: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
e950: 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 GE(pPage);.
e960: 20 7d 0a 20 20 20 20 20 20 69 50 74 72 20 3d 20 }. iPtr =
e970: 69 46 72 65 65 42 6c 6b 3b 0a 20 20 20 20 7d 0a iFreeBlk;. }.
e980: 20 20 20 20 69 66 28 20 69 46 72 65 65 42 6c 6b if( iFreeBlk
e990: 3e 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 >pPage->pBt->usa
e9a0: 62 6c 65 53 69 7a 65 2d 34 20 29 7b 0a 20 20 20 bleSize-4 ){.
e9b0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
e9c0: 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 _CORRUPT_PAGE(pP
e9d0: 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 age);. }.
e9e0: 61 73 73 65 72 74 28 20 69 46 72 65 65 42 6c 6b assert( iFreeBlk
e9f0: 3e 69 50 74 72 20 7c 7c 20 69 46 72 65 65 42 6c >iPtr || iFreeBl
ea00: 6b 3d 3d 30 20 29 3b 0a 20 20 0a 20 20 20 20 2f k==0 );. . /
ea10: 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 3a * At this point:
ea20: 0a 20 20 20 20 2a 2a 20 20 20 20 69 46 72 65 65 . ** iFree
ea30: 42 6c 6b 3a 20 20 20 46 69 72 73 74 20 66 72 65 Blk: First fre
ea40: 65 62 6c 6f 63 6b 20 61 66 74 65 72 20 69 53 74 eblock after iSt
ea50: 61 72 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 20 art, or zero if
ea60: 6e 6f 6e 65 0a 20 20 20 20 2a 2a 20 20 20 20 69 none. ** i
ea70: 50 74 72 3a 20 20 20 20 20 20 20 54 68 65 20 61 Ptr: The a
ea80: 64 64 72 65 73 73 20 6f 66 20 61 20 70 6f 69 6e ddress of a poin
ea90: 74 65 72 20 74 6f 20 69 46 72 65 65 42 6c 6b 0a ter to iFreeBlk.
eaa0: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 68 **. ** Ch
eab0: 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 69 46 eck to see if iF
eac0: 72 65 65 42 6c 6b 20 73 68 6f 75 6c 64 20 62 65 reeBlk should be
ead0: 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f 20 coalesced onto
eae0: 74 68 65 20 65 6e 64 20 6f 66 20 69 53 74 61 72 the end of iStar
eaf0: 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 t.. */. if
eb00: 28 20 69 46 72 65 65 42 6c 6b 20 26 26 20 69 45 ( iFreeBlk && iE
eb10: 6e 64 2b 33 3e 3d 69 46 72 65 65 42 6c 6b 20 29 nd+3>=iFreeBlk )
eb20: 7b 0a 20 20 20 20 20 20 6e 46 72 61 67 20 3d 20 {. nFrag =
eb30: 69 46 72 65 65 42 6c 6b 20 2d 20 69 45 6e 64 3b iFreeBlk - iEnd;
eb40: 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e 64 3e . if( iEnd>
eb50: 69 46 72 65 65 42 6c 6b 20 29 20 72 65 74 75 72 iFreeBlk ) retur
eb60: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
eb70: 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
eb80: 20 20 20 20 69 45 6e 64 20 3d 20 69 46 72 65 65 iEnd = iFree
eb90: 42 6c 6b 20 2b 20 67 65 74 32 62 79 74 65 28 26 Blk + get2byte(&
eba0: 64 61 74 61 5b 69 46 72 65 65 42 6c 6b 2b 32 5d data[iFreeBlk+2]
ebb0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e );. if( iEn
ebc0: 64 20 3e 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e d > pPage->pBt->
ebd0: 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 usableSize ){.
ebe0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
ebf0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
ec00: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d (pPage);. }
ec10: 0a 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 69 . iSize = i
ec20: 45 6e 64 20 2d 20 69 53 74 61 72 74 3b 0a 20 20 End - iStart;.
ec30: 20 20 20 20 69 46 72 65 65 42 6c 6b 20 3d 20 67 iFreeBlk = g
ec40: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 et2byte(&data[iF
ec50: 72 65 65 42 6c 6b 5d 29 3b 0a 20 20 20 20 7d 0a reeBlk]);. }.
ec60: 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 69 50 74 . /* If iPt
ec70: 72 20 69 73 20 61 6e 6f 74 68 65 72 20 66 72 65 r is another fre
ec80: 65 62 6c 6f 63 6b 20 28 74 68 61 74 20 69 73 2c eblock (that is,
ec90: 20 69 66 20 69 50 74 72 20 69 73 20 6e 6f 74 20 if iPtr is not
eca0: 74 68 65 20 66 72 65 65 6c 69 73 74 0a 20 20 20 the freelist.
ecb0: 20 2a 2a 20 70 6f 69 6e 74 65 72 20 69 6e 20 74 ** pointer in t
ecc0: 68 65 20 70 61 67 65 20 68 65 61 64 65 72 29 20 he page header)
ecd0: 74 68 65 6e 20 63 68 65 63 6b 20 74 6f 20 73 65 then check to se
ece0: 65 20 69 66 20 69 53 74 61 72 74 20 73 68 6f 75 e if iStart shou
ecf0: 6c 64 20 62 65 0a 20 20 20 20 2a 2a 20 63 6f 61 ld be. ** coa
ed00: 6c 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 lesced onto the
ed10: 65 6e 64 20 6f 66 20 69 50 74 72 2e 0a 20 20 20 end of iPtr..
ed20: 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 74 72 */. if( iPtr
ed30: 3e 68 64 72 2b 31 20 29 7b 0a 20 20 20 20 20 20 >hdr+1 ){.
ed40: 69 6e 74 20 69 50 74 72 45 6e 64 20 3d 20 69 50 int iPtrEnd = iP
ed50: 74 72 20 2b 20 67 65 74 32 62 79 74 65 28 26 64 tr + get2byte(&d
ed60: 61 74 61 5b 69 50 74 72 2b 32 5d 29 3b 0a 20 20 ata[iPtr+2]);.
ed70: 20 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 2b if( iPtrEnd+
ed80: 33 3e 3d 69 53 74 61 72 74 20 29 7b 0a 20 20 20 3>=iStart ){.
ed90: 20 20 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 if( iPtrEnd
eda0: 3e 69 53 74 61 72 74 20 29 20 72 65 74 75 72 6e >iStart ) return
edb0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
edc0: 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
edd0: 20 20 20 20 20 6e 46 72 61 67 20 2b 3d 20 69 53 nFrag += iS
ede0: 74 61 72 74 20 2d 20 69 50 74 72 45 6e 64 3b 0a tart - iPtrEnd;.
edf0: 20 20 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 iSize =
ee00: 69 45 6e 64 20 2d 20 69 50 74 72 3b 0a 20 20 20 iEnd - iPtr;.
ee10: 20 20 20 20 20 69 53 74 61 72 74 20 3d 20 69 50 iStart = iP
ee20: 74 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 tr;. }.
ee30: 7d 0a 20 20 20 20 69 66 28 20 6e 46 72 61 67 3e }. if( nFrag>
ee40: 64 61 74 61 5b 68 64 72 2b 37 5d 20 29 20 72 65 data[hdr+7] ) re
ee50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
ee60: 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b UPT_PAGE(pPage);
ee70: 0a 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d . data[hdr+7]
ee80: 20 2d 3d 20 6e 46 72 61 67 3b 0a 20 20 7d 0a 20 -= nFrag;. }.
ee90: 20 78 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 x = get2byte(&d
eea0: 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 ata[hdr+5]);. i
eeb0: 66 28 20 69 53 74 61 72 74 3c 3d 78 20 29 7b 0a f( iStart<=x ){.
eec0: 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 20 66 /* The new f
eed0: 72 65 65 62 6c 6f 63 6b 20 69 73 20 61 74 20 74 reeblock is at t
eee0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
eef0: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
ef00: 20 61 72 65 61 2c 0a 20 20 20 20 2a 2a 20 73 6f area,. ** so
ef10: 20 6a 75 73 74 20 65 78 74 65 6e 64 20 74 68 65 just extend the
ef20: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 cell content ar
ef30: 65 61 20 72 61 74 68 65 72 20 74 68 61 6e 20 63 ea rather than c
ef40: 72 65 61 74 65 20 61 6e 6f 74 68 65 72 0a 20 20 reate another.
ef50: 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 65 6e ** freelist en
ef60: 74 72 79 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 try */. if( i
ef70: 53 74 61 72 74 3c 78 20 7c 7c 20 69 50 74 72 21 Start<x || iPtr!
ef80: 3d 68 64 72 2b 31 20 29 20 72 65 74 75 72 6e 20 =hdr+1 ) return
ef90: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 SQLITE_CORRUPT_P
efa0: 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 AGE(pPage);.
efb0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
efc0: 64 72 2b 31 5d 2c 20 69 46 72 65 65 42 6c 6b 29 dr+1], iFreeBlk)
efd0: 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 ;. put2byte(&
efe0: 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 69 45 6e data[hdr+5], iEn
eff0: 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 d);. }else{.
f000: 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 65 20 6e /* Insert the n
f010: 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 6e 74 ew freeblock int
f020: 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a o the freelist *
f030: 2f 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 /. put2byte(&
f040: 64 61 74 61 5b 69 50 74 72 5d 2c 20 69 53 74 61 data[iPtr], iSta
f050: 72 74 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 rt);. }. if( p
f060: 50 61 67 65 2d 3e 70 42 74 2d 3e 62 74 73 46 6c Page->pBt->btsFl
f070: 61 67 73 20 26 20 42 54 53 5f 46 41 53 54 5f 53 ags & BTS_FAST_S
f080: 45 43 55 52 45 20 29 7b 0a 20 20 20 20 2f 2a 20 ECURE ){. /*
f090: 4f 76 65 72 77 72 69 74 65 20 64 65 6c 65 74 65 Overwrite delete
f0a0: 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 d information wi
f0b0: 74 68 20 7a 65 72 6f 73 20 77 68 65 6e 20 74 68 th zeros when th
f0c0: 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 0a e secure_delete.
f0d0: 20 20 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 73 ** option is
f0e0: 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 20 20 enabled */.
f0f0: 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 69 53 74 memset(&data[iSt
f100: 61 72 74 5d 2c 20 30 2c 20 69 53 69 7a 65 29 3b art], 0, iSize);
f110: 0a 20 20 7d 0a 20 20 70 75 74 32 62 79 74 65 28 . }. put2byte(
f120: 26 64 61 74 61 5b 69 53 74 61 72 74 5d 2c 20 69 &data[iStart], i
f130: 46 72 65 65 42 6c 6b 29 3b 0a 20 20 70 75 74 32 FreeBlk);. put2
f140: 62 79 74 65 28 26 64 61 74 61 5b 69 53 74 61 72 byte(&data[iStar
f150: 74 2b 32 5d 2c 20 69 53 69 7a 65 29 3b 0a 20 20 t+2], iSize);.
f160: 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 pPage->nFree +=
f170: 69 4f 72 69 67 53 69 7a 65 3b 0a 20 20 72 65 74 iOrigSize;. ret
f180: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
f190: 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6f 64 65 20 74 ../*.** Decode t
f1a0: 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 28 74 he flags byte (t
f1b0: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
f1c0: 20 74 68 65 20 68 65 61 64 65 72 29 20 66 6f 72 the header) for
f1d0: 20 61 20 70 61 67 65 0a 2a 2a 20 61 6e 64 20 69 a page.** and i
f1e0: 6e 69 74 69 61 6c 69 7a 65 20 66 69 65 6c 64 73 nitialize fields
f1f0: 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 20 of the MemPage
f200: 73 74 72 75 63 74 75 72 65 20 61 63 63 6f 72 64 structure accord
f210: 69 6e 67 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c ingly..**.** Onl
f220: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
f230: 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 61 72 65 combinations are
f240: 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 supported. Any
f250: 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e 74 0a thing different.
f260: 2a 2a 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 ** indicates a c
f270: 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 orrupt database
f280: 66 69 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 files:.**.**
f290: 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 PTF_ZERODAT
f2a0: 41 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 A.** PTF
f2b0: 5f 5a 45 52 4f 44 41 54 41 20 7c 20 50 54 46 5f _ZERODATA | PTF_
f2c0: 4c 45 41 46 0a 2a 2a 20 20 20 20 20 20 20 20 20 LEAF.**
f2d0: 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 PTF_LEAFDATA | P
f2e0: 54 46 5f 49 4e 54 4b 45 59 0a 2a 2a 20 20 20 20 TF_INTKEY.**
f2f0: 20 20 20 20 20 50 54 46 5f 4c 45 41 46 44 41 54 PTF_LEAFDAT
f300: 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 20 7c A | PTF_INTKEY |
f310: 20 50 54 46 5f 4c 45 41 46 0a 2a 2f 0a 73 74 61 PTF_LEAF.*/.sta
f320: 74 69 63 20 69 6e 74 20 64 65 63 6f 64 65 46 6c tic int decodeFl
f330: 61 67 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ags(MemPage *pPa
f340: 67 65 2c 20 69 6e 74 20 66 6c 61 67 42 79 74 65 ge, int flagByte
f350: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
f360: 42 74 3b 20 20 20 20 20 2f 2a 20 41 20 63 6f 70 Bt; /* A cop
f370: 79 20 6f 66 20 70 50 61 67 65 2d 3e 70 42 74 20 y of pPage->pBt
f380: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
f390: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d age->hdrOffset==
f3a0: 28 70 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 (pPage->pgno==1
f3b0: 3f 20 31 30 30 20 3a 20 30 29 20 29 3b 0a 20 20 ? 100 : 0) );.
f3c0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
f3d0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
f3e0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
f3f0: 0a 20 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 3d . pPage->leaf =
f400: 20 28 75 38 29 28 66 6c 61 67 42 79 74 65 3e 3e (u8)(flagByte>>
f410: 33 29 3b 20 20 61 73 73 65 72 74 28 20 50 54 46 3); assert( PTF
f420: 5f 4c 45 41 46 20 3d 3d 20 31 3c 3c 33 20 29 3b _LEAF == 1<<3 );
f430: 0a 20 20 66 6c 61 67 42 79 74 65 20 26 3d 20 7e . flagByte &= ~
f440: 50 54 46 5f 4c 45 41 46 3b 0a 20 20 70 50 61 67 PTF_LEAF;. pPag
f450: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 e->childPtrSize
f460: 3d 20 34 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 = 4-4*pPage->lea
f470: 66 3b 0a 20 20 70 50 61 67 65 2d 3e 78 43 65 6c f;. pPage->xCel
f480: 6c 53 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 lSize = cellSize
f490: 50 74 72 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 Ptr;. pBt = pPa
f4a0: 67 65 2d 3e 70 42 74 3b 0a 20 20 69 66 28 20 66 ge->pBt;. if( f
f4b0: 6c 61 67 42 79 74 65 3d 3d 28 50 54 46 5f 4c 45 lagByte==(PTF_LE
f4c0: 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 AFDATA | PTF_INT
f4d0: 4b 45 59 29 20 29 7b 0a 20 20 20 20 2f 2a 20 45 KEY) ){. /* E
f4e0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 37 VIDENCE-OF: R-07
f4f0: 32 39 31 2d 33 35 33 32 38 20 41 20 76 61 6c 75 291-35328 A valu
f500: 65 20 6f 66 20 35 20 28 30 78 30 35 29 20 6d 65 e of 5 (0x05) me
f510: 61 6e 73 20 74 68 65 20 70 61 67 65 20 69 73 20 ans the page is
f520: 61 6e 0a 20 20 20 20 2a 2a 20 69 6e 74 65 72 69 an. ** interi
f530: 6f 72 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 or table b-tree
f540: 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 page. */. ass
f550: 65 72 74 28 20 28 50 54 46 5f 4c 45 41 46 44 41 ert( (PTF_LEAFDA
f560: 54 41 7c 50 54 46 5f 49 4e 54 4b 45 59 29 3d 3d TA|PTF_INTKEY)==
f570: 35 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 5 );. /* EVID
f580: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 36 39 30 30 ENCE-OF: R-26900
f590: 2d 30 39 31 37 36 20 41 20 76 61 6c 75 65 20 6f -09176 A value o
f5a0: 66 20 31 33 20 28 30 78 30 64 29 20 6d 65 61 6e f 13 (0x0d) mean
f5b0: 73 20 74 68 65 20 70 61 67 65 20 69 73 20 61 0a s the page is a.
f5c0: 20 20 20 20 2a 2a 20 6c 65 61 66 20 74 61 62 6c ** leaf tabl
f5d0: 65 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a e b-tree page. *
f5e0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
f5f0: 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f TF_LEAFDATA|PTF_
f600: 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 29 INTKEY|PTF_LEAF)
f610: 3d 3d 31 33 20 29 3b 0a 20 20 20 20 70 50 61 67 ==13 );. pPag
f620: 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 31 3b 0a 20 e->intKey = 1;.
f630: 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 if( pPage->le
f640: 61 66 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 af ){. pPag
f650: 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 e->intKeyLeaf =
f660: 31 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e 1;. pPage->
f670: 78 50 61 72 73 65 43 65 6c 6c 20 3d 20 62 74 72 xParseCell = btr
f680: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 3b 0a eeParseCellPtr;.
f690: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
f6a0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 pPage->intKeyLe
f6b0: 61 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 af = 0;. pP
f6c0: 61 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 20 3d age->xCellSize =
f6d0: 20 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 61 cellSizePtrNoPa
f6e0: 79 6c 6f 61 64 3b 0a 20 20 20 20 20 20 70 50 61 yload;. pPa
f6f0: 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 20 3d ge->xParseCell =
f700: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
f710: 74 72 4e 6f 50 61 79 6c 6f 61 64 3b 0a 20 20 20 trNoPayload;.
f720: 20 7d 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 }. pPage->ma
f730: 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 xLocal = pBt->ma
f740: 78 4c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 xLeaf;. pPage
f750: 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 ->minLocal = pBt
f760: 2d 3e 6d 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c ->minLeaf;. }el
f770: 73 65 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d se if( flagByte=
f780: 3d 50 54 46 5f 5a 45 52 4f 44 41 54 41 20 29 7b =PTF_ZERODATA ){
f790: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
f7a0: 2d 4f 46 3a 20 52 2d 34 33 33 31 36 2d 33 37 33 -OF: R-43316-373
f7b0: 30 38 20 41 20 76 61 6c 75 65 20 6f 66 20 32 20 08 A value of 2
f7c0: 28 30 78 30 32 29 20 6d 65 61 6e 73 20 74 68 65 (0x02) means the
f7d0: 20 70 61 67 65 20 69 73 20 61 6e 0a 20 20 20 20 page is an.
f7e0: 2a 2a 20 69 6e 74 65 72 69 6f 72 20 69 6e 64 65 ** interior inde
f7f0: 78 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a x b-tree page. *
f800: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
f810: 54 46 5f 5a 45 52 4f 44 41 54 41 29 3d 3d 32 20 TF_ZERODATA)==2
f820: 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e );. /* EVIDEN
f830: 43 45 2d 4f 46 3a 20 52 2d 35 39 36 31 35 2d 34 CE-OF: R-59615-4
f840: 32 38 32 38 20 41 20 76 61 6c 75 65 20 6f 66 20 2828 A value of
f850: 31 30 20 28 30 78 30 61 29 20 6d 65 61 6e 73 20 10 (0x0a) means
f860: 74 68 65 20 70 61 67 65 20 69 73 20 61 0a 20 20 the page is a.
f870: 20 20 2a 2a 20 6c 65 61 66 20 69 6e 64 65 78 20 ** leaf index
f880: 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a b-tree page. */.
f890: 20 20 20 20 61 73 73 65 72 74 28 20 28 50 54 46 assert( (PTF
f8a0: 5f 5a 45 52 4f 44 41 54 41 7c 50 54 46 5f 4c 45 _ZERODATA|PTF_LE
f8b0: 41 46 29 3d 3d 31 30 20 29 3b 0a 20 20 20 20 70 AF)==10 );. p
f8c0: 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 30 Page->intKey = 0
f8d0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 ;. pPage->int
f8e0: 4b 65 79 4c 65 61 66 20 3d 20 30 3b 0a 20 20 20 KeyLeaf = 0;.
f8f0: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
f900: 6c 6c 20 3d 20 62 74 72 65 65 50 61 72 73 65 43 ll = btreeParseC
f910: 65 6c 6c 50 74 72 49 6e 64 65 78 3b 0a 20 20 20 ellPtrIndex;.
f920: 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c pPage->maxLocal
f930: 20 3d 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c = pBt->maxLocal
f940: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e ;. pPage->min
f950: 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e Local = pBt->min
f960: 4c 6f 63 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a Local;. }else{.
f970: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
f980: 4f 46 3a 20 52 2d 34 37 36 30 38 2d 35 36 34 36 OF: R-47608-5646
f990: 39 20 41 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 9 Any other valu
f9a0: 65 20 66 6f 72 20 74 68 65 20 62 2d 74 72 65 65 e for the b-tree
f9b0: 20 70 61 67 65 20 74 79 70 65 20 69 73 0a 20 20 page type is.
f9c0: 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 2e 20 2a ** an error. *
f9d0: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
f9e0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
f9f0: 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 70 (pPage);. }. p
fa00: 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 65 50 61 Page->max1bytePa
fa10: 79 6c 6f 61 64 20 3d 20 70 42 74 2d 3e 6d 61 78 yload = pBt->max
fa20: 31 62 79 74 65 50 61 79 6c 6f 61 64 3b 0a 20 20 1bytePayload;.
fa30: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
fa40: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 ;.}../*.** Initi
fa50: 61 6c 69 7a 65 20 74 68 65 20 61 75 78 69 6c 69 alize the auxili
fa60: 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ary information
fa70: 66 6f 72 20 61 20 64 69 73 6b 20 62 6c 6f 63 6b for a disk block
fa80: 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 ..**.** Return S
fa90: 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
faa0: 65 73 73 2e 20 20 49 66 20 77 65 20 73 65 65 20 ess. If we see
fab0: 74 68 61 74 20 74 68 65 20 70 61 67 65 20 64 6f that the page do
fac0: 65 73 0a 2a 2a 20 6e 6f 74 20 63 6f 6e 74 61 69 es.** not contai
fad0: 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 n a well-formed
fae0: 64 61 74 61 62 61 73 65 20 70 61 67 65 2c 20 74 database page, t
faf0: 68 65 6e 20 72 65 74 75 72 6e 20 0a 2a 2a 20 53 hen return .** S
fb00: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e 20 20 QLITE_CORRUPT.
fb10: 4e 6f 74 65 20 74 68 61 74 20 61 20 72 65 74 75 Note that a retu
fb20: 72 6e 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4b 20 rn of SQLITE_OK
fb30: 64 6f 65 73 20 6e 6f 74 0a 2a 2a 20 67 75 61 72 does not.** guar
fb40: 61 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 70 antee that the p
fb50: 61 67 65 20 69 73 20 77 65 6c 6c 2d 66 6f 72 6d age is well-form
fb60: 65 64 2e 20 20 49 74 20 6f 6e 6c 79 20 73 68 6f ed. It only sho
fb70: 77 73 20 74 68 61 74 0a 2a 2a 20 77 65 20 66 61 ws that.** we fa
fb80: 69 6c 65 64 20 74 6f 20 64 65 74 65 63 74 20 61 iled to detect a
fb90: 6e 79 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a ny corruption..*
fba0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 /.static int btr
fbb0: 65 65 49 6e 69 74 50 61 67 65 28 4d 65 6d 50 61 eeInitPage(MemPa
fbc0: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
fbd0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 t pc;
fbe0: 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 61 /* Address of a
fbf0: 20 66 72 65 65 62 6c 6f 63 6b 20 77 69 74 68 69 freeblock withi
fc00: 6e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d n pPage->aData[]
fc10: 20 2a 2f 0a 20 20 75 38 20 68 64 72 3b 20 20 20 */. u8 hdr;
fc20: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
fc30: 65 74 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 et to beginning
fc40: 6f 66 20 70 61 67 65 20 68 65 61 64 65 72 20 2a of page header *
fc50: 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 /. u8 *data;
fc60: 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c 20 /* Equal
fc70: 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 to pPage->aData
fc80: 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 */. BtShared *p
fc90: 42 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 Bt; /* Th
fca0: 65 20 6d 61 69 6e 20 62 74 72 65 65 20 73 74 72 e main btree str
fcb0: 75 63 74 75 72 65 20 2a 2f 0a 20 20 69 6e 74 20 ucture */. int
fcc0: 75 73 61 62 6c 65 53 69 7a 65 3b 20 20 20 20 2f usableSize; /
fcd0: 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 75 73 61 62 * Amount of usab
fce0: 6c 65 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 le space on each
fcf0: 20 70 61 67 65 20 2a 2f 0a 20 20 75 31 36 20 63 page */. u16 c
fd00: 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a ellOffset; /*
fd10: 20 4f 66 66 73 65 74 20 66 72 6f 6d 20 73 74 61 Offset from sta
fd20: 72 74 20 6f 66 20 70 61 67 65 20 74 6f 20 66 69 rt of page to fi
fd30: 72 73 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 rst cell pointer
fd40: 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b */. int nFree;
fd50: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
fd60: 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 79 74 er of unused byt
fd70: 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a es on the page *
fd80: 2f 0a 20 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 /. int top;
fd90: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
fda0: 62 79 74 65 20 6f 66 20 74 68 65 20 63 65 6c 6c byte of the cell
fdb0: 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f content area */
fdc0: 0a 20 20 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 . int iCellFirs
fdd0: 74 3b 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 t; /* First a
fde0: 6c 6c 6f 77 61 62 6c 65 20 63 65 6c 6c 20 6f 72 llowable cell or
fdf0: 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 freeblock offse
fe00: 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c t */. int iCell
fe10: 4c 61 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 Last; /* Las
fe20: 74 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 t possible cell
fe30: 6f 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 or freeblock off
fe40: 73 65 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 set */.. assert
fe50: 28 20 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 ( pPage->pBt!=0
fe60: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
fe70: 67 65 2d 3e 70 42 74 2d 3e 64 62 21 3d 30 20 29 ge->pBt->db!=0 )
fe80: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
fe90: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
fea0: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
feb0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
fec0: 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 73 71 6c 69 Page->pgno==sqli
fed0: 74 65 33 50 61 67 65 72 50 61 67 65 6e 75 6d 62 te3PagerPagenumb
fee0: 65 72 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 er(pPage->pDbPag
fef0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
ff00: 70 50 61 67 65 20 3d 3d 20 73 71 6c 69 74 65 33 pPage == sqlite3
ff10: 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 PagerGetExtra(pP
ff20: 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
ff30: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
ff40: 2d 3e 61 44 61 74 61 20 3d 3d 20 73 71 6c 69 74 ->aData == sqlit
ff50: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
ff60: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
ff70: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
ff80: 65 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a e->isInit==0 );.
ff90: 0a 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e . pBt = pPage->
ffa0: 70 42 74 3b 0a 20 20 68 64 72 20 3d 20 70 50 61 pBt;. hdr = pPa
ffb0: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 ge->hdrOffset;.
ffc0: 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 data = pPage->a
ffd0: 44 61 74 61 3b 0a 20 20 2f 2a 20 45 56 49 44 45 Data;. /* EVIDE
ffe0: 4e 43 45 2d 4f 46 3a 20 52 2d 32 38 35 39 34 2d NCE-OF: R-28594-
fff0: 30 32 38 39 30 20 54 68 65 20 6f 6e 65 2d 62 79 02890 The one-by
10000 74 65 20 66 6c 61 67 20 61 74 20 6f 66 66 73 65 te flag at offse
10010 74 20 30 20 69 6e 64 69 63 61 74 69 6e 67 0a 20 t 0 indicating.
10020 20 2a 2a 20 74 68 65 20 62 2d 74 72 65 65 20 70 ** the b-tree p
10030 61 67 65 20 74 79 70 65 2e 20 2a 2f 0a 20 20 69 age type. */. i
10040 66 28 20 64 65 63 6f 64 65 46 6c 61 67 73 28 70 f( decodeFlags(p
10050 50 61 67 65 2c 20 64 61 74 61 5b 68 64 72 5d 29 Page, data[hdr])
10060 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
10070 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
10080 47 45 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 GE(pPage);. }.
10090 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 assert( pBt->pa
100a0 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 geSize>=512 && p
100b0 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 Bt->pageSize<=65
100c0 35 33 36 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 536 );. pPage->
100d0 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 31 36 29 maskPage = (u16)
100e0 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d (pBt->pageSize -
100f0 20 31 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 4f 1);. pPage->nO
10100 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 75 verflow = 0;. u
10110 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d sableSize = pBt-
10120 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 70 >usableSize;. p
10130 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 Page->cellOffset
10140 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 = cellOffset =
10150 68 64 72 20 2b 20 38 20 2b 20 70 50 61 67 65 2d hdr + 8 + pPage-
10160 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 >childPtrSize;.
10170 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 pPage->aDataEnd
10180 20 3d 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 = &data[usableS
10190 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 61 ize];. pPage->a
101a0 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b CellIdx = &data[
101b0 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 70 cellOffset];. p
101c0 50 61 67 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 Page->aDataOfst
101d0 3d 20 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 = &data[pPage->c
101e0 68 69 6c 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 hildPtrSize];.
101f0 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
10200 52 2d 35 38 30 31 35 2d 34 38 31 37 35 20 54 68 R-58015-48175 Th
10210 65 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 67 e two-byte integ
10220 65 72 20 61 74 20 6f 66 66 73 65 74 20 35 20 64 er at offset 5 d
10230 65 73 69 67 6e 61 74 65 73 0a 20 20 2a 2a 20 74 esignates. ** t
10240 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 he start of the
10250 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 cell content are
10260 61 2e 20 41 20 7a 65 72 6f 20 76 61 6c 75 65 20 a. A zero value
10270 66 6f 72 20 74 68 69 73 20 69 6e 74 65 67 65 72 for this integer
10280 20 69 73 0a 20 20 2a 2a 20 69 6e 74 65 72 70 72 is. ** interpr
10290 65 74 65 64 20 61 73 20 36 35 35 33 36 2e 20 2a eted as 65536. *
102a0 2f 0a 20 20 74 6f 70 20 3d 20 67 65 74 32 62 79 /. top = get2by
102b0 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b teNotZero(&data[
102c0 68 64 72 2b 35 5d 29 3b 0a 20 20 2f 2a 20 45 56 hdr+5]);. /* EV
102d0 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 30 IDENCE-OF: R-370
102e0 30 32 2d 33 32 37 37 34 20 54 68 65 20 74 77 6f 02-32774 The two
102f0 2d 62 79 74 65 20 69 6e 74 65 67 65 72 20 61 74 -byte integer at
10300 20 6f 66 66 73 65 74 20 33 20 67 69 76 65 73 20 offset 3 gives
10310 74 68 65 0a 20 20 2a 2a 20 6e 75 6d 62 65 72 20 the. ** number
10320 6f 66 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 of cells on the
10330 70 61 67 65 2e 20 2a 2f 0a 20 20 70 50 61 67 65 page. */. pPage
10340 2d 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 ->nCell = get2by
10350 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 te(&data[hdr+3])
10360 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e ;. if( pPage->n
10370 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 42 74 Cell>MX_CELL(pBt
10380 29 20 29 7b 0a 20 20 20 20 2f 2a 20 54 6f 20 6d ) ){. /* To m
10390 61 6e 79 20 63 65 6c 6c 73 20 66 6f 72 20 61 20 any cells for a
103a0 73 69 6e 67 6c 65 20 70 61 67 65 2e 20 20 54 68 single page. Th
103b0 65 20 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 e page must be c
103c0 6f 72 72 75 70 74 20 2a 2f 0a 20 20 20 20 72 65 orrupt */. re
103d0 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
103e0 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b UPT_PAGE(pPage);
103f0 0a 20 20 7d 0a 20 20 74 65 73 74 63 61 73 65 28 . }. testcase(
10400 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 4d pPage->nCell==M
10410 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 3b 0a 20 X_CELL(pBt) );.
10420 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
10430 20 52 2d 32 34 30 38 39 2d 35 37 39 37 39 20 49 R-24089-57979 I
10440 66 20 61 20 70 61 67 65 20 63 6f 6e 74 61 69 6e f a page contain
10450 73 20 6e 6f 20 63 65 6c 6c 73 20 28 77 68 69 63 s no cells (whic
10460 68 20 69 73 20 6f 6e 6c 79 0a 20 20 2a 2a 20 70 h is only. ** p
10470 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 20 72 6f ossible for a ro
10480 6f 74 20 70 61 67 65 20 6f 66 20 61 20 74 61 62 ot page of a tab
10490 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 le that contains
104a0 20 6e 6f 20 72 6f 77 73 29 20 74 68 65 6e 20 74 no rows) then t
104b0 68 65 0a 20 20 2a 2a 20 6f 66 66 73 65 74 20 74 he. ** offset t
104c0 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 o the cell conte
104d0 6e 74 20 61 72 65 61 20 77 69 6c 6c 20 65 71 75 nt area will equ
104e0 61 6c 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 al the page size
104f0 20 6d 69 6e 75 73 20 74 68 65 0a 20 20 2a 2a 20 minus the. **
10500 62 79 74 65 73 20 6f 66 20 72 65 73 65 72 76 65 bytes of reserve
10510 64 20 73 70 61 63 65 2e 20 2a 2f 0a 20 20 61 73 d space. */. as
10520 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 sert( pPage->nCe
10530 6c 6c 3e 30 20 7c 7c 20 74 6f 70 3d 3d 75 73 61 ll>0 || top==usa
10540 62 6c 65 53 69 7a 65 20 7c 7c 20 43 4f 52 52 55 bleSize || CORRU
10550 50 54 5f 44 42 20 29 3b 0a 0a 20 20 2f 2a 20 41 PT_DB );.. /* A
10560 20 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 61 62 malformed datab
10570 61 73 65 20 70 61 67 65 20 6d 69 67 68 74 20 63 ase page might c
10580 61 75 73 65 20 75 73 20 74 6f 20 72 65 61 64 20 ause us to read
10590 70 61 73 74 20 74 68 65 20 65 6e 64 0a 20 20 2a past the end. *
105a0 2a 20 6f 66 20 70 61 67 65 20 77 68 65 6e 20 70 * of page when p
105b0 61 72 73 69 6e 67 20 61 20 63 65 6c 6c 2e 20 20 arsing a cell.
105c0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 . **. ** The f
105d0 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6f ollowing block o
105e0 66 20 63 6f 64 65 20 63 68 65 63 6b 73 20 65 61 f code checks ea
105f0 72 6c 79 20 74 6f 20 73 65 65 20 69 66 20 61 20 rly to see if a
10600 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a 20 20 2a cell extends. *
10610 2a 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f * past the end o
10620 66 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 72 f a page boundar
10630 79 20 61 6e 64 20 63 61 75 73 65 73 20 53 51 4c y and causes SQL
10640 49 54 45 5f 43 4f 52 52 55 50 54 20 74 6f 20 62 ITE_CORRUPT to b
10650 65 20 0a 20 20 2a 2a 20 72 65 74 75 72 6e 65 64 e . ** returned
10660 20 69 66 20 69 74 20 64 6f 65 73 2e 0a 20 20 2a if it does.. *
10670 2f 0a 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d /. iCellFirst =
10680 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a cellOffset + 2*
10690 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
106a0 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 iCellLast = usab
106b0 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 69 66 leSize - 4;. if
106c0 28 20 70 42 74 2d 3e 64 62 2d 3e 66 6c 61 67 73 ( pBt->db->flags
106d0 20 26 20 53 51 4c 49 54 45 5f 43 65 6c 6c 53 69 & SQLITE_CellSi
106e0 7a 65 43 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20 zeCk ){. int
106f0 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a i; /*
10700 20 49 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20 Index into the
10710 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 cell pointer arr
10720 61 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 73 7a ay */. int sz
10730 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ; /* S
10740 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a 2f ize of a cell */
10750 0a 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 .. if( !pPage
10760 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c 4c 61 ->leaf ) iCellLa
10770 73 74 2d 2d 3b 0a 20 20 20 20 66 6f 72 28 69 3d st--;. for(i=
10780 30 3b 20 69 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 0; i<pPage->nCel
10790 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 70 l; i++){. p
107a0 63 20 3d 20 67 65 74 32 62 79 74 65 41 6c 69 67 c = get2byteAlig
107b0 6e 65 64 28 26 64 61 74 61 5b 63 65 6c 6c 4f 66 ned(&data[cellOf
107c0 66 73 65 74 2b 69 2a 32 5d 29 3b 0a 20 20 20 20 fset+i*2]);.
107d0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
107e0 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
107f0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
10800 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 ==iCellLast );.
10810 20 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c if( pc<iCel
10820 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 lFirst || pc>iCe
10830 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 llLast ){.
10840 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
10850 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 CORRUPT_PAGE(pPa
10860 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ge);. }.
10870 20 20 20 73 7a 20 3d 20 70 50 61 67 65 2d 3e 78 sz = pPage->x
10880 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 CellSize(pPage,
10890 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 &data[pc]);.
108a0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
108b0 7a 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b z==usableSize );
108c0 0a 20 20 20 20 20 20 69 66 28 20 70 63 2b 73 7a . if( pc+sz
108d0 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
108e0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
108f0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 LITE_CORRUPT_PAG
10900 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 E(pPage);.
10910 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
10920 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 20 69 !pPage->leaf ) i
10930 43 65 6c 6c 4c 61 73 74 2b 2b 3b 0a 20 20 7d 20 CellLast++;. }
10940 20 0a 0a 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 .. /* Compute
10950 74 68 65 20 74 6f 74 61 6c 20 66 72 65 65 20 73 the total free s
10960 70 61 63 65 20 6f 6e 20 74 68 65 20 70 61 67 65 pace on the page
10970 0a 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f . ** EVIDENCE-O
10980 46 3a 20 52 2d 32 33 35 38 38 2d 33 34 34 35 30 F: R-23588-34450
10990 20 54 68 65 20 74 77 6f 2d 62 79 74 65 20 69 6e The two-byte in
109a0 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
109b0 31 20 67 69 76 65 73 20 74 68 65 0a 20 20 2a 2a 1 gives the. **
109c0 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 66 69 start of the fi
109d0 72 73 74 20 66 72 65 65 62 6c 6f 63 6b 20 6f 6e rst freeblock on
109e0 20 74 68 65 20 70 61 67 65 2c 20 6f 72 20 69 73 the page, or is
109f0 20 7a 65 72 6f 20 69 66 20 74 68 65 72 65 20 61 zero if there a
10a00 72 65 20 6e 6f 0a 20 20 2a 2a 20 66 72 65 65 62 re no. ** freeb
10a10 6c 6f 63 6b 73 2e 20 2a 2f 0a 20 20 70 63 20 3d locks. */. pc =
10a20 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
10a30 68 64 72 2b 31 5d 29 3b 0a 20 20 6e 46 72 65 65 hdr+1]);. nFree
10a40 20 3d 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2b = data[hdr+7] +
10a50 20 74 6f 70 3b 20 20 2f 2a 20 49 6e 69 74 20 6e top; /* Init n
10a60 46 72 65 65 20 74 6f 20 6e 6f 6e 2d 66 72 65 65 Free to non-free
10a70 62 6c 6f 63 6b 20 66 72 65 65 20 73 70 61 63 65 block free space
10a80 20 2a 2f 0a 20 20 69 66 28 20 70 63 3e 30 20 29 */. if( pc>0 )
10a90 7b 0a 20 20 20 20 75 33 32 20 6e 65 78 74 2c 20 {. u32 next,
10aa0 73 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 70 63 size;. if( pc
10ab0 3c 69 43 65 6c 6c 46 69 72 73 74 20 29 7b 0a 20 <iCellFirst ){.
10ac0 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
10ad0 2d 4f 46 3a 20 52 2d 35 35 35 33 30 2d 35 32 39 -OF: R-55530-529
10ae0 33 30 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 30 In a well-for
10af0 6d 65 64 20 62 2d 74 72 65 65 20 70 61 67 65 2c med b-tree page,
10b00 20 74 68 65 72 65 20 77 69 6c 6c 0a 20 20 20 20 there will.
10b10 20 20 2a 2a 20 61 6c 77 61 79 73 20 62 65 20 61 ** always be a
10b20 74 20 6c 65 61 73 74 20 6f 6e 65 20 63 65 6c 6c t least one cell
10b30 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 before the firs
10b40 74 20 66 72 65 65 62 6c 6f 63 6b 2e 0a 20 20 20 t freeblock..
10b50 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 */. retu
10b60 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
10b70 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 20 0a T_PAGE(pPage); .
10b80 20 20 20 20 7d 0a 20 20 20 20 77 68 69 6c 65 28 }. while(
10b90 20 31 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 1 ){. if(
10ba0 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
10bb0 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 62 /* Freeb
10bc0 6c 6f 63 6b 20 6f 66 66 20 74 68 65 20 65 6e 64 lock off the end
10bd0 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a of the page */.
10be0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
10bf0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
10c00 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 GE(pPage);.
10c10 20 7d 0a 20 20 20 20 20 20 6e 65 78 74 20 3d 20 }. next =
10c20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 get2byte(&data[p
10c30 63 5d 29 3b 0a 20 20 20 20 20 20 73 69 7a 65 20 c]);. size
10c40 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
10c50 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 20 20 20 6e [pc+2]);. n
10c60 46 72 65 65 20 3d 20 6e 46 72 65 65 20 2b 20 73 Free = nFree + s
10c70 69 7a 65 3b 0a 20 20 20 20 20 20 69 66 28 20 6e ize;. if( n
10c80 65 78 74 3c 3d 70 63 2b 73 69 7a 65 2b 33 20 29 ext<=pc+size+3 )
10c90 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 70 63 break;. pc
10ca0 20 3d 20 6e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 = next;. }.
10cb0 20 20 20 69 66 28 20 6e 65 78 74 3e 30 20 29 7b if( next>0 ){
10cc0 0a 20 20 20 20 20 20 2f 2a 20 46 72 65 65 62 6c . /* Freebl
10cd0 6f 63 6b 20 6e 6f 74 20 69 6e 20 61 73 63 65 6e ock not in ascen
10ce0 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 20 20 ding order */.
10cf0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
10d00 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 E_CORRUPT_PAGE(p
10d10 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 Page);. }.
10d20 20 69 66 28 20 70 63 2b 73 69 7a 65 3e 28 75 6e if( pc+size>(un
10d30 73 69 67 6e 65 64 20 69 6e 74 29 75 73 61 62 6c signed int)usabl
10d40 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 2f eSize ){. /
10d50 2a 20 4c 61 73 74 20 66 72 65 65 62 6c 6f 63 6b * Last freeblock
10d60 20 65 78 74 65 6e 64 73 20 70 61 73 74 20 70 61 extends past pa
10d70 67 65 20 65 6e 64 20 2a 2f 0a 20 20 20 20 20 20 ge end */.
10d80 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
10d90 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 RRUPT_PAGE(pPage
10da0 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
10db0 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 /* At this point
10dc0 2c 20 6e 46 72 65 65 20 63 6f 6e 74 61 69 6e 73 , nFree contains
10dd0 20 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 the sum of the
10de0 6f 66 66 73 65 74 20 74 6f 20 74 68 65 20 73 74 offset to the st
10df0 61 72 74 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 art. ** of the
10e00 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 cell-content are
10e10 61 20 70 6c 75 73 20 74 68 65 20 6e 75 6d 62 65 a plus the numbe
10e20 72 20 6f 66 20 66 72 65 65 20 62 79 74 65 73 20 r of free bytes
10e30 77 69 74 68 69 6e 0a 20 20 2a 2a 20 74 68 65 20 within. ** the
10e40 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 cell-content are
10e50 61 2e 20 49 66 20 74 68 69 73 20 69 73 20 67 72 a. If this is gr
10e60 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 75 eater than the u
10e70 73 61 62 6c 65 2d 73 69 7a 65 0a 20 20 2a 2a 20 sable-size. **
10e80 6f 66 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 of the page, the
10e90 6e 20 74 68 65 20 70 61 67 65 20 6d 75 73 74 20 n the page must
10ea0 62 65 20 63 6f 72 72 75 70 74 65 64 2e 20 54 68 be corrupted. Th
10eb0 69 73 20 63 68 65 63 6b 20 61 6c 73 6f 0a 20 20 is check also.
10ec0 2a 2a 20 73 65 72 76 65 73 20 74 6f 20 76 65 72 ** serves to ver
10ed0 69 66 79 20 74 68 61 74 20 74 68 65 20 6f 66 66 ify that the off
10ee0 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 set to the start
10ef0 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e of the cell-con
10f00 74 65 6e 74 0a 20 20 2a 2a 20 61 72 65 61 2c 20 tent. ** area,
10f10 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 according to the
10f20 20 70 61 67 65 20 68 65 61 64 65 72 2c 20 6c 69 page header, li
10f30 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 es within the pa
10f40 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e ge.. */. if( n
10f50 46 72 65 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 Free>usableSize
10f60 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
10f70 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 LITE_CORRUPT_PAG
10f80 45 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 E(pPage);. }.
10f90 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 pPage->nFree = (
10fa0 75 31 36 29 28 6e 46 72 65 65 20 2d 20 69 43 65 u16)(nFree - iCe
10fb0 6c 6c 46 69 72 73 74 29 3b 0a 20 20 70 50 61 67 llFirst);. pPag
10fc0 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 e->isInit = 1;.
10fd0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
10fe0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 K;.}../*.** Set
10ff0 75 70 20 61 20 72 61 77 20 70 61 67 65 20 73 6f up a raw page so
11000 20 74 68 61 74 20 69 74 20 6c 6f 6f 6b 73 20 6c that it looks l
11010 69 6b 65 20 61 20 64 61 74 61 62 61 73 65 20 70 ike a database p
11020 61 67 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6e age holding.** n
11030 6f 20 65 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 74 o entries..*/.st
11040 61 74 69 63 20 76 6f 69 64 20 7a 65 72 6f 50 61 atic void zeroPa
11050 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ge(MemPage *pPag
11060 65 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 e, int flags){.
11070 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
11080 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
11090 61 74 61 3b 0a 20 20 42 74 53 68 61 72 65 64 20 ata;. BtShared
110a0 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 *pBt = pPage->pB
110b0 74 3b 0a 20 20 75 38 20 68 64 72 20 3d 20 70 50 t;. u8 hdr = pP
110c0 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
110d0 20 20 75 31 36 20 66 69 72 73 74 3b 0a 0a 20 20 u16 first;..
110e0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
110f0 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 agerPagenumber(p
11100 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d Page->pDbPage)==
11110 70 50 61 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a 20 pPage->pgno );.
11120 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
11130 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 PagerGetExtra(pP
11140 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d age->pDbPage) ==
11150 20 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b (void*)pPage );
11160 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
11170 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
11180 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d Page->pDbPage) =
11190 3d 20 64 61 74 61 20 29 3b 0a 20 20 61 73 73 65 = data );. asse
111a0 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
111b0 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
111c0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
111d0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
111e0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
111f0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
11200 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
11210 20 42 54 53 5f 46 41 53 54 5f 53 45 43 55 52 45 BTS_FAST_SECURE
11220 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 ){. memset(&
11230 64 61 74 61 5b 68 64 72 5d 2c 20 30 2c 20 70 42 data[hdr], 0, pB
11240 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
11250 68 64 72 29 3b 0a 20 20 7d 0a 20 20 64 61 74 61 hdr);. }. data
11260 5b 68 64 72 5d 20 3d 20 28 63 68 61 72 29 66 6c [hdr] = (char)fl
11270 61 67 73 3b 0a 20 20 66 69 72 73 74 20 3d 20 68 ags;. first = h
11280 64 72 20 2b 20 28 28 66 6c 61 67 73 26 50 54 46 dr + ((flags&PTF
11290 5f 4c 45 41 46 29 3d 3d 30 20 3f 20 31 32 20 3a _LEAF)==0 ? 12 :
112a0 20 38 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 8);. memset(&d
112b0 61 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 ata[hdr+1], 0, 4
112c0 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d );. data[hdr+7]
112d0 20 3d 20 30 3b 0a 20 20 70 75 74 32 62 79 74 65 = 0;. put2byte
112e0 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 (&data[hdr+5], p
112f0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b Bt->usableSize);
11300 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 . pPage->nFree
11310 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 = (u16)(pBt->usa
11320 62 6c 65 53 69 7a 65 20 2d 20 66 69 72 73 74 29 bleSize - first)
11330 3b 0a 20 20 64 65 63 6f 64 65 46 6c 61 67 73 28 ;. decodeFlags(
11340 70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 pPage, flags);.
11350 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
11360 65 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 et = first;. pP
11370 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 age->aDataEnd =
11380 26 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c &data[pBt->usabl
11390 65 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d eSize];. pPage-
113a0 3e 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 >aCellIdx = &dat
113b0 61 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 a[first];. pPag
113c0 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 3d 20 26 e->aDataOfst = &
113d0 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 68 69 6c data[pPage->chil
113e0 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 70 50 61 dPtrSize];. pPa
113f0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 ge->nOverflow =
11400 30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 0;. assert( pBt
11410 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 ->pageSize>=512
11420 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 && pBt->pageSize
11430 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 70 50 61 <=65536 );. pPa
11440 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 ge->maskPage = (
11450 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 u16)(pBt->pageSi
11460 7a 65 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 65 ze - 1);. pPage
11470 2d 3e 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 ->nCell = 0;. p
11480 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 Page->isInit = 1
11490 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 ;.}.../*.** Conv
114a0 65 72 74 20 61 20 44 62 50 61 67 65 20 6f 62 74 ert a DbPage obt
114b0 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 70 ained from the p
114c0 61 67 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d 50 ager into a MemP
114d0 61 67 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 74 age used by.** t
114e0 68 65 20 62 74 72 65 65 20 6c 61 79 65 72 2e 0a he btree layer..
114f0 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 */.static MemPag
11500 65 20 2a 62 74 72 65 65 50 61 67 65 46 72 6f 6d e *btreePageFrom
11510 44 62 50 61 67 65 28 44 62 50 61 67 65 20 2a 70 DbPage(DbPage *p
11520 44 62 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 6e DbPage, Pgno pgn
11530 6f 2c 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 o, BtShared *pBt
11540 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
11550 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 age = (MemPage*)
11560 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 sqlite3PagerGetE
11570 78 74 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 xtra(pDbPage);.
11580 20 69 66 28 20 70 67 6e 6f 21 3d 70 50 61 67 65 if( pgno!=pPage
11590 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50 ->pgno ){. pP
115a0 61 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c age->aData = sql
115b0 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
115c0 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 70 (pDbPage);. p
115d0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 Page->pDbPage =
115e0 70 44 62 50 61 67 65 3b 0a 20 20 20 20 70 50 61 pDbPage;. pPa
115f0 67 65 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 ge->pBt = pBt;.
11600 20 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20 3d pPage->pgno =
11610 20 70 67 6e 6f 3b 0a 20 20 20 20 70 50 61 67 65 pgno;. pPage
11620 2d 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 70 67 ->hdrOffset = pg
11630 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b no==1 ? 100 : 0;
11640 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
11650 50 61 67 65 2d 3e 61 44 61 74 61 3d 3d 73 71 6c Page->aData==sql
11660 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
11670 28 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 (pDbPage) );. r
11680 65 74 75 72 6e 20 70 50 61 67 65 3b 20 0a 7d 0a eturn pPage; .}.
11690 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 67 ./*.** Get a pag
116a0 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 e from the pager
116b0 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 . Initialize th
116c0 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 6e e MemPage.pBt an
116d0 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 61 d.** MemPage.aDa
116e0 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 6e ta elements if n
116f0 65 65 64 65 64 2e 20 20 53 65 65 20 61 6c 73 6f eeded. See also
11700 3a 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 : btreeGetUnused
11710 50 61 67 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 Page()..**.** If
11720 20 74 68 65 20 50 41 47 45 52 5f 47 45 54 5f 4e the PAGER_GET_N
11730 4f 43 4f 4e 54 45 4e 54 20 66 6c 61 67 20 69 73 OCONTENT flag is
11740 20 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 set, it means t
11750 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 hat we do not ca
11760 72 65 0a 2a 2a 20 61 62 6f 75 74 20 74 68 65 20 re.** about the
11770 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
11780 61 67 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 age at this time
11790 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 . So do not go
117a0 74 6f 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 74 to the disk.** t
117b0 6f 20 66 65 74 63 68 20 74 68 65 20 63 6f 6e 74 o fetch the cont
117c0 65 6e 74 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 ent. Just fill
117d0 69 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 in the content w
117e0 69 74 68 20 7a 65 72 6f 73 20 66 6f 72 20 6e 6f ith zeros for no
117f0 77 2e 0a 2a 2a 20 49 66 20 69 6e 20 74 68 65 20 w..** If in the
11800 66 75 74 75 72 65 20 77 65 20 63 61 6c 6c 20 73 future we call s
11810 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
11820 28 29 20 6f 6e 20 74 68 69 73 20 70 61 67 65 2c () on this page,
11830 20 74 68 61 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 that.** means w
11840 65 20 68 61 76 65 20 73 74 61 72 74 65 64 20 74 e have started t
11850 6f 20 62 65 20 63 6f 6e 63 65 72 6e 65 64 20 61 o be concerned a
11860 62 6f 75 74 20 63 6f 6e 74 65 6e 74 20 61 6e 64 bout content and
11870 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 72 65 61 the disk.** rea
11880 64 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 d should occur a
11890 74 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f t that point..*/
118a0 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
118b0 65 47 65 74 50 61 67 65 28 0a 20 20 42 74 53 68 eGetPage(. BtSh
118c0 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
118d0 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
118e0 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 . Pgno pgno,
118f0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
11900 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f r of the page to
11910 20 66 65 74 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 fetch */. MemP
11920 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
11930 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 70 /* Return the p
11940 61 67 65 20 69 6e 20 74 68 69 73 20 70 61 72 61 age in this para
11950 6d 65 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 66 meter */. int f
11960 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 lags
11970 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 /* PAGER_GET_NOC
11980 4f 4e 54 45 4e 54 20 6f 72 20 50 41 47 45 52 5f ONTENT or PAGER_
11990 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a GET_READONLY */.
119a0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 ){. int rc;. D
119b0 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a bPage *pDbPage;.
119c0 0a 20 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 . assert( flags
119d0 3d 3d 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 ==0 || flags==PA
119e0 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e GER_GET_NOCONTEN
119f0 54 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 45 T || flags==PAGE
11a00 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 29 R_GET_READONLY )
11a10 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
11a20 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
11a30 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
11a40 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
11a50 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
11a60 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 2a , pgno, (DbPage*
11a70 2a 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 67 *)&pDbPage, flag
11a80 73 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 s);. if( rc ) r
11a90 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 eturn rc;. *ppP
11aa0 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 age = btreePageF
11ab0 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 romDbPage(pDbPag
11ac0 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 e, pgno, pBt);.
11ad0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
11ae0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 K;.}../*.** Retr
11af0 69 65 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d ieve a page from
11b00 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
11b10 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 74 . If the request
11b20 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a ed page is not.*
11b30 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 * already in the
11b40 20 70 61 67 65 72 20 63 61 63 68 65 20 72 65 74 pager cache ret
11b50 75 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 urn NULL. Initia
11b60 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 lize the MemPage
11b70 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 .pBt and.** MemP
11b80 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e age.aData elemen
11b90 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f ts if needed..*/
11ba0 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 .static MemPage
11bb0 2a 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 *btreePageLookup
11bc0 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
11bd0 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 Pgno pgno){. Db
11be0 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 Page *pDbPage;.
11bf0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
11c00 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
11c10 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 >mutex) );. pDb
11c20 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 Page = sqlite3Pa
11c30 67 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 gerLookup(pBt->p
11c40 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 Pager, pgno);.
11c50 69 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 if( pDbPage ){.
11c60 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 return btreeP
11c70 61 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 ageFromDbPage(pD
11c80 62 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 bPage, pgno, pBt
11c90 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
11ca0 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
11cb0 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 rn the size of t
11cc0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
11cd0 20 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 in pages. If th
11ce0 65 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 ere is any kind
11cf0 6f 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 of.** error, ret
11d00 75 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 urn ((unsigned i
11d10 6e 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 nt)-1)..*/.stati
11d20 63 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 c Pgno btreePage
11d30 63 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a count(BtShared *
11d40 70 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 pBt){. return p
11d50 42 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 Bt->nPage;.}.u32
11d60 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 sqlite3BtreeLas
11d70 74 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b tPage(Btree *p){
11d80 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
11d90 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
11da0 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
11db0 28 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 ( ((p->pBt->nPag
11dc0 65 29 26 30 78 38 30 30 30 30 30 30 30 29 3d 3d e)&0x80000000)==
11dd0 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 74 0 );. return bt
11de0 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 2d 3e reePagecount(p->
11df0 70 42 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 pBt);.}../*.** G
11e00 65 74 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 et a page from t
11e10 68 65 20 70 61 67 65 72 20 61 6e 64 20 69 6e 69 he pager and ini
11e20 74 69 61 6c 69 7a 65 20 69 74 2e 0a 2a 2a 0a 2a tialize it..**.*
11e30 2a 20 49 66 20 70 43 75 72 21 3d 30 20 74 68 65 * If pCur!=0 the
11e40 6e 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65 n the page is be
11e50 69 6e 67 20 66 65 74 63 68 65 64 20 61 73 20 70 ing fetched as p
11e60 61 72 74 20 6f 66 20 61 20 6d 6f 76 65 54 6f 43 art of a moveToC
11e70 68 69 6c 64 28 29 0a 2a 2a 20 63 61 6c 6c 2e 20 hild().** call.
11e80 20 44 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 Do additional s
11e90 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f anity checking o
11ea0 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 n the page in th
11eb0 69 73 20 63 61 73 65 2e 0a 2a 2a 20 41 6e 64 20 is case..** And
11ec0 69 66 20 74 68 65 20 66 65 74 63 68 20 66 61 69 if the fetch fai
11ed0 6c 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ls, this routine
11ee0 20 6d 75 73 74 20 64 65 63 72 65 6d 65 6e 74 20 must decrement
11ef0 70 43 75 72 2d 3e 69 50 61 67 65 2e 0a 2a 2a 0a pCur->iPage..**.
11f00 2a 2a 20 54 68 65 20 70 61 67 65 20 69 73 20 66 ** The page is f
11f10 65 74 63 68 65 64 20 61 73 20 72 65 61 64 2d 77 etched as read-w
11f20 72 69 74 65 20 75 6e 6c 65 73 73 20 70 43 75 72 rite unless pCur
11f30 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 is not NULL and
11f40 20 69 73 0a 2a 2a 20 61 20 72 65 61 64 2d 6f 6e is.** a read-on
11f50 6c 79 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a ly cursor..**.**
11f60 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
11f70 75 72 73 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 urs, then *ppPag
11f80 65 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 e is undefined.
11f90 49 74 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e It.** may remain
11fa0 20 75 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 unchanged, or i
11fb0 74 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 t may be set to
11fc0 61 6e 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 an invalid value
11fd0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
11fe0 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a getAndInitPage(.
11ff0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c BtShared *pBt,
12000 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12010 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 /* The databas
12020 65 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f e file */. Pgno
12030 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pgno,
12040 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
12050 75 6d 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 umber of the pag
12060 65 20 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 e to get */. Me
12070 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 mPage **ppPage,
12080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
12090 20 57 72 69 74 65 20 74 68 65 20 70 61 67 65 20 Write the page
120a0 70 6f 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a pointer here */.
120b0 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
120c0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
120d0 20 20 2f 2a 20 43 75 72 73 6f 72 20 74 6f 20 72 /* Cursor to r
120e0 65 63 65 69 76 65 20 74 68 65 20 70 61 67 65 2c eceive the page,
120f0 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 69 6e or NULL */. in
12100 74 20 62 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 t bReadOnly
12110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
12120 20 54 72 75 65 20 66 6f 72 20 61 20 72 65 61 64 True for a read
12130 2d 6f 6e 6c 79 20 70 61 67 65 20 2a 2f 0a 29 7b -only page */.){
12140 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 50 . int rc;. DbP
12150 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 age *pDbPage;.
12160 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
12170 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
12180 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
12190 72 74 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 70 rt( pCur==0 || p
121a0 70 50 61 67 65 3d 3d 26 70 43 75 72 2d 3e 70 50 pPage==&pCur->pP
121b0 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 age );. assert(
121c0 20 70 43 75 72 3d 3d 30 20 7c 7c 20 62 52 65 61 pCur==0 || bRea
121d0 64 4f 6e 6c 79 3d 3d 70 43 75 72 2d 3e 63 75 72 dOnly==pCur->cur
121e0 50 61 67 65 72 46 6c 61 67 73 20 29 3b 0a 20 20 PagerFlags );.
121f0 61 73 73 65 72 74 28 20 70 43 75 72 3d 3d 30 20 assert( pCur==0
12200 7c 7c 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 || pCur->iPage>0
12210 20 29 3b 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e );.. if( pgno>
12220 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 btreePagecount(p
12230 42 74 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 Bt) ){. rc =
12240 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
12250 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 67 65 KPT;. goto ge
12260 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 72 tAndInitPage_err
12270 6f 72 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 or;. }. rc = s
12280 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
12290 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f Bt->pPager, pgno
122a0 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 62 , (DbPage**)&pDb
122b0 50 61 67 65 2c 20 62 52 65 61 64 4f 6e 6c 79 29 Page, bReadOnly)
122c0 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
122d0 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 49 6e 69 goto getAndIni
122e0 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a 20 20 7d tPage_error;. }
122f0 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 28 4d 65 . *ppPage = (Me
12300 6d 50 61 67 65 2a 29 73 71 6c 69 74 65 33 50 61 mPage*)sqlite3Pa
12310 67 65 72 47 65 74 45 78 74 72 61 28 70 44 62 50 gerGetExtra(pDbP
12320 61 67 65 29 3b 0a 20 20 69 66 28 20 28 2a 70 70 age);. if( (*pp
12330 50 61 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 Page)->isInit==0
12340 20 29 7b 0a 20 20 20 20 62 74 72 65 65 50 61 67 ){. btreePag
12350 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 eFromDbPage(pDbP
12360 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b age, pgno, pBt);
12370 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 49 . rc = btreeI
12380 6e 69 74 50 61 67 65 28 2a 70 70 50 61 67 65 29 nitPage(*ppPage)
12390 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
123a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
123b0 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 releasePage(*pp
123c0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 67 6f 74 Page);. got
123d0 6f 20 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 o getAndInitPage
123e0 5f 65 72 72 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 _error;. }.
123f0 7d 0a 20 20 61 73 73 65 72 74 28 20 28 2a 70 70 }. assert( (*pp
12400 50 61 67 65 29 2d 3e 70 67 6e 6f 3d 3d 70 67 6e Page)->pgno==pgn
12410 6f 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 o );. assert( (
12420 2a 70 70 50 61 67 65 29 2d 3e 61 44 61 74 61 3d *ppPage)->aData=
12430 3d 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 =sqlite3PagerGet
12440 44 61 74 61 28 70 44 62 50 61 67 65 29 20 29 3b Data(pDbPage) );
12450 0a 0a 20 20 2f 2a 20 49 66 20 6f 62 74 61 69 6e .. /* If obtain
12460 69 6e 67 20 61 20 63 68 69 6c 64 20 70 61 67 65 ing a child page
12470 20 66 6f 72 20 61 20 63 75 72 73 6f 72 2c 20 77 for a cursor, w
12480 65 20 6d 75 73 74 20 76 65 72 69 66 79 20 74 68 e must verify th
12490 61 74 20 74 68 65 20 70 61 67 65 20 69 73 0a 20 at the page is.
124a0 20 2a 2a 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 ** compatible w
124b0 69 74 68 20 74 68 65 20 72 6f 6f 74 20 70 61 67 ith the root pag
124c0 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43 75 72 e. */. if( pCur
124d0 20 26 26 20 28 28 2a 70 70 50 61 67 65 29 2d 3e && ((*ppPage)->
124e0 6e 43 65 6c 6c 3c 31 20 7c 7c 20 28 2a 70 70 50 nCell<1 || (*ppP
124f0 61 67 65 29 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 age)->intKey!=pC
12500 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 29 20 29 ur->curIntKey) )
12510 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
12520 45 5f 43 4f 52 52 55 50 54 5f 50 47 4e 4f 28 70 E_CORRUPT_PGNO(p
12530 67 6e 6f 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 gno);. releas
12540 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a ePage(*ppPage);.
12550 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 49 goto getAndI
12560 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a 20 nitPage_error;.
12570 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
12580 54 45 5f 4f 4b 3b 0a 0a 67 65 74 41 6e 64 49 6e TE_OK;..getAndIn
12590 69 74 50 61 67 65 5f 65 72 72 6f 72 3a 0a 20 20 itPage_error:.
125a0 69 66 28 20 70 43 75 72 20 29 7b 0a 20 20 20 20 if( pCur ){.
125b0 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 3b 0a 20 pCur->iPage--;.
125c0 20 20 20 70 43 75 72 2d 3e 70 50 61 67 65 20 3d pCur->pPage =
125d0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
125e0 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 7d 0a ur->iPage];. }.
125f0 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e 6f testcase( pgno
12600 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
12610 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d 3d pgno!=0 || rc==
12620 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 29 SQLITE_CORRUPT )
12630 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
12640 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 ../*.** Release
12650 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 73 a MemPage. This
12660 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c 65 should be calle
12670 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 d once for each
12680 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 6f prior.** call to
12690 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a 2a btreeGetPage..*
126a0 2a 0a 2a 2a 20 50 61 67 65 31 20 69 73 20 61 20 *.** Page1 is a
126b0 73 70 65 63 69 61 6c 20 63 61 73 65 20 61 6e 64 special case and
126c0 20 6d 75 73 74 20 62 65 20 72 65 6c 65 61 73 65 must be release
126d0 64 20 75 73 69 6e 67 20 72 65 6c 65 61 73 65 50 d using releaseP
126e0 61 67 65 4f 6e 65 28 29 2e 0a 2a 2f 0a 73 74 61 ageOne()..*/.sta
126f0 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 tic void release
12700 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 4d 65 6d 50 PageNotNull(MemP
12710 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 61 age *pPage){. a
12720 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
12730 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ata );. assert(
12740 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 pPage->pBt );.
12750 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
12760 70 44 62 50 61 67 65 21 3d 30 20 29 3b 0a 20 20 pDbPage!=0 );.
12770 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
12780 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 agerGetExtra(pPa
12790 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 ge->pDbPage) ==
127a0 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a (void*)pPage );.
127b0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
127c0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 50 3PagerGetData(pP
127d0 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 age->pDbPage)==p
127e0 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 Page->aData );.
127f0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
12800 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
12810 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
12820 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
12830 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 70 50 61 UnrefNotNull(pPa
12840 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 7d 0a ge->pDbPage);.}.
12850 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 static void rele
12860 61 73 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 asePage(MemPage
12870 2a 70 50 61 67 65 29 7b 0a 20 20 69 66 28 20 70 *pPage){. if( p
12880 50 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 61 Page ) releasePa
12890 67 65 4e 6f 74 4e 75 6c 6c 28 70 50 61 67 65 29 geNotNull(pPage)
128a0 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 ;.}.static void
128b0 72 65 6c 65 61 73 65 50 61 67 65 4f 6e 65 28 4d releasePageOne(M
128c0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 7b 0a emPage *pPage){.
128d0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 assert( pPage!
128e0 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
128f0 70 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a pPage->aData );.
12900 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
12910 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 65 72 74 >pBt );. assert
12920 28 20 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 ( pPage->pDbPage
12930 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
12940 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
12950 45 78 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 Extra(pPage->pDb
12960 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 Page) == (void*)
12970 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 pPage );. asser
12980 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
12990 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 etData(pPage->pD
129a0 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 bPage)==pPage->a
129b0 44 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 Data );. assert
129c0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
129d0 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
129e0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
129f0 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 50 61 ite3PagerUnrefPa
12a00 67 65 4f 6e 65 28 70 50 61 67 65 2d 3e 70 44 62 geOne(pPage->pDb
12a10 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
12a20 47 65 74 20 61 6e 20 75 6e 75 73 65 64 20 70 61 Get an unused pa
12a30 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 ge..**.** This w
12a40 6f 72 6b 73 20 6a 75 73 74 20 6c 69 6b 65 20 62 orks just like b
12a50 74 72 65 65 47 65 74 50 61 67 65 28 29 20 77 69 treeGetPage() wi
12a60 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e 3a th the addition:
12a70 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 49 66 20 74 .**.** * If t
12a80 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 he page is alrea
12a90 64 79 20 69 6e 20 75 73 65 20 66 6f 72 20 73 6f dy in use for so
12aa0 6d 65 20 6f 74 68 65 72 20 70 75 72 70 6f 73 65 me other purpose
12ab0 2c 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a , immediately.**
12ac0 20 20 20 20 20 20 72 65 6c 65 61 73 65 20 69 74 release it
12ad0 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 53 and return an S
12ae0 51 4c 49 54 45 5f 43 55 52 52 55 50 54 20 65 72 QLITE_CURRUPT er
12af0 72 6f 72 2e 0a 2a 2a 20 20 20 2a 20 20 4d 61 6b ror..** * Mak
12b00 65 20 73 75 72 65 20 74 68 65 20 69 73 49 6e 69 e sure the isIni
12b10 74 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 0a t flag is clear.
12b20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
12b30 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 reeGetUnusedPage
12b40 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
12b50 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 t, /* The
12b60 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 btree */. Pgno
12b70 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
12b80 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 /* Number of the
12b90 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 2a page to fetch *
12ba0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
12bb0 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 75 Page, /* Retu
12bc0 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 rn the page in t
12bd0 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a 2f his parameter */
12be0 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 . int flags
12bf0 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 /* PAGER
12c00 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 6f _GET_NOCONTENT o
12c10 72 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 r PAGER_GET_READ
12c20 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ONLY */.){. int
12c30 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
12c40 67 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 ge(pBt, pgno, pp
12c50 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
12c60 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
12c70 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 73 71 6c K ){. if( sql
12c80 69 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 ite3PagerPageRef
12c90 63 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 2d count((*ppPage)-
12ca0 3e 70 44 62 50 61 67 65 29 3e 31 20 29 7b 0a 20 >pDbPage)>1 ){.
12cb0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
12cc0 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 (*ppPage);.
12cd0 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 *ppPage = 0;.
12ce0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
12cf0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
12d00 20 20 20 20 7d 0a 20 20 20 20 28 2a 70 70 50 61 }. (*ppPa
12d10 67 65 29 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b ge)->isInit = 0;
12d20 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 . }else{. *p
12d30 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 pPage = 0;. }.
12d40 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
12d50 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 20 72 /*.** During a r
12d60 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 74 68 ollback, when th
12d70 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 73 20 e pager reloads
12d80 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 6f information into
12d90 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 73 6f the cache.** so
12da0 20 74 68 61 74 20 74 68 65 20 63 61 63 68 65 20 that the cache
12db0 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 is restored to i
12dc0 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 ts original stat
12dd0 65 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f e at the start o
12de0 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 63 f.** the transac
12df0 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 20 70 tion, for each p
12e00 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 68 69 age restored thi
12e10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
12e20 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 led..**.** This
12e30 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 6f routine needs to
12e40 20 72 65 73 65 74 20 74 68 65 20 65 78 74 72 61 reset the extra
12e50 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 61 74 data section at
12e60 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 0a the end of the.
12e70 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 65 65 ** page to agree
12e80 20 77 69 74 68 20 74 68 65 20 72 65 73 74 6f 72 with the restor
12e90 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 74 ed data..*/.stat
12ea0 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 69 6e ic void pageRein
12eb0 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 74 61 it(DbPage *pData
12ec0 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
12ed0 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d 20 28 age;. pPage = (
12ee0 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 74 65 MemPage *)sqlite
12ef0 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 3PagerGetExtra(p
12f00 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74 28 Data);. assert(
12f10 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
12f20 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12f30 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 >0 );. if( pPag
12f40 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 e->isInit ){.
12f50 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
12f60 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
12f70 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
12f80 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 ;. pPage->isI
12f90 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 nit = 0;. if(
12fa0 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
12fb0 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12fc0 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 70 >1 ){. /* p
12fd0 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 20 62 Page might not b
12fe0 65 20 61 20 62 74 72 65 65 20 70 61 67 65 3b 20 e a btree page;
12ff0 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 6e 20 it might be an
13000 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 overflow page.
13010 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d 61 70 ** or ptrmap
13020 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 65 20 page or a free
13030 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 65 20 page. In those
13040 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c 6c 6f cases, the follo
13050 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 63 61 wing. ** ca
13060 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 74 50 ll to btreeInitP
13070 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b 65 6c age() will likel
13080 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f y return SQLITE_
13090 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 20 2a CORRUPT.. *
130a0 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 69 73 * But no harm is
130b0 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e 20 20 done by this.
130c0 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 20 69 And it is very i
130d0 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a 20 20 mportant that.
130e0 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e 69 74 ** btreeInit
130f0 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c 65 64 Page() be called
13100 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 65 20 on every btree
13110 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b 65 0a page so we make.
13120 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 61 6c ** the cal
13130 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 67 65 l for every page
13140 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e 20 66 that comes in f
13150 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e 20 2a or re-initing. *
13160 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 6e 69 /. btreeIni
13170 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 tPage(pPage);.
13180 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
13190 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 Invoke the busy
131a0 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 20 62 handler for a b
131b0 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tree..*/.static
131c0 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 int btreeInvokeB
131d0 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64 20 usyHandler(void
131e0 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 61 72 *pArg){. BtShar
131f0 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 68 61 ed *pBt = (BtSha
13200 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 73 73 red*)pArg;. ass
13210 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 3b 0a ert( pBt->db );.
13220 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
13230 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
13240 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
13250 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
13260 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
13270 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 73 79 r(&pBt->db->busy
13280 48 61 6e 64 6c 65 72 2c 0a 20 20 20 20 20 20 20 Handler,.
13290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
132a0 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
132b0 65 33 50 61 67 65 72 46 69 6c 65 28 70 42 74 2d e3PagerFile(pBt-
132c0 3e 70 50 61 67 65 72 29 29 3b 0a 7d 0a 0a 2f 2a >pPager));.}../*
132d0 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 62 .** Open a datab
132e0 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a ase file..** .**
132f0 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 zFilename is th
13300 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 e name of the da
13310 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
13320 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 zFilename is NU
13330 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 70 LL.** then an ep
13340 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 hemeral database
13350 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 is created. Th
13360 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 e ephemeral data
13370 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 65 base might.** be
13380 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e 20 exclusively in
13390 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d 69 memory, or it mi
133a0 67 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d 62 ght use a disk-b
133b0 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 68 ased memory cach
133c0 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 79 e..** Either way
133d0 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c 20 , the ephemeral
133e0 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 database will be
133f0 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
13400 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e 20 eleted .** when
13410 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
13420 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a e() is called..*
13430 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d *.** If zFilenam
13440 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 e is ":memory:"
13450 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 then an in-memor
13460 79 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 y database is cr
13470 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 73 eated.** that is
13480 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
13490 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 74 estroyed when it
134a0 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a is closed..**.*
134b0 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 61 * The "flags" pa
134c0 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 74 rameter is a bit
134d0 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 20 mask that might
134e0 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 6b contain bits lik
134f0 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 5f e.** BTREE_OMIT_
13500 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 42 JOURNAL and/or B
13510 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a 0a TREE_MEMORY..**.
13520 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
13530 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 se is already op
13540 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 ened in the same
13550 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
13560 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 61 tion.** and we a
13570 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 re in shared cac
13580 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 he mode, then th
13590 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 6c e open will fail
135a0 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c 49 with an.** SQLI
135b0 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 72 TE_CONSTRAINT er
135c0 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 20 ror. We cannot
135d0 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f 72 allow two or mor
135e0 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f 62 e BtShared.** ob
135f0 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 6d jects in the sam
13600 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
13610 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 6e ction since doin
13620 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a 2a g so will lead.*
13630 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 69 * to problems wi
13640 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 th locking..*/.i
13650 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f nt sqlite3BtreeO
13660 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 pen(. sqlite3_v
13670 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 2f fs *pVfs, /
13680 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f 72 * VFS to use for
13690 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f 0a this b-tree */.
136a0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
136b0 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 6d ilename, /* Nam
136c0 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f e of the file co
136d0 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 ntaining the BTr
136e0 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ee database */.
136f0 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
13700 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 6f /* Asso
13710 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 ciated database
13720 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65 handle */. Btre
13730 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 20 e **ppBtree,
13740 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
13750 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 o new Btree obje
13760 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 ct written here
13770 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 */. int flags,
13780 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
13790 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 Options */. int
137a0 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 20 vfsFlags
137b0 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 /* Flags pa
137c0 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 ssed through to
137d0 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
137e0 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 n() */.){. BtSh
137f0 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 20 ared *pBt = 0;
13800 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
13810 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 72 ared part of btr
13820 65 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a ee structure */.
13830 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 20 Btree *p;
13840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13850 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 65 /* Handle to re
13860 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 turn */. sqlite
13870 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f 70 3_mutex *mutexOp
13880 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 76 en = 0; /* Prev
13890 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e 64 ents a race cond
138a0 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 33 ition. Ticket #3
138b0 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 537 */. int rc
138c0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
138d0 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c /* Resul
138e0 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 73 t code from this
138f0 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 function */. u
13900 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 8 nReserve;
13910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
13920 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 20 Byte of unused
13930 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 space on each pa
13940 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ge */. unsigned
13950 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 5b char zDbHeader[
13960 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 61 100]; /* Databa
13970 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 6e se header conten
13980 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 20 t */.. /* True
13990 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 70 if opening an ep
139a0 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 61 hemeral, tempora
139b0 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ry database */.
139c0 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 6d const int isTem
139d0 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3d pDb = zFilename=
139e0 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b =0 || zFilename[
139f0 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 74 0]==0;.. /* Set
13a00 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 the variable is
13a10 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 6f Memdb to true fo
13a20 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 r an in-memory d
13a30 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 2a atabase, or . *
13a40 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 69 * false for a fi
13a50 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 73 le-based databas
13a60 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 e.. */.#ifdef S
13a70 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
13a80 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 YDB. const int
13a90 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 6c isMemdb = 0;.#el
13aa0 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 se. const int i
13ab0 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 6e sMemdb = (zFilen
13ac0 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a 46 ame && strcmp(zF
13ad0 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f 72 ilename, ":memor
13ae0 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 20 y:")==0).
13af0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13b00 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 20 || (isTempDb &&
13b10 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d sqlite3TempInMem
13b20 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 20 ory(db)).
13b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13b40 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 53 || (vfsFlags & S
13b50 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
13b60 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 Y)!=0;.#endif..
13b70 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 assert( db!=0 )
13b80 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 73 ;. assert( pVfs
13b90 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
13ba0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
13bb0 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
13bc0 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 ;. assert( (fla
13bd0 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 20 gs&0xff)==flags
13be0 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 ); /* flags fi
13bf0 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a 0a t in 8 bits */..
13c00 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 45 /* Only a BTRE
13c10 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 E_SINGLE databas
13c20 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f 55 e can be BTREE_U
13c30 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 73 NORDERED */. as
13c40 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 sert( (flags & B
13c50 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 3d TREE_UNORDERED)=
13c60 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 42 =0 || (flags & B
13c70 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 20 TREE_SINGLE)!=0
13c80 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 45 );.. /* A BTREE
13c90 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 _SINGLE database
13ca0 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 6d is always a tem
13cb0 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 70 porary and/or ep
13cc0 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 73 hemeral */. ass
13cd0 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 ert( (flags & BT
13ce0 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 7c REE_SINGLE)==0 |
13cf0 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a 20 | isTempDb );..
13d00 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a if( isMemdb ){.
13d10 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 52 flags |= BTR
13d20 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 20 EE_MEMORY;. }.
13d30 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 if( (vfsFlags &
13d40 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
13d50 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 4d N_DB)!=0 && (isM
13d60 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 62 emdb || isTempDb
13d70 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 ) ){. vfsFlag
13d80 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 s = (vfsFlags &
13d90 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 ~SQLITE_OPEN_MAI
13da0 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f N_DB) | SQLITE_O
13db0 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d PEN_TEMP_DB;. }
13dc0 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 . p = sqlite3Ma
13dd0 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 llocZero(sizeof(
13de0 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 21 Btree));. if( !
13df0 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 p ){. return
13e00 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
13e10 54 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 T;. }. p->inTr
13e20 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 ans = TRANS_NONE
13e30 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a ;. p->db = db;.
13e40 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
13e50 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
13e60 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 . p->lock.pBtre
13e70 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b e = p;. p->lock
13e80 2e 69 54 61 62 6c 65 20 3d 20 31 3b 0a 23 65 6e .iTable = 1;.#en
13e90 64 69 66 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 dif..#if !define
13ea0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 d(SQLITE_OMIT_SH
13eb0 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 ARED_CACHE) && !
13ec0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
13ed0 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a MIT_DISKIO). /*
13ee0 0a 20 20 2a 2a 20 49 66 20 74 68 69 73 20 42 74 . ** If this Bt
13ef0 72 65 65 20 69 73 20 61 20 63 61 6e 64 69 64 61 ree is a candida
13f00 74 65 20 66 6f 72 20 73 68 61 72 65 64 20 63 61 te for shared ca
13f10 63 68 65 2c 20 74 72 79 20 74 6f 20 66 69 6e 64 che, try to find
13f20 20 61 6e 0a 20 20 2a 2a 20 65 78 69 73 74 69 6e an. ** existin
13f30 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 g BtShared objec
13f40 74 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 68 t that we can sh
13f50 61 72 65 20 77 69 74 68 0a 20 20 2a 2f 0a 20 20 are with. */.
13f60 69 66 28 20 69 73 54 65 6d 70 44 62 3d 3d 30 20 if( isTempDb==0
13f70 26 26 20 28 69 73 4d 65 6d 64 62 3d 3d 30 20 7c && (isMemdb==0 |
13f80 7c 20 28 76 66 73 46 6c 61 67 73 26 53 51 4c 49 | (vfsFlags&SQLI
13f90 54 45 5f 4f 50 45 4e 5f 55 52 49 29 21 3d 30 29 TE_OPEN_URI)!=0)
13fa0 20 29 7b 0a 20 20 20 20 69 66 28 20 76 66 73 46 ){. if( vfsF
13fb0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
13fc0 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 29 EN_SHAREDCACHE )
13fd0 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 69 6c {. int nFil
13fe0 65 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 ename = sqlite3S
13ff0 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d trlen30(zFilenam
14000 65 29 2b 31 3b 0a 20 20 20 20 20 20 69 6e 74 20 e)+1;. int
14010 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 nFullPathname =
14020 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 pVfs->mxPathname
14030 2b 31 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a +1;. char *
14040 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 zFullPathname =
14050 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 4d 41 sqlite3Malloc(MA
14060 58 28 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c X(nFullPathname,
14070 6e 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 20 nFilename));.
14080 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
14090 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
140a0 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 0a 20 utexShared; )..
140b0 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 p->sharable
140c0 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 = 1;. if(
140d0 21 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 !zFullPathname )
140e0 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
140f0 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 3_free(p);.
14100 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
14110 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
14120 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 69 }. if( i
14130 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 20 20 sMemdb ){.
14140 20 20 6d 65 6d 63 70 79 28 7a 46 75 6c 6c 50 61 memcpy(zFullPa
14150 74 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 6e 61 6d thname, zFilenam
14160 65 2c 20 6e 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 e, nFilename);.
14170 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
14180 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
14190 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 OsFullPathname(p
141a0 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a Vfs, zFilename,.
141b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
141c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
141d0 20 20 20 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 nFullPathname
141e0 2c 20 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 , zFullPathname)
141f0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
14200 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
14210 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c lite3_free(zFull
14220 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 Pathname);.
14230 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
14240 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 e(p);.
14250 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
14260 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 69 66 }. }.#if
14270 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
14280 46 45 0a 20 20 20 20 20 20 6d 75 74 65 78 4f 70 FE. mutexOp
14290 65 6e 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 en = sqlite3Mute
142a0 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
142b0 54 45 58 5f 53 54 41 54 49 43 5f 4f 50 45 4e 29 TEX_STATIC_OPEN)
142c0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
142d0 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
142e0 78 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 6d 75 xOpen);. mu
142f0 74 65 78 53 68 61 72 65 64 20 3d 20 73 71 6c 69 texShared = sqli
14300 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
14310 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
14320 43 5f 4d 41 53 54 45 52 29 3b 0a 20 20 20 20 20 C_MASTER);.
14330 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
14340 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 nter(mutexShared
14350 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 );.#endif.
14360 66 6f 72 28 70 42 74 3d 47 4c 4f 42 41 4c 28 42 for(pBt=GLOBAL(B
14370 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 tShared*,sqlite3
14380 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 SharedCacheList)
14390 3b 20 70 42 74 3b 20 70 42 74 3d 70 42 74 2d 3e ; pBt; pBt=pBt->
143a0 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 pNext){.
143b0 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 52 65 assert( pBt->nRe
143c0 66 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 f>0 );. i
143d0 66 28 20 30 3d 3d 73 74 72 63 6d 70 28 7a 46 75 f( 0==strcmp(zFu
143e0 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 73 71 6c 69 llPathname, sqli
143f0 74 65 33 50 61 67 65 72 46 69 6c 65 6e 61 6d 65 te3PagerFilename
14400 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 30 29 (pBt->pPager, 0)
14410 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
14420 20 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 && sqlite3Pag
14430 65 72 56 66 73 28 70 42 74 2d 3e 70 50 61 67 65 erVfs(pBt->pPage
14440 72 29 3d 3d 70 56 66 73 20 29 7b 0a 20 20 20 20 r)==pVfs ){.
14450 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 int iDb;.
14460 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 44 62 for(iDb
14470 3d 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 44 62 3e =db->nDb-1; iDb>
14480 3d 30 3b 20 69 44 62 2d 2d 29 7b 0a 20 20 20 20 =0; iDb--){.
14490 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 Btree *p
144a0 45 78 69 73 74 69 6e 67 20 3d 20 64 62 2d 3e 61 Existing = db->a
144b0 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 Db[iDb].pBt;.
144c0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 45 78 if( pEx
144d0 69 73 74 69 6e 67 20 26 26 20 70 45 78 69 73 74 isting && pExist
144e0 69 6e 67 2d 3e 70 42 74 3d 3d 70 42 74 20 29 7b ing->pBt==pBt ){
144f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
14500 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
14510 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b ve(mutexShared);
14520 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
14530 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
14540 76 65 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 ve(mutexOpen);.
14550 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c sql
14560 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 ite3_free(zFullP
14570 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 athname);.
14580 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
14590 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 free(p);.
145a0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
145b0 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3b LITE_CONSTRAINT;
145c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
145d0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
145e0 20 20 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 p->pBt = pB
145f0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 70 42 74 t;. pBt
14600 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 ->nRef++;.
14610 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
14620 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
14630 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
14640 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 61 72 _leave(mutexShar
14650 65 64 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ed);. sqlit
14660 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 e3_free(zFullPat
14670 68 6e 61 6d 65 29 3b 0a 20 20 20 20 7d 0a 23 69 hname);. }.#i
14680 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
14690 47 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 G. else{.
146a0 20 20 2f 2a 20 49 6e 20 64 65 62 75 67 20 6d 6f /* In debug mo
146b0 64 65 2c 20 77 65 20 6d 61 72 6b 20 61 6c 6c 20 de, we mark all
146c0 70 65 72 73 69 73 74 65 6e 74 20 64 61 74 61 62 persistent datab
146d0 61 73 65 73 20 61 73 20 73 68 61 72 61 62 6c 65 ases as sharable
146e0 0a 20 20 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 . ** even w
146f0 68 65 6e 20 74 68 65 79 20 61 72 65 20 6e 6f 74 hen they are not
14700 2e 20 20 54 68 69 73 20 65 78 65 72 63 69 73 65 . This exercise
14710 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f s the locking co
14720 64 65 20 61 6e 64 0a 20 20 20 20 20 20 2a 2a 20 de and. **
14730 67 69 76 65 73 20 6d 6f 72 65 20 6f 70 70 6f 72 gives more oppor
14740 74 75 6e 69 74 79 20 66 6f 72 20 61 73 73 65 72 tunity for asser
14750 74 73 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 ts(sqlite3_mutex
14760 5f 68 65 6c 64 28 29 29 0a 20 20 20 20 20 20 2a _held()). *
14770 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 * statements to
14780 66 69 6e 64 20 6c 6f 63 6b 69 6e 67 20 70 72 6f find locking pro
14790 62 6c 65 6d 73 2e 0a 20 20 20 20 20 20 2a 2f 0a blems.. */.
147a0 20 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c p->sharabl
147b0 65 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e e = 1;. }.#en
147c0 64 69 66 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 dif. }.#endif.
147d0 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 if( pBt==0 ){.
147e0 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 /*. ** The
147f0 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 following asser
14800 74 73 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 ts make sure tha
14810 74 20 73 74 72 75 63 74 75 72 65 73 20 75 73 65 t structures use
14820 64 20 62 79 20 74 68 65 20 62 74 72 65 65 20 61 d by the btree a
14830 72 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 72 69 re. ** the ri
14840 67 68 74 20 73 69 7a 65 2e 20 20 54 68 69 73 20 ght size. This
14850 69 73 20 74 6f 20 67 75 61 72 64 20 61 67 61 69 is to guard agai
14860 6e 73 74 20 73 69 7a 65 20 63 68 61 6e 67 65 73 nst size changes
14870 20 74 68 61 74 20 72 65 73 75 6c 74 0a 20 20 20 that result.
14880 20 2a 2a 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 ** when compili
14890 6e 67 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e ng on a differen
148a0 74 20 61 72 63 68 69 74 65 63 74 75 72 65 2e 0a t architecture..
148b0 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 */. asser
148c0 74 28 20 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d t( sizeof(i64)==
148d0 38 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 8 );. assert(
148e0 20 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 sizeof(u64)==8
148f0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
14900 69 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 3b izeof(u32)==4 );
14910 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a . assert( siz
14920 65 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a 20 eof(u16)==2 );.
14930 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f assert( sizeo
14940 66 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 20 f(Pgno)==4 );.
14950 0a 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 74 . pBt = sqlit
14960 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 e3MallocZero( si
14970 7a 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 20 zeof(*pBt) );.
14980 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a if( pBt==0 ){.
14990 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
149a0 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
149b0 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f goto btree_o
149c0 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 pen_out;. }.
149d0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
149e0 61 67 65 72 4f 70 65 6e 28 70 56 66 73 2c 20 26 agerOpen(pVfs, &
149f0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a 46 69 pBt->pPager, zFi
14a00 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 lename,.
14a10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14a20 20 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 sizeof(MemPage
14a30 29 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 ), flags, vfsFla
14a40 67 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b gs, pageReinit);
14a50 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
14a60 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
14a70 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d sqlite3PagerSetM
14a80 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 mapLimit(pBt->pP
14a90 61 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 ager, db->szMmap
14aa0 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
14ab0 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 lite3PagerReadFi
14ac0 6c 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 leheader(pBt->pP
14ad0 61 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 ager,sizeof(zDbH
14ae0 65 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 eader),zDbHeader
14af0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
14b00 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
14b10 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 {. goto btr
14b20 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
14b30 20 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e }. pBt->open
14b40 46 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 Flags = (u8)flag
14b50 73 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d s;. pBt->db =
14b60 20 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 db;. sqlite3
14b70 50 61 67 65 72 53 65 74 42 75 73 79 48 61 6e 64 PagerSetBusyHand
14b80 6c 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ler(pBt->pPager,
14b90 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
14ba0 48 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 Handler, pBt);.
14bb0 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b p->pBt = pBt;
14bc0 0a 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 . . pBt->pCu
14bd0 72 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 rsor = 0;. pB
14be0 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 t->pPage1 = 0;.
14bf0 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 if( sqlite3Pa
14c00 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 gerIsreadonly(pB
14c10 74 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 t->pPager) ) pBt
14c20 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
14c30 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 S_READ_ONLY;.#if
14c40 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
14c50 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 0a 20 SECURE_DELETE).
14c60 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 pBt->btsFlags
14c70 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 45 5f 44 |= BTS_SECURE_D
14c80 45 4c 45 54 45 3b 0a 23 65 6c 69 66 20 64 65 66 ELETE;.#elif def
14c90 69 6e 65 64 28 53 51 4c 49 54 45 5f 46 41 53 54 ined(SQLITE_FAST
14ca0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 0a _SECURE_DELETE).
14cb0 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
14cc0 73 20 7c 3d 20 42 54 53 5f 4f 56 45 52 57 52 49 s |= BTS_OVERWRI
14cd0 54 45 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 2f TE;.#endif. /
14ce0 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
14cf0 2d 35 31 38 37 33 2d 33 39 36 31 38 20 54 68 65 -51873-39618 The
14d00 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20 61 page size for a
14d10 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 database file i
14d20 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 6d 69 s. ** determi
14d30 6e 65 64 20 62 79 20 74 68 65 20 32 2d 62 79 74 ned by the 2-byt
14d40 65 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 74 65 e integer locate
14d50 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f d at an offset o
14d60 66 20 31 36 20 62 79 74 65 73 20 66 72 6f 6d 0a f 16 bytes from.
14d70 20 20 20 20 2a 2a 20 74 68 65 20 62 65 67 69 6e ** the begin
14d80 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 61 ning of the data
14d90 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 base file. */.
14da0 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 pBt->pageSize
14db0 3d 20 28 7a 44 62 48 65 61 64 65 72 5b 31 36 5d = (zDbHeader[16]
14dc0 3c 3c 38 29 20 7c 20 28 7a 44 62 48 65 61 64 65 <<8) | (zDbHeade
14dd0 72 5b 31 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 r[17]<<16);.
14de0 69 66 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a if( pBt->pageSiz
14df0 65 3c 35 31 32 20 7c 7c 20 70 42 74 2d 3e 70 61 e<512 || pBt->pa
14e00 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 geSize>SQLITE_MA
14e10 58 5f 50 41 47 45 5f 53 49 5a 45 0a 20 20 20 20 X_PAGE_SIZE.
14e20 20 20 20 20 20 7c 7c 20 28 28 70 42 74 2d 3e 70 || ((pBt->p
14e30 61 67 65 53 69 7a 65 2d 31 29 26 70 42 74 2d 3e ageSize-1)&pBt->
14e40 70 61 67 65 53 69 7a 65 29 21 3d 30 20 29 7b 0a pageSize)!=0 ){.
14e50 20 20 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 pBt->pageS
14e60 69 7a 65 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 ize = 0;.#ifndef
14e70 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
14e80 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a OVACUUM. /*
14e90 20 49 66 20 74 68 65 20 6d 61 67 69 63 20 6e 61 If the magic na
14ea0 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 me ":memory:" wi
14eb0 6c 6c 20 63 72 65 61 74 65 20 61 6e 20 69 6e 2d ll create an in-
14ec0 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c memory database,
14ed0 20 74 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 6c then. ** l
14ee0 65 61 76 65 20 74 68 65 20 61 75 74 6f 56 61 63 eave the autoVac
14ef0 75 75 6d 20 6d 6f 64 65 20 61 74 20 30 20 28 64 uum mode at 0 (d
14f00 6f 20 6e 6f 74 20 61 75 74 6f 2d 76 61 63 75 75 o not auto-vacuu
14f10 6d 29 2c 20 65 76 65 6e 20 69 66 0a 20 20 20 20 m), even if.
14f20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 ** SQLITE_DEFA
14f30 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 ULT_AUTOVACUUM i
14f40 73 20 74 72 75 65 2e 20 4f 6e 20 74 68 65 20 6f s true. On the o
14f50 74 68 65 72 20 68 61 6e 64 2c 20 69 66 0a 20 20 ther hand, if.
14f60 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d ** SQLITE_OM
14f70 49 54 5f 4d 45 4d 4f 52 59 44 42 20 68 61 73 20 IT_MEMORYDB has
14f80 62 65 65 6e 20 64 65 66 69 6e 65 64 2c 20 74 68 been defined, th
14f90 65 6e 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 en ":memory:" is
14fa0 20 6a 75 73 74 20 61 0a 20 20 20 20 20 20 2a 2a just a. **
14fb0 20 72 65 67 75 6c 61 72 20 66 69 6c 65 2d 6e 61 regular file-na
14fc0 6d 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 me. In this case
14fd0 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d the auto-vacuum
14fe0 20 61 70 70 6c 69 65 73 20 61 73 20 70 65 72 20 applies as per
14ff0 6e 6f 72 6d 61 6c 2e 0a 20 20 20 20 20 20 2a 2f normal.. */
15000 0a 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 . if( zFile
15010 6e 61 6d 65 20 26 26 20 21 69 73 4d 65 6d 64 62 name && !isMemdb
15020 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ){. pBt-
15030 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 53 >autoVacuum = (S
15040 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 QLITE_DEFAULT_AU
15050 54 4f 56 41 43 55 55 4d 20 3f 20 31 20 3a 20 30 TOVACUUM ? 1 : 0
15060 29 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e );. pBt->
15070 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 53 51 incrVacuum = (SQ
15080 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 LITE_DEFAULT_AUT
15090 4f 56 41 43 55 55 4d 3d 3d 32 20 3f 20 31 20 3a OVACUUM==2 ? 1 :
150a0 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 0);. }.#en
150b0 64 69 66 0a 20 20 20 20 20 20 6e 52 65 73 65 72 dif. nReser
150c0 76 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 ve = 0;. }els
150d0 65 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 e{. /* EVID
150e0 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 ENCE-OF: R-37497
150f0 2d 34 32 34 31 32 20 54 68 65 20 73 69 7a 65 20 -42412 The size
15100 6f 66 20 74 68 65 20 72 65 73 65 72 76 65 64 20 of the reserved
15110 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 20 20 20 region is.
15120 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 ** determined by
15130 20 74 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e the one-byte un
15140 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 66 signed integer f
15150 6f 75 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 65 ound at an offse
15160 74 20 6f 66 20 32 30 0a 20 20 20 20 20 20 2a 2a t of 20. **
15170 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
15180 73 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 se file header.
15190 2a 2f 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 */. nReserv
151a0 65 20 3d 20 7a 44 62 48 65 61 64 65 72 5b 32 30 e = zDbHeader[20
151b0 5d 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ];. pBt->bt
151c0 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 sFlags |= BTS_PA
151d0 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 GESIZE_FIXED;.#i
151e0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
151f0 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 T_AUTOVACUUM.
15200 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
15210 75 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 um = (get4byte(&
15220 7a 44 62 48 65 61 64 65 72 5b 33 36 20 2b 20 34 zDbHeader[36 + 4
15230 2a 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 20 20 *4])?1:0);.
15240 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
15250 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 = (get4byte(&zD
15260 62 48 65 61 64 65 72 5b 33 36 20 2b 20 37 2a 34 bHeader[36 + 7*4
15270 5d 29 3f 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a ])?1:0);.#endif.
15280 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 }. rc = s
15290 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
152a0 67 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 gesize(pBt->pPag
152b0 65 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 er, &pBt->pageSi
152c0 7a 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 ze, nReserve);.
152d0 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
152e0 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b btree_open_out;
152f0 0a 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 . pBt->usable
15300 53 69 7a 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 Size = pBt->page
15310 53 69 7a 65 20 2d 20 6e 52 65 73 65 72 76 65 3b Size - nReserve;
15320 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 42 . assert( (pB
15330 74 2d 3e 70 61 67 65 53 69 7a 65 20 26 20 37 29 t->pageSize & 7)
15340 3d 3d 30 20 29 3b 20 20 2f 2a 20 38 2d 62 79 74 ==0 ); /* 8-byt
15350 65 20 61 6c 69 67 6e 6d 65 6e 74 20 6f 66 20 70 e alignment of p
15360 61 67 65 53 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 ageSize */. .#
15370 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
15380 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
15390 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e 65 ACHE) && !define
153a0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 d(SQLITE_OMIT_DI
153b0 53 4b 49 4f 29 0a 20 20 20 20 2f 2a 20 41 64 64 SKIO). /* Add
153c0 20 74 68 65 20 6e 65 77 20 42 74 53 68 61 72 65 the new BtShare
153d0 64 20 6f 62 6a 65 63 74 20 74 6f 20 74 68 65 20 d object to the
153e0 6c 69 6e 6b 65 64 20 6c 69 73 74 20 73 68 61 72 linked list shar
153f0 61 62 6c 65 20 42 74 53 68 61 72 65 64 73 2e 0a able BtShareds..
15400 20 20 20 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e */. pBt->
15410 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20 69 66 nRef = 1;. if
15420 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b ( p->sharable ){
15430 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 . MUTEX_LOG
15440 49 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 IC( sqlite3_mute
15450 78 20 2a 6d 75 74 65 78 53 68 61 72 65 64 3b 20 x *mutexShared;
15460 29 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f ). MUTEX_LO
15470 47 49 43 28 20 6d 75 74 65 78 53 68 61 72 65 64 GIC( mutexShared
15480 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 = sqlite3MutexA
15490 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
154a0 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 X_STATIC_MASTER)
154b0 3b 29 0a 20 20 20 20 20 20 69 66 28 20 53 51 4c ;). if( SQL
154c0 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 26 ITE_THREADSAFE &
154d0 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 & sqlite3GlobalC
154e0 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
154f0 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ){. pBt-
15500 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 >mutex = sqlite3
15510 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
15520 45 5f 4d 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 E_MUTEX_FAST);.
15530 20 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e if( pBt->
15540 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 mutex==0 ){.
15550 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
15560 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
15570 20 20 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 goto btr
15580 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
15590 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
155a0 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
155b0 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 53 68 ex_enter(mutexSh
155c0 61 72 65 64 29 3b 0a 20 20 20 20 20 20 70 42 74 ared);. pBt
155d0 2d 3e 70 4e 65 78 74 20 3d 20 47 4c 4f 42 41 4c ->pNext = GLOBAL
155e0 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
155f0 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15600 74 29 3b 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c t);. GLOBAL
15610 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
15620 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15630 74 29 20 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 t) = pBt;.
15640 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
15650 61 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 ave(mutexShared)
15660 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
15670 20 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 }..#if !defined
15680 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 (SQLITE_OMIT_SHA
15690 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 64 RED_CACHE) && !d
156a0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
156b0 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 20 IT_DISKIO). /*
156c0 49 66 20 74 68 65 20 6e 65 77 20 42 74 72 65 65 If the new Btree
156d0 20 75 73 65 73 20 61 20 73 68 61 72 61 62 6c 65 uses a sharable
156e0 20 70 42 74 53 68 61 72 65 64 2c 20 74 68 65 6e pBtShared, then
156f0 20 6c 69 6e 6b 20 74 68 65 20 6e 65 77 0a 20 20 link the new.
15700 2a 2a 20 42 74 72 65 65 20 69 6e 74 6f 20 74 68 ** Btree into th
15710 65 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 73 68 e list of all sh
15720 61 72 61 62 6c 65 20 42 74 72 65 65 73 20 66 6f arable Btrees fo
15730 72 20 74 68 65 20 73 61 6d 65 20 63 6f 6e 6e 65 r the same conne
15740 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 ction.. ** The
15750 6c 69 73 74 20 69 73 20 6b 65 70 74 20 69 6e 20 list is kept in
15760 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 ascending order
15770 62 79 20 70 42 74 20 61 64 64 72 65 73 73 2e 0a by pBt address..
15780 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 73 68 */. if( p->sh
15790 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 69 6e arable ){. in
157a0 74 20 69 3b 0a 20 20 20 20 42 74 72 65 65 20 2a t i;. Btree *
157b0 70 53 69 62 3b 0a 20 20 20 20 66 6f 72 28 69 3d pSib;. for(i=
157c0 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
157d0 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 28 70 +){. if( (p
157e0 53 69 62 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d Sib = db->aDb[i]
157f0 2e 70 42 74 29 21 3d 30 20 26 26 20 70 53 69 62 .pBt)!=0 && pSib
15800 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 ->sharable ){.
15810 20 20 20 20 20 20 77 68 69 6c 65 28 20 70 53 69 while( pSi
15820 62 2d 3e 70 50 72 65 76 20 29 7b 20 70 53 69 62 b->pPrev ){ pSib
15830 20 3d 20 70 53 69 62 2d 3e 70 50 72 65 76 3b 20 = pSib->pPrev;
15840 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 75 }. if( (u
15850 70 74 72 29 70 2d 3e 70 42 74 3c 28 75 70 74 72 ptr)p->pBt<(uptr
15860 29 70 53 69 62 2d 3e 70 42 74 20 29 7b 0a 20 20 )pSib->pBt ){.
15870 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
15880 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 = pSib;.
15890 20 20 20 70 2d 3e 70 50 72 65 76 20 3d 20 30 3b p->pPrev = 0;
158a0 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 2d . pSib-
158b0 3e 70 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 >pPrev = p;.
158c0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
158d0 20 20 20 20 20 77 68 69 6c 65 28 20 70 53 69 62 while( pSib
158e0 2d 3e 70 4e 65 78 74 20 26 26 20 28 75 70 74 72 ->pNext && (uptr
158f0 29 70 53 69 62 2d 3e 70 4e 65 78 74 2d 3e 70 42 )pSib->pNext->pB
15900 74 3c 28 75 70 74 72 29 70 2d 3e 70 42 74 20 29 t<(uptr)p->pBt )
15910 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 53 {. pS
15920 69 62 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 ib = pSib->pNext
15930 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
15940 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
15950 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a = pSib->pNext;.
15960 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 50 72 p->pPr
15970 65 76 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 ev = pSib;.
15980 20 20 20 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 if( p->pNex
15990 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
159a0 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 p->pNext->pPrev
159b0 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 20 20 = p;.
159c0 7d 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 }. pSib
159d0 2d 3e 70 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 ->pNext = p;.
159e0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 62 }. b
159f0 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
15a00 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
15a10 20 2a 70 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a *ppBtree = p;..
15a20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a btree_open_out:.
15a30 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
15a40 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
15a50 42 74 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 Bt && pBt->pPage
15a60 72 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 r ){. sqlit
15a70 65 33 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 e3PagerClose(pBt
15a80 2d 3e 70 50 61 67 65 72 2c 20 30 29 3b 0a 20 20 ->pPager, 0);.
15a90 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f }. sqlite3_
15aa0 66 72 65 65 28 70 42 74 29 3b 0a 20 20 20 20 73 free(pBt);. s
15ab0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
15ac0 20 20 20 20 2a 70 70 42 74 72 65 65 20 3d 20 30 *ppBtree = 0
15ad0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
15ae0 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 qlite3_file *pFi
15af0 6c 65 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 le;.. /* If t
15b00 68 65 20 42 2d 54 72 65 65 20 77 61 73 20 73 75 he B-Tree was su
15b10 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 65 6e 65 ccessfully opene
15b20 64 2c 20 73 65 74 20 74 68 65 20 70 61 67 65 72 d, set the pager
15b30 2d 63 61 63 68 65 20 73 69 7a 65 20 74 6f 20 74 -cache size to t
15b40 68 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c he. ** defaul
15b50 74 20 76 61 6c 75 65 2e 20 45 78 63 65 70 74 2c t value. Except,
15b60 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 6f 6e when opening on
15b70 20 61 6e 20 65 78 69 73 74 69 6e 67 20 73 68 61 an existing sha
15b80 72 65 64 20 70 61 67 65 72 2d 63 61 63 68 65 2c red pager-cache,
15b90 0a 20 20 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 63 . ** do not c
15ba0 68 61 6e 67 65 20 74 68 65 20 70 61 67 65 72 2d hange the pager-
15bb0 63 61 63 68 65 20 73 69 7a 65 2e 0a 20 20 20 20 cache size..
15bc0 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 */. if( sqlit
15bd0 65 33 42 74 72 65 65 53 63 68 65 6d 61 28 70 2c e3BtreeSchema(p,
15be0 20 30 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 20 0, 0)==0 ){.
15bf0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
15c00 65 74 43 61 63 68 65 73 69 7a 65 28 70 2d 3e 70 etCachesize(p->p
15c10 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 51 4c 49 Bt->pPager, SQLI
15c20 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45 TE_DEFAULT_CACHE
15c30 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 0a 20 _SIZE);. }..
15c40 20 20 20 70 46 69 6c 65 20 3d 20 73 71 6c 69 74 pFile = sqlit
15c50 65 33 50 61 67 65 72 46 69 6c 65 28 70 42 74 2d e3PagerFile(pBt-
15c60 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 >pPager);. if
15c70 28 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 ( pFile->pMethod
15c80 73 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 s ){. sqlit
15c90 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 e3OsFileControlH
15ca0 69 6e 74 28 70 46 69 6c 65 2c 20 53 51 4c 49 54 int(pFile, SQLIT
15cb0 45 5f 46 43 4e 54 4c 5f 50 44 42 2c 20 28 76 6f E_FCNTL_PDB, (vo
15cc0 69 64 2a 29 26 70 42 74 2d 3e 64 62 29 3b 0a 20 id*)&pBt->db);.
15cd0 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6d }. }. if( m
15ce0 75 74 65 78 4f 70 65 6e 20 29 7b 0a 20 20 20 20 utexOpen ){.
15cf0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
15d00 6d 75 74 65 78 5f 68 65 6c 64 28 6d 75 74 65 78 mutex_held(mutex
15d10 4f 70 65 6e 29 20 29 3b 0a 20 20 20 20 73 71 6c Open) );. sql
15d20 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
15d30 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 7d (mutexOpen);. }
15d40 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 . assert( rc!=S
15d50 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 QLITE_OK || sqli
15d60 74 65 33 42 74 72 65 65 43 6f 6e 6e 65 63 74 69 te3BtreeConnecti
15d70 6f 6e 43 6f 75 6e 74 28 2a 70 70 42 74 72 65 65 onCount(*ppBtree
15d80 29 3e 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 )>0 );. return
15d90 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 rc;.}../*.** Dec
15da0 72 65 6d 65 6e 74 20 74 68 65 20 42 74 53 68 61 rement the BtSha
15db0 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 red.nRef counter
15dc0 2e 20 20 57 68 65 6e 20 69 74 20 72 65 61 63 68 . When it reach
15dd0 65 73 20 7a 65 72 6f 2c 0a 2a 2a 20 72 65 6d 6f es zero,.** remo
15de0 76 65 20 74 68 65 20 42 74 53 68 61 72 65 64 20 ve the BtShared
15df0 73 74 72 75 63 74 75 72 65 20 66 72 6f 6d 20 74 structure from t
15e00 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 2e he sharing list.
15e10 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72 75 65 Return.** true
15e20 20 69 66 20 74 68 65 20 42 74 53 68 61 72 65 64 if the BtShared
15e30 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 20 72 65 .nRef counter re
15e40 61 63 68 65 73 20 7a 65 72 6f 20 61 6e 64 20 72 aches zero and r
15e50 65 74 75 72 6e 0a 2a 2a 20 66 61 6c 73 65 20 69 eturn.** false i
15e60 66 20 69 74 20 69 73 20 73 74 69 6c 6c 20 70 6f f it is still po
15e70 73 69 74 69 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 sitive..*/.stati
15e80 63 20 69 6e 74 20 72 65 6d 6f 76 65 46 72 6f 6d c int removeFrom
15e90 53 68 61 72 69 6e 67 4c 69 73 74 28 42 74 53 68 SharingList(BtSh
15ea0 61 72 65 64 20 2a 70 42 74 29 7b 0a 23 69 66 6e ared *pBt){.#ifn
15eb0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
15ec0 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 4d SHARED_CACHE. M
15ed0 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 UTEX_LOGIC( sqli
15ee0 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 73 74 te3_mutex *pMast
15ef0 65 72 3b 20 29 0a 20 20 42 74 53 68 61 72 65 64 er; ). BtShared
15f00 20 2a 70 4c 69 73 74 3b 0a 20 20 69 6e 74 20 72 *pList;. int r
15f10 65 6d 6f 76 65 64 20 3d 20 30 3b 0a 0a 20 20 61 emoved = 0;.. a
15f20 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
15f30 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 42 74 utex_notheld(pBt
15f40 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 4d 55 ->mutex) );. MU
15f50 54 45 58 5f 4c 4f 47 49 43 28 20 70 4d 61 73 74 TEX_LOGIC( pMast
15f60 65 72 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 er = sqlite3Mute
15f70 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
15f80 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 TEX_STATIC_MASTE
15f90 52 29 3b 20 29 0a 20 20 73 71 6c 69 74 65 33 5f R); ). sqlite3_
15fa0 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 mutex_enter(pMas
15fb0 74 65 72 29 3b 0a 20 20 70 42 74 2d 3e 6e 52 65 ter);. pBt->nRe
15fc0 66 2d 2d 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e f--;. if( pBt->
15fd0 6e 52 65 66 3c 3d 30 20 29 7b 0a 20 20 20 20 69 nRef<=0 ){. i
15fe0 66 28 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 f( GLOBAL(BtShar
15ff0 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 ed*,sqlite3Share
16000 64 43 61 63 68 65 4c 69 73 74 29 3d 3d 70 42 74 dCacheList)==pBt
16010 20 29 7b 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c ){. GLOBAL
16020 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
16030 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
16040 74 29 20 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b t) = pBt->pNext;
16050 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
16060 20 20 70 4c 69 73 74 20 3d 20 47 4c 4f 42 41 4c pList = GLOBAL
16070 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
16080 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
16090 74 29 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 t);. while(
160a0 20 41 4c 57 41 59 53 28 70 4c 69 73 74 29 20 26 ALWAYS(pList) &
160b0 26 20 70 4c 69 73 74 2d 3e 70 4e 65 78 74 21 3d & pList->pNext!=
160c0 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 pBt ){. p
160d0 4c 69 73 74 3d 70 4c 69 73 74 2d 3e 70 4e 65 78 List=pList->pNex
160e0 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 t;. }.
160f0 20 69 66 28 20 41 4c 57 41 59 53 28 70 4c 69 73 if( ALWAYS(pLis
16100 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4c t) ){. pL
16110 69 73 74 2d 3e 70 4e 65 78 74 20 3d 20 70 42 74 ist->pNext = pBt
16120 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d ->pNext;. }
16130 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 53 . }. if( S
16140 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
16150 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
16160 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 70 42 74 3_mutex_free(pBt
16170 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a ->mutex);. }.
16180 20 20 20 20 72 65 6d 6f 76 65 64 20 3d 20 31 3b removed = 1;
16190 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
161a0 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 73 74 utex_leave(pMast
161b0 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 er);. return re
161c0 6d 6f 76 65 64 3b 0a 23 65 6c 73 65 0a 20 20 72 moved;.#else. r
161d0 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a eturn 1;.#endif.
161e0 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 }../*.** Make su
161f0 72 65 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 re pBt->pTmpSpac
16200 65 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 e points to an a
16210 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 0a 2a 2a llocation of .**
16220 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 42 MX_CELL_SIZE(pB
16230 74 29 20 62 79 74 65 73 20 77 69 74 68 20 61 20 t) bytes with a
16240 34 2d 62 79 74 65 20 70 72 65 66 69 78 20 66 6f 4-byte prefix fo
16250 72 20 61 20 6c 65 66 74 2d 63 68 69 6c 64 0a 2a r a left-child.*
16260 2a 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 * pointer..*/.st
16270 61 74 69 63 20 76 6f 69 64 20 61 6c 6c 6f 63 61 atic void alloca
16280 74 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 68 teTempSpace(BtSh
16290 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 66 ared *pBt){. if
162a0 28 20 21 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 ( !pBt->pTmpSpac
162b0 65 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e 70 54 e ){. pBt->pT
162c0 6d 70 53 70 61 63 65 20 3d 20 73 71 6c 69 74 65 mpSpace = sqlite
162d0 33 50 61 67 65 4d 61 6c 6c 6f 63 28 20 70 42 74 3PageMalloc( pBt
162e0 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 0a 20 ->pageSize );..
162f0 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
16300 20 75 73 65 73 20 6f 66 20 70 42 74 2d 3e 70 54 uses of pBt->pT
16310 6d 70 53 70 61 63 65 20 69 73 20 74 6f 20 66 6f mpSpace is to fo
16320 72 6d 61 74 20 63 65 6c 6c 73 20 62 65 66 6f 72 rmat cells befor
16330 65 0a 20 20 20 20 2a 2a 20 69 6e 73 65 72 74 69 e. ** inserti
16340 6e 67 20 74 68 65 6d 20 69 6e 74 6f 20 61 20 6c ng them into a l
16350 65 61 66 20 70 61 67 65 20 28 66 75 6e 63 74 69 eaf page (functi
16360 6f 6e 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 29 on fillInCell())
16370 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 20 63 65 . If. ** a ce
16380 6c 6c 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 ll is less than
16390 34 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 4 bytes in size,
163a0 20 69 74 20 69 73 20 72 6f 75 6e 64 65 64 20 75 it is rounded u
163b0 70 20 74 6f 20 34 20 62 79 74 65 73 0a 20 20 20 p to 4 bytes.
163c0 20 2a 2a 20 62 79 20 74 68 65 20 76 61 72 69 6f ** by the vario
163d0 75 73 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 us routines that
163e0 20 6d 61 6e 69 70 75 6c 61 74 65 20 62 69 6e 61 manipulate bina
163f0 72 79 20 63 65 6c 6c 73 2e 20 57 68 69 63 68 0a ry cells. Which.
16400 20 20 20 20 2a 2a 20 63 61 6e 20 6d 65 61 6e 20 ** can mean
16410 74 68 61 74 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 that fillInCell(
16420 29 20 6f 6e 6c 79 20 69 6e 69 74 69 61 6c 69 7a ) only initializ
16430 65 73 20 74 68 65 20 66 69 72 73 74 20 32 20 6f es the first 2 o
16440 72 20 33 0a 20 20 20 20 2a 2a 20 62 79 74 65 73 r 3. ** bytes
16450 20 6f 66 20 70 54 6d 70 53 70 61 63 65 2c 20 62 of pTmpSpace, b
16460 75 74 20 74 68 61 74 20 74 68 65 20 66 69 72 73 ut that the firs
16470 74 20 34 20 62 79 74 65 73 20 61 72 65 20 63 6f t 4 bytes are co
16480 70 69 65 64 20 66 72 6f 6d 0a 20 20 20 20 2a 2a pied from. **
16490 20 69 74 20 69 6e 74 6f 20 61 20 64 61 74 61 62 it into a datab
164a0 61 73 65 20 70 61 67 65 2e 20 54 68 69 73 20 69 ase page. This i
164b0 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 61 s not actually a
164c0 20 70 72 6f 62 6c 65 6d 2c 20 62 75 74 20 69 74 problem, but it
164d0 0a 20 20 20 20 2a 2a 20 64 6f 65 73 20 63 61 75 . ** does cau
164e0 73 65 20 61 20 76 61 6c 67 72 69 6e 64 20 65 72 se a valgrind er
164f0 72 6f 72 20 77 68 65 6e 20 74 68 65 20 31 20 6f ror when the 1 o
16500 72 20 32 20 62 79 74 65 73 20 6f 66 20 75 6e 69 r 2 bytes of uni
16510 74 69 61 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a tialized . **
16520 20 64 61 74 61 20 69 73 20 70 61 73 73 65 64 20 data is passed
16530 74 6f 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 77 to system call w
16540 72 69 74 65 28 29 2e 20 53 6f 20 74 6f 20 61 76 rite(). So to av
16550 6f 69 64 20 74 68 69 73 20 65 72 72 6f 72 2c 0a oid this error,.
16560 20 20 20 20 2a 2a 20 7a 65 72 6f 20 74 68 65 20 ** zero the
16570 66 69 72 73 74 20 34 20 62 79 74 65 73 20 6f 66 first 4 bytes of
16580 20 74 65 6d 70 20 73 70 61 63 65 20 68 65 72 65 temp space here
16590 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
165a0 41 6c 73 6f 3a 20 20 50 72 6f 76 69 64 65 20 66 Also: Provide f
165b0 6f 75 72 20 62 79 74 65 73 20 6f 66 20 69 6e 69 our bytes of ini
165c0 74 69 61 6c 69 7a 65 64 20 73 70 61 63 65 20 62 tialized space b
165d0 65 66 6f 72 65 20 74 68 65 0a 20 20 20 20 2a 2a efore the. **
165e0 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 70 54 beginning of pT
165f0 6d 70 53 70 61 63 65 20 61 73 20 61 6e 20 61 72 mpSpace as an ar
16600 65 61 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 ea available to
16610 70 72 65 70 65 6e 64 20 74 68 65 0a 20 20 20 20 prepend the.
16620 2a 2a 20 6c 65 66 74 2d 63 68 69 6c 64 20 70 6f ** left-child po
16630 69 6e 74 65 72 20 74 6f 20 74 68 65 20 62 65 67 inter to the beg
16640 69 6e 6e 69 6e 67 20 6f 66 20 61 20 63 65 6c 6c inning of a cell
16650 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
16660 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
16670 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 ){. memset(
16680 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 2c 20 pBt->pTmpSpace,
16690 30 2c 20 38 29 3b 0a 20 20 20 20 20 20 70 42 74 0, 8);. pBt
166a0 2d 3e 70 54 6d 70 53 70 61 63 65 20 2b 3d 20 34 ->pTmpSpace += 4
166b0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
166c0 2a 0a 2a 2a 20 46 72 65 65 20 74 68 65 20 70 42 *.** Free the pB
166d0 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 61 6c 6c t->pTmpSpace all
166e0 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 ocation.*/.stati
166f0 63 20 76 6f 69 64 20 66 72 65 65 54 65 6d 70 53 c void freeTempS
16700 70 61 63 65 28 42 74 53 68 61 72 65 64 20 2a 70 pace(BtShared *p
16710 42 74 29 7b 0a 20 20 69 66 28 20 70 42 74 2d 3e Bt){. if( pBt->
16720 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 pTmpSpace ){.
16730 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
16740 2d 3d 20 34 3b 0a 20 20 20 20 73 71 6c 69 74 65 -= 4;. sqlite
16750 33 50 61 67 65 46 72 65 65 28 70 42 74 2d 3e 70 3PageFree(pBt->p
16760 54 6d 70 53 70 61 63 65 29 3b 0a 20 20 20 20 70 TmpSpace);. p
16770 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 Bt->pTmpSpace =
16780 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 0;. }.}../*.**
16790 43 6c 6f 73 65 20 61 6e 20 6f 70 65 6e 20 64 61 Close an open da
167a0 74 61 62 61 73 65 20 61 6e 64 20 69 6e 76 61 6c tabase and inval
167b0 69 64 61 74 65 20 61 6c 6c 20 63 75 72 73 6f 72 idate all cursor
167c0 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
167d0 33 42 74 72 65 65 43 6c 6f 73 65 28 42 74 72 65 3BtreeClose(Btre
167e0 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
167f0 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
16800 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
16810 72 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 r;.. /* Close a
16820 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 ll cursors opene
16830 64 20 76 69 61 20 74 68 69 73 20 68 61 6e 64 6c d via this handl
16840 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 e. */. assert(
16850 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
16860 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
16870 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ) );. sqlite3Bt
16880 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
16890 43 75 72 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 Cur = pBt->pCurs
168a0 6f 72 3b 0a 20 20 77 68 69 6c 65 28 20 70 43 75 or;. while( pCu
168b0 72 20 29 7b 0a 20 20 20 20 42 74 43 75 72 73 6f r ){. BtCurso
168c0 72 20 2a 70 54 6d 70 20 3d 20 70 43 75 72 3b 0a r *pTmp = pCur;.
168d0 20 20 20 20 70 43 75 72 20 3d 20 70 43 75 72 2d pCur = pCur-
168e0 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 66 28 20 >pNext;. if(
168f0 70 54 6d 70 2d 3e 70 42 74 72 65 65 3d 3d 70 20 pTmp->pBtree==p
16900 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
16910 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 BtreeCloseCursor
16920 28 70 54 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20 (pTmp);. }.
16930 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b }.. /* Rollback
16940 20 61 6e 79 20 61 63 74 69 76 65 20 74 72 61 6e any active tran
16950 73 61 63 74 69 6f 6e 20 61 6e 64 20 66 72 65 65 saction and free
16960 20 74 68 65 20 68 61 6e 64 6c 65 20 73 74 72 75 the handle stru
16970 63 74 75 72 65 2e 0a 20 20 2a 2a 20 54 68 65 20 cture.. ** The
16980 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 call to sqlite3B
16990 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 20 64 treeRollback() d
169a0 72 6f 70 73 20 61 6e 79 20 74 61 62 6c 65 2d 6c rops any table-l
169b0 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a 20 20 2a ocks held by. *
169c0 2a 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 0a 20 * this handle..
169d0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 */. sqlite3Btr
169e0 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c 20 53 51 eeRollback(p, SQ
169f0 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 73 LITE_OK, 0);. s
16a00 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
16a10 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 (p);.. /* If th
16a20 65 72 65 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 ere are still ot
16a30 68 65 72 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 her outstanding
16a40 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 references to th
16a50 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 0a 20 e shared-btree.
16a60 20 2a 2a 20 73 74 72 75 63 74 75 72 65 2c 20 72 ** structure, r
16a70 65 74 75 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 eturn now. The r
16a80 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 69 73 emainder of this
16a90 20 70 72 6f 63 65 64 75 72 65 20 63 6c 65 61 6e procedure clean
16aa0 73 20 0a 20 20 2a 2a 20 75 70 20 74 68 65 20 73 s . ** up the s
16ab0 68 61 72 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a hared-btree.. *
16ac0 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 /. assert( p->w
16ad0 61 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 antToLock==0 &&
16ae0 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a p->locked==0 );.
16af0 20 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 if( !p->sharab
16b00 6c 65 20 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d le || removeFrom
16b10 53 68 61 72 69 6e 67 4c 69 73 74 28 70 42 74 29 SharingList(pBt)
16b20 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 ){. /* The p
16b30 42 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 Bt is no longer
16b40 6f 6e 20 74 68 65 20 73 68 61 72 69 6e 67 20 6c on the sharing l
16b50 69 73 74 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 ist, so we can a
16b60 63 63 65 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 ccess. ** it
16b70 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 without having t
16b80 6f 20 68 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 o hold the mutex
16b90 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
16ba0 43 6c 65 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 Clean out and de
16bb0 6c 65 74 65 20 74 68 65 20 42 74 53 68 61 72 65 lete the BtShare
16bc0 64 20 6f 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f d object.. */
16bd0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 42 . assert( !pB
16be0 74 2d 3e 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 t->pCursor );.
16bf0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c sqlite3PagerCl
16c00 6f 73 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ose(pBt->pPager,
16c10 20 70 2d 3e 64 62 29 3b 0a 20 20 20 20 69 66 28 p->db);. if(
16c20 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 6d pBt->xFreeSchem
16c30 61 20 26 26 20 70 42 74 2d 3e 70 53 63 68 65 6d a && pBt->pSchem
16c40 61 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e a ){. pBt->
16c50 78 46 72 65 65 53 63 68 65 6d 61 28 70 42 74 2d xFreeSchema(pBt-
16c60 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 7d >pSchema);. }
16c70 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
16c80 65 65 28 30 2c 20 70 42 74 2d 3e 70 53 63 68 65 ee(0, pBt->pSche
16c90 6d 61 29 3b 0a 20 20 20 20 66 72 65 65 54 65 6d ma);. freeTem
16ca0 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 pSpace(pBt);.
16cb0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 42 sqlite3_free(pB
16cc0 74 29 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 t);. }..#ifndef
16cd0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
16ce0 52 45 44 5f 43 41 43 48 45 0a 20 20 61 73 73 65 RED_CACHE. asse
16cf0 72 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 rt( p->wantToLoc
16d00 6b 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 k==0 );. assert
16d10 28 20 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 ( p->locked==0 )
16d20 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 ;. if( p->pPrev
16d30 20 29 20 70 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 ) p->pPrev->pNe
16d40 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 xt = p->pNext;.
16d50 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 20 if( p->pNext )
16d60 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 p->pNext->pPrev
16d70 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 23 65 6e 64 = p->pPrev;.#end
16d80 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 if.. sqlite3_fr
16d90 65 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ee(p);. return
16da0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
16db0 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 22 .** Change the "
16dc0 73 6f 66 74 22 20 6c 69 6d 69 74 20 6f 6e 20 74 soft" limit on t
16dd0 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
16de0 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e es in the cache.
16df0 0a 2a 2a 20 55 6e 75 73 65 64 20 61 6e 64 20 75 .** Unused and u
16e00 6e 6d 6f 64 69 66 69 65 64 20 70 61 67 65 73 20 nmodified pages
16e10 77 69 6c 6c 20 62 65 20 72 65 63 79 63 6c 65 64 will be recycled
16e20 20 77 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 when the number
16e30 20 6f 66 0a 2a 2a 20 70 61 67 65 73 20 69 6e 20 of.** pages in
16e40 74 68 65 20 63 61 63 68 65 20 65 78 63 65 65 64 the cache exceed
16e50 73 20 74 68 69 73 20 73 6f 66 74 20 6c 69 6d 69 s this soft limi
16e60 74 2e 20 20 42 75 74 20 74 68 65 20 73 69 7a 65 t. But the size
16e70 20 6f 66 20 74 68 65 0a 2a 2a 20 63 61 63 68 65 of the.** cache
16e80 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 67 is allowed to g
16e90 72 6f 77 20 6c 61 72 67 65 72 20 74 68 61 6e 20 row larger than
16ea0 74 68 69 73 20 6c 69 6d 69 74 20 69 66 20 69 74 this limit if it
16eb0 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20 64 69 72 contains.** dir
16ec0 74 79 20 70 61 67 65 73 20 6f 72 20 70 61 67 65 ty pages or page
16ed0 73 20 73 74 69 6c 6c 20 69 6e 20 61 63 74 69 76 s still in activ
16ee0 65 20 75 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 e use..*/.int sq
16ef0 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63 lite3BtreeSetCac
16f00 68 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c heSize(Btree *p,
16f10 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 int mxPage){.
16f20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
16f30 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 p->pBt;. assert
16f40 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
16f50 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 held(p->db->mute
16f60 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 x) );. sqlite3B
16f70 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
16f80 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 sqlite3PagerSetC
16f90 61 63 68 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 achesize(pBt->pP
16fa0 61 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 ager, mxPage);.
16fb0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
16fc0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
16fd0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
16fe0 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 22 .** Change the "
16ff0 73 70 69 6c 6c 22 20 6c 69 6d 69 74 20 6f 6e 20 spill" limit on
17000 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 the number of pa
17010 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 ges in the cache
17020 2e 0a 2a 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 ..** If the numb
17030 65 72 20 6f 66 20 70 61 67 65 73 20 65 78 63 65 er of pages exce
17040 65 64 73 20 74 68 69 73 20 6c 69 6d 69 74 20 64 eds this limit d
17050 75 72 69 6e 67 20 61 20 77 72 69 74 65 20 74 72 uring a write tr
17060 61 6e 73 61 63 74 69 6f 6e 2c 0a 2a 2a 20 74 68 ansaction,.** th
17070 65 20 70 61 67 65 72 20 6d 69 67 68 74 20 61 74 e pager might at
17080 74 65 6d 70 74 20 74 6f 20 22 73 70 69 6c 6c 22 tempt to "spill"
17090 20 70 61 67 65 73 20 74 6f 20 74 68 65 20 6a 6f pages to the jo
170a0 75 72 6e 61 6c 20 65 61 72 6c 79 20 69 6e 0a 2a urnal early in.*
170b0 2a 20 6f 72 64 65 72 20 74 6f 20 66 72 65 65 20 * order to free
170c0 75 70 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a up memory..**.**
170d0 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 The value retur
170e0 6e 65 64 20 69 73 20 74 68 65 20 63 75 72 72 65 ned is the curre
170f0 6e 74 20 73 70 69 6c 6c 20 73 69 7a 65 2e 20 20 nt spill size.
17100 49 66 20 7a 65 72 6f 20 69 73 20 70 61 73 73 65 If zero is passe
17110 64 0a 2a 2a 20 61 73 20 61 6e 20 61 72 67 75 6d d.** as an argum
17120 65 6e 74 2c 20 6e 6f 20 63 68 61 6e 67 65 73 20 ent, no changes
17130 61 72 65 20 6d 61 64 65 20 74 6f 20 74 68 65 20 are made to the
17140 73 70 69 6c 6c 20 73 69 7a 65 20 73 65 74 74 69 spill size setti
17150 6e 67 2c 20 73 6f 0a 2a 2a 20 75 73 69 6e 67 20 ng, so.** using
17160 6d 78 50 61 67 65 20 6f 66 20 30 20 69 73 20 61 mxPage of 0 is a
17170 20 77 61 79 20 74 6f 20 71 75 65 72 79 20 74 68 way to query th
17180 65 20 63 75 72 72 65 6e 74 20 73 70 69 6c 6c 20 e current spill
17190 73 69 7a 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c size..*/.int sql
171a0 69 74 65 33 42 74 72 65 65 53 65 74 53 70 69 6c ite3BtreeSetSpil
171b0 6c 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 lSize(Btree *p,
171c0 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 int mxPage){. B
171d0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
171e0 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 20 72 65 73 ->pBt;. int res
171f0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
17200 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
17210 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
17220 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
17230 74 65 72 28 70 29 3b 0a 20 20 72 65 73 20 3d 20 ter(p);. res =
17240 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 53 sqlite3PagerSetS
17250 70 69 6c 6c 73 69 7a 65 28 70 42 74 2d 3e 70 50 pillsize(pBt->pP
17260 61 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 ager, mxPage);.
17270 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
17280 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
17290 72 65 73 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 res;.}..#if SQLI
172a0 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
172b0 3e 30 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 >0./*.** Change
172c0 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 the limit on the
172d0 20 61 6d 6f 75 6e 74 20 6f 66 20 74 68 65 20 64 amount of the d
172e0 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 68 61 atabase file tha
172f0 74 20 6d 61 79 20 62 65 0a 2a 2a 20 6d 65 6d 6f t may be.** memo
17300 72 79 20 6d 61 70 70 65 64 2e 0a 2a 2f 0a 69 6e ry mapped..*/.in
17310 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
17320 74 4d 6d 61 70 4c 69 6d 69 74 28 42 74 72 65 65 tMmapLimit(Btree
17330 20 2a 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 *p, sqlite3_int
17340 36 34 20 73 7a 4d 6d 61 70 29 7b 0a 20 20 42 74 64 szMmap){. Bt
17350 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
17360 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 >pBt;. assert(
17370 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
17380 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 ld(p->db->mutex)
17390 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 );. sqlite3Btr
173a0 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 eeEnter(p);. sq
173b0 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d 6d 61 lite3PagerSetMma
173c0 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 61 67 pLimit(pBt->pPag
173d0 65 72 2c 20 73 7a 4d 6d 61 70 29 3b 0a 20 20 73 er, szMmap);. s
173e0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
173f0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 (p);. return SQ
17400 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 LITE_OK;.}.#endi
17410 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 41 58 5f f /* SQLITE_MAX_
17420 4d 4d 41 50 5f 53 49 5a 45 3e 30 20 2a 2f 0a 0a MMAP_SIZE>0 */..
17430 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 /*.** Change the
17440 20 77 61 79 20 64 61 74 61 20 69 73 20 73 79 6e way data is syn
17450 63 65 64 20 74 6f 20 64 69 73 6b 20 69 6e 20 6f ced to disk in o
17460 72 64 65 72 20 74 6f 20 69 6e 63 72 65 61 73 65 rder to increase
17470 20 6f 72 20 64 65 63 72 65 61 73 65 0a 2a 2a 20 or decrease.**
17480 68 6f 77 20 77 65 6c 6c 20 74 68 65 20 64 61 74 how well the dat
17490 61 62 61 73 65 20 72 65 73 69 73 74 73 20 64 61 abase resists da
174a0 6d 61 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 mage due to OS c
174b0 72 61 73 68 65 73 20 61 6e 64 20 70 6f 77 65 72 rashes and power
174c0 0a 2a 2a 20 66 61 69 6c 75 72 65 73 2e 20 20 4c .** failures. L
174d0 65 76 65 6c 20 31 20 69 73 20 74 68 65 20 73 61 evel 1 is the sa
174e0 6d 65 20 61 73 20 61 73 79 6e 63 68 72 6f 6e 6f me as asynchrono
174f0 75 73 20 28 6e 6f 20 73 79 6e 63 73 28 29 20 6f us (no syncs() o
17500 63 63 75 72 20 61 6e 64 0a 2a 2a 20 74 68 65 72 ccur and.** ther
17510 65 20 69 73 20 61 20 68 69 67 68 20 70 72 6f 62 e is a high prob
17520 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 ability of damag
17530 65 29 20 20 4c 65 76 65 6c 20 32 20 69 73 20 74 e) Level 2 is t
17540 68 65 20 64 65 66 61 75 6c 74 2e 20 20 54 68 65 he default. The
17550 72 65 0a 2a 2a 20 69 73 20 61 20 76 65 72 79 20 re.** is a very
17560 6c 6f 77 20 62 75 74 20 6e 6f 6e 2d 7a 65 72 6f low but non-zero
17570 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 probability of
17580 64 61 6d 61 67 65 2e 20 20 4c 65 76 65 6c 20 33 damage. Level 3
17590 20 72 65 64 75 63 65 73 20 74 68 65 0a 2a 2a 20 reduces the.**
175a0 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 probability of d
175b0 61 6d 61 67 65 20 74 6f 20 6e 65 61 72 20 7a 65 amage to near ze
175c0 72 6f 20 62 75 74 20 77 69 74 68 20 61 20 77 72 ro but with a wr
175d0 69 74 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 ite performance
175e0 72 65 64 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 reduction..*/.#i
175f0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
17600 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 0a T_PAGER_PRAGMAS.
17610 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
17620 53 65 74 50 61 67 65 72 46 6c 61 67 73 28 0a 20 SetPagerFlags(.
17630 20 42 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 Btree *p,
17640 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 /* The b
17650 74 72 65 65 20 74 6f 20 73 65 74 20 74 68 65 20 tree to set the
17660 73 61 66 65 74 79 20 6c 65 76 65 6c 20 6f 6e 20 safety level on
17670 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 70 67 */. unsigned pg
17680 46 6c 61 67 73 20 20 20 20 20 20 20 2f 2a 20 56 Flags /* V
17690 61 72 69 6f 75 73 20 50 41 47 45 52 5f 2a 20 66 arious PAGER_* f
176a0 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 lags */.){. BtS
176b0 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
176c0 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 pBt;. assert( s
176d0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
176e0 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 d(p->db->mutex)
176f0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
17700 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c eEnter(p);. sql
17710 69 74 65 33 50 61 67 65 72 53 65 74 46 6c 61 67 ite3PagerSetFlag
17720 73 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 s(pBt->pPager, p
17730 67 46 6c 61 67 73 29 3b 0a 20 20 73 71 6c 69 74 gFlags);. sqlit
17740 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
17750 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
17760 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f _OK;.}.#endif../
17770 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
17780 64 65 66 61 75 6c 74 20 70 61 67 65 73 20 73 69 default pages si
17790 7a 65 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 ze and the numbe
177a0 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 62 79 r of reserved by
177b0 74 65 73 20 70 65 72 20 70 61 67 65 2e 0a 2a 2a tes per page..**
177c0 20 4f 72 2c 20 69 66 20 74 68 65 20 70 61 67 65 Or, if the page
177d0 20 73 69 7a 65 20 68 61 73 20 61 6c 72 65 61 64 size has alread
177e0 79 20 62 65 65 6e 20 66 69 78 65 64 2c 20 72 65 y been fixed, re
177f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 turn SQLITE_READ
17800 4f 4e 4c 59 20 0a 2a 2a 20 77 69 74 68 6f 75 74 ONLY .** without
17810 20 63 68 61 6e 67 69 6e 67 20 61 6e 79 74 68 69 changing anythi
17820 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 ng..**.** The pa
17830 67 65 20 73 69 7a 65 20 6d 75 73 74 20 62 65 20 ge size must be
17840 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62 65 74 a power of 2 bet
17850 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 35 ween 512 and 655
17860 33 36 2e 20 20 49 66 20 74 68 65 20 70 61 67 65 36. If the page
17870 0a 2a 2a 20 73 69 7a 65 20 73 75 70 70 6c 69 65 .** size supplie
17880 64 20 64 6f 65 73 20 6e 6f 74 20 6d 65 65 74 20 d does not meet
17890 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 this constraint
178a0 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 73 69 then the page si
178b0 7a 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 63 68 61 ze is not.** cha
178c0 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 nged..**.** Page
178d0 20 73 69 7a 65 73 20 61 72 65 20 63 6f 6e 73 74 sizes are const
178e0 72 61 69 6e 65 64 20 74 6f 20 62 65 20 61 20 70 rained to be a p
178f0 6f 77 65 72 20 6f 66 20 74 77 6f 20 73 6f 20 74 ower of two so t
17900 68 61 74 20 74 68 65 20 72 65 67 69 6f 6e 0a 2a hat the region.*
17910 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 * of the databas
17920 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20 e file used for
17930 6c 6f 63 6b 69 6e 67 20 28 62 65 67 69 6e 6e 69 locking (beginni
17940 6e 67 20 61 74 20 50 45 4e 44 49 4e 47 5f 42 59 ng at PENDING_BY
17950 54 45 2c 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 TE,.** the first
17960 20 62 79 74 65 20 70 61 73 74 20 74 68 65 20 31 byte past the 1
17970 47 42 20 62 6f 75 6e 64 61 72 79 2c 20 30 78 34 GB boundary, 0x4
17980 30 30 30 30 30 30 30 29 20 6e 65 65 64 73 20 74 0000000) needs t
17990 6f 20 6f 63 63 75 72 0a 2a 2a 20 61 74 20 74 68 o occur.** at th
179a0 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 61 e beginning of a
179b0 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 page..**.** If
179c0 70 61 72 61 6d 65 74 65 72 20 6e 52 65 73 65 72 parameter nReser
179d0 76 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 ve is less than
179e0 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 6e zero, then the n
179f0 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 umber of reserve
17a00 64 0a 2a 2a 20 62 79 74 65 73 20 70 65 72 20 70 d.** bytes per p
17a10 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e 63 68 age is left unch
17a20 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 anged..**.** If
17a30 74 68 65 20 69 46 69 78 21 3d 30 20 74 68 65 6e the iFix!=0 then
17a40 20 74 68 65 20 42 54 53 5f 50 41 47 45 53 49 5a the BTS_PAGESIZ
17a50 45 5f 46 49 58 45 44 20 66 6c 61 67 20 69 73 20 E_FIXED flag is
17a60 73 65 74 20 73 6f 20 74 68 61 74 20 74 68 65 20 set so that the
17a70 70 61 67 65 20 73 69 7a 65 0a 2a 2a 20 61 6e 64 page size.** and
17a80 20 61 75 74 6f 76 61 63 75 75 6d 20 6d 6f 64 65 autovacuum mode
17a90 20 63 61 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 can no longer b
17aa0 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e e changed..*/.in
17ab0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
17ac0 74 50 61 67 65 53 69 7a 65 28 42 74 72 65 65 20 tPageSize(Btree
17ad0 2a 70 2c 20 69 6e 74 20 70 61 67 65 53 69 7a 65 *p, int pageSize
17ae0 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 2c 20 , int nReserve,
17af0 69 6e 74 20 69 46 69 78 29 7b 0a 20 20 69 6e 74 int iFix){. int
17b00 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
17b10 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
17b20 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 = p->pBt;. ass
17b30 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e 3d 2d ert( nReserve>=-
17b40 31 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d 32 1 && nReserve<=2
17b50 35 35 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 55 );. sqlite3B
17b60 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 23 69 treeEnter(p);.#i
17b70 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 f SQLITE_HAS_COD
17b80 45 43 0a 20 20 69 66 28 20 6e 52 65 73 65 72 76 EC. if( nReserv
17b90 65 3e 70 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 e>pBt->optimalRe
17ba0 73 65 72 76 65 20 29 20 70 42 74 2d 3e 6f 70 74 serve ) pBt->opt
17bb0 69 6d 61 6c 52 65 73 65 72 76 65 20 3d 20 28 75 imalReserve = (u
17bc0 38 29 6e 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 8)nReserve;.#end
17bd0 69 66 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 if. if( pBt->bt
17be0 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 41 47 sFlags & BTS_PAG
17bf0 45 53 49 5a 45 5f 46 49 58 45 44 20 29 7b 0a 20 ESIZE_FIXED ){.
17c00 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
17c10 65 61 76 65 28 70 29 3b 0a 20 20 20 20 72 65 74 eave(p);. ret
17c20 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 4f urn SQLITE_READO
17c30 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e NLY;. }. if( n
17c40 52 65 73 65 72 76 65 3c 30 20 29 7b 0a 20 20 20 Reserve<0 ){.
17c50 20 6e 52 65 73 65 72 76 65 20 3d 20 70 42 74 2d nReserve = pBt-
17c60 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 42 74 2d >pageSize - pBt-
17c70 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 7d >usableSize;. }
17c80 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 65 . assert( nRese
17c90 72 76 65 3e 3d 30 20 26 26 20 6e 52 65 73 65 72 rve>=0 && nReser
17ca0 76 65 3c 3d 32 35 35 20 29 3b 0a 20 20 69 66 28 ve<=255 );. if(
17cb0 20 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 pageSize>=512 &
17cc0 26 20 70 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 & pageSize<=SQLI
17cd0 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 TE_MAX_PAGE_SIZE
17ce0 20 26 26 0a 20 20 20 20 20 20 20 20 28 28 70 61 &&. ((pa
17cf0 67 65 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 geSize-1)&pageSi
17d00 7a 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 ze)==0 ){. as
17d10 73 65 72 74 28 20 28 70 61 67 65 53 69 7a 65 20 sert( (pageSize
17d20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 20 61 & 7)==0 );. a
17d30 73 73 65 72 74 28 20 21 70 42 74 2d 3e 70 43 75 ssert( !pBt->pCu
17d40 72 73 6f 72 20 29 3b 0a 20 20 20 20 70 42 74 2d rsor );. pBt-
17d50 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 75 33 32 >pageSize = (u32
17d60 29 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 66 )pageSize;. f
17d70 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 reeTempSpace(pBt
17d80 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 );. }. rc = sq
17d90 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 67 lite3PagerSetPag
17da0 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 esize(pBt->pPage
17db0 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a r, &pBt->pageSiz
17dc0 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 e, nReserve);.
17dd0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
17de0 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 = pBt->pageSize
17df0 2d 20 28 75 31 36 29 6e 52 65 73 65 72 76 65 3b - (u16)nReserve;
17e00 0a 20 20 69 66 28 20 69 46 69 78 20 29 20 70 42 . if( iFix ) pB
17e10 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
17e20 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 TS_PAGESIZE_FIXE
17e30 44 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 D;. sqlite3Btre
17e40 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
17e50 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
17e60 20 52 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 Return the curr
17e70 65 6e 74 6c 79 20 64 65 66 69 6e 65 64 20 70 61 ently defined pa
17e80 67 65 20 73 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 ge size.*/.int s
17e90 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61 qlite3BtreeGetPa
17ea0 67 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 29 geSize(Btree *p)
17eb0 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 70 42 {. return p->pB
17ec0 74 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a t->pageSize;.}..
17ed0 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
17ee0 69 6f 6e 20 69 73 20 73 69 6d 69 6c 61 72 20 74 ion is similar t
17ef0 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 o sqlite3BtreeGe
17f00 74 52 65 73 65 72 76 65 28 29 2c 20 65 78 63 65 tReserve(), exce
17f10 70 74 20 74 68 61 74 20 69 74 0a 2a 2a 20 6d 61 pt that it.** ma
17f20 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 y only be called
17f30 20 69 66 20 69 74 20 69 73 20 67 75 61 72 61 6e if it is guaran
17f40 74 65 65 64 20 74 68 61 74 20 74 68 65 20 62 2d teed that the b-
17f50 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 61 6c tree mutex is al
17f60 72 65 61 64 79 0a 2a 2a 20 68 65 6c 64 2e 0a 2a ready.** held..*
17f70 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 75 73 65 *.** This is use
17f80 66 75 6c 20 69 6e 20 6f 6e 65 20 73 70 65 63 69 ful in one speci
17f90 61 6c 20 63 61 73 65 20 69 6e 20 74 68 65 20 62 al case in the b
17fa0 61 63 6b 75 70 20 41 50 49 20 63 6f 64 65 20 77 ackup API code w
17fb0 68 65 72 65 20 69 74 20 69 73 0a 2a 2a 20 6b 6e here it is.** kn
17fc0 6f 77 6e 20 74 68 61 74 20 74 68 65 20 73 68 61 own that the sha
17fd0 72 65 64 20 62 2d 74 72 65 65 20 6d 75 74 65 78 red b-tree mutex
17fe0 20 69 73 20 68 65 6c 64 2c 20 62 75 74 20 74 68 is held, but th
17ff0 65 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20 0a e mutex on the .
18000 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 ** database hand
18010 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a 70 20 le that owns *p
18020 69 73 20 6e 6f 74 2e 20 49 6e 20 74 68 69 73 20 is not. In this
18030 63 61 73 65 20 69 66 20 73 71 6c 69 74 65 33 42 case if sqlite3B
18040 74 72 65 65 45 6e 74 65 72 28 29 0a 2a 2a 20 77 treeEnter().** w
18050 65 72 65 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 ere to be called
18060 2c 20 69 74 20 6d 69 67 68 74 20 63 6f 6c 6c 69 , it might colli
18070 64 65 20 77 69 74 68 20 73 6f 6d 65 20 6f 74 68 de with some oth
18080 65 72 20 6f 70 65 72 61 74 69 6f 6e 20 6f 6e 20 er operation on
18090 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 the.** database
180a0 68 61 6e 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 handle that owns
180b0 20 2a 70 2c 20 63 61 75 73 69 6e 67 20 75 6e 64 *p, causing und
180c0 65 66 69 6e 65 64 20 62 65 68 61 76 69 6f 72 2e efined behavior.
180d0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
180e0 74 72 65 65 47 65 74 52 65 73 65 72 76 65 4e 6f treeGetReserveNo
180f0 4d 75 74 65 78 28 42 74 72 65 65 20 2a 70 29 7b Mutex(Btree *p){
18100 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73 65 . int n;. asse
18110 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
18120 78 5f 68 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d x_held(p->pBt->m
18130 75 74 65 78 29 20 29 3b 0a 20 20 6e 20 3d 20 70 utex) );. n = p
18140 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 ->pBt->pageSize
18150 2d 20 70 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 - p->pBt->usable
18160 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 6e Size;. return n
18170 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
18180 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
18190 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 61 bytes of space a
181a0 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 65 t the end of eve
181b0 72 79 20 70 61 67 65 20 74 68 61 74 0a 2a 2a 20 ry page that.**
181c0 61 72 65 20 69 6e 74 65 6e 74 75 61 6c 6c 79 20 are intentually
181d0 6c 65 66 74 20 75 6e 75 73 65 64 2e 20 20 54 68 left unused. Th
181e0 69 73 20 69 73 20 74 68 65 20 22 72 65 73 65 72 is is the "reser
181f0 76 65 64 22 20 73 70 61 63 65 20 74 68 61 74 20 ved" space that
18200 69 73 0a 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 is.** sometimes
18210 75 73 65 64 20 62 79 20 65 78 74 65 6e 73 69 6f used by extensio
18220 6e 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c ns..**.** If SQL
18230 49 54 45 5f 48 41 53 5f 4d 55 54 45 58 20 69 73 ITE_HAS_MUTEX is
18240 20 64 65 66 69 6e 65 64 20 74 68 65 6e 20 74 68 defined then th
18250 65 20 6e 75 6d 62 65 72 20 72 65 74 75 72 6e 65 e number returne
18260 64 20 69 73 20 74 68 65 0a 2a 2a 20 67 72 65 61 d is the.** grea
18270 74 65 72 20 6f 66 20 74 68 65 20 63 75 72 72 65 ter of the curre
18280 6e 74 20 72 65 73 65 72 76 65 64 20 73 70 61 63 nt reserved spac
18290 65 20 61 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 e and the maximu
182a0 6d 20 72 65 71 75 65 73 74 65 64 0a 2a 2a 20 72 m requested.** r
182b0 65 73 65 72 76 65 20 73 70 61 63 65 2e 0a 2a 2f eserve space..*/
182c0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
182d0 65 47 65 74 4f 70 74 69 6d 61 6c 52 65 73 65 72 eGetOptimalReser
182e0 76 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ve(Btree *p){.
182f0 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 int n;. sqlite3
18300 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
18310 20 6e 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 n = sqlite3Btre
18320 65 47 65 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 eGetReserveNoMut
18330 65 78 28 70 29 3b 0a 23 69 66 64 65 66 20 53 51 ex(p);.#ifdef SQ
18340 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 LITE_HAS_CODEC.
18350 20 69 66 28 20 6e 3c 70 2d 3e 70 42 74 2d 3e 6f if( n<p->pBt->o
18360 70 74 69 6d 61 6c 52 65 73 65 72 76 65 20 29 20 ptimalReserve )
18370 6e 20 3d 20 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 n = p->pBt->opti
18380 6d 61 6c 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 malReserve;.#end
18390 69 66 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 if. sqlite3Btre
183a0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
183b0 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a urn n;.}.../*.**
183c0 20 53 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d Set the maximum
183d0 20 70 61 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 page count for
183e0 61 20 64 61 74 61 62 61 73 65 20 69 66 20 6d 78 a database if mx
183f0 50 61 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 Page is positive
18400 2e 0a 2a 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 ..** No changes
18410 61 72 65 20 6d 61 64 65 20 69 66 20 6d 78 50 61 are made if mxPa
18420 67 65 20 69 73 20 30 20 6f 72 20 6e 65 67 61 74 ge is 0 or negat
18430 69 76 65 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 ive..** Regardle
18440 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 ss of the value
18450 6f 66 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 of mxPage, retur
18460 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 n the maximum pa
18470 67 65 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 ge count..*/.int
18480 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d 61 78 sqlite3BtreeMax
18490 50 61 67 65 43 6f 75 6e 74 28 42 74 72 65 65 20 PageCount(Btree
184a0 2a 70 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b *p, int mxPage){
184b0 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 . int n;. sqli
184c0 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
184d0 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 ;. n = sqlite3P
184e0 61 67 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 agerMaxPageCount
184f0 28 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c (p->pBt->pPager,
18500 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 mxPage);. sqli
18510 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
18520 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a ;. return n;.}.
18530 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 ./*.** Change th
18540 65 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 e values for the
18550 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
18560 54 45 20 61 6e 64 20 42 54 53 5f 4f 56 45 52 57 TE and BTS_OVERW
18570 52 49 54 45 20 66 6c 61 67 73 3a 0a 2a 2a 0a 2a RITE flags:.**.*
18580 2a 20 20 20 20 6e 65 77 46 6c 61 67 3d 3d 30 20 * newFlag==0
18590 20 20 20 20 20 20 42 6f 74 68 20 42 54 53 5f 53 Both BTS_S
185a0 45 43 55 52 45 5f 44 45 4c 45 54 45 20 61 6e 64 ECURE_DELETE and
185b0 20 42 54 53 5f 4f 56 45 52 57 52 49 54 45 20 61 BTS_OVERWRITE a
185c0 72 65 20 63 6c 65 61 72 65 64 0a 2a 2a 20 20 20 re cleared.**
185d0 20 6e 65 77 46 6c 61 67 3d 3d 31 20 20 20 20 20 newFlag==1
185e0 20 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c BTS_SECURE_DEL
185f0 45 54 45 20 73 65 74 20 61 6e 64 20 42 54 53 5f ETE set and BTS_
18600 4f 56 45 52 57 52 49 54 45 20 69 73 20 63 6c 65 OVERWRITE is cle
18610 61 72 65 64 0a 2a 2a 20 20 20 20 6e 65 77 46 6c ared.** newFl
18620 61 67 3d 3d 32 20 20 20 20 20 20 20 42 54 53 5f ag==2 BTS_
18630 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 63 6c SECURE_DELETE cl
18640 65 61 72 65 64 20 61 6e 64 20 42 54 53 5f 4f 56 eared and BTS_OV
18650 45 52 57 52 49 54 45 20 69 73 20 73 65 74 0a 2a ERWRITE is set.*
18660 2a 20 20 20 20 6e 65 77 46 6c 61 67 3d 3d 28 2d * newFlag==(-
18670 31 29 20 20 20 20 4e 6f 20 63 68 61 6e 67 65 73 1) No changes
18680 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
18690 69 6e 65 20 61 63 74 73 20 61 73 20 61 20 71 75 ine acts as a qu
186a0 65 72 79 20 69 66 20 6e 65 77 46 6c 61 67 20 69 ery if newFlag i
186b0 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f s less than zero
186c0 0a 2a 2a 0a 2a 2a 20 57 69 74 68 20 42 54 53 5f .**.** With BTS_
186d0 4f 56 45 52 57 52 49 54 45 20 73 65 74 2c 20 64 OVERWRITE set, d
186e0 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74 20 69 eleted content i
186f0 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 62 79 s overwritten by
18700 20 7a 65 72 6f 73 2c 20 62 75 74 0a 2a 2a 20 66 zeros, but.** f
18710 72 65 65 6c 69 73 74 20 6c 65 61 66 20 70 61 67 reelist leaf pag
18720 65 73 20 61 72 65 20 6e 6f 74 20 77 72 69 74 74 es are not writt
18730 65 6e 20 62 61 63 6b 20 74 6f 20 74 68 65 20 64 en back to the d
18740 61 74 61 62 61 73 65 2e 20 20 54 68 75 73 20 69 atabase. Thus i
18750 6e 2d 70 61 67 65 0a 2a 2a 20 64 65 6c 65 74 65 n-page.** delete
18760 64 20 63 6f 6e 74 65 6e 74 20 69 73 20 63 6c 65 d content is cle
18770 61 72 65 64 2c 20 62 75 74 20 66 72 65 65 6c 69 ared, but freeli
18780 73 74 20 64 65 6c 65 74 65 64 20 63 6f 6e 74 65 st deleted conte
18790 6e 74 20 69 73 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a nt is not..**.**
187a0 20 57 69 74 68 20 42 54 53 5f 53 45 43 55 52 45 With BTS_SECURE
187b0 5f 44 45 4c 45 54 45 2c 20 6f 70 65 72 61 74 69 _DELETE, operati
187c0 6f 6e 20 69 73 20 6c 69 6b 65 20 42 54 53 5f 4f on is like BTS_O
187d0 56 45 52 57 52 49 54 45 20 77 69 74 68 20 74 68 VERWRITE with th
187e0 65 20 61 64 64 69 74 69 6f 6e 0a 2a 2a 20 74 68 e addition.** th
187f0 61 74 20 66 72 65 65 6c 69 73 74 20 6c 65 61 66 at freelist leaf
18800 20 70 61 67 65 73 20 61 72 65 20 77 72 69 74 74 pages are writt
18810 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 en back into the
18820 20 64 61 74 61 62 61 73 65 2c 20 69 6e 63 72 65 database, incre
18830 61 73 69 6e 67 0a 2a 2a 20 74 68 65 20 61 6d 6f asing.** the amo
18840 75 6e 74 20 6f 66 20 64 69 73 6b 20 49 2f 4f 2e unt of disk I/O.
18850 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
18860 74 72 65 65 53 65 63 75 72 65 44 65 6c 65 74 65 treeSecureDelete
18870 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6e (Btree *p, int n
18880 65 77 46 6c 61 67 29 7b 0a 20 20 69 6e 74 20 62 ewFlag){. int b
18890 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 ;. if( p==0 ) r
188a0 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74 eturn 0;. sqlit
188b0 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
188c0 0a 20 20 61 73 73 65 72 74 28 20 42 54 53 5f 4f . assert( BTS_O
188d0 56 45 52 57 52 49 54 45 3d 3d 42 54 53 5f 53 45 VERWRITE==BTS_SE
188e0 43 55 52 45 5f 44 45 4c 45 54 45 2a 32 20 29 3b CURE_DELETE*2 );
188f0 0a 20 20 61 73 73 65 72 74 28 20 42 54 53 5f 46 . assert( BTS_F
18900 41 53 54 5f 53 45 43 55 52 45 3d 3d 28 42 54 53 AST_SECURE==(BTS
18910 5f 4f 56 45 52 57 52 49 54 45 7c 42 54 53 5f 53 _OVERWRITE|BTS_S
18920 45 43 55 52 45 5f 44 45 4c 45 54 45 29 20 29 3b ECURE_DELETE) );
18930 0a 20 20 69 66 28 20 6e 65 77 46 6c 61 67 3e 3d . if( newFlag>=
18940 30 20 29 7b 0a 20 20 20 20 70 2d 3e 70 42 74 2d 0 ){. p->pBt-
18950 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 >btsFlags &= ~BT
18960 53 5f 46 41 53 54 5f 53 45 43 55 52 45 3b 0a 20 S_FAST_SECURE;.
18970 20 20 20 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c p->pBt->btsFl
18980 61 67 73 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 ags |= BTS_SECUR
18990 45 5f 44 45 4c 45 54 45 2a 6e 65 77 46 6c 61 67 E_DELETE*newFlag
189a0 3b 0a 20 20 7d 0a 20 20 62 20 3d 20 28 70 2d 3e ;. }. b = (p->
189b0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
189c0 42 54 53 5f 46 41 53 54 5f 53 45 43 55 52 45 29 BTS_FAST_SECURE)
189d0 2f 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 /BTS_SECURE_DELE
189e0 54 45 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 TE;. sqlite3Btr
189f0 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
18a00 74 75 72 6e 20 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn b;.}../*.**
18a10 20 43 68 61 6e 67 65 20 74 68 65 20 27 61 75 74 Change the 'aut
18a20 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 o-vacuum' proper
18a30 74 79 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ty of the databa
18a40 73 65 2e 20 49 66 20 74 68 65 20 27 61 75 74 6f se. If the 'auto
18a50 56 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 6d Vacuum'.** param
18a60 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f eter is non-zero
18a70 2c 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 75 , then auto-vacu
18a80 75 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 6c um mode is enabl
18a90 65 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 0a ed. If zero, it.
18aa0 2a 2a 20 69 73 20 64 69 73 61 62 6c 65 64 2e 20 ** is disabled.
18ab0 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 The default valu
18ac0 65 20 66 6f 72 20 74 68 65 20 61 75 74 6f 2d 76 e for the auto-v
18ad0 61 63 75 75 6d 20 70 72 6f 70 65 72 74 79 20 69 acuum property i
18ae0 73 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 s .** determined
18af0 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 44 by the SQLITE_D
18b00 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 EFAULT_AUTOVACUU
18b10 4d 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 M macro..*/.int
18b20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 41 sqlite3BtreeSetA
18b30 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 20 utoVacuum(Btree
18b40 2a 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 75 *p, int autoVacu
18b50 75 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 um){.#ifdef SQLI
18b60 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
18b70 55 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 UM. return SQLI
18b80 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 6c TE_READONLY;.#el
18b90 73 65 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 se. BtShared *p
18ba0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 Bt = p->pBt;. i
18bb0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
18bc0 4b 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 75 38 K;. u8 av = (u8
18bd0 29 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 20 )autoVacuum;..
18be0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
18bf0 72 28 70 29 3b 0a 20 20 69 66 28 20 28 70 42 74 r(p);. if( (pBt
18c00 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
18c10 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 29 _PAGESIZE_FIXED)
18c20 21 3d 30 20 26 26 20 28 61 76 20 3f 31 3a 30 29 !=0 && (av ?1:0)
18c30 21 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 !=pBt->autoVacuu
18c40 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 m ){. rc = SQ
18c50 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 LITE_READONLY;.
18c60 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 2d }else{. pBt-
18c70 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 76 >autoVacuum = av
18c80 20 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d 3e ?1:0;. pBt->
18c90 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 76 3d incrVacuum = av=
18ca0 3d 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 73 =2 ?1:0;. }. s
18cb0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
18cc0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
18cd0 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
18ce0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c * Return the val
18cf0 75 65 20 6f 66 20 74 68 65 20 27 61 75 74 6f 2d ue of the 'auto-
18d00 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 79 vacuum' property
18d10 2e 20 49 66 20 61 75 74 6f 2d 76 61 63 75 75 6d . If auto-vacuum
18d20 20 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 20 is .** enabled
18d30 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 1 is returned. O
18d40 74 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a 69 therwise 0..*/.i
18d50 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 nt sqlite3BtreeG
18d60 65 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 etAutoVacuum(Btr
18d70 65 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 ee *p){.#ifdef S
18d80 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
18d90 41 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 42 ACUUM. return B
18da0 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f TREE_AUTOVACUUM_
18db0 4e 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 6e NONE;.#else. in
18dc0 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 t rc;. sqlite3B
18dd0 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
18de0 72 63 20 3d 20 28 0a 20 20 20 20 28 21 70 2d 3e rc = (. (!p->
18df0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 pBt->autoVacuum)
18e00 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 ?BTREE_AUTOVACUU
18e10 4d 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 2d M_NONE:. (!p-
18e20 3e 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d >pBt->incrVacuum
18e30 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 )?BTREE_AUTOVACU
18e40 55 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 52 UM_FULL:. BTR
18e50 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 4e EE_AUTOVACUUM_IN
18e60 43 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 65 CR. );. sqlite
18e70 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
18e80 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e return rc;.#en
18e90 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 dif.}../*.** If
18ea0 74 68 65 20 75 73 65 72 20 68 61 73 20 6e 6f 74 the user has not
18eb0 20 73 65 74 20 74 68 65 20 73 61 66 65 74 79 2d set the safety-
18ec0 6c 65 76 65 6c 20 66 6f 72 20 74 68 69 73 20 64 level for this d
18ed0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
18ee0 6f 6e 0a 2a 2a 20 75 73 69 6e 67 20 22 50 52 41 on.** using "PRA
18ef0 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 22 GMA synchronous"
18f00 2c 20 61 6e 64 20 69 66 20 74 68 65 20 73 61 66 , and if the saf
18f10 65 74 79 2d 6c 65 76 65 6c 20 69 73 20 6e 6f 74 ety-level is not
18f20 20 61 6c 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 already.** set
18f30 74 6f 20 74 68 65 20 76 61 6c 75 65 20 70 61 73 to the value pas
18f40 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 sed to this func
18f50 74 69 6f 6e 20 61 73 20 74 68 65 20 73 65 63 6f tion as the seco
18f60 6e 64 20 70 61 72 61 6d 65 74 65 72 2c 0a 2a 2a nd parameter,.**
18f70 20 73 65 74 20 69 74 20 73 6f 2e 0a 2a 2f 0a 23 set it so..*/.#
18f80 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c if SQLITE_DEFAUL
18f90 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 21 3d 53 T_SYNCHRONOUS!=S
18fa0 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 QLITE_DEFAULT_WA
18fb0 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 5c 0a L_SYNCHRONOUS \.
18fc0 20 20 20 20 26 26 20 21 64 65 66 69 6e 65 64 28 && !defined(
18fd0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 SQLITE_OMIT_WAL)
18fe0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 65 74 .static void set
18ff0 44 65 66 61 75 6c 74 53 79 6e 63 46 6c 61 67 28 DefaultSyncFlag(
19000 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 75 BtShared *pBt, u
19010 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 29 7b 8 safety_level){
19020 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a . sqlite3 *db;.
19030 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 69 66 28 Db *pDb;. if(
19040 20 28 64 62 3d 70 42 74 2d 3e 64 62 29 21 3d 30 (db=pBt->db)!=0
19050 20 26 26 20 28 70 44 62 3d 64 62 2d 3e 61 44 62 && (pDb=db->aDb
19060 29 21 3d 30 20 29 7b 0a 20 20 20 20 77 68 69 6c )!=0 ){. whil
19070 65 28 20 70 44 62 2d 3e 70 42 74 3d 3d 30 20 7c e( pDb->pBt==0 |
19080 7c 20 70 44 62 2d 3e 70 42 74 2d 3e 70 42 74 21 | pDb->pBt->pBt!
19090 3d 70 42 74 20 29 7b 20 70 44 62 2b 2b 3b 20 7d =pBt ){ pDb++; }
190a0 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e 62 53 . if( pDb->bS
190b0 79 6e 63 53 65 74 3d 3d 30 20 0a 20 20 20 20 20 yncSet==0 .
190c0 26 26 20 70 44 62 2d 3e 73 61 66 65 74 79 5f 6c && pDb->safety_l
190d0 65 76 65 6c 21 3d 73 61 66 65 74 79 5f 6c 65 76 evel!=safety_lev
190e0 65 6c 20 0a 20 20 20 20 20 26 26 20 70 44 62 21 el . && pDb!
190f0 3d 26 64 62 2d 3e 61 44 62 5b 31 5d 20 0a 20 20 =&db->aDb[1] .
19100 20 20 29 7b 0a 20 20 20 20 20 20 70 44 62 2d 3e ){. pDb->
19110 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 73 safety_level = s
19120 61 66 65 74 79 5f 6c 65 76 65 6c 3b 0a 20 20 20 afety_level;.
19130 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
19140 65 74 46 6c 61 67 73 28 70 42 74 2d 3e 70 50 61 etFlags(pBt->pPa
19150 67 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20 70 ger,. p
19160 44 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c Db->safety_level
19170 20 7c 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 | (db->flags &
19180 50 41 47 45 52 5f 46 4c 41 47 53 5f 4d 41 53 4b PAGER_FLAGS_MASK
19190 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a ));. }. }.}.
191a0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
191b0 65 74 44 65 66 61 75 6c 74 53 79 6e 63 46 6c 61 etDefaultSyncFla
191c0 67 28 70 42 74 2c 73 61 66 65 74 79 5f 6c 65 76 g(pBt,safety_lev
191d0 65 6c 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 46 el).#endif../* F
191e0 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 orward declarati
191f0 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 on */.static int
19200 20 6e 65 77 44 61 74 61 62 61 73 65 28 42 74 53 newDatabase(BtS
19210 68 61 72 65 64 2a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a hared*);.../*.**
19220 20 47 65 74 20 61 20 72 65 66 65 72 65 6e 63 65 Get a reference
19230 20 74 6f 20 70 50 61 67 65 31 20 6f 66 20 74 68 to pPage1 of th
19240 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
19250 20 20 54 68 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 This will.** a
19260 6c 73 6f 20 61 63 71 75 69 72 65 20 61 20 72 65 lso acquire a re
19270 61 64 6c 6f 63 6b 20 6f 6e 20 74 68 61 74 20 66 adlock on that f
19280 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 ile..**.** SQLIT
19290 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
192a0 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 on success. If
192b0 20 74 68 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 the file is not
192c0 20 61 0a 2a 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 a.** well-forme
192d0 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c d database file,
192e0 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 43 4f 52 then SQLITE_COR
192f0 52 55 50 54 20 69 73 20 72 65 74 75 72 6e 65 64 RUPT is returned
19300 2e 0a 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 ..** SQLITE_BUSY
19310 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
19320 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
19330 6c 6f 63 6b 65 64 2e 20 20 53 51 4c 49 54 45 5f locked. SQLITE_
19340 4e 4f 4d 45 4d 0a 2a 2a 20 69 73 20 72 65 74 75 NOMEM.** is retu
19350 72 6e 65 64 20 69 66 20 77 65 20 72 75 6e 20 6f rned if we run o
19360 75 74 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a ut of memory. .*
19370 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 6f 63 /.static int loc
19380 6b 42 74 72 65 65 28 42 74 53 68 61 72 65 64 20 kBtree(BtShared
19390 2a 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b *pBt){. int rc;
193a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
193b0 20 52 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f Result code fro
193c0 6d 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a m subfunctions *
193d0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 /. MemPage *pPa
193e0 67 65 31 3b 20 20 20 20 20 2f 2a 20 50 61 67 65 ge1; /* Page
193f0 20 31 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 1 of the databa
19400 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 33 32 se file */. u32
19410 20 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 nPage;
19420 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
19430 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 ages in the data
19440 62 61 73 65 20 2a 2f 0a 20 20 75 33 32 20 6e 50 base */. u32 nP
19450 61 67 65 46 69 6c 65 20 3d 20 30 3b 20 20 20 2f ageFile = 0; /
19460 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
19470 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 s in the databas
19480 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 33 32 20 e file */. u32
19490 6e 50 61 67 65 48 65 61 64 65 72 3b 20 20 20 20 nPageHeader;
194a0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
194b0 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 ges in the datab
194c0 61 73 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f ase according to
194d0 20 68 64 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 hdr */.. asser
194e0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
194f0 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
19500 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
19510 42 74 2d 3e 70 50 61 67 65 31 3d 3d 30 20 29 3b Bt->pPage1==0 );
19520 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
19530 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 70 agerSharedLock(p
19540 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 69 Bt->pPager);. i
19550 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
19560 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
19570 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
19580 65 28 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 e(pBt, 1, &pPage
19590 31 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 1, 0);. if( rc!
195a0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 =SQLITE_OK ) ret
195b0 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f urn rc;.. /* Do
195c0 20 73 6f 6d 65 20 63 68 65 63 6b 69 6e 67 20 74 some checking t
195d0 6f 20 68 65 6c 70 20 69 6e 73 75 72 65 20 74 68 o help insure th
195e0 65 20 66 69 6c 65 20 77 65 20 6f 70 65 6e 65 64 e file we opened
195f0 20 72 65 61 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 really is. **
19600 61 20 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 a valid database
19610 20 66 69 6c 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e file. . */. n
19620 50 61 67 65 20 3d 20 6e 50 61 67 65 48 65 61 64 Page = nPageHead
19630 65 72 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 er = get4byte(28
19640 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 +(u8*)pPage1->aD
19650 61 74 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 ata);. sqlite3P
19660 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 agerPagecount(pB
19670 74 2d 3e 70 50 61 67 65 72 2c 20 28 69 6e 74 2a t->pPager, (int*
19680 29 26 6e 50 61 67 65 46 69 6c 65 29 3b 0a 20 20 )&nPageFile);.
19690 69 66 28 20 6e 50 61 67 65 3d 3d 30 20 7c 7c 20 if( nPage==0 ||
196a0 6d 65 6d 63 6d 70 28 32 34 2b 28 75 38 2a 29 70 memcmp(24+(u8*)p
196b0 50 61 67 65 31 2d 3e 61 44 61 74 61 2c 20 39 32 Page1->aData, 92
196c0 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 +(u8*)pPage1->aD
196d0 61 74 61 2c 34 29 21 3d 30 20 29 7b 0a 20 20 20 ata,4)!=0 ){.
196e0 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 46 69 nPage = nPageFi
196f0 6c 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 28 70 le;. }. if( (p
19700 42 74 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 Bt->db->flags &
19710 53 51 4c 49 54 45 5f 52 65 73 65 74 44 61 74 61 SQLITE_ResetData
19720 62 61 73 65 29 21 3d 30 20 29 7b 0a 20 20 20 20 base)!=0 ){.
19730 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 nPage = 0;. }.
19740 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b 0a if( nPage>0 ){.
19750 20 20 20 20 75 33 32 20 70 61 67 65 53 69 7a 65 u32 pageSize
19760 3b 0a 20 20 20 20 75 33 32 20 75 73 61 62 6c 65 ;. u32 usable
19770 53 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 61 Size;. u8 *pa
19780 67 65 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 44 ge1 = pPage1->aD
19790 61 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 ata;. rc = SQ
197a0 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 20 LITE_NOTADB;.
197b0 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
197c0 20 52 2d 34 33 37 33 37 2d 33 39 39 39 39 20 45 R-43737-39999 E
197d0 76 65 72 79 20 76 61 6c 69 64 20 53 51 4c 69 74 very valid SQLit
197e0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
197f0 62 65 67 69 6e 73 0a 20 20 20 20 2a 2a 20 77 69 begins. ** wi
19800 74 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 th the following
19810 20 31 36 20 62 79 74 65 73 20 28 69 6e 20 68 65 16 bytes (in he
19820 78 29 3a 20 35 33 20 35 31 20 34 63 20 36 39 20 x): 53 51 4c 69
19830 37 34 20 36 35 20 32 30 20 36 36 20 36 66 20 37 74 65 20 66 6f 7
19840 32 20 36 64 0a 20 20 20 20 2a 2a 20 36 31 20 37 2 6d. ** 61 7
19850 34 20 32 30 20 33 33 20 30 30 2e 20 2a 2f 0a 20 4 20 33 00. */.
19860 20 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 70 61 if( memcmp(pa
19870 67 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 ge1, zMagicHeade
19880 72 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 20 20 r, 16)!=0 ){.
19890 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e goto page1_in
198a0 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d it_failed;. }
198b0 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
198c0 4f 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 66 28 OMIT_WAL. if(
198d0 20 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 7b 0a page1[18]>1 ){.
198e0 20 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c pBt->btsFl
198f0 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f ags |= BTS_READ_
19900 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ONLY;. }.
19910 69 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 31 20 if( page1[19]>1
19920 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 ){. goto pa
19930 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
19940 0a 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 . }.#else.
19950 20 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 32 if( page1[18]>2
19960 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 ){. pBt->b
19970 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 tsFlags |= BTS_R
19980 45 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a EAD_ONLY;. }.
19990 20 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 if( page1[19
199a0 5d 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 ]>2 ){. got
199b0 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 o page1_init_fai
199c0 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 led;. }..
199d0 2f 2a 20 49 66 20 74 68 65 20 77 72 69 74 65 20 /* If the write
199e0 76 65 72 73 69 6f 6e 20 69 73 20 73 65 74 20 74 version is set t
199f0 6f 20 32 2c 20 74 68 69 73 20 64 61 74 61 62 61 o 2, this databa
19a00 73 65 20 73 68 6f 75 6c 64 20 62 65 20 61 63 63 se should be acc
19a10 65 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 6e 20 essed. ** in
19a20 57 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 WAL mode. If the
19a30 20 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c 72 65 log is not alre
19a40 61 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 ady open, open i
19a50 74 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 20 20 t now. Then .
19a60 20 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ** return SQLIT
19a70 45 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 6e 20 E_OK and return
19a80 77 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 74 69 without populati
19a90 6e 67 20 42 74 53 68 61 72 65 64 2e 70 50 61 67 ng BtShared.pPag
19aa0 65 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 63 e1.. ** The c
19ab0 61 6c 6c 65 72 20 64 65 74 65 63 74 73 20 74 68 aller detects th
19ac0 69 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 68 69 is and calls thi
19ad0 73 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e s function again
19ae0 2e 20 54 68 69 73 20 69 73 0a 20 20 20 20 2a 2a . This is. **
19af0 20 72 65 71 75 69 72 65 64 20 61 73 20 74 68 65 required as the
19b00 20 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 65 version of page
19b10 20 31 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 1 currently in
19b20 74 68 65 20 70 61 67 65 31 20 62 75 66 66 65 72 the page1 buffer
19b30 0a 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 . ** may not
19b40 62 65 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 be the latest ve
19b50 72 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 6d 61 rsion - there ma
19b60 79 20 62 65 20 61 20 6e 65 77 65 72 20 6f 6e 65 y be a newer one
19b70 20 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 20 20 in the log.
19b80 2a 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a ** file.. */.
19b90 20 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 if( page1[19
19ba0 5d 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 62 74 ]==2 && (pBt->bt
19bb0 73 46 6c 61 67 73 20 26 20 42 54 53 5f 4e 4f 5f sFlags & BTS_NO_
19bc0 57 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 WAL)==0 ){.
19bd0 20 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 30 3b int isOpen = 0;
19be0 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
19bf0 74 65 33 50 61 67 65 72 4f 70 65 6e 57 61 6c 28 te3PagerOpenWal(
19c00 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 69 73 pBt->pPager, &is
19c10 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 Open);. if(
19c20 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
19c30 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 {. goto p
19c40 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 age1_init_failed
19c50 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
19c60 20 20 20 20 20 20 20 73 65 74 44 65 66 61 75 6c setDefaul
19c70 74 53 79 6e 63 46 6c 61 67 28 70 42 74 2c 20 53 tSyncFlag(pBt, S
19c80 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 QLITE_DEFAULT_WA
19c90 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 2b 31 29 L_SYNCHRONOUS+1)
19ca0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 73 ;. if( is
19cb0 4f 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Open==0 ){.
19cc0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
19cd0 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a 20 20 20 One(pPage1);.
19ce0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
19cf0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
19d00 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
19d10 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 54 rc = SQLITE_NOT
19d20 41 44 42 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a ADB;. }else{.
19d30 20 20 20 20 20 20 73 65 74 44 65 66 61 75 6c 74 setDefault
19d40 53 79 6e 63 46 6c 61 67 28 70 42 74 2c 20 53 51 SyncFlag(pBt, SQ
19d50 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e LITE_DEFAULT_SYN
19d60 43 48 52 4f 4e 4f 55 53 2b 31 29 3b 0a 20 20 20 CHRONOUS+1);.
19d70 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f }.#endif.. /
19d80 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
19d90 2d 31 35 34 36 35 2d 32 30 38 31 33 20 54 68 65 -15465-20813 The
19da0 20 6d 61 78 69 6d 75 6d 20 61 6e 64 20 6d 69 6e maximum and min
19db0 69 6d 75 6d 20 65 6d 62 65 64 64 65 64 20 70 61 imum embedded pa
19dc0 79 6c 6f 61 64 0a 20 20 20 20 2a 2a 20 66 72 61 yload. ** fra
19dd0 63 74 69 6f 6e 73 20 61 6e 64 20 74 68 65 20 6c ctions and the l
19de0 65 61 66 20 70 61 79 6c 6f 61 64 20 66 72 61 63 eaf payload frac
19df0 74 69 6f 6e 20 76 61 6c 75 65 73 20 6d 75 73 74 tion values must
19e00 20 62 65 20 36 34 2c 20 33 32 2c 20 61 6e 64 20 be 64, 32, and
19e10 33 32 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 32.. **. *
19e20 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 * The original d
19e30 65 73 69 67 6e 20 61 6c 6c 6f 77 65 64 20 74 68 esign allowed th
19e40 65 73 65 20 61 6d 6f 75 6e 74 73 20 74 6f 20 76 ese amounts to v
19e50 61 72 79 2c 20 62 75 74 20 61 73 20 6f 66 0a 20 ary, but as of.
19e60 20 20 20 2a 2a 20 76 65 72 73 69 6f 6e 20 33 2e ** version 3.
19e70 36 2e 30 2c 20 77 65 20 72 65 71 75 69 72 65 20 6.0, we require
19e80 74 68 65 6d 20 74 6f 20 62 65 20 66 69 78 65 64 them to be fixed
19e90 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
19ea0 20 6d 65 6d 63 6d 70 28 26 70 61 67 65 31 5b 32 memcmp(&page1[2
19eb0 31 5d 2c 20 22 5c 31 30 30 5c 30 34 30 5c 30 34 1], "\100\040\04
19ec0 30 22 2c 33 29 21 3d 30 20 29 7b 0a 20 20 20 20 0",3)!=0 ){.
19ed0 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
19ee0 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
19ef0 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
19f00 4f 46 3a 20 52 2d 35 31 38 37 33 2d 33 39 36 31 OF: R-51873-3961
19f10 38 20 54 68 65 20 70 61 67 65 20 73 69 7a 65 20 8 The page size
19f20 66 6f 72 20 61 20 64 61 74 61 62 61 73 65 20 66 for a database f
19f30 69 6c 65 20 69 73 0a 20 20 20 20 2a 2a 20 64 65 ile is. ** de
19f40 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 termined by the
19f50 32 2d 62 79 74 65 20 69 6e 74 65 67 65 72 20 6c 2-byte integer l
19f60 6f 63 61 74 65 64 20 61 74 20 61 6e 20 6f 66 66 ocated at an off
19f70 73 65 74 20 6f 66 20 31 36 20 62 79 74 65 73 20 set of 16 bytes
19f80 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 74 68 65 20 from. ** the
19f90 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 beginning of the
19fa0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
19fb0 2a 2f 0a 20 20 20 20 70 61 67 65 53 69 7a 65 20 */. pageSize
19fc0 3d 20 28 70 61 67 65 31 5b 31 36 5d 3c 3c 38 29 = (page1[16]<<8)
19fd0 20 7c 20 28 70 61 67 65 31 5b 31 37 5d 3c 3c 31 | (page1[17]<<1
19fe0 36 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 6);. /* EVIDE
19ff0 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 30 30 38 2d NCE-OF: R-25008-
1a000 32 31 36 38 38 20 54 68 65 20 73 69 7a 65 20 6f 21688 The size o
1a010 66 20 61 20 70 61 67 65 20 69 73 20 61 20 70 6f f a page is a po
1a020 77 65 72 20 6f 66 20 74 77 6f 0a 20 20 20 20 2a wer of two. *
1a030 2a 20 62 65 74 77 65 65 6e 20 35 31 32 20 61 6e * between 512 an
1a040 64 20 36 35 35 33 36 20 69 6e 63 6c 75 73 69 76 d 65536 inclusiv
1a050 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 28 e. */. if( ((
1a060 70 61 67 65 53 69 7a 65 2d 31 29 26 70 61 67 65 pageSize-1)&page
1a070 53 69 7a 65 29 21 3d 30 0a 20 20 20 20 20 7c 7c Size)!=0. ||
1a080 20 70 61 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 pageSize>SQLITE
1a090 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 20 0a _MAX_PAGE_SIZE .
1a0a0 20 20 20 20 20 7c 7c 20 70 61 67 65 53 69 7a 65 || pageSize
1a0b0 3c 3d 32 35 36 20 0a 20 20 20 20 29 7b 0a 20 20 <=256 . ){.
1a0c0 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 goto page1_i
1a0d0 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 nit_failed;.
1a0e0 7d 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c }. pBt->btsFl
1a0f0 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 ags |= BTS_PAGES
1a100 49 5a 45 5f 46 49 58 45 44 3b 0a 20 20 20 20 61 IZE_FIXED;. a
1a110 73 73 65 72 74 28 20 28 70 61 67 65 53 69 7a 65 ssert( (pageSize
1a120 20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 20 & 7)==0 );.
1a130 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
1a140 52 2d 35 39 33 31 30 2d 35 31 32 30 35 20 54 68 R-59310-51205 Th
1a150 65 20 22 72 65 73 65 72 76 65 64 20 73 70 61 63 e "reserved spac
1a160 65 22 20 73 69 7a 65 20 69 6e 20 74 68 65 20 31 e" size in the 1
1a170 2d 62 79 74 65 0a 20 20 20 20 2a 2a 20 69 6e 74 -byte. ** int
1a180 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 32 eger at offset 2
1a190 30 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 0 is the number
1a1a0 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 of bytes of spac
1a1b0 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 0a e at the end of.
1a1c0 20 20 20 20 2a 2a 20 65 61 63 68 20 70 61 67 65 ** each page
1a1d0 20 74 6f 20 72 65 73 65 72 76 65 20 66 6f 72 20 to reserve for
1a1e0 65 78 74 65 6e 73 69 6f 6e 73 2e 20 0a 20 20 20 extensions. .
1a1f0 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 56 49 44 45 **. ** EVIDE
1a200 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 2d NCE-OF: R-37497-
1a210 34 32 34 31 32 20 54 68 65 20 73 69 7a 65 20 6f 42412 The size o
1a220 66 20 74 68 65 20 72 65 73 65 72 76 65 64 20 72 f the reserved r
1a230 65 67 69 6f 6e 20 69 73 0a 20 20 20 20 2a 2a 20 egion is. **
1a240 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
1a250 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e 73 69 67 e one-byte unsig
1a260 6e 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 6e ned integer foun
1a270 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f d at an offset o
1a280 66 20 32 30 0a 20 20 20 20 2a 2a 20 69 6e 74 6f f 20. ** into
1a290 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1a2a0 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 20 le header. */.
1a2b0 20 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 usableSize = p
1a2c0 61 67 65 53 69 7a 65 20 2d 20 70 61 67 65 31 5b ageSize - page1[
1a2d0 32 30 5d 3b 0a 20 20 20 20 69 66 28 20 28 75 33 20];. if( (u3
1a2e0 32 29 70 61 67 65 53 69 7a 65 21 3d 70 42 74 2d 2)pageSize!=pBt-
1a2f0 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a 20 20 20 >pageSize ){.
1a300 20 20 20 2f 2a 20 41 66 74 65 72 20 72 65 61 64 /* After read
1a310 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 61 ing the first pa
1a320 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ge of the databa
1a330 73 65 20 61 73 73 75 6d 69 6e 67 20 61 20 70 61 se assuming a pa
1a340 67 65 20 73 69 7a 65 0a 20 20 20 20 20 20 2a 2a ge size. **
1a350 20 6f 66 20 42 74 53 68 61 72 65 64 2e 70 61 67 of BtShared.pag
1a360 65 53 69 7a 65 2c 20 77 65 20 68 61 76 65 20 64 eSize, we have d
1a370 69 73 63 6f 76 65 72 65 64 20 74 68 61 74 20 74 iscovered that t
1a380 68 65 20 70 61 67 65 2d 73 69 7a 65 20 69 73 0a he page-size is.
1a390 20 20 20 20 20 20 2a 2a 20 61 63 74 75 61 6c 6c ** actuall
1a3a0 79 20 70 61 67 65 53 69 7a 65 2e 20 55 6e 6c 6f y pageSize. Unlo
1a3b0 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 2c ck the database,
1a3c0 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 50 61 67 leave pBt->pPag
1a3d0 65 31 20 61 74 0a 20 20 20 20 20 20 2a 2a 20 7a e1 at. ** z
1a3e0 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20 53 ero and return S
1a3f0 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 65 20 63 61 QLITE_OK. The ca
1a400 6c 6c 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 74 ller will call t
1a410 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 his function.
1a420 20 20 20 2a 2a 20 61 67 61 69 6e 20 77 69 74 68 ** again with
1a430 20 74 68 65 20 63 6f 72 72 65 63 74 20 70 61 67 the correct pag
1a440 65 2d 73 69 7a 65 2e 0a 20 20 20 20 20 20 2a 2f e-size.. */
1a450 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 . releasePa
1a460 67 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a 20 geOne(pPage1);.
1a470 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 pBt->usable
1a480 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 7a Size = usableSiz
1a490 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 61 e;. pBt->pa
1a4a0 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a geSize = pageSiz
1a4b0 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 6d e;. freeTem
1a4c0 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 pSpace(pBt);.
1a4d0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
1a4e0 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 agerSetPagesize(
1a4f0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 pBt->pPager, &pB
1a500 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 20 t->pageSize,.
1a510 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a530 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 53 pageSize-usableS
1a540 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 ize);. retu
1a550 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
1a560 20 69 66 28 20 73 71 6c 69 74 65 33 57 72 69 74 if( sqlite3Writ
1a570 61 62 6c 65 53 63 68 65 6d 61 28 70 42 74 2d 3e ableSchema(pBt->
1a580 64 62 29 3d 3d 30 20 26 26 20 6e 50 61 67 65 3e db)==0 && nPage>
1a590 6e 50 61 67 65 46 69 6c 65 20 29 7b 0a 20 20 20 nPageFile ){.
1a5a0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
1a5b0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
1a5c0 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e goto page1_in
1a5d0 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d it_failed;. }
1a5e0 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
1a5f0 2d 4f 46 3a 20 52 2d 32 38 33 31 32 2d 36 34 37 -OF: R-28312-647
1a600 30 34 20 48 6f 77 65 76 65 72 2c 20 74 68 65 20 04 However, the
1a610 75 73 61 62 6c 65 20 73 69 7a 65 20 69 73 20 6e usable size is n
1a620 6f 74 20 61 6c 6c 6f 77 65 64 20 74 6f 0a 20 20 ot allowed to.
1a630 20 20 2a 2a 20 62 65 20 6c 65 73 73 20 74 68 61 ** be less tha
1a640 6e 20 34 38 30 2e 20 49 6e 20 6f 74 68 65 72 20 n 480. In other
1a650 77 6f 72 64 73 2c 20 69 66 20 74 68 65 20 70 61 words, if the pa
1a660 67 65 20 73 69 7a 65 20 69 73 20 35 31 32 2c 20 ge size is 512,
1a670 74 68 65 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 then the. **
1a680 72 65 73 65 72 76 65 64 20 73 70 61 63 65 20 73 reserved space s
1a690 69 7a 65 20 63 61 6e 6e 6f 74 20 65 78 63 65 65 ize cannot excee
1a6a0 64 20 33 32 2e 20 2a 2f 0a 20 20 20 20 69 66 28 d 32. */. if(
1a6b0 20 75 73 61 62 6c 65 53 69 7a 65 3c 34 38 30 20 usableSize<480
1a6c0 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 ){. goto pa
1a6d0 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
1a6e0 0a 20 20 20 20 7d 0a 20 20 20 20 70 42 74 2d 3e . }. pBt->
1a6f0 70 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 pageSize = pageS
1a700 69 7a 65 3b 0a 20 20 20 20 70 42 74 2d 3e 75 73 ize;. pBt->us
1a710 61 62 6c 65 53 69 7a 65 20 3d 20 75 73 61 62 6c ableSize = usabl
1a720 65 53 69 7a 65 3b 0a 23 69 66 6e 64 65 66 20 53 eSize;.#ifndef S
1a730 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
1a740 41 43 55 55 4d 0a 20 20 20 20 70 42 74 2d 3e 61 ACUUM. pBt->a
1a750 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 65 74 utoVacuum = (get
1a760 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 20 4byte(&page1[36
1a770 2b 20 34 2a 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 + 4*4])?1:0);.
1a780 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 pBt->incrVacuu
1a790 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 70 m = (get4byte(&p
1a7a0 61 67 65 31 5b 33 36 20 2b 20 37 2a 34 5d 29 3f age1[36 + 7*4])?
1a7b0 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 1:0);.#endif. }
1a7c0 0a 0a 20 20 2f 2a 20 6d 61 78 4c 6f 63 61 6c 20 .. /* maxLocal
1a7d0 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 is the maximum a
1a7e0 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 mount of payload
1a7f0 20 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 6c 6c to store locall
1a800 79 20 66 6f 72 0a 20 20 2a 2a 20 61 20 63 65 6c y for. ** a cel
1a810 6c 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 69 74 l. Make sure it
1a820 20 69 73 20 73 6d 61 6c 6c 20 65 6e 6f 75 67 68 is small enough
1a830 20 73 6f 20 74 68 61 74 20 61 74 20 6c 65 61 73 so that at leas
1a840 74 20 6d 69 6e 46 61 6e 6f 75 74 0a 20 20 2a 2a t minFanout. **
1a850 20 63 65 6c 6c 73 20 63 61 6e 20 77 69 6c 6c 20 cells can will
1a860 66 69 74 20 6f 6e 20 6f 6e 65 20 70 61 67 65 2e fit on one page.
1a870 20 20 57 65 20 61 73 73 75 6d 65 20 61 20 31 30 We assume a 10
1a880 2d 62 79 74 65 20 70 61 67 65 20 68 65 61 64 65 -byte page heade
1a890 72 2e 0a 20 20 2a 2a 20 42 65 73 69 64 65 73 20 r.. ** Besides
1a8a0 74 68 65 20 70 61 79 6c 6f 61 64 2c 20 74 68 65 the payload, the
1a8b0 20 63 65 6c 6c 20 6d 75 73 74 20 73 74 6f 72 65 cell must store
1a8c0 3a 0a 20 20 2a 2a 20 20 20 20 20 32 2d 62 79 74 :. ** 2-byt
1a8d0 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
1a8e0 20 63 65 6c 6c 0a 20 20 2a 2a 20 20 20 20 20 34 cell. ** 4
1a8f0 2d 62 79 74 65 20 63 68 69 6c 64 20 70 6f 69 6e -byte child poin
1a900 74 65 72 0a 20 20 2a 2a 20 20 20 20 20 39 2d 62 ter. ** 9-b
1a910 79 74 65 20 6e 4b 65 79 20 76 61 6c 75 65 0a 20 yte nKey value.
1a920 20 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 6e ** 4-byte n
1a930 44 61 74 61 20 76 61 6c 75 65 0a 20 20 2a 2a 20 Data value. **
1a940 20 20 20 20 34 2d 62 79 74 65 20 6f 76 65 72 66 4-byte overf
1a950 6c 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 low page pointer
1a960 0a 20 20 2a 2a 20 53 6f 20 61 20 63 65 6c 6c 20 . ** So a cell
1a970 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 32 2d consists of a 2-
1a980 62 79 74 65 20 70 6f 69 6e 74 65 72 2c 20 61 20 byte pointer, a
1a990 68 65 61 64 65 72 20 77 68 69 63 68 20 69 73 20 header which is
1a9a0 61 73 20 6d 75 63 68 20 61 73 0a 20 20 2a 2a 20 as much as. **
1a9b0 31 37 20 62 79 74 65 73 20 6c 6f 6e 67 2c 20 30 17 bytes long, 0
1a9c0 20 74 6f 20 4e 20 62 79 74 65 73 20 6f 66 20 70 to N bytes of p
1a9d0 61 79 6c 6f 61 64 2c 20 61 6e 64 20 61 6e 20 6f ayload, and an o
1a9e0 70 74 69 6f 6e 61 6c 20 34 20 62 79 74 65 20 6f ptional 4 byte o
1a9f0 76 65 72 66 6c 6f 77 0a 20 20 2a 2a 20 70 61 67 verflow. ** pag
1aa00 65 20 70 6f 69 6e 74 65 72 2e 0a 20 20 2a 2f 0a e pointer.. */.
1aa10 20 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 20 pBt->maxLocal
1aa20 3d 20 28 75 31 36 29 28 28 70 42 74 2d 3e 75 73 = (u16)((pBt->us
1aa30 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a 36 34 2f ableSize-12)*64/
1aa40 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 70 42 74 255 - 23);. pBt
1aa50 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 ->minLocal = (u1
1aa60 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 6)((pBt->usableS
1aa70 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d ize-12)*32/255 -
1aa80 20 32 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 61 78 23);. pBt->max
1aa90 4c 65 61 66 20 3d 20 28 75 31 36 29 28 70 42 74 Leaf = (u16)(pBt
1aaa0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 33 ->usableSize - 3
1aab0 35 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 65 5);. pBt->minLe
1aac0 61 66 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d af = (u16)((pBt-
1aad0 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a >usableSize-12)*
1aae0 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 32/255 - 23);.
1aaf0 69 66 28 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 if( pBt->maxLoca
1ab00 6c 3e 31 32 37 20 29 7b 0a 20 20 20 20 70 42 74 l>127 ){. pBt
1ab10 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 ->max1bytePayloa
1ab20 64 20 3d 20 31 32 37 3b 0a 20 20 7d 65 6c 73 65 d = 127;. }else
1ab30 7b 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 {. pBt->max1b
1ab40 79 74 65 50 61 79 6c 6f 61 64 20 3d 20 28 75 38 ytePayload = (u8
1ab50 29 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a )pBt->maxLocal;.
1ab60 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 42 }. assert( pB
1ab70 74 2d 3e 6d 61 78 4c 65 61 66 20 2b 20 32 33 20 t->maxLeaf + 23
1ab80 3c 3d 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 <= MX_CELL_SIZE(
1ab90 70 42 74 29 20 29 3b 0a 20 20 70 42 74 2d 3e 70 pBt) );. pBt->p
1aba0 50 61 67 65 31 20 3d 20 70 50 61 67 65 31 3b 0a Page1 = pPage1;.
1abb0 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e pBt->nPage = n
1abc0 50 61 67 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 Page;. return S
1abd0 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 31 QLITE_OK;..page1
1abe0 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3a 0a 20 20 _init_failed:.
1abf0 72 65 6c 65 61 73 65 50 61 67 65 4f 6e 65 28 70 releasePageOne(p
1ac00 50 61 67 65 31 29 3b 0a 20 20 70 42 74 2d 3e 70 Page1);. pBt->p
1ac10 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 72 65 74 Page1 = 0;. ret
1ac20 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 urn rc;.}..#ifnd
1ac30 65 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 ef NDEBUG./*.**
1ac40 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 Return the numbe
1ac50 72 20 6f 66 20 63 75 72 73 6f 72 73 20 6f 70 65 r of cursors ope
1ac60 6e 20 6f 6e 20 70 42 74 2e 20 54 68 69 73 20 69 n on pBt. This i
1ac70 73 20 66 6f 72 20 75 73 65 0a 2a 2a 20 69 6e 20 s for use.** in
1ac80 61 73 73 65 72 74 28 29 20 65 78 70 72 65 73 73 assert() express
1ac90 69 6f 6e 73 2c 20 73 6f 20 69 74 20 69 73 20 6f ions, so it is o
1aca0 6e 6c 79 20 63 6f 6d 70 69 6c 65 64 20 69 66 20 nly compiled if
1acb0 4e 44 45 42 55 47 20 69 73 20 6e 6f 74 0a 2a 2a NDEBUG is not.**
1acc0 20 64 65 66 69 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 defined..**.**
1acd0 4f 6e 6c 79 20 77 72 69 74 65 20 63 75 72 73 6f Only write curso
1ace0 72 73 20 61 72 65 20 63 6f 75 6e 74 65 64 20 69 rs are counted i
1acf0 66 20 77 72 4f 6e 6c 79 20 69 73 20 74 72 75 65 f wrOnly is true
1ad00 2e 20 20 49 66 20 77 72 4f 6e 6c 79 20 69 73 0a . If wrOnly is.
1ad10 2a 2a 20 66 61 6c 73 65 20 74 68 65 6e 20 61 6c ** false then al
1ad20 6c 20 63 75 72 73 6f 72 73 20 61 72 65 20 63 6f l cursors are co
1ad30 75 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 unted..**.** For
1ad40 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 the purposes of
1ad50 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2c 20 61 this routine, a
1ad60 20 63 75 72 73 6f 72 20 69 73 20 61 6e 79 20 63 cursor is any c
1ad70 75 72 73 6f 72 20 74 68 61 74 0a 2a 2a 20 69 73 ursor that.** is
1ad80 20 63 61 70 61 62 6c 65 20 6f 66 20 72 65 61 64 capable of read
1ad90 69 6e 67 20 6f 72 20 77 72 69 74 69 6e 67 20 74 ing or writing t
1ada0 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 o the database.
1adb0 20 43 75 72 73 6f 72 73 20 74 68 61 74 0a 2a 2a Cursors that.**
1adc0 20 68 61 76 65 20 62 65 65 6e 20 74 72 69 70 70 have been tripp
1add0 65 64 20 69 6e 74 6f 20 74 68 65 20 43 55 52 53 ed into the CURS
1ade0 4f 52 5f 46 41 55 4c 54 20 73 74 61 74 65 20 61 OR_FAULT state a
1adf0 72 65 20 6e 6f 74 20 63 6f 75 6e 74 65 64 2e 0a re not counted..
1ae00 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 63 6f */.static int co
1ae10 75 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 73 28 untValidCursors(
1ae20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 69 BtShared *pBt, i
1ae30 6e 74 20 77 72 4f 6e 6c 79 29 7b 0a 20 20 42 74 nt wrOnly){. Bt
1ae40 43 75 72 73 6f 72 20 2a 70 43 75 72 3b 0a 20 20 Cursor *pCur;.
1ae50 69 6e 74 20 72 20 3d 20 30 3b 0a 20 20 66 6f 72 int r = 0;. for
1ae60 28 70 43 75 72 3d 70 42 74 2d 3e 70 43 75 72 73 (pCur=pBt->pCurs
1ae70 6f 72 3b 20 70 43 75 72 3b 20 70 43 75 72 3d 70 or; pCur; pCur=p
1ae80 43 75 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 Cur->pNext){.
1ae90 20 69 66 28 20 28 77 72 4f 6e 6c 79 3d 3d 30 20 if( (wrOnly==0
1aea0 7c 7c 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 || (pCur->curFla
1aeb0 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
1aec0 6c 61 67 29 21 3d 30 29 0a 20 20 20 20 20 26 26 lag)!=0). &&
1aed0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
1aee0 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 20 72 2b URSOR_FAULT ) r+
1aef0 2b 3b 20 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e +; . }. return
1af00 20 72 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a r;.}.#endif../*
1af10 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 .** If there are
1af20 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 no outstanding
1af30 63 75 72 73 6f 72 73 20 61 6e 64 20 77 65 20 61 cursors and we a
1af40 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 6d 69 re not in the mi
1af50 64 64 6c 65 0a 2a 2a 20 6f 66 20 61 20 74 72 61 ddle.** of a tra
1af60 6e 73 61 63 74 69 6f 6e 20 62 75 74 20 74 68 65 nsaction but the
1af70 72 65 20 69 73 20 61 20 72 65 61 64 20 6c 6f 63 re is a read loc
1af80 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
1af90 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 73 20 e, then.** this
1afa0 72 6f 75 74 69 6e 65 20 75 6e 72 65 66 73 20 74 routine unrefs t
1afb0 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 he first page of
1afc0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1afd0 6c 65 20 77 68 69 63 68 20 0a 2a 2a 20 68 61 73 le which .** has
1afe0 20 74 68 65 20 65 66 66 65 63 74 20 6f 66 20 72 the effect of r
1aff0 65 6c 65 61 73 69 6e 67 20 74 68 65 20 72 65 61 eleasing the rea
1b000 64 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 d lock..**.** If
1b010 20 74 68 65 72 65 20 69 73 20 61 20 74 72 61 6e there is a tran
1b020 73 61 63 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 saction in progr
1b030 65 73 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e ess, this routin
1b040 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f e is a no-op..*/
1b050 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 6c .static void unl
1b060 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1b070 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
1b080 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
1b090 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
1b0a0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
1b0b0 73 73 65 72 74 28 20 63 6f 75 6e 74 56 61 6c 69 ssert( countVali
1b0c0 64 43 75 72 73 6f 72 73 28 70 42 74 2c 30 29 3d dCursors(pBt,0)=
1b0d0 3d 30 20 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 61 =0 || pBt->inTra
1b0e0 6e 73 61 63 74 69 6f 6e 3e 54 52 41 4e 53 5f 4e nsaction>TRANS_N
1b0f0 4f 4e 45 20 29 3b 0a 20 20 69 66 28 20 70 42 74 ONE );. if( pBt
1b100 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d ->inTransaction=
1b110 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 20 70 =TRANS_NONE && p
1b120 42 74 2d 3e 70 50 61 67 65 31 21 3d 30 20 29 7b Bt->pPage1!=0 ){
1b130 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 . MemPage *pP
1b140 61 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 age1 = pBt->pPag
1b150 65 31 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 e1;. assert(
1b160 70 50 61 67 65 31 2d 3e 61 44 61 74 61 20 29 3b pPage1->aData );
1b170 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
1b180 69 74 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e ite3PagerRefcoun
1b190 74 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d t(pBt->pPager)==
1b1a0 31 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 50 1 );. pBt->pP
1b1b0 61 67 65 31 20 3d 20 30 3b 0a 20 20 20 20 72 65 age1 = 0;. re
1b1c0 6c 65 61 73 65 50 61 67 65 4f 6e 65 28 70 50 61 leasePageOne(pPa
1b1d0 67 65 31 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a ge1);. }.}../*.
1b1e0 2a 2a 20 49 66 20 70 42 74 20 70 6f 69 6e 74 73 ** If pBt points
1b1f0 20 74 6f 20 61 6e 20 65 6d 70 74 79 20 66 69 6c to an empty fil
1b200 65 20 74 68 65 6e 20 63 6f 6e 76 65 72 74 20 74 e then convert t
1b210 68 61 74 20 65 6d 70 74 79 20 66 69 6c 65 0a 2a hat empty file.*
1b220 2a 20 69 6e 74 6f 20 61 20 6e 65 77 20 65 6d 70 * into a new emp
1b230 74 79 20 64 61 74 61 62 61 73 65 20 62 79 20 69 ty database by i
1b240 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 nitializing the
1b250 66 69 72 73 74 20 70 61 67 65 20 6f 66 0a 2a 2a first page of.**
1b260 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a the database..*
1b270 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6e 65 77 /.static int new
1b280 44 61 74 61 62 61 73 65 28 42 74 53 68 61 72 65 Database(BtShare
1b290 64 20 2a 70 42 74 29 7b 0a 20 20 4d 65 6d 50 61 d *pBt){. MemPa
1b2a0 67 65 20 2a 70 50 31 3b 0a 20 20 75 6e 73 69 67 ge *pP1;. unsig
1b2b0 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 3b 0a ned char *data;.
1b2c0 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 int rc;.. ass
1b2d0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
1b2e0 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
1b2f0 65 78 29 20 29 3b 0a 20 20 69 66 28 20 70 42 74 ex) );. if( pBt
1b300 2d 3e 6e 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 ->nPage>0 ){.
1b310 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1b320 4b 3b 0a 20 20 7d 0a 20 20 70 50 31 20 3d 20 70 K;. }. pP1 = p
1b330 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 61 73 Bt->pPage1;. as
1b340 73 65 72 74 28 20 70 50 31 21 3d 30 20 29 3b 0a sert( pP1!=0 );.
1b350 20 20 64 61 74 61 20 3d 20 70 50 31 2d 3e 61 44 data = pP1->aD
1b360 61 74 61 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ata;. rc = sqli
1b370 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
1b380 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 69 1->pDbPage);. i
1b390 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
1b3a0 63 3b 0a 20 20 6d 65 6d 63 70 79 28 64 61 74 61 c;. memcpy(data
1b3b0 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 2c 20 , zMagicHeader,
1b3c0 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 61 sizeof(zMagicHea
1b3d0 64 65 72 29 29 3b 0a 20 20 61 73 73 65 72 74 28 der));. assert(
1b3e0 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 48 65 sizeof(zMagicHe
1b3f0 61 64 65 72 29 3d 3d 31 36 20 29 3b 0a 20 20 64 ader)==16 );. d
1b400 61 74 61 5b 31 36 5d 20 3d 20 28 75 38 29 28 28 ata[16] = (u8)((
1b410 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 38 pBt->pageSize>>8
1b420 29 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b )&0xff);. data[
1b430 31 37 5d 20 3d 20 28 75 38 29 28 28 70 42 74 2d 17] = (u8)((pBt-
1b440 3e 70 61 67 65 53 69 7a 65 3e 3e 31 36 29 26 30 >pageSize>>16)&0
1b450 78 66 66 29 3b 0a 20 20 64 61 74 61 5b 31 38 5d xff);. data[18]
1b460 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 31 39 5d = 1;. data[19]
1b470 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 28 20 = 1;. assert(
1b480 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3c pBt->usableSize<
1b490 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 26 =pBt->pageSize &
1b4a0 26 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a & pBt->usableSiz
1b4b0 65 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 61 67 65 e+255>=pBt->page
1b4c0 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 5b 32 30 Size);. data[20
1b4d0 5d 20 3d 20 28 75 38 29 28 70 42 74 2d 3e 70 61 ] = (u8)(pBt->pa
1b4e0 67 65 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 geSize - pBt->us
1b4f0 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 ableSize);. dat
1b500 61 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 20 64 61 a[21] = 64;. da
1b510 74 61 5b 32 32 5d 20 3d 20 33 32 3b 0a 20 20 64 ta[22] = 32;. d
1b520 61 74 61 5b 32 33 5d 20 3d 20 33 32 3b 0a 20 20 ata[23] = 32;.
1b530 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 32 34 5d memset(&data[24]
1b540 2c 20 30 2c 20 31 30 30 2d 32 34 29 3b 0a 20 20 , 0, 100-24);.
1b550 7a 65 72 6f 50 61 67 65 28 70 50 31 2c 20 50 54 zeroPage(pP1, PT
1b560 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 F_INTKEY|PTF_LEA
1b570 46 7c 50 54 46 5f 4c 45 41 46 44 41 54 41 20 29 F|PTF_LEAFDATA )
1b580 3b 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 ;. pBt->btsFlag
1b590 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 53 49 5a s |= BTS_PAGESIZ
1b5a0 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 E_FIXED;.#ifndef
1b5b0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
1b5c0 4f 56 41 43 55 55 4d 0a 20 20 61 73 73 65 72 74 OVACUUM. assert
1b5d0 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 ( pBt->autoVacuu
1b5e0 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e 61 75 74 m==1 || pBt->aut
1b5f0 6f 56 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 oVacuum==0 );.
1b600 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 63 assert( pBt->inc
1b610 72 56 61 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 rVacuum==1 || pB
1b620 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 3d 3d 30 t->incrVacuum==0
1b630 20 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 );. put4byte(&
1b640 64 61 74 61 5b 33 36 20 2b 20 34 2a 34 5d 2c 20 data[36 + 4*4],
1b650 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 pBt->autoVacuum)
1b660 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 64 61 ;. put4byte(&da
1b670 74 61 5b 33 36 20 2b 20 37 2a 34 5d 2c 20 70 42 ta[36 + 7*4], pB
1b680 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 29 3b 0a t->incrVacuum);.
1b690 23 65 6e 64 69 66 0a 20 20 70 42 74 2d 3e 6e 50 #endif. pBt->nP
1b6a0 61 67 65 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b age = 1;. data[
1b6b0 33 31 5d 20 3d 20 31 3b 0a 20 20 72 65 74 75 72 31] = 1;. retur
1b6c0 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1b6d0 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 /*.** Initialize
1b6e0 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 20 the first page
1b6f0 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
1b700 66 69 6c 65 20 28 63 72 65 61 74 69 6e 67 20 61 file (creating a
1b710 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
1b720 73 69 73 74 69 6e 67 20 6f 66 20 61 20 73 69 6e sisting of a sin
1b730 67 6c 65 20 70 61 67 65 20 61 6e 64 20 6e 6f 20 gle page and no
1b740 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 29 2e schema objects).
1b750 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
1b760 4b 0a 2a 2a 20 69 66 20 73 75 63 63 65 73 73 66 K.** if successf
1b770 75 6c 2c 20 6f 72 20 61 6e 20 53 51 4c 69 74 65 ul, or an SQLite
1b780 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 error code othe
1b790 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 rwise..*/.int sq
1b7a0 6c 69 74 65 33 42 74 72 65 65 4e 65 77 44 62 28 lite3BtreeNewDb(
1b7b0 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 Btree *p){. int
1b7c0 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 rc;. sqlite3Bt
1b7d0 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
1b7e0 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 30 ->pBt->nPage = 0
1b7f0 3b 0a 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 ;. rc = newData
1b800 62 61 73 65 28 70 2d 3e 70 42 74 29 3b 0a 20 20 base(p->pBt);.
1b810 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1b820 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
1b830 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 c;.}../*.** Atte
1b840 6d 70 74 20 74 6f 20 73 74 61 72 74 20 61 20 6e mpt to start a n
1b850 65 77 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ew transaction.
1b860 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 A write-transact
1b870 69 6f 6e 0a 2a 2a 20 69 73 20 73 74 61 72 74 65 ion.** is starte
1b880 64 20 69 66 20 74 68 65 20 73 65 63 6f 6e 64 20 d if the second
1b890 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 7a argument is nonz
1b8a0 65 72 6f 2c 20 6f 74 68 65 72 77 69 73 65 20 61 ero, otherwise a
1b8b0 20 72 65 61 64 2d 0a 2a 2a 20 74 72 61 6e 73 61 read-.** transa
1b8c0 63 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 73 ction. If the s
1b8d0 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 econd argument i
1b8e0 73 20 32 20 6f 72 20 6d 6f 72 65 20 61 6e 64 20 s 2 or more and
1b8f0 65 78 63 6c 75 73 69 76 65 0a 2a 2a 20 74 72 61 exclusive.** tra
1b900 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 72 nsaction is star
1b910 74 65 64 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 ted, meaning tha
1b920 74 20 6e 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 t no other proce
1b930 73 73 20 69 73 20 61 6c 6c 6f 77 65 64 0a 2a 2a ss is allowed.**
1b940 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 64 to access the d
1b950 61 74 61 62 61 73 65 2e 20 20 41 20 70 72 65 65 atabase. A pree
1b960 78 69 73 74 69 6e 67 20 74 72 61 6e 73 61 63 74 xisting transact
1b970 69 6f 6e 20 6d 61 79 20 6e 6f 74 20 62 65 0a 2a ion may not be.*
1b980 2a 20 75 70 67 72 61 64 65 64 20 74 6f 20 65 78 * upgraded to ex
1b990 63 6c 75 73 69 76 65 20 62 79 20 63 61 6c 6c 69 clusive by calli
1b9a0 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ng this routine
1b9b0 61 20 73 65 63 6f 6e 64 20 74 69 6d 65 20 2d 20 a second time -
1b9c0 74 68 65 0a 2a 2a 20 65 78 63 6c 75 73 69 76 69 the.** exclusivi
1b9d0 74 79 20 66 6c 61 67 20 6f 6e 6c 79 20 77 6f 72 ty flag only wor
1b9e0 6b 73 20 66 6f 72 20 61 20 6e 65 77 20 74 72 61 ks for a new tra
1b9f0 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 nsaction..**.**
1ba00 41 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 A write-transact
1ba10 69 6f 6e 20 6d 75 73 74 20 62 65 20 73 74 61 72 ion must be star
1ba20 74 65 64 20 62 65 66 6f 72 65 20 61 74 74 65 6d ted before attem
1ba30 70 74 69 6e 67 20 61 6e 79 20 0a 2a 2a 20 63 68 pting any .** ch
1ba40 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 74 anges to the dat
1ba50 61 62 61 73 65 2e 20 20 4e 6f 6e 65 20 6f 66 20 abase. None of
1ba60 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f the following ro
1ba70 75 74 69 6e 65 73 20 0a 2a 2a 20 77 69 6c 6c 20 utines .** will
1ba80 77 6f 72 6b 20 75 6e 6c 65 73 73 20 61 20 74 72 work unless a tr
1ba90 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 73 74 61 ansaction is sta
1baa0 72 74 65 64 20 66 69 72 73 74 3a 0a 2a 2a 0a 2a rted first:.**.*
1bab0 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 * sqlite3Bt
1bac0 72 65 65 43 72 65 61 74 65 54 61 62 6c 65 28 29 reeCreateTable()
1bad0 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
1bae0 42 74 72 65 65 43 72 65 61 74 65 49 6e 64 65 78 BtreeCreateIndex
1baf0 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 ().** sqlit
1bb00 65 33 42 74 72 65 65 43 6c 65 61 72 54 61 62 6c e3BtreeClearTabl
1bb10 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 e().** sqli
1bb20 74 65 33 42 74 72 65 65 44 72 6f 70 54 61 62 6c te3BtreeDropTabl
1bb30 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 e().** sqli
1bb40 74 65 33 42 74 72 65 65 49 6e 73 65 72 74 28 29 te3BtreeInsert()
1bb50 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
1bb60 42 74 72 65 65 44 65 6c 65 74 65 28 29 0a 2a 2a BtreeDelete().**
1bb70 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1bb80 65 65 55 70 64 61 74 65 4d 65 74 61 28 29 0a 2a eeUpdateMeta().*
1bb90 2a 0a 2a 2a 20 49 66 20 61 6e 20 69 6e 69 74 69 *.** If an initi
1bba0 61 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 61 63 al attempt to ac
1bbb0 71 75 69 72 65 20 74 68 65 20 6c 6f 63 6b 20 66 quire the lock f
1bbc0 61 69 6c 73 20 62 65 63 61 75 73 65 20 6f 66 20 ails because of
1bbd0 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 0a lock contention.
1bbe0 2a 2a 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 ** and the datab
1bbf0 61 73 65 20 77 61 73 20 70 72 65 76 69 6f 75 73 ase was previous
1bc00 6c 79 20 75 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 ly unlocked, the
1bc10 6e 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 n invoke the bus
1bc20 79 20 68 61 6e 64 6c 65 72 0a 2a 2a 20 69 66 20 y handler.** if
1bc30 74 68 65 72 65 20 69 73 20 6f 6e 65 2e 20 20 42 there is one. B
1bc40 75 74 20 69 66 20 74 68 65 72 65 20 77 61 73 20 ut if there was
1bc50 70 72 65 76 69 6f 75 73 6c 79 20 61 20 72 65 61 previously a rea
1bc60 64 2d 6c 6f 63 6b 2c 20 64 6f 20 6e 6f 74 0a 2a d-lock, do not.*
1bc70 2a 20 69 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 * invoke the bus
1bc80 79 20 68 61 6e 64 6c 65 72 20 2d 20 6a 75 73 74 y handler - just
1bc90 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 return SQLITE_B
1bca0 55 53 59 2e 20 20 53 51 4c 49 54 45 5f 42 55 53 USY. SQLITE_BUS
1bcb0 59 20 69 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 Y is .** returne
1bcc0 64 20 77 68 65 6e 20 74 68 65 72 65 20 69 73 20 d when there is
1bcd0 61 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d 6c already a read-l
1bce0 6f 63 6b 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ock in order to
1bcf0 61 76 6f 69 64 20 61 20 64 65 61 64 6c 6f 63 6b avoid a deadlock
1bd00 2e 0a 2a 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20 ..**.** Suppose
1bd10 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 70 72 there are two pr
1bd20 6f 63 65 73 73 65 73 20 41 20 61 6e 64 20 42 2e ocesses A and B.
1bd30 20 20 41 20 68 61 73 20 61 20 72 65 61 64 20 6c A has a read l
1bd40 6f 63 6b 20 61 6e 64 20 42 20 68 61 73 0a 2a 2a ock and B has.**
1bd50 20 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b a reserved lock
1bd60 2e 20 20 42 20 74 72 69 65 73 20 74 6f 20 70 72 . B tries to pr
1bd70 6f 6d 6f 74 65 20 74 6f 20 65 78 63 6c 75 73 69 omote to exclusi
1bd80 76 65 20 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 ve but is blocke
1bd90 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 6f 66 20 d because.** of
1bda0 41 27 73 20 72 65 61 64 20 6c 6f 63 6b 2e 20 20 A's read lock.
1bdb0 41 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f A tries to promo
1bdc0 74 65 20 74 6f 20 72 65 73 65 72 76 65 64 20 62 te to reserved b
1bdd0 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 79 ut is blocked by
1bde0 20 42 2e 0a 2a 2a 20 4f 6e 65 20 6f 72 20 74 68 B..** One or th
1bdf0 65 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 74 e other of the t
1be00 77 6f 20 70 72 6f 63 65 73 73 65 73 20 6d 75 73 wo processes mus
1be10 74 20 67 69 76 65 20 77 61 79 20 6f 72 20 74 68 t give way or th
1be20 65 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 6e 6f ere can be.** no
1be30 20 70 72 6f 67 72 65 73 73 2e 20 20 42 79 20 72 progress. By r
1be40 65 74 75 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f eturning SQLITE_
1be50 42 55 53 59 20 61 6e 64 20 6e 6f 74 20 69 6e 76 BUSY and not inv
1be60 6f 6b 69 6e 67 20 74 68 65 20 62 75 73 79 20 63 oking the busy c
1be70 61 6c 6c 62 61 63 6b 0a 2a 2a 20 77 68 65 6e 20 allback.** when
1be80 41 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 A already has a
1be90 72 65 61 64 20 6c 6f 63 6b 2c 20 77 65 20 65 6e read lock, we en
1bea0 63 6f 75 72 61 67 65 20 41 20 74 6f 20 67 69 76 courage A to giv
1beb0 65 20 75 70 20 61 6e 64 20 6c 65 74 20 42 0a 2a e up and let B.*
1bec0 2a 20 70 72 6f 63 65 65 64 2e 0a 2a 2f 0a 69 6e * proceed..*/.in
1bed0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 t sqlite3BtreeBe
1bee0 67 69 6e 54 72 61 6e 73 28 42 74 72 65 65 20 2a ginTrans(Btree *
1bef0 70 2c 20 69 6e 74 20 77 72 66 6c 61 67 2c 20 69 p, int wrflag, i
1bf00 6e 74 20 2a 70 53 63 68 65 6d 61 56 65 72 73 69 nt *pSchemaVersi
1bf10 6f 6e 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 on){. BtShared
1bf20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 *pBt = p->pBt;.
1bf30 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
1bf40 5f 4f 4b 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 _OK;.. sqlite3B
1bf50 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
1bf60 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 btreeIntegrity(p
1bf70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 );.. /* If the
1bf80 62 74 72 65 65 20 69 73 20 61 6c 72 65 61 64 79 btree is already
1bf90 20 69 6e 20 61 20 77 72 69 74 65 2d 74 72 61 6e in a write-tran
1bfa0 73 61 63 74 69 6f 6e 2c 20 6f 72 20 69 74 0a 20 saction, or it.
1bfb0 20 2a 2a 20 69 73 20 61 6c 72 65 61 64 79 20 69 ** is already i
1bfc0 6e 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 63 n a read-transac
1bfd0 74 69 6f 6e 20 61 6e 64 20 61 20 72 65 61 64 2d tion and a read-
1bfe0 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a transaction. **
1bff0 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 is requested, t
1c000 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a his is a no-op..
1c010 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e */. if( p->in
1c020 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 Trans==TRANS_WRI
1c030 54 45 20 7c 7c 20 28 70 2d 3e 69 6e 54 72 61 6e TE || (p->inTran
1c040 73 3d 3d 54 52 41 4e 53 5f 52 45 41 44 20 26 26 s==TRANS_READ &&
1c050 20 21 77 72 66 6c 61 67 29 20 29 7b 0a 20 20 20 !wrflag) ){.
1c060 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 goto trans_begu
1c070 6e 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 n;. }. assert(
1c080 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
1c090 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ion==TRANS_WRITE
1c0a0 20 7c 7c 20 49 66 4e 6f 74 4f 6d 69 74 41 56 28 || IfNotOmitAV(
1c0b0 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 pBt->bDoTruncate
1c0c0 29 3d 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 28 )==0 );.. if( (
1c0d0 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 p->db->flags & S
1c0e0 51 4c 49 54 45 5f 52 65 73 65 74 44 61 74 61 62 QLITE_ResetDatab
1c0f0 61 73 65 29 20 0a 20 20 20 26 26 20 73 71 6c 69 ase) . && sqli
1c100 74 65 33 50 61 67 65 72 49 73 72 65 61 64 6f 6e te3PagerIsreadon
1c110 6c 79 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d ly(pBt->pPager)=
1c120 3d 30 20 0a 20 20 29 7b 0a 20 20 20 20 70 42 74 =0 . ){. pBt
1c130 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 ->btsFlags &= ~B
1c140 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 20 20 TS_READ_ONLY;.
1c150 7d 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 74 72 }.. /* Write tr
1c160 61 6e 73 61 63 74 69 6f 6e 73 20 61 72 65 20 6e ansactions are n
1c170 6f 74 20 70 6f 73 73 69 62 6c 65 20 6f 6e 20 61 ot possible on a
1c180 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74 61 62 read-only datab
1c190 61 73 65 20 2a 2f 0a 20 20 69 66 28 20 28 70 42 ase */. if( (pB
1c1a0 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
1c1b0 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 S_READ_ONLY)!=0
1c1c0 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 && wrflag ){.
1c1d0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 rc = SQLITE_REA
1c1e0 44 4f 4e 4c 59 3b 0a 20 20 20 20 67 6f 74 6f 20 DONLY;. goto
1c1f0 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 7d trans_begun;. }
1c200 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
1c210 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
1c220 48 45 0a 20 20 7b 0a 20 20 20 20 73 71 6c 69 74 HE. {. sqlit
1c230 65 33 20 2a 70 42 6c 6f 63 6b 20 3d 20 30 3b 0a e3 *pBlock = 0;.
1c240 20 20 20 20 2f 2a 20 49 66 20 61 6e 6f 74 68 65 /* If anothe
1c250 72 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c r database handl
1c260 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 6f 70 e has already op
1c270 65 6e 65 64 20 61 20 77 72 69 74 65 20 74 72 61 ened a write tra
1c280 6e 73 61 63 74 69 6f 6e 20 0a 20 20 20 20 2a 2a nsaction . **
1c290 20 6f 6e 20 74 68 69 73 20 73 68 61 72 65 64 2d on this shared-
1c2a0 62 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 btree structure
1c2b0 61 6e 64 20 61 20 73 65 63 6f 6e 64 20 77 72 69 and a second wri
1c2c0 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 te transaction i
1c2d0 73 0a 20 20 20 20 2a 2a 20 72 65 71 75 65 73 74 s. ** request
1c2e0 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ed, return SQLIT
1c2f0 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 20 20 2a 2f E_LOCKED.. */
1c300 0a 20 20 20 20 69 66 28 20 28 77 72 66 6c 61 67 . if( (wrflag
1c310 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 && pBt->inTrans
1c320 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
1c330 49 54 45 29 0a 20 20 20 20 20 7c 7c 20 28 70 42 ITE). || (pB
1c340 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
1c350 53 5f 50 45 4e 44 49 4e 47 29 21 3d 30 0a 20 20 S_PENDING)!=0.
1c360 20 20 29 7b 0a 20 20 20 20 20 20 70 42 6c 6f 63 ){. pBloc
1c370 6b 20 3d 20 70 42 74 2d 3e 70 57 72 69 74 65 72 k = pBt->pWriter
1c380 2d 3e 64 62 3b 0a 20 20 20 20 7d 65 6c 73 65 20 ->db;. }else
1c390 69 66 28 20 77 72 66 6c 61 67 3e 31 20 29 7b 0a if( wrflag>1 ){.
1c3a0 20 20 20 20 20 20 42 74 4c 6f 63 6b 20 2a 70 49 BtLock *pI
1c3b0 74 65 72 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 ter;. for(p
1c3c0 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b Iter=pBt->pLock;
1c3d0 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 pIter; pIter=pI
1c3e0 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 ter->pNext){.
1c3f0 20 20 20 20 20 69 66 28 20 70 49 74 65 72 2d 3e if( pIter->
1c400 70 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 20 20 pBtree!=p ){.
1c410 20 20 20 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 pBlock =
1c420 70 49 74 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 pIter->pBtree->d
1c430 62 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 b;. bre
1c440 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ak;. }.
1c450 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 }. }.
1c460 69 66 28 20 70 42 6c 6f 63 6b 20 29 7b 0a 20 20 if( pBlock ){.
1c470 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 sqlite3Conne
1c480 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d 3e ctionBlocked(p->
1c490 64 62 2c 20 70 42 6c 6f 63 6b 29 3b 0a 20 20 20 db, pBlock);.
1c4a0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4c rc = SQLITE_L
1c4b0 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 OCKED_SHAREDCACH
1c4c0 45 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 74 72 E;. goto tr
1c4d0 61 6e 73 5f 62 65 67 75 6e 3b 0a 20 20 20 20 7d ans_begun;. }
1c4e0 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f . }.#endif.. /
1c4f0 2a 20 41 6e 79 20 72 65 61 64 2d 6f 6e 6c 79 20 * Any read-only
1c500 6f 72 20 72 65 61 64 2d 77 72 69 74 65 20 74 72 or read-write tr
1c510 61 6e 73 61 63 74 69 6f 6e 20 69 6d 70 6c 69 65 ansaction implie
1c520 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e s a read-lock on
1c530 20 0a 20 20 2a 2a 20 70 61 67 65 20 31 2e 20 53 . ** page 1. S
1c540 6f 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 o if some other
1c550 73 68 61 72 65 64 2d 63 61 63 68 65 20 63 6c 69 shared-cache cli
1c560 65 6e 74 20 61 6c 72 65 61 64 79 20 68 61 73 20 ent already has
1c570 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 0a 20 20 a write-lock .
1c580 2a 2a 20 6f 6e 20 70 61 67 65 20 31 2c 20 74 68 ** on page 1, th
1c590 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 e transaction ca
1c5a0 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 2e 20 nnot be opened.
1c5b0 2a 2f 0a 20 20 72 63 20 3d 20 71 75 65 72 79 53 */. rc = queryS
1c5c0 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
1c5d0 6f 63 6b 28 70 2c 20 4d 41 53 54 45 52 5f 52 4f ock(p, MASTER_RO
1c5e0 4f 54 2c 20 52 45 41 44 5f 4c 4f 43 4b 29 3b 0a OT, READ_LOCK);.
1c5f0 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 if( SQLITE_OK!
1c600 3d 72 63 20 29 20 67 6f 74 6f 20 74 72 61 6e 73 =rc ) goto trans
1c610 5f 62 65 67 75 6e 3b 0a 0a 20 20 70 42 74 2d 3e _begun;.. pBt->
1c620 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 btsFlags &= ~BTS
1c630 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d 50 54 59 _INITIALLY_EMPTY
1c640 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 ;. if( pBt->nPa
1c650 67 65 3d 3d 30 20 29 20 70 42 74 2d 3e 62 74 73 ge==0 ) pBt->bts
1c660 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 49 4e 49 Flags |= BTS_INI
1c670 54 49 41 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 TIALLY_EMPTY;.
1c680 64 6f 20 7b 0a 20 20 20 20 2f 2a 20 43 61 6c 6c do {. /* Call
1c690 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 75 6e 74 lockBtree() unt
1c6a0 69 6c 20 65 69 74 68 65 72 20 70 42 74 2d 3e 70 il either pBt->p
1c6b0 50 61 67 65 31 20 69 73 20 70 6f 70 75 6c 61 74 Page1 is populat
1c6c0 65 64 20 6f 72 0a 20 20 20 20 2a 2a 20 6c 6f 63 ed or. ** loc
1c6d0 6b 42 74 72 65 65 28 29 20 72 65 74 75 72 6e 73 kBtree() returns
1c6e0 20 73 6f 6d 65 74 68 69 6e 67 20 6f 74 68 65 72 something other
1c6f0 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e than SQLITE_OK.
1c700 20 6c 6f 63 6b 42 74 72 65 65 28 29 0a 20 20 20 lockBtree().
1c710 20 2a 2a 20 6d 61 79 20 72 65 74 75 72 6e 20 53 ** may return S
1c720 51 4c 49 54 45 5f 4f 4b 20 62 75 74 20 6c 65 61 QLITE_OK but lea
1c730 76 65 20 70 42 74 2d 3e 70 50 61 67 65 31 20 73 ve pBt->pPage1 s
1c740 65 74 20 74 6f 20 30 20 69 66 20 61 66 74 65 72 et to 0 if after
1c750 0a 20 20 20 20 2a 2a 20 72 65 61 64 69 6e 67 20 . ** reading
1c760 70 61 67 65 20 31 20 69 74 20 64 69 73 63 6f 76 page 1 it discov
1c770 65 72 73 20 74 68 61 74 20 74 68 65 20 70 61 67 ers that the pag
1c780 65 2d 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 e-size of the da
1c790 74 61 62 61 73 65 20 0a 20 20 20 20 2a 2a 20 66 tabase . ** f
1c7a0 69 6c 65 20 69 73 20 6e 6f 74 20 70 42 74 2d 3e ile is not pBt->
1c7b0 70 61 67 65 53 69 7a 65 2e 20 49 6e 20 74 68 69 pageSize. In thi
1c7c0 73 20 63 61 73 65 20 6c 6f 63 6b 42 74 72 65 65 s case lockBtree
1c7d0 28 29 20 77 69 6c 6c 20 75 70 64 61 74 65 0a 20 () will update.
1c7e0 20 20 20 2a 2a 20 70 42 74 2d 3e 70 61 67 65 53 ** pBt->pageS
1c7f0 69 7a 65 20 74 6f 20 74 68 65 20 70 61 67 65 2d ize to the page-
1c800 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 size of the file
1c810 20 6f 6e 20 64 69 73 6b 2e 0a 20 20 20 20 2a 2f on disk.. */
1c820 0a 20 20 20 20 77 68 69 6c 65 28 20 70 42 74 2d . while( pBt-
1c830 3e 70 50 61 67 65 31 3d 3d 30 20 26 26 20 53 51 >pPage1==0 && SQ
1c840 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d 20 6c LITE_OK==(rc = l
1c850 6f 63 6b 42 74 72 65 65 28 70 42 74 29 29 20 29 ockBtree(pBt)) )
1c860 3b 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 ;.. if( rc==S
1c870 51 4c 49 54 45 5f 4f 4b 20 26 26 20 77 72 66 6c QLITE_OK && wrfl
1c880 61 67 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ag ){. if(
1c890 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
1c8a0 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 21 BTS_READ_ONLY)!
1c8b0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 =0 ){. rc
1c8c0 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 4f 4e = SQLITE_READON
1c8d0 4c 59 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b LY;. }else{
1c8e0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
1c8f0 6c 69 74 65 33 50 61 67 65 72 42 65 67 69 6e 28 lite3PagerBegin(
1c900 70 42 74 2d 3e 70 50 61 67 65 72 2c 77 72 66 6c pBt->pPager,wrfl
1c910 61 67 3e 31 2c 73 71 6c 69 74 65 33 54 65 6d 70 ag>1,sqlite3Temp
1c920 49 6e 4d 65 6d 6f 72 79 28 70 2d 3e 64 62 29 29 InMemory(p->db))
1c930 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
1c940 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1c950 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 6e 65 rc = ne
1c960 77 44 61 74 61 62 61 73 65 28 70 42 74 29 3b 0a wDatabase(pBt);.
1c970 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
1c980 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 ( rc==SQLITE_BUS
1c990 59 5f 53 4e 41 50 53 48 4f 54 20 26 26 20 70 42 Y_SNAPSHOT && pB
1c9a0 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
1c9b0 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 7b 0a ==TRANS_NONE ){.
1c9c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 66 20 /* if
1c9d0 74 68 65 72 65 20 77 61 73 20 6e 6f 20 74 72 61 there was no tra
1c9e0 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 65 64 20 nsaction opened
1c9f0 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
1ca00 6f 6e 20 77 61 73 0a 20 20 20 20 20 20 20 20 20 on was.
1ca10 20 2a 2a 20 63 61 6c 6c 65 64 20 61 6e 64 20 53 ** called and S
1ca20 51 4c 49 54 45 5f 42 55 53 59 5f 53 4e 41 50 53 QLITE_BUSY_SNAPS
1ca30 48 4f 54 20 69 73 20 72 65 74 75 72 6e 65 64 2c HOT is returned,
1ca40 20 63 68 61 6e 67 65 20 74 68 65 20 65 72 72 6f change the erro
1ca50 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 63 r. ** c
1ca60 6f 64 65 20 74 6f 20 53 51 4c 49 54 45 5f 42 55 ode to SQLITE_BU
1ca70 53 59 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 SY. */.
1ca80 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 53 rc = SQLITE_BUS
1ca90 59 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 Y;. }.
1caa0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 }. }. .
1cab0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1cac0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 75 6e 6c _OK ){. unl
1cad0 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1cae0 28 70 42 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d (pBt);. }. }
1caf0 77 68 69 6c 65 28 20 28 72 63 26 30 78 46 46 29 while( (rc&0xFF)
1cb00 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 26 26 ==SQLITE_BUSY &&
1cb10 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
1cb20 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 ion==TRANS_NONE
1cb30 26 26 0a 20 20 20 20 20 20 20 20 20 20 62 74 72 &&. btr
1cb40 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 eeInvokeBusyHand
1cb50 6c 65 72 28 70 42 74 29 20 29 3b 0a 20 20 73 71 ler(pBt) );. sq
1cb60 6c 69 74 65 33 50 61 67 65 72 52 65 73 65 74 4c lite3PagerResetL
1cb70 6f 63 6b 54 69 6d 65 6f 75 74 28 70 42 74 2d 3e ockTimeout(pBt->
1cb80 70 50 61 67 65 72 29 3b 0a 0a 20 20 69 66 28 20 pPager);.. if(
1cb90 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1cba0 0a 20 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 . if( p->inTr
1cbb0 61 6e 73 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 ans==TRANS_NONE
1cbc0 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 54 ){. pBt->nT
1cbd0 72 61 6e 73 61 63 74 69 6f 6e 2b 2b 3b 0a 23 69 ransaction++;.#i
1cbe0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
1cbf0 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 T_SHARED_CACHE.
1cc00 20 20 20 20 20 69 66 28 20 70 2d 3e 73 68 61 72 if( p->shar
1cc10 61 62 6c 65 20 29 7b 0a 20 20 20 20 20 20 20 20 able ){.
1cc20 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b 2e assert( p->lock.
1cc30 70 42 74 72 65 65 3d 3d 70 20 26 26 20 70 2d 3e pBtree==p && p->
1cc40 6c 6f 63 6b 2e 69 54 61 62 6c 65 3d 3d 31 20 29 lock.iTable==1 )
1cc50 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e 6c 6f 63 ;. p->loc
1cc60 6b 2e 65 4c 6f 63 6b 20 3d 20 52 45 41 44 5f 4c k.eLock = READ_L
1cc70 4f 43 4b 3b 0a 20 20 20 20 20 20 20 20 70 2d 3e OCK;. p->
1cc80 6c 6f 63 6b 2e 70 4e 65 78 74 20 3d 20 70 42 74 lock.pNext = pBt
1cc90 2d 3e 70 4c 6f 63 6b 3b 0a 20 20 20 20 20 20 20 ->pLock;.
1cca0 20 70 42 74 2d 3e 70 4c 6f 63 6b 20 3d 20 26 70 pBt->pLock = &p
1ccb0 2d 3e 6c 6f 63 6b 3b 0a 20 20 20 20 20 20 7d 0a ->lock;. }.
1ccc0 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 #endif. }.
1ccd0 20 70 2d 3e 69 6e 54 72 61 6e 73 20 3d 20 28 77 p->inTrans = (w
1cce0 72 66 6c 61 67 3f 54 52 41 4e 53 5f 57 52 49 54 rflag?TRANS_WRIT
1ccf0 45 3a 54 52 41 4e 53 5f 52 45 41 44 29 3b 0a 20 E:TRANS_READ);.
1cd00 20 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e if( p->inTran
1cd10 73 3e 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 s>pBt->inTransac
1cd20 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 70 42 tion ){. pB
1cd30 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
1cd40 20 3d 20 70 2d 3e 69 6e 54 72 61 6e 73 3b 0a 20 = p->inTrans;.
1cd50 20 20 20 7d 0a 20 20 20 20 69 66 28 20 77 72 66 }. if( wrf
1cd60 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 4d 65 6d lag ){. Mem
1cd70 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 Page *pPage1 = p
1cd80 42 74 2d 3e 70 50 61 67 65 31 3b 0a 23 69 66 6e Bt->pPage1;.#ifn
1cd90 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1cda0 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 20 SHARED_CACHE.
1cdb0 20 20 20 61 73 73 65 72 74 28 20 21 70 42 74 2d assert( !pBt-
1cdc0 3e 70 57 72 69 74 65 72 20 29 3b 0a 20 20 20 20 >pWriter );.
1cdd0 20 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 3d pBt->pWriter =
1cde0 20 70 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 p;. pBt->b
1cdf0 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 53 5f tsFlags &= ~BTS_
1ce00 45 58 43 4c 55 53 49 56 45 3b 0a 20 20 20 20 20 EXCLUSIVE;.
1ce10 20 69 66 28 20 77 72 66 6c 61 67 3e 31 20 29 20 if( wrflag>1 )
1ce20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
1ce30 20 42 54 53 5f 45 58 43 4c 55 53 49 56 45 3b 0a BTS_EXCLUSIVE;.
1ce40 23 65 6e 64 69 66 0a 0a 20 20 20 20 20 20 2f 2a #endif.. /*
1ce50 20 49 66 20 74 68 65 20 64 62 2d 73 69 7a 65 20 If the db-size
1ce60 68 65 61 64 65 72 20 66 69 65 6c 64 20 69 73 20 header field is
1ce70 69 6e 63 6f 72 72 65 63 74 20 28 61 73 20 69 74 incorrect (as it
1ce80 20 6d 61 79 20 62 65 20 69 66 20 61 6e 20 6f 6c may be if an ol
1ce90 64 0a 20 20 20 20 20 20 2a 2a 20 63 6c 69 65 6e d. ** clien
1cea0 74 20 68 61 73 20 62 65 65 6e 20 77 72 69 74 69 t has been writi
1ceb0 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ng the database
1cec0 66 69 6c 65 29 2c 20 75 70 64 61 74 65 20 69 74 file), update it
1ced0 20 6e 6f 77 2e 20 44 6f 69 6e 67 0a 20 20 20 20 now. Doing.
1cee0 20 20 2a 2a 20 74 68 69 73 20 73 6f 6f 6e 65 72 ** this sooner
1cef0 20 72 61 74 68 65 72 20 74 68 61 6e 20 6c 61 74 rather than lat
1cf00 65 72 20 6d 65 61 6e 73 20 74 68 65 20 64 61 74 er means the dat
1cf10 61 62 61 73 65 20 73 69 7a 65 20 63 61 6e 20 73 abase size can s
1cf20 61 66 65 6c 79 20 0a 20 20 20 20 20 20 2a 2a 20 afely . **
1cf30 72 65 2d 72 65 61 64 20 74 68 65 20 64 61 74 61 re-read the data
1cf40 62 61 73 65 20 73 69 7a 65 20 66 72 6f 6d 20 70 base size from p
1cf50 61 67 65 20 31 20 69 66 20 61 20 73 61 76 65 70 age 1 if a savep
1cf60 6f 69 6e 74 20 6f 72 20 74 72 61 6e 73 61 63 74 oint or transact
1cf70 69 6f 6e 0a 20 20 20 20 20 20 2a 2a 20 72 6f 6c ion. ** rol
1cf80 6c 62 61 63 6b 20 6f 63 63 75 72 73 20 77 69 74 lback occurs wit
1cf90 68 69 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 hin the transact
1cfa0 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ion.. */.
1cfb0 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 if( pBt->nPa
1cfc0 67 65 21 3d 67 65 74 34 62 79 74 65 28 26 70 50 ge!=get4byte(&pP
1cfd0 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 29 age1->aData[28])
1cfe0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d ){. rc =
1cff0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
1d000 74 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 te(pPage1->pDbPa
1d010 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ge);. if(
1d020 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
1d030 7b 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 {. put4
1d040 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 byte(&pPage1->aD
1d050 61 74 61 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e 50 ata[28], pBt->nP
1d060 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a age);. }.
1d070 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1d080 7d 0a 0a 74 72 61 6e 73 5f 62 65 67 75 6e 3a 0a }..trans_begun:.
1d090 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1d0a0 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
1d0b0 53 63 68 65 6d 61 56 65 72 73 69 6f 6e 20 29 7b SchemaVersion ){
1d0c0 0a 20 20 20 20 20 20 2a 70 53 63 68 65 6d 61 56 . *pSchemaV
1d0d0 65 72 73 69 6f 6e 20 3d 20 67 65 74 34 62 79 74 ersion = get4byt
1d0e0 65 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e e(&pBt->pPage1->
1d0f0 61 44 61 74 61 5b 34 30 5d 29 3b 0a 20 20 20 20 aData[40]);.
1d100 7d 0a 20 20 20 20 69 66 28 20 77 72 66 6c 61 67 }. if( wrflag
1d110 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 ){. /* Thi
1d120 73 20 63 61 6c 6c 20 6d 61 6b 65 73 20 73 75 72 s call makes sur
1d130 65 20 74 68 61 74 20 74 68 65 20 70 61 67 65 72 e that the pager
1d140 20 68 61 73 20 74 68 65 20 63 6f 72 72 65 63 74 has the correct
1d150 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 20 20 number of.
1d160 20 2a 2a 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 ** open savepoi
1d170 6e 74 73 2e 20 49 66 20 74 68 65 20 73 65 63 6f nts. If the seco
1d180 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 nd parameter is
1d190 67 72 65 61 74 65 72 20 74 68 61 6e 20 30 20 61 greater than 0 a
1d1a0 6e 64 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 nd. ** the
1d1b0 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 6e sub-journal is n
1d1c0 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2c ot already open,
1d1d0 20 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 65 then it will be
1d1e0 20 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a 20 20 opened here..
1d1f0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 */. rc
1d200 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f 70 = sqlite3PagerOp
1d210 65 6e 53 61 76 65 70 6f 69 6e 74 28 70 42 74 2d enSavepoint(pBt-
1d220 3e 70 50 61 67 65 72 2c 20 70 2d 3e 64 62 2d 3e >pPager, p->db->
1d230 6e 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 20 20 nSavepoint);.
1d240 20 7d 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 49 }. }.. btreeI
1d250 6e 74 65 67 72 69 74 79 28 70 29 3b 0a 20 20 73 ntegrity(p);. s
1d260 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
1d270 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
1d280 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c ;.}..#ifndef SQL
1d290 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
1d2a0 55 55 4d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 UUM../*.** Set t
1d2b0 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 he pointer-map e
1d2c0 6e 74 72 69 65 73 20 66 6f 72 20 61 6c 6c 20 63 ntries for all c
1d2d0 68 69 6c 64 72 65 6e 20 6f 66 20 70 61 67 65 20 hildren of page
1d2e0 70 50 61 67 65 2e 20 41 6c 73 6f 2c 20 69 66 0a pPage. Also, if.
1d2f0 2a 2a 20 70 50 61 67 65 20 63 6f 6e 74 61 69 6e ** pPage contain
1d300 73 20 63 65 6c 6c 73 20 74 68 61 74 20 70 6f 69 s cells that poi
1d310 6e 74 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 nt to overflow p
1d320 61 67 65 73 2c 20 73 65 74 20 74 68 65 20 70 6f ages, set the po
1d330 69 6e 74 65 72 0a 2a 2a 20 6d 61 70 20 65 6e 74 inter.** map ent
1d340 72 69 65 73 20 66 6f 72 20 74 68 65 20 6f 76 65 ries for the ove
1d350 72 66 6c 6f 77 20 70 61 67 65 73 20 61 73 20 77 rflow pages as w
1d360 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ell..*/.static i
1d370 6e 74 20 73 65 74 43 68 69 6c 64 50 74 72 6d 61 nt setChildPtrma
1d380 70 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ps(MemPage *pPag
1d390 65 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 e){. int i;
1d3a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d3b0 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e /* Coun
1d3c0 74 65 72 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a ter variable */.
1d3d0 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 int nCell;
1d3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d3f0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1d400 66 20 63 65 6c 6c 73 20 69 6e 20 70 61 67 65 20 f cells in page
1d410 70 50 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 72 pPage */. int r
1d420 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
1d430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1d440 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a Return code */.
1d450 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
1d460 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
1d470 50 67 6e 6f 20 70 67 6e 6f 20 3d 20 70 50 61 67 Pgno pgno = pPag
1d480 65 2d 3e 70 67 6e 6f 3b 0a 0a 20 20 61 73 73 65 e->pgno;.. asse
1d490 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
1d4a0 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
1d4b0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 t->mutex) );. r
1d4c0 63 20 3d 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 c = pPage->isIni
1d4d0 74 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 t ? SQLITE_OK :
1d4e0 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 50 btreeInitPage(pP
1d4f0 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d age);. if( rc!=
1d500 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 SQLITE_OK ) retu
1d510 72 6e 20 72 63 3b 0a 20 20 6e 43 65 6c 6c 20 3d rn rc;. nCell =
1d520 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a pPage->nCell;..
1d530 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 for(i=0; i<nCe
1d540 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 ll; i++){. u8
1d550 20 2a 70 43 65 6c 6c 20 3d 20 66 69 6e 64 43 65 *pCell = findCe
1d560 6c 6c 28 70 50 61 67 65 2c 20 69 29 3b 0a 0a 20 ll(pPage, i);..
1d570 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c ptrmapPutOvfl
1d580 50 74 72 28 70 50 61 67 65 2c 20 70 50 61 67 65 Ptr(pPage, pPage
1d590 2c 20 70 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a , pCell, &rc);..
1d5a0 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e if( !pPage->
1d5b0 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 50 67 leaf ){. Pg
1d5c0 6e 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 no childPgno = g
1d5d0 65 74 34 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a et4byte(pCell);.
1d5e0 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 ptrmapPut(
1d5f0 70 42 74 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 pBt, childPgno,
1d600 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 PTRMAP_BTREE, pg
1d610 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a no, &rc);. }.
1d620 20 20 7d 0a 0a 20 20 69 66 28 20 21 70 50 61 67 }.. if( !pPag
1d630 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 e->leaf ){. P
1d640 67 6e 6f 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 gno childPgno =
1d650 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d get4byte(&pPage-
1d660 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 >aData[pPage->hd
1d670 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 rOffset+8]);.
1d680 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 ptrmapPut(pBt,
1d690 63 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 childPgno, PTRMA
1d6a0 50 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 P_BTREE, pgno, &
1d6b0 72 63 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 rc);. }.. retu
1d6c0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1d6d0 53 6f 6d 65 77 68 65 72 65 20 6f 6e 20 70 50 61 Somewhere on pPa
1d6e0 67 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 ge is a pointer
1d6f0 74 6f 20 70 61 67 65 20 69 46 72 6f 6d 2e 20 20 to page iFrom.
1d700 4d 6f 64 69 66 79 20 74 68 69 73 20 70 6f 69 6e Modify this poin
1d710 74 65 72 20 73 6f 0a 2a 2a 20 74 68 61 74 20 69 ter so.** that i
1d720 74 20 70 6f 69 6e 74 73 20 74 6f 20 69 54 6f 2e t points to iTo.
1d730 20 50 61 72 61 6d 65 74 65 72 20 65 54 79 70 65 Parameter eType
1d740 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 74 describes the t
1d750 79 70 65 20 6f 66 20 70 6f 69 6e 74 65 72 20 74 ype of pointer t
1d760 6f 0a 2a 2a 20 62 65 20 6d 6f 64 69 66 69 65 64 o.** be modified
1d770 2c 20 61 73 20 20 66 6f 6c 6c 6f 77 73 3a 0a 2a , as follows:.*
1d780 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 42 54 52 45 *.** PTRMAP_BTRE
1d790 45 3a 20 20 20 20 20 70 50 61 67 65 20 69 73 20 E: pPage is
1d7a0 61 20 62 74 72 65 65 2d 70 61 67 65 2e 20 54 68 a btree-page. Th
1d7b0 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 e pointer points
1d7c0 20 61 74 20 61 20 63 68 69 6c 64 20 0a 2a 2a 20 at a child .**
1d7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d7e0 20 20 70 61 67 65 20 6f 66 20 70 50 61 67 65 2e page of pPage.
1d7f0 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 4f 56 .**.** PTRMAP_OV
1d800 45 52 46 4c 4f 57 31 3a 20 70 50 61 67 65 20 69 ERFLOW1: pPage i
1d810 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 2e 20 s a btree-page.
1d820 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e The pointer poin
1d830 74 73 20 61 74 20 61 6e 20 6f 76 65 72 66 6c 6f ts at an overflo
1d840 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 w.**
1d850 20 20 20 20 20 20 20 70 61 67 65 20 70 6f 69 6e page poin
1d860 74 65 64 20 74 6f 20 62 79 20 6f 6e 65 20 6f 66 ted to by one of
1d870 20 74 68 65 20 63 65 6c 6c 73 20 6f 6e 20 70 50 the cells on pP
1d880 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 age..**.** PTRMA
1d890 50 5f 4f 56 45 52 46 4c 4f 57 32 3a 20 70 50 61 P_OVERFLOW2: pPa
1d8a0 67 65 20 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f ge is an overflo
1d8b0 77 2d 70 61 67 65 2e 20 54 68 65 20 70 6f 69 6e w-page. The poin
1d8c0 74 65 72 20 70 6f 69 6e 74 73 20 61 74 20 74 68 ter points at th
1d8d0 65 20 6e 65 78 74 0a 2a 2a 20 20 20 20 20 20 20 e next.**
1d8e0 20 20 20 20 20 20 20 20 20 20 20 20 6f 76 65 72 over
1d8f0 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 68 65 flow page in the
1d900 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 list..*/.static
1d910 20 69 6e 74 20 6d 6f 64 69 66 79 50 61 67 65 50 int modifyPageP
1d920 6f 69 6e 74 65 72 28 4d 65 6d 50 61 67 65 20 2a ointer(MemPage *
1d930 70 50 61 67 65 2c 20 50 67 6e 6f 20 69 46 72 6f pPage, Pgno iFro
1d940 6d 2c 20 50 67 6e 6f 20 69 54 6f 2c 20 75 38 20 m, Pgno iTo, u8
1d950 65 54 79 70 65 29 7b 0a 20 20 61 73 73 65 72 74 eType){. assert
1d960 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
1d970 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
1d980 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
1d990 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
1d9a0 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
1d9b0 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a ge->pDbPage) );.
1d9c0 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 if( eType==PTR
1d9d0 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 29 7b MAP_OVERFLOW2 ){
1d9e0 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e . /* The poin
1d9f0 74 65 72 20 69 73 20 61 6c 77 61 79 73 20 74 68 ter is always th
1da00 65 20 66 69 72 73 74 20 34 20 62 79 74 65 73 20 e first 4 bytes
1da10 6f 66 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 of the page in t
1da20 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20 his case. */.
1da30 20 20 69 66 28 20 67 65 74 34 62 79 74 65 28 70 if( get4byte(p
1da40 50 61 67 65 2d 3e 61 44 61 74 61 29 21 3d 69 46 Page->aData)!=iF
1da50 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 72 65 74 rom ){. ret
1da60 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
1da70 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a PT_PAGE(pPage);.
1da80 20 20 20 20 7d 0a 20 20 20 20 70 75 74 34 62 79 }. put4by
1da90 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c te(pPage->aData,
1daa0 20 69 54 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a iTo);. }else{.
1dab0 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 int i;. i
1dac0 6e 74 20 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e nt nCell;. in
1dad0 74 20 72 63 3b 0a 0a 20 20 20 20 72 63 20 3d 20 t rc;.. rc =
1dae0 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3f 20 pPage->isInit ?
1daf0 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 62 74 72 65 SQLITE_OK : btre
1db00 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 eInitPage(pPage)
1db10 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
1db20 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 6e 43 eturn rc;. nC
1db30 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 ell = pPage->nCe
1db40 6c 6c 3b 0a 0a 20 20 20 20 66 6f 72 28 69 3d 30 ll;.. for(i=0
1db50 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b ; i<nCell; i++){
1db60 0a 20 20 20 20 20 20 75 38 20 2a 70 43 65 6c 6c . u8 *pCell
1db70 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 = findCell(pPag
1db80 65 2c 20 69 29 3b 0a 20 20 20 20 20 20 69 66 28 e, i);. if(
1db90 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f eType==PTRMAP_O
1dba0 56 45 52 46 4c 4f 57 31 20 29 7b 0a 20 20 20 20 VERFLOW1 ){.
1dbb0 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 CellInfo inf
1dbc0 6f 3b 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 o;. pPage
1dbd0 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 61 ->xParseCell(pPa
1dbe0 67 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f ge, pCell, &info
1dbf0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 );. if( i
1dc00 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 6e 66 6f 2e nfo.nLocal<info.
1dc10 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 nPayload ){.
1dc20 20 20 20 20 20 20 69 66 28 20 70 43 65 6c 6c 2b if( pCell+
1dc30 69 6e 66 6f 2e 6e 53 69 7a 65 20 3e 20 70 50 61 info.nSize > pPa
1dc40 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d ge->aData+pPage-
1dc50 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
1dc60 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
1dc70 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
1dc80 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 RRUPT_PAGE(pPage
1dc90 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
1dca0 20 20 20 20 20 20 20 20 20 69 66 28 20 69 46 72 if( iFr
1dcb0 6f 6d 3d 3d 67 65 74 34 62 79 74 65 28 70 43 65 om==get4byte(pCe
1dcc0 6c 6c 2b 69 6e 66 6f 2e 6e 53 69 7a 65 2d 34 29 ll+info.nSize-4)
1dcd0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
1dce0 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c 2b 69 put4byte(pCell+i
1dcf0 6e 66 6f 2e 6e 53 69 7a 65 2d 34 2c 20 69 54 6f nfo.nSize-4, iTo
1dd00 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 );. b
1dd10 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 reak;.
1dd20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
1dd30 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
1dd40 20 69 66 28 20 67 65 74 34 62 79 74 65 28 70 43 if( get4byte(pC
1dd50 65 6c 6c 29 3d 3d 69 46 72 6f 6d 20 29 7b 0a 20 ell)==iFrom ){.
1dd60 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 put4byt
1dd70 65 28 70 43 65 6c 6c 2c 20 69 54 6f 29 3b 0a 20 e(pCell, iTo);.
1dd80 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a break;.
1dd90 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
1dda0 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 69 }. }. . i
1ddb0 66 28 20 69 3d 3d 6e 43 65 6c 6c 20 29 7b 0a 20 f( i==nCell ){.
1ddc0 20 20 20 20 20 69 66 28 20 65 54 79 70 65 21 3d if( eType!=
1ddd0 50 54 52 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 PTRMAP_BTREE ||
1dde0 0a 20 20 20 20 20 20 20 20 20 20 67 65 74 34 62 . get4b
1ddf0 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 yte(&pPage->aDat
1de00 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
1de10 65 74 2b 38 5d 29 21 3d 69 46 72 6f 6d 20 29 7b et+8])!=iFrom ){
1de20 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
1de30 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 SQLITE_CORRUPT_P
1de40 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 AGE(pPage);.
1de50 20 20 7d 0a 20 20 20 20 20 20 70 75 74 34 62 79 }. put4by
1de60 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
1de70 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
1de80 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 t+8], iTo);.
1de90 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 }. }. return S
1dea0 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a QLITE_OK;.}.../*
1deb0 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 6f 70 65 .** Move the ope
1dec0 6e 20 64 61 74 61 62 61 73 65 20 70 61 67 65 20 n database page
1ded0 70 44 62 50 61 67 65 20 74 6f 20 6c 6f 63 61 74 pDbPage to locat
1dee0 69 6f 6e 20 69 46 72 65 65 50 61 67 65 20 69 6e ion iFreePage in
1def0 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 73 the .** databas
1df00 65 2e 20 54 68 65 20 70 44 62 50 61 67 65 20 72 e. The pDbPage r
1df10 65 66 65 72 65 6e 63 65 20 72 65 6d 61 69 6e 73 eference remains
1df20 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 valid..**.** Th
1df30 65 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 20 e isCommit flag
1df40 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 74 indicates that t
1df50 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 here is no need
1df60 74 6f 20 72 65 6d 65 6d 62 65 72 20 74 68 61 74 to remember that
1df70 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 .** the journal
1df80 6e 65 65 64 73 20 74 6f 20 62 65 20 73 79 6e 63 needs to be sync
1df90 28 29 65 64 20 62 65 66 6f 72 65 20 64 61 74 61 ()ed before data
1dfa0 62 61 73 65 20 70 61 67 65 20 70 44 62 50 61 67 base page pDbPag
1dfb0 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 63 61 6e 20 e->pgno .** can
1dfc0 62 65 20 77 72 69 74 74 65 6e 20 74 6f 2e 20 54 be written to. T
1dfd0 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 61 6c he caller has al
1dfe0 72 65 61 64 79 20 70 72 6f 6d 69 73 65 64 20 6e ready promised n
1dff0 6f 74 20 74 6f 20 77 72 69 74 65 20 74 6f 20 74 ot to write to t
1e000 68 61 74 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2f 0a hat.** page..*/.
1e010 73 74 61 74 69 63 20 69 6e 74 20 72 65 6c 6f 63 static int reloc
1e020 61 74 65 50 61 67 65 28 0a 20 20 42 74 53 68 61 atePage(. BtSha
1e030 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
1e040 20 20 20 20 2f 2a 20 42 74 72 65 65 20 2a 2f 0a /* Btree */.
1e050 20 20 4d 65 6d 50 61 67 65 20 2a 70 44 62 50 61 MemPage *pDbPa
1e060 67 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 ge, /* Op
1e070 65 6e 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 en page to move
1e080 2a 2f 0a 20 20 75 38 20 65 54 79 70 65 2c 20 20 */. u8 eType,
1e090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1e0a0 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 27 74 79 Pointer map 'ty
1e0b0 70 65 27 20 65 6e 74 72 79 20 66 6f 72 20 70 44 pe' entry for pD
1e0c0 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 bPage */. Pgno
1e0d0 69 50 74 72 50 61 67 65 2c 20 20 20 20 20 20 20 iPtrPage,
1e0e0 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d /* Pointer m
1e0f0 61 70 20 27 70 61 67 65 2d 6e 6f 27 20 65 6e 74 ap 'page-no' ent
1e100 72 79 20 66 6f 72 20 70 44 62 50 61 67 65 20 2a ry for pDbPage *
1e110 2f 0a 20 20 50 67 6e 6f 20 69 46 72 65 65 50 61 /. Pgno iFreePa
1e120 67 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ge, /*
1e130 54 68 65 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 The location to
1e140 6d 6f 76 65 20 70 44 62 50 61 67 65 20 74 6f 20 move pDbPage to
1e150 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f 6d 6d 69 */. int isCommi
1e160 74 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t /*
1e170 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 20 70 isCommit flag p
1e180 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 33 assed to sqlite3
1e190 50 61 67 65 72 4d 6f 76 65 70 61 67 65 20 2a 2f PagerMovepage */
1e1a0 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 .){. MemPage *p
1e1b0 50 74 72 50 61 67 65 3b 20 20 20 2f 2a 20 54 68 PtrPage; /* Th
1e1c0 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 e page that cont
1e1d0 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 ains a pointer t
1e1e0 6f 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 o pDbPage */. P
1e1f0 67 6e 6f 20 69 44 62 50 61 67 65 20 3d 20 70 44 gno iDbPage = pD
1e200 62 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 20 20 50 bPage->pgno;. P
1e210 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 ager *pPager = p
1e220 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69 6e Bt->pPager;. in
1e230 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 t rc;.. assert(
1e240 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f eType==PTRMAP_O
1e250 56 45 52 46 4c 4f 57 32 20 7c 7c 20 65 54 79 70 VERFLOW2 || eTyp
1e260 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c e==PTRMAP_OVERFL
1e270 4f 57 31 20 7c 7c 20 0a 20 20 20 20 20 20 65 54 OW1 || . eT
1e280 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 45 ype==PTRMAP_BTRE
1e290 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 4d E || eType==PTRM
1e2a0 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 3b 0a 20 AP_ROOTPAGE );.
1e2b0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
1e2c0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
1e2d0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
1e2e0 65 72 74 28 20 70 44 62 50 61 67 65 2d 3e 70 42 ert( pDbPage->pB
1e2f0 74 3d 3d 70 42 74 20 29 3b 0a 20 20 69 66 28 20 t==pBt );. if(
1e300 69 44 62 50 61 67 65 3c 33 20 29 20 72 65 74 75 iDbPage<3 ) retu
1e310 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
1e320 54 5f 42 4b 50 54 3b 0a 0a 20 20 2f 2a 20 4d 6f T_BKPT;.. /* Mo
1e330 76 65 20 70 61 67 65 20 69 44 62 50 61 67 65 20 ve page iDbPage
1e340 66 72 6f 6d 20 69 74 73 20 63 75 72 72 65 6e 74 from its current
1e350 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 70 61 67 location to pag
1e360 65 20 6e 75 6d 62 65 72 20 69 46 72 65 65 50 61 e number iFreePa
1e370 67 65 20 2a 2f 0a 20 20 54 52 41 43 45 28 28 22 ge */. TRACE(("
1e380 41 55 54 4f 56 41 43 55 55 4d 3a 20 4d 6f 76 69 AUTOVACUUM: Movi
1e390 6e 67 20 25 64 20 74 6f 20 66 72 65 65 20 70 61 ng %d to free pa
1e3a0 67 65 20 25 64 20 28 70 74 72 20 70 61 67 65 20 ge %d (ptr page
1e3b0 25 64 20 74 79 70 65 20 25 64 29 5c 6e 22 2c 20 %d type %d)\n",
1e3c0 0a 20 20 20 20 20 20 69 44 62 50 61 67 65 2c 20 . iDbPage,
1e3d0 69 46 72 65 65 50 61 67 65 2c 20 69 50 74 72 50 iFreePage, iPtrP
1e3e0 61 67 65 2c 20 65 54 79 70 65 29 29 3b 0a 20 20 age, eType));.
1e3f0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
1e400 72 4d 6f 76 65 70 61 67 65 28 70 50 61 67 65 72 rMovepage(pPager
1e410 2c 20 70 44 62 50 61 67 65 2d 3e 70 44 62 50 61 , pDbPage->pDbPa
1e420 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 69 ge, iFreePage, i
1e430 73 43 6f 6d 6d 69 74 29 3b 0a 20 20 69 66 28 20 sCommit);. if(
1e440 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1e450 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a . return rc;.
1e460 20 20 7d 0a 20 20 70 44 62 50 61 67 65 2d 3e 70 }. pDbPage->p
1e470 67 6e 6f 20 3d 20 69 46 72 65 65 50 61 67 65 3b gno = iFreePage;
1e480 0a 0a 20 20 2f 2a 20 49 66 20 70 44 62 50 61 67 .. /* If pDbPag
1e490 65 20 77 61 73 20 61 20 62 74 72 65 65 2d 70 61 e was a btree-pa
1e4a0 67 65 2c 20 74 68 65 6e 20 69 74 20 6d 61 79 20 ge, then it may
1e4b0 68 61 76 65 20 63 68 69 6c 64 20 70 61 67 65 73 have child pages
1e4c0 20 61 6e 64 2f 6f 72 20 63 65 6c 6c 73 0a 20 20 and/or cells.
1e4d0 2a 2a 20 74 68 61 74 20 70 6f 69 6e 74 20 74 6f ** that point to
1e4e0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e overflow pages.
1e4f0 20 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 The pointer map
1e500 20 65 6e 74 72 69 65 73 20 66 6f 72 20 61 6c 6c entries for all
1e510 20 74 68 65 73 65 0a 20 20 2a 2a 20 70 61 67 65 these. ** page
1e520 73 20 6e 65 65 64 20 74 6f 20 62 65 20 63 68 61 s need to be cha
1e530 6e 67 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 nged.. **. **
1e540 49 66 20 70 44 62 50 61 67 65 20 69 73 20 61 6e If pDbPage is an
1e550 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 overflow page,
1e560 74 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 34 then the first 4
1e570 20 62 79 74 65 73 20 6d 61 79 20 73 74 6f 72 65 bytes may store
1e580 20 61 0a 20 20 2a 2a 20 70 6f 69 6e 74 65 72 20 a. ** pointer
1e590 74 6f 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 to a subsequent
1e5a0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e 20 49 overflow page. I
1e5b0 66 20 74 68 69 73 20 69 73 20 74 68 65 20 63 61 f this is the ca
1e5c0 73 65 2c 20 74 68 65 6e 0a 20 20 2a 2a 20 74 68 se, then. ** th
1e5d0 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 6e 65 e pointer map ne
1e5e0 65 64 73 20 74 6f 20 62 65 20 75 70 64 61 74 65 eds to be update
1e5f0 64 20 66 6f 72 20 74 68 65 20 73 75 62 73 65 71 d for the subseq
1e600 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 uent overflow pa
1e610 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 ge.. */. if( e
1e620 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 Type==PTRMAP_BTR
1e630 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 EE || eType==PTR
1e640 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a MAP_ROOTPAGE ){.
1e650 20 20 20 20 72 63 20 3d 20 73 65 74 43 68 69 6c rc = setChil
1e660 64 50 74 72 6d 61 70 73 28 70 44 62 50 61 67 65 dPtrmaps(pDbPage
1e670 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
1e680 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1e690 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
1e6a0 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }. }else{.
1e6b0 50 67 6e 6f 20 6e 65 78 74 4f 76 66 6c 20 3d 20 Pgno nextOvfl =
1e6c0 67 65 74 34 62 79 74 65 28 70 44 62 50 61 67 65 get4byte(pDbPage
1e6d0 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 69 66 ->aData);. if
1e6e0 28 20 6e 65 78 74 4f 76 66 6c 21 3d 30 20 29 7b ( nextOvfl!=0 ){
1e6f0 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 . ptrmapPut
1e700 28 70 42 74 2c 20 6e 65 78 74 4f 76 66 6c 2c 20 (pBt, nextOvfl,
1e710 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
1e720 2c 20 69 46 72 65 65 50 61 67 65 2c 20 26 72 63 , iFreePage, &rc
1e730 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
1e740 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1e750 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
1e760 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
1e770 20 7d 0a 0a 20 20 2f 2a 20 46 69 78 20 74 68 65 }.. /* Fix the
1e780 20 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 65 database pointe
1e790 72 20 6f 6e 20 70 61 67 65 20 69 50 74 72 50 61 r on page iPtrPa
1e7a0 67 65 20 74 68 61 74 20 70 6f 69 6e 74 65 64 20 ge that pointed
1e7b0 61 74 20 69 44 62 50 61 67 65 20 73 6f 0a 20 20 at iDbPage so.
1e7c0 2a 2a 20 74 68 61 74 20 69 74 20 70 6f 69 6e 74 ** that it point
1e7d0 73 20 61 74 20 69 46 72 65 65 50 61 67 65 2e 20 s at iFreePage.
1e7e0 41 6c 73 6f 20 66 69 78 20 74 68 65 20 70 6f 69 Also fix the poi
1e7f0 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 nter map entry f
1e800 6f 72 0a 20 20 2a 2a 20 69 50 74 72 50 61 67 65 or. ** iPtrPage
1e810 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 54 79 .. */. if( eTy
1e820 70 65 21 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 pe!=PTRMAP_ROOTP
1e830 41 47 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 AGE ){. rc =
1e840 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
1e850 2c 20 69 50 74 72 50 61 67 65 2c 20 26 70 50 74 , iPtrPage, &pPt
1e860 72 50 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 69 rPage, 0);. i
1e870 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1e880 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1e890 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 rc;. }. r
1e8a0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
1e8b0 57 72 69 74 65 28 70 50 74 72 50 61 67 65 2d 3e Write(pPtrPage->
1e8c0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 pDbPage);. if
1e8d0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1e8e0 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 ){. release
1e8f0 50 61 67 65 28 70 50 74 72 50 61 67 65 29 3b 0a Page(pPtrPage);.
1e900 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
1e910 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 . }. rc =
1e920 6d 6f 64 69 66 79 50 61 67 65 50 6f 69 6e 74 65 modifyPagePointe
1e930 72 28 70 50 74 72 50 61 67 65 2c 20 69 44 62 50 r(pPtrPage, iDbP
1e940 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 age, iFreePage,
1e950 65 54 79 70 65 29 3b 0a 20 20 20 20 72 65 6c 65 eType);. rele
1e960 61 73 65 50 61 67 65 28 70 50 74 72 50 61 67 65 asePage(pPtrPage
1e970 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
1e980 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1e990 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
1e9a0 20 69 46 72 65 65 50 61 67 65 2c 20 65 54 79 70 iFreePage, eTyp
1e9b0 65 2c 20 69 50 74 72 50 61 67 65 2c 20 26 72 63 e, iPtrPage, &rc
1e9c0 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 );. }. }. r
1e9d0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 eturn rc;.}../*
1e9e0 46 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 Forward declarat
1e9f0 69 6f 6e 20 72 65 71 75 69 72 65 64 20 62 79 20 ion required by
1ea00 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 29 incrVacuumStep()
1ea10 2e 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 . */.static int
1ea20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
1ea30 65 28 42 74 53 68 61 72 65 64 20 2a 2c 20 4d 65 e(BtShared *, Me
1ea40 6d 50 61 67 65 20 2a 2a 2c 20 50 67 6e 6f 20 2a mPage **, Pgno *
1ea50 2c 20 50 67 6e 6f 2c 20 75 38 29 3b 0a 0a 2f 2a , Pgno, u8);../*
1ea60 0a 2a 2a 20 50 65 72 66 6f 72 6d 20 61 20 73 69 .** Perform a si
1ea70 6e 67 6c 65 20 73 74 65 70 20 6f 66 20 61 6e 20 ngle step of an
1ea80 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 incremental-vacu
1ea90 75 6d 2e 20 49 66 20 73 75 63 63 65 73 73 66 75 um. If successfu
1eaa0 6c 2c 20 72 65 74 75 72 6e 0a 2a 2a 20 53 51 4c l, return.** SQL
1eab0 49 54 45 5f 4f 4b 2e 20 49 66 20 74 68 65 72 65 ITE_OK. If there
1eac0 20 69 73 20 6e 6f 20 77 6f 72 6b 20 74 6f 20 64 is no work to d
1ead0 6f 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72 65 o (and therefore
1eae0 20 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 0a 2a 2a no point in .**
1eaf0 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 calling this fu
1eb00 6e 63 74 69 6f 6e 20 61 67 61 69 6e 29 2c 20 72 nction again), r
1eb10 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e eturn SQLITE_DON
1eb20 45 2e 20 4f 72 2c 20 69 66 20 61 6e 20 65 72 72 E. Or, if an err
1eb30 6f 72 20 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 72 or .** occurs, r
1eb40 65 74 75 72 6e 20 73 6f 6d 65 20 6f 74 68 65 72 eturn some other
1eb50 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a error code..**.
1eb60 2a 2a 20 4d 6f 72 65 20 73 70 65 63 69 66 69 63 ** More specific
1eb70 61 6c 6c 79 2c 20 74 68 69 73 20 66 75 6e 63 74 ally, this funct
1eb80 69 6f 6e 20 61 74 74 65 6d 70 74 73 20 74 6f 20 ion attempts to
1eb90 72 65 2d 6f 72 67 61 6e 69 7a 65 20 74 68 65 20 re-organize the
1eba0 64 61 74 61 62 61 73 65 20 73 6f 20 0a 2a 2a 20 database so .**
1ebb0 74 68 61 74 20 74 68 65 20 6c 61 73 74 20 70 61 that the last pa
1ebc0 67 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 ge of the file c
1ebd0 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 urrently in use
1ebe0 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 69 6e 20 is no longer in
1ebf0 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d use..**.** Param
1ec00 65 74 65 72 20 6e 46 69 6e 20 69 73 20 74 68 65 eter nFin is the
1ec10 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
1ec20 20 74 68 61 74 20 74 68 69 73 20 64 61 74 61 62 that this datab
1ec30 61 73 65 20 77 6f 75 6c 64 20 63 6f 6e 74 61 69 ase would contai
1ec40 6e 0a 2a 2a 20 77 65 72 65 20 74 68 69 73 20 66 n.** were this f
1ec50 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 64 20 75 unction called u
1ec60 6e 74 69 6c 20 69 74 20 72 65 74 75 72 6e 73 20 ntil it returns
1ec70 53 51 4c 49 54 45 5f 44 4f 4e 45 2e 0a 2a 2a 0a SQLITE_DONE..**.
1ec80 2a 2a 20 49 66 20 74 68 65 20 62 43 6f 6d 6d 69 ** If the bCommi
1ec90 74 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e t parameter is n
1eca0 6f 6e 2d 7a 65 72 6f 2c 20 74 68 69 73 20 66 75 on-zero, this fu
1ecb0 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 20 74 nction assumes t
1ecc0 68 61 74 20 74 68 65 20 0a 2a 2a 20 63 61 6c 6c hat the .** call
1ecd0 65 72 20 77 69 6c 6c 20 6b 65 65 70 20 63 61 6c er will keep cal
1ece0 6c 69 6e 67 20 69 6e 63 72 56 61 63 75 75 6d 53 ling incrVacuumS
1ecf0 74 65 70 28 29 20 75 6e 74 69 6c 20 69 74 20 72 tep() until it r
1ed00 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f eturns SQLITE_DO
1ed10 4e 45 20 0a 2a 2a 20 6f 72 20 61 6e 20 65 72 72 NE .** or an err
1ed20 6f 72 2e 20 62 43 6f 6d 6d 69 74 20 69 73 20 70 or. bCommit is p
1ed30 61 73 73 65 64 20 74 72 75 65 20 66 6f 72 20 61 assed true for a
1ed40 6e 20 61 75 74 6f 2d 76 61 63 75 75 6d 2d 6f 6e n auto-vacuum-on
1ed50 2d 63 6f 6d 6d 69 74 20 0a 2a 2a 20 6f 70 65 72 -commit .** oper
1ed60 61 74 69 6f 6e 2c 20 6f 72 20 66 61 6c 73 65 20 ation, or false
1ed70 66 6f 72 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 for an increment
1ed80 61 6c 20 76 61 63 75 75 6d 2e 0a 2a 2f 0a 73 74 al vacuum..*/.st
1ed90 61 74 69 63 20 69 6e 74 20 69 6e 63 72 56 61 63 atic int incrVac
1eda0 75 75 6d 53 74 65 70 28 42 74 53 68 61 72 65 64 uumStep(BtShared
1edb0 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6e 46 69 6e *pBt, Pgno nFin
1edc0 2c 20 50 67 6e 6f 20 69 4c 61 73 74 50 67 2c 20 , Pgno iLastPg,
1edd0 69 6e 74 20 62 43 6f 6d 6d 69 74 29 7b 0a 20 20 int bCommit){.
1ede0 50 67 6e 6f 20 6e 46 72 65 65 4c 69 73 74 3b 20 Pgno nFreeList;
1edf0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1ee00 62 65 72 20 6f 66 20 70 61 67 65 73 20 73 74 69 ber of pages sti
1ee10 6c 6c 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c ll on the free-l
1ee20 69 73 74 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b ist */. int rc;
1ee30 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
1ee40 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
1ee50 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
1ee60 61 73 73 65 72 74 28 20 69 4c 61 73 74 50 67 3e assert( iLastPg>
1ee70 6e 46 69 6e 20 29 3b 0a 0a 20 20 69 66 28 20 21 nFin );.. if( !
1ee80 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 PTRMAP_ISPAGE(pB
1ee90 74 2c 20 69 4c 61 73 74 50 67 29 20 26 26 20 69 t, iLastPg) && i
1eea0 4c 61 73 74 50 67 21 3d 50 45 4e 44 49 4e 47 5f LastPg!=PENDING_
1eeb0 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 BYTE_PAGE(pBt) )
1eec0 7b 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a {. u8 eType;.
1eed0 20 20 20 20 50 67 6e 6f 20 69 50 74 72 50 61 67 Pgno iPtrPag
1eee0 65 3b 0a 0a 20 20 20 20 6e 46 72 65 65 4c 69 73 e;.. nFreeLis
1eef0 74 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 t = get4byte(&pB
1ef00 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
1ef10 5b 33 36 5d 29 3b 0a 20 20 20 20 69 66 28 20 6e [36]);. if( n
1ef20 46 72 65 65 4c 69 73 74 3d 3d 30 20 29 7b 0a 20 FreeList==0 ){.
1ef30 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
1ef40 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 0a TE_DONE;. }..
1ef50 20 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 rc = ptrmapG
1ef60 65 74 28 70 42 74 2c 20 69 4c 61 73 74 50 67 2c et(pBt, iLastPg,
1ef70 20 26 65 54 79 70 65 2c 20 26 69 50 74 72 50 61 &eType, &iPtrPa
1ef80 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 ge);. if( rc!
1ef90 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1efa0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1efb0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 65 54 79 }. if( eTy
1efc0 70 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 pe==PTRMAP_ROOTP
1efd0 41 47 45 20 29 7b 0a 20 20 20 20 20 20 72 65 74 AGE ){. ret
1efe0 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
1eff0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 0a PT_BKPT;. }..
1f000 20 20 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 if( eType==P
1f010 54 52 4d 41 50 5f 46 52 45 45 50 41 47 45 20 29 TRMAP_FREEPAGE )
1f020 7b 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f 6d {. if( bCom
1f030 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 mit==0 ){.
1f040 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 /* Remove the
1f050 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 66 69 page from the fi
1f060 6c 65 73 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 les free-list. T
1f070 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71 75 69 his is not requi
1f080 72 65 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 red. ** i
1f090 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 6e 6f 6e f bCommit is non
1f0a0 2d 7a 65 72 6f 2e 20 49 6e 20 74 68 61 74 20 63 -zero. In that c
1f0b0 61 73 65 2c 20 74 68 65 20 66 72 65 65 2d 6c 69 ase, the free-li
1f0c0 73 74 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 20 st will be.
1f0d0 20 20 20 2a 2a 20 74 72 75 6e 63 61 74 65 64 20 ** truncated
1f0e0 74 6f 20 7a 65 72 6f 20 61 66 74 65 72 20 74 68 to zero after th
1f0f0 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
1f100 72 6e 73 2c 20 73 6f 20 69 74 20 64 6f 65 73 6e rns, so it doesn
1f110 27 74 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d 't . ** m
1f120 61 74 74 65 72 20 69 66 20 69 74 20 73 74 69 6c atter if it stil
1f130 6c 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 l contains some
1f140 67 61 72 62 61 67 65 20 65 6e 74 72 69 65 73 2e garbage entries.
1f150 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 . */.
1f160 20 20 20 20 50 67 6e 6f 20 69 46 72 65 65 50 67 Pgno iFreePg
1f170 3b 0a 20 20 20 20 20 20 20 20 4d 65 6d 50 61 67 ;. MemPag
1f180 65 20 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 20 e *pFreePg;.
1f190 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 rc = allocat
1f1a0 65 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 eBtreePage(pBt,
1f1b0 26 70 46 72 65 65 50 67 2c 20 26 69 46 72 65 65 &pFreePg, &iFree
1f1c0 50 67 2c 20 69 4c 61 73 74 50 67 2c 20 42 54 41 Pg, iLastPg, BTA
1f1d0 4c 4c 4f 43 5f 45 58 41 43 54 29 3b 0a 20 20 20 LLOC_EXACT);.
1f1e0 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
1f1f0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1f200 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1f210 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
1f220 20 61 73 73 65 72 74 28 20 69 46 72 65 65 50 67 assert( iFreePg
1f230 3d 3d 69 4c 61 73 74 50 67 20 29 3b 0a 20 20 20 ==iLastPg );.
1f240 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
1f250 28 70 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 (pFreePg);.
1f260 20 7d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a }. } else {.
1f270 20 20 20 20 20 20 50 67 6e 6f 20 69 46 72 65 65 Pgno iFree
1f280 50 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Pg;
1f290 2f 2a 20 49 6e 64 65 78 20 6f 66 20 66 72 65 65 /* Index of free
1f2a0 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 70 4c page to move pL
1f2b0 61 73 74 50 67 20 74 6f 20 2a 2f 0a 20 20 20 20 astPg to */.
1f2c0 20 20 4d 65 6d 50 61 67 65 20 2a 70 4c 61 73 74 MemPage *pLast
1f2d0 50 67 3b 0a 20 20 20 20 20 20 75 38 20 65 4d 6f Pg;. u8 eMo
1f2e0 64 65 20 3d 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 de = BTALLOC_ANY
1f2f0 3b 20 20 20 2f 2a 20 4d 6f 64 65 20 70 61 72 61 ; /* Mode para
1f300 6d 65 74 65 72 20 66 6f 72 20 61 6c 6c 6f 63 61 meter for alloca
1f310 74 65 42 74 72 65 65 50 61 67 65 28 29 20 2a 2f teBtreePage() */
1f320 0a 20 20 20 20 20 20 50 67 6e 6f 20 69 4e 65 61 . Pgno iNea
1f330 72 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 r = 0;
1f340 20 2f 2a 20 6e 65 61 72 62 79 20 70 61 72 61 6d /* nearby param
1f350 65 74 65 72 20 66 6f 72 20 61 6c 6c 6f 63 61 74 eter for allocat
1f360 65 42 74 72 65 65 50 61 67 65 28 29 20 2a 2f 0a eBtreePage() */.
1f370 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 . rc = btre
1f380 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 4c eGetPage(pBt, iL
1f390 61 73 74 50 67 2c 20 26 70 4c 61 73 74 50 67 2c astPg, &pLastPg,
1f3a0 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 0);. if( r
1f3b0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1f3c0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
1f3d0 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 c;. }..
1f3e0 20 20 2f 2a 20 49 66 20 62 43 6f 6d 6d 69 74 20 /* If bCommit
1f3f0 69 73 20 7a 65 72 6f 2c 20 74 68 69 73 20 6c 6f is zero, this lo
1f400 6f 70 20 72 75 6e 73 20 65 78 61 63 74 6c 79 20 op runs exactly
1f410 6f 6e 63 65 20 61 6e 64 20 70 61 67 65 20 70 4c once and page pL
1f420 61 73 74 50 67 0a 20 20 20 20 20 20 2a 2a 20 69 astPg. ** i
1f430 73 20 73 77 61 70 70 65 64 20 77 69 74 68 20 74 s swapped with t
1f440 68 65 20 66 69 72 73 74 20 66 72 65 65 20 70 61 he first free pa
1f450 67 65 20 70 75 6c 6c 65 64 20 6f 66 66 20 74 68 ge pulled off th
1f460 65 20 66 72 65 65 20 6c 69 73 74 2e 0a 20 20 20 e free list..
1f470 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4f **. ** O
1f480 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 n the other hand
1f490 2c 20 69 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 , if bCommit is
1f4a0 67 72 65 61 74 65 72 20 74 68 61 6e 20 7a 65 72 greater than zer
1f4b0 6f 2c 20 74 68 65 6e 20 6b 65 65 70 0a 20 20 20 o, then keep.
1f4c0 20 20 20 2a 2a 20 6c 6f 6f 70 69 6e 67 20 75 6e ** looping un
1f4d0 74 69 6c 20 61 20 66 72 65 65 2d 70 61 67 65 20 til a free-page
1f4e0 6c 6f 63 61 74 65 64 20 77 69 74 68 69 6e 20 74 located within t
1f4f0 68 65 20 66 69 72 73 74 20 6e 46 69 6e 20 70 61 he first nFin pa
1f500 67 65 73 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 ges. ** of
1f510 74 68 65 20 66 69 6c 65 20 69 73 20 66 6f 75 6e the file is foun
1f520 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 d.. */.
1f530 20 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 if( bCommit==0
1f540 20 29 7b 0a 20 20 20 20 20 20 20 20 65 4d 6f 64 ){. eMod
1f550 65 20 3d 20 42 54 41 4c 4c 4f 43 5f 4c 45 3b 0a e = BTALLOC_LE;.
1f560 20 20 20 20 20 20 20 20 69 4e 65 61 72 20 3d 20 iNear =
1f570 6e 46 69 6e 3b 0a 20 20 20 20 20 20 7d 0a 20 20 nFin;. }.
1f580 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 20 do {.
1f590 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 MemPage *pFreeP
1f5a0 67 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 g;. rc =
1f5b0 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
1f5c0 65 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c e(pBt, &pFreePg,
1f5d0 20 26 69 46 72 65 65 50 67 2c 20 69 4e 65 61 72 &iFreePg, iNear
1f5e0 2c 20 65 4d 6f 64 65 29 3b 0a 20 20 20 20 20 20 , eMode);.
1f5f0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1f600 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
1f610 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4c 61 releasePage(pLa
1f620 73 74 50 67 29 3b 0a 20 20 20 20 20 20 20 20 20 stPg);.
1f630 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
1f640 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 72 65 }. re
1f650 6c 65 61 73 65 50 61 67 65 28 70 46 72 65 65 50 leasePage(pFreeP
1f660 67 29 3b 0a 20 20 20 20 20 20 7d 77 68 69 6c 65 g);. }while
1f670 28 20 62 43 6f 6d 6d 69 74 20 26 26 20 69 46 72 ( bCommit && iFr
1f680 65 65 50 67 3e 6e 46 69 6e 20 29 3b 0a 20 20 20 eePg>nFin );.
1f690 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 assert( iFree
1f6a0 50 67 3c 69 4c 61 73 74 50 67 20 29 3b 0a 20 20 Pg<iLastPg );.
1f6b0 20 20 20 20 0a 20 20 20 20 20 20 72 63 20 3d 20 . rc =
1f6c0 72 65 6c 6f 63 61 74 65 50 61 67 65 28 70 42 74 relocatePage(pBt
1f6d0 2c 20 70 4c 61 73 74 50 67 2c 20 65 54 79 70 65 , pLastPg, eType
1f6e0 2c 20 69 50 74 72 50 61 67 65 2c 20 69 46 72 65 , iPtrPage, iFre
1f6f0 65 50 67 2c 20 62 43 6f 6d 6d 69 74 29 3b 0a 20 ePg, bCommit);.
1f700 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
1f710 28 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 20 20 (pLastPg);.
1f720 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1f730 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 OK ){. re
1f740 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
1f750 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 . }. }.. if
1f760 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a ( bCommit==0 ){.
1f770 20 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 69 do {. i
1f780 4c 61 73 74 50 67 2d 2d 3b 0a 20 20 20 20 7d 77 LastPg--;. }w
1f790 68 69 6c 65 28 20 69 4c 61 73 74 50 67 3d 3d 50 hile( iLastPg==P
1f7a0 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
1f7b0 28 70 42 74 29 20 7c 7c 20 50 54 52 4d 41 50 5f (pBt) || PTRMAP_
1f7c0 49 53 50 41 47 45 28 70 42 74 2c 20 69 4c 61 73 ISPAGE(pBt, iLas
1f7d0 74 50 67 29 20 29 3b 0a 20 20 20 20 70 42 74 2d tPg) );. pBt-
1f7e0 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 31 >bDoTruncate = 1
1f7f0 3b 0a 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 ;. pBt->nPage
1f800 20 3d 20 69 4c 61 73 74 50 67 3b 0a 20 20 7d 0a = iLastPg;. }.
1f810 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
1f820 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 OK;.}../*.** The
1f830 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 65 64 database opened
1f840 20 62 79 20 74 68 65 20 66 69 72 73 74 20 61 72 by the first ar
1f850 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 61 75 74 gument is an aut
1f860 6f 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 o-vacuum databas
1f870 65 0a 2a 2a 20 6e 4f 72 69 67 20 70 61 67 65 73 e.** nOrig pages
1f880 20 69 6e 20 73 69 7a 65 20 63 6f 6e 74 61 69 6e in size contain
1f890 69 6e 67 20 6e 46 72 65 65 20 66 72 65 65 20 70 ing nFree free p
1f8a0 61 67 65 73 2e 20 52 65 74 75 72 6e 20 74 68 65 ages. Return the
1f8b0 20 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 73 69 expected .** si
1f8c0 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
1f8d0 73 65 20 69 6e 20 70 61 67 65 73 20 66 6f 6c 6c se in pages foll
1f8e0 6f 77 69 6e 67 20 61 6e 20 61 75 74 6f 2d 76 61 owing an auto-va
1f8f0 63 75 75 6d 20 6f 70 65 72 61 74 69 6f 6e 2e 0a cuum operation..
1f900 2a 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f 20 66 */.static Pgno f
1f910 69 6e 61 6c 44 62 53 69 7a 65 28 42 74 53 68 61 inalDbSize(BtSha
1f920 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6e red *pBt, Pgno n
1f930 4f 72 69 67 2c 20 50 67 6e 6f 20 6e 46 72 65 65 Orig, Pgno nFree
1f940 29 7b 0a 20 20 69 6e 74 20 6e 45 6e 74 72 79 3b ){. int nEntry;
1f950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f960 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1f970 66 20 65 6e 74 72 69 65 73 20 6f 6e 20 6f 6e 65 f entries on one
1f980 20 70 74 72 6d 61 70 20 70 61 67 65 20 2a 2f 0a ptrmap page */.
1f990 20 20 50 67 6e 6f 20 6e 50 74 72 6d 61 70 3b 20 Pgno nPtrmap;
1f9a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f9b0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 50 /* Number of P
1f9c0 74 72 4d 61 70 20 70 61 67 65 73 20 74 6f 20 62 trMap pages to b
1f9d0 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 50 67 6e e freed */. Pgn
1f9e0 6f 20 6e 46 69 6e 3b 20 20 20 20 20 20 20 20 20 o nFin;
1f9f0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1fa00 52 65 74 75 72 6e 20 76 61 6c 75 65 20 2a 2f 0a Return value */.
1fa10 0a 20 20 6e 45 6e 74 72 79 20 3d 20 70 42 74 2d . nEntry = pBt-
1fa20 3e 75 73 61 62 6c 65 53 69 7a 65 2f 35 3b 0a 20 >usableSize/5;.
1fa30 20 6e 50 74 72 6d 61 70 20 3d 20 28 6e 46 72 65 nPtrmap = (nFre
1fa40 65 2d 6e 4f 72 69 67 2b 50 54 52 4d 41 50 5f 50 e-nOrig+PTRMAP_P
1fa50 41 47 45 4e 4f 28 70 42 74 2c 20 6e 4f 72 69 67 AGENO(pBt, nOrig
1fa60 29 2b 6e 45 6e 74 72 79 29 2f 6e 45 6e 74 72 79 )+nEntry)/nEntry
1fa70 3b 0a 20 20 6e 46 69 6e 20 3d 20 6e 4f 72 69 67 ;. nFin = nOrig
1fa80 20 2d 20 6e 46 72 65 65 20 2d 20 6e 50 74 72 6d - nFree - nPtrm
1fa90 61 70 3b 0a 20 20 69 66 28 20 6e 4f 72 69 67 3e ap;. if( nOrig>
1faa0 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
1fab0 45 28 70 42 74 29 20 26 26 20 6e 46 69 6e 3c 50 E(pBt) && nFin<P
1fac0 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
1fad0 28 70 42 74 29 20 29 7b 0a 20 20 20 20 6e 46 69 (pBt) ){. nFi
1fae0 6e 2d 2d 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65 n--;. }. while
1faf0 28 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 ( PTRMAP_ISPAGE(
1fb00 70 42 74 2c 20 6e 46 69 6e 29 20 7c 7c 20 6e 46 pBt, nFin) || nF
1fb10 69 6e 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 in==PENDING_BYTE
1fb20 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 _PAGE(pBt) ){.
1fb30 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 0a 20 nFin--;. }..
1fb40 20 72 65 74 75 72 6e 20 6e 46 69 6e 3b 0a 7d 0a return nFin;.}.
1fb50 0a 2f 2a 0a 2a 2a 20 41 20 77 72 69 74 65 2d 74 ./*.** A write-t
1fb60 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20 ransaction must
1fb70 62 65 20 6f 70 65 6e 65 64 20 62 65 66 6f 72 65 be opened before
1fb80 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 calling this fu
1fb90 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 49 74 20 70 65 nction..** It pe
1fba0 72 66 6f 72 6d 73 20 61 20 73 69 6e 67 6c 65 20 rforms a single
1fbb0 75 6e 69 74 20 6f 66 20 77 6f 72 6b 20 74 6f 77 unit of work tow
1fbc0 61 72 64 73 20 61 6e 20 69 6e 63 72 65 6d 65 6e ards an incremen
1fbd0 74 61 6c 20 76 61 63 75 75 6d 2e 0a 2a 2a 0a 2a tal vacuum..**.*
1fbe0 2a 20 49 66 20 74 68 65 20 69 6e 63 72 65 6d 65 * If the increme
1fbf0 6e 74 61 6c 20 76 61 63 75 75 6d 20 69 73 20 66 ntal vacuum is f
1fc00 69 6e 69 73 68 65 64 20 61 66 74 65 72 20 74 68 inished after th
1fc10 69 73 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 is function has
1fc20 72 75 6e 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 44 run,.** SQLITE_D
1fc30 4f 4e 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e ONE is returned.
1fc40 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 66 69 If it is not fi
1fc50 6e 69 73 68 65 64 2c 20 62 75 74 20 6e 6f 20 65 nished, but no e
1fc60 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2c 0a 2a rror occurred,.*
1fc70 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 * SQLITE_OK is r
1fc80 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 eturned. Otherwi
1fc90 73 65 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 se an SQLite err
1fca0 6f 72 20 63 6f 64 65 2e 20 0a 2a 2f 0a 69 6e 74 or code. .*/.int
1fcb0 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 6e 63 sqlite3BtreeInc
1fcc0 72 56 61 63 75 75 6d 28 42 74 72 65 65 20 2a 70 rVacuum(Btree *p
1fcd0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 ){. int rc;. B
1fce0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
1fcf0 2d 3e 70 42 74 3b 0a 0a 20 20 73 71 6c 69 74 65 ->pBt;.. sqlite
1fd00 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
1fd10 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 assert( pBt->i
1fd20 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 nTransaction==TR
1fd30 41 4e 53 5f 57 52 49 54 45 20 26 26 20 70 2d 3e ANS_WRITE && p->
1fd40 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 inTrans==TRANS_W
1fd50 52 49 54 45 20 29 3b 0a 20 20 69 66 28 20 21 70 RITE );. if( !p
1fd60 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 Bt->autoVacuum )
1fd70 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
1fd80 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65 7b E_DONE;. }else{
1fd90 0a 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 20 . Pgno nOrig
1fda0 3d 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 = btreePagecount
1fdb0 28 70 42 74 29 3b 0a 20 20 20 20 50 67 6e 6f 20 (pBt);. Pgno
1fdc0 6e 46 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 nFree = get4byte
1fdd0 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
1fde0 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 50 Data[36]);. P
1fdf0 67 6e 6f 20 6e 46 69 6e 20 3d 20 66 69 6e 61 6c gno nFin = final
1fe00 44 62 53 69 7a 65 28 70 42 74 2c 20 6e 4f 72 69 DbSize(pBt, nOri
1fe10 67 2c 20 6e 46 72 65 65 29 3b 0a 0a 20 20 20 20 g, nFree);..
1fe20 69 66 28 20 6e 4f 72 69 67 3c 6e 46 69 6e 20 29 if( nOrig<nFin )
1fe30 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
1fe40 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
1fe50 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
1fe60 6e 46 72 65 65 3e 30 20 29 7b 0a 20 20 20 20 20 nFree>0 ){.
1fe70 20 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 rc = saveAllCur
1fe80 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b sors(pBt, 0, 0);
1fe90 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 . if( rc==S
1fea0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1feb0 20 20 20 20 69 6e 76 61 6c 69 64 61 74 65 41 6c invalidateAl
1fec0 6c 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 lOverflowCache(p
1fed0 42 74 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 Bt);. rc
1fee0 3d 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 = incrVacuumStep
1fef0 28 70 42 74 2c 20 6e 46 69 6e 2c 20 6e 4f 72 69 (pBt, nFin, nOri
1ff00 67 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 g, 0);. }.
1ff10 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1ff20 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1ff30 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1ff40 67 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 gerWrite(pBt->pP
1ff50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a age1->pDbPage);.
1ff60 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 put4byte
1ff70 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
1ff80 44 61 74 61 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e Data[28], pBt->n
1ff90 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 Page);. }.
1ffa0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1ffb0 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
1ffc0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 ;. }. }. sq
1ffd0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
1ffe0 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
1fff0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 .}../*.** This r
20000 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
20010 20 70 72 69 6f 72 20 74 6f 20 73 71 6c 69 74 65 prior to sqlite
20020 33 50 61 67 65 72 43 6f 6d 6d 69 74 20 77 68 65 3PagerCommit whe
20030 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a n a transaction.
20040 2a 2a 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 ** is committed
20050 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 for an auto-vacu
20060 75 6d 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a um database..**.
20070 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 4f 4b 20 ** If SQLITE_OK
20080 69 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 is returned, the
20090 6e 20 2a 70 6e 54 72 75 6e 63 20 69 73 20 73 65 n *pnTrunc is se
200a0 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 t to the number
200b0 6f 66 20 70 61 67 65 73 0a 2a 2a 20 74 68 65 20 of pages.** the
200c0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 73 68 database file sh
200d0 6f 75 6c 64 20 62 65 20 74 72 75 6e 63 61 74 65 ould be truncate
200e0 64 20 74 6f 20 64 75 72 69 6e 67 20 74 68 65 20 d to during the
200f0 63 6f 6d 6d 69 74 20 70 72 6f 63 65 73 73 2e 20 commit process.
20100 0a 2a 2a 20 69 2e 65 2e 20 74 68 65 20 64 61 74 .** i.e. the dat
20110 61 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 72 abase has been r
20120 65 6f 72 67 61 6e 69 7a 65 64 20 73 6f 20 74 68 eorganized so th
20130 61 74 20 6f 6e 6c 79 20 74 68 65 20 66 69 72 73 at only the firs
20140 74 20 2a 70 6e 54 72 75 6e 63 0a 2a 2a 20 70 61 t *pnTrunc.** pa
20150 67 65 73 20 61 72 65 20 69 6e 20 75 73 65 2e 0a ges are in use..
20160 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 75 */.static int au
20170 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 42 toVacuumCommit(B
20180 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
20190 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
201a0 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 _OK;. Pager *pP
201b0 61 67 65 72 20 3d 20 70 42 74 2d 3e 70 50 61 67 ager = pBt->pPag
201c0 65 72 3b 0a 20 20 56 56 41 5f 4f 4e 4c 59 28 20 er;. VVA_ONLY(
201d0 69 6e 74 20 6e 52 65 66 20 3d 20 73 71 6c 69 74 int nRef = sqlit
201e0 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 e3PagerRefcount(
201f0 70 50 61 67 65 72 29 3b 20 29 0a 0a 20 20 61 73 pPager); ).. as
20200 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
20210 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
20220 74 65 78 29 20 29 3b 0a 20 20 69 6e 76 61 6c 69 tex) );. invali
20230 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 dateAllOverflowC
20240 61 63 68 65 28 70 42 74 29 3b 0a 20 20 61 73 73 ache(pBt);. ass
20250 65 72 74 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 ert(pBt->autoVac
20260 75 75 6d 29 3b 0a 20 20 69 66 28 20 21 70 42 74 uum);. if( !pBt
20270 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 29 7b 0a ->incrVacuum ){.
20280 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 Pgno nFin;
20290 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
202a0 20 6f 66 20 70 61 67 65 73 20 69 6e 20 64 61 74 of pages in dat
202b0 61 62 61 73 65 20 61 66 74 65 72 20 61 75 74 6f abase after auto
202c0 76 61 63 75 75 6d 69 6e 67 20 2a 2f 0a 20 20 20 vacuuming */.
202d0 20 50 67 6e 6f 20 6e 46 72 65 65 3b 20 20 20 20 Pgno nFree;
202e0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
202f0 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 pages on the fr
20300 65 65 6c 69 73 74 20 69 6e 69 74 69 61 6c 6c 79 eelist initially
20310 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 69 46 72 */. Pgno iFr
20320 65 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ee; /* Th
20330 65 20 6e 65 78 74 20 70 61 67 65 20 74 6f 20 62 e next page to b
20340 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 50 e freed */. P
20350 67 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 20 20 20 gno nOrig;
20360 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 73 69 /* Database si
20370 7a 65 20 62 65 66 6f 72 65 20 66 72 65 65 69 6e ze before freein
20380 67 20 2a 2f 0a 0a 20 20 20 20 6e 4f 72 69 67 20 g */.. nOrig
20390 3d 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 = btreePagecount
203a0 28 70 42 74 29 3b 0a 20 20 20 20 69 66 28 20 50 (pBt);. if( P
203b0 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
203c0 2c 20 6e 4f 72 69 67 29 20 7c 7c 20 6e 4f 72 69 , nOrig) || nOri
203d0 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f g==PENDING_BYTE_
203e0 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
203f0 20 20 20 2f 2a 20 49 74 20 69 73 20 6e 6f 74 20 /* It is not
20400 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 72 65 61 possible to crea
20410 74 65 20 61 20 64 61 74 61 62 61 73 65 20 66 6f te a database fo
20420 72 20 77 68 69 63 68 20 74 68 65 20 66 69 6e 61 r which the fina
20430 6c 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 l page. **
20440 69 73 20 65 69 74 68 65 72 20 61 20 70 6f 69 6e is either a poin
20450 74 65 72 2d 6d 61 70 20 70 61 67 65 20 6f 72 20 ter-map page or
20460 74 68 65 20 70 65 6e 64 69 6e 67 2d 62 79 74 65 the pending-byte
20470 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 0a 20 20 page. If one.
20480 20 20 20 20 2a 2a 20 69 73 20 65 6e 63 6f 75 6e ** is encoun
20490 74 65 72 65 64 2c 20 74 68 69 73 20 69 6e 64 69 tered, this indi
204a0 63 61 74 65 73 20 63 6f 72 72 75 70 74 69 6f 6e cates corruption
204b0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
204c0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
204d0 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
204e0 20 7d 0a 0a 20 20 20 20 6e 46 72 65 65 20 3d 20 }.. nFree =
204f0 67 65 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 get4byte(&pBt->p
20500 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d Page1->aData[36]
20510 29 3b 0a 20 20 20 20 6e 46 69 6e 20 3d 20 66 69 );. nFin = fi
20520 6e 61 6c 44 62 53 69 7a 65 28 70 42 74 2c 20 6e nalDbSize(pBt, n
20530 4f 72 69 67 2c 20 6e 46 72 65 65 29 3b 0a 20 20 Orig, nFree);.
20540 20 20 69 66 28 20 6e 46 69 6e 3e 6e 4f 72 69 67 if( nFin>nOrig
20550 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
20560 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
20570 20 20 20 69 66 28 20 6e 46 69 6e 3c 6e 4f 72 69 if( nFin<nOri
20580 67 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 g ){. rc =
20590 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 saveAllCursors(p
205a0 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d Bt, 0, 0);. }
205b0 0a 20 20 20 20 66 6f 72 28 69 46 72 65 65 3d 6e . for(iFree=n
205c0 4f 72 69 67 3b 20 69 46 72 65 65 3e 6e 46 69 6e Orig; iFree>nFin
205d0 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f && rc==SQLITE_O
205e0 4b 3b 20 69 46 72 65 65 2d 2d 29 7b 0a 20 20 20 K; iFree--){.
205f0 20 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 75 rc = incrVacu
20600 75 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 6e umStep(pBt, nFin
20610 2c 20 69 46 72 65 65 2c 20 31 29 3b 0a 20 20 20 , iFree, 1);.
20620 20 7d 0a 20 20 20 20 69 66 28 20 28 72 63 3d 3d }. if( (rc==
20630 53 51 4c 49 54 45 5f 44 4f 4e 45 20 7c 7c 20 72 SQLITE_DONE || r
20640 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 26 26 c==SQLITE_OK) &&
20650 20 6e 46 72 65 65 3e 30 20 29 7b 0a 20 20 20 20 nFree>0 ){.
20660 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
20670 67 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 gerWrite(pBt->pP
20680 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a age1->pDbPage);.
20690 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 put4byte(&
206a0 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 pBt->pPage1->aDa
206b0 74 61 5b 33 32 5d 2c 20 30 29 3b 0a 20 20 20 20 ta[32], 0);.
206c0 20 20 70 75 74 34 62 79 74 65 28 26 70 42 74 2d put4byte(&pBt-
206d0 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 >pPage1->aData[3
206e0 36 5d 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 75 6], 0);. pu
206f0 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 t4byte(&pBt->pPa
20700 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 ge1->aData[28],
20710 6e 46 69 6e 29 3b 0a 20 20 20 20 20 20 70 42 74 nFin);. pBt
20720 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 ->bDoTruncate =
20730 31 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 1;. pBt->nP
20740 61 67 65 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 age = nFin;.
20750 7d 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 }. if( rc!=SQ
20760 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
20770 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c sqlite3PagerRol
20780 6c 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 lback(pPager);.
20790 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 73 65 }. }.. asse
207a0 72 74 28 20 6e 52 65 66 3e 3d 73 71 6c 69 74 65 rt( nRef>=sqlite
207b0 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 70 3PagerRefcount(p
207c0 50 61 67 65 72 29 20 29 3b 0a 20 20 72 65 74 75 Pager) );. retu
207d0 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6c 73 65 20 rn rc;.}..#else
207e0 2f 2a 20 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /* ifndef SQLITE
207f0 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
20800 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 73 65 74 */.# define set
20810 43 68 69 6c 64 50 74 72 6d 61 70 73 28 78 29 20 ChildPtrmaps(x)
20820 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 66 SQLITE_OK.#endif
20830 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
20840 74 69 6e 65 20 64 6f 65 73 20 74 68 65 20 66 69 tine does the fi
20850 72 73 74 20 70 68 61 73 65 20 6f 66 20 61 20 74 rst phase of a t
20860 77 6f 2d 70 68 61 73 65 20 63 6f 6d 6d 69 74 2e wo-phase commit.
20870 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a This routine.*
20880 2a 20 63 61 75 73 65 73 20 61 20 72 6f 6c 6c 62 * causes a rollb
20890 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 74 6f 20 62 ack journal to b
208a0 65 20 63 72 65 61 74 65 64 20 28 69 66 20 69 74 e created (if it
208b0 20 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65 61 64 does not alread
208c0 79 20 65 78 69 73 74 29 0a 2a 2a 20 61 6e 64 20 y exist).** and
208d0 70 6f 70 75 6c 61 74 65 64 20 77 69 74 68 20 65 populated with e
208e0 6e 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 69 6f nough informatio
208f0 6e 20 73 6f 20 74 68 61 74 20 69 66 20 61 20 70 n so that if a p
20900 6f 77 65 72 20 6c 6f 73 73 20 6f 63 63 75 72 73 ower loss occurs
20910 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
20920 20 63 61 6e 20 62 65 20 72 65 73 74 6f 72 65 64 can be restored
20930 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c to its original
20940 20 73 74 61 74 65 20 62 79 20 70 6c 61 79 69 6e state by playin
20950 67 20 62 61 63 6b 0a 2a 2a 20 74 68 65 20 6a 6f g back.** the jo
20960 75 72 6e 61 6c 2e 20 20 54 68 65 6e 20 74 68 65 urnal. Then the
20970 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
20980 20 6a 6f 75 72 6e 61 6c 20 61 72 65 20 66 6c 75 journal are flu
20990 73 68 65 64 20 6f 75 74 20 74 6f 0a 2a 2a 20 74 shed out to.** t
209a0 68 65 20 64 69 73 6b 2e 20 20 41 66 74 65 72 20 he disk. After
209b0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 the journal is s
209c0 61 66 65 6c 79 20 6f 6e 20 6f 78 69 64 65 2c 20 afely on oxide,
209d0 74 68 65 20 63 68 61 6e 67 65 73 20 74 6f 20 74 the changes to t
209e0 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 61 he.** database a
209f0 72 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 re written into
20a00 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
20a10 65 20 61 6e 64 20 66 6c 75 73 68 65 64 20 74 6f e and flushed to
20a20 20 6f 78 69 64 65 2e 0a 2a 2a 20 41 74 20 74 68 oxide..** At th
20a30 65 20 65 6e 64 20 6f 66 20 74 68 69 73 20 63 61 e end of this ca
20a40 6c 6c 2c 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b ll, the rollback
20a50 20 6a 6f 75 72 6e 61 6c 20 73 74 69 6c 6c 20 65 journal still e
20a60 78 69 73 74 73 20 6f 6e 20 74 68 65 0a 2a 2a 20 xists on the.**
20a70 64 69 73 6b 20 61 6e 64 20 77 65 20 61 72 65 20 disk and we are
20a80 73 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 20 61 6c still holding al
20a90 6c 20 6c 6f 63 6b 73 2c 20 73 6f 20 74 68 65 20 l locks, so the
20aa0 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 transaction has
20ab0 6e 6f 74 0a 2a 2a 20 63 6f 6d 6d 69 74 74 65 64 not.** committed
20ac0 2e 20 20 53 65 65 20 73 71 6c 69 74 65 33 42 74 . See sqlite3Bt
20ad0 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 reeCommitPhaseTw
20ae0 6f 28 29 20 66 6f 72 20 74 68 65 20 73 65 63 6f o() for the seco
20af0 6e 64 20 70 68 61 73 65 20 6f 66 20 74 68 65 0a nd phase of the.
20b00 2a 2a 20 63 6f 6d 6d 69 74 20 70 72 6f 63 65 73 ** commit proces
20b10 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 61 s..**.** This ca
20b20 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 ll is a no-op if
20b30 20 6e 6f 20 77 72 69 74 65 2d 74 72 61 6e 73 61 no write-transa
20b40 63 74 69 6f 6e 20 69 73 20 63 75 72 72 65 6e 74 ction is current
20b50 6c 79 20 61 63 74 69 76 65 20 6f 6e 20 70 42 74 ly active on pBt
20b60 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 ..**.** Otherwis
20b70 65 2c 20 73 79 6e 63 20 74 68 65 20 64 61 74 61 e, sync the data
20b80 62 61 73 65 20 66 69 6c 65 20 66 6f 72 20 74 68 base file for th
20b90 65 20 62 74 72 65 65 20 70 42 74 2e 20 7a 4d 61 e btree pBt. zMa
20ba0 73 74 65 72 20 70 6f 69 6e 74 73 20 74 6f 0a 2a ster points to.*
20bb0 2a 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 * the name of a
20bc0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
20bd0 69 6c 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 ile that should
20be0 62 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 be written into
20bf0 74 68 65 0a 2a 2a 20 69 6e 64 69 76 69 64 75 61 the.** individua
20c00 6c 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 l journal file,
20c10 6f 72 20 69 73 20 4e 55 4c 4c 2c 20 69 6e 64 69 or is NULL, indi
20c20 63 61 74 69 6e 67 20 6e 6f 20 6d 61 73 74 65 72 cating no master
20c30 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 0a 2a journal file .*
20c40 2a 20 28 73 69 6e 67 6c 65 20 64 61 74 61 62 61 * (single databa
20c50 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e se transaction).
20c60 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 .**.** When this
20c70 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 is called, the
20c80 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 73 master journal s
20c90 68 6f 75 6c 64 20 61 6c 72 65 61 64 79 20 68 61 hould already ha
20ca0 76 65 20 62 65 65 6e 0a 2a 2a 20 63 72 65 61 74 ve been.** creat
20cb0 65 64 2c 20 70 6f 70 75 6c 61 74 65 64 20 77 69 ed, populated wi
20cc0 74 68 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c 20 th this journal
20cd0 70 6f 69 6e 74 65 72 20 61 6e 64 20 73 79 6e 63 pointer and sync
20ce0 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a 2a ed to disk..**.*
20cf0 2a 20 4f 6e 63 65 20 74 68 69 73 20 69 73 20 72 * Once this is r
20d00 6f 75 74 69 6e 65 20 68 61 73 20 72 65 74 75 72 outine has retur
20d10 6e 65 64 2c 20 74 68 65 20 6f 6e 6c 79 20 74 68 ned, the only th
20d20 69 6e 67 20 72 65 71 75 69 72 65 64 20 74 6f 20 ing required to
20d30 63 6f 6d 6d 69 74 0a 2a 2a 20 74 68 65 20 77 72 commit.** the wr
20d40 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
20d50 66 6f 72 20 74 68 69 73 20 64 61 74 61 62 61 73 for this databas
20d60 65 20 66 69 6c 65 20 69 73 20 74 6f 20 64 65 6c e file is to del
20d70 65 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e ete the journal.
20d80 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
20d90 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f treeCommitPhaseO
20da0 6e 65 28 42 74 72 65 65 20 2a 70 2c 20 63 6f 6e ne(Btree *p, con
20db0 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 st char *zMaster
20dc0 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
20dd0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 LITE_OK;. if( p
20de0 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
20df0 5f 57 52 49 54 45 20 29 7b 0a 20 20 20 20 42 74 _WRITE ){. Bt
20e00 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
20e10 3e 70 42 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 >pBt;. sqlite
20e20 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
20e30 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
20e40 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
20e50 20 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f if( pBt->auto
20e60 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 20 Vacuum ){.
20e70 72 63 20 3d 20 61 75 74 6f 56 61 63 75 75 6d 43 rc = autoVacuumC
20e80 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20 ommit(pBt);.
20e90 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
20ea0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 _OK ){. s
20eb0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
20ec0 28 70 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 (p);. ret
20ed0 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a urn rc;. }.
20ee0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 42 }. if( pB
20ef0 74 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 29 t->bDoTruncate )
20f00 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
20f10 61 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67 agerTruncateImag
20f20 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 e(pBt->pPager, p
20f30 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 Bt->nPage);.
20f40 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 63 20 }.#endif. rc
20f50 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f = sqlite3PagerCo
20f60 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 42 74 mmitPhaseOne(pBt
20f70 2d 3e 70 50 61 67 65 72 2c 20 7a 4d 61 73 74 65 ->pPager, zMaste
20f80 72 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 r, 0);. sqlit
20f90 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
20fa0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
20fb0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ;.}../*.** This
20fc0 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c function is call
20fd0 65 64 20 66 72 6f 6d 20 62 6f 74 68 20 42 74 72 ed from both Btr
20fe0 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f eeCommitPhaseTwo
20ff0 28 29 20 61 6e 64 20 42 74 72 65 65 52 6f 6c 6c () and BtreeRoll
21000 62 61 63 6b 28 29 0a 2a 2a 20 61 74 20 74 68 65 back().** at the
21010 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 61 conclusion of a
21020 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f transaction..*/
21030 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 .static void btr
21040 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e eeEndTransaction
21050 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 (Btree *p){. Bt
21060 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
21070 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 65 33 20 >pBt;. sqlite3
21080 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 61 *db = p->db;. a
21090 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 ssert( sqlite3Bt
210a0 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 reeHoldsMutex(p)
210b0 20 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c );..#ifndef SQL
210c0 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
210d0 55 55 4d 0a 20 20 70 42 74 2d 3e 62 44 6f 54 72 UUM. pBt->bDoTr
210e0 75 6e 63 61 74 65 20 3d 20 30 3b 0a 23 65 6e 64 uncate = 0;.#end
210f0 69 66 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 if. if( p->inTr
21100 61 6e 73 3e 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 ans>TRANS_NONE &
21110 26 20 64 62 2d 3e 6e 56 64 62 65 52 65 61 64 3e & db->nVdbeRead>
21120 31 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 1 ){. /* If t
21130 68 65 72 65 20 61 72 65 20 6f 74 68 65 72 20 61 here are other a
21140 63 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 ctive statements
21150 20 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 that belong to
21160 74 68 69 73 20 64 61 74 61 62 61 73 65 0a 20 20 this database.
21170 20 20 2a 2a 20 68 61 6e 64 6c 65 2c 20 64 6f 77 ** handle, dow
21180 6e 67 72 61 64 65 20 74 6f 20 61 20 72 65 61 64 ngrade to a read
21190 2d 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f -only transactio
211a0 6e 2e 20 54 68 65 20 6f 74 68 65 72 20 73 74 61 n. The other sta
211b0 74 65 6d 65 6e 74 73 0a 20 20 20 20 2a 2a 20 6d tements. ** m
211c0 61 79 20 73 74 69 6c 6c 20 62 65 20 72 65 61 64 ay still be read
211d0 69 6e 67 20 66 72 6f 6d 20 74 68 65 20 64 61 74 ing from the dat
211e0 61 62 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 64 abase. */. d
211f0 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 61 72 65 owngradeAllShare
21200 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 dCacheTableLocks
21210 28 70 29 3b 0a 20 20 20 20 70 2d 3e 69 6e 54 72 (p);. p->inTr
21220 61 6e 73 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 ans = TRANS_READ
21230 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f ;. }else{. /
21240 2a 20 49 66 20 74 68 65 20 68 61 6e 64 6c 65 20 * If the handle
21250 68 61 64 20 61 6e 79 20 6b 69 6e 64 20 6f 66 20 had any kind of
21260 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e transaction open
21270 2c 20 64 65 63 72 65 6d 65 6e 74 20 74 68 65 20 , decrement the
21280 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 . ** transact
21290 69 6f 6e 20 63 6f 75 6e 74 20 6f 66 20 74 68 65 ion count of the
212a0 20 73 68 61 72 65 64 20 62 74 72 65 65 2e 20 49 shared btree. I
212b0 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f f the transactio
212c0 6e 20 63 6f 75 6e 74 20 0a 20 20 20 20 2a 2a 20 n count . **
212d0 72 65 61 63 68 65 73 20 30 2c 20 73 65 74 20 74 reaches 0, set t
212e0 68 65 20 73 68 61 72 65 64 20 73 74 61 74 65 20 he shared state
212f0 74 6f 20 54 52 41 4e 53 5f 4e 4f 4e 45 2e 20 54 to TRANS_NONE. T
21300 68 65 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 he unlockBtreeIf
21310 55 6e 75 73 65 64 28 29 0a 20 20 20 20 2a 2a 20 Unused(). **
21320 63 61 6c 6c 20 62 65 6c 6f 77 20 77 69 6c 6c 20 call below will
21330 75 6e 6c 6f 63 6b 20 74 68 65 20 70 61 67 65 72 unlock the pager
21340 2e 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d . */. if( p-
21350 3e 69 6e 54 72 61 6e 73 21 3d 54 52 41 4e 53 5f >inTrans!=TRANS_
21360 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 63 6c NONE ){. cl
21370 65 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 earAllSharedCach
21380 65 54 61 62 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a eTableLocks(p);.
21390 20 20 20 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e pBt->nTran
213a0 73 61 63 74 69 6f 6e 2d 2d 3b 0a 20 20 20 20 20 saction--;.
213b0 20 69 66 28 20 30 3d 3d 70 42 74 2d 3e 6e 54 72 if( 0==pBt->nTr
213c0 61 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 ansaction ){.
213d0 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e pBt->inTran
213e0 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f saction = TRANS_
213f0 4e 4f 4e 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 NONE;. }.
21400 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 }.. /* Set
21410 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e the current tran
21420 73 61 63 74 69 6f 6e 20 73 74 61 74 65 20 74 6f saction state to
21430 20 54 52 41 4e 53 5f 4e 4f 4e 45 20 61 6e 64 20 TRANS_NONE and
21440 75 6e 6c 6f 63 6b 20 74 68 65 20 0a 20 20 20 20 unlock the .
21450 2a 2a 20 70 61 67 65 72 20 69 66 20 74 68 69 73 ** pager if this
21460 20 63 61 6c 6c 20 63 6c 6f 73 65 64 20 74 68 65 call closed the
21470 20 6f 6e 6c 79 20 72 65 61 64 20 6f 72 20 77 72 only read or wr
21480 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ite transaction.
21490 20 20 2a 2f 0a 20 20 20 20 70 2d 3e 69 6e 54 72 */. p->inTr
214a0 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 ans = TRANS_NONE
214b0 3b 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 ;. unlockBtre
214c0 65 49 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a eIfUnused(pBt);.
214d0 20 20 7d 0a 0a 20 20 62 74 72 65 65 49 6e 74 65 }.. btreeInte
214e0 67 72 69 74 79 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a grity(p);.}../*.
214f0 2a 2a 20 43 6f 6d 6d 69 74 20 74 68 65 20 74 72 ** Commit the tr
21500 61 6e 73 61 63 74 69 6f 6e 20 63 75 72 72 65 6e ansaction curren
21510 74 6c 79 20 69 6e 20 70 72 6f 67 72 65 73 73 2e tly in progress.
21520 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
21530 69 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 ine implements t
21540 68 65 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 he second phase
21550 6f 66 20 61 20 32 2d 70 68 61 73 65 20 63 6f 6d of a 2-phase com
21560 6d 69 74 2e 20 20 54 68 65 0a 2a 2a 20 73 71 6c mit. The.** sql
21570 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
21580 68 61 73 65 4f 6e 65 28 29 20 72 6f 75 74 69 6e haseOne() routin
21590 65 20 64 6f 65 73 20 74 68 65 20 66 69 72 73 74 e does the first
215a0 20 70 68 61 73 65 20 61 6e 64 20 73 68 6f 75 6c phase and shoul
215b0 64 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20 d.** be invoked
215c0 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 prior to calling
215d0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 this routine.
215e0 54 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 The sqlite3Btree
215f0 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 CommitPhaseOne()
21600 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64 69 64 20 .** routine did
21610 61 6c 6c 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 all the work of
21620 77 72 69 74 69 6e 67 20 69 6e 66 6f 72 6d 61 74 writing informat
21630 69 6f 6e 20 6f 75 74 20 74 6f 20 64 69 73 6b 20 ion out to disk
21640 61 6e 64 20 66 6c 75 73 68 69 6e 67 20 74 68 65 and flushing the
21650 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 20 73 6f 20 .** contents so
21660 74 68 61 74 20 74 68 65 79 20 61 72 65 20 77 72 that they are wr
21670 69 74 74 65 6e 20 6f 6e 74 6f 20 74 68 65 20 64 itten onto the d
21680 69 73 6b 20 70 6c 61 74 74 65 72 2e 20 20 41 6c isk platter. Al
21690 6c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e l this.** routin
216a0 65 20 68 61 73 20 74 6f 20 64 6f 20 69 73 20 64 e has to do is d
216b0 65 6c 65 74 65 20 6f 72 20 74 72 75 6e 63 61 74 elete or truncat
216c0 65 20 6f 72 20 7a 65 72 6f 20 74 68 65 20 68 65 e or zero the he
216d0 61 64 65 72 20 69 6e 20 74 68 65 0a 2a 2a 20 74 ader in the.** t
216e0 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 he rollback jour
216f0 6e 61 6c 20 28 77 68 69 63 68 20 63 61 75 73 65 nal (which cause
21700 73 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f s the transactio
21710 6e 20 74 6f 20 63 6f 6d 6d 69 74 29 20 61 6e 64 n to commit) and
21720 0a 2a 2a 20 64 72 6f 70 20 6c 6f 63 6b 73 2e 0a .** drop locks..
21730 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 **.** Normally,
21740 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 if an error occu
21750 72 73 20 77 68 69 6c 65 20 74 68 65 20 70 61 67 rs while the pag
21760 65 72 20 6c 61 79 65 72 20 69 73 20 61 74 74 65 er layer is atte
21770 6d 70 74 69 6e 67 20 74 6f 20 0a 2a 2a 20 66 69 mpting to .** fi
21780 6e 61 6c 69 7a 65 20 74 68 65 20 75 6e 64 65 72 nalize the under
21790 6c 79 69 6e 67 20 6a 6f 75 72 6e 61 6c 20 66 69 lying journal fi
217a0 6c 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f le, this functio
217b0 6e 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 n returns an err
217c0 6f 72 20 61 6e 64 0a 2a 2a 20 74 68 65 20 75 70 or and.** the up
217d0 70 65 72 20 6c 61 79 65 72 20 77 69 6c 6c 20 61 per layer will a
217e0 74 74 65 6d 70 74 20 61 20 72 6f 6c 6c 62 61 63 ttempt a rollbac
217f0 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 k. However, if t
21800 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
21810 6e 74 0a 2a 2a 20 69 73 20 6e 6f 6e 2d 7a 65 72 nt.** is non-zer
21820 6f 20 74 68 65 6e 20 74 68 69 73 20 62 2d 74 72 o then this b-tr
21830 65 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 ee transaction i
21840 73 20 70 61 72 74 20 6f 66 20 61 20 6d 75 6c 74 s part of a mult
21850 69 2d 66 69 6c 65 20 0a 2a 2a 20 74 72 61 6e 73 i-file .** trans
21860 61 63 74 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 action. In this
21870 63 61 73 65 2c 20 74 68 65 20 74 72 61 6e 73 61 case, the transa
21880 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 ction has alread
21890 79 20 62 65 65 6e 20 63 6f 6d 6d 69 74 74 65 64 y been committed
218a0 20 0a 2a 2a 20 28 62 79 20 64 65 6c 65 74 69 6e .** (by deletin
218b0 67 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e g a master journ
218c0 61 6c 20 66 69 6c 65 29 20 61 6e 64 20 74 68 65 al file) and the
218d0 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 69 67 6e caller will ign
218e0 6f 72 65 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e ore this .** fun
218f0 63 74 69 6f 6e 73 20 72 65 74 75 72 6e 20 63 6f ctions return co
21900 64 65 2e 20 53 6f 2c 20 65 76 65 6e 20 69 66 20 de. So, even if
21910 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 an error occurs
21920 69 6e 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 in the pager lay
21930 65 72 2c 0a 2a 2a 20 72 65 73 65 74 20 74 68 65 er,.** reset the
21940 20 62 2d 74 72 65 65 20 6f 62 6a 65 63 74 73 20 b-tree objects
21950 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 20 74 internal state t
21960 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 o indicate that
21970 74 68 65 20 77 72 69 74 65 0a 2a 2a 20 74 72 61 the write.** tra
21980 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 65 nsaction has bee
21990 6e 20 63 6c 6f 73 65 64 2e 20 54 68 69 73 20 69 n closed. This i
219a0 73 20 71 75 69 74 65 20 73 61 66 65 2c 20 61 73 s quite safe, as
219b0 20 74 68 65 20 70 61 67 65 72 20 77 69 6c 6c 20 the pager will
219c0 68 61 76 65 0a 2a 2a 20 74 72 61 6e 73 69 74 69 have.** transiti
219d0 6f 6e 65 64 20 74 6f 20 74 68 65 20 65 72 72 6f oned to the erro
219e0 72 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 54 r state..**.** T
219f0 68 69 73 20 77 69 6c 6c 20 72 65 6c 65 61 73 65 his will release
21a00 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 the write lock
21a10 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
21a20 66 69 6c 65 2e 20 20 49 66 20 74 68 65 72 65 0a file. If there.
21a30 2a 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 ** are no active
21a40 20 63 75 72 73 6f 72 73 2c 20 69 74 20 61 6c 73 cursors, it als
21a50 6f 20 72 65 6c 65 61 73 65 73 20 74 68 65 20 72 o releases the r
21a60 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a 69 6e 74 ead lock..*/.int
21a70 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d sqlite3BtreeCom
21a80 6d 69 74 50 68 61 73 65 54 77 6f 28 42 74 72 65 mitPhaseTwo(Btre
21a90 65 20 2a 70 2c 20 69 6e 74 20 62 43 6c 65 61 6e e *p, int bClean
21aa0 75 70 29 7b 0a 0a 20 20 69 66 28 20 70 2d 3e 69 up){.. if( p->i
21ab0 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 4e 4f nTrans==TRANS_NO
21ac0 4e 45 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 NE ) return SQLI
21ad0 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 TE_OK;. sqlite3
21ae0 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
21af0 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 btreeIntegrity(
21b00 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 p);.. /* If the
21b10 20 68 61 6e 64 6c 65 20 68 61 73 20 61 20 77 72 handle has a wr
21b20 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
21b30 6f 70 65 6e 2c 20 63 6f 6d 6d 69 74 20 74 68 65 open, commit the
21b40 20 73 68 61 72 65 64 2d 62 74 72 65 65 73 20 0a shared-btrees .
21b50 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e ** transaction
21b60 20 61 6e 64 20 73 65 74 20 74 68 65 20 73 68 61 and set the sha
21b70 72 65 64 20 73 74 61 74 65 20 74 6f 20 54 52 41 red state to TRA
21b80 4e 53 5f 52 45 41 44 2e 0a 20 20 2a 2f 0a 20 20 NS_READ.. */.
21b90 69 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d if( p->inTrans==
21ba0 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 TRANS_WRITE ){.
21bb0 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 42 int rc;. B
21bc0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
21bd0 2d 3e 70 42 74 3b 0a 20 20 20 20 61 73 73 65 72 ->pBt;. asser
21be0 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 t( pBt->inTransa
21bf0 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 ction==TRANS_WRI
21c00 54 45 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 TE );. assert
21c10 28 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 ( pBt->nTransact
21c20 69 6f 6e 3e 30 20 29 3b 0a 20 20 20 20 72 63 20 ion>0 );. rc
21c30 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f = sqlite3PagerCo
21c40 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70 42 74 mmitPhaseTwo(pBt
21c50 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 ->pPager);. i
21c60 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
21c70 20 26 26 20 62 43 6c 65 61 6e 75 70 3d 3d 30 20 && bCleanup==0
21c80 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
21c90 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
21ca0 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
21cb0 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 44 61 }. p->iDa
21cc0 74 61 56 65 72 73 69 6f 6e 2d 2d 3b 20 20 2f 2a taVersion--; /*
21cd0 20 43 6f 6d 70 65 6e 73 61 74 65 20 66 6f 72 20 Compensate for
21ce0 70 50 61 67 65 72 2d 3e 69 44 61 74 61 56 65 72 pPager->iDataVer
21cf0 73 69 6f 6e 2b 2b 3b 20 2a 2f 0a 20 20 20 20 70 sion++; */. p
21d00 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
21d10 6e 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b 0a n = TRANS_READ;.
21d20 20 20 20 20 62 74 72 65 65 43 6c 65 61 72 48 61 btreeClearHa
21d30 73 43 6f 6e 74 65 6e 74 28 70 42 74 29 3b 0a 20 sContent(pBt);.
21d40 20 7d 0a 0a 20 20 62 74 72 65 65 45 6e 64 54 72 }.. btreeEndTr
21d50 61 6e 73 61 63 74 69 6f 6e 28 70 29 3b 0a 20 20 ansaction(p);.
21d60 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
21d70 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 e(p);. return S
21d80 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
21d90 2a 2a 20 44 6f 20 62 6f 74 68 20 70 68 61 73 65 ** Do both phase
21da0 73 20 6f 66 20 61 20 63 6f 6d 6d 69 74 2e 0a 2a s of a commit..*
21db0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
21dc0 65 65 43 6f 6d 6d 69 74 28 42 74 72 65 65 20 2a eeCommit(Btree *
21dd0 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 p){. int rc;.
21de0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
21df0 72 28 70 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c r(p);. rc = sql
21e00 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 ite3BtreeCommitP
21e10 68 61 73 65 4f 6e 65 28 70 2c 20 30 29 3b 0a 20 haseOne(p, 0);.
21e20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
21e30 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 OK ){. rc = s
21e40 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 qlite3BtreeCommi
21e50 74 50 68 61 73 65 54 77 6f 28 70 2c 20 30 29 3b tPhaseTwo(p, 0);
21e60 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 . }. sqlite3Bt
21e70 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
21e80 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
21e90 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
21ea0 73 65 74 73 20 74 68 65 20 73 74 61 74 65 20 74 sets the state t
21eb0 6f 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 61 o CURSOR_FAULT a
21ec0 6e 64 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a 20 nd the error.**
21ed0 63 6f 64 65 20 74 6f 20 65 72 72 43 6f 64 65 20 code to errCode
21ee0 66 6f 72 20 65 76 65 72 79 20 63 75 72 73 6f 72 for every cursor
21ef0 20 6f 6e 20 61 6e 79 20 42 74 53 68 61 72 65 64 on any BtShared
21f00 20 74 68 61 74 20 70 42 74 72 65 65 0a 2a 2a 20 that pBtree.**
21f10 72 65 66 65 72 65 6e 63 65 73 2e 20 20 4f 72 20 references. Or
21f20 69 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c 79 if the writeOnly
21f30 20 66 6c 61 67 20 69 73 20 73 65 74 20 74 6f 20 flag is set to
21f40 31 2c 20 74 68 65 6e 20 6f 6e 6c 79 0a 2a 2a 20 1, then only.**
21f50 74 72 69 70 20 77 72 69 74 65 20 63 75 72 73 6f trip write curso
21f60 72 73 20 61 6e 64 20 6c 65 61 76 65 20 72 65 61 rs and leave rea
21f70 64 20 63 75 72 73 6f 72 73 20 75 6e 63 68 61 6e d cursors unchan
21f80 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 45 76 65 72 79 ged..**.** Every
21f90 20 63 75 72 73 6f 72 20 69 73 20 61 20 63 61 6e cursor is a can
21fa0 64 69 64 61 74 65 20 74 6f 20 62 65 20 74 72 69 didate to be tri
21fb0 70 70 65 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 pped, including
21fc0 63 75 72 73 6f 72 73 0a 2a 2a 20 74 68 61 74 20 cursors.** that
21fd0 62 65 6c 6f 6e 67 20 74 6f 20 6f 74 68 65 72 20 belong to other
21fe0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
21ff0 69 6f 6e 73 20 74 68 61 74 20 68 61 70 70 65 6e ions that happen
22000 20 74 6f 20 62 65 0a 2a 2a 20 73 68 61 72 69 6e to be.** sharin
22010 67 20 74 68 65 20 63 61 63 68 65 20 77 69 74 68 g the cache with
22020 20 70 42 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 54 pBtree..**.** T
22030 68 69 73 20 72 6f 75 74 69 6e 65 20 67 65 74 73 his routine gets
22040 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 72 called when a r
22050 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 2e 20 ollback occurs.
22060 49 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c 79 If the writeOnly
22070 0a 2a 2a 20 66 6c 61 67 20 69 73 20 74 72 75 65 .** flag is true
22080 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 77 72 69 74 , then only writ
22090 65 2d 63 75 72 73 6f 72 73 20 6e 65 65 64 20 62 e-cursors need b
220a0 65 20 74 72 69 70 70 65 64 20 2d 20 72 65 61 64 e tripped - read
220b0 2d 6f 6e 6c 79 0a 2a 2a 20 63 75 72 73 6f 72 73 -only.** cursors
220c0 20 73 61 76 65 20 74 68 65 69 72 20 63 75 72 72 save their curr
220d0 65 6e 74 20 70 6f 73 69 74 69 6f 6e 73 20 73 6f ent positions so
220e0 20 74 68 61 74 20 74 68 65 79 20 6d 61 79 20 63 that they may c
220f0 6f 6e 74 69 6e 75 65 20 0a 2a 2a 20 66 6f 6c 6c ontinue .** foll
22100 6f 77 69 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 owing the rollba
22110 63 6b 2e 20 4f 72 2c 20 69 66 20 77 72 69 74 65 ck. Or, if write
22120 4f 6e 6c 79 20 69 73 20 66 61 6c 73 65 2c 20 61 Only is false, a
22130 6c 6c 20 63 75 72 73 6f 72 73 20 61 72 65 20 0a ll cursors are .
22140 2a 2a 20 74 72 69 70 70 65 64 2e 20 49 6e 20 67 ** tripped. In g
22150 65 6e 65 72 61 6c 2c 20 77 72 69 74 65 4f 6e 6c eneral, writeOnl
22160 79 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 68 y is false if th
22170 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 65 e transaction be
22180 69 6e 67 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 ing.** rolled ba
22190 63 6b 20 6d 6f 64 69 66 69 65 64 20 74 68 65 20 ck modified the
221a0 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e database schema.
221b0 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 62 2d In this case b-
221c0 74 72 65 65 20 72 6f 6f 74 0a 2a 2a 20 70 61 67 tree root.** pag
221d0 65 73 20 6d 61 79 20 62 65 20 6d 6f 76 65 64 20 es may be moved
221e0 6f 72 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 or deleted from
221f0 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6c 74 the database alt
22200 6f 67 65 74 68 65 72 2c 20 6d 61 6b 69 6e 67 0a ogether, making.
22210 2a 2a 20 69 74 20 75 6e 73 61 66 65 20 66 6f 72 ** it unsafe for
22220 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 74 6f read cursors to
22230 20 63 6f 6e 74 69 6e 75 65 2e 0a 2a 2a 0a 2a 2a continue..**.**
22240 20 49 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c If the writeOnl
22250 79 20 66 6c 61 67 20 69 73 20 74 72 75 65 20 61 y flag is true a
22260 6e 64 20 61 6e 20 65 72 72 6f 72 20 69 73 20 65 nd an error is e
22270 6e 63 6f 75 6e 74 65 72 65 64 20 77 68 69 6c 65 ncountered while
22280 20 0a 2a 2a 20 73 61 76 69 6e 67 20 74 68 65 20 .** saving the
22290 63 75 72 72 65 6e 74 20 70 6f 73 69 74 69 6f 6e current position
222a0 20 6f 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 of a read-only
222b0 63 75 72 73 6f 72 2c 20 61 6c 6c 20 63 75 72 73 cursor, all curs
222c0 6f 72 73 2c 20 0a 2a 2a 20 69 6e 63 6c 75 64 69 ors, .** includi
222d0 6e 67 20 61 6c 6c 20 72 65 61 64 2d 63 75 72 73 ng all read-curs
222e0 6f 72 73 20 61 72 65 20 74 72 69 70 70 65 64 2e ors are tripped.
222f0 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
22300 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
22310 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 69 successful, or i
22320 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
22330 73 20 77 68 69 6c 65 0a 2a 2a 20 73 61 76 69 6e s while.** savin
22340 67 20 61 20 63 75 72 73 6f 72 20 70 6f 73 69 74 g a cursor posit
22350 69 6f 6e 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 ion, an SQLite e
22360 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 69 6e rror code..*/.in
22370 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 54 72 t sqlite3BtreeTr
22380 69 70 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 72 ipAllCursors(Btr
22390 65 65 20 2a 70 42 74 72 65 65 2c 20 69 6e 74 20 ee *pBtree, int
223a0 65 72 72 43 6f 64 65 2c 20 69 6e 74 20 77 72 69 errCode, int wri
223b0 74 65 4f 6e 6c 79 29 7b 0a 20 20 42 74 43 75 72 teOnly){. BtCur
223c0 73 6f 72 20 2a 70 3b 0a 20 20 69 6e 74 20 72 63 sor *p;. int rc
223d0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 = SQLITE_OK;..
223e0 20 61 73 73 65 72 74 28 20 28 77 72 69 74 65 4f assert( (writeO
223f0 6e 6c 79 3d 3d 30 20 7c 7c 20 77 72 69 74 65 4f nly==0 || writeO
22400 6e 6c 79 3d 3d 31 29 20 26 26 20 42 54 43 46 5f nly==1) && BTCF_
22410 57 72 69 74 65 46 6c 61 67 3d 3d 31 20 29 3b 0a WriteFlag==1 );.
22420 20 20 69 66 28 20 70 42 74 72 65 65 20 29 7b 0a if( pBtree ){.
22430 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
22440 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 Enter(pBtree);.
22450 20 20 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d for(p=pBtree-
22460 3e 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 >pBt->pCursor; p
22470 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 ; p=p->pNext){.
22480 20 20 20 20 20 69 66 28 20 77 72 69 74 65 4f 6e if( writeOn
22490 6c 79 20 26 26 20 28 70 2d 3e 63 75 72 46 6c 61 ly && (p->curFla
224a0 67 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 gs & BTCF_WriteF
224b0 6c 61 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 lag)==0 ){.
224c0 20 20 20 69 66 28 20 70 2d 3e 65 53 74 61 74 65 if( p->eState
224d0 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c ==CURSOR_VALID |
224e0 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 | p->eState==CUR
224f0 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 7b 0a SOR_SKIPNEXT ){.
22500 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 rc = s
22510 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f aveCursorPositio
22520 6e 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 n(p);.
22530 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
22540 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 K ){.
22550 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 42 74 (void)sqlite3Bt
22560 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 reeTripAllCursor
22570 73 28 70 42 74 72 65 65 2c 20 72 63 2c 20 30 29 s(pBtree, rc, 0)
22580 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72 ;. br
22590 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d eak;. }
225a0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
225b0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
225c0 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 sqlite3BtreeClea
225d0 72 43 75 72 73 6f 72 28 70 29 3b 0a 20 20 20 20 rCursor(p);.
225e0 20 20 20 20 70 2d 3e 65 53 74 61 74 65 20 3d 20 p->eState =
225f0 43 55 52 53 4f 52 5f 46 41 55 4c 54 3b 0a 20 20 CURSOR_FAULT;.
22600 20 20 20 20 20 20 70 2d 3e 73 6b 69 70 4e 65 78 p->skipNex
22610 74 20 3d 20 65 72 72 43 6f 64 65 3b 0a 20 20 20 t = errCode;.
22620 20 20 20 7d 0a 20 20 20 20 20 20 62 74 72 65 65 }. btree
22630 52 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 ReleaseAllCursor
22640 50 61 67 65 73 28 70 29 3b 0a 20 20 20 20 7d 0a Pages(p);. }.
22650 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
22660 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a 20 Leave(pBtree);.
22670 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
22680 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 }../*.** Rollbac
22690 6b 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f k the transactio
226a0 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 0a 2a n in progress..*
226b0 2a 0a 2a 2a 20 49 66 20 74 72 69 70 43 6f 64 65 *.** If tripCode
226c0 20 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f 4f is not SQLITE_O
226d0 4b 20 74 68 65 6e 20 63 75 72 73 6f 72 73 20 77 K then cursors w
226e0 69 6c 6c 20 62 65 20 69 6e 76 61 6c 69 64 61 74 ill be invalidat
226f0 65 64 20 28 74 72 69 70 70 65 64 29 2e 0a 2a 2a ed (tripped)..**
22700 20 4f 6e 6c 79 20 77 72 69 74 65 20 63 75 72 73 Only write curs
22710 6f 72 73 20 61 72 65 20 74 72 69 70 70 65 64 20 ors are tripped
22720 69 66 20 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 if writeOnly is
22730 74 72 75 65 20 62 75 74 20 61 6c 6c 20 63 75 72 true but all cur
22740 73 6f 72 73 20 61 72 65 0a 2a 2a 20 74 72 69 70 sors are.** trip
22750 70 65 64 20 69 66 20 77 72 69 74 65 4f 6e 6c 79 ped if writeOnly
22760 20 69 73 20 66 61 6c 73 65 2e 20 20 41 6e 79 20 is false. Any
22770 61 74 74 65 6d 70 74 20 74 6f 20 75 73 65 0a 2a attempt to use.*
22780 2a 20 61 20 74 72 69 70 70 65 64 20 63 75 72 73 * a tripped curs
22790 6f 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 or will result i
227a0 6e 20 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a n an error..**.*
227b0 2a 20 54 68 69 73 20 77 69 6c 6c 20 72 65 6c 65 * This will rele
227c0 61 73 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f ase the write lo
227d0 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ck on the databa
227e0 73 65 20 66 69 6c 65 2e 20 20 49 66 20 74 68 65 se file. If the
227f0 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 61 63 74 re.** are no act
22800 69 76 65 20 63 75 72 73 6f 72 73 2c 20 69 74 20 ive cursors, it
22810 61 6c 73 6f 20 72 65 6c 65 61 73 65 73 20 74 68 also releases th
22820 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a e read lock..*/.
22830 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
22840 52 6f 6c 6c 62 61 63 6b 28 42 74 72 65 65 20 2a Rollback(Btree *
22850 70 2c 20 69 6e 74 20 74 72 69 70 43 6f 64 65 2c p, int tripCode,
22860 20 69 6e 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b int writeOnly){
22870 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 53 . int rc;. BtS
22880 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
22890 70 42 74 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a pBt;. MemPage *
228a0 70 50 61 67 65 31 3b 0a 0a 20 20 61 73 73 65 72 pPage1;.. asser
228b0 74 28 20 77 72 69 74 65 4f 6e 6c 79 3d 3d 31 20 t( writeOnly==1
228c0 7c 7c 20 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 || writeOnly==0
228d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 74 72 69 );. assert( tri
228e0 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 41 42 pCode==SQLITE_AB
228f0 4f 52 54 5f 52 4f 4c 4c 42 41 43 4b 20 7c 7c 20 ORT_ROLLBACK ||
22900 74 72 69 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 tripCode==SQLITE
22910 5f 4f 4b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 _OK );. sqlite3
22920 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
22930 20 69 66 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 if( tripCode==S
22940 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
22950 72 63 20 3d 20 74 72 69 70 43 6f 64 65 20 3d 20 rc = tripCode =
22960 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 saveAllCursors(p
22970 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 69 Bt, 0, 0);. i
22980 66 28 20 72 63 20 29 20 77 72 69 74 65 4f 6e 6c f( rc ) writeOnl
22990 79 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a y = 0;. }else{.
229a0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
229b0 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 74 72 OK;. }. if( tr
229c0 69 70 43 6f 64 65 20 29 7b 0a 20 20 20 20 69 6e ipCode ){. in
229d0 74 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 42 t rc2 = sqlite3B
229e0 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f treeTripAllCurso
229f0 72 73 28 70 2c 20 74 72 69 70 43 6f 64 65 2c 20 rs(p, tripCode,
22a00 77 72 69 74 65 4f 6e 6c 79 29 3b 0a 20 20 20 20 writeOnly);.
22a10 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
22a20 54 45 5f 4f 4b 20 7c 7c 20 28 77 72 69 74 65 4f TE_OK || (writeO
22a30 6e 6c 79 3d 3d 30 20 26 26 20 72 63 32 3d 3d 53 nly==0 && rc2==S
22a40 51 4c 49 54 45 5f 4f 4b 29 20 29 3b 0a 20 20 20 QLITE_OK) );.
22a50 20 69 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 if( rc2!=SQLITE
22a60 5f 4f 4b 20 29 20 72 63 20 3d 20 72 63 32 3b 0a _OK ) rc = rc2;.
22a70 20 20 7d 0a 20 20 62 74 72 65 65 49 6e 74 65 67 }. btreeInteg
22a80 72 69 74 79 28 70 29 3b 0a 0a 20 20 69 66 28 20 rity(p);.. if(
22a90 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
22aa0 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 20 20 69 S_WRITE ){. i
22ab0 6e 74 20 72 63 32 3b 0a 0a 20 20 20 20 61 73 73 nt rc2;.. ass
22ac0 65 72 74 28 20 54 52 41 4e 53 5f 57 52 49 54 45 ert( TRANS_WRITE
22ad0 3d 3d 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 ==pBt->inTransac
22ae0 74 69 6f 6e 20 29 3b 0a 20 20 20 20 72 63 32 20 tion );. rc2
22af0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f = sqlite3PagerRo
22b00 6c 6c 62 61 63 6b 28 70 42 74 2d 3e 70 50 61 67 llback(pBt->pPag
22b10 65 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 32 er);. if( rc2
22b20 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
22b30 20 20 20 20 20 72 63 20 3d 20 72 63 32 3b 0a 20 rc = rc2;.
22b40 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 54 68 65 }.. /* The
22b50 20 72 6f 6c 6c 62 61 63 6b 20 6d 61 79 20 68 61 rollback may ha
22b60 76 65 20 64 65 73 74 72 6f 79 65 64 20 74 68 65 ve destroyed the
22b70 20 70 50 61 67 65 31 2d 3e 61 44 61 74 61 20 76 pPage1->aData v
22b80 61 6c 75 65 2e 20 20 53 6f 0a 20 20 20 20 2a 2a alue. So. **
22b90 20 63 61 6c 6c 20 62 74 72 65 65 47 65 74 50 61 call btreeGetPa
22ba0 67 65 28 29 20 6f 6e 20 70 61 67 65 20 31 20 61 ge() on page 1 a
22bb0 67 61 69 6e 20 74 6f 20 6d 61 6b 65 0a 20 20 20 gain to make.
22bc0 20 2a 2a 20 73 75 72 65 20 70 50 61 67 65 31 2d ** sure pPage1-
22bd0 3e 61 44 61 74 61 20 69 73 20 73 65 74 20 63 6f >aData is set co
22be0 72 72 65 63 74 6c 79 2e 20 2a 2f 0a 20 20 20 20 rrectly. */.
22bf0 69 66 28 20 62 74 72 65 65 47 65 74 50 61 67 65 if( btreeGetPage
22c00 28 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 31 (pBt, 1, &pPage1
22c10 2c 20 30 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 , 0)==SQLITE_OK
22c20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 50 61 ){. int nPa
22c30 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 ge = get4byte(28
22c40 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 +(u8*)pPage1->aD
22c50 61 74 61 29 3b 0a 20 20 20 20 20 20 74 65 73 74 ata);. test
22c60 63 61 73 65 28 20 6e 50 61 67 65 3d 3d 30 20 29 case( nPage==0 )
22c70 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 50 61 67 ;. if( nPag
22c80 65 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 50 61 e==0 ) sqlite3Pa
22c90 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 74 gerPagecount(pBt
22ca0 2d 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 ->pPager, &nPage
22cb0 29 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 );. testcas
22cc0 65 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 6e e( pBt->nPage!=n
22cd0 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 70 42 Page );. pB
22ce0 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 t->nPage = nPage
22cf0 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 ;. releaseP
22d00 61 67 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a ageOne(pPage1);.
22d10 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
22d20 28 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 ( countValidCurs
22d30 6f 72 73 28 70 42 74 2c 20 31 29 3d 3d 30 20 29 ors(pBt, 1)==0 )
22d40 3b 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 ;. pBt->inTra
22d50 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 nsaction = TRANS
22d60 5f 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 _READ;. btree
22d70 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 ClearHasContent(
22d80 70 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 pBt);. }.. btr
22d90 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e eeEndTransaction
22da0 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 (p);. sqlite3Bt
22db0 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 reeLeave(p);. r
22dc0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
22dd0 2a 2a 20 53 74 61 72 74 20 61 20 73 74 61 74 65 ** Start a state
22de0 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 ment subtransact
22df0 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 61 6e ion. The subtran
22e00 73 61 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 72 saction can be r
22e10 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 69 6e olled.** back in
22e20 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 dependently of t
22e30 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 he main transact
22e40 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 73 74 ion. You must st
22e50 61 72 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f art a transactio
22e60 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 74 61 n .** before sta
22e70 72 74 69 6e 67 20 61 20 73 75 62 74 72 61 6e 73 rting a subtrans
22e80 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 action. The subt
22e90 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 6e ransaction is en
22ea0 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ded automaticall
22eb0 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d 61 69 y .** if the mai
22ec0 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f n transaction co
22ed0 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 20 62 mmits or rolls b
22ee0 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 65 ack..**.** State
22ef0 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 ment subtransact
22f00 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 61 72 ions are used ar
22f10 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 61 6c 20 ound individual
22f20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a SQL statements.*
22f30 2a 20 74 68 61 74 20 61 72 65 20 63 6f 6e 74 61 * that are conta
22f40 69 6e 65 64 20 77 69 74 68 69 6e 20 61 20 42 45 ined within a BE
22f50 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 6c 6f GIN...COMMIT blo
22f60 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 74 72 ck. If a constr
22f70 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 aint.** error oc
22f80 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 curs within the
22f90 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 20 65 statement, the e
22fa0 66 66 65 63 74 20 6f 66 20 74 68 61 74 20 6f 6e ffect of that on
22fb0 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 63 e statement.** c
22fc0 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 an be rolled bac
22fd0 6b 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 k without having
22fe0 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 to rollback the
22ff0 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74 entire transact
23000 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 74 61 ion..**.** A sta
23010 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 6e 73 tement sub-trans
23020 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65 6d action is implem
23030 65 6e 74 65 64 20 61 73 20 61 6e 20 61 6e 6f 6e ented as an anon
23040 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 2e ymous savepoint.
23050 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 70 61 The.** value pa
23060 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f ssed as the seco
23070 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 nd parameter is
23080 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 the total number
23090 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 2c 0a of savepoints,.
230a0 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 ** including the
230b0 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 20 73 new anonymous s
230c0 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e 20 6f avepoint, open o
230d0 6e 20 74 68 65 20 42 2d 54 72 65 65 2e 20 69 2e n the B-Tree. i.
230e0 65 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 e. if there.** a
230f0 72 65 20 6e 6f 20 61 63 74 69 76 65 20 73 61 76 re no active sav
23100 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f 20 6f epoints and no o
23110 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 2d 74 ther statement-t
23120 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 65 6e ransactions open
23130 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e 74 20 ,.** iStatement
23140 69 73 20 31 2e 20 54 68 69 73 20 61 6e 6f 6e 79 is 1. This anony
23150 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 20 63 mous savepoint c
23160 61 6e 20 62 65 20 72 65 6c 65 61 73 65 64 20 6f an be released o
23170 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 2a 2a r rolled back.**
23180 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 using the sqlit
23190 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 e3BtreeSavepoint
231a0 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a () function..*/.
231b0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
231c0 42 65 67 69 6e 53 74 6d 74 28 42 74 72 65 65 20 BeginStmt(Btree
231d0 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 65 6d 65 *p, int iStateme
231e0 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 nt){. int rc;.
231f0 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d BtShared *pBt =
23200 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 p->pBt;. sqlit
23210 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
23220 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e . assert( p->in
23230 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 Trans==TRANS_WRI
23240 54 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 TE );. assert(
23250 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
23260 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d BTS_READ_ONLY)=
23270 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
23280 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 3b 0a iStatement>0 );.
23290 20 20 61 73 73 65 72 74 28 20 69 53 74 61 74 65 assert( iState
232a0 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 61 76 ment>p->db->nSav
232b0 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 73 65 epoint );. asse
232c0 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 rt( pBt->inTrans
232d0 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
232e0 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 20 74 ITE );. /* At t
232f0 68 65 20 70 61 67 65 72 20 6c 65 76 65 6c 2c 20 he pager level,
23300 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e a statement tran
23310 73 61 63 74 69 6f 6e 20 69 73 20 61 20 73 61 76 saction is a sav
23320 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 2a 2a epoint with. **
23330 20 61 6e 20 69 6e 64 65 78 20 67 72 65 61 74 65 an index greate
23340 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 65 70 r than all savep
23350 6f 69 6e 74 73 20 63 72 65 61 74 65 64 20 65 78 oints created ex
23360 70 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 0a 20 plicitly using.
23370 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e ** SQL statemen
23380 74 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 67 61 ts. It is illega
23390 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c 65 61 l to open, relea
233a0 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 61 se or rollback a
233b0 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 61 76 ny. ** such sav
233c0 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 74 68 epoints while th
233d0 65 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e e statement tran
233e0 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e saction savepoin
233f0 74 20 69 73 20 61 63 74 69 76 65 2e 0a 20 20 2a t is active.. *
23400 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 /. rc = sqlite3
23410 50 61 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 69 PagerOpenSavepoi
23420 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 nt(pBt->pPager,
23430 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 20 73 iStatement);. s
23440 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
23450 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
23460 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 ;.}../*.** The s
23470 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 econd argument t
23480 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c o this function,
23490 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 20 53 op, is always S
234a0 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
234b0 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f 49 4e K.** or SAVEPOIN
234c0 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 73 20 T_RELEASE. This
234d0 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 72 20 function either
234e0 72 65 6c 65 61 73 65 73 20 6f 72 20 72 6f 6c 6c releases or roll
234f0 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 73 61 s back the.** sa
23500 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 66 69 vepoint identifi
23510 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 ed by parameter
23520 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 70 65 iSavepoint, depe
23530 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c nding on the val
23540 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a 2a 2a ue .** of op..**
23550 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 53 .** Normally, iS
23560 61 76 65 70 6f 69 6e 74 20 69 73 20 67 72 65 61 avepoint is grea
23570 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 ter than or equa
23580 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 65 76 l to zero. Howev
23590 65 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a 2a 20 er, if op is.**
235a0 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 SAVEPOINT_ROLLBA
235b0 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 70 6f CK, then iSavepo
235c0 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 int may also be
235d0 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 -1. In this case
235e0 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 the .** content
235f0 73 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20 s of the entire
23600 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 20 transaction are
23610 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 69 rolled back. Thi
23620 73 20 69 73 20 64 69 66 66 65 72 65 6e 74 0a 2a s is different.*
23630 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 * from a normal
23640 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c transaction roll
23650 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f 63 6b back, as no lock
23660 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 20 61 s are released a
23670 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 nd the.** transa
23680 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 6f 70 ction remains op
23690 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 en..*/.int sqlit
236a0 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 e3BtreeSavepoint
236b0 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6f (Btree *p, int o
236c0 70 2c 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e p, int iSavepoin
236d0 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 t){. int rc = S
236e0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 QLITE_OK;. if(
236f0 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d p && p->inTrans=
23700 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a =TRANS_WRITE ){.
23710 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 BtShared *pB
23720 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 t = p->pBt;.
23730 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 56 45 assert( op==SAVE
23740 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 7c 7c POINT_RELEASE ||
23750 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 op==SAVEPOINT_R
23760 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 20 61 OLLBACK );. a
23770 73 73 65 72 74 28 20 69 53 61 76 65 70 6f 69 6e ssert( iSavepoin
23780 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 70 6f t>=0 || (iSavepo
23790 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d 3d 53 int==-1 && op==S
237a0 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
237b0 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 K) );. sqlite
237c0 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
237d0 20 20 20 20 69 66 28 20 6f 70 3d 3d 53 41 56 45 if( op==SAVE
237e0 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 20 29 POINT_ROLLBACK )
237f0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 {. rc = sav
23800 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c eAllCursors(pBt,
23810 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 0, 0);. }.
23820 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
23830 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 _OK ){. rc
23840 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 61 = sqlite3PagerSa
23850 76 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 vepoint(pBt->pPa
23860 67 65 72 2c 20 6f 70 2c 20 69 53 61 76 65 70 6f ger, op, iSavepo
23870 69 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 int);. }.
23880 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
23890 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 K ){. if( i
238a0 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 20 28 Savepoint<0 && (
238b0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
238c0 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d BTS_INITIALLY_EM
238d0 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 PTY)!=0 ){.
238e0 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 pBt->nPage =
238f0 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 0;. }.
23900 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 rc = newDatabas
23910 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 70 42 e(pBt);. pB
23920 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 34 62 t->nPage = get4b
23930 79 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 70 50 yte(28 + pBt->pP
23940 61 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a 0a 20 age1->aData);..
23950 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 /* The data
23960 62 61 73 65 20 73 69 7a 65 20 77 61 73 20 77 72 base size was wr
23970 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6f itten into the o
23980 66 66 73 65 74 20 32 38 20 6f 66 20 74 68 65 20 ffset 28 of the
23990 68 65 61 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 header. **
239a0 77 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 when the transac
239b0 74 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 73 6f tion started, so
239c0 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 we know that th
239d0 65 20 76 61 6c 75 65 20 61 74 20 6f 66 66 73 65 e value at offse
239e0 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 69 73 t. ** 28 is
239f0 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 20 20 nonzero. */.
23a00 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e assert( pBt->
23a10 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 20 7d nPage>0 );. }
23a20 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
23a30 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 eLeave(p);. }.
23a40 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
23a50 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 *.** Create a ne
23a60 77 20 63 75 72 73 6f 72 20 66 6f 72 20 74 68 65 w cursor for the
23a70 20 42 54 72 65 65 20 77 68 6f 73 65 20 72 6f 6f BTree whose roo
23a80 74 20 69 73 20 6f 6e 20 74 68 65 20 70 61 67 65 t is on the page
23a90 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 20 61 .** iTable. If a
23aa0 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 73 6f read-only curso
23ab0 72 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 r is requested,
23ac0 69 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 it is assumed th
23ad0 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 at.** the caller
23ae0 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 74 20 already has at
23af0 6c 65 61 73 74 20 61 20 72 65 61 64 2d 6f 6e 6c least a read-onl
23b00 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 y transaction op
23b10 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 61 74 en.** on the dat
23b20 61 62 61 73 65 20 61 6c 72 65 61 64 79 2e 20 49 abase already. I
23b30 66 20 61 20 77 72 69 74 65 2d 63 75 72 73 6f 72 f a write-cursor
23b40 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 is requested, t
23b50 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 hen.** the calle
23b60 72 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 r is assumed to
23b70 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 have an open wri
23b80 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a te transaction..
23b90 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 42 54 52 **.** If the BTR
23ba0 45 45 5f 57 52 43 53 52 20 62 69 74 20 6f 66 20 EE_WRCSR bit of
23bb0 77 72 46 6c 61 67 20 69 73 20 63 6c 65 61 72 2c wrFlag is clear,
23bc0 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
23bd0 20 63 61 6e 20 6f 6e 6c 79 0a 2a 2a 20 62 65 20 can only.** be
23be0 75 73 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 used for reading
23bf0 2e 20 20 49 66 20 74 68 65 20 42 54 52 45 45 5f . If the BTREE_
23c00 57 52 43 53 52 20 62 69 74 20 69 73 20 73 65 74 WRCSR bit is set
23c10 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
23c20 72 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 r.** can be used
23c30 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 20 for reading or
23c40 66 6f 72 20 77 72 69 74 69 6e 67 20 69 66 20 6f for writing if o
23c50 74 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e 73 20 ther conditions
23c60 66 6f 72 20 77 72 69 74 69 6e 67 0a 2a 2a 20 61 for writing.** a
23c70 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 54 68 re also met. Th
23c80 65 73 65 20 61 72 65 20 74 68 65 20 63 6f 6e 64 ese are the cond
23c90 69 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 73 74 itions that must
23ca0 20 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 65 72 be met in order
23cb0 0a 2a 2a 20 66 6f 72 20 77 72 69 74 69 6e 67 20 .** for writing
23cc0 74 6f 20 62 65 20 61 6c 6c 6f 77 65 64 3a 0a 2a to be allowed:.*
23cd0 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 75 72 *.** 1: The cur
23ce0 73 6f 72 20 6d 75 73 74 20 68 61 76 65 20 62 65 sor must have be
23cf0 65 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 20 77 en opened with w
23d00 72 46 6c 61 67 20 63 6f 6e 74 61 69 6e 69 6e 67 rFlag containing
23d10 20 42 54 52 45 45 5f 57 52 43 53 52 0a 2a 2a 0a BTREE_WRCSR.**.
23d20 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 61 74 ** 2: Other dat
23d30 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
23d40 73 20 74 68 61 74 20 73 68 61 72 65 20 74 68 65 s that share the
23d50 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 63 68 same pager cach
23d60 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 68 69 e.** but whi
23d70 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 ch are not in th
23d80 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 e READ_UNCOMMITT
23d90 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e 6f 74 ED state may not
23da0 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 72 have.** cur
23db0 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 20 77 sors open with w
23dc0 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 20 rFlag==0 on the
23dd0 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 68 same table. Oth
23de0 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 68 erwise.** th
23df0 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 62 e changes made b
23e00 79 20 74 68 69 73 20 77 72 69 74 65 20 63 75 72 y this write cur
23e10 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 69 73 sor would be vis
23e20 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 74 ible to.** t
23e30 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 he read cursors
23e40 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 in the other dat
23e50 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
23e60 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 20 ..**.** 3: The
23e70 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 database must be
23e80 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 6f writable (not o
23e90 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 n read-only medi
23ea0 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 65 a).**.** 4: The
23eb0 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 61 63 re must be an ac
23ec0 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e tive transaction
23ed0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 54 52 45 ..**.** The BTRE
23ee0 45 5f 46 4f 52 44 45 4c 45 54 45 20 62 69 74 20 E_FORDELETE bit
23ef0 6f 66 20 77 72 46 6c 61 67 20 6d 61 79 20 6f 70 of wrFlag may op
23f00 74 69 6f 6e 61 6c 6c 79 20 62 65 20 73 65 74 20 tionally be set
23f10 69 66 20 42 54 52 45 45 5f 57 52 43 53 52 0a 2a if BTREE_WRCSR.*
23f20 2a 20 69 73 20 73 65 74 2e 20 20 49 66 20 46 4f * is set. If FO
23f30 52 44 45 4c 45 54 45 20 69 73 20 73 65 74 2c 20 RDELETE is set,
23f40 74 68 61 74 20 69 73 20 61 20 68 69 6e 74 20 74 that is a hint t
23f50 6f 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 o the implementa
23f60 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 69 tion that.** thi
23f70 73 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 6f 6e s cursor will on
23f80 6c 79 20 62 65 20 75 73 65 64 20 74 6f 20 73 65 ly be used to se
23f90 65 6b 20 74 6f 20 61 6e 64 20 64 65 6c 65 74 65 ek to and delete
23fa0 20 65 6e 74 72 69 65 73 20 6f 66 20 61 6e 20 69 entries of an i
23fb0 6e 64 65 78 0a 2a 2a 20 61 73 20 70 61 72 74 20 ndex.** as part
23fc0 6f 66 20 61 20 6c 61 72 67 65 72 20 44 45 4c 45 of a larger DELE
23fd0 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 TE statement. T
23fe0 68 65 20 46 4f 52 44 45 4c 45 54 45 20 68 69 6e he FORDELETE hin
23ff0 74 20 69 73 20 6e 6f 74 20 75 73 65 64 20 62 79 t is not used by
24000 0a 2a 2a 20 74 68 69 73 20 69 6d 70 6c 65 6d 65 .** this impleme
24010 6e 74 61 74 69 6f 6e 2e 20 20 42 75 74 20 69 6e ntation. But in
24020 20 61 20 68 79 70 6f 74 68 65 74 69 63 61 6c 20 a hypothetical
24030 61 6c 74 65 72 6e 61 74 69 76 65 20 73 74 6f 72 alternative stor
24040 61 67 65 20 65 6e 67 69 6e 65 20 0a 2a 2a 20 69 age engine .** i
24050 6e 20 77 68 69 63 68 20 69 6e 64 65 78 20 65 6e n which index en
24060 74 72 69 65 73 20 61 72 65 20 61 75 74 6f 6d 61 tries are automa
24070 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 tically deleted
24080 77 68 65 6e 20 63 6f 72 72 65 73 70 6f 6e 64 69 when correspondi
24090 6e 67 20 74 61 62 6c 65 0a 2a 2a 20 72 6f 77 73 ng table.** rows
240a0 20 61 72 65 20 64 65 6c 65 74 65 64 2c 20 74 68 are deleted, th
240b0 65 20 46 4f 52 44 45 4c 45 54 45 20 66 6c 61 67 e FORDELETE flag
240c0 20 69 73 20 61 20 68 69 6e 74 20 74 68 61 74 20 is a hint that
240d0 61 6c 6c 20 53 45 45 4b 20 61 6e 64 20 44 45 4c all SEEK and DEL
240e0 45 54 45 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e ETE.** operation
240f0 73 20 6f 6e 20 74 68 69 73 20 63 75 72 73 6f 72 s on this cursor
24100 20 63 61 6e 20 62 65 20 6e 6f 2d 6f 70 73 20 61 can be no-ops a
24110 6e 64 20 61 6c 6c 20 52 45 41 44 20 6f 70 65 72 nd all READ oper
24120 61 74 69 6f 6e 73 20 63 61 6e 20 0a 2a 2a 20 72 ations can .** r
24130 65 74 75 72 6e 20 61 20 6e 75 6c 6c 20 72 6f 77 eturn a null row
24140 20 28 32 2d 62 79 74 65 73 3a 20 30 78 30 31 20 (2-bytes: 0x01
24150 30 78 30 30 29 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 20 0x00)..**.** No
24160 63 68 65 63 6b 69 6e 67 20 69 73 20 64 6f 6e 65 checking is done
24170 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 to make sure th
24180 61 74 20 70 61 67 65 20 69 54 61 62 6c 65 20 72 at page iTable r
24190 65 61 6c 6c 79 20 69 73 20 74 68 65 0a 2a 2a 20 eally is the.**
241a0 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 20 62 root page of a b
241b0 2d 74 72 65 65 2e 20 20 49 66 20 69 74 20 69 73 -tree. If it is
241c0 20 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 20 63 not, then the c
241d0 75 72 73 6f 72 20 61 63 71 75 69 72 65 64 0a 2a ursor acquired.*
241e0 2a 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 * will not work
241f0 63 6f 72 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a correctly..**.**
24200 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 It is assumed t
24210 68 61 74 20 74 68 65 20 73 71 6c 69 74 65 33 42 hat the sqlite3B
24220 74 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 29 treeCursorZero()
24230 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 has been called
24240 0a 2a 2a 20 6f 6e 20 70 43 75 72 20 74 6f 20 69 .** on pCur to i
24250 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 65 nitialize the me
24260 6d 6f 72 79 20 73 70 61 63 65 20 70 72 69 6f 72 mory space prior
24270 20 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 68 69 to invoking thi
24280 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 s routine..*/.st
24290 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 43 75 atic int btreeCu
242a0 72 73 6f 72 28 0a 20 20 42 74 72 65 65 20 2a 70 rsor(. Btree *p
242b0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
242c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
242d0 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 * The btree */.
242e0 20 69 6e 74 20 69 54 61 62 6c 65 2c 20 20 20 20 int iTable,
242f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24300 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 /* Root
24310 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f page of table to
24320 20 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 open */. int w
24330 72 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 rFlag,
24340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24350 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 65 2e /* 1 to write.
24360 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 0 read-only */.
24370 20 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f struct KeyInfo
24380 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 20 20 *pKeyInfo,
24390 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
243a0 74 20 61 72 67 20 74 6f 20 63 6f 6d 70 61 72 69 t arg to compari
243b0 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a son function */.
243c0 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
243d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
243e0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 /* Spac
243f0 65 20 66 6f 72 20 6e 65 77 20 63 75 72 73 6f 72 e for new cursor
24400 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 */.){. BtShare
24410 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
24420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24430 2f 2a 20 53 68 61 72 65 64 20 62 2d 74 72 65 65 /* Shared b-tree
24440 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 43 handle */. BtC
24450 75 72 73 6f 72 20 2a 70 58 3b 20 20 20 20 20 20 ursor *pX;
24460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24470 20 20 20 20 2f 2a 20 4c 6f 6f 70 69 6e 67 20 6f /* Looping o
24480 76 65 72 20 6f 74 68 65 72 20 61 6c 6c 20 63 75 ver other all cu
24490 72 73 6f 72 73 20 2a 2f 0a 0a 20 20 61 73 73 65 rsors */.. asse
244a0 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 rt( sqlite3Btree
244b0 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b HoldsMutex(p) );
244c0 0a 20 20 61 73 73 65 72 74 28 20 77 72 46 6c 61 . assert( wrFla
244d0 67 3d 3d 30 20 0a 20 20 20 20 20 20 20 7c 7c 20 g==0 . ||
244e0 77 72 46 6c 61 67 3d 3d 42 54 52 45 45 5f 57 52 wrFlag==BTREE_WR
244f0 43 53 52 20 0a 20 20 20 20 20 20 20 7c 7c 20 77 CSR . || w
24500 72 46 6c 61 67 3d 3d 28 42 54 52 45 45 5f 57 52 rFlag==(BTREE_WR
24510 43 53 52 7c 42 54 52 45 45 5f 46 4f 52 44 45 4c CSR|BTREE_FORDEL
24520 45 54 45 29 20 0a 20 20 29 3b 0a 0a 20 20 2f 2a ETE) . );.. /*
24530 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 The following a
24540 73 73 65 72 74 20 73 74 61 74 65 6d 65 6e 74 73 ssert statements
24550 20 76 65 72 69 66 79 20 74 68 61 74 20 69 66 20 verify that if
24560 74 68 69 73 20 69 73 20 61 20 73 68 61 72 61 62 this is a sharab
24570 6c 65 20 0a 20 20 2a 2a 20 62 2d 74 72 65 65 20 le . ** b-tree
24580 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 63 6f database, the co
24590 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 nnection is hold
245a0 69 6e 67 20 74 68 65 20 72 65 71 75 69 72 65 64 ing the required
245b0 20 74 61 62 6c 65 20 6c 6f 63 6b 73 2c 20 0a 20 table locks, .
245c0 20 2a 2a 20 61 6e 64 20 74 68 61 74 20 6e 6f 20 ** and that no
245d0 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
245e0 20 68 61 73 20 61 6e 79 20 6f 70 65 6e 20 63 75 has any open cu
245f0 72 73 6f 72 20 74 68 61 74 20 63 6f 6e 66 6c 69 rsor that confli
24600 63 74 73 20 77 69 74 68 20 0a 20 20 2a 2a 20 74 cts with . ** t
24610 68 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f 0a 20 20 his lock. */.
24620 61 73 73 65 72 74 28 20 68 61 73 53 68 61 72 65 assert( hasShare
24630 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 dCacheTableLock(
24640 70 2c 20 69 54 61 62 6c 65 2c 20 70 4b 65 79 49 p, iTable, pKeyI
24650 6e 66 6f 21 3d 30 2c 20 28 77 72 46 6c 61 67 3f nfo!=0, (wrFlag?
24660 32 3a 31 29 29 20 29 3b 0a 20 20 61 73 73 65 72 2:1)) );. asser
24670 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 t( wrFlag==0 ||
24680 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 74 !hasReadConflict
24690 73 28 70 2c 20 69 54 61 62 6c 65 29 20 29 3b 0a s(p, iTable) );.
246a0 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 . /* Assert tha
246b0 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68 61 73 t the caller has
246c0 20 6f 70 65 6e 65 64 20 74 68 65 20 72 65 71 75 opened the requ
246d0 69 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e ired transaction
246e0 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 . */. assert( p
246f0 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f ->inTrans>TRANS_
24700 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 72 74 NONE );. assert
24710 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 70 ( wrFlag==0 || p
24720 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
24730 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 _WRITE );. asse
24740 72 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 20 rt( pBt->pPage1
24750 26 26 20 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e && pBt->pPage1->
24760 61 44 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 aData );. asser
24770 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 t( wrFlag==0 ||
24780 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
24790 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d BTS_READ_ONLY)=
247a0 3d 30 20 29 3b 0a 0a 20 20 69 66 28 20 77 72 46 =0 );.. if( wrF
247b0 6c 61 67 20 29 7b 0a 20 20 20 20 61 6c 6c 6f 63 lag ){. alloc
247c0 61 74 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 ateTempSpace(pBt
247d0 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e );. if( pBt->
247e0 70 54 6d 70 53 70 61 63 65 3d 3d 30 20 29 20 72 pTmpSpace==0 ) r
247f0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d eturn SQLITE_NOM
24800 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 EM_BKPT;. }. i
24810 66 28 20 69 54 61 62 6c 65 3d 3d 31 20 26 26 20 f( iTable==1 &&
24820 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 btreePagecount(p
24830 42 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 Bt)==0 ){. as
24840 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
24850 29 3b 0a 20 20 20 20 69 54 61 62 6c 65 20 3d 20 );. iTable =
24860 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 0;. }.. /* Now
24870 20 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 65 that no other e
24880 72 72 6f 72 73 20 63 61 6e 20 6f 63 63 75 72 2c rrors can occur,
24890 20 66 69 6e 69 73 68 20 66 69 6c 6c 69 6e 67 20 finish filling
248a0 69 6e 20 74 68 65 20 42 74 43 75 72 73 6f 72 0a in the BtCursor.
248b0 20 20 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 61 ** variables a
248c0 6e 64 20 6c 69 6e 6b 20 74 68 65 20 63 75 72 73 nd link the curs
248d0 6f 72 20 69 6e 74 6f 20 74 68 65 20 42 74 53 68 or into the BtSh
248e0 61 72 65 64 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 ared list. */.
248f0 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 pCur->pgnoRoot
24900 3d 20 28 50 67 6e 6f 29 69 54 61 62 6c 65 3b 0a = (Pgno)iTable;.
24910 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 pCur->iPage =
24920 2d 31 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 -1;. pCur->pKey
24930 49 6e 66 6f 20 3d 20 70 4b 65 79 49 6e 66 6f 3b Info = pKeyInfo;
24940 0a 20 20 70 43 75 72 2d 3e 70 42 74 72 65 65 20 . pCur->pBtree
24950 3d 20 70 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 = p;. pCur->pBt
24960 20 3d 20 70 42 74 3b 0a 20 20 70 43 75 72 2d 3e = pBt;. pCur->
24970 63 75 72 46 6c 61 67 73 20 3d 20 77 72 46 6c 61 curFlags = wrFla
24980 67 20 3f 20 42 54 43 46 5f 57 72 69 74 65 46 6c g ? BTCF_WriteFl
24990 61 67 20 3a 20 30 3b 0a 20 20 70 43 75 72 2d 3e ag : 0;. pCur->
249a0 63 75 72 50 61 67 65 72 46 6c 61 67 73 20 3d 20 curPagerFlags =
249b0 77 72 46 6c 61 67 20 3f 20 30 20 3a 20 50 41 47 wrFlag ? 0 : PAG
249c0 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 3b ER_GET_READONLY;
249d0 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 . /* If there a
249e0 72 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 63 re two or more c
249f0 75 72 73 6f 72 73 20 6f 6e 20 74 68 65 20 73 61 ursors on the sa
24a00 6d 65 20 62 74 72 65 65 2c 20 74 68 65 6e 20 61 me btree, then a
24a10 6c 6c 20 73 75 63 68 0a 20 20 2a 2a 20 63 75 72 ll such. ** cur
24a20 73 6f 72 73 20 2a 6d 75 73 74 2a 20 68 61 76 65 sors *must* have
24a30 20 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 69 70 the BTCF_Multip
24a40 6c 65 20 66 6c 61 67 20 73 65 74 2e 20 2a 2f 0a le flag set. */.
24a50 20 20 66 6f 72 28 70 58 3d 70 42 74 2d 3e 70 43 for(pX=pBt->pC
24a60 75 72 73 6f 72 3b 20 70 58 3b 20 70 58 3d 70 58 ursor; pX; pX=pX
24a70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 ->pNext){. if
24a80 28 20 70 58 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d ( pX->pgnoRoot==
24a90 28 50 67 6e 6f 29 69 54 61 62 6c 65 20 29 7b 0a (Pgno)iTable ){.
24aa0 20 20 20 20 20 20 70 58 2d 3e 63 75 72 46 6c 61 pX->curFla
24ab0 67 73 20 7c 3d 20 42 54 43 46 5f 4d 75 6c 74 69 gs |= BTCF_Multi
24ac0 70 6c 65 3b 0a 20 20 20 20 20 20 70 43 75 72 2d ple;. pCur-
24ad0 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 >curFlags |= BTC
24ae0 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a 20 20 20 20 F_Multiple;.
24af0 7d 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 70 4e }. }. pCur->pN
24b00 65 78 74 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 ext = pBt->pCurs
24b10 6f 72 3b 0a 20 20 70 42 74 2d 3e 70 43 75 72 73 or;. pBt->pCurs
24b20 6f 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 43 75 or = pCur;. pCu
24b30 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 r->eState = CURS
24b40 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 72 65 OR_INVALID;. re
24b50 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
24b60 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 }.int sqlite3Btr
24b70 65 65 43 75 72 73 6f 72 28 0a 20 20 42 74 72 65 eeCursor(. Btre
24b80 65 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 e *p,
24b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24ba0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 /* The b
24bb0 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 54 tree */. int iT
24bc0 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 able,
24bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24be0 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 /* Root pa
24bf0 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f ge of table to o
24c00 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 pen */. int wrF
24c10 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 lag,
24c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24c30 20 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 /* 1 to wri
24c40 74 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 te. 0 read-only
24c50 2a 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 79 49 */. struct KeyI
24c60 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 nfo *pKeyInfo,
24c70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24c80 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 74 6f /* First arg to
24c90 20 78 43 6f 6d 70 61 72 65 28 29 20 2a 2f 0a 20 xCompare() */.
24ca0 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 20 BtCursor *pCur
24cb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24cd0 57 72 69 74 65 20 6e 65 77 20 63 75 72 73 6f 72 Write new cursor
24ce0 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
24cf0 74 20 72 63 3b 0a 20 20 69 66 28 20 69 54 61 62 t rc;. if( iTab
24d00 6c 65 3c 31 20 29 7b 0a 20 20 20 20 72 63 20 3d le<1 ){. rc =
24d10 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
24d20 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 BKPT;. }else{.
24d30 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 sqlite3BtreeE
24d40 6e 74 65 72 28 70 29 3b 0a 20 20 20 20 72 63 20 nter(p);. rc
24d50 3d 20 62 74 72 65 65 43 75 72 73 6f 72 28 70 2c = btreeCursor(p,
24d60 20 69 54 61 62 6c 65 2c 20 77 72 46 6c 61 67 2c iTable, wrFlag,
24d70 20 70 4b 65 79 49 6e 66 6f 2c 20 70 43 75 72 29 pKeyInfo, pCur)
24d80 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 ;. sqlite3Btr
24d90 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a eeLeave(p);. }.
24da0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
24db0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
24dc0 20 73 69 7a 65 20 6f 66 20 61 20 42 74 43 75 72 size of a BtCur
24dd0 73 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 62 79 sor object in by
24de0 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 tes..**.** This
24df0 69 6e 74 65 72 66 61 63 65 73 20 69 73 20 6e 65 interfaces is ne
24e00 65 64 65 64 20 73 6f 20 74 68 61 74 20 75 73 65 eded so that use
24e10 72 73 20 6f 66 20 63 75 72 73 6f 72 73 20 63 61 rs of cursors ca
24e20 6e 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a 2a 2a n preallocate.**
24e30 20 73 75 66 66 69 63 69 65 6e 74 20 73 74 6f 72 sufficient stor
24e40 61 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 63 75 age to hold a cu
24e50 72 73 6f 72 2e 20 20 54 68 65 20 42 74 43 75 72 rsor. The BtCur
24e60 73 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 6f 70 sor object is op
24e70 61 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 72 73 aque.** to users
24e80 20 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f 74 20 so they cannot
24e90 64 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 29 20 do the sizeof()
24ea0 74 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 68 65 themselves - the
24eb0 79 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a 20 74 y must call.** t
24ec0 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a his routine..*/.
24ed0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
24ee0 43 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 64 29 CursorSize(void)
24ef0 7b 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 {. return ROUND
24f00 38 28 73 69 7a 65 6f 66 28 42 74 43 75 72 73 6f 8(sizeof(BtCurso
24f10 72 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e r));.}../*.** In
24f20 69 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 79 20 itialize memory
24f30 74 68 61 74 20 77 69 6c 6c 20 62 65 20 63 6f 6e that will be con
24f40 76 65 72 74 65 64 20 69 6e 74 6f 20 61 20 42 74 verted into a Bt
24f50 43 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e 0a 2a Cursor object..*
24f60 2a 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 *.** The simple
24f70 61 70 70 72 6f 61 63 68 20 68 65 72 65 20 77 6f approach here wo
24f80 75 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 65 74 uld be to memset
24f90 28 29 20 74 68 65 20 65 6e 74 69 72 65 20 6f 62 () the entire ob
24fa0 6a 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f 2e ject.** to zero.
24fb0 20 20 42 75 74 20 69 74 20 74 75 72 6e 73 20 6f But it turns o
24fc0 75 74 20 74 68 61 74 20 74 68 65 20 61 70 50 61 ut that the apPa
24fd0 67 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 5b 5d ge[] and aiIdx[]
24fe0 20 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 6e 6f arrays.** do no
24ff0 74 20 6e 65 65 64 20 74 6f 20 62 65 20 7a 65 72 t need to be zer
25000 6f 65 64 20 61 6e 64 20 74 68 65 79 20 61 72 65 oed and they are
25010 20 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 63 61 large, so we ca
25020 6e 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a 2a 20 n save a lot.**
25030 6f 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 20 73 of run-time by s
25040 6b 69 70 70 69 6e 67 20 74 68 65 20 69 6e 69 74 kipping the init
25050 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 68 ialization of th
25060 6f 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a 2a 2f ose elements..*/
25070 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 .void sqlite3Btr
25080 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 74 43 eeCursorZero(BtC
25090 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d 65 6d ursor *p){. mem
250a0 73 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 65 74 set(p, 0, offset
250b0 6f 66 28 42 74 43 75 72 73 6f 72 2c 20 42 54 43 of(BtCursor, BTC
250c0 55 52 53 4f 52 5f 46 49 52 53 54 5f 55 4e 49 4e URSOR_FIRST_UNIN
250d0 49 54 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 IT));.}../*.** C
250e0 6c 6f 73 65 20 61 20 63 75 72 73 6f 72 2e 20 20 lose a cursor.
250f0 54 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e The read lock on
25100 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
25110 6c 65 20 69 73 20 72 65 6c 65 61 73 65 64 0a 2a le is released.*
25120 2a 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 * when the last
25130 63 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 65 64 cursor is closed
25140 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
25150 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 BtreeCloseCursor
25160 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
25170 7b 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 {. Btree *pBtre
25180 65 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 65 65 e = pCur->pBtree
25190 3b 0a 20 20 69 66 28 20 70 42 74 72 65 65 20 29 ;. if( pBtree )
251a0 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a {. BtShared *
251b0 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b pBt = pCur->pBt;
251c0 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
251d0 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a eEnter(pBtree);.
251e0 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
251f0 3e 70 43 75 72 73 6f 72 21 3d 30 20 29 3b 0a 20 >pCursor!=0 );.
25200 20 20 20 69 66 28 20 70 42 74 2d 3e 70 43 75 72 if( pBt->pCur
25210 73 6f 72 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 sor==pCur ){.
25220 20 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 pBt->pCursor
25230 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 = pCur->pNext;.
25240 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
25250 42 74 43 75 72 73 6f 72 20 2a 70 50 72 65 76 20 BtCursor *pPrev
25260 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
25270 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 do{.
25280 20 20 69 66 28 20 70 50 72 65 76 2d 3e 70 4e 65 if( pPrev->pNe
25290 78 74 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 20 xt==pCur ){.
252a0 20 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e 65 pPrev->pNe
252b0 78 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 xt = pCur->pNext
252c0 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 ;. brea
252d0 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 k;. }.
252e0 20 20 20 20 20 70 50 72 65 76 20 3d 20 70 50 72 pPrev = pPr
252f0 65 76 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 ev->pNext;.
25300 20 7d 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 }while( ALWAYS(
25310 70 50 72 65 76 29 20 29 3b 0a 20 20 20 20 7d 0a pPrev) );. }.
25320 20 20 20 20 62 74 72 65 65 52 65 6c 65 61 73 65 btreeRelease
25330 41 6c 6c 43 75 72 73 6f 72 50 61 67 65 73 28 70 AllCursorPages(p
25340 43 75 72 29 3b 0a 20 20 20 20 75 6e 6c 6f 63 6b Cur);. unlock
25350 42 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 BtreeIfUnused(pB
25360 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f t);. sqlite3_
25370 66 72 65 65 28 70 43 75 72 2d 3e 61 4f 76 65 72 free(pCur->aOver
25380 66 6c 6f 77 29 3b 0a 20 20 20 20 73 71 6c 69 74 flow);. sqlit
25390 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 4b e3_free(pCur->pK
253a0 65 79 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ey);. sqlite3
253b0 42 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 BtreeLeave(pBtre
253c0 65 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 70 42 e);. pCur->pB
253d0 74 72 65 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 tree = 0;. }.
253e0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
253f0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 ;.}../*.** Make
25400 73 75 72 65 20 74 68 65 20 42 74 43 75 72 73 6f sure the BtCurso
25410 72 2a 20 67 69 76 65 6e 20 69 6e 20 74 68 65 20 r* given in the
25420 61 72 67 75 6d 65 6e 74 20 68 61 73 20 61 20 76 argument has a v
25430 61 6c 69 64 0a 2a 2a 20 42 74 43 75 72 73 6f 72 alid.** BtCursor
25440 2e 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 2e .info structure.
25450 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 20 61 If it is not a
25460 6c 72 65 61 64 79 20 76 61 6c 69 64 2c 20 63 61 lready valid, ca
25470 6c 6c 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 65 ll.** btreeParse
25480 43 65 6c 6c 28 29 20 74 6f 20 66 69 6c 6c 20 69 Cell() to fill i
25490 74 20 69 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 43 75 t in..**.** BtCu
254a0 72 73 6f 72 2e 69 6e 66 6f 20 69 73 20 61 20 63 rsor.info is a c
254b0 61 63 68 65 20 6f 66 20 74 68 65 20 69 6e 66 6f ache of the info
254c0 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 63 rmation in the c
254d0 75 72 72 65 6e 74 20 63 65 6c 6c 2e 0a 2a 2a 20 urrent cell..**
254e0 55 73 69 6e 67 20 74 68 69 73 20 63 61 63 68 65 Using this cache
254f0 20 72 65 64 75 63 65 73 20 74 68 65 20 6e 75 6d reduces the num
25500 62 65 72 20 6f 66 20 63 61 6c 6c 73 20 74 6f 20 ber of calls to
25510 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 29 btreeParseCell()
25520 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 ..*/.#ifndef NDE
25530 42 55 47 0a 20 20 73 74 61 74 69 63 20 69 6e 74 BUG. static int
25540 20 63 65 6c 6c 49 6e 66 6f 45 71 75 61 6c 28 43 cellInfoEqual(C
25550 65 6c 6c 49 6e 66 6f 20 2a 61 2c 20 43 65 6c 6c ellInfo *a, Cell
25560 49 6e 66 6f 20 2a 62 29 7b 0a 20 20 20 20 69 66 Info *b){. if
25570 28 20 61 2d 3e 6e 4b 65 79 21 3d 62 2d 3e 6e 4b ( a->nKey!=b->nK
25580 65 79 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 ey ) return 0;.
25590 20 20 20 69 66 28 20 61 2d 3e 70 50 61 79 6c 6f if( a->pPaylo
255a0 61 64 21 3d 62 2d 3e 70 50 61 79 6c 6f 61 64 20 ad!=b->pPayload
255b0 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 ) return 0;.
255c0 69 66 28 20 61 2d 3e 6e 50 61 79 6c 6f 61 64 21 if( a->nPayload!
255d0 3d 62 2d 3e 6e 50 61 79 6c 6f 61 64 20 29 20 72 =b->nPayload ) r
255e0 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 69 66 28 eturn 0;. if(
255f0 20 61 2d 3e 6e 4c 6f 63 61 6c 21 3d 62 2d 3e 6e a->nLocal!=b->n
25600 4c 6f 63 61 6c 20 29 20 72 65 74 75 72 6e 20 30 Local ) return 0
25610 3b 0a 20 20 20 20 69 66 28 20 61 2d 3e 6e 53 69 ;. if( a->nSi
25620 7a 65 21 3d 62 2d 3e 6e 53 69 7a 65 20 29 20 72 ze!=b->nSize ) r
25630 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 72 65 74 eturn 0;. ret
25640 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 73 74 61 urn 1;. }. sta
25650 74 69 63 20 76 6f 69 64 20 61 73 73 65 72 74 43 tic void assertC
25660 65 6c 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f 72 ellInfo(BtCursor
25670 20 2a 70 43 75 72 29 7b 0a 20 20 20 20 43 65 6c *pCur){. Cel
25680 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 lInfo info;.
25690 6d 65 6d 73 65 74 28 26 69 6e 66 6f 2c 20 30 2c memset(&info, 0,
256a0 20 73 69 7a 65 6f 66 28 69 6e 66 6f 29 29 3b 0a sizeof(info));.
256b0 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
256c0 6c 6c 28 70 43 75 72 2d 3e 70 50 61 67 65 2c 20 ll(pCur->pPage,
256d0 70 43 75 72 2d 3e 69 78 2c 20 26 69 6e 66 6f 29 pCur->ix, &info)
256e0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 43 4f ;. assert( CO
256f0 52 52 55 50 54 5f 44 42 20 7c 7c 20 63 65 6c 6c RRUPT_DB || cell
25700 49 6e 66 6f 45 71 75 61 6c 28 26 69 6e 66 6f 2c InfoEqual(&info,
25710 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 20 29 3b &pCur->info) );
25720 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 23 64 65 . }.#else. #de
25730 66 69 6e 65 20 61 73 73 65 72 74 43 65 6c 6c 49 fine assertCellI
25740 6e 66 6f 28 78 29 0a 23 65 6e 64 69 66 0a 73 74 nfo(x).#endif.st
25750 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e atic SQLITE_NOIN
25760 4c 49 4e 45 20 76 6f 69 64 20 67 65 74 43 65 6c LINE void getCel
25770 6c 49 6e 66 6f 28 42 74 43 75 72 73 6f 72 20 2a lInfo(BtCursor *
25780 70 43 75 72 29 7b 0a 20 20 69 66 28 20 70 43 75 pCur){. if( pCu
25790 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
257a0 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 63 75 ){. pCur->cu
257b0 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 rFlags |= BTCF_V
257c0 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 20 20 62 74 alidNKey;. bt
257d0 72 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 reeParseCell(pCu
257e0 72 2d 3e 70 50 61 67 65 2c 70 43 75 72 2d 3e 69 r->pPage,pCur->i
257f0 78 2c 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a x,&pCur->info);.
25800 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 }else{. ass
25810 65 72 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 ertCellInfo(pCur
25820 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 );. }.}..#ifnde
25830 66 20 4e 44 45 42 55 47 20 20 2f 2a 20 54 68 65 f NDEBUG /* The
25840 20 6e 65 78 74 20 72 6f 75 74 69 6e 65 20 75 73 next routine us
25850 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 ed only within a
25860 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
25870 74 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ts */./*.** Retu
25880 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 67 rn true if the g
25890 69 76 65 6e 20 42 74 43 75 72 73 6f 72 20 69 73 iven BtCursor is
258a0 20 76 61 6c 69 64 2e 20 20 41 20 76 61 6c 69 64 valid. A valid
258b0 20 63 75 72 73 6f 72 20 69 73 20 6f 6e 65 0a 2a cursor is one.*
258c0 2a 20 74 68 61 74 20 69 73 20 63 75 72 72 65 6e * that is curren
258d0 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 tly pointing to
258e0 61 20 72 6f 77 20 69 6e 20 61 20 28 6e 6f 6e 2d a row in a (non-
258f0 65 6d 70 74 79 29 20 74 61 62 6c 65 2e 0a 2a 2a empty) table..**
25900 20 54 68 69 73 20 69 73 20 61 20 76 65 72 69 66 This is a verif
25910 69 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 20 ication routine
25920 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 77 69 74 is used only wit
25930 68 69 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 hin assert() sta
25940 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 69 6e 74 20 tements..*/.int
25950 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
25960 6f 72 49 73 56 61 6c 69 64 28 42 74 43 75 72 73 orIsValid(BtCurs
25970 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 65 74 or *pCur){. ret
25980 75 72 6e 20 70 43 75 72 20 26 26 20 70 43 75 72 urn pCur && pCur
25990 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
259a0 5f 56 41 4c 49 44 3b 0a 7d 0a 23 65 6e 64 69 66 _VALID;.}.#endif
259b0 20 2f 2a 20 4e 44 45 42 55 47 20 2a 2f 0a 69 6e /* NDEBUG */.in
259c0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 t sqlite3BtreeCu
259d0 72 73 6f 72 49 73 56 61 6c 69 64 4e 4e 28 42 74 rsorIsValidNN(Bt
259e0 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
259f0 20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 assert( pCur!=0
25a00 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 );. return pCu
25a10 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
25a20 52 5f 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a R_VALID;.}../*.*
25a30 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c * Return the val
25a40 75 65 20 6f 66 20 74 68 65 20 69 6e 74 65 67 65 ue of the intege
25a50 72 20 6b 65 79 20 6f 72 20 22 72 6f 77 69 64 22 r key or "rowid"
25a60 20 66 6f 72 20 61 20 74 61 62 6c 65 20 62 74 72 for a table btr
25a70 65 65 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ee..** This rout
25a80 69 6e 65 20 69 73 20 6f 6e 6c 79 20 76 61 6c 69 ine is only vali
25a90 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 20 74 d for a cursor t
25aa0 68 61 74 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 hat is pointing
25ab0 69 6e 74 6f 20 61 0a 2a 2a 20 6f 72 64 69 6e 61 into a.** ordina
25ac0 72 79 20 74 61 62 6c 65 20 62 74 72 65 65 2e 20 ry table btree.
25ad0 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 20 70 If the cursor p
25ae0 6f 69 6e 74 73 20 74 6f 20 61 6e 20 69 6e 64 65 oints to an inde
25af0 78 20 62 74 72 65 65 20 6f 72 0a 2a 2a 20 69 73 x btree or.** is
25b00 20 69 6e 76 61 6c 69 64 2c 20 74 68 65 20 72 65 invalid, the re
25b10 73 75 6c 74 20 6f 66 20 74 68 69 73 20 72 6f 75 sult of this rou
25b20 74 69 6e 65 20 69 73 20 75 6e 64 65 66 69 6e 65 tine is undefine
25b30 64 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 74 65 d..*/.i64 sqlite
25b40 33 42 74 72 65 65 49 6e 74 65 67 65 72 4b 65 79 3BtreeIntegerKey
25b50 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
25b60 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 {. assert( curs
25b70 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
25b80 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
25b90 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
25ba0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
25bb0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 63 75 assert( pCur->cu
25bc0 72 49 6e 74 4b 65 79 20 29 3b 0a 20 20 67 65 74 rIntKey );. get
25bd0 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a CellInfo(pCur);.
25be0 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 69 return pCur->i
25bf0 6e 66 6f 2e 6e 4b 65 79 3b 0a 7d 0a 0a 23 69 66 nfo.nKey;.}..#if
25c00 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
25c10 45 5f 4f 46 46 53 45 54 5f 53 51 4c 5f 46 55 4e E_OFFSET_SQL_FUN
25c20 43 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 C./*.** Return t
25c30 68 65 20 6f 66 66 73 65 74 20 69 6e 74 6f 20 74 he offset into t
25c40 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
25c50 20 66 6f 72 20 74 68 65 20 73 74 61 72 74 20 6f for the start o
25c60 66 20 74 68 65 0a 2a 2a 20 70 61 79 6c 6f 61 64 f the.** payload
25c70 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 63 75 to which the cu
25c80 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 rsor is pointing
25c90 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 74 65 33 ..*/.i64 sqlite3
25ca0 42 74 72 65 65 4f 66 66 73 65 74 28 42 74 43 75 BtreeOffset(BtCu
25cb0 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 rsor *pCur){. a
25cc0 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
25cd0 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
25ce0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
25cf0 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
25d00 56 41 4c 49 44 20 29 3b 0a 20 20 67 65 74 43 65 VALID );. getCe
25d10 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 llInfo(pCur);.
25d20 72 65 74 75 72 6e 20 28 69 36 34 29 70 43 75 72 return (i64)pCur
25d30 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2a ->pBt->pageSize*
25d40 28 28 69 36 34 29 70 43 75 72 2d 3e 70 50 61 67 ((i64)pCur->pPag
25d50 65 2d 3e 70 67 6e 6f 20 2d 20 31 29 20 2b 0a 20 e->pgno - 1) +.
25d60 20 20 20 20 20 20 20 20 28 69 36 34 29 28 70 43 (i64)(pC
25d70 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 ur->info.pPayloa
25d80 64 20 2d 20 70 43 75 72 2d 3e 70 50 61 67 65 2d d - pCur->pPage-
25d90 3e 61 44 61 74 61 29 3b 0a 7d 0a 23 65 6e 64 69 >aData);.}.#endi
25da0 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 f /* SQLITE_ENAB
25db0 4c 45 5f 4f 46 46 53 45 54 5f 53 51 4c 5f 46 55 LE_OFFSET_SQL_FU
25dc0 4e 43 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 NC */../*.** Ret
25dd0 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f urn the number o
25de0 66 20 62 79 74 65 73 20 6f 66 20 70 61 79 6c 6f f bytes of paylo
25df0 61 64 20 66 6f 72 20 74 68 65 20 65 6e 74 72 79 ad for the entry
25e00 20 74 68 61 74 20 70 43 75 72 20 69 73 0a 2a 2a that pCur is.**
25e10 20 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 currently point
25e20 69 6e 67 20 74 6f 2e 20 20 46 6f 72 20 74 61 62 ing to. For tab
25e30 6c 65 20 62 74 72 65 65 73 2c 20 74 68 69 73 20 le btrees, this
25e40 77 69 6c 6c 20 62 65 20 74 68 65 20 61 6d 6f 75 will be the amou
25e50 6e 74 0a 2a 2a 20 6f 66 20 64 61 74 61 2e 20 20 nt.** of data.
25e60 46 6f 72 20 69 6e 64 65 78 20 62 74 72 65 65 73 For index btrees
25e70 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 20 74 , this will be t
25e80 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6b he size of the k
25e90 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 ey..**.** The ca
25ea0 6c 6c 65 72 20 6d 75 73 74 20 67 75 61 72 61 6e ller must guaran
25eb0 74 65 65 20 74 68 61 74 20 74 68 65 20 63 75 72 tee that the cur
25ec0 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 sor is pointing
25ed0 74 6f 20 61 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a 2a to a non-NULL.**
25ee0 20 76 61 6c 69 64 20 65 6e 74 72 79 2e 20 20 49 valid entry. I
25ef0 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 74 n other words, t
25f00 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 he calling proce
25f10 64 75 72 65 20 6d 75 73 74 20 67 75 61 72 61 6e dure must guaran
25f20 74 65 65 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 tee.** that the
25f30 63 75 72 73 6f 72 20 68 61 73 20 43 75 72 73 6f cursor has Curso
25f40 72 2e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 r.eState==CURSOR
25f50 5f 56 41 4c 49 44 2e 0a 2a 2f 0a 75 33 32 20 73 _VALID..*/.u32 s
25f60 71 6c 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f qlite3BtreePaylo
25f70 61 64 53 69 7a 65 28 42 74 43 75 72 73 6f 72 20 adSize(BtCursor
25f80 2a 70 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 *pCur){. assert
25f90 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
25fa0 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ex(pCur) );. as
25fb0 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
25fc0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
25fd0 20 29 3b 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 );. getCellInf
25fe0 6f 28 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 o(pCur);. retur
25ff0 6e 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 n pCur->info.nPa
26000 79 6c 6f 61 64 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 yload;.}../*.**
26010 47 69 76 65 6e 20 74 68 65 20 70 61 67 65 20 6e Given the page n
26020 75 6d 62 65 72 20 6f 66 20 61 6e 20 6f 76 65 72 umber of an over
26030 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 68 65 flow page in the
26040 20 64 61 74 61 62 61 73 65 20 28 70 61 72 61 6d database (param
26050 65 74 65 72 0a 2a 2a 20 6f 76 66 6c 29 2c 20 74 eter.** ovfl), t
26060 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 66 69 6e his function fin
26070 64 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 ds the page numb
26080 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 70 er of the next p
26090 61 67 65 20 69 6e 20 74 68 65 20 0a 2a 2a 20 6c age in the .** l
260a0 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 6f 76 inked list of ov
260b0 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 49 66 erflow pages. If
260c0 20 70 6f 73 73 69 62 6c 65 2c 20 69 74 20 75 73 possible, it us
260d0 65 73 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 es the auto-vacu
260e0 75 6d 0a 2a 2a 20 70 6f 69 6e 74 65 72 2d 6d 61 um.** pointer-ma
260f0 70 20 64 61 74 61 20 69 6e 73 74 65 61 64 20 6f p data instead o
26100 66 20 72 65 61 64 69 6e 67 20 74 68 65 20 63 6f f reading the co
26110 6e 74 65 6e 74 20 6f 66 20 70 61 67 65 20 6f 76 ntent of page ov
26120 66 6c 20 74 6f 20 64 6f 20 73 6f 2e 20 0a 2a 2a fl to do so. .**
26130 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 .** If an error
26140 6f 63 63 75 72 73 20 61 6e 20 53 51 4c 69 74 65 occurs an SQLite
26150 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 error code is r
26160 65 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 eturned. Otherwi
26170 73 65 3a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 se:.**.** The pa
26180 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 ge number of the
26190 20 6e 65 78 74 20 6f 76 65 72 66 6c 6f 77 20 70 next overflow p
261a0 61 67 65 20 69 6e 20 74 68 65 20 6c 69 6e 6b 65 age in the linke
261b0 64 20 6c 69 73 74 20 69 73 20 0a 2a 2a 20 77 72 d list is .** wr
261c0 69 74 74 65 6e 20 74 6f 20 2a 70 50 67 6e 6f 4e itten to *pPgnoN
261d0 65 78 74 2e 20 49 66 20 70 61 67 65 20 6f 76 66 ext. If page ovf
261e0 6c 20 69 73 20 74 68 65 20 6c 61 73 74 20 70 61 l is the last pa
261f0 67 65 20 69 6e 20 69 74 73 20 6c 69 6e 6b 65 64 ge in its linked
26200 20 0a 2a 2a 20 6c 69 73 74 2c 20 2a 70 50 67 6e .** list, *pPgn
26210 6f 4e 65 78 74 20 69 73 20 73 65 74 20 74 6f 20 oNext is set to
26220 7a 65 72 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 zero. .**.** If
26230 70 70 50 61 67 65 20 69 73 20 6e 6f 74 20 4e 55 ppPage is not NU
26240 4c 4c 2c 20 61 6e 64 20 61 20 72 65 66 65 72 65 LL, and a refere
26250 6e 63 65 20 74 6f 20 74 68 65 20 4d 65 6d 50 61 nce to the MemPa
26260 67 65 20 6f 62 6a 65 63 74 20 63 6f 72 72 65 73 ge object corres
26270 70 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20 70 61 ponding.** to pa
26280 67 65 20 6e 75 6d 62 65 72 20 70 4f 76 66 6c 20 ge number pOvfl
26290 77 61 73 20 6f 62 74 61 69 6e 65 64 2c 20 74 68 was obtained, th
262a0 65 6e 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 en *ppPage is se
262b0 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 t to point to th
262c0 61 74 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 2e at.** reference.
262d0 20 49 74 20 69 73 20 74 68 65 20 72 65 73 70 6f It is the respo
262e0 6e 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 nsibility of the
262f0 20 63 61 6c 6c 65 72 20 74 6f 20 63 61 6c 6c 20 caller to call
26300 72 65 6c 65 61 73 65 50 61 67 65 28 29 0a 2a 2a releasePage().**
26310 20 6f 6e 20 2a 70 70 50 61 67 65 20 74 6f 20 66 on *ppPage to f
26320 72 65 65 20 74 68 65 20 72 65 66 65 72 65 6e 63 ree the referenc
26330 65 2e 20 49 6e 20 6e 6f 20 72 65 66 65 72 65 6e e. In no referen
26340 63 65 20 77 61 73 20 6f 62 74 61 69 6e 65 64 20 ce was obtained
26350 28 62 65 63 61 75 73 65 0a 2a 2a 20 74 68 65 20 (because.** the
26360 70 6f 69 6e 74 65 72 2d 6d 61 70 20 77 61 73 20 pointer-map was
26370 75 73 65 64 20 74 6f 20 6f 62 74 61 69 6e 20 74 used to obtain t
26380 68 65 20 76 61 6c 75 65 20 66 6f 72 20 2a 70 50 he value for *pP
26390 67 6e 6f 4e 65 78 74 29 2c 20 74 68 65 6e 0a 2a gnoNext), then.*
263a0 2a 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 74 * *ppPage is set
263b0 20 74 6f 20 7a 65 72 6f 2e 0a 2a 2f 0a 73 74 61 to zero..*/.sta
263c0 74 69 63 20 69 6e 74 20 67 65 74 4f 76 65 72 66 tic int getOverf
263d0 6c 6f 77 50 61 67 65 28 0a 20 20 42 74 53 68 61 lowPage(. BtSha
263e0 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
263f0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 /* The d
26400 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
26410 20 20 50 67 6e 6f 20 6f 76 66 6c 2c 20 20 20 20 Pgno ovfl,
26420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
26430 2a 20 43 75 72 72 65 6e 74 20 6f 76 65 72 66 6c * Current overfl
26440 6f 77 20 70 61 67 65 20 6e 75 6d 62 65 72 20 2a ow page number *
26450 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
26460 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 Page,
26470 20 2f 2a 20 4f 55 54 3a 20 4d 65 6d 50 61 67 65 /* OUT: MemPage
26480 20 68 61 6e 64 6c 65 20 28 6d 61 79 20 62 65 20 handle (may be
26490 4e 55 4c 4c 29 20 2a 2f 0a 20 20 50 67 6e 6f 20 NULL) */. Pgno
264a0 2a 70 50 67 6e 6f 4e 65 78 74 20 20 20 20 20 20 *pPgnoNext
264b0 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
264c0 4e 65 78 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 Next overflow pa
264d0 67 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 29 7b 0a ge number */.){.
264e0 20 20 50 67 6e 6f 20 6e 65 78 74 20 3d 20 30 3b Pgno next = 0;
264f0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
26500 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 e = 0;. int rc
26510 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
26520 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
26530 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
26540 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
26550 72 74 28 70 50 67 6e 6f 4e 65 78 74 29 3b 0a 0a rt(pPgnoNext);..
26560 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
26570 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
26580 20 2f 2a 20 54 72 79 20 74 6f 20 66 69 6e 64 20 /* Try to find
26590 74 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e the next page in
265a0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 6c 69 the overflow li
265b0 73 74 20 75 73 69 6e 67 20 74 68 65 0a 20 20 2a st using the. *
265c0 2a 20 61 75 74 6f 76 61 63 75 75 6d 20 70 6f 69 * autovacuum poi
265d0 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 73 2e 20 nter-map pages.
265e0 47 75 65 73 73 20 74 68 61 74 20 74 68 65 20 6e Guess that the n
265f0 65 78 74 20 70 61 67 65 20 69 6e 20 0a 20 20 2a ext page in . *
26600 2a 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 6c * the overflow l
26610 69 73 74 20 69 73 20 70 61 67 65 20 6e 75 6d 62 ist is page numb
26620 65 72 20 28 6f 76 66 6c 2b 31 29 2e 20 49 66 20 er (ovfl+1). If
26630 74 68 61 74 20 67 75 65 73 73 20 74 75 72 6e 73 that guess turns
26640 20 0a 20 20 2a 2a 20 6f 75 74 20 74 6f 20 62 65 . ** out to be
26650 20 77 72 6f 6e 67 2c 20 66 61 6c 6c 20 62 61 63 wrong, fall bac
26660 6b 20 74 6f 20 6c 6f 61 64 69 6e 67 20 74 68 65 k to loading the
26670 20 64 61 74 61 20 6f 66 20 70 61 67 65 20 0a 20 data of page .
26680 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 76 66 6c 20 ** number ovfl
26690 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 to determine the
266a0 20 6e 65 78 74 20 70 61 67 65 20 6e 75 6d 62 65 next page numbe
266b0 72 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 42 r.. */. if( pB
266c0 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b t->autoVacuum ){
266d0 0a 20 20 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 0a . Pgno pgno;.
266e0 20 20 20 20 50 67 6e 6f 20 69 47 75 65 73 73 20 Pgno iGuess
266f0 3d 20 6f 76 66 6c 2b 31 3b 0a 20 20 20 20 75 38 = ovfl+1;. u8
26700 20 65 54 79 70 65 3b 0a 0a 20 20 20 20 77 68 69 eType;.. whi
26710 6c 65 28 20 50 54 52 4d 41 50 5f 49 53 50 41 47 le( PTRMAP_ISPAG
26720 45 28 70 42 74 2c 20 69 47 75 65 73 73 29 20 7c E(pBt, iGuess) |
26730 7c 20 69 47 75 65 73 73 3d 3d 50 45 4e 44 49 4e | iGuess==PENDIN
26740 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
26750 20 29 7b 0a 20 20 20 20 20 20 69 47 75 65 73 73 ){. iGuess
26760 2b 2b 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 ++;. }.. i
26770 66 28 20 69 47 75 65 73 73 3c 3d 62 74 72 65 65 f( iGuess<=btree
26780 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 20 29 Pagecount(pBt) )
26790 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 74 72 {. rc = ptr
267a0 6d 61 70 47 65 74 28 70 42 74 2c 20 69 47 75 65 mapGet(pBt, iGue
267b0 73 73 2c 20 26 65 54 79 70 65 2c 20 26 70 67 6e ss, &eType, &pgn
267c0 6f 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 o);. if( rc
267d0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 65 ==SQLITE_OK && e
267e0 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 Type==PTRMAP_OVE
267f0 52 46 4c 4f 57 32 20 26 26 20 70 67 6e 6f 3d 3d RFLOW2 && pgno==
26800 6f 76 66 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 ovfl ){.
26810 6e 65 78 74 20 3d 20 69 47 75 65 73 73 3b 0a 20 next = iGuess;.
26820 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
26830 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 20 20 7d TE_DONE;. }
26840 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 . }. }.#endi
26850 66 0a 0a 20 20 61 73 73 65 72 74 28 20 6e 65 78 f.. assert( nex
26860 74 3d 3d 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 t==0 || rc==SQLI
26870 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 69 66 28 TE_DONE );. if(
26880 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
26890 7b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 {. rc = btree
268a0 47 65 74 50 61 67 65 28 70 42 74 2c 20 6f 76 66 GetPage(pBt, ovf
268b0 6c 2c 20 26 70 50 61 67 65 2c 20 28 70 70 50 61 l, &pPage, (ppPa
268c0 67 65 3d 3d 30 29 20 3f 20 50 41 47 45 52 5f 47 ge==0) ? PAGER_G
268d0 45 54 5f 52 45 41 44 4f 4e 4c 59 20 3a 20 30 29 ET_READONLY : 0)
268e0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 ;. assert( rc
268f0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 ==SQLITE_OK || p
26900 50 61 67 65 3d 3d 30 20 29 3b 0a 20 20 20 20 69 Page==0 );. i
26910 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
26920 20 29 7b 0a 20 20 20 20 20 20 6e 65 78 74 20 3d ){. next =
26930 20 67 65 74 34 62 79 74 65 28 70 50 61 67 65 2d get4byte(pPage-
26940 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 >aData);. }.
26950 20 7d 0a 0a 20 20 2a 70 50 67 6e 6f 4e 65 78 74 }.. *pPgnoNext
26960 20 3d 20 6e 65 78 74 3b 0a 20 20 69 66 28 20 70 = next;. if( p
26970 70 50 61 67 65 20 29 7b 0a 20 20 20 20 2a 70 70 pPage ){. *pp
26980 50 61 67 65 20 3d 20 70 50 61 67 65 3b 0a 20 20 Page = pPage;.
26990 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 6c 65 61 }else{. relea
269a0 73 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 sePage(pPage);.
269b0 20 7d 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d }. return (rc=
269c0 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 3f 20 53 =SQLITE_DONE ? S
269d0 51 4c 49 54 45 5f 4f 4b 20 3a 20 72 63 29 3b 0a QLITE_OK : rc);.
269e0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 70 79 20 64 61 }../*.** Copy da
269f0 74 61 20 66 72 6f 6d 20 61 20 62 75 66 66 65 72 ta from a buffer
26a00 20 74 6f 20 61 20 70 61 67 65 2c 20 6f 72 20 66 to a page, or f
26a10 72 6f 6d 20 61 20 70 61 67 65 20 74 6f 20 61 20 rom a page to a
26a20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 70 50 buffer..**.** pP
26a30 61 79 6c 6f 61 64 20 69 73 20 61 20 70 6f 69 6e ayload is a poin
26a40 74 65 72 20 74 6f 20 64 61 74 61 20 73 74 6f 72 ter to data stor
26a50 65 64 20 6f 6e 20 64 61 74 61 62 61 73 65 20 70 ed on database p
26a60 61 67 65 20 70 44 62 50 61 67 65 2e 0a 2a 2a 20 age pDbPage..**
26a70 49 66 20 61 72 67 75 6d 65 6e 74 20 65 4f 70 20 If argument eOp
26a80 69 73 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 6e is false, then n
26a90 42 79 74 65 20 62 79 74 65 73 20 6f 66 20 64 61 Byte bytes of da
26aa0 74 61 20 61 72 65 20 63 6f 70 69 65 64 0a 2a 2a ta are copied.**
26ab0 20 66 72 6f 6d 20 70 50 61 79 6c 6f 61 64 20 74 from pPayload t
26ac0 6f 20 74 68 65 20 62 75 66 66 65 72 20 70 6f 69 o the buffer poi
26ad0 6e 74 65 64 20 61 74 20 62 79 20 70 42 75 66 2e nted at by pBuf.
26ae0 20 49 66 20 65 4f 70 20 69 73 20 74 72 75 65 2c If eOp is true,
26af0 0a 2a 2a 20 74 68 65 6e 20 73 71 6c 69 74 65 33 .** then sqlite3
26b00 50 61 67 65 72 57 72 69 74 65 28 29 20 69 73 20 PagerWrite() is
26b10 63 61 6c 6c 65 64 20 6f 6e 20 70 44 62 50 61 67 called on pDbPag
26b20 65 20 61 6e 64 20 6e 42 79 74 65 20 62 79 74 65 e and nByte byte
26b30 73 0a 2a 2a 20 6f 66 20 64 61 74 61 20 61 72 65 s.** of data are
26b40 20 63 6f 70 69 65 64 20 66 72 6f 6d 20 74 68 65 copied from the
26b50 20 62 75 66 66 65 72 20 70 42 75 66 20 74 6f 20 buffer pBuf to
26b60 70 50 61 79 6c 6f 61 64 2e 0a 2a 2a 0a 2a 2a 20 pPayload..**.**
26b70 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
26b80 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 73 urned on success
26b90 2c 20 6f 74 68 65 72 77 69 73 65 20 61 6e 20 65 , otherwise an e
26ba0 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 73 74 rror code..*/.st
26bb0 61 74 69 63 20 69 6e 74 20 63 6f 70 79 50 61 79 atic int copyPay
26bc0 6c 6f 61 64 28 0a 20 20 76 6f 69 64 20 2a 70 50 load(. void *pP
26bd0 61 79 6c 6f 61 64 2c 20 20 20 20 20 20 20 20 20 ayload,
26be0 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
26bf0 70 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 20 76 page data */. v
26c00 6f 69 64 20 2a 70 42 75 66 2c 20 20 20 20 20 20 oid *pBuf,
26c10 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
26c20 74 65 72 20 74 6f 20 62 75 66 66 65 72 20 2a 2f ter to buffer */
26c30 0a 20 20 69 6e 74 20 6e 42 79 74 65 2c 20 20 20 . int nByte,
26c40 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
26c50 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 Number of bytes
26c60 74 6f 20 63 6f 70 79 20 2a 2f 0a 20 20 69 6e 74 to copy */. int
26c70 20 65 4f 70 2c 20 20 20 20 20 20 20 20 20 20 20 eOp,
26c80 20 20 20 20 20 20 20 2f 2a 20 30 20 2d 3e 20 63 /* 0 -> c
26c90 6f 70 79 20 66 72 6f 6d 20 70 61 67 65 2c 20 31 opy from page, 1
26ca0 20 2d 3e 20 63 6f 70 79 20 74 6f 20 70 61 67 65 -> copy to page
26cb0 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 70 44 */. DbPage *pD
26cc0 62 50 61 67 65 20 20 20 20 20 20 20 20 20 20 20 bPage
26cd0 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 /* Page containi
26ce0 6e 67 20 70 50 61 79 6c 6f 61 64 20 2a 2f 0a 29 ng pPayload */.)
26cf0 7b 0a 20 20 69 66 28 20 65 4f 70 20 29 7b 0a 20 {. if( eOp ){.
26d00 20 20 20 2f 2a 20 43 6f 70 79 20 64 61 74 61 20 /* Copy data
26d10 66 72 6f 6d 20 62 75 66 66 65 72 20 74 6f 20 70 from buffer to p
26d20 61 67 65 20 28 61 20 77 72 69 74 65 20 6f 70 65 age (a write ope
26d30 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 69 ration) */. i
26d40 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 nt rc = sqlite3P
26d50 61 67 65 72 57 72 69 74 65 28 70 44 62 50 61 67 agerWrite(pDbPag
26d60 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
26d70 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
26d80 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
26d90 20 20 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 }. memcpy(p
26da0 50 61 79 6c 6f 61 64 2c 20 70 42 75 66 2c 20 6e Payload, pBuf, n
26db0 42 79 74 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a Byte);. }else{.
26dc0 20 20 20 20 2f 2a 20 43 6f 70 79 20 64 61 74 61 /* Copy data
26dd0 20 66 72 6f 6d 20 70 61 67 65 20 74 6f 20 62 75 from page to bu
26de0 66 66 65 72 20 28 61 20 72 65 61 64 20 6f 70 65 ffer (a read ope
26df0 72 61 74 69 6f 6e 29 20 2a 2f 0a 20 20 20 20 6d ration) */. m
26e00 65 6d 63 70 79 28 70 42 75 66 2c 20 70 50 61 79 emcpy(pBuf, pPay
26e10 6c 6f 61 64 2c 20 6e 42 79 74 65 29 3b 0a 20 20 load, nByte);.
26e20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
26e30 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 E_OK;.}../*.** T
26e40 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
26e50 75 73 65 64 20 74 6f 20 72 65 61 64 20 6f 72 20 used to read or
26e60 6f 76 65 72 77 72 69 74 65 20 70 61 79 6c 6f 61 overwrite payloa
26e70 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a d information.**
26e80 20 66 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 for the entry t
26e90 68 61 74 20 74 68 65 20 70 43 75 72 20 63 75 72 hat the pCur cur
26ea0 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 sor is pointing
26eb0 74 6f 2e 20 54 68 65 20 65 4f 70 0a 2a 2a 20 61 to. The eOp.** a
26ec0 72 67 75 6d 65 6e 74 20 69 73 20 69 6e 74 65 72 rgument is inter
26ed0 70 72 65 74 65 64 20 61 73 20 66 6f 6c 6c 6f 77 preted as follow
26ee0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 30 3a 20 54 68 s:.**.** 0: Th
26ef0 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 61 e operation is a
26f00 20 72 65 61 64 2e 20 50 6f 70 75 6c 61 74 65 20 read. Populate
26f10 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 61 63 the overflow cac
26f20 68 65 2e 0a 2a 2a 20 20 20 31 3a 20 54 68 65 20 he..** 1: The
26f30 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 61 20 77 operation is a w
26f40 72 69 74 65 2e 20 50 6f 70 75 6c 61 74 65 20 74 rite. Populate t
26f50 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 61 63 68 he overflow cach
26f60 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 74 6f 74 61 6c e..**.** A total
26f70 20 6f 66 20 22 61 6d 74 22 20 62 79 74 65 73 20 of "amt" bytes
26f80 61 72 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 are read or writ
26f90 74 65 6e 20 62 65 67 69 6e 6e 69 6e 67 20 61 74 ten beginning at
26fa0 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 20 44 61 "offset"..** Da
26fb0 74 61 20 69 73 20 72 65 61 64 20 74 6f 20 6f 72 ta is read to or
26fc0 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
26fd0 20 70 42 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 pBuf..**.** The
26fe0 20 63 6f 6e 74 65 6e 74 20 62 65 69 6e 67 20 72 content being r
26ff0 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 20 6d ead or written m
27000 69 67 68 74 20 61 70 70 65 61 72 20 6f 6e 20 74 ight appear on t
27010 68 65 20 6d 61 69 6e 20 70 61 67 65 0a 2a 2a 20 he main page.**
27020 6f 72 20 62 65 20 73 63 61 74 74 65 72 65 64 20 or be scattered
27030 6f 75 74 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 out on multiple
27040 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a overflow pages..
27050 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 72 **.** If the cur
27060 72 65 6e 74 20 63 75 72 73 6f 72 20 65 6e 74 72 rent cursor entr
27070 79 20 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f y uses one or mo
27080 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 re overflow page
27090 73 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 s.** this functi
270a0 6f 6e 20 6d 61 79 20 61 6c 6c 6f 63 61 74 65 20 on may allocate
270b0 73 70 61 63 65 20 66 6f 72 20 61 6e 64 20 6c 61 space for and la
270c0 7a 69 6c 79 20 70 6f 70 75 6c 61 74 65 0a 2a 2a zily populate.**
270d0 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 the overflow pa
270e0 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 61 72 ge-list cache ar
270f0 72 61 79 20 28 42 74 43 75 72 73 6f 72 2e 61 4f ray (BtCursor.aO
27100 76 65 72 66 6c 6f 77 29 2e 20 0a 2a 2a 20 53 75 verflow). .** Su
27110 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 75 bsequent calls u
27120 73 65 20 74 68 69 73 20 63 61 63 68 65 20 74 6f se this cache to
27130 20 6d 61 6b 65 20 73 65 65 6b 69 6e 67 20 74 6f make seeking to
27140 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 6f 66 the supplied of
27150 66 73 65 74 20 0a 2a 2a 20 6d 6f 72 65 20 65 66 fset .** more ef
27160 66 69 63 69 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4f ficient..**.** O
27170 6e 63 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 nce an overflow
27180 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 20 page-list cache
27190 68 61 73 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 has been allocat
271a0 65 64 2c 20 69 74 20 6d 75 73 74 20 62 65 0a 2a ed, it must be.*
271b0 2a 20 69 6e 76 61 6c 69 64 61 74 65 64 20 69 66 * invalidated if
271c0 20 73 6f 6d 65 20 6f 74 68 65 72 20 63 75 72 73 some other curs
271d0 6f 72 20 77 72 69 74 65 73 20 74 6f 20 74 68 65 or writes to the
271e0 20 73 61 6d 65 20 74 61 62 6c 65 2c 20 6f 72 20 same table, or
271f0 69 66 0a 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 if.** the cursor
27200 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 61 20 64 is moved to a d
27210 69 66 66 65 72 65 6e 74 20 72 6f 77 2e 20 41 64 ifferent row. Ad
27220 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 6e 20 61 ditionally, in a
27230 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 6d 6f uto-vacuum.** mo
27240 64 65 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e de, the followin
27250 67 20 65 76 65 6e 74 73 20 6d 61 79 20 69 6e 76 g events may inv
27260 61 6c 69 64 61 74 65 20 61 6e 20 6f 76 65 72 66 alidate an overf
27270 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
27280 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 che..**.** * A
27290 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 76 61 n incremental va
272a0 63 75 75 6d 2c 0a 2a 2a 20 20 20 2a 20 41 20 63 cuum,.** * A c
272b0 6f 6d 6d 69 74 20 69 6e 20 61 75 74 6f 5f 76 61 ommit in auto_va
272c0 63 75 75 6d 3d 22 66 75 6c 6c 22 20 6d 6f 64 65 cuum="full" mode
272d0 2c 0a 2a 2a 20 20 20 2a 20 43 72 65 61 74 69 6e ,.** * Creatin
272e0 67 20 61 20 74 61 62 6c 65 20 28 6d 61 79 20 72 g a table (may r
272f0 65 71 75 69 72 65 20 6d 6f 76 69 6e 67 20 61 6e equire moving an
27300 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 29 2e overflow page).
27310 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 .*/.static int a
27320 63 63 65 73 73 50 61 79 6c 6f 61 64 28 0a 20 20 ccessPayload(.
27330 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
27340 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 70 /* Cursor p
27350 6f 69 6e 74 69 6e 67 20 74 6f 20 65 6e 74 72 79 ointing to entry
27360 20 74 6f 20 72 65 61 64 20 66 72 6f 6d 20 2a 2f to read from */
27370 0a 20 20 75 33 32 20 6f 66 66 73 65 74 2c 20 20 . u32 offset,
27380 20 20 20 20 20 20 20 20 2f 2a 20 42 65 67 69 6e /* Begin
27390 20 72 65 61 64 69 6e 67 20 74 68 69 73 20 66 61 reading this fa
273a0 72 20 69 6e 74 6f 20 70 61 79 6c 6f 61 64 20 2a r into payload *
273b0 2f 0a 20 20 75 33 32 20 61 6d 74 2c 20 20 20 20 /. u32 amt,
273c0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 /* Read
273d0 20 74 68 69 73 20 6d 61 6e 79 20 62 79 74 65 73 this many bytes
273e0 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 */. unsigned c
273f0 68 61 72 20 2a 70 42 75 66 2c 20 2f 2a 20 57 72 har *pBuf, /* Wr
27400 69 74 65 20 74 68 65 20 62 79 74 65 73 20 69 6e ite the bytes in
27410 74 6f 20 74 68 69 73 20 62 75 66 66 65 72 20 2a to this buffer *
27420 2f 20 0a 20 20 69 6e 74 20 65 4f 70 20 20 20 20 / . int eOp
27430 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 65 72 /* zer
27440 6f 20 74 6f 20 72 65 61 64 2e 20 6e 6f 6e 2d 7a o to read. non-z
27450 65 72 6f 20 74 6f 20 77 72 69 74 65 2e 20 2a 2f ero to write. */
27460 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 .){. unsigned c
27470 68 61 72 20 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 har *aPayload;.
27480 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
27490 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 49 64 78 20 _OK;. int iIdx
274a0 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a = 0;. MemPage *
274b0 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 50 pPage = pCur->pP
274c0 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
274d0 20 20 20 2f 2a 20 42 74 72 65 65 20 70 61 67 65 /* Btree page
274e0 20 6f 66 20 63 75 72 72 65 6e 74 20 65 6e 74 72 of current entr
274f0 79 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 y */. BtShared
27500 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 *pBt = pCur->pBt
27510 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
27520 20 20 20 2f 2a 20 42 74 72 65 65 20 74 68 69 73 /* Btree this
27530 20 63 75 72 73 6f 72 20 62 65 6c 6f 6e 67 73 20 cursor belongs
27540 74 6f 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c to */.#ifdef SQL
27550 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 ITE_DIRECT_OVERF
27560 4c 4f 57 5f 52 45 41 44 0a 20 20 75 6e 73 69 67 LOW_READ. unsig
27570 6e 65 64 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 ned char * const
27580 20 70 42 75 66 53 74 61 72 74 20 3d 20 70 42 75 pBufStart = pBu
27590 66 3b 20 20 20 20 20 2f 2a 20 53 74 61 72 74 20 f; /* Start
275a0 6f 66 20 6f 72 69 67 69 6e 61 6c 20 6f 75 74 20 of original out
275b0 62 75 66 66 65 72 20 2a 2f 0a 23 65 6e 64 69 66 buffer */.#endif
275c0 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
275d0 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 65 e );. assert( e
275e0 4f 70 3d 3d 30 20 7c 7c 20 65 4f 70 3d 3d 31 20 Op==0 || eOp==1
275f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
27600 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
27610 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
27620 65 72 74 28 20 70 43 75 72 2d 3e 69 78 3c 70 50 ert( pCur->ix<pP
27630 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 age->nCell );.
27640 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
27650 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
27660 3b 0a 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f ;.. getCellInfo
27670 28 70 43 75 72 29 3b 0a 20 20 61 50 61 79 6c 6f (pCur);. aPaylo
27680 61 64 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e ad = pCur->info.
27690 70 50 61 79 6c 6f 61 64 3b 0a 20 20 61 73 73 65 pPayload;. asse
276a0 72 74 28 20 6f 66 66 73 65 74 2b 61 6d 74 20 3c rt( offset+amt <
276b0 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 = pCur->info.nPa
276c0 79 6c 6f 61 64 20 29 3b 0a 0a 20 20 61 73 73 65 yload );.. asse
276d0 72 74 28 20 61 50 61 79 6c 6f 61 64 20 3e 20 70 rt( aPayload > p
276e0 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 Page->aData );.
276f0 20 69 66 28 20 28 75 70 74 72 29 28 61 50 61 79 if( (uptr)(aPay
27700 6c 6f 61 64 20 2d 20 70 50 61 67 65 2d 3e 61 44 load - pPage->aD
27710 61 74 61 29 20 3e 20 28 70 42 74 2d 3e 75 73 61 ata) > (pBt->usa
27720 62 6c 65 53 69 7a 65 20 2d 20 70 43 75 72 2d 3e bleSize - pCur->
27730 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 29 20 29 7b 0a info.nLocal) ){.
27740 20 20 20 20 2f 2a 20 54 72 79 69 6e 67 20 74 6f /* Trying to
27750 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 70 read or write p
27760 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ast the end of t
27770 68 65 20 64 61 74 61 20 69 73 20 61 6e 20 65 72 he data is an er
27780 72 6f 72 2e 20 20 54 68 65 0a 20 20 20 20 2a 2a ror. The. **
27790 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 62 6f conditional abo
277a0 76 65 20 69 73 20 72 65 61 6c 6c 79 3a 0a 20 20 ve is really:.
277b0 20 20 2a 2a 20 20 20 20 26 61 50 61 79 6c 6f 61 ** &aPayloa
277c0 64 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f d[pCur->info.nLo
277d0 63 61 6c 5d 20 3e 20 26 70 50 61 67 65 2d 3e 61 cal] > &pPage->a
277e0 44 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 Data[pBt->usable
277f0 53 69 7a 65 5d 0a 20 20 20 20 2a 2a 20 62 75 74 Size]. ** but
27800 20 69 73 20 72 65 63 61 73 74 20 69 6e 74 6f 20 is recast into
27810 69 74 73 20 63 75 72 72 65 6e 74 20 66 6f 72 6d its current form
27820 20 74 6f 20 61 76 6f 69 64 20 69 6e 74 65 67 65 to avoid intege
27830 72 20 6f 76 65 72 66 6c 6f 77 20 70 72 6f 62 6c r overflow probl
27840 65 6d 73 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 ems. */. r
27850 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
27860 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 RUPT_PAGE(pPage)
27870 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 ;. }.. /* Chec
27880 6b 20 69 66 20 64 61 74 61 20 6d 75 73 74 20 62 k if data must b
27890 65 20 72 65 61 64 2f 77 72 69 74 74 65 6e 20 74 e read/written t
278a0 6f 2f 66 72 6f 6d 20 74 68 65 20 62 74 72 65 65 o/from the btree
278b0 20 70 61 67 65 20 69 74 73 65 6c 66 2e 20 2a 2f page itself. */
278c0 0a 20 20 69 66 28 20 6f 66 66 73 65 74 3c 70 43 . if( offset<pC
278d0 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 ur->info.nLocal
278e0 29 7b 0a 20 20 20 20 69 6e 74 20 61 20 3d 20 61 ){. int a = a
278f0 6d 74 3b 0a 20 20 20 20 69 66 28 20 61 2b 6f 66 mt;. if( a+of
27900 66 73 65 74 3e 70 43 75 72 2d 3e 69 6e 66 6f 2e fset>pCur->info.
27910 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 nLocal ){.
27920 61 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e a = pCur->info.n
27930 4c 6f 63 61 6c 20 2d 20 6f 66 66 73 65 74 3b 0a Local - offset;.
27940 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 63 }. rc = c
27950 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 50 61 79 opyPayload(&aPay
27960 6c 6f 61 64 5b 6f 66 66 73 65 74 5d 2c 20 70 42 load[offset], pB
27970 75 66 2c 20 61 2c 20 65 4f 70 2c 20 70 50 61 67 uf, a, eOp, pPag
27980 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
27990 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 offset = 0;.
279a0 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 pBuf += a;.
279b0 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 amt -= a;. }els
279c0 65 7b 0a 20 20 20 20 6f 66 66 73 65 74 20 2d 3d e{. offset -=
279d0 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 pCur->info.nLoc
279e0 61 6c 3b 0a 20 20 7d 0a 0a 0a 20 20 69 66 28 20 al;. }... if(
279f0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
27a00 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f amt>0 ){. co
27a10 6e 73 74 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 nst u32 ovflSize
27a20 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 = pBt->usableSi
27a30 7a 65 20 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 ze - 4; /* Byte
27a40 73 20 63 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 s content per ov
27a50 66 6c 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 fl page */. P
27a60 67 6e 6f 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 gno nextPage;..
27a70 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 nextPage = ge
27a80 74 34 62 79 74 65 28 26 61 50 61 79 6c 6f 61 64 t4byte(&aPayload
27a90 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 [pCur->info.nLoc
27aa0 61 6c 5d 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 al]);.. /* If
27ab0 20 74 68 65 20 42 74 43 75 72 73 6f 72 2e 61 4f the BtCursor.aO
27ac0 76 65 72 66 6c 6f 77 5b 5d 20 68 61 73 20 6e 6f verflow[] has no
27ad0 74 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 t been allocated
27ae0 2c 20 61 6c 6c 6f 63 61 74 65 20 69 74 20 6e 6f , allocate it no
27af0 77 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a w.. **. **
27b00 20 54 68 65 20 61 4f 76 65 72 66 6c 6f 77 5b 5d The aOverflow[]
27b10 20 61 72 72 61 79 20 69 73 20 73 69 7a 65 64 20 array is sized
27b20 61 74 20 6f 6e 65 20 65 6e 74 72 79 20 66 6f 72 at one entry for
27b30 20 65 61 63 68 20 6f 76 65 72 66 6c 6f 77 20 70 each overflow p
27b40 61 67 65 0a 20 20 20 20 2a 2a 20 69 6e 20 74 68 age. ** in th
27b50 65 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e e overflow chain
27b60 2e 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 65 . The page numbe
27b70 72 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f r of the first o
27b80 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 0a verflow page is.
27b90 20 20 20 20 2a 2a 20 73 74 6f 72 65 64 20 69 6e ** stored in
27ba0 20 61 4f 76 65 72 66 6c 6f 77 5b 30 5d 2c 20 65 aOverflow[0], e
27bb0 74 63 2e 20 41 20 76 61 6c 75 65 20 6f 66 20 30 tc. A value of 0
27bc0 20 69 6e 20 74 68 65 20 61 4f 76 65 72 66 6c 6f in the aOverflo
27bd0 77 5b 5d 20 61 72 72 61 79 0a 20 20 20 20 2a 2a w[] array. **
27be0 20 6d 65 61 6e 73 20 22 6e 6f 74 20 79 65 74 20 means "not yet
27bf0 6b 6e 6f 77 6e 22 20 28 74 68 65 20 63 61 63 68 known" (the cach
27c00 65 20 69 73 20 6c 61 7a 69 6c 79 20 70 6f 70 75 e is lazily popu
27c10 6c 61 74 65 64 29 2e 0a 20 20 20 20 2a 2f 0a 20 lated).. */.
27c20 20 20 20 69 66 28 20 28 70 43 75 72 2d 3e 63 75 if( (pCur->cu
27c30 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 rFlags & BTCF_Va
27c40 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 29 7b 0a 20 lidOvfl)==0 ){.
27c50 20 20 20 20 20 69 6e 74 20 6e 4f 76 66 6c 20 3d int nOvfl =
27c60 20 28 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 50 61 (pCur->info.nPa
27c70 79 6c 6f 61 64 2d 70 43 75 72 2d 3e 69 6e 66 6f yload-pCur->info
27c80 2e 6e 4c 6f 63 61 6c 2b 6f 76 66 6c 53 69 7a 65 .nLocal+ovflSize
27c90 2d 31 29 2f 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 -1)/ovflSize;.
27ca0 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 61 4f if( pCur->aO
27cb0 76 65 72 66 6c 6f 77 3d 3d 30 0a 20 20 20 20 20 verflow==0.
27cc0 20 20 7c 7c 20 6e 4f 76 66 6c 2a 28 69 6e 74 29 || nOvfl*(int)
27cd0 73 69 7a 65 6f 66 28 50 67 6e 6f 29 20 3e 20 73 sizeof(Pgno) > s
27ce0 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 qlite3MallocSize
27cf0 28 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 (pCur->aOverflow
27d00 29 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ). ){.
27d10 20 20 20 50 67 6e 6f 20 2a 61 4e 65 77 20 3d 20 Pgno *aNew =
27d20 28 50 67 6e 6f 2a 29 73 71 6c 69 74 65 33 52 65 (Pgno*)sqlite3Re
27d30 61 6c 6c 6f 63 28 0a 20 20 20 20 20 20 20 20 20 alloc(.
27d40 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c pCur->aOverfl
27d50 6f 77 2c 20 6e 4f 76 66 6c 2a 32 2a 73 69 7a 65 ow, nOvfl*2*size
27d60 6f 66 28 50 67 6e 6f 29 0a 20 20 20 20 20 20 20 of(Pgno).
27d70 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 );. if(
27d80 61 4e 65 77 3d 3d 30 20 29 7b 0a 20 20 20 20 20 aNew==0 ){.
27d90 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
27da0 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
27db0 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
27dc0 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 61 4f pCur->aO
27dd0 76 65 72 66 6c 6f 77 20 3d 20 61 4e 65 77 3b 0a verflow = aNew;.
27de0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
27df0 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 }. memset(p
27e00 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 Cur->aOverflow,
27e10 30 2c 20 6e 4f 76 66 6c 2a 73 69 7a 65 6f 66 28 0, nOvfl*sizeof(
27e20 50 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 70 43 Pgno));. pC
27e30 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 ur->curFlags |=
27e40 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 3b 0a BTCF_ValidOvfl;.
27e50 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
27e60 20 2f 2a 20 49 66 20 74 68 65 20 6f 76 65 72 66 /* If the overf
27e70 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
27e80 63 68 65 20 68 61 73 20 62 65 65 6e 20 61 6c 6c che has been all
27e90 6f 63 61 74 65 64 20 61 6e 64 20 74 68 65 0a 20 ocated and the.
27ea0 20 20 20 20 20 2a 2a 20 65 6e 74 72 79 20 66 6f ** entry fo
27eb0 72 20 74 68 65 20 66 69 72 73 74 20 72 65 71 75 r the first requ
27ec0 69 72 65 64 20 6f 76 65 72 66 6c 6f 77 20 70 61 ired overflow pa
27ed0 67 65 20 69 73 20 76 61 6c 69 64 2c 20 73 6b 69 ge is valid, ski
27ee0 70 0a 20 20 20 20 20 20 2a 2a 20 64 69 72 65 63 p. ** direc
27ef0 74 6c 79 20 74 6f 20 69 74 2e 0a 20 20 20 20 20 tly to it..
27f00 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 43 */. if( pC
27f10 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 6f 66 ur->aOverflow[of
27f20 66 73 65 74 2f 6f 76 66 6c 53 69 7a 65 5d 20 29 fset/ovflSize] )
27f30 7b 0a 20 20 20 20 20 20 20 20 69 49 64 78 20 3d {. iIdx =
27f40 20 28 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 7a (offset/ovflSiz
27f50 65 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 78 74 e);. next
27f60 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 Page = pCur->aOv
27f70 65 72 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a 20 20 erflow[iIdx];.
27f80 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 28 offset = (
27f90 6f 66 66 73 65 74 25 6f 76 66 6c 53 69 7a 65 29 offset%ovflSize)
27fa0 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
27fb0 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d . assert( rc=
27fc0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 61 6d =SQLITE_OK && am
27fd0 74 3e 30 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 t>0 );. while
27fe0 28 20 6e 65 78 74 50 61 67 65 20 29 7b 0a 20 20 ( nextPage ){.
27ff0 20 20 20 20 2f 2a 20 49 66 20 72 65 71 75 69 72 /* If requir
28000 65 64 2c 20 70 6f 70 75 6c 61 74 65 20 74 68 65 ed, populate the
28010 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c overflow page-l
28020 69 73 74 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20 ist cache. */.
28030 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
28040 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 ->aOverflow[iIdx
28050 5d 3d 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 ]==0.
28060 20 20 20 7c 7c 20 70 43 75 72 2d 3e 61 4f 76 65 || pCur->aOve
28070 72 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d 6e 65 78 rflow[iIdx]==nex
28080 74 50 61 67 65 0a 20 20 20 20 20 20 20 20 20 20 tPage.
28090 20 20 20 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 || CORRUPT_D
280a0 42 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 2d B );. pCur-
280b0 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d >aOverflow[iIdx]
280c0 20 3d 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 = nextPage;..
280d0 20 20 20 20 69 66 28 20 6f 66 66 73 65 74 3e 3d if( offset>=
280e0 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 ovflSize ){.
280f0 20 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c 79 20 /* The only
28100 72 65 61 73 6f 6e 20 74 6f 20 72 65 61 64 20 74 reason to read t
28110 68 69 73 20 70 61 67 65 20 69 73 20 74 6f 20 6f his page is to o
28120 62 74 61 69 6e 20 74 68 65 20 70 61 67 65 0a 20 btain the page.
28130 20 20 20 20 20 20 20 2a 2a 20 6e 75 6d 62 65 72 ** number
28140 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 70 61 for the next pa
28150 67 65 20 69 6e 20 74 68 65 20 6f 76 65 72 66 6c ge in the overfl
28160 6f 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 61 ow chain. The pa
28170 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 61 ge. ** da
28180 74 61 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 ta is not requir
28190 65 64 2e 20 53 6f 20 66 69 72 73 74 20 74 72 79 ed. So first try
281a0 20 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 6f to lookup the o
281b0 76 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 verflow.
281c0 2a 2a 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ** page-list cac
281d0 68 65 2c 20 69 66 20 61 6e 79 2c 20 74 68 65 6e he, if any, then
281e0 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 74 68 fall back to th
281f0 65 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 e getOverflowPag
28200 65 28 29 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 e(). ** f
28210 75 6e 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 20 unction..
28220 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 73 65 */. asse
28230 72 74 28 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 rt( pCur->curFla
28240 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 64 4f gs & BTCF_ValidO
28250 76 66 6c 20 29 3b 0a 20 20 20 20 20 20 20 20 61 vfl );. a
28260 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 42 74 ssert( pCur->pBt
28270 72 65 65 2d 3e 64 62 3d 3d 70 42 74 2d 3e 64 62 ree->db==pBt->db
28280 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 );. if(
28290 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
282a0 69 49 64 78 2b 31 5d 20 29 7b 0a 20 20 20 20 20 iIdx+1] ){.
282b0 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
282c0 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
282d0 69 49 64 78 2b 31 5d 3b 0a 20 20 20 20 20 20 20 iIdx+1];.
282e0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
282f0 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 66 6c rc = getOverfl
28300 6f 77 50 61 67 65 28 70 42 74 2c 20 6e 65 78 74 owPage(pBt, next
28310 50 61 67 65 2c 20 30 2c 20 26 6e 65 78 74 50 61 Page, 0, &nextPa
28320 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ge);. }.
28330 20 20 20 20 20 20 20 6f 66 66 73 65 74 20 2d 3d offset -=
28340 20 6f 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 ovflSize;.
28350 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
28360 2f 2a 20 4e 65 65 64 20 74 6f 20 72 65 61 64 20 /* Need to read
28370 74 68 69 73 20 70 61 67 65 20 70 72 6f 70 65 72 this page proper
28380 6c 79 2e 20 49 74 20 63 6f 6e 74 61 69 6e 73 20 ly. It contains
28390 73 6f 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20 some of the.
283a0 20 20 20 20 2a 2a 20 72 61 6e 67 65 20 6f 66 20 ** range of
283b0 64 61 74 61 20 74 68 61 74 20 69 73 20 62 65 69 data that is bei
283c0 6e 67 20 72 65 61 64 20 28 65 4f 70 3d 3d 30 29 ng read (eOp==0)
283d0 20 6f 72 20 77 72 69 74 74 65 6e 20 28 65 4f 70 or written (eOp
283e0 21 3d 30 29 2e 0a 20 20 20 20 20 20 20 20 2a 2f !=0).. */
283f0 0a 20 20 20 20 20 20 20 20 69 6e 74 20 61 20 3d . int a =
28400 20 61 6d 74 3b 0a 20 20 20 20 20 20 20 20 69 66 amt;. if
28410 28 20 61 20 2b 20 6f 66 66 73 65 74 20 3e 20 6f ( a + offset > o
28420 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 vflSize ){.
28430 20 20 20 20 20 61 20 3d 20 6f 76 66 6c 53 69 7a a = ovflSiz
28440 65 20 2d 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 e - offset;.
28450 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 }..#ifdef SQ
28460 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 LITE_DIRECT_OVER
28470 46 4c 4f 57 5f 52 45 41 44 0a 20 20 20 20 20 20 FLOW_READ.
28480 20 20 2f 2a 20 49 66 20 61 6c 6c 20 74 68 65 20 /* If all the
28490 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 following are tr
284a0 75 65 3a 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 ue:. **.
284b0 20 20 20 20 20 20 20 2a 2a 20 20 20 31 29 20 74 ** 1) t
284c0 68 69 73 20 69 73 20 61 20 72 65 61 64 20 6f 70 his is a read op
284d0 65 72 61 74 69 6f 6e 2c 20 61 6e 64 20 0a 20 20 eration, and .
284e0 20 20 20 20 20 20 2a 2a 20 20 20 32 29 20 64 61 ** 2) da
284f0 74 61 20 69 73 20 72 65 71 75 69 72 65 64 20 66 ta is required f
28500 72 6f 6d 20 74 68 65 20 73 74 61 72 74 20 6f 66 rom the start of
28510 20 74 68 69 73 20 6f 76 65 72 66 6c 6f 77 20 70 this overflow p
28520 61 67 65 2c 20 61 6e 64 0a 20 20 20 20 20 20 20 age, and.
28530 20 2a 2a 20 20 20 33 29 20 74 68 65 72 65 20 61 ** 3) there a
28540 72 65 20 6e 6f 20 64 69 72 74 79 20 70 61 67 65 re no dirty page
28550 73 20 69 6e 20 74 68 65 20 70 61 67 65 2d 63 61 s in the page-ca
28560 63 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 che. **
28570 20 34 29 20 74 68 65 20 64 61 74 61 62 61 73 65 4) the database
28580 20 69 73 20 66 69 6c 65 2d 62 61 63 6b 65 64 2c is file-backed,
28590 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 and. **
285a0 20 20 35 29 20 74 68 65 20 70 61 67 65 20 69 73 5) the page is
285b0 20 6e 6f 74 20 69 6e 20 74 68 65 20 57 41 4c 20 not in the WAL
285c0 66 69 6c 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 file. **
285d0 20 20 36 29 20 61 74 20 6c 65 61 73 74 20 34 20 6) at least 4
285e0 62 79 74 65 73 20 68 61 76 65 20 61 6c 72 65 61 bytes have alrea
285f0 64 79 20 62 65 65 6e 20 72 65 61 64 20 69 6e 74 dy been read int
28600 6f 20 74 68 65 20 6f 75 74 70 75 74 20 62 75 66 o the output buf
28610 66 65 72 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a fer . **.
28620 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 ** then
28630 64 61 74 61 20 63 61 6e 20 62 65 20 72 65 61 64 data can be read
28640 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 directly from t
28650 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
28660 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 into the.
28670 20 20 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 66 ** output buff
28680 65 72 2c 20 62 79 70 61 73 73 69 6e 67 20 74 68 er, bypassing th
28690 65 20 70 61 67 65 2d 63 61 63 68 65 20 61 6c 74 e page-cache alt
286a0 6f 67 65 74 68 65 72 2e 20 54 68 69 73 20 73 70 ogether. This sp
286b0 65 65 64 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 eeds. **
286c0 75 70 20 6c 6f 61 64 69 6e 67 20 6c 61 72 67 65 up loading large
286d0 20 72 65 63 6f 72 64 73 20 74 68 61 74 20 73 70 records that sp
286e0 61 6e 20 6d 61 6e 79 20 6f 76 65 72 66 6c 6f 77 an many overflow
286f0 20 70 61 67 65 73 2e 0a 20 20 20 20 20 20 20 20 pages..
28700 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 65 */. if( e
28710 4f 70 3d 3d 30 20 20 20 20 20 20 20 20 20 20 20 Op==0
28720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28740 20 20 2f 2a 20 28 31 29 20 2a 2f 0a 20 20 20 20 /* (1) */.
28750 20 20 20 20 20 26 26 20 6f 66 66 73 65 74 3d 3d && offset==
28760 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
28770 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28780 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 32 /* (2
28790 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 ) */. &&
287a0 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 69 72 sqlite3PagerDir
287b0 65 63 74 52 65 61 64 4f 6b 28 70 42 74 2d 3e 70 ectReadOk(pBt->p
287c0 50 61 67 65 72 2c 20 6e 65 78 74 50 61 67 65 29 Pager, nextPage)
287d0 20 20 20 20 2f 2a 20 28 33 2c 34 2c 35 29 20 2a /* (3,4,5) *
287e0 2f 0a 20 20 20 20 20 20 20 20 20 26 26 20 26 70 /. && &p
287f0 42 75 66 5b 2d 34 5d 3e 3d 70 42 75 66 53 74 61 Buf[-4]>=pBufSta
28800 72 74 20 20 20 20 20 20 20 20 20 20 20 20 20 20 rt
28810 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28820 20 2f 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 /* (6) */.
28830 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ){.
28840 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
28850 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 = sqlite3PagerF
28860 69 6c 65 28 70 42 74 2d 3e 70 50 61 67 65 72 29 ile(pBt->pPager)
28870 3b 0a 20 20 20 20 20 20 20 20 20 20 75 38 20 61 ;. u8 a
28880 53 61 76 65 5b 34 5d 3b 0a 20 20 20 20 20 20 20 Save[4];.
28890 20 20 20 75 38 20 2a 61 57 72 69 74 65 20 3d 20 u8 *aWrite =
288a0 26 70 42 75 66 5b 2d 34 5d 3b 0a 20 20 20 20 20 &pBuf[-4];.
288b0 20 20 20 20 20 61 73 73 65 72 74 28 20 61 57 72 assert( aWr
288c0 69 74 65 3e 3d 70 42 75 66 53 74 61 72 74 20 29 ite>=pBufStart )
288d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
288e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 64 75 65 /* due
288f0 20 74 6f 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 to (6) */.
28900 20 20 20 20 20 6d 65 6d 63 70 79 28 61 53 61 76 memcpy(aSav
28910 65 2c 20 61 57 72 69 74 65 2c 20 34 29 3b 0a 20 e, aWrite, 4);.
28920 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
28930 6c 69 74 65 33 4f 73 52 65 61 64 28 66 64 2c 20 lite3OsRead(fd,
28940 61 57 72 69 74 65 2c 20 61 2b 34 2c 20 28 69 36 aWrite, a+4, (i6
28950 34 29 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2a 4)pBt->pageSize*
28960 28 6e 65 78 74 50 61 67 65 2d 31 29 29 3b 0a 20 (nextPage-1));.
28970 20 20 20 20 20 20 20 20 20 6e 65 78 74 50 61 67 nextPag
28980 65 20 3d 20 67 65 74 34 62 79 74 65 28 61 57 72 e = get4byte(aWr
28990 69 74 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ite);.
289a0 6d 65 6d 63 70 79 28 61 57 72 69 74 65 2c 20 61 memcpy(aWrite, a
289b0 53 61 76 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 Save, 4);.
289c0 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 0a 0a }else.#endif..
289d0 20 20 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 {.
289e0 20 20 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 DbPage *pDbP
289f0 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 72 age;. r
28a00 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
28a10 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c Get(pBt->pPager,
28a20 20 6e 65 78 74 50 61 67 65 2c 20 26 70 44 62 50 nextPage, &pDbP
28a30 61 67 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 age,.
28a40 20 20 20 28 65 4f 70 3d 3d 30 20 3f 20 50 41 47 (eOp==0 ? PAG
28a50 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 ER_GET_READONLY
28a60 3a 20 30 29 0a 20 20 20 20 20 20 20 20 20 20 29 : 0). )
28a70 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
28a80 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
28a90 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 50 61 . aPa
28aa0 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 33 50 yload = sqlite3P
28ab0 61 67 65 72 47 65 74 44 61 74 61 28 70 44 62 50 agerGetData(pDbP
28ac0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
28ad0 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 nextPage = get
28ae0 34 62 79 74 65 28 61 50 61 79 6c 6f 61 64 29 3b 4byte(aPayload);
28af0 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
28b00 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 = copyPayload(&a
28b10 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 2b 34 Payload[offset+4
28b20 5d 2c 20 70 42 75 66 2c 20 61 2c 20 65 4f 70 2c ], pBuf, a, eOp,
28b30 20 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 pDbPage);.
28b40 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 sqlite3Pa
28b50 67 65 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 gerUnref(pDbPage
28b60 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6f );. o
28b70 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 20 20 ffset = 0;.
28b80 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
28b90 0a 20 20 20 20 20 20 20 20 61 6d 74 20 2d 3d 20 . amt -=
28ba0 61 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 61 a;. if( a
28bb0 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 72 mt==0 ) return r
28bc0 63 3b 0a 20 20 20 20 20 20 20 20 70 42 75 66 20 c;. pBuf
28bd0 2b 3d 20 61 3b 0a 20 20 20 20 20 20 7d 0a 20 20 += a;. }.
28be0 20 20 20 20 69 66 28 20 72 63 20 29 20 62 72 65 if( rc ) bre
28bf0 61 6b 3b 0a 20 20 20 20 20 20 69 49 64 78 2b 2b ak;. iIdx++
28c00 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 ;. }. }.. i
28c10 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
28c20 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a 20 20 20 && amt>0 ){.
28c30 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 63 68 61 /* Overflow cha
28c40 69 6e 20 65 6e 64 73 20 70 72 65 6d 61 74 75 72 in ends prematur
28c50 65 6c 79 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 ely */. retur
28c60 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
28c70 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
28c80 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
28c90 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 61 72 ../*.** Read par
28ca0 74 20 6f 66 20 74 68 65 20 70 61 79 6c 6f 61 64 t of the payload
28cb0 20 66 6f 72 20 74 68 65 20 72 6f 77 20 61 74 20 for the row at
28cc0 77 68 69 63 68 20 74 68 61 74 20 63 75 72 73 6f which that curso
28cd0 72 20 70 43 75 72 20 69 73 20 63 75 72 72 65 6e r pCur is curren
28ce0 74 6c 79 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 2e tly.** pointing.
28cf0 20 20 22 61 6d 74 22 20 62 79 74 65 73 20 77 69 "amt" bytes wi
28d00 6c 6c 20 62 65 20 74 72 61 6e 73 66 65 72 72 65 ll be transferre
28d10 64 20 69 6e 74 6f 20 70 42 75 66 5b 5d 2e 20 20 d into pBuf[].
28d20 54 68 65 20 74 72 61 6e 73 66 65 72 0a 2a 2a 20 The transfer.**
28d30 62 65 67 69 6e 73 20 61 74 20 22 6f 66 66 73 65 begins at "offse
28d40 74 22 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 20 63 t"..**.** pCur c
28d50 61 6e 20 62 65 20 70 6f 69 6e 74 69 6e 67 20 74 an be pointing t
28d60 6f 20 65 69 74 68 65 72 20 61 20 74 61 62 6c 65 o either a table
28d70 20 6f 72 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 or an index b-t
28d80 72 65 65 2e 0a 2a 2a 20 49 66 20 70 6f 69 6e 74 ree..** If point
28d90 69 6e 67 20 74 6f 20 61 20 74 61 62 6c 65 20 62 ing to a table b
28da0 74 72 65 65 2c 20 74 68 65 6e 20 74 68 65 20 63 tree, then the c
28db0 6f 6e 74 65 6e 74 20 73 65 63 74 69 6f 6e 20 69 ontent section i
28dc0 73 20 72 65 61 64 2e 20 20 49 66 0a 2a 2a 20 70 s read. If.** p
28dd0 43 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 Cur is pointing
28de0 74 6f 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 to an index b-tr
28df0 65 65 20 74 68 65 6e 20 74 68 65 20 6b 65 79 20 ee then the key
28e00 73 65 63 74 69 6f 6e 20 69 73 20 72 65 61 64 2e section is read.
28e10 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 73 71 6c 69 74 .**.** For sqlit
28e20 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 29 e3BtreePayload()
28e30 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 , the caller mus
28e40 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 70 43 t ensure that pC
28e50 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 0a 2a ur is pointing.*
28e60 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 72 6f 77 * to a valid row
28e70 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 20 in the table.
28e80 46 6f 72 20 73 71 6c 69 74 65 33 42 74 72 65 65 For sqlite3Btree
28e90 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 29 PayloadChecked()
28ea0 2c 20 74 68 65 0a 2a 2a 20 63 75 72 73 6f 72 20 , the.** cursor
28eb0 6d 69 67 68 74 20 62 65 20 69 6e 76 61 6c 69 64 might be invalid
28ec0 20 6f 72 20 6d 69 67 68 74 20 6e 65 65 64 20 74 or might need t
28ed0 6f 20 62 65 20 72 65 73 74 6f 72 65 64 20 62 65 o be restored be
28ee0 66 6f 72 65 20 62 65 69 6e 67 20 72 65 61 64 2e fore being read.
28ef0 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 .**.** Return SQ
28f00 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 LITE_OK on succe
28f10 73 73 20 6f 72 20 61 6e 20 65 72 72 6f 72 20 63 ss or an error c
28f20 6f 64 65 20 69 66 20 61 6e 79 74 68 69 6e 67 20 ode if anything
28f30 67 6f 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e 20 20 goes.** wrong.
28f40 41 6e 20 65 72 72 6f 72 20 69 73 20 72 65 74 75 An error is retu
28f50 72 6e 65 64 20 69 66 20 22 6f 66 66 73 65 74 2b rned if "offset+
28f60 61 6d 74 22 20 69 73 20 6c 61 72 67 65 72 20 74 amt" is larger t
28f70 68 61 6e 0a 2a 2a 20 74 68 65 20 61 76 61 69 6c han.** the avail
28f80 61 62 6c 65 20 70 61 79 6c 6f 61 64 2e 0a 2a 2f able payload..*/
28f90 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
28fa0 65 50 61 79 6c 6f 61 64 28 42 74 43 75 72 73 6f ePayload(BtCurso
28fb0 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6f 66 66 r *pCur, u32 off
28fc0 73 65 74 2c 20 75 33 32 20 61 6d 74 2c 20 76 6f set, u32 amt, vo
28fd0 69 64 20 2a 70 42 75 66 29 7b 0a 20 20 61 73 73 id *pBuf){. ass
28fe0 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
28ff0 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 Mutex(pCur) );.
29000 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
29010 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
29020 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
29030 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 pCur->iPage>=0
29040 26 26 20 70 43 75 72 2d 3e 70 50 61 67 65 20 29 && pCur->pPage )
29050 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
29060 2d 3e 69 78 3c 70 43 75 72 2d 3e 70 50 61 67 65 ->ix<pCur->pPage
29070 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 72 65 74 ->nCell );. ret
29080 75 72 6e 20 61 63 63 65 73 73 50 61 79 6c 6f 61 urn accessPayloa
29090 64 28 70 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 d(pCur, offset,
290a0 61 6d 74 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 amt, (unsigned c
290b0 68 61 72 2a 29 70 42 75 66 2c 20 30 29 3b 0a 7d har*)pBuf, 0);.}
290c0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 76 61 72 ../*.** This var
290d0 69 61 6e 74 20 6f 66 20 73 71 6c 69 74 65 33 42 iant of sqlite3B
290e0 74 72 65 65 50 61 79 6c 6f 61 64 28 29 20 77 6f treePayload() wo
290f0 72 6b 73 20 65 76 65 6e 20 69 66 20 74 68 65 20 rks even if the
29100 63 75 72 73 6f 72 20 68 61 73 20 6e 6f 74 0a 2a cursor has not.*
29110 2a 20 69 6e 20 74 68 65 20 43 55 52 53 4f 52 5f * in the CURSOR_
29120 56 41 4c 49 44 20 73 74 61 74 65 2e 20 20 49 74 VALID state. It
29130 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 62 79 is only used by
29140 20 74 68 65 20 73 71 6c 69 74 65 33 5f 62 6c 6f the sqlite3_blo
29150 62 5f 72 65 61 64 28 29 0a 2a 2a 20 69 6e 74 65 b_read().** inte
29160 72 66 61 63 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 rface..*/.#ifnde
29170 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e f SQLITE_OMIT_IN
29180 43 52 42 4c 4f 42 0a 73 74 61 74 69 63 20 53 51 CRBLOB.static SQ
29190 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 69 6e LITE_NOINLINE in
291a0 74 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 43 t accessPayloadC
291b0 68 65 63 6b 65 64 28 0a 20 20 42 74 43 75 72 73 hecked(. BtCurs
291c0 6f 72 20 2a 70 43 75 72 2c 0a 20 20 75 33 32 20 or *pCur,. u32
291d0 6f 66 66 73 65 74 2c 0a 20 20 75 33 32 20 61 6d offset,. u32 am
291e0 74 2c 0a 20 20 76 6f 69 64 20 2a 70 42 75 66 0a t,. void *pBuf.
291f0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 ){. int rc;. i
29200 66 20 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 f ( pCur->eState
29210 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
29220 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
29230 51 4c 49 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d QLITE_ABORT;. }
29240 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
29250 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 rOwnsBtShared(pC
29260 75 72 29 20 29 3b 0a 20 20 72 63 20 3d 20 62 74 ur) );. rc = bt
29270 72 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 reeRestoreCursor
29280 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a Position(pCur);.
29290 20 20 72 65 74 75 72 6e 20 72 63 20 3f 20 72 63 return rc ? rc
292a0 20 3a 20 61 63 63 65 73 73 50 61 79 6c 6f 61 64 : accessPayload
292b0 28 70 43 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 (pCur, offset, a
292c0 6d 74 2c 20 70 42 75 66 2c 20 30 29 3b 0a 7d 0a mt, pBuf, 0);.}.
292d0 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
292e0 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 42 PayloadChecked(B
292f0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 tCursor *pCur, u
29300 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 20 61 32 offset, u32 a
29310 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 29 7b mt, void *pBuf){
29320 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
29330 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
29340 44 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 D ){. assert(
29350 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
29360 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 20 red(pCur) );.
29370 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 return accessPa
29380 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 yload(pCur, offs
29390 65 74 2c 20 61 6d 74 2c 20 70 42 75 66 2c 20 30 et, amt, pBuf, 0
293a0 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
293b0 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 79 return accessPay
293c0 6c 6f 61 64 43 68 65 63 6b 65 64 28 70 43 75 72 loadChecked(pCur
293d0 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 70 , offset, amt, p
293e0 42 75 66 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 Buf);. }.}.#end
293f0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
29400 54 5f 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a 0a 2f T_INCRBLOB */../
29410 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 6f *.** Return a po
29420 69 6e 74 65 72 20 74 6f 20 70 61 79 6c 6f 61 64 inter to payload
29430 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f information fro
29440 6d 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 m the entry that
29450 20 74 68 65 20 0a 2a 2a 20 70 43 75 72 20 63 75 the .** pCur cu
29460 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 rsor is pointing
29470 20 74 6f 2e 20 20 54 68 65 20 70 6f 69 6e 74 65 to. The pointe
29480 72 20 69 73 20 74 6f 20 74 68 65 20 62 65 67 69 r is to the begi
29490 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 74 68 65 20 nning of.** the
294a0 6b 65 79 20 69 66 20 69 6e 64 65 78 20 62 74 72 key if index btr
294b0 65 65 73 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b ees (pPage->intK
294c0 65 79 3d 3d 30 29 20 61 6e 64 20 69 73 20 74 68 ey==0) and is th
294d0 65 20 64 61 74 61 20 66 6f 72 0a 2a 2a 20 74 61 e data for.** ta
294e0 62 6c 65 20 62 74 72 65 65 73 20 28 70 50 61 67 ble btrees (pPag
294f0 65 2d 3e 69 6e 74 4b 65 79 3d 3d 31 29 2e 20 54 e->intKey==1). T
29500 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
29510 65 73 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 0a es of available.
29520 2a 2a 20 6b 65 79 2f 64 61 74 61 20 69 73 20 77 ** key/data is w
29530 72 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 41 6d ritten into *pAm
29540 74 2e 20 20 49 66 20 2a 70 41 6d 74 3d 3d 30 2c t. If *pAmt==0,
29550 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 0a then the value.
29560 2a 2a 20 72 65 74 75 72 6e 65 64 20 77 69 6c 6c ** returned will
29570 20 6e 6f 74 20 62 65 20 61 20 76 61 6c 69 64 20 not be a valid
29580 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 pointer..**.** T
29590 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 his routine is a
295a0 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 n optimization.
295b0 20 49 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 66 6f It is common fo
295c0 72 20 74 68 65 20 65 6e 74 69 72 65 20 6b 65 79 r the entire key
295d0 0a 2a 2a 20 61 6e 64 20 64 61 74 61 20 74 6f 20 .** and data to
295e0 66 69 74 20 6f 6e 20 74 68 65 20 6c 6f 63 61 6c fit on the local
295f0 20 70 61 67 65 20 61 6e 64 20 66 6f 72 20 74 68 page and for th
29600 65 72 65 20 74 6f 20 62 65 20 6e 6f 20 6f 76 65 ere to be no ove
29610 72 66 6c 6f 77 0a 2a 2a 20 70 61 67 65 73 2e 20 rflow.** pages.
29620 20 57 68 65 6e 20 74 68 61 74 20 69 73 20 73 6f When that is so
29630 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 63 , this routine c
29640 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 61 63 an be used to ac
29650 63 65 73 73 20 74 68 65 0a 2a 2a 20 6b 65 79 20 cess the.** key
29660 61 6e 64 20 64 61 74 61 20 77 69 74 68 6f 75 74 and data without
29670 20 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 2e 20 making a copy.
29680 20 49 66 20 74 68 65 20 6b 65 79 20 61 6e 64 2f If the key and/
29690 6f 72 20 64 61 74 61 20 73 70 69 6c 6c 73 0a 2a or data spills.*
296a0 2a 20 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 * onto overflow
296b0 70 61 67 65 73 2c 20 74 68 65 6e 20 61 63 63 65 pages, then acce
296c0 73 73 50 61 79 6c 6f 61 64 28 29 20 6d 75 73 74 ssPayload() must
296d0 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 61 73 be used to reas
296e0 73 65 6d 62 6c 65 0a 2a 2a 20 74 68 65 20 6b 65 semble.** the ke
296f0 79 2f 64 61 74 61 20 61 6e 64 20 63 6f 70 79 20 y/data and copy
29700 69 74 20 69 6e 74 6f 20 61 20 70 72 65 61 6c 6c it into a preall
29710 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a 2a ocated buffer..*
29720 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 *.** The pointer
29730 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 returned by thi
29740 73 20 72 6f 75 74 69 6e 65 20 6c 6f 6f 6b 73 20 s routine looks
29750 64 69 72 65 63 74 6c 79 20 69 6e 74 6f 20 74 68 directly into th
29760 65 20 63 61 63 68 65 64 0a 2a 2a 20 70 61 67 65 e cached.** page
29770 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
29780 2e 20 20 54 68 65 20 64 61 74 61 20 6d 69 67 68 . The data migh
29790 74 20 63 68 61 6e 67 65 20 6f 72 20 6d 6f 76 65 t change or move
297a0 20 74 68 65 20 6e 65 78 74 20 74 69 6d 65 0a 2a the next time.*
297b0 2a 20 61 6e 79 20 62 74 72 65 65 20 72 6f 75 74 * any btree rout
297c0 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a ine is called..*
297d0 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 76 /.static const v
297e0 6f 69 64 20 2a 66 65 74 63 68 50 61 79 6c 6f 61 oid *fetchPayloa
297f0 64 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 d(. BtCursor *p
29800 43 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 75 72 Cur, /* Cur
29810 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 sor pointing to
29820 65 6e 74 72 79 20 74 6f 20 72 65 61 64 20 66 72 entry to read fr
29830 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 2a 70 41 6d om */. u32 *pAm
29840 74 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t /*
29850 57 72 69 74 65 20 74 68 65 20 6e 75 6d 62 65 72 Write the number
29860 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 79 of available by
29870 74 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 tes here */.){.
29880 20 69 6e 74 20 61 6d 74 3b 0a 20 20 61 73 73 65 int amt;. asse
29890 72 74 28 20 70 43 75 72 21 3d 30 20 26 26 20 70 rt( pCur!=0 && p
298a0 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 26 26 Cur->iPage>=0 &&
298b0 20 70 43 75 72 2d 3e 70 50 61 67 65 29 3b 0a 20 pCur->pPage);.
298c0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
298d0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
298e0 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
298f0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
29900 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 eld(pCur->pBtree
29910 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
29920 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
29930 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
29940 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
29950 70 43 75 72 2d 3e 69 78 3c 70 43 75 72 2d 3e 70 pCur->ix<pCur->p
29960 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 Page->nCell );.
29970 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
29980 6e 66 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b 0a 20 nfo.nSize>0 );.
29990 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
299a0 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3e 70 43 75 nfo.pPayload>pCu
299b0 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 61 20 r->pPage->aData
299c0 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b || CORRUPT_DB );
299d0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
299e0 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3c 70 >info.pPayload<p
299f0 43 75 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 Cur->pPage->aDat
29a00 61 45 6e 64 20 7c 7c 43 4f 52 52 55 50 54 5f 44 aEnd ||CORRUPT_D
29a10 42 29 3b 0a 20 20 61 6d 74 20 3d 20 70 43 75 72 B);. amt = pCur
29a20 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 ->info.nLocal;.
29a30 20 69 66 28 20 61 6d 74 3e 28 69 6e 74 29 28 70 if( amt>(int)(p
29a40 43 75 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 Cur->pPage->aDat
29a50 61 45 6e 64 20 2d 20 70 43 75 72 2d 3e 69 6e 66 aEnd - pCur->inf
29a60 6f 2e 70 50 61 79 6c 6f 61 64 29 20 29 7b 0a 20 o.pPayload) ){.
29a70 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 20 74 /* There is t
29a80 6f 6f 20 6c 69 74 74 6c 65 20 73 70 61 63 65 20 oo little space
29a90 6f 6e 20 74 68 65 20 70 61 67 65 20 66 6f 72 20 on the page for
29aa0 74 68 65 20 65 78 70 65 63 74 65 64 20 61 6d 6f the expected amo
29ab0 75 6e 74 0a 20 20 20 20 2a 2a 20 6f 66 20 6c 6f unt. ** of lo
29ac0 63 61 6c 20 63 6f 6e 74 65 6e 74 2e 20 44 61 74 cal content. Dat
29ad0 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 63 6f abase must be co
29ae0 72 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 61 73 rrupt. */. as
29af0 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 42 sert( CORRUPT_DB
29b00 20 29 3b 0a 20 20 20 20 61 6d 74 20 3d 20 4d 41 );. amt = MA
29b10 58 28 30 2c 20 28 69 6e 74 29 28 70 43 75 72 2d X(0, (int)(pCur-
29b20 3e 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 >pPage->aDataEnd
29b30 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 - pCur->info.pP
29b40 61 79 6c 6f 61 64 29 29 3b 0a 20 20 7d 0a 20 20 ayload));. }.
29b50 2a 70 41 6d 74 20 3d 20 28 75 33 32 29 61 6d 74 *pAmt = (u32)amt
29b60 3b 0a 20 20 72 65 74 75 72 6e 20 28 76 6f 69 64 ;. return (void
29b70 2a 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 *)pCur->info.pPa
29b80 79 6c 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a yload;.}.../*.**
29b90 20 46 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 For the entry t
29ba0 68 61 74 20 63 75 72 73 6f 72 20 70 43 75 72 20 hat cursor pCur
29bb0 69 73 20 70 6f 69 6e 74 20 74 6f 2c 20 72 65 74 is point to, ret
29bc0 75 72 6e 20 61 73 0a 2a 2a 20 6d 61 6e 79 20 62 urn as.** many b
29bd0 79 74 65 73 20 6f 66 20 74 68 65 20 6b 65 79 20 ytes of the key
29be0 6f 72 20 64 61 74 61 20 61 73 20 61 72 65 20 61 or data as are a
29bf0 76 61 69 6c 61 62 6c 65 20 6f 6e 20 74 68 65 20 vailable on the
29c00 6c 6f 63 61 6c 0a 2a 2a 20 62 2d 74 72 65 65 20 local.** b-tree
29c10 70 61 67 65 2e 20 20 57 72 69 74 65 20 74 68 65 page. Write the
29c20 20 6e 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c number of avail
29c30 61 62 6c 65 20 62 79 74 65 73 20 69 6e 74 6f 20 able bytes into
29c40 2a 70 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 *pAmt..**.** The
29c50 20 70 6f 69 6e 74 65 72 20 72 65 74 75 72 6e 65 pointer returne
29c60 64 20 69 73 20 65 70 68 65 6d 65 72 61 6c 2e 20 d is ephemeral.
29c70 20 54 68 65 20 6b 65 79 2f 64 61 74 61 20 6d 61 The key/data ma
29c80 79 20 6d 6f 76 65 0a 2a 2a 20 6f 72 20 62 65 20 y move.** or be
29c90 64 65 73 74 72 6f 79 65 64 20 6f 6e 20 74 68 65 destroyed on the
29ca0 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f 20 61 6e next call to an
29cb0 79 20 42 74 72 65 65 20 72 6f 75 74 69 6e 65 2c y Btree routine,
29cc0 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 63 61 .** including ca
29cd0 6c 6c 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 74 lls from other t
29ce0 68 72 65 61 64 73 20 61 67 61 69 6e 73 74 20 74 hreads against t
29cf0 68 65 20 73 61 6d 65 20 63 61 63 68 65 2e 0a 2a he same cache..*
29d00 2a 20 48 65 6e 63 65 2c 20 61 20 6d 75 74 65 78 * Hence, a mutex
29d10 20 6f 6e 20 74 68 65 20 42 74 53 68 61 72 65 64 on the BtShared
29d20 20 73 68 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 should be held
29d30 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 prior to calling
29d40 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 .** this routine
29d50 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f ..**.** These ro
29d60 75 74 69 6e 65 73 20 69 73 20 75 73 65 64 20 74 utines is used t
29d70 6f 20 67 65 74 20 71 75 69 63 6b 20 61 63 63 65 o get quick acce
29d80 73 73 20 74 6f 20 6b 65 79 20 61 6e 64 20 64 61 ss to key and da
29d90 74 61 0a 2a 2a 20 69 6e 20 74 68 65 20 63 6f 6d ta.** in the com
29da0 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 6e mon case where n
29db0 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 o overflow pages
29dc0 20 61 72 65 20 75 73 65 64 2e 0a 2a 2f 0a 63 6f are used..*/.co
29dd0 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 nst void *sqlite
29de0 33 42 74 72 65 65 50 61 79 6c 6f 61 64 46 65 74 3BtreePayloadFet
29df0 63 68 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 ch(BtCursor *pCu
29e00 72 2c 20 75 33 32 20 2a 70 41 6d 74 29 7b 0a 20 r, u32 *pAmt){.
29e10 20 72 65 74 75 72 6e 20 66 65 74 63 68 50 61 79 return fetchPay
29e20 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 6d 74 29 load(pCur, pAmt)
29e30 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 ;.}.../*.** Move
29e40 20 74 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e the cursor down
29e50 20 74 6f 20 61 20 6e 65 77 20 63 68 69 6c 64 20 to a new child
29e60 70 61 67 65 2e 20 20 54 68 65 20 6e 65 77 50 67 page. The newPg
29e70 6e 6f 20 61 72 67 75 6d 65 6e 74 20 69 73 20 74 no argument is t
29e80 68 65 0a 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 he.** page numbe
29e90 72 20 6f 66 20 74 68 65 20 63 68 69 6c 64 20 70 r of the child p
29ea0 61 67 65 20 74 6f 20 6d 6f 76 65 20 74 6f 2e 0a age to move to..
29eb0 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 **.** This funct
29ec0 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 ion returns SQLI
29ed0 54 45 5f 43 4f 52 52 55 50 54 20 69 66 20 74 68 TE_CORRUPT if th
29ee0 65 20 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c e page-header fl
29ef0 61 67 73 20 66 69 65 6c 64 20 6f 66 0a 2a 2a 20 ags field of.**
29f00 74 68 65 20 6e 65 77 20 63 68 69 6c 64 20 70 61 the new child pa
29f10 67 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 ge does not matc
29f20 68 20 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c h the flags fiel
29f30 64 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 d of the parent
29f40 28 69 2e 65 2e 0a 2a 2a 20 69 66 20 61 6e 20 69 (i.e..** if an i
29f50 6e 74 6b 65 79 20 70 61 67 65 20 61 70 70 65 61 ntkey page appea
29f60 72 73 20 74 6f 20 62 65 20 74 68 65 20 70 61 72 rs to be the par
29f70 65 6e 74 20 6f 66 20 61 20 6e 6f 6e 2d 69 6e 74 ent of a non-int
29f80 6b 65 79 20 70 61 67 65 2c 20 6f 72 0a 2a 2a 20 key page, or.**
29f90 76 69 63 65 2d 76 65 72 73 61 29 2e 0a 2a 2f 0a vice-versa)..*/.
29fa0 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 static int moveT
29fb0 6f 43 68 69 6c 64 28 42 74 43 75 72 73 6f 72 20 oChild(BtCursor
29fc0 2a 70 43 75 72 2c 20 75 33 32 20 6e 65 77 50 67 *pCur, u32 newPg
29fd0 6e 6f 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 no){. BtShared
29fe0 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 *pBt = pCur->pBt
29ff0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
2a000 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
2a010 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
2a020 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
2a030 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
2a040 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2a050 3e 69 50 61 67 65 3c 42 54 43 55 52 53 4f 52 5f >iPage<BTCURSOR_
2a060 4d 41 58 5f 44 45 50 54 48 20 29 3b 0a 20 20 61 MAX_DEPTH );. a
2a070 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 ssert( pCur->iPa
2a080 67 65 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 ge>=0 );. if( p
2a090 43 75 72 2d 3e 69 50 61 67 65 3e 3d 28 42 54 43 Cur->iPage>=(BTC
2a0a0 55 52 53 4f 52 5f 4d 41 58 5f 44 45 50 54 48 2d URSOR_MAX_DEPTH-
2a0b0 31 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 1) ){. return
2a0c0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2a0d0 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 70 43 75 72 BKPT;. }. pCur
2a0e0 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
2a0f0 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 ;. pCur->curFla
2a100 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c gs &= ~(BTCF_Val
2a110 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 idNKey|BTCF_Vali
2a120 64 4f 76 66 6c 29 3b 0a 20 20 70 43 75 72 2d 3e dOvfl);. pCur->
2a130 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2a140 65 5d 20 3d 20 70 43 75 72 2d 3e 69 78 3b 0a 20 e] = pCur->ix;.
2a150 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
2a160 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 70 43 75 ur->iPage] = pCu
2a170 72 2d 3e 70 50 61 67 65 3b 0a 20 20 70 43 75 72 r->pPage;. pCur
2a180 2d 3e 69 78 20 3d 20 30 3b 0a 20 20 70 43 75 72 ->ix = 0;. pCur
2a190 2d 3e 69 50 61 67 65 2b 2b 3b 0a 20 20 72 65 74 ->iPage++;. ret
2a1a0 75 72 6e 20 67 65 74 41 6e 64 49 6e 69 74 50 61 urn getAndInitPa
2a1b0 67 65 28 70 42 74 2c 20 6e 65 77 50 67 6e 6f 2c ge(pBt, newPgno,
2a1c0 20 26 70 43 75 72 2d 3e 70 50 61 67 65 2c 20 70 &pCur->pPage, p
2a1d0 43 75 72 2c 20 70 43 75 72 2d 3e 63 75 72 50 61 Cur, pCur->curPa
2a1e0 67 65 72 46 6c 61 67 73 29 3b 0a 7d 0a 0a 23 69 gerFlags);.}..#i
2a1f0 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
2a200 47 0a 2f 2a 0a 2a 2a 20 50 61 67 65 20 70 50 61 G./*.** Page pPa
2a210 72 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 65 72 rent is an inter
2a220 6e 61 6c 20 28 6e 6f 6e 2d 6c 65 61 66 29 20 74 nal (non-leaf) t
2a230 72 65 65 20 70 61 67 65 2e 20 54 68 69 73 20 66 ree page. This f
2a240 75 6e 63 74 69 6f 6e 20 0a 2a 2a 20 61 73 73 65 unction .** asse
2a250 72 74 73 20 74 68 61 74 20 70 61 67 65 20 6e 75 rts that page nu
2a260 6d 62 65 72 20 69 43 68 69 6c 64 20 69 73 20 74 mber iChild is t
2a270 68 65 20 6c 65 66 74 2d 63 68 69 6c 64 20 69 66 he left-child if
2a280 20 74 68 65 20 69 49 64 78 27 74 68 0a 2a 2a 20 the iIdx'th.**
2a290 63 65 6c 6c 20 69 6e 20 70 61 67 65 20 70 50 61 cell in page pPa
2a2a0 72 65 6e 74 2e 20 4f 72 2c 20 69 66 20 69 49 64 rent. Or, if iId
2a2b0 78 20 69 73 20 65 71 75 61 6c 20 74 6f 20 74 68 x is equal to th
2a2c0 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f e total number o
2a2d0 66 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 70 50 f.** cells in pP
2a2e0 61 72 65 6e 74 2c 20 74 68 61 74 20 70 61 67 65 arent, that page
2a2f0 20 6e 75 6d 62 65 72 20 69 43 68 69 6c 64 20 69 number iChild i
2a300 73 20 74 68 65 20 72 69 67 68 74 2d 63 68 69 6c s the right-chil
2a310 64 20 6f 66 0a 2a 2a 20 74 68 65 20 70 61 67 65 d of.** the page
2a320 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
2a330 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 assertParentInd
2a340 65 78 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 72 ex(MemPage *pPar
2a350 65 6e 74 2c 20 69 6e 74 20 69 49 64 78 2c 20 50 ent, int iIdx, P
2a360 67 6e 6f 20 69 43 68 69 6c 64 29 7b 0a 20 20 69 gno iChild){. i
2a370 66 28 20 43 4f 52 52 55 50 54 5f 44 42 20 29 20 f( CORRUPT_DB )
2a380 72 65 74 75 72 6e 3b 20 20 2f 2a 20 54 68 65 20 return; /* The
2a390 63 6f 6e 64 69 74 69 6f 6e 73 20 74 65 73 74 65 conditions teste
2a3a0 64 20 62 65 6c 6f 77 20 6d 69 67 68 74 20 6e 6f d below might no
2a3b0 74 20 62 65 20 74 72 75 65 0a 20 20 20 20 20 20 t be true.
2a3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a3d0 20 20 20 20 20 20 2a 2a 20 69 6e 20 61 20 63 6f ** in a co
2a3e0 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 2a rrupt database *
2a3f0 2f 0a 20 20 61 73 73 65 72 74 28 20 69 49 64 78 /. assert( iIdx
2a400 3c 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c <=pParent->nCell
2a410 20 29 3b 0a 20 20 69 66 28 20 69 49 64 78 3d 3d );. if( iIdx==
2a420 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 20 29 pParent->nCell )
2a430 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 65 {. assert( ge
2a440 74 34 62 79 74 65 28 26 70 50 61 72 65 6e 74 2d t4byte(&pParent-
2a450 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d 3e >aData[pParent->
2a460 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3d 3d 69 hdrOffset+8])==i
2a470 43 68 69 6c 64 20 29 3b 0a 20 20 7d 65 6c 73 65 Child );. }else
2a480 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 65 {. assert( ge
2a490 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 t4byte(findCell(
2a4a0 70 50 61 72 65 6e 74 2c 20 69 49 64 78 29 29 3d pParent, iIdx))=
2a4b0 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 0a 7d =iChild );. }.}
2a4c0 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 .#else.# define
2a4d0 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 assertParentInd
2a4e0 65 78 28 78 2c 79 2c 7a 29 20 0a 23 65 6e 64 69 ex(x,y,z) .#endi
2a4f0 66 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 f../*.** Move th
2a500 65 20 63 75 72 73 6f 72 20 75 70 20 74 6f 20 74 e cursor up to t
2a510 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 0a he parent page..
2a520 2a 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 64 78 20 **.** pCur->idx
2a530 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 63 65 is set to the ce
2a540 6c 6c 20 69 6e 64 65 78 20 74 68 61 74 20 63 6f ll index that co
2a550 6e 74 61 69 6e 73 20 74 68 65 20 70 6f 69 6e 74 ntains the point
2a560 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 er.** to the pag
2a570 65 20 77 65 20 61 72 65 20 63 6f 6d 69 6e 67 20 e we are coming
2a580 66 72 6f 6d 2e 20 20 49 66 20 77 65 20 61 72 65 from. If we are
2a590 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 74 68 65 coming from the
2a5a0 0a 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 20 63 .** right-most c
2a5b0 68 69 6c 64 20 70 61 67 65 20 74 68 65 6e 20 70 hild page then p
2a5c0 43 75 72 2d 3e 69 64 78 20 69 73 20 73 65 74 20 Cur->idx is set
2a5d0 74 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 68 61 6e to one more than
2a5e0 0a 2a 2a 20 74 68 65 20 6c 61 72 67 65 73 74 20 .** the largest
2a5f0 63 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a 2f 0a 73 cell index..*/.s
2a600 74 61 74 69 63 20 76 6f 69 64 20 6d 6f 76 65 54 tatic void moveT
2a610 6f 50 61 72 65 6e 74 28 42 74 43 75 72 73 6f 72 oParent(BtCursor
2a620 20 2a 70 43 75 72 29 7b 0a 20 20 4d 65 6d 50 61 *pCur){. MemPa
2a630 67 65 20 2a 70 4c 65 61 66 3b 0a 20 20 61 73 73 ge *pLeaf;. ass
2a640 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 ert( cursorOwnsB
2a650 74 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b tShared(pCur) );
2a660 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2a670 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
2a680 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
2a690 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 t( pCur->iPage>0
2a6a0 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
2a6b0 75 72 2d 3e 70 50 61 67 65 20 29 3b 0a 20 20 61 ur->pPage );. a
2a6c0 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 65 78 ssertParentIndex
2a6d0 28 0a 20 20 20 20 70 43 75 72 2d 3e 61 70 50 61 (. pCur->apPa
2a6e0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d 31 ge[pCur->iPage-1
2a6f0 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 ], . pCur->ai
2a700 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 2d Idx[pCur->iPage-
2a710 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d 3e 70 1], . pCur->p
2a720 50 61 67 65 2d 3e 70 67 6e 6f 0a 20 20 29 3b 0a Page->pgno. );.
2a730 20 20 74 65 73 74 63 61 73 65 28 20 70 43 75 72 testcase( pCur
2a740 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2a750 61 67 65 2d 31 5d 20 3e 20 70 43 75 72 2d 3e 61 age-1] > pCur->a
2a760 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
2a770 65 2d 31 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 e-1]->nCell );.
2a780 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a pCur->info.nSiz
2a790 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 e = 0;. pCur->c
2a7a0 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 urFlags &= ~(BTC
2a7b0 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 F_ValidNKey|BTCF
2a7c0 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 70 _ValidOvfl);. p
2a7d0 43 75 72 2d 3e 69 78 20 3d 20 70 43 75 72 2d 3e Cur->ix = pCur->
2a7e0 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2a7f0 65 2d 31 5d 3b 0a 20 20 70 4c 65 61 66 20 3d 20 e-1];. pLeaf =
2a800 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 70 pCur->pPage;. p
2a810 43 75 72 2d 3e 70 50 61 67 65 20 3d 20 70 43 75 Cur->pPage = pCu
2a820 72 2d 3e 61 70 50 61 67 65 5b 2d 2d 70 43 75 72 r->apPage[--pCur
2a830 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 72 65 6c 65 ->iPage];. rele
2a840 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 asePageNotNull(p
2a850 4c 65 61 66 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Leaf);.}../*.**
2a860 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 Move the cursor
2a870 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 to point to the
2a880 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 69 74 73 root page of its
2a890 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 b-tree structur
2a8a0 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
2a8b0 74 61 62 6c 65 20 68 61 73 20 61 20 76 69 72 74 table has a virt
2a8c0 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2c 20 74 ual root page, t
2a8d0 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 69 hen the cursor i
2a8e0 73 20 6d 6f 76 65 64 20 74 6f 20 70 6f 69 6e 74 s moved to point
2a8f0 0a 2a 2a 20 74 6f 20 74 68 65 20 76 69 72 74 75 .** to the virtu
2a900 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 69 6e 73 al root page ins
2a910 74 65 61 64 20 6f 66 20 74 68 65 20 61 63 74 75 tead of the actu
2a920 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 41 20 al root page. A
2a930 74 61 62 6c 65 20 68 61 73 20 61 0a 2a 2a 20 76 table has a.** v
2a940 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 irtual root page
2a950 20 77 68 65 6e 20 74 68 65 20 61 63 74 75 61 6c when the actual
2a960 20 72 6f 6f 74 20 70 61 67 65 20 63 6f 6e 74 61 root page conta
2a970 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 61 6e 64 ins no cells and
2a980 20 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 20 63 68 a .** single ch
2a990 69 6c 64 20 70 61 67 65 2e 20 54 68 69 73 20 63 ild page. This c
2a9a0 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 77 an only happen w
2a9b0 69 74 68 20 74 68 65 20 74 61 62 6c 65 20 72 6f ith the table ro
2a9c0 6f 74 65 64 20 61 74 20 70 61 67 65 20 31 2e 0a oted at page 1..
2a9d0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 2d 74 **.** If the b-t
2a9e0 72 65 65 20 73 74 72 75 63 74 75 72 65 20 69 73 ree structure is
2a9f0 20 65 6d 70 74 79 2c 20 74 68 65 20 63 75 72 73 empty, the curs
2aa00 6f 72 20 73 74 61 74 65 20 69 73 20 73 65 74 20 or state is set
2aa10 74 6f 20 0a 2a 2a 20 43 55 52 53 4f 52 5f 49 4e to .** CURSOR_IN
2aa20 56 41 4c 49 44 20 61 6e 64 20 74 68 69 73 20 72 VALID and this r
2aa30 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 53 outine returns S
2aa40 51 4c 49 54 45 5f 45 4d 50 54 59 2e 20 4f 74 68 QLITE_EMPTY. Oth
2aa50 65 72 77 69 73 65 2c 0a 2a 2a 20 74 68 65 20 63 erwise,.** the c
2aa60 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 6f 20 ursor is set to
2aa70 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 69 72 point to the fir
2aa80 73 74 20 63 65 6c 6c 20 6c 6f 63 61 74 65 64 20 st cell located
2aa90 6f 6e 20 74 68 65 20 72 6f 6f 74 0a 2a 2a 20 28 on the root.** (
2aaa0 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 29 or virtual root)
2aab0 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 63 75 page and the cu
2aac0 72 73 6f 72 20 73 74 61 74 65 20 69 73 20 73 65 rsor state is se
2aad0 74 20 74 6f 20 43 55 52 53 4f 52 5f 56 41 4c 49 t to CURSOR_VALI
2aae0 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 D..**.** If this
2aaf0 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e function return
2ab00 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 s successfully,
2ab10 69 74 20 6d 61 79 20 62 65 20 61 73 73 75 6d 65 it may be assume
2ab20 64 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 70 61 d that the.** pa
2ab30 67 65 2d 68 65 61 64 65 72 20 66 6c 61 67 73 20 ge-header flags
2ab40 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 68 indicate that th
2ab50 65 20 5b 76 69 72 74 75 61 6c 5d 20 72 6f 6f 74 e [virtual] root
2ab60 2d 70 61 67 65 20 69 73 20 74 68 65 20 65 78 70 -page is the exp
2ab70 65 63 74 65 64 20 0a 2a 2a 20 6b 69 6e 64 20 6f ected .** kind o
2ab80 66 20 62 2d 74 72 65 65 20 70 61 67 65 20 28 69 f b-tree page (i
2ab90 2e 65 2e 20 69 66 20 77 68 65 6e 20 6f 70 65 6e .e. if when open
2aba0 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 20 74 ing the cursor t
2abb0 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 6e 6f he caller did no
2abc0 74 0a 2a 2a 20 73 70 65 63 69 66 79 20 61 20 4b t.** specify a K
2abd0 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 eyInfo structure
2abe0 20 74 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 the flags byte
2abf0 69 73 20 73 65 74 20 74 6f 20 30 78 30 35 20 6f is set to 0x05 o
2ac00 72 20 30 78 30 44 2c 0a 2a 2a 20 69 6e 64 69 63 r 0x0D,.** indic
2ac10 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 62 2d ating a table b-
2ac20 74 72 65 65 2c 20 6f 72 20 69 66 20 74 68 65 20 tree, or if the
2ac30 63 61 6c 6c 65 72 20 64 69 64 20 73 70 65 63 69 caller did speci
2ac40 66 79 20 61 20 4b 65 79 49 6e 66 6f 20 0a 2a 2a fy a KeyInfo .**
2ac50 20 73 74 72 75 63 74 75 72 65 20 74 68 65 20 66 structure the f
2ac60 6c 61 67 73 20 62 79 74 65 20 69 73 20 73 65 74 lags byte is set
2ac70 20 74 6f 20 30 78 30 32 20 6f 72 20 30 78 30 41 to 0x02 or 0x0A
2ac80 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 61 6e 20 , indicating an
2ac90 69 6e 64 65 78 0a 2a 2a 20 62 2d 74 72 65 65 29 index.** b-tree)
2aca0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
2acb0 6d 6f 76 65 54 6f 52 6f 6f 74 28 42 74 43 75 72 moveToRoot(BtCur
2acc0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 4d 65 sor *pCur){. Me
2acd0 6d 50 61 67 65 20 2a 70 52 6f 6f 74 3b 0a 20 20 mPage *pRoot;.
2ace0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
2acf0 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 OK;.. assert( c
2ad00 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
2ad10 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 d(pCur) );. ass
2ad20 65 72 74 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 ert( CURSOR_INVA
2ad30 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f 52 45 51 LID < CURSOR_REQ
2ad40 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 73 UIRESEEK );. as
2ad50 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 41 4c sert( CURSOR_VAL
2ad60 49 44 20 20 20 3c 20 43 55 52 53 4f 52 5f 52 45 ID < CURSOR_RE
2ad70 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 QUIRESEEK );. a
2ad80 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 46 41 ssert( CURSOR_FA
2ad90 55 4c 54 20 20 20 3e 20 43 55 52 53 4f 52 5f 52 ULT > CURSOR_R
2ada0 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
2adb0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 assert( pCur->eS
2adc0 74 61 74 65 20 3c 20 43 55 52 53 4f 52 5f 52 45 tate < CURSOR_RE
2add0 51 55 49 52 45 53 45 45 4b 20 7c 7c 20 70 43 75 QUIRESEEK || pCu
2ade0 72 2d 3e 69 50 61 67 65 3c 30 20 29 3b 0a 20 20 r->iPage<0 );.
2adf0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 assert( pCur->pg
2ae00 6e 6f 52 6f 6f 74 3e 30 20 7c 7c 20 70 43 75 72 noRoot>0 || pCur
2ae10 2d 3e 69 50 61 67 65 3c 30 20 29 3b 0a 0a 20 20 ->iPage<0 );..
2ae20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e if( pCur->iPage>
2ae30 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 =0 ){. if( pC
2ae40 75 72 2d 3e 69 50 61 67 65 20 29 7b 0a 20 20 20 ur->iPage ){.
2ae50 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 4e 6f releasePageNo
2ae60 74 4e 75 6c 6c 28 70 43 75 72 2d 3e 70 50 61 67 tNull(pCur->pPag
2ae70 65 29 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 e);. while(
2ae80 20 2d 2d 70 43 75 72 2d 3e 69 50 61 67 65 20 29 --pCur->iPage )
2ae90 7b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 {. releas
2aea0 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 43 75 ePageNotNull(pCu
2aeb0 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
2aec0 69 50 61 67 65 5d 29 3b 0a 20 20 20 20 20 20 7d iPage]);. }
2aed0 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 70 50 61 . pCur->pPa
2aee0 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
2aef0 65 5b 30 5d 3b 0a 20 20 20 20 20 20 67 6f 74 6f e[0];. goto
2af00 20 73 6b 69 70 5f 69 6e 69 74 3b 0a 20 20 20 20 skip_init;.
2af10 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 }. }else if( pC
2af20 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 ur->pgnoRoot==0
2af30 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
2af40 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
2af50 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 75 72 6e ALID;. return
2af60 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 3b 0a 20 SQLITE_EMPTY;.
2af70 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 }else{. asse
2af80 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3d rt( pCur->iPage=
2af90 3d 28 2d 31 29 20 29 3b 0a 20 20 20 20 69 66 28 =(-1) );. if(
2afa0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d 43 pCur->eState>=C
2afb0 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 URSOR_REQUIRESEE
2afc0 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 K ){. if( p
2afd0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
2afe0 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a 20 20 20 SOR_FAULT ){.
2aff0 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
2b000 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 51 4c r->skipNext!=SQL
2b010 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 ITE_OK );.
2b020 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 return pCur->s
2b030 6b 69 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d kipNext;. }
2b040 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 . sqlite3Bt
2b050 72 65 65 43 6c 65 61 72 43 75 72 73 6f 72 28 70 reeClearCursor(p
2b060 43 75 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Cur);. }.
2b070 72 63 20 3d 20 67 65 74 41 6e 64 49 6e 69 74 50 rc = getAndInitP
2b080 61 67 65 28 70 43 75 72 2d 3e 70 42 74 72 65 65 age(pCur->pBtree
2b090 2d 3e 70 42 74 2c 20 70 43 75 72 2d 3e 70 67 6e ->pBt, pCur->pgn
2b0a0 6f 52 6f 6f 74 2c 20 26 70 43 75 72 2d 3e 70 50 oRoot, &pCur->pP
2b0b0 61 67 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 age,.
2b0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 30 2c 20 0,
2b0d0 70 43 75 72 2d 3e 63 75 72 50 61 67 65 72 46 6c pCur->curPagerFl
2b0e0 61 67 73 29 3b 0a 20 20 20 20 69 66 28 20 72 63 ags);. if( rc
2b0f0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
2b100 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 pCur->eStat
2b110 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c e = CURSOR_INVAL
2b120 49 44 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ID;. return
2b130 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 rc;. }. p
2b140 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 30 3b 0a Cur->iPage = 0;.
2b150 20 20 20 20 70 43 75 72 2d 3e 63 75 72 49 6e 74 pCur->curInt
2b160 4b 65 79 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 Key = pCur->pPag
2b170 65 2d 3e 69 6e 74 4b 65 79 3b 0a 20 20 7d 0a 20 e->intKey;. }.
2b180 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d 3e 70 pRoot = pCur->p
2b190 50 61 67 65 3b 0a 20 20 61 73 73 65 72 74 28 20 Page;. assert(
2b1a0 70 52 6f 6f 74 2d 3e 70 67 6e 6f 3d 3d 70 43 75 pRoot->pgno==pCu
2b1b0 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 29 3b 0a 0a r->pgnoRoot );..
2b1c0 20 20 2f 2a 20 49 66 20 70 43 75 72 2d 3e 70 4b /* If pCur->pK
2b1d0 65 79 49 6e 66 6f 20 69 73 20 6e 6f 74 20 4e 55 eyInfo is not NU
2b1e0 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20 63 61 6c LL, then the cal
2b1f0 6c 65 72 20 74 68 61 74 20 6f 70 65 6e 65 64 20 ler that opened
2b200 74 68 69 73 20 63 75 72 73 6f 72 0a 20 20 2a 2a this cursor. **
2b210 20 65 78 70 65 63 74 65 64 20 74 6f 20 6f 70 65 expected to ope
2b220 6e 20 69 74 20 6f 6e 20 61 6e 20 69 6e 64 65 78 n it on an index
2b230 20 62 2d 74 72 65 65 2e 20 4f 74 68 65 72 77 69 b-tree. Otherwi
2b240 73 65 2c 20 69 66 20 70 4b 65 79 49 6e 66 6f 20 se, if pKeyInfo
2b250 69 73 0a 20 20 2a 2a 20 4e 55 4c 4c 2c 20 74 68 is. ** NULL, th
2b260 65 20 63 61 6c 6c 65 72 20 65 78 70 65 63 74 73 e caller expects
2b270 20 61 20 74 61 62 6c 65 20 62 2d 74 72 65 65 2e a table b-tree.
2b280 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 If this is not
2b290 74 68 65 20 63 61 73 65 2c 0a 20 20 2a 2a 20 72 the case,. ** r
2b2a0 65 74 75 72 6e 20 61 6e 20 53 51 4c 49 54 45 5f eturn an SQLITE_
2b2b0 43 4f 52 52 55 50 54 20 65 72 72 6f 72 2e 20 0a CORRUPT error. .
2b2c0 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 72 6c 69 65 **. ** Earlie
2b2d0 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 r versions of SQ
2b2e0 4c 69 74 65 20 61 73 73 75 6d 65 64 20 74 68 61 Lite assumed tha
2b2f0 74 20 74 68 69 73 20 74 65 73 74 20 63 6f 75 6c t this test coul
2b300 64 20 6e 6f 74 20 66 61 69 6c 0a 20 20 2a 2a 20 d not fail. **
2b310 69 66 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 if the root page
2b320 20 77 61 73 20 61 6c 72 65 61 64 79 20 6c 6f 61 was already loa
2b330 64 65 64 20 77 68 65 6e 20 74 68 69 73 20 66 75 ded when this fu
2b340 6e 63 74 69 6f 6e 20 77 61 73 20 63 61 6c 6c 65 nction was calle
2b350 64 20 28 69 2e 65 2e 0a 20 20 2a 2a 20 69 66 20 d (i.e.. ** if
2b360 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 29 2e pCur->iPage>=0).
2b370 20 42 75 74 20 74 68 69 73 20 69 73 20 6e 6f 74 But this is not
2b380 20 73 6f 20 69 66 20 74 68 65 20 64 61 74 61 62 so if the datab
2b390 61 73 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 ase is corrupted
2b3a0 20 0a 20 20 2a 2a 20 69 6e 20 73 75 63 68 20 61 . ** in such a
2b3b0 20 77 61 79 20 74 68 61 74 20 70 61 67 65 20 70 way that page p
2b3c0 52 6f 6f 74 20 69 73 20 6c 69 6e 6b 65 64 20 69 Root is linked i
2b3d0 6e 74 6f 20 61 20 73 65 63 6f 6e 64 20 62 2d 74 nto a second b-t
2b3e0 72 65 65 20 74 61 62 6c 65 20 0a 20 20 2a 2a 20 ree table . **
2b3f0 28 6f 72 20 74 68 65 20 66 72 65 65 6c 69 73 74 (or the freelist
2b400 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 ). */. assert(
2b410 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b 65 79 3d 3d pRoot->intKey==
2b420 31 20 7c 7c 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b 1 || pRoot->intK
2b430 65 79 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 ey==0 );. if( p
2b440 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 Root->isInit==0
2b450 7c 7c 20 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e || (pCur->pKeyIn
2b460 66 6f 3d 3d 30 29 21 3d 70 52 6f 6f 74 2d 3e 69 fo==0)!=pRoot->i
2b470 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 72 65 74 ntKey ){. ret
2b480 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
2b490 50 54 5f 50 41 47 45 28 70 43 75 72 2d 3e 70 50 PT_PAGE(pCur->pP
2b4a0 61 67 65 29 3b 0a 20 20 7d 0a 0a 73 6b 69 70 5f age);. }..skip_
2b4b0 69 6e 69 74 3a 20 20 0a 20 20 70 43 75 72 2d 3e init: . pCur->
2b4c0 69 78 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ix = 0;. pCur->
2b4d0 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a info.nSize = 0;.
2b4e0 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
2b4f0 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c 61 73 &= ~(BTCF_AtLas
2b500 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 t|BTCF_ValidNKey
2b510 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 |BTCF_ValidOvfl)
2b520 3b 0a 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 ;.. pRoot = pCu
2b530 72 2d 3e 70 50 61 67 65 3b 0a 20 20 69 66 28 20 r->pPage;. if(
2b540 70 52 6f 6f 74 2d 3e 6e 43 65 6c 6c 3e 30 20 29 pRoot->nCell>0 )
2b550 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 {. pCur->eSta
2b560 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 te = CURSOR_VALI
2b570 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 D;. }else if( !
2b580 70 52 6f 6f 74 2d 3e 6c 65 61 66 20 29 7b 0a 20 pRoot->leaf ){.
2b590 20 20 20 50 67 6e 6f 20 73 75 62 70 61 67 65 3b Pgno subpage;
2b5a0 0a 20 20 20 20 69 66 28 20 70 52 6f 6f 74 2d 3e . if( pRoot->
2b5b0 70 67 6e 6f 21 3d 31 20 29 20 72 65 74 75 72 6e pgno!=1 ) return
2b5c0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2b5d0 42 4b 50 54 3b 0a 20 20 20 20 73 75 62 70 61 67 BKPT;. subpag
2b5e0 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 52 e = get4byte(&pR
2b5f0 6f 6f 74 2d 3e 61 44 61 74 61 5b 70 52 6f 6f 74 oot->aData[pRoot
2b600 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b ->hdrOffset+8]);
2b610 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 . pCur->eStat
2b620 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 e = CURSOR_VALID
2b630 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 ;. rc = moveT
2b640 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 73 75 62 oChild(pCur, sub
2b650 70 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a page);. }else{.
2b660 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 pCur->eState
2b670 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 = CURSOR_INVALI
2b680 44 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 D;. rc = SQLI
2b690 54 45 5f 45 4d 50 54 59 3b 0a 20 20 7d 0a 20 20 TE_EMPTY;. }.
2b6a0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
2b6b0 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 .** Move the cur
2b6c0 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 sor down to the
2b6d0 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 61 66 20 65 left-most leaf e
2b6e0 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 ntry beneath the
2b6f0 0a 2a 2a 20 65 6e 74 72 79 20 74 6f 20 77 68 69 .** entry to whi
2b700 63 68 20 69 74 20 69 73 20 63 75 72 72 65 6e 74 ch it is current
2b710 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 0a 2a 2a 0a ly pointing..**.
2b720 2a 2a 20 54 68 65 20 6c 65 66 74 2d 6d 6f 73 74 ** The left-most
2b730 20 6c 65 61 66 20 69 73 20 74 68 65 20 6f 6e 65 leaf is the one
2b740 20 77 69 74 68 20 74 68 65 20 73 6d 61 6c 6c 65 with the smalle
2b750 73 74 20 6b 65 79 20 2d 20 74 68 65 20 66 69 72 st key - the fir
2b760 73 74 0a 2a 2a 20 69 6e 20 61 73 63 65 6e 64 69 st.** in ascendi
2b770 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ng order..*/.sta
2b780 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 4c 65 tic int moveToLe
2b790 66 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 20 ftmost(BtCursor
2b7a0 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 70 *pCur){. Pgno p
2b7b0 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 gno;. int rc =
2b7c0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 6d SQLITE_OK;. Mem
2b7d0 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 20 Page *pPage;..
2b7e0 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f 77 assert( cursorOw
2b7f0 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 29 nsBtShared(pCur)
2b800 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
2b810 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
2b820 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 77 68 OR_VALID );. wh
2b830 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ile( rc==SQLITE_
2b840 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 3d 20 OK && !(pPage =
2b850 70 43 75 72 2d 3e 70 50 61 67 65 29 2d 3e 6c 65 pCur->pPage)->le
2b860 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 af ){. assert
2b870 28 20 70 43 75 72 2d 3e 69 78 3c 70 50 61 67 65 ( pCur->ix<pPage
2b880 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 70 ->nCell );. p
2b890 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 66 gno = get4byte(f
2b8a0 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 indCell(pPage, p
2b8b0 43 75 72 2d 3e 69 78 29 29 3b 0a 20 20 20 20 72 Cur->ix));. r
2b8c0 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
2b8d0 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 7d pCur, pgno);. }
2b8e0 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
2b8f0 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
2b900 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 cursor down to t
2b910 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 6c 65 he right-most le
2b920 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 af entry beneath
2b930 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 6f 20 the.** page to
2b940 77 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 which it is curr
2b950 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 20 ently pointing.
2b960 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 66 66 Notice the diff
2b970 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 65 65 erence.** betwee
2b980 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 n moveToLeftmost
2b990 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 69 67 () and moveToRig
2b9a0 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 65 54 htmost(). moveT
2b9b0 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 oLeftmost().** f
2b9c0 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d 6d 6f inds the left-mo
2b9d0 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 st entry beneath
2b9e0 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 68 65 the *entry* whe
2b9f0 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 68 74 reas moveToRight
2ba00 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 73 20 most().** finds
2ba10 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 the right-most e
2ba20 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 68 65 ntry beneath the
2ba30 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a 20 54 *page*..**.** T
2ba40 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 65 6e he right-most en
2ba50 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 20 77 try is the one w
2ba60 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 74 20 ith the largest
2ba70 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 0a 2a key - the last.*
2ba80 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e 64 69 * key in ascendi
2ba90 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ng order..*/.sta
2baa0 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f 52 69 tic int moveToRi
2bab0 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 6f 72 ghtmost(BtCursor
2bac0 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f 20 *pCur){. Pgno
2bad0 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 3d pgno;. int rc =
2bae0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d 65 SQLITE_OK;. Me
2baf0 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 mPage *pPage = 0
2bb00 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
2bb10 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
2bb20 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
2bb30 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
2bb40 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
2bb50 0a 20 20 77 68 69 6c 65 28 20 21 28 70 50 61 67 . while( !(pPag
2bb60 65 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 65 29 e = pCur->pPage)
2bb70 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 70 67 ->leaf ){. pg
2bb80 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 no = get4byte(&p
2bb90 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
2bba0 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
2bbb0 3b 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 20 3d ;. pCur->ix =
2bbc0 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 pPage->nCell;.
2bbd0 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 rc = moveToCh
2bbe0 69 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b ild(pCur, pgno);
2bbf0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
2bc00 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 turn rc;. }. p
2bc10 43 75 72 2d 3e 69 78 20 3d 20 70 50 61 67 65 2d Cur->ix = pPage-
2bc20 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 61 73 73 65 >nCell-1;. asse
2bc30 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e rt( pCur->info.n
2bc40 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 61 73 73 Size==0 );. ass
2bc50 65 72 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 ert( (pCur->curF
2bc60 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 6c 69 lags & BTCF_Vali
2bc70 64 4e 4b 65 79 29 3d 3d 30 20 29 3b 0a 20 20 72 dNKey)==0 );. r
2bc80 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2bc90 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 .}../* Move the
2bca0 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 66 69 cursor to the fi
2bcb0 72 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 rst entry in the
2bcc0 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 table. Return
2bcd0 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 SQLITE_OK.** on
2bce0 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 success. Set *p
2bcf0 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 Res to 0 if the
2bd00 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 cursor actually
2bd10 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 points to someth
2bd20 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 ing.** or set *p
2bd30 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 Res to 1 if the
2bd40 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a table is empty..
2bd50 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
2bd60 72 65 65 46 69 72 73 74 28 42 74 43 75 72 73 6f reeFirst(BtCurso
2bd70 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 r *pCur, int *pR
2bd80 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a es){. int rc;..
2bd90 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
2bda0 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
2bdb0 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
2bdc0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
2bdd0 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d ld(pCur->pBtree-
2bde0 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 >db->mutex) );.
2bdf0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 rc = moveToRoot
2be00 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 (pCur);. if( rc
2be10 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2be20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
2be30 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 >pPage->nCell>0
2be40 29 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d 20 30 );. *pRes = 0
2be50 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 ;. rc = moveT
2be60 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b oLeftmost(pCur);
2be70 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 3d . }else if( rc=
2be80 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59 20 29 7b =SQLITE_EMPTY ){
2be90 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
2bea0 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c r->pgnoRoot==0 |
2beb0 7c 20 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e | pCur->pPage->n
2bec0 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 20 2a Cell==0 );. *
2bed0 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 72 63 pRes = 1;. rc
2bee0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
2bef0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
2bf00 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
2bf10 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 ction is a no-op
2bf20 20 69 66 20 63 75 72 73 6f 72 20 70 43 75 72 20 if cursor pCur
2bf30 64 6f 65 73 20 6e 6f 74 20 70 6f 69 6e 74 20 74 does not point t
2bf40 6f 20 61 20 76 61 6c 69 64 20 72 6f 77 2e 0a 2a o a valid row..*
2bf50 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 * Otherwise, if
2bf60 70 43 75 72 20 69 73 20 76 61 6c 69 64 2c 20 63 pCur is valid, c
2bf70 6f 6e 66 69 67 75 72 65 20 69 74 20 73 6f 20 74 onfigure it so t
2bf80 68 61 74 20 74 68 65 20 6e 65 78 74 20 63 61 6c hat the next cal
2bf90 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 42 l to.** sqlite3B
2bfa0 74 72 65 65 4e 65 78 74 28 29 20 69 73 20 61 20 treeNext() is a
2bfb0 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 23 69 66 6e 64 65 no-op..*/.#ifnde
2bfc0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 49 f SQLITE_OMIT_WI
2bfd0 4e 44 4f 57 46 55 4e 43 0a 76 6f 69 64 20 73 71 NDOWFUNC.void sq
2bfe0 6c 69 74 65 33 42 74 72 65 65 53 6b 69 70 4e 65 lite3BtreeSkipNe
2bff0 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 xt(BtCursor *pCu
2c000 72 29 7b 0a 20 20 2f 2a 20 57 65 20 62 65 6c 69 r){. /* We beli
2c010 65 76 65 20 74 68 61 74 20 74 68 65 20 63 75 72 eve that the cur
2c020 73 6f 72 20 6d 75 73 74 20 61 6c 77 61 79 73 20 sor must always
2c030 62 65 20 69 6e 20 74 68 65 20 76 61 6c 69 64 20 be in the valid
2c040 73 74 61 74 65 20 77 68 65 6e 0a 20 20 2a 2a 20 state when. **
2c050 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 this routine is
2c060 63 61 6c 6c 65 64 2c 20 62 75 74 20 74 68 65 20 called, but the
2c070 70 72 6f 6f 66 20 69 73 20 64 69 66 66 69 63 75 proof is difficu
2c080 6c 74 2c 20 73 6f 20 77 65 20 61 64 64 20 61 6e lt, so we add an
2c090 0a 20 20 2a 2a 20 41 4c 57 61 59 53 28 29 20 74 . ** ALWaYS() t
2c0a0 65 73 74 20 6a 75 73 74 20 69 6e 20 63 61 73 65 est just in case
2c0b0 20 77 65 20 61 72 65 20 77 72 6f 6e 67 2e 20 2a we are wrong. *
2c0c0 2f 0a 20 20 69 66 28 20 41 4c 57 41 59 53 28 70 /. if( ALWAYS(p
2c0d0 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
2c0e0 53 4f 52 5f 56 41 4c 49 44 29 20 29 7b 0a 20 20 SOR_VALID) ){.
2c0f0 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
2c100 20 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 CURSOR_SKIPNEXT
2c110 3b 0a 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 ;. pCur->skip
2c120 4e 65 78 74 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a Next = 1;. }.}.
2c130 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
2c140 5f 4f 4d 49 54 5f 57 49 4e 44 4f 57 46 55 4e 43 _OMIT_WINDOWFUNC
2c150 20 2a 2f 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 */../* Move the
2c160 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6c cursor to the l
2c170 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ast entry in the
2c180 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 table. Return
2c190 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 SQLITE_OK.** on
2c1a0 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 success. Set *p
2c1b0 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 Res to 0 if the
2c1c0 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 cursor actually
2c1d0 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 points to someth
2c1e0 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 ing.** or set *p
2c1f0 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 Res to 1 if the
2c200 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a table is empty..
2c210 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
2c220 72 65 65 4c 61 73 74 28 42 74 43 75 72 73 6f 72 reeLast(BtCursor
2c230 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 *pCur, int *pRe
2c240 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 0a s){. int rc;. .
2c250 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
2c260 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
2c270 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
2c280 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
2c290 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d ld(pCur->pBtree-
2c2a0 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a >db->mutex) );..
2c2b0 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 /* If the curs
2c2c0 6f 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 or already point
2c2d0 73 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e s to the last en
2c2e0 74 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e try, this is a n
2c2f0 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 o-op. */. if( C
2c300 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 URSOR_VALID==pCu
2c310 72 2d 3e 65 53 74 61 74 65 20 26 26 20 28 70 43 r->eState && (pC
2c320 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 ur->curFlags & B
2c330 54 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 TCF_AtLast)!=0 )
2c340 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f {.#ifdef SQLITE_
2c350 44 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 DEBUG. /* Thi
2c360 73 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 s block serves t
2c370 6f 20 61 73 73 65 72 74 28 29 20 74 68 61 74 20 o assert() that
2c380 74 68 65 20 63 75 72 73 6f 72 20 72 65 61 6c 6c the cursor reall
2c390 79 20 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 y does point .
2c3a0 20 20 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 ** to the last
2c3b0 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 62 2d entry in the b-
2c3c0 74 72 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 tree. */. int
2c3d0 20 69 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d ii;. for(ii=
2c3e0 30 3b 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 0; ii<pCur->iPag
2c3f0 65 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 e; ii++){.
2c400 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 assert( pCur->ai
2c410 49 64 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 Idx[ii]==pCur->a
2c420 70 50 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c pPage[ii]->nCell
2c430 20 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 );. }. as
2c440 73 65 72 74 28 20 70 43 75 72 2d 3e 69 78 3d 3d sert( pCur->ix==
2c450 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 pCur->pPage->nCe
2c460 6c 6c 2d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 ll-1 );. asse
2c470 72 74 28 20 70 43 75 72 2d 3e 70 50 61 67 65 2d rt( pCur->pPage-
2c480 3e 6c 65 61 66 20 29 3b 0a 23 65 6e 64 69 66 0a >leaf );.#endif.
2c490 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2c4a0 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 E_OK;. }.. rc
2c4b0 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 = moveToRoot(pCu
2c4c0 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 r);. if( rc==SQ
2c4d0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 LITE_OK ){. a
2c4e0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 ssert( pCur->eSt
2c4f0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate==CURSOR_VALI
2c500 44 20 29 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d D );. *pRes =
2c510 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 0;. rc = mov
2c520 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 eToRightmost(pCu
2c530 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d r);. if( rc==
2c540 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2c550 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 pCur->curFlag
2c560 73 20 7c 3d 20 42 54 43 46 5f 41 74 4c 61 73 74 s |= BTCF_AtLast
2c570 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
2c580 20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 pCur->curFlag
2c590 73 20 26 3d 20 7e 42 54 43 46 5f 41 74 4c 61 73 s &= ~BTCF_AtLas
2c5a0 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 t;. }. }else
2c5b0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2c5c0 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 61 73 73 EMPTY ){. ass
2c5d0 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 ert( pCur->pgnoR
2c5e0 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e oot==0 || pCur->
2c5f0 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 pPage->nCell==0
2c600 29 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d 20 31 );. *pRes = 1
2c610 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 ;. rc = SQLIT
2c620 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 E_OK;. }. retu
2c630 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 rn rc;.}../* Mov
2c640 65 20 74 68 65 20 63 75 72 73 6f 72 20 73 6f 20 e the cursor so
2c650 74 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 that it points t
2c660 6f 20 61 6e 20 65 6e 74 72 79 20 6e 65 61 72 20 o an entry near
2c670 74 68 65 20 6b 65 79 20 0a 2a 2a 20 73 70 65 63 the key .** spec
2c680 69 66 69 65 64 20 62 79 20 70 49 64 78 4b 65 79 ified by pIdxKey
2c690 20 6f 72 20 69 6e 74 4b 65 79 2e 20 20 20 52 65 or intKey. Re
2c6a0 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 turn a success c
2c6b0 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 49 ode..**.** For I
2c6c0 4e 54 4b 45 59 20 74 61 62 6c 65 73 2c 20 74 68 NTKEY tables, th
2c6d0 65 20 69 6e 74 4b 65 79 20 70 61 72 61 6d 65 74 e intKey paramet
2c6e0 65 72 20 69 73 20 75 73 65 64 2e 20 20 70 49 64 er is used. pId
2c6f0 78 4b 65 79 20 0a 2a 2a 20 6d 75 73 74 20 62 65 xKey .** must be
2c700 20 4e 55 4c 4c 2e 20 20 46 6f 72 20 69 6e 64 65 NULL. For inde
2c710 78 20 74 61 62 6c 65 73 2c 20 70 49 64 78 4b 65 x tables, pIdxKe
2c720 79 20 69 73 20 75 73 65 64 20 61 6e 64 20 69 6e y is used and in
2c730 74 4b 65 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 tKey.** is ignor
2c740 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 ed..**.** If an
2c750 65 78 61 63 74 20 6d 61 74 63 68 20 69 73 20 6e exact match is n
2c760 6f 74 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 74 ot found, then t
2c770 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 77 he cursor is alw
2c780 61 79 73 0a 2a 2a 20 6c 65 66 74 20 70 6f 69 6e ays.** left poin
2c790 74 69 6e 67 20 61 74 20 61 20 6c 65 61 66 20 70 ting at a leaf p
2c7a0 61 67 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 age which would
2c7b0 68 6f 6c 64 20 74 68 65 20 65 6e 74 72 79 20 69 hold the entry i
2c7c0 66 20 69 74 0a 2a 2a 20 77 65 72 65 20 70 72 65 f it.** were pre
2c7d0 73 65 6e 74 2e 20 20 54 68 65 20 63 75 72 73 6f sent. The curso
2c7e0 72 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 6f r might point to
2c7f0 20 61 6e 20 65 6e 74 72 79 20 74 68 61 74 20 63 an entry that c
2c800 6f 6d 65 73 0a 2a 2a 20 62 65 66 6f 72 65 20 6f omes.** before o
2c810 72 20 61 66 74 65 72 20 74 68 65 20 6b 65 79 2e r after the key.
2c820 0a 2a 2a 0a 2a 2a 20 41 6e 20 69 6e 74 65 67 65 .**.** An intege
2c830 72 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 r is written int
2c840 6f 20 2a 70 52 65 73 20 77 68 69 63 68 20 69 73 o *pRes which is
2c850 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a the result of.*
2c860 2a 20 63 6f 6d 70 61 72 69 6e 67 20 74 68 65 20 * comparing the
2c870 6b 65 79 20 77 69 74 68 20 74 68 65 20 65 6e 74 key with the ent
2c880 72 79 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 ry to which the
2c890 63 75 72 73 6f 72 20 69 73 20 0a 2a 2a 20 70 6f cursor is .** po
2c8a0 69 6e 74 69 6e 67 2e 20 20 54 68 65 20 6d 65 61 inting. The mea
2c8b0 6e 69 6e 67 20 6f 66 20 74 68 65 20 69 6e 74 65 ning of the inte
2c8c0 67 65 72 20 77 72 69 74 74 65 6e 20 69 6e 74 6f ger written into
2c8d0 0a 2a 2a 20 2a 70 52 65 73 20 69 73 20 61 73 20 .** *pRes is as
2c8e0 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 follows:.**.**
2c8f0 20 20 20 2a 70 52 65 73 3c 30 20 20 20 20 20 20 *pRes<0
2c900 54 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 The cursor is le
2c910 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 ft pointing at a
2c920 6e 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 n entry that.**
2c930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2c940 20 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e is smaller than
2c950 20 69 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 20 intKey/pIdxKey
2c960 6f 72 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 or if the table
2c970 69 73 20 65 6d 70 74 79 0a 2a 2a 20 20 20 20 20 is empty.**
2c980 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 and
2c990 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 74 the cursor is t
2c9a0 68 65 72 65 66 6f 72 65 20 6c 65 66 74 20 70 6f herefore left po
2c9b0 69 6e 74 20 74 6f 20 6e 6f 74 68 69 6e 67 2e 0a int to nothing..
2c9c0 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3d **.** *pRes=
2c9d0 3d 30 20 20 20 20 20 54 68 65 20 63 75 72 73 6f =0 The curso
2c9e0 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 r is left pointi
2c9f0 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 ng at an entry t
2ca00 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 hat.**
2ca10 20 20 20 20 20 20 20 20 65 78 61 63 74 6c 79 20 exactly
2ca20 6d 61 74 63 68 65 73 20 69 6e 74 4b 65 79 2f 70 matches intKey/p
2ca30 49 64 78 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 IdxKey..**.**
2ca40 20 20 2a 70 52 65 73 3e 30 20 20 20 20 20 20 54 *pRes>0 T
2ca50 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 he cursor is lef
2ca60 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e t pointing at an
2ca70 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 entry that.**
2ca80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ca90 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 is larger than i
2caa0 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a ntKey/pIdxKey..*
2cab0 2a 0a 2a 2a 20 46 6f 72 20 69 6e 64 65 78 20 74 *.** For index t
2cac0 61 62 6c 65 73 2c 20 74 68 65 20 70 49 64 78 4b ables, the pIdxK
2cad0 65 79 2d 3e 65 71 53 65 65 6e 20 66 69 65 6c 64 ey->eqSeen field
2cae0 20 69 73 20 73 65 74 20 74 6f 20 31 20 69 66 20 is set to 1 if
2caf0 74 68 65 72 65 0a 2a 2a 20 65 78 69 73 74 73 20 there.** exists
2cb00 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 an entry in the
2cb10 74 61 62 6c 65 20 74 68 61 74 20 65 78 61 63 74 table that exact
2cb20 6c 79 20 6d 61 74 63 68 65 73 20 70 49 64 78 4b ly matches pIdxK
2cb30 65 79 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c ey. .*/.int sql
2cb40 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 ite3BtreeMovetoU
2cb50 6e 70 61 63 6b 65 64 28 0a 20 20 42 74 43 75 72 npacked(. BtCur
2cb60 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 sor *pCur,
2cb70 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f /* The curso
2cb80 72 20 74 6f 20 62 65 20 6d 6f 76 65 64 20 2a 2f r to be moved */
2cb90 0a 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 . UnpackedRecor
2cba0 64 20 2a 70 49 64 78 4b 65 79 2c 20 2f 2a 20 55 d *pIdxKey, /* U
2cbb0 6e 70 61 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 npacked index ke
2cbc0 79 20 2a 2f 0a 20 20 69 36 34 20 69 6e 74 4b 65 y */. i64 intKe
2cbd0 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y,
2cbe0 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 6b 65 79 /* The table key
2cbf0 20 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 52 69 */. int biasRi
2cc00 67 68 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f ght, /
2cc10 2a 20 49 66 20 74 72 75 65 2c 20 62 69 61 73 20 * If true, bias
2cc20 74 68 65 20 73 65 61 72 63 68 20 74 6f 20 74 68 the search to th
2cc30 65 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 e high end */.
2cc40 69 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 int *pRes
2cc50 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 /* Writ
2cc60 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 e search results
2cc70 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
2cc80 74 20 72 63 3b 0a 20 20 52 65 63 6f 72 64 43 6f t rc;. RecordCo
2cc90 6d 70 61 72 65 20 78 52 65 63 6f 72 64 43 6f 6d mpare xRecordCom
2cca0 70 61 72 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 pare;.. assert(
2ccb0 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2ccc0 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2ccd0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
2cce0 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e utex_held(pCur->
2ccf0 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 pBtree->db->mute
2cd00 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
2cd10 70 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 74 pRes );. assert
2cd20 28 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d ( (pIdxKey==0)==
2cd30 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d (pCur->pKeyInfo=
2cd40 3d 30 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 =0) );. assert(
2cd50 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
2cd60 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 28 URSOR_VALID || (
2cd70 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 70 43 pIdxKey==0)==(pC
2cd80 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 21 3d 30 ur->curIntKey!=0
2cd90 29 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 ) );.. /* If th
2cda0 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 e cursor is alre
2cdb0 61 64 79 20 70 6f 73 69 74 69 6f 6e 65 64 20 61 ady positioned a
2cdc0 74 20 74 68 65 20 70 6f 69 6e 74 20 77 65 20 61 t the point we a
2cdd0 72 65 20 74 72 79 69 6e 67 0a 20 20 2a 2a 20 74 re trying. ** t
2cde0 6f 20 6d 6f 76 65 20 74 6f 2c 20 74 68 65 6e 20 o move to, then
2cdf0 6a 75 73 74 20 72 65 74 75 72 6e 20 77 69 74 68 just return with
2ce00 6f 75 74 20 64 6f 69 6e 67 20 61 6e 79 20 77 6f out doing any wo
2ce10 72 6b 20 2a 2f 0a 20 20 69 66 28 20 70 49 64 78 rk */. if( pIdx
2ce20 4b 65 79 3d 3d 30 0a 20 20 20 26 26 20 70 43 75 Key==0. && pCu
2ce30 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
2ce40 52 5f 56 41 4c 49 44 20 26 26 20 28 70 43 75 72 R_VALID && (pCur
2ce50 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2ce60 46 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d 30 0a F_ValidNKey)!=0.
2ce70 20 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 ){. if( pCu
2ce80 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e r->info.nKey==in
2ce90 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 tKey ){. *p
2cea0 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 Res = 0;. r
2ceb0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2cec0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
2ced0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3c 69 Cur->info.nKey<i
2cee0 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 69 ntKey ){. i
2cef0 66 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 f( (pCur->curFla
2cf00 67 73 20 26 20 42 54 43 46 5f 41 74 4c 61 73 74 gs & BTCF_AtLast
2cf10 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 )!=0 ){.
2cf20 2a 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 *pRes = -1;.
2cf30 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2cf40 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 E_OK;. }.
2cf50 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 72 65 /* If the re
2cf60 71 75 65 73 74 65 64 20 6b 65 79 20 69 73 20 6f quested key is o
2cf70 6e 65 20 6d 6f 72 65 20 74 68 61 6e 20 74 68 65 ne more than the
2cf80 20 70 72 65 76 69 6f 75 73 20 6b 65 79 2c 20 74 previous key, t
2cf90 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 74 72 79 hen. ** try
2cfa0 20 74 6f 20 67 65 74 20 74 68 65 72 65 20 75 73 to get there us
2cfb0 69 6e 67 20 73 71 6c 69 74 65 33 42 74 72 65 65 ing sqlite3Btree
2cfc0 4e 65 78 74 28 29 20 72 61 74 68 65 72 20 74 68 Next() rather th
2cfd0 61 6e 20 61 20 66 75 6c 6c 0a 20 20 20 20 20 20 an a full.
2cfe0 2a 2a 20 62 69 6e 61 72 79 20 73 65 61 72 63 68 ** binary search
2cff0 2e 20 20 54 68 69 73 20 69 73 20 61 6e 20 6f 70 . This is an op
2d000 74 69 6d 69 7a 61 74 69 6f 6e 20 6f 6e 6c 79 2e timization only.
2d010 20 20 54 68 65 20 63 6f 72 72 65 63 74 20 61 6e The correct an
2d020 73 77 65 72 0a 20 20 20 20 20 20 2a 2a 20 69 73 swer. ** is
2d030 20 73 74 69 6c 6c 20 6f 62 74 61 69 6e 65 64 20 still obtained
2d040 77 69 74 68 6f 75 74 20 74 68 69 73 20 63 61 73 without this cas
2d050 65 2c 20 6f 6e 6c 79 20 61 20 6c 69 74 74 6c 65 e, only a little
2d060 20 6d 6f 72 65 20 73 6c 6f 77 65 6c 79 20 2a 2f more slowely */
2d070 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
2d080 3e 69 6e 66 6f 2e 6e 4b 65 79 2b 31 3d 3d 69 6e >info.nKey+1==in
2d090 74 4b 65 79 20 26 26 20 21 70 43 75 72 2d 3e 73 tKey && !pCur->s
2d0a0 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 kipNext ){.
2d0b0 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
2d0c0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2d0d0 65 33 42 74 72 65 65 4e 65 78 74 28 70 43 75 72 e3BtreeNext(pCur
2d0e0 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 69 66 , 0);. if
2d0f0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2d100 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 65 74 ){. get
2d110 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a CellInfo(pCur);.
2d120 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 if( pC
2d130 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 ur->info.nKey==i
2d140 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 ntKey ){.
2d150 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
2d160 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 TE_OK;.
2d170 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
2d180 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2d190 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 DONE ){.
2d1a0 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
2d1b0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
2d1c0 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
2d1d0 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a n rc;. }.
2d1e0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
2d1f0 7d 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 }.. if( pIdxKey
2d200 20 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 ){. xRecordC
2d210 6f 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 33 ompare = sqlite3
2d220 56 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 28 VdbeFindCompare(
2d230 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 49 pIdxKey);. pI
2d240 64 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 3d dxKey->errCode =
2d250 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 0;. assert(
2d260 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c 74 pIdxKey->default
2d270 5f 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 20 _rc==1 .
2d280 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 || pIdxKey->def
2d290 61 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 20 ault_rc==0 .
2d2a0 20 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d || pIdxKey-
2d2b0 3e 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 0a >default_rc==-1.
2d2c0 20 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a );. }else{.
2d2d0 20 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 xRecordCompa
2d2e0 72 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 6b re = 0; /* All k
2d2f0 65 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 73 eys are integers
2d300 20 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 */. }.. rc =
2d310 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 moveToRoot(pCur)
2d320 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
2d330 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2d340 5f 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 20 20 _EMPTY ){.
2d350 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 assert( pCur->pg
2d360 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 noRoot==0 || pCu
2d370 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d r->pPage->nCell=
2d380 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a 70 52 65 =0 );. *pRe
2d390 73 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 72 65 s = -1;. re
2d3a0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2d3b0 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e }. return
2d3c0 20 72 63 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 rc;. }. asser
2d3d0 74 28 20 70 43 75 72 2d 3e 70 50 61 67 65 20 29 t( pCur->pPage )
2d3e0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
2d3f0 2d 3e 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 ->pPage->isInit
2d400 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2d410 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
2d420 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
2d430 65 72 74 28 20 70 43 75 72 2d 3e 70 50 61 67 65 ert( pCur->pPage
2d440 2d 3e 6e 43 65 6c 6c 20 3e 20 30 20 29 3b 0a 20 ->nCell > 0 );.
2d450 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
2d460 50 61 67 65 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Page==0 || pCur-
2d470 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b >apPage[0]->intK
2d480 65 79 3d 3d 70 43 75 72 2d 3e 63 75 72 49 6e 74 ey==pCur->curInt
2d490 4b 65 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 Key );. assert(
2d4a0 20 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 pCur->curIntKey
2d4b0 20 7c 7c 20 70 49 64 78 4b 65 79 20 29 3b 0a 20 || pIdxKey );.
2d4c0 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 69 6e for(;;){. in
2d4d0 74 20 6c 77 72 2c 20 75 70 72 2c 20 69 64 78 2c t lwr, upr, idx,
2d4e0 20 63 3b 0a 20 20 20 20 50 67 6e 6f 20 63 68 6c c;. Pgno chl
2d4f0 64 50 67 3b 0a 20 20 20 20 4d 65 6d 50 61 67 65 dPg;. MemPage
2d500 20 2a 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e *pPage = pCur->
2d510 70 50 61 67 65 3b 0a 20 20 20 20 75 38 20 2a 70 pPage;. u8 *p
2d520 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Cell;
2d530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
2d540 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 63 75 72 * Pointer to cur
2d550 72 65 6e 74 20 63 65 6c 6c 20 69 6e 20 70 50 61 rent cell in pPa
2d560 67 65 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 70 50 ge */.. /* pP
2d570 61 67 65 2d 3e 6e 43 65 6c 6c 20 6d 75 73 74 20 age->nCell must
2d580 62 65 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 be greater than
2d590 7a 65 72 6f 2e 20 49 66 20 74 68 69 73 20 69 73 zero. If this is
2d5a0 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 0a 20 the root-page.
2d5b0 20 20 20 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 ** the cursor
2d5c0 20 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e would have been
2d5d0 20 49 4e 56 41 4c 49 44 20 61 62 6f 76 65 20 61 INVALID above a
2d5e0 6e 64 20 74 68 69 73 20 66 6f 72 28 3b 3b 29 20 nd this for(;;)
2d5f0 6c 6f 6f 70 0a 20 20 20 20 2a 2a 20 6e 6f 74 20 loop. ** not
2d600 72 75 6e 2e 20 49 66 20 74 68 69 73 20 69 73 20 run. If this is
2d610 6e 6f 74 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 not the root-pag
2d620 65 2c 20 74 68 65 6e 20 74 68 65 20 6d 6f 76 65 e, then the move
2d630 54 6f 43 68 69 6c 64 28 29 20 72 6f 75 74 69 6e ToChild() routin
2d640 65 0a 20 20 20 20 2a 2a 20 77 6f 75 6c 64 20 68 e. ** would h
2d650 61 76 65 20 61 6c 72 65 61 64 79 20 64 65 74 65 ave already dete
2d660 63 74 65 64 20 64 62 20 63 6f 72 72 75 70 74 69 cted db corrupti
2d670 6f 6e 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 20 70 on. Similarly, p
2d680 50 61 67 65 20 6d 75 73 74 0a 20 20 20 20 2a 2a Page must. **
2d690 20 62 65 20 74 68 65 20 72 69 67 68 74 20 6b 69 be the right ki
2d6a0 6e 64 20 28 69 6e 64 65 78 20 6f 72 20 74 61 62 nd (index or tab
2d6b0 6c 65 29 20 6f 66 20 62 2d 74 72 65 65 20 70 61 le) of b-tree pa
2d6c0 67 65 2e 20 4f 74 68 65 72 77 69 73 65 0a 20 20 ge. Otherwise.
2d6d0 20 20 2a 2a 20 61 20 6d 6f 76 65 54 6f 43 68 69 ** a moveToChi
2d6e0 6c 64 28 29 20 6f 72 20 6d 6f 76 65 54 6f 52 6f ld() or moveToRo
2d6f0 6f 74 28 29 20 63 61 6c 6c 20 77 6f 75 6c 64 20 ot() call would
2d700 68 61 76 65 20 64 65 74 65 63 74 65 64 20 63 6f have detected co
2d710 72 72 75 70 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 rruption. */.
2d720 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
2d730 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 >nCell>0 );.
2d740 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 assert( pPage->i
2d750 6e 74 4b 65 79 3d 3d 28 70 49 64 78 4b 65 79 3d ntKey==(pIdxKey=
2d760 3d 30 29 20 29 3b 0a 20 20 20 20 6c 77 72 20 3d =0) );. lwr =
2d770 20 30 3b 0a 20 20 20 20 75 70 72 20 3d 20 70 50 0;. upr = pP
2d780 61 67 65 2d 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 age->nCell-1;.
2d790 20 20 61 73 73 65 72 74 28 20 62 69 61 73 52 69 assert( biasRi
2d7a0 67 68 74 3d 3d 30 20 7c 7c 20 62 69 61 73 52 69 ght==0 || biasRi
2d7b0 67 68 74 3d 3d 31 20 29 3b 0a 20 20 20 20 69 64 ght==1 );. id
2d7c0 78 20 3d 20 75 70 72 3e 3e 28 31 2d 62 69 61 73 x = upr>>(1-bias
2d7d0 52 69 67 68 74 29 3b 20 2f 2a 20 69 64 78 20 3d Right); /* idx =
2d7e0 20 62 69 61 73 52 69 67 68 74 20 3f 20 75 70 72 biasRight ? upr
2d7f0 20 3a 20 28 6c 77 72 2b 75 70 72 29 2f 32 3b 20 : (lwr+upr)/2;
2d800 2a 2f 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 20 */. pCur->ix
2d810 3d 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 20 = (u16)idx;.
2d820 69 66 28 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 if( xRecordCompa
2d830 72 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 66 re==0 ){. f
2d840 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 20 20 20 20 or(;;){.
2d850 69 36 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 i64 nCellKey;.
2d860 20 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 66 69 pCell = fi
2d870 6e 64 43 65 6c 6c 50 61 73 74 50 74 72 28 70 50 ndCellPastPtr(pP
2d880 61 67 65 2c 20 69 64 78 29 3b 0a 20 20 20 20 20 age, idx);.
2d890 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e if( pPage->in
2d8a0 74 4b 65 79 4c 65 61 66 20 29 7b 0a 20 20 20 20 tKeyLeaf ){.
2d8b0 20 20 20 20 20 20 77 68 69 6c 65 28 20 30 78 38 while( 0x8
2d8c0 30 20 3c 3d 20 2a 28 70 43 65 6c 6c 2b 2b 29 20 0 <= *(pCell++)
2d8d0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 ){. i
2d8e0 66 28 20 70 43 65 6c 6c 3e 3d 70 50 61 67 65 2d f( pCell>=pPage-
2d8f0 3e 61 44 61 74 61 45 6e 64 20 29 7b 0a 20 20 20 >aDataEnd ){.
2d900 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
2d910 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
2d920 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
2d930 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2d940 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2d950 7d 0a 20 20 20 20 20 20 20 20 67 65 74 56 61 72 }. getVar
2d960 69 6e 74 28 70 43 65 6c 6c 2c 20 28 75 36 34 2a int(pCell, (u64*
2d970 29 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 )&nCellKey);.
2d980 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 if( nCellKe
2d990 79 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 y<intKey ){.
2d9a0 20 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b lwr = idx+
2d9b0 31 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 1;. if(
2d9c0 20 6c 77 72 3e 75 70 72 20 29 7b 20 63 20 3d 20 lwr>upr ){ c =
2d9d0 2d 31 3b 20 62 72 65 61 6b 3b 20 7d 0a 20 20 20 -1; break; }.
2d9e0 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6e }else if( n
2d9f0 43 65 6c 6c 4b 65 79 3e 69 6e 74 4b 65 79 20 29 CellKey>intKey )
2da00 7b 0a 20 20 20 20 20 20 20 20 20 20 75 70 72 20 {. upr
2da10 3d 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 = idx-1;.
2da20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 if( lwr>upr )
2da30 7b 20 63 20 3d 20 2b 31 3b 20 62 72 65 61 6b 3b { c = +1; break;
2da40 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
2da50 7b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 {. asse
2da60 72 74 28 20 6e 43 65 6c 6c 4b 65 79 3d 3d 69 6e rt( nCellKey==in
2da70 74 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 20 20 tKey );.
2da80 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 pCur->ix = (u1
2da90 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 6)idx;.
2daa0 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
2dab0 66 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 f ){.
2dac0 20 6c 77 72 20 3d 20 69 64 78 3b 0a 20 20 20 20 lwr = idx;.
2dad0 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 goto mov
2dae0 65 74 6f 5f 6e 65 78 74 5f 6c 61 79 65 72 3b 0a eto_next_layer;.
2daf0 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }else{
2db00 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 . pCu
2db10 72 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 r->curFlags |= B
2db20 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 3b 0a 20 TCF_ValidNKey;.
2db30 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d pCur-
2db40 3e 69 6e 66 6f 2e 6e 4b 65 79 20 3d 20 6e 43 65 >info.nKey = nCe
2db50 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 llKey;.
2db60 20 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 pCur->info.nS
2db70 69 7a 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ize = 0;.
2db80 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a *pRes = 0;.
2db90 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 retu
2dba0 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2dbb0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2dbc0 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 65 }. asse
2dbd0 72 74 28 20 6c 77 72 2b 75 70 72 3e 3d 30 20 29 rt( lwr+upr>=0 )
2dbe0 3b 0a 20 20 20 20 20 20 20 20 69 64 78 20 3d 20 ;. idx =
2dbf0 28 6c 77 72 2b 75 70 72 29 3e 3e 31 3b 20 20 2f (lwr+upr)>>1; /
2dc00 2a 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 * idx = (lwr+upr
2dc10 29 2f 32 3b 20 2a 2f 0a 20 20 20 20 20 20 7d 0a )/2; */. }.
2dc20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
2dc30 20 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 20 20 for(;;){.
2dc40 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 2f 2a int nCell; /*
2dc50 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 43 65 Size of the pCe
2dc60 6c 6c 20 63 65 6c 6c 20 69 6e 20 62 79 74 65 73 ll cell in bytes
2dc70 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 43 65 6c */. pCel
2dc80 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 l = findCellPast
2dc90 50 74 72 28 70 50 61 67 65 2c 20 69 64 78 29 3b Ptr(pPage, idx);
2dca0 0a 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 .. /* The
2dcb0 20 6d 61 78 69 6d 75 6d 20 73 75 70 70 6f 72 74 maximum support
2dcc0 65 64 20 70 61 67 65 2d 73 69 7a 65 20 69 73 20 ed page-size is
2dcd0 36 35 35 33 36 20 62 79 74 65 73 2e 20 54 68 69 65536 bytes. Thi
2dce0 73 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 20 20 s means that.
2dcf0 20 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 78 69 ** the maxi
2dd00 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 mum number of re
2dd10 63 6f 72 64 20 62 79 74 65 73 20 73 74 6f 72 65 cord bytes store
2dd20 64 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 42 2d d on an index B-
2dd30 54 72 65 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 Tree. **
2dd40 70 61 67 65 20 69 73 20 6c 65 73 73 20 74 68 61 page is less tha
2dd50 6e 20 31 36 33 38 34 20 62 79 74 65 73 20 61 6e n 16384 bytes an
2dd60 64 20 6d 61 79 20 62 65 20 73 74 6f 72 65 64 20 d may be stored
2dd70 61 73 20 61 20 32 2d 62 79 74 65 0a 20 20 20 20 as a 2-byte.
2dd80 20 20 20 20 2a 2a 20 76 61 72 69 6e 74 2e 20 54 ** varint. T
2dd90 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 his information
2dda0 69 73 20 75 73 65 64 20 74 6f 20 61 74 74 65 6d is used to attem
2ddb0 70 74 20 74 6f 20 61 76 6f 69 64 20 70 61 72 73 pt to avoid pars
2ddc0 69 6e 67 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 ing . **
2ddd0 74 68 65 20 65 6e 74 69 72 65 20 63 65 6c 6c 20 the entire cell
2dde0 62 79 20 63 68 65 63 6b 69 6e 67 20 66 6f 72 20 by checking for
2ddf0 74 68 65 20 63 61 73 65 73 20 77 68 65 72 65 20 the cases where
2de00 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 0a 20 the record is .
2de10 20 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 65 64 ** stored
2de20 20 65 6e 74 69 72 65 6c 79 20 77 69 74 68 69 6e entirely within
2de30 20 74 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 the b-tree page
2de40 20 62 79 20 69 6e 73 70 65 63 74 69 6e 67 20 74 by inspecting t
2de50 68 65 20 66 69 72 73 74 20 0a 20 20 20 20 20 20 he first .
2de60 20 20 2a 2a 20 32 20 62 79 74 65 73 20 6f 66 20 ** 2 bytes of
2de70 74 68 65 20 63 65 6c 6c 2e 0a 20 20 20 20 20 20 the cell..
2de80 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6e 43 65 */. nCe
2de90 6c 6c 20 3d 20 70 43 65 6c 6c 5b 30 5d 3b 0a 20 ll = pCell[0];.
2dea0 20 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c if( nCell
2deb0 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 <=pPage->max1byt
2dec0 65 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 ePayload ){.
2ded0 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 /* This br
2dee0 61 6e 63 68 20 72 75 6e 73 20 69 66 20 74 68 65 anch runs if the
2def0 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 69 65 record-size fie
2df00 6c 64 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 69 ld of the cell i
2df10 73 20 61 0a 20 20 20 20 20 20 20 20 20 20 2a 2a s a. **
2df20 20 73 69 6e 67 6c 65 20 62 79 74 65 20 76 61 72 single byte var
2df30 69 6e 74 20 61 6e 64 20 74 68 65 20 72 65 63 6f int and the reco
2df40 72 64 20 66 69 74 73 20 65 6e 74 69 72 65 6c 79 rd fits entirely
2df50 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 20 20 on the main.
2df60 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 65 65 ** b-tree
2df70 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 page. */.
2df80 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 testcase( p
2df90 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d 70 50 Cell+nCell+1==pP
2dfa0 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b age->aDataEnd );
2dfb0 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 . c = x
2dfc0 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 RecordCompare(nC
2dfd0 65 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 ell, (void*)&pCe
2dfe0 6c 6c 5b 31 5d 2c 20 70 49 64 78 4b 65 79 29 3b ll[1], pIdxKey);
2dff0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
2e000 66 28 20 21 28 70 43 65 6c 6c 5b 31 5d 20 26 20 f( !(pCell[1] &
2e010 30 78 38 30 29 20 0a 20 20 20 20 20 20 20 20 20 0x80) .
2e020 20 26 26 20 28 6e 43 65 6c 6c 20 3d 20 28 28 6e && (nCell = ((n
2e030 43 65 6c 6c 26 30 78 37 66 29 3c 3c 37 29 20 2b Cell&0x7f)<<7) +
2e040 20 70 43 65 6c 6c 5b 31 5d 29 3c 3d 70 50 61 67 pCell[1])<=pPag
2e050 65 2d 3e 6d 61 78 4c 6f 63 61 6c 0a 20 20 20 20 e->maxLocal.
2e060 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ){.
2e070 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 2d 73 /* The record-s
2e080 69 7a 65 20 66 69 65 6c 64 20 69 73 20 61 20 32 ize field is a 2
2e090 20 62 79 74 65 20 76 61 72 69 6e 74 20 61 6e 64 byte varint and
2e0a0 20 74 68 65 20 72 65 63 6f 72 64 20 0a 20 20 20 the record .
2e0b0 20 20 20 20 20 20 20 2a 2a 20 66 69 74 73 20 65 ** fits e
2e0c0 6e 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d ntirely on the m
2e0d0 61 69 6e 20 62 2d 74 72 65 65 20 70 61 67 65 2e ain b-tree page.
2e0e0 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 */. t
2e0f0 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c 2b 6e estcase( pCell+n
2e100 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d 3e 61 Cell+2==pPage->a
2e110 44 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 20 20 DataEnd );.
2e120 20 20 20 20 20 63 20 3d 20 78 52 65 63 6f 72 64 c = xRecord
2e130 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 28 Compare(nCell, (
2e140 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 32 5d 2c void*)&pCell[2],
2e150 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 pIdxKey);.
2e160 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2e170 20 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 /* The recor
2e180 64 20 66 6c 6f 77 73 20 6f 76 65 72 20 6f 6e 74 d flows over ont
2e190 6f 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 o one or more ov
2e1a0 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 49 6e erflow pages. In
2e1b0 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 . ** th
2e1c0 69 73 20 63 61 73 65 20 74 68 65 20 77 68 6f 6c is case the whol
2e1d0 65 20 63 65 6c 6c 20 6e 65 65 64 73 20 74 6f 20 e cell needs to
2e1e0 62 65 20 70 61 72 73 65 64 2c 20 61 20 62 75 66 be parsed, a buf
2e1f0 66 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 20 20 fer allocated.
2e200 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 61 ** and a
2e210 63 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 75 ccessPayload() u
2e220 73 65 64 20 74 6f 20 72 65 74 72 69 65 76 65 20 sed to retrieve
2e230 74 68 65 20 72 65 63 6f 72 64 20 69 6e 74 6f 20 the record into
2e240 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a the. **
2e250 20 62 75 66 66 65 72 20 62 65 66 6f 72 65 20 56 buffer before V
2e260 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 dbeRecordCompare
2e270 28 29 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 () can be called
2e280 2e 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 0a . . **.
2e290 20 20 20 20 20 20 20 20 20 20 2a 2a 20 49 66 20 ** If
2e2a0 74 68 65 20 72 65 63 6f 72 64 20 69 73 20 63 6f the record is co
2e2b0 72 72 75 70 74 2c 20 74 68 65 20 78 52 65 63 6f rrupt, the xReco
2e2c0 72 64 43 6f 6d 70 61 72 65 20 72 6f 75 74 69 6e rdCompare routin
2e2d0 65 20 6d 61 79 20 72 65 61 64 0a 20 20 20 20 20 e may read.
2e2e0 20 20 20 20 20 2a 2a 20 75 70 20 74 6f 20 74 77 ** up to tw
2e2f0 6f 20 76 61 72 69 6e 74 73 20 70 61 73 74 20 74 o varints past t
2e300 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 62 75 he end of the bu
2e310 66 66 65 72 2e 20 41 6e 20 65 78 74 72 61 20 31 ffer. An extra 1
2e320 38 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 8 . **
2e330 62 79 74 65 73 20 6f 66 20 70 61 64 64 69 6e 67 bytes of padding
2e340 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 74 is allocated at
2e350 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 the end of the
2e360 62 75 66 66 65 72 20 69 6e 0a 20 20 20 20 20 20 buffer in.
2e370 20 20 20 20 2a 2a 20 63 61 73 65 20 74 68 69 73 ** case this
2e380 20 68 61 70 70 65 6e 73 2e 20 20 2a 2f 0a 20 20 happens. */.
2e390 20 20 20 20 20 20 20 20 76 6f 69 64 20 2a 70 43 void *pC
2e3a0 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 ellKey;.
2e3b0 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 43 65 u8 * const pCe
2e3c0 6c 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c 20 2d llBody = pCell -
2e3d0 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
2e3e0 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 20 20 Size;.
2e3f0 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c pPage->xParseCel
2e400 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 42 6f l(pPage, pCellBo
2e410 64 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 dy, &pCur->info)
2e420 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 43 65 6c ;. nCel
2e430 6c 20 3d 20 28 69 6e 74 29 70 43 75 72 2d 3e 69 l = (int)pCur->i
2e440 6e 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 20 20 nfo.nKey;.
2e450 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 testcase( nC
2e460 65 6c 6c 3c 30 20 29 3b 20 20 20 2f 2a 20 54 72 ell<0 ); /* Tr
2e470 75 65 20 69 66 20 6b 65 79 20 73 69 7a 65 20 69 ue if key size i
2e480 73 20 32 5e 33 32 20 6f 72 20 6d 6f 72 65 20 2a s 2^32 or more *
2e490 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 /. test
2e4a0 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 30 20 29 case( nCell==0 )
2e4b0 3b 20 20 2f 2a 20 49 6e 76 61 6c 69 64 20 6b 65 ; /* Invalid ke
2e4c0 79 20 73 69 7a 65 3a 20 20 30 78 38 30 20 30 78 y size: 0x80 0x
2e4d0 38 30 20 30 78 30 30 20 2a 2f 0a 20 20 20 20 20 80 0x00 */.
2e4e0 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e testcase( n
2e4f0 43 65 6c 6c 3d 3d 31 20 29 3b 20 20 2f 2a 20 49 Cell==1 ); /* I
2e500 6e 76 61 6c 69 64 20 6b 65 79 20 73 69 7a 65 3a nvalid key size:
2e510 20 20 30 78 38 30 20 30 78 38 30 20 30 78 30 31 0x80 0x80 0x01
2e520 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 */. te
2e530 73 74 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 32 stcase( nCell==2
2e540 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 ); /* Minimum
2e550 6c 65 67 61 6c 20 69 6e 64 65 78 20 6b 65 79 20 legal index key
2e560 73 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 size */.
2e570 20 20 69 66 28 20 6e 43 65 6c 6c 3c 32 20 7c 7c if( nCell<2 ||
2e580 20 6e 43 65 6c 6c 2f 70 43 75 72 2d 3e 70 42 74 nCell/pCur->pBt
2e590 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3e 70 43 75 ->usableSize>pCu
2e5a0 72 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 20 29 7b r->pBt->nPage ){
2e5b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
2e5c0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
2e5d0 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
2e5e0 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d goto m
2e5f0 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 oveto_finish;.
2e600 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2e610 20 20 20 20 70 43 65 6c 6c 4b 65 79 20 3d 20 73 pCellKey = s
2e620 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 6e 43 qlite3Malloc( nC
2e630 65 6c 6c 2b 31 38 20 29 3b 0a 20 20 20 20 20 20 ell+18 );.
2e640 20 20 20 20 69 66 28 20 70 43 65 6c 6c 4b 65 79 if( pCellKey
2e650 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
2e660 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
2e670 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 OMEM_BKPT;.
2e680 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 goto move
2e690 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 to_finish;.
2e6a0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2e6b0 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 pCur->ix = (u16
2e6c0 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 20 )idx;.
2e6d0 72 63 20 3d 20 61 63 63 65 73 73 50 61 79 6c 6f rc = accessPaylo
2e6e0 61 64 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c ad(pCur, 0, nCel
2e6f0 6c 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61 l, (unsigned cha
2e700 72 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 30 29 3b r*)pCellKey, 0);
2e710 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d . pCur-
2e720 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 >curFlags &= ~BT
2e730 43 46 5f 56 61 6c 69 64 4f 76 66 6c 3b 0a 20 20 CF_ValidOvfl;.
2e740 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 if( rc )
2e750 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 {. sq
2e760 6c 69 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c lite3_free(pCell
2e770 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 Key);.
2e780 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 goto moveto_fi
2e790 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 nish;.
2e7a0 7d 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 }. c =
2e7b0 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e xRecordCompare(n
2e7c0 43 65 6c 6c 2c 20 70 43 65 6c 6c 4b 65 79 2c 20 Cell, pCellKey,
2e7d0 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 pIdxKey);.
2e7e0 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
2e7f0 28 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 (pCellKey);.
2e800 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 }. as
2e810 73 65 72 74 28 20 0a 20 20 20 20 20 20 20 20 20 sert( .
2e820 20 20 20 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 (pIdxKey->err
2e830 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 43 4f 52 Code!=SQLITE_COR
2e840 52 55 50 54 20 7c 7c 20 63 3d 3d 30 29 0a 20 20 RUPT || c==0).
2e850 20 20 20 20 20 20 20 26 26 20 28 70 49 64 78 4b && (pIdxK
2e860 65 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c ey->errCode!=SQL
2e870 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 70 43 75 ITE_NOMEM || pCu
2e880 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d r->pBtree->db->m
2e890 61 6c 6c 6f 63 46 61 69 6c 65 64 29 0a 20 20 20 allocFailed).
2e8a0 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 );.
2e8b0 69 66 28 20 63 3c 30 20 29 7b 0a 20 20 20 20 20 if( c<0 ){.
2e8c0 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 lwr = idx+1
2e8d0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 ;. }else
2e8e0 69 66 28 20 63 3e 30 20 29 7b 0a 20 20 20 20 20 if( c>0 ){.
2e8f0 20 20 20 20 20 75 70 72 20 3d 20 69 64 78 2d 31 upr = idx-1
2e900 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
2e910 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
2e920 74 28 20 63 3d 3d 30 20 29 3b 0a 20 20 20 20 20 t( c==0 );.
2e930 20 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a *pRes = 0;.
2e940 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 rc = S
2e950 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
2e960 20 20 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 pCur->ix = (
2e970 75 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 u16)idx;.
2e980 20 20 20 69 66 28 20 70 49 64 78 4b 65 79 2d 3e if( pIdxKey->
2e990 65 72 72 43 6f 64 65 20 29 20 72 63 20 3d 20 53 errCode ) rc = S
2e9a0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
2e9b0 50 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f PT;. go
2e9c0 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 to moveto_finish
2e9d0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
2e9e0 20 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 if( lwr>upr
2e9f0 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 ) break;.
2ea00 20 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 72 assert( lwr+upr
2ea10 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 >=0 );. i
2ea20 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e 3e dx = (lwr+upr)>>
2ea30 31 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c 77 1; /* idx = (lw
2ea40 72 2b 75 70 72 29 2f 32 20 2a 2f 0a 20 20 20 20 r+upr)/2 */.
2ea50 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 }. }. as
2ea60 73 65 72 74 28 20 6c 77 72 3d 3d 75 70 72 2b 31 sert( lwr==upr+1
2ea70 20 7c 7c 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b || (pPage->intK
2ea80 65 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 ey && !pPage->le
2ea90 61 66 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 af) );. asser
2eaa0 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 t( pPage->isInit
2eab0 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 );. if( pPag
2eac0 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
2ead0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
2eae0 78 3c 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e x<pCur->pPage->n
2eaf0 43 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 70 43 Cell );. pC
2eb00 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 29 69 64 ur->ix = (u16)id
2eb10 78 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d x;. *pRes =
2eb20 20 63 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 c;. rc = S
2eb30 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 QLITE_OK;.
2eb40 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 goto moveto_fini
2eb50 73 68 3b 0a 20 20 20 20 7d 0a 6d 6f 76 65 74 6f sh;. }.moveto
2eb60 5f 6e 65 78 74 5f 6c 61 79 65 72 3a 0a 20 20 20 _next_layer:.
2eb70 20 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d if( lwr>=pPage-
2eb80 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 >nCell ){.
2eb90 63 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 chldPg = get4byt
2eba0 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b e(&pPage->aData[
2ebb0 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 pPage->hdrOffset
2ebc0 2b 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b +8]);. }else{
2ebd0 0a 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 . chldPg =
2ebe0 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c get4byte(findCel
2ebf0 6c 28 70 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a l(pPage, lwr));.
2ec00 20 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e }. pCur->
2ec10 69 78 20 3d 20 28 75 31 36 29 6c 77 72 3b 0a 20 ix = (u16)lwr;.
2ec20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 rc = moveToCh
2ec30 69 6c 64 28 70 43 75 72 2c 20 63 68 6c 64 50 67 ild(pCur, chldPg
2ec40 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
2ec50 62 72 65 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 65 74 break;. }.movet
2ec60 6f 5f 66 69 6e 69 73 68 3a 0a 20 20 70 43 75 72 o_finish:. pCur
2ec70 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
2ec80 3b 0a 20 20 61 73 73 65 72 74 28 20 28 70 43 75 ;. assert( (pCu
2ec90 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 r->curFlags & BT
2eca0 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 CF_ValidOvfl)==0
2ecb0 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
2ecc0 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 .}.../*.** Retur
2ecd0 6e 20 54 52 55 45 20 69 66 20 74 68 65 20 63 75 n TRUE if the cu
2ece0 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f 69 6e rsor is not poin
2ecf0 74 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 ting at an entry
2ed00 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a of the table..*
2ed10 2a 0a 2a 2a 20 54 52 55 45 20 77 69 6c 6c 20 62 *.** TRUE will b
2ed20 65 20 72 65 74 75 72 6e 65 64 20 61 66 74 65 72 e returned after
2ed30 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 a call to sqlit
2ed40 65 33 42 74 72 65 65 4e 65 78 74 28 29 20 6d 6f e3BtreeNext() mo
2ed50 76 65 73 0a 2a 2a 20 70 61 73 74 20 74 68 65 20 ves.** past the
2ed60 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 last entry in th
2ed70 65 20 74 61 62 6c 65 20 6f 72 20 73 71 6c 69 74 e table or sqlit
2ed80 65 33 42 74 72 65 65 50 72 65 76 28 29 20 6d 6f e3BtreePrev() mo
2ed90 76 65 73 20 70 61 73 74 0a 2a 2a 20 74 68 65 20 ves past.** the
2eda0 66 69 72 73 74 20 65 6e 74 72 79 2e 20 20 54 52 first entry. TR
2edb0 55 45 20 69 73 20 61 6c 73 6f 20 72 65 74 75 72 UE is also retur
2edc0 6e 65 64 20 69 66 20 74 68 65 20 74 61 62 6c 65 ned if the table
2edd0 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e is empty..*/.in
2ede0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6f t sqlite3BtreeEo
2edf0 66 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 f(BtCursor *pCur
2ee00 29 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 57 68 ){. /* TODO: Wh
2ee10 61 74 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 at if the cursor
2ee20 20 69 73 20 69 6e 20 43 55 52 53 4f 52 5f 52 45 is in CURSOR_RE
2ee30 51 55 49 52 45 53 45 45 4b 20 62 75 74 20 61 6c QUIRESEEK but al
2ee40 6c 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 0a l table entries.
2ee50 20 20 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 64 ** have been d
2ee60 65 6c 65 74 65 64 3f 20 54 68 69 73 20 41 50 49 eleted? This API
2ee70 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 63 68 will need to ch
2ee80 61 6e 67 65 20 74 6f 20 72 65 74 75 72 6e 20 61 ange to return a
2ee90 6e 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a n error code. *
2eea0 2a 20 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 * as well as the
2eeb0 20 62 6f 6f 6c 65 61 6e 20 72 65 73 75 6c 74 20 boolean result
2eec0 76 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 72 65 value.. */. re
2eed0 74 75 72 6e 20 28 43 55 52 53 4f 52 5f 56 41 4c turn (CURSOR_VAL
2eee0 49 44 21 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 ID!=pCur->eState
2eef0 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 );.}../*.** Retu
2ef00 72 6e 20 61 6e 20 65 73 74 69 6d 61 74 65 20 66 rn an estimate f
2ef10 6f 72 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 or the number of
2ef20 20 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 62 rows in the tab
2ef30 6c 65 20 74 68 61 74 20 70 43 75 72 20 69 73 0a le that pCur is.
2ef40 2a 2a 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 ** pointing to.
2ef50 20 52 65 74 75 72 6e 20 61 20 6e 65 67 61 74 69 Return a negati
2ef60 76 65 20 6e 75 6d 62 65 72 20 69 66 20 6e 6f 20 ve number if no
2ef70 65 73 74 69 6d 61 74 65 20 69 73 20 63 75 72 72 estimate is curr
2ef80 65 6e 74 6c 79 20 0a 2a 2a 20 61 76 61 69 6c 61 ently .** availa
2ef90 62 6c 65 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 ble..*/.i64 sqli
2efa0 74 65 33 42 74 72 65 65 52 6f 77 43 6f 75 6e 74 te3BtreeRowCount
2efb0 45 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 Est(BtCursor *pC
2efc0 75 72 29 7b 0a 20 20 69 36 34 20 6e 3b 0a 20 20 ur){. i64 n;.
2efd0 75 38 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 u8 i;.. assert(
2efe0 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2eff0 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2f000 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
2f010 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e utex_held(pCur->
2f020 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 pBtree->db->mute
2f030 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 75 72 72 x) );.. /* Curr
2f040 65 6e 74 6c 79 20 74 68 69 73 20 69 6e 74 65 72 ently this inter
2f050 66 61 63 65 20 69 73 20 6f 6e 6c 79 20 63 61 6c face is only cal
2f060 6c 65 64 20 62 79 20 74 68 65 20 4f 50 5f 49 66 led by the OP_If
2f070 53 6d 61 6c 6c 65 72 0a 20 20 2a 2a 20 6f 70 63 Smaller. ** opc
2f080 6f 64 65 2c 20 61 6e 64 20 69 74 20 74 68 61 74 ode, and it that
2f090 20 63 61 73 65 20 74 68 65 20 63 75 72 73 6f 72 case the cursor
2f0a0 20 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 will always be
2f0b0 76 61 6c 69 64 20 61 6e 64 0a 20 20 2a 2a 20 77 valid and. ** w
2f0c0 69 6c 6c 20 61 6c 77 61 79 73 20 70 6f 69 6e 74 ill always point
2f0d0 20 74 6f 20 61 20 6c 65 61 66 20 6e 6f 64 65 2e to a leaf node.
2f0e0 20 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 52 28 */. if( NEVER(
2f0f0 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
2f100 52 53 4f 52 5f 56 41 4c 49 44 29 20 29 20 72 65 RSOR_VALID) ) re
2f110 74 75 72 6e 20 2d 31 3b 0a 20 20 69 66 28 20 4e turn -1;. if( N
2f120 45 56 45 52 28 70 43 75 72 2d 3e 70 50 61 67 65 EVER(pCur->pPage
2f130 2d 3e 6c 65 61 66 3d 3d 30 29 20 29 20 72 65 74 ->leaf==0) ) ret
2f140 75 72 6e 20 2d 31 3b 0a 0a 20 20 6e 20 3d 20 70 urn -1;.. n = p
2f150 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c Cur->pPage->nCel
2f160 6c 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c l;. for(i=0; i<
2f170 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b pCur->iPage; i++
2f180 29 7b 0a 20 20 20 20 6e 20 2a 3d 20 70 43 75 72 ){. n *= pCur
2f190 2d 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 6e 43 65 ->apPage[i]->nCe
2f1a0 6c 6c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e ll;. }. return
2f1b0 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 n;.}../*.** Adv
2f1c0 61 6e 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 ance the cursor
2f1d0 74 6f 20 74 68 65 20 6e 65 78 74 20 65 6e 74 72 to the next entr
2f1e0 79 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 y in the databas
2f1f0 65 2e 20 0a 2a 2a 20 52 65 74 75 72 6e 20 76 61 e. .** Return va
2f200 6c 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 53 51 lue:.**.** SQ
2f210 4c 49 54 45 5f 4f 4b 20 20 20 20 20 20 20 20 73 LITE_OK s
2f220 75 63 63 65 73 73 0a 2a 2a 20 20 20 20 53 51 4c uccess.** SQL
2f230 49 54 45 5f 44 4f 4e 45 20 20 20 20 20 20 63 75 ITE_DONE cu
2f240 72 73 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 rsor is already
2f250 70 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 20 pointing at the
2f260 6c 61 73 74 20 65 6c 65 6d 65 6e 74 0a 2a 2a 20 last element.**
2f270 20 20 20 6f 74 68 65 72 77 69 73 65 20 20 20 20 otherwise
2f280 20 20 20 20 73 6f 6d 65 20 6b 69 6e 64 20 6f 66 some kind of
2f290 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 0a error occurred.
2f2a0 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 65 **.** The main e
2f2b0 6e 74 72 79 20 70 6f 69 6e 74 20 69 73 20 73 71 ntry point is sq
2f2c0 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 lite3BtreeNext()
2f2d0 2e 20 20 54 68 61 74 20 72 6f 75 74 69 6e 65 20 . That routine
2f2e0 69 73 20 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 is optimized.**
2f2f0 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 for the common c
2f300 61 73 65 20 6f 66 20 6d 65 72 65 6c 79 20 69 6e ase of merely in
2f310 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 crementing the c
2f320 65 6c 6c 20 63 6f 75 6e 74 65 72 20 42 74 43 75 ell counter BtCu
2f330 72 73 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f rsor.aiIdx.** to
2f340 20 74 68 65 20 6e 65 78 74 20 63 65 6c 6c 20 6f the next cell o
2f350 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 n the current pa
2f360 67 65 2e 20 20 54 68 65 20 28 73 6c 6f 77 65 72 ge. The (slower
2f370 29 20 62 74 72 65 65 4e 65 78 74 28 29 20 68 65 ) btreeNext() he
2f380 6c 70 65 72 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 lper.** routine
2f390 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 is called when i
2f3a0 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 t is necessary t
2f3b0 6f 20 6d 6f 76 65 20 74 6f 20 61 20 64 69 66 66 o move to a diff
2f3c0 65 72 65 6e 74 20 70 61 67 65 20 6f 72 0a 2a 2a erent page or.**
2f3d0 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 to restore the
2f3e0 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 cursor..**.** If
2f3f0 20 62 69 74 20 30 78 30 31 20 6f 66 20 74 68 65 bit 0x01 of the
2f400 20 46 20 61 72 67 75 6d 65 6e 74 20 69 6e 20 73 F argument in s
2f410 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 qlite3BtreeNext(
2f420 43 2c 46 29 20 69 73 20 31 2c 20 74 68 65 6e 20 C,F) is 1, then
2f430 74 68 65 0a 2a 2a 20 63 75 72 73 6f 72 20 63 6f the.** cursor co
2f440 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 6e 20 rresponds to an
2f450 53 51 4c 20 69 6e 64 65 78 20 61 6e 64 20 74 68 SQL index and th
2f460 69 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 is routine could
2f470 20 68 61 76 65 20 62 65 65 6e 0a 2a 2a 20 73 6b have been.** sk
2f480 69 70 70 65 64 20 69 66 20 74 68 65 20 53 51 4c ipped if the SQL
2f490 20 69 6e 64 65 78 20 68 61 64 20 62 65 65 6e 20 index had been
2f4a0 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 a unique index.
2f4b0 20 54 68 65 20 46 20 61 72 67 75 6d 65 6e 74 0a The F argument.
2f4c0 2a 2a 20 69 73 20 61 20 68 69 6e 74 20 74 6f 20 ** is a hint to
2f4d0 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 2e 20 20 the implement.
2f4e0 53 51 4c 69 74 65 20 62 74 72 65 65 20 69 6d 70 SQLite btree imp
2f4f0 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 lementation does
2f500 20 6e 6f 74 20 75 73 65 0a 2a 2a 20 74 68 69 73 not use.** this
2f510 20 68 69 6e 74 2c 20 62 75 74 20 43 4f 4d 44 42 hint, but COMDB
2f520 32 20 64 6f 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 2 does..*/.stati
2f530 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e c SQLITE_NOINLIN
2f540 45 20 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 E int btreeNext(
2f550 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
2f560 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 . int rc;. int
2f570 20 69 64 78 3b 0a 20 20 4d 65 6d 50 61 67 65 20 idx;. MemPage
2f580 2a 70 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 *pPage;.. asser
2f590 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
2f5a0 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
2f5b0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 assert( pCur->s
2f5c0 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 kipNext==0 || pC
2f5d0 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
2f5e0 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 69 66 OR_VALID );. if
2f5f0 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d ( pCur->eState!=
2f600 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a CURSOR_VALID ){.
2f610 20 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 assert( (pCu
2f620 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 r->curFlags & BT
2f630 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 CF_ValidOvfl)==0
2f640 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 );. rc = res
2f650 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
2f660 6f 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 on(pCur);. if
2f670 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
2f680 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
2f690 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 rc;. }. if
2f6a0 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ( CURSOR_INVALID
2f6b0 3d 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 ==pCur->eState )
2f6c0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
2f6d0 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 QLITE_DONE;.
2f6e0 7d 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e }. if( pCur->
2f6f0 73 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 skipNext ){.
2f700 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2f710 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
2f720 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 ALID || pCur->eS
2f730 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 tate==CURSOR_SKI
2f740 50 4e 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 PNEXT );. p
2f750 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 Cur->eState = CU
2f760 52 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 RSOR_VALID;.
2f770 20 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 if( pCur->skip
2f780 4e 65 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 Next>0 ){.
2f790 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 pCur->skipNext
2f7a0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 = 0;. re
2f7b0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2f7c0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 }. pC
2f7d0 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 ur->skipNext = 0
2f7e0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 ;. }. }.. p
2f7f0 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 50 61 Page = pCur->pPa
2f800 67 65 3b 0a 20 20 69 64 78 20 3d 20 2b 2b 70 43 ge;. idx = ++pC
2f810 75 72 2d 3e 69 78 3b 0a 20 20 69 66 28 20 21 70 ur->ix;. if( !p
2f820 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a Page->isInit ){.
2f830 20 20 20 20 2f 2a 20 54 68 65 20 6f 6e 6c 79 20 /* The only
2f840 6b 6e 6f 77 6e 20 77 61 79 20 66 6f 72 20 74 68 known way for th
2f850 69 73 20 74 6f 20 68 61 70 70 65 6e 20 69 73 20 is to happen is
2f860 66 6f 72 20 74 68 65 72 65 20 74 6f 20 62 65 20 for there to be
2f870 61 0a 20 20 20 20 2a 2a 20 72 65 63 75 72 73 69 a. ** recursi
2f880 76 65 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 ve SQL function
2f890 74 68 61 74 20 64 6f 65 73 20 61 20 44 45 4c 45 that does a DELE
2f8a0 54 45 20 6f 70 65 72 61 74 69 6f 6e 20 61 73 20 TE operation as
2f8b0 70 61 72 74 20 6f 66 20 61 0a 20 20 20 20 2a 2a part of a. **
2f8c0 20 53 45 4c 45 43 54 20 77 68 69 63 68 20 64 65 SELECT which de
2f8d0 6c 65 74 65 73 20 63 6f 6e 74 65 6e 74 20 6f 75 letes content ou
2f8e0 74 20 66 72 6f 6d 20 75 6e 64 65 72 20 61 6e 20 t from under an
2f8f0 61 63 74 69 76 65 20 63 75 72 73 6f 72 0a 20 20 active cursor.
2f900 20 20 2a 2a 20 69 6e 20 61 20 63 6f 72 72 75 70 ** in a corrup
2f910 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 t database file
2f920 77 68 65 72 65 20 74 68 65 20 74 61 62 6c 65 20 where the table
2f930 62 65 69 6e 67 20 44 45 4c 45 54 45 2d 65 64 20 being DELETE-ed
2f940 66 72 6f 6d 0a 20 20 20 20 2a 2a 20 68 61 73 20 from. ** has
2f950 70 61 67 65 73 20 69 6e 20 63 6f 6d 6d 6f 6e 20 pages in common
2f960 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 20 62 with the table b
2f970 65 69 6e 67 20 71 75 65 72 69 65 64 2e 20 20 53 eing queried. S
2f980 65 65 20 54 48 33 0a 20 20 20 20 2a 2a 20 6d 6f ee TH3. ** mo
2f990 64 75 6c 65 20 63 6f 76 31 2f 62 74 72 65 65 37 dule cov1/btree7
2f9a0 38 2e 74 65 73 74 20 74 65 73 74 63 61 73 65 20 8.test testcase
2f9b0 32 32 30 20 28 32 30 31 38 2d 30 36 2d 30 38 29 220 (2018-06-08)
2f9c0 20 66 6f 72 20 61 6e 0a 20 20 20 20 2a 2a 20 65 for an. ** e
2f9d0 78 61 6d 70 6c 65 2e 20 2a 2f 0a 20 20 20 20 72 xample. */. r
2f9e0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
2f9f0 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 0a RUPT_BKPT;. }..
2fa00 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
2fa10 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 6f 72 base file is cor
2fa20 72 75 70 74 2c 20 69 74 20 69 73 20 70 6f 73 73 rupt, it is poss
2fa30 69 62 6c 65 20 66 6f 72 20 74 68 65 20 76 61 6c ible for the val
2fa40 75 65 20 6f 66 20 69 64 78 20 0a 20 20 2a 2a 20 ue of idx . **
2fa50 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 20 68 65 to be invalid he
2fa60 72 65 2e 20 54 68 69 73 20 63 61 6e 20 6f 6e 6c re. This can onl
2fa70 79 20 6f 63 63 75 72 20 69 66 20 61 20 73 65 63 y occur if a sec
2fa80 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f 64 69 66 ond cursor modif
2fa90 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 ies. ** the pag
2faa0 65 20 77 68 69 6c 65 20 63 75 72 73 6f 72 20 70 e while cursor p
2fab0 43 75 72 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 Cur is holding a
2fac0 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 69 74 reference to it
2fad0 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 20 2a 2a . Which can. **
2fae0 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 69 66 20 only happen if
2faf0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
2fb00 63 6f 72 72 75 70 74 20 69 6e 20 73 75 63 68 20 corrupt in such
2fb10 61 20 77 61 79 20 61 73 20 74 6f 20 6c 69 6e 6b a way as to link
2fb20 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 65 20 69 the. ** page i
2fb30 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e nto more than on
2fb40 65 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 e b-tree structu
2fb50 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 re. */. testcas
2fb60 65 28 20 69 64 78 3e 70 50 61 67 65 2d 3e 6e 43 e( idx>pPage->nC
2fb70 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 20 69 64 ell );.. if( id
2fb80 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 x>=pPage->nCell
2fb90 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 ){. if( !pPag
2fba0 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 e->leaf ){.
2fbb0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
2fbc0 64 28 70 43 75 72 2c 20 67 65 74 34 62 79 74 65 d(pCur, get4byte
2fbd0 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
2fbe0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
2fbf0 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 66 28 20 8]));. if(
2fc00 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a rc ) return rc;.
2fc10 20 20 20 20 20 20 72 65 74 75 72 6e 20 6d 6f 76 return mov
2fc20 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 eToLeftmost(pCur
2fc30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 6f 7b );. }. do{
2fc40 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d . if( pCur-
2fc50 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 >iPage==0 ){.
2fc60 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 pCur->eStat
2fc70 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c e = CURSOR_INVAL
2fc80 49 44 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 ID;. retu
2fc90 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a rn SQLITE_DONE;.
2fca0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6d 6f }. mo
2fcb0 76 65 54 6f 50 61 72 65 6e 74 28 70 43 75 72 29 veToParent(pCur)
2fcc0 3b 0a 20 20 20 20 20 20 70 50 61 67 65 20 3d 20 ;. pPage =
2fcd0 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 20 pCur->pPage;.
2fce0 20 7d 77 68 69 6c 65 28 20 70 43 75 72 2d 3e 69 }while( pCur->i
2fcf0 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 x>=pPage->nCell
2fd00 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 );. if( pPage
2fd10 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 ->intKey ){.
2fd20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
2fd30 42 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 20 BtreeNext(pCur,
2fd40 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 0);. }else{.
2fd50 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
2fd60 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d TE_OK;. }. }
2fd70 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 . if( pPage->le
2fd80 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e af ){. return
2fd90 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
2fda0 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 lse{. return
2fdb0 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 moveToLeftmost(p
2fdc0 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 6e 74 20 Cur);. }.}.int
2fdd0 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 sqlite3BtreeNext
2fde0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
2fdf0 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 20 4d int flags){. M
2fe00 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 emPage *pPage;.
2fe10 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
2fe20 52 28 20 66 6c 61 67 73 20 29 3b 20 20 2f 2a 20 R( flags ); /*
2fe30 55 73 65 64 20 69 6e 20 43 4f 4d 44 42 32 20 62 Used in COMDB2 b
2fe40 75 74 20 6e 6f 74 20 6e 61 74 69 76 65 20 53 51 ut not native SQ
2fe50 4c 69 74 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 Lite */. assert
2fe60 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 ( cursorOwnsBtSh
2fe70 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 ared(pCur) );.
2fe80 61 73 73 65 72 74 28 20 66 6c 61 67 73 3d 3d 30 assert( flags==0
2fe90 20 7c 7c 20 66 6c 61 67 73 3d 3d 31 20 29 3b 0a || flags==1 );.
2fea0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2feb0 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 skipNext==0 || p
2fec0 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2fed0 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 70 SOR_VALID );. p
2fee0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
2fef0 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 = 0;. pCur->cur
2ff00 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f Flags &= ~(BTCF_
2ff10 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 ValidNKey|BTCF_V
2ff20 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 69 66 28 alidOvfl);. if(
2ff30 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
2ff40 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 20 72 65 URSOR_VALID ) re
2ff50 74 75 72 6e 20 62 74 72 65 65 4e 65 78 74 28 70 turn btreeNext(p
2ff60 43 75 72 29 3b 0a 20 20 70 50 61 67 65 20 3d 20 Cur);. pPage =
2ff70 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 69 pCur->pPage;. i
2ff80 66 28 20 28 2b 2b 70 43 75 72 2d 3e 69 78 29 3e f( (++pCur->ix)>
2ff90 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b =pPage->nCell ){
2ffa0 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 2d 2d 3b . pCur->ix--;
2ffb0 0a 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 . return btre
2ffc0 65 4e 65 78 74 28 70 43 75 72 29 3b 0a 20 20 7d eNext(pCur);. }
2ffd0 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 . if( pPage->le
2ffe0 61 66 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e af ){. return
2fff0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 65 SQLITE_OK;. }e
30000 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 lse{. return
30010 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 moveToLeftmost(p
30020 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a Cur);. }.}../*.
30030 2a 2a 20 53 74 65 70 20 74 68 65 20 63 75 72 73 ** Step the curs
30040 6f 72 20 74 6f 20 74 68 65 20 62 61 63 6b 20 74 or to the back t
30050 6f 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 65 o the previous e
30060 6e 74 72 79 20 69 6e 20 74 68 65 20 64 61 74 61 ntry in the data
30070 62 61 73 65 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 base..** Return
30080 76 61 6c 75 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 values:.**.**
30090 20 20 53 51 4c 49 54 45 5f 4f 4b 20 20 20 20 20 SQLITE_OK
300a0 73 75 63 63 65 73 73 0a 2a 2a 20 20 20 20 20 53 success.** S
300b0 51 4c 49 54 45 5f 44 4f 4e 45 20 20 20 74 68 65 QLITE_DONE the
300c0 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 61 cursor is alrea
300d0 64 79 20 6f 6e 20 74 68 65 20 66 69 72 73 74 20 dy on the first
300e0 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 74 element of the t
300f0 61 62 6c 65 0a 2a 2a 20 20 20 20 20 6f 74 68 65 able.** othe
30100 72 77 69 73 65 20 20 20 20 20 73 6f 6d 65 20 6b rwise some k
30110 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 6f 63 63 ind of error occ
30120 75 72 72 65 64 0a 2a 2a 0a 2a 2a 20 54 68 65 20 urred.**.** The
30130 6d 61 69 6e 20 65 6e 74 72 79 20 70 6f 69 6e 74 main entry point
30140 20 69 73 20 73 71 6c 69 74 65 33 42 74 72 65 65 is sqlite3Btree
30150 50 72 65 76 69 6f 75 73 28 29 2e 20 20 54 68 61 Previous(). Tha
30160 74 20 72 6f 75 74 69 6e 65 20 69 73 20 6f 70 74 t routine is opt
30170 69 6d 69 7a 65 64 0a 2a 2a 20 66 6f 72 20 74 68 imized.** for th
30180 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 6f 66 e common case of
30190 20 6d 65 72 65 6c 79 20 64 65 63 72 65 6d 65 6e merely decremen
301a0 74 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 63 6f ting the cell co
301b0 75 6e 74 65 72 20 42 74 43 75 72 73 6f 72 2e 61 unter BtCursor.a
301c0 69 49 64 78 0a 2a 2a 20 74 6f 20 74 68 65 20 70 iIdx.** to the p
301d0 72 65 76 69 6f 75 73 20 63 65 6c 6c 20 6f 6e 20 revious cell on
301e0 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 the current page
301f0 2e 20 20 54 68 65 20 28 73 6c 6f 77 65 72 29 20 . The (slower)
30200 62 74 72 65 65 50 72 65 76 69 6f 75 73 28 29 0a btreePrevious().
30210 2a 2a 20 68 65 6c 70 65 72 20 72 6f 75 74 69 6e ** helper routin
30220 65 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e e is called when
30230 20 69 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 it is necessary
30240 20 74 6f 20 6d 6f 76 65 20 74 6f 20 61 20 64 69 to move to a di
30250 66 66 65 72 65 6e 74 20 70 61 67 65 0a 2a 2a 20 fferent page.**
30260 6f 72 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 or to restore th
30270 65 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 e cursor..**.**
30280 49 66 20 62 69 74 20 30 78 30 31 20 6f 66 20 74 If bit 0x01 of t
30290 68 65 20 46 20 61 72 67 75 6d 65 6e 74 20 74 6f he F argument to
302a0 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 72 65 sqlite3BtreePre
302b0 76 69 6f 75 73 28 43 2c 46 29 20 69 73 20 31 2c vious(C,F) is 1,
302c0 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 75 72 then.** the cur
302d0 73 6f 72 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 sor corresponds
302e0 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 65 78 20 to an SQL index
302f0 61 6e 64 20 74 68 69 73 20 72 6f 75 74 69 6e 65 and this routine
30300 20 63 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e could have been
30310 0a 2a 2a 20 73 6b 69 70 70 65 64 20 69 66 20 74 .** skipped if t
30320 68 65 20 53 51 4c 20 69 6e 64 65 78 20 68 61 64 he SQL index had
30330 20 62 65 65 6e 20 61 20 75 6e 69 71 75 65 20 69 been a unique i
30340 6e 64 65 78 2e 20 20 54 68 65 20 46 20 61 72 67 ndex. The F arg
30350 75 6d 65 6e 74 20 69 73 20 61 0a 2a 2a 20 68 69 ument is a.** hi
30360 6e 74 20 74 6f 20 74 68 65 20 69 6d 70 6c 65 6d nt to the implem
30370 65 6e 74 2e 20 20 54 68 65 20 6e 61 74 69 76 65 ent. The native
30380 20 53 51 4c 69 74 65 20 62 74 72 65 65 20 69 6d SQLite btree im
30390 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 plementation doe
303a0 73 20 6e 6f 74 0a 2a 2a 20 75 73 65 20 74 68 69 s not.** use thi
303b0 73 20 68 69 6e 74 2c 20 62 75 74 20 43 4f 4d 44 s hint, but COMD
303c0 42 32 20 64 6f 65 73 2e 0a 2a 2f 0a 73 74 61 74 B2 does..*/.stat
303d0 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 ic SQLITE_NOINLI
303e0 4e 45 20 69 6e 74 20 62 74 72 65 65 50 72 65 76 NE int btreePrev
303f0 69 6f 75 73 28 42 74 43 75 72 73 6f 72 20 2a 70 ious(BtCursor *p
30400 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Cur){. int rc;.
30410 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
30420 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
30430 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
30440 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
30450 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 t( pCur->skipNex
30460 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 65 53 t==0 || pCur->eS
30470 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c tate!=CURSOR_VAL
30480 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ID );. assert(
30490 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
304a0 26 20 28 42 54 43 46 5f 41 74 4c 61 73 74 7c 42 & (BTCF_AtLast|B
304b0 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c 7c 42 54 TCF_ValidOvfl|BT
304c0 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 29 3d 3d CF_ValidNKey))==
304d0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 0 );. assert( p
304e0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d Cur->info.nSize=
304f0 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 =0 );. if( pCur
30500 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 ->eState!=CURSOR
30510 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 72 63 _VALID ){. rc
30520 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 = restoreCursor
30530 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a Position(pCur);.
30540 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
30550 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 TE_OK ){. r
30560 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
30570 20 20 20 20 69 66 28 20 43 55 52 53 4f 52 5f 49 if( CURSOR_I
30580 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d 3e 65 53 NVALID==pCur->eS
30590 74 61 74 65 20 29 7b 0a 20 20 20 20 20 20 72 65 tate ){. re
305a0 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 turn SQLITE_DONE
305b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
305c0 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 29 pCur->skipNext )
305d0 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
305e0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
305f0 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 RSOR_VALID || pC
30600 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
30610 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 3b 0a 20 OR_SKIPNEXT );.
30620 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 pCur->eStat
30630 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 e = CURSOR_VALID
30640 3b 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 72 ;. if( pCur
30650 2d 3e 73 6b 69 70 4e 65 78 74 3c 30 20 29 7b 0a ->skipNext<0 ){.
30660 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b pCur->sk
30670 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 ipNext = 0;.
30680 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
30690 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 E_OK;. }.
306a0 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 pCur->skipNe
306b0 78 74 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 xt = 0;. }.
306c0 7d 0a 0a 20 20 70 50 61 67 65 20 3d 20 70 43 75 }.. pPage = pCu
306d0 72 2d 3e 70 50 61 67 65 3b 0a 20 20 61 73 73 65 r->pPage;. asse
306e0 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 rt( pPage->isIni
306f0 74 20 29 3b 0a 20 20 69 66 28 20 21 70 50 61 67 t );. if( !pPag
30700 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 69 e->leaf ){. i
30710 6e 74 20 69 64 78 20 3d 20 70 43 75 72 2d 3e 69 nt idx = pCur->i
30720 78 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 x;. rc = move
30730 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 67 65 ToChild(pCur, ge
30740 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c 28 t4byte(findCell(
30750 70 50 61 67 65 2c 20 69 64 78 29 29 29 3b 0a 20 pPage, idx)));.
30760 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
30770 72 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 rn rc;. rc =
30780 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 74 28 moveToRightmost(
30790 70 43 75 72 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a pCur);. }else{.
307a0 20 20 20 20 77 68 69 6c 65 28 20 70 43 75 72 2d while( pCur-
307b0 3e 69 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 >ix==0 ){.
307c0 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3d if( pCur->iPage=
307d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 =0 ){. pC
307e0 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
307f0 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 SOR_INVALID;.
30800 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
30810 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 20 20 7d TE_DONE;. }
30820 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f 50 61 72 . moveToPar
30830 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 20 20 7d ent(pCur);. }
30840 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
30850 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 r->info.nSize==0
30860 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
30870 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
30880 26 20 28 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 & (BTCF_ValidOvf
30890 6c 29 29 3d 3d 30 20 29 3b 0a 0a 20 20 20 20 70 l))==0 );.. p
308a0 43 75 72 2d 3e 69 78 2d 2d 3b 0a 20 20 20 20 70 Cur->ix--;. p
308b0 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 50 61 Page = pCur->pPa
308c0 67 65 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 ge;. if( pPag
308d0 65 2d 3e 69 6e 74 4b 65 79 20 26 26 20 21 70 50 e->intKey && !pP
308e0 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 age->leaf ){.
308f0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
30900 74 72 65 65 50 72 65 76 69 6f 75 73 28 70 43 75 treePrevious(pCu
30910 72 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 r, 0);. }else
30920 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
30930 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 ITE_OK;. }.
30940 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
30950 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
30960 65 50 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 ePrevious(BtCurs
30970 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 66 6c or *pCur, int fl
30980 61 67 73 29 7b 0a 20 20 61 73 73 65 72 74 28 20 ags){. assert(
30990 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
309a0 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
309b0 73 65 72 74 28 20 66 6c 61 67 73 3d 3d 30 20 7c sert( flags==0 |
309c0 7c 20 66 6c 61 67 73 3d 3d 31 20 29 3b 0a 20 20 | flags==1 );.
309d0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
309e0 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 ipNext==0 || pCu
309f0 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
30a00 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 55 4e 55 R_VALID );. UNU
30a10 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 20 66 SED_PARAMETER( f
30a20 6c 61 67 73 20 29 3b 20 20 2f 2a 20 55 73 65 64 lags ); /* Used
30a30 20 69 6e 20 43 4f 4d 44 42 32 20 62 75 74 20 6e in COMDB2 but n
30a40 6f 74 20 6e 61 74 69 76 65 20 53 51 4c 69 74 65 ot native SQLite
30a50 20 2a 2f 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 */. pCur->curF
30a60 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 lags &= ~(BTCF_A
30a70 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 tLast|BTCF_Valid
30a80 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c 69 64 4e Ovfl|BTCF_ValidN
30a90 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e 69 6e Key);. pCur->in
30aa0 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 fo.nSize = 0;.
30ab0 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
30ac0 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 0a 20 !=CURSOR_VALID.
30ad0 20 20 7c 7c 20 70 43 75 72 2d 3e 69 78 3d 3d 30 || pCur->ix==0
30ae0 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e 70 50 61 . || pCur->pPa
30af0 67 65 2d 3e 6c 65 61 66 3d 3d 30 0a 20 20 29 7b ge->leaf==0. ){
30b00 0a 20 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 . return btre
30b10 65 50 72 65 76 69 6f 75 73 28 70 43 75 72 29 3b ePrevious(pCur);
30b20 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 69 78 2d . }. pCur->ix-
30b30 2d 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 -;. return SQLI
30b40 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
30b50 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 70 Allocate a new p
30b60 61 67 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 age from the dat
30b70 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a abase file..**.*
30b80 2a 20 54 68 65 20 6e 65 77 20 70 61 67 65 20 69 * The new page i
30b90 73 20 6d 61 72 6b 65 64 20 61 73 20 64 69 72 74 s marked as dirt
30ba0 79 2e 20 20 28 49 6e 20 6f 74 68 65 72 20 77 6f y. (In other wo
30bb0 72 64 73 2c 20 73 71 6c 69 74 65 33 50 61 67 65 rds, sqlite3Page
30bc0 72 57 72 69 74 65 28 29 0a 2a 2a 20 68 61 73 20 rWrite().** has
30bd0 61 6c 72 65 61 64 79 20 62 65 65 6e 20 63 61 6c already been cal
30be0 6c 65 64 20 6f 6e 20 74 68 65 20 6e 65 77 20 70 led on the new p
30bf0 61 67 65 2e 29 20 20 54 68 65 20 6e 65 77 20 70 age.) The new p
30c00 61 67 65 20 68 61 73 20 61 6c 73 6f 0a 2a 2a 20 age has also.**
30c10 62 65 65 6e 20 72 65 66 65 72 65 6e 63 65 64 20 been referenced
30c20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 and the calling
30c30 72 6f 75 74 69 6e 65 20 69 73 20 72 65 73 70 6f routine is respo
30c40 6e 73 69 62 6c 65 20 66 6f 72 20 63 61 6c 6c 69 nsible for calli
30c50 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 33 50 61 67 ng.** sqlite3Pag
30c60 65 72 55 6e 72 65 66 28 29 20 6f 6e 20 74 68 65 erUnref() on the
30c70 20 6e 65 77 20 70 61 67 65 20 77 68 65 6e 20 69 new page when i
30c80 74 20 69 73 20 64 6f 6e 65 2e 0a 2a 2a 0a 2a 2a t is done..**.**
30c90 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
30ca0 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 63 65 73 turned on succes
30cb0 73 2e 20 20 41 6e 79 20 6f 74 68 65 72 20 72 65 s. Any other re
30cc0 74 75 72 6e 20 76 61 6c 75 65 20 69 6e 64 69 63 turn value indic
30cd0 61 74 65 73 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 ates.** an error
30ce0 2e 20 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 . *ppPage is se
30cf0 74 20 74 6f 20 4e 55 4c 4c 20 69 6e 20 74 68 65 t to NULL in the
30d00 20 65 76 65 6e 74 20 6f 66 20 61 6e 20 65 72 72 event of an err
30d10 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 or..**.** If the
30d20 20 22 6e 65 61 72 62 79 22 20 70 61 72 61 6d 65 "nearby" parame
30d30 74 65 72 20 69 73 20 6e 6f 74 20 30 2c 20 74 68 ter is not 0, th
30d40 65 6e 20 61 6e 20 65 66 66 6f 72 74 20 69 73 20 en an effort is
30d50 6d 61 64 65 20 74 6f 20 0a 2a 2a 20 6c 6f 63 61 made to .** loca
30d60 74 65 20 61 20 70 61 67 65 20 63 6c 6f 73 65 20 te a page close
30d70 74 6f 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 to the page numb
30d80 65 72 20 22 6e 65 61 72 62 79 22 2e 20 20 54 68 er "nearby". Th
30d90 69 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 is can be used i
30da0 6e 20 61 6e 0a 2a 2a 20 61 74 74 65 6d 70 74 20 n an.** attempt
30db0 74 6f 20 6b 65 65 70 20 72 65 6c 61 74 65 64 20 to keep related
30dc0 70 61 67 65 73 20 63 6c 6f 73 65 20 74 6f 20 65 pages close to e
30dd0 61 63 68 20 6f 74 68 65 72 20 69 6e 20 74 68 65 ach other in the
30de0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 0a database file,.
30df0 2a 2a 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e ** which in turn
30e00 20 63 61 6e 20 6d 61 6b 65 20 64 61 74 61 62 61 can make databa
30e10 73 65 20 61 63 63 65 73 73 20 66 61 73 74 65 72 se access faster
30e20 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 ..**.** If the e
30e30 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 72 20 69 Mode parameter i
30e40 73 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 20 s BTALLOC_EXACT
30e50 61 6e 64 20 74 68 65 20 6e 65 61 72 62 79 20 70 and the nearby p
30e60 61 67 65 20 65 78 69 73 74 73 0a 2a 2a 20 61 6e age exists.** an
30e70 79 77 68 65 72 65 20 6f 6e 20 74 68 65 20 66 72 ywhere on the fr
30e80 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 20 69 74 ee-list, then it
30e90 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74 is guaranteed t
30ea0 6f 20 62 65 20 72 65 74 75 72 6e 65 64 2e 20 20 o be returned.
30eb0 49 66 0a 2a 2a 20 65 4d 6f 64 65 20 69 73 20 42 If.** eMode is B
30ec0 54 41 4c 4c 4f 43 5f 4c 54 20 74 68 65 6e 20 74 TALLOC_LT then t
30ed0 68 65 20 70 61 67 65 20 72 65 74 75 72 6e 65 64 he page returned
30ee0 20 77 69 6c 6c 20 62 65 20 6c 65 73 73 20 74 68 will be less th
30ef0 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a 20 74 an or equal.** t
30f00 6f 20 6e 65 61 72 62 79 20 69 66 20 61 6e 79 20 o nearby if any
30f10 73 75 63 68 20 70 61 67 65 20 65 78 69 73 74 73 such page exists
30f20 2e 20 20 49 66 20 65 4d 6f 64 65 20 69 73 20 42 . If eMode is B
30f30 54 41 4c 4c 4f 43 5f 41 4e 59 20 74 68 65 6e 20 TALLOC_ANY then
30f40 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 there.** are no
30f50 72 65 73 74 72 69 63 74 69 6f 6e 73 20 6f 6e 20 restrictions on
30f60 77 68 69 63 68 20 70 61 67 65 20 69 73 20 72 65 which page is re
30f70 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 turned..*/.stati
30f80 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 c int allocateBt
30f90 72 65 65 50 61 67 65 28 0a 20 20 42 74 53 68 61 reePage(. BtSha
30fa0 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 red *pBt,
30fb0 20 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a /* The btree *
30fc0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
30fd0 50 61 67 65 2c 20 20 20 20 20 20 2f 2a 20 53 74 Page, /* St
30fe0 6f 72 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 ore pointer to t
30ff0 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 he allocated pag
31000 65 20 68 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f e here */. Pgno
31010 20 2a 70 50 67 6e 6f 2c 20 20 20 20 20 20 20 20 *pPgno,
31020 20 20 20 2f 2a 20 53 74 6f 72 65 20 74 68 65 20 /* Store the
31030 70 61 67 65 20 6e 75 6d 62 65 72 20 68 65 72 65 page number here
31040 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 65 61 72 62 */. Pgno nearb
31050 79 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 y, /*
31060 53 65 61 72 63 68 20 66 6f 72 20 61 20 70 61 67 Search for a pag
31070 65 20 6e 65 61 72 20 74 68 69 73 20 6f 6e 65 20 e near this one
31080 2a 2f 0a 20 20 75 38 20 65 4d 6f 64 65 20 20 20 */. u8 eMode
31090 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
310a0 54 41 4c 4c 4f 43 5f 45 58 41 43 54 2c 20 42 54 TALLOC_EXACT, BT
310b0 41 4c 4c 4f 43 5f 4c 54 2c 20 6f 72 20 42 54 41 ALLOC_LT, or BTA
310c0 4c 4c 4f 43 5f 41 4e 59 20 2a 2f 0a 29 7b 0a 20 LLOC_ANY */.){.
310d0 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 31 MemPage *pPage1
310e0 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 ;. int rc;. u3
310f0 32 20 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 2 n; /* Numb
31100 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 er of pages on t
31110 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a 20 he freelist */.
31120 20 75 33 32 20 6b 3b 20 20 20 20 20 2f 2a 20 4e u32 k; /* N
31130 75 6d 62 65 72 20 6f 66 20 6c 65 61 76 65 73 20 umber of leaves
31140 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 6f 66 20 on the trunk of
31150 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a the freelist */.
31160 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 72 75 6e MemPage *pTrun
31170 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 65 k = 0;. MemPage
31180 20 2a 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 30 *pPrevTrunk = 0
31190 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 61 67 65 3b ;. Pgno mxPage;
311a0 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 69 /* Total si
311b0 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ze of the databa
311c0 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 61 73 se file */.. as
311d0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
311e0 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
311f0 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
31200 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 ( eMode==BTALLOC
31210 5f 41 4e 59 20 7c 7c 20 28 6e 65 61 72 62 79 3e _ANY || (nearby>
31220 30 20 26 26 20 49 66 4e 6f 74 4f 6d 69 74 41 56 0 && IfNotOmitAV
31230 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d (pBt->autoVacuum
31240 29 29 20 29 3b 0a 20 20 70 50 61 67 65 31 20 3d )) );. pPage1 =
31250 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 pBt->pPage1;.
31260 6d 78 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 mxPage = btreePa
31270 67 65 63 6f 75 6e 74 28 70 42 74 29 3b 0a 20 20 gecount(pBt);.
31280 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
31290 52 2d 30 35 31 31 39 2d 30 32 36 33 37 20 54 68 R-05119-02637 Th
312a0 65 20 34 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 e 4-byte big-end
312b0 69 61 6e 20 69 6e 74 65 67 65 72 20 61 74 20 6f ian integer at o
312c0 66 66 73 65 74 20 33 36 0a 20 20 2a 2a 20 73 74 ffset 36. ** st
312d0 6f 72 65 73 20 73 74 6f 72 65 73 20 74 68 65 20 ores stores the
312e0 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 total number of
312f0 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 pages on the fre
31300 65 6c 69 73 74 2e 20 2a 2f 0a 20 20 6e 20 3d 20 elist. */. n =
31310 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 31 get4byte(&pPage1
31320 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 ->aData[36]);.
31330 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 6d 78 50 testcase( n==mxP
31340 61 67 65 2d 31 20 29 3b 0a 20 20 69 66 28 20 6e age-1 );. if( n
31350 3e 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 >=mxPage ){.
31360 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
31370 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a RRUPT_BKPT;. }.
31380 20 20 69 66 28 20 6e 3e 30 20 29 7b 0a 20 20 20 if( n>0 ){.
31390 20 2f 2a 20 54 68 65 72 65 20 61 72 65 20 70 61 /* There are pa
313a0 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c ges on the freel
313b0 69 73 74 2e 20 20 52 65 75 73 65 20 6f 6e 65 20 ist. Reuse one
313c0 6f 66 20 74 68 6f 73 65 20 70 61 67 65 73 2e 20 of those pages.
313d0 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 69 54 72 75 */. Pgno iTru
313e0 6e 6b 3b 0a 20 20 20 20 75 38 20 73 65 61 72 63 nk;. u8 searc
313f0 68 4c 69 73 74 20 3d 20 30 3b 20 2f 2a 20 49 66 hList = 0; /* If
31400 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 6d the free-list m
31410 75 73 74 20 62 65 20 73 65 61 72 63 68 65 64 20 ust be searched
31420 66 6f 72 20 27 6e 65 61 72 62 79 27 20 2a 2f 0a for 'nearby' */.
31430 20 20 20 20 75 33 32 20 6e 53 65 61 72 63 68 20 u32 nSearch
31440 3d 20 30 3b 20 20 20 2f 2a 20 43 6f 75 6e 74 20 = 0; /* Count
31450 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 of the number of
31460 20 73 65 61 72 63 68 20 61 74 74 65 6d 70 74 73 search attempts
31470 20 2a 2f 0a 20 20 20 20 0a 20 20 20 20 2f 2a 20 */. . /*
31480 49 66 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f If eMode==BTALLO
31490 43 5f 45 58 41 43 54 20 61 6e 64 20 61 20 71 75 C_EXACT and a qu
314a0 65 72 79 20 6f 66 20 74 68 65 20 70 6f 69 6e 74 ery of the point
314b0 65 72 2d 6d 61 70 0a 20 20 20 20 2a 2a 20 73 68 er-map. ** sh
314c0 6f 77 73 20 74 68 61 74 20 74 68 65 20 70 61 67 ows that the pag
314d0 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 73 6f e 'nearby' is so
314e0 6d 65 77 68 65 72 65 20 6f 6e 20 74 68 65 20 66 mewhere on the f
314f0 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 0a 20 ree-list, then.
31500 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 ** the entire
31510 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 20 73 65 -list will be se
31520 61 72 63 68 65 64 20 66 6f 72 20 74 68 61 74 20 arched for that
31530 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 23 69 66 page.. */.#if
31540 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
31550 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
31560 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c if( eMode==BTALL
31570 4f 43 5f 45 58 41 43 54 20 29 7b 0a 20 20 20 20 OC_EXACT ){.
31580 20 20 69 66 28 20 6e 65 61 72 62 79 3c 3d 6d 78 if( nearby<=mx
31590 50 61 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20 Page ){.
315a0 75 38 20 65 54 79 70 65 3b 0a 20 20 20 20 20 20 u8 eType;.
315b0 20 20 61 73 73 65 72 74 28 20 6e 65 61 72 62 79 assert( nearby
315c0 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 >0 );. as
315d0 73 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 sert( pBt->autoV
315e0 61 63 75 75 6d 20 29 3b 0a 20 20 20 20 20 20 20 acuum );.
315f0 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 rc = ptrmapGet(
31600 70 42 74 2c 20 6e 65 61 72 62 79 2c 20 26 65 54 pBt, nearby, &eT
31610 79 70 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 ype, 0);.
31620 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
31630 20 72 63 3b 0a 20 20 20 20 20 20 20 20 69 66 28 rc;. if(
31640 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 46 eType==PTRMAP_F
31650 52 45 45 50 41 47 45 20 29 7b 0a 20 20 20 20 20 REEPAGE ){.
31660 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 searchList
31670 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 = 1;. }.
31680 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 }. }else
31690 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c if( eMode==BTAL
316a0 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 20 20 20 20 LOC_LE ){.
316b0 73 65 61 72 63 68 4c 69 73 74 20 3d 20 31 3b 0a searchList = 1;.
316c0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 }.#endif..
316d0 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74 20 74 /* Decrement t
316e0 68 65 20 66 72 65 65 2d 6c 69 73 74 20 63 6f 75 he free-list cou
316f0 6e 74 20 62 79 20 31 2e 20 53 65 74 20 69 54 72 nt by 1. Set iTr
31700 75 6e 6b 20 74 6f 20 74 68 65 20 69 6e 64 65 78 unk to the index
31710 20 6f 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 66 of the. ** f
31720 69 72 73 74 20 66 72 65 65 2d 6c 69 73 74 20 74 irst free-list t
31730 72 75 6e 6b 20 70 61 67 65 2e 20 69 50 72 65 76 runk page. iPrev
31740 54 72 75 6e 6b 20 69 73 20 69 6e 69 74 69 61 6c Trunk is initial
31750 6c 79 20 31 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ly 1.. */.
31760 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
31770 65 72 57 72 69 74 65 28 70 50 61 67 65 31 2d 3e erWrite(pPage1->
31780 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 pDbPage);. if
31790 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
317a0 3b 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 26 ;. put4byte(&
317b0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
317c0 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 20 20 20 2f 2a ], n-1);.. /*
317d0 20 54 68 65 20 63 6f 64 65 20 77 69 74 68 69 6e The code within
317e0 20 74 68 69 73 20 6c 6f 6f 70 20 69 73 20 72 75 this loop is ru
317f0 6e 20 6f 6e 6c 79 20 6f 6e 63 65 20 69 66 20 74 n only once if t
31800 68 65 20 27 73 65 61 72 63 68 4c 69 73 74 27 20 he 'searchList'
31810 76 61 72 69 61 62 6c 65 0a 20 20 20 20 2a 2a 20 variable. **
31820 69 73 20 6e 6f 74 20 74 72 75 65 2e 20 4f 74 68 is not true. Oth
31830 65 72 77 69 73 65 2c 20 69 74 20 72 75 6e 73 20 erwise, it runs
31840 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 74 72 once for each tr
31850 75 6e 6b 2d 70 61 67 65 20 6f 6e 20 74 68 65 0a unk-page on the.
31860 20 20 20 20 2a 2a 20 66 72 65 65 2d 6c 69 73 74 ** free-list
31870 20 75 6e 74 69 6c 20 74 68 65 20 70 61 67 65 20 until the page
31880 27 6e 65 61 72 62 79 27 20 69 73 20 6c 6f 63 61 'nearby' is loca
31890 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 4c ted (eMode==BTAL
318a0 4c 4f 43 5f 45 58 41 43 54 29 0a 20 20 20 20 2a LOC_EXACT). *
318b0 2a 20 6f 72 20 75 6e 74 69 6c 20 61 20 70 61 67 * or until a pag
318c0 65 20 6c 65 73 73 20 74 68 61 6e 20 27 6e 65 61 e less than 'nea
318d0 72 62 79 27 20 69 73 20 6c 6f 63 61 74 65 64 20 rby' is located
318e0 28 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f (eMode==BTALLOC_
318f0 4c 54 29 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 LT). */. d
31900 6f 20 7b 0a 20 20 20 20 20 20 70 50 72 65 76 54 o {. pPrevT
31910 72 75 6e 6b 20 3d 20 70 54 72 75 6e 6b 3b 0a 20 runk = pTrunk;.
31920 20 20 20 20 20 69 66 28 20 70 50 72 65 76 54 72 if( pPrevTr
31930 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 2f unk ){. /
31940 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
31950 2d 30 31 35 30 36 2d 31 31 30 35 33 20 54 68 65 -01506-11053 The
31960 20 66 69 72 73 74 20 69 6e 74 65 67 65 72 20 6f first integer o
31970 6e 20 61 20 66 72 65 65 6c 69 73 74 20 74 72 75 n a freelist tru
31980 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 nk page.
31990 2a 2a 20 69 73 20 74 68 65 20 70 61 67 65 20 6e ** is the page n
319a0 75 6d 62 65 72 20 6f 66 20 74 68 65 20 6e 65 78 umber of the nex
319b0 74 20 66 72 65 65 6c 69 73 74 20 74 72 75 6e 6b t freelist trunk
319c0 20 70 61 67 65 20 69 6e 20 74 68 65 20 6c 69 73 page in the lis
319d0 74 20 6f 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 t or. **
319e0 7a 65 72 6f 20 69 66 20 74 68 69 73 20 69 73 20 zero if this is
319f0 74 68 65 20 6c 61 73 74 20 66 72 65 65 6c 69 73 the last freelis
31a00 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 2a 2f t trunk page. */
31a10 0a 20 20 20 20 20 20 20 20 69 54 72 75 6e 6b 20 . iTrunk
31a20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 72 65 = get4byte(&pPre
31a30 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d vTrunk->aData[0]
31a40 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a );. }else{.
31a50 20 20 20 20 20 20 20 20 2f 2a 20 45 56 49 44 45 /* EVIDE
31a60 4e 43 45 2d 4f 46 3a 20 52 2d 35 39 38 34 31 2d NCE-OF: R-59841-
31a70 31 33 37 39 38 20 54 68 65 20 34 2d 62 79 74 65 13798 The 4-byte
31a80 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 big-endian inte
31a90 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 33 32 ger at offset 32
31aa0 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 . ** stor
31ab0 65 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 es the page numb
31ac0 65 72 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 er of the first
31ad0 70 61 67 65 20 6f 66 20 74 68 65 20 66 72 65 65 page of the free
31ae0 6c 69 73 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 list, or zero if
31af0 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 . ** the
31b00 66 72 65 65 6c 69 73 74 20 69 73 20 65 6d 70 74 freelist is empt
31b10 79 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 54 y. */. iT
31b20 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 runk = get4byte(
31b30 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
31b40 32 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 2]);. }.
31b50 20 20 20 74 65 73 74 63 61 73 65 28 20 69 54 72 testcase( iTr
31b60 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 unk==mxPage );.
31b70 20 20 20 20 20 69 66 28 20 69 54 72 75 6e 6b 3e if( iTrunk>
31b80 6d 78 50 61 67 65 20 7c 7c 20 6e 53 65 61 72 63 mxPage || nSearc
31b90 68 2b 2b 20 3e 20 6e 20 29 7b 0a 20 20 20 20 20 h++ > n ){.
31ba0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
31bb0 4f 52 52 55 50 54 5f 50 47 4e 4f 28 70 50 72 65 ORRUPT_PGNO(pPre
31bc0 76 54 72 75 6e 6b 20 3f 20 70 50 72 65 76 54 72 vTrunk ? pPrevTr
31bd0 75 6e 6b 2d 3e 70 67 6e 6f 20 3a 20 31 29 3b 0a unk->pgno : 1);.
31be0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
31bf0 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 rc = btreeG
31c00 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 74 etUnusedPage(pBt
31c10 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 6e , iTrunk, &pTrun
31c20 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 k, 0);. }.
31c30 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 if( rc ){.
31c40 20 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 pTrunk =
31c50 30 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 0;. goto
31c60 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 end_allocate_pag
31c70 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 e;. }.
31c80 20 61 73 73 65 72 74 28 20 70 54 72 75 6e 6b 21 assert( pTrunk!
31c90 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 =0 );. asse
31ca0 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 44 61 74 rt( pTrunk->aDat
31cb0 61 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 2f 2a a!=0 );. /*
31cc0 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
31cd0 31 33 35 32 33 2d 30 34 33 39 34 20 54 68 65 20 13523-04394 The
31ce0 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 72 20 6f second integer o
31cf0 6e 20 61 20 66 72 65 65 6c 69 73 74 20 74 72 75 n a freelist tru
31d00 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a nk page. **
31d10 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f is the number o
31d20 66 20 6c 65 61 66 20 70 61 67 65 20 70 6f 69 6e f leaf page poin
31d30 74 65 72 73 20 74 6f 20 66 6f 6c 6c 6f 77 2e 20 ters to follow.
31d40 2a 2f 0a 20 20 20 20 20 20 6b 20 3d 20 67 65 74 */. k = get
31d50 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 4byte(&pTrunk->a
31d60 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 20 20 20 Data[4]);.
31d70 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 73 65 61 if( k==0 && !sea
31d80 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 20 20 20 rchList ){.
31d90 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b 20 /* The trunk
31da0 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 20 61 6e has no leaves an
31db0 64 20 74 68 65 20 6c 69 73 74 20 69 73 20 6e 6f d the list is no
31dc0 74 20 62 65 69 6e 67 20 73 65 61 72 63 68 65 64 t being searched
31dd0 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 53 6f . . ** So
31de0 20 65 78 74 72 61 63 74 20 74 68 65 20 74 72 75 extract the tru
31df0 6e 6b 20 70 61 67 65 20 69 74 73 65 6c 66 20 61 nk page itself a
31e00 6e 64 20 75 73 65 20 69 74 20 61 73 20 74 68 65 nd use it as the
31e10 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 20 20 20 newly .
31e20 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 ** allocated pag
31e30 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 73 e */. ass
31e40 65 72 74 28 20 70 50 72 65 76 54 72 75 6e 6b 3d ert( pPrevTrunk=
31e50 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 63 =0 );. rc
31e60 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
31e70 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 rite(pTrunk->pDb
31e80 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 Page);. i
31e90 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
31ea0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f goto end_allo
31eb0 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 cate_page;.
31ec0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 2a 70 50 }. *pP
31ed0 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 gno = iTrunk;.
31ee0 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 memcpy(&pP
31ef0 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c age1->aData[32],
31f00 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b &pTrunk->aData[
31f10 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 0], 4);.
31f20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 75 6e 6b *ppPage = pTrunk
31f30 3b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b ;. pTrunk
31f40 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 54 52 = 0;. TR
31f50 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 ACE(("ALLOCATE:
31f60 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 20 66 72 %d trunk - %d fr
31f70 65 65 20 70 61 67 65 73 20 6c 65 66 74 5c 6e 22 ee pages left\n"
31f80 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b , *pPgno, n-1));
31f90 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
31fa0 20 6b 3e 28 75 33 32 29 28 70 42 74 2d 3e 75 73 k>(u32)(pBt->us
31fb0 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 32 29 20 ableSize/4 - 2)
31fc0 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 56 61 ){. /* Va
31fd0 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f 75 74 20 lue of k is out
31fe0 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 74 61 62 of range. Datab
31ff0 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 2a ase corruption *
32000 2f 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 /. rc = S
32010 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 47 QLITE_CORRUPT_PG
32020 4e 4f 28 69 54 72 75 6e 6b 29 3b 0a 20 20 20 20 NO(iTrunk);.
32030 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c goto end_all
32040 6f 63 61 74 65 5f 70 61 67 65 3b 0a 23 69 66 6e ocate_page;.#ifn
32050 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
32060 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 AUTOVACUUM.
32070 20 7d 65 6c 73 65 20 69 66 28 20 73 65 61 72 63 }else if( searc
32080 68 4c 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 hList .
32090 20 20 20 26 26 20 28 6e 65 61 72 62 79 3d 3d 69 && (nearby==i
320a0 54 72 75 6e 6b 20 7c 7c 20 28 69 54 72 75 6e 6b Trunk || (iTrunk
320b0 3c 6e 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 <nearby && eMode
320c0 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a ==BTALLOC_LE)) .
320d0 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
320e0 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 69 73 20 /* The list is
320f0 62 65 69 6e 67 20 73 65 61 72 63 68 65 64 20 61 being searched a
32100 6e 64 20 74 68 69 73 20 74 72 75 6e 6b 20 70 61 nd this trunk pa
32110 67 65 20 69 73 20 74 68 65 20 70 61 67 65 0a 20 ge is the page.
32120 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 61 6c 6c ** to all
32130 6f 63 61 74 65 2c 20 72 65 67 61 72 64 6c 65 73 ocate, regardles
32140 73 20 6f 66 20 77 68 65 74 68 65 72 20 69 74 20 s of whether it
32150 68 61 73 20 6c 65 61 76 65 73 2e 0a 20 20 20 20 has leaves..
32160 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 2a */. *
32170 70 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b 0a pPgno = iTrunk;.
32180 20 20 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 *ppPage
32190 3d 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 = pTrunk;.
321a0 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 searchList = 0
321b0 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 ;. rc = s
321c0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
321d0 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 (pTrunk->pDbPage
321e0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
321f0 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 c ){. g
32200 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
32210 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d _page;. }
32220 0a 20 20 20 20 20 20 20 20 69 66 28 20 6b 3d 3d . if( k==
32230 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 0 ){. i
32240 66 28 20 21 70 50 72 65 76 54 72 75 6e 6b 20 29 f( !pPrevTrunk )
32250 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 {. me
32260 6d 63 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 mcpy(&pPage1->aD
32270 61 74 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b ata[32], &pTrunk
32280 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a ->aData[0], 4);.
32290 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }else{
322a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
322b0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
322c0 69 74 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e ite(pPrevTrunk->
322d0 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
322e0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
322f0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
32300 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
32310 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
32320 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
32330 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 memcp
32340 79 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 y(&pPrevTrunk->a
32350 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e 6b Data[0], &pTrunk
32360 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a ->aData[0], 4);.
32370 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
32380 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
32390 20 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e /* The trun
323a0 6b 20 70 61 67 65 20 69 73 20 72 65 71 75 69 72 k page is requir
323b0 65 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 ed by the caller
323c0 20 62 75 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 but it contains
323d0 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 . ** p
323e0 6f 69 6e 74 65 72 73 20 74 6f 20 66 72 65 65 2d ointers to free-
323f0 6c 69 73 74 20 6c 65 61 76 65 73 2e 20 54 68 65 list leaves. The
32400 20 66 69 72 73 74 20 6c 65 61 66 20 62 65 63 6f first leaf beco
32410 6d 65 73 20 61 20 74 72 75 6e 6b 0a 20 20 20 20 mes a trunk.
32420 20 20 20 20 20 20 2a 2a 20 70 61 67 65 20 69 6e ** page in
32430 20 74 68 69 73 20 63 61 73 65 2e 0a 20 20 20 20 this case..
32440 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
32450 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 MemPage *pNew
32460 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 20 Trunk;.
32470 20 50 67 6e 6f 20 69 4e 65 77 54 72 75 6e 6b 20 Pgno iNewTrunk
32480 3d 20 67 65 74 34 62 79 74 65 28 26 70 54 72 75 = get4byte(&pTru
32490 6e 6b 2d 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 nk->aData[8]);.
324a0 20 20 20 20 20 20 20 20 20 69 66 28 20 69 4e 65 if( iNe
324b0 77 54 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b wTrunk>mxPage ){
324c0 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 . rc
324d0 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
324e0 54 5f 50 47 4e 4f 28 69 54 72 75 6e 6b 29 3b 0a T_PGNO(iTrunk);.
324f0 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f goto
32500 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
32510 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ge;. }.
32520 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 testca
32530 73 65 28 20 69 4e 65 77 54 72 75 6e 6b 3d 3d 6d se( iNewTrunk==m
32540 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 xPage );.
32550 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
32560 55 6e 75 73 65 64 50 61 67 65 28 70 42 74 2c 20 UnusedPage(pBt,
32570 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 4e 65 77 iNewTrunk, &pNew
32580 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 Trunk, 0);.
32590 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
325a0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
325b0 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
325c0 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
325d0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
325e0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
325f0 50 61 67 65 72 57 72 69 74 65 28 70 4e 65 77 54 PagerWrite(pNewT
32600 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a runk->pDbPage);.
32610 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
32620 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
32630 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 61 relea
32640 73 65 50 61 67 65 28 70 4e 65 77 54 72 75 6e 6b sePage(pNewTrunk
32650 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 );. g
32660 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
32670 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
32680 20 7d 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d }. mem
32690 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e cpy(&pNewTrunk->
326a0 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e aData[0], &pTrun
326b0 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b k->aData[0], 4);
326c0 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 . put4b
326d0 79 74 65 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e yte(&pNewTrunk->
326e0 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b 0a aData[4], k-1);.
326f0 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
32700 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 61 (&pNewTrunk->aDa
32710 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e ta[8], &pTrunk->
32720 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b 2d 31 29 aData[12], (k-1)
32730 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 *4);. r
32740 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 54 eleasePage(pNewT
32750 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 runk);.
32760 20 69 66 28 20 21 70 50 72 65 76 54 72 75 6e 6b if( !pPrevTrunk
32770 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
32780 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
32790 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
327a0 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 pPage1->pDbPage)
327b0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 );.
327c0 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
327d0 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 4e 65 ->aData[32], iNe
327e0 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 wTrunk);.
327f0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
32800 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
32810 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 72 e3PagerWrite(pPr
32820 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 evTrunk->pDbPage
32830 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
32840 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
32850 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
32860 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
32870 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
32880 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 put4byt
32890 65 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 e(&pPrevTrunk->a
328a0 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 54 72 75 Data[0], iNewTru
328b0 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d nk);. }
328c0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
328d0 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 pTrunk = 0;.
328e0 20 20 20 20 20 20 20 54 52 41 43 45 28 28 22 41 TRACE(("A
328f0 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 72 75 6e LLOCATE: %d trun
32900 6b 20 2d 20 25 64 20 66 72 65 65 20 70 61 67 65 k - %d free page
32910 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 50 67 6e s left\n", *pPgn
32920 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e 64 69 66 o, n-1));.#endif
32930 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
32940 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 k>0 ){.
32950 2f 2a 20 45 78 74 72 61 63 74 20 61 20 6c 65 61 /* Extract a lea
32960 66 20 66 72 6f 6d 20 74 68 65 20 74 72 75 6e 6b f from the trunk
32970 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 32 20 */. u32
32980 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 20 20 20 closest;.
32990 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a 20 20 20 Pgno iPage;.
329a0 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 68 unsigned ch
329b0 61 72 20 2a 61 44 61 74 61 20 3d 20 70 54 72 75 ar *aData = pTru
329c0 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 nk->aData;.
329d0 20 20 20 69 66 28 20 6e 65 61 72 62 79 3e 30 20 if( nearby>0
329e0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33 32 ){. u32
329f0 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 63 6c i;. cl
32a00 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 osest = 0;.
32a10 20 20 20 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d if( eMode==
32a20 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 BTALLOC_LE ){.
32a30 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
32a40 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 0; i<k; i++){.
32a50 20 20 20 20 20 20 20 20 20 20 20 20 69 50 61 67 iPag
32a60 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 44 e = get4byte(&aD
32a70 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a 20 20 20 ata[8+i*4]);.
32a80 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 69 if( i
32a90 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 29 7b 0a Page<=nearby ){.
32aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32ab0 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 20 20 closest = i;.
32ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 bre
32ad0 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ak;.
32ae0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
32af0 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
32b00 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 e{. i
32b10 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 20 20 20 nt dist;.
32b20 20 20 20 20 20 64 69 73 74 20 3d 20 73 71 6c 69 dist = sqli
32b30 74 65 33 41 62 73 49 6e 74 33 32 28 67 65 74 34 te3AbsInt32(get4
32b40 62 79 74 65 28 26 61 44 61 74 61 5b 38 5d 29 20 byte(&aData[8])
32b50 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 20 20 20 - nearby);.
32b60 20 20 20 20 20 20 20 66 6f 72 28 69 3d 31 3b 20 for(i=1;
32b70 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 i<k; i++){.
32b80 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 32 20 int d2
32b90 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 33 = sqlite3AbsInt3
32ba0 32 28 67 65 74 34 62 79 74 65 28 26 61 44 61 74 2(get4byte(&aDat
32bb0 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e 65 61 72 a[8+i*4]) - near
32bc0 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 by);.
32bd0 20 20 20 69 66 28 20 64 32 3c 64 69 73 74 20 29 if( d2<dist )
32be0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
32bf0 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 closest = i;.
32c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 d
32c10 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 20 20 20 ist = d2;.
32c20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
32c30 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
32c40 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 }. }els
32c50 65 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6c 6f e{. clo
32c60 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 sest = 0;.
32c70 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 50 61 }.. iPa
32c80 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 61 ge = get4byte(&a
32c90 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a 34 Data[8+closest*4
32ca0 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 ]);. test
32cb0 63 61 73 65 28 20 69 50 61 67 65 3d 3d 6d 78 50 case( iPage==mxP
32cc0 61 67 65 20 29 3b 0a 20 20 20 20 20 20 20 20 69 age );. i
32cd0 66 28 20 69 50 61 67 65 3e 6d 78 50 61 67 65 20 f( iPage>mxPage
32ce0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 ){. rc
32cf0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
32d00 5f 50 47 4e 4f 28 69 54 72 75 6e 6b 29 3b 0a 20 _PGNO(iTrunk);.
32d10 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
32d20 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
32d30 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
32d40 20 20 20 74 65 73 74 63 61 73 65 28 20 69 50 61 testcase( iPa
32d50 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 20 ge==mxPage );.
32d60 20 20 20 20 20 20 69 66 28 20 21 73 65 61 72 63 if( !searc
32d70 68 4c 69 73 74 20 0a 20 20 20 20 20 20 20 20 20 hList .
32d80 7c 7c 20 28 69 50 61 67 65 3d 3d 6e 65 61 72 62 || (iPage==nearb
32d90 79 20 7c 7c 20 28 69 50 61 67 65 3c 6e 65 61 72 y || (iPage<near
32da0 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d 42 54 41 by && eMode==BTA
32db0 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 20 20 20 LLOC_LE)) .
32dc0 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ){.
32dd0 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 3b 0a 20 int noContent;.
32de0 20 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 *pPgno
32df0 3d 20 69 50 61 67 65 3b 0a 20 20 20 20 20 20 20 = iPage;.
32e00 20 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 TRACE(("ALLOC
32e10 41 54 45 3a 20 25 64 20 77 61 73 20 6c 65 61 66 ATE: %d was leaf
32e20 20 25 64 20 6f 66 20 25 64 20 6f 6e 20 74 72 75 %d of %d on tru
32e30 6e 6b 20 25 64 22 0a 20 20 20 20 20 20 20 20 20 nk %d".
32e40 20 20 20 20 20 20 20 20 22 3a 20 25 64 20 6d 6f ": %d mo
32e50 72 65 20 66 72 65 65 20 70 61 67 65 73 5c 6e 22 re free pages\n"
32e60 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
32e70 20 20 20 2a 70 50 67 6e 6f 2c 20 63 6c 6f 73 65 *pPgno, close
32e80 73 74 2b 31 2c 20 6b 2c 20 70 54 72 75 6e 6b 2d st+1, k, pTrunk-
32e90 3e 70 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 20 20 >pgno, n-1));.
32ea0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
32eb0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
32ec0 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
32ed0 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
32ee0 63 20 29 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c c ) goto end_all
32ef0 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 ocate_page;.
32f00 20 20 20 20 20 20 69 66 28 20 63 6c 6f 73 65 73 if( closes
32f10 74 3c 6b 2d 31 20 29 7b 0a 20 20 20 20 20 20 20 t<k-1 ){.
32f20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 61 44 61 memcpy(&aDa
32f30 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a 34 5d 2c ta[8+closest*4],
32f40 20 26 61 44 61 74 61 5b 34 2b 6b 2a 34 5d 2c 20 &aData[4+k*4],
32f50 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 4);. }.
32f60 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 put4by
32f70 74 65 28 26 61 44 61 74 61 5b 34 5d 2c 20 6b 2d te(&aData[4], k-
32f80 31 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 6f 1);. no
32f90 43 6f 6e 74 65 6e 74 20 3d 20 21 62 74 72 65 65 Content = !btree
32fa0 47 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 70 42 GetHasContent(pB
32fb0 74 2c 20 2a 70 50 67 6e 6f 29 3f 20 50 41 47 45 t, *pPgno)? PAGE
32fc0 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 R_GET_NOCONTENT
32fd0 3a 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 72 : 0;. r
32fe0 63 20 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 c = btreeGetUnus
32ff0 65 64 50 61 67 65 28 70 42 74 2c 20 2a 70 50 67 edPage(pBt, *pPg
33000 6e 6f 2c 20 70 70 50 61 67 65 2c 20 6e 6f 43 6f no, ppPage, noCo
33010 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 20 20 20 ntent);.
33020 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
33030 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
33040 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
33050 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 50 61 agerWrite((*ppPa
33060 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge)->pDbPage);.
33070 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 if( r
33080 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
33090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
330a0 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 61 67 leasePage(*ppPag
330b0 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
330c0 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 *ppPage = 0;.
330d0 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
330e0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
330f0 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 searchList =
33100 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 0;. }.
33110 20 20 20 7d 0a 20 20 20 20 20 20 72 65 6c 65 61 }. relea
33120 73 65 50 61 67 65 28 70 50 72 65 76 54 72 75 6e sePage(pPrevTrun
33130 6b 29 3b 0a 20 20 20 20 20 20 70 50 72 65 76 54 k);. pPrevT
33140 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 7d 77 runk = 0;. }w
33150 68 69 6c 65 28 20 73 65 61 72 63 68 4c 69 73 74 hile( searchList
33160 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 );. }else{.
33170 20 2f 2a 20 54 68 65 72 65 20 61 72 65 20 6e 6f /* There are no
33180 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 pages on the fr
33190 65 65 6c 69 73 74 2c 20 73 6f 20 61 70 70 65 6e eelist, so appen
331a0 64 20 61 20 6e 65 77 20 70 61 67 65 20 74 6f 20 d a new page to
331b0 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 the. ** datab
331c0 61 73 65 20 69 6d 61 67 65 2e 0a 20 20 20 20 2a ase image.. *
331d0 2a 0a 20 20 20 20 2a 2a 20 4e 6f 72 6d 61 6c 6c *. ** Normall
331e0 79 2c 20 6e 65 77 20 70 61 67 65 73 20 61 6c 6c y, new pages all
331f0 6f 63 61 74 65 64 20 62 79 20 74 68 69 73 20 62 ocated by this b
33200 6c 6f 63 6b 20 63 61 6e 20 62 65 20 72 65 71 75 lock can be requ
33210 65 73 74 65 64 20 66 72 6f 6d 20 74 68 65 0a 20 ested from the.
33220 20 20 20 2a 2a 20 70 61 67 65 72 20 6c 61 79 65 ** pager laye
33230 72 20 77 69 74 68 20 74 68 65 20 27 6e 6f 2d 63 r with the 'no-c
33240 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 73 65 74 ontent' flag set
33250 2e 20 54 68 69 73 20 70 72 65 76 65 6e 74 73 20 . This prevents
33260 74 68 65 20 70 61 67 65 72 0a 20 20 20 20 2a 2a the pager. **
33270 20 66 72 6f 6d 20 74 72 79 69 6e 67 20 74 6f 20 from trying to
33280 72 65 61 64 20 74 68 65 20 70 61 67 65 73 20 63 read the pages c
33290 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 73 6b ontent from disk
332a0 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 . However, if th
332b0 65 0a 20 20 20 20 2a 2a 20 63 75 72 72 65 6e 74 e. ** current
332c0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 transaction has
332d0 20 61 6c 72 65 61 64 79 20 72 75 6e 20 6f 6e 65 already run one
332e0 20 6f 72 20 6d 6f 72 65 20 69 6e 63 72 65 6d 65 or more increme
332f0 6e 74 61 6c 2d 76 61 63 75 75 6d 0a 20 20 20 20 ntal-vacuum.
33300 2a 2a 20 73 74 65 70 73 2c 20 74 68 65 6e 20 74 ** steps, then t
33310 68 65 20 70 61 67 65 20 77 65 20 61 72 65 20 61 he page we are a
33320 62 6f 75 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 bout to allocate
33330 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 63 6f 6e may contain con
33340 74 65 6e 74 0a 20 20 20 20 2a 2a 20 74 68 61 74 tent. ** that
33350 20 69 73 20 72 65 71 75 69 72 65 64 20 69 6e 20 is required in
33360 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 20 72 the event of a r
33370 6f 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 68 69 73 ollback. In this
33380 20 63 61 73 65 2c 20 64 6f 0a 20 20 20 20 2a 2a case, do. **
33390 20 6e 6f 74 20 73 65 74 20 74 68 65 20 6e 6f 2d not set the no-
333a0 63 6f 6e 74 65 6e 74 20 66 6c 61 67 2e 20 54 68 content flag. Th
333b0 69 73 20 63 61 75 73 65 73 20 74 68 65 20 70 61 is causes the pa
333c0 67 65 72 20 74 6f 20 6c 6f 61 64 20 61 6e 64 20 ger to load and
333d0 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 74 journal. ** t
333e0 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 65 20 he current page
333f0 63 6f 6e 74 65 6e 74 20 62 65 66 6f 72 65 20 6f content before o
33400 76 65 72 77 72 69 74 69 6e 67 20 69 74 2e 0a 20 verwriting it..
33410 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 74 **. ** Not
33420 65 20 74 68 61 74 20 74 68 65 20 70 61 67 65 72 e that the pager
33430 20 77 69 6c 6c 20 6e 6f 74 20 61 63 74 75 61 6c will not actual
33440 6c 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6c 6f ly attempt to lo
33450 61 64 20 6f 72 20 6a 6f 75 72 6e 61 6c 20 0a 20 ad or journal .
33460 20 20 20 2a 2a 20 63 6f 6e 74 65 6e 74 20 66 6f ** content fo
33470 72 20 61 6e 79 20 70 61 67 65 20 74 68 61 74 20 r any page that
33480 72 65 61 6c 6c 79 20 64 6f 65 73 20 6c 69 65 20 really does lie
33490 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 past the end of
334a0 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 the database.
334b0 20 2a 2a 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b ** file on disk
334c0 2e 20 53 6f 20 74 68 65 20 65 66 66 65 63 74 73 . So the effects
334d0 20 6f 66 20 64 69 73 61 62 6c 69 6e 67 20 74 68 of disabling th
334e0 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 6f 70 74 e no-content opt
334f0 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 20 20 2a 2a imization. **
33500 20 68 65 72 65 20 61 72 65 20 63 6f 6e 66 69 6e here are confin
33510 65 64 20 74 6f 20 74 68 6f 73 65 20 70 61 67 65 ed to those page
33520 73 20 74 68 61 74 20 6c 69 65 20 62 65 74 77 65 s that lie betwe
33530 65 6e 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 en the end of th
33540 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 e. ** databas
33550 65 20 69 6d 61 67 65 20 61 6e 64 20 74 68 65 20 e image and the
33560 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 62 end of the datab
33570 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f ase file.. */
33580 0a 20 20 20 20 69 6e 74 20 62 4e 6f 43 6f 6e 74 . int bNoCont
33590 65 6e 74 20 3d 20 28 30 3d 3d 49 66 4e 6f 74 4f ent = (0==IfNotO
335a0 6d 69 74 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 mitAV(pBt->bDoTr
335b0 75 6e 63 61 74 65 29 29 3f 20 50 41 47 45 52 5f uncate))? PAGER_
335c0 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 3a 30 3b GET_NOCONTENT:0;
335d0 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 .. rc = sqlit
335e0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 42 74 e3PagerWrite(pBt
335f0 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 ->pPage1->pDbPag
33600 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 e);. if( rc )
33610 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
33620 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 pBt->nPage++;.
33630 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 if( pBt->nPage
33640 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 ==PENDING_BYTE_P
33650 41 47 45 28 70 42 74 29 20 29 20 70 42 74 2d 3e AGE(pBt) ) pBt->
33660 6e 50 61 67 65 2b 2b 3b 0a 0a 23 69 66 6e 64 65 nPage++;..#ifnde
33670 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
33680 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
33690 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
336a0 20 26 26 20 50 54 52 4d 41 50 5f 49 53 50 41 47 && PTRMAP_ISPAG
336b0 45 28 70 42 74 2c 20 70 42 74 2d 3e 6e 50 61 67 E(pBt, pBt->nPag
336c0 65 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 e) ){. /* I
336d0 66 20 2a 70 50 67 6e 6f 20 72 65 66 65 72 73 20 f *pPgno refers
336e0 74 6f 20 61 20 70 6f 69 6e 74 65 72 2d 6d 61 70 to a pointer-map
336f0 20 70 61 67 65 2c 20 61 6c 6c 6f 63 61 74 65 20 page, allocate
33700 74 77 6f 20 6e 65 77 20 70 61 67 65 73 0a 20 20 two new pages.
33710 20 20 20 20 2a 2a 20 61 74 20 74 68 65 20 65 6e ** at the en
33720 64 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 6e d of the file in
33730 73 74 65 61 64 20 6f 66 20 6f 6e 65 2e 20 54 68 stead of one. Th
33740 65 20 66 69 72 73 74 20 61 6c 6c 6f 63 61 74 65 e first allocate
33750 64 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 d page. **
33760 62 65 63 6f 6d 65 73 20 61 20 6e 65 77 20 70 6f becomes a new po
33770 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 inter-map page,
33780 74 68 65 20 73 65 63 6f 6e 64 20 69 73 20 75 73 the second is us
33790 65 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 ed by the caller
337a0 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
337b0 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 20 3d 20 MemPage *pPg =
337c0 30 3b 0a 20 20 20 20 20 20 54 52 41 43 45 28 28 0;. TRACE((
337d0 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 72 "ALLOCATE: %d fr
337e0 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 20 28 om end of file (
337f0 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 pointer-map page
33800 29 5c 6e 22 2c 20 70 42 74 2d 3e 6e 50 61 67 65 )\n", pBt->nPage
33810 29 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ));. assert
33820 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 50 45 ( pBt->nPage!=PE
33830 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
33840 70 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72 63 pBt) );. rc
33850 20 3d 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 = btreeGetUnuse
33860 64 50 61 67 65 28 70 42 74 2c 20 70 42 74 2d 3e dPage(pBt, pBt->
33870 6e 50 61 67 65 2c 20 26 70 50 67 2c 20 62 4e 6f nPage, &pPg, bNo
33880 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 20 Content);.
33890 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
338a0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 K ){. rc
338b0 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
338c0 69 74 65 28 70 50 67 2d 3e 70 44 62 50 61 67 65 ite(pPg->pDbPage
338d0 29 3b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 61 );. relea
338e0 73 65 50 61 67 65 28 70 50 67 29 3b 0a 20 20 20 sePage(pPg);.
338f0 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 }. if( r
33900 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
33910 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 2b pBt->nPage+
33920 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 +;. if( pBt
33930 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 4e 47 ->nPage==PENDING
33940 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
33950 29 7b 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b ){ pBt->nPage++;
33960 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a }. }.#endif.
33970 20 20 20 20 70 75 74 34 62 79 74 65 28 32 38 20 put4byte(28
33980 2b 20 28 75 38 2a 29 70 42 74 2d 3e 70 50 61 67 + (u8*)pBt->pPag
33990 65 31 2d 3e 61 44 61 74 61 2c 20 70 42 74 2d 3e e1->aData, pBt->
339a0 6e 50 61 67 65 29 3b 0a 20 20 20 20 2a 70 50 67 nPage);. *pPg
339b0 6e 6f 20 3d 20 70 42 74 2d 3e 6e 50 61 67 65 3b no = pBt->nPage;
339c0 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 .. assert( *p
339d0 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 59 Pgno!=PENDING_BY
339e0 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a TE_PAGE(pBt) );.
339f0 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 rc = btreeGe
33a00 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 74 2c tUnusedPage(pBt,
33a10 20 2a 70 50 67 6e 6f 2c 20 70 70 50 61 67 65 2c *pPgno, ppPage,
33a20 20 62 4e 6f 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 bNoContent);.
33a30 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
33a40 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 3d 20 73 n rc;. rc = s
33a50 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
33a60 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 50 ((*ppPage)->pDbP
33a70 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
33a80 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
33a90 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
33aa0 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 (*ppPage);.
33ab0 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 *ppPage = 0;.
33ac0 20 20 7d 0a 20 20 20 20 54 52 41 43 45 28 28 22 }. TRACE(("
33ad0 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 66 72 6f ALLOCATE: %d fro
33ae0 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 5c 6e 22 m end of file\n"
33af0 2c 20 2a 70 50 67 6e 6f 29 29 3b 0a 20 20 7d 0a , *pPgno));. }.
33b00 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 . assert( CORRU
33b10 50 54 5f 44 42 20 7c 7c 20 2a 70 50 67 6e 6f 21 PT_DB || *pPgno!
33b20 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 =PENDING_BYTE_PA
33b30 47 45 28 70 42 74 29 20 29 3b 0a 0a 65 6e 64 5f GE(pBt) );..end_
33b40 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3a 0a 20 allocate_page:.
33b50 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 72 releasePage(pTr
33b60 75 6e 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 unk);. releaseP
33b70 61 67 65 28 70 50 72 65 76 54 72 75 6e 6b 29 3b age(pPrevTrunk);
33b80 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 . assert( rc!=S
33b90 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 QLITE_OK || sqli
33ba0 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 63 te3PagerPageRefc
33bb0 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 2d 3e ount((*ppPage)->
33bc0 70 44 62 50 61 67 65 29 3c 3d 31 20 29 3b 0a 20 pDbPage)<=1 );.
33bd0 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
33be0 49 54 45 5f 4f 4b 20 7c 7c 20 28 2a 70 70 50 61 ITE_OK || (*ppPa
33bf0 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 ge)->isInit==0 )
33c00 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
33c10 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
33c20 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
33c30 20 61 64 64 20 70 61 67 65 20 69 50 61 67 65 20 add page iPage
33c40 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
33c50 66 69 6c 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 file free-list.
33c60 0a 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d 65 .** It is assume
33c70 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 d that the page
33c80 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 is not already a
33c90 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 72 65 part of the fre
33ca0 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 e-list..**.** Th
33cb0 65 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 e value passed a
33cc0 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 s the second arg
33cd0 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 75 ument to this fu
33ce0 6e 63 74 69 6f 6e 20 69 73 20 6f 70 74 69 6f 6e nction is option
33cf0 61 6c 2e 0a 2a 2a 20 49 66 20 74 68 65 20 63 61 al..** If the ca
33d00 6c 6c 65 72 20 68 61 70 70 65 6e 73 20 74 6f 20 ller happens to
33d10 68 61 76 65 20 61 20 70 6f 69 6e 74 65 72 20 74 have a pointer t
33d20 6f 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 o the MemPage ob
33d30 6a 65 63 74 20 0a 2a 2a 20 63 6f 72 72 65 73 70 ject .** corresp
33d40 6f 6e 64 69 6e 67 20 74 6f 20 70 61 67 65 20 69 onding to page i
33d50 50 61 67 65 20 68 61 6e 64 79 2c 20 69 74 20 6d Page handy, it m
33d60 61 79 20 70 61 73 73 20 69 74 20 61 73 20 74 68 ay pass it as th
33d70 65 20 73 65 63 6f 6e 64 20 76 61 6c 75 65 2e 20 e second value.
33d80 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 .** Otherwise, i
33d90 74 20 6d 61 79 20 70 61 73 73 20 4e 55 4c 4c 2e t may pass NULL.
33da0 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 70 6f 69 6e .**.** If a poin
33db0 74 65 72 20 74 6f 20 61 20 4d 65 6d 50 61 67 65 ter to a MemPage
33dc0 20 6f 62 6a 65 63 74 20 69 73 20 70 61 73 73 65 object is passe
33dd0 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 d as the second
33de0 61 72 67 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 73 argument,.** its
33df0 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 reference count
33e00 20 69 73 20 6e 6f 74 20 61 6c 74 65 72 65 64 20 is not altered
33e10 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
33e20 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
33e30 66 72 65 65 50 61 67 65 32 28 42 74 53 68 61 72 freePage2(BtShar
33e40 65 64 20 2a 70 42 74 2c 20 4d 65 6d 50 61 67 65 ed *pBt, MemPage
33e50 20 2a 70 4d 65 6d 50 61 67 65 2c 20 50 67 6e 6f *pMemPage, Pgno
33e60 20 69 50 61 67 65 29 7b 0a 20 20 4d 65 6d 50 61 iPage){. MemPa
33e70 67 65 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b 20 ge *pTrunk = 0;
33e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
33e90 2a 20 46 72 65 65 2d 6c 69 73 74 20 74 72 75 6e * Free-list trun
33ea0 6b 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f k page */. Pgno
33eb0 20 69 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 20 iTrunk = 0;
33ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33ed0 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 6f /* Page number o
33ee0 66 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 6e f free-list trun
33ef0 6b 20 70 61 67 65 20 2a 2f 20 0a 20 20 4d 65 6d k page */ . Mem
33f00 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 Page *pPage1 = p
33f10 42 74 2d 3e 70 50 61 67 65 31 3b 20 20 20 20 20 Bt->pPage1;
33f20 20 2f 2a 20 4c 6f 63 61 6c 20 72 65 66 65 72 65 /* Local refere
33f30 6e 63 65 20 74 6f 20 70 61 67 65 20 31 20 2a 2f nce to page 1 */
33f40 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
33f50 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
33f60 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 62 /* Page b
33f70 65 69 6e 67 20 66 72 65 65 64 2e 20 4d 61 79 20 eing freed. May
33f80 62 65 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 6e be NULL. */. in
33f90 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
33fa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33fb0 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 65 /* Return Code
33fc0 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b */. int nFree;
33fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33fe0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 /* Ini
33ff0 74 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 tial number of p
34000 61 67 65 73 20 6f 6e 20 66 72 65 65 2d 6c 69 73 ages on free-lis
34010 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 t */.. assert(
34020 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
34030 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
34040 3b 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 ;. assert( CORR
34050 55 50 54 5f 44 42 20 7c 7c 20 69 50 61 67 65 3e UPT_DB || iPage>
34060 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 1 );. assert( !
34070 70 4d 65 6d 50 61 67 65 20 7c 7c 20 70 4d 65 6d pMemPage || pMem
34080 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 50 61 67 Page->pgno==iPag
34090 65 20 29 3b 0a 0a 20 20 69 66 28 20 69 50 61 67 e );.. if( iPag
340a0 65 3c 32 20 29 20 72 65 74 75 72 6e 20 53 51 4c e<2 ) return SQL
340b0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
340c0 3b 0a 20 20 69 66 28 20 70 4d 65 6d 50 61 67 65 ;. if( pMemPage
340d0 20 29 7b 0a 20 20 20 20 70 50 61 67 65 20 3d 20 ){. pPage =
340e0 70 4d 65 6d 50 61 67 65 3b 0a 20 20 20 20 73 71 pMemPage;. sq
340f0 6c 69 74 65 33 50 61 67 65 72 52 65 66 28 70 50 lite3PagerRef(pP
34100 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 age->pDbPage);.
34110 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 }else{. pPag
34120 65 20 3d 20 62 74 72 65 65 50 61 67 65 4c 6f 6f e = btreePageLoo
34130 6b 75 70 28 70 42 74 2c 20 69 50 61 67 65 29 3b kup(pBt, iPage);
34140 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 63 72 65 . }.. /* Incre
34150 6d 65 6e 74 20 74 68 65 20 66 72 65 65 20 70 61 ment the free pa
34160 67 65 20 63 6f 75 6e 74 20 6f 6e 20 70 50 61 67 ge count on pPag
34170 65 31 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c e1 */. rc = sql
34180 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
34190 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b Page1->pDbPage);
341a0 0a 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f . if( rc ) goto
341b0 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 freepage_out;.
341c0 20 6e 46 72 65 65 20 3d 20 67 65 74 34 62 79 74 nFree = get4byt
341d0 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
341e0 5b 33 36 5d 29 3b 0a 20 20 70 75 74 34 62 79 74 [36]);. put4byt
341f0 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
34200 5b 33 36 5d 2c 20 6e 46 72 65 65 2b 31 29 3b 0a [36], nFree+1);.
34210 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 73 46 . if( pBt->btsF
34220 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 55 52 lags & BTS_SECUR
34230 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 20 20 E_DELETE ){.
34240 2f 2a 20 49 66 20 74 68 65 20 73 65 63 75 72 65 /* If the secure
34250 5f 64 65 6c 65 74 65 20 6f 70 74 69 6f 6e 20 69 _delete option i
34260 73 20 65 6e 61 62 6c 65 64 2c 20 74 68 65 6e 0a s enabled, then.
34270 20 20 20 20 2a 2a 20 61 6c 77 61 79 73 20 66 75 ** always fu
34280 6c 6c 79 20 6f 76 65 72 77 72 69 74 65 20 64 65 lly overwrite de
34290 6c 65 74 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f leted informatio
342a0 6e 20 77 69 74 68 20 7a 65 72 6f 73 2e 0a 20 20 n with zeros..
342b0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 21 70 */. if( (!p
342c0 50 61 67 65 20 26 26 20 28 28 72 63 20 3d 20 62 Page && ((rc = b
342d0 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c treeGetPage(pBt,
342e0 20 69 50 61 67 65 2c 20 26 70 50 61 67 65 2c 20 iPage, &pPage,
342f0 30 29 29 21 3d 30 29 20 29 0a 20 20 20 20 20 7c 0))!=0) ). |
34300 7c 20 20 20 20 20 20 20 20 20 20 20 20 28 28 72 | ((r
34310 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
34320 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 Write(pPage->pDb
34330 50 61 67 65 29 29 21 3d 30 29 0a 20 20 20 20 29 Page))!=0). )
34340 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 66 72 65 {. goto fre
34350 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d epage_out;. }
34360 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 50 61 67 . memset(pPag
34370 65 2d 3e 61 44 61 74 61 2c 20 30 2c 20 70 50 61 e->aData, 0, pPa
34380 67 65 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a ge->pBt->pageSiz
34390 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 e);. }.. /* If
343a0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 75 the database su
343b0 70 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 63 75 pports auto-vacu
343c0 75 6d 2c 20 77 72 69 74 65 20 61 6e 20 65 6e 74 um, write an ent
343d0 72 79 20 69 6e 20 74 68 65 20 70 6f 69 6e 74 65 ry in the pointe
343e0 72 2d 6d 61 70 0a 20 20 2a 2a 20 74 6f 20 69 6e r-map. ** to in
343f0 64 69 63 61 74 65 20 74 68 61 74 20 74 68 65 20 dicate that the
34400 70 61 67 65 20 69 73 20 66 72 65 65 2e 0a 20 20 page is free..
34410 2a 2f 0a 20 20 69 66 28 20 49 53 41 55 54 4f 56 */. if( ISAUTOV
34420 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 70 74 72 ACUUM ){. ptr
34430 6d 61 70 50 75 74 28 70 42 74 2c 20 69 50 61 67 mapPut(pBt, iPag
34440 65 2c 20 50 54 52 4d 41 50 5f 46 52 45 45 50 41 e, PTRMAP_FREEPA
34450 47 45 2c 20 30 2c 20 26 72 63 29 3b 0a 20 20 20 GE, 0, &rc);.
34460 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 66 if( rc ) goto f
34470 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d reepage_out;. }
34480 0a 0a 20 20 2f 2a 20 4e 6f 77 20 6d 61 6e 69 70 .. /* Now manip
34490 75 6c 61 74 65 20 74 68 65 20 61 63 74 75 61 6c ulate the actual
344a0 20 64 61 74 61 62 61 73 65 20 66 72 65 65 2d 6c database free-l
344b0 69 73 74 20 73 74 72 75 63 74 75 72 65 2e 20 54 ist structure. T
344c0 68 65 72 65 20 61 72 65 20 74 77 6f 0a 20 20 2a here are two. *
344d0 2a 20 70 6f 73 73 69 62 69 6c 69 74 69 65 73 2e * possibilities.
344e0 20 49 66 20 74 68 65 20 66 72 65 65 2d 6c 69 73 If the free-lis
344f0 74 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 65 t is currently e
34500 6d 70 74 79 2c 20 6f 72 20 69 66 20 74 68 65 20 mpty, or if the
34510 66 69 72 73 74 0a 20 20 2a 2a 20 74 72 75 6e 6b first. ** trunk
34520 20 70 61 67 65 20 69 6e 20 74 68 65 20 66 72 65 page in the fre
34530 65 2d 6c 69 73 74 20 69 73 20 66 75 6c 6c 2c 20 e-list is full,
34540 74 68 65 6e 20 74 68 69 73 20 70 61 67 65 20 77 then this page w
34550 69 6c 6c 20 62 65 63 6f 6d 65 20 61 0a 20 20 2a ill become a. *
34560 2a 20 6e 65 77 20 66 72 65 65 2d 6c 69 73 74 20 * new free-list
34570 74 72 75 6e 6b 20 70 61 67 65 2e 20 4f 74 68 65 trunk page. Othe
34580 72 77 69 73 65 2c 20 69 74 20 77 69 6c 6c 20 62 rwise, it will b
34590 65 63 6f 6d 65 20 61 20 6c 65 61 66 20 6f 66 20 ecome a leaf of
345a0 74 68 65 0a 20 20 2a 2a 20 66 69 72 73 74 20 74 the. ** first t
345b0 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 65 runk page in the
345c0 20 63 75 72 72 65 6e 74 20 66 72 65 65 2d 6c 69 current free-li
345d0 73 74 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 74 st. This block t
345e0 65 73 74 73 20 69 66 20 69 74 0a 20 20 2a 2a 20 ests if it. **
345f0 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 is possible to a
34600 64 64 20 74 68 65 20 70 61 67 65 20 61 73 20 61 dd the page as a
34610 20 6e 65 77 20 66 72 65 65 2d 6c 69 73 74 20 6c new free-list l
34620 65 61 66 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 eaf.. */. if(
34630 6e 46 72 65 65 21 3d 30 20 29 7b 0a 20 20 20 20 nFree!=0 ){.
34640 75 33 32 20 6e 4c 65 61 66 3b 20 20 20 20 20 20 u32 nLeaf;
34650 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 69 /* Ini
34660 74 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 6c tial number of l
34670 65 61 66 20 63 65 6c 6c 73 20 6f 6e 20 74 72 75 eaf cells on tru
34680 6e 6b 20 70 61 67 65 20 2a 2f 0a 0a 20 20 20 20 nk page */..
34690 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 74 iTrunk = get4byt
346a0 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
346b0 5b 33 32 5d 29 3b 0a 20 20 20 20 72 63 20 3d 20 [32]);. rc =
346c0 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 btreeGetPage(pBt
346d0 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 6e , iTrunk, &pTrun
346e0 6b 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 k, 0);. if( r
346f0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
34700 20 20 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 goto freep
34710 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 0a age_out;. }..
34720 20 20 20 20 6e 4c 65 61 66 20 3d 20 67 65 74 34 nLeaf = get4
34730 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 byte(&pTrunk->aD
34740 61 74 61 5b 34 5d 29 3b 0a 20 20 20 20 61 73 73 ata[4]);. ass
34750 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 ert( pBt->usable
34760 53 69 7a 65 3e 33 32 20 29 3b 0a 20 20 20 20 69 Size>32 );. i
34770 66 28 20 6e 4c 65 61 66 20 3e 20 28 75 33 32 29 f( nLeaf > (u32)
34780 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f pBt->usableSize/
34790 34 20 2d 20 32 20 29 7b 0a 20 20 20 20 20 20 72 4 - 2 ){. r
347a0 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 c = SQLITE_CORRU
347b0 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 PT_BKPT;. g
347c0 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
347d0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
347e0 6e 4c 65 61 66 20 3c 20 28 75 33 32 29 70 42 74 nLeaf < (u32)pBt
347f0 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d ->usableSize/4 -
34800 20 38 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 8 ){. /* I
34810 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 72 n this case ther
34820 65 20 69 73 20 72 6f 6f 6d 20 6f 6e 20 74 68 65 e is room on the
34830 20 74 72 75 6e 6b 20 70 61 67 65 20 74 6f 20 69 trunk page to i
34840 6e 73 65 72 74 20 74 68 65 20 70 61 67 65 0a 20 nsert the page.
34850 20 20 20 20 20 2a 2a 20 62 65 69 6e 67 20 66 72 ** being fr
34860 65 65 64 20 61 73 20 61 20 6e 65 77 20 6c 65 61 eed as a new lea
34870 66 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 f.. **.
34880 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 ** Note that t
34890 68 65 20 74 72 75 6e 6b 20 70 61 67 65 20 69 73 he trunk page is
348a0 20 6e 6f 74 20 72 65 61 6c 6c 79 20 66 75 6c 6c not really full
348b0 20 75 6e 74 69 6c 20 69 74 20 63 6f 6e 74 61 69 until it contai
348c0 6e 73 0a 20 20 20 20 20 20 2a 2a 20 75 73 61 62 ns. ** usab
348d0 6c 65 53 69 7a 65 2f 34 20 2d 20 32 20 65 6e 74 leSize/4 - 2 ent
348e0 72 69 65 73 2c 20 6e 6f 74 20 75 73 61 62 6c 65 ries, not usable
348f0 53 69 7a 65 2f 34 20 2d 20 38 20 65 6e 74 72 69 Size/4 - 8 entri
34900 65 73 20 61 73 20 77 65 20 68 61 76 65 0a 20 20 es as we have.
34910 20 20 20 20 2a 2a 20 63 6f 64 65 64 2e 20 20 42 ** coded. B
34920 75 74 20 64 75 65 20 74 6f 20 61 20 63 6f 64 69 ut due to a codi
34930 6e 67 20 65 72 72 6f 72 20 69 6e 20 76 65 72 73 ng error in vers
34940 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 70 ions of SQLite p
34950 72 69 6f 72 20 74 6f 0a 20 20 20 20 20 20 2a 2a rior to. **
34960 20 33 2e 36 2e 30 2c 20 64 61 74 61 62 61 73 65 3.6.0, database
34970 73 20 77 69 74 68 20 66 72 65 65 6c 69 73 74 20 s with freelist
34980 74 72 75 6e 6b 20 70 61 67 65 73 20 68 6f 6c 64 trunk pages hold
34990 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 0a 20 20 ing more than.
349a0 20 20 20 20 2a 2a 20 75 73 61 62 6c 65 53 69 7a ** usableSiz
349b0 65 2f 34 20 2d 20 38 20 65 6e 74 72 69 65 73 20 e/4 - 8 entries
349c0 77 69 6c 6c 20 62 65 20 72 65 70 6f 72 74 65 64 will be reported
349d0 20 61 73 20 63 6f 72 72 75 70 74 2e 20 20 49 6e as corrupt. In
349e0 20 6f 72 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 order. **
349f0 74 6f 20 6d 61 69 6e 74 61 69 6e 20 62 61 63 6b to maintain back
34a00 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 6c wards compatibil
34a10 69 74 79 20 77 69 74 68 20 6f 6c 64 65 72 20 76 ity with older v
34a20 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 ersions of SQLit
34a30 65 2c 0a 20 20 20 20 20 20 2a 2a 20 77 65 20 77 e,. ** we w
34a40 69 6c 6c 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 ill continue to
34a50 72 65 73 74 72 69 63 74 20 74 68 65 20 6e 75 6d restrict the num
34a60 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 74 ber of entries t
34a70 6f 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d o usableSize/4 -
34a80 20 38 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 8. ** for
34a90 6e 6f 77 2e 20 20 41 74 20 73 6f 6d 65 20 70 6f now. At some po
34aa0 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74 75 72 int in the futur
34ab0 65 20 28 6f 6e 63 65 20 65 76 65 72 79 6f 6e 65 e (once everyone
34ac0 20 68 61 73 20 75 70 67 72 61 64 65 64 0a 20 20 has upgraded.
34ad0 20 20 20 20 2a 2a 20 74 6f 20 33 2e 36 2e 30 20 ** to 3.6.0
34ae0 6f 72 20 6c 61 74 65 72 29 20 77 65 20 73 68 6f or later) we sho
34af0 75 6c 64 20 63 6f 6e 73 69 64 65 72 20 66 69 78 uld consider fix
34b00 69 6e 67 20 74 68 65 20 63 6f 6e 64 69 74 69 6f ing the conditio
34b10 6e 61 6c 20 61 62 6f 76 65 0a 20 20 20 20 20 20 nal above.
34b20 2a 2a 20 74 6f 20 72 65 61 64 20 22 75 73 61 62 ** to read "usab
34b30 6c 65 53 69 7a 65 2f 34 2d 32 22 20 69 6e 73 74 leSize/4-2" inst
34b40 65 61 64 20 6f 66 20 22 75 73 61 62 6c 65 53 69 ead of "usableSi
34b50 7a 65 2f 34 2d 38 22 2e 0a 20 20 20 20 20 20 2a ze/4-8".. *
34b60 2a 0a 20 20 20 20 20 20 2a 2a 20 45 56 49 44 45 *. ** EVIDE
34b70 4e 43 45 2d 4f 46 3a 20 52 2d 31 39 39 32 30 2d NCE-OF: R-19920-
34b80 31 31 35 37 36 20 48 6f 77 65 76 65 72 2c 20 6e 11576 However, n
34b90 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 ewer versions of
34ba0 20 53 51 4c 69 74 65 20 73 74 69 6c 6c 0a 20 20 SQLite still.
34bb0 20 20 20 20 2a 2a 20 61 76 6f 69 64 20 75 73 69 ** avoid usi
34bc0 6e 67 20 74 68 65 20 6c 61 73 74 20 73 69 78 20 ng the last six
34bd0 65 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 66 entries in the f
34be0 72 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 reelist trunk pa
34bf0 67 65 20 61 72 72 61 79 20 69 6e 0a 20 20 20 20 ge array in.
34c00 20 20 2a 2a 20 6f 72 64 65 72 20 74 68 61 74 20 ** order that
34c10 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 63 database files c
34c20 72 65 61 74 65 64 20 62 79 20 6e 65 77 65 72 20 reated by newer
34c30 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 versions of SQLi
34c40 74 65 20 63 61 6e 20 62 65 0a 20 20 20 20 20 20 te can be.
34c50 2a 2a 20 72 65 61 64 20 62 79 20 6f 6c 64 65 72 ** read by older
34c60 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
34c70 69 74 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ite.. */.
34c80 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
34c90 50 61 67 65 72 57 72 69 74 65 28 70 54 72 75 6e PagerWrite(pTrun
34ca0 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 k->pDbPage);.
34cb0 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
34cc0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
34cd0 70 75 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b put4byte(&pTrunk
34ce0 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 6e 4c 65 61 ->aData[4], nLea
34cf0 66 2b 31 29 3b 0a 20 20 20 20 20 20 20 20 70 75 f+1);. pu
34d00 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e t4byte(&pTrunk->
34d10 61 44 61 74 61 5b 38 2b 6e 4c 65 61 66 2a 34 5d aData[8+nLeaf*4]
34d20 2c 20 69 50 61 67 65 29 3b 0a 20 20 20 20 20 20 , iPage);.
34d30 20 20 69 66 28 20 70 50 61 67 65 20 26 26 20 28 if( pPage && (
34d40 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
34d50 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 BTS_SECURE_DELET
34d60 45 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 E)==0 ){.
34d70 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 sqlite3PagerD
34d80 6f 6e 74 57 72 69 74 65 28 70 50 61 67 65 2d 3e ontWrite(pPage->
34d90 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
34da0 20 20 7d 0a 20 20 20 20 20 20 20 20 72 63 20 3d }. rc =
34db0 20 62 74 72 65 65 53 65 74 48 61 73 43 6f 6e 74 btreeSetHasCont
34dc0 65 6e 74 28 70 42 74 2c 20 69 50 61 67 65 29 3b ent(pBt, iPage);
34dd0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 54 . }. T
34de0 52 41 43 45 28 28 22 46 52 45 45 2d 50 41 47 45 RACE(("FREE-PAGE
34df0 3a 20 25 64 20 6c 65 61 66 20 6f 6e 20 74 72 75 : %d leaf on tru
34e00 6e 6b 20 70 61 67 65 20 25 64 5c 6e 22 2c 70 50 nk page %d\n",pP
34e10 61 67 65 2d 3e 70 67 6e 6f 2c 70 54 72 75 6e 6b age->pgno,pTrunk
34e20 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 20 20 20 ->pgno));.
34e30 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 goto freepage_ou
34e40 74 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 t;. }. }..
34e50 2f 2a 20 49 66 20 63 6f 6e 74 72 6f 6c 20 66 6c /* If control fl
34e60 6f 77 73 20 74 6f 20 74 68 69 73 20 70 6f 69 6e ows to this poin
34e70 74 2c 20 74 68 65 6e 20 69 74 20 77 61 73 20 6e t, then it was n
34e80 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 61 ot possible to a
34e90 64 64 20 74 68 65 0a 20 20 2a 2a 20 74 68 65 20 dd the. ** the
34ea0 70 61 67 65 20 62 65 69 6e 67 20 66 72 65 65 64 page being freed
34eb0 20 61 73 20 61 20 6c 65 61 66 20 70 61 67 65 20 as a leaf page
34ec0 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 72 75 of the first tru
34ed0 6e 6b 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c nk in the free-l
34ee0 69 73 74 2e 0a 20 20 2a 2a 20 50 6f 73 73 69 62 ist.. ** Possib
34ef0 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20 66 ly because the f
34f00 72 65 65 2d 6c 69 73 74 20 69 73 20 65 6d 70 74 ree-list is empt
34f10 79 2c 20 6f 72 20 70 6f 73 73 69 62 6c 79 20 62 y, or possibly b
34f20 65 63 61 75 73 65 20 74 68 65 20 0a 20 20 2a 2a ecause the . **
34f30 20 66 69 72 73 74 20 74 72 75 6e 6b 20 69 6e 20 first trunk in
34f40 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 the free-list is
34f50 20 66 75 6c 6c 2e 20 45 69 74 68 65 72 20 77 61 full. Either wa
34f60 79 2c 20 74 68 65 20 70 61 67 65 20 62 65 69 6e y, the page bein
34f70 67 20 66 72 65 65 64 0a 20 20 2a 2a 20 77 69 6c g freed. ** wil
34f80 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 6e 65 77 l become the new
34f90 20 66 69 72 73 74 20 74 72 75 6e 6b 20 70 61 67 first trunk pag
34fa0 65 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 e in the free-li
34fb0 73 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 st.. */. if( p
34fc0 50 61 67 65 3d 3d 30 20 26 26 20 53 51 4c 49 54 Page==0 && SQLIT
34fd0 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 62 74 72 65 E_OK!=(rc = btre
34fe0 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 50 eGetPage(pBt, iP
34ff0 61 67 65 2c 20 26 70 50 61 67 65 2c 20 30 29 29 age, &pPage, 0))
35000 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 65 ){. goto fre
35010 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 epage_out;. }.
35020 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
35030 65 72 57 72 69 74 65 28 70 50 61 67 65 2d 3e 70 erWrite(pPage->p
35040 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 DbPage);. if( r
35050 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
35060 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 goto freepag
35070 65 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 70 75 74 e_out;. }. put
35080 34 62 79 74 65 28 70 50 61 67 65 2d 3e 61 44 61 4byte(pPage->aDa
35090 74 61 2c 20 69 54 72 75 6e 6b 29 3b 0a 20 20 70 ta, iTrunk);. p
350a0 75 74 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e ut4byte(&pPage->
350b0 61 44 61 74 61 5b 34 5d 2c 20 30 29 3b 0a 20 20 aData[4], 0);.
350c0 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
350d0 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 50 61 ->aData[32], iPa
350e0 67 65 29 3b 0a 20 20 54 52 41 43 45 28 28 22 46 ge);. TRACE(("F
350f0 52 45 45 2d 50 41 47 45 3a 20 25 64 20 6e 65 77 REE-PAGE: %d new
35100 20 74 72 75 6e 6b 20 70 61 67 65 20 72 65 70 6c trunk page repl
35110 61 63 69 6e 67 20 25 64 5c 6e 22 2c 20 70 50 61 acing %d\n", pPa
35120 67 65 2d 3e 70 67 6e 6f 2c 20 69 54 72 75 6e 6b ge->pgno, iTrunk
35130 29 29 3b 0a 0a 66 72 65 65 70 61 67 65 5f 6f 75 ));..freepage_ou
35140 74 3a 0a 20 20 69 66 28 20 70 50 61 67 65 20 29 t:. if( pPage )
35150 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 {. pPage->isI
35160 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 nit = 0;. }. r
35170 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
35180 29 3b 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 );. releasePage
35190 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 74 75 (pTrunk);. retu
351a0 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 rn rc;.}.static
351b0 76 6f 69 64 20 66 72 65 65 50 61 67 65 28 4d 65 void freePage(Me
351c0 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
351d0 74 20 2a 70 52 43 29 7b 0a 20 20 69 66 28 20 28 t *pRC){. if( (
351e0 2a 70 52 43 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b *pRC)==SQLITE_OK
351f0 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 66 ){. *pRC = f
35200 72 65 65 50 61 67 65 32 28 70 50 61 67 65 2d 3e reePage2(pPage->
35210 70 42 74 2c 20 70 50 61 67 65 2c 20 70 50 61 67 pBt, pPage, pPag
35220 65 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a e->pgno);. }.}.
35230 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6e 79 20 ./*.** Free any
35240 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
35250 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
35260 68 65 20 67 69 76 65 6e 20 43 65 6c 6c 2e 20 20 he given Cell.
35270 53 74 6f 72 65 0a 2a 2a 20 73 69 7a 65 20 69 6e Store.** size in
35280 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
35290 74 68 65 20 63 65 6c 6c 20 69 6e 20 70 49 6e 66 the cell in pInf
352a0 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 o..*/.static int
352b0 20 63 6c 65 61 72 43 65 6c 6c 28 0a 20 20 4d 65 clearCell(. Me
352c0 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
352d0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 /* The pa
352e0 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 ge that contains
352f0 20 74 68 65 20 43 65 6c 6c 20 2a 2f 0a 20 20 75 the Cell */. u
35300 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 43 nsigned char *pC
35310 65 6c 6c 2c 20 20 20 20 2f 2a 20 46 69 72 73 74 ell, /* First
35320 20 62 79 74 65 20 6f 66 20 74 68 65 20 43 65 6c byte of the Cel
35330 6c 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 l */. CellInfo
35340 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 20 *pInfo
35350 2f 2a 20 53 69 7a 65 20 69 6e 66 6f 72 6d 61 74 /* Size informat
35360 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 63 65 ion about the ce
35370 6c 6c 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 ll */.){. BtSha
35380 72 65 64 20 2a 70 42 74 3b 0a 20 20 50 67 6e 6f red *pBt;. Pgno
35390 20 6f 76 66 6c 50 67 6e 6f 3b 0a 20 20 69 6e 74 ovflPgno;. int
353a0 20 72 63 3b 0a 20 20 69 6e 74 20 6e 4f 76 66 6c rc;. int nOvfl
353b0 3b 0a 20 20 75 33 32 20 6f 76 66 6c 50 61 67 65 ;. u32 ovflPage
353c0 53 69 7a 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 Size;.. assert(
353d0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
353e0 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
353f0 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 67 mutex) );. pPag
35400 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 50 e->xParseCell(pP
35410 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e 66 age, pCell, pInf
35420 6f 29 3b 0a 20 20 69 66 28 20 70 49 6e 66 6f 2d o);. if( pInfo-
35430 3e 6e 4c 6f 63 61 6c 3d 3d 70 49 6e 66 6f 2d 3e >nLocal==pInfo->
35440 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 nPayload ){.
35450 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
35460 3b 20 20 2f 2a 20 4e 6f 20 6f 76 65 72 66 6c 6f ; /* No overflo
35470 77 20 70 61 67 65 73 2e 20 52 65 74 75 72 6e 20 w pages. Return
35480 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 6e without doing an
35490 79 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 0a 20 20 ything */. }.
354a0 74 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c 20 testcase( pCell
354b0 2b 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d + pInfo->nSize =
354c0 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e = pPage->aDataEn
354d0 64 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 d );. testcase(
354e0 20 70 43 65 6c 6c 20 2b 20 28 70 49 6e 66 6f 2d pCell + (pInfo-
354f0 3e 6e 53 69 7a 65 2d 31 29 20 3d 3d 20 70 50 61 >nSize-1) == pPa
35500 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a ge->aDataEnd );.
35510 20 20 69 66 28 20 70 43 65 6c 6c 20 2b 20 70 49 if( pCell + pI
35520 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3e 20 70 50 61 nfo->nSize > pPa
35530 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 7b 0a ge->aDataEnd ){.
35540 20 20 20 20 2f 2a 20 43 65 6c 6c 20 65 78 74 65 /* Cell exte
35550 6e 64 73 20 70 61 73 74 20 65 6e 64 20 6f 66 20 nds past end of
35560 70 61 67 65 20 2a 2f 0a 20 20 20 20 72 65 74 75 page */. retu
35570 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
35580 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 T_PAGE(pPage);.
35590 20 7d 0a 20 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 }. ovflPgno =
355a0 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c 20 2b get4byte(pCell +
355b0 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 2d 20 pInfo->nSize -
355c0 34 29 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 67 4);. pBt = pPag
355d0 65 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 e->pBt;. assert
355e0 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ( pBt->usableSiz
355f0 65 20 3e 20 34 20 29 3b 0a 20 20 6f 76 66 6c 50 e > 4 );. ovflP
35600 61 67 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 ageSize = pBt->u
35610 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 sableSize - 4;.
35620 20 6e 4f 76 66 6c 20 3d 20 28 70 49 6e 66 6f 2d nOvfl = (pInfo-
35630 3e 6e 50 61 79 6c 6f 61 64 20 2d 20 70 49 6e 66 >nPayload - pInf
35640 6f 2d 3e 6e 4c 6f 63 61 6c 20 2b 20 6f 76 66 6c o->nLocal + ovfl
35650 50 61 67 65 53 69 7a 65 20 2d 20 31 29 2f 6f 76 PageSize - 1)/ov
35660 66 6c 50 61 67 65 53 69 7a 65 3b 0a 20 20 61 73 flPageSize;. as
35670 73 65 72 74 28 20 6e 4f 76 66 6c 3e 30 20 7c 7c sert( nOvfl>0 ||
35680 20 0a 20 20 20 20 28 43 4f 52 52 55 50 54 5f 44 . (CORRUPT_D
35690 42 20 26 26 20 28 70 49 6e 66 6f 2d 3e 6e 50 61 B && (pInfo->nPa
356a0 79 6c 6f 61 64 20 2b 20 6f 76 66 6c 50 61 67 65 yload + ovflPage
356b0 53 69 7a 65 29 3c 6f 76 66 6c 50 61 67 65 53 69 Size)<ovflPageSi
356c0 7a 65 29 0a 20 20 29 3b 0a 20 20 77 68 69 6c 65 ze). );. while
356d0 28 20 6e 4f 76 66 6c 2d 2d 20 29 7b 0a 20 20 20 ( nOvfl-- ){.
356e0 20 50 67 6e 6f 20 69 4e 65 78 74 20 3d 20 30 3b Pgno iNext = 0;
356f0 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4f . MemPage *pO
35700 76 66 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 vfl = 0;. if(
35710 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 7c 7c 20 6f ovflPgno<2 || o
35720 76 66 6c 50 67 6e 6f 3e 62 74 72 65 65 50 61 67 vflPgno>btreePag
35730 65 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 ecount(pBt) ){.
35740 20 20 20 20 20 2f 2a 20 30 20 69 73 20 6e 6f 74 /* 0 is not
35750 20 61 20 6c 65 67 61 6c 20 70 61 67 65 20 6e 75 a legal page nu
35760 6d 62 65 72 20 61 6e 64 20 70 61 67 65 20 31 20 mber and page 1
35770 63 61 6e 6e 6f 74 20 62 65 20 61 6e 20 0a 20 20 cannot be an .
35780 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 ** overflow
35790 70 61 67 65 2e 20 54 68 65 72 65 66 6f 72 65 20 page. Therefore
357a0 69 66 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 6f 72 if ovflPgno<2 or
357b0 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
357c0 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 the . ** f
357d0 69 6c 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ile the database
357e0 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 74 must be corrupt
357f0 2e 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 . */. retur
35800 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
35810 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 _BKPT;. }.
35820 20 69 66 28 20 6e 4f 76 66 6c 20 29 7b 0a 20 20 if( nOvfl ){.
35830 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 72 rc = getOver
35840 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6f 76 flowPage(pBt, ov
35850 66 6c 50 67 6e 6f 2c 20 26 70 4f 76 66 6c 2c 20 flPgno, &pOvfl,
35860 26 69 4e 65 78 74 29 3b 0a 20 20 20 20 20 20 69 &iNext);. i
35870 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
35880 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 c;. }.. if
35890 28 20 28 20 70 4f 76 66 6c 20 7c 7c 20 28 28 70 ( ( pOvfl || ((p
358a0 4f 76 66 6c 20 3d 20 62 74 72 65 65 50 61 67 65 Ovfl = btreePage
358b0 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 6f 76 66 6c Lookup(pBt, ovfl
358c0 50 67 6e 6f 29 29 21 3d 30 29 20 29 0a 20 20 20 Pgno))!=0) ).
358d0 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 && sqlite3Page
358e0 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 4f rPageRefcount(pO
358f0 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 21 3d 31 vfl->pDbPage)!=1
35900 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 2a . ){. /*
35910 20 54 68 65 72 65 20 69 73 20 6e 6f 20 72 65 61 There is no rea
35920 73 6f 6e 20 61 6e 79 20 63 75 72 73 6f 72 20 73 son any cursor s
35930 68 6f 75 6c 64 20 68 61 76 65 20 61 6e 20 6f 75 hould have an ou
35940 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 tstanding refere
35950 6e 63 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 6f nce . ** to
35960 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
35970 65 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 61 e belonging to a
35980 20 63 65 6c 6c 20 74 68 61 74 20 69 73 20 62 65 cell that is be
35990 69 6e 67 20 64 65 6c 65 74 65 64 2f 75 70 64 61 ing deleted/upda
359a0 74 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 53 6f ted.. ** So
359b0 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 if there exists
359c0 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72 more than one r
359d0 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 69 73 eference to this
359e0 20 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 0a page, then it .
359f0 20 20 20 20 20 20 2a 2a 20 6d 75 73 74 20 6e 6f ** must no
35a00 74 20 72 65 61 6c 6c 79 20 62 65 20 61 6e 20 6f t really be an o
35a10 76 65 72 66 6c 6f 77 20 70 61 67 65 20 61 6e 64 verflow page and
35a20 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 the database mu
35a30 73 74 20 62 65 20 63 6f 72 72 75 70 74 2e 20 0a st be corrupt. .
35a40 20 20 20 20 20 20 2a 2a 20 49 74 20 69 73 20 68 ** It is h
35a50 65 6c 70 66 75 6c 20 74 6f 20 64 65 74 65 63 74 elpful to detect
35a60 20 74 68 69 73 20 62 65 66 6f 72 65 20 63 61 6c this before cal
35a70 6c 69 6e 67 20 66 72 65 65 50 61 67 65 32 28 29 ling freePage2()
35a80 2c 20 61 73 20 0a 20 20 20 20 20 20 2a 2a 20 66 , as . ** f
35a90 72 65 65 50 61 67 65 32 28 29 20 6d 61 79 20 7a reePage2() may z
35aa0 65 72 6f 20 74 68 65 20 70 61 67 65 20 63 6f 6e ero the page con
35ab0 74 65 6e 74 73 20 69 66 20 73 65 63 75 72 65 2d tents if secure-
35ac0 64 65 6c 65 74 65 20 6d 6f 64 65 20 69 73 0a 20 delete mode is.
35ad0 20 20 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 2e ** enabled.
35ae0 20 49 66 20 74 68 69 73 20 27 6f 76 65 72 66 6c If this 'overfl
35af0 6f 77 27 20 70 61 67 65 20 68 61 70 70 65 6e 73 ow' page happens
35b00 20 74 6f 20 62 65 20 61 20 70 61 67 65 20 74 68 to be a page th
35b10 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 at the. **
35b20 63 61 6c 6c 65 72 20 69 73 20 69 74 65 72 61 74 caller is iterat
35b30 69 6e 67 20 74 68 72 6f 75 67 68 20 6f 72 20 75 ing through or u
35b40 73 69 6e 67 20 69 6e 20 73 6f 6d 65 20 6f 74 68 sing in some oth
35b50 65 72 20 77 61 79 2c 20 74 68 69 73 0a 20 20 20 er way, this.
35b60 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 70 72 6f ** can be pro
35b70 62 6c 65 6d 61 74 69 63 2e 0a 20 20 20 20 20 20 blematic..
35b80 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 */. rc = SQ
35b90 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
35ba0 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 T;. }else{.
35bb0 20 20 20 20 72 63 20 3d 20 66 72 65 65 50 61 67 rc = freePag
35bc0 65 32 28 70 42 74 2c 20 70 4f 76 66 6c 2c 20 6f e2(pBt, pOvfl, o
35bd0 76 66 6c 50 67 6e 6f 29 3b 0a 20 20 20 20 7d 0a vflPgno);. }.
35be0 0a 20 20 20 20 69 66 28 20 70 4f 76 66 6c 20 29 . if( pOvfl )
35bf0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
35c00 61 67 65 72 55 6e 72 65 66 28 70 4f 76 66 6c 2d agerUnref(pOvfl-
35c10 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 7d >pDbPage);. }
35c20 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
35c30 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 6f 76 66 turn rc;. ovf
35c40 6c 50 67 6e 6f 20 3d 20 69 4e 65 78 74 3b 0a 20 lPgno = iNext;.
35c50 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
35c60 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 TE_OK;.}../*.**
35c70 43 72 65 61 74 65 20 74 68 65 20 62 79 74 65 20 Create the byte
35c80 73 65 71 75 65 6e 63 65 20 75 73 65 64 20 74 6f sequence used to
35c90 20 72 65 70 72 65 73 65 6e 74 20 61 20 63 65 6c represent a cel
35ca0 6c 20 6f 6e 20 70 61 67 65 20 70 50 61 67 65 0a l on page pPage.
35cb0 2a 2a 20 61 6e 64 20 77 72 69 74 65 20 74 68 61 ** and write tha
35cc0 74 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 t byte sequence
35cd0 69 6e 74 6f 20 70 43 65 6c 6c 5b 5d 2e 20 20 4f into pCell[]. O
35ce0 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 verflow pages ar
35cf0 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 e.** allocated a
35d00 6e 64 20 66 69 6c 6c 65 64 20 69 6e 20 61 73 20 nd filled in as
35d10 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 65 20 necessary. The
35d20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 72 calling procedur
35d30 65 0a 2a 2a 20 69 73 20 72 65 73 70 6f 6e 73 69 e.** is responsi
35d40 62 6c 65 20 66 6f 72 20 6d 61 6b 69 6e 67 20 73 ble for making s
35d50 75 72 65 20 73 75 66 66 69 63 69 65 6e 74 20 73 ure sufficient s
35d60 70 61 63 65 20 68 61 73 20 62 65 65 6e 20 61 6c pace has been al
35d70 6c 6f 63 61 74 65 64 0a 2a 2a 20 66 6f 72 20 70 located.** for p
35d80 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 4e 6f Cell[]..**.** No
35d90 74 65 20 74 68 61 74 20 70 43 65 6c 6c 20 64 6f te that pCell do
35da0 65 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 es not necessary
35db0 20 6e 65 65 64 20 74 6f 20 70 6f 69 6e 74 20 74 need to point t
35dc0 6f 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 61 o the pPage->aDa
35dd0 74 61 0a 2a 2a 20 61 72 65 61 2e 20 20 70 43 65 ta.** area. pCe
35de0 6c 6c 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 ll might point t
35df0 6f 20 73 6f 6d 65 20 74 65 6d 70 6f 72 61 72 79 o some temporary
35e00 20 73 74 6f 72 61 67 65 2e 20 20 54 68 65 20 63 storage. The c
35e10 65 6c 6c 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 63 ell will.** be c
35e20 6f 6e 73 74 72 75 63 74 65 64 20 69 6e 20 74 68 onstructed in th
35e30 69 73 20 74 65 6d 70 6f 72 61 72 79 20 61 72 65 is temporary are
35e40 61 20 74 68 65 6e 20 63 6f 70 69 65 64 20 69 6e a then copied in
35e50 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 0a to pPage->aData.
35e60 2a 2a 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 61 ** later..*/.sta
35e70 74 69 63 20 69 6e 74 20 66 69 6c 6c 49 6e 43 65 tic int fillInCe
35e80 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 ll(. MemPage *p
35e90 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 Page,
35ea0 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 /* The page
35eb0 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 that contains t
35ec0 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 6e 73 he cell */. uns
35ed0 69 67 6e 65 64 20 63 68 61 72 20 2a 70 43 65 6c igned char *pCel
35ee0 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 l, /* C
35ef0 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 omplete text of
35f00 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 63 6f the cell */. co
35f10 6e 73 74 20 42 74 72 65 65 50 61 79 6c 6f 61 64 nst BtreePayload
35f20 20 2a 70 58 2c 20 20 20 20 20 20 20 20 2f 2a 20 *pX, /*
35f30 50 61 79 6c 6f 61 64 20 77 69 74 68 20 77 68 69 Payload with whi
35f40 63 68 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 ch to construct
35f50 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e the cell */. in
35f60 74 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 20 20 t *pnSize
35f70 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
35f80 57 72 69 74 65 20 63 65 6c 6c 20 73 69 7a 65 20 Write cell size
35f90 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
35fa0 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 63 6f 6e nPayload;. con
35fb0 73 74 20 75 38 20 2a 70 53 72 63 3b 0a 20 20 69 st u8 *pSrc;. i
35fc0 6e 74 20 6e 53 72 63 2c 20 6e 2c 20 72 63 2c 20 nt nSrc, n, rc,
35fd0 6d 6e 3b 0a 20 20 69 6e 74 20 73 70 61 63 65 4c mn;. int spaceL
35fe0 65 66 74 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a eft;. MemPage *
35ff0 70 54 6f 52 65 6c 65 61 73 65 3b 0a 20 20 75 6e pToRelease;. un
36000 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 72 signed char *pPr
36010 69 6f 72 3b 0a 20 20 75 6e 73 69 67 6e 65 64 20 ior;. unsigned
36020 63 68 61 72 20 2a 70 50 61 79 6c 6f 61 64 3b 0a char *pPayload;.
36030 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b BtShared *pBt;
36040 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 4f 76 66 6c . Pgno pgnoOvfl
36050 3b 0a 20 20 69 6e 74 20 6e 48 65 61 64 65 72 3b ;. int nHeader;
36060 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
36070 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
36080 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
36090 29 20 29 3b 0a 0a 20 20 2f 2a 20 70 50 61 67 65 ) );.. /* pPage
360a0 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 is not necessar
360b0 69 6c 79 20 77 72 69 74 65 61 62 6c 65 20 73 69 ily writeable si
360c0 6e 63 65 20 70 43 65 6c 6c 20 6d 69 67 68 74 20 nce pCell might
360d0 62 65 20 61 75 78 69 6c 69 61 72 79 0a 20 20 2a be auxiliary. *
360e0 2a 20 62 75 66 66 65 72 20 73 70 61 63 65 20 74 * buffer space t
360f0 68 61 74 20 69 73 20 73 65 70 61 72 61 74 65 20 hat is separate
36100 66 72 6f 6d 20 74 68 65 20 70 50 61 67 65 20 62 from the pPage b
36110 75 66 66 65 72 20 61 72 65 61 20 2a 2f 0a 20 20 uffer area */.
36120 61 73 73 65 72 74 28 20 70 43 65 6c 6c 3c 70 50 assert( pCell<pP
36130 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 43 age->aData || pC
36140 65 6c 6c 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 ell>=&pPage->aDa
36150 74 61 5b 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 ta[pPage->pBt->p
36160 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 ageSize].
36170 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 || sqlite3P
36180 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 agerIswriteable(
36190 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 pPage->pDbPage)
361a0 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e );.. /* Fill in
361b0 20 74 68 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a the header. */.
361c0 20 20 6e 48 65 61 64 65 72 20 3d 20 70 50 61 67 nHeader = pPag
361d0 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b e->childPtrSize;
361e0 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e . if( pPage->in
361f0 74 4b 65 79 20 29 7b 0a 20 20 20 20 6e 50 61 79 tKey ){. nPay
36200 6c 6f 61 64 20 3d 20 70 58 2d 3e 6e 44 61 74 61 load = pX->nData
36210 20 2b 20 70 58 2d 3e 6e 5a 65 72 6f 3b 0a 20 20 + pX->nZero;.
36220 20 20 70 53 72 63 20 3d 20 70 58 2d 3e 70 44 61 pSrc = pX->pDa
36230 74 61 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 70 ta;. nSrc = p
36240 58 2d 3e 6e 44 61 74 61 3b 0a 20 20 20 20 61 73 X->nData;. as
36250 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 6e 74 sert( pPage->int
36260 4b 65 79 4c 65 61 66 20 29 3b 20 2f 2a 20 66 69 KeyLeaf ); /* fi
36270 6c 6c 49 6e 43 65 6c 6c 28 29 20 6f 6e 6c 79 20 llInCell() only
36280 63 61 6c 6c 65 64 20 66 6f 72 20 6c 65 61 76 65 called for leave
36290 73 20 2a 2f 0a 20 20 20 20 6e 48 65 61 64 65 72 s */. nHeader
362a0 20 2b 3d 20 70 75 74 56 61 72 69 6e 74 33 32 28 += putVarint32(
362b0 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c &pCell[nHeader],
362c0 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 20 20 nPayload);.
362d0 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 74 56 61 nHeader += putVa
362e0 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e 48 65 61 rint(&pCell[nHea
362f0 64 65 72 5d 2c 20 2a 28 75 36 34 2a 29 26 70 58 der], *(u64*)&pX
36300 2d 3e 6e 4b 65 79 29 3b 0a 20 20 7d 65 6c 73 65 ->nKey);. }else
36310 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 58 {. assert( pX
36320 2d 3e 6e 4b 65 79 3c 3d 30 78 37 66 66 66 66 66 ->nKey<=0x7fffff
36330 66 66 20 26 26 20 70 58 2d 3e 70 4b 65 79 21 3d ff && pX->pKey!=
36340 30 20 29 3b 0a 20 20 20 20 6e 53 72 63 20 3d 20 0 );. nSrc =
36350 6e 50 61 79 6c 6f 61 64 20 3d 20 28 69 6e 74 29 nPayload = (int)
36360 70 58 2d 3e 6e 4b 65 79 3b 0a 20 20 20 20 70 53 pX->nKey;. pS
36370 72 63 20 3d 20 70 58 2d 3e 70 4b 65 79 3b 0a 20 rc = pX->pKey;.
36380 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 nHeader += pu
36390 74 56 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c tVarint32(&pCell
363a0 5b 6e 48 65 61 64 65 72 5d 2c 20 6e 50 61 79 6c [nHeader], nPayl
363b0 6f 61 64 29 3b 0a 20 20 7d 0a 20 20 0a 20 20 2f oad);. }. . /
363c0 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 20 70 61 * Fill in the pa
363d0 79 6c 6f 61 64 20 2a 2f 0a 20 20 70 50 61 79 6c yload */. pPayl
363e0 6f 61 64 20 3d 20 26 70 43 65 6c 6c 5b 6e 48 65 oad = &pCell[nHe
363f0 61 64 65 72 5d 3b 0a 20 20 69 66 28 20 6e 50 61 ader];. if( nPa
36400 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 yload<=pPage->ma
36410 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 2f 2a xLocal ){. /*
36420 20 54 68 69 73 20 69 73 20 74 68 65 20 63 6f 6d This is the com
36430 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 65 mon case where e
36440 76 65 72 79 74 68 69 6e 67 20 66 69 74 73 20 6f verything fits o
36450 6e 20 74 68 65 20 62 74 72 65 65 20 70 61 67 65 n the btree page
36460 0a 20 20 20 20 2a 2a 20 61 6e 64 20 6e 6f 20 6f . ** and no o
36470 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 72 verflow pages ar
36480 65 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a 20 e required. */.
36490 20 20 20 6e 20 3d 20 6e 48 65 61 64 65 72 20 2b n = nHeader +
364a0 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 74 nPayload;. t
364b0 65 73 74 63 61 73 65 28 20 6e 3d 3d 33 20 29 3b estcase( n==3 );
364c0 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e . testcase( n
364d0 3d 3d 34 20 29 3b 0a 20 20 20 20 69 66 28 20 6e ==4 );. if( n
364e0 3c 34 20 29 20 6e 20 3d 20 34 3b 0a 20 20 20 20 <4 ) n = 4;.
364f0 2a 70 6e 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 20 *pnSize = n;.
36500 20 61 73 73 65 72 74 28 20 6e 53 72 63 3c 3d 6e assert( nSrc<=n
36510 50 61 79 6c 6f 61 64 20 29 3b 0a 20 20 20 20 74 Payload );. t
36520 65 73 74 63 61 73 65 28 20 6e 53 72 63 3c 6e 50 estcase( nSrc<nP
36530 61 79 6c 6f 61 64 20 29 3b 0a 20 20 20 20 6d 65 ayload );. me
36540 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 2c 20 70 mcpy(pPayload, p
36550 53 72 63 2c 20 6e 53 72 63 29 3b 0a 20 20 20 20 Src, nSrc);.
36560 6d 65 6d 73 65 74 28 70 50 61 79 6c 6f 61 64 2b memset(pPayload+
36570 6e 53 72 63 2c 20 30 2c 20 6e 50 61 79 6c 6f 61 nSrc, 0, nPayloa
36580 64 2d 6e 53 72 63 29 3b 0a 20 20 20 20 72 65 74 d-nSrc);. ret
36590 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
365a0 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 72 }.. /* If we r
365b0 65 61 63 68 20 74 68 69 73 20 70 6f 69 6e 74 2c each this point,
365c0 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 73 it means that s
365d0 6f 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 74 65 ome of the conte
365e0 6e 74 20 77 69 6c 6c 20 6e 65 65 64 0a 20 20 2a nt will need. *
365f0 2a 20 74 6f 20 73 70 69 6c 6c 20 6f 6e 74 6f 20 * to spill onto
36600 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a overflow pages..
36610 20 20 2a 2f 0a 20 20 6d 6e 20 3d 20 70 50 61 67 */. mn = pPag
36620 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 6e e->minLocal;. n
36630 20 3d 20 6d 6e 20 2b 20 28 6e 50 61 79 6c 6f 61 = mn + (nPayloa
36640 64 20 2d 20 6d 6e 29 20 25 20 28 70 50 61 67 65 d - mn) % (pPage
36650 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
36660 65 20 2d 20 34 29 3b 0a 20 20 74 65 73 74 63 61 e - 4);. testca
36670 73 65 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 6d 61 se( n==pPage->ma
36680 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 73 74 xLocal );. test
36690 63 61 73 65 28 20 6e 3d 3d 70 50 61 67 65 2d 3e case( n==pPage->
366a0 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 maxLocal+1 );.
366b0 69 66 28 20 6e 20 3e 20 70 50 61 67 65 2d 3e 6d if( n > pPage->m
366c0 61 78 4c 6f 63 61 6c 20 29 20 6e 20 3d 20 6d 6e axLocal ) n = mn
366d0 3b 0a 20 20 73 70 61 63 65 4c 65 66 74 20 3d 20 ;. spaceLeft =
366e0 6e 3b 0a 20 20 2a 70 6e 53 69 7a 65 20 3d 20 6e n;. *pnSize = n
366f0 20 2b 20 6e 48 65 61 64 65 72 20 2b 20 34 3b 0a + nHeader + 4;.
36700 20 20 70 50 72 69 6f 72 20 3d 20 26 70 43 65 6c pPrior = &pCel
36710 6c 5b 6e 48 65 61 64 65 72 2b 6e 5d 3b 0a 20 20 l[nHeader+n];.
36720 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 30 3b 0a pToRelease = 0;.
36730 20 20 70 67 6e 6f 4f 76 66 6c 20 3d 20 30 3b 0a pgnoOvfl = 0;.
36740 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 pBt = pPage->p
36750 42 74 3b 0a 0a 20 20 2f 2a 20 41 74 20 74 68 69 Bt;.. /* At thi
36760 73 20 70 6f 69 6e 74 20 76 61 72 69 61 62 6c 65 s point variable
36770 73 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 s should be set
36780 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a as follows:. **
36790 0a 20 20 2a 2a 20 20 20 6e 50 61 79 6c 6f 61 64 . ** nPayload
367a0 20 20 20 20 20 20 20 20 20 20 20 54 6f 74 61 6c Total
367b0 20 70 61 79 6c 6f 61 64 20 73 69 7a 65 20 69 6e payload size in
367c0 20 62 79 74 65 73 0a 20 20 2a 2a 20 20 20 70 50 bytes. ** pP
367d0 61 79 6c 6f 61 64 20 20 20 20 20 20 20 20 20 20 ayload
367e0 20 42 65 67 69 6e 20 77 72 69 74 69 6e 67 20 70 Begin writing p
367f0 61 79 6c 6f 61 64 20 68 65 72 65 0a 20 20 2a 2a ayload here. **
36800 20 20 20 73 70 61 63 65 4c 65 66 74 20 20 20 20 spaceLeft
36810 20 20 20 20 20 20 53 70 61 63 65 20 61 76 61 69 Space avai
36820 6c 61 62 6c 65 20 61 74 20 70 50 61 79 6c 6f 61 lable at pPayloa
36830 64 2e 20 20 49 66 20 6e 50 61 79 6c 6f 61 64 3e d. If nPayload>
36840 73 70 61 63 65 4c 65 66 74 2c 0a 20 20 2a 2a 20 spaceLeft,. **
36850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36860 20 20 20 20 20 74 68 61 74 20 6d 65 61 6e 73 20 that means
36870 63 6f 6e 74 65 6e 74 20 6d 75 73 74 20 73 70 69 content must spi
36880 6c 6c 20 69 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 ll into overflow
36890 20 70 61 67 65 73 2e 0a 20 20 2a 2a 20 20 20 2a pages.. ** *
368a0 70 6e 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 pnSize
368b0 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 6c 6f Size of the lo
368c0 63 61 6c 20 63 65 6c 6c 20 28 6e 6f 74 20 63 6f cal cell (not co
368d0 75 6e 74 69 6e 67 20 6f 76 65 72 66 6c 6f 77 20 unting overflow
368e0 70 61 67 65 73 29 0a 20 20 2a 2a 20 20 20 70 50 pages). ** pP
368f0 72 69 6f 72 20 20 20 20 20 20 20 20 20 20 20 20 rior
36900 20 57 68 65 72 65 20 74 6f 20 77 72 69 74 65 20 Where to write
36910 74 68 65 20 70 67 6e 6f 20 6f 66 20 74 68 65 20 the pgno of the
36920 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
36930 61 67 65 0a 20 20 2a 2a 0a 20 20 2a 2a 20 55 73 age. **. ** Us
36940 65 20 61 20 63 61 6c 6c 20 74 6f 20 62 74 72 65 e a call to btre
36950 65 50 61 72 73 65 43 65 6c 6c 50 74 72 28 29 20 eParseCellPtr()
36960 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 to verify that t
36970 68 65 20 76 61 6c 75 65 73 20 61 62 6f 76 65 0a he values above.
36980 20 20 2a 2a 20 77 65 72 65 20 63 6f 6d 70 75 74 ** were comput
36990 65 64 20 63 6f 72 72 65 63 74 6c 79 2e 0a 20 20 ed correctly..
369a0 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
369b0 5f 44 45 42 55 47 0a 20 20 7b 0a 20 20 20 20 43 _DEBUG. {. C
369c0 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 ellInfo info;.
369d0 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 pPage->xParseC
369e0 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c ell(pPage, pCell
369f0 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 61 73 , &info);. as
36a00 73 65 72 74 28 20 6e 48 65 61 64 65 72 3d 3d 28 sert( nHeader==(
36a10 69 6e 74 29 28 69 6e 66 6f 2e 70 50 61 79 6c 6f int)(info.pPaylo
36a20 61 64 20 2d 20 70 43 65 6c 6c 29 20 29 3b 0a 20 ad - pCell) );.
36a30 20 20 20 61 73 73 65 72 74 28 20 69 6e 66 6f 2e assert( info.
36a40 6e 4b 65 79 3d 3d 70 58 2d 3e 6e 4b 65 79 20 29 nKey==pX->nKey )
36a50 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 ;. assert( *p
36a60 6e 53 69 7a 65 20 3d 3d 20 69 6e 66 6f 2e 6e 53 nSize == info.nS
36a70 69 7a 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ize );. asser
36a80 74 28 20 73 70 61 63 65 4c 65 66 74 20 3d 3d 20 t( spaceLeft ==
36a90 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 29 3b 0a 20 info.nLocal );.
36aa0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 }.#endif.. /*
36ab0 57 72 69 74 65 20 74 68 65 20 70 61 79 6c 6f 61 Write the payloa
36ac0 64 20 69 6e 74 6f 20 74 68 65 20 6c 6f 63 61 6c d into the local
36ad0 20 43 65 6c 6c 20 61 6e 64 20 61 6e 79 20 65 78 Cell and any ex
36ae0 74 72 61 20 69 6e 74 6f 20 6f 76 65 72 66 6c 6f tra into overflo
36af0 77 20 70 61 67 65 73 20 2a 2f 0a 20 20 77 68 69 w pages */. whi
36b00 6c 65 28 20 31 20 29 7b 0a 20 20 20 20 6e 20 3d le( 1 ){. n =
36b10 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 20 20 69 nPayload;. i
36b20 66 28 20 6e 3e 73 70 61 63 65 4c 65 66 74 20 29 f( n>spaceLeft )
36b30 20 6e 20 3d 20 73 70 61 63 65 4c 65 66 74 3b 0a n = spaceLeft;.
36b40 0a 20 20 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 . /* If pToRe
36b50 6c 65 61 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 lease is not zer
36b60 6f 20 74 68 61 6e 20 70 50 61 79 6c 6f 61 64 20 o than pPayload
36b70 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 68 65 20 points into the
36b80 64 61 74 61 20 61 72 65 61 0a 20 20 20 20 2a 2a data area. **
36b90 20 6f 66 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 of pToRelease.
36ba0 20 4d 61 6b 65 20 73 75 72 65 20 70 54 6f 52 65 Make sure pToRe
36bb0 6c 65 61 73 65 20 69 73 20 73 74 69 6c 6c 20 77 lease is still w
36bc0 72 69 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 riteable. */.
36bd0 20 61 73 73 65 72 74 28 20 70 54 6f 52 65 6c 65 assert( pToRele
36be0 61 73 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 ase==0 || sqlite
36bf0 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
36c00 65 28 70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 e(pToRelease->pD
36c10 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 2f bPage) );.. /
36c20 2a 20 49 66 20 70 50 61 79 6c 6f 61 64 20 69 73 * If pPayload is
36c30 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 part of the dat
36c40 61 20 61 72 65 61 20 6f 66 20 70 50 61 67 65 2c a area of pPage,
36c50 20 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 then make sure
36c60 70 50 61 67 65 0a 20 20 20 20 2a 2a 20 69 73 20 pPage. ** is
36c70 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 still writeable
36c80 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
36c90 50 61 79 6c 6f 61 64 3c 70 50 61 67 65 2d 3e 61 Payload<pPage->a
36ca0 44 61 74 61 20 7c 7c 20 70 50 61 79 6c 6f 61 64 Data || pPayload
36cb0 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b >=&pPage->aData[
36cc0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 pBt->pageSize].
36cd0 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 || sq
36ce0 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
36cf0 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
36d00 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 69 66 Page) );.. if
36d10 28 20 6e 53 72 63 3e 3d 6e 20 29 7b 0a 20 20 20 ( nSrc>=n ){.
36d20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f memcpy(pPaylo
36d30 61 64 2c 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 ad, pSrc, n);.
36d40 20 20 7d 65 6c 73 65 20 69 66 28 20 6e 53 72 63 }else if( nSrc
36d50 3e 30 20 29 7b 0a 20 20 20 20 20 20 6e 20 3d 20 >0 ){. n =
36d60 6e 53 72 63 3b 0a 20 20 20 20 20 20 6d 65 6d 63 nSrc;. memc
36d70 70 79 28 70 50 61 79 6c 6f 61 64 2c 20 70 53 72 py(pPayload, pSr
36d80 63 2c 20 6e 29 3b 0a 20 20 20 20 7d 65 6c 73 65 c, n);. }else
36d90 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70 {. memset(p
36da0 50 61 79 6c 6f 61 64 2c 20 30 2c 20 6e 29 3b 0a Payload, 0, n);.
36db0 20 20 20 20 7d 0a 20 20 20 20 6e 50 61 79 6c 6f }. nPaylo
36dc0 61 64 20 2d 3d 20 6e 3b 0a 20 20 20 20 69 66 28 ad -= n;. if(
36dd0 20 6e 50 61 79 6c 6f 61 64 3c 3d 30 20 29 20 62 nPayload<=0 ) b
36de0 72 65 61 6b 3b 0a 20 20 20 20 70 50 61 79 6c 6f reak;. pPaylo
36df0 61 64 20 2b 3d 20 6e 3b 0a 20 20 20 20 70 53 72 ad += n;. pSr
36e00 63 20 2b 3d 20 6e 3b 0a 20 20 20 20 6e 53 72 63 c += n;. nSrc
36e10 20 2d 3d 20 6e 3b 0a 20 20 20 20 73 70 61 63 65 -= n;. space
36e20 4c 65 66 74 20 2d 3d 20 6e 3b 0a 20 20 20 20 69 Left -= n;. i
36e30 66 28 20 73 70 61 63 65 4c 65 66 74 3d 3d 30 20 f( spaceLeft==0
36e40 29 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 ){. MemPage
36e50 20 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 23 69 66 *pOvfl = 0;.#if
36e60 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
36e70 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
36e80 20 20 50 67 6e 6f 20 70 67 6e 6f 50 74 72 6d 61 Pgno pgnoPtrma
36e90 70 20 3d 20 70 67 6e 6f 4f 76 66 6c 3b 20 2f 2a p = pgnoOvfl; /*
36ea0 20 4f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 70 Overflow page p
36eb0 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 79 ointer-map entry
36ec0 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 69 page */. i
36ed0 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 f( pBt->autoVacu
36ee0 75 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 64 6f um ){. do
36ef0 7b 0a 20 20 20 20 20 20 20 20 20 20 70 67 6e 6f {. pgno
36f00 4f 76 66 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 Ovfl++;.
36f10 7d 20 77 68 69 6c 65 28 20 0a 20 20 20 20 20 20 } while( .
36f20 20 20 20 20 50 54 52 4d 41 50 5f 49 53 50 41 47 PTRMAP_ISPAG
36f30 45 28 70 42 74 2c 20 70 67 6e 6f 4f 76 66 6c 29 E(pBt, pgnoOvfl)
36f40 20 7c 7c 20 70 67 6e 6f 4f 76 66 6c 3d 3d 50 45 || pgnoOvfl==PE
36f50 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
36f60 70 42 74 29 20 0a 20 20 20 20 20 20 20 20 29 3b pBt) . );
36f70 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a . }.#endif.
36f80 20 20 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 rc = alloc
36f90 61 74 65 42 74 72 65 65 50 61 67 65 28 70 42 74 ateBtreePage(pBt
36fa0 2c 20 26 70 4f 76 66 6c 2c 20 26 70 67 6e 6f 4f , &pOvfl, &pgnoO
36fb0 76 66 6c 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 30 vfl, pgnoOvfl, 0
36fc0 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
36fd0 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
36fe0 4d 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 M. /* If th
36ff0 65 20 64 61 74 61 62 61 73 65 20 73 75 70 70 6f e database suppo
37000 72 74 73 20 61 75 74 6f 2d 76 61 63 75 75 6d 2c rts auto-vacuum,
37010 20 61 6e 64 20 74 68 65 20 73 65 63 6f 6e 64 20 and the second
37020 6f 72 20 73 75 62 73 65 71 75 65 6e 74 0a 20 20 or subsequent.
37030 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 20 ** overflow
37040 70 61 67 65 20 69 73 20 62 65 69 6e 67 20 61 6c page is being al
37050 6c 6f 63 61 74 65 64 2c 20 61 64 64 20 61 6e 20 located, add an
37060 65 6e 74 72 79 20 74 6f 20 74 68 65 20 70 6f 69 entry to the poi
37070 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 20 20 2a nter-map. *
37080 2a 20 66 6f 72 20 74 68 61 74 20 70 61 67 65 20 * for that page
37090 6e 6f 77 2e 20 0a 20 20 20 20 20 20 2a 2a 0a 20 now. . **.
370a0 20 20 20 20 20 2a 2a 20 49 66 20 74 68 69 73 20 ** If this
370b0 69 73 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 is the first ove
370c0 72 66 6c 6f 77 20 70 61 67 65 2c 20 74 68 65 6e rflow page, then
370d0 20 77 72 69 74 65 20 61 20 70 61 72 74 69 61 6c write a partial
370e0 20 65 6e 74 72 79 20 0a 20 20 20 20 20 20 2a 2a entry . **
370f0 20 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d to the pointer-
37100 6d 61 70 2e 20 49 66 20 77 65 20 77 72 69 74 65 map. If we write
37110 20 6e 6f 74 68 69 6e 67 20 74 6f 20 74 68 69 73 nothing to this
37120 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 73 6c 6f pointer-map slo
37130 74 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 6e t,. ** then
37140 20 74 68 65 20 6f 70 74 69 6d 69 73 74 69 63 20 the optimistic
37150 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 20 70 overflow chain p
37160 72 6f 63 65 73 73 69 6e 67 20 69 6e 20 63 6c 65 rocessing in cle
37170 61 72 43 65 6c 6c 28 29 0a 20 20 20 20 20 20 2a arCell(). *
37180 2a 20 6d 61 79 20 6d 69 73 69 6e 74 65 72 70 72 * may misinterpr
37190 65 74 20 74 68 65 20 75 6e 69 6e 69 74 69 61 6c et the uninitial
371a0 69 7a 65 64 20 76 61 6c 75 65 73 20 61 6e 64 20 ized values and
371b0 64 65 6c 65 74 65 20 74 68 65 0a 20 20 20 20 20 delete the.
371c0 20 2a 2a 20 77 72 6f 6e 67 20 70 61 67 65 73 20 ** wrong pages
371d0 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
371e0 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 e.. */.
371f0 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 if( pBt->autoV
37200 61 63 75 75 6d 20 26 26 20 72 63 3d 3d 53 51 4c acuum && rc==SQL
37210 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
37220 20 20 75 38 20 65 54 79 70 65 20 3d 20 28 70 67 u8 eType = (pg
37230 6e 6f 50 74 72 6d 61 70 3f 50 54 52 4d 41 50 5f noPtrmap?PTRMAP_
37240 4f 56 45 52 46 4c 4f 57 32 3a 50 54 52 4d 41 50 OVERFLOW2:PTRMAP
37250 5f 4f 56 45 52 46 4c 4f 57 31 29 3b 0a 20 20 20 _OVERFLOW1);.
37260 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 ptrmapPut(p
37270 42 74 2c 20 70 67 6e 6f 4f 76 66 6c 2c 20 65 54 Bt, pgnoOvfl, eT
37280 79 70 65 2c 20 70 67 6e 6f 50 74 72 6d 61 70 2c ype, pgnoPtrmap,
37290 20 26 72 63 29 3b 0a 20 20 20 20 20 20 20 20 69 &rc);. i
372a0 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
372b0 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 releasePage(p
372c0 4f 76 66 6c 29 3b 0a 20 20 20 20 20 20 20 20 7d Ovfl);. }
372d0 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a . }.#endif.
372e0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
372f0 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
37300 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 3b age(pToRelease);
37310 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
37320 72 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 rc;. }..
37330 20 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 /* If pToRele
37340 61 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 ase is not zero
37350 74 68 61 6e 20 70 50 72 69 6f 72 20 70 6f 69 6e than pPrior poin
37360 74 73 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 ts into the data
37370 20 61 72 65 61 0a 20 20 20 20 20 20 2a 2a 20 6f area. ** o
37380 66 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d f pToRelease. M
37390 61 6b 65 20 73 75 72 65 20 70 54 6f 52 65 6c 65 ake sure pToRele
373a0 61 73 65 20 69 73 20 73 74 69 6c 6c 20 77 72 69 ase is still wri
373b0 74 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 20 teable. */.
373c0 20 61 73 73 65 72 74 28 20 70 54 6f 52 65 6c 65 assert( pToRele
373d0 61 73 65 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 ase==0 || sqlite
373e0 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
373f0 65 28 70 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 e(pToRelease->pD
37400 62 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 bPage) );..
37410 20 2f 2a 20 49 66 20 70 50 72 69 6f 72 20 69 73 /* If pPrior is
37420 20 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 part of the dat
37430 61 20 61 72 65 61 20 6f 66 20 70 50 61 67 65 2c a area of pPage,
37440 20 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 then make sure
37450 70 50 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 pPage. ** i
37460 73 20 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c s still writeabl
37470 65 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 e */. asser
37480 74 28 20 70 50 72 69 6f 72 3c 70 50 61 67 65 2d t( pPrior<pPage-
37490 3e 61 44 61 74 61 20 7c 7c 20 70 50 72 69 6f 72 >aData || pPrior
374a0 3e 3d 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b >=&pPage->aData[
374b0 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 pBt->pageSize].
374c0 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 || sq
374d0 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
374e0 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
374f0 50 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 Page) );..
37500 70 75 74 34 62 79 74 65 28 70 50 72 69 6f 72 2c put4byte(pPrior,
37510 20 70 67 6e 6f 4f 76 66 6c 29 3b 0a 20 20 20 20 pgnoOvfl);.
37520 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 releasePage(pT
37530 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 oRelease);.
37540 20 70 54 6f 52 65 6c 65 61 73 65 20 3d 20 70 4f pToRelease = pO
37550 76 66 6c 3b 0a 20 20 20 20 20 20 70 50 72 69 6f vfl;. pPrio
37560 72 20 3d 20 70 4f 76 66 6c 2d 3e 61 44 61 74 61 r = pOvfl->aData
37570 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
37580 28 70 50 72 69 6f 72 2c 20 30 29 3b 0a 20 20 20 (pPrior, 0);.
37590 20 20 20 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 pPayload = &p
375a0 4f 76 66 6c 2d 3e 61 44 61 74 61 5b 34 5d 3b 0a Ovfl->aData[4];.
375b0 20 20 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 spaceLeft
375c0 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
375d0 65 20 2d 20 34 3b 0a 20 20 20 20 7d 0a 20 20 7d e - 4;. }. }
375e0 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 . releasePage(p
375f0 54 6f 52 65 6c 65 61 73 65 29 3b 0a 20 20 72 65 ToRelease);. re
37600 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
37610 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 }../*.** Remove
37620 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 66 72 the i-th cell fr
37630 6f 6d 20 70 50 61 67 65 2e 20 20 54 68 69 73 20 om pPage. This
37640 72 6f 75 74 69 6e 65 20 65 66 66 65 63 74 73 20 routine effects
37650 70 50 61 67 65 20 6f 6e 6c 79 2e 0a 2a 2a 20 54 pPage only..** T
37660 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 he cell content
37670 69 73 20 6e 6f 74 20 66 72 65 65 64 20 6f 72 20 is not freed or
37680 64 65 61 6c 6c 6f 63 61 74 65 64 2e 20 20 49 74 deallocated. It
37690 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 is assumed that
376a0 0a 2a 2a 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e .** the cell con
376b0 74 65 6e 74 20 68 61 73 20 62 65 65 6e 20 63 6f tent has been co
376c0 70 69 65 64 20 73 6f 6d 65 70 6c 61 63 65 20 65 pied someplace e
376d0 6c 73 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 lse. This routi
376e0 6e 65 20 6a 75 73 74 0a 2a 2a 20 72 65 6d 6f 76 ne just.** remov
376f0 65 73 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 es the reference
37700 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 66 72 6f to the cell fro
37710 6d 20 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 22 m pPage..**.** "
37720 73 7a 22 20 6d 75 73 74 20 62 65 20 74 68 65 20 sz" must be the
37730 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
37740 69 6e 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2f 0a in the cell..*/.
37750 73 74 61 74 69 63 20 76 6f 69 64 20 64 72 6f 70 static void drop
37760 43 65 6c 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 Cell(MemPage *pP
37770 61 67 65 2c 20 69 6e 74 20 69 64 78 2c 20 69 6e age, int idx, in
37780 74 20 73 7a 2c 20 69 6e 74 20 2a 70 52 43 29 7b t sz, int *pRC){
37790 0a 20 20 75 33 32 20 70 63 3b 20 20 20 20 20 20 . u32 pc;
377a0 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 /* Offset to
377b0 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 6f 66 20 cell content of
377c0 63 65 6c 6c 20 62 65 69 6e 67 20 64 65 6c 65 74 cell being delet
377d0 65 64 20 2a 2f 0a 20 20 75 38 20 2a 64 61 74 61 ed */. u8 *data
377e0 3b 20 20 20 20 20 20 20 2f 2a 20 70 50 61 67 65 ; /* pPage
377f0 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 75 38 20 ->aData */. u8
37800 2a 70 74 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 *ptr; /*
37810 55 73 65 64 20 74 6f 20 6d 6f 76 65 20 62 79 74 Used to move byt
37820 65 73 20 61 72 6f 75 6e 64 20 77 69 74 68 69 6e es around within
37830 20 64 61 74 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 data[] */. int
37840 20 72 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 rc; /*
37850 54 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 The return code
37860 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 20 */. int hdr;
37870 20 20 20 20 20 2f 2a 20 42 65 67 69 6e 6e 69 6e /* Beginnin
37880 67 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 2e g of the header.
37890 20 20 30 20 6d 6f 73 74 20 70 61 67 65 73 2e 20 0 most pages.
378a0 20 31 30 30 20 70 61 67 65 20 31 20 2a 2f 0a 0a 100 page 1 */..
378b0 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 74 if( *pRC ) ret
378c0 75 72 6e 3b 0a 20 20 61 73 73 65 72 74 28 20 69 urn;. assert( i
378d0 64 78 3e 3d 30 20 26 26 20 69 64 78 3c 70 50 61 dx>=0 && idx<pPa
378e0 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 ge->nCell );. a
378f0 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 ssert( CORRUPT_D
37900 42 20 7c 7c 20 73 7a 3d 3d 63 65 6c 6c 53 69 7a B || sz==cellSiz
37910 65 28 70 50 61 67 65 2c 20 69 64 78 29 20 29 3b e(pPage, idx) );
37920 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
37930 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
37940 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
37950 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
37960 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
37970 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d ld(pPage->pBt->m
37980 75 74 65 78 29 20 29 3b 0a 20 20 64 61 74 61 20 utex) );. data
37990 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a = pPage->aData;.
379a0 20 20 70 74 72 20 3d 20 26 70 50 61 67 65 2d 3e ptr = &pPage->
379b0 61 43 65 6c 6c 49 64 78 5b 32 2a 69 64 78 5d 3b aCellIdx[2*idx];
379c0 0a 20 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 . pc = get2byte
379d0 28 70 74 72 29 3b 0a 20 20 68 64 72 20 3d 20 70 (ptr);. hdr = p
379e0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b Page->hdrOffset;
379f0 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d . testcase( pc=
37a00 3d 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b =get2byte(&data[
37a10 68 64 72 2b 35 5d 29 20 29 3b 0a 20 20 74 65 73 hdr+5]) );. tes
37a20 74 63 61 73 65 28 20 70 63 2b 73 7a 3d 3d 70 50 tcase( pc+sz==pP
37a30 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 age->pBt->usable
37a40 53 69 7a 65 20 29 3b 0a 20 20 69 66 28 20 70 63 Size );. if( pc
37a50 2b 73 7a 20 3e 20 70 50 61 67 65 2d 3e 70 42 74 +sz > pPage->pBt
37a60 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a ->usableSize ){.
37a70 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 54 *pRC = SQLIT
37a80 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
37a90 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a return;. }.
37aa0 20 20 72 63 20 3d 20 66 72 65 65 53 70 61 63 65 rc = freeSpace
37ab0 28 70 50 61 67 65 2c 20 70 63 2c 20 73 7a 29 3b (pPage, pc, sz);
37ac0 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 . if( rc ){.
37ad0 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 *pRC = rc;.
37ae0 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 70 50 return;. }. pP
37af0 61 67 65 2d 3e 6e 43 65 6c 6c 2d 2d 3b 0a 20 20 age->nCell--;.
37b00 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c if( pPage->nCell
37b10 3d 3d 30 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 ==0 ){. memse
37b20 74 28 26 64 61 74 61 5b 68 64 72 2b 31 5d 2c 20 t(&data[hdr+1],
37b30 30 2c 20 34 29 3b 0a 20 20 20 20 64 61 74 61 5b 0, 4);. data[
37b40 68 64 72 2b 37 5d 20 3d 20 30 3b 0a 20 20 20 20 hdr+7] = 0;.
37b50 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
37b60 64 72 2b 35 5d 2c 20 70 50 61 67 65 2d 3e 70 42 dr+5], pPage->pB
37b70 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a t->usableSize);.
37b80 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 pPage->nFree
37b90 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 = pPage->pBt->u
37ba0 73 61 62 6c 65 53 69 7a 65 20 2d 20 70 50 61 67 sableSize - pPag
37bb0 65 2d 3e 68 64 72 4f 66 66 73 65 74 0a 20 20 20 e->hdrOffset.
37bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
37bd0 20 20 20 20 2d 20 70 50 61 67 65 2d 3e 63 68 69 - pPage->chi
37be0 6c 64 50 74 72 53 69 7a 65 20 2d 20 38 3b 0a 20 ldPtrSize - 8;.
37bf0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6d 65 6d 6d }else{. memm
37c00 6f 76 65 28 70 74 72 2c 20 70 74 72 2b 32 2c 20 ove(ptr, ptr+2,
37c10 32 2a 28 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 2*(pPage->nCell
37c20 2d 20 69 64 78 29 29 3b 0a 20 20 20 20 70 75 74 - idx));. put
37c30 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
37c40 33 5d 2c 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3], pPage->nCell
37c50 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6e 46 );. pPage->nF
37c60 72 65 65 20 2b 3d 20 32 3b 0a 20 20 7d 0a 7d 0a ree += 2;. }.}.
37c70 0a 2f 2a 0a 2a 2a 20 49 6e 73 65 72 74 20 61 20 ./*.** Insert a
37c80 6e 65 77 20 63 65 6c 6c 20 6f 6e 20 70 50 61 67 new cell on pPag
37c90 65 20 61 74 20 63 65 6c 6c 20 69 6e 64 65 78 20 e at cell index
37ca0 22 69 22 2e 20 20 70 43 65 6c 6c 20 70 6f 69 6e "i". pCell poin
37cb0 74 73 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 6e ts to the.** con
37cc0 74 65 6e 74 20 6f 66 20 74 68 65 20 63 65 6c 6c tent of the cell
37cd0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 ..**.** If the c
37ce0 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 77 69 6c 6c ell content will
37cf0 20 66 69 74 20 6f 6e 20 74 68 65 20 70 61 67 65 fit on the page
37d00 2c 20 74 68 65 6e 20 70 75 74 20 69 74 20 74 68 , then put it th
37d10 65 72 65 2e 20 20 49 66 20 69 74 0a 2a 2a 20 77 ere. If it.** w
37d20 69 6c 6c 20 6e 6f 74 20 66 69 74 2c 20 74 68 65 ill not fit, the
37d30 6e 20 6d 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 n make a copy of
37d40 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e the cell conten
37d50 74 20 69 6e 74 6f 20 70 54 65 6d 70 20 69 66 0a t into pTemp if.
37d60 2a 2a 20 70 54 65 6d 70 20 69 73 20 6e 6f 74 20 ** pTemp is not
37d70 6e 75 6c 6c 2e 20 20 52 65 67 61 72 64 6c 65 73 null. Regardles
37d80 73 20 6f 66 20 70 54 65 6d 70 2c 20 61 6c 6c 6f s of pTemp, allo
37d90 63 61 74 65 20 61 20 6e 65 77 20 65 6e 74 72 79 cate a new entry
37da0 0a 2a 2a 20 69 6e 20 70 50 61 67 65 2d 3e 61 70 .** in pPage->ap
37db0 4f 76 66 6c 5b 5d 20 61 6e 64 20 6d 61 6b 65 20 Ovfl[] and make
37dc0 69 74 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 it point to the
37dd0 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 28 65 69 cell content (ei
37de0 74 68 65 72 0a 2a 2a 20 69 6e 20 70 54 65 6d 70 ther.** in pTemp
37df0 20 6f 72 20 74 68 65 20 6f 72 69 67 69 6e 61 6c or the original
37e00 20 70 43 65 6c 6c 29 20 61 6e 64 20 61 6c 73 6f pCell) and also
37e10 20 72 65 63 6f 72 64 20 69 74 73 20 69 6e 64 65 record its inde
37e20 78 2e 20 0a 2a 2a 20 41 6c 6c 6f 63 61 74 69 6e x. .** Allocatin
37e30 67 20 61 20 6e 65 77 20 65 6e 74 72 79 20 69 6e g a new entry in
37e40 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c 5b 5d 20 pPage->aCell[]
37e50 69 6d 70 6c 69 65 73 20 74 68 61 74 20 0a 2a 2a implies that .**
37e60 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
37e70 77 20 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 w is incremented
37e80 2e 0a 2a 2a 0a 2a 2a 20 2a 70 52 43 20 6d 75 73 ..**.** *pRC mus
37e90 74 20 62 65 20 53 51 4c 49 54 45 5f 4f 4b 20 77 t be SQLITE_OK w
37ea0 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 hen this routine
37eb0 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 is called..*/.s
37ec0 74 61 74 69 63 20 76 6f 69 64 20 69 6e 73 65 72 tatic void inser
37ed0 74 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 tCell(. MemPage
37ee0 20 2a 70 50 61 67 65 2c 20 20 20 2f 2a 20 50 61 *pPage, /* Pa
37ef0 67 65 20 69 6e 74 6f 20 77 68 69 63 68 20 77 65 ge into which we
37f00 20 61 72 65 20 63 6f 70 79 69 6e 67 20 2a 2f 0a are copying */.
37f10 20 20 69 6e 74 20 69 2c 20 20 20 20 20 20 20 20 int i,
37f20 20 20 20 20 2f 2a 20 4e 65 77 20 63 65 6c 6c 20 /* New cell
37f30 62 65 63 6f 6d 65 73 20 74 68 65 20 69 2d 74 68 becomes the i-th
37f40 20 63 65 6c 6c 20 6f 66 20 74 68 65 20 70 61 67 cell of the pag
37f50 65 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c e */. u8 *pCell
37f60 2c 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 , /* Cont
37f70 65 6e 74 20 6f 66 20 74 68 65 20 6e 65 77 20 63 ent of the new c
37f80 65 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 2c ell */. int sz,
37f90 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 79 /* By
37fa0 74 65 73 20 6f 66 20 63 6f 6e 74 65 6e 74 20 69 tes of content i
37fb0 6e 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 n pCell */. u8
37fc0 2a 70 54 65 6d 70 2c 20 20 20 20 20 20 20 20 2f *pTemp, /
37fd0 2a 20 54 65 6d 70 20 73 74 6f 72 61 67 65 20 73 * Temp storage s
37fe0 70 61 63 65 20 66 6f 72 20 70 43 65 6c 6c 2c 20 pace for pCell,
37ff0 69 66 20 6e 65 65 64 65 64 20 2a 2f 0a 20 20 50 if needed */. P
38000 67 6e 6f 20 69 43 68 69 6c 64 2c 20 20 20 20 20 gno iChild,
38010 20 2f 2a 20 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c /* If non-zero,
38020 20 72 65 70 6c 61 63 65 20 66 69 72 73 74 20 34 replace first 4
38030 20 62 79 74 65 73 20 77 69 74 68 20 74 68 69 73 bytes with this
38040 20 76 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20 value */. int
38050 2a 70 52 43 20 20 20 20 20 20 20 20 20 20 2f 2a *pRC /*
38060 20 52 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 Read and write
38070 72 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d return code from
38080 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
38090 74 20 69 64 78 20 3d 20 30 3b 20 20 20 20 20 20 t idx = 0;
380a0 2f 2a 20 57 68 65 72 65 20 74 6f 20 77 72 69 74 /* Where to writ
380b0 65 20 6e 65 77 20 63 65 6c 6c 20 63 6f 6e 74 65 e new cell conte
380c0 6e 74 20 69 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a nt in data[] */.
380d0 20 20 69 6e 74 20 6a 3b 20 20 20 20 20 20 20 20 int j;
380e0 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
380f0 74 65 72 20 2a 2f 0a 20 20 75 38 20 2a 64 61 74 ter */. u8 *dat
38100 61 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 a; /* Th
38110 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 e content of the
38120 20 77 68 6f 6c 65 20 70 61 67 65 20 2a 2f 0a 20 whole page */.
38130 20 75 38 20 2a 70 49 6e 73 3b 20 20 20 20 20 20 u8 *pIns;
38140 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 20 /* The point
38150 69 6e 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 in pPage->aCellI
38160 64 78 5b 5d 20 77 68 65 72 65 20 6e 6f 20 63 65 dx[] where no ce
38170 6c 6c 20 69 6e 73 65 72 74 65 64 20 2a 2f 0a 0a ll inserted */..
38180 20 20 61 73 73 65 72 74 28 20 2a 70 52 43 3d 3d assert( *pRC==
38190 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 61 SQLITE_OK );. a
381a0 73 73 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69 ssert( i>=0 && i
381b0 3c 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 70 <=pPage->nCell+p
381c0 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 Page->nOverflow
381d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 4d 58 5f );. assert( MX_
381e0 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 CELL(pPage->pBt)
381f0 3c 3d 31 30 39 32 31 20 29 3b 0a 20 20 61 73 73 <=10921 );. ass
38200 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c ert( pPage->nCel
38210 6c 3c 3d 4d 58 5f 43 45 4c 4c 28 70 50 61 67 65 l<=MX_CELL(pPage
38220 2d 3e 70 42 74 29 20 7c 7c 20 43 4f 52 52 55 50 ->pBt) || CORRUP
38230 54 5f 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 T_DB );. assert
38240 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c ( pPage->nOverfl
38250 6f 77 3c 3d 41 72 72 61 79 53 69 7a 65 28 70 50 ow<=ArraySize(pP
38260 61 67 65 2d 3e 61 70 4f 76 66 6c 29 20 29 3b 0a age->apOvfl) );.
38270 20 20 61 73 73 65 72 74 28 20 41 72 72 61 79 53 assert( ArrayS
38280 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 4f 76 66 ize(pPage->apOvf
38290 6c 29 3d 3d 41 72 72 61 79 53 69 7a 65 28 70 50 l)==ArraySize(pP
382a0 61 67 65 2d 3e 61 69 4f 76 66 6c 29 20 29 3b 0a age->aiOvfl) );.
382b0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
382c0 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
382d0 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
382e0 29 3b 0a 20 20 2f 2a 20 54 68 65 20 63 65 6c 6c );. /* The cell
382f0 20 73 68 6f 75 6c 64 20 6e 6f 72 6d 61 6c 6c 79 should normally
38300 20 62 65 20 73 69 7a 65 64 20 63 6f 72 72 65 63 be sized correc
38310 74 6c 79 2e 20 20 48 6f 77 65 76 65 72 2c 20 77 tly. However, w
38320 68 65 6e 20 6d 6f 76 69 6e 67 20 61 0a 20 20 2a hen moving a. *
38330 2a 20 6d 61 6c 66 6f 72 6d 65 64 20 63 65 6c 6c * malformed cell
38340 20 66 72 6f 6d 20 61 20 6c 65 61 66 20 70 61 67 from a leaf pag
38350 65 20 74 6f 20 61 6e 20 69 6e 74 65 72 69 6f 72 e to an interior
38360 20 70 61 67 65 2c 20 69 66 20 74 68 65 20 63 65 page, if the ce
38370 6c 6c 20 73 69 7a 65 0a 20 20 2a 2a 20 77 61 6e ll size. ** wan
38380 74 65 64 20 74 6f 20 62 65 20 6c 65 73 73 20 74 ted to be less t
38390 68 61 6e 20 34 20 62 75 74 20 67 6f 74 20 72 6f han 4 but got ro
383a0 75 6e 64 65 64 20 75 70 20 74 6f 20 34 20 6f 6e unded up to 4 on
383b0 20 74 68 65 20 6c 65 61 66 2c 20 74 68 65 6e 20 the leaf, then
383c0 73 69 7a 65 0a 20 20 2a 2a 20 6d 69 67 68 74 20 size. ** might
383d0 62 65 20 6c 65 73 73 20 74 68 61 6e 20 38 20 28 be less than 8 (
383e0 6c 65 61 66 2d 73 69 7a 65 20 2b 20 70 6f 69 6e leaf-size + poin
383f0 74 65 72 29 20 6f 6e 20 74 68 65 20 69 6e 74 65 ter) on the inte
38400 72 69 6f 72 20 6e 6f 64 65 2e 20 20 48 65 6e 63 rior node. Henc
38410 65 0a 20 20 2a 2a 20 74 68 65 20 74 65 72 6d 20 e. ** the term
38420 61 66 74 65 72 20 74 68 65 20 7c 7c 20 69 6e 20 after the || in
38430 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 the following as
38440 73 65 72 74 28 29 2e 20 2a 2f 0a 20 20 61 73 73 sert(). */. ass
38450 65 72 74 28 20 73 7a 3d 3d 70 50 61 67 65 2d 3e ert( sz==pPage->
38460 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c xCellSize(pPage,
38470 20 70 43 65 6c 6c 29 20 7c 7c 20 28 73 7a 3d 3d pCell) || (sz==
38480 38 20 26 26 20 69 43 68 69 6c 64 3e 30 29 20 29 8 && iChild>0) )
38490 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e ;. if( pPage->n
384a0 4f 76 65 72 66 6c 6f 77 20 7c 7c 20 73 7a 2b 32 Overflow || sz+2
384b0 3e 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 29 7b >pPage-&g