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: 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20 2a 70 4b */. void *pK
5a40: 65 79 3b 0a 20 20 20 20 70 43 75 72 2d 3e 6e 4b ey;. pCur->nK
5a50: 65 79 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 ey = sqlite3Btre
5a60: 65 50 61 79 6c 6f 61 64 53 69 7a 65 28 70 43 75 ePayloadSize(pCu
5a70: 72 29 3b 0a 20 20 20 20 70 4b 65 79 20 3d 20 73 r);. pKey = s
5a80: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 70 43 qlite3Malloc( pC
5a90: 75 72 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 20 20 ur->nKey );.
5aa0: 69 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 20 if( pKey ){.
5ab0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 rc = sqlite3Bt
5ac0: 72 65 65 50 61 79 6c 6f 61 64 28 70 43 75 72 2c reePayload(pCur,
5ad0: 20 30 2c 20 28 69 6e 74 29 70 43 75 72 2d 3e 6e 0, (int)pCur->n
5ae0: 4b 65 79 2c 20 70 4b 65 79 29 3b 0a 20 20 20 20 Key, pKey);.
5af0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
5b00: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 70 _OK ){. p
5b10: 43 75 72 2d 3e 70 4b 65 79 20 3d 20 70 4b 65 79 Cur->pKey = pKey
5b20: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
5b30: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 sqlite3_f
5b40: 72 65 65 28 70 4b 65 79 29 3b 0a 20 20 20 20 20 ree(pKey);.
5b50: 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
5b60: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
5b70: 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 NOMEM_BKPT;.
5b80: 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 }. }. assert(
5b90: 21 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 !pCur->curIntKey
5ba0: 20 7c 7c 20 21 70 43 75 72 2d 3e 70 4b 65 79 20 || !pCur->pKey
5bb0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
5bc0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 }../*.** Save th
5bd0: 65 20 63 75 72 72 65 6e 74 20 63 75 72 73 6f 72 e current cursor
5be0: 20 70 6f 73 69 74 69 6f 6e 20 69 6e 20 74 68 65 position in the
5bf0: 20 76 61 72 69 61 62 6c 65 73 20 42 74 43 75 72 variables BtCur
5c00: 73 6f 72 2e 6e 4b 65 79 20 0a 2a 2a 20 61 6e 64 sor.nKey .** and
5c10: 20 42 74 43 75 72 73 6f 72 2e 70 4b 65 79 2e 20 BtCursor.pKey.
5c20: 54 68 65 20 63 75 72 73 6f 72 27 73 20 73 74 61 The cursor's sta
5c30: 74 65 20 69 73 20 73 65 74 20 74 6f 20 43 55 52 te is set to CUR
5c40: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 2e SOR_REQUIRESEEK.
5c50: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 .**.** The calle
5c60: 72 20 6d 75 73 74 20 65 6e 73 75 72 65 20 74 68 r must ensure th
5c70: 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 at the cursor is
5c80: 20 76 61 6c 69 64 20 28 68 61 73 20 65 53 74 61 valid (has eSta
5c90: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
5ca0: 29 0a 2a 2a 20 70 72 69 6f 72 20 74 6f 20 63 61 ).** prior to ca
5cb0: 6c 6c 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 lling this routi
5cc0: 6e 65 2e 20 20 0a 2a 2f 0a 73 74 61 74 69 63 20 ne. .*/.static
5cd0: 69 6e 74 20 73 61 76 65 43 75 72 73 6f 72 50 6f int saveCursorPo
5ce0: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
5cf0: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
5d00: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 43 55 52 ;.. assert( CUR
5d10: 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 2d SOR_VALID==pCur-
5d20: 3e 65 53 74 61 74 65 20 7c 7c 20 43 55 52 53 4f >eState || CURSO
5d30: 52 5f 53 4b 49 50 4e 45 58 54 3d 3d 70 43 75 72 R_SKIPNEXT==pCur
5d40: 2d 3e 65 53 74 61 74 65 20 29 3b 0a 20 20 61 73 ->eState );. as
5d50: 73 65 72 74 28 20 30 3d 3d 70 43 75 72 2d 3e 70 sert( 0==pCur->p
5d60: 4b 65 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 Key );. assert(
5d70: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
5d80: 78 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 69 66 x(pCur) );.. if
5d90: 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
5da0: 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 CURSOR_SKIPNEXT
5db0: 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 ){. pCur->eSt
5dc0: 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c ate = CURSOR_VAL
5dd0: 49 44 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ID;. }else{.
5de0: 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
5df0: 3d 20 30 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d = 0;. }.. rc =
5e00: 20 73 61 76 65 43 75 72 73 6f 72 4b 65 79 28 70 saveCursorKey(p
5e10: 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d Cur);. if( rc==
5e20: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
5e30: 20 62 74 72 65 65 52 65 6c 65 61 73 65 41 6c 6c btreeReleaseAll
5e40: 43 75 72 73 6f 72 50 61 67 65 73 28 70 43 75 72 CursorPages(pCur
5e50: 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 );. pCur->eSt
5e60: 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 52 45 51 ate = CURSOR_REQ
5e70: 55 49 52 45 53 45 45 4b 3b 0a 20 20 7d 0a 0a 20 UIRESEEK;. }..
5e80: 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
5e90: 26 3d 20 7e 28 42 54 43 46 5f 56 61 6c 69 64 4e &= ~(BTCF_ValidN
5ea0: 4b 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 Key|BTCF_ValidOv
5eb0: 66 6c 7c 42 54 43 46 5f 41 74 4c 61 73 74 29 3b fl|BTCF_AtLast);
5ec0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
5ed0: 0a 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 ./* Forward refe
5ee0: 72 65 6e 63 65 20 2a 2f 0a 73 74 61 74 69 63 20 rence */.static
5ef0: 69 6e 74 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c int SQLITE_NOINL
5f00: 49 4e 45 20 73 61 76 65 43 75 72 73 6f 72 73 4f INE saveCursorsO
5f10: 6e 4c 69 73 74 28 42 74 43 75 72 73 6f 72 2a 2c nList(BtCursor*,
5f20: 50 67 6e 6f 2c 42 74 43 75 72 73 6f 72 2a 29 3b Pgno,BtCursor*);
5f30: 0a 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 65 ../*.** Save the
5f40: 20 70 6f 73 69 74 69 6f 6e 73 20 6f 66 20 61 6c positions of al
5f50: 6c 20 63 75 72 73 6f 72 73 20 28 65 78 63 65 70 l cursors (excep
5f60: 74 20 70 45 78 63 65 70 74 29 20 74 68 61 74 20 t pExcept) that
5f70: 61 72 65 20 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 74 are open on.** t
5f80: 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f he table with ro
5f90: 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 2e 20 20 ot-page iRoot.
5fa0: 22 53 61 76 69 6e 67 20 74 68 65 20 63 75 72 73 "Saving the curs
5fb0: 6f 72 20 70 6f 73 69 74 69 6f 6e 22 20 6d 65 61 or position" mea
5fc0: 6e 73 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 6c ns that.** the l
5fd0: 6f 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 62 ocation in the b
5fe0: 74 72 65 65 20 69 73 20 72 65 6d 65 6d 62 65 72 tree is remember
5ff0: 65 64 20 69 6e 20 73 75 63 68 20 61 20 77 61 79 ed in such a way
6000: 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 0a that it can be.
6010: 2a 2a 20 6d 6f 76 65 64 20 62 61 63 6b 20 74 6f ** moved back to
6020: 20 74 68 65 20 73 61 6d 65 20 73 70 6f 74 20 61 the same spot a
6030: 66 74 65 72 20 74 68 65 20 62 74 72 65 65 20 68 fter the btree h
6040: 61 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 as been modified
6050: 2e 20 20 54 68 69 73 0a 2a 2a 20 72 6f 75 74 69 . This.** routi
6060: 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 6a 75 73 ne is called jus
6070: 74 20 62 65 66 6f 72 65 20 63 75 72 73 6f 72 20 t before cursor
6080: 70 45 78 63 65 70 74 20 69 73 20 75 73 65 64 20 pExcept is used
6090: 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 0a 2a 2a to modify the.**
60a0: 20 74 61 62 6c 65 2c 20 66 6f 72 20 65 78 61 6d table, for exam
60b0: 70 6c 65 20 69 6e 20 42 74 72 65 65 44 65 6c 65 ple in BtreeDele
60c0: 74 65 28 29 20 6f 72 20 42 74 72 65 65 49 6e 73 te() or BtreeIns
60d0: 65 72 74 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ert()..**.** If
60e0: 74 68 65 72 65 20 61 72 65 20 74 77 6f 20 6f 72 there are two or
60f0: 20 6d 6f 72 65 20 63 75 72 73 6f 72 73 20 6f 6e more cursors on
6100: 20 74 68 65 20 73 61 6d 65 20 62 74 72 65 65 2c the same btree,
6110: 20 74 68 65 6e 20 61 6c 6c 20 73 75 63 68 20 0a then all such .
6120: 2a 2a 20 63 75 72 73 6f 72 73 20 73 68 6f 75 6c ** cursors shoul
6130: 64 20 68 61 76 65 20 74 68 65 69 72 20 42 54 43 d have their BTC
6140: 46 5f 4d 75 6c 74 69 70 6c 65 20 66 6c 61 67 20 F_Multiple flag
6150: 73 65 74 2e 20 20 54 68 65 20 62 74 72 65 65 43 set. The btreeC
6160: 75 72 73 6f 72 28 29 0a 2a 2a 20 72 6f 75 74 69 ursor().** routi
6170: 6e 65 20 65 6e 66 6f 72 63 65 73 20 74 68 61 74 ne enforces that
6180: 20 72 75 6c 65 2e 20 20 54 68 69 73 20 72 6f 75 rule. This rou
6190: 74 69 6e 65 20 6f 6e 6c 79 20 6e 65 65 64 73 20 tine only needs
61a0: 74 6f 20 62 65 20 63 61 6c 6c 65 64 20 69 6e 0a to be called in.
61b0: 2a 2a 20 74 68 65 20 75 6e 63 6f 6d 6d 6f 6e 20 ** the uncommon
61c0: 63 61 73 65 20 77 68 65 6e 20 70 45 78 70 65 63 case when pExpec
61d0: 74 20 68 61 73 20 74 68 65 20 42 54 43 46 5f 4d t has the BTCF_M
61e0: 75 6c 74 69 70 6c 65 20 66 6c 61 67 20 73 65 74 ultiple flag set
61f0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 45 78 70 65 ..**.** If pExpe
6200: 63 74 21 3d 4e 55 4c 4c 20 61 6e 64 20 69 66 20 ct!=NULL and if
6210: 6e 6f 20 6f 74 68 65 72 20 63 75 72 73 6f 72 73 no other cursors
6220: 20 61 72 65 20 66 6f 75 6e 64 20 6f 6e 20 74 68 are found on th
6230: 65 20 73 61 6d 65 20 72 6f 6f 74 2d 70 61 67 65 e same root-page
6240: 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 42 54 ,.** then the BT
6250: 43 46 5f 4d 75 6c 74 69 70 6c 65 20 66 6c 61 67 CF_Multiple flag
6260: 20 6f 6e 20 70 45 78 70 65 63 74 20 69 73 20 63 on pExpect is c
6270: 6c 65 61 72 65 64 2c 20 74 6f 20 61 76 6f 69 64 leared, to avoid
6280: 20 61 6e 6f 74 68 65 72 0a 2a 2a 20 70 6f 69 6e another.** poin
6290: 74 6c 65 73 73 20 63 61 6c 6c 20 74 6f 20 74 68 tless call to th
62a0: 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2a 0a 2a is routine..**.*
62b0: 2a 20 49 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e * Implementation
62c0: 20 6e 6f 74 65 3a 20 20 54 68 69 73 20 72 6f 75 note: This rou
62d0: 74 69 6e 65 20 6d 65 72 65 6c 79 20 63 68 65 63 tine merely chec
62e0: 6b 73 20 74 6f 20 73 65 65 20 69 66 20 61 6e 79 ks to see if any
62f0: 20 63 75 72 73 6f 72 73 0a 2a 2a 20 6e 65 65 64 cursors.** need
6300: 20 74 6f 20 62 65 20 73 61 76 65 64 2e 20 20 49 to be saved. I
6310: 74 20 63 61 6c 6c 73 20 6f 75 74 20 74 6f 20 73 t calls out to s
6320: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
6330: 28 29 20 69 6e 20 74 68 65 20 28 75 6e 75 73 75 () in the (unusu
6340: 61 6c 29 0a 2a 2a 20 65 76 65 6e 74 20 74 68 61 al).** event tha
6350: 74 20 63 75 72 73 6f 72 73 20 61 72 65 20 69 6e t cursors are in
6360: 20 6e 65 65 64 20 74 6f 20 62 65 69 6e 67 20 73 need to being s
6370: 61 76 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 aved..*/.static
6380: 69 6e 74 20 73 61 76 65 41 6c 6c 43 75 72 73 6f int saveAllCurso
6390: 72 73 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 rs(BtShared *pBt
63a0: 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 42 74 , Pgno iRoot, Bt
63b0: 43 75 72 73 6f 72 20 2a 70 45 78 63 65 70 74 29 Cursor *pExcept)
63c0: 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b {. BtCursor *p;
63d0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
63e0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
63f0: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
6400: 73 73 65 72 74 28 20 70 45 78 63 65 70 74 3d 3d ssert( pExcept==
6410: 30 20 7c 7c 20 70 45 78 63 65 70 74 2d 3e 70 42 0 || pExcept->pB
6420: 74 3d 3d 70 42 74 20 29 3b 0a 20 20 66 6f 72 28 t==pBt );. for(
6430: 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 p=pBt->pCursor;
6440: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a p; p=p->pNext){.
6450: 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 65 if( p!=pExce
6460: 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 pt && (0==iRoot
6470: 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d || p->pgnoRoot==
6480: 69 52 6f 6f 74 29 20 29 20 62 72 65 61 6b 3b 0a iRoot) ) break;.
6490: 20 20 7d 0a 20 20 69 66 28 20 70 20 29 20 72 65 }. if( p ) re
64a0: 74 75 72 6e 20 73 61 76 65 43 75 72 73 6f 72 73 turn saveCursors
64b0: 4f 6e 4c 69 73 74 28 70 2c 20 69 52 6f 6f 74 2c OnList(p, iRoot,
64c0: 20 70 45 78 63 65 70 74 29 3b 0a 20 20 69 66 28 pExcept);. if(
64d0: 20 70 45 78 63 65 70 74 20 29 20 70 45 78 63 65 pExcept ) pExce
64e0: 70 74 2d 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 pt->curFlags &=
64f0: 7e 42 54 43 46 5f 4d 75 6c 74 69 70 6c 65 3b 0a ~BTCF_Multiple;.
6500: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
6510: 4f 4b 3b 0a 7d 0a 0a 2f 2a 20 54 68 69 73 20 68 OK;.}../* This h
6520: 65 6c 70 65 72 20 72 6f 75 74 69 6e 65 20 74 6f elper routine to
6530: 20 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 20 saveAllCursors
6540: 64 6f 65 73 20 74 68 65 20 61 63 74 75 61 6c 20 does the actual
6550: 77 6f 72 6b 20 6f 66 20 73 61 76 69 6e 67 0a 2a work of saving.*
6560: 2a 20 74 68 65 20 63 75 72 73 6f 72 73 20 69 66 * the cursors if
6570: 20 61 6e 64 20 77 68 65 6e 20 61 20 63 75 72 73 and when a curs
6580: 6f 72 20 69 73 20 66 6f 75 6e 64 20 74 68 61 74 or is found that
6590: 20 61 63 74 75 61 6c 6c 79 20 72 65 71 75 69 72 actually requir
65a0: 65 73 20 73 61 76 69 6e 67 2e 0a 2a 2a 20 54 68 es saving..** Th
65b0: 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 69 73 e common case is
65c0: 20 74 68 61 74 20 6e 6f 20 63 75 72 73 6f 72 73 that no cursors
65d0: 20 6e 65 65 64 20 74 6f 20 62 65 20 73 61 76 65 need to be save
65e0: 64 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 74 69 d, so this routi
65f0: 6e 65 20 69 73 0a 2a 2a 20 62 72 6f 6b 65 6e 20 ne is.** broken
6600: 6f 75 74 20 66 72 6f 6d 20 69 74 73 20 63 61 6c out from its cal
6610: 6c 65 72 20 74 6f 20 61 76 6f 69 64 20 75 6e 6e ler to avoid unn
6620: 65 63 65 73 73 61 72 79 20 73 74 61 63 6b 20 70 ecessary stack p
6630: 6f 69 6e 74 65 72 20 6d 6f 76 65 6d 65 6e 74 2e ointer movement.
6640: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 53 .*/.static int S
6650: 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 73 QLITE_NOINLINE s
6660: 61 76 65 43 75 72 73 6f 72 73 4f 6e 4c 69 73 74 aveCursorsOnList
6670: 28 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 2c (. BtCursor *p,
6680: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
6690: 66 69 72 73 74 20 63 75 72 73 6f 72 20 74 68 61 first cursor tha
66a0: 74 20 6e 65 65 64 73 20 73 61 76 69 6e 67 20 2a t needs saving *
66b0: 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 2c 20 /. Pgno iRoot,
66c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 6c 79 /* Only
66d0: 20 73 61 76 65 20 63 75 72 73 6f 72 20 77 69 74 save cursor wit
66e0: 68 20 74 68 69 73 20 69 52 6f 6f 74 2e 20 53 61 h this iRoot. Sa
66f0: 76 65 20 61 6c 6c 20 69 66 20 7a 65 72 6f 20 2a ve all if zero *
6700: 2f 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 45 /. BtCursor *pE
6710: 78 63 65 70 74 20 20 20 20 2f 2a 20 44 6f 20 6e xcept /* Do n
6720: 6f 74 20 73 61 76 65 20 74 68 69 73 20 63 75 72 ot save this cur
6730: 73 6f 72 20 2a 2f 0a 29 7b 0a 20 20 64 6f 7b 0a sor */.){. do{.
6740: 20 20 20 20 69 66 28 20 70 21 3d 70 45 78 63 65 if( p!=pExce
6750: 70 74 20 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 pt && (0==iRoot
6760: 7c 7c 20 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d || p->pgnoRoot==
6770: 69 52 6f 6f 74 29 20 29 7b 0a 20 20 20 20 20 20 iRoot) ){.
6780: 69 66 28 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 if( p->eState==C
6790: 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 URSOR_VALID || p
67a0: 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
67b0: 5f 53 4b 49 50 4e 45 58 54 20 29 7b 0a 20 20 20 _SKIPNEXT ){.
67c0: 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 61 int rc = sa
67d0: 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e veCursorPosition
67e0: 28 70 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 (p);. if(
67f0: 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 SQLITE_OK!=rc )
6800: 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 {. retu
6810: 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d rn rc;. }
6820: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
6830: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
6840: 70 2d 3e 69 50 61 67 65 3e 3d 30 20 29 3b 0a 20 p->iPage>=0 );.
6850: 20 20 20 20 20 20 20 62 74 72 65 65 52 65 6c 65 btreeRele
6860: 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 61 67 65 aseAllCursorPage
6870: 73 28 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 s(p);. }.
6880: 20 20 7d 0a 20 20 20 20 70 20 3d 20 70 2d 3e 70 }. p = p->p
6890: 4e 65 78 74 3b 0a 20 20 7d 77 68 69 6c 65 28 20 Next;. }while(
68a0: 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 p );. return SQ
68b0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
68c0: 2a 20 43 6c 65 61 72 20 74 68 65 20 63 75 72 72 * Clear the curr
68d0: 65 6e 74 20 63 75 72 73 6f 72 20 70 6f 73 69 74 ent cursor posit
68e0: 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c ion..*/.void sql
68f0: 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 ite3BtreeClearCu
6900: 72 73 6f 72 28 42 74 43 75 72 73 6f 72 20 2a 70 rsor(BtCursor *p
6910: 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 Cur){. assert(
6920: 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
6930: 28 70 43 75 72 29 20 29 3b 0a 20 20 73 71 6c 69 (pCur) );. sqli
6940: 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 te3_free(pCur->p
6950: 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d 3e 70 4b Key);. pCur->pK
6960: 65 79 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ey = 0;. pCur->
6970: 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f eState = CURSOR_
6980: 49 4e 56 41 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a INVALID;.}../*.*
6990: 2a 20 49 6e 20 74 68 69 73 20 76 65 72 73 69 6f * In this versio
69a0: 6e 20 6f 66 20 42 74 72 65 65 4d 6f 76 65 74 6f n of BtreeMoveto
69b0: 2c 20 70 4b 65 79 20 69 73 20 61 20 70 61 63 6b , pKey is a pack
69c0: 65 64 20 69 6e 64 65 78 20 72 65 63 6f 72 64 0a ed index record.
69d0: 2a 2a 20 73 75 63 68 20 61 73 20 69 73 20 67 65 ** such as is ge
69e0: 6e 65 72 61 74 65 64 20 62 79 20 74 68 65 20 4f nerated by the O
69f0: 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 P_MakeRecord opc
6a00: 6f 64 65 2e 20 20 55 6e 70 61 63 6b 20 74 68 65 ode. Unpack the
6a10: 0a 2a 2a 20 72 65 63 6f 72 64 20 61 6e 64 20 74 .** record and t
6a20: 68 65 6e 20 63 61 6c 6c 20 42 74 72 65 65 4d 6f hen call BtreeMo
6a30: 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 29 20 74 vetoUnpacked() t
6a40: 6f 20 64 6f 20 74 68 65 20 77 6f 72 6b 2e 0a 2a o do the work..*
6a50: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 /.static int btr
6a60: 65 65 4d 6f 76 65 74 6f 28 0a 20 20 42 74 43 75 eeMoveto(. BtCu
6a70: 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 rsor *pCur,
6a80: 2f 2a 20 43 75 72 73 6f 72 20 6f 70 65 6e 20 6f /* Cursor open o
6a90: 6e 20 74 68 65 20 62 74 72 65 65 20 74 6f 20 62 n the btree to b
6aa0: 65 20 73 65 61 72 63 68 65 64 20 2a 2f 0a 20 20 e searched */.
6ab0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 const void *pKey
6ac0: 2c 20 20 20 2f 2a 20 50 61 63 6b 65 64 20 6b 65 , /* Packed ke
6ad0: 79 20 69 66 20 74 68 65 20 62 74 72 65 65 20 69 y if the btree i
6ae0: 73 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 20 20 s an index */.
6af0: 69 36 34 20 6e 4b 65 79 2c 20 20 20 20 20 20 20 i64 nKey,
6b00: 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 6b /* Integer k
6b10: 65 79 20 66 6f 72 20 74 61 62 6c 65 73 2e 20 20 ey for tables.
6b20: 53 69 7a 65 20 6f 66 20 70 4b 65 79 20 66 6f 72 Size of pKey for
6b30: 20 69 6e 64 69 63 65 73 20 2a 2f 0a 20 20 69 6e indices */. in
6b40: 74 20 62 69 61 73 2c 20 20 20 20 20 20 20 20 20 t bias,
6b50: 20 20 2f 2a 20 42 69 61 73 20 73 65 61 72 63 68 /* Bias search
6b60: 20 74 6f 20 74 68 65 20 68 69 67 68 20 65 6e 64 to the high end
6b70: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 */. int *pRes
6b80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 /* Wri
6b90: 74 65 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 te search result
6ba0: 73 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 s here */.){. i
6bb0: 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
6bc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 61 /* Sta
6bd0: 74 75 73 20 63 6f 64 65 20 2a 2f 0a 20 20 55 6e tus code */. Un
6be0: 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 49 packedRecord *pI
6bf0: 64 78 4b 65 79 3b 20 20 20 2f 2a 20 55 6e 70 61 dxKey; /* Unpa
6c00: 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 79 20 2a cked index key *
6c10: 2f 0a 0a 20 20 69 66 28 20 70 4b 65 79 20 29 7b /.. if( pKey ){
6c20: 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 4b 65 . assert( nKe
6c30: 79 3d 3d 28 69 36 34 29 28 69 6e 74 29 6e 4b 65 y==(i64)(int)nKe
6c40: 79 20 29 3b 0a 20 20 20 20 70 49 64 78 4b 65 79 y );. pIdxKey
6c50: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 41 6c = sqlite3VdbeAl
6c60: 6c 6f 63 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 locUnpackedRecor
6c70: 64 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f d(pCur->pKeyInfo
6c80: 29 3b 0a 20 20 20 20 69 66 28 20 70 49 64 78 4b );. if( pIdxK
6c90: 65 79 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 ey==0 ) return S
6ca0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 QLITE_NOMEM_BKPT
6cb0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 ;. sqlite3Vdb
6cc0: 65 52 65 63 6f 72 64 55 6e 70 61 63 6b 28 70 43 eRecordUnpack(pC
6cd0: 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 28 69 ur->pKeyInfo, (i
6ce0: 6e 74 29 6e 4b 65 79 2c 20 70 4b 65 79 2c 20 70 nt)nKey, pKey, p
6cf0: 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 69 66 28 IdxKey);. if(
6d00: 20 70 49 64 78 4b 65 79 2d 3e 6e 46 69 65 6c 64 pIdxKey->nField
6d10: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 ==0 ){. rc
6d20: 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
6d30: 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 _BKPT;. got
6d40: 6f 20 6d 6f 76 65 74 6f 5f 64 6f 6e 65 3b 0a 20 o moveto_done;.
6d50: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 }. }else{.
6d60: 20 20 70 49 64 78 4b 65 79 20 3d 20 30 3b 0a 20 pIdxKey = 0;.
6d70: 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 }. rc = sqlite
6d80: 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e 70 61 3BtreeMovetoUnpa
6d90: 63 6b 65 64 28 70 43 75 72 2c 20 70 49 64 78 4b cked(pCur, pIdxK
6da0: 65 79 2c 20 6e 4b 65 79 2c 20 62 69 61 73 2c 20 ey, nKey, bias,
6db0: 70 52 65 73 29 3b 0a 6d 6f 76 65 74 6f 5f 64 6f pRes);.moveto_do
6dc0: 6e 65 3a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 ne:. if( pIdxKe
6dd0: 79 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 y ){. sqlite3
6de0: 44 62 46 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 DbFree(pCur->pKe
6df0: 79 49 6e 66 6f 2d 3e 64 62 2c 20 70 49 64 78 4b yInfo->db, pIdxK
6e00: 65 79 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 ey);. }. retur
6e10: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
6e20: 65 73 74 6f 72 65 20 74 68 65 20 63 75 72 73 6f estore the curso
6e30: 72 20 74 6f 20 74 68 65 20 70 6f 73 69 74 69 6f r to the positio
6e40: 6e 20 69 74 20 77 61 73 20 69 6e 20 28 6f 72 20 n it was in (or
6e50: 61 73 20 63 6c 6f 73 65 20 74 6f 20 61 73 20 70 as close to as p
6e60: 6f 73 73 69 62 6c 65 29 0a 2a 2a 20 77 68 65 6e ossible).** when
6e70: 20 73 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 saveCursorPosit
6e80: 69 6f 6e 28 29 20 77 61 73 20 63 61 6c 6c 65 64 ion() was called
6e90: 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 68 69 73 . Note that this
6ea0: 20 63 61 6c 6c 20 64 65 6c 65 74 65 73 20 74 68 call deletes th
6eb0: 65 20 0a 2a 2a 20 73 61 76 65 64 20 70 6f 73 69 e .** saved posi
6ec0: 74 69 6f 6e 20 69 6e 66 6f 20 73 74 6f 72 65 64 tion info stored
6ed0: 20 62 79 20 73 61 76 65 43 75 72 73 6f 72 50 6f by saveCursorPo
6ee0: 73 69 74 69 6f 6e 28 29 2c 20 73 6f 20 74 68 65 sition(), so the
6ef0: 72 65 20 63 61 6e 20 62 65 0a 2a 2a 20 61 74 20 re can be.** at
6f00: 6d 6f 73 74 20 6f 6e 65 20 65 66 66 65 63 74 69 most one effecti
6f10: 76 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 ve restoreCursor
6f20: 50 6f 73 69 74 69 6f 6e 28 29 20 63 61 6c 6c 20 Position() call
6f30: 61 66 74 65 72 20 65 61 63 68 20 0a 2a 2a 20 73 after each .** s
6f40: 61 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f aveCursorPositio
6f50: 6e 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 n()..*/.static i
6f60: 6e 74 20 62 74 72 65 65 52 65 73 74 6f 72 65 43 nt btreeRestoreC
6f70: 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 42 74 ursorPosition(Bt
6f80: 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
6f90: 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 73 int rc;. int s
6fa0: 6b 69 70 4e 65 78 74 3b 0a 20 20 61 73 73 65 72 kipNext;. asser
6fb0: 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
6fc0: 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
6fd0: 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
6fe0: 53 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 State>=CURSOR_RE
6ff0: 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 69 QUIRESEEK );. i
7000: 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d f( pCur->eState=
7010: 3d 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b =CURSOR_FAULT ){
7020: 0a 20 20 20 20 72 65 74 75 72 6e 20 70 43 75 72 . return pCur
7030: 2d 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 20 7d 0a ->skipNext;. }.
7040: 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
7050: 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b CURSOR_INVALID;
7060: 0a 20 20 72 63 20 3d 20 62 74 72 65 65 4d 6f 76 . rc = btreeMov
7070: 65 74 6f 28 70 43 75 72 2c 20 70 43 75 72 2d 3e eto(pCur, pCur->
7080: 70 4b 65 79 2c 20 70 43 75 72 2d 3e 6e 4b 65 79 pKey, pCur->nKey
7090: 2c 20 30 2c 20 26 73 6b 69 70 4e 65 78 74 29 3b , 0, &skipNext);
70a0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
70b0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 E_OK ){. sqli
70c0: 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 te3_free(pCur->p
70d0: 4b 65 79 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e Key);. pCur->
70e0: 70 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 pKey = 0;. as
70f0: 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
7100: 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
7110: 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 || pCur->eState
7120: 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 ==CURSOR_INVALID
7130: 20 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 73 6b );. pCur->sk
7140: 69 70 4e 65 78 74 20 7c 3d 20 73 6b 69 70 4e 65 ipNext |= skipNe
7150: 78 74 3b 0a 20 20 20 20 69 66 28 20 70 43 75 72 xt;. if( pCur
7160: 2d 3e 73 6b 69 70 4e 65 78 74 20 26 26 20 70 43 ->skipNext && pC
7170: 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
7180: 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 OR_VALID ){.
7190: 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
71a0: 20 43 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 CURSOR_SKIPNEXT
71b0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
71c0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 64 65 66 turn rc;.}..#def
71d0: 69 6e 65 20 72 65 73 74 6f 72 65 43 75 72 73 6f ine restoreCurso
71e0: 72 50 6f 73 69 74 69 6f 6e 28 70 29 20 5c 0a 20 rPosition(p) \.
71f0: 20 28 70 2d 3e 65 53 74 61 74 65 3e 3d 43 55 52 (p->eState>=CUR
7200: 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b 20 SOR_REQUIRESEEK
7210: 3f 20 5c 0a 20 20 20 20 20 20 20 20 20 62 74 72 ? \. btr
7220: 65 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 eeRestoreCursorP
7230: 6f 73 69 74 69 6f 6e 28 70 29 20 3a 20 5c 0a 20 osition(p) : \.
7240: 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f SQLITE_O
7250: 4b 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d K)../*.** Determ
7260: 69 6e 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e ine whether or n
7270: 6f 74 20 61 20 63 75 72 73 6f 72 20 68 61 73 20 ot a cursor has
7280: 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 70 moved from the p
7290: 6f 73 69 74 69 6f 6e 20 77 68 65 72 65 0a 2a 2a osition where.**
72a0: 20 69 74 20 77 61 73 20 6c 61 73 74 20 70 6c 61 it was last pla
72b0: 63 65 64 2c 20 6f 72 20 68 61 73 20 62 65 65 6e ced, or has been
72c0: 20 69 6e 76 61 6c 69 64 61 74 65 64 20 66 6f 72 invalidated for
72d0: 20 61 6e 79 20 6f 74 68 65 72 20 72 65 61 73 6f any other reaso
72e0: 6e 2e 0a 2a 2a 20 43 75 72 73 6f 72 73 20 63 61 n..** Cursors ca
72f0: 6e 20 6d 6f 76 65 20 77 68 65 6e 20 74 68 65 20 n move when the
7300: 72 6f 77 20 74 68 65 79 20 61 72 65 20 70 6f 69 row they are poi
7310: 6e 74 69 6e 67 20 61 74 20 69 73 20 64 65 6c 65 nting at is dele
7320: 74 65 64 20 6f 75 74 0a 2a 2a 20 66 72 6f 6d 20 ted out.** from
7330: 75 6e 64 65 72 20 74 68 65 6d 2c 20 66 6f 72 20 under them, for
7340: 65 78 61 6d 70 6c 65 2e 20 20 43 75 72 73 6f 72 example. Cursor
7350: 20 6d 69 67 68 74 20 61 6c 73 6f 20 6d 6f 76 65 might also move
7360: 20 69 66 20 61 20 62 74 72 65 65 0a 2a 2a 20 69 if a btree.** i
7370: 73 20 72 65 62 61 6c 61 6e 63 65 64 2e 0a 2a 2a s rebalanced..**
7380: 0a 2a 2a 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 .** Calling this
7390: 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 61 20 routine with a
73a0: 4e 55 4c 4c 20 63 75 72 73 6f 72 20 70 6f 69 6e NULL cursor poin
73b0: 74 65 72 20 72 65 74 75 72 6e 73 20 66 61 6c 73 ter returns fals
73c0: 65 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65 e..**.** Use the
73d0: 20 73 65 70 61 72 61 74 65 20 73 71 6c 69 74 65 separate sqlite
73e0: 33 42 74 72 65 65 43 75 72 73 6f 72 52 65 73 74 3BtreeCursorRest
73f0: 6f 72 65 28 29 20 72 6f 75 74 69 6e 65 20 74 6f ore() routine to
7400: 20 72 65 73 74 6f 72 65 20 61 20 63 75 72 73 6f restore a curso
7410: 72 0a 2a 2a 20 62 61 63 6b 20 74 6f 20 77 68 65 r.** back to whe
7420: 72 65 20 69 74 20 6f 75 67 68 74 20 74 6f 20 62 re it ought to b
7430: 65 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e e if this routin
7440: 65 20 72 65 74 75 72 6e 73 20 74 72 75 65 2e 0a e returns true..
7450: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
7460: 72 65 65 43 75 72 73 6f 72 48 61 73 4d 6f 76 65 reeCursorHasMove
7470: 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 d(BtCursor *pCur
7480: 29 7b 0a 20 20 61 73 73 65 72 74 28 20 45 49 47 ){. assert( EIG
7490: 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e HT_BYTE_ALIGNMEN
74a0: 54 28 70 43 75 72 29 0a 20 20 20 20 20 20 20 7c T(pCur). |
74b0: 7c 20 70 43 75 72 3d 3d 73 71 6c 69 74 65 33 42 | pCur==sqlite3B
74c0: 74 72 65 65 46 61 6b 65 56 61 6c 69 64 43 75 72 treeFakeValidCur
74d0: 73 6f 72 28 29 20 29 3b 0a 20 20 61 73 73 65 72 sor() );. asser
74e0: 74 28 20 6f 66 66 73 65 74 6f 66 28 42 74 43 75 t( offsetof(BtCu
74f0: 72 73 6f 72 2c 20 65 53 74 61 74 65 29 3d 3d 30 rsor, eState)==0
7500: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 69 );. assert( si
7510: 7a 65 6f 66 28 70 43 75 72 2d 3e 65 53 74 61 74 zeof(pCur->eStat
7520: 65 29 3d 3d 31 20 29 3b 0a 20 20 72 65 74 75 72 e)==1 );. retur
7530: 6e 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 21 n CURSOR_VALID !
7540: 3d 20 2a 28 75 38 2a 29 70 43 75 72 3b 0a 7d 0a = *(u8*)pCur;.}.
7550: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 ./*.** Return a
7560: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 66 61 6b pointer to a fak
7570: 65 20 42 74 43 75 72 73 6f 72 20 6f 62 6a 65 63 e BtCursor objec
7580: 74 20 74 68 61 74 20 77 69 6c 6c 20 61 6c 77 61 t that will alwa
7590: 79 73 20 61 6e 73 77 65 72 0a 2a 2a 20 66 61 6c ys answer.** fal
75a0: 73 65 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 se to the sqlite
75b0: 33 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 3BtreeCursorHasM
75c0: 6f 76 65 64 28 29 20 72 6f 75 74 69 6e 65 20 61 oved() routine a
75d0: 62 6f 76 65 2e 20 20 54 68 65 20 66 61 6b 65 0a bove. The fake.
75e0: 2a 2a 20 63 75 72 73 6f 72 20 72 65 74 75 72 6e ** cursor return
75f0: 65 64 20 6d 75 73 74 20 6e 6f 74 20 62 65 20 75 ed must not be u
7600: 73 65 64 20 77 69 74 68 20 61 6e 79 20 6f 74 68 sed with any oth
7610: 65 72 20 42 74 72 65 65 20 69 6e 74 65 72 66 61 er Btree interfa
7620: 63 65 2e 0a 2a 2f 0a 42 74 43 75 72 73 6f 72 20 ce..*/.BtCursor
7630: 2a 73 71 6c 69 74 65 33 42 74 72 65 65 46 61 6b *sqlite3BtreeFak
7640: 65 56 61 6c 69 64 43 75 72 73 6f 72 28 76 6f 69 eValidCursor(voi
7650: 64 29 7b 0a 20 20 73 74 61 74 69 63 20 75 38 20 d){. static u8
7660: 66 61 6b 65 43 75 72 73 6f 72 20 3d 20 43 55 52 fakeCursor = CUR
7670: 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 61 73 73 SOR_VALID;. ass
7680: 65 72 74 28 20 6f 66 66 73 65 74 6f 66 28 42 74 ert( offsetof(Bt
7690: 43 75 72 73 6f 72 2c 20 65 53 74 61 74 65 29 3d Cursor, eState)=
76a0: 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 =0 );. return (
76b0: 42 74 43 75 72 73 6f 72 2a 29 26 66 61 6b 65 43 BtCursor*)&fakeC
76c0: 75 72 73 6f 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 ursor;.}../*.**
76d0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 73 This routine res
76e0: 74 6f 72 65 73 20 61 20 63 75 72 73 6f 72 20 62 tores a cursor b
76f0: 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 67 69 ack to its origi
7700: 6e 61 6c 20 70 6f 73 69 74 69 6f 6e 20 61 66 74 nal position aft
7710: 65 72 20 69 74 0a 2a 2a 20 68 61 73 20 62 65 65 er it.** has bee
7720: 6e 20 6d 6f 76 65 64 20 62 79 20 73 6f 6d 65 20 n moved by some
7730: 6f 75 74 73 69 64 65 20 61 63 74 69 76 69 74 79 outside activity
7740: 20 28 73 75 63 68 20 61 73 20 61 20 62 74 72 65 (such as a btre
7750: 65 20 72 65 62 61 6c 61 6e 63 65 20 6f 72 0a 2a e rebalance or.*
7760: 2a 20 61 20 72 6f 77 20 68 61 76 69 6e 67 20 62 * a row having b
7770: 65 65 6e 20 64 65 6c 65 74 65 64 20 6f 75 74 20 een deleted out
7780: 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 20 63 from under the c
7790: 75 72 73 6f 72 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 ursor). .**.**
77a0: 4f 6e 20 73 75 63 63 65 73 73 2c 20 74 68 65 20 On success, the
77b0: 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 70 *pDifferentRow p
77c0: 61 72 61 6d 65 74 65 72 20 69 73 20 66 61 6c 73 arameter is fals
77d0: 65 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 e if the cursor
77e0: 69 73 20 6c 65 66 74 0a 2a 2a 20 70 6f 69 6e 74 is left.** point
77f0: 69 6e 67 20 61 74 20 65 78 61 63 74 6c 79 20 74 ing at exactly t
7800: 68 65 20 73 61 6d 65 20 72 6f 77 2e 20 20 2a 70 he same row. *p
7810: 44 69 66 66 65 72 6e 74 52 6f 77 20 69 73 20 74 DifferntRow is t
7820: 68 65 20 72 6f 77 20 74 68 65 20 63 75 72 73 6f he row the curso
7830: 72 0a 2a 2a 20 77 61 73 20 70 6f 69 6e 74 69 6e r.** was pointin
7840: 67 20 74 6f 20 68 61 73 20 62 65 65 6e 20 64 65 g to has been de
7850: 6c 65 74 65 64 2c 20 66 6f 72 63 69 6e 67 20 74 leted, forcing t
7860: 68 65 20 63 75 72 73 6f 72 20 74 6f 20 70 6f 69 he cursor to poi
7870: 6e 74 20 74 6f 20 73 6f 6d 65 0a 2a 2a 20 6e 65 nt to some.** ne
7880: 61 72 62 79 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a 20 arby row..**.**
7890: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 68 6f This routine sho
78a0: 75 6c 64 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c uld only be call
78b0: 65 64 20 66 6f 72 20 61 20 63 75 72 73 6f 72 20 ed for a cursor
78c0: 74 68 61 74 20 6a 75 73 74 20 72 65 74 75 72 6e that just return
78d0: 65 64 0a 2a 2a 20 54 52 55 45 20 66 72 6f 6d 20 ed.** TRUE from
78e0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
78f0: 6f 72 48 61 73 4d 6f 76 65 64 28 29 2e 0a 2a 2f orHasMoved()..*/
7900: 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
7910: 65 43 75 72 73 6f 72 52 65 73 74 6f 72 65 28 42 eCursorRestore(B
7920: 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 tCursor *pCur, i
7930: 6e 74 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f nt *pDifferentRo
7940: 77 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 w){. int rc;..
7950: 20 61 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 assert( pCur!=0
7960: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
7970: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
7980: 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 72 63 OR_VALID );. rc
7990: 20 3d 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 = restoreCursor
79a0: 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a Position(pCur);.
79b0: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
79c0: 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 3d *pDifferentRow =
79d0: 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 1;. return r
79e0: 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 75 c;. }. if( pCu
79f0: 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
7a00: 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 2a R_VALID ){. *
7a10: 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 3d 20 pDifferentRow =
7a20: 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 1;. }else{.
7a30: 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
7a40: 69 70 4e 65 78 74 3d 3d 30 20 29 3b 0a 20 20 20 ipNext==0 );.
7a50: 20 2a 70 44 69 66 66 65 72 65 6e 74 52 6f 77 20 *pDifferentRow
7a60: 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 = 0;. }. retur
7a70: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
7a80: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
7a90: 41 42 4c 45 5f 43 55 52 53 4f 52 5f 48 49 4e 54 ABLE_CURSOR_HINT
7aa0: 53 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 65 20 S./*.** Provide
7ab0: 68 69 6e 74 73 20 74 6f 20 74 68 65 20 63 75 72 hints to the cur
7ac0: 73 6f 72 2e 20 20 54 68 65 20 70 61 72 74 69 63 sor. The partic
7ad0: 75 6c 61 72 20 68 69 6e 74 20 67 69 76 65 6e 20 ular hint given
7ae0: 28 61 6e 64 20 74 68 65 20 74 79 70 65 0a 2a 2a (and the type.**
7af0: 20 61 6e 64 20 6e 75 6d 62 65 72 20 6f 66 20 74 and number of t
7b00: 68 65 20 76 61 72 61 72 67 73 20 70 61 72 61 6d he varargs param
7b10: 65 74 65 72 73 29 20 69 73 20 64 65 74 65 72 6d eters) is determ
7b20: 69 6e 65 64 20 62 79 20 74 68 65 20 65 48 69 6e ined by the eHin
7b30: 74 54 79 70 65 0a 2a 2a 20 70 61 72 61 6d 65 74 tType.** paramet
7b40: 65 72 2e 20 20 53 65 65 20 74 68 65 20 64 65 66 er. See the def
7b50: 69 6e 69 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 initions of the
7b60: 42 54 52 45 45 5f 48 49 4e 54 5f 2a 20 6d 61 63 BTREE_HINT_* mac
7b70: 72 6f 73 20 66 6f 72 20 64 65 74 61 69 6c 73 2e ros for details.
7b80: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
7b90: 42 74 72 65 65 43 75 72 73 6f 72 48 69 6e 74 28 BtreeCursorHint(
7ba0: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
7bb0: 69 6e 74 20 65 48 69 6e 74 54 79 70 65 2c 20 2e int eHintType, .
7bc0: 2e 2e 29 7b 0a 20 20 2f 2a 20 55 73 65 64 20 6f ..){. /* Used o
7bd0: 6e 6c 79 20 62 79 20 73 79 73 74 65 6d 20 74 68 nly by system th
7be0: 61 74 20 73 75 62 73 74 69 74 75 74 65 20 74 68 at substitute th
7bf0: 65 69 72 20 6f 77 6e 20 73 74 6f 72 61 67 65 20 eir own storage
7c00: 65 6e 67 69 6e 65 20 2a 2f 0a 7d 0a 23 65 6e 64 engine */.}.#end
7c10: 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 if../*.** Provid
7c20: 65 20 66 6c 61 67 20 68 69 6e 74 73 20 74 6f 20 e flag hints to
7c30: 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2f 0a 76 the cursor..*/.v
7c40: 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 oid sqlite3Btree
7c50: 43 75 72 73 6f 72 48 69 6e 74 46 6c 61 67 73 28 CursorHintFlags(
7c60: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
7c70: 75 6e 73 69 67 6e 65 64 20 78 29 7b 0a 20 20 61 unsigned x){. a
7c80: 73 73 65 72 74 28 20 78 3d 3d 42 54 52 45 45 5f ssert( x==BTREE_
7c90: 53 45 45 4b 5f 45 51 20 7c 7c 20 78 3d 3d 42 54 SEEK_EQ || x==BT
7ca0: 52 45 45 5f 42 55 4c 4b 4c 4f 41 44 20 7c 7c 20 REE_BULKLOAD ||
7cb0: 78 3d 3d 30 20 29 3b 0a 20 20 70 43 75 72 2d 3e x==0 );. pCur->
7cc0: 68 69 6e 74 73 20 3d 20 78 3b 0a 7d 0a 0a 0a 23 hints = x;.}...#
7cd0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
7ce0: 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a IT_AUTOVACUUM./*
7cf0: 0a 2a 2a 20 47 69 76 65 6e 20 61 20 70 61 67 65 .** Given a page
7d00: 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 72 65 67 number of a reg
7d10: 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 70 61 ular database pa
7d20: 67 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 70 ge, return the p
7d30: 61 67 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f age.** number fo
7d40: 72 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 r the pointer-ma
7d50: 70 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 p page that cont
7d60: 61 69 6e 73 20 74 68 65 20 65 6e 74 72 79 20 66 ains the entry f
7d70: 6f 72 20 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 or the.** input
7d80: 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a page number..**.
7d90: 2a 2a 20 52 65 74 75 72 6e 20 30 20 28 6e 6f 74 ** Return 0 (not
7da0: 20 61 20 76 61 6c 69 64 20 70 61 67 65 29 20 66 a valid page) f
7db0: 6f 72 20 70 67 6e 6f 3d 3d 31 20 73 69 6e 63 65 or pgno==1 since
7dc0: 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 6e 6f 20 there is.** no
7dd0: 70 6f 69 6e 74 65 72 20 6d 61 70 20 61 73 73 6f pointer map asso
7de0: 63 69 61 74 65 64 20 77 69 74 68 20 70 61 67 65 ciated with page
7df0: 20 31 2e 20 20 54 68 65 20 69 6e 74 65 67 72 69 1. The integri
7e00: 74 79 5f 63 68 65 63 6b 20 6c 6f 67 69 63 0a 2a ty_check logic.*
7e10: 2a 20 72 65 71 75 69 72 65 73 20 74 68 61 74 20 * requires that
7e20: 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 2a 2c 31 ptrmapPageno(*,1
7e30: 29 21 3d 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 )!=1..*/.static
7e40: 50 67 6e 6f 20 70 74 72 6d 61 70 50 61 67 65 6e Pgno ptrmapPagen
7e50: 6f 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c o(BtShared *pBt,
7e60: 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 Pgno pgno){. i
7e70: 6e 74 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 nt nPagesPerMapP
7e80: 61 67 65 3b 0a 20 20 50 67 6e 6f 20 69 50 74 72 age;. Pgno iPtr
7e90: 4d 61 70 2c 20 72 65 74 3b 0a 20 20 61 73 73 65 Map, ret;. asse
7ea0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
7eb0: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
7ec0: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 67 6e 6f x) );. if( pgno
7ed0: 3c 32 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 <2 ) return 0;.
7ee0: 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 nPagesPerMapPag
7ef0: 65 20 3d 20 28 70 42 74 2d 3e 75 73 61 62 6c 65 e = (pBt->usable
7f00: 53 69 7a 65 2f 35 29 2b 31 3b 0a 20 20 69 50 74 Size/5)+1;. iPt
7f10: 72 4d 61 70 20 3d 20 28 70 67 6e 6f 2d 32 29 2f rMap = (pgno-2)/
7f20: 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 nPagesPerMapPage
7f30: 3b 0a 20 20 72 65 74 20 3d 20 28 69 50 74 72 4d ;. ret = (iPtrM
7f40: 61 70 2a 6e 50 61 67 65 73 50 65 72 4d 61 70 50 ap*nPagesPerMapP
7f50: 61 67 65 29 20 2b 20 32 3b 20 0a 20 20 69 66 28 age) + 2; . if(
7f60: 20 72 65 74 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 ret==PENDING_BY
7f70: 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
7f80: 20 20 20 20 72 65 74 2b 2b 3b 0a 20 20 7d 0a 20 ret++;. }.
7f90: 20 72 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a return ret;.}..
7fa0: 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 6e 20 65 /*.** Write an e
7fb0: 6e 74 72 79 20 69 6e 74 6f 20 74 68 65 20 70 6f ntry into the po
7fc0: 69 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a inter map..**.**
7fd0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 75 70 This routine up
7fe0: 64 61 74 65 73 20 74 68 65 20 70 6f 69 6e 74 65 dates the pointe
7ff0: 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 20 r map entry for
8000: 70 61 67 65 20 6e 75 6d 62 65 72 20 27 6b 65 79 page number 'key
8010: 27 0a 2a 2a 20 73 6f 20 74 68 61 74 20 69 74 20 '.** so that it
8020: 6d 61 70 73 20 74 6f 20 74 79 70 65 20 27 65 54 maps to type 'eT
8030: 79 70 65 27 20 61 6e 64 20 70 61 72 65 6e 74 20 ype' and parent
8040: 70 61 67 65 20 6e 75 6d 62 65 72 20 27 70 67 6e page number 'pgn
8050: 6f 27 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 52 o'..**.** If *pR
8060: 43 20 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e C is initially n
8070: 6f 6e 2d 7a 65 72 6f 20 28 6e 6f 6e 2d 53 51 4c on-zero (non-SQL
8080: 49 54 45 5f 4f 4b 29 20 74 68 65 6e 20 74 68 69 ITE_OK) then thi
8090: 73 20 72 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 s routine is.**
80a0: 61 20 6e 6f 2d 6f 70 2e 20 20 49 66 20 61 6e 20 a no-op. If an
80b0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
80c0: 65 20 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 e appropriate er
80d0: 72 6f 72 20 63 6f 64 65 20 69 73 20 77 72 69 74 ror code is writ
80e0: 74 65 6e 0a 2a 2a 20 69 6e 74 6f 20 2a 70 52 43 ten.** into *pRC
80f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
8100: 20 70 74 72 6d 61 70 50 75 74 28 42 74 53 68 61 ptrmapPut(BtSha
8110: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b red *pBt, Pgno k
8120: 65 79 2c 20 75 38 20 65 54 79 70 65 2c 20 50 67 ey, u8 eType, Pg
8130: 6e 6f 20 70 61 72 65 6e 74 2c 20 69 6e 74 20 2a no parent, int *
8140: 70 52 43 29 7b 0a 20 20 44 62 50 61 67 65 20 2a pRC){. DbPage *
8150: 70 44 62 50 61 67 65 3b 20 20 2f 2a 20 54 68 65 pDbPage; /* The
8160: 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 pointer map pag
8170: 65 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d e */. u8 *pPtrm
8180: 61 70 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ap; /* The
8190: 70 6f 69 6e 74 65 72 20 6d 61 70 20 64 61 74 61 pointer map data
81a0: 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 50 74 72 6d */. Pgno iPtrm
81b0: 61 70 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 70 ap; /* The p
81c0: 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 ointer map page
81d0: 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 69 6e 74 20 number */. int
81e0: 6f 66 66 73 65 74 3b 20 20 20 20 20 20 20 2f 2a offset; /*
81f0: 20 4f 66 66 73 65 74 20 69 6e 20 70 6f 69 6e 74 Offset in point
8200: 65 72 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 er map page */.
8210: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
8220: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
8230: 65 20 66 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 e from subfuncti
8240: 6f 6e 73 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 ons */.. if( *p
8250: 52 43 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 RC ) return;..
8260: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
8270: 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
8280: 6d 75 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 mutex) );. /* T
8290: 68 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 he master-journa
82a0: 6c 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6d 75 l page number mu
82b0: 73 74 20 6e 65 76 65 72 20 62 65 20 75 73 65 64 st never be used
82c0: 20 61 73 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 as a pointer ma
82d0: 70 20 70 61 67 65 20 2a 2f 0a 20 20 61 73 73 65 p page */. asse
82e0: 72 74 28 20 30 3d 3d 50 54 52 4d 41 50 5f 49 53 rt( 0==PTRMAP_IS
82f0: 50 41 47 45 28 70 42 74 2c 20 50 45 4e 44 49 4e PAGE(pBt, PENDIN
8300: 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 G_BYTE_PAGE(pBt)
8310: 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ) );.. assert(
8320: 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 pBt->autoVacuum
8330: 29 3b 0a 20 20 69 66 28 20 6b 65 79 3d 3d 30 20 );. if( key==0
8340: 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 ){. *pRC = SQ
8350: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
8360: 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 T;. return;.
8370: 20 7d 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 }. iPtrmap = P
8380: 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 TRMAP_PAGENO(pBt
8390: 2c 20 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 , key);. rc = s
83a0: 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
83b0: 42 74 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 Bt->pPager, iPtr
83c0: 6d 61 70 2c 20 26 70 44 62 50 61 67 65 2c 20 30 map, &pDbPage, 0
83d0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
83e0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 ITE_OK ){. *p
83f0: 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 72 65 74 RC = rc;. ret
8400: 75 72 6e 3b 0a 20 20 7d 0a 20 20 6f 66 66 73 65 urn;. }. offse
8410: 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f 46 t = PTRMAP_PTROF
8420: 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b 65 FSET(iPtrmap, ke
8430: 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 74 y);. if( offset
8440: 3c 30 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d <0 ){. *pRC =
8450: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
8460: 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 70 BKPT;. goto p
8470: 74 72 6d 61 70 5f 65 78 69 74 3b 0a 20 20 7d 0a trmap_exit;. }.
8480: 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 assert( offset
8490: 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e 75 73 <= (int)pBt->us
84a0: 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b 0a 20 20 ableSize-5 );.
84b0: 70 50 74 72 6d 61 70 20 3d 20 28 75 38 20 2a 29 pPtrmap = (u8 *)
84c0: 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 sqlite3PagerGetD
84d0: 61 74 61 28 70 44 62 50 61 67 65 29 3b 0a 0a 20 ata(pDbPage);..
84e0: 20 69 66 28 20 65 54 79 70 65 21 3d 70 50 74 72 if( eType!=pPtr
84f0: 6d 61 70 5b 6f 66 66 73 65 74 5d 20 7c 7c 20 67 map[offset] || g
8500: 65 74 34 62 79 74 65 28 26 70 50 74 72 6d 61 70 et4byte(&pPtrmap
8510: 5b 6f 66 66 73 65 74 2b 31 5d 29 21 3d 70 61 72 [offset+1])!=par
8520: 65 6e 74 20 29 7b 0a 20 20 20 20 54 52 41 43 45 ent ){. TRACE
8530: 28 28 22 50 54 52 4d 41 50 5f 55 50 44 41 54 45 (("PTRMAP_UPDATE
8540: 3a 20 25 64 2d 3e 28 25 64 2c 25 64 29 5c 6e 22 : %d->(%d,%d)\n"
8550: 2c 20 6b 65 79 2c 20 65 54 79 70 65 2c 20 70 61 , key, eType, pa
8560: 72 65 6e 74 29 29 3b 0a 20 20 20 20 2a 70 52 43 rent));. *pRC
8570: 3d 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 = rc = sqlite3Pa
8580: 67 65 72 57 72 69 74 65 28 70 44 62 50 61 67 65 gerWrite(pDbPage
8590: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
85a0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
85b0: 20 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 65 74 pPtrmap[offset
85c0: 5d 20 3d 20 65 54 79 70 65 3b 0a 20 20 20 20 20 ] = eType;.
85d0: 20 70 75 74 34 62 79 74 65 28 26 70 50 74 72 6d put4byte(&pPtrm
85e0: 61 70 5b 6f 66 66 73 65 74 2b 31 5d 2c 20 70 61 ap[offset+1], pa
85f0: 72 65 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d rent);. }. }
8600: 0a 0a 70 74 72 6d 61 70 5f 65 78 69 74 3a 0a 20 ..ptrmap_exit:.
8610: 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
8620: 65 66 28 70 44 62 50 61 67 65 29 3b 0a 7d 0a 0a ef(pDbPage);.}..
8630: 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 6e 20 65 6e /*.** Read an en
8640: 74 72 79 20 66 72 6f 6d 20 74 68 65 20 70 6f 69 try from the poi
8650: 6e 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 nter map..**.**
8660: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 This routine ret
8670: 72 69 65 76 65 73 20 74 68 65 20 70 6f 69 6e 74 rieves the point
8680: 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 er map entry for
8690: 20 70 61 67 65 20 27 6b 65 79 27 2c 20 77 72 69 page 'key', wri
86a0: 74 69 6e 67 0a 2a 2a 20 74 68 65 20 74 79 70 65 ting.** the type
86b0: 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 67 65 and parent page
86c0: 20 6e 75 6d 62 65 72 20 74 6f 20 2a 70 45 54 79 number to *pETy
86d0: 70 65 20 61 6e 64 20 2a 70 50 67 6e 6f 20 72 65 pe and *pPgno re
86e0: 73 70 65 63 74 69 76 65 6c 79 2e 0a 2a 2a 20 41 spectively..** A
86f0: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 n error code is
8700: 72 65 74 75 72 6e 65 64 20 69 66 20 73 6f 6d 65 returned if some
8710: 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 thing goes wrong
8720: 2c 20 6f 74 68 65 72 77 69 73 65 20 53 51 4c 49 , otherwise SQLI
8730: 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 74 61 74 69 63 TE_OK..*/.static
8740: 20 69 6e 74 20 70 74 72 6d 61 70 47 65 74 28 42 int ptrmapGet(B
8750: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
8760: 6e 6f 20 6b 65 79 2c 20 75 38 20 2a 70 45 54 79 no key, u8 *pETy
8770: 70 65 2c 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 29 pe, Pgno *pPgno)
8780: 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 62 50 {. DbPage *pDbP
8790: 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 70 6f age; /* The po
87a0: 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 2a inter map page *
87b0: 2f 0a 20 20 69 6e 74 20 69 50 74 72 6d 61 70 3b /. int iPtrmap;
87c0: 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
87d0: 72 20 6d 61 70 20 70 61 67 65 20 69 6e 64 65 78 r map page index
87e0: 20 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d 61 */. u8 *pPtrma
87f0: 70 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e p; /* Poin
8800: 74 65 72 20 6d 61 70 20 70 61 67 65 20 64 61 74 ter map page dat
8810: 61 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 66 73 65 a */. int offse
8820: 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 t; /* Off
8830: 73 65 74 20 6f 66 20 65 6e 74 72 79 20 69 6e 20 set of entry in
8840: 70 6f 69 6e 74 65 72 20 6d 61 70 20 2a 2f 0a 20 pointer map */.
8850: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 int rc;.. asse
8860: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
8870: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
8880: 78 29 20 29 3b 0a 0a 20 20 69 50 74 72 6d 61 70 x) );.. iPtrmap
8890: 20 3d 20 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f = PTRMAP_PAGENO
88a0: 28 70 42 74 2c 20 6b 65 79 29 3b 0a 20 20 72 63 (pBt, key);. rc
88b0: 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 = sqlite3PagerG
88c0: 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 et(pBt->pPager,
88d0: 69 50 74 72 6d 61 70 2c 20 26 70 44 62 50 61 67 iPtrmap, &pDbPag
88e0: 65 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 e, 0);. if( rc!
88f0: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e =0 ){. return
8900: 20 72 63 3b 0a 20 20 7d 0a 20 20 70 50 74 72 6d rc;. }. pPtrm
8910: 61 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 ap = (u8 *)sqlit
8920: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
8930: 44 62 50 61 67 65 29 3b 0a 0a 20 20 6f 66 66 73 DbPage);.. offs
8940: 65 74 20 3d 20 50 54 52 4d 41 50 5f 50 54 52 4f et = PTRMAP_PTRO
8950: 46 46 53 45 54 28 69 50 74 72 6d 61 70 2c 20 6b FFSET(iPtrmap, k
8960: 65 79 29 3b 0a 20 20 69 66 28 20 6f 66 66 73 65 ey);. if( offse
8970: 74 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 t<0 ){. sqlit
8980: 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 e3PagerUnref(pDb
8990: 50 61 67 65 29 3b 0a 20 20 20 20 72 65 74 75 72 Page);. retur
89a0: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
89b0: 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 _BKPT;. }. ass
89c0: 65 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 ert( offset <= (
89d0: 69 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 int)pBt->usableS
89e0: 69 7a 65 2d 35 20 29 3b 0a 20 20 61 73 73 65 72 ize-5 );. asser
89f0: 74 28 20 70 45 54 79 70 65 21 3d 30 20 29 3b 0a t( pEType!=0 );.
8a00: 20 20 2a 70 45 54 79 70 65 20 3d 20 70 50 74 72 *pEType = pPtr
8a10: 6d 61 70 5b 6f 66 66 73 65 74 5d 3b 0a 20 20 69 map[offset];. i
8a20: 66 28 20 70 50 67 6e 6f 20 29 20 2a 70 50 67 6e f( pPgno ) *pPgn
8a30: 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 o = get4byte(&pP
8a40: 74 72 6d 61 70 5b 6f 66 66 73 65 74 2b 31 5d 29 trmap[offset+1])
8a50: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 ;.. sqlite3Page
8a60: 72 55 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b rUnref(pDbPage);
8a70: 0a 20 20 69 66 28 20 2a 70 45 54 79 70 65 3c 31 . if( *pEType<1
8a80: 20 7c 7c 20 2a 70 45 54 79 70 65 3e 35 20 29 20 || *pEType>5 )
8a90: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
8aa0: 52 52 55 50 54 5f 50 47 4e 4f 28 69 50 74 72 6d RRUPT_PGNO(iPtrm
8ab0: 61 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 ap);. return SQ
8ac0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6c 73 LITE_OK;.}..#els
8ad0: 65 20 2f 2a 20 69 66 20 64 65 66 69 6e 65 64 20 e /* if defined
8ae0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
8af0: 56 41 43 55 55 4d 20 2a 2f 0a 20 20 23 64 65 66 VACUUM */. #def
8b00: 69 6e 65 20 70 74 72 6d 61 70 50 75 74 28 77 2c ine ptrmapPut(w,
8b10: 78 2c 79 2c 7a 2c 72 63 29 0a 20 20 23 64 65 66 x,y,z,rc). #def
8b20: 69 6e 65 20 70 74 72 6d 61 70 47 65 74 28 77 2c ine ptrmapGet(w,
8b30: 78 2c 79 2c 7a 29 20 53 51 4c 49 54 45 5f 4f 4b x,y,z) SQLITE_OK
8b40: 0a 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 . #define ptrma
8b50: 70 50 75 74 4f 76 66 6c 50 74 72 28 78 2c 20 79 pPutOvflPtr(x, y
8b60: 2c 20 72 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a , rc).#endif../*
8b70: 0a 2a 2a 20 47 69 76 65 6e 20 61 20 62 74 72 65 .** Given a btre
8b80: 65 20 70 61 67 65 20 61 6e 64 20 61 20 63 65 6c e page and a cel
8b90: 6c 20 69 6e 64 65 78 20 28 30 20 6d 65 61 6e 73 l index (0 means
8ba0: 20 74 68 65 20 66 69 72 73 74 20 63 65 6c 6c 20 the first cell
8bb0: 6f 6e 0a 2a 2a 20 74 68 65 20 70 61 67 65 2c 20 on.** the page,
8bc0: 31 20 6d 65 61 6e 73 20 74 68 65 20 73 65 63 6f 1 means the seco
8bd0: 6e 64 20 63 65 6c 6c 2c 20 61 6e 64 20 73 6f 20 nd cell, and so
8be0: 66 6f 72 74 68 29 20 72 65 74 75 72 6e 20 61 20 forth) return a
8bf0: 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 pointer.** to th
8c00: 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e 0a e cell content..
8c10: 2a 2a 0a 2a 2a 20 66 69 6e 64 43 65 6c 6c 50 61 **.** findCellPa
8c20: 73 74 50 74 72 28 29 20 64 6f 65 73 20 74 68 65 stPtr() does the
8c30: 20 73 61 6d 65 20 65 78 63 65 70 74 20 69 74 20 same except it
8c40: 73 6b 69 70 73 20 70 61 73 74 20 74 68 65 20 69 skips past the i
8c50: 6e 69 74 69 61 6c 0a 2a 2a 20 34 2d 62 79 74 65 nitial.** 4-byte
8c60: 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 20 66 child pointer f
8c70: 6f 75 6e 64 20 6f 6e 20 69 6e 74 65 72 69 6f 72 ound on interior
8c80: 20 70 61 67 65 73 2c 20 69 66 20 74 68 65 72 65 pages, if there
8c90: 20 69 73 20 6f 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 is one..**.** T
8ca0: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 6f 72 6b his routine work
8cb0: 73 20 6f 6e 6c 79 20 66 6f 72 20 70 61 67 65 73 s only for pages
8cc0: 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 63 6f 6e that do not con
8cd0: 74 61 69 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 tain overflow ce
8ce0: 6c 6c 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 lls..*/.#define
8cf0: 66 69 6e 64 43 65 6c 6c 28 50 2c 49 29 20 5c 0a findCell(P,I) \.
8d00: 20 20 28 28 50 29 2d 3e 61 44 61 74 61 20 2b 20 ((P)->aData +
8d10: 28 28 50 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 ((P)->maskPage &
8d20: 20 67 65 74 32 62 79 74 65 41 6c 69 67 6e 65 64 get2byteAligned
8d30: 28 26 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b (&(P)->aCellIdx[
8d40: 32 2a 28 49 29 5d 29 29 29 0a 23 64 65 66 69 6e 2*(I)]))).#defin
8d50: 65 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 50 74 e findCellPastPt
8d60: 72 28 50 2c 49 29 20 5c 0a 20 20 28 28 50 29 2d r(P,I) \. ((P)-
8d70: 3e 61 44 61 74 61 4f 66 73 74 20 2b 20 28 28 50 >aDataOfst + ((P
8d80: 29 2d 3e 6d 61 73 6b 50 61 67 65 20 26 20 67 65 )->maskPage & ge
8d90: 74 32 62 79 74 65 41 6c 69 67 6e 65 64 28 26 28 t2byteAligned(&(
8da0: 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 28 P)->aCellIdx[2*(
8db0: 49 29 5d 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 54 I)]))).../*.** T
8dc0: 68 69 73 20 69 73 20 63 6f 6d 6d 6f 6e 20 74 61 his is common ta
8dd0: 69 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f il processing fo
8de0: 72 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c r btreeParseCell
8df0: 50 74 72 28 29 20 61 6e 64 0a 2a 2a 20 62 74 72 Ptr() and.** btr
8e00: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 49 6e eeParseCellPtrIn
8e10: 64 65 78 28 29 20 66 6f 72 20 74 68 65 20 63 61 dex() for the ca
8e20: 73 65 20 77 68 65 6e 20 74 68 65 20 63 65 6c 6c se when the cell
8e30: 20 64 6f 65 73 20 6e 6f 74 20 66 69 74 20 65 6e does not fit en
8e40: 74 69 72 65 6c 79 0a 2a 2a 20 6f 6e 20 61 20 73 tirely.** on a s
8e50: 69 6e 67 6c 65 20 42 2d 74 72 65 65 20 70 61 67 ingle B-tree pag
8e60: 65 2e 20 20 4d 61 6b 65 20 6e 65 63 65 73 73 61 e. Make necessa
8e70: 72 79 20 61 64 6a 75 73 74 6d 65 6e 74 73 20 74 ry adjustments t
8e80: 6f 20 74 68 65 20 43 65 6c 6c 49 6e 66 6f 0a 2a o the CellInfo.*
8e90: 2a 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a * structure..*/.
8ea0: 73 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f static SQLITE_NO
8eb0: 49 4e 4c 49 4e 45 20 76 6f 69 64 20 62 74 72 65 INLINE void btre
8ec0: 65 50 61 72 73 65 43 65 6c 6c 41 64 6a 75 73 74 eParseCellAdjust
8ed0: 53 69 7a 65 46 6f 72 4f 76 65 72 66 6c 6f 77 28 SizeForOverflow(
8ee0: 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
8ef0: 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 e, /* Pa
8f00: 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 ge containing th
8f10: 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a e cell */. u8 *
8f20: 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 pCell,
8f30: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
8f40: 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 2e o the cell text.
8f50: 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a */. CellInfo *
8f60: 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f 2a pInfo /*
8f70: 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 Fill in this st
8f80: 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 ructure */.){.
8f90: 2f 2a 20 49 66 20 74 68 65 20 70 61 79 6c 6f 61 /* If the payloa
8fa0: 64 20 77 69 6c 6c 20 6e 6f 74 20 66 69 74 20 63 d will not fit c
8fb0: 6f 6d 70 6c 65 74 65 6c 79 20 6f 6e 20 74 68 65 ompletely on the
8fc0: 20 6c 6f 63 61 6c 20 70 61 67 65 2c 20 77 65 20 local page, we
8fd0: 68 61 76 65 0a 20 20 2a 2a 20 74 6f 20 64 65 63 have. ** to dec
8fe0: 69 64 65 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 ide how much to
8ff0: 73 74 6f 72 65 20 6c 6f 63 61 6c 6c 79 20 61 6e store locally an
9000: 64 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 70 d how much to sp
9010: 69 6c 6c 20 6f 6e 74 6f 0a 20 20 2a 2a 20 6f 76 ill onto. ** ov
9020: 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 erflow pages. T
9030: 68 65 20 73 74 72 61 74 65 67 79 20 69 73 20 74 he strategy is t
9040: 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 20 61 o minimize the a
9050: 6d 6f 75 6e 74 20 6f 66 20 75 6e 75 73 65 64 0a mount of unused.
9060: 20 20 2a 2a 20 73 70 61 63 65 20 6f 6e 20 6f 76 ** space on ov
9070: 65 72 66 6c 6f 77 20 70 61 67 65 73 20 77 68 69 erflow pages whi
9080: 6c 65 20 6b 65 65 70 69 6e 67 20 74 68 65 20 61 le keeping the a
9090: 6d 6f 75 6e 74 20 6f 66 20 6c 6f 63 61 6c 20 73 mount of local s
90a0: 74 6f 72 61 67 65 0a 20 20 2a 2a 20 69 6e 20 62 torage. ** in b
90b0: 65 74 77 65 65 6e 20 6d 69 6e 4c 6f 63 61 6c 20 etween minLocal
90c0: 61 6e 64 20 6d 61 78 4c 6f 63 61 6c 2e 0a 20 20 and maxLocal..
90d0: 2a 2a 0a 20 20 2a 2a 20 57 61 72 6e 69 6e 67 3a **. ** Warning:
90e0: 20 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 77 changing the w
90f0: 61 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 79 6c ay overflow payl
9100: 6f 61 64 20 69 73 20 64 69 73 74 72 69 62 75 74 oad is distribut
9110: 65 64 20 69 6e 20 61 6e 79 0a 20 20 2a 2a 20 77 ed in any. ** w
9120: 61 79 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 ay will result i
9130: 6e 20 61 6e 20 69 6e 63 6f 6d 70 61 74 69 62 6c n an incompatibl
9140: 65 20 66 69 6c 65 20 66 6f 72 6d 61 74 2e 0a 20 e file format..
9150: 20 2a 2f 0a 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 */. int minLoc
9160: 61 6c 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 al; /* Minimum
9170: 61 6d 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 amount of payloa
9180: 64 20 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a d held locally *
9190: 2f 0a 20 20 69 6e 74 20 6d 61 78 4c 6f 63 61 6c /. int maxLocal
91a0: 3b 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d ; /* Maximum am
91b0: 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 ount of payload
91c0: 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a held locally */.
91d0: 20 20 69 6e 74 20 73 75 72 70 6c 75 73 3b 20 20 int surplus;
91e0: 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 61 79 /* Overflow pay
91f0: 6c 6f 61 64 20 61 76 61 69 6c 61 62 6c 65 20 66 load available f
9200: 6f 72 20 6c 6f 63 61 6c 20 73 74 6f 72 61 67 65 or local storage
9210: 20 2a 2f 0a 0a 20 20 6d 69 6e 4c 6f 63 61 6c 20 */.. minLocal
9220: 3d 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 = pPage->minLoca
9230: 6c 3b 0a 20 20 6d 61 78 4c 6f 63 61 6c 20 3d 20 l;. maxLocal =
9240: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 3b pPage->maxLocal;
9250: 0a 20 20 73 75 72 70 6c 75 73 20 3d 20 6d 69 6e . surplus = min
9260: 4c 6f 63 61 6c 20 2b 20 28 70 49 6e 66 6f 2d 3e Local + (pInfo->
9270: 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c 6f nPayload - minLo
9280: 63 61 6c 29 25 28 70 50 61 67 65 2d 3e 70 42 74 cal)%(pPage->pBt
9290: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 29 3b ->usableSize-4);
92a0: 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 75 72 . testcase( sur
92b0: 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 20 29 plus==maxLocal )
92c0: 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 73 75 ;. testcase( su
92d0: 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f 63 61 6c 2b rplus==maxLocal+
92e0: 31 20 29 3b 0a 20 20 69 66 28 20 73 75 72 70 6c 1 );. if( surpl
92f0: 75 73 20 3c 3d 20 6d 61 78 4c 6f 63 61 6c 20 29 us <= maxLocal )
9300: 7b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f {. pInfo->nLo
9310: 63 61 6c 20 3d 20 28 75 31 36 29 73 75 72 70 6c cal = (u16)surpl
9320: 75 73 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 us;. }else{.
9330: 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d pInfo->nLocal =
9340: 20 28 75 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b 0a (u16)minLocal;.
9350: 20 20 7d 0a 20 20 70 49 6e 66 6f 2d 3e 6e 53 69 }. pInfo->nSi
9360: 7a 65 20 3d 20 28 75 31 36 29 28 26 70 49 6e 66 ze = (u16)(&pInf
9370: 6f 2d 3e 70 50 61 79 6c 6f 61 64 5b 70 49 6e 66 o->pPayload[pInf
9380: 6f 2d 3e 6e 4c 6f 63 61 6c 5d 20 2d 20 70 43 65 o->nLocal] - pCe
9390: 6c 6c 29 20 2b 20 34 3b 0a 7d 0a 0a 2f 2a 0a 2a ll) + 4;.}../*.*
93a0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
93b0: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 69 6d 70 routines are imp
93c0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20 lementations of
93d0: 74 68 65 20 4d 65 6d 50 61 67 65 2e 78 50 61 72 the MemPage.xPar
93e0: 73 65 43 65 6c 6c 28 29 0a 2a 2a 20 6d 65 74 68 seCell().** meth
93f0: 6f 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 73 65 20 od..**.** Parse
9400: 61 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 a cell content b
9410: 6c 6f 63 6b 20 61 6e 64 20 66 69 6c 6c 20 69 6e lock and fill in
9420: 20 74 68 65 20 43 65 6c 6c 49 6e 66 6f 20 73 74 the CellInfo st
9430: 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 62 ructure..**.** b
9440: 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
9450: 28 29 20 20 20 20 20 20 20 20 3d 3e 20 20 20 74 () => t
9460: 61 62 6c 65 20 62 74 72 65 65 20 6c 65 61 66 20 able btree leaf
9470: 6e 6f 64 65 73 0a 2a 2a 20 62 74 72 65 65 50 61 nodes.** btreePa
9480: 72 73 65 43 65 6c 6c 4e 6f 50 61 79 6c 6f 61 64 rseCellNoPayload
9490: 28 29 20 20 3d 3e 20 20 20 74 61 62 6c 65 20 62 () => table b
94a0: 74 72 65 65 20 69 6e 74 65 72 6e 61 6c 20 6e 6f tree internal no
94b0: 64 65 73 0a 2a 2a 20 62 74 72 65 65 50 61 72 73 des.** btreePars
94c0: 65 43 65 6c 6c 50 74 72 49 6e 64 65 78 28 29 20 eCellPtrIndex()
94d0: 20 20 3d 3e 20 20 20 69 6e 64 65 78 20 62 74 72 => index btr
94e0: 65 65 20 6e 6f 64 65 73 0a 2a 2a 0a 2a 2a 20 54 ee nodes.**.** T
94f0: 68 65 72 65 20 69 73 20 61 6c 73 6f 20 61 20 77 here is also a w
9500: 72 61 70 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 rapper function
9510: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 29 btreeParseCell()
9520: 20 74 68 61 74 20 77 6f 72 6b 73 20 66 6f 72 0a that works for.
9530: 2a 2a 20 61 6c 6c 20 4d 65 6d 50 61 67 65 20 74 ** all MemPage t
9540: 79 70 65 73 20 61 6e 64 20 74 68 61 74 20 72 65 ypes and that re
9550: 66 65 72 65 6e 63 65 73 20 74 68 65 20 63 65 6c ferences the cel
9560: 6c 20 62 79 20 69 6e 64 65 78 20 72 61 74 68 65 l by index rathe
9570: 72 20 74 68 61 6e 0a 2a 2a 20 62 79 20 70 6f 69 r than.** by poi
9580: 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 nter..*/.static
9590: 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 void btreeParseC
95a0: 65 6c 6c 50 74 72 4e 6f 50 61 79 6c 6f 61 64 28 ellPtrNoPayload(
95b0: 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
95c0: 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 e, /* Pa
95d0: 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 ge containing th
95e0: 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a e cell */. u8 *
95f0: 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 pCell,
9600: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
9610: 6f 20 74 68 65 20 63 65 6c 6c 20 74 65 78 74 2e o the cell text.
9620: 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a */. CellInfo *
9630: 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 2f 2a pInfo /*
9640: 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 Fill in this st
9650: 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 ructure */.){.
9660: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
9670: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
9680: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
9690: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
96a0: 2d 3e 6c 65 61 66 3d 3d 30 20 29 3b 0a 20 20 61 ->leaf==0 );. a
96b0: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 63 68 ssert( pPage->ch
96c0: 69 6c 64 50 74 72 53 69 7a 65 3d 3d 34 20 29 3b ildPtrSize==4 );
96d0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
96e0: 44 45 42 55 47 0a 20 20 55 4e 55 53 45 44 5f 50 DEBUG. UNUSED_P
96f0: 41 52 41 4d 45 54 45 52 28 70 50 61 67 65 29 3b ARAMETER(pPage);
9700: 0a 23 65 6e 64 69 66 0a 20 20 70 49 6e 66 6f 2d .#endif. pInfo-
9710: 3e 6e 53 69 7a 65 20 3d 20 34 20 2b 20 67 65 74 >nSize = 4 + get
9720: 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 34 5d Varint(&pCell[4]
9730: 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d 3e , (u64*)&pInfo->
9740: 6e 4b 65 79 29 3b 0a 20 20 70 49 6e 66 6f 2d 3e nKey);. pInfo->
9750: 6e 50 61 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 nPayload = 0;.
9760: 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 pInfo->nLocal =
9770: 30 3b 0a 20 20 70 49 6e 66 6f 2d 3e 70 50 61 79 0;. pInfo->pPay
9780: 6c 6f 61 64 20 3d 20 30 3b 0a 20 20 72 65 74 75 load = 0;. retu
9790: 72 6e 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 rn;.}.static voi
97a0: 64 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c d btreeParseCell
97b0: 50 74 72 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a Ptr(. MemPage *
97c0: 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 2f pPage, /
97d0: 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e * Page containin
97e0: 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 g the cell */.
97f0: 75 38 20 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 u8 *pCell,
9800: 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
9810: 65 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 74 er to the cell t
9820: 65 78 74 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e ext. */. CellIn
9830: 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 fo *pInfo
9840: 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 /* Fill in thi
9850: 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 s structure */.)
9860: 7b 0a 20 20 75 38 20 2a 70 49 74 65 72 3b 20 20 {. u8 *pIter;
9870: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
9880: 6f 72 20 73 63 61 6e 6e 69 6e 67 20 74 68 72 6f or scanning thro
9890: 75 67 68 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 ugh pCell */. u
98a0: 33 32 20 6e 50 61 79 6c 6f 61 64 3b 20 20 20 20 32 nPayload;
98b0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
98c0: 20 6f 66 20 62 79 74 65 73 20 6f 66 20 63 65 6c of bytes of cel
98d0: 6c 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 75 l payload */. u
98e0: 36 34 20 69 4b 65 79 3b 20 20 20 20 20 20 20 20 64 iKey;
98f0: 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 63 /* Extrac
9900: 74 65 64 20 4b 65 79 20 76 61 6c 75 65 20 2a 2f ted Key value */
9910: 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 .. assert( sqli
9920: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
9930: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
9940: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
9950: 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 20 7c 7c Page->leaf==0 ||
9960: 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 31 20 pPage->leaf==1
9970: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
9980: 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 ge->intKeyLeaf )
9990: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
99a0: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3d e->childPtrSize=
99b0: 3d 30 20 29 3b 0a 20 20 70 49 74 65 72 20 3d 20 =0 );. pIter =
99c0: 70 43 65 6c 6c 3b 0a 0a 20 20 2f 2a 20 54 68 65 pCell;.. /* The
99d0: 20 6e 65 78 74 20 62 6c 6f 63 6b 20 6f 66 20 63 next block of c
99e0: 6f 64 65 20 69 73 20 65 71 75 69 76 61 6c 65 6e ode is equivalen
99f0: 74 20 74 6f 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 t to:. **. **
9a00: 20 20 20 20 70 49 74 65 72 20 2b 3d 20 67 65 74 pIter += get
9a10: 56 61 72 69 6e 74 33 32 28 70 49 74 65 72 2c 20 Varint32(pIter,
9a20: 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 2a 2a 0a nPayload);. **.
9a30: 20 20 2a 2a 20 54 68 65 20 63 6f 64 65 20 69 73 ** The code is
9a40: 20 69 6e 6c 69 6e 65 64 20 74 6f 20 61 76 6f 69 inlined to avoi
9a50: 64 20 61 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c d a function cal
9a60: 6c 2e 0a 20 20 2a 2f 0a 20 20 6e 50 61 79 6c 6f l.. */. nPaylo
9a70: 61 64 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 ad = *pIter;. i
9a80: 66 28 20 6e 50 61 79 6c 6f 61 64 3e 3d 30 78 38 f( nPayload>=0x8
9a90: 30 20 29 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 0 ){. u8 *pEn
9aa0: 64 20 3d 20 26 70 49 74 65 72 5b 38 5d 3b 0a 20 d = &pIter[8];.
9ab0: 20 20 20 6e 50 61 79 6c 6f 61 64 20 26 3d 20 30 nPayload &= 0
9ac0: 78 37 66 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 x7f;. do{.
9ad0: 20 20 20 6e 50 61 79 6c 6f 61 64 20 3d 20 28 6e nPayload = (n
9ae0: 50 61 79 6c 6f 61 64 3c 3c 37 29 20 7c 20 28 2a Payload<<7) | (*
9af0: 2b 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b ++pIter & 0x7f);
9b00: 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 28 2a 70 . }while( (*p
9b10: 49 74 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 Iter)>=0x80 && p
9b20: 49 74 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d Iter<pEnd );. }
9b30: 0a 20 20 70 49 74 65 72 2b 2b 3b 0a 0a 20 20 2f . pIter++;.. /
9b40: 2a 20 54 68 65 20 6e 65 78 74 20 62 6c 6f 63 6b * The next block
9b50: 20 6f 66 20 63 6f 64 65 20 69 73 20 65 71 75 69 of code is equi
9b60: 76 61 6c 65 6e 74 20 74 6f 3a 0a 20 20 2a 2a 0a valent to:. **.
9b70: 20 20 2a 2a 20 20 20 20 20 70 49 74 65 72 20 2b ** pIter +
9b80: 3d 20 67 65 74 56 61 72 69 6e 74 28 70 49 74 65 = getVarint(pIte
9b90: 72 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d r, (u64*)&pInfo-
9ba0: 3e 6e 4b 65 79 29 3b 0a 20 20 2a 2a 0a 20 20 2a >nKey);. **. *
9bb0: 2a 20 54 68 65 20 63 6f 64 65 20 69 73 20 69 6e * The code is in
9bc0: 6c 69 6e 65 64 20 74 6f 20 61 76 6f 69 64 20 61 lined to avoid a
9bd0: 20 66 75 6e 63 74 69 6f 6e 20 63 61 6c 6c 2e 0a function call..
9be0: 20 20 2a 2f 0a 20 20 69 4b 65 79 20 3d 20 2a 70 */. iKey = *p
9bf0: 49 74 65 72 3b 0a 20 20 69 66 28 20 69 4b 65 79 Iter;. if( iKey
9c00: 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 75 38 >=0x80 ){. u8
9c10: 20 2a 70 45 6e 64 20 3d 20 26 70 49 74 65 72 5b *pEnd = &pIter[
9c20: 37 5d 3b 0a 20 20 20 20 69 4b 65 79 20 26 3d 20 7];. iKey &=
9c30: 30 78 37 66 3b 0a 20 20 20 20 77 68 69 6c 65 28 0x7f;. while(
9c40: 31 29 7b 0a 20 20 20 20 20 20 69 4b 65 79 20 3d 1){. iKey =
9c50: 20 28 69 4b 65 79 3c 3c 37 29 20 7c 20 28 2a 2b (iKey<<7) | (*+
9c60: 2b 70 49 74 65 72 20 26 20 30 78 37 66 29 3b 0a +pIter & 0x7f);.
9c70: 20 20 20 20 20 20 69 66 28 20 28 2a 70 49 74 65 if( (*pIte
9c80: 72 29 3c 30 78 38 30 20 29 20 62 72 65 61 6b 3b r)<0x80 ) break;
9c90: 0a 20 20 20 20 20 20 69 66 28 20 70 49 74 65 72 . if( pIter
9ca0: 3e 3d 70 45 6e 64 20 29 7b 0a 20 20 20 20 20 20 >=pEnd ){.
9cb0: 20 20 69 4b 65 79 20 3d 20 28 69 4b 65 79 3c 3c iKey = (iKey<<
9cc0: 38 29 20 7c 20 2a 2b 2b 70 49 74 65 72 3b 0a 20 8) | *++pIter;.
9cd0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
9ce0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
9cf0: 20 20 70 49 74 65 72 2b 2b 3b 0a 0a 20 20 70 49 pIter++;.. pI
9d00: 6e 66 6f 2d 3e 6e 4b 65 79 20 3d 20 2a 28 69 36 nfo->nKey = *(i6
9d10: 34 2a 29 26 69 4b 65 79 3b 0a 20 20 70 49 6e 66 4*)&iKey;. pInf
9d20: 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d 20 6e 50 o->nPayload = nP
9d30: 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e 66 6f 2d ayload;. pInfo-
9d40: 3e 70 50 61 79 6c 6f 61 64 20 3d 20 70 49 74 65 >pPayload = pIte
9d50: 72 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e r;. testcase( n
9d60: 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e Payload==pPage->
9d70: 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 maxLocal );. te
9d80: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
9d90: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
9da0: 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6e 50 61 l+1 );. if( nPa
9db0: 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d 3e 6d 61 yload<=pPage->ma
9dc0: 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 2f 2a xLocal ){. /*
9dd0: 20 54 68 69 73 20 69 73 20 74 68 65 20 28 65 61 This is the (ea
9de0: 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 sy) common case
9df0: 77 68 65 72 65 20 74 68 65 20 65 6e 74 69 72 65 where the entire
9e00: 20 70 61 79 6c 6f 61 64 20 66 69 74 73 0a 20 20 payload fits.
9e10: 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 6f 63 61 ** on the loca
9e20: 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f 76 65 72 l page. No over
9e30: 66 6c 6f 77 20 69 73 20 72 65 71 75 69 72 65 64 flow is required
9e40: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 49 6e .. */. pIn
9e50: 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 6e 50 61 79 fo->nSize = nPay
9e60: 6c 6f 61 64 20 2b 20 28 75 31 36 29 28 70 49 74 load + (u16)(pIt
9e70: 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a 20 20 20 er - pCell);.
9e80: 20 69 66 28 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a if( pInfo->nSiz
9e90: 65 3c 34 20 29 20 70 49 6e 66 6f 2d 3e 6e 53 69 e<4 ) pInfo->nSi
9ea0: 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 49 6e 66 ze = 4;. pInf
9eb0: 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 o->nLocal = (u16
9ec0: 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 7d 65 6c )nPayload;. }el
9ed0: 73 65 7b 0a 20 20 20 20 62 74 72 65 65 50 61 72 se{. btreePar
9ee0: 73 65 43 65 6c 6c 41 64 6a 75 73 74 53 69 7a 65 seCellAdjustSize
9ef0: 46 6f 72 4f 76 65 72 66 6c 6f 77 28 70 50 61 67 ForOverflow(pPag
9f00: 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e 66 6f 29 e, pCell, pInfo)
9f10: 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 63 20 76 ;. }.}.static v
9f20: 6f 69 64 20 62 74 72 65 65 50 61 72 73 65 43 65 oid btreeParseCe
9f30: 6c 6c 50 74 72 49 6e 64 65 78 28 0a 20 20 4d 65 llPtrIndex(. Me
9f40: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
9f50: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f /* Page co
9f60: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c ntaining the cel
9f70: 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c l */. u8 *pCell
9f80: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
9f90: 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 * Pointer to the
9fa0: 20 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 cell text. */.
9fb0: 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f CellInfo *pInfo
9fc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c /* Fill
9fd0: 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 in this structu
9fe0: 72 65 20 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 re */.){. u8 *p
9ff0: 49 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 Iter;
a000: 20 20 20 2f 2a 20 46 6f 72 20 73 63 61 6e 6e 69 /* For scanni
a010: 6e 67 20 74 68 72 6f 75 67 68 20 70 43 65 6c 6c ng through pCell
a020: 20 2a 2f 0a 20 20 75 33 32 20 6e 50 61 79 6c 6f */. u32 nPaylo
a030: 61 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ad; /*
a040: 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 Number of bytes
a050: 20 6f 66 20 63 65 6c 6c 20 70 61 79 6c 6f 61 64 of cell payload
a060: 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 73 */.. assert( s
a070: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
a080: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
a090: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
a0a0: 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 ( pPage->leaf==0
a0b0: 20 7c 7c 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d || pPage->leaf=
a0c0: 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =1 );. assert(
a0d0: 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 pPage->intKeyLea
a0e0: 66 3d 3d 30 20 29 3b 0a 20 20 70 49 74 65 72 20 f==0 );. pIter
a0f0: 3d 20 70 43 65 6c 6c 20 2b 20 70 50 61 67 65 2d = pCell + pPage-
a100: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 >childPtrSize;.
a110: 20 6e 50 61 79 6c 6f 61 64 20 3d 20 2a 70 49 74 nPayload = *pIt
a120: 65 72 3b 0a 20 20 69 66 28 20 6e 50 61 79 6c 6f er;. if( nPaylo
a130: 61 64 3e 3d 30 78 38 30 20 29 7b 0a 20 20 20 20 ad>=0x80 ){.
a140: 75 38 20 2a 70 45 6e 64 20 3d 20 26 70 49 74 65 u8 *pEnd = &pIte
a150: 72 5b 38 5d 3b 0a 20 20 20 20 6e 50 61 79 6c 6f r[8];. nPaylo
a160: 61 64 20 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 ad &= 0x7f;.
a170: 64 6f 7b 0a 20 20 20 20 20 20 6e 50 61 79 6c 6f do{. nPaylo
a180: 61 64 20 3d 20 28 6e 50 61 79 6c 6f 61 64 3c 3c ad = (nPayload<<
a190: 37 29 20 7c 20 28 2a 2b 2b 70 49 74 65 72 20 26 7) | (*++pIter &
a1a0: 20 30 78 37 66 29 3b 0a 20 20 20 20 7d 77 68 69 0x7f);. }whi
a1b0: 6c 65 28 20 2a 28 70 49 74 65 72 29 3e 3d 30 78 le( *(pIter)>=0x
a1c0: 38 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 80 && pIter<pEnd
a1d0: 20 29 3b 0a 20 20 7d 0a 20 20 70 49 74 65 72 2b );. }. pIter+
a1e0: 2b 3b 0a 20 20 70 49 6e 66 6f 2d 3e 6e 4b 65 79 +;. pInfo->nKey
a1f0: 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 70 = nPayload;. p
a200: 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 3d Info->nPayload =
a210: 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 70 49 6e nPayload;. pIn
a220: 66 6f 2d 3e 70 50 61 79 6c 6f 61 64 20 3d 20 70 fo->pPayload = p
a230: 49 74 65 72 3b 0a 20 20 74 65 73 74 63 61 73 65 Iter;. testcase
a240: 28 20 6e 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 ( nPayload==pPag
a250: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 e->maxLocal );.
a260: 20 74 65 73 74 63 61 73 65 28 20 6e 50 61 79 6c testcase( nPayl
a270: 6f 61 64 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c oad==pPage->maxL
a280: 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 ocal+1 );. if(
a290: 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 61 67 65 2d nPayload<=pPage-
a2a0: 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 >maxLocal ){.
a2b0: 20 2f 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 /* This is the
a2c0: 28 65 61 73 79 29 20 63 6f 6d 6d 6f 6e 20 63 61 (easy) common ca
a2d0: 73 65 20 77 68 65 72 65 20 74 68 65 20 65 6e 74 se where the ent
a2e0: 69 72 65 20 70 61 79 6c 6f 61 64 20 66 69 74 73 ire payload fits
a2f0: 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6c . ** on the l
a300: 6f 63 61 6c 20 70 61 67 65 2e 20 20 4e 6f 20 6f ocal page. No o
a310: 76 65 72 66 6c 6f 77 20 69 73 20 72 65 71 75 69 verflow is requi
a320: 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 red.. */.
a330: 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 6e pInfo->nSize = n
a340: 50 61 79 6c 6f 61 64 20 2b 20 28 75 31 36 29 28 Payload + (u16)(
a350: 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a pIter - pCell);.
a360: 20 20 20 20 69 66 28 20 70 49 6e 66 6f 2d 3e 6e if( pInfo->n
a370: 53 69 7a 65 3c 34 20 29 20 70 49 6e 66 6f 2d 3e Size<4 ) pInfo->
a380: 6e 53 69 7a 65 20 3d 20 34 3b 0a 20 20 20 20 70 nSize = 4;. p
a390: 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 28 Info->nLocal = (
a3a0: 75 31 36 29 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 u16)nPayload;.
a3b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 62 74 72 65 65 }else{. btree
a3c0: 50 61 72 73 65 43 65 6c 6c 41 64 6a 75 73 74 53 ParseCellAdjustS
a3d0: 69 7a 65 46 6f 72 4f 76 65 72 66 6c 6f 77 28 70 izeForOverflow(p
a3e0: 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 70 49 6e Page, pCell, pIn
a3f0: 66 6f 29 3b 0a 20 20 7d 0a 7d 0a 73 74 61 74 69 fo);. }.}.stati
a400: 63 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 73 c void btreePars
a410: 65 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 eCell(. MemPage
a420: 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 *pPage,
a430: 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 61 69 6e /* Page contain
a440: 69 6e 67 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a ing the cell */.
a450: 20 20 69 6e 74 20 69 43 65 6c 6c 2c 20 20 20 20 int iCell,
a460: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
a470: 20 63 65 6c 6c 20 69 6e 64 65 78 2e 20 20 46 69 cell index. Fi
a480: 72 73 74 20 63 65 6c 6c 20 69 73 20 30 20 2a 2f rst cell is 0 */
a490: 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e . CellInfo *pIn
a4a0: 66 6f 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 fo /* Fi
a4b0: 6c 6c 20 69 6e 20 74 68 69 73 20 73 74 72 75 63 ll in this struc
a4c0: 74 75 72 65 20 2a 2f 0a 29 7b 0a 20 20 70 50 61 ture */.){. pPa
a4d0: 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 28 70 ge->xParseCell(p
a4e0: 50 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 Page, findCell(p
a4f0: 50 61 67 65 2c 20 69 43 65 6c 6c 29 2c 20 70 49 Page, iCell), pI
a500: 6e 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 nfo);.}../*.** T
a510: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 he following rou
a520: 74 69 6e 65 73 20 61 72 65 20 69 6d 70 6c 65 6d tines are implem
a530: 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 entations of the
a540: 20 4d 65 6d 50 61 67 65 2e 78 43 65 6c 6c 53 69 MemPage.xCellSi
a550: 7a 65 0a 2a 2a 20 6d 65 74 68 6f 64 2e 0a 2a 2a ze.** method..**
a560: 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 .** Compute the
a570: 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 total number of
a580: 62 79 74 65 73 20 74 68 61 74 20 61 20 43 65 6c bytes that a Cel
a590: 6c 20 6e 65 65 64 73 20 69 6e 20 74 68 65 20 63 l needs in the c
a5a0: 65 6c 6c 0a 2a 2a 20 64 61 74 61 20 61 72 65 61 ell.** data area
a5b0: 20 6f 66 20 74 68 65 20 62 74 72 65 65 2d 70 61 of the btree-pa
a5c0: 67 65 2e 20 20 54 68 65 20 72 65 74 75 72 6e 20 ge. The return
a5d0: 6e 75 6d 62 65 72 20 69 6e 63 6c 75 64 65 73 20 number includes
a5e0: 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 74 61 the cell.** data
a5f0: 20 68 65 61 64 65 72 20 61 6e 64 20 74 68 65 20 header and the
a600: 6c 6f 63 61 6c 20 70 61 79 6c 6f 61 64 2c 20 62 local payload, b
a610: 75 74 20 6e 6f 74 20 61 6e 79 20 6f 76 65 72 66 ut not any overf
a620: 6c 6f 77 20 70 61 67 65 20 6f 72 0a 2a 2a 20 74 low page or.** t
a630: 68 65 20 73 70 61 63 65 20 75 73 65 64 20 62 79 he space used by
a640: 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 the cell pointe
a650: 72 2e 0a 2a 2a 0a 2a 2a 20 63 65 6c 6c 53 69 7a r..**.** cellSiz
a660: 65 50 74 72 4e 6f 50 61 79 6c 6f 61 64 28 29 20 ePtrNoPayload()
a670: 20 20 20 3d 3e 20 20 20 74 61 62 6c 65 20 69 6e => table in
a680: 74 65 72 6e 61 6c 20 6e 6f 64 65 73 0a 2a 2a 20 ternal nodes.**
a690: 63 65 6c 6c 53 69 7a 65 50 74 72 28 29 20 20 20 cellSizePtr()
a6a0: 20 20 20 20 20 20 20 20 20 20 3d 3e 20 20 20 61 => a
a6b0: 6c 6c 20 69 6e 64 65 78 20 6e 6f 64 65 73 20 26 ll index nodes &
a6c0: 20 74 61 62 6c 65 20 6c 65 61 66 20 6e 6f 64 65 table leaf node
a6d0: 73 0a 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 s.*/.static u16
a6e0: 63 65 6c 6c 53 69 7a 65 50 74 72 28 4d 65 6d 50 cellSizePtr(MemP
a6f0: 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 20 2a age *pPage, u8 *
a700: 70 43 65 6c 6c 29 7b 0a 20 20 75 38 20 2a 70 49 pCell){. u8 *pI
a710: 74 65 72 20 3d 20 70 43 65 6c 6c 20 2b 20 70 50 ter = pCell + pP
a720: 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a age->childPtrSiz
a730: 65 3b 20 2f 2a 20 46 6f 72 20 6c 6f 6f 70 69 6e e; /* For loopin
a740: 67 20 6f 76 65 72 20 62 79 74 65 73 20 6f 66 20 g over bytes of
a750: 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 20 2a 70 pCell */. u8 *p
a760: 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 End;
a770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a780: 20 20 20 20 2f 2a 20 45 6e 64 20 6d 61 72 6b 20 /* End mark
a790: 66 6f 72 20 61 20 76 61 72 69 6e 74 20 2a 2f 0a for a varint */.
a7a0: 20 20 75 33 32 20 6e 53 69 7a 65 3b 20 20 20 20 u32 nSize;
a7b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a7c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
a7d0: 7a 65 20 76 61 6c 75 65 20 74 6f 20 72 65 74 75 ze value to retu
a7e0: 72 6e 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 rn */..#ifdef SQ
a7f0: 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f 2a 20 LITE_DEBUG. /*
a800: 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e The value return
a810: 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 ed by this funct
a820: 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 ion should alway
a830: 73 20 62 65 20 74 68 65 20 73 61 6d 65 20 61 73 s be the same as
a840: 0a 20 20 2a 2a 20 74 68 65 20 28 43 65 6c 6c 49 . ** the (CellI
a850: 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 61 6c 75 65 nfo.nSize) value
a860: 20 66 6f 75 6e 64 20 62 79 20 64 6f 69 6e 67 20 found by doing
a870: 61 20 66 75 6c 6c 20 70 61 72 73 65 20 6f 66 20 a full parse of
a880: 74 68 65 0a 20 20 2a 2a 20 63 65 6c 6c 2e 20 49 the. ** cell. I
a890: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 69 f SQLITE_DEBUG i
a8a0: 73 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 61 73 s defined, an as
a8b0: 73 65 72 74 28 29 20 61 74 20 74 68 65 20 62 6f sert() at the bo
a8c0: 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a 20 74 68 69 ttom of. ** thi
a8d0: 73 20 66 75 6e 63 74 69 6f 6e 20 76 65 72 69 66 s function verif
a8e0: 69 65 73 20 74 68 61 74 20 74 68 69 73 20 69 6e ies that this in
a8f0: 76 61 72 69 61 6e 74 20 69 73 20 6e 6f 74 20 76 variant is not v
a900: 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a 20 20 43 65 iolated. */. Ce
a910: 6c 6c 49 6e 66 6f 20 64 65 62 75 67 69 6e 66 6f llInfo debuginfo
a920: 3b 0a 20 20 70 50 61 67 65 2d 3e 78 50 61 72 73 ;. pPage->xPars
a930: 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 eCell(pPage, pCe
a940: 6c 6c 2c 20 26 64 65 62 75 67 69 6e 66 6f 29 3b ll, &debuginfo);
a950: 0a 23 65 6e 64 69 66 0a 0a 20 20 6e 53 69 7a 65 .#endif.. nSize
a960: 20 3d 20 2a 70 49 74 65 72 3b 0a 20 20 69 66 28 = *pIter;. if(
a970: 20 6e 53 69 7a 65 3e 3d 30 78 38 30 20 29 7b 0a nSize>=0x80 ){.
a980: 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 74 65 pEnd = &pIte
a990: 72 5b 38 5d 3b 0a 20 20 20 20 6e 53 69 7a 65 20 r[8];. nSize
a9a0: 26 3d 20 30 78 37 66 3b 0a 20 20 20 20 64 6f 7b &= 0x7f;. do{
a9b0: 0a 20 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 28 . nSize = (
a9c0: 6e 53 69 7a 65 3c 3c 37 29 20 7c 20 28 2a 2b 2b nSize<<7) | (*++
a9d0: 70 49 74 65 72 20 26 20 30 78 37 66 29 3b 0a 20 pIter & 0x7f);.
a9e0: 20 20 20 7d 77 68 69 6c 65 28 20 2a 28 70 49 74 }while( *(pIt
a9f0: 65 72 29 3e 3d 30 78 38 30 20 26 26 20 70 49 74 er)>=0x80 && pIt
aa00: 65 72 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 0a 20 er<pEnd );. }.
aa10: 20 70 49 74 65 72 2b 2b 3b 0a 20 20 69 66 28 20 pIter++;. if(
aa20: 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b pPage->intKey ){
aa30: 0a 20 20 20 20 2f 2a 20 70 49 74 65 72 20 6e 6f . /* pIter no
aa40: 77 20 70 6f 69 6e 74 73 20 61 74 20 74 68 65 20 w points at the
aa50: 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 20 6b 64-bit integer k
aa60: 65 79 20 76 61 6c 75 65 2c 20 61 20 76 61 72 69 ey value, a vari
aa70: 61 62 6c 65 20 6c 65 6e 67 74 68 20 0a 20 20 20 able length .
aa80: 20 2a 2a 20 69 6e 74 65 67 65 72 2e 20 54 68 65 ** integer. The
aa90: 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b following block
aaa0: 20 6d 6f 76 65 73 20 70 49 74 65 72 20 74 6f 20 moves pIter to
aab0: 70 6f 69 6e 74 20 61 74 20 74 68 65 20 66 69 72 point at the fir
aac0: 73 74 20 62 79 74 65 0a 20 20 20 20 2a 2a 20 70 st byte. ** p
aad0: 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ast the end of t
aae0: 68 65 20 6b 65 79 20 76 61 6c 75 65 2e 20 2a 2f he key value. */
aaf0: 0a 20 20 20 20 70 45 6e 64 20 3d 20 26 70 49 74 . pEnd = &pIt
ab00: 65 72 5b 39 5d 3b 0a 20 20 20 20 77 68 69 6c 65 er[9];. while
ab10: 28 20 28 2a 70 49 74 65 72 2b 2b 29 26 30 78 38 ( (*pIter++)&0x8
ab20: 30 20 26 26 20 70 49 74 65 72 3c 70 45 6e 64 20 0 && pIter<pEnd
ab30: 29 3b 0a 20 20 7d 0a 20 20 74 65 73 74 63 61 73 );. }. testcas
ab40: 65 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d e( nSize==pPage-
ab50: 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 >maxLocal );. t
ab60: 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d estcase( nSize==
ab70: 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b pPage->maxLocal+
ab80: 31 20 29 3b 0a 20 20 69 66 28 20 6e 53 69 7a 65 1 );. if( nSize
ab90: 3c 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 <=pPage->maxLoca
aba0: 6c 20 29 7b 0a 20 20 20 20 6e 53 69 7a 65 20 2b l ){. nSize +
abb0: 3d 20 28 75 33 32 29 28 70 49 74 65 72 20 2d 20 = (u32)(pIter -
abc0: 70 43 65 6c 6c 29 3b 0a 20 20 20 20 69 66 28 20 pCell);. if(
abd0: 6e 53 69 7a 65 3c 34 20 29 20 6e 53 69 7a 65 20 nSize<4 ) nSize
abe0: 3d 20 34 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 = 4;. }else{.
abf0: 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 20 3d int minLocal =
ac00: 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c pPage->minLocal
ac10: 3b 0a 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 ;. nSize = mi
ac20: 6e 4c 6f 63 61 6c 20 2b 20 28 6e 53 69 7a 65 20 nLocal + (nSize
ac30: 2d 20 6d 69 6e 4c 6f 63 61 6c 29 20 25 20 28 70 - minLocal) % (p
ac40: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
ac50: 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 eSize - 4);.
ac60: 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d testcase( nSize=
ac70: 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c =pPage->maxLocal
ac80: 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 );. testcase
ac90: 28 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e ( nSize==pPage->
aca0: 6d 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 maxLocal+1 );.
acb0: 20 20 69 66 28 20 6e 53 69 7a 65 3e 70 50 61 67 if( nSize>pPag
acc0: 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 e->maxLocal ){.
acd0: 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 6e nSize = min
ace0: 4c 6f 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 Local;. }.
acf0: 20 6e 53 69 7a 65 20 2b 3d 20 34 20 2b 20 28 75 nSize += 4 + (u
ad00: 31 36 29 28 70 49 74 65 72 20 2d 20 70 43 65 6c 16)(pIter - pCel
ad10: 6c 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 l);. }. assert
ad20: 28 20 6e 53 69 7a 65 3d 3d 64 65 62 75 67 69 6e ( nSize==debugin
ad30: 66 6f 2e 6e 53 69 7a 65 20 7c 7c 20 43 4f 52 52 fo.nSize || CORR
ad40: 55 50 54 5f 44 42 20 29 3b 0a 20 20 72 65 74 75 UPT_DB );. retu
ad50: 72 6e 20 28 75 31 36 29 6e 53 69 7a 65 3b 0a 7d rn (u16)nSize;.}
ad60: 0a 73 74 61 74 69 63 20 75 31 36 20 63 65 6c 6c .static u16 cell
ad70: 53 69 7a 65 50 74 72 4e 6f 50 61 79 6c 6f 61 64 SizePtrNoPayload
ad80: 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c (MemPage *pPage,
ad90: 20 75 38 20 2a 70 43 65 6c 6c 29 7b 0a 20 20 75 u8 *pCell){. u
ada0: 38 20 2a 70 49 74 65 72 20 3d 20 70 43 65 6c 6c 8 *pIter = pCell
adb0: 20 2b 20 34 3b 20 2f 2a 20 46 6f 72 20 6c 6f 6f + 4; /* For loo
adc0: 70 69 6e 67 20 6f 76 65 72 20 62 79 74 65 73 20 ping over bytes
add0: 6f 66 20 70 43 65 6c 6c 20 2a 2f 0a 20 20 75 38 of pCell */. u8
ade0: 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 20 20 20 *pEnd;
adf0: 20 20 20 20 20 2f 2a 20 45 6e 64 20 6d 61 72 6b /* End mark
ae00: 20 66 6f 72 20 61 20 76 61 72 69 6e 74 20 2a 2f for a varint */
ae10: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
ae20: 44 45 42 55 47 0a 20 20 2f 2a 20 54 68 65 20 76 DEBUG. /* The v
ae30: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
ae40: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 this function s
ae50: 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 65 20 hould always be
ae60: 74 68 65 20 73 61 6d 65 20 61 73 0a 20 20 2a 2a the same as. **
ae70: 20 74 68 65 20 28 43 65 6c 6c 49 6e 66 6f 2e 6e the (CellInfo.n
ae80: 53 69 7a 65 29 20 76 61 6c 75 65 20 66 6f 75 6e Size) value foun
ae90: 64 20 62 79 20 64 6f 69 6e 67 20 61 20 66 75 6c d by doing a ful
aea0: 6c 20 70 61 72 73 65 20 6f 66 20 74 68 65 0a 20 l parse of the.
aeb0: 20 2a 2a 20 63 65 6c 6c 2e 20 49 66 20 53 51 4c ** cell. If SQL
aec0: 49 54 45 5f 44 45 42 55 47 20 69 73 20 64 65 66 ITE_DEBUG is def
aed0: 69 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 ined, an assert(
aee0: 29 20 61 74 20 74 68 65 20 62 6f 74 74 6f 6d 20 ) at the bottom
aef0: 6f 66 0a 20 20 2a 2a 20 74 68 69 73 20 66 75 6e of. ** this fun
af00: 63 74 69 6f 6e 20 76 65 72 69 66 69 65 73 20 74 ction verifies t
af10: 68 61 74 20 74 68 69 73 20 69 6e 76 61 72 69 61 hat this invaria
af20: 6e 74 20 69 73 20 6e 6f 74 20 76 69 6f 6c 61 74 nt is not violat
af30: 65 64 2e 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 ed. */. CellInf
af40: 6f 20 64 65 62 75 67 69 6e 66 6f 3b 0a 20 20 70 o debuginfo;. p
af50: 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c Page->xParseCell
af60: 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c 20 26 (pPage, pCell, &
af70: 64 65 62 75 67 69 6e 66 6f 29 3b 0a 23 65 6c 73 debuginfo);.#els
af80: 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d e. UNUSED_PARAM
af90: 45 54 45 52 28 70 50 61 67 65 29 3b 0a 23 65 6e ETER(pPage);.#en
afa0: 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 70 dif.. assert( p
afb0: 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 Page->childPtrSi
afc0: 7a 65 3d 3d 34 20 29 3b 0a 20 20 70 45 6e 64 20 ze==4 );. pEnd
afd0: 3d 20 70 49 74 65 72 20 2b 20 39 3b 0a 20 20 77 = pIter + 9;. w
afe0: 68 69 6c 65 28 20 28 2a 70 49 74 65 72 2b 2b 29 hile( (*pIter++)
aff0: 26 30 78 38 30 20 26 26 20 70 49 74 65 72 3c 70 &0x80 && pIter<p
b000: 45 6e 64 20 29 3b 0a 20 20 61 73 73 65 72 74 28 End );. assert(
b010: 20 64 65 62 75 67 69 6e 66 6f 2e 6e 53 69 7a 65 debuginfo.nSize
b020: 3d 3d 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 ==(u16)(pIter -
b030: 70 43 65 6c 6c 29 20 7c 7c 20 43 4f 52 52 55 50 pCell) || CORRUP
b040: 54 5f 44 42 20 29 3b 0a 20 20 72 65 74 75 72 6e T_DB );. return
b050: 20 28 75 31 36 29 28 70 49 74 65 72 20 2d 20 70 (u16)(pIter - p
b060: 43 65 6c 6c 29 3b 0a 7d 0a 0a 0a 23 69 66 64 65 Cell);.}...#ifde
b070: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f f SQLITE_DEBUG./
b080: 2a 20 54 68 69 73 20 76 61 72 69 61 74 69 6f 6e * This variation
b090: 20 6f 6e 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 on cellSizePtr(
b0a0: 29 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 ) is used inside
b0b0: 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 61 of assert() sta
b0c0: 74 65 6d 65 6e 74 73 0a 2a 2a 20 6f 6e 6c 79 2e tements.** only.
b0d0: 20 2a 2f 0a 73 74 61 74 69 63 20 75 31 36 20 63 */.static u16 c
b0e0: 65 6c 6c 53 69 7a 65 28 4d 65 6d 50 61 67 65 20 ellSize(MemPage
b0f0: 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 43 65 6c *pPage, int iCel
b100: 6c 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 l){. return pPa
b110: 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 50 ge->xCellSize(pP
b120: 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c 28 70 50 age, findCell(pP
b130: 61 67 65 2c 20 69 43 65 6c 6c 29 29 3b 0a 7d 0a age, iCell));.}.
b140: 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
b150: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
b160: 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 49 66 20 VACUUM./*.** If
b170: 74 68 65 20 63 65 6c 6c 20 70 43 65 6c 6c 2c 20 the cell pCell,
b180: 70 61 72 74 20 6f 66 20 70 61 67 65 20 70 50 61 part of page pPa
b190: 67 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 70 6f ge contains a po
b1a0: 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 61 6e 20 6f inter.** to an o
b1b0: 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 69 6e verflow page, in
b1c0: 73 65 72 74 20 61 6e 20 65 6e 74 72 79 20 69 6e sert an entry in
b1d0: 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d to the pointer-m
b1e0: 61 70 0a 2a 2a 20 66 6f 72 20 74 68 65 20 6f 76 ap.** for the ov
b1f0: 65 72 66 6c 6f 77 20 70 61 67 65 2e 0a 2a 2f 0a erflow page..*/.
b200: 73 74 61 74 69 63 20 76 6f 69 64 20 70 74 72 6d static void ptrm
b210: 61 70 50 75 74 4f 76 66 6c 50 74 72 28 4d 65 6d apPutOvflPtr(Mem
b220: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 75 38 20 Page *pPage, u8
b230: 2a 70 43 65 6c 6c 2c 20 69 6e 74 20 2a 70 52 43 *pCell, int *pRC
b240: 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e ){. CellInfo in
b250: 66 6f 3b 0a 20 20 69 66 28 20 2a 70 52 43 20 29 fo;. if( *pRC )
b260: 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 72 return;. asser
b270: 74 28 20 70 43 65 6c 6c 21 3d 30 20 29 3b 0a 20 t( pCell!=0 );.
b280: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
b290: 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c ll(pPage, pCell,
b2a0: 20 26 69 6e 66 6f 29 3b 0a 20 20 69 66 28 20 69 &info);. if( i
b2b0: 6e 66 6f 2e 6e 4c 6f 63 61 6c 3c 69 6e 66 6f 2e nfo.nLocal<info.
b2c0: 6e 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 nPayload ){.
b2d0: 50 67 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 34 Pgno ovfl = get4
b2e0: 62 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f byte(&pCell[info
b2f0: 2e 6e 53 69 7a 65 2d 34 5d 29 3b 0a 20 20 20 20 .nSize-4]);.
b300: 70 74 72 6d 61 70 50 75 74 28 70 50 61 67 65 2d ptrmapPut(pPage-
b310: 3e 70 42 74 2c 20 6f 76 66 6c 2c 20 50 54 52 4d >pBt, ovfl, PTRM
b320: 41 50 5f 4f 56 45 52 46 4c 4f 57 31 2c 20 70 50 AP_OVERFLOW1, pP
b330: 61 67 65 2d 3e 70 67 6e 6f 2c 20 70 52 43 29 3b age->pgno, pRC);
b340: 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a . }.}.#endif...
b350: 2f 2a 0a 2a 2a 20 44 65 66 72 61 67 6d 65 6e 74 /*.** Defragment
b360: 20 74 68 65 20 70 61 67 65 20 67 69 76 65 6e 2e the page given.
b370: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 This routine re
b380: 6f 72 67 61 6e 69 7a 65 73 20 63 65 6c 6c 73 20 organizes cells
b390: 77 69 74 68 69 6e 20 74 68 65 0a 2a 2a 20 70 61 within the.** pa
b3a0: 67 65 20 73 6f 20 74 68 61 74 20 74 68 65 72 65 ge so that there
b3b0: 20 61 72 65 20 6e 6f 20 66 72 65 65 2d 62 6c 6f are no free-blo
b3c0: 63 6b 73 20 6f 6e 20 74 68 65 20 66 72 65 65 2d cks on the free-
b3d0: 62 6c 6f 63 6b 20 6c 69 73 74 2e 0a 2a 2a 0a 2a block list..**.*
b3e0: 2a 20 50 61 72 61 6d 65 74 65 72 20 6e 4d 61 78 * Parameter nMax
b3f0: 46 72 61 67 20 69 73 20 74 68 65 20 6d 61 78 69 Frag is the maxi
b400: 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 66 72 mum amount of fr
b410: 61 67 6d 65 6e 74 65 64 20 73 70 61 63 65 20 74 agmented space t
b420: 68 61 74 20 6d 61 79 20 62 65 0a 2a 2a 20 70 72 hat may be.** pr
b430: 65 73 65 6e 74 20 69 6e 20 74 68 65 20 70 61 67 esent in the pag
b440: 65 20 61 66 74 65 72 20 74 68 69 73 20 72 6f 75 e after this rou
b450: 74 69 6e 65 20 72 65 74 75 72 6e 73 2e 0a 2a 2a tine returns..**
b460: 0a 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a .** EVIDENCE-OF:
b470: 20 52 2d 34 34 35 38 32 2d 36 30 31 33 38 20 53 R-44582-60138 S
b480: 51 4c 69 74 65 20 6d 61 79 20 66 72 6f 6d 20 74 QLite may from t
b490: 69 6d 65 20 74 6f 20 74 69 6d 65 20 72 65 6f 72 ime to time reor
b4a0: 67 61 6e 69 7a 65 20 61 0a 2a 2a 20 62 2d 74 72 ganize a.** b-tr
b4b0: 65 65 20 70 61 67 65 20 73 6f 20 74 68 61 74 20 ee page so that
b4c0: 74 68 65 72 65 20 61 72 65 20 6e 6f 20 66 72 65 there are no fre
b4d0: 65 62 6c 6f 63 6b 73 20 6f 72 20 66 72 61 67 6d eblocks or fragm
b4e0: 65 6e 74 20 62 79 74 65 73 2c 20 61 6c 6c 0a 2a ent bytes, all.*
b4f0: 2a 20 75 6e 75 73 65 64 20 62 79 74 65 73 20 61 * unused bytes a
b500: 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 re contained in
b510: 74 68 65 20 75 6e 61 6c 6c 6f 63 61 74 65 64 20 the unallocated
b520: 73 70 61 63 65 20 72 65 67 69 6f 6e 2c 20 61 6e space region, an
b530: 64 20 61 6c 6c 0a 2a 2a 20 63 65 6c 6c 73 20 61 d all.** cells a
b540: 72 65 20 70 61 63 6b 65 64 20 74 69 67 68 74 6c re packed tightl
b550: 79 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 y at the end of
b560: 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 the page..*/.sta
b570: 74 69 63 20 69 6e 74 20 64 65 66 72 61 67 6d 65 tic int defragme
b580: 6e 74 50 61 67 65 28 4d 65 6d 50 61 67 65 20 2a ntPage(MemPage *
b590: 70 50 61 67 65 2c 20 69 6e 74 20 6e 4d 61 78 46 pPage, int nMaxF
b5a0: 72 61 67 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 rag){. int i;
b5b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b5c0: 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 /* Loop count
b5d0: 65 72 20 2a 2f 0a 20 20 69 6e 74 20 70 63 3b 20 er */. int pc;
b5e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b5f0: 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 /* Address of
b600: 20 74 68 65 20 69 2d 74 68 20 63 65 6c 6c 20 2a the i-th cell *
b610: 2f 0a 20 20 69 6e 74 20 68 64 72 3b 20 20 20 20 /. int hdr;
b620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
b630: 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 * Offset to the
b640: 70 61 67 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 page header */.
b650: 20 69 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 int size;
b660: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
b670: 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a 2f ize of a cell */
b680: 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 53 69 7a . int usableSiz
b690: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
b6a0: 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 61 62 6c Number of usabl
b6b0: 65 20 62 79 74 65 73 20 6f 6e 20 61 20 70 61 67 e bytes on a pag
b6c0: 65 20 2a 2f 0a 20 20 69 6e 74 20 63 65 6c 6c 4f e */. int cellO
b6d0: 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 20 ffset;
b6e0: 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 74 /* Offset to t
b6f0: 68 65 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 he cell pointer
b700: 61 72 72 61 79 20 2a 2f 0a 20 20 69 6e 74 20 63 array */. int c
b710: 62 72 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 brk;
b720: 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 /* Offset
b730: 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 to the cell cont
b740: 65 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 69 6e ent area */. in
b750: 74 20 6e 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 t nCell;
b760: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
b770: 65 72 20 6f 66 20 63 65 6c 6c 73 20 6f 6e 20 74 er of cells on t
b780: 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 6e 73 he page */. uns
b790: 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 igned char *data
b7a0: 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 ; /* The p
b7b0: 61 67 65 20 64 61 74 61 20 2a 2f 0a 20 20 75 6e age data */. un
b7c0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 74 65 6d signed char *tem
b7d0: 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 65 6d 70 p; /* Temp
b7e0: 20 61 72 65 61 20 66 6f 72 20 63 65 6c 6c 20 63 area for cell c
b7f0: 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 75 6e 73 69 ontent */. unsi
b800: 67 6e 65 64 20 63 68 61 72 20 2a 73 72 63 3b 20 gned char *src;
b810: 20 20 20 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 /* Source
b820: 20 6f 66 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 of content */.
b830: 20 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b int iCellFirst;
b840: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
b850: 69 72 73 74 20 61 6c 6c 6f 77 61 62 6c 65 20 63 irst allowable c
b860: 65 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 ell index */. i
b870: 6e 74 20 69 43 65 6c 6c 4c 61 73 74 3b 20 20 20 nt iCellLast;
b880: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 /* Las
b890: 74 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 t possible cell
b8a0: 69 6e 64 65 78 20 2a 2f 0a 0a 20 20 61 73 73 65 index */.. asse
b8b0: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
b8c0: 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
b8d0: 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
b8e0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
b8f0: 70 42 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 pBt!=0 );. asse
b900: 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e rt( pPage->pBt->
b910: 75 73 61 62 6c 65 53 69 7a 65 20 3c 3d 20 53 51 usableSize <= SQ
b920: 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
b930: 5a 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ZE );. assert(
b940: 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
b950: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
b960: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
b970: 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
b980: 6d 75 74 65 78 29 20 29 3b 0a 20 20 74 65 6d 70 mutex) );. temp
b990: 20 3d 20 30 3b 0a 20 20 73 72 63 20 3d 20 64 61 = 0;. src = da
b9a0: 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 ta = pPage->aDat
b9b0: 61 3b 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 a;. hdr = pPage
b9c0: 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 63 ->hdrOffset;. c
b9d0: 65 6c 6c 4f 66 66 73 65 74 20 3d 20 70 50 61 67 ellOffset = pPag
b9e0: 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 3b 0a 20 e->cellOffset;.
b9f0: 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e nCell = pPage->
ba00: 6e 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 74 28 nCell;. assert(
ba10: 20 6e 43 65 6c 6c 3d 3d 67 65 74 32 62 79 74 65 nCell==get2byte
ba20: 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 20 29 (&data[hdr+3]) )
ba30: 3b 0a 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d ;. iCellFirst =
ba40: 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a cellOffset + 2*
ba50: 6e 43 65 6c 6c 3b 0a 20 20 75 73 61 62 6c 65 53 nCell;. usableS
ba60: 69 7a 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 ize = pPage->pBt
ba70: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 0a 20 ->usableSize;..
ba80: 20 2f 2a 20 54 68 69 73 20 62 6c 6f 63 6b 20 68 /* This block h
ba90: 61 6e 64 6c 65 73 20 70 61 67 65 73 20 77 69 74 andles pages wit
baa0: 68 20 74 77 6f 20 6f 72 20 66 65 77 65 72 20 66 h two or fewer f
bab0: 72 65 65 20 62 6c 6f 63 6b 73 20 61 6e 64 20 6e ree blocks and n
bac0: 4d 61 78 46 72 61 67 0a 20 20 2a 2a 20 6f 72 20 MaxFrag. ** or
bad0: 66 65 77 65 72 20 66 72 61 67 6d 65 6e 74 65 64 fewer fragmented
bae0: 20 62 79 74 65 73 2e 20 49 6e 20 74 68 69 73 20 bytes. In this
baf0: 63 61 73 65 20 69 74 20 69 73 20 66 61 73 74 65 case it is faste
bb00: 72 20 74 6f 20 6d 6f 76 65 20 74 68 65 0a 20 20 r to move the.
bb10: 2a 2a 20 74 77 6f 20 28 6f 72 20 6f 6e 65 29 20 ** two (or one)
bb20: 62 6c 6f 63 6b 73 20 6f 66 20 63 65 6c 6c 73 20 blocks of cells
bb30: 75 73 69 6e 67 20 6d 65 6d 6d 6f 76 65 28 29 20 using memmove()
bb40: 61 6e 64 20 61 64 64 20 74 68 65 20 72 65 71 75 and add the requ
bb50: 69 72 65 64 0a 20 20 2a 2a 20 6f 66 66 73 65 74 ired. ** offset
bb60: 73 20 74 6f 20 65 61 63 68 20 70 6f 69 6e 74 65 s to each pointe
bb70: 72 20 69 6e 20 74 68 65 20 63 65 6c 6c 2d 70 6f r in the cell-po
bb80: 69 6e 74 65 72 20 61 72 72 61 79 20 74 68 61 6e inter array than
bb90: 20 69 74 20 69 73 20 74 6f 20 0a 20 20 2a 2a 20 it is to . **
bba0: 72 65 63 6f 6e 73 74 72 75 63 74 20 74 68 65 20 reconstruct the
bbb0: 65 6e 74 69 72 65 20 70 61 67 65 2e 20 20 2a 2f entire page. */
bbc0: 0a 20 20 69 66 28 20 28 69 6e 74 29 64 61 74 61 . if( (int)data
bbd0: 5b 68 64 72 2b 37 5d 3c 3d 6e 4d 61 78 46 72 61 [hdr+7]<=nMaxFra
bbe0: 67 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 46 72 g ){. int iFr
bbf0: 65 65 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 ee = get2byte(&d
bc00: 61 74 61 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 20 ata[hdr+1]);.
bc10: 20 69 66 28 20 69 46 72 65 65 20 29 7b 0a 20 20 if( iFree ){.
bc20: 20 20 20 20 69 6e 74 20 69 46 72 65 65 32 20 3d int iFree2 =
bc30: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
bc40: 69 46 72 65 65 5d 29 3b 0a 0a 20 20 20 20 20 20 iFree]);..
bc50: 2f 2a 20 70 61 67 65 46 69 6e 64 53 6c 6f 74 28 /* pageFindSlot(
bc60: 29 20 68 61 73 20 61 6c 72 65 61 64 79 20 76 65 ) has already ve
bc70: 72 69 66 69 65 64 20 74 68 61 74 20 66 72 65 65 rified that free
bc80: 20 62 6c 6f 63 6b 73 20 61 72 65 20 73 6f 72 74 blocks are sort
bc90: 65 64 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 6f ed. ** in o
bca0: 72 64 65 72 20 6f 66 20 6f 66 66 73 65 74 20 77 rder of offset w
bcb0: 69 74 68 69 6e 20 74 68 65 20 70 61 67 65 2c 20 ithin the page,
bcc0: 61 6e 64 20 74 68 61 74 20 6e 6f 20 62 6c 6f 63 and that no bloc
bcd0: 6b 20 65 78 74 65 6e 64 73 0a 20 20 20 20 20 20 k extends.
bce0: 2a 2a 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 ** past the end
bcf0: 6f 66 20 74 68 65 20 70 61 67 65 2e 20 50 72 6f of the page. Pro
bd00: 76 69 64 65 64 20 74 68 65 20 74 77 6f 20 66 72 vided the two fr
bd10: 65 65 20 73 6c 6f 74 73 20 64 6f 20 6e 6f 74 20 ee slots do not
bd20: 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 6c 61 . ** overla
bd30: 70 2c 20 74 68 69 73 20 67 75 61 72 61 6e 74 65 p, this guarante
bd40: 65 73 20 74 68 61 74 20 74 68 65 20 6d 65 6d 6d es that the memm
bd50: 6f 76 65 28 29 20 63 61 6c 6c 73 20 62 65 6c 6f ove() calls belo
bd60: 77 20 77 69 6c 6c 20 6e 6f 74 0a 20 20 20 20 20 w will not.
bd70: 20 2a 2a 20 6f 76 65 72 77 72 69 74 65 20 74 68 ** overwrite th
bd80: 65 20 75 73 61 62 6c 65 53 69 7a 65 20 62 79 74 e usableSize byt
bd90: 65 20 62 75 66 66 65 72 2c 20 65 76 65 6e 20 69 e buffer, even i
bda0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 70 f the database p
bdb0: 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 age. ** is
bdc0: 63 6f 72 72 75 70 74 2e 20 20 2a 2f 0a 20 20 20 corrupt. */.
bdd0: 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 assert( iFree
bde0: 32 3d 3d 30 20 7c 7c 20 69 46 72 65 65 32 3e 69 2==0 || iFree2>i
bdf0: 46 72 65 65 20 29 3b 0a 20 20 20 20 20 20 61 73 Free );. as
be00: 73 65 72 74 28 20 69 46 72 65 65 2b 67 65 74 32 sert( iFree+get2
be10: 62 79 74 65 28 26 64 61 74 61 5b 69 46 72 65 65 byte(&data[iFree
be20: 2b 32 5d 29 20 3c 3d 20 75 73 61 62 6c 65 53 69 +2]) <= usableSi
be30: 7a 65 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 ze );. asse
be40: 72 74 28 20 69 46 72 65 65 32 3d 3d 30 20 7c 7c rt( iFree2==0 ||
be50: 20 69 46 72 65 65 32 2b 67 65 74 32 62 79 74 65 iFree2+get2byte
be60: 28 26 64 61 74 61 5b 69 46 72 65 65 32 2b 32 5d (&data[iFree2+2]
be70: 29 20 3c 3d 20 75 73 61 62 6c 65 53 69 7a 65 20 ) <= usableSize
be80: 29 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 30 3d );.. if( 0=
be90: 3d 69 46 72 65 65 32 20 7c 7c 20 28 64 61 74 61 =iFree2 || (data
bea0: 5b 69 46 72 65 65 32 5d 3d 3d 30 20 26 26 20 64 [iFree2]==0 && d
beb0: 61 74 61 5b 69 46 72 65 65 32 2b 31 5d 3d 3d 30 ata[iFree2+1]==0
bec0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 75 38 20 ) ){. u8
bed0: 2a 70 45 6e 64 20 3d 20 26 64 61 74 61 5b 63 65 *pEnd = &data[ce
bee0: 6c 6c 4f 66 66 73 65 74 20 2b 20 6e 43 65 6c 6c llOffset + nCell
bef0: 2a 32 5d 3b 0a 20 20 20 20 20 20 20 20 75 38 20 *2];. u8
bf00: 2a 70 41 64 64 72 3b 0a 20 20 20 20 20 20 20 20 *pAddr;.
bf10: 69 6e 74 20 73 7a 32 20 3d 20 30 3b 0a 20 20 20 int sz2 = 0;.
bf20: 20 20 20 20 20 69 6e 74 20 73 7a 20 3d 20 67 65 int sz = ge
bf30: 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 72 t2byte(&data[iFr
bf40: 65 65 2b 32 5d 29 3b 0a 20 20 20 20 20 20 20 20 ee+2]);.
bf50: 69 6e 74 20 74 6f 70 20 3d 20 67 65 74 32 62 79 int top = get2by
bf60: 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 te(&data[hdr+5])
bf70: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 74 6f ;. if( to
bf80: 70 3e 3d 69 46 72 65 65 20 29 7b 0a 20 20 20 20 p>=iFree ){.
bf90: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
bfa0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
bfb0: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 (pPage);.
bfc0: 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 }. if( i
bfd0: 46 72 65 65 32 20 29 7b 0a 20 20 20 20 20 20 20 Free2 ){.
bfe0: 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 assert( iFree
bff0: 2b 73 7a 3c 3d 69 46 72 65 65 32 20 29 3b 20 2f +sz<=iFree2 ); /
c000: 2a 20 56 65 72 69 66 69 65 64 20 62 79 20 70 61 * Verified by pa
c010: 67 65 46 69 6e 64 53 6c 6f 74 28 29 20 2a 2f 0a geFindSlot() */.
c020: 20 20 20 20 20 20 20 20 20 20 73 7a 32 20 3d 20 sz2 =
c030: 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 get2byte(&data[i
c040: 46 72 65 65 32 2b 32 5d 29 3b 0a 20 20 20 20 20 Free2+2]);.
c050: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 46 72 assert( iFr
c060: 65 65 2b 73 7a 2b 73 7a 32 2b 69 46 72 65 65 32 ee+sz+sz2+iFree2
c070: 2d 28 69 46 72 65 65 2b 73 7a 29 20 3c 3d 20 75 -(iFree+sz) <= u
c080: 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 sableSize );.
c090: 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 28 26 memmove(&
c0a0: 64 61 74 61 5b 69 46 72 65 65 2b 73 7a 2b 73 7a data[iFree+sz+sz
c0b0: 32 5d 2c 20 26 64 61 74 61 5b 69 46 72 65 65 2b 2], &data[iFree+
c0c0: 73 7a 5d 2c 20 69 46 72 65 65 32 2d 28 69 46 72 sz], iFree2-(iFr
c0d0: 65 65 2b 73 7a 29 29 3b 0a 20 20 20 20 20 20 20 ee+sz));.
c0e0: 20 20 20 73 7a 20 2b 3d 20 73 7a 32 3b 0a 20 20 sz += sz2;.
c0f0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
c100: 63 62 72 6b 20 3d 20 74 6f 70 2b 73 7a 3b 0a 20 cbrk = top+sz;.
c110: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 63 assert( c
c120: 62 72 6b 2b 28 69 46 72 65 65 2d 74 6f 70 29 20 brk+(iFree-top)
c130: 3c 3d 20 75 73 61 62 6c 65 53 69 7a 65 20 29 3b <= usableSize );
c140: 0a 20 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 . memmove
c150: 28 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 26 64 (&data[cbrk], &d
c160: 61 74 61 5b 74 6f 70 5d 2c 20 69 46 72 65 65 2d ata[top], iFree-
c170: 74 6f 70 29 3b 0a 20 20 20 20 20 20 20 20 66 6f top);. fo
c180: 72 28 70 41 64 64 72 3d 26 64 61 74 61 5b 63 65 r(pAddr=&data[ce
c190: 6c 6c 4f 66 66 73 65 74 5d 3b 20 70 41 64 64 72 llOffset]; pAddr
c1a0: 3c 70 45 6e 64 3b 20 70 41 64 64 72 2b 3d 32 29 <pEnd; pAddr+=2)
c1b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 70 63 20 3d {. pc =
c1c0: 20 67 65 74 32 62 79 74 65 28 70 41 64 64 72 29 get2byte(pAddr)
c1d0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
c1e0: 70 63 3c 69 46 72 65 65 20 29 7b 20 70 75 74 32 pc<iFree ){ put2
c1f0: 62 79 74 65 28 70 41 64 64 72 2c 20 70 63 2b 73 byte(pAddr, pc+s
c200: 7a 29 3b 20 7d 0a 20 20 20 20 20 20 20 20 20 20 z); }.
c210: 65 6c 73 65 20 69 66 28 20 70 63 3c 69 46 72 65 else if( pc<iFre
c220: 65 32 20 29 7b 20 70 75 74 32 62 79 74 65 28 70 e2 ){ put2byte(p
c230: 41 64 64 72 2c 20 70 63 2b 73 7a 32 29 3b 20 7d Addr, pc+sz2); }
c240: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
c250: 20 20 20 67 6f 74 6f 20 64 65 66 72 61 67 6d 65 goto defragme
c260: 6e 74 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a nt_out;. }.
c270: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 63 62 72 }. }.. cbr
c280: 6b 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a k = usableSize;.
c290: 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 iCellLast = us
c2a0: 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 ableSize - 4;.
c2b0: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c for(i=0; i<nCell
c2c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a ; i++){. u8 *
c2d0: 70 41 64 64 72 3b 20 20 20 20 20 2f 2a 20 54 68 pAddr; /* Th
c2e0: 65 20 69 2d 74 68 20 63 65 6c 6c 20 70 6f 69 6e e i-th cell poin
c2f0: 74 65 72 20 2a 2f 0a 20 20 20 20 70 41 64 64 72 ter */. pAddr
c300: 20 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 = &data[cellOff
c310: 73 65 74 20 2b 20 69 2a 32 5d 3b 0a 20 20 20 20 set + i*2];.
c320: 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 70 41 pc = get2byte(pA
c330: 64 64 72 29 3b 0a 20 20 20 20 74 65 73 74 63 61 ddr);. testca
c340: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 se( pc==iCellFir
c350: 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 st );. testca
c360: 73 65 28 20 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 se( pc==iCellLas
c370: 74 20 29 3b 0a 20 20 20 20 2f 2a 20 54 68 65 73 t );. /* Thes
c380: 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 68 61 76 e conditions hav
c390: 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 76 e already been v
c3a0: 65 72 69 66 69 65 64 20 69 6e 20 62 74 72 65 65 erified in btree
c3b0: 49 6e 69 74 50 61 67 65 28 29 0a 20 20 20 20 2a InitPage(). *
c3c0: 2a 20 69 66 20 50 52 41 47 4d 41 20 63 65 6c 6c * if PRAGMA cell
c3d0: 5f 73 69 7a 65 5f 63 68 65 63 6b 3d 4f 4e 2e 0a _size_check=ON..
c3e0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 */. if( p
c3f0: 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 c<iCellFirst ||
c400: 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
c410: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
c420: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
c430: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 (pPage);. }.
c440: 20 20 20 61 73 73 65 72 74 28 20 70 63 3e 3d 69 assert( pc>=i
c450: 43 65 6c 6c 46 69 72 73 74 20 26 26 20 70 63 3c CellFirst && pc<
c460: 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 =iCellLast );.
c470: 20 20 73 69 7a 65 20 3d 20 70 50 61 67 65 2d 3e size = pPage->
c480: 78 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c xCellSize(pPage,
c490: 20 26 73 72 63 5b 70 63 5d 29 3b 0a 20 20 20 20 &src[pc]);.
c4a0: 63 62 72 6b 20 2d 3d 20 73 69 7a 65 3b 0a 20 20 cbrk -= size;.
c4b0: 20 20 69 66 28 20 63 62 72 6b 3c 69 43 65 6c 6c if( cbrk<iCell
c4c0: 46 69 72 73 74 20 7c 7c 20 70 63 2b 73 69 7a 65 First || pc+size
c4d0: 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
c4e0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
c4f0: 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 TE_CORRUPT_PAGE(
c500: 70 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 pPage);. }.
c510: 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 2b 73 assert( cbrk+s
c520: 69 7a 65 3c 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize<=usableSize
c530: 26 26 20 63 62 72 6b 3e 3d 69 43 65 6c 6c 46 69 && cbrk>=iCellFi
c540: 72 73 74 20 29 3b 0a 20 20 20 20 74 65 73 74 63 rst );. testc
c550: 61 73 65 28 20 63 62 72 6b 2b 73 69 7a 65 3d 3d ase( cbrk+size==
c560: 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 usableSize );.
c570: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
c580: 69 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 ize==usableSize
c590: 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
c5a0: 70 41 64 64 72 2c 20 63 62 72 6b 29 3b 0a 20 20 pAddr, cbrk);.
c5b0: 20 20 69 66 28 20 74 65 6d 70 3d 3d 30 20 29 7b if( temp==0 ){
c5c0: 0a 20 20 20 20 20 20 69 6e 74 20 78 3b 0a 20 20 . int x;.
c5d0: 20 20 20 20 69 66 28 20 63 62 72 6b 3d 3d 70 63 if( cbrk==pc
c5e0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
c5f0: 20 20 20 74 65 6d 70 20 3d 20 73 71 6c 69 74 65 temp = sqlite
c600: 33 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 28 3PagerTempSpace(
c610: 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 50 61 67 pPage->pBt->pPag
c620: 65 72 29 3b 0a 20 20 20 20 20 20 78 20 3d 20 67 er);. x = g
c630: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 et2byte(&data[hd
c640: 72 2b 35 5d 29 3b 0a 20 20 20 20 20 20 6d 65 6d r+5]);. mem
c650: 63 70 79 28 26 74 65 6d 70 5b 78 5d 2c 20 26 64 cpy(&temp[x], &d
c660: 61 74 61 5b 78 5d 2c 20 28 63 62 72 6b 2b 73 69 ata[x], (cbrk+si
c670: 7a 65 29 20 2d 20 78 29 3b 0a 20 20 20 20 20 20 ze) - x);.
c680: 73 72 63 20 3d 20 74 65 6d 70 3b 0a 20 20 20 20 src = temp;.
c690: 7d 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 }. memcpy(&da
c6a0: 74 61 5b 63 62 72 6b 5d 2c 20 26 73 72 63 5b 70 ta[cbrk], &src[p
c6b0: 63 5d 2c 20 73 69 7a 65 29 3b 0a 20 20 7d 0a 20 c], size);. }.
c6c0: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 data[hdr+7] = 0
c6d0: 3b 0a 0a 20 64 65 66 72 61 67 6d 65 6e 74 5f 6f ;.. defragment_o
c6e0: 75 74 3a 0a 20 20 69 66 28 20 64 61 74 61 5b 68 ut:. if( data[h
c6f0: 64 72 2b 37 5d 2b 63 62 72 6b 2d 69 43 65 6c 6c dr+7]+cbrk-iCell
c700: 46 69 72 73 74 21 3d 70 50 61 67 65 2d 3e 6e 46 First!=pPage->nF
c710: 72 65 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ree ){. retur
c720: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
c730: 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
c740: 7d 0a 20 20 61 73 73 65 72 74 28 20 63 62 72 6b }. assert( cbrk
c750: 3e 3d 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a >=iCellFirst );.
c760: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
c770: 5b 68 64 72 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a [hdr+5], cbrk);.
c780: 20 20 64 61 74 61 5b 68 64 72 2b 31 5d 20 3d 20 data[hdr+1] =
c790: 30 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 32 5d 0;. data[hdr+2]
c7a0: 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 26 = 0;. memset(&
c7b0: 64 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 74 5d data[iCellFirst]
c7c0: 2c 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c 6c 46 , 0, cbrk-iCellF
c7d0: 69 72 73 74 29 3b 0a 20 20 61 73 73 65 72 74 28 irst);. assert(
c7e0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
c7f0: 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e riteable(pPage->
c800: 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 65 pDbPage) );. re
c810: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
c820: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 20 }../*.** Search
c830: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 6f 6e the free-list on
c840: 20 70 61 67 65 20 70 50 67 20 66 6f 72 20 73 70 page pPg for sp
c850: 61 63 65 20 74 6f 20 73 74 6f 72 65 20 61 20 63 ace to store a c
c860: 65 6c 6c 20 6e 42 79 74 65 20 62 79 74 65 73 20 ell nByte bytes
c870: 69 6e 0a 2a 2a 20 73 69 7a 65 2e 20 49 66 20 6f in.** size. If o
c880: 6e 65 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c ne can be found,
c890: 20 72 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 return a pointe
c8a0: 72 20 74 6f 20 74 68 65 20 73 70 61 63 65 20 61 r to the space a
c8b0: 6e 64 20 72 65 6d 6f 76 65 20 69 74 0a 2a 2a 20 nd remove it.**
c8c0: 66 72 6f 6d 20 74 68 65 20 66 72 65 65 2d 6c 69 from the free-li
c8d0: 73 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 20 st..**.** If no
c8e0: 73 75 69 74 61 62 6c 65 20 73 70 61 63 65 20 63 suitable space c
c8f0: 61 6e 20 62 65 20 66 6f 75 6e 64 20 6f 6e 20 74 an be found on t
c900: 68 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 72 65 he free-list, re
c910: 74 75 72 6e 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a turn NULL..**.**
c920: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d This function m
c930: 61 79 20 64 65 74 65 63 74 20 63 6f 72 72 75 70 ay detect corrup
c940: 74 69 6f 6e 20 77 69 74 68 69 6e 20 70 50 67 2e tion within pPg.
c950: 20 20 49 66 20 63 6f 72 72 75 70 74 69 6f 6e 20 If corruption
c960: 69 73 0a 2a 2a 20 64 65 74 65 63 74 65 64 20 74 is.** detected t
c970: 68 65 6e 20 2a 70 52 63 20 69 73 20 73 65 74 20 hen *pRc is set
c980: 74 6f 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 to SQLITE_CORRUP
c990: 54 20 61 6e 64 20 4e 55 4c 4c 20 69 73 20 72 65 T and NULL is re
c9a0: 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 53 6c turned..**.** Sl
c9b0: 6f 74 73 20 6f 6e 20 74 68 65 20 66 72 65 65 20 ots on the free
c9c0: 6c 69 73 74 20 74 68 61 74 20 61 72 65 20 62 65 list that are be
c9d0: 74 77 65 65 6e 20 31 20 61 6e 64 20 33 20 62 79 tween 1 and 3 by
c9e0: 74 65 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 tes larger than
c9f0: 6e 42 79 74 65 0a 2a 2a 20 77 69 6c 6c 20 62 65 nByte.** will be
ca00: 20 69 67 6e 6f 72 65 64 20 69 66 20 61 64 64 69 ignored if addi
ca10: 6e 67 20 74 68 65 20 65 78 74 72 61 20 73 70 61 ng the extra spa
ca20: 63 65 20 74 6f 20 74 68 65 20 66 72 61 67 6d 65 ce to the fragme
ca30: 6e 74 61 74 69 6f 6e 20 63 6f 75 6e 74 0a 2a 2a ntation count.**
ca40: 20 63 61 75 73 65 73 20 74 68 65 20 66 72 61 67 causes the frag
ca50: 6d 65 6e 74 61 74 69 6f 6e 20 63 6f 75 6e 74 20 mentation count
ca60: 74 6f 20 65 78 63 65 65 64 20 36 30 2e 0a 2a 2f to exceed 60..*/
ca70: 0a 73 74 61 74 69 63 20 75 38 20 2a 70 61 67 65 .static u8 *page
ca80: 46 69 6e 64 53 6c 6f 74 28 4d 65 6d 50 61 67 65 FindSlot(MemPage
ca90: 20 2a 70 50 67 2c 20 69 6e 74 20 6e 42 79 74 65 *pPg, int nByte
caa0: 2c 20 69 6e 74 20 2a 70 52 63 29 7b 0a 20 20 63 , int *pRc){. c
cab0: 6f 6e 73 74 20 69 6e 74 20 68 64 72 20 3d 20 70 onst int hdr = p
cac0: 50 67 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 Pg->hdrOffset;.
cad0: 20 75 38 20 2a 20 63 6f 6e 73 74 20 61 44 61 74 u8 * const aDat
cae0: 61 20 3d 20 70 50 67 2d 3e 61 44 61 74 61 3b 0a a = pPg->aData;.
caf0: 20 20 69 6e 74 20 69 41 64 64 72 20 3d 20 68 64 int iAddr = hd
cb00: 72 20 2b 20 31 3b 0a 20 20 69 6e 74 20 70 63 20 r + 1;. int pc
cb10: 3d 20 67 65 74 32 62 79 74 65 28 26 61 44 61 74 = get2byte(&aDat
cb20: 61 5b 69 41 64 64 72 5d 29 3b 0a 20 20 69 6e 74 a[iAddr]);. int
cb30: 20 78 3b 0a 20 20 69 6e 74 20 75 73 61 62 6c 65 x;. int usable
cb40: 53 69 7a 65 20 3d 20 70 50 67 2d 3e 70 42 74 2d Size = pPg->pBt-
cb50: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 69 >usableSize;. i
cb60: 6e 74 20 73 69 7a 65 3b 20 20 20 20 20 20 20 20 nt size;
cb70: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
cb80: 68 65 20 66 72 65 65 20 73 6c 6f 74 20 2a 2f 0a he free slot */.
cb90: 0a 20 20 61 73 73 65 72 74 28 20 70 63 3e 30 20 . assert( pc>0
cba0: 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 63 3c 3d );. while( pc<=
cbb0: 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 29 7b 0a usableSize-4 ){.
cbc0: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
cbd0: 4f 46 3a 20 52 2d 32 32 37 31 30 2d 35 33 33 32 OF: R-22710-5332
cbe0: 38 20 54 68 65 20 74 68 69 72 64 20 61 6e 64 20 8 The third and
cbf0: 66 6f 75 72 74 68 20 62 79 74 65 73 20 6f 66 20 fourth bytes of
cc00: 65 61 63 68 0a 20 20 20 20 2a 2a 20 66 72 65 65 each. ** free
cc10: 62 6c 6f 63 6b 20 66 6f 72 6d 20 61 20 62 69 67 block form a big
cc20: 2d 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 -endian integer
cc30: 77 68 69 63 68 20 69 73 20 74 68 65 20 73 69 7a which is the siz
cc40: 65 20 6f 66 20 74 68 65 20 66 72 65 65 62 6c 6f e of the freeblo
cc50: 63 6b 0a 20 20 20 20 2a 2a 20 69 6e 20 62 79 74 ck. ** in byt
cc60: 65 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 es, including th
cc70: 65 20 34 2d 62 79 74 65 20 68 65 61 64 65 72 2e e 4-byte header.
cc80: 20 2a 2f 0a 20 20 20 20 73 69 7a 65 20 3d 20 67 */. size = g
cc90: 65 74 32 62 79 74 65 28 26 61 44 61 74 61 5b 70 et2byte(&aData[p
cca0: 63 2b 32 5d 29 3b 0a 20 20 20 20 69 66 28 20 28 c+2]);. if( (
ccb0: 78 20 3d 20 73 69 7a 65 20 2d 20 6e 42 79 74 65 x = size - nByte
ccc0: 29 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 74 65 )>=0 ){. te
ccd0: 73 74 63 61 73 65 28 20 78 3d 3d 34 20 29 3b 0a stcase( x==4 );.
cce0: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
ccf0: 78 3d 3d 33 20 29 3b 0a 20 20 20 20 20 20 69 66 x==3 );. if
cd00: 28 20 73 69 7a 65 2b 70 63 20 3e 20 75 73 61 62 ( size+pc > usab
cd10: 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 leSize ){.
cd20: 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 5f *pRc = SQLITE_
cd30: 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 67 CORRUPT_PAGE(pPg
cd40: 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 );. retur
cd50: 6e 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 n 0;. }else
cd60: 20 69 66 28 20 78 3c 34 20 29 7b 0a 20 20 20 20 if( x<4 ){.
cd70: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
cd80: 4f 46 3a 20 52 2d 31 31 34 39 38 2d 35 38 30 32 OF: R-11498-5802
cd90: 32 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 2 In a well-form
cda0: 65 64 20 62 2d 74 72 65 65 20 70 61 67 65 2c 20 ed b-tree page,
cdb0: 74 68 65 20 74 6f 74 61 6c 0a 20 20 20 20 20 20 the total.
cdc0: 20 20 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 62 ** number of b
cdd0: 79 74 65 73 20 69 6e 20 66 72 61 67 6d 65 6e 74 ytes in fragment
cde0: 73 20 6d 61 79 20 6e 6f 74 20 65 78 63 65 65 64 s may not exceed
cdf0: 20 36 30 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 60. */.
ce00: 69 66 28 20 61 44 61 74 61 5b 68 64 72 2b 37 5d if( aData[hdr+7]
ce10: 3e 35 37 20 29 20 72 65 74 75 72 6e 20 30 3b 0a >57 ) return 0;.
ce20: 0a 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f . /* Remo
ce30: 76 65 20 74 68 65 20 73 6c 6f 74 20 66 72 6f 6d ve the slot from
ce40: 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 the free-list.
ce50: 55 70 64 61 74 65 20 74 68 65 20 6e 75 6d 62 65 Update the numbe
ce60: 72 20 6f 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 r of. **
ce70: 66 72 61 67 6d 65 6e 74 65 64 20 62 79 74 65 73 fragmented bytes
ce80: 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67 65 within the page
ce90: 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 6d . */. mem
cea0: 63 70 79 28 26 61 44 61 74 61 5b 69 41 64 64 72 cpy(&aData[iAddr
ceb0: 5d 2c 20 26 61 44 61 74 61 5b 70 63 5d 2c 20 32 ], &aData[pc], 2
cec0: 29 3b 0a 20 20 20 20 20 20 20 20 61 44 61 74 61 );. aData
ced0: 5b 68 64 72 2b 37 5d 20 2b 3d 20 28 75 38 29 78 [hdr+7] += (u8)x
cee0: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
cef0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 6c /* The sl
cf00: 6f 74 20 72 65 6d 61 69 6e 73 20 6f 6e 20 74 68 ot remains on th
cf10: 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 52 65 64 e free-list. Red
cf20: 75 63 65 20 69 74 73 20 73 69 7a 65 20 74 6f 20 uce its size to
cf30: 61 63 63 6f 75 6e 74 0a 20 20 20 20 20 20 20 20 account.
cf40: 20 2a 2a 20 66 6f 72 20 74 68 65 20 70 6f 72 74 ** for the port
cf50: 69 6f 6e 20 75 73 65 64 20 62 79 20 74 68 65 20 ion used by the
cf60: 6e 65 77 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 new allocation.
cf70: 2a 2f 0a 20 20 20 20 20 20 20 20 70 75 74 32 62 */. put2b
cf80: 79 74 65 28 26 61 44 61 74 61 5b 70 63 2b 32 5d yte(&aData[pc+2]
cf90: 2c 20 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 , x);. }.
cfa0: 20 20 20 20 72 65 74 75 72 6e 20 26 61 44 61 74 return &aDat
cfb0: 61 5b 70 63 20 2b 20 78 5d 3b 0a 20 20 20 20 7d a[pc + x];. }
cfc0: 0a 20 20 20 20 69 41 64 64 72 20 3d 20 70 63 3b . iAddr = pc;
cfd0: 0a 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 79 . pc = get2by
cfe0: 74 65 28 26 61 44 61 74 61 5b 70 63 5d 29 3b 0a te(&aData[pc]);.
cff0: 20 20 20 20 69 66 28 20 70 63 3c 69 41 64 64 72 if( pc<iAddr
d000: 2b 73 69 7a 65 20 29 20 62 72 65 61 6b 3b 0a 20 +size ) break;.
d010: 20 7d 0a 20 20 69 66 28 20 70 63 20 29 7b 0a 20 }. if( pc ){.
d020: 20 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 *pRc = SQLITE
d030: 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 _CORRUPT_PAGE(pP
d040: 67 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 g);. }.. retur
d050: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c n 0;.}../*.** Al
d060: 6c 6f 63 61 74 65 20 6e 42 79 74 65 20 62 79 74 locate nByte byt
d070: 65 73 20 6f 66 20 73 70 61 63 65 20 66 72 6f 6d es of space from
d080: 20 77 69 74 68 69 6e 20 74 68 65 20 42 2d 54 72 within the B-Tr
d090: 65 65 20 70 61 67 65 20 70 61 73 73 65 64 0a 2a ee page passed.*
d0a0: 2a 20 61 73 20 74 68 65 20 66 69 72 73 74 20 61 * as the first a
d0b0: 72 67 75 6d 65 6e 74 2e 20 57 72 69 74 65 20 69 rgument. Write i
d0c0: 6e 74 6f 20 2a 70 49 64 78 20 74 68 65 20 69 6e nto *pIdx the in
d0d0: 64 65 78 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e dex into pPage->
d0e0: 61 44 61 74 61 5b 5d 0a 2a 2a 20 6f 66 20 74 68 aData[].** of th
d0f0: 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
d100: 61 6c 6c 6f 63 61 74 65 64 20 73 70 61 63 65 2e allocated space.
d110: 20 52 65 74 75 72 6e 20 65 69 74 68 65 72 20 53 Return either S
d120: 51 4c 49 54 45 5f 4f 4b 20 6f 72 0a 2a 2a 20 61 QLITE_OK or.** a
d130: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 28 75 73 n error code (us
d140: 75 61 6c 6c 79 20 53 51 4c 49 54 45 5f 43 4f 52 ually SQLITE_COR
d150: 52 55 50 54 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 RUPT)..**.** The
d160: 20 63 61 6c 6c 65 72 20 67 75 61 72 61 6e 74 65 caller guarante
d170: 65 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 es that there is
d180: 20 73 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 sufficient spac
d190: 65 20 74 6f 20 6d 61 6b 65 20 74 68 65 0a 2a 2a e to make the.**
d1a0: 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 54 68 allocation. Th
d1b0: 69 73 20 72 6f 75 74 69 6e 65 20 6d 69 67 68 74 is routine might
d1c0: 20 6e 65 65 64 20 74 6f 20 64 65 66 72 61 67 6d need to defragm
d1d0: 65 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ent in order to
d1e0: 62 72 69 6e 67 0a 2a 2a 20 61 6c 6c 20 74 68 65 bring.** all the
d1f0: 20 73 70 61 63 65 20 74 6f 67 65 74 68 65 72 2c space together,
d200: 20 68 6f 77 65 76 65 72 2e 20 20 54 68 69 73 20 however. This
d210: 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 76 6f routine will avo
d220: 69 64 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 id using.** the
d230: 66 69 72 73 74 20 74 77 6f 20 62 79 74 65 73 20 first two bytes
d240: 70 61 73 74 20 74 68 65 20 63 65 6c 6c 20 70 6f past the cell po
d250: 69 6e 74 65 72 20 61 72 65 61 20 73 69 6e 63 65 inter area since
d260: 20 70 72 65 73 75 6d 61 62 6c 79 20 74 68 69 73 presumably this
d270: 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 .** allocation i
d280: 73 20 62 65 69 6e 67 20 6d 61 64 65 20 69 6e 20 s being made in
d290: 6f 72 64 65 72 20 74 6f 20 69 6e 73 65 72 74 20 order to insert
d2a0: 61 20 6e 65 77 20 63 65 6c 6c 2c 20 73 6f 20 77 a new cell, so w
d2b0: 65 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 6f 20 65 e will.** also e
d2c0: 6e 64 20 75 70 20 6e 65 65 64 69 6e 67 20 61 20 nd up needing a
d2d0: 6e 65 77 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 new cell pointer
d2e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
d2f0: 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 4d 65 allocateSpace(Me
d300: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e mPage *pPage, in
d310: 74 20 6e 42 79 74 65 2c 20 69 6e 74 20 2a 70 49 t nByte, int *pI
d320: 64 78 29 7b 0a 20 20 63 6f 6e 73 74 20 69 6e 74 dx){. const int
d330: 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 hdr = pPage->hd
d340: 72 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4c rOffset; /* L
d350: 6f 63 61 6c 20 63 61 63 68 65 20 6f 66 20 70 50 ocal cache of pP
d360: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 2a age->hdrOffset *
d370: 2f 0a 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 64 /. u8 * const d
d380: 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 ata = pPage->aDa
d390: 74 61 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 ta; /* Loca
d3a0: 6c 20 63 61 63 68 65 20 6f 66 20 70 50 61 67 65 l cache of pPage
d3b0: 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 69 6e 74 ->aData */. int
d3c0: 20 74 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 top;
d3d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d3e0: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
d3f0: 6f 66 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 of cell content
d400: 61 72 65 61 20 2a 2f 0a 20 20 69 6e 74 20 72 63 area */. int rc
d410: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 = SQLITE_OK;
d420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
d430: 2a 20 49 6e 74 65 67 65 72 20 72 65 74 75 72 6e * Integer return
d440: 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 67 code */. int g
d450: 61 70 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 69 ap; /* Fi
d460: 72 73 74 20 62 79 74 65 20 6f 66 20 67 61 70 20 rst byte of gap
d470: 62 65 74 77 65 65 6e 20 63 65 6c 6c 20 70 6f 69 between cell poi
d480: 6e 74 65 72 73 20 61 6e 64 20 63 65 6c 6c 20 63 nters and cell c
d490: 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 0a 20 20 61 ontent */. . a
d4a0: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
d4b0: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
d4c0: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
d4d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
d4e0: 65 2d 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 65 e->pBt );. asse
d4f0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
d500: 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
d510: 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
d520: 73 73 65 72 74 28 20 6e 42 79 74 65 3e 3d 30 20 ssert( nByte>=0
d530: 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 63 ); /* Minimum c
d540: 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 2a 2f ell size is 4 */
d550: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
d560: 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 74 65 20 29 ->nFree>=nByte )
d570: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
d580: 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 e->nOverflow==0
d590: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 42 79 );. assert( nBy
d5a0: 74 65 20 3c 20 28 69 6e 74 29 28 70 50 61 67 65 te < (int)(pPage
d5b0: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
d5c0: 65 2d 38 29 20 29 3b 0a 0a 20 20 61 73 73 65 72 e-8) );.. asser
d5d0: 74 28 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 t( pPage->cellOf
d5e0: 66 73 65 74 20 3d 3d 20 68 64 72 20 2b 20 31 32 fset == hdr + 12
d5f0: 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 65 61 66 - 4*pPage->leaf
d600: 20 29 3b 0a 20 20 67 61 70 20 3d 20 70 50 61 67 );. gap = pPag
d610: 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 e->cellOffset +
d620: 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 2*pPage->nCell;.
d630: 20 20 61 73 73 65 72 74 28 20 67 61 70 3c 3d 36 assert( gap<=6
d640: 35 35 33 36 20 29 3b 0a 20 20 2f 2a 20 45 56 49 5536 );. /* EVI
d650: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 39 33 35 DENCE-OF: R-2935
d660: 36 2d 30 32 33 39 31 20 49 66 20 74 68 65 20 64 6-02391 If the d
d670: 61 74 61 62 61 73 65 20 75 73 65 73 20 61 20 36 atabase uses a 6
d680: 35 35 33 36 2d 62 79 74 65 20 70 61 67 65 20 73 5536-byte page s
d690: 69 7a 65 0a 20 20 2a 2a 20 61 6e 64 20 74 68 65 ize. ** and the
d6a0: 20 72 65 73 65 72 76 65 64 20 73 70 61 63 65 20 reserved space
d6b0: 69 73 20 7a 65 72 6f 20 28 74 68 65 20 75 73 75 is zero (the usu
d6c0: 61 6c 20 76 61 6c 75 65 20 66 6f 72 20 72 65 73 al value for res
d6d0: 65 72 76 65 64 20 73 70 61 63 65 29 0a 20 20 2a erved space). *
d6e0: 2a 20 74 68 65 6e 20 74 68 65 20 63 65 6c 6c 20 * then the cell
d6f0: 63 6f 6e 74 65 6e 74 20 6f 66 66 73 65 74 20 6f content offset o
d700: 66 20 61 6e 20 65 6d 70 74 79 20 70 61 67 65 20 f an empty page
d710: 77 61 6e 74 73 20 74 6f 20 62 65 20 36 35 35 33 wants to be 6553
d720: 36 2e 0a 20 20 2a 2a 20 48 6f 77 65 76 65 72 2c 6.. ** However,
d730: 20 74 68 61 74 20 69 6e 74 65 67 65 72 20 69 73 that integer is
d740: 20 74 6f 6f 20 6c 61 72 67 65 20 74 6f 20 62 65 too large to be
d750: 20 73 74 6f 72 65 64 20 69 6e 20 61 20 32 2d 62 stored in a 2-b
d760: 79 74 65 20 75 6e 73 69 67 6e 65 64 0a 20 20 2a yte unsigned. *
d770: 2a 20 69 6e 74 65 67 65 72 2c 20 73 6f 20 61 20 * integer, so a
d780: 76 61 6c 75 65 20 6f 66 20 30 20 69 73 20 75 73 value of 0 is us
d790: 65 64 20 69 6e 20 69 74 73 20 70 6c 61 63 65 2e ed in its place.
d7a0: 20 2a 2f 0a 20 20 74 6f 70 20 3d 20 67 65 74 32 */. top = get2
d7b0: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
d7c0: 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20 74 6f ]);. assert( to
d7d0: 70 3c 3d 28 69 6e 74 29 70 50 61 67 65 2d 3e 70 p<=(int)pPage->p
d7e0: 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 Bt->usableSize )
d7f0: 3b 20 2f 2a 20 50 72 65 76 65 6e 74 20 62 79 20 ; /* Prevent by
d800: 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 29 getAndInitPage()
d810: 20 2a 2f 0a 20 20 69 66 28 20 67 61 70 3e 74 6f */. if( gap>to
d820: 70 20 29 7b 0a 20 20 20 20 69 66 28 20 74 6f 70 p ){. if( top
d830: 3d 3d 30 20 26 26 20 70 50 61 67 65 2d 3e 70 42 ==0 && pPage->pB
d840: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 3d 3d 36 t->usableSize==6
d850: 35 35 33 36 20 29 7b 0a 20 20 20 20 20 20 74 6f 5536 ){. to
d860: 70 20 3d 20 36 35 35 33 36 3b 0a 20 20 20 20 7d p = 65536;. }
d870: 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 65 74 75 else{. retu
d880: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
d890: 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 T_PAGE(pPage);.
d8a0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 }. }.. /* I
d8b0: 66 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67 f there is enoug
d8c0: 68 20 73 70 61 63 65 20 62 65 74 77 65 65 6e 20 h space between
d8d0: 67 61 70 20 61 6e 64 20 74 6f 70 20 66 6f 72 20 gap and top for
d8e0: 6f 6e 65 20 6d 6f 72 65 20 63 65 6c 6c 20 70 6f one more cell po
d8f0: 69 6e 74 65 72 0a 20 20 2a 2a 20 61 72 72 61 79 inter. ** array
d900: 20 65 6e 74 72 79 20 6f 66 66 73 65 74 2c 20 61 entry offset, a
d910: 6e 64 20 69 66 20 74 68 65 20 66 72 65 65 6c 69 nd if the freeli
d920: 73 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2c st is not empty,
d930: 20 74 68 65 6e 20 73 65 61 72 63 68 20 74 68 65 then search the
d940: 0a 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 6c . ** freelist l
d950: 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 66 72 65 ooking for a fre
d960: 65 20 73 6c 6f 74 20 62 69 67 20 65 6e 6f 75 67 e slot big enoug
d970: 68 20 74 6f 20 73 61 74 69 73 66 79 20 74 68 65 h to satisfy the
d980: 20 72 65 71 75 65 73 74 2e 0a 20 20 2a 2f 0a 20 request.. */.
d990: 20 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 testcase( gap+2
d9a0: 3d 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 74 63 ==top );. testc
d9b0: 61 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f 70 20 ase( gap+1==top
d9c0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 );. testcase( g
d9d0: 61 70 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 ap==top );. if(
d9e0: 20 28 64 61 74 61 5b 68 64 72 2b 32 5d 20 7c 7c (data[hdr+2] ||
d9f0: 20 64 61 74 61 5b 68 64 72 2b 31 5d 29 20 26 26 data[hdr+1]) &&
da00: 20 67 61 70 2b 32 3c 3d 74 6f 70 20 29 7b 0a 20 gap+2<=top ){.
da10: 20 20 20 75 38 20 2a 70 53 70 61 63 65 20 3d 20 u8 *pSpace =
da20: 70 61 67 65 46 69 6e 64 53 6c 6f 74 28 70 50 61 pageFindSlot(pPa
da30: 67 65 2c 20 6e 42 79 74 65 2c 20 26 72 63 29 3b ge, nByte, &rc);
da40: 0a 20 20 20 20 69 66 28 20 70 53 70 61 63 65 20 . if( pSpace
da50: 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
da60: 20 70 53 70 61 63 65 3e 3d 64 61 74 61 20 26 26 pSpace>=data &&
da70: 20 28 70 53 70 61 63 65 20 2d 20 64 61 74 61 29 (pSpace - data)
da80: 3c 36 35 35 33 36 20 29 3b 0a 20 20 20 20 20 20 <65536 );.
da90: 2a 70 49 64 78 20 3d 20 28 69 6e 74 29 28 70 53 *pIdx = (int)(pS
daa0: 70 61 63 65 20 2d 20 64 61 74 61 29 3b 0a 20 20 pace - data);.
dab0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
dac0: 45 5f 4f 4b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 E_OK;. }else
dad0: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
dae0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
daf0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 72 . }.. /* The r
db00: 65 71 75 65 73 74 20 63 6f 75 6c 64 20 6e 6f 74 equest could not
db10: 20 62 65 20 66 75 6c 66 69 6c 6c 65 64 20 75 73 be fulfilled us
db20: 69 6e 67 20 61 20 66 72 65 65 6c 69 73 74 20 73 ing a freelist s
db30: 6c 6f 74 2e 20 20 43 68 65 63 6b 0a 20 20 2a 2a lot. Check. **
db40: 20 74 6f 20 73 65 65 20 69 66 20 64 65 66 72 61 to see if defra
db50: 67 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 6e 65 gmentation is ne
db60: 63 65 73 73 61 72 79 2e 0a 20 20 2a 2f 0a 20 20 cessary.. */.
db70: 74 65 73 74 63 61 73 65 28 20 67 61 70 2b 32 2b testcase( gap+2+
db80: 6e 42 79 74 65 3d 3d 74 6f 70 20 29 3b 0a 20 20 nByte==top );.
db90: 69 66 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3e if( gap+2+nByte>
dba0: 74 6f 70 20 29 7b 0a 20 20 20 20 61 73 73 65 72 top ){. asser
dbb0: 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e t( pPage->nCell>
dbc0: 30 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 0 || CORRUPT_DB
dbd0: 29 3b 0a 20 20 20 20 72 63 20 3d 20 64 65 66 72 );. rc = defr
dbe0: 61 67 6d 65 6e 74 50 61 67 65 28 70 50 61 67 65 agmentPage(pPage
dbf0: 2c 20 4d 49 4e 28 34 2c 20 70 50 61 67 65 2d 3e , MIN(4, pPage->
dc00: 6e 46 72 65 65 20 2d 20 28 32 2b 6e 42 79 74 65 nFree - (2+nByte
dc10: 29 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 )));. if( rc
dc20: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
dc30: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
dc40: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
dc50: 2b 35 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 +5]);. assert
dc60: 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 3c 3d 74 ( gap+2+nByte<=t
dc70: 6f 70 20 29 3b 0a 20 20 7d 0a 0a 0a 20 20 2f 2a op );. }... /*
dc80: 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 Allocate memory
dc90: 20 66 72 6f 6d 20 74 68 65 20 67 61 70 20 69 6e from the gap in
dca0: 20 62 65 74 77 65 65 6e 20 74 68 65 20 63 65 6c between the cel
dcb0: 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 0a l pointer array.
dcc0: 20 20 2a 2a 20 61 6e 64 20 74 68 65 20 63 65 6c ** and the cel
dcd0: 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 20 l content area.
dce0: 20 54 68 65 20 62 74 72 65 65 49 6e 69 74 50 61 The btreeInitPa
dcf0: 67 65 28 29 20 63 61 6c 6c 20 68 61 73 20 61 6c ge() call has al
dd00: 72 65 61 64 79 0a 20 20 2a 2a 20 76 61 6c 69 64 ready. ** valid
dd10: 61 74 65 64 20 74 68 65 20 66 72 65 65 6c 69 73 ated the freelis
dd20: 74 2e 20 20 47 69 76 65 6e 20 74 68 61 74 20 74 t. Given that t
dd30: 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 76 he freelist is v
dd40: 61 6c 69 64 2c 20 74 68 65 72 65 0a 20 20 2a 2a alid, there. **
dd50: 20 69 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 is no way that
dd60: 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 63 the allocation c
dd70: 61 6e 20 65 78 74 65 6e 64 20 6f 66 66 20 74 68 an extend off th
dd80: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 70 61 67 e end of the pag
dd90: 65 2e 0a 20 20 2a 2a 20 54 68 65 20 61 73 73 65 e.. ** The asse
dda0: 72 74 28 29 20 62 65 6c 6f 77 20 76 65 72 69 66 rt() below verif
ddb0: 69 65 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 ies the previous
ddc0: 20 73 65 6e 74 65 6e 63 65 2e 0a 20 20 2a 2f 0a sentence.. */.
ddd0: 20 20 74 6f 70 20 2d 3d 20 6e 42 79 74 65 3b 0a top -= nByte;.
dde0: 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
ddf0: 5b 68 64 72 2b 35 5d 2c 20 74 6f 70 29 3b 0a 20 [hdr+5], top);.
de00: 20 61 73 73 65 72 74 28 20 74 6f 70 2b 6e 42 79 assert( top+nBy
de10: 74 65 20 3c 3d 20 28 69 6e 74 29 70 50 61 67 65 te <= (int)pPage
de20: 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
de30: 65 20 29 3b 0a 20 20 2a 70 49 64 78 20 3d 20 74 e );. *pIdx = t
de40: 6f 70 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c op;. return SQL
de50: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
de60: 20 52 65 74 75 72 6e 20 61 20 73 65 63 74 69 6f Return a sectio
de70: 6e 20 6f 66 20 74 68 65 20 70 50 61 67 65 2d 3e n of the pPage->
de80: 61 44 61 74 61 20 74 6f 20 74 68 65 20 66 72 65 aData to the fre
de90: 65 6c 69 73 74 2e 0a 2a 2a 20 54 68 65 20 66 69 elist..** The fi
dea0: 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 rst byte of the
deb0: 6e 65 77 20 66 72 65 65 20 62 6c 6f 63 6b 20 69 new free block i
dec0: 73 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 69 s pPage->aData[i
ded0: 53 74 61 72 74 5d 0a 2a 2a 20 61 6e 64 20 74 68 Start].** and th
dee0: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 62 6c e size of the bl
def0: 6f 63 6b 20 69 73 20 69 53 69 7a 65 20 62 79 74 ock is iSize byt
df00: 65 73 2e 0a 2a 2a 0a 2a 2a 20 41 64 6a 61 63 65 es..**.** Adjace
df10: 6e 74 20 66 72 65 65 62 6c 6f 63 6b 73 20 61 72 nt freeblocks ar
df20: 65 20 63 6f 61 6c 65 73 63 65 64 2e 0a 2a 2a 0a e coalesced..**.
df30: 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 65 76 65 ** Note that eve
df40: 6e 20 74 68 6f 75 67 68 20 74 68 65 20 66 72 65 n though the fre
df50: 65 62 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 20 eblock list was
df60: 63 68 65 63 6b 65 64 20 62 79 20 62 74 72 65 65 checked by btree
df70: 49 6e 69 74 50 61 67 65 28 29 2c 0a 2a 2a 20 74 InitPage(),.** t
df80: 68 61 74 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c hat routine will
df90: 20 6e 6f 74 20 64 65 74 65 63 74 20 6f 76 65 72 not detect over
dfa0: 6c 61 70 20 62 65 74 77 65 65 6e 20 63 65 6c 6c lap between cell
dfb0: 73 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b 73 2e s or freeblocks.
dfc0: 20 20 4e 6f 72 0a 2a 2a 20 64 6f 65 73 20 69 74 Nor.** does it
dfd0: 20 64 65 74 65 63 74 20 63 65 6c 6c 73 20 6f 72 detect cells or
dfe0: 20 66 72 65 65 62 6c 6f 63 6b 73 20 74 68 61 74 freeblocks that
dff0: 20 65 6e 63 72 6f 75 63 68 20 69 6e 74 6f 20 74 encrouch into t
e000: 68 65 20 72 65 73 65 72 76 65 64 20 62 79 74 65 he reserved byte
e010: 73 0a 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 s.** at the end
e020: 6f 66 20 74 68 65 20 70 61 67 65 2e 20 20 53 6f of the page. So
e030: 20 64 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 do additional c
e040: 6f 72 72 75 70 74 69 6f 6e 20 63 68 65 63 6b 73 orruption checks
e050: 20 69 6e 73 69 64 65 20 74 68 69 73 0a 2a 2a 20 inside this.**
e060: 72 6f 75 74 69 6e 65 20 61 6e 64 20 72 65 74 75 routine and retu
e070: 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
e080: 54 20 69 66 20 61 6e 79 20 70 72 6f 62 6c 65 6d T if any problem
e090: 73 20 61 72 65 20 66 6f 75 6e 64 2e 0a 2a 2f 0a s are found..*/.
e0a0: 73 74 61 74 69 63 20 69 6e 74 20 66 72 65 65 53 static int freeS
e0b0: 70 61 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 pace(MemPage *pP
e0c0: 61 67 65 2c 20 75 31 36 20 69 53 74 61 72 74 2c age, u16 iStart,
e0d0: 20 75 31 36 20 69 53 69 7a 65 29 7b 0a 20 20 75 u16 iSize){. u
e0e0: 31 36 20 69 50 74 72 3b 20 20 20 20 20 20 20 20 16 iPtr;
e0f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e100: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
e110: 6f 66 20 70 74 72 20 74 6f 20 6e 65 78 74 20 66 of ptr to next f
e120: 72 65 65 62 6c 6f 63 6b 20 2a 2f 0a 20 20 75 31 reeblock */. u1
e130: 36 20 69 46 72 65 65 42 6c 6b 3b 20 20 20 20 20 6 iFreeBlk;
e140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e150: 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f /* Address o
e160: 66 20 74 68 65 20 6e 65 78 74 20 66 72 65 65 62 f the next freeb
e170: 6c 6f 63 6b 20 2a 2f 0a 20 20 75 38 20 68 64 72 lock */. u8 hdr
e180: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e1a0: 2f 2a 20 50 61 67 65 20 68 65 61 64 65 72 20 73 /* Page header s
e1b0: 69 7a 65 2e 20 20 30 20 6f 72 20 31 30 30 20 2a ize. 0 or 100 *
e1c0: 2f 0a 20 20 75 38 20 6e 46 72 61 67 20 3d 20 30 /. u8 nFrag = 0
e1d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
e1e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 64 /* Red
e1f0: 75 63 74 69 6f 6e 20 69 6e 20 66 72 61 67 6d 65 uction in fragme
e200: 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 36 ntation */. u16
e210: 20 69 4f 72 69 67 53 69 7a 65 20 3d 20 69 53 69 iOrigSize = iSi
e220: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ze;
e230: 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 /* Original v
e240: 61 6c 75 65 20 6f 66 20 69 53 69 7a 65 20 2a 2f alue of iSize */
e250: 0a 20 20 75 31 36 20 78 3b 20 20 20 20 20 20 20 . u16 x;
e260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e270: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
e280: 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 65 et to cell conte
e290: 6e 74 20 61 72 65 61 20 2a 2f 0a 20 20 75 33 32 nt area */. u32
e2a0: 20 69 45 6e 64 20 3d 20 69 53 74 61 72 74 20 2b iEnd = iStart +
e2b0: 20 69 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 iSize;
e2c0: 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 /* First byte
e2d0: 20 70 61 73 74 20 74 68 65 20 69 53 74 61 72 74 past the iStart
e2e0: 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 75 6e 73 buffer */. uns
e2f0: 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 61 igned char *data
e300: 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b = pPage->aData;
e310: 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e 74 65 /* Page conte
e320: 6e 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 nt */.. assert(
e330: 20 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 pPage->pBt!=0 )
e340: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
e350: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
e360: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
e370: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
e380: 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 69 CORRUPT_DB || i
e390: 53 74 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 Start>=pPage->hd
e3a0: 72 4f 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d rOffset+6+pPage-
e3b0: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b >childPtrSize );
e3c0: 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 55 . assert( CORRU
e3d0: 50 54 5f 44 42 20 7c 7c 20 69 45 6e 64 20 3c 3d PT_DB || iEnd <=
e3e0: 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 pPage->pBt->usa
e3f0: 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 73 bleSize );. ass
e400: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
e410: 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
e420: 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
e430: 61 73 73 65 72 74 28 20 69 53 69 7a 65 3e 3d 34 assert( iSize>=4
e440: 20 29 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d ); /* Minimum
e450: 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 cell size is 4
e460: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 */. assert( iSt
e470: 61 72 74 3c 3d 70 50 61 67 65 2d 3e 70 42 74 2d art<=pPage->pBt-
e480: 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 20 29 3b >usableSize-4 );
e490: 0a 0a 20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 .. /* The list
e4a0: 6f 66 20 66 72 65 65 62 6c 6f 63 6b 73 20 6d 75 of freeblocks mu
e4b0: 73 74 20 62 65 20 69 6e 20 61 73 63 65 6e 64 69 st be in ascendi
e4c0: 6e 67 20 6f 72 64 65 72 2e 20 20 46 69 6e 64 20 ng order. Find
e4d0: 74 68 65 20 0a 20 20 2a 2a 20 73 70 6f 74 20 6f the . ** spot o
e4e0: 6e 20 74 68 65 20 6c 69 73 74 20 77 68 65 72 65 n the list where
e4f0: 20 69 53 74 61 72 74 20 73 68 6f 75 6c 64 20 62 iStart should b
e500: 65 20 69 6e 73 65 72 74 65 64 2e 0a 20 20 2a 2f e inserted.. */
e510: 0a 20 20 68 64 72 20 3d 20 70 50 61 67 65 2d 3e . hdr = pPage->
e520: 68 64 72 4f 66 66 73 65 74 3b 0a 20 20 69 50 74 hdrOffset;. iPt
e530: 72 20 3d 20 68 64 72 20 2b 20 31 3b 0a 20 20 69 r = hdr + 1;. i
e540: 66 28 20 64 61 74 61 5b 69 50 74 72 2b 31 5d 3d f( data[iPtr+1]=
e550: 3d 30 20 26 26 20 64 61 74 61 5b 69 50 74 72 5d =0 && data[iPtr]
e560: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 46 72 65 65 ==0 ){. iFree
e570: 42 6c 6b 20 3d 20 30 3b 20 20 2f 2a 20 53 68 6f Blk = 0; /* Sho
e580: 72 74 63 75 74 20 66 6f 72 20 74 68 65 20 63 61 rtcut for the ca
e590: 73 65 20 77 68 65 6e 20 74 68 65 20 66 72 65 65 se when the free
e5a0: 6c 69 73 74 20 69 73 20 65 6d 70 74 79 20 2a 2f list is empty */
e5b0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 77 68 . }else{. wh
e5c0: 69 6c 65 28 20 28 69 46 72 65 65 42 6c 6b 20 3d ile( (iFreeBlk =
e5d0: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
e5e0: 69 50 74 72 5d 29 29 3c 69 53 74 61 72 74 20 29 iPtr]))<iStart )
e5f0: 7b 0a 20 20 20 20 20 20 69 66 28 20 69 46 72 65 {. if( iFre
e600: 65 42 6c 6b 3c 69 50 74 72 2b 34 20 29 7b 0a 20 eBlk<iPtr+4 ){.
e610: 20 20 20 20 20 20 20 69 66 28 20 69 46 72 65 65 if( iFree
e620: 42 6c 6b 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a Blk==0 ) break;.
e630: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
e640: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
e650: 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 GE(pPage);.
e660: 20 7d 0a 20 20 20 20 20 20 69 50 74 72 20 3d 20 }. iPtr =
e670: 69 46 72 65 65 42 6c 6b 3b 0a 20 20 20 20 7d 0a iFreeBlk;. }.
e680: 20 20 20 20 69 66 28 20 69 46 72 65 65 42 6c 6b if( iFreeBlk
e690: 3e 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 >pPage->pBt->usa
e6a0: 62 6c 65 53 69 7a 65 2d 34 20 29 7b 0a 20 20 20 bleSize-4 ){.
e6b0: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
e6c0: 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 _CORRUPT_PAGE(pP
e6d0: 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 age);. }.
e6e0: 61 73 73 65 72 74 28 20 69 46 72 65 65 42 6c 6b assert( iFreeBlk
e6f0: 3e 69 50 74 72 20 7c 7c 20 69 46 72 65 65 42 6c >iPtr || iFreeBl
e700: 6b 3d 3d 30 20 29 3b 0a 20 20 0a 20 20 20 20 2f k==0 );. . /
e710: 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 3a * At this point:
e720: 0a 20 20 20 20 2a 2a 20 20 20 20 69 46 72 65 65 . ** iFree
e730: 42 6c 6b 3a 20 20 20 46 69 72 73 74 20 66 72 65 Blk: First fre
e740: 65 62 6c 6f 63 6b 20 61 66 74 65 72 20 69 53 74 eblock after iSt
e750: 61 72 74 2c 20 6f 72 20 7a 65 72 6f 20 69 66 20 art, or zero if
e760: 6e 6f 6e 65 0a 20 20 20 20 2a 2a 20 20 20 20 69 none. ** i
e770: 50 74 72 3a 20 20 20 20 20 20 20 54 68 65 20 61 Ptr: The a
e780: 64 64 72 65 73 73 20 6f 66 20 61 20 70 6f 69 6e ddress of a poin
e790: 74 65 72 20 74 6f 20 69 46 72 65 65 42 6c 6b 0a ter to iFreeBlk.
e7a0: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 68 **. ** Ch
e7b0: 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 69 46 eck to see if iF
e7c0: 72 65 65 42 6c 6b 20 73 68 6f 75 6c 64 20 62 65 reeBlk should be
e7d0: 20 63 6f 61 6c 65 73 63 65 64 20 6f 6e 74 6f 20 coalesced onto
e7e0: 74 68 65 20 65 6e 64 20 6f 66 20 69 53 74 61 72 the end of iStar
e7f0: 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 t.. */. if
e800: 28 20 69 46 72 65 65 42 6c 6b 20 26 26 20 69 45 ( iFreeBlk && iE
e810: 6e 64 2b 33 3e 3d 69 46 72 65 65 42 6c 6b 20 29 nd+3>=iFreeBlk )
e820: 7b 0a 20 20 20 20 20 20 6e 46 72 61 67 20 3d 20 {. nFrag =
e830: 69 46 72 65 65 42 6c 6b 20 2d 20 69 45 6e 64 3b iFreeBlk - iEnd;
e840: 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e 64 3e . if( iEnd>
e850: 69 46 72 65 65 42 6c 6b 20 29 20 72 65 74 75 72 iFreeBlk ) retur
e860: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
e870: 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 _PAGE(pPage);.
e880: 20 20 20 20 69 45 6e 64 20 3d 20 69 46 72 65 65 iEnd = iFree
e890: 42 6c 6b 20 2b 20 67 65 74 32 62 79 74 65 28 26 Blk + get2byte(&
e8a0: 64 61 74 61 5b 69 46 72 65 65 42 6c 6b 2b 32 5d data[iFreeBlk+2]
e8b0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 69 45 6e );. if( iEn
e8c0: 64 20 3e 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e d > pPage->pBt->
e8d0: 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 20 usableSize ){.
e8e0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
e8f0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
e900: 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d (pPage);. }
e910: 0a 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 69 . iSize = i
e920: 45 6e 64 20 2d 20 69 53 74 61 72 74 3b 0a 20 20 End - iStart;.
e930: 20 20 20 20 69 46 72 65 65 42 6c 6b 20 3d 20 67 iFreeBlk = g
e940: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 69 46 et2byte(&data[iF
e950: 72 65 65 42 6c 6b 5d 29 3b 0a 20 20 20 20 7d 0a reeBlk]);. }.
e960: 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 69 50 74 . /* If iPt
e970: 72 20 69 73 20 61 6e 6f 74 68 65 72 20 66 72 65 r is another fre
e980: 65 62 6c 6f 63 6b 20 28 74 68 61 74 20 69 73 2c eblock (that is,
e990: 20 69 66 20 69 50 74 72 20 69 73 20 6e 6f 74 20 if iPtr is not
e9a0: 74 68 65 20 66 72 65 65 6c 69 73 74 0a 20 20 20 the freelist.
e9b0: 20 2a 2a 20 70 6f 69 6e 74 65 72 20 69 6e 20 74 ** pointer in t
e9c0: 68 65 20 70 61 67 65 20 68 65 61 64 65 72 29 20 he page header)
e9d0: 74 68 65 6e 20 63 68 65 63 6b 20 74 6f 20 73 65 then check to se
e9e0: 65 20 69 66 20 69 53 74 61 72 74 20 73 68 6f 75 e if iStart shou
e9f0: 6c 64 20 62 65 0a 20 20 20 20 2a 2a 20 63 6f 61 ld be. ** coa
ea00: 6c 65 73 63 65 64 20 6f 6e 74 6f 20 74 68 65 20 lesced onto the
ea10: 65 6e 64 20 6f 66 20 69 50 74 72 2e 0a 20 20 20 end of iPtr..
ea20: 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 50 74 72 */. if( iPtr
ea30: 3e 68 64 72 2b 31 20 29 7b 0a 20 20 20 20 20 20 >hdr+1 ){.
ea40: 69 6e 74 20 69 50 74 72 45 6e 64 20 3d 20 69 50 int iPtrEnd = iP
ea50: 74 72 20 2b 20 67 65 74 32 62 79 74 65 28 26 64 tr + get2byte(&d
ea60: 61 74 61 5b 69 50 74 72 2b 32 5d 29 3b 0a 20 20 ata[iPtr+2]);.
ea70: 20 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 2b if( iPtrEnd+
ea80: 33 3e 3d 69 53 74 61 72 74 20 29 7b 0a 20 20 20 3>=iStart ){.
ea90: 20 20 20 20 20 69 66 28 20 69 50 74 72 45 6e 64 if( iPtrEnd
eaa0: 3e 69 53 74 61 72 74 20 29 20 72 65 74 75 72 6e >iStart ) return
eab0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
eac0: 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
ead0: 20 20 20 20 20 6e 46 72 61 67 20 2b 3d 20 69 53 nFrag += iS
eae0: 74 61 72 74 20 2d 20 69 50 74 72 45 6e 64 3b 0a tart - iPtrEnd;.
eaf0: 20 20 20 20 20 20 20 20 69 53 69 7a 65 20 3d 20 iSize =
eb00: 69 45 6e 64 20 2d 20 69 50 74 72 3b 0a 20 20 20 iEnd - iPtr;.
eb10: 20 20 20 20 20 69 53 74 61 72 74 20 3d 20 69 50 iStart = iP
eb20: 74 72 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 tr;. }.
eb30: 7d 0a 20 20 20 20 69 66 28 20 6e 46 72 61 67 3e }. if( nFrag>
eb40: 64 61 74 61 5b 68 64 72 2b 37 5d 20 29 20 72 65 data[hdr+7] ) re
eb50: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
eb60: 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b UPT_PAGE(pPage);
eb70: 0a 20 20 20 20 64 61 74 61 5b 68 64 72 2b 37 5d . data[hdr+7]
eb80: 20 2d 3d 20 6e 46 72 61 67 3b 0a 20 20 7d 0a 20 -= nFrag;. }.
eb90: 20 78 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 x = get2byte(&d
eba0: 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 69 ata[hdr+5]);. i
ebb0: 66 28 20 69 53 74 61 72 74 3c 3d 78 20 29 7b 0a f( iStart<=x ){.
ebc0: 20 20 20 20 2f 2a 20 54 68 65 20 6e 65 77 20 66 /* The new f
ebd0: 72 65 65 62 6c 6f 63 6b 20 69 73 20 61 74 20 74 reeblock is at t
ebe0: 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
ebf0: 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
ec00: 20 61 72 65 61 2c 0a 20 20 20 20 2a 2a 20 73 6f area,. ** so
ec10: 20 6a 75 73 74 20 65 78 74 65 6e 64 20 74 68 65 just extend the
ec20: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 cell content ar
ec30: 65 61 20 72 61 74 68 65 72 20 74 68 61 6e 20 63 ea rather than c
ec40: 72 65 61 74 65 20 61 6e 6f 74 68 65 72 0a 20 20 reate another.
ec50: 20 20 2a 2a 20 66 72 65 65 6c 69 73 74 20 65 6e ** freelist en
ec60: 74 72 79 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 try */. if( i
ec70: 53 74 61 72 74 3c 78 20 7c 7c 20 69 50 74 72 21 Start<x || iPtr!
ec80: 3d 68 64 72 2b 31 20 29 20 72 65 74 75 72 6e 20 =hdr+1 ) return
ec90: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 SQLITE_CORRUPT_P
eca0: 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 AGE(pPage);.
ecb0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
ecc0: 64 72 2b 31 5d 2c 20 69 46 72 65 65 42 6c 6b 29 dr+1], iFreeBlk)
ecd0: 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 ;. put2byte(&
ece0: 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 69 45 6e data[hdr+5], iEn
ecf0: 64 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 d);. }else{.
ed00: 20 2f 2a 20 49 6e 73 65 72 74 20 74 68 65 20 6e /* Insert the n
ed10: 65 77 20 66 72 65 65 62 6c 6f 63 6b 20 69 6e 74 ew freeblock int
ed20: 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a o the freelist *
ed30: 2f 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 /. put2byte(&
ed40: 64 61 74 61 5b 69 50 74 72 5d 2c 20 69 53 74 61 data[iPtr], iSta
ed50: 72 74 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 rt);. }. if( p
ed60: 50 61 67 65 2d 3e 70 42 74 2d 3e 62 74 73 46 6c Page->pBt->btsFl
ed70: 61 67 73 20 26 20 42 54 53 5f 46 41 53 54 5f 53 ags & BTS_FAST_S
ed80: 45 43 55 52 45 20 29 7b 0a 20 20 20 20 2f 2a 20 ECURE ){. /*
ed90: 4f 76 65 72 77 72 69 74 65 20 64 65 6c 65 74 65 Overwrite delete
eda0: 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 d information wi
edb0: 74 68 20 7a 65 72 6f 73 20 77 68 65 6e 20 74 68 th zeros when th
edc0: 65 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 0a e secure_delete.
edd0: 20 20 20 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 73 ** option is
ede0: 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 20 20 enabled */.
edf0: 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 69 53 74 memset(&data[iSt
ee00: 61 72 74 5d 2c 20 30 2c 20 69 53 69 7a 65 29 3b art], 0, iSize);
ee10: 0a 20 20 7d 0a 20 20 70 75 74 32 62 79 74 65 28 . }. put2byte(
ee20: 26 64 61 74 61 5b 69 53 74 61 72 74 5d 2c 20 69 &data[iStart], i
ee30: 46 72 65 65 42 6c 6b 29 3b 0a 20 20 70 75 74 32 FreeBlk);. put2
ee40: 62 79 74 65 28 26 64 61 74 61 5b 69 53 74 61 72 byte(&data[iStar
ee50: 74 2b 32 5d 2c 20 69 53 69 7a 65 29 3b 0a 20 20 t+2], iSize);.
ee60: 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 pPage->nFree +=
ee70: 69 4f 72 69 67 53 69 7a 65 3b 0a 20 20 72 65 74 iOrigSize;. ret
ee80: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
ee90: 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6f 64 65 20 74 ../*.** Decode t
eea0: 68 65 20 66 6c 61 67 73 20 62 79 74 65 20 28 74 he flags byte (t
eeb0: 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 he first byte of
eec0: 20 74 68 65 20 68 65 61 64 65 72 29 20 66 6f 72 the header) for
eed0: 20 61 20 70 61 67 65 0a 2a 2a 20 61 6e 64 20 69 a page.** and i
eee0: 6e 69 74 69 61 6c 69 7a 65 20 66 69 65 6c 64 73 nitialize fields
eef0: 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 20 of the MemPage
ef00: 73 74 72 75 63 74 75 72 65 20 61 63 63 6f 72 64 structure accord
ef10: 69 6e 67 6c 79 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c ingly..**.** Onl
ef20: 79 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 y the following
ef30: 63 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 61 72 65 combinations are
ef40: 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 6e 79 supported. Any
ef50: 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e 74 0a thing different.
ef60: 2a 2a 20 69 6e 64 69 63 61 74 65 73 20 61 20 63 ** indicates a c
ef70: 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 20 orrupt database
ef80: 66 69 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 files:.**.**
ef90: 20 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 PTF_ZERODAT
efa0: 41 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 A.** PTF
efb0: 5f 5a 45 52 4f 44 41 54 41 20 7c 20 50 54 46 5f _ZERODATA | PTF_
efc0: 4c 45 41 46 0a 2a 2a 20 20 20 20 20 20 20 20 20 LEAF.**
efd0: 50 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 PTF_LEAFDATA | P
efe0: 54 46 5f 49 4e 54 4b 45 59 0a 2a 2a 20 20 20 20 TF_INTKEY.**
eff0: 20 20 20 20 20 50 54 46 5f 4c 45 41 46 44 41 54 PTF_LEAFDAT
f000: 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 20 7c A | PTF_INTKEY |
f010: 20 50 54 46 5f 4c 45 41 46 0a 2a 2f 0a 73 74 61 PTF_LEAF.*/.sta
f020: 74 69 63 20 69 6e 74 20 64 65 63 6f 64 65 46 6c tic int decodeFl
f030: 61 67 73 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ags(MemPage *pPa
f040: 67 65 2c 20 69 6e 74 20 66 6c 61 67 42 79 74 65 ge, int flagByte
f050: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
f060: 42 74 3b 20 20 20 20 20 2f 2a 20 41 20 63 6f 70 Bt; /* A cop
f070: 79 20 6f 66 20 70 50 61 67 65 2d 3e 70 42 74 20 y of pPage->pBt
f080: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
f090: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3d 3d age->hdrOffset==
f0a0: 28 70 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 (pPage->pgno==1
f0b0: 3f 20 31 30 30 20 3a 20 30 29 20 29 3b 0a 20 20 ? 100 : 0) );.
f0c0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
f0d0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
f0e0: 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
f0f0: 0a 20 20 70 50 61 67 65 2d 3e 6c 65 61 66 20 3d . pPage->leaf =
f100: 20 28 75 38 29 28 66 6c 61 67 42 79 74 65 3e 3e (u8)(flagByte>>
f110: 33 29 3b 20 20 61 73 73 65 72 74 28 20 50 54 46 3); assert( PTF
f120: 5f 4c 45 41 46 20 3d 3d 20 31 3c 3c 33 20 29 3b _LEAF == 1<<3 );
f130: 0a 20 20 66 6c 61 67 42 79 74 65 20 26 3d 20 7e . flagByte &= ~
f140: 50 54 46 5f 4c 45 41 46 3b 0a 20 20 70 50 61 67 PTF_LEAF;. pPag
f150: 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 e->childPtrSize
f160: 3d 20 34 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 = 4-4*pPage->lea
f170: 66 3b 0a 20 20 70 50 61 67 65 2d 3e 78 43 65 6c f;. pPage->xCel
f180: 6c 53 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a 65 lSize = cellSize
f190: 50 74 72 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 Ptr;. pBt = pPa
f1a0: 67 65 2d 3e 70 42 74 3b 0a 20 20 69 66 28 20 66 ge->pBt;. if( f
f1b0: 6c 61 67 42 79 74 65 3d 3d 28 50 54 46 5f 4c 45 lagByte==(PTF_LE
f1c0: 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 AFDATA | PTF_INT
f1d0: 4b 45 59 29 20 29 7b 0a 20 20 20 20 2f 2a 20 45 KEY) ){. /* E
f1e0: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 30 37 VIDENCE-OF: R-07
f1f0: 32 39 31 2d 33 35 33 32 38 20 41 20 76 61 6c 75 291-35328 A valu
f200: 65 20 6f 66 20 35 20 28 30 78 30 35 29 20 6d 65 e of 5 (0x05) me
f210: 61 6e 73 20 74 68 65 20 70 61 67 65 20 69 73 20 ans the page is
f220: 61 6e 0a 20 20 20 20 2a 2a 20 69 6e 74 65 72 69 an. ** interi
f230: 6f 72 20 74 61 62 6c 65 20 62 2d 74 72 65 65 20 or table b-tree
f240: 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 61 73 73 page. */. ass
f250: 65 72 74 28 20 28 50 54 46 5f 4c 45 41 46 44 41 ert( (PTF_LEAFDA
f260: 54 41 7c 50 54 46 5f 49 4e 54 4b 45 59 29 3d 3d TA|PTF_INTKEY)==
f270: 35 20 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 5 );. /* EVID
f280: 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 36 39 30 30 ENCE-OF: R-26900
f290: 2d 30 39 31 37 36 20 41 20 76 61 6c 75 65 20 6f -09176 A value o
f2a0: 66 20 31 33 20 28 30 78 30 64 29 20 6d 65 61 6e f 13 (0x0d) mean
f2b0: 73 20 74 68 65 20 70 61 67 65 20 69 73 20 61 0a s the page is a.
f2c0: 20 20 20 20 2a 2a 20 6c 65 61 66 20 74 61 62 6c ** leaf tabl
f2d0: 65 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a e b-tree page. *
f2e0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
f2f0: 54 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f TF_LEAFDATA|PTF_
f300: 49 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 29 INTKEY|PTF_LEAF)
f310: 3d 3d 31 33 20 29 3b 0a 20 20 20 20 70 50 61 67 ==13 );. pPag
f320: 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 31 3b 0a 20 e->intKey = 1;.
f330: 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c 65 if( pPage->le
f340: 61 66 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 af ){. pPag
f350: 65 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 3d 20 e->intKeyLeaf =
f360: 31 3b 0a 20 20 20 20 20 20 70 50 61 67 65 2d 3e 1;. pPage->
f370: 78 50 61 72 73 65 43 65 6c 6c 20 3d 20 62 74 72 xParseCell = btr
f380: 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 3b 0a eeParseCellPtr;.
f390: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
f3a0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 4c 65 pPage->intKeyLe
f3b0: 61 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 af = 0;. pP
f3c0: 61 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 20 3d age->xCellSize =
f3d0: 20 63 65 6c 6c 53 69 7a 65 50 74 72 4e 6f 50 61 cellSizePtrNoPa
f3e0: 79 6c 6f 61 64 3b 0a 20 20 20 20 20 20 70 50 61 yload;. pPa
f3f0: 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c 20 3d ge->xParseCell =
f400: 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
f410: 74 72 4e 6f 50 61 79 6c 6f 61 64 3b 0a 20 20 20 trNoPayload;.
f420: 20 7d 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 }. pPage->ma
f430: 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 xLocal = pBt->ma
f440: 78 4c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 xLeaf;. pPage
f450: 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 74 ->minLocal = pBt
f460: 2d 3e 6d 69 6e 4c 65 61 66 3b 0a 20 20 7d 65 6c ->minLeaf;. }el
f470: 73 65 20 69 66 28 20 66 6c 61 67 42 79 74 65 3d se if( flagByte=
f480: 3d 50 54 46 5f 5a 45 52 4f 44 41 54 41 20 29 7b =PTF_ZERODATA ){
f490: 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 . /* EVIDENCE
f4a0: 2d 4f 46 3a 20 52 2d 34 33 33 31 36 2d 33 37 33 -OF: R-43316-373
f4b0: 30 38 20 41 20 76 61 6c 75 65 20 6f 66 20 32 20 08 A value of 2
f4c0: 28 30 78 30 32 29 20 6d 65 61 6e 73 20 74 68 65 (0x02) means the
f4d0: 20 70 61 67 65 20 69 73 20 61 6e 0a 20 20 20 20 page is an.
f4e0: 2a 2a 20 69 6e 74 65 72 69 6f 72 20 69 6e 64 65 ** interior inde
f4f0: 78 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a x b-tree page. *
f500: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 /. assert( (P
f510: 54 46 5f 5a 45 52 4f 44 41 54 41 29 3d 3d 32 20 TF_ZERODATA)==2
f520: 29 3b 0a 20 20 20 20 2f 2a 20 45 56 49 44 45 4e );. /* EVIDEN
f530: 43 45 2d 4f 46 3a 20 52 2d 35 39 36 31 35 2d 34 CE-OF: R-59615-4
f540: 32 38 32 38 20 41 20 76 61 6c 75 65 20 6f 66 20 2828 A value of
f550: 31 30 20 28 30 78 30 61 29 20 6d 65 61 6e 73 20 10 (0x0a) means
f560: 74 68 65 20 70 61 67 65 20 69 73 20 61 0a 20 20 the page is a.
f570: 20 20 2a 2a 20 6c 65 61 66 20 69 6e 64 65 78 20 ** leaf index
f580: 62 2d 74 72 65 65 20 70 61 67 65 2e 20 2a 2f 0a b-tree page. */.
f590: 20 20 20 20 61 73 73 65 72 74 28 20 28 50 54 46 assert( (PTF
f5a0: 5f 5a 45 52 4f 44 41 54 41 7c 50 54 46 5f 4c 45 _ZERODATA|PTF_LE
f5b0: 41 46 29 3d 3d 31 30 20 29 3b 0a 20 20 20 20 70 AF)==10 );. p
f5c0: 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d 20 30 Page->intKey = 0
f5d0: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 6e 74 ;. pPage->int
f5e0: 4b 65 79 4c 65 61 66 20 3d 20 30 3b 0a 20 20 20 KeyLeaf = 0;.
f5f0: 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
f600: 6c 6c 20 3d 20 62 74 72 65 65 50 61 72 73 65 43 ll = btreeParseC
f610: 65 6c 6c 50 74 72 49 6e 64 65 78 3b 0a 20 20 20 ellPtrIndex;.
f620: 20 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c pPage->maxLocal
f630: 20 3d 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c = pBt->maxLocal
f640: 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 69 6e ;. pPage->min
f650: 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 69 6e Local = pBt->min
f660: 4c 6f 63 61 6c 3b 0a 20 20 7d 65 6c 73 65 7b 0a Local;. }else{.
f670: 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d /* EVIDENCE-
f680: 4f 46 3a 20 52 2d 34 37 36 30 38 2d 35 36 34 36 OF: R-47608-5646
f690: 39 20 41 6e 79 20 6f 74 68 65 72 20 76 61 6c 75 9 Any other valu
f6a0: 65 20 66 6f 72 20 74 68 65 20 62 2d 74 72 65 65 e for the b-tree
f6b0: 20 70 61 67 65 20 74 79 70 65 20 69 73 0a 20 20 page type is.
f6c0: 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 2e 20 2a ** an error. *
f6d0: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
f6e0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
f6f0: 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 70 (pPage);. }. p
f700: 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 65 50 61 Page->max1bytePa
f710: 79 6c 6f 61 64 20 3d 20 70 42 74 2d 3e 6d 61 78 yload = pBt->max
f720: 31 62 79 74 65 50 61 79 6c 6f 61 64 3b 0a 20 20 1bytePayload;.
f730: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
f740: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 ;.}../*.** Initi
f750: 61 6c 69 7a 65 20 74 68 65 20 61 75 78 69 6c 69 alize the auxili
f760: 61 72 79 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ary information
f770: 66 6f 72 20 61 20 64 69 73 6b 20 62 6c 6f 63 6b for a disk block
f780: 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 ..**.** Return S
f790: 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 QLITE_OK on succ
f7a0: 65 73 73 2e 20 20 49 66 20 77 65 20 73 65 65 20 ess. If we see
f7b0: 74 68 61 74 20 74 68 65 20 70 61 67 65 20 64 6f that the page do
f7c0: 65 73 0a 2a 2a 20 6e 6f 74 20 63 6f 6e 74 61 69 es.** not contai
f7d0: 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 n a well-formed
f7e0: 64 61 74 61 62 61 73 65 20 70 61 67 65 2c 20 74 database page, t
f7f0: 68 65 6e 20 72 65 74 75 72 6e 20 0a 2a 2a 20 53 hen return .** S
f800: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2e 20 20 QLITE_CORRUPT.
f810: 4e 6f 74 65 20 74 68 61 74 20 61 20 72 65 74 75 Note that a retu
f820: 72 6e 20 6f 66 20 53 51 4c 49 54 45 5f 4f 4b 20 rn of SQLITE_OK
f830: 64 6f 65 73 20 6e 6f 74 0a 2a 2a 20 67 75 61 72 does not.** guar
f840: 61 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 70 antee that the p
f850: 61 67 65 20 69 73 20 77 65 6c 6c 2d 66 6f 72 6d age is well-form
f860: 65 64 2e 20 20 49 74 20 6f 6e 6c 79 20 73 68 6f ed. It only sho
f870: 77 73 20 74 68 61 74 0a 2a 2a 20 77 65 20 66 61 ws that.** we fa
f880: 69 6c 65 64 20 74 6f 20 64 65 74 65 63 74 20 61 iled to detect a
f890: 6e 79 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a ny corruption..*
f8a0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 /.static int btr
f8b0: 65 65 49 6e 69 74 50 61 67 65 28 4d 65 6d 50 61 eeInitPage(MemPa
f8c0: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
f8d0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 t pc;
f8e0: 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 61 /* Address of a
f8f0: 20 66 72 65 65 62 6c 6f 63 6b 20 77 69 74 68 69 freeblock withi
f900: 6e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d n pPage->aData[]
f910: 20 2a 2f 0a 20 20 75 38 20 68 64 72 3b 20 20 20 */. u8 hdr;
f920: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
f930: 65 74 20 74 6f 20 62 65 67 69 6e 6e 69 6e 67 20 et to beginning
f940: 6f 66 20 70 61 67 65 20 68 65 61 64 65 72 20 2a of page header *
f950: 2f 0a 20 20 75 38 20 2a 64 61 74 61 3b 20 20 20 /. u8 *data;
f960: 20 20 20 20 20 20 20 2f 2a 20 45 71 75 61 6c 20 /* Equal
f970: 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 to pPage->aData
f980: 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 */. BtShared *p
f990: 42 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 Bt; /* Th
f9a0: 65 20 6d 61 69 6e 20 62 74 72 65 65 20 73 74 72 e main btree str
f9b0: 75 63 74 75 72 65 20 2a 2f 0a 20 20 69 6e 74 20 ucture */. int
f9c0: 75 73 61 62 6c 65 53 69 7a 65 3b 20 20 20 20 2f usableSize; /
f9d0: 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 75 73 61 62 * Amount of usab
f9e0: 6c 65 20 73 70 61 63 65 20 6f 6e 20 65 61 63 68 le space on each
f9f0: 20 70 61 67 65 20 2a 2f 0a 20 20 75 31 36 20 63 page */. u16 c
fa00: 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a ellOffset; /*
fa10: 20 4f 66 66 73 65 74 20 66 72 6f 6d 20 73 74 61 Offset from sta
fa20: 72 74 20 6f 66 20 70 61 67 65 20 74 6f 20 66 69 rt of page to fi
fa30: 72 73 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 rst cell pointer
fa40: 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 3b */. int nFree;
fa50: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
fa60: 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 79 74 er of unused byt
fa70: 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a es on the page *
fa80: 2f 0a 20 20 69 6e 74 20 74 6f 70 3b 20 20 20 20 /. int top;
fa90: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
faa0: 62 79 74 65 20 6f 66 20 74 68 65 20 63 65 6c 6c byte of the cell
fab0: 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f content area */
fac0: 0a 20 20 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 . int iCellFirs
fad0: 74 3b 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 t; /* First a
fae0: 6c 6c 6f 77 61 62 6c 65 20 63 65 6c 6c 20 6f 72 llowable cell or
faf0: 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 73 65 freeblock offse
fb00: 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c t */. int iCell
fb10: 4c 61 73 74 3b 20 20 20 20 20 2f 2a 20 4c 61 73 Last; /* Las
fb20: 74 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 t possible cell
fb30: 6f 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f 66 66 or freeblock off
fb40: 73 65 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 set */.. assert
fb50: 28 20 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 ( pPage->pBt!=0
fb60: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
fb70: 67 65 2d 3e 70 42 74 2d 3e 64 62 21 3d 30 20 29 ge->pBt->db!=0 )
fb80: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
fb90: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
fba0: 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
fbb0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
fbc0: 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 73 71 6c 69 Page->pgno==sqli
fbd0: 74 65 33 50 61 67 65 72 50 61 67 65 6e 75 6d 62 te3PagerPagenumb
fbe0: 65 72 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 er(pPage->pDbPag
fbf0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
fc00: 70 50 61 67 65 20 3d 3d 20 73 71 6c 69 74 65 33 pPage == sqlite3
fc10: 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 PagerGetExtra(pP
fc20: 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
fc30: 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
fc40: 2d 3e 61 44 61 74 61 20 3d 3d 20 73 71 6c 69 74 ->aData == sqlit
fc50: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
fc60: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
fc70: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
fc80: 65 2d 3e 69 73 49 6e 69 74 3d 3d 30 20 29 3b 0a e->isInit==0 );.
fc90: 0a 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e . pBt = pPage->
fca0: 70 42 74 3b 0a 20 20 68 64 72 20 3d 20 70 50 61 pBt;. hdr = pPa
fcb0: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 ge->hdrOffset;.
fcc0: 20 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 data = pPage->a
fcd0: 44 61 74 61 3b 0a 20 20 2f 2a 20 45 56 49 44 45 Data;. /* EVIDE
fce0: 4e 43 45 2d 4f 46 3a 20 52 2d 32 38 35 39 34 2d NCE-OF: R-28594-
fcf0: 30 32 38 39 30 20 54 68 65 20 6f 6e 65 2d 62 79 02890 The one-by
fd00: 74 65 20 66 6c 61 67 20 61 74 20 6f 66 66 73 65 te flag at offse
fd10: 74 20 30 20 69 6e 64 69 63 61 74 69 6e 67 0a 20 t 0 indicating.
fd20: 20 2a 2a 20 74 68 65 20 62 2d 74 72 65 65 20 70 ** the b-tree p
fd30: 61 67 65 20 74 79 70 65 2e 20 2a 2f 0a 20 20 69 age type. */. i
fd40: 66 28 20 64 65 63 6f 64 65 46 6c 61 67 73 28 70 f( decodeFlags(p
fd50: 50 61 67 65 2c 20 64 61 74 61 5b 68 64 72 5d 29 Page, data[hdr])
fd60: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
fd70: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
fd80: 47 45 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 GE(pPage);. }.
fd90: 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 61 assert( pBt->pa
fda0: 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 geSize>=512 && p
fdb0: 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 35 Bt->pageSize<=65
fdc0: 35 33 36 20 29 3b 0a 20 20 70 50 61 67 65 2d 3e 536 );. pPage->
fdd0: 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 31 36 29 maskPage = (u16)
fde0: 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d (pBt->pageSize -
fdf0: 20 31 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 4f 1);. pPage->nO
fe00: 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 20 75 verflow = 0;. u
fe10: 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 74 2d sableSize = pBt-
fe20: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 70 >usableSize;. p
fe30: 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 Page->cellOffset
fe40: 20 3d 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 = cellOffset =
fe50: 68 64 72 20 2b 20 38 20 2b 20 70 50 61 67 65 2d hdr + 8 + pPage-
fe60: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 >childPtrSize;.
fe70: 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 pPage->aDataEnd
fe80: 20 3d 20 26 64 61 74 61 5b 75 73 61 62 6c 65 53 = &data[usableS
fe90: 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d 3e 61 ize];. pPage->a
fea0: 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 61 5b CellIdx = &data[
feb0: 63 65 6c 6c 4f 66 66 73 65 74 5d 3b 0a 20 20 70 cellOffset];. p
fec0: 50 61 67 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 Page->aDataOfst
fed0: 3d 20 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 = &data[pPage->c
fee0: 68 69 6c 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 hildPtrSize];.
fef0: 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 /* EVIDENCE-OF:
ff00: 52 2d 35 38 30 31 35 2d 34 38 31 37 35 20 54 68 R-58015-48175 Th
ff10: 65 20 74 77 6f 2d 62 79 74 65 20 69 6e 74 65 67 e two-byte integ
ff20: 65 72 20 61 74 20 6f 66 66 73 65 74 20 35 20 64 er at offset 5 d
ff30: 65 73 69 67 6e 61 74 65 73 0a 20 20 2a 2a 20 74 esignates. ** t
ff40: 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 he start of the
ff50: 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 cell content are
ff60: 61 2e 20 41 20 7a 65 72 6f 20 76 61 6c 75 65 20 a. A zero value
ff70: 66 6f 72 20 74 68 69 73 20 69 6e 74 65 67 65 72 for this integer
ff80: 20 69 73 0a 20 20 2a 2a 20 69 6e 74 65 72 70 72 is. ** interpr
ff90: 65 74 65 64 20 61 73 20 36 35 35 33 36 2e 20 2a eted as 65536. *
ffa0: 2f 0a 20 20 74 6f 70 20 3d 20 67 65 74 32 62 79 /. top = get2by
ffb0: 74 65 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b teNotZero(&data[
ffc0: 68 64 72 2b 35 5d 29 3b 0a 20 20 2f 2a 20 45 56 hdr+5]);. /* EV
ffd0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 30 IDENCE-OF: R-370
ffe0: 30 32 2d 33 32 37 37 34 20 54 68 65 20 74 77 6f 02-32774 The two
fff0: 2d 62 79 74 65 20 69 6e 74 65 67 65 72 20 61 74 -byte integer at
10000 20 6f 66 66 73 65 74 20 33 20 67 69 76 65 73 20 offset 3 gives
10010 74 68 65 0a 20 20 2a 2a 20 6e 75 6d 62 65 72 20 the. ** number
10020 6f 66 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 20 of cells on the
10030 70 61 67 65 2e 20 2a 2f 0a 20 20 70 50 61 67 65 page. */. pPage
10040 2d 3e 6e 43 65 6c 6c 20 3d 20 67 65 74 32 62 79 ->nCell = get2by
10050 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 te(&data[hdr+3])
10060 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e ;. if( pPage->n
10070 43 65 6c 6c 3e 4d 58 5f 43 45 4c 4c 28 70 42 74 Cell>MX_CELL(pBt
10080 29 20 29 7b 0a 20 20 20 20 2f 2a 20 54 6f 20 6d ) ){. /* To m
10090 61 6e 79 20 63 65 6c 6c 73 20 66 6f 72 20 61 20 any cells for a
100a0 73 69 6e 67 6c 65 20 70 61 67 65 2e 20 20 54 68 single page. Th
100b0 65 20 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 e page must be c
100c0 6f 72 72 75 70 74 20 2a 2f 0a 20 20 20 20 72 65 orrupt */. re
100d0 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
100e0 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b UPT_PAGE(pPage);
100f0 0a 20 20 7d 0a 20 20 74 65 73 74 63 61 73 65 28 . }. testcase(
10100 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 4d pPage->nCell==M
10110 58 5f 43 45 4c 4c 28 70 42 74 29 20 29 3b 0a 20 X_CELL(pBt) );.
10120 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
10130 20 52 2d 32 34 30 38 39 2d 35 37 39 37 39 20 49 R-24089-57979 I
10140 66 20 61 20 70 61 67 65 20 63 6f 6e 74 61 69 6e f a page contain
10150 73 20 6e 6f 20 63 65 6c 6c 73 20 28 77 68 69 63 s no cells (whic
10160 68 20 69 73 20 6f 6e 6c 79 0a 20 20 2a 2a 20 70 h is only. ** p
10170 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 20 72 6f ossible for a ro
10180 6f 74 20 70 61 67 65 20 6f 66 20 61 20 74 61 62 ot page of a tab
10190 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 le that contains
101a0 20 6e 6f 20 72 6f 77 73 29 20 74 68 65 6e 20 74 no rows) then t
101b0 68 65 0a 20 20 2a 2a 20 6f 66 66 73 65 74 20 74 he. ** offset t
101c0 6f 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 o the cell conte
101d0 6e 74 20 61 72 65 61 20 77 69 6c 6c 20 65 71 75 nt area will equ
101e0 61 6c 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 al the page size
101f0 20 6d 69 6e 75 73 20 74 68 65 0a 20 20 2a 2a 20 minus the. **
10200 62 79 74 65 73 20 6f 66 20 72 65 73 65 72 76 65 bytes of reserve
10210 64 20 73 70 61 63 65 2e 20 2a 2f 0a 20 20 61 73 d space. */. as
10220 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 65 sert( pPage->nCe
10230 6c 6c 3e 30 20 7c 7c 20 74 6f 70 3d 3d 75 73 61 ll>0 || top==usa
10240 62 6c 65 53 69 7a 65 20 7c 7c 20 43 4f 52 52 55 bleSize || CORRU
10250 50 54 5f 44 42 20 29 3b 0a 0a 20 20 2f 2a 20 41 PT_DB );.. /* A
10260 20 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 61 62 malformed datab
10270 61 73 65 20 70 61 67 65 20 6d 69 67 68 74 20 63 ase page might c
10280 61 75 73 65 20 75 73 20 74 6f 20 72 65 61 64 20 ause us to read
10290 70 61 73 74 20 74 68 65 20 65 6e 64 0a 20 20 2a past the end. *
102a0 2a 20 6f 66 20 70 61 67 65 20 77 68 65 6e 20 70 * of page when p
102b0 61 72 73 69 6e 67 20 61 20 63 65 6c 6c 2e 20 20 arsing a cell.
102c0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 . **. ** The f
102d0 6f 6c 6c 6f 77 69 6e 67 20 62 6c 6f 63 6b 20 6f ollowing block o
102e0 66 20 63 6f 64 65 20 63 68 65 63 6b 73 20 65 61 f code checks ea
102f0 72 6c 79 20 74 6f 20 73 65 65 20 69 66 20 61 20 rly to see if a
10300 63 65 6c 6c 20 65 78 74 65 6e 64 73 0a 20 20 2a cell extends. *
10310 2a 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f * past the end o
10320 66 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 72 f a page boundar
10330 79 20 61 6e 64 20 63 61 75 73 65 73 20 53 51 4c y and causes SQL
10340 49 54 45 5f 43 4f 52 52 55 50 54 20 74 6f 20 62 ITE_CORRUPT to b
10350 65 20 0a 20 20 2a 2a 20 72 65 74 75 72 6e 65 64 e . ** returned
10360 20 69 66 20 69 74 20 64 6f 65 73 2e 0a 20 20 2a if it does.. *
10370 2f 0a 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d /. iCellFirst =
10380 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a cellOffset + 2*
10390 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
103a0 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 iCellLast = usab
103b0 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 69 66 leSize - 4;. if
103c0 28 20 70 42 74 2d 3e 64 62 2d 3e 66 6c 61 67 73 ( pBt->db->flags
103d0 20 26 20 53 51 4c 49 54 45 5f 43 65 6c 6c 53 69 & SQLITE_CellSi
103e0 7a 65 43 6b 20 29 7b 0a 20 20 20 20 69 6e 74 20 zeCk ){. int
103f0 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a i; /*
10400 20 49 6e 64 65 78 20 69 6e 74 6f 20 74 68 65 20 Index into the
10410 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 cell pointer arr
10420 61 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 73 7a ay */. int sz
10430 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ; /* S
10440 69 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a 2f ize of a cell */
10450 0a 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 .. if( !pPage
10460 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c 4c 61 ->leaf ) iCellLa
10470 73 74 2d 2d 3b 0a 20 20 20 20 66 6f 72 28 69 3d st--;. for(i=
10480 30 3b 20 69 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 0; i<pPage->nCel
10490 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 70 l; i++){. p
104a0 63 20 3d 20 67 65 74 32 62 79 74 65 41 6c 69 67 c = get2byteAlig
104b0 6e 65 64 28 26 64 61 74 61 5b 63 65 6c 6c 4f 66 ned(&data[cellOf
104c0 66 73 65 74 2b 69 2a 32 5d 29 3b 0a 20 20 20 20 fset+i*2]);.
104d0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
104e0 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
104f0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 63 testcase( pc
10500 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 ==iCellLast );.
10510 20 20 20 20 20 69 66 28 20 70 63 3c 69 43 65 6c if( pc<iCel
10520 6c 46 69 72 73 74 20 7c 7c 20 70 63 3e 69 43 65 lFirst || pc>iCe
10530 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 20 20 20 20 llLast ){.
10540 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
10550 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 CORRUPT_PAGE(pPa
10560 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ge);. }.
10570 20 20 20 73 7a 20 3d 20 70 50 61 67 65 2d 3e 78 sz = pPage->x
10580 43 65 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 CellSize(pPage,
10590 26 64 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 &data[pc]);.
105a0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
105b0 7a 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b z==usableSize );
105c0 0a 20 20 20 20 20 20 69 66 28 20 70 63 2b 73 7a . if( pc+sz
105d0 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b 0a 20 >usableSize ){.
105e0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
105f0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 LITE_CORRUPT_PAG
10600 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 E(pPage);.
10610 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 }. }. if(
10620 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 20 69 !pPage->leaf ) i
10630 43 65 6c 6c 4c 61 73 74 2b 2b 3b 0a 20 20 7d 20 CellLast++;. }
10640 20 0a 0a 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 .. /* Compute
10650 74 68 65 20 74 6f 74 61 6c 20 66 72 65 65 20 73 the total free s
10660 70 61 63 65 20 6f 6e 20 74 68 65 20 70 61 67 65 pace on the page
10670 0a 20 20 2a 2a 20 45 56 49 44 45 4e 43 45 2d 4f . ** EVIDENCE-O
10680 46 3a 20 52 2d 32 33 35 38 38 2d 33 34 34 35 30 F: R-23588-34450
10690 20 54 68 65 20 74 77 6f 2d 62 79 74 65 20 69 6e The two-byte in
106a0 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
106b0 31 20 67 69 76 65 73 20 74 68 65 0a 20 20 2a 2a 1 gives the. **
106c0 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 66 69 start of the fi
106d0 72 73 74 20 66 72 65 65 62 6c 6f 63 6b 20 6f 6e rst freeblock on
106e0 20 74 68 65 20 70 61 67 65 2c 20 6f 72 20 69 73 the page, or is
106f0 20 7a 65 72 6f 20 69 66 20 74 68 65 72 65 20 61 zero if there a
10700 72 65 20 6e 6f 0a 20 20 2a 2a 20 66 72 65 65 62 re no. ** freeb
10710 6c 6f 63 6b 73 2e 20 2a 2f 0a 20 20 70 63 20 3d locks. */. pc =
10720 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
10730 68 64 72 2b 31 5d 29 3b 0a 20 20 6e 46 72 65 65 hdr+1]);. nFree
10740 20 3d 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 2b = data[hdr+7] +
10750 20 74 6f 70 3b 20 20 2f 2a 20 49 6e 69 74 20 6e top; /* Init n
10760 46 72 65 65 20 74 6f 20 6e 6f 6e 2d 66 72 65 65 Free to non-free
10770 62 6c 6f 63 6b 20 66 72 65 65 20 73 70 61 63 65 block free space
10780 20 2a 2f 0a 20 20 69 66 28 20 70 63 3e 30 20 29 */. if( pc>0 )
10790 7b 0a 20 20 20 20 75 33 32 20 6e 65 78 74 2c 20 {. u32 next,
107a0 73 69 7a 65 3b 0a 20 20 20 20 69 66 28 20 70 63 size;. if( pc
107b0 3c 69 43 65 6c 6c 46 69 72 73 74 20 29 7b 0a 20 <iCellFirst ){.
107c0 20 20 20 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 /* EVIDENCE
107d0 2d 4f 46 3a 20 52 2d 35 35 35 33 30 2d 35 32 39 -OF: R-55530-529
107e0 33 30 20 49 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 30 In a well-for
107f0 6d 65 64 20 62 2d 74 72 65 65 20 70 61 67 65 2c med b-tree page,
10800 20 74 68 65 72 65 20 77 69 6c 6c 0a 20 20 20 20 there will.
10810 20 20 2a 2a 20 61 6c 77 61 79 73 20 62 65 20 61 ** always be a
10820 74 20 6c 65 61 73 74 20 6f 6e 65 20 63 65 6c 6c t least one cell
10830 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 before the firs
10840 74 20 66 72 65 65 62 6c 6f 63 6b 2e 0a 20 20 20 t freeblock..
10850 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 */. retu
10860 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
10870 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 20 0a T_PAGE(pPage); .
10880 20 20 20 20 7d 0a 20 20 20 20 77 68 69 6c 65 28 }. while(
10890 20 31 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 1 ){. if(
108a0 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
108b0 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 62 /* Freeb
108c0 6c 6f 63 6b 20 6f 66 66 20 74 68 65 20 65 6e 64 lock off the end
108d0 20 6f 66 20 74 68 65 20 70 61 67 65 20 2a 2f 0a of the page */.
108e0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
108f0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
10900 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 GE(pPage);.
10910 20 7d 0a 20 20 20 20 20 20 6e 65 78 74 20 3d 20 }. next =
10920 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 get2byte(&data[p
10930 63 5d 29 3b 0a 20 20 20 20 20 20 73 69 7a 65 20 c]);. size
10940 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
10950 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 20 20 20 6e [pc+2]);. n
10960 46 72 65 65 20 3d 20 6e 46 72 65 65 20 2b 20 73 Free = nFree + s
10970 69 7a 65 3b 0a 20 20 20 20 20 20 69 66 28 20 6e ize;. if( n
10980 65 78 74 3c 3d 70 63 2b 73 69 7a 65 2b 33 20 29 ext<=pc+size+3 )
10990 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 70 63 break;. pc
109a0 20 3d 20 6e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 = next;. }.
109b0 20 20 20 69 66 28 20 6e 65 78 74 3e 30 20 29 7b if( next>0 ){
109c0 0a 20 20 20 20 20 20 2f 2a 20 46 72 65 65 62 6c . /* Freebl
109d0 6f 63 6b 20 6e 6f 74 20 69 6e 20 61 73 63 65 6e ock not in ascen
109e0 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 20 20 ding order */.
109f0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
10a00 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 28 70 E_CORRUPT_PAGE(p
10a10 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 Page);. }.
10a20 20 69 66 28 20 70 63 2b 73 69 7a 65 3e 28 75 6e if( pc+size>(un
10a30 73 69 67 6e 65 64 20 69 6e 74 29 75 73 61 62 6c signed int)usabl
10a40 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 2f eSize ){. /
10a50 2a 20 4c 61 73 74 20 66 72 65 65 62 6c 6f 63 6b * Last freeblock
10a60 20 65 78 74 65 6e 64 73 20 70 61 73 74 20 70 61 extends past pa
10a70 67 65 20 65 6e 64 20 2a 2f 0a 20 20 20 20 20 20 ge end */.
10a80 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
10a90 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 65 RRUPT_PAGE(pPage
10aa0 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
10ab0 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 /* At this point
10ac0 2c 20 6e 46 72 65 65 20 63 6f 6e 74 61 69 6e 73 , nFree contains
10ad0 20 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 the sum of the
10ae0 6f 66 66 73 65 74 20 74 6f 20 74 68 65 20 73 74 offset to the st
10af0 61 72 74 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 art. ** of the
10b00 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 cell-content are
10b10 61 20 70 6c 75 73 20 74 68 65 20 6e 75 6d 62 65 a plus the numbe
10b20 72 20 6f 66 20 66 72 65 65 20 62 79 74 65 73 20 r of free bytes
10b30 77 69 74 68 69 6e 0a 20 20 2a 2a 20 74 68 65 20 within. ** the
10b40 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 20 61 72 65 cell-content are
10b50 61 2e 20 49 66 20 74 68 69 73 20 69 73 20 67 72 a. If this is gr
10b60 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 75 eater than the u
10b70 73 61 62 6c 65 2d 73 69 7a 65 0a 20 20 2a 2a 20 sable-size. **
10b80 6f 66 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 of the page, the
10b90 6e 20 74 68 65 20 70 61 67 65 20 6d 75 73 74 20 n the page must
10ba0 62 65 20 63 6f 72 72 75 70 74 65 64 2e 20 54 68 be corrupted. Th
10bb0 69 73 20 63 68 65 63 6b 20 61 6c 73 6f 0a 20 20 is check also.
10bc0 2a 2a 20 73 65 72 76 65 73 20 74 6f 20 76 65 72 ** serves to ver
10bd0 69 66 79 20 74 68 61 74 20 74 68 65 20 6f 66 66 ify that the off
10be0 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 set to the start
10bf0 20 6f 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e of the cell-con
10c00 74 65 6e 74 0a 20 20 2a 2a 20 61 72 65 61 2c 20 tent. ** area,
10c10 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 according to the
10c20 20 70 61 67 65 20 68 65 61 64 65 72 2c 20 6c 69 page header, li
10c30 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 es within the pa
10c40 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e ge.. */. if( n
10c50 46 72 65 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 Free>usableSize
10c60 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
10c70 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 LITE_CORRUPT_PAG
10c80 45 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 E(pPage);. }.
10c90 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 pPage->nFree = (
10ca0 75 31 36 29 28 6e 46 72 65 65 20 2d 20 69 43 65 u16)(nFree - iCe
10cb0 6c 6c 46 69 72 73 74 29 3b 0a 20 20 70 50 61 67 llFirst);. pPag
10cc0 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 3b 0a 20 e->isInit = 1;.
10cd0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
10ce0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 K;.}../*.** Set
10cf0 75 70 20 61 20 72 61 77 20 70 61 67 65 20 73 6f up a raw page so
10d00 20 74 68 61 74 20 69 74 20 6c 6f 6f 6b 73 20 6c that it looks l
10d10 69 6b 65 20 61 20 64 61 74 61 62 61 73 65 20 70 ike a database p
10d20 61 67 65 20 68 6f 6c 64 69 6e 67 0a 2a 2a 20 6e age holding.** n
10d30 6f 20 65 6e 74 72 69 65 73 2e 0a 2a 2f 0a 73 74 o entries..*/.st
10d40 61 74 69 63 20 76 6f 69 64 20 7a 65 72 6f 50 61 atic void zeroPa
10d50 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ge(MemPage *pPag
10d60 65 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a 20 e, int flags){.
10d70 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
10d80 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
10d90 61 74 61 3b 0a 20 20 42 74 53 68 61 72 65 64 20 ata;. BtShared
10da0 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 *pBt = pPage->pB
10db0 74 3b 0a 20 20 75 38 20 68 64 72 20 3d 20 70 50 t;. u8 hdr = pP
10dc0 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
10dd0 20 20 75 31 36 20 66 69 72 73 74 3b 0a 0a 20 20 u16 first;..
10de0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
10df0 61 67 65 72 50 61 67 65 6e 75 6d 62 65 72 28 70 agerPagenumber(p
10e00 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d Page->pDbPage)==
10e10 70 50 61 67 65 2d 3e 70 67 6e 6f 20 29 3b 0a 20 pPage->pgno );.
10e20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
10e30 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 PagerGetExtra(pP
10e40 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d age->pDbPage) ==
10e50 20 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b (void*)pPage );
10e60 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
10e70 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
10e80 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d Page->pDbPage) =
10e90 3d 20 64 61 74 61 20 29 3b 0a 20 20 61 73 73 65 = data );. asse
10ea0 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
10eb0 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
10ec0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
10ed0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
10ee0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
10ef0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
10f00 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
10f10 20 42 54 53 5f 46 41 53 54 5f 53 45 43 55 52 45 BTS_FAST_SECURE
10f20 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 26 ){. memset(&
10f30 64 61 74 61 5b 68 64 72 5d 2c 20 30 2c 20 70 42 data[hdr], 0, pB
10f40 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
10f50 68 64 72 29 3b 0a 20 20 7d 0a 20 20 64 61 74 61 hdr);. }. data
10f60 5b 68 64 72 5d 20 3d 20 28 63 68 61 72 29 66 6c [hdr] = (char)fl
10f70 61 67 73 3b 0a 20 20 66 69 72 73 74 20 3d 20 68 ags;. first = h
10f80 64 72 20 2b 20 28 28 66 6c 61 67 73 26 50 54 46 dr + ((flags&PTF
10f90 5f 4c 45 41 46 29 3d 3d 30 20 3f 20 31 32 20 3a _LEAF)==0 ? 12 :
10fa0 20 38 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 64 8);. memset(&d
10fb0 61 74 61 5b 68 64 72 2b 31 5d 2c 20 30 2c 20 34 ata[hdr+1], 0, 4
10fc0 29 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 5d );. data[hdr+7]
10fd0 20 3d 20 30 3b 0a 20 20 70 75 74 32 62 79 74 65 = 0;. put2byte
10fe0 28 26 64 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 (&data[hdr+5], p
10ff0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b Bt->usableSize);
11000 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 . pPage->nFree
11010 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 75 73 61 = (u16)(pBt->usa
11020 62 6c 65 53 69 7a 65 20 2d 20 66 69 72 73 74 29 bleSize - first)
11030 3b 0a 20 20 64 65 63 6f 64 65 46 6c 61 67 73 28 ;. decodeFlags(
11040 70 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 pPage, flags);.
11050 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
11060 65 74 20 3d 20 66 69 72 73 74 3b 0a 20 20 70 50 et = first;. pP
11070 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 3d 20 age->aDataEnd =
11080 26 64 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c &data[pBt->usabl
11090 65 53 69 7a 65 5d 3b 0a 20 20 70 50 61 67 65 2d eSize];. pPage-
110a0 3e 61 43 65 6c 6c 49 64 78 20 3d 20 26 64 61 74 >aCellIdx = &dat
110b0 61 5b 66 69 72 73 74 5d 3b 0a 20 20 70 50 61 67 a[first];. pPag
110c0 65 2d 3e 61 44 61 74 61 4f 66 73 74 20 3d 20 26 e->aDataOfst = &
110d0 64 61 74 61 5b 70 50 61 67 65 2d 3e 63 68 69 6c data[pPage->chil
110e0 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 70 50 61 dPtrSize];. pPa
110f0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 ge->nOverflow =
11100 30 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 0;. assert( pBt
11110 2d 3e 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 ->pageSize>=512
11120 26 26 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 && pBt->pageSize
11130 3c 3d 36 35 35 33 36 20 29 3b 0a 20 20 70 50 61 <=65536 );. pPa
11140 67 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 ge->maskPage = (
11150 75 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 u16)(pBt->pageSi
11160 7a 65 20 2d 20 31 29 3b 0a 20 20 70 50 61 67 65 ze - 1);. pPage
11170 2d 3e 6e 43 65 6c 6c 20 3d 20 30 3b 0a 20 20 70 ->nCell = 0;. p
11180 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 31 Page->isInit = 1
11190 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 ;.}.../*.** Conv
111a0 65 72 74 20 61 20 44 62 50 61 67 65 20 6f 62 74 ert a DbPage obt
111b0 61 69 6e 65 64 20 66 72 6f 6d 20 74 68 65 20 70 ained from the p
111c0 61 67 65 72 20 69 6e 74 6f 20 61 20 4d 65 6d 50 ager into a MemP
111d0 61 67 65 20 75 73 65 64 20 62 79 0a 2a 2a 20 74 age used by.** t
111e0 68 65 20 62 74 72 65 65 20 6c 61 79 65 72 2e 0a he btree layer..
111f0 2a 2f 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 */.static MemPag
11200 65 20 2a 62 74 72 65 65 50 61 67 65 46 72 6f 6d e *btreePageFrom
11210 44 62 50 61 67 65 28 44 62 50 61 67 65 20 2a 70 DbPage(DbPage *p
11220 44 62 50 61 67 65 2c 20 50 67 6e 6f 20 70 67 6e DbPage, Pgno pgn
11230 6f 2c 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 o, BtShared *pBt
11240 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
11250 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 age = (MemPage*)
11260 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 sqlite3PagerGetE
11270 78 74 72 61 28 70 44 62 50 61 67 65 29 3b 0a 20 xtra(pDbPage);.
11280 20 69 66 28 20 70 67 6e 6f 21 3d 70 50 61 67 65 if( pgno!=pPage
11290 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50 ->pgno ){. pP
112a0 61 67 65 2d 3e 61 44 61 74 61 20 3d 20 73 71 6c age->aData = sql
112b0 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
112c0 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 70 (pDbPage);. p
112d0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 20 3d 20 Page->pDbPage =
112e0 70 44 62 50 61 67 65 3b 0a 20 20 20 20 70 50 61 pDbPage;. pPa
112f0 67 65 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 ge->pBt = pBt;.
11300 20 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f 20 3d pPage->pgno =
11310 20 70 67 6e 6f 3b 0a 20 20 20 20 70 50 61 67 65 pgno;. pPage
11320 2d 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 70 67 ->hdrOffset = pg
11330 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 3b no==1 ? 100 : 0;
11340 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
11350 50 61 67 65 2d 3e 61 44 61 74 61 3d 3d 73 71 6c Page->aData==sql
11360 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 61 ite3PagerGetData
11370 28 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 72 (pDbPage) );. r
11380 65 74 75 72 6e 20 70 50 61 67 65 3b 20 0a 7d 0a eturn pPage; .}.
11390 0a 2f 2a 0a 2a 2a 20 47 65 74 20 61 20 70 61 67 ./*.** Get a pag
113a0 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 72 e from the pager
113b0 2e 20 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 . Initialize th
113c0 65 20 4d 65 6d 50 61 67 65 2e 70 42 74 20 61 6e e MemPage.pBt an
113d0 64 0a 2a 2a 20 4d 65 6d 50 61 67 65 2e 61 44 61 d.** MemPage.aDa
113e0 74 61 20 65 6c 65 6d 65 6e 74 73 20 69 66 20 6e ta elements if n
113f0 65 65 64 65 64 2e 20 20 53 65 65 20 61 6c 73 6f eeded. See also
11400 3a 20 62 74 72 65 65 47 65 74 55 6e 75 73 65 64 : btreeGetUnused
11410 50 61 67 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 Page()..**.** If
11420 20 74 68 65 20 50 41 47 45 52 5f 47 45 54 5f 4e the PAGER_GET_N
11430 4f 43 4f 4e 54 45 4e 54 20 66 6c 61 67 20 69 73 OCONTENT flag is
11440 20 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 set, it means t
11450 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 hat we do not ca
11460 72 65 0a 2a 2a 20 61 62 6f 75 74 20 74 68 65 20 re.** about the
11470 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
11480 61 67 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 age at this time
11490 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 . So do not go
114a0 74 6f 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 74 to the disk.** t
114b0 6f 20 66 65 74 63 68 20 74 68 65 20 63 6f 6e 74 o fetch the cont
114c0 65 6e 74 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 ent. Just fill
114d0 69 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 in the content w
114e0 69 74 68 20 7a 65 72 6f 73 20 66 6f 72 20 6e 6f ith zeros for no
114f0 77 2e 0a 2a 2a 20 49 66 20 69 6e 20 74 68 65 20 w..** If in the
11500 66 75 74 75 72 65 20 77 65 20 63 61 6c 6c 20 73 future we call s
11510 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
11520 28 29 20 6f 6e 20 74 68 69 73 20 70 61 67 65 2c () on this page,
11530 20 74 68 61 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 that.** means w
11540 65 20 68 61 76 65 20 73 74 61 72 74 65 64 20 74 e have started t
11550 6f 20 62 65 20 63 6f 6e 63 65 72 6e 65 64 20 61 o be concerned a
11560 62 6f 75 74 20 63 6f 6e 74 65 6e 74 20 61 6e 64 bout content and
11570 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 72 65 61 the disk.** rea
11580 64 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 d should occur a
11590 74 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f t that point..*/
115a0 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
115b0 65 47 65 74 50 61 67 65 28 0a 20 20 42 74 53 68 eGetPage(. BtSh
115c0 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
115d0 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
115e0 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 . Pgno pgno,
115f0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
11600 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f r of the page to
11610 20 66 65 74 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 fetch */. MemP
11620 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
11630 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 70 /* Return the p
11640 61 67 65 20 69 6e 20 74 68 69 73 20 70 61 72 61 age in this para
11650 6d 65 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 66 meter */. int f
11660 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 lags
11670 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f 43 /* PAGER_GET_NOC
11680 4f 4e 54 45 4e 54 20 6f 72 20 50 41 47 45 52 5f ONTENT or PAGER_
11690 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 2a 2f 0a GET_READONLY */.
116a0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 ){. int rc;. D
116b0 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a bPage *pDbPage;.
116c0 0a 20 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 . assert( flags
116d0 3d 3d 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 ==0 || flags==PA
116e0 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e GER_GET_NOCONTEN
116f0 54 20 7c 7c 20 66 6c 61 67 73 3d 3d 50 41 47 45 T || flags==PAGE
11700 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 20 29 R_GET_READONLY )
11710 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
11720 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
11730 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
11740 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
11750 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 72 rGet(pBt->pPager
11760 2c 20 70 67 6e 6f 2c 20 28 44 62 50 61 67 65 2a , pgno, (DbPage*
11770 2a 29 26 70 44 62 50 61 67 65 2c 20 66 6c 61 67 *)&pDbPage, flag
11780 73 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 s);. if( rc ) r
11790 65 74 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 eturn rc;. *ppP
117a0 61 67 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 age = btreePageF
117b0 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 romDbPage(pDbPag
117c0 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 e, pgno, pBt);.
117d0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
117e0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 K;.}../*.** Retr
117f0 69 65 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d ieve a page from
11800 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
11810 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 74 . If the request
11820 65 64 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a ed page is not.*
11830 2a 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 * already in the
11840 20 70 61 67 65 72 20 63 61 63 68 65 20 72 65 74 pager cache ret
11850 75 72 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 urn NULL. Initia
11860 6c 69 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 lize the MemPage
11870 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 .pBt and.** MemP
11880 61 67 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e age.aData elemen
11890 74 73 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f ts if needed..*/
118a0 0a 73 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 .static MemPage
118b0 2a 62 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 *btreePageLookup
118c0 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 (BtShared *pBt,
118d0 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 Pgno pgno){. Db
118e0 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 Page *pDbPage;.
118f0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
11900 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
11910 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 >mutex) );. pDb
11920 50 61 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 Page = sqlite3Pa
11930 67 65 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 gerLookup(pBt->p
11940 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 Pager, pgno);.
11950 69 66 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 if( pDbPage ){.
11960 20 20 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 return btreeP
11970 61 67 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 ageFromDbPage(pD
11980 62 50 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 bPage, pgno, pBt
11990 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
119a0 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 0;.}../*.** Retu
119b0 72 6e 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 rn the size of t
119c0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
119d0 20 69 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 in pages. If th
119e0 65 72 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 ere is any kind
119f0 6f 66 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 of.** error, ret
11a00 75 72 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 urn ((unsigned i
11a10 6e 74 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 nt)-1)..*/.stati
11a20 63 20 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 c Pgno btreePage
11a30 63 6f 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a count(BtShared *
11a40 70 42 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 pBt){. return p
11a50 42 74 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 Bt->nPage;.}.u32
11a60 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 sqlite3BtreeLas
11a70 74 50 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b tPage(Btree *p){
11a80 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
11a90 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
11aa0 78 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 x(p) );. assert
11ab0 28 20 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 ( ((p->pBt->nPag
11ac0 65 29 26 30 78 38 30 30 30 30 30 30 30 29 3d 3d e)&0x80000000)==
11ad0 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 62 74 0 );. return bt
11ae0 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 2d 3e reePagecount(p->
11af0 70 42 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 pBt);.}../*.** G
11b00 65 74 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 et a page from t
11b10 68 65 20 70 61 67 65 72 20 61 6e 64 20 69 6e 69 he pager and ini
11b20 74 69 61 6c 69 7a 65 20 69 74 2e 0a 2a 2a 0a 2a tialize it..**.*
11b30 2a 20 49 66 20 70 43 75 72 21 3d 30 20 74 68 65 * If pCur!=0 the
11b40 6e 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65 n the page is be
11b50 69 6e 67 20 66 65 74 63 68 65 64 20 61 73 20 70 ing fetched as p
11b60 61 72 74 20 6f 66 20 61 20 6d 6f 76 65 54 6f 43 art of a moveToC
11b70 68 69 6c 64 28 29 0a 2a 2a 20 63 61 6c 6c 2e 20 hild().** call.
11b80 20 44 6f 20 61 64 64 69 74 69 6f 6e 61 6c 20 73 Do additional s
11b90 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f anity checking o
11ba0 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 n the page in th
11bb0 69 73 20 63 61 73 65 2e 0a 2a 2a 20 41 6e 64 20 is case..** And
11bc0 69 66 20 74 68 65 20 66 65 74 63 68 20 66 61 69 if the fetch fai
11bd0 6c 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 ls, this routine
11be0 20 6d 75 73 74 20 64 65 63 72 65 6d 65 6e 74 20 must decrement
11bf0 70 43 75 72 2d 3e 69 50 61 67 65 2e 0a 2a 2a 0a pCur->iPage..**.
11c00 2a 2a 20 54 68 65 20 70 61 67 65 20 69 73 20 66 ** The page is f
11c10 65 74 63 68 65 64 20 61 73 20 72 65 61 64 2d 77 etched as read-w
11c20 72 69 74 65 20 75 6e 6c 65 73 73 20 70 43 75 72 rite unless pCur
11c30 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 61 6e 64 is not NULL and
11c40 20 69 73 0a 2a 2a 20 61 20 72 65 61 64 2d 6f 6e is.** a read-on
11c50 6c 79 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a ly cursor..**.**
11c60 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
11c70 75 72 73 2c 20 74 68 65 6e 20 2a 70 70 50 61 67 urs, then *ppPag
11c80 65 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 e is undefined.
11c90 49 74 0a 2a 2a 20 6d 61 79 20 72 65 6d 61 69 6e It.** may remain
11ca0 20 75 6e 63 68 61 6e 67 65 64 2c 20 6f 72 20 69 unchanged, or i
11cb0 74 20 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 t may be set to
11cc0 61 6e 20 69 6e 76 61 6c 69 64 20 76 61 6c 75 65 an invalid value
11cd0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
11ce0 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 0a getAndInitPage(.
11cf0 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c BtShared *pBt,
11d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11d10 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 /* The databas
11d20 65 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f e file */. Pgno
11d30 20 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 pgno,
11d40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
11d50 75 6d 62 65 72 20 6f 66 20 74 68 65 20 70 61 67 umber of the pag
11d60 65 20 74 6f 20 67 65 74 20 2a 2f 0a 20 20 4d 65 e to get */. Me
11d70 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 mPage **ppPage,
11d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
11d90 20 57 72 69 74 65 20 74 68 65 20 70 61 67 65 20 Write the page
11da0 70 6f 69 6e 74 65 72 20 68 65 72 65 20 2a 2f 0a pointer here */.
11db0 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 BtCursor *pCur
11dc0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
11dd0 20 20 2f 2a 20 43 75 72 73 6f 72 20 74 6f 20 72 /* Cursor to r
11de0 65 63 65 69 76 65 20 74 68 65 20 70 61 67 65 2c eceive the page,
11df0 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 69 6e or NULL */. in
11e00 74 20 62 52 65 61 64 4f 6e 6c 79 20 20 20 20 20 t bReadOnly
11e10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
11e20 20 54 72 75 65 20 66 6f 72 20 61 20 72 65 61 64 True for a read
11e30 2d 6f 6e 6c 79 20 70 61 67 65 20 2a 2f 0a 29 7b -only page */.){
11e40 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 44 62 50 . int rc;. DbP
11e50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 age *pDbPage;.
11e60 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
11e70 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
11e80 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
11e90 72 74 28 20 70 43 75 72 3d 3d 30 20 7c 7c 20 70 rt( pCur==0 || p
11ea0 70 50 61 67 65 3d 3d 26 70 43 75 72 2d 3e 70 50 pPage==&pCur->pP
11eb0 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 age );. assert(
11ec0 20 70 43 75 72 3d 3d 30 20 7c 7c 20 62 52 65 61 pCur==0 || bRea
11ed0 64 4f 6e 6c 79 3d 3d 70 43 75 72 2d 3e 63 75 72 dOnly==pCur->cur
11ee0 50 61 67 65 72 46 6c 61 67 73 20 29 3b 0a 20 20 PagerFlags );.
11ef0 61 73 73 65 72 74 28 20 70 43 75 72 3d 3d 30 20 assert( pCur==0
11f00 7c 7c 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 30 || pCur->iPage>0
11f10 20 29 3b 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e );.. if( pgno>
11f20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 btreePagecount(p
11f30 42 74 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 Bt) ){. rc =
11f40 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
11f50 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 67 65 KPT;. goto ge
11f60 74 41 6e 64 49 6e 69 74 50 61 67 65 5f 65 72 72 tAndInitPage_err
11f70 6f 72 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 or;. }. rc = s
11f80 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
11f90 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f Bt->pPager, pgno
11fa0 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 62 , (DbPage**)&pDb
11fb0 50 61 67 65 2c 20 62 52 65 61 64 4f 6e 6c 79 29 Page, bReadOnly)
11fc0 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 ;. if( rc ){.
11fd0 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 49 6e 69 goto getAndIni
11fe0 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a 20 20 7d tPage_error;. }
11ff0 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 28 4d 65 . *ppPage = (Me
12000 6d 50 61 67 65 2a 29 73 71 6c 69 74 65 33 50 61 mPage*)sqlite3Pa
12010 67 65 72 47 65 74 45 78 74 72 61 28 70 44 62 50 gerGetExtra(pDbP
12020 61 67 65 29 3b 0a 20 20 69 66 28 20 28 2a 70 70 age);. if( (*pp
12030 50 61 67 65 29 2d 3e 69 73 49 6e 69 74 3d 3d 30 Page)->isInit==0
12040 20 29 7b 0a 20 20 20 20 62 74 72 65 65 50 61 67 ){. btreePag
12050 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 eFromDbPage(pDbP
12060 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b age, pgno, pBt);
12070 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 49 . rc = btreeI
12080 6e 69 74 50 61 67 65 28 2a 70 70 50 61 67 65 29 nitPage(*ppPage)
12090 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
120a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
120b0 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 releasePage(*pp
120c0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 67 6f 74 Page);. got
120d0 6f 20 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 o getAndInitPage
120e0 5f 65 72 72 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 _error;. }.
120f0 7d 0a 20 20 61 73 73 65 72 74 28 20 28 2a 70 70 }. assert( (*pp
12100 50 61 67 65 29 2d 3e 70 67 6e 6f 3d 3d 70 67 6e Page)->pgno==pgn
12110 6f 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 o );. assert( (
12120 2a 70 70 50 61 67 65 29 2d 3e 61 44 61 74 61 3d *ppPage)->aData=
12130 3d 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 =sqlite3PagerGet
12140 44 61 74 61 28 70 44 62 50 61 67 65 29 20 29 3b Data(pDbPage) );
12150 0a 0a 20 20 2f 2a 20 49 66 20 6f 62 74 61 69 6e .. /* If obtain
12160 69 6e 67 20 61 20 63 68 69 6c 64 20 70 61 67 65 ing a child page
12170 20 66 6f 72 20 61 20 63 75 72 73 6f 72 2c 20 77 for a cursor, w
12180 65 20 6d 75 73 74 20 76 65 72 69 66 79 20 74 68 e must verify th
12190 61 74 20 74 68 65 20 70 61 67 65 20 69 73 0a 20 at the page is.
121a0 20 2a 2a 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 ** compatible w
121b0 69 74 68 20 74 68 65 20 72 6f 6f 74 20 70 61 67 ith the root pag
121c0 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 43 75 72 e. */. if( pCur
121d0 20 26 26 20 28 28 2a 70 70 50 61 67 65 29 2d 3e && ((*ppPage)->
121e0 6e 43 65 6c 6c 3c 31 20 7c 7c 20 28 2a 70 70 50 nCell<1 || (*ppP
121f0 61 67 65 29 2d 3e 69 6e 74 4b 65 79 21 3d 70 43 age)->intKey!=pC
12200 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 29 20 29 ur->curIntKey) )
12210 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
12220 45 5f 43 4f 52 52 55 50 54 5f 50 47 4e 4f 28 70 E_CORRUPT_PGNO(p
12230 67 6e 6f 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 gno);. releas
12240 65 50 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a ePage(*ppPage);.
12250 20 20 20 20 67 6f 74 6f 20 67 65 74 41 6e 64 49 goto getAndI
12260 6e 69 74 50 61 67 65 5f 65 72 72 6f 72 3b 0a 20 nitPage_error;.
12270 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
12280 54 45 5f 4f 4b 3b 0a 0a 67 65 74 41 6e 64 49 6e TE_OK;..getAndIn
12290 69 74 50 61 67 65 5f 65 72 72 6f 72 3a 0a 20 20 itPage_error:.
122a0 69 66 28 20 70 43 75 72 20 29 7b 0a 20 20 20 20 if( pCur ){.
122b0 70 43 75 72 2d 3e 69 50 61 67 65 2d 2d 3b 0a 20 pCur->iPage--;.
122c0 20 20 20 70 43 75 72 2d 3e 70 50 61 67 65 20 3d pCur->pPage =
122d0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
122e0 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 7d 0a ur->iPage];. }.
122f0 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e 6f testcase( pgno
12300 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
12310 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d 3d pgno!=0 || rc==
12320 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 29 SQLITE_CORRUPT )
12330 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
12340 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 ../*.** Release
12350 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 73 a MemPage. This
12360 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c 65 should be calle
12370 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 d once for each
12380 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 6f prior.** call to
12390 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a 2a btreeGetPage..*
123a0 2a 0a 2a 2a 20 50 61 67 65 31 20 69 73 20 61 20 *.** Page1 is a
123b0 73 70 65 63 69 61 6c 20 63 61 73 65 20 61 6e 64 special case and
123c0 20 6d 75 73 74 20 62 65 20 72 65 6c 65 61 73 65 must be release
123d0 64 20 75 73 69 6e 67 20 72 65 6c 65 61 73 65 50 d using releaseP
123e0 61 67 65 4f 6e 65 28 29 2e 0a 2a 2f 0a 73 74 61 ageOne()..*/.sta
123f0 74 69 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 tic void release
12400 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 4d 65 6d 50 PageNotNull(MemP
12410 61 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 61 age *pPage){. a
12420 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
12430 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ata );. assert(
12440 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 pPage->pBt );.
12450 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
12460 70 44 62 50 61 67 65 21 3d 30 20 29 3b 0a 20 20 pDbPage!=0 );.
12470 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 assert( sqlite3P
12480 61 67 65 72 47 65 74 45 78 74 72 61 28 70 50 61 agerGetExtra(pPa
12490 67 65 2d 3e 70 44 62 50 61 67 65 29 20 3d 3d 20 ge->pDbPage) ==
124a0 28 76 6f 69 64 2a 29 70 50 61 67 65 20 29 3b 0a (void*)pPage );.
124b0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
124c0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 50 3PagerGetData(pP
124d0 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3d 3d 70 age->pDbPage)==p
124e0 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a 20 Page->aData );.
124f0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
12500 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
12510 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
12520 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
12530 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 70 50 61 UnrefNotNull(pPa
12540 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 7d 0a ge->pDbPage);.}.
12550 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 6c 65 static void rele
12560 61 73 65 50 61 67 65 28 4d 65 6d 50 61 67 65 20 asePage(MemPage
12570 2a 70 50 61 67 65 29 7b 0a 20 20 69 66 28 20 70 *pPage){. if( p
12580 50 61 67 65 20 29 20 72 65 6c 65 61 73 65 50 61 Page ) releasePa
12590 67 65 4e 6f 74 4e 75 6c 6c 28 70 50 61 67 65 29 geNotNull(pPage)
125a0 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 ;.}.static void
125b0 72 65 6c 65 61 73 65 50 61 67 65 4f 6e 65 28 4d releasePageOne(M
125c0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 7b 0a emPage *pPage){.
125d0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 21 assert( pPage!
125e0 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
125f0 70 50 61 67 65 2d 3e 61 44 61 74 61 20 29 3b 0a pPage->aData );.
12600 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
12610 3e 70 42 74 20 29 3b 0a 20 20 61 73 73 65 72 74 >pBt );. assert
12620 28 20 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 ( pPage->pDbPage
12630 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
12640 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
12650 45 78 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 Extra(pPage->pDb
12660 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 Page) == (void*)
12670 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 pPage );. asser
12680 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
12690 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 etData(pPage->pD
126a0 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 bPage)==pPage->a
126b0 44 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 Data );. assert
126c0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
126d0 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
126e0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c >mutex) );. sql
126f0 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 50 61 ite3PagerUnrefPa
12700 67 65 4f 6e 65 28 70 50 61 67 65 2d 3e 70 44 62 geOne(pPage->pDb
12710 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Page);.}../*.**
12720 47 65 74 20 61 6e 20 75 6e 75 73 65 64 20 70 61 Get an unused pa
12730 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 ge..**.** This w
12740 6f 72 6b 73 20 6a 75 73 74 20 6c 69 6b 65 20 62 orks just like b
12750 74 72 65 65 47 65 74 50 61 67 65 28 29 20 77 69 treeGetPage() wi
12760 74 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e 3a th the addition:
12770 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 49 66 20 74 .**.** * If t
12780 68 65 20 70 61 67 65 20 69 73 20 61 6c 72 65 61 he page is alrea
12790 64 79 20 69 6e 20 75 73 65 20 66 6f 72 20 73 6f dy in use for so
127a0 6d 65 20 6f 74 68 65 72 20 70 75 72 70 6f 73 65 me other purpose
127b0 2c 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a 2a , immediately.**
127c0 20 20 20 20 20 20 72 65 6c 65 61 73 65 20 69 74 release it
127d0 20 61 6e 64 20 72 65 74 75 72 6e 20 61 6e 20 53 and return an S
127e0 51 4c 49 54 45 5f 43 55 52 52 55 50 54 20 65 72 QLITE_CURRUPT er
127f0 72 6f 72 2e 0a 2a 2a 20 20 20 2a 20 20 4d 61 6b ror..** * Mak
12800 65 20 73 75 72 65 20 74 68 65 20 69 73 49 6e 69 e sure the isIni
12810 74 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 0a t flag is clear.
12820 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 */.static int bt
12830 72 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 reeGetUnusedPage
12840 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
12850 74 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 t, /* The
12860 62 74 72 65 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 btree */. Pgno
12870 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
12880 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 /* Number of the
12890 20 70 61 67 65 20 74 6f 20 66 65 74 63 68 20 2a page to fetch *
128a0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 /. MemPage **pp
128b0 50 61 67 65 2c 20 20 20 20 2f 2a 20 52 65 74 75 Page, /* Retu
128c0 72 6e 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 rn the page in t
128d0 68 69 73 20 70 61 72 61 6d 65 74 65 72 20 2a 2f his parameter */
128e0 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 . int flags
128f0 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 /* PAGER
12900 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 6f _GET_NOCONTENT o
12910 72 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 r PAGER_GET_READ
12920 4f 4e 4c 59 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ONLY */.){. int
12930 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 rc = btreeGetPa
12940 67 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 ge(pBt, pgno, pp
12950 50 61 67 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 Page, flags);.
12960 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
12970 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 73 71 6c K ){. if( sql
12980 69 74 65 33 50 61 67 65 72 50 61 67 65 52 65 66 ite3PagerPageRef
12990 63 6f 75 6e 74 28 28 2a 70 70 50 61 67 65 29 2d count((*ppPage)-
129a0 3e 70 44 62 50 61 67 65 29 3e 31 20 29 7b 0a 20 >pDbPage)>1 ){.
129b0 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
129c0 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 20 (*ppPage);.
129d0 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 *ppPage = 0;.
129e0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
129f0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
12a00 20 20 20 20 7d 0a 20 20 20 20 28 2a 70 70 50 61 }. (*ppPa
12a10 67 65 29 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b ge)->isInit = 0;
12a20 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 . }else{. *p
12a30 70 50 61 67 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 pPage = 0;. }.
12a40 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
12a50 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 61 20 72 /*.** During a r
12a60 6f 6c 6c 62 61 63 6b 2c 20 77 68 65 6e 20 74 68 ollback, when th
12a70 65 20 70 61 67 65 72 20 72 65 6c 6f 61 64 73 20 e pager reloads
12a80 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 74 6f information into
12a90 20 74 68 65 20 63 61 63 68 65 0a 2a 2a 20 73 6f the cache.** so
12aa0 20 74 68 61 74 20 74 68 65 20 63 61 63 68 65 20 that the cache
12ab0 69 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 is restored to i
12ac0 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 ts original stat
12ad0 65 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f e at the start o
12ae0 66 0a 2a 2a 20 74 68 65 20 74 72 61 6e 73 61 63 f.** the transac
12af0 74 69 6f 6e 2c 20 66 6f 72 20 65 61 63 68 20 70 tion, for each p
12b00 61 67 65 20 72 65 73 74 6f 72 65 64 20 74 68 69 age restored thi
12b10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
12b20 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 led..**.** This
12b30 72 6f 75 74 69 6e 65 20 6e 65 65 64 73 20 74 6f routine needs to
12b40 20 72 65 73 65 74 20 74 68 65 20 65 78 74 72 61 reset the extra
12b50 20 64 61 74 61 20 73 65 63 74 69 6f 6e 20 61 74 data section at
12b60 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 0a the end of the.
12b70 2a 2a 20 70 61 67 65 20 74 6f 20 61 67 72 65 65 ** page to agree
12b80 20 77 69 74 68 20 74 68 65 20 72 65 73 74 6f 72 with the restor
12b90 65 64 20 64 61 74 61 2e 0a 2a 2f 0a 73 74 61 74 ed data..*/.stat
12ba0 69 63 20 76 6f 69 64 20 70 61 67 65 52 65 69 6e ic void pageRein
12bb0 69 74 28 44 62 50 61 67 65 20 2a 70 44 61 74 61 it(DbPage *pData
12bc0 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 ){. MemPage *pP
12bd0 61 67 65 3b 0a 20 20 70 50 61 67 65 20 3d 20 28 age;. pPage = (
12be0 4d 65 6d 50 61 67 65 20 2a 29 73 71 6c 69 74 65 MemPage *)sqlite
12bf0 33 50 61 67 65 72 47 65 74 45 78 74 72 61 28 70 3PagerGetExtra(p
12c00 44 61 74 61 29 3b 0a 20 20 61 73 73 65 72 74 28 Data);. assert(
12c10 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
12c20 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12c30 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 >0 );. if( pPag
12c40 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 20 e->isInit ){.
12c50 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
12c60 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 _mutex_held(pPag
12c70 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 e->pBt->mutex) )
12c80 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 49 ;. pPage->isI
12c90 6e 69 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 nit = 0;. if(
12ca0 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
12cb0 65 52 65 66 63 6f 75 6e 74 28 70 44 61 74 61 29 eRefcount(pData)
12cc0 3e 31 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 70 >1 ){. /* p
12cd0 50 61 67 65 20 6d 69 67 68 74 20 6e 6f 74 20 62 Page might not b
12ce0 65 20 61 20 62 74 72 65 65 20 70 61 67 65 3b 20 e a btree page;
12cf0 20 69 74 20 6d 69 67 68 74 20 62 65 20 61 6e 20 it might be an
12d00 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 overflow page.
12d10 20 20 20 20 2a 2a 20 6f 72 20 70 74 72 6d 61 70 ** or ptrmap
12d20 20 70 61 67 65 20 6f 72 20 61 20 66 72 65 65 20 page or a free
12d30 70 61 67 65 2e 20 20 49 6e 20 74 68 6f 73 65 20 page. In those
12d40 63 61 73 65 73 2c 20 74 68 65 20 66 6f 6c 6c 6f cases, the follo
12d50 77 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 63 61 wing. ** ca
12d60 6c 6c 20 74 6f 20 62 74 72 65 65 49 6e 69 74 50 ll to btreeInitP
12d70 61 67 65 28 29 20 77 69 6c 6c 20 6c 69 6b 65 6c age() will likel
12d80 79 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f y return SQLITE_
12d90 43 4f 52 52 55 50 54 2e 0a 20 20 20 20 20 20 2a CORRUPT.. *
12da0 2a 20 42 75 74 20 6e 6f 20 68 61 72 6d 20 69 73 * But no harm is
12db0 20 64 6f 6e 65 20 62 79 20 74 68 69 73 2e 20 20 done by this.
12dc0 41 6e 64 20 69 74 20 69 73 20 76 65 72 79 20 69 And it is very i
12dd0 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 0a 20 20 mportant that.
12de0 20 20 20 20 2a 2a 20 62 74 72 65 65 49 6e 69 74 ** btreeInit
12df0 50 61 67 65 28 29 20 62 65 20 63 61 6c 6c 65 64 Page() be called
12e00 20 6f 6e 20 65 76 65 72 79 20 62 74 72 65 65 20 on every btree
12e10 70 61 67 65 20 73 6f 20 77 65 20 6d 61 6b 65 0a page so we make.
12e20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 61 6c ** the cal
12e30 6c 20 66 6f 72 20 65 76 65 72 79 20 70 61 67 65 l for every page
12e40 20 74 68 61 74 20 63 6f 6d 65 73 20 69 6e 20 66 that comes in f
12e50 6f 72 20 72 65 2d 69 6e 69 74 69 6e 67 2e 20 2a or re-initing. *
12e60 2f 0a 20 20 20 20 20 20 62 74 72 65 65 49 6e 69 /. btreeIni
12e70 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 tPage(pPage);.
12e80 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a }. }.}../*.**
12e90 20 49 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 Invoke the busy
12ea0 20 68 61 6e 64 6c 65 72 20 66 6f 72 20 61 20 62 handler for a b
12eb0 74 72 65 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tree..*/.static
12ec0 69 6e 74 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 int btreeInvokeB
12ed0 75 73 79 48 61 6e 64 6c 65 72 28 76 6f 69 64 20 usyHandler(void
12ee0 2a 70 41 72 67 29 7b 0a 20 20 42 74 53 68 61 72 *pArg){. BtShar
12ef0 65 64 20 2a 70 42 74 20 3d 20 28 42 74 53 68 61 ed *pBt = (BtSha
12f00 72 65 64 2a 29 70 41 72 67 3b 0a 20 20 61 73 73 red*)pArg;. ass
12f10 65 72 74 28 20 70 42 74 2d 3e 64 62 20 29 3b 0a ert( pBt->db );.
12f20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
12f30 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
12f40 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
12f50 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 return sqlite3
12f60 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 InvokeBusyHandle
12f70 72 28 26 70 42 74 2d 3e 64 62 2d 3e 62 75 73 79 r(&pBt->db->busy
12f80 48 61 6e 64 6c 65 72 2c 0a 20 20 20 20 20 20 20 Handler,.
12f90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12fa0 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
12fb0 65 33 50 61 67 65 72 46 69 6c 65 28 70 42 74 2d e3PagerFile(pBt-
12fc0 3e 70 50 61 67 65 72 29 29 3b 0a 7d 0a 0a 2f 2a >pPager));.}../*
12fd0 0a 2a 2a 20 4f 70 65 6e 20 61 20 64 61 74 61 62 .** Open a datab
12fe0 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 0a 2a 2a ase file..** .**
12ff0 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 74 68 zFilename is th
13000 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 e name of the da
13010 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 66 tabase file. If
13020 20 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 4e 55 zFilename is NU
13030 4c 4c 0a 2a 2a 20 74 68 65 6e 20 61 6e 20 65 70 LL.** then an ep
13040 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 hemeral database
13050 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 is created. Th
13060 65 20 65 70 68 65 6d 65 72 61 6c 20 64 61 74 61 e ephemeral data
13070 62 61 73 65 20 6d 69 67 68 74 0a 2a 2a 20 62 65 base might.** be
13080 20 65 78 63 6c 75 73 69 76 65 6c 79 20 69 6e 20 exclusively in
13090 6d 65 6d 6f 72 79 2c 20 6f 72 20 69 74 20 6d 69 memory, or it mi
130a0 67 68 74 20 75 73 65 20 61 20 64 69 73 6b 2d 62 ght use a disk-b
130b0 61 73 65 64 20 6d 65 6d 6f 72 79 20 63 61 63 68 ased memory cach
130c0 65 2e 0a 2a 2a 20 45 69 74 68 65 72 20 77 61 79 e..** Either way
130d0 2c 20 74 68 65 20 65 70 68 65 6d 65 72 61 6c 20 , the ephemeral
130e0 64 61 74 61 62 61 73 65 20 77 69 6c 6c 20 62 65 database will be
130f0 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
13100 65 6c 65 74 65 64 20 0a 2a 2a 20 77 68 65 6e 20 eleted .** when
13110 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
13120 65 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a e() is called..*
13130 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d *.** If zFilenam
13140 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 e is ":memory:"
13150 74 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 then an in-memor
13160 79 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72 y database is cr
13170 65 61 74 65 64 0a 2a 2a 20 74 68 61 74 20 69 73 eated.** that is
13180 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
13190 65 73 74 72 6f 79 65 64 20 77 68 65 6e 20 69 74 estroyed when it
131a0 20 69 73 20 63 6c 6f 73 65 64 2e 0a 2a 2a 0a 2a is closed..**.*
131b0 2a 20 54 68 65 20 22 66 6c 61 67 73 22 20 70 61 * The "flags" pa
131c0 72 61 6d 65 74 65 72 20 69 73 20 61 20 62 69 74 rameter is a bit
131d0 6d 61 73 6b 20 74 68 61 74 20 6d 69 67 68 74 20 mask that might
131e0 63 6f 6e 74 61 69 6e 20 62 69 74 73 20 6c 69 6b contain bits lik
131f0 65 0a 2a 2a 20 42 54 52 45 45 5f 4f 4d 49 54 5f e.** BTREE_OMIT_
13200 4a 4f 55 52 4e 41 4c 20 61 6e 64 2f 6f 72 20 42 JOURNAL and/or B
13210 54 52 45 45 5f 4d 45 4d 4f 52 59 2e 0a 2a 2a 0a TREE_MEMORY..**.
13220 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
13230 73 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 se is already op
13240 65 6e 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 ened in the same
13250 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
13260 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 77 65 20 61 tion.** and we a
13270 72 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 re in shared cac
13280 68 65 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 68 he mode, then th
13290 65 20 6f 70 65 6e 20 77 69 6c 6c 20 66 61 69 6c e open will fail
132a0 20 77 69 74 68 20 61 6e 0a 2a 2a 20 53 51 4c 49 with an.** SQLI
132b0 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 65 72 TE_CONSTRAINT er
132c0 72 6f 72 2e 20 20 57 65 20 63 61 6e 6e 6f 74 20 ror. We cannot
132d0 61 6c 6c 6f 77 20 74 77 6f 20 6f 72 20 6d 6f 72 allow two or mor
132e0 65 20 42 74 53 68 61 72 65 64 0a 2a 2a 20 6f 62 e BtShared.** ob
132f0 6a 65 63 74 73 20 69 6e 20 74 68 65 20 73 61 6d jects in the sam
13300 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 e database conne
13310 63 74 69 6f 6e 20 73 69 6e 63 65 20 64 6f 69 6e ction since doin
13320 67 20 73 6f 20 77 69 6c 6c 20 6c 65 61 64 0a 2a g so will lead.*
13330 2a 20 74 6f 20 70 72 6f 62 6c 65 6d 73 20 77 69 * to problems wi
13340 74 68 20 6c 6f 63 6b 69 6e 67 2e 0a 2a 2f 0a 69 th locking..*/.i
13350 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f nt sqlite3BtreeO
13360 70 65 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 pen(. sqlite3_v
13370 66 73 20 2a 70 56 66 73 2c 20 20 20 20 20 20 2f fs *pVfs, /
13380 2a 20 56 46 53 20 74 6f 20 75 73 65 20 66 6f 72 * VFS to use for
13390 20 74 68 69 73 20 62 2d 74 72 65 65 20 2a 2f 0a this b-tree */.
133a0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 const char *zF
133b0 69 6c 65 6e 61 6d 65 2c 20 20 2f 2a 20 4e 61 6d ilename, /* Nam
133c0 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 6f e of the file co
133d0 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 42 54 72 ntaining the BTr
133e0 65 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ee database */.
133f0 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
13400 20 20 20 20 20 20 20 20 20 2f 2a 20 41 73 73 6f /* Asso
13410 63 69 61 74 65 64 20 64 61 74 61 62 61 73 65 20 ciated database
13420 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 72 65 handle */. Btre
13430 65 20 2a 2a 70 70 42 74 72 65 65 2c 20 20 20 20 e **ppBtree,
13440 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
13450 6f 20 6e 65 77 20 42 74 72 65 65 20 6f 62 6a 65 o new Btree obje
13460 63 74 20 77 72 69 74 74 65 6e 20 68 65 72 65 20 ct written here
13470 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 2c 20 */. int flags,
13480 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
13490 4f 70 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 Options */. int
134a0 20 76 66 73 46 6c 61 67 73 20 20 20 20 20 20 20 vfsFlags
134b0 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 /* Flags pa
134c0 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 6f 20 ssed through to
134d0 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
134e0 6e 28 29 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 n() */.){. BtSh
134f0 61 72 65 64 20 2a 70 42 74 20 3d 20 30 3b 20 20 ared *pBt = 0;
13500 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
13510 61 72 65 64 20 70 61 72 74 20 6f 66 20 62 74 72 ared part of btr
13520 65 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a ee structure */.
13530 20 20 42 74 72 65 65 20 2a 70 3b 20 20 20 20 20 Btree *p;
13540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13550 20 2f 2a 20 48 61 6e 64 6c 65 20 74 6f 20 72 65 /* Handle to re
13560 74 75 72 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 turn */. sqlite
13570 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 4f 70 3_mutex *mutexOp
13580 65 6e 20 3d 20 30 3b 20 20 2f 2a 20 50 72 65 76 en = 0; /* Prev
13590 65 6e 74 73 20 61 20 72 61 63 65 20 63 6f 6e 64 ents a race cond
135a0 69 74 69 6f 6e 2e 20 54 69 63 6b 65 74 20 23 33 ition. Ticket #3
135b0 35 33 37 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 537 */. int rc
135c0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
135d0 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c /* Resul
135e0 74 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 69 73 t code from this
135f0 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 function */. u
13600 38 20 6e 52 65 73 65 72 76 65 3b 20 20 20 20 20 8 nReserve;
13610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
13620 20 42 79 74 65 20 6f 66 20 75 6e 75 73 65 64 20 Byte of unused
13630 73 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 space on each pa
13640 67 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ge */. unsigned
13650 20 63 68 61 72 20 7a 44 62 48 65 61 64 65 72 5b char zDbHeader[
13660 31 30 30 5d 3b 20 20 2f 2a 20 44 61 74 61 62 61 100]; /* Databa
13670 73 65 20 68 65 61 64 65 72 20 63 6f 6e 74 65 6e se header conten
13680 74 20 2a 2f 0a 0a 20 20 2f 2a 20 54 72 75 65 20 t */.. /* True
13690 69 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 65 70 if opening an ep
136a0 68 65 6d 65 72 61 6c 2c 20 74 65 6d 70 6f 72 61 hemeral, tempora
136b0 72 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 ry database */.
136c0 20 63 6f 6e 73 74 20 69 6e 74 20 69 73 54 65 6d const int isTem
136d0 70 44 62 20 3d 20 7a 46 69 6c 65 6e 61 6d 65 3d pDb = zFilename=
136e0 3d 30 20 7c 7c 20 7a 46 69 6c 65 6e 61 6d 65 5b =0 || zFilename[
136f0 30 5d 3d 3d 30 3b 0a 0a 20 20 2f 2a 20 53 65 74 0]==0;.. /* Set
13700 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 69 73 the variable is
13710 4d 65 6d 64 62 20 74 6f 20 74 72 75 65 20 66 6f Memdb to true fo
13720 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 r an in-memory d
13730 61 74 61 62 61 73 65 2c 20 6f 72 20 0a 20 20 2a atabase, or . *
13740 2a 20 66 61 6c 73 65 20 66 6f 72 20 61 20 66 69 * false for a fi
13750 6c 65 2d 62 61 73 65 64 20 64 61 74 61 62 61 73 le-based databas
13760 65 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 e.. */.#ifdef S
13770 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
13780 59 44 42 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 YDB. const int
13790 69 73 4d 65 6d 64 62 20 3d 20 30 3b 0a 23 65 6c isMemdb = 0;.#el
137a0 73 65 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 69 se. const int i
137b0 73 4d 65 6d 64 62 20 3d 20 28 7a 46 69 6c 65 6e sMemdb = (zFilen
137c0 61 6d 65 20 26 26 20 73 74 72 63 6d 70 28 7a 46 ame && strcmp(zF
137d0 69 6c 65 6e 61 6d 65 2c 20 22 3a 6d 65 6d 6f 72 ilename, ":memor
137e0 79 3a 22 29 3d 3d 30 29 0a 20 20 20 20 20 20 20 y:")==0).
137f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13800 7c 7c 20 28 69 73 54 65 6d 70 44 62 20 26 26 20 || (isTempDb &&
13810 73 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d sqlite3TempInMem
13820 6f 72 79 28 64 62 29 29 0a 20 20 20 20 20 20 20 ory(db)).
13830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13840 7c 7c 20 28 76 66 73 46 6c 61 67 73 20 26 20 53 || (vfsFlags & S
13850 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 45 4d 4f 52 QLITE_OPEN_MEMOR
13860 59 29 21 3d 30 3b 0a 23 65 6e 64 69 66 0a 0a 20 Y)!=0;.#endif..
13870 20 61 73 73 65 72 74 28 20 64 62 21 3d 30 20 29 assert( db!=0 )
13880 3b 0a 20 20 61 73 73 65 72 74 28 20 70 56 66 73 ;. assert( pVfs
13890 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 !=0 );. assert(
138a0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
138b0 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 eld(db->mutex) )
138c0 3b 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c 61 ;. assert( (fla
138d0 67 73 26 30 78 66 66 29 3d 3d 66 6c 61 67 73 20 gs&0xff)==flags
138e0 29 3b 20 20 20 2f 2a 20 66 6c 61 67 73 20 66 69 ); /* flags fi
138f0 74 20 69 6e 20 38 20 62 69 74 73 20 2a 2f 0a 0a t in 8 bits */..
13900 20 20 2f 2a 20 4f 6e 6c 79 20 61 20 42 54 52 45 /* Only a BTRE
13910 45 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 E_SINGLE databas
13920 65 20 63 61 6e 20 62 65 20 42 54 52 45 45 5f 55 e can be BTREE_U
13930 4e 4f 52 44 45 52 45 44 20 2a 2f 0a 20 20 61 73 NORDERED */. as
13940 73 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 sert( (flags & B
13950 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 29 3d TREE_UNORDERED)=
13960 3d 30 20 7c 7c 20 28 66 6c 61 67 73 20 26 20 42 =0 || (flags & B
13970 54 52 45 45 5f 53 49 4e 47 4c 45 29 21 3d 30 20 TREE_SINGLE)!=0
13980 29 3b 0a 0a 20 20 2f 2a 20 41 20 42 54 52 45 45 );.. /* A BTREE
13990 5f 53 49 4e 47 4c 45 20 64 61 74 61 62 61 73 65 _SINGLE database
139a0 20 69 73 20 61 6c 77 61 79 73 20 61 20 74 65 6d is always a tem
139b0 70 6f 72 61 72 79 20 61 6e 64 2f 6f 72 20 65 70 porary and/or ep
139c0 68 65 6d 65 72 61 6c 20 2a 2f 0a 20 20 61 73 73 hemeral */. ass
139d0 65 72 74 28 20 28 66 6c 61 67 73 20 26 20 42 54 ert( (flags & BT
139e0 52 45 45 5f 53 49 4e 47 4c 45 29 3d 3d 30 20 7c REE_SINGLE)==0 |
139f0 7c 20 69 73 54 65 6d 70 44 62 20 29 3b 0a 0a 20 | isTempDb );..
13a00 20 69 66 28 20 69 73 4d 65 6d 64 62 20 29 7b 0a if( isMemdb ){.
13a10 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 42 54 52 flags |= BTR
13a20 45 45 5f 4d 45 4d 4f 52 59 3b 0a 20 20 7d 0a 20 EE_MEMORY;. }.
13a30 20 69 66 28 20 28 76 66 73 46 6c 61 67 73 20 26 if( (vfsFlags &
13a40 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 SQLITE_OPEN_MAI
13a50 4e 5f 44 42 29 21 3d 30 20 26 26 20 28 69 73 4d N_DB)!=0 && (isM
13a60 65 6d 64 62 20 7c 7c 20 69 73 54 65 6d 70 44 62 emdb || isTempDb
13a70 29 20 29 7b 0a 20 20 20 20 76 66 73 46 6c 61 67 ) ){. vfsFlag
13a80 73 20 3d 20 28 76 66 73 46 6c 61 67 73 20 26 20 s = (vfsFlags &
13a90 7e 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 ~SQLITE_OPEN_MAI
13aa0 4e 5f 44 42 29 20 7c 20 53 51 4c 49 54 45 5f 4f N_DB) | SQLITE_O
13ab0 50 45 4e 5f 54 45 4d 50 5f 44 42 3b 0a 20 20 7d PEN_TEMP_DB;. }
13ac0 0a 20 20 70 20 3d 20 73 71 6c 69 74 65 33 4d 61 . p = sqlite3Ma
13ad0 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f 66 28 llocZero(sizeof(
13ae0 42 74 72 65 65 29 29 3b 0a 20 20 69 66 28 20 21 Btree));. if( !
13af0 70 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 p ){. return
13b00 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
13b10 54 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 6e 54 72 T;. }. p->inTr
13b20 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 ans = TRANS_NONE
13b30 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62 3b 0a ;. p->db = db;.
13b40 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
13b50 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
13b60 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 . p->lock.pBtre
13b70 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c 6f 63 6b e = p;. p->lock
13b80 2e 69 54 61 62 6c 65 20 3d 20 31 3b 0a 23 65 6e .iTable = 1;.#en
13b90 64 69 66 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 dif..#if !define
13ba0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 d(SQLITE_OMIT_SH
13bb0 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 ARED_CACHE) && !
13bc0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
13bd0 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a MIT_DISKIO). /*
13be0 0a 20 20 2a 2a 20 49 66 20 74 68 69 73 20 42 74 . ** If this Bt
13bf0 72 65 65 20 69 73 20 61 20 63 61 6e 64 69 64 61 ree is a candida
13c00 74 65 20 66 6f 72 20 73 68 61 72 65 64 20 63 61 te for shared ca
13c10 63 68 65 2c 20 74 72 79 20 74 6f 20 66 69 6e 64 che, try to find
13c20 20 61 6e 0a 20 20 2a 2a 20 65 78 69 73 74 69 6e an. ** existin
13c30 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 g BtShared objec
13c40 74 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 68 t that we can sh
13c50 61 72 65 20 77 69 74 68 0a 20 20 2a 2f 0a 20 20 are with. */.
13c60 69 66 28 20 69 73 54 65 6d 70 44 62 3d 3d 30 20 if( isTempDb==0
13c70 26 26 20 28 69 73 4d 65 6d 64 62 3d 3d 30 20 7c && (isMemdb==0 |
13c80 7c 20 28 76 66 73 46 6c 61 67 73 26 53 51 4c 49 | (vfsFlags&SQLI
13c90 54 45 5f 4f 50 45 4e 5f 55 52 49 29 21 3d 30 29 TE_OPEN_URI)!=0)
13ca0 20 29 7b 0a 20 20 20 20 69 66 28 20 76 66 73 46 ){. if( vfsF
13cb0 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
13cc0 45 4e 5f 53 48 41 52 45 44 43 41 43 48 45 20 29 EN_SHAREDCACHE )
13cd0 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 46 69 6c {. int nFil
13ce0 65 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 ename = sqlite3S
13cf0 74 72 6c 65 6e 33 30 28 7a 46 69 6c 65 6e 61 6d trlen30(zFilenam
13d00 65 29 2b 31 3b 0a 20 20 20 20 20 20 69 6e 74 20 e)+1;. int
13d10 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 nFullPathname =
13d20 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 pVfs->mxPathname
13d30 2b 31 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a +1;. char *
13d40 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 zFullPathname =
13d50 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 4d 41 sqlite3Malloc(MA
13d60 58 28 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c X(nFullPathname,
13d70 6e 46 69 6c 65 6e 61 6d 65 29 29 3b 0a 20 20 20 nFilename));.
13d80 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
13d90 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
13da0 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 0a 20 utexShared; )..
13db0 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 p->sharable
13dc0 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 = 1;. if(
13dd0 21 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 !zFullPathname )
13de0 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
13df0 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 3_free(p);.
13e00 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
13e10 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
13e20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 69 }. if( i
13e30 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 20 20 sMemdb ){.
13e40 20 20 6d 65 6d 63 70 79 28 7a 46 75 6c 6c 50 61 memcpy(zFullPa
13e50 74 68 6e 61 6d 65 2c 20 7a 46 69 6c 65 6e 61 6d thname, zFilenam
13e60 65 2c 20 6e 46 69 6c 65 6e 61 6d 65 29 3b 0a 20 e, nFilename);.
13e70 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
13e80 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
13e90 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 OsFullPathname(p
13ea0 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a Vfs, zFilename,.
13eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13ed0 20 20 20 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 nFullPathname
13ee0 2c 20 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 , zFullPathname)
13ef0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
13f00 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
13f10 6c 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c lite3_free(zFull
13f20 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 Pathname);.
13f30 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
13f40 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 e(p);.
13f50 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
13f60 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 69 66 }. }.#if
13f70 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 SQLITE_THREADSA
13f80 46 45 0a 20 20 20 20 20 20 6d 75 74 65 78 4f 70 FE. mutexOp
13f90 65 6e 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 en = sqlite3Mute
13fa0 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
13fb0 54 45 58 5f 53 54 41 54 49 43 5f 4f 50 45 4e 29 TEX_STATIC_OPEN)
13fc0 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
13fd0 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
13fe0 78 4f 70 65 6e 29 3b 0a 20 20 20 20 20 20 6d 75 xOpen);. mu
13ff0 74 65 78 53 68 61 72 65 64 20 3d 20 73 71 6c 69 texShared = sqli
14000 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 te3MutexAlloc(SQ
14010 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
14020 43 5f 4d 41 53 54 45 52 29 3b 0a 20 20 20 20 20 C_MASTER);.
14030 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 sqlite3_mutex_e
14040 6e 74 65 72 28 6d 75 74 65 78 53 68 61 72 65 64 nter(mutexShared
14050 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 );.#endif.
14060 66 6f 72 28 70 42 74 3d 47 4c 4f 42 41 4c 28 42 for(pBt=GLOBAL(B
14070 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 tShared*,sqlite3
14080 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 SharedCacheList)
14090 3b 20 70 42 74 3b 20 70 42 74 3d 70 42 74 2d 3e ; pBt; pBt=pBt->
140a0 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 pNext){.
140b0 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e 52 65 assert( pBt->nRe
140c0 66 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 f>0 );. i
140d0 66 28 20 30 3d 3d 73 74 72 63 6d 70 28 7a 46 75 f( 0==strcmp(zFu
140e0 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 73 71 6c 69 llPathname, sqli
140f0 74 65 33 50 61 67 65 72 46 69 6c 65 6e 61 6d 65 te3PagerFilename
14100 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 30 29 (pBt->pPager, 0)
14110 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
14120 20 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 && sqlite3Pag
14130 65 72 56 66 73 28 70 42 74 2d 3e 70 50 61 67 65 erVfs(pBt->pPage
14140 72 29 3d 3d 70 56 66 73 20 29 7b 0a 20 20 20 20 r)==pVfs ){.
14150 20 20 20 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 int iDb;.
14160 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 44 62 for(iDb
14170 3d 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 44 62 3e =db->nDb-1; iDb>
14180 3d 30 3b 20 69 44 62 2d 2d 29 7b 0a 20 20 20 20 =0; iDb--){.
14190 20 20 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 Btree *p
141a0 45 78 69 73 74 69 6e 67 20 3d 20 64 62 2d 3e 61 Existing = db->a
141b0 44 62 5b 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 Db[iDb].pBt;.
141c0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 45 78 if( pEx
141d0 69 73 74 69 6e 67 20 26 26 20 70 45 78 69 73 74 isting && pExist
141e0 69 6e 67 2d 3e 70 42 74 3d 3d 70 42 74 20 29 7b ing->pBt==pBt ){
141f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
14200 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
14210 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b ve(mutexShared);
14220 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 . s
14230 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
14240 76 65 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 ve(mutexOpen);.
14250 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c sql
14260 69 74 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 ite3_free(zFullP
14270 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 athname);.
14280 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f sqlite3_
14290 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 20 free(p);.
142a0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
142b0 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3b LITE_CONSTRAINT;
142c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
142d0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
142e0 20 20 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 p->pBt = pB
142f0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 70 42 74 t;. pBt
14300 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 ->nRef++;.
14310 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
14320 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
14330 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
14340 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 61 72 _leave(mutexShar
14350 65 64 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ed);. sqlit
14360 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 e3_free(zFullPat
14370 68 6e 61 6d 65 29 3b 0a 20 20 20 20 7d 0a 23 69 hname);. }.#i
14380 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
14390 47 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 G. else{.
143a0 20 20 2f 2a 20 49 6e 20 64 65 62 75 67 20 6d 6f /* In debug mo
143b0 64 65 2c 20 77 65 20 6d 61 72 6b 20 61 6c 6c 20 de, we mark all
143c0 70 65 72 73 69 73 74 65 6e 74 20 64 61 74 61 62 persistent datab
143d0 61 73 65 73 20 61 73 20 73 68 61 72 61 62 6c 65 ases as sharable
143e0 0a 20 20 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 . ** even w
143f0 68 65 6e 20 74 68 65 79 20 61 72 65 20 6e 6f 74 hen they are not
14400 2e 20 20 54 68 69 73 20 65 78 65 72 63 69 73 65 . This exercise
14410 73 20 74 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f s the locking co
14420 64 65 20 61 6e 64 0a 20 20 20 20 20 20 2a 2a 20 de and. **
14430 67 69 76 65 73 20 6d 6f 72 65 20 6f 70 70 6f 72 gives more oppor
14440 74 75 6e 69 74 79 20 66 6f 72 20 61 73 73 65 72 tunity for asser
14450 74 73 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 ts(sqlite3_mutex
14460 5f 68 65 6c 64 28 29 29 0a 20 20 20 20 20 20 2a _held()). *
14470 2a 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 * statements to
14480 66 69 6e 64 20 6c 6f 63 6b 69 6e 67 20 70 72 6f find locking pro
14490 62 6c 65 6d 73 2e 0a 20 20 20 20 20 20 2a 2f 0a blems.. */.
144a0 20 20 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c p->sharabl
144b0 65 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e e = 1;. }.#en
144c0 64 69 66 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 dif. }.#endif.
144d0 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 if( pBt==0 ){.
144e0 20 20 20 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 /*. ** The
144f0 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 following asser
14500 74 73 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 ts make sure tha
14510 74 20 73 74 72 75 63 74 75 72 65 73 20 75 73 65 t structures use
14520 64 20 62 79 20 74 68 65 20 62 74 72 65 65 20 61 d by the btree a
14530 72 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 72 69 re. ** the ri
14540 67 68 74 20 73 69 7a 65 2e 20 20 54 68 69 73 20 ght size. This
14550 69 73 20 74 6f 20 67 75 61 72 64 20 61 67 61 69 is to guard agai
14560 6e 73 74 20 73 69 7a 65 20 63 68 61 6e 67 65 73 nst size changes
14570 20 74 68 61 74 20 72 65 73 75 6c 74 0a 20 20 20 that result.
14580 20 2a 2a 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 ** when compili
14590 6e 67 20 6f 6e 20 61 20 64 69 66 66 65 72 65 6e ng on a differen
145a0 74 20 61 72 63 68 69 74 65 63 74 75 72 65 2e 0a t architecture..
145b0 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 */. asser
145c0 74 28 20 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d t( sizeof(i64)==
145d0 38 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 8 );. assert(
145e0 20 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 sizeof(u64)==8
145f0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 );. assert( s
14600 69 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 3b izeof(u32)==4 );
14610 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a . assert( siz
14620 65 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a 20 eof(u16)==2 );.
14630 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f assert( sizeo
14640 66 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 20 f(Pgno)==4 );.
14650 0a 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 74 . pBt = sqlit
14660 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 69 e3MallocZero( si
14670 7a 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 20 zeof(*pBt) );.
14680 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b 0a if( pBt==0 ){.
14690 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
146a0 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
146b0 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f goto btree_o
146c0 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 pen_out;. }.
146d0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
146e0 61 67 65 72 4f 70 65 6e 28 70 56 66 73 2c 20 26 agerOpen(pVfs, &
146f0 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 7a 46 69 pBt->pPager, zFi
14700 6c 65 6e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 lename,.
14710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14720 20 20 73 69 7a 65 6f 66 28 4d 65 6d 50 61 67 65 sizeof(MemPage
14730 29 2c 20 66 6c 61 67 73 2c 20 76 66 73 46 6c 61 ), flags, vfsFla
14740 67 73 2c 20 70 61 67 65 52 65 69 6e 69 74 29 3b gs, pageReinit);
14750 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
14760 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
14770 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d sqlite3PagerSetM
14780 6d 61 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 mapLimit(pBt->pP
14790 61 67 65 72 2c 20 64 62 2d 3e 73 7a 4d 6d 61 70 ager, db->szMmap
147a0 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
147b0 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 46 69 lite3PagerReadFi
147c0 6c 65 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 leheader(pBt->pP
147d0 61 67 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 ager,sizeof(zDbH
147e0 65 61 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 eader),zDbHeader
147f0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
14800 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
14810 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 {. goto btr
14820 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
14830 20 7d 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e }. pBt->open
14840 46 6c 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 Flags = (u8)flag
14850 73 3b 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d s;. pBt->db =
14860 20 64 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 db;. sqlite3
14870 50 61 67 65 72 53 65 74 42 75 73 79 48 61 6e 64 PagerSetBusyHand
14880 6c 65 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ler(pBt->pPager,
14890 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
148a0 48 61 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 Handler, pBt);.
148b0 20 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b p->pBt = pBt;
148c0 0a 20 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 . . pBt->pCu
148d0 72 73 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 rsor = 0;. pB
148e0 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 t->pPage1 = 0;.
148f0 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 if( sqlite3Pa
14900 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 gerIsreadonly(pB
14910 74 2d 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 t->pPager) ) pBt
14920 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 ->btsFlags |= BT
14930 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 S_READ_ONLY;.#if
14940 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
14950 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 0a 20 SECURE_DELETE).
14960 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 pBt->btsFlags
14970 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 45 5f 44 |= BTS_SECURE_D
14980 45 4c 45 54 45 3b 0a 23 65 6c 69 66 20 64 65 66 ELETE;.#elif def
14990 69 6e 65 64 28 53 51 4c 49 54 45 5f 46 41 53 54 ined(SQLITE_FAST
149a0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 0a _SECURE_DELETE).
149b0 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
149c0 73 20 7c 3d 20 42 54 53 5f 4f 56 45 52 57 52 49 s |= BTS_OVERWRI
149d0 54 45 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 2f TE;.#endif. /
149e0 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
149f0 2d 35 31 38 37 33 2d 33 39 36 31 38 20 54 68 65 -51873-39618 The
14a00 20 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20 61 page size for a
14a10 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 database file i
14a20 73 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 6d 69 s. ** determi
14a30 6e 65 64 20 62 79 20 74 68 65 20 32 2d 62 79 74 ned by the 2-byt
14a40 65 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 74 65 e integer locate
14a50 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f d at an offset o
14a60 66 20 31 36 20 62 79 74 65 73 20 66 72 6f 6d 0a f 16 bytes from.
14a70 20 20 20 20 2a 2a 20 74 68 65 20 62 65 67 69 6e ** the begin
14a80 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 61 ning of the data
14a90 62 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 base file. */.
14aa0 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 pBt->pageSize
14ab0 3d 20 28 7a 44 62 48 65 61 64 65 72 5b 31 36 5d = (zDbHeader[16]
14ac0 3c 3c 38 29 20 7c 20 28 7a 44 62 48 65 61 64 65 <<8) | (zDbHeade
14ad0 72 5b 31 37 5d 3c 3c 31 36 29 3b 0a 20 20 20 20 r[17]<<16);.
14ae0 69 66 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a if( pBt->pageSiz
14af0 65 3c 35 31 32 20 7c 7c 20 70 42 74 2d 3e 70 61 e<512 || pBt->pa
14b00 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 geSize>SQLITE_MA
14b10 58 5f 50 41 47 45 5f 53 49 5a 45 0a 20 20 20 20 X_PAGE_SIZE.
14b20 20 20 20 20 20 7c 7c 20 28 28 70 42 74 2d 3e 70 || ((pBt->p
14b30 61 67 65 53 69 7a 65 2d 31 29 26 70 42 74 2d 3e ageSize-1)&pBt->
14b40 70 61 67 65 53 69 7a 65 29 21 3d 30 20 29 7b 0a pageSize)!=0 ){.
14b50 20 20 20 20 20 20 70 42 74 2d 3e 70 61 67 65 53 pBt->pageS
14b60 69 7a 65 20 3d 20 30 3b 0a 23 69 66 6e 64 65 66 ize = 0;.#ifndef
14b70 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
14b80 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a OVACUUM. /*
14b90 20 49 66 20 74 68 65 20 6d 61 67 69 63 20 6e 61 If the magic na
14ba0 6d 65 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 77 69 me ":memory:" wi
14bb0 6c 6c 20 63 72 65 61 74 65 20 61 6e 20 69 6e 2d ll create an in-
14bc0 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c memory database,
14bd0 20 74 68 65 6e 0a 20 20 20 20 20 20 2a 2a 20 6c then. ** l
14be0 65 61 76 65 20 74 68 65 20 61 75 74 6f 56 61 63 eave the autoVac
14bf0 75 75 6d 20 6d 6f 64 65 20 61 74 20 30 20 28 64 uum mode at 0 (d
14c00 6f 20 6e 6f 74 20 61 75 74 6f 2d 76 61 63 75 75 o not auto-vacuu
14c10 6d 29 2c 20 65 76 65 6e 20 69 66 0a 20 20 20 20 m), even if.
14c20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 44 45 46 41 ** SQLITE_DEFA
14c30 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 69 ULT_AUTOVACUUM i
14c40 73 20 74 72 75 65 2e 20 4f 6e 20 74 68 65 20 6f s true. On the o
14c50 74 68 65 72 20 68 61 6e 64 2c 20 69 66 0a 20 20 ther hand, if.
14c60 20 20 20 20 2a 2a 20 53 51 4c 49 54 45 5f 4f 4d ** SQLITE_OM
14c70 49 54 5f 4d 45 4d 4f 52 59 44 42 20 68 61 73 20 IT_MEMORYDB has
14c80 62 65 65 6e 20 64 65 66 69 6e 65 64 2c 20 74 68 been defined, th
14c90 65 6e 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 69 73 en ":memory:" is
14ca0 20 6a 75 73 74 20 61 0a 20 20 20 20 20 20 2a 2a just a. **
14cb0 20 72 65 67 75 6c 61 72 20 66 69 6c 65 2d 6e 61 regular file-na
14cc0 6d 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 me. In this case
14cd0 20 74 68 65 20 61 75 74 6f 2d 76 61 63 75 75 6d the auto-vacuum
14ce0 20 61 70 70 6c 69 65 73 20 61 73 20 70 65 72 20 applies as per
14cf0 6e 6f 72 6d 61 6c 2e 0a 20 20 20 20 20 20 2a 2f normal.. */
14d00 0a 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65 . if( zFile
14d10 6e 61 6d 65 20 26 26 20 21 69 73 4d 65 6d 64 62 name && !isMemdb
14d20 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ){. pBt-
14d30 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 53 >autoVacuum = (S
14d40 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 QLITE_DEFAULT_AU
14d50 54 4f 56 41 43 55 55 4d 20 3f 20 31 20 3a 20 30 TOVACUUM ? 1 : 0
14d60 29 3b 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e );. pBt->
14d70 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 53 51 incrVacuum = (SQ
14d80 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 LITE_DEFAULT_AUT
14d90 4f 56 41 43 55 55 4d 3d 3d 32 20 3f 20 31 20 3a OVACUUM==2 ? 1 :
14da0 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 0);. }.#en
14db0 64 69 66 0a 20 20 20 20 20 20 6e 52 65 73 65 72 dif. nReser
14dc0 76 65 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 ve = 0;. }els
14dd0 65 7b 0a 20 20 20 20 20 20 2f 2a 20 45 56 49 44 e{. /* EVID
14de0 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 ENCE-OF: R-37497
14df0 2d 34 32 34 31 32 20 54 68 65 20 73 69 7a 65 20 -42412 The size
14e00 6f 66 20 74 68 65 20 72 65 73 65 72 76 65 64 20 of the reserved
14e10 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 20 20 20 region is.
14e20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 ** determined by
14e30 20 74 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e the one-byte un
14e40 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 66 signed integer f
14e50 6f 75 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 65 ound at an offse
14e60 74 20 6f 66 20 32 30 0a 20 20 20 20 20 20 2a 2a t of 20. **
14e70 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 into the databa
14e80 73 65 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 se file header.
14e90 2a 2f 0a 20 20 20 20 20 20 6e 52 65 73 65 72 76 */. nReserv
14ea0 65 20 3d 20 7a 44 62 48 65 61 64 65 72 5b 32 30 e = zDbHeader[20
14eb0 5d 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ];. pBt->bt
14ec0 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 sFlags |= BTS_PA
14ed0 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 GESIZE_FIXED;.#i
14ee0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
14ef0 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 T_AUTOVACUUM.
14f00 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 pBt->autoVacu
14f10 75 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 um = (get4byte(&
14f20 7a 44 62 48 65 61 64 65 72 5b 33 36 20 2b 20 34 zDbHeader[36 + 4
14f30 2a 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 20 20 *4])?1:0);.
14f40 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
14f50 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 7a 44 = (get4byte(&zD
14f60 62 48 65 61 64 65 72 5b 33 36 20 2b 20 37 2a 34 bHeader[36 + 7*4
14f70 5d 29 3f 31 3a 30 29 3b 0a 23 65 6e 64 69 66 0a ])?1:0);.#endif.
14f80 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73 }. rc = s
14f90 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
14fa0 67 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 gesize(pBt->pPag
14fb0 65 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 er, &pBt->pageSi
14fc0 7a 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 ze, nReserve);.
14fd0 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
14fe0 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b btree_open_out;
14ff0 0a 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 . pBt->usable
15000 53 69 7a 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 Size = pBt->page
15010 53 69 7a 65 20 2d 20 6e 52 65 73 65 72 76 65 3b Size - nReserve;
15020 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 70 42 . assert( (pB
15030 74 2d 3e 70 61 67 65 53 69 7a 65 20 26 20 37 29 t->pageSize & 7)
15040 3d 3d 30 20 29 3b 20 20 2f 2a 20 38 2d 62 79 74 ==0 ); /* 8-byt
15050 65 20 61 6c 69 67 6e 6d 65 6e 74 20 6f 66 20 70 e alignment of p
15060 61 67 65 53 69 7a 65 20 2a 2f 0a 20 20 20 0a 23 ageSize */. .#
15070 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
15080 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
15090 41 43 48 45 29 20 26 26 20 21 64 65 66 69 6e 65 ACHE) && !define
150a0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 d(SQLITE_OMIT_DI
150b0 53 4b 49 4f 29 0a 20 20 20 20 2f 2a 20 41 64 64 SKIO). /* Add
150c0 20 74 68 65 20 6e 65 77 20 42 74 53 68 61 72 65 the new BtShare
150d0 64 20 6f 62 6a 65 63 74 20 74 6f 20 74 68 65 20 d object to the
150e0 6c 69 6e 6b 65 64 20 6c 69 73 74 20 73 68 61 72 linked list shar
150f0 61 62 6c 65 20 42 74 53 68 61 72 65 64 73 2e 0a able BtShareds..
15100 20 20 20 20 2a 2f 0a 20 20 20 20 70 42 74 2d 3e */. pBt->
15110 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20 69 66 nRef = 1;. if
15120 28 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b ( p->sharable ){
15130 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f 47 . MUTEX_LOG
15140 49 43 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 IC( sqlite3_mute
15150 78 20 2a 6d 75 74 65 78 53 68 61 72 65 64 3b 20 x *mutexShared;
15160 29 0a 20 20 20 20 20 20 4d 55 54 45 58 5f 4c 4f ). MUTEX_LO
15170 47 49 43 28 20 6d 75 74 65 78 53 68 61 72 65 64 GIC( mutexShared
15180 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 = sqlite3MutexA
15190 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
151a0 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 X_STATIC_MASTER)
151b0 3b 29 0a 20 20 20 20 20 20 69 66 28 20 53 51 4c ;). if( SQL
151c0 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 26 ITE_THREADSAFE &
151d0 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 & sqlite3GlobalC
151e0 6f 6e 66 69 67 2e 62 43 6f 72 65 4d 75 74 65 78 onfig.bCoreMutex
151f0 20 29 7b 0a 20 20 20 20 20 20 20 20 70 42 74 2d ){. pBt-
15200 3e 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 >mutex = sqlite3
15210 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
15220 45 5f 4d 55 54 45 58 5f 46 41 53 54 29 3b 0a 20 E_MUTEX_FAST);.
15230 20 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e if( pBt->
15240 6d 75 74 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 mutex==0 ){.
15250 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
15260 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
15270 20 20 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 goto btr
15280 65 65 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 ee_open_out;.
15290 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
152a0 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
152b0 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 53 68 ex_enter(mutexSh
152c0 61 72 65 64 29 3b 0a 20 20 20 20 20 20 70 42 74 ared);. pBt
152d0 2d 3e 70 4e 65 78 74 20 3d 20 47 4c 4f 42 41 4c ->pNext = GLOBAL
152e0 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
152f0 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15300 74 29 3b 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c t);. GLOBAL
15310 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
15320 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15330 74 29 20 3d 20 70 42 74 3b 0a 20 20 20 20 20 20 t) = pBt;.
15340 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
15350 61 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 ave(mutexShared)
15360 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
15370 20 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 }..#if !defined
15380 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 (SQLITE_OMIT_SHA
15390 52 45 44 5f 43 41 43 48 45 29 20 26 26 20 21 64 RED_CACHE) && !d
153a0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
153b0 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 2f 2a 20 IT_DISKIO). /*
153c0 49 66 20 74 68 65 20 6e 65 77 20 42 74 72 65 65 If the new Btree
153d0 20 75 73 65 73 20 61 20 73 68 61 72 61 62 6c 65 uses a sharable
153e0 20 70 42 74 53 68 61 72 65 64 2c 20 74 68 65 6e pBtShared, then
153f0 20 6c 69 6e 6b 20 74 68 65 20 6e 65 77 0a 20 20 link the new.
15400 2a 2a 20 42 74 72 65 65 20 69 6e 74 6f 20 74 68 ** Btree into th
15410 65 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 73 68 e list of all sh
15420 61 72 61 62 6c 65 20 42 74 72 65 65 73 20 66 6f arable Btrees fo
15430 72 20 74 68 65 20 73 61 6d 65 20 63 6f 6e 6e 65 r the same conne
15440 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 54 68 65 20 ction.. ** The
15450 6c 69 73 74 20 69 73 20 6b 65 70 74 20 69 6e 20 list is kept in
15460 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 ascending order
15470 62 79 20 70 42 74 20 61 64 64 72 65 73 73 2e 0a by pBt address..
15480 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 73 68 */. if( p->sh
15490 61 72 61 62 6c 65 20 29 7b 0a 20 20 20 20 69 6e arable ){. in
154a0 74 20 69 3b 0a 20 20 20 20 42 74 72 65 65 20 2a t i;. Btree *
154b0 70 53 69 62 3b 0a 20 20 20 20 66 6f 72 28 69 3d pSib;. for(i=
154c0 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 0; i<db->nDb; i+
154d0 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 28 70 +){. if( (p
154e0 53 69 62 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d Sib = db->aDb[i]
154f0 2e 70 42 74 29 21 3d 30 20 26 26 20 70 53 69 62 .pBt)!=0 && pSib
15500 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 ->sharable ){.
15510 20 20 20 20 20 20 77 68 69 6c 65 28 20 70 53 69 while( pSi
15520 62 2d 3e 70 50 72 65 76 20 29 7b 20 70 53 69 62 b->pPrev ){ pSib
15530 20 3d 20 70 53 69 62 2d 3e 70 50 72 65 76 3b 20 = pSib->pPrev;
15540 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 75 }. if( (u
15550 70 74 72 29 70 2d 3e 70 42 74 3c 28 75 70 74 72 ptr)p->pBt<(uptr
15560 29 70 53 69 62 2d 3e 70 42 74 20 29 7b 0a 20 20 )pSib->pBt ){.
15570 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
15580 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 = pSib;.
15590 20 20 20 70 2d 3e 70 50 72 65 76 20 3d 20 30 3b p->pPrev = 0;
155a0 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 2d . pSib-
155b0 3e 70 50 72 65 76 20 3d 20 70 3b 0a 20 20 20 20 >pPrev = p;.
155c0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
155d0 20 20 20 20 20 77 68 69 6c 65 28 20 70 53 69 62 while( pSib
155e0 2d 3e 70 4e 65 78 74 20 26 26 20 28 75 70 74 72 ->pNext && (uptr
155f0 29 70 53 69 62 2d 3e 70 4e 65 78 74 2d 3e 70 42 )pSib->pNext->pB
15600 74 3c 28 75 70 74 72 29 70 2d 3e 70 42 74 20 29 t<(uptr)p->pBt )
15610 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 53 {. pS
15620 69 62 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 ib = pSib->pNext
15630 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
15640 20 20 20 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 p->pNext
15650 20 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a = pSib->pNext;.
15660 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 50 72 p->pPr
15670 65 76 20 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 ev = pSib;.
15680 20 20 20 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 if( p->pNex
15690 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
156a0 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 p->pNext->pPrev
156b0 20 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 20 20 = p;.
156c0 7d 0a 20 20 20 20 20 20 20 20 20 20 70 53 69 62 }. pSib
156d0 2d 3e 70 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 ->pNext = p;.
156e0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 62 }. b
156f0 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
15700 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 }. }.#endif.
15710 20 2a 70 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a *ppBtree = p;..
15720 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a btree_open_out:.
15730 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
15740 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
15750 42 74 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 Bt && pBt->pPage
15760 72 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 r ){. sqlit
15770 65 33 50 61 67 65 72 43 6c 6f 73 65 28 70 42 74 e3PagerClose(pBt
15780 2d 3e 70 50 61 67 65 72 2c 20 30 29 3b 0a 20 20 ->pPager, 0);.
15790 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f }. sqlite3_
157a0 66 72 65 65 28 70 42 74 29 3b 0a 20 20 20 20 73 free(pBt);. s
157b0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 29 3b 0a qlite3_free(p);.
157c0 20 20 20 20 2a 70 70 42 74 72 65 65 20 3d 20 30 *ppBtree = 0
157d0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
157e0 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 46 69 qlite3_file *pFi
157f0 6c 65 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 le;.. /* If t
15800 68 65 20 42 2d 54 72 65 65 20 77 61 73 20 73 75 he B-Tree was su
15810 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 65 6e 65 ccessfully opene
15820 64 2c 20 73 65 74 20 74 68 65 20 70 61 67 65 72 d, set the pager
15830 2d 63 61 63 68 65 20 73 69 7a 65 20 74 6f 20 74 -cache size to t
15840 68 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c he. ** defaul
15850 74 20 76 61 6c 75 65 2e 20 45 78 63 65 70 74 2c t value. Except,
15860 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 6f 6e when opening on
15870 20 61 6e 20 65 78 69 73 74 69 6e 67 20 73 68 61 an existing sha
15880 72 65 64 20 70 61 67 65 72 2d 63 61 63 68 65 2c red pager-cache,
15890 0a 20 20 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 63 . ** do not c
158a0 68 61 6e 67 65 20 74 68 65 20 70 61 67 65 72 2d hange the pager-
158b0 63 61 63 68 65 20 73 69 7a 65 2e 0a 20 20 20 20 cache size..
158c0 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 */. if( sqlit
158d0 65 33 42 74 72 65 65 53 63 68 65 6d 61 28 70 2c e3BtreeSchema(p,
158e0 20 30 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 20 0, 0)==0 ){.
158f0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
15900 65 74 43 61 63 68 65 73 69 7a 65 28 70 2d 3e 70 etCachesize(p->p
15910 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 51 4c 49 Bt->pPager, SQLI
15920 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45 TE_DEFAULT_CACHE
15930 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 0a 20 _SIZE);. }..
15940 20 20 20 70 46 69 6c 65 20 3d 20 73 71 6c 69 74 pFile = sqlit
15950 65 33 50 61 67 65 72 46 69 6c 65 28 70 42 74 2d e3PagerFile(pBt-
15960 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 >pPager);. if
15970 28 20 70 46 69 6c 65 2d 3e 70 4d 65 74 68 6f 64 ( pFile->pMethod
15980 73 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 s ){. sqlit
15990 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 e3OsFileControlH
159a0 69 6e 74 28 70 46 69 6c 65 2c 20 53 51 4c 49 54 int(pFile, SQLIT
159b0 45 5f 46 43 4e 54 4c 5f 50 44 42 2c 20 28 76 6f E_FCNTL_PDB, (vo
159c0 69 64 2a 29 26 70 42 74 2d 3e 64 62 29 3b 0a 20 id*)&pBt->db);.
159d0 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6d }. }. if( m
159e0 75 74 65 78 4f 70 65 6e 20 29 7b 0a 20 20 20 20 utexOpen ){.
159f0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
15a00 6d 75 74 65 78 5f 68 65 6c 64 28 6d 75 74 65 78 mutex_held(mutex
15a10 4f 70 65 6e 29 20 29 3b 0a 20 20 20 20 73 71 6c Open) );. sql
15a20 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
15a30 28 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 7d (mutexOpen);. }
15a40 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 . assert( rc!=S
15a50 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 71 6c 69 QLITE_OK || sqli
15a60 74 65 33 42 74 72 65 65 43 6f 6e 6e 65 63 74 69 te3BtreeConnecti
15a70 6f 6e 43 6f 75 6e 74 28 2a 70 70 42 74 72 65 65 onCount(*ppBtree
15a80 29 3e 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 )>0 );. return
15a90 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 rc;.}../*.** Dec
15aa0 72 65 6d 65 6e 74 20 74 68 65 20 42 74 53 68 61 rement the BtSha
15ab0 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 red.nRef counter
15ac0 2e 20 20 57 68 65 6e 20 69 74 20 72 65 61 63 68 . When it reach
15ad0 65 73 20 7a 65 72 6f 2c 0a 2a 2a 20 72 65 6d 6f es zero,.** remo
15ae0 76 65 20 74 68 65 20 42 74 53 68 61 72 65 64 20 ve the BtShared
15af0 73 74 72 75 63 74 75 72 65 20 66 72 6f 6d 20 74 structure from t
15b00 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 2e he sharing list.
15b10 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 72 75 65 Return.** true
15b20 20 69 66 20 74 68 65 20 42 74 53 68 61 72 65 64 if the BtShared
15b30 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 20 72 65 .nRef counter re
15b40 61 63 68 65 73 20 7a 65 72 6f 20 61 6e 64 20 72 aches zero and r
15b50 65 74 75 72 6e 0a 2a 2a 20 66 61 6c 73 65 20 69 eturn.** false i
15b60 66 20 69 74 20 69 73 20 73 74 69 6c 6c 20 70 6f f it is still po
15b70 73 69 74 69 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 sitive..*/.stati
15b80 63 20 69 6e 74 20 72 65 6d 6f 76 65 46 72 6f 6d c int removeFrom
15b90 53 68 61 72 69 6e 67 4c 69 73 74 28 42 74 53 68 SharingList(BtSh
15ba0 61 72 65 64 20 2a 70 42 74 29 7b 0a 23 69 66 6e ared *pBt){.#ifn
15bb0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
15bc0 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 4d SHARED_CACHE. M
15bd0 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 UTEX_LOGIC( sqli
15be0 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d 61 73 74 te3_mutex *pMast
15bf0 65 72 3b 20 29 0a 20 20 42 74 53 68 61 72 65 64 er; ). BtShared
15c00 20 2a 70 4c 69 73 74 3b 0a 20 20 69 6e 74 20 72 *pList;. int r
15c10 65 6d 6f 76 65 64 20 3d 20 30 3b 0a 0a 20 20 61 emoved = 0;.. a
15c20 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
15c30 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 70 42 74 utex_notheld(pBt
15c40 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 4d 55 ->mutex) );. MU
15c50 54 45 58 5f 4c 4f 47 49 43 28 20 70 4d 61 73 74 TEX_LOGIC( pMast
15c60 65 72 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 er = sqlite3Mute
15c70 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 xAlloc(SQLITE_MU
15c80 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 TEX_STATIC_MASTE
15c90 52 29 3b 20 29 0a 20 20 73 71 6c 69 74 65 33 5f R); ). sqlite3_
15ca0 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 4d 61 73 mutex_enter(pMas
15cb0 74 65 72 29 3b 0a 20 20 70 42 74 2d 3e 6e 52 65 ter);. pBt->nRe
15cc0 66 2d 2d 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e f--;. if( pBt->
15cd0 6e 52 65 66 3c 3d 30 20 29 7b 0a 20 20 20 20 69 nRef<=0 ){. i
15ce0 66 28 20 47 4c 4f 42 41 4c 28 42 74 53 68 61 72 f( GLOBAL(BtShar
15cf0 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 72 65 ed*,sqlite3Share
15d00 64 43 61 63 68 65 4c 69 73 74 29 3d 3d 70 42 74 dCacheList)==pBt
15d10 20 29 7b 0a 20 20 20 20 20 20 47 4c 4f 42 41 4c ){. GLOBAL
15d20 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
15d30 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15d40 74 29 20 3d 20 70 42 74 2d 3e 70 4e 65 78 74 3b t) = pBt->pNext;
15d50 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
15d60 20 20 70 4c 69 73 74 20 3d 20 47 4c 4f 42 41 4c pList = GLOBAL
15d70 28 42 74 53 68 61 72 65 64 2a 2c 73 71 6c 69 74 (BtShared*,sqlit
15d80 65 33 53 68 61 72 65 64 43 61 63 68 65 4c 69 73 e3SharedCacheLis
15d90 74 29 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 t);. while(
15da0 20 41 4c 57 41 59 53 28 70 4c 69 73 74 29 20 26 ALWAYS(pList) &
15db0 26 20 70 4c 69 73 74 2d 3e 70 4e 65 78 74 21 3d & pList->pNext!=
15dc0 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 pBt ){. p
15dd0 4c 69 73 74 3d 70 4c 69 73 74 2d 3e 70 4e 65 78 List=pList->pNex
15de0 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 t;. }.
15df0 20 69 66 28 20 41 4c 57 41 59 53 28 70 4c 69 73 if( ALWAYS(pLis
15e00 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4c t) ){. pL
15e10 69 73 74 2d 3e 70 4e 65 78 74 20 3d 20 70 42 74 ist->pNext = pBt
15e20 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d ->pNext;. }
15e30 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 53 . }. if( S
15e40 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
15e50 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
15e60 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 70 42 74 3_mutex_free(pBt
15e70 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d 0a ->mutex);. }.
15e80 20 20 20 20 72 65 6d 6f 76 65 64 20 3d 20 31 3b removed = 1;
15e90 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
15ea0 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 61 73 74 utex_leave(pMast
15eb0 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 65 er);. return re
15ec0 6d 6f 76 65 64 3b 0a 23 65 6c 73 65 0a 20 20 72 moved;.#else. r
15ed0 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 69 66 0a eturn 1;.#endif.
15ee0 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 }../*.** Make su
15ef0 72 65 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 re pBt->pTmpSpac
15f00 65 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 e points to an a
15f10 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 0a 2a 2a llocation of .**
15f20 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 42 MX_CELL_SIZE(pB
15f30 74 29 20 62 79 74 65 73 20 77 69 74 68 20 61 20 t) bytes with a
15f40 34 2d 62 79 74 65 20 70 72 65 66 69 78 20 66 6f 4-byte prefix fo
15f50 72 20 61 20 6c 65 66 74 2d 63 68 69 6c 64 0a 2a r a left-child.*
15f60 2a 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 * pointer..*/.st
15f70 61 74 69 63 20 76 6f 69 64 20 61 6c 6c 6f 63 61 atic void alloca
15f80 74 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 68 teTempSpace(BtSh
15f90 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 69 66 ared *pBt){. if
15fa0 28 20 21 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 ( !pBt->pTmpSpac
15fb0 65 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e 70 54 e ){. pBt->pT
15fc0 6d 70 53 70 61 63 65 20 3d 20 73 71 6c 69 74 65 mpSpace = sqlite
15fd0 33 50 61 67 65 4d 61 6c 6c 6f 63 28 20 70 42 74 3PageMalloc( pBt
15fe0 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 0a 20 ->pageSize );..
15ff0 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
16000 20 75 73 65 73 20 6f 66 20 70 42 74 2d 3e 70 54 uses of pBt->pT
16010 6d 70 53 70 61 63 65 20 69 73 20 74 6f 20 66 6f mpSpace is to fo
16020 72 6d 61 74 20 63 65 6c 6c 73 20 62 65 66 6f 72 rmat cells befor
16030 65 0a 20 20 20 20 2a 2a 20 69 6e 73 65 72 74 69 e. ** inserti
16040 6e 67 20 74 68 65 6d 20 69 6e 74 6f 20 61 20 6c ng them into a l
16050 65 61 66 20 70 61 67 65 20 28 66 75 6e 63 74 69 eaf page (functi
16060 6f 6e 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 29 on fillInCell())
16070 2e 20 49 66 0a 20 20 20 20 2a 2a 20 61 20 63 65 . If. ** a ce
16080 6c 6c 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 ll is less than
16090 34 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 4 bytes in size,
160a0 20 69 74 20 69 73 20 72 6f 75 6e 64 65 64 20 75 it is rounded u
160b0 70 20 74 6f 20 34 20 62 79 74 65 73 0a 20 20 20 p to 4 bytes.
160c0 20 2a 2a 20 62 79 20 74 68 65 20 76 61 72 69 6f ** by the vario
160d0 75 73 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 us routines that
160e0 20 6d 61 6e 69 70 75 6c 61 74 65 20 62 69 6e 61 manipulate bina
160f0 72 79 20 63 65 6c 6c 73 2e 20 57 68 69 63 68 0a ry cells. Which.
16100 20 20 20 20 2a 2a 20 63 61 6e 20 6d 65 61 6e 20 ** can mean
16110 74 68 61 74 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 that fillInCell(
16120 29 20 6f 6e 6c 79 20 69 6e 69 74 69 61 6c 69 7a ) only initializ
16130 65 73 20 74 68 65 20 66 69 72 73 74 20 32 20 6f es the first 2 o
16140 72 20 33 0a 20 20 20 20 2a 2a 20 62 79 74 65 73 r 3. ** bytes
16150 20 6f 66 20 70 54 6d 70 53 70 61 63 65 2c 20 62 of pTmpSpace, b
16160 75 74 20 74 68 61 74 20 74 68 65 20 66 69 72 73 ut that the firs
16170 74 20 34 20 62 79 74 65 73 20 61 72 65 20 63 6f t 4 bytes are co
16180 70 69 65 64 20 66 72 6f 6d 0a 20 20 20 20 2a 2a pied from. **
16190 20 69 74 20 69 6e 74 6f 20 61 20 64 61 74 61 62 it into a datab
161a0 61 73 65 20 70 61 67 65 2e 20 54 68 69 73 20 69 ase page. This i
161b0 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 61 s not actually a
161c0 20 70 72 6f 62 6c 65 6d 2c 20 62 75 74 20 69 74 problem, but it
161d0 0a 20 20 20 20 2a 2a 20 64 6f 65 73 20 63 61 75 . ** does cau
161e0 73 65 20 61 20 76 61 6c 67 72 69 6e 64 20 65 72 se a valgrind er
161f0 72 6f 72 20 77 68 65 6e 20 74 68 65 20 31 20 6f ror when the 1 o
16200 72 20 32 20 62 79 74 65 73 20 6f 66 20 75 6e 69 r 2 bytes of uni
16210 74 69 61 6c 69 7a 65 64 20 0a 20 20 20 20 2a 2a tialized . **
16220 20 64 61 74 61 20 69 73 20 70 61 73 73 65 64 20 data is passed
16230 74 6f 20 73 79 73 74 65 6d 20 63 61 6c 6c 20 77 to system call w
16240 72 69 74 65 28 29 2e 20 53 6f 20 74 6f 20 61 76 rite(). So to av
16250 6f 69 64 20 74 68 69 73 20 65 72 72 6f 72 2c 0a oid this error,.
16260 20 20 20 20 2a 2a 20 7a 65 72 6f 20 74 68 65 20 ** zero the
16270 66 69 72 73 74 20 34 20 62 79 74 65 73 20 6f 66 first 4 bytes of
16280 20 74 65 6d 70 20 73 70 61 63 65 20 68 65 72 65 temp space here
16290 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
162a0 41 6c 73 6f 3a 20 20 50 72 6f 76 69 64 65 20 66 Also: Provide f
162b0 6f 75 72 20 62 79 74 65 73 20 6f 66 20 69 6e 69 our bytes of ini
162c0 74 69 61 6c 69 7a 65 64 20 73 70 61 63 65 20 62 tialized space b
162d0 65 66 6f 72 65 20 74 68 65 0a 20 20 20 20 2a 2a efore the. **
162e0 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 70 54 beginning of pT
162f0 6d 70 53 70 61 63 65 20 61 73 20 61 6e 20 61 72 mpSpace as an ar
16300 65 61 20 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 ea available to
16310 70 72 65 70 65 6e 64 20 74 68 65 0a 20 20 20 20 prepend the.
16320 2a 2a 20 6c 65 66 74 2d 63 68 69 6c 64 20 70 6f ** left-child po
16330 69 6e 74 65 72 20 74 6f 20 74 68 65 20 62 65 67 inter to the beg
16340 69 6e 6e 69 6e 67 20 6f 66 20 61 20 63 65 6c 6c inning of a cell
16350 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
16360 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
16370 29 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 ){. memset(
16380 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 2c 20 pBt->pTmpSpace,
16390 30 2c 20 38 29 3b 0a 20 20 20 20 20 20 70 42 74 0, 8);. pBt
163a0 2d 3e 70 54 6d 70 53 70 61 63 65 20 2b 3d 20 34 ->pTmpSpace += 4
163b0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
163c0 2a 0a 2a 2a 20 46 72 65 65 20 74 68 65 20 70 42 *.** Free the pB
163d0 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 61 6c 6c t->pTmpSpace all
163e0 6f 63 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 ocation.*/.stati
163f0 63 20 76 6f 69 64 20 66 72 65 65 54 65 6d 70 53 c void freeTempS
16400 70 61 63 65 28 42 74 53 68 61 72 65 64 20 2a 70 pace(BtShared *p
16410 42 74 29 7b 0a 20 20 69 66 28 20 70 42 74 2d 3e Bt){. if( pBt->
16420 70 54 6d 70 53 70 61 63 65 20 29 7b 0a 20 20 20 pTmpSpace ){.
16430 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 pBt->pTmpSpace
16440 2d 3d 20 34 3b 0a 20 20 20 20 73 71 6c 69 74 65 -= 4;. sqlite
16450 33 50 61 67 65 46 72 65 65 28 70 42 74 2d 3e 70 3PageFree(pBt->p
16460 54 6d 70 53 70 61 63 65 29 3b 0a 20 20 20 20 70 TmpSpace);. p
16470 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 Bt->pTmpSpace =
16480 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 0;. }.}../*.**
16490 43 6c 6f 73 65 20 61 6e 20 6f 70 65 6e 20 64 61 Close an open da
164a0 74 61 62 61 73 65 20 61 6e 64 20 69 6e 76 61 6c tabase and inval
164b0 69 64 61 74 65 20 61 6c 6c 20 63 75 72 73 6f 72 idate all cursor
164c0 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
164d0 33 42 74 72 65 65 43 6c 6f 73 65 28 42 74 72 65 3BtreeClose(Btre
164e0 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
164f0 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
16500 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
16510 72 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 r;.. /* Close a
16520 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 ll cursors opene
16530 64 20 76 69 61 20 74 68 69 73 20 68 61 6e 64 6c d via this handl
16540 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 e. */. assert(
16550 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
16560 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
16570 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ) );. sqlite3Bt
16580 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
16590 43 75 72 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 Cur = pBt->pCurs
165a0 6f 72 3b 0a 20 20 77 68 69 6c 65 28 20 70 43 75 or;. while( pCu
165b0 72 20 29 7b 0a 20 20 20 20 42 74 43 75 72 73 6f r ){. BtCurso
165c0 72 20 2a 70 54 6d 70 20 3d 20 70 43 75 72 3b 0a r *pTmp = pCur;.
165d0 20 20 20 20 70 43 75 72 20 3d 20 70 43 75 72 2d pCur = pCur-
165e0 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 66 28 20 >pNext;. if(
165f0 70 54 6d 70 2d 3e 70 42 74 72 65 65 3d 3d 70 20 pTmp->pBtree==p
16600 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
16610 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 BtreeCloseCursor
16620 28 70 54 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20 (pTmp);. }.
16630 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b }.. /* Rollback
16640 20 61 6e 79 20 61 63 74 69 76 65 20 74 72 61 6e any active tran
16650 73 61 63 74 69 6f 6e 20 61 6e 64 20 66 72 65 65 saction and free
16660 20 74 68 65 20 68 61 6e 64 6c 65 20 73 74 72 75 the handle stru
16670 63 74 75 72 65 2e 0a 20 20 2a 2a 20 54 68 65 20 cture.. ** The
16680 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 call to sqlite3B
16690 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 20 64 treeRollback() d
166a0 72 6f 70 73 20 61 6e 79 20 74 61 62 6c 65 2d 6c rops any table-l
166b0 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a 20 20 2a ocks held by. *
166c0 2a 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 0a 20 * this handle..
166d0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 */. sqlite3Btr
166e0 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c 20 53 51 eeRollback(p, SQ
166f0 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 73 LITE_OK, 0);. s
16700 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
16710 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 (p);.. /* If th
16720 65 72 65 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 ere are still ot
16730 68 65 72 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 her outstanding
16740 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 references to th
16750 65 20 73 68 61 72 65 64 2d 62 74 72 65 65 0a 20 e shared-btree.
16760 20 2a 2a 20 73 74 72 75 63 74 75 72 65 2c 20 72 ** structure, r
16770 65 74 75 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 eturn now. The r
16780 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 69 73 emainder of this
16790 20 70 72 6f 63 65 64 75 72 65 20 63 6c 65 61 6e procedure clean
167a0 73 20 0a 20 20 2a 2a 20 75 70 20 74 68 65 20 73 s . ** up the s
167b0 68 61 72 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a hared-btree.. *
167c0 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 /. assert( p->w
167d0 61 6e 74 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 antToLock==0 &&
167e0 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a p->locked==0 );.
167f0 20 20 69 66 28 20 21 70 2d 3e 73 68 61 72 61 62 if( !p->sharab
16800 6c 65 20 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d le || removeFrom
16810 53 68 61 72 69 6e 67 4c 69 73 74 28 70 42 74 29 SharingList(pBt)
16820 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 ){. /* The p
16830 42 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 Bt is no longer
16840 6f 6e 20 74 68 65 20 73 68 61 72 69 6e 67 20 6c on the sharing l
16850 69 73 74 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 ist, so we can a
16860 63 63 65 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 ccess. ** it
16870 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 without having t
16880 6f 20 68 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 o hold the mutex
16890 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
168a0 43 6c 65 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 Clean out and de
168b0 6c 65 74 65 20 74 68 65 20 42 74 53 68 61 72 65 lete the BtShare
168c0 64 20 6f 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f d object.. */
168d0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 70 42 . assert( !pB
168e0 74 2d 3e 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 t->pCursor );.
168f0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c sqlite3PagerCl
16900 6f 73 65 28 70 42 74 2d 3e 70 50 61 67 65 72 2c ose(pBt->pPager,
16910 20 70 2d 3e 64 62 29 3b 0a 20 20 20 20 69 66 28 p->db);. if(
16920 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 6d pBt->xFreeSchem
16930 61 20 26 26 20 70 42 74 2d 3e 70 53 63 68 65 6d a && pBt->pSchem
16940 61 20 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e a ){. pBt->
16950 78 46 72 65 65 53 63 68 65 6d 61 28 70 42 74 2d xFreeSchema(pBt-
16960 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 7d >pSchema);. }
16970 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 . sqlite3DbFr
16980 65 65 28 30 2c 20 70 42 74 2d 3e 70 53 63 68 65 ee(0, pBt->pSche
16990 6d 61 29 3b 0a 20 20 20 20 66 72 65 65 54 65 6d ma);. freeTem
169a0 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 pSpace(pBt);.
169b0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 42 sqlite3_free(pB
169c0 74 29 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 t);. }..#ifndef
169d0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
169e0 52 45 44 5f 43 41 43 48 45 0a 20 20 61 73 73 65 RED_CACHE. asse
169f0 72 74 28 20 70 2d 3e 77 61 6e 74 54 6f 4c 6f 63 rt( p->wantToLoc
16a00 6b 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 k==0 );. assert
16a10 28 20 70 2d 3e 6c 6f 63 6b 65 64 3d 3d 30 20 29 ( p->locked==0 )
16a20 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 ;. if( p->pPrev
16a30 20 29 20 70 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 ) p->pPrev->pNe
16a40 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 xt = p->pNext;.
16a50 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 20 if( p->pNext )
16a60 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 p->pNext->pPrev
16a70 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 23 65 6e 64 = p->pPrev;.#end
16a80 69 66 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 if.. sqlite3_fr
16a90 65 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ee(p);. return
16aa0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
16ab0 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 22 .** Change the "
16ac0 73 6f 66 74 22 20 6c 69 6d 69 74 20 6f 6e 20 74 soft" limit on t
16ad0 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 he number of pag
16ae0 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 2e es in the cache.
16af0 0a 2a 2a 20 55 6e 75 73 65 64 20 61 6e 64 20 75 .** Unused and u
16b00 6e 6d 6f 64 69 66 69 65 64 20 70 61 67 65 73 20 nmodified pages
16b10 77 69 6c 6c 20 62 65 20 72 65 63 79 63 6c 65 64 will be recycled
16b20 20 77 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 when the number
16b30 20 6f 66 0a 2a 2a 20 70 61 67 65 73 20 69 6e 20 of.** pages in
16b40 74 68 65 20 63 61 63 68 65 20 65 78 63 65 65 64 the cache exceed
16b50 73 20 74 68 69 73 20 73 6f 66 74 20 6c 69 6d 69 s this soft limi
16b60 74 2e 20 20 42 75 74 20 74 68 65 20 73 69 7a 65 t. But the size
16b70 20 6f 66 20 74 68 65 0a 2a 2a 20 63 61 63 68 65 of the.** cache
16b80 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f 20 67 is allowed to g
16b90 72 6f 77 20 6c 61 72 67 65 72 20 74 68 61 6e 20 row larger than
16ba0 74 68 69 73 20 6c 69 6d 69 74 20 69 66 20 69 74 this limit if it
16bb0 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20 64 69 72 contains.** dir
16bc0 74 79 20 70 61 67 65 73 20 6f 72 20 70 61 67 65 ty pages or page
16bd0 73 20 73 74 69 6c 6c 20 69 6e 20 61 63 74 69 76 s still in activ
16be0 65 20 75 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 e use..*/.int sq
16bf0 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63 lite3BtreeSetCac
16c00 68 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c heSize(Btree *p,
16c10 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 int mxPage){.
16c20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
16c30 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 p->pBt;. assert
16c40 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
16c50 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 held(p->db->mute
16c60 78 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 x) );. sqlite3B
16c70 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
16c80 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 sqlite3PagerSetC
16c90 61 63 68 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 achesize(pBt->pP
16ca0 61 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 ager, mxPage);.
16cb0 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
16cc0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
16cd0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
16ce0 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 22 .** Change the "
16cf0 73 70 69 6c 6c 22 20 6c 69 6d 69 74 20 6f 6e 20 spill" limit on
16d00 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 the number of pa
16d10 67 65 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 ges in the cache
16d20 2e 0a 2a 2a 20 49 66 20 74 68 65 20 6e 75 6d 62 ..** If the numb
16d30 65 72 20 6f 66 20 70 61 67 65 73 20 65 78 63 65 er of pages exce
16d40 65 64 73 20 74 68 69 73 20 6c 69 6d 69 74 20 64 eds this limit d
16d50 75 72 69 6e 67 20 61 20 77 72 69 74 65 20 74 72 uring a write tr
16d60 61 6e 73 61 63 74 69 6f 6e 2c 0a 2a 2a 20 74 68 ansaction,.** th
16d70 65 20 70 61 67 65 72 20 6d 69 67 68 74 20 61 74 e pager might at
16d80 74 65 6d 70 74 20 74 6f 20 22 73 70 69 6c 6c 22 tempt to "spill"
16d90 20 70 61 67 65 73 20 74 6f 20 74 68 65 20 6a 6f pages to the jo
16da0 75 72 6e 61 6c 20 65 61 72 6c 79 20 69 6e 0a 2a urnal early in.*
16db0 2a 20 6f 72 64 65 72 20 74 6f 20 66 72 65 65 20 * order to free
16dc0 75 70 20 6d 65 6d 6f 72 79 2e 0a 2a 2a 0a 2a 2a up memory..**.**
16dd0 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 The value retur
16de0 6e 65 64 20 69 73 20 74 68 65 20 63 75 72 72 65 ned is the curre
16df0 6e 74 20 73 70 69 6c 6c 20 73 69 7a 65 2e 20 20 nt spill size.
16e00 49 66 20 7a 65 72 6f 20 69 73 20 70 61 73 73 65 If zero is passe
16e10 64 0a 2a 2a 20 61 73 20 61 6e 20 61 72 67 75 6d d.** as an argum
16e20 65 6e 74 2c 20 6e 6f 20 63 68 61 6e 67 65 73 20 ent, no changes
16e30 61 72 65 20 6d 61 64 65 20 74 6f 20 74 68 65 20 are made to the
16e40 73 70 69 6c 6c 20 73 69 7a 65 20 73 65 74 74 69 spill size setti
16e50 6e 67 2c 20 73 6f 0a 2a 2a 20 75 73 69 6e 67 20 ng, so.** using
16e60 6d 78 50 61 67 65 20 6f 66 20 30 20 69 73 20 61 mxPage of 0 is a
16e70 20 77 61 79 20 74 6f 20 71 75 65 72 79 20 74 68 way to query th
16e80 65 20 63 75 72 72 65 6e 74 20 73 70 69 6c 6c 20 e current spill
16e90 73 69 7a 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c size..*/.int sql
16ea0 69 74 65 33 42 74 72 65 65 53 65 74 53 70 69 6c ite3BtreeSetSpil
16eb0 6c 53 69 7a 65 28 42 74 72 65 65 20 2a 70 2c 20 lSize(Btree *p,
16ec0 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 42 int mxPage){. B
16ed0 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
16ee0 2d 3e 70 42 74 3b 0a 20 20 69 6e 74 20 72 65 73 ->pBt;. int res
16ef0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
16f00 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
16f10 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a ->db->mutex) );.
16f20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
16f30 74 65 72 28 70 29 3b 0a 20 20 72 65 73 20 3d 20 ter(p);. res =
16f40 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 53 sqlite3PagerSetS
16f50 70 69 6c 6c 73 69 7a 65 28 70 42 74 2d 3e 70 50 pillsize(pBt->pP
16f60 61 67 65 72 2c 20 6d 78 50 61 67 65 29 3b 0a 20 ager, mxPage);.
16f70 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
16f80 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
16f90 72 65 73 3b 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 res;.}..#if SQLI
16fa0 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
16fb0 3e 30 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 >0./*.** Change
16fc0 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 68 65 the limit on the
16fd0 20 61 6d 6f 75 6e 74 20 6f 66 20 74 68 65 20 64 amount of the d
16fe0 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 68 61 atabase file tha
16ff0 74 20 6d 61 79 20 62 65 0a 2a 2a 20 6d 65 6d 6f t may be.** memo
17000 72 79 20 6d 61 70 70 65 64 2e 0a 2a 2f 0a 69 6e ry mapped..*/.in
17010 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
17020 74 4d 6d 61 70 4c 69 6d 69 74 28 42 74 72 65 65 tMmapLimit(Btree
17030 20 2a 70 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74 *p, sqlite3_int
17040 36 34 20 73 7a 4d 6d 61 70 29 7b 0a 20 20 42 74 64 szMmap){. Bt
17050 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
17060 3e 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 >pBt;. assert(
17070 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
17080 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 ld(p->db->mutex)
17090 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 );. sqlite3Btr
170a0 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 eeEnter(p);. sq
170b0 6c 69 74 65 33 50 61 67 65 72 53 65 74 4d 6d 61 lite3PagerSetMma
170c0 70 4c 69 6d 69 74 28 70 42 74 2d 3e 70 50 61 67 pLimit(pBt->pPag
170d0 65 72 2c 20 73 7a 4d 6d 61 70 29 3b 0a 20 20 73 er, szMmap);. s
170e0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
170f0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 (p);. return SQ
17100 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 LITE_OK;.}.#endi
17110 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4d 41 58 5f f /* SQLITE_MAX_
17120 4d 4d 41 50 5f 53 49 5a 45 3e 30 20 2a 2f 0a 0a MMAP_SIZE>0 */..
17130 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 /*.** Change the
17140 20 77 61 79 20 64 61 74 61 20 69 73 20 73 79 6e way data is syn
17150 63 65 64 20 74 6f 20 64 69 73 6b 20 69 6e 20 6f ced to disk in o
17160 72 64 65 72 20 74 6f 20 69 6e 63 72 65 61 73 65 rder to increase
17170 20 6f 72 20 64 65 63 72 65 61 73 65 0a 2a 2a 20 or decrease.**
17180 68 6f 77 20 77 65 6c 6c 20 74 68 65 20 64 61 74 how well the dat
17190 61 62 61 73 65 20 72 65 73 69 73 74 73 20 64 61 abase resists da
171a0 6d 61 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 mage due to OS c
171b0 72 61 73 68 65 73 20 61 6e 64 20 70 6f 77 65 72 rashes and power
171c0 0a 2a 2a 20 66 61 69 6c 75 72 65 73 2e 20 20 4c .** failures. L
171d0 65 76 65 6c 20 31 20 69 73 20 74 68 65 20 73 61 evel 1 is the sa
171e0 6d 65 20 61 73 20 61 73 79 6e 63 68 72 6f 6e 6f me as asynchrono
171f0 75 73 20 28 6e 6f 20 73 79 6e 63 73 28 29 20 6f us (no syncs() o
17200 63 63 75 72 20 61 6e 64 0a 2a 2a 20 74 68 65 72 ccur and.** ther
17210 65 20 69 73 20 61 20 68 69 67 68 20 70 72 6f 62 e is a high prob
17220 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d 61 67 ability of damag
17230 65 29 20 20 4c 65 76 65 6c 20 32 20 69 73 20 74 e) Level 2 is t
17240 68 65 20 64 65 66 61 75 6c 74 2e 20 20 54 68 65 he default. The
17250 72 65 0a 2a 2a 20 69 73 20 61 20 76 65 72 79 20 re.** is a very
17260 6c 6f 77 20 62 75 74 20 6e 6f 6e 2d 7a 65 72 6f low but non-zero
17270 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 probability of
17280 64 61 6d 61 67 65 2e 20 20 4c 65 76 65 6c 20 33 damage. Level 3
17290 20 72 65 64 75 63 65 73 20 74 68 65 0a 2a 2a 20 reduces the.**
172a0 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 probability of d
172b0 61 6d 61 67 65 20 74 6f 20 6e 65 61 72 20 7a 65 amage to near ze
172c0 72 6f 20 62 75 74 20 77 69 74 68 20 61 20 77 72 ro but with a wr
172d0 69 74 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 ite performance
172e0 72 65 64 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 reduction..*/.#i
172f0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
17300 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 0a T_PAGER_PRAGMAS.
17310 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
17320 53 65 74 50 61 67 65 72 46 6c 61 67 73 28 0a 20 SetPagerFlags(.
17330 20 42 74 72 65 65 20 2a 70 2c 20 20 20 20 20 20 Btree *p,
17340 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 /* The b
17350 74 72 65 65 20 74 6f 20 73 65 74 20 74 68 65 20 tree to set the
17360 73 61 66 65 74 79 20 6c 65 76 65 6c 20 6f 6e 20 safety level on
17370 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 70 67 */. unsigned pg
17380 46 6c 61 67 73 20 20 20 20 20 20 20 2f 2a 20 56 Flags /* V
17390 61 72 69 6f 75 73 20 50 41 47 45 52 5f 2a 20 66 arious PAGER_* f
173a0 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 lags */.){. BtS
173b0 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
173c0 70 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 pBt;. assert( s
173d0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
173e0 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 d(p->db->mutex)
173f0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
17400 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 73 71 6c eEnter(p);. sql
17410 69 74 65 33 50 61 67 65 72 53 65 74 46 6c 61 67 ite3PagerSetFlag
17420 73 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 s(pBt->pPager, p
17430 67 46 6c 61 67 73 29 3b 0a 20 20 73 71 6c 69 74 gFlags);. sqlit
17440 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
17450 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
17460 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f _OK;.}.#endif../
17470 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
17480 64 65 66 61 75 6c 74 20 70 61 67 65 73 20 73 69 default pages si
17490 7a 65 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 ze and the numbe
174a0 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 62 79 r of reserved by
174b0 74 65 73 20 70 65 72 20 70 61 67 65 2e 0a 2a 2a tes per page..**
174c0 20 4f 72 2c 20 69 66 20 74 68 65 20 70 61 67 65 Or, if the page
174d0 20 73 69 7a 65 20 68 61 73 20 61 6c 72 65 61 64 size has alread
174e0 79 20 62 65 65 6e 20 66 69 78 65 64 2c 20 72 65 y been fixed, re
174f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 turn SQLITE_READ
17500 4f 4e 4c 59 20 0a 2a 2a 20 77 69 74 68 6f 75 74 ONLY .** without
17510 20 63 68 61 6e 67 69 6e 67 20 61 6e 79 74 68 69 changing anythi
17520 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 ng..**.** The pa
17530 67 65 20 73 69 7a 65 20 6d 75 73 74 20 62 65 20 ge size must be
17540 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62 65 74 a power of 2 bet
17550 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 35 ween 512 and 655
17560 33 36 2e 20 20 49 66 20 74 68 65 20 70 61 67 65 36. If the page
17570 0a 2a 2a 20 73 69 7a 65 20 73 75 70 70 6c 69 65 .** size supplie
17580 64 20 64 6f 65 73 20 6e 6f 74 20 6d 65 65 74 20 d does not meet
17590 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 this constraint
175a0 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 73 69 then the page si
175b0 7a 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 63 68 61 ze is not.** cha
175c0 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 nged..**.** Page
175d0 20 73 69 7a 65 73 20 61 72 65 20 63 6f 6e 73 74 sizes are const
175e0 72 61 69 6e 65 64 20 74 6f 20 62 65 20 61 20 70 rained to be a p
175f0 6f 77 65 72 20 6f 66 20 74 77 6f 20 73 6f 20 74 ower of two so t
17600 68 61 74 20 74 68 65 20 72 65 67 69 6f 6e 0a 2a hat the region.*
17610 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 * of the databas
17620 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20 e file used for
17630 6c 6f 63 6b 69 6e 67 20 28 62 65 67 69 6e 6e 69 locking (beginni
17640 6e 67 20 61 74 20 50 45 4e 44 49 4e 47 5f 42 59 ng at PENDING_BY
17650 54 45 2c 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 TE,.** the first
17660 20 62 79 74 65 20 70 61 73 74 20 74 68 65 20 31 byte past the 1
17670 47 42 20 62 6f 75 6e 64 61 72 79 2c 20 30 78 34 GB boundary, 0x4
17680 30 30 30 30 30 30 30 29 20 6e 65 65 64 73 20 74 0000000) needs t
17690 6f 20 6f 63 63 75 72 0a 2a 2a 20 61 74 20 74 68 o occur.** at th
176a0 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 61 e beginning of a
176b0 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 page..**.** If
176c0 70 61 72 61 6d 65 74 65 72 20 6e 52 65 73 65 72 parameter nReser
176d0 76 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 ve is less than
176e0 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 6e zero, then the n
176f0 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 umber of reserve
17700 64 0a 2a 2a 20 62 79 74 65 73 20 70 65 72 20 70 d.** bytes per p
17710 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e 63 68 age is left unch
17720 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 anged..**.** If
17730 74 68 65 20 69 46 69 78 21 3d 30 20 74 68 65 6e the iFix!=0 then
17740 20 74 68 65 20 42 54 53 5f 50 41 47 45 53 49 5a the BTS_PAGESIZ
17750 45 5f 46 49 58 45 44 20 66 6c 61 67 20 69 73 20 E_FIXED flag is
17760 73 65 74 20 73 6f 20 74 68 61 74 20 74 68 65 20 set so that the
17770 70 61 67 65 20 73 69 7a 65 0a 2a 2a 20 61 6e 64 page size.** and
17780 20 61 75 74 6f 76 61 63 75 75 6d 20 6d 6f 64 65 autovacuum mode
17790 20 63 61 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 can no longer b
177a0 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e e changed..*/.in
177b0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
177c0 74 50 61 67 65 53 69 7a 65 28 42 74 72 65 65 20 tPageSize(Btree
177d0 2a 70 2c 20 69 6e 74 20 70 61 67 65 53 69 7a 65 *p, int pageSize
177e0 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 2c 20 , int nReserve,
177f0 69 6e 74 20 69 46 69 78 29 7b 0a 20 20 69 6e 74 int iFix){. int
17800 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
17810 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
17820 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 = p->pBt;. ass
17830 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e 3d 2d ert( nReserve>=-
17840 31 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d 32 1 && nReserve<=2
17850 35 35 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 55 );. sqlite3B
17860 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 23 69 treeEnter(p);.#i
17870 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 f SQLITE_HAS_COD
17880 45 43 0a 20 20 69 66 28 20 6e 52 65 73 65 72 76 EC. if( nReserv
17890 65 3e 70 42 74 2d 3e 6f 70 74 69 6d 61 6c 52 65 e>pBt->optimalRe
178a0 73 65 72 76 65 20 29 20 70 42 74 2d 3e 6f 70 74 serve ) pBt->opt
178b0 69 6d 61 6c 52 65 73 65 72 76 65 20 3d 20 28 75 imalReserve = (u
178c0 38 29 6e 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 8)nReserve;.#end
178d0 69 66 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 if. if( pBt->bt
178e0 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 41 47 sFlags & BTS_PAG
178f0 45 53 49 5a 45 5f 46 49 58 45 44 20 29 7b 0a 20 ESIZE_FIXED ){.
17900 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
17910 65 61 76 65 28 70 29 3b 0a 20 20 20 20 72 65 74 eave(p);. ret
17920 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 4f urn SQLITE_READO
17930 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e NLY;. }. if( n
17940 52 65 73 65 72 76 65 3c 30 20 29 7b 0a 20 20 20 Reserve<0 ){.
17950 20 6e 52 65 73 65 72 76 65 20 3d 20 70 42 74 2d nReserve = pBt-
17960 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 42 74 2d >pageSize - pBt-
17970 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 7d >usableSize;. }
17980 0a 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 65 . assert( nRese
17990 72 76 65 3e 3d 30 20 26 26 20 6e 52 65 73 65 72 rve>=0 && nReser
179a0 76 65 3c 3d 32 35 35 20 29 3b 0a 20 20 69 66 28 ve<=255 );. if(
179b0 20 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 pageSize>=512 &
179c0 26 20 70 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 & pageSize<=SQLI
179d0 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 TE_MAX_PAGE_SIZE
179e0 20 26 26 0a 20 20 20 20 20 20 20 20 28 28 70 61 &&. ((pa
179f0 67 65 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 geSize-1)&pageSi
17a00 7a 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 ze)==0 ){. as
17a10 73 65 72 74 28 20 28 70 61 67 65 53 69 7a 65 20 sert( (pageSize
17a20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 20 61 & 7)==0 );. a
17a30 73 73 65 72 74 28 20 21 70 42 74 2d 3e 70 43 75 ssert( !pBt->pCu
17a40 72 73 6f 72 20 29 3b 0a 20 20 20 20 70 42 74 2d rsor );. pBt-
17a50 3e 70 61 67 65 53 69 7a 65 20 3d 20 28 75 33 32 >pageSize = (u32
17a60 29 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 66 )pageSize;. f
17a70 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 reeTempSpace(pBt
17a80 29 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 );. }. rc = sq
17a90 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 67 lite3PagerSetPag
17aa0 65 73 69 7a 65 28 70 42 74 2d 3e 70 50 61 67 65 esize(pBt->pPage
17ab0 72 2c 20 26 70 42 74 2d 3e 70 61 67 65 53 69 7a r, &pBt->pageSiz
17ac0 65 2c 20 6e 52 65 73 65 72 76 65 29 3b 0a 20 20 e, nReserve);.
17ad0 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
17ae0 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 = pBt->pageSize
17af0 2d 20 28 75 31 36 29 6e 52 65 73 65 72 76 65 3b - (u16)nReserve;
17b00 0a 20 20 69 66 28 20 69 46 69 78 20 29 20 70 42 . if( iFix ) pB
17b10 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 t->btsFlags |= B
17b20 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 TS_PAGESIZE_FIXE
17b30 44 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 D;. sqlite3Btre
17b40 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
17b50 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
17b60 20 52 65 74 75 72 6e 20 74 68 65 20 63 75 72 72 Return the curr
17b70 65 6e 74 6c 79 20 64 65 66 69 6e 65 64 20 70 61 ently defined pa
17b80 67 65 20 73 69 7a 65 0a 2a 2f 0a 69 6e 74 20 73 ge size.*/.int s
17b90 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 50 61 qlite3BtreeGetPa
17ba0 67 65 53 69 7a 65 28 42 74 72 65 65 20 2a 70 29 geSize(Btree *p)
17bb0 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 70 42 {. return p->pB
17bc0 74 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 7d 0a 0a t->pageSize;.}..
17bd0 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
17be0 69 6f 6e 20 69 73 20 73 69 6d 69 6c 61 72 20 74 ion is similar t
17bf0 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 o sqlite3BtreeGe
17c00 74 52 65 73 65 72 76 65 28 29 2c 20 65 78 63 65 tReserve(), exce
17c10 70 74 20 74 68 61 74 20 69 74 0a 2a 2a 20 6d 61 pt that it.** ma
17c20 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 y only be called
17c30 20 69 66 20 69 74 20 69 73 20 67 75 61 72 61 6e if it is guaran
17c40 74 65 65 64 20 74 68 61 74 20 74 68 65 20 62 2d teed that the b-
17c50 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 61 6c tree mutex is al
17c60 72 65 61 64 79 0a 2a 2a 20 68 65 6c 64 2e 0a 2a ready.** held..*
17c70 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 75 73 65 *.** This is use
17c80 66 75 6c 20 69 6e 20 6f 6e 65 20 73 70 65 63 69 ful in one speci
17c90 61 6c 20 63 61 73 65 20 69 6e 20 74 68 65 20 62 al case in the b
17ca0 61 63 6b 75 70 20 41 50 49 20 63 6f 64 65 20 77 ackup API code w
17cb0 68 65 72 65 20 69 74 20 69 73 0a 2a 2a 20 6b 6e here it is.** kn
17cc0 6f 77 6e 20 74 68 61 74 20 74 68 65 20 73 68 61 own that the sha
17cd0 72 65 64 20 62 2d 74 72 65 65 20 6d 75 74 65 78 red b-tree mutex
17ce0 20 69 73 20 68 65 6c 64 2c 20 62 75 74 20 74 68 is held, but th
17cf0 65 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 20 0a e mutex on the .
17d00 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 ** database hand
17d10 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a 70 20 le that owns *p
17d20 69 73 20 6e 6f 74 2e 20 49 6e 20 74 68 69 73 20 is not. In this
17d30 63 61 73 65 20 69 66 20 73 71 6c 69 74 65 33 42 case if sqlite3B
17d40 74 72 65 65 45 6e 74 65 72 28 29 0a 2a 2a 20 77 treeEnter().** w
17d50 65 72 65 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 ere to be called
17d60 2c 20 69 74 20 6d 69 67 68 74 20 63 6f 6c 6c 69 , it might colli
17d70 64 65 20 77 69 74 68 20 73 6f 6d 65 20 6f 74 68 de with some oth
17d80 65 72 20 6f 70 65 72 61 74 69 6f 6e 20 6f 6e 20 er operation on
17d90 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 the.** database
17da0 68 61 6e 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 handle that owns
17db0 20 2a 70 2c 20 63 61 75 73 69 6e 67 20 75 6e 64 *p, causing und
17dc0 65 66 69 6e 65 64 20 62 65 68 61 76 69 6f 72 2e efined behavior.
17dd0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
17de0 74 72 65 65 47 65 74 52 65 73 65 72 76 65 4e 6f treeGetReserveNo
17df0 4d 75 74 65 78 28 42 74 72 65 65 20 2a 70 29 7b Mutex(Btree *p){
17e00 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 61 73 73 65 . int n;. asse
17e10 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
17e20 78 5f 68 65 6c 64 28 70 2d 3e 70 42 74 2d 3e 6d x_held(p->pBt->m
17e30 75 74 65 78 29 20 29 3b 0a 20 20 6e 20 3d 20 70 utex) );. n = p
17e40 2d 3e 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 ->pBt->pageSize
17e50 2d 20 70 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 - p->pBt->usable
17e60 53 69 7a 65 3b 0a 20 20 72 65 74 75 72 6e 20 6e Size;. return n
17e70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
17e80 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
17e90 62 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 61 bytes of space a
17ea0 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 65 t the end of eve
17eb0 72 79 20 70 61 67 65 20 74 68 61 74 0a 2a 2a 20 ry page that.**
17ec0 61 72 65 20 69 6e 74 65 6e 74 75 61 6c 6c 79 20 are intentually
17ed0 6c 65 66 74 20 75 6e 75 73 65 64 2e 20 20 54 68 left unused. Th
17ee0 69 73 20 69 73 20 74 68 65 20 22 72 65 73 65 72 is is the "reser
17ef0 76 65 64 22 20 73 70 61 63 65 20 74 68 61 74 20 ved" space that
17f00 69 73 0a 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 is.** sometimes
17f10 75 73 65 64 20 62 79 20 65 78 74 65 6e 73 69 6f used by extensio
17f20 6e 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 53 51 4c ns..**.** If SQL
17f30 49 54 45 5f 48 41 53 5f 4d 55 54 45 58 20 69 73 ITE_HAS_MUTEX is
17f40 20 64 65 66 69 6e 65 64 20 74 68 65 6e 20 74 68 defined then th
17f50 65 20 6e 75 6d 62 65 72 20 72 65 74 75 72 6e 65 e number returne
17f60 64 20 69 73 20 74 68 65 0a 2a 2a 20 67 72 65 61 d is the.** grea
17f70 74 65 72 20 6f 66 20 74 68 65 20 63 75 72 72 65 ter of the curre
17f80 6e 74 20 72 65 73 65 72 76 65 64 20 73 70 61 63 nt reserved spac
17f90 65 20 61 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 e and the maximu
17fa0 6d 20 72 65 71 75 65 73 74 65 64 0a 2a 2a 20 72 m requested.** r
17fb0 65 73 65 72 76 65 20 73 70 61 63 65 2e 0a 2a 2f eserve space..*/
17fc0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
17fd0 65 47 65 74 4f 70 74 69 6d 61 6c 52 65 73 65 72 eGetOptimalReser
17fe0 76 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 ve(Btree *p){.
17ff0 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 33 int n;. sqlite3
18000 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
18010 20 6e 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 n = sqlite3Btre
18020 65 47 65 74 52 65 73 65 72 76 65 4e 6f 4d 75 74 eGetReserveNoMut
18030 65 78 28 70 29 3b 0a 23 69 66 64 65 66 20 53 51 ex(p);.#ifdef SQ
18040 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 LITE_HAS_CODEC.
18050 20 69 66 28 20 6e 3c 70 2d 3e 70 42 74 2d 3e 6f if( n<p->pBt->o
18060 70 74 69 6d 61 6c 52 65 73 65 72 76 65 20 29 20 ptimalReserve )
18070 6e 20 3d 20 70 2d 3e 70 42 74 2d 3e 6f 70 74 69 n = p->pBt->opti
18080 6d 61 6c 52 65 73 65 72 76 65 3b 0a 23 65 6e 64 malReserve;.#end
18090 69 66 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 if. sqlite3Btre
180a0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
180b0 75 72 6e 20 6e 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a urn n;.}.../*.**
180c0 20 53 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d Set the maximum
180d0 20 70 61 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 page count for
180e0 61 20 64 61 74 61 62 61 73 65 20 69 66 20 6d 78 a database if mx
180f0 50 61 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 Page is positive
18100 2e 0a 2a 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 ..** No changes
18110 61 72 65 20 6d 61 64 65 20 69 66 20 6d 78 50 61 are made if mxPa
18120 67 65 20 69 73 20 30 20 6f 72 20 6e 65 67 61 74 ge is 0 or negat
18130 69 76 65 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 ive..** Regardle
18140 73 73 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 ss of the value
18150 6f 66 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 of mxPage, retur
18160 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 n the maximum pa
18170 67 65 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 ge count..*/.int
18180 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d 61 78 sqlite3BtreeMax
18190 50 61 67 65 43 6f 75 6e 74 28 42 74 72 65 65 20 PageCount(Btree
181a0 2a 70 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b *p, int mxPage){
181b0 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 . int n;. sqli
181c0 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
181d0 3b 0a 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 ;. n = sqlite3P
181e0 61 67 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 agerMaxPageCount
181f0 28 70 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c (p->pBt->pPager,
18200 20 6d 78 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 mxPage);. sqli
18210 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
18220 3b 0a 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a ;. return n;.}.
18230 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 ./*.** Change th
18240 65 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 e values for the
18250 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
18260 54 45 20 61 6e 64 20 42 54 53 5f 4f 56 45 52 57 TE and BTS_OVERW
18270 52 49 54 45 20 66 6c 61 67 73 3a 0a 2a 2a 0a 2a RITE flags:.**.*
18280 2a 20 20 20 20 6e 65 77 46 6c 61 67 3d 3d 30 20 * newFlag==0
18290 20 20 20 20 20 20 42 6f 74 68 20 42 54 53 5f 53 Both BTS_S
182a0 45 43 55 52 45 5f 44 45 4c 45 54 45 20 61 6e 64 ECURE_DELETE and
182b0 20 42 54 53 5f 4f 56 45 52 57 52 49 54 45 20 61 BTS_OVERWRITE a
182c0 72 65 20 63 6c 65 61 72 65 64 0a 2a 2a 20 20 20 re cleared.**
182d0 20 6e 65 77 46 6c 61 67 3d 3d 31 20 20 20 20 20 newFlag==1
182e0 20 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c BTS_SECURE_DEL
182f0 45 54 45 20 73 65 74 20 61 6e 64 20 42 54 53 5f ETE set and BTS_
18300 4f 56 45 52 57 52 49 54 45 20 69 73 20 63 6c 65 OVERWRITE is cle
18310 61 72 65 64 0a 2a 2a 20 20 20 20 6e 65 77 46 6c ared.** newFl
18320 61 67 3d 3d 32 20 20 20 20 20 20 20 42 54 53 5f ag==2 BTS_
18330 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 63 6c SECURE_DELETE cl
18340 65 61 72 65 64 20 61 6e 64 20 42 54 53 5f 4f 56 eared and BTS_OV
18350 45 52 57 52 49 54 45 20 69 73 20 73 65 74 0a 2a ERWRITE is set.*
18360 2a 20 20 20 20 6e 65 77 46 6c 61 67 3d 3d 28 2d * newFlag==(-
18370 31 29 20 20 20 20 4e 6f 20 63 68 61 6e 67 65 73 1) No changes
18380 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
18390 69 6e 65 20 61 63 74 73 20 61 73 20 61 20 71 75 ine acts as a qu
183a0 65 72 79 20 69 66 20 6e 65 77 46 6c 61 67 20 69 ery if newFlag i
183b0 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65 72 6f s less than zero
183c0 0a 2a 2a 0a 2a 2a 20 57 69 74 68 20 42 54 53 5f .**.** With BTS_
183d0 4f 56 45 52 57 52 49 54 45 20 73 65 74 2c 20 64 OVERWRITE set, d
183e0 65 6c 65 74 65 64 20 63 6f 6e 74 65 6e 74 20 69 eleted content i
183f0 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 62 79 s overwritten by
18400 20 7a 65 72 6f 73 2c 20 62 75 74 0a 2a 2a 20 66 zeros, but.** f
18410 72 65 65 6c 69 73 74 20 6c 65 61 66 20 70 61 67 reelist leaf pag
18420 65 73 20 61 72 65 20 6e 6f 74 20 77 72 69 74 74 es are not writt
18430 65 6e 20 62 61 63 6b 20 74 6f 20 74 68 65 20 64 en back to the d
18440 61 74 61 62 61 73 65 2e 20 20 54 68 75 73 20 69 atabase. Thus i
18450 6e 2d 70 61 67 65 0a 2a 2a 20 64 65 6c 65 74 65 n-page.** delete
18460 64 20 63 6f 6e 74 65 6e 74 20 69 73 20 63 6c 65 d content is cle
18470 61 72 65 64 2c 20 62 75 74 20 66 72 65 65 6c 69 ared, but freeli
18480 73 74 20 64 65 6c 65 74 65 64 20 63 6f 6e 74 65 st deleted conte
18490 6e 74 20 69 73 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a nt is not..**.**
184a0 20 57 69 74 68 20 42 54 53 5f 53 45 43 55 52 45 With BTS_SECURE
184b0 5f 44 45 4c 45 54 45 2c 20 6f 70 65 72 61 74 69 _DELETE, operati
184c0 6f 6e 20 69 73 20 6c 69 6b 65 20 42 54 53 5f 4f on is like BTS_O
184d0 56 45 52 57 52 49 54 45 20 77 69 74 68 20 74 68 VERWRITE with th
184e0 65 20 61 64 64 69 74 69 6f 6e 0a 2a 2a 20 74 68 e addition.** th
184f0 61 74 20 66 72 65 65 6c 69 73 74 20 6c 65 61 66 at freelist leaf
18500 20 70 61 67 65 73 20 61 72 65 20 77 72 69 74 74 pages are writt
18510 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 en back into the
18520 20 64 61 74 61 62 61 73 65 2c 20 69 6e 63 72 65 database, incre
18530 61 73 69 6e 67 0a 2a 2a 20 74 68 65 20 61 6d 6f asing.** the amo
18540 75 6e 74 20 6f 66 20 64 69 73 6b 20 49 2f 4f 2e unt of disk I/O.
18550 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
18560 74 72 65 65 53 65 63 75 72 65 44 65 6c 65 74 65 treeSecureDelete
18570 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6e (Btree *p, int n
18580 65 77 46 6c 61 67 29 7b 0a 20 20 69 6e 74 20 62 ewFlag){. int b
18590 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72 ;. if( p==0 ) r
185a0 65 74 75 72 6e 20 30 3b 0a 20 20 73 71 6c 69 74 eturn 0;. sqlit
185b0 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
185c0 0a 20 20 61 73 73 65 72 74 28 20 42 54 53 5f 4f . assert( BTS_O
185d0 56 45 52 57 52 49 54 45 3d 3d 42 54 53 5f 53 45 VERWRITE==BTS_SE
185e0 43 55 52 45 5f 44 45 4c 45 54 45 2a 32 20 29 3b CURE_DELETE*2 );
185f0 0a 20 20 61 73 73 65 72 74 28 20 42 54 53 5f 46 . assert( BTS_F
18600 41 53 54 5f 53 45 43 55 52 45 3d 3d 28 42 54 53 AST_SECURE==(BTS
18610 5f 4f 56 45 52 57 52 49 54 45 7c 42 54 53 5f 53 _OVERWRITE|BTS_S
18620 45 43 55 52 45 5f 44 45 4c 45 54 45 29 20 29 3b ECURE_DELETE) );
18630 0a 20 20 69 66 28 20 6e 65 77 46 6c 61 67 3e 3d . if( newFlag>=
18640 30 20 29 7b 0a 20 20 20 20 70 2d 3e 70 42 74 2d 0 ){. p->pBt-
18650 3e 62 74 73 46 6c 61 67 73 20 26 3d 20 7e 42 54 >btsFlags &= ~BT
18660 53 5f 46 41 53 54 5f 53 45 43 55 52 45 3b 0a 20 S_FAST_SECURE;.
18670 20 20 20 70 2d 3e 70 42 74 2d 3e 62 74 73 46 6c p->pBt->btsFl
18680 61 67 73 20 7c 3d 20 42 54 53 5f 53 45 43 55 52 ags |= BTS_SECUR
18690 45 5f 44 45 4c 45 54 45 2a 6e 65 77 46 6c 61 67 E_DELETE*newFlag
186a0 3b 0a 20 20 7d 0a 20 20 62 20 3d 20 28 70 2d 3e ;. }. b = (p->
186b0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
186c0 42 54 53 5f 46 41 53 54 5f 53 45 43 55 52 45 29 BTS_FAST_SECURE)
186d0 2f 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 /BTS_SECURE_DELE
186e0 54 45 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 TE;. sqlite3Btr
186f0 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
18700 74 75 72 6e 20 62 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn b;.}../*.**
18710 20 43 68 61 6e 67 65 20 74 68 65 20 27 61 75 74 Change the 'aut
18720 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 o-vacuum' proper
18730 74 79 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ty of the databa
18740 73 65 2e 20 49 66 20 74 68 65 20 27 61 75 74 6f se. If the 'auto
18750 56 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 6d Vacuum'.** param
18760 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f eter is non-zero
18770 2c 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 75 , then auto-vacu
18780 75 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 6c um mode is enabl
18790 65 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 0a ed. If zero, it.
187a0 2a 2a 20 69 73 20 64 69 73 61 62 6c 65 64 2e 20 ** is disabled.
187b0 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 The default valu
187c0 65 20 66 6f 72 20 74 68 65 20 61 75 74 6f 2d 76 e for the auto-v
187d0 61 63 75 75 6d 20 70 72 6f 70 65 72 74 79 20 69 acuum property i
187e0 73 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 s .** determined
187f0 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f 44 by the SQLITE_D
18800 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 EFAULT_AUTOVACUU
18810 4d 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 20 M macro..*/.int
18820 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 41 sqlite3BtreeSetA
18830 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 20 utoVacuum(Btree
18840 2a 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 75 *p, int autoVacu
18850 75 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 um){.#ifdef SQLI
18860 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
18870 55 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 UM. return SQLI
18880 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 6c TE_READONLY;.#el
18890 73 65 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 se. BtShared *p
188a0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 Bt = p->pBt;. i
188b0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
188c0 4b 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 75 38 K;. u8 av = (u8
188d0 29 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 20 )autoVacuum;..
188e0 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
188f0 72 28 70 29 3b 0a 20 20 69 66 28 20 28 70 42 74 r(p);. if( (pBt
18900 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
18910 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 29 _PAGESIZE_FIXED)
18920 21 3d 30 20 26 26 20 28 61 76 20 3f 31 3a 30 29 !=0 && (av ?1:0)
18930 21 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 !=pBt->autoVacuu
18940 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 m ){. rc = SQ
18950 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 LITE_READONLY;.
18960 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 2d }else{. pBt-
18970 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 76 >autoVacuum = av
18980 20 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d 3e ?1:0;. pBt->
18990 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 76 3d incrVacuum = av=
189a0 3d 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 73 =2 ?1:0;. }. s
189b0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
189c0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
189d0 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a ;.#endif.}../*.*
189e0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 6c * Return the val
189f0 75 65 20 6f 66 20 74 68 65 20 27 61 75 74 6f 2d ue of the 'auto-
18a00 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 79 vacuum' property
18a10 2e 20 49 66 20 61 75 74 6f 2d 76 61 63 75 75 6d . If auto-vacuum
18a20 20 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 20 is .** enabled
18a30 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 1 is returned. O
18a40 74 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a 69 therwise 0..*/.i
18a50 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 nt sqlite3BtreeG
18a60 65 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 etAutoVacuum(Btr
18a70 65 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 ee *p){.#ifdef S
18a80 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
18a90 41 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 42 ACUUM. return B
18aa0 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f TREE_AUTOVACUUM_
18ab0 4e 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 6e NONE;.#else. in
18ac0 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 t rc;. sqlite3B
18ad0 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
18ae0 72 63 20 3d 20 28 0a 20 20 20 20 28 21 70 2d 3e rc = (. (!p->
18af0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 29 pBt->autoVacuum)
18b00 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 ?BTREE_AUTOVACUU
18b10 4d 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 2d M_NONE:. (!p-
18b20 3e 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d >pBt->incrVacuum
18b30 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 )?BTREE_AUTOVACU
18b40 55 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 52 UM_FULL:. BTR
18b50 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 4e EE_AUTOVACUUM_IN
18b60 43 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 65 CR. );. sqlite
18b70 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
18b80 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 6e return rc;.#en
18b90 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 dif.}../*.** If
18ba0 74 68 65 20 75 73 65 72 20 68 61 73 20 6e 6f 74 the user has not
18bb0 20 73 65 74 20 74 68 65 20 73 61 66 65 74 79 2d set the safety-
18bc0 6c 65 76 65 6c 20 66 6f 72 20 74 68 69 73 20 64 level for this d
18bd0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
18be0 6f 6e 0a 2a 2a 20 75 73 69 6e 67 20 22 50 52 41 on.** using "PRA
18bf0 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 22 GMA synchronous"
18c00 2c 20 61 6e 64 20 69 66 20 74 68 65 20 73 61 66 , and if the saf
18c10 65 74 79 2d 6c 65 76 65 6c 20 69 73 20 6e 6f 74 ety-level is not
18c20 20 61 6c 72 65 61 64 79 0a 2a 2a 20 73 65 74 20 already.** set
18c30 74 6f 20 74 68 65 20 76 61 6c 75 65 20 70 61 73 to the value pas
18c40 73 65 64 20 74 6f 20 74 68 69 73 20 66 75 6e 63 sed to this func
18c50 74 69 6f 6e 20 61 73 20 74 68 65 20 73 65 63 6f tion as the seco
18c60 6e 64 20 70 61 72 61 6d 65 74 65 72 2c 0a 2a 2a nd parameter,.**
18c70 20 73 65 74 20 69 74 20 73 6f 2e 0a 2a 2f 0a 23 set it so..*/.#
18c80 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c if SQLITE_DEFAUL
18c90 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 21 3d 53 T_SYNCHRONOUS!=S
18ca0 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 41 QLITE_DEFAULT_WA
18cb0 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 5c 0a L_SYNCHRONOUS \.
18cc0 20 20 20 20 26 26 20 21 64 65 66 69 6e 65 64 28 && !defined(
18cd0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 29 SQLITE_OMIT_WAL)
18ce0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 65 74 .static void set
18cf0 44 65 66 61 75 6c 74 53 79 6e 63 46 6c 61 67 28 DefaultSyncFlag(
18d00 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 75 BtShared *pBt, u
18d10 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 29 7b 8 safety_level){
18d20 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a . sqlite3 *db;.
18d30 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 69 66 28 Db *pDb;. if(
18d40 20 28 64 62 3d 70 42 74 2d 3e 64 62 29 21 3d 30 (db=pBt->db)!=0
18d50 20 26 26 20 28 70 44 62 3d 64 62 2d 3e 61 44 62 && (pDb=db->aDb
18d60 29 21 3d 30 20 29 7b 0a 20 20 20 20 77 68 69 6c )!=0 ){. whil
18d70 65 28 20 70 44 62 2d 3e 70 42 74 3d 3d 30 20 7c e( pDb->pBt==0 |
18d80 7c 20 70 44 62 2d 3e 70 42 74 2d 3e 70 42 74 21 | pDb->pBt->pBt!
18d90 3d 70 42 74 20 29 7b 20 70 44 62 2b 2b 3b 20 7d =pBt ){ pDb++; }
18da0 0a 20 20 20 20 69 66 28 20 70 44 62 2d 3e 62 53 . if( pDb->bS
18db0 79 6e 63 53 65 74 3d 3d 30 20 0a 20 20 20 20 20 yncSet==0 .
18dc0 26 26 20 70 44 62 2d 3e 73 61 66 65 74 79 5f 6c && pDb->safety_l
18dd0 65 76 65 6c 21 3d 73 61 66 65 74 79 5f 6c 65 76 evel!=safety_lev
18de0 65 6c 20 0a 20 20 20 20 20 26 26 20 70 44 62 21 el . && pDb!
18df0 3d 26 64 62 2d 3e 61 44 62 5b 31 5d 20 0a 20 20 =&db->aDb[1] .
18e00 20 20 29 7b 0a 20 20 20 20 20 20 70 44 62 2d 3e ){. pDb->
18e10 73 61 66 65 74 79 5f 6c 65 76 65 6c 20 3d 20 73 safety_level = s
18e20 61 66 65 74 79 5f 6c 65 76 65 6c 3b 0a 20 20 20 afety_level;.
18e30 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
18e40 65 74 46 6c 61 67 73 28 70 42 74 2d 3e 70 50 61 etFlags(pBt->pPa
18e50 67 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20 70 ger,. p
18e60 44 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c Db->safety_level
18e70 20 7c 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 | (db->flags &
18e80 50 41 47 45 52 5f 46 4c 41 47 53 5f 4d 41 53 4b PAGER_FLAGS_MASK
18e90 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a ));. }. }.}.
18ea0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
18eb0 65 74 44 65 66 61 75 6c 74 53 79 6e 63 46 6c 61 etDefaultSyncFla
18ec0 67 28 70 42 74 2c 73 61 66 65 74 79 5f 6c 65 76 g(pBt,safety_lev
18ed0 65 6c 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 46 el).#endif../* F
18ee0 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 orward declarati
18ef0 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 on */.static int
18f00 20 6e 65 77 44 61 74 61 62 61 73 65 28 42 74 53 newDatabase(BtS
18f10 68 61 72 65 64 2a 29 3b 0a 0a 0a 2f 2a 0a 2a 2a hared*);.../*.**
18f20 20 47 65 74 20 61 20 72 65 66 65 72 65 6e 63 65 Get a reference
18f30 20 74 6f 20 70 50 61 67 65 31 20 6f 66 20 74 68 to pPage1 of th
18f40 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
18f50 20 20 54 68 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 This will.** a
18f60 6c 73 6f 20 61 63 71 75 69 72 65 20 61 20 72 65 lso acquire a re
18f70 61 64 6c 6f 63 6b 20 6f 6e 20 74 68 61 74 20 66 adlock on that f
18f80 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 ile..**.** SQLIT
18f90 45 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 E_OK is returned
18fa0 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 on success. If
18fb0 20 74 68 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 the file is not
18fc0 20 61 0a 2a 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 a.** well-forme
18fd0 64 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c d database file,
18fe0 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 43 4f 52 then SQLITE_COR
18ff0 52 55 50 54 20 69 73 20 72 65 74 75 72 6e 65 64 RUPT is returned
19000 2e 0a 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 ..** SQLITE_BUSY
19010 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 is returned if
19020 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
19030 6c 6f 63 6b 65 64 2e 20 20 53 51 4c 49 54 45 5f locked. SQLITE_
19040 4e 4f 4d 45 4d 0a 2a 2a 20 69 73 20 72 65 74 75 NOMEM.** is retu
19050 72 6e 65 64 20 69 66 20 77 65 20 72 75 6e 20 6f rned if we run o
19060 75 74 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a ut of memory. .*
19070 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6c 6f 63 /.static int loc
19080 6b 42 74 72 65 65 28 42 74 53 68 61 72 65 64 20 kBtree(BtShared
19090 2a 70 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b *pBt){. int rc;
190a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
190b0 20 52 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f Result code fro
190c0 6d 20 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a m subfunctions *
190d0 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 /. MemPage *pPa
190e0 67 65 31 3b 20 20 20 20 20 2f 2a 20 50 61 67 65 ge1; /* Page
190f0 20 31 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 1 of the databa
19100 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 se file */. int
19110 20 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 nPage;
19120 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
19130 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 ages in the data
19140 62 61 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 base */. int nP
19150 61 67 65 46 69 6c 65 20 3d 20 30 3b 20 20 20 2f ageFile = 0; /
19160 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
19170 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 s in the databas
19180 65 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 e file */. int
19190 6e 50 61 67 65 48 65 61 64 65 72 3b 20 20 20 20 nPageHeader;
191a0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 /* Number of pa
191b0 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 ges in the datab
191c0 61 73 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f ase according to
191d0 20 68 64 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 hdr */.. asser
191e0 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
191f0 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
19200 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
19210 42 74 2d 3e 70 50 61 67 65 31 3d 3d 30 20 29 3b Bt->pPage1==0 );
19220 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
19230 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 70 agerSharedLock(p
19240 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 69 Bt->pPager);. i
19250 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
19260 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
19270 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
19280 65 28 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 e(pBt, 1, &pPage
19290 31 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 1, 0);. if( rc!
192a0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 =SQLITE_OK ) ret
192b0 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f urn rc;.. /* Do
192c0 20 73 6f 6d 65 20 63 68 65 63 6b 69 6e 67 20 74 some checking t
192d0 6f 20 68 65 6c 70 20 69 6e 73 75 72 65 20 74 68 o help insure th
192e0 65 20 66 69 6c 65 20 77 65 20 6f 70 65 6e 65 64 e file we opened
192f0 20 72 65 61 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 really is. **
19300 61 20 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 a valid database
19310 20 66 69 6c 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e file. . */. n
19320 50 61 67 65 20 3d 20 6e 50 61 67 65 48 65 61 64 Page = nPageHead
19330 65 72 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 er = get4byte(28
19340 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 +(u8*)pPage1->aD
19350 61 74 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 ata);. sqlite3P
19360 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 agerPagecount(pB
19370 74 2d 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 t->pPager, &nPag
19380 65 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 6e 50 eFile);. if( nP
19390 61 67 65 3d 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 age==0 || memcmp
193a0 28 32 34 2b 28 75 38 2a 29 70 50 61 67 65 31 2d (24+(u8*)pPage1-
193b0 3e 61 44 61 74 61 2c 20 39 32 2b 28 75 38 2a 29 >aData, 92+(u8*)
193c0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 2c 34 29 pPage1->aData,4)
193d0 21 3d 30 20 29 7b 0a 20 20 20 20 6e 50 61 67 65 !=0 ){. nPage
193e0 20 3d 20 6e 50 61 67 65 46 69 6c 65 3b 0a 20 20 = nPageFile;.
193f0 7d 0a 20 20 69 66 28 20 28 70 42 74 2d 3e 64 62 }. if( (pBt->db
19400 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 ->flags & SQLITE
19410 5f 52 65 73 65 74 44 61 74 61 62 61 73 65 29 21 _ResetDatabase)!
19420 3d 30 20 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 =0 ){. nPage
19430 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e = 0;. }. if( n
19440 50 61 67 65 3e 30 20 29 7b 0a 20 20 20 20 75 33 Page>0 ){. u3
19450 32 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 2 pageSize;.
19460 75 33 32 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a u32 usableSize;.
19470 20 20 20 20 75 38 20 2a 70 61 67 65 31 20 3d 20 u8 *page1 =
19480 70 50 61 67 65 31 2d 3e 61 44 61 74 61 3b 0a 20 pPage1->aData;.
19490 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
194a0 4f 54 41 44 42 3b 0a 20 20 20 20 2f 2a 20 45 56 OTADB;. /* EV
194b0 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 34 33 37 IDENCE-OF: R-437
194c0 33 37 2d 33 39 39 39 39 20 45 76 65 72 79 20 76 37-39999 Every v
194d0 61 6c 69 64 20 53 51 4c 69 74 65 20 64 61 74 61 alid SQLite data
194e0 62 61 73 65 20 66 69 6c 65 20 62 65 67 69 6e 73 base file begins
194f0 0a 20 20 20 20 2a 2a 20 77 69 74 68 20 74 68 65 . ** with the
19500 20 66 6f 6c 6c 6f 77 69 6e 67 20 31 36 20 62 79 following 16 by
19510 74 65 73 20 28 69 6e 20 68 65 78 29 3a 20 35 33 tes (in hex): 53
19520 20 35 31 20 34 63 20 36 39 20 37 34 20 36 35 20 51 4c 69 74 65
19530 32 30 20 36 36 20 36 66 20 37 32 20 36 64 0a 20 20 66 6f 72 6d.
19540 20 20 20 2a 2a 20 36 31 20 37 34 20 32 30 20 33 ** 61 74 20 3
19550 33 20 30 30 2e 20 2a 2f 0a 20 20 20 20 69 66 28 3 00. */. if(
19560 20 6d 65 6d 63 6d 70 28 70 61 67 65 31 2c 20 7a memcmp(page1, z
19570 4d 61 67 69 63 48 65 61 64 65 72 2c 20 31 36 29 MagicHeader, 16)
19580 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 !=0 ){. got
19590 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 o page1_init_fai
195a0 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 23 69 66 64 led;. }..#ifd
195b0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
195c0 41 4c 0a 20 20 20 20 69 66 28 20 70 61 67 65 31 AL. if( page1
195d0 5b 31 38 5d 3e 31 20 29 7b 0a 20 20 20 20 20 20 [18]>1 ){.
195e0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d pBt->btsFlags |=
195f0 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 3b 0a BTS_READ_ONLY;.
19600 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 61 }. if( pa
19610 67 65 31 5b 31 39 5d 3e 31 20 29 7b 0a 20 20 20 ge1[19]>1 ){.
19620 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e goto page1_in
19630 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d it_failed;. }
19640 0a 23 65 6c 73 65 0a 20 20 20 20 69 66 28 20 70 .#else. if( p
19650 61 67 65 31 5b 31 38 5d 3e 32 20 29 7b 0a 20 20 age1[18]>2 ){.
19660 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 pBt->btsFlag
19670 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f 4e s |= BTS_READ_ON
19680 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 LY;. }. if
19690 28 20 70 61 67 65 31 5b 31 39 5d 3e 32 20 29 7b ( page1[19]>2 ){
196a0 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
196b0 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 1_init_failed;.
196c0 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
196d0 74 68 65 20 77 72 69 74 65 20 76 65 72 73 69 6f the write versio
196e0 6e 20 69 73 20 73 65 74 20 74 6f 20 32 2c 20 74 n is set to 2, t
196f0 68 69 73 20 64 61 74 61 62 61 73 65 20 73 68 6f his database sho
19700 75 6c 64 20 62 65 20 61 63 63 65 73 73 65 64 0a uld be accessed.
19710 20 20 20 20 2a 2a 20 69 6e 20 57 41 4c 20 6d 6f ** in WAL mo
19720 64 65 2e 20 49 66 20 74 68 65 20 6c 6f 67 20 69 de. If the log i
19730 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 s not already op
19740 65 6e 2c 20 6f 70 65 6e 20 69 74 20 6e 6f 77 2e en, open it now.
19750 20 54 68 65 6e 20 0a 20 20 20 20 2a 2a 20 72 65 Then . ** re
19760 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 61 turn SQLITE_OK a
19770 6e 64 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 nd return withou
19780 74 20 70 6f 70 75 6c 61 74 69 6e 67 20 42 74 53 t populating BtS
19790 68 61 72 65 64 2e 70 50 61 67 65 31 2e 0a 20 20 hared.pPage1..
197a0 20 20 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 ** The caller
197b0 64 65 74 65 63 74 73 20 74 68 69 73 20 61 6e 64 detects this and
197c0 20 63 61 6c 6c 73 20 74 68 69 73 20 66 75 6e 63 calls this func
197d0 74 69 6f 6e 20 61 67 61 69 6e 2e 20 54 68 69 73 tion again. This
197e0 20 69 73 0a 20 20 20 20 2a 2a 20 72 65 71 75 69 is. ** requi
197f0 72 65 64 20 61 73 20 74 68 65 20 76 65 72 73 69 red as the versi
19800 6f 6e 20 6f 66 20 70 61 67 65 20 31 20 63 75 72 on of page 1 cur
19810 72 65 6e 74 6c 79 20 69 6e 20 74 68 65 20 70 61 rently in the pa
19820 67 65 31 20 62 75 66 66 65 72 0a 20 20 20 20 2a ge1 buffer. *
19830 2a 20 6d 61 79 20 6e 6f 74 20 62 65 20 74 68 65 * may not be the
19840 20 6c 61 74 65 73 74 20 76 65 72 73 69 6f 6e 20 latest version
19850 2d 20 74 68 65 72 65 20 6d 61 79 20 62 65 20 61 - there may be a
19860 20 6e 65 77 65 72 20 6f 6e 65 20 69 6e 20 74 68 newer one in th
19870 65 20 6c 6f 67 0a 20 20 20 20 2a 2a 20 66 69 6c e log. ** fil
19880 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 e.. */. if
19890 28 20 70 61 67 65 31 5b 31 39 5d 3d 3d 32 20 26 ( page1[19]==2 &
198a0 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 & (pBt->btsFlags
198b0 20 26 20 42 54 53 5f 4e 4f 5f 57 41 4c 29 3d 3d & BTS_NO_WAL)==
198c0 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 0 ){. int i
198d0 73 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 sOpen = 0;.
198e0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
198f0 65 72 4f 70 65 6e 57 61 6c 28 70 42 74 2d 3e 70 erOpenWal(pBt->p
19900 50 61 67 65 72 2c 20 26 69 73 4f 70 65 6e 29 3b Pager, &isOpen);
19910 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 . if( rc!=S
19920 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
19930 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 goto page1_i
19940 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 nit_failed;.
19950 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
19960 20 73 65 74 44 65 66 61 75 6c 74 53 79 6e 63 46 setDefaultSyncF
19970 6c 61 67 28 70 42 74 2c 20 53 51 4c 49 54 45 5f lag(pBt, SQLITE_
19980 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 DEFAULT_WAL_SYNC
19990 48 52 4f 4e 4f 55 53 2b 31 29 3b 0a 20 20 20 20 HRONOUS+1);.
199a0 20 20 20 20 69 66 28 20 69 73 4f 70 65 6e 3d 3d if( isOpen==
199b0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 0 ){. r
199c0 65 6c 65 61 73 65 50 61 67 65 4f 6e 65 28 70 50 eleasePageOne(pP
199d0 61 67 65 31 29 3b 0a 20 20 20 20 20 20 20 20 20 age1);.
199e0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
199f0 4b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 K;. }.
19a00 20 20 20 7d 0a 20 20 20 20 20 20 72 63 20 3d 20 }. rc =
19a10 53 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 SQLITE_NOTADB;.
19a20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
19a30 73 65 74 44 65 66 61 75 6c 74 53 79 6e 63 46 6c setDefaultSyncFl
19a40 61 67 28 70 42 74 2c 20 53 51 4c 49 54 45 5f 44 ag(pBt, SQLITE_D
19a50 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f EFAULT_SYNCHRONO
19a60 55 53 2b 31 29 3b 0a 20 20 20 20 7d 0a 23 65 6e US+1);. }.#en
19a70 64 69 66 0a 0a 20 20 20 20 2f 2a 20 45 56 49 44 dif.. /* EVID
19a80 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 35 34 36 35 ENCE-OF: R-15465
19a90 2d 32 30 38 31 33 20 54 68 65 20 6d 61 78 69 6d -20813 The maxim
19aa0 75 6d 20 61 6e 64 20 6d 69 6e 69 6d 75 6d 20 65 um and minimum e
19ab0 6d 62 65 64 64 65 64 20 70 61 79 6c 6f 61 64 0a mbedded payload.
19ac0 20 20 20 20 2a 2a 20 66 72 61 63 74 69 6f 6e 73 ** fractions
19ad0 20 61 6e 64 20 74 68 65 20 6c 65 61 66 20 70 61 and the leaf pa
19ae0 79 6c 6f 61 64 20 66 72 61 63 74 69 6f 6e 20 76 yload fraction v
19af0 61 6c 75 65 73 20 6d 75 73 74 20 62 65 20 36 34 alues must be 64
19b00 2c 20 33 32 2c 20 61 6e 64 20 33 32 2e 0a 20 20 , 32, and 32..
19b10 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 **. ** The
19b20 6f 72 69 67 69 6e 61 6c 20 64 65 73 69 67 6e 20 original design
19b30 61 6c 6c 6f 77 65 64 20 74 68 65 73 65 20 61 6d allowed these am
19b40 6f 75 6e 74 73 20 74 6f 20 76 61 72 79 2c 20 62 ounts to vary, b
19b50 75 74 20 61 73 20 6f 66 0a 20 20 20 20 2a 2a 20 ut as of. **
19b60 76 65 72 73 69 6f 6e 20 33 2e 36 2e 30 2c 20 77 version 3.6.0, w
19b70 65 20 72 65 71 75 69 72 65 20 74 68 65 6d 20 74 e require them t
19b80 6f 20 62 65 20 66 69 78 65 64 2e 0a 20 20 20 20 o be fixed..
19b90 2a 2f 0a 20 20 20 20 69 66 28 20 6d 65 6d 63 6d */. if( memcm
19ba0 70 28 26 70 61 67 65 31 5b 32 31 5d 2c 20 22 5c p(&page1[21], "\
19bb0 31 30 30 5c 30 34 30 5c 30 34 30 22 2c 33 29 21 100\040\040",3)!
19bc0 3d 30 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f =0 ){. goto
19bd0 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
19be0 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a ed;. }. /*
19bf0 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
19c00 35 31 38 37 33 2d 33 39 36 31 38 20 54 68 65 20 51873-39618 The
19c10 70 61 67 65 20 73 69 7a 65 20 66 6f 72 20 61 20 page size for a
19c20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 database file is
19c30 0a 20 20 20 20 2a 2a 20 64 65 74 65 72 6d 69 6e . ** determin
19c40 65 64 20 62 79 20 74 68 65 20 32 2d 62 79 74 65 ed by the 2-byte
19c50 20 69 6e 74 65 67 65 72 20 6c 6f 63 61 74 65 64 integer located
19c60 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 6f 66 at an offset of
19c70 20 31 36 20 62 79 74 65 73 20 66 72 6f 6d 0a 20 16 bytes from.
19c80 20 20 20 2a 2a 20 74 68 65 20 62 65 67 69 6e 6e ** the beginn
19c90 69 6e 67 20 6f 66 20 74 68 65 20 64 61 74 61 62 ing of the datab
19ca0 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 ase file. */.
19cb0 20 70 61 67 65 53 69 7a 65 20 3d 20 28 70 61 67 pageSize = (pag
19cc0 65 31 5b 31 36 5d 3c 3c 38 29 20 7c 20 28 70 61 e1[16]<<8) | (pa
19cd0 67 65 31 5b 31 37 5d 3c 3c 31 36 29 3b 0a 20 20 ge1[17]<<16);.
19ce0 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
19cf0 3a 20 52 2d 32 35 30 30 38 2d 32 31 36 38 38 20 : R-25008-21688
19d00 54 68 65 20 73 69 7a 65 20 6f 66 20 61 20 70 61 The size of a pa
19d10 67 65 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 ge is a power of
19d20 20 74 77 6f 0a 20 20 20 20 2a 2a 20 62 65 74 77 two. ** betw
19d30 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 35 33 een 512 and 6553
19d40 36 20 69 6e 63 6c 75 73 69 76 65 2e 20 2a 2f 0a 6 inclusive. */.
19d50 20 20 20 20 69 66 28 20 28 28 70 61 67 65 53 69 if( ((pageSi
19d60 7a 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 21 ze-1)&pageSize)!
19d70 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 67 65 53 =0. || pageS
19d80 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 50 ize>SQLITE_MAX_P
19d90 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 20 20 7c AGE_SIZE . |
19da0 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 35 36 20 | pageSize<=256
19db0 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f . ){. go
19dc0 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 to page1_init_fa
19dd0 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 iled;. }.
19de0 61 73 73 65 72 74 28 20 28 70 61 67 65 53 69 7a assert( (pageSiz
19df0 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a 20 20 20 e & 7)==0 );.
19e00 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
19e10 20 52 2d 35 39 33 31 30 2d 35 31 32 30 35 20 54 R-59310-51205 T
19e20 68 65 20 22 72 65 73 65 72 76 65 64 20 73 70 61 he "reserved spa
19e30 63 65 22 20 73 69 7a 65 20 69 6e 20 74 68 65 20 ce" size in the
19e40 31 2d 62 79 74 65 0a 20 20 20 20 2a 2a 20 69 6e 1-byte. ** in
19e50 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 20 teger at offset
19e60 32 30 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 is the number
19e70 20 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 of bytes of spa
19e80 63 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 ce at the end of
19e90 0a 20 20 20 20 2a 2a 20 65 61 63 68 20 70 61 67 . ** each pag
19ea0 65 20 74 6f 20 72 65 73 65 72 76 65 20 66 6f 72 e to reserve for
19eb0 20 65 78 74 65 6e 73 69 6f 6e 73 2e 20 0a 20 20 extensions. .
19ec0 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 45 56 49 44 **. ** EVID
19ed0 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 34 39 37 ENCE-OF: R-37497
19ee0 2d 34 32 34 31 32 20 54 68 65 20 73 69 7a 65 20 -42412 The size
19ef0 6f 66 20 74 68 65 20 72 65 73 65 72 76 65 64 20 of the reserved
19f00 72 65 67 69 6f 6e 20 69 73 0a 20 20 20 20 2a 2a region is. **
19f10 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 determined by t
19f20 68 65 20 6f 6e 65 2d 62 79 74 65 20 75 6e 73 69 he one-byte unsi
19f30 67 6e 65 64 20 69 6e 74 65 67 65 72 20 66 6f 75 gned integer fou
19f40 6e 64 20 61 74 20 61 6e 20 6f 66 66 73 65 74 20 nd at an offset
19f50 6f 66 20 32 30 0a 20 20 20 20 2a 2a 20 69 6e 74 of 20. ** int
19f60 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 o the database f
19f70 69 6c 65 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 ile header. */.
19f80 20 20 20 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 usableSize =
19f90 70 61 67 65 53 69 7a 65 20 2d 20 70 61 67 65 31 pageSize - page1
19fa0 5b 32 30 5d 3b 0a 20 20 20 20 69 66 28 20 28 75 [20];. if( (u
19fb0 33 32 29 70 61 67 65 53 69 7a 65 21 3d 70 42 74 32)pageSize!=pBt
19fc0 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a 20 20 ->pageSize ){.
19fd0 20 20 20 20 2f 2a 20 41 66 74 65 72 20 72 65 61 /* After rea
19fe0 64 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 ding the first p
19ff0 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 age of the datab
1a000 61 73 65 20 61 73 73 75 6d 69 6e 67 20 61 20 70 ase assuming a p
1a010 61 67 65 20 73 69 7a 65 0a 20 20 20 20 20 20 2a age size. *
1a020 2a 20 6f 66 20 42 74 53 68 61 72 65 64 2e 70 61 * of BtShared.pa
1a030 67 65 53 69 7a 65 2c 20 77 65 20 68 61 76 65 20 geSize, we have
1a040 64 69 73 63 6f 76 65 72 65 64 20 74 68 61 74 20 discovered that
1a050 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 69 73 the page-size is
1a060 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 75 61 6c . ** actual
1a070 6c 79 20 70 61 67 65 53 69 7a 65 2e 20 55 6e 6c ly pageSize. Unl
1a080 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 65 ock the database
1a090 2c 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 50 61 , leave pBt->pPa
1a0a0 67 65 31 20 61 74 0a 20 20 20 20 20 20 2a 2a 20 ge1 at. **
1a0b0 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20 zero and return
1a0c0 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 65 20 63 SQLITE_OK. The c
1a0d0 61 6c 6c 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 aller will call
1a0e0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 this function.
1a0f0 20 20 20 20 2a 2a 20 61 67 61 69 6e 20 77 69 74 ** again wit
1a100 68 20 74 68 65 20 63 6f 72 72 65 63 74 20 70 61 h the correct pa
1a110 67 65 2d 73 69 7a 65 2e 0a 20 20 20 20 20 20 2a ge-size.. *
1a120 2f 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 /. releaseP
1a130 61 67 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a ageOne(pPage1);.
1a140 20 20 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c pBt->usabl
1a150 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 eSize = usableSi
1a160 7a 65 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 ze;. pBt->p
1a170 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 ageSize = pageSi
1a180 7a 65 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 ze;. freeTe
1a190 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 mpSpace(pBt);.
1a1a0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
1a1b0 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
1a1c0 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 (pBt->pPager, &p
1a1d0 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 Bt->pageSize,.
1a1e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a1f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a200 20 70 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 pageSize-usable
1a210 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 Size);. ret
1a220 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
1a230 20 20 69 66 28 20 28 70 42 74 2d 3e 64 62 2d 3e if( (pBt->db->
1a240 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 57 flags & SQLITE_W
1a250 72 69 74 65 53 63 68 65 6d 61 29 3d 3d 30 20 26 riteSchema)==0 &
1a260 26 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 69 6c & nPage>nPageFil
1a270 65 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 e ){. rc =
1a280 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1a290 4b 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 KPT;. goto
1a2a0 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 page1_init_faile
1a2b0 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 d;. }. /*
1a2c0 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 EVIDENCE-OF: R-2
1a2d0 38 33 31 32 2d 36 34 37 30 34 20 48 6f 77 65 76 8312-64704 Howev
1a2e0 65 72 2c 20 74 68 65 20 75 73 61 62 6c 65 20 73 er, the usable s
1a2f0 69 7a 65 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 ize is not allow
1a300 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 62 65 20 ed to. ** be
1a310 6c 65 73 73 20 74 68 61 6e 20 34 38 30 2e 20 49 less than 480. I
1a320 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 69 n other words, i
1a330 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 20 f the page size
1a340 69 73 20 35 31 32 2c 20 74 68 65 6e 20 74 68 65 is 512, then the
1a350 0a 20 20 20 20 2a 2a 20 72 65 73 65 72 76 65 64 . ** reserved
1a360 20 73 70 61 63 65 20 73 69 7a 65 20 63 61 6e 6e space size cann
1a370 6f 74 20 65 78 63 65 65 64 20 33 32 2e 20 2a 2f ot exceed 32. */
1a380 0a 20 20 20 20 69 66 28 20 75 73 61 62 6c 65 53 . if( usableS
1a390 69 7a 65 3c 34 38 30 20 29 7b 0a 20 20 20 20 20 ize<480 ){.
1a3a0 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
1a3b0 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
1a3c0 20 20 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 pBt->pageSize
1a3d0 20 3d 20 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 = pageSize;.
1a3e0 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
1a3f0 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 3b 0a 23 = usableSize;.#
1a400 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1a410 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
1a420 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 pBt->autoVacuu
1a430 6d 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 70 m = (get4byte(&p
1a440 61 67 65 31 5b 33 36 20 2b 20 34 2a 34 5d 29 3f age1[36 + 4*4])?
1a450 31 3a 30 29 3b 0a 20 20 20 20 70 42 74 2d 3e 69 1:0);. pBt->i
1a460 6e 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 74 ncrVacuum = (get
1a470 34 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 20 4byte(&page1[36
1a480 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 0a 23 65 + 7*4])?1:0);.#e
1a490 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 2f 2a 20 6d ndif. }.. /* m
1a4a0 61 78 4c 6f 63 61 6c 20 69 73 20 74 68 65 20 6d axLocal is the m
1a4b0 61 78 69 6d 75 6d 20 61 6d 6f 75 6e 74 20 6f 66 aximum amount of
1a4c0 20 70 61 79 6c 6f 61 64 20 74 6f 20 73 74 6f 72 payload to stor
1a4d0 65 20 6c 6f 63 61 6c 6c 79 20 66 6f 72 0a 20 20 e locally for.
1a4e0 2a 2a 20 61 20 63 65 6c 6c 2e 20 20 4d 61 6b 65 ** a cell. Make
1a4f0 20 73 75 72 65 20 69 74 20 69 73 20 73 6d 61 6c sure it is smal
1a500 6c 20 65 6e 6f 75 67 68 20 73 6f 20 74 68 61 74 l enough so that
1a510 20 61 74 20 6c 65 61 73 74 20 6d 69 6e 46 61 6e at least minFan
1a520 6f 75 74 0a 20 20 2a 2a 20 63 65 6c 6c 73 20 63 out. ** cells c
1a530 61 6e 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 6f an will fit on o
1a540 6e 65 20 70 61 67 65 2e 20 20 57 65 20 61 73 73 ne page. We ass
1a550 75 6d 65 20 61 20 31 30 2d 62 79 74 65 20 70 61 ume a 10-byte pa
1a560 67 65 20 68 65 61 64 65 72 2e 0a 20 20 2a 2a 20 ge header.. **
1a570 42 65 73 69 64 65 73 20 74 68 65 20 70 61 79 6c Besides the payl
1a580 6f 61 64 2c 20 74 68 65 20 63 65 6c 6c 20 6d 75 oad, the cell mu
1a590 73 74 20 73 74 6f 72 65 3a 0a 20 20 2a 2a 20 20 st store:. **
1a5a0 20 20 20 32 2d 62 79 74 65 20 70 6f 69 6e 74 65 2-byte pointe
1a5b0 72 20 74 6f 20 74 68 65 20 63 65 6c 6c 0a 20 20 r to the cell.
1a5c0 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 63 68 ** 4-byte ch
1a5d0 69 6c 64 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a ild pointer. **
1a5e0 20 20 20 20 20 39 2d 62 79 74 65 20 6e 4b 65 79 9-byte nKey
1a5f0 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 20 20 20 value. **
1a600 34 2d 62 79 74 65 20 6e 44 61 74 61 20 76 61 6c 4-byte nData val
1a610 75 65 0a 20 20 2a 2a 20 20 20 20 20 34 2d 62 79 ue. ** 4-by
1a620 74 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 te overflow page
1a630 20 70 6f 69 6e 74 65 72 0a 20 20 2a 2a 20 53 6f pointer. ** So
1a640 20 61 20 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 a cell consists
1a650 20 6f 66 20 61 20 32 2d 62 79 74 65 20 70 6f 69 of a 2-byte poi
1a660 6e 74 65 72 2c 20 61 20 68 65 61 64 65 72 20 77 nter, a header w
1a670 68 69 63 68 20 69 73 20 61 73 20 6d 75 63 68 20 hich is as much
1a680 61 73 0a 20 20 2a 2a 20 31 37 20 62 79 74 65 73 as. ** 17 bytes
1a690 20 6c 6f 6e 67 2c 20 30 20 74 6f 20 4e 20 62 79 long, 0 to N by
1a6a0 74 65 73 20 6f 66 20 70 61 79 6c 6f 61 64 2c 20 tes of payload,
1a6b0 61 6e 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 and an optional
1a6c0 34 20 62 79 74 65 20 6f 76 65 72 66 6c 6f 77 0a 4 byte overflow.
1a6d0 20 20 2a 2a 20 70 61 67 65 20 70 6f 69 6e 74 65 ** page pointe
1a6e0 72 2e 0a 20 20 2a 2f 0a 20 20 70 42 74 2d 3e 6d r.. */. pBt->m
1a6f0 61 78 4c 6f 63 61 6c 20 3d 20 28 75 31 36 29 28 axLocal = (u16)(
1a700 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 (pBt->usableSize
1a710 2d 31 32 29 2a 36 34 2f 32 35 35 20 2d 20 32 33 -12)*64/255 - 23
1a720 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 6f 63 );. pBt->minLoc
1a730 61 6c 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d al = (u16)((pBt-
1a740 3e 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a >usableSize-12)*
1a750 33 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 32/255 - 23);.
1a760 70 42 74 2d 3e 6d 61 78 4c 65 61 66 20 3d 20 28 pBt->maxLeaf = (
1a770 75 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 u16)(pBt->usable
1a780 53 69 7a 65 20 2d 20 33 35 29 3b 0a 20 20 70 42 Size - 35);. pB
1a790 74 2d 3e 6d 69 6e 4c 65 61 66 20 3d 20 28 75 31 t->minLeaf = (u1
1a7a0 36 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 6)((pBt->usableS
1a7b0 69 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d ize-12)*32/255 -
1a7c0 20 32 33 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 23);. if( pBt-
1a7d0 3e 6d 61 78 4c 6f 63 61 6c 3e 31 32 37 20 29 7b >maxLocal>127 ){
1a7e0 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 . pBt->max1by
1a7f0 74 65 50 61 79 6c 6f 61 64 20 3d 20 31 32 37 3b tePayload = 127;
1a800 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 . }else{. pB
1a810 74 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f t->max1bytePaylo
1a820 61 64 20 3d 20 28 75 38 29 70 42 74 2d 3e 6d 61 ad = (u8)pBt->ma
1a830 78 4c 6f 63 61 6c 3b 0a 20 20 7d 0a 20 20 61 73 xLocal;. }. as
1a840 73 65 72 74 28 20 70 42 74 2d 3e 6d 61 78 4c 65 sert( pBt->maxLe
1a850 61 66 20 2b 20 32 33 20 3c 3d 20 4d 58 5f 43 45 af + 23 <= MX_CE
1a860 4c 4c 5f 53 49 5a 45 28 70 42 74 29 20 29 3b 0a LL_SIZE(pBt) );.
1a870 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 pBt->pPage1 =
1a880 70 50 61 67 65 31 3b 0a 20 20 70 42 74 2d 3e 6e pPage1;. pBt->n
1a890 50 61 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 Page = nPage;.
1a8a0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1a8b0 3b 0a 0a 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 ;..page1_init_fa
1a8c0 69 6c 65 64 3a 0a 20 20 72 65 6c 65 61 73 65 50 iled:. releaseP
1a8d0 61 67 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a ageOne(pPage1);.
1a8e0 20 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 pBt->pPage1 =
1a8f0 30 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 0;. return rc;.
1a900 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 }..#ifndef NDEBU
1a910 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 G./*.** Return t
1a920 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 75 72 he number of cur
1a930 73 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 70 42 74 sors open on pBt
1a940 2e 20 54 68 69 73 20 69 73 20 66 6f 72 20 75 73 . This is for us
1a950 65 0a 2a 2a 20 69 6e 20 61 73 73 65 72 74 28 29 e.** in assert()
1a960 20 65 78 70 72 65 73 73 69 6f 6e 73 2c 20 73 6f expressions, so
1a970 20 69 74 20 69 73 20 6f 6e 6c 79 20 63 6f 6d 70 it is only comp
1a980 69 6c 65 64 20 69 66 20 4e 44 45 42 55 47 20 69 iled if NDEBUG i
1a990 73 20 6e 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 64 s not.** defined
1a9a0 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c 79 20 77 72 69 ..**.** Only wri
1a9b0 74 65 20 63 75 72 73 6f 72 73 20 61 72 65 20 63 te cursors are c
1a9c0 6f 75 6e 74 65 64 20 69 66 20 77 72 4f 6e 6c 79 ounted if wrOnly
1a9d0 20 69 73 20 74 72 75 65 2e 20 20 49 66 20 77 72 is true. If wr
1a9e0 4f 6e 6c 79 20 69 73 0a 2a 2a 20 66 61 6c 73 65 Only is.** false
1a9f0 20 74 68 65 6e 20 61 6c 6c 20 63 75 72 73 6f 72 then all cursor
1aa00 73 20 61 72 65 20 63 6f 75 6e 74 65 64 2e 0a 2a s are counted..*
1aa10 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 20 70 75 72 *.** For the pur
1aa20 70 6f 73 65 73 20 6f 66 20 74 68 69 73 20 72 6f poses of this ro
1aa30 75 74 69 6e 65 2c 20 61 20 63 75 72 73 6f 72 20 utine, a cursor
1aa40 69 73 20 61 6e 79 20 63 75 72 73 6f 72 20 74 68 is any cursor th
1aa50 61 74 0a 2a 2a 20 69 73 20 63 61 70 61 62 6c 65 at.** is capable
1aa60 20 6f 66 20 72 65 61 64 69 6e 67 20 6f 72 20 77 of reading or w
1aa70 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 riting to the da
1aa80 74 61 62 61 73 65 2e 20 20 43 75 72 73 6f 72 73 tabase. Cursors
1aa90 20 74 68 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 that.** have be
1aaa0 65 6e 20 74 72 69 70 70 65 64 20 69 6e 74 6f 20 en tripped into
1aab0 74 68 65 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 the CURSOR_FAULT
1aac0 20 73 74 61 74 65 20 61 72 65 20 6e 6f 74 20 63 state are not c
1aad0 6f 75 6e 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 ounted..*/.stati
1aae0 63 20 69 6e 74 20 63 6f 75 6e 74 56 61 6c 69 64 c int countValid
1aaf0 43 75 72 73 6f 72 73 28 42 74 53 68 61 72 65 64 Cursors(BtShared
1ab00 20 2a 70 42 74 2c 20 69 6e 74 20 77 72 4f 6e 6c *pBt, int wrOnl
1ab10 79 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a y){. BtCursor *
1ab20 70 43 75 72 3b 0a 20 20 69 6e 74 20 72 20 3d 20 pCur;. int r =
1ab30 30 3b 0a 20 20 66 6f 72 28 70 43 75 72 3d 70 42 0;. for(pCur=pB
1ab40 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 43 75 72 t->pCursor; pCur
1ab50 3b 20 70 43 75 72 3d 70 43 75 72 2d 3e 70 4e 65 ; pCur=pCur->pNe
1ab60 78 74 29 7b 0a 20 20 20 20 69 66 28 20 28 77 72 xt){. if( (wr
1ab70 4f 6e 6c 79 3d 3d 30 20 7c 7c 20 28 70 43 75 72 Only==0 || (pCur
1ab80 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
1ab90 46 5f 57 72 69 74 65 46 6c 61 67 29 21 3d 30 29 F_WriteFlag)!=0)
1aba0 0a 20 20 20 20 20 26 26 20 70 43 75 72 2d 3e 65 . && pCur->e
1abb0 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f 46 41 State!=CURSOR_FA
1abc0 55 4c 54 20 29 20 72 2b 2b 3b 20 0a 20 20 7d 0a ULT ) r++; . }.
1abd0 20 20 72 65 74 75 72 6e 20 72 3b 0a 7d 0a 23 65 return r;.}.#e
1abe0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 ndif../*.** If t
1abf0 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 73 here are no outs
1ac00 74 61 6e 64 69 6e 67 20 63 75 72 73 6f 72 73 20 tanding cursors
1ac10 61 6e 64 20 77 65 20 61 72 65 20 6e 6f 74 20 69 and we are not i
1ac20 6e 20 74 68 65 20 6d 69 64 64 6c 65 0a 2a 2a 20 n the middle.**
1ac30 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e of a transaction
1ac40 20 62 75 74 20 74 68 65 72 65 20 69 73 20 61 20 but there is a
1ac50 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 read lock on the
1ac60 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e 0a database, then.
1ac70 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ** this routine
1ac80 75 6e 72 65 66 73 20 74 68 65 20 66 69 72 73 74 unrefs the first
1ac90 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 page of the dat
1aca0 61 62 61 73 65 20 66 69 6c 65 20 77 68 69 63 68 abase file which
1acb0 20 0a 2a 2a 20 68 61 73 20 74 68 65 20 65 66 66 .** has the eff
1acc0 65 63 74 20 6f 66 20 72 65 6c 65 61 73 69 6e 67 ect of releasing
1acd0 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a the read lock..
1ace0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 69 **.** If there i
1acf0 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 s a transaction
1ad00 69 6e 20 70 72 6f 67 72 65 73 73 2c 20 74 68 69 in progress, thi
1ad10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 6e s routine is a n
1ad20 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 o-op..*/.static
1ad30 76 6f 69 64 20 75 6e 6c 6f 63 6b 42 74 72 65 65 void unlockBtree
1ad40 49 66 55 6e 75 73 65 64 28 42 74 53 68 61 72 65 IfUnused(BtShare
1ad50 64 20 2a 70 42 74 29 7b 0a 20 20 61 73 73 65 72 d *pBt){. asser
1ad60 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
1ad70 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 _held(pBt->mutex
1ad80 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 63 ) );. assert( c
1ad90 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 6f 72 73 ountValidCursors
1ada0 28 70 42 74 2c 30 29 3d 3d 30 20 7c 7c 20 70 42 (pBt,0)==0 || pB
1adb0 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
1adc0 3e 54 52 41 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 >TRANS_NONE );.
1add0 20 69 66 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e if( pBt->inTran
1ade0 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e saction==TRANS_N
1adf0 4f 4e 45 20 26 26 20 70 42 74 2d 3e 70 50 61 67 ONE && pBt->pPag
1ae00 65 31 21 3d 30 20 29 7b 0a 20 20 20 20 4d 65 6d e1!=0 ){. Mem
1ae10 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 70 Page *pPage1 = p
1ae20 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 20 20 20 Bt->pPage1;.
1ae30 61 73 73 65 72 74 28 20 70 50 61 67 65 31 2d 3e assert( pPage1->
1ae40 61 44 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 aData );. ass
1ae50 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
1ae60 72 52 65 66 63 6f 75 6e 74 28 70 42 74 2d 3e 70 rRefcount(pBt->p
1ae70 50 61 67 65 72 29 3d 3d 31 20 29 3b 0a 20 20 20 Pager)==1 );.
1ae80 20 70 42 74 2d 3e 70 50 61 67 65 31 20 3d 20 30 pBt->pPage1 = 0
1ae90 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 ;. releasePag
1aea0 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a 20 20 eOne(pPage1);.
1aeb0 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 70 42 }.}../*.** If pB
1aec0 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 t points to an e
1aed0 6d 70 74 79 20 66 69 6c 65 20 74 68 65 6e 20 63 mpty file then c
1aee0 6f 6e 76 65 72 74 20 74 68 61 74 20 65 6d 70 74 onvert that empt
1aef0 79 20 66 69 6c 65 0a 2a 2a 20 69 6e 74 6f 20 61 y file.** into a
1af00 20 6e 65 77 20 65 6d 70 74 79 20 64 61 74 61 62 new empty datab
1af10 61 73 65 20 62 79 20 69 6e 69 74 69 61 6c 69 7a ase by initializ
1af20 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 70 61 ing the first pa
1af30 67 65 20 6f 66 0a 2a 2a 20 74 68 65 20 64 61 74 ge of.** the dat
1af40 61 62 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 abase..*/.static
1af50 20 69 6e 74 20 6e 65 77 44 61 74 61 62 61 73 65 int newDatabase
1af60 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b (BtShared *pBt){
1af70 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 31 3b . MemPage *pP1;
1af80 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
1af90 20 2a 64 61 74 61 3b 0a 20 20 69 6e 74 20 72 63 *data;. int rc
1afa0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c ;.. assert( sql
1afb0 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
1afc0 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
1afd0 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 65 3e if( pBt->nPage>
1afe0 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
1aff0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 SQLITE_OK;. }.
1b000 20 70 50 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 pP1 = pBt->pPag
1b010 65 31 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 e1;. assert( pP
1b020 31 21 3d 30 20 29 3b 0a 20 20 64 61 74 61 20 3d 1!=0 );. data =
1b030 20 70 50 31 2d 3e 61 44 61 74 61 3b 0a 20 20 72 pP1->aData;. r
1b040 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
1b050 57 72 69 74 65 28 70 50 31 2d 3e 70 44 62 50 61 Write(pP1->pDbPa
1b060 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 ge);. if( rc )
1b070 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 6d 65 6d return rc;. mem
1b080 63 70 79 28 64 61 74 61 2c 20 7a 4d 61 67 69 63 cpy(data, zMagic
1b090 48 65 61 64 65 72 2c 20 73 69 7a 65 6f 66 28 7a Header, sizeof(z
1b0a0 4d 61 67 69 63 48 65 61 64 65 72 29 29 3b 0a 20 MagicHeader));.
1b0b0 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 assert( sizeof(
1b0c0 7a 4d 61 67 69 63 48 65 61 64 65 72 29 3d 3d 31 zMagicHeader)==1
1b0d0 36 20 29 3b 0a 20 20 64 61 74 61 5b 31 36 5d 20 6 );. data[16]
1b0e0 3d 20 28 75 38 29 28 28 70 42 74 2d 3e 70 61 67 = (u8)((pBt->pag
1b0f0 65 53 69 7a 65 3e 3e 38 29 26 30 78 66 66 29 3b eSize>>8)&0xff);
1b100 0a 20 20 64 61 74 61 5b 31 37 5d 20 3d 20 28 75 . data[17] = (u
1b110 38 29 28 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 8)((pBt->pageSiz
1b120 65 3e 3e 31 36 29 26 30 78 66 66 29 3b 0a 20 20 e>>16)&0xff);.
1b130 64 61 74 61 5b 31 38 5d 20 3d 20 31 3b 0a 20 20 data[18] = 1;.
1b140 64 61 74 61 5b 31 39 5d 20 3d 20 31 3b 0a 20 20 data[19] = 1;.
1b150 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 73 61 assert( pBt->usa
1b160 62 6c 65 53 69 7a 65 3c 3d 70 42 74 2d 3e 70 61 bleSize<=pBt->pa
1b170 67 65 53 69 7a 65 20 26 26 20 70 42 74 2d 3e 75 geSize && pBt->u
1b180 73 61 62 6c 65 53 69 7a 65 2b 32 35 35 3e 3d 70 sableSize+255>=p
1b190 42 74 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 Bt->pageSize);.
1b1a0 20 64 61 74 61 5b 32 30 5d 20 3d 20 28 75 38 29 data[20] = (u8)
1b1b0 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d (pBt->pageSize -
1b1c0 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 pBt->usableSize
1b1d0 29 3b 0a 20 20 64 61 74 61 5b 32 31 5d 20 3d 20 );. data[21] =
1b1e0 36 34 3b 0a 20 20 64 61 74 61 5b 32 32 5d 20 3d 64;. data[22] =
1b1f0 20 33 32 3b 0a 20 20 64 61 74 61 5b 32 33 5d 20 32;. data[23]
1b200 3d 20 33 32 3b 0a 20 20 6d 65 6d 73 65 74 28 26 = 32;. memset(&
1b210 64 61 74 61 5b 32 34 5d 2c 20 30 2c 20 31 30 30 data[24], 0, 100
1b220 2d 32 34 29 3b 0a 20 20 7a 65 72 6f 50 61 67 65 -24);. zeroPage
1b230 28 70 50 31 2c 20 50 54 46 5f 49 4e 54 4b 45 59 (pP1, PTF_INTKEY
1b240 7c 50 54 46 5f 4c 45 41 46 7c 50 54 46 5f 4c 45 |PTF_LEAF|PTF_LE
1b250 41 46 44 41 54 41 20 29 3b 0a 20 20 70 42 74 2d AFDATA );. pBt-
1b260 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 >btsFlags |= BTS
1b270 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 3b _PAGESIZE_FIXED;
1b280 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
1b290 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
1b2a0 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 assert( pBt->a
1b2b0 75 74 6f 56 61 63 75 75 6d 3d 3d 31 20 7c 7c 20 utoVacuum==1 ||
1b2c0 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 3d pBt->autoVacuum=
1b2d0 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
1b2e0 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d 3d pBt->incrVacuum=
1b2f0 3d 31 20 7c 7c 20 70 42 74 2d 3e 69 6e 63 72 56 =1 || pBt->incrV
1b300 61 63 75 75 6d 3d 3d 30 20 29 3b 0a 20 20 70 75 acuum==0 );. pu
1b310 74 34 62 79 74 65 28 26 64 61 74 61 5b 33 36 20 t4byte(&data[36
1b320 2b 20 34 2a 34 5d 2c 20 70 42 74 2d 3e 61 75 74 + 4*4], pBt->aut
1b330 6f 56 61 63 75 75 6d 29 3b 0a 20 20 70 75 74 34 oVacuum);. put4
1b340 62 79 74 65 28 26 64 61 74 61 5b 33 36 20 2b 20 byte(&data[36 +
1b350 37 2a 34 5d 2c 20 70 42 74 2d 3e 69 6e 63 72 56 7*4], pBt->incrV
1b360 61 63 75 75 6d 29 3b 0a 23 65 6e 64 69 66 0a 20 acuum);.#endif.
1b370 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 31 3b pBt->nPage = 1;
1b380 0a 20 20 64 61 74 61 5b 33 31 5d 20 3d 20 31 3b . data[31] = 1;
1b390 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
1b3a0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e _OK;.}../*.** In
1b3b0 69 74 69 61 6c 69 7a 65 20 74 68 65 20 66 69 72 itialize the fir
1b3c0 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 st page of the d
1b3d0 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 63 72 atabase file (cr
1b3e0 65 61 74 69 6e 67 20 61 20 64 61 74 61 62 61 73 eating a databas
1b3f0 65 0a 2a 2a 20 63 6f 6e 73 69 73 74 69 6e 67 20 e.** consisting
1b400 6f 66 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 of a single page
1b410 20 61 6e 64 20 6e 6f 20 73 63 68 65 6d 61 20 6f and no schema o
1b420 62 6a 65 63 74 73 29 2e 20 52 65 74 75 72 6e 20 bjects). Return
1b430 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 66 20 SQLITE_OK.** if
1b440 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 61 successful, or a
1b450 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 n SQLite error c
1b460 6f 64 65 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a ode otherwise..*
1b470 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
1b480 65 65 4e 65 77 44 62 28 42 74 72 65 65 20 2a 70 eeNewDb(Btree *p
1b490 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 ){. int rc;. s
1b4a0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
1b4b0 28 70 29 3b 0a 20 20 70 2d 3e 70 42 74 2d 3e 6e (p);. p->pBt->n
1b4c0 50 61 67 65 20 3d 20 30 3b 0a 20 20 72 63 20 3d Page = 0;. rc =
1b4d0 20 6e 65 77 44 61 74 61 62 61 73 65 28 70 2d 3e newDatabase(p->
1b4e0 70 42 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 pBt);. sqlite3B
1b4f0 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
1b500 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
1b510 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73 .** Attempt to s
1b520 74 61 72 74 20 61 20 6e 65 77 20 74 72 61 6e 73 tart a new trans
1b530 61 63 74 69 6f 6e 2e 20 41 20 77 72 69 74 65 2d action. A write-
1b540 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 69 transaction.** i
1b550 73 20 73 74 61 72 74 65 64 20 69 66 20 74 68 65 s started if the
1b560 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
1b570 20 69 73 20 6e 6f 6e 7a 65 72 6f 2c 20 6f 74 68 is nonzero, oth
1b580 65 72 77 69 73 65 20 61 20 72 65 61 64 2d 0a 2a erwise a read-.*
1b590 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 * transaction.
1b5a0 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 If the second ar
1b5b0 67 75 6d 65 6e 74 20 69 73 20 32 20 6f 72 20 6d gument is 2 or m
1b5c0 6f 72 65 20 61 6e 64 20 65 78 63 6c 75 73 69 76 ore and exclusiv
1b5d0 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e e.** transaction
1b5e0 20 69 73 20 73 74 61 72 74 65 64 2c 20 6d 65 61 is started, mea
1b5f0 6e 69 6e 67 20 74 68 61 74 20 6e 6f 20 6f 74 68 ning that no oth
1b600 65 72 20 70 72 6f 63 65 73 73 20 69 73 20 61 6c er process is al
1b610 6c 6f 77 65 64 0a 2a 2a 20 74 6f 20 61 63 63 65 lowed.** to acce
1b620 73 73 20 74 68 65 20 64 61 74 61 62 61 73 65 2e ss the database.
1b630 20 20 41 20 70 72 65 65 78 69 73 74 69 6e 67 20 A preexisting
1b640 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 transaction may
1b650 6e 6f 74 20 62 65 0a 2a 2a 20 75 70 67 72 61 64 not be.** upgrad
1b660 65 64 20 74 6f 20 65 78 63 6c 75 73 69 76 65 20 ed to exclusive
1b670 62 79 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 by calling this
1b680 72 6f 75 74 69 6e 65 20 61 20 73 65 63 6f 6e 64 routine a second
1b690 20 74 69 6d 65 20 2d 20 74 68 65 0a 2a 2a 20 65 time - the.** e
1b6a0 78 63 6c 75 73 69 76 69 74 79 20 66 6c 61 67 20 xclusivity flag
1b6b0 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 6f 72 20 61 only works for a
1b6c0 20 6e 65 77 20 74 72 61 6e 73 61 63 74 69 6f 6e new transaction
1b6d0 2e 0a 2a 2a 0a 2a 2a 20 41 20 77 72 69 74 65 2d ..**.** A write-
1b6e0 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 transaction must
1b6f0 20 62 65 20 73 74 61 72 74 65 64 20 62 65 66 6f be started befo
1b700 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 61 6e re attempting an
1b710 79 20 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74 6f y .** changes to
1b720 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 the database.
1b730 4e 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c None of the foll
1b740 6f 77 69 6e 67 20 72 6f 75 74 69 6e 65 73 20 0a owing routines .
1b750 2a 2a 20 77 69 6c 6c 20 77 6f 72 6b 20 75 6e 6c ** will work unl
1b760 65 73 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f ess a transactio
1b770 6e 20 69 73 20 73 74 61 72 74 65 64 20 66 69 72 n is started fir
1b780 73 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 73 st:.**.** s
1b790 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 61 74 qlite3BtreeCreat
1b7a0 65 54 61 62 6c 65 28 29 0a 2a 2a 20 20 20 20 20 eTable().**
1b7b0 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 72 65 sqlite3BtreeCre
1b7c0 61 74 65 49 6e 64 65 78 28 29 0a 2a 2a 20 20 20 ateIndex().**
1b7d0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 sqlite3BtreeC
1b7e0 6c 65 61 72 54 61 62 6c 65 28 29 0a 2a 2a 20 20 learTable().**
1b7f0 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1b800 44 72 6f 70 54 61 62 6c 65 28 29 0a 2a 2a 20 20 DropTable().**
1b810 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
1b820 49 6e 73 65 72 74 28 29 0a 2a 2a 20 20 20 20 20 Insert().**
1b830 20 73 71 6c 69 74 65 33 42 74 72 65 65 44 65 6c sqlite3BtreeDel
1b840 65 74 65 28 29 0a 2a 2a 20 20 20 20 20 20 73 71 ete().** sq
1b850 6c 69 74 65 33 42 74 72 65 65 55 70 64 61 74 65 lite3BtreeUpdate
1b860 4d 65 74 61 28 29 0a 2a 2a 0a 2a 2a 20 49 66 20 Meta().**.** If
1b870 61 6e 20 69 6e 69 74 69 61 6c 20 61 74 74 65 6d an initial attem
1b880 70 74 20 74 6f 20 61 63 71 75 69 72 65 20 74 68 pt to acquire th
1b890 65 20 6c 6f 63 6b 20 66 61 69 6c 73 20 62 65 63 e lock fails bec
1b8a0 61 75 73 65 20 6f 66 20 6c 6f 63 6b 20 63 6f 6e ause of lock con
1b8b0 74 65 6e 74 69 6f 6e 0a 2a 2a 20 61 6e 64 20 74 tention.** and t
1b8c0 68 65 20 64 61 74 61 62 61 73 65 20 77 61 73 20 he database was
1b8d0 70 72 65 76 69 6f 75 73 6c 79 20 75 6e 6c 6f 63 previously unloc
1b8e0 6b 65 64 2c 20 74 68 65 6e 20 69 6e 76 6f 6b 65 ked, then invoke
1b8f0 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 the busy handle
1b900 72 0a 2a 2a 20 69 66 20 74 68 65 72 65 20 69 73 r.** if there is
1b910 20 6f 6e 65 2e 20 20 42 75 74 20 69 66 20 74 68 one. But if th
1b920 65 72 65 20 77 61 73 20 70 72 65 76 69 6f 75 73 ere was previous
1b930 6c 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 2c 20 ly a read-lock,
1b940 64 6f 20 6e 6f 74 0a 2a 2a 20 69 6e 76 6f 6b 65 do not.** invoke
1b950 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 the busy handle
1b960 72 20 2d 20 6a 75 73 74 20 72 65 74 75 72 6e 20 r - just return
1b970 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 20 53 51 SQLITE_BUSY. SQ
1b980 4c 49 54 45 5f 42 55 53 59 20 69 73 20 0a 2a 2a LITE_BUSY is .**
1b990 20 72 65 74 75 72 6e 65 64 20 77 68 65 6e 20 74 returned when t
1b9a0 68 65 72 65 20 69 73 20 61 6c 72 65 61 64 79 20 here is already
1b9b0 61 20 72 65 61 64 2d 6c 6f 63 6b 20 69 6e 20 6f a read-lock in o
1b9c0 72 64 65 72 20 74 6f 20 61 76 6f 69 64 20 61 20 rder to avoid a
1b9d0 64 65 61 64 6c 6f 63 6b 2e 0a 2a 2a 0a 2a 2a 20 deadlock..**.**
1b9e0 53 75 70 70 6f 73 65 20 74 68 65 72 65 20 61 72 Suppose there ar
1b9f0 65 20 74 77 6f 20 70 72 6f 63 65 73 73 65 73 20 e two processes
1ba00 41 20 61 6e 64 20 42 2e 20 20 41 20 68 61 73 20 A and B. A has
1ba10 61 20 72 65 61 64 20 6c 6f 63 6b 20 61 6e 64 20 a read lock and
1ba20 42 20 68 61 73 0a 2a 2a 20 61 20 72 65 73 65 72 B has.** a reser
1ba30 76 65 64 20 6c 6f 63 6b 2e 20 20 42 20 74 72 69 ved lock. B tri
1ba40 65 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 74 6f es to promote to
1ba50 20 65 78 63 6c 75 73 69 76 65 20 62 75 74 20 69 exclusive but i
1ba60 73 20 62 6c 6f 63 6b 65 64 20 62 65 63 61 75 73 s blocked becaus
1ba70 65 0a 2a 2a 20 6f 66 20 41 27 73 20 72 65 61 64 e.** of A's read
1ba80 20 6c 6f 63 6b 2e 20 20 41 20 74 72 69 65 73 20 lock. A tries
1ba90 74 6f 20 70 72 6f 6d 6f 74 65 20 74 6f 20 72 65 to promote to re
1baa0 73 65 72 76 65 64 20 62 75 74 20 69 73 20 62 6c served but is bl
1bab0 6f 63 6b 65 64 20 62 79 20 42 2e 0a 2a 2a 20 4f ocked by B..** O
1bac0 6e 65 20 6f 72 20 74 68 65 20 6f 74 68 65 72 20 ne or the other
1bad0 6f 66 20 74 68 65 20 74 77 6f 20 70 72 6f 63 65 of the two proce
1bae0 73 73 65 73 20 6d 75 73 74 20 67 69 76 65 20 77 sses must give w
1baf0 61 79 20 6f 72 20 74 68 65 72 65 20 63 61 6e 20 ay or there can
1bb00 62 65 0a 2a 2a 20 6e 6f 20 70 72 6f 67 72 65 73 be.** no progres
1bb10 73 2e 20 20 42 79 20 72 65 74 75 72 6e 69 6e 67 s. By returning
1bb20 20 53 51 4c 49 54 45 5f 42 55 53 59 20 61 6e 64 SQLITE_BUSY and
1bb30 20 6e 6f 74 20 69 6e 76 6f 6b 69 6e 67 20 74 68 not invoking th
1bb40 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 0a e busy callback.
1bb50 2a 2a 20 77 68 65 6e 20 41 20 61 6c 72 65 61 64 ** when A alread
1bb60 79 20 68 61 73 20 61 20 72 65 61 64 20 6c 6f 63 y has a read loc
1bb70 6b 2c 20 77 65 20 65 6e 63 6f 75 72 61 67 65 20 k, we encourage
1bb80 41 20 74 6f 20 67 69 76 65 20 75 70 20 61 6e 64 A to give up and
1bb90 20 6c 65 74 20 42 0a 2a 2a 20 70 72 6f 63 65 65 let B.** procee
1bba0 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 d..*/.int sqlite
1bbb0 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 3BtreeBeginTrans
1bbc0 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 77 (Btree *p, int w
1bbd0 72 66 6c 61 67 29 7b 0a 20 20 42 74 53 68 61 72 rflag){. BtShar
1bbe0 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 ed *pBt = p->pBt
1bbf0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
1bc00 49 54 45 5f 4f 4b 3b 0a 0a 20 20 73 71 6c 69 74 ITE_OK;.. sqlit
1bc10 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b e3BtreeEnter(p);
1bc20 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 74 . btreeIntegrit
1bc30 79 28 70 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 y(p);.. /* If t
1bc40 68 65 20 62 74 72 65 65 20 69 73 20 61 6c 72 65 he btree is alre
1bc50 61 64 79 20 69 6e 20 61 20 77 72 69 74 65 2d 74 ady in a write-t
1bc60 72 61 6e 73 61 63 74 69 6f 6e 2c 20 6f 72 20 69 ransaction, or i
1bc70 74 0a 20 20 2a 2a 20 69 73 20 61 6c 72 65 61 64 t. ** is alread
1bc80 79 20 69 6e 20 61 20 72 65 61 64 2d 74 72 61 6e y in a read-tran
1bc90 73 61 63 74 69 6f 6e 20 61 6e 64 20 61 20 72 65 saction and a re
1bca0 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 ad-transaction.
1bcb0 20 2a 2a 20 69 73 20 72 65 71 75 65 73 74 65 64 ** is requested
1bcc0 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f , this is a no-o
1bcd0 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d p.. */. if( p-
1bce0 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
1bcf0 57 52 49 54 45 20 7c 7c 20 28 70 2d 3e 69 6e 54 WRITE || (p->inT
1bd00 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 52 45 41 44 rans==TRANS_READ
1bd10 20 26 26 20 21 77 72 66 6c 61 67 29 20 29 7b 0a && !wrflag) ){.
1bd20 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 goto trans_b
1bd30 65 67 75 6e 3b 0a 20 20 7d 0a 20 20 61 73 73 65 egun;. }. asse
1bd40 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 rt( pBt->inTrans
1bd50 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 action==TRANS_WR
1bd60 49 54 45 20 7c 7c 20 49 66 4e 6f 74 4f 6d 69 74 ITE || IfNotOmit
1bd70 41 56 28 70 42 74 2d 3e 62 44 6f 54 72 75 6e 63 AV(pBt->bDoTrunc
1bd80 61 74 65 29 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a ate)==0 );.. /*
1bd90 20 57 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 Write transacti
1bda0 6f 6e 73 20 61 72 65 20 6e 6f 74 20 70 6f 73 73 ons are not poss
1bdb0 69 62 6c 65 20 6f 6e 20 61 20 72 65 61 64 2d 6f ible on a read-o
1bdc0 6e 6c 79 20 64 61 74 61 62 61 73 65 20 2a 2f 0a nly database */.
1bdd0 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 46 if( (pBt->btsF
1bde0 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 44 5f lags & BTS_READ_
1bdf0 4f 4e 4c 59 29 21 3d 30 20 26 26 20 77 72 66 6c ONLY)!=0 && wrfl
1be00 61 67 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 ag ){. rc = S
1be10 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a QLITE_READONLY;.
1be20 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 goto trans_b
1be30 65 67 75 6e 3b 0a 20 20 7d 0a 0a 23 69 66 6e 64 egun;. }..#ifnd
1be40 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
1be50 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 7b 0a HARED_CACHE. {.
1be60 20 20 20 20 73 71 6c 69 74 65 33 20 2a 70 42 6c sqlite3 *pBl
1be70 6f 63 6b 20 3d 20 30 3b 0a 20 20 20 20 2f 2a 20 ock = 0;. /*
1be80 49 66 20 61 6e 6f 74 68 65 72 20 64 61 74 61 62 If another datab
1be90 61 73 65 20 68 61 6e 64 6c 65 20 68 61 73 20 61 ase handle has a
1bea0 6c 72 65 61 64 79 20 6f 70 65 6e 65 64 20 61 20 lready opened a
1beb0 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
1bec0 6e 20 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68 69 n . ** on thi
1bed0 73 20 73 68 61 72 65 64 2d 62 74 72 65 65 20 73 s shared-btree s
1bee0 74 72 75 63 74 75 72 65 20 61 6e 64 20 61 20 73 tructure and a s
1bef0 65 63 6f 6e 64 20 77 72 69 74 65 20 74 72 61 6e econd write tran
1bf00 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 20 20 2a saction is. *
1bf10 2a 20 72 65 71 75 65 73 74 65 64 2c 20 72 65 74 * requested, ret
1bf20 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 urn SQLITE_LOCKE
1bf30 44 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 D.. */. if
1bf40 28 20 28 77 72 66 6c 61 67 20 26 26 20 70 42 74 ( (wrflag && pBt
1bf50 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d ->inTransaction=
1bf60 3d 54 52 41 4e 53 5f 57 52 49 54 45 29 0a 20 20 =TRANS_WRITE).
1bf70 20 20 20 7c 7c 20 28 70 42 74 2d 3e 62 74 73 46 || (pBt->btsF
1bf80 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e 44 49 lags & BTS_PENDI
1bf90 4e 47 29 21 3d 30 0a 20 20 20 20 29 7b 0a 20 20 NG)!=0. ){.
1bfa0 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 74 pBlock = pBt
1bfb0 2d 3e 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a 20 ->pWriter->db;.
1bfc0 20 20 20 7d 65 6c 73 65 20 69 66 28 20 77 72 66 }else if( wrf
1bfd0 6c 61 67 3e 31 20 29 7b 0a 20 20 20 20 20 20 42 lag>1 ){. B
1bfe0 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 20 20 tLock *pIter;.
1bff0 20 20 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 for(pIter=pB
1c000 74 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b t->pLock; pIter;
1c010 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e pIter=pIter->pN
1c020 65 78 74 29 7b 0a 20 20 20 20 20 20 20 20 69 66 ext){. if
1c030 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 21 ( pIter->pBtree!
1c040 3d 70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =p ){.
1c050 70 42 6c 6f 63 6b 20 3d 20 70 49 74 65 72 2d 3e pBlock = pIter->
1c060 70 42 74 72 65 65 2d 3e 64 62 3b 0a 20 20 20 20 pBtree->db;.
1c070 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1c080 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
1c090 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 42 6c }. if( pBl
1c0a0 6f 63 6b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c ock ){. sql
1c0b0 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c ite3ConnectionBl
1c0c0 6f 63 6b 65 64 28 70 2d 3e 64 62 2c 20 70 42 6c ocked(p->db, pBl
1c0d0 6f 63 6b 29 3b 0a 20 20 20 20 20 20 72 63 20 3d ock);. rc =
1c0e0 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 5f 53 SQLITE_LOCKED_S
1c0f0 48 41 52 45 44 43 41 43 48 45 3b 0a 20 20 20 20 HAREDCACHE;.
1c100 20 20 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 goto trans_beg
1c110 75 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 un;. }. }.#e
1c120 6e 64 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 72 ndif.. /* Any r
1c130 65 61 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 64 ead-only or read
1c140 2d 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 -write transacti
1c150 6f 6e 20 69 6d 70 6c 69 65 73 20 61 20 72 65 61 on implies a rea
1c160 64 2d 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a 20 d-lock on . **
1c170 70 61 67 65 20 31 2e 20 53 6f 20 69 66 20 73 6f page 1. So if so
1c180 6d 65 20 6f 74 68 65 72 20 73 68 61 72 65 64 2d me other shared-
1c190 63 61 63 68 65 20 63 6c 69 65 6e 74 20 61 6c 72 cache client alr
1c1a0 65 61 64 79 20 68 61 73 20 61 20 77 72 69 74 65 eady has a write
1c1b0 2d 6c 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 70 -lock . ** on p
1c1c0 61 67 65 20 31 2c 20 74 68 65 20 74 72 61 6e 73 age 1, the trans
1c1d0 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 65 action cannot be
1c1e0 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 63 opened. */. rc
1c1f0 20 3d 20 71 75 65 72 79 53 68 61 72 65 64 43 61 = querySharedCa
1c200 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 cheTableLock(p,
1c210 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 41 MASTER_ROOT, REA
1c220 44 5f 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 53 D_LOCK);. if( S
1c230 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 67 QLITE_OK!=rc ) g
1c240 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b oto trans_begun;
1c250 0a 0a 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 .. pBt->btsFlag
1c260 73 20 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 41 s &= ~BTS_INITIA
1c270 4c 4c 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 28 LLY_EMPTY;. if(
1c280 20 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 29 pBt->nPage==0 )
1c290 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c pBt->btsFlags |
1c2a0 3d 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f = BTS_INITIALLY_
1c2b0 45 4d 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 20 EMPTY;. do {.
1c2c0 20 20 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 74 /* Call lockBt
1c2d0 72 65 65 28 29 20 75 6e 74 69 6c 20 65 69 74 68 ree() until eith
1c2e0 65 72 20 70 42 74 2d 3e 70 50 61 67 65 31 20 69 er pBt->pPage1 i
1c2f0 73 20 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a 20 s populated or.
1c300 20 20 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 28 ** lockBtree(
1c310 29 20 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 ) returns someth
1c320 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 53 ing other than S
1c330 51 4c 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 74 QLITE_OK. lockBt
1c340 72 65 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 79 ree(). ** may
1c350 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1c360 4b 20 62 75 74 20 6c 65 61 76 65 20 70 42 74 2d K but leave pBt-
1c370 3e 70 50 61 67 65 31 20 73 65 74 20 74 6f 20 30 >pPage1 set to 0
1c380 20 69 66 20 61 66 74 65 72 0a 20 20 20 20 2a 2a if after. **
1c390 20 72 65 61 64 69 6e 67 20 70 61 67 65 20 31 20 reading page 1
1c3a0 69 74 20 64 69 73 63 6f 76 65 72 73 20 74 68 61 it discovers tha
1c3b0 74 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 t the page-size
1c3c0 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
1c3d0 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 20 . ** file is
1c3e0 6e 6f 74 20 70 42 74 2d 3e 70 61 67 65 53 69 7a not pBt->pageSiz
1c3f0 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 e. In this case
1c400 6c 6f 63 6b 42 74 72 65 65 28 29 20 77 69 6c 6c lockBtree() will
1c410 20 75 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 70 update. ** p
1c420 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f 20 Bt->pageSize to
1c430 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 the page-size of
1c440 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 the file on dis
1c450 6b 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 68 k.. */. wh
1c460 69 6c 65 28 20 70 42 74 2d 3e 70 50 61 67 65 31 ile( pBt->pPage1
1c470 3d 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b ==0 && SQLITE_OK
1c480 3d 3d 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 65 ==(rc = lockBtre
1c490 65 28 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 20 e(pBt)) );..
1c4a0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
1c4b0 4b 20 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 K && wrflag ){.
1c4c0 20 20 20 20 20 69 66 28 20 28 70 42 74 2d 3e 62 if( (pBt->b
1c4d0 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 tsFlags & BTS_RE
1c4e0 41 44 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a 20 AD_ONLY)!=0 ){.
1c4f0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
1c500 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 TE_READONLY;.
1c510 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1c520 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1c530 67 65 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 50 gerBegin(pBt->pP
1c540 61 67 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 71 ager,wrflag>1,sq
1c550 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 lite3TempInMemor
1c560 79 28 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20 y(p->db));.
1c570 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1c580 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
1c590 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 rc = newDataba
1c5a0 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 se(pBt);.
1c5b0 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
1c5c0 0a 20 20 0a 20 20 20 20 69 66 28 20 72 63 21 3d . . if( rc!=
1c5d0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1c5e0 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 unlockBtreeIf
1c5f0 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 Unused(pBt);.
1c600 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 63 }. }while( (rc
1c610 26 30 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f 42 &0xFF)==SQLITE_B
1c620 55 53 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 USY && pBt->inTr
1c630 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 ansaction==TRANS
1c640 5f 4e 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 20 _NONE &&.
1c650 20 20 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 btreeInvokeBu
1c660 73 79 48 61 6e 64 6c 65 72 28 70 42 74 29 20 29 syHandler(pBt) )
1c670 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
1c680 52 65 73 65 74 4c 6f 63 6b 54 69 6d 65 6f 75 74 ResetLockTimeout
1c690 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 0a (pBt->pPager);..
1c6a0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1c6b0 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 70 _OK ){. if( p
1c6c0 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
1c6d0 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 70 _NONE ){. p
1c6e0 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e Bt->nTransaction
1c6f0 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ++;.#ifndef SQLI
1c700 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 TE_OMIT_SHARED_C
1c710 41 43 48 45 0a 20 20 20 20 20 20 69 66 28 20 70 ACHE. if( p
1c720 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 ->sharable ){.
1c730 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d assert( p-
1c740 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 3d 3d 70 20 >lock.pBtree==p
1c750 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 62 6c && p->lock.iTabl
1c760 65 3d 3d 31 20 29 3b 0a 20 20 20 20 20 20 20 20 e==1 );.
1c770 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 6b 20 3d 20 p->lock.eLock =
1c780 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 20 READ_LOCK;.
1c790 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 4e 65 78 74 p->lock.pNext
1c7a0 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a 20 = pBt->pLock;.
1c7b0 20 20 20 20 20 20 20 70 42 74 2d 3e 70 4c 6f 63 pBt->pLoc
1c7c0 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b 3b 0a 20 20 k = &p->lock;.
1c7d0 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 }.#endif.
1c7e0 20 7d 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 6e }. p->inTran
1c7f0 73 20 3d 20 28 77 72 66 6c 61 67 3f 54 52 41 4e s = (wrflag?TRAN
1c800 53 5f 57 52 49 54 45 3a 54 52 41 4e 53 5f 52 45 S_WRITE:TRANS_RE
1c810 41 44 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e AD);. if( p->
1c820 69 6e 54 72 61 6e 73 3e 70 42 74 2d 3e 69 6e 54 inTrans>pBt->inT
1c830 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 20 ransaction ){.
1c840 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 pBt->inTrans
1c850 61 63 74 69 6f 6e 20 3d 20 70 2d 3e 69 6e 54 72 action = p->inTr
1c860 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 ans;. }. i
1c870 66 28 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 f( wrflag ){.
1c880 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 MemPage *pPag
1c890 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 e1 = pBt->pPage1
1c8a0 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
1c8b0 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
1c8c0 48 45 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 HE. assert(
1c8d0 20 21 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 !pBt->pWriter )
1c8e0 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 57 72 ;. pBt->pWr
1c8f0 69 74 65 72 20 3d 20 70 3b 0a 20 20 20 20 20 20 iter = p;.
1c900 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d pBt->btsFlags &=
1c910 20 7e 42 54 53 5f 45 58 43 4c 55 53 49 56 45 3b ~BTS_EXCLUSIVE;
1c920 0a 20 20 20 20 20 20 69 66 28 20 77 72 66 6c 61 . if( wrfla
1c930 67 3e 31 20 29 20 70 42 74 2d 3e 62 74 73 46 6c g>1 ) pBt->btsFl
1c940 61 67 73 20 7c 3d 20 42 54 53 5f 45 58 43 4c 55 ags |= BTS_EXCLU
1c950 53 49 56 45 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 SIVE;.#endif..
1c960 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 64 62 /* If the db
1c970 2d 73 69 7a 65 20 68 65 61 64 65 72 20 66 69 65 -size header fie
1c980 6c 64 20 69 73 20 69 6e 63 6f 72 72 65 63 74 20 ld is incorrect
1c990 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 69 66 (as it may be if
1c9a0 20 61 6e 20 6f 6c 64 0a 20 20 20 20 20 20 2a 2a an old. **
1c9b0 20 63 6c 69 65 6e 74 20 68 61 73 20 62 65 65 6e client has been
1c9c0 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 74 writing the dat
1c9d0 61 62 61 73 65 20 66 69 6c 65 29 2c 20 75 70 64 abase file), upd
1c9e0 61 74 65 20 69 74 20 6e 6f 77 2e 20 44 6f 69 6e ate it now. Doin
1c9f0 67 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20 g. ** this
1ca00 73 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74 68 sooner rather th
1ca10 61 6e 20 6c 61 74 65 72 20 6d 65 61 6e 73 20 74 an later means t
1ca20 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
1ca30 20 63 61 6e 20 73 61 66 65 6c 79 20 0a 20 20 20 can safely .
1ca40 20 20 20 2a 2a 20 72 65 2d 72 65 61 64 20 74 68 ** re-read th
1ca50 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 e database size
1ca60 66 72 6f 6d 20 70 61 67 65 20 31 20 69 66 20 61 from page 1 if a
1ca70 20 73 61 76 65 70 6f 69 6e 74 20 6f 72 20 74 72 savepoint or tr
1ca80 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 ansaction.
1ca90 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 ** rollback occu
1caa0 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 74 72 rs within the tr
1cab0 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 ansaction..
1cac0 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 */. if( pB
1cad0 74 2d 3e 6e 50 61 67 65 21 3d 67 65 74 34 62 79 t->nPage!=get4by
1cae0 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
1caf0 61 5b 32 38 5d 29 20 29 7b 0a 20 20 20 20 20 20 a[28]) ){.
1cb00 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
1cb10 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 2d gerWrite(pPage1-
1cb20 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 >pDbPage);.
1cb30 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1cb40 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
1cb50 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 67 put4byte(&pPag
1cb60 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 70 e1->aData[28], p
1cb70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 Bt->nPage);.
1cb80 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
1cb90 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 61 6e 73 5f }. }...trans_
1cba0 62 65 67 75 6e 3a 0a 20 20 69 66 28 20 72 63 3d begun:. if( rc=
1cbb0 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 77 72 =SQLITE_OK && wr
1cbc0 66 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 54 flag ){. /* T
1cbd0 68 69 73 20 63 61 6c 6c 20 6d 61 6b 65 73 20 73 his call makes s
1cbe0 75 72 65 20 74 68 61 74 20 74 68 65 20 70 61 67 ure that the pag
1cbf0 65 72 20 68 61 73 20 74 68 65 20 63 6f 72 72 65 er has the corre
1cc00 63 74 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 ct number of.
1cc10 20 2a 2a 20 6f 70 65 6e 20 73 61 76 65 70 6f 69 ** open savepoi
1cc20 6e 74 73 2e 20 49 66 20 74 68 65 20 73 65 63 6f nts. If the seco
1cc30 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 nd parameter is
1cc40 67 72 65 61 74 65 72 20 74 68 61 6e 20 30 20 61 greater than 0 a
1cc50 6e 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 75 nd. ** the su
1cc60 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 6e 6f 74 b-journal is not
1cc70 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 74 already open, t
1cc80 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 65 20 6f hen it will be o
1cc90 70 65 6e 65 64 20 68 65 72 65 2e 0a 20 20 20 20 pened here..
1cca0 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
1ccb0 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 te3PagerOpenSave
1ccc0 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 point(pBt->pPage
1ccd0 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 61 76 65 70 r, p->db->nSavep
1cce0 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 oint);. }.. bt
1ccf0 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b reeIntegrity(p);
1cd00 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c . sqlite3BtreeL
1cd10 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 eave(p);. retur
1cd20 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 n rc;.}..#ifndef
1cd30 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
1cd40 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a 2a 2a 20 53 OVACUUM../*.** S
1cd50 65 74 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d et the pointer-m
1cd60 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 61 ap entries for a
1cd70 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66 20 70 ll children of p
1cd80 61 67 65 20 70 50 61 67 65 2e 20 41 6c 73 6f 2c age pPage. Also,
1cd90 20 69 66 0a 2a 2a 20 70 50 61 67 65 20 63 6f 6e if.** pPage con
1cda0 74 61 69 6e 73 20 63 65 6c 6c 73 20 74 68 61 74 tains cells that
1cdb0 20 70 6f 69 6e 74 20 74 6f 20 6f 76 65 72 66 6c point to overfl
1cdc0 6f 77 20 70 61 67 65 73 2c 20 73 65 74 20 74 68 ow pages, set th
1cdd0 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 6d 61 70 e pointer.** map
1cde0 20 65 6e 74 72 69 65 73 20 66 6f 72 20 74 68 65 entries for the
1cdf0 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 overflow pages
1ce00 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 as well..*/.stat
1ce10 69 63 20 69 6e 74 20 73 65 74 43 68 69 6c 64 50 ic int setChildP
1ce20 74 72 6d 61 70 73 28 4d 65 6d 50 61 67 65 20 2a trmaps(MemPage *
1ce30 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 69 3b pPage){. int i;
1ce40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ce60 43 6f 75 6e 74 65 72 20 76 61 72 69 61 62 6c 65 Counter variable
1ce70 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 3b */. int nCell;
1ce80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce90 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1cea0 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 6e 20 70 er of cells in p
1ceb0 61 67 65 20 70 50 61 67 65 20 2a 2f 0a 20 20 69 age pPage */. i
1cec0 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
1ced0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cee0 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
1cef0 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 2a */. BtShared *
1cf00 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 pBt = pPage->pBt
1cf10 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 20 3d 20 ;. Pgno pgno =
1cf20 70 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 0a 20 20 pPage->pgno;..
1cf30 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
1cf40 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 mutex_held(pPage
1cf50 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b ->pBt->mutex) );
1cf60 0a 20 20 72 63 20 3d 20 70 50 61 67 65 2d 3e 69 . rc = pPage->i
1cf70 73 49 6e 69 74 20 3f 20 53 51 4c 49 54 45 5f 4f sInit ? SQLITE_O
1cf80 4b 20 3a 20 62 74 72 65 65 49 6e 69 74 50 61 67 K : btreeInitPag
1cf90 65 28 70 50 61 67 65 29 3b 0a 20 20 69 66 28 20 e(pPage);. if(
1cfa0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
1cfb0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 6e 43 65 return rc;. nCe
1cfc0 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c ll = pPage->nCel
1cfd0 6c 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 l;.. for(i=0; i
1cfe0 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 <nCell; i++){.
1cff0 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 u8 *pCell = fi
1d000 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 ndCell(pPage, i)
1d010 3b 0a 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 ;.. ptrmapPut
1d020 4f 76 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 OvflPtr(pPage, p
1d030 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a 20 20 20 Cell, &rc);..
1d040 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
1d050 66 20 29 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 f ){. Pgno
1d060 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 34 childPgno = get4
1d070 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a 20 20 20 byte(pCell);.
1d080 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 ptrmapPut(pBt
1d090 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 , childPgno, PTR
1d0a0 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c MAP_BTREE, pgno,
1d0b0 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d &rc);. }. }
1d0c0 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e .. if( !pPage->
1d0d0 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 6e 6f leaf ){. Pgno
1d0e0 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 childPgno = get
1d0f0 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 4byte(&pPage->aD
1d100 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 ata[pPage->hdrOf
1d110 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 74 fset+8]);. pt
1d120 72 6d 61 70 50 75 74 28 70 42 74 2c 20 63 68 69 rmapPut(pBt, chi
1d130 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 ldPgno, PTRMAP_B
1d140 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 TREE, pgno, &rc)
1d150 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 ;. }.. return
1d160 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d rc;.}../*.** Som
1d170 65 77 68 65 72 65 20 6f 6e 20 70 50 61 67 65 20 ewhere on pPage
1d180 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
1d190 70 61 67 65 20 69 46 72 6f 6d 2e 20 20 4d 6f 64 page iFrom. Mod
1d1a0 69 66 79 20 74 68 69 73 20 70 6f 69 6e 74 65 72 ify this pointer
1d1b0 20 73 6f 0a 2a 2a 20 74 68 61 74 20 69 74 20 70 so.** that it p
1d1c0 6f 69 6e 74 73 20 74 6f 20 69 54 6f 2e 20 50 61 oints to iTo. Pa
1d1d0 72 61 6d 65 74 65 72 20 65 54 79 70 65 20 64 65 rameter eType de
1d1e0 73 63 72 69 62 65 73 20 74 68 65 20 74 79 70 65 scribes the type
1d1f0 20 6f 66 20 70 6f 69 6e 74 65 72 20 74 6f 0a 2a of pointer to.*
1d200 2a 20 62 65 20 6d 6f 64 69 66 69 65 64 2c 20 61 * be modified, a
1d210 73 20 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a s follows:.**.*
1d220 2a 20 50 54 52 4d 41 50 5f 42 54 52 45 45 3a 20 * PTRMAP_BTREE:
1d230 20 20 20 20 70 50 61 67 65 20 69 73 20 61 20 62 pPage is a b
1d240 74 72 65 65 2d 70 61 67 65 2e 20 54 68 65 20 70 tree-page. The p
1d250 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 74 ointer points at
1d260 20 61 20 63 68 69 6c 64 20 0a 2a 2a 20 20 20 20 a child .**
1d270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
1d280 61 67 65 20 6f 66 20 70 50 61 67 65 2e 0a 2a 2a age of pPage..**
1d290 0a 2a 2a 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 .** PTRMAP_OVERF
1d2a0 4c 4f 57 31 3a 20 70 50 61 67 65 20 69 73 20 61 LOW1: pPage is a
1d2b0 20 62 74 72 65 65 2d 70 61 67 65 2e 20 54 68 65 btree-page. The
1d2c0 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 pointer points
1d2d0 61 74 20 61 6e 20 6f 76 65 72 66 6c 6f 77 0a 2a at an overflow.*
1d2e0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1d2f0 20 20 20 20 70 61 67 65 20 70 6f 69 6e 74 65 64 page pointed
1d300 20 74 6f 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 to by one of th
1d310 65 20 63 65 6c 6c 73 20 6f 6e 20 70 50 61 67 65 e cells on pPage
1d320 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 4f ..**.** PTRMAP_O
1d330 56 45 52 46 4c 4f 57 32 3a 20 70 50 61 67 65 20 VERFLOW2: pPage
1d340 69 73 20 61 6e 20 6f 76 65 72 66 6c 6f 77 2d 70 is an overflow-p
1d350 61 67 65 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 age. The pointer
1d360 20 70 6f 69 6e 74 73 20 61 74 20 74 68 65 20 6e points at the n
1d370 65 78 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ext.**
1d380 20 20 20 20 20 20 20 20 20 6f 76 65 72 66 6c 6f overflo
1d390 77 20 70 61 67 65 20 69 6e 20 74 68 65 20 6c 69 w page in the li
1d3a0 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e st..*/.static in
1d3b0 74 20 6d 6f 64 69 66 79 50 61 67 65 50 6f 69 6e t modifyPagePoin
1d3c0 74 65 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ter(MemPage *pPa
1d3d0 67 65 2c 20 50 67 6e 6f 20 69 46 72 6f 6d 2c 20 ge, Pgno iFrom,
1d3e0 50 67 6e 6f 20 69 54 6f 2c 20 75 38 20 65 54 79 Pgno iTo, u8 eTy
1d3f0 70 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 pe){. assert( s
1d400 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
1d410 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
1d420 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
1d430 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
1d440 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
1d450 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 69 >pDbPage) );. i
1d460 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 f( eType==PTRMAP
1d470 5f 4f 56 45 52 46 4c 4f 57 32 20 29 7b 0a 20 20 _OVERFLOW2 ){.
1d480 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 /* The pointer
1d490 20 69 73 20 61 6c 77 61 79 73 20 74 68 65 20 66 is always the f
1d4a0 69 72 73 74 20 34 20 62 79 74 65 73 20 6f 66 20 irst 4 bytes of
1d4b0 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 69 73 the page in this
1d4c0 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 69 case. */. i
1d4d0 66 28 20 67 65 74 34 62 79 74 65 28 70 50 61 67 f( get4byte(pPag
1d4e0 65 2d 3e 61 44 61 74 61 29 21 3d 69 46 72 6f 6d e->aData)!=iFrom
1d4f0 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1d500 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
1d510 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
1d520 20 7d 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 }. put4byte(
1d530 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 54 pPage->aData, iT
1d540 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 o);. }else{.
1d550 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 20 int i;. int
1d560 6e 43 65 6c 6c 3b 0a 20 20 20 20 69 6e 74 20 72 nCell;. int r
1d570 63 3b 0a 0a 20 20 20 20 72 63 20 3d 20 70 50 61 c;.. rc = pPa
1d580 67 65 2d 3e 69 73 49 6e 69 74 20 3f 20 53 51 4c ge->isInit ? SQL
1d590 49 54 45 5f 4f 4b 20 3a 20 62 74 72 65 65 49 6e ITE_OK : btreeIn
1d5a0 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 itPage(pPage);.
1d5b0 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 if( rc ) retu
1d5c0 72 6e 20 72 63 3b 0a 20 20 20 20 6e 43 65 6c 6c rn rc;. nCell
1d5d0 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b = pPage->nCell;
1d5e0 0a 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 .. for(i=0; i
1d5f0 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 <nCell; i++){.
1d600 20 20 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 u8 *pCell =
1d610 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
1d620 69 29 3b 0a 20 20 20 20 20 20 69 66 28 20 65 54 i);. if( eT
1d630 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 ype==PTRMAP_OVER
1d640 46 4c 4f 57 31 20 29 7b 0a 20 20 20 20 20 20 20 FLOW1 ){.
1d650 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a CellInfo info;.
1d660 20 20 20 20 20 20 20 20 70 50 61 67 65 2d 3e 78 pPage->x
1d670 50 61 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c ParseCell(pPage,
1d680 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a pCell, &info);.
1d690 20 20 20 20 20 20 20 20 69 66 28 20 69 6e 66 6f if( info
1d6a0 2e 6e 4c 6f 63 61 6c 3c 69 6e 66 6f 2e 6e 50 61 .nLocal<info.nPa
1d6b0 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 20 20 20 yload ){.
1d6c0 20 20 20 69 66 28 20 70 43 65 6c 6c 2b 69 6e 66 if( pCell+inf
1d6d0 6f 2e 6e 53 69 7a 65 20 3e 20 70 50 61 67 65 2d o.nSize > pPage-
1d6e0 3e 61 44 61 74 61 2b 70 50 61 67 65 2d 3e 70 42 >aData+pPage->pB
1d6f0 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b t->usableSize ){
1d700 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 . ret
1d710 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
1d720 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a PT_PAGE(pPage);.
1d730 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
1d740 20 20 20 20 20 20 69 66 28 20 69 46 72 6f 6d 3d if( iFrom=
1d750 3d 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c 2b =get4byte(pCell+
1d760 69 6e 66 6f 2e 6e 53 69 7a 65 2d 34 29 20 29 7b info.nSize-4) ){
1d770 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 . put
1d780 34 62 79 74 65 28 70 43 65 6c 6c 2b 69 6e 66 6f 4byte(pCell+info
1d790 2e 6e 53 69 7a 65 2d 34 2c 20 69 54 6f 29 3b 0a .nSize-4, iTo);.
1d7a0 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
1d7b0 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 k;. }.
1d7c0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
1d7d0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 69 66 else{. if
1d7e0 28 20 67 65 74 34 62 79 74 65 28 70 43 65 6c 6c ( get4byte(pCell
1d7f0 29 3d 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 )==iFrom ){.
1d800 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 70 put4byte(p
1d810 43 65 6c 6c 2c 20 69 54 6f 29 3b 0a 20 20 20 20 Cell, iTo);.
1d820 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
1d830 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
1d840 20 20 20 7d 0a 20 20 0a 20 20 20 20 69 66 28 20 }. . if(
1d850 69 3d 3d 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 i==nCell ){.
1d860 20 20 69 66 28 20 65 54 79 70 65 21 3d 50 54 52 if( eType!=PTR
1d870 4d 41 50 5f 42 54 52 45 45 20 7c 7c 20 0a 20 20 MAP_BTREE || .
1d880 20 20 20 20 20 20 20 20 67 65 74 34 62 79 74 65 get4byte
1d890 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
1d8a0 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
1d8b0 38 5d 29 21 3d 69 46 72 6f 6d 20 29 7b 0a 20 20 8])!=iFrom ){.
1d8c0 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
1d8d0 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 47 45 ITE_CORRUPT_PAGE
1d8e0 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d (pPage);. }
1d8f0 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 . put4byte(
1d900 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 &pPage->aData[pP
1d910 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 age->hdrOffset+8
1d920 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 7d 0a 20 ], iTo);. }.
1d930 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 }. return SQLI
1d940 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a TE_OK;.}.../*.**
1d950 20 4d 6f 76 65 20 74 68 65 20 6f 70 65 6e 20 64 Move the open d
1d960 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
1d970 50 61 67 65 20 74 6f 20 6c 6f 63 61 74 69 6f 6e Page to location
1d980 20 69 46 72 65 65 50 61 67 65 20 69 6e 20 74 68 iFreePage in th
1d990 65 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 e .** database.
1d9a0 54 68 65 20 70 44 62 50 61 67 65 20 72 65 66 65 The pDbPage refe
1d9b0 72 65 6e 63 65 20 72 65 6d 61 69 6e 73 20 76 61 rence remains va
1d9c0 6c 69 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 lid..**.** The i
1d9d0 73 43 6f 6d 6d 69 74 20 66 6c 61 67 20 69 6e 64 sCommit flag ind
1d9e0 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 72 icates that ther
1d9f0 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 74 6f 20 e is no need to
1da00 72 65 6d 65 6d 62 65 72 20 74 68 61 74 0a 2a 2a remember that.**
1da10 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 6e 65 65 the journal nee
1da20 64 73 20 74 6f 20 62 65 20 73 79 6e 63 28 29 65 ds to be sync()e
1da30 64 20 62 65 66 6f 72 65 20 64 61 74 61 62 61 73 d before databas
1da40 65 20 70 61 67 65 20 70 44 62 50 61 67 65 2d 3e e page pDbPage->
1da50 70 67 6e 6f 20 0a 2a 2a 20 63 61 6e 20 62 65 20 pgno .** can be
1da60 77 72 69 74 74 65 6e 20 74 6f 2e 20 54 68 65 20 written to. The
1da70 63 61 6c 6c 65 72 20 68 61 73 20 61 6c 72 65 61 caller has alrea
1da80 64 79 20 70 72 6f 6d 69 73 65 64 20 6e 6f 74 20 dy promised not
1da90 74 6f 20 77 72 69 74 65 20 74 6f 20 74 68 61 74 to write to that
1daa0 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 .** page..*/.sta
1dab0 74 69 63 20 69 6e 74 20 72 65 6c 6f 63 61 74 65 tic int relocate
1dac0 50 61 67 65 28 0a 20 20 42 74 53 68 61 72 65 64 Page(. BtShared
1dad0 20 2a 70 42 74 2c 20 20 20 20 20 20 20 20 20 20 *pBt,
1dae0 20 2f 2a 20 42 74 72 65 65 20 2a 2f 0a 20 20 4d /* Btree */. M
1daf0 65 6d 50 61 67 65 20 2a 70 44 62 50 61 67 65 2c emPage *pDbPage,
1db00 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 /* Open
1db10 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 2a 2f 0a page to move */.
1db20 20 20 75 38 20 65 54 79 70 65 2c 20 20 20 20 20 u8 eType,
1db30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
1db40 69 6e 74 65 72 20 6d 61 70 20 27 74 79 70 65 27 inter map 'type'
1db50 20 65 6e 74 72 79 20 66 6f 72 20 70 44 62 50 61 entry for pDbPa
1db60 67 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 69 50 74 ge */. Pgno iPt
1db70 72 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 rPage,
1db80 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 /* Pointer map
1db90 27 70 61 67 65 2d 6e 6f 27 20 65 6e 74 72 79 20 'page-no' entry
1dba0 66 6f 72 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 for pDbPage */.
1dbb0 20 50 67 6e 6f 20 69 46 72 65 65 50 61 67 65 2c Pgno iFreePage,
1dbc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
1dbd0 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 6d 6f 76 location to mov
1dbe0 65 20 70 44 62 50 61 67 65 20 74 6f 20 2a 2f 0a e pDbPage to */.
1dbf0 20 20 69 6e 74 20 69 73 43 6f 6d 6d 69 74 20 20 int isCommit
1dc00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 73 /* is
1dc10 43 6f 6d 6d 69 74 20 66 6c 61 67 20 70 61 73 73 Commit flag pass
1dc20 65 64 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 ed to sqlite3Pag
1dc30 65 72 4d 6f 76 65 70 61 67 65 20 2a 2f 0a 29 7b erMovepage */.){
1dc40 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 74 72 . MemPage *pPtr
1dc50 50 61 67 65 3b 20 20 20 2f 2a 20 54 68 65 20 70 Page; /* The p
1dc60 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e age that contain
1dc70 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 70 s a pointer to p
1dc80 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f DbPage */. Pgno
1dc90 20 69 44 62 50 61 67 65 20 3d 20 70 44 62 50 61 iDbPage = pDbPa
1dca0 67 65 2d 3e 70 67 6e 6f 3b 0a 20 20 50 61 67 65 ge->pgno;. Page
1dcb0 72 20 2a 70 50 61 67 65 72 20 3d 20 70 42 74 2d r *pPager = pBt-
1dcc0 3e 70 50 61 67 65 72 3b 0a 20 20 69 6e 74 20 72 >pPager;. int r
1dcd0 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 65 54 c;.. assert( eT
1dce0 79 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 ype==PTRMAP_OVER
1dcf0 46 4c 4f 57 32 20 7c 7c 20 65 54 79 70 65 3d 3d FLOW2 || eType==
1dd00 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 PTRMAP_OVERFLOW1
1dd10 20 7c 7c 20 0a 20 20 20 20 20 20 65 54 79 70 65 || . eType
1dd20 3d 3d 50 54 52 4d 41 50 5f 42 54 52 45 45 20 7c ==PTRMAP_BTREE |
1dd30 7c 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f | eType==PTRMAP_
1dd40 52 4f 4f 54 50 41 47 45 20 29 3b 0a 20 20 61 73 ROOTPAGE );. as
1dd50 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
1dd60 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
1dd70 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
1dd80 28 20 70 44 62 50 61 67 65 2d 3e 70 42 74 3d 3d ( pDbPage->pBt==
1dd90 70 42 74 20 29 3b 0a 0a 20 20 2f 2a 20 4d 6f 76 pBt );.. /* Mov
1dda0 65 20 70 61 67 65 20 69 44 62 50 61 67 65 20 66 e page iDbPage f
1ddb0 72 6f 6d 20 69 74 73 20 63 75 72 72 65 6e 74 20 rom its current
1ddc0 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 70 61 67 65 location to page
1ddd0 20 6e 75 6d 62 65 72 20 69 46 72 65 65 50 61 67 number iFreePag
1dde0 65 20 2a 2f 0a 20 20 54 52 41 43 45 28 28 22 41 e */. TRACE(("A
1ddf0 55 54 4f 56 41 43 55 55 4d 3a 20 4d 6f 76 69 6e UTOVACUUM: Movin
1de00 67 20 25 64 20 74 6f 20 66 72 65 65 20 70 61 67 g %d to free pag
1de10 65 20 25 64 20 28 70 74 72 20 70 61 67 65 20 25 e %d (ptr page %
1de20 64 20 74 79 70 65 20 25 64 29 5c 6e 22 2c 20 0a d type %d)\n", .
1de30 20 20 20 20 20 20 69 44 62 50 61 67 65 2c 20 69 iDbPage, i
1de40 46 72 65 65 50 61 67 65 2c 20 69 50 74 72 50 61 FreePage, iPtrPa
1de50 67 65 2c 20 65 54 79 70 65 29 29 3b 0a 20 20 72 ge, eType));. r
1de60 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
1de70 4d 6f 76 65 70 61 67 65 28 70 50 61 67 65 72 2c Movepage(pPager,
1de80 20 70 44 62 50 61 67 65 2d 3e 70 44 62 50 61 67 pDbPage->pDbPag
1de90 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 69 73 e, iFreePage, is
1dea0 43 6f 6d 6d 69 74 29 3b 0a 20 20 69 66 28 20 72 Commit);. if( r
1deb0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1dec0 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1ded0 20 7d 0a 20 20 70 44 62 50 61 67 65 2d 3e 70 67 }. pDbPage->pg
1dee0 6e 6f 20 3d 20 69 46 72 65 65 50 61 67 65 3b 0a no = iFreePage;.
1def0 0a 20 20 2f 2a 20 49 66 20 70 44 62 50 61 67 65 . /* If pDbPage
1df00 20 77 61 73 20 61 20 62 74 72 65 65 2d 70 61 67 was a btree-pag
1df10 65 2c 20 74 68 65 6e 20 69 74 20 6d 61 79 20 68 e, then it may h
1df20 61 76 65 20 63 68 69 6c 64 20 70 61 67 65 73 20 ave child pages
1df30 61 6e 64 2f 6f 72 20 63 65 6c 6c 73 0a 20 20 2a and/or cells. *
1df40 2a 20 74 68 61 74 20 70 6f 69 6e 74 20 74 6f 20 * that point to
1df50 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 overflow pages.
1df60 54 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 The pointer map
1df70 65 6e 74 72 69 65 73 20 66 6f 72 20 61 6c 6c 20 entries for all
1df80 74 68 65 73 65 0a 20 20 2a 2a 20 70 61 67 65 73 these. ** pages
1df90 20 6e 65 65 64 20 74 6f 20 62 65 20 63 68 61 6e need to be chan
1dfa0 67 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 ged.. **. ** I
1dfb0 66 20 70 44 62 50 61 67 65 20 69 73 20 61 6e 20 f pDbPage is an
1dfc0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 74 overflow page, t
1dfd0 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 34 20 hen the first 4
1dfe0 62 79 74 65 73 20 6d 61 79 20 73 74 6f 72 65 20 bytes may store
1dff0 61 0a 20 20 2a 2a 20 70 6f 69 6e 74 65 72 20 74 a. ** pointer t
1e000 6f 20 61 20 73 75 62 73 65 71 75 65 6e 74 20 6f o a subsequent o
1e010 76 65 72 66 6c 6f 77 20 70 61 67 65 2e 20 49 66 verflow page. If
1e020 20 74 68 69 73 20 69 73 20 74 68 65 20 63 61 73 this is the cas
1e030 65 2c 20 74 68 65 6e 0a 20 20 2a 2a 20 74 68 65 e, then. ** the
1e040 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 6e 65 65 pointer map nee
1e050 64 73 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 ds to be updated
1e060 20 66 6f 72 20 74 68 65 20 73 75 62 73 65 71 75 for the subsequ
1e070 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ent overflow pag
1e080 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 54 e.. */. if( eT
1e090 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 45 ype==PTRMAP_BTRE
1e0a0 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 4d E || eType==PTRM
1e0b0 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 7b 0a 20 AP_ROOTPAGE ){.
1e0c0 20 20 20 72 63 20 3d 20 73 65 74 43 68 69 6c 64 rc = setChild
1e0d0 50 74 72 6d 61 70 73 28 70 44 62 50 61 67 65 29 Ptrmaps(pDbPage)
1e0e0 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
1e0f0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1e100 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
1e110 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 50 }. }else{. P
1e120 67 6e 6f 20 6e 65 78 74 4f 76 66 6c 20 3d 20 67 gno nextOvfl = g
1e130 65 74 34 62 79 74 65 28 70 44 62 50 61 67 65 2d et4byte(pDbPage-
1e140 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 69 66 28 >aData);. if(
1e150 20 6e 65 78 74 4f 76 66 6c 21 3d 30 20 29 7b 0a nextOvfl!=0 ){.
1e160 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 ptrmapPut(
1e170 70 42 74 2c 20 6e 65 78 74 4f 76 66 6c 2c 20 50 pBt, nextOvfl, P
1e180 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 2c TRMAP_OVERFLOW2,
1e190 20 69 46 72 65 65 50 61 67 65 2c 20 26 72 63 29 iFreePage, &rc)
1e1a0 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
1e1b0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1e1c0 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
1e1d0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
1e1e0 7d 0a 0a 20 20 2f 2a 20 46 69 78 20 74 68 65 20 }.. /* Fix the
1e1f0 64 61 74 61 62 61 73 65 20 70 6f 69 6e 74 65 72 database pointer
1e200 20 6f 6e 20 70 61 67 65 20 69 50 74 72 50 61 67 on page iPtrPag
1e210 65 20 74 68 61 74 20 70 6f 69 6e 74 65 64 20 61 e that pointed a
1e220 74 20 69 44 62 50 61 67 65 20 73 6f 0a 20 20 2a t iDbPage so. *
1e230 2a 20 74 68 61 74 20 69 74 20 70 6f 69 6e 74 73 * that it points
1e240 20 61 74 20 69 46 72 65 65 50 61 67 65 2e 20 41 at iFreePage. A
1e250 6c 73 6f 20 66 69 78 20 74 68 65 20 70 6f 69 6e lso fix the poin
1e260 74 65 72 20 6d 61 70 20 65 6e 74 72 79 20 66 6f ter map entry fo
1e270 72 0a 20 20 2a 2a 20 69 50 74 72 50 61 67 65 2e r. ** iPtrPage.
1e280 0a 20 20 2a 2f 0a 20 20 69 66 28 20 65 54 79 70 . */. if( eTyp
1e290 65 21 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 e!=PTRMAP_ROOTPA
1e2a0 47 45 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 62 GE ){. rc = b
1e2b0 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c treeGetPage(pBt,
1e2c0 20 69 50 74 72 50 61 67 65 2c 20 26 70 50 74 72 iPtrPage, &pPtr
1e2d0 50 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 69 66 Page, 0);. if
1e2e0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1e2f0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1e300 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 rc;. }. rc
1e310 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 = sqlite3PagerW
1e320 72 69 74 65 28 70 50 74 72 50 61 67 65 2d 3e 70 rite(pPtrPage->p
1e330 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 DbPage);. if(
1e340 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
1e350 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 {. releaseP
1e360 61 67 65 28 70 50 74 72 50 61 67 65 29 3b 0a 20 age(pPtrPage);.
1e370 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
1e380 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 6d }. rc = m
1e390 6f 64 69 66 79 50 61 67 65 50 6f 69 6e 74 65 72 odifyPagePointer
1e3a0 28 70 50 74 72 50 61 67 65 2c 20 69 44 62 50 61 (pPtrPage, iDbPa
1e3b0 67 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 65 ge, iFreePage, e
1e3c0 54 79 70 65 29 3b 0a 20 20 20 20 72 65 6c 65 61 Type);. relea
1e3d0 73 65 50 61 67 65 28 70 50 74 72 50 61 67 65 29 sePage(pPtrPage)
1e3e0 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
1e3f0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1e400 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 ptrmapPut(pBt,
1e410 69 46 72 65 65 50 61 67 65 2c 20 65 54 79 70 65 iFreePage, eType
1e420 2c 20 69 50 74 72 50 61 67 65 2c 20 26 72 63 29 , iPtrPage, &rc)
1e430 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
1e440 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 46 turn rc;.}../* F
1e450 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 orward declarati
1e460 6f 6e 20 72 65 71 75 69 72 65 64 20 62 79 20 69 on required by i
1e470 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 29 2e ncrVacuumStep().
1e480 20 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 */.static int a
1e490 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
1e4a0 28 42 74 53 68 61 72 65 64 20 2a 2c 20 4d 65 6d (BtShared *, Mem
1e4b0 50 61 67 65 20 2a 2a 2c 20 50 67 6e 6f 20 2a 2c Page **, Pgno *,
1e4c0 20 50 67 6e 6f 2c 20 75 38 29 3b 0a 0a 2f 2a 0a Pgno, u8);../*.
1e4d0 2a 2a 20 50 65 72 66 6f 72 6d 20 61 20 73 69 6e ** Perform a sin
1e4e0 67 6c 65 20 73 74 65 70 20 6f 66 20 61 6e 20 69 gle step of an i
1e4f0 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 75 ncremental-vacuu
1e500 6d 2e 20 49 66 20 73 75 63 63 65 73 73 66 75 6c m. If successful
1e510 2c 20 72 65 74 75 72 6e 0a 2a 2a 20 53 51 4c 49 , return.** SQLI
1e520 54 45 5f 4f 4b 2e 20 49 66 20 74 68 65 72 65 20 TE_OK. If there
1e530 69 73 20 6e 6f 20 77 6f 72 6b 20 74 6f 20 64 6f is no work to do
1e540 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 (and therefore
1e550 6e 6f 20 70 6f 69 6e 74 20 69 6e 20 0a 2a 2a 20 no point in .**
1e560 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 6e calling this fun
1e570 63 74 69 6f 6e 20 61 67 61 69 6e 29 2c 20 72 65 ction again), re
1e580 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 turn SQLITE_DONE
1e590 2e 20 4f 72 2c 20 69 66 20 61 6e 20 65 72 72 6f . Or, if an erro
1e5a0 72 20 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 72 65 r .** occurs, re
1e5b0 74 75 72 6e 20 73 6f 6d 65 20 6f 74 68 65 72 20 turn some other
1e5c0 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a error code..**.*
1e5d0 2a 20 4d 6f 72 65 20 73 70 65 63 69 66 69 63 61 * More specifica
1e5e0 6c 6c 79 2c 20 74 68 69 73 20 66 75 6e 63 74 69 lly, this functi
1e5f0 6f 6e 20 61 74 74 65 6d 70 74 73 20 74 6f 20 72 on attempts to r
1e600 65 2d 6f 72 67 61 6e 69 7a 65 20 74 68 65 20 64 e-organize the d
1e610 61 74 61 62 61 73 65 20 73 6f 20 0a 2a 2a 20 74 atabase so .** t
1e620 68 61 74 20 74 68 65 20 6c 61 73 74 20 70 61 67 hat the last pag
1e630 65 20 6f 66 20 74 68 65 20 66 69 6c 65 20 63 75 e of the file cu
1e640 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 69 rrently in use i
1e650 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 69 6e 20 75 s no longer in u
1e660 73 65 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61 6d 65 se..**.** Parame
1e670 74 65 72 20 6e 46 69 6e 20 69 73 20 74 68 65 20 ter nFin is the
1e680 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 number of pages
1e690 74 68 61 74 20 74 68 69 73 20 64 61 74 61 62 61 that this databa
1e6a0 73 65 20 77 6f 75 6c 64 20 63 6f 6e 74 61 69 6e se would contain
1e6b0 0a 2a 2a 20 77 65 72 65 20 74 68 69 73 20 66 75 .** were this fu
1e6c0 6e 63 74 69 6f 6e 20 63 61 6c 6c 65 64 20 75 6e nction called un
1e6d0 74 69 6c 20 69 74 20 72 65 74 75 72 6e 73 20 53 til it returns S
1e6e0 51 4c 49 54 45 5f 44 4f 4e 45 2e 0a 2a 2a 0a 2a QLITE_DONE..**.*
1e6f0 2a 20 49 66 20 74 68 65 20 62 43 6f 6d 6d 69 74 * If the bCommit
1e700 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f parameter is no
1e710 6e 2d 7a 65 72 6f 2c 20 74 68 69 73 20 66 75 6e n-zero, this fun
1e720 63 74 69 6f 6e 20 61 73 73 75 6d 65 73 20 74 68 ction assumes th
1e730 61 74 20 74 68 65 20 0a 2a 2a 20 63 61 6c 6c 65 at the .** calle
1e740 72 20 77 69 6c 6c 20 6b 65 65 70 20 63 61 6c 6c r will keep call
1e750 69 6e 67 20 69 6e 63 72 56 61 63 75 75 6d 53 74 ing incrVacuumSt
1e760 65 70 28 29 20 75 6e 74 69 6c 20 69 74 20 72 65 ep() until it re
1e770 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e turns SQLITE_DON
1e780 45 20 0a 2a 2a 20 6f 72 20 61 6e 20 65 72 72 6f E .** or an erro
1e790 72 2e 20 62 43 6f 6d 6d 69 74 20 69 73 20 70 61 r. bCommit is pa
1e7a0 73 73 65 64 20 74 72 75 65 20 66 6f 72 20 61 6e ssed true for an
1e7b0 20 61 75 74 6f 2d 76 61 63 75 75 6d 2d 6f 6e 2d auto-vacuum-on-
1e7c0 63 6f 6d 6d 69 74 20 0a 2a 2a 20 6f 70 65 72 61 commit .** opera
1e7d0 74 69 6f 6e 2c 20 6f 72 20 66 61 6c 73 65 20 66 tion, or false f
1e7e0 6f 72 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 or an incrementa
1e7f0 6c 20 76 61 63 75 75 6d 2e 0a 2a 2f 0a 73 74 61 l vacuum..*/.sta
1e800 74 69 63 20 69 6e 74 20 69 6e 63 72 56 61 63 75 tic int incrVacu
1e810 75 6d 53 74 65 70 28 42 74 53 68 61 72 65 64 20 umStep(BtShared
1e820 2a 70 42 74 2c 20 50 67 6e 6f 20 6e 46 69 6e 2c *pBt, Pgno nFin,
1e830 20 50 67 6e 6f 20 69 4c 61 73 74 50 67 2c 20 69 Pgno iLastPg, i
1e840 6e 74 20 62 43 6f 6d 6d 69 74 29 7b 0a 20 20 50 nt bCommit){. P
1e850 67 6e 6f 20 6e 46 72 65 65 4c 69 73 74 3b 20 20 gno nFreeList;
1e860 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1e870 65 72 20 6f 66 20 70 61 67 65 73 20 73 74 69 6c er of pages stil
1e880 6c 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 l on the free-li
1e890 73 74 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 0a st */. int rc;.
1e8a0 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
1e8b0 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 e3_mutex_held(pB
1e8c0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
1e8d0 73 73 65 72 74 28 20 69 4c 61 73 74 50 67 3e 6e ssert( iLastPg>n
1e8e0 46 69 6e 20 29 3b 0a 0a 20 20 69 66 28 20 21 50 Fin );.. if( !P
1e8f0 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 TRMAP_ISPAGE(pBt
1e900 2c 20 69 4c 61 73 74 50 67 29 20 26 26 20 69 4c , iLastPg) && iL
1e910 61 73 74 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42 astPg!=PENDING_B
1e920 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b YTE_PAGE(pBt) ){
1e930 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a 20 . u8 eType;.
1e940 20 20 20 50 67 6e 6f 20 69 50 74 72 50 61 67 65 Pgno iPtrPage
1e950 3b 0a 0a 20 20 20 20 6e 46 72 65 65 4c 69 73 74 ;.. nFreeList
1e960 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 = get4byte(&pBt
1e970 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b ->pPage1->aData[
1e980 33 36 5d 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 36]);. if( nF
1e990 72 65 65 4c 69 73 74 3d 3d 30 20 29 7b 0a 20 20 reeList==0 ){.
1e9a0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1e9b0 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 0a 20 E_DONE;. }..
1e9c0 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 rc = ptrmapGe
1e9d0 74 28 70 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 t(pBt, iLastPg,
1e9e0 26 65 54 79 70 65 2c 20 26 69 50 74 72 50 61 67 &eType, &iPtrPag
1e9f0 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
1ea00 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1ea10 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1ea20 20 20 7d 0a 20 20 20 20 69 66 28 20 65 54 79 70 }. if( eTyp
1ea30 65 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 e==PTRMAP_ROOTPA
1ea40 47 45 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 GE ){. retu
1ea50 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
1ea60 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 T_BKPT;. }..
1ea70 20 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 if( eType==PT
1ea80 52 4d 41 50 5f 46 52 45 45 50 41 47 45 20 29 7b RMAP_FREEPAGE ){
1ea90 0a 20 20 20 20 20 20 69 66 28 20 62 43 6f 6d 6d . if( bComm
1eaa0 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 it==0 ){.
1eab0 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 70 /* Remove the p
1eac0 61 67 65 20 66 72 6f 6d 20 74 68 65 20 66 69 6c age from the fil
1ead0 65 73 20 66 72 65 65 2d 6c 69 73 74 2e 20 54 68 es free-list. Th
1eae0 69 73 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 is is not requir
1eaf0 65 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 66 ed. ** if
1eb00 20 62 43 6f 6d 6d 69 74 20 69 73 20 6e 6f 6e 2d bCommit is non-
1eb10 7a 65 72 6f 2e 20 49 6e 20 74 68 61 74 20 63 61 zero. In that ca
1eb20 73 65 2c 20 74 68 65 20 66 72 65 65 2d 6c 69 73 se, the free-lis
1eb30 74 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 20 20 t will be.
1eb40 20 20 2a 2a 20 74 72 75 6e 63 61 74 65 64 20 74 ** truncated t
1eb50 6f 20 7a 65 72 6f 20 61 66 74 65 72 20 74 68 69 o zero after thi
1eb60 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
1eb70 6e 73 2c 20 73 6f 20 69 74 20 64 6f 65 73 6e 27 ns, so it doesn'
1eb80 74 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d 61 t . ** ma
1eb90 74 74 65 72 20 69 66 20 69 74 20 73 74 69 6c 6c tter if it still
1eba0 20 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 67 contains some g
1ebb0 61 72 62 61 67 65 20 65 6e 74 72 69 65 73 2e 0a arbage entries..
1ebc0 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 */.
1ebd0 20 20 20 50 67 6e 6f 20 69 46 72 65 65 50 67 3b Pgno iFreePg;
1ebe0 0a 20 20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 . MemPage
1ebf0 20 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 20 20 *pFreePg;.
1ec00 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 rc = allocate
1ec10 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 BtreePage(pBt, &
1ec20 70 46 72 65 65 50 67 2c 20 26 69 46 72 65 65 50 pFreePg, &iFreeP
1ec30 67 2c 20 69 4c 61 73 74 50 67 2c 20 42 54 41 4c g, iLastPg, BTAL
1ec40 4c 4f 43 5f 45 58 41 43 54 29 3b 0a 20 20 20 20 LOC_EXACT);.
1ec50 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1ec60 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1ec70 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
1ec80 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
1ec90 61 73 73 65 72 74 28 20 69 46 72 65 65 50 67 3d assert( iFreePg=
1eca0 3d 69 4c 61 73 74 50 67 20 29 3b 0a 20 20 20 20 =iLastPg );.
1ecb0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
1ecc0 70 46 72 65 65 50 67 29 3b 0a 20 20 20 20 20 20 pFreePg);.
1ecd0 7d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 }. } else {.
1ece0 20 20 20 20 20 50 67 6e 6f 20 69 46 72 65 65 50 Pgno iFreeP
1ecf0 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f g; /
1ed00 2a 20 49 6e 64 65 78 20 6f 66 20 66 72 65 65 20 * Index of free
1ed10 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 70 4c 61 page to move pLa
1ed20 73 74 50 67 20 74 6f 20 2a 2f 0a 20 20 20 20 20 stPg to */.
1ed30 20 4d 65 6d 50 61 67 65 20 2a 70 4c 61 73 74 50 MemPage *pLastP
1ed40 67 3b 0a 20 20 20 20 20 20 75 38 20 65 4d 6f 64 g;. u8 eMod
1ed50 65 20 3d 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 3b e = BTALLOC_ANY;
1ed60 20 20 20 2f 2a 20 4d 6f 64 65 20 70 61 72 61 6d /* Mode param
1ed70 65 74 65 72 20 66 6f 72 20 61 6c 6c 6f 63 61 74 eter for allocat
1ed80 65 42 74 72 65 65 50 61 67 65 28 29 20 2a 2f 0a eBtreePage() */.
1ed90 20 20 20 20 20 20 50 67 6e 6f 20 69 4e 65 61 72 Pgno iNear
1eda0 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
1edb0 2f 2a 20 6e 65 61 72 62 79 20 70 61 72 61 6d 65 /* nearby parame
1edc0 74 65 72 20 66 6f 72 20 61 6c 6c 6f 63 61 74 65 ter for allocate
1edd0 42 74 72 65 65 50 61 67 65 28 29 20 2a 2f 0a 0a BtreePage() */..
1ede0 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 rc = btree
1edf0 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 4c 61 GetPage(pBt, iLa
1ee00 73 74 50 67 2c 20 26 70 4c 61 73 74 50 67 2c 20 stPg, &pLastPg,
1ee10 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 0);. if( rc
1ee20 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
1ee30 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
1ee40 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
1ee50 20 2f 2a 20 49 66 20 62 43 6f 6d 6d 69 74 20 69 /* If bCommit i
1ee60 73 20 7a 65 72 6f 2c 20 74 68 69 73 20 6c 6f 6f s zero, this loo
1ee70 70 20 72 75 6e 73 20 65 78 61 63 74 6c 79 20 6f p runs exactly o
1ee80 6e 63 65 20 61 6e 64 20 70 61 67 65 20 70 4c 61 nce and page pLa
1ee90 73 74 50 67 0a 20 20 20 20 20 20 2a 2a 20 69 73 stPg. ** is
1eea0 20 73 77 61 70 70 65 64 20 77 69 74 68 20 74 68 swapped with th
1eeb0 65 20 66 69 72 73 74 20 66 72 65 65 20 70 61 67 e first free pag
1eec0 65 20 70 75 6c 6c 65 64 20 6f 66 66 20 74 68 65 e pulled off the
1eed0 20 66 72 65 65 20 6c 69 73 74 2e 0a 20 20 20 20 free list..
1eee0 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4f 6e **. ** On
1eef0 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c the other hand,
1ef00 20 69 66 20 62 43 6f 6d 6d 69 74 20 69 73 20 67 if bCommit is g
1ef10 72 65 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f reater than zero
1ef20 2c 20 74 68 65 6e 20 6b 65 65 70 0a 20 20 20 20 , then keep.
1ef30 20 20 2a 2a 20 6c 6f 6f 70 69 6e 67 20 75 6e 74 ** looping unt
1ef40 69 6c 20 61 20 66 72 65 65 2d 70 61 67 65 20 6c il a free-page l
1ef50 6f 63 61 74 65 64 20 77 69 74 68 69 6e 20 74 68 ocated within th
1ef60 65 20 66 69 72 73 74 20 6e 46 69 6e 20 70 61 67 e first nFin pag
1ef70 65 73 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 74 es. ** of t
1ef80 68 65 20 66 69 6c 65 20 69 73 20 66 6f 75 6e 64 he file is found
1ef90 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
1efa0 20 69 66 28 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 if( bCommit==0
1efb0 29 7b 0a 20 20 20 20 20 20 20 20 65 4d 6f 64 65 ){. eMode
1efc0 20 3d 20 42 54 41 4c 4c 4f 43 5f 4c 45 3b 0a 20 = BTALLOC_LE;.
1efd0 20 20 20 20 20 20 20 69 4e 65 61 72 20 3d 20 6e iNear = n
1efe0 46 69 6e 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 Fin;. }.
1eff0 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 20 20 do {.
1f000 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 50 67 MemPage *pFreePg
1f010 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 61 ;. rc = a
1f020 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 llocateBtreePage
1f030 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 2c 20 (pBt, &pFreePg,
1f040 26 69 46 72 65 65 50 67 2c 20 69 4e 65 61 72 2c &iFreePg, iNear,
1f050 20 65 4d 6f 64 65 29 3b 0a 20 20 20 20 20 20 20 eMode);.
1f060 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
1f070 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
1f080 72 65 6c 65 61 73 65 50 61 67 65 28 70 4c 61 73 releasePage(pLas
1f090 74 50 67 29 3b 0a 20 20 20 20 20 20 20 20 20 20 tPg);.
1f0a0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
1f0b0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 72 65 6c }. rel
1f0c0 65 61 73 65 50 61 67 65 28 70 46 72 65 65 50 67 easePage(pFreePg
1f0d0 29 3b 0a 20 20 20 20 20 20 7d 77 68 69 6c 65 28 );. }while(
1f0e0 20 62 43 6f 6d 6d 69 74 20 26 26 20 69 46 72 65 bCommit && iFre
1f0f0 65 50 67 3e 6e 46 69 6e 20 29 3b 0a 20 20 20 20 ePg>nFin );.
1f100 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 50 assert( iFreeP
1f110 67 3c 69 4c 61 73 74 50 67 20 29 3b 0a 20 20 20 g<iLastPg );.
1f120 20 20 20 0a 20 20 20 20 20 20 72 63 20 3d 20 72 . rc = r
1f130 65 6c 6f 63 61 74 65 50 61 67 65 28 70 42 74 2c elocatePage(pBt,
1f140 20 70 4c 61 73 74 50 67 2c 20 65 54 79 70 65 2c pLastPg, eType,
1f150 20 69 50 74 72 50 61 67 65 2c 20 69 46 72 65 65 iPtrPage, iFree
1f160 50 67 2c 20 62 43 6f 6d 6d 69 74 29 3b 0a 20 20 Pg, bCommit);.
1f170 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
1f180 70 4c 61 73 74 50 67 29 3b 0a 20 20 20 20 20 20 pLastPg);.
1f190 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
1f1a0 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74 K ){. ret
1f1b0 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a urn rc;. }.
1f1c0 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 }. }.. if(
1f1d0 20 62 43 6f 6d 6d 69 74 3d 3d 30 20 29 7b 0a 20 bCommit==0 ){.
1f1e0 20 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 69 4c do {. iL
1f1f0 61 73 74 50 67 2d 2d 3b 0a 20 20 20 20 7d 77 68 astPg--;. }wh
1f200 69 6c 65 28 20 69 4c 61 73 74 50 67 3d 3d 50 45 ile( iLastPg==PE
1f210 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
1f220 70 42 74 29 20 7c 7c 20 50 54 52 4d 41 50 5f 49 pBt) || PTRMAP_I
1f230 53 50 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 SPAGE(pBt, iLast
1f240 50 67 29 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e Pg) );. pBt->
1f250 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 31 3b bDoTruncate = 1;
1f260 0a 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 . pBt->nPage
1f270 3d 20 69 4c 61 73 74 50 67 3b 0a 20 20 7d 0a 20 = iLastPg;. }.
1f280 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1f290 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 K;.}../*.** The
1f2a0 64 61 74 61 62 61 73 65 20 6f 70 65 6e 65 64 20 database opened
1f2b0 62 79 20 74 68 65 20 66 69 72 73 74 20 61 72 67 by the first arg
1f2c0 75 6d 65 6e 74 20 69 73 20 61 6e 20 61 75 74 6f ument is an auto
1f2d0 2d 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 -vacuum database
1f2e0 0a 2a 2a 20 6e 4f 72 69 67 20 70 61 67 65 73 20 .** nOrig pages
1f2f0 69 6e 20 73 69 7a 65 20 63 6f 6e 74 61 69 6e 69 in size containi
1f300 6e 67 20 6e 46 72 65 65 20 66 72 65 65 20 70 61 ng nFree free pa
1f310 67 65 73 2e 20 52 65 74 75 72 6e 20 74 68 65 20 ges. Return the
1f320 65 78 70 65 63 74 65 64 20 0a 2a 2a 20 73 69 7a expected .** siz
1f330 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
1f340 65 20 69 6e 20 70 61 67 65 73 20 66 6f 6c 6c 6f e in pages follo
1f350 77 69 6e 67 20 61 6e 20 61 75 74 6f 2d 76 61 63 wing an auto-vac
1f360 75 75 6d 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 2a uum operation..*
1f370 2f 0a 73 74 61 74 69 63 20 50 67 6e 6f 20 66 69 /.static Pgno fi
1f380 6e 61 6c 44 62 53 69 7a 65 28 42 74 53 68 61 72 nalDbSize(BtShar
1f390 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6e 4f ed *pBt, Pgno nO
1f3a0 72 69 67 2c 20 50 67 6e 6f 20 6e 46 72 65 65 29 rig, Pgno nFree)
1f3b0 7b 0a 20 20 69 6e 74 20 6e 45 6e 74 72 79 3b 20 {. int nEntry;
1f3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f3d0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1f3e0 20 65 6e 74 72 69 65 73 20 6f 6e 20 6f 6e 65 20 entries on one
1f3f0 70 74 72 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 ptrmap page */.
1f400 20 50 67 6e 6f 20 6e 50 74 72 6d 61 70 3b 20 20 Pgno nPtrmap;
1f410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f420 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 50 74 /* Number of Pt
1f430 72 4d 61 70 20 70 61 67 65 73 20 74 6f 20 62 65 rMap pages to be
1f440 20 66 72 65 65 64 20 2a 2f 0a 20 20 50 67 6e 6f freed */. Pgno
1f450 20 6e 46 69 6e 3b 20 20 20 20 20 20 20 20 20 20 nFin;
1f460 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
1f470 65 74 75 72 6e 20 76 61 6c 75 65 20 2a 2f 0a 0a eturn value */..
1f480 20 20 6e 45 6e 74 72 79 20 3d 20 70 42 74 2d 3e nEntry = pBt->
1f490 75 73 61 62 6c 65 53 69 7a 65 2f 35 3b 0a 20 20 usableSize/5;.
1f4a0 6e 50 74 72 6d 61 70 20 3d 20 28 6e 46 72 65 65 nPtrmap = (nFree
1f4b0 2d 6e 4f 72 69 67 2b 50 54 52 4d 41 50 5f 50 41 -nOrig+PTRMAP_PA
1f4c0 47 45 4e 4f 28 70 42 74 2c 20 6e 4f 72 69 67 29 GENO(pBt, nOrig)
1f4d0 2b 6e 45 6e 74 72 79 29 2f 6e 45 6e 74 72 79 3b +nEntry)/nEntry;
1f4e0 0a 20 20 6e 46 69 6e 20 3d 20 6e 4f 72 69 67 20 . nFin = nOrig
1f4f0 2d 20 6e 46 72 65 65 20 2d 20 6e 50 74 72 6d 61 - nFree - nPtrma
1f500 70 3b 0a 20 20 69 66 28 20 6e 4f 72 69 67 3e 50 p;. if( nOrig>P
1f510 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 ENDING_BYTE_PAGE
1f520 28 70 42 74 29 20 26 26 20 6e 46 69 6e 3c 50 45 (pBt) && nFin<PE
1f530 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 NDING_BYTE_PAGE(
1f540 70 42 74 29 20 29 7b 0a 20 20 20 20 6e 46 69 6e pBt) ){. nFin
1f550 2d 2d 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65 28 --;. }. while(
1f560 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 PTRMAP_ISPAGE(p
1f570 42 74 2c 20 6e 46 69 6e 29 20 7c 7c 20 6e 46 69 Bt, nFin) || nFi
1f580 6e 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f n==PENDING_BYTE_
1f590 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
1f5a0 20 6e 46 69 6e 2d 2d 3b 0a 20 20 7d 0a 0a 20 20 nFin--;. }..
1f5b0 72 65 74 75 72 6e 20 6e 46 69 6e 3b 0a 7d 0a 0a return nFin;.}..
1f5c0 2f 2a 0a 2a 2a 20 41 20 77 72 69 74 65 2d 74 72 /*.** A write-tr
1f5d0 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 ansaction must b
1f5e0 65 20 6f 70 65 6e 65 64 20 62 65 66 6f 72 65 20 e opened before
1f5f0 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 6e calling this fun
1f600 63 74 69 6f 6e 2e 0a 2a 2a 20 49 74 20 70 65 72 ction..** It per
1f610 66 6f 72 6d 73 20 61 20 73 69 6e 67 6c 65 20 75 forms a single u
1f620 6e 69 74 20 6f 66 20 77 6f 72 6b 20 74 6f 77 61 nit of work towa
1f630 72 64 73 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 rds an increment
1f640 61 6c 20 76 61 63 75 75 6d 2e 0a 2a 2a 0a 2a 2a al vacuum..**.**
1f650 20 49 66 20 74 68 65 20 69 6e 63 72 65 6d 65 6e If the incremen
1f660 74 61 6c 20 76 61 63 75 75 6d 20 69 73 20 66 69 tal vacuum is fi
1f670 6e 69 73 68 65 64 20 61 66 74 65 72 20 74 68 69 nished after thi
1f680 73 20 66 75 6e 63 74 69 6f 6e 20 68 61 73 20 72 s function has r
1f690 75 6e 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 44 4f un,.** SQLITE_DO
1f6a0 4e 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 NE is returned.
1f6b0 49 66 20 69 74 20 69 73 20 6e 6f 74 20 66 69 6e If it is not fin
1f6c0 69 73 68 65 64 2c 20 62 75 74 20 6e 6f 20 65 72 ished, but no er
1f6d0 72 6f 72 20 6f 63 63 75 72 72 65 64 2c 0a 2a 2a ror occurred,.**
1f6e0 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
1f6f0 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 turned. Otherwis
1f700 65 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f e an SQLite erro
1f710 72 20 63 6f 64 65 2e 20 0a 2a 2f 0a 69 6e 74 20 r code. .*/.int
1f720 73 71 6c 69 74 65 33 42 74 72 65 65 49 6e 63 72 sqlite3BtreeIncr
1f730 56 61 63 75 75 6d 28 42 74 72 65 65 20 2a 70 29 Vacuum(Btree *p)
1f740 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 {. int rc;. Bt
1f750 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
1f760 3e 70 42 74 3b 0a 0a 20 20 73 71 6c 69 74 65 33 >pBt;.. sqlite3
1f770 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
1f780 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 69 6e assert( pBt->in
1f790 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 Transaction==TRA
1f7a0 4e 53 5f 57 52 49 54 45 20 26 26 20 70 2d 3e 69 NS_WRITE && p->i
1f7b0 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 nTrans==TRANS_WR
1f7c0 49 54 45 20 29 3b 0a 20 20 69 66 28 20 21 70 42 ITE );. if( !pB
1f7d0 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b t->autoVacuum ){
1f7e0 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
1f7f0 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65 7b 0a _DONE;. }else{.
1f800 20 20 20 20 50 67 6e 6f 20 6e 4f 72 69 67 20 3d Pgno nOrig =
1f810 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 btreePagecount(
1f820 70 42 74 29 3b 0a 20 20 20 20 50 67 6e 6f 20 6e pBt);. Pgno n
1f830 46 72 65 65 20 3d 20 67 65 74 34 62 79 74 65 28 Free = get4byte(
1f840 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 &pBt->pPage1->aD
1f850 61 74 61 5b 33 36 5d 29 3b 0a 20 20 20 20 50 67 ata[36]);. Pg
1f860 6e 6f 20 6e 46 69 6e 20 3d 20 66 69 6e 61 6c 44 no nFin = finalD
1f870 62 53 69 7a 65 28 70 42 74 2c 20 6e 4f 72 69 67 bSize(pBt, nOrig
1f880 2c 20 6e 46 72 65 65 29 3b 0a 0a 20 20 20 20 69 , nFree);.. i
1f890 66 28 20 6e 4f 72 69 67 3c 6e 46 69 6e 20 29 7b f( nOrig<nFin ){
1f8a0 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
1f8b0 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
1f8c0 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6e . }else if( n
1f8d0 46 72 65 65 3e 30 20 29 7b 0a 20 20 20 20 20 20 Free>0 ){.
1f8e0 72 63 20 3d 20 73 61 76 65 41 6c 6c 43 75 72 73 rc = saveAllCurs
1f8f0 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a ors(pBt, 0, 0);.
1f900 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
1f910 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1f920 20 20 20 69 6e 76 61 6c 69 64 61 74 65 41 6c 6c invalidateAll
1f930 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 70 42 OverflowCache(pB
1f940 74 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d t);. rc =
1f950 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 28 incrVacuumStep(
1f960 70 42 74 2c 20 6e 46 69 6e 2c 20 6e 4f 72 69 67 pBt, nFin, nOrig
1f970 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 , 0);. }.
1f980 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1f990 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1f9a0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
1f9b0 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 erWrite(pBt->pPa
1f9c0 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
1f9d0 20 20 20 20 20 20 20 70 75 74 34 62 79 74 65 28 put4byte(
1f9e0 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 &pBt->pPage1->aD
1f9f0 61 74 61 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e 50 ata[28], pBt->nP
1fa00 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 age);. }.
1fa10 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
1fa20 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b c = SQLITE_DONE;
1fa30 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c . }. }. sql
1fa40 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 ite3BtreeLeave(p
1fa50 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
1fa60 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
1fa70 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 utine is called
1fa80 70 72 69 6f 72 20 74 6f 20 73 71 6c 69 74 65 33 prior to sqlite3
1fa90 50 61 67 65 72 43 6f 6d 6d 69 74 20 77 68 65 6e PagerCommit when
1faa0 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a a transaction.*
1fab0 2a 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 66 * is committed f
1fac0 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 75 or an auto-vacuu
1fad0 6d 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a 2a m database..**.*
1fae0 2a 20 49 66 20 53 51 4c 49 54 45 5f 4f 4b 20 69 * If SQLITE_OK i
1faf0 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 6e s returned, then
1fb00 20 2a 70 6e 54 72 75 6e 63 20 69 73 20 73 65 74 *pnTrunc is set
1fb10 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f to the number o
1fb20 66 20 70 61 67 65 73 0a 2a 2a 20 74 68 65 20 64 f pages.** the d
1fb30 61 74 61 62 61 73 65 20 66 69 6c 65 20 73 68 6f atabase file sho
1fb40 75 6c 64 20 62 65 20 74 72 75 6e 63 61 74 65 64 uld be truncated
1fb50 20 74 6f 20 64 75 72 69 6e 67 20 74 68 65 20 63 to during the c
1fb60 6f 6d 6d 69 74 20 70 72 6f 63 65 73 73 2e 20 0a ommit process. .
1fb70 2a 2a 20 69 2e 65 2e 20 74 68 65 20 64 61 74 61 ** i.e. the data
1fb80 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 72 65 base has been re
1fb90 6f 72 67 61 6e 69 7a 65 64 20 73 6f 20 74 68 61 organized so tha
1fba0 74 20 6f 6e 6c 79 20 74 68 65 20 66 69 72 73 74 t only the first
1fbb0 20 2a 70 6e 54 72 75 6e 63 0a 2a 2a 20 70 61 67 *pnTrunc.** pag
1fbc0 65 73 20 61 72 65 20 69 6e 20 75 73 65 2e 0a 2a es are in use..*
1fbd0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 75 74 /.static int aut
1fbe0 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 42 74 oVacuumCommit(Bt
1fbf0 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 Shared *pBt){.
1fc00 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
1fc10 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 OK;. Pager *pPa
1fc20 67 65 72 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 ger = pBt->pPage
1fc30 72 3b 0a 20 20 56 56 41 5f 4f 4e 4c 59 28 20 69 r;. VVA_ONLY( i
1fc40 6e 74 20 6e 52 65 66 20 3d 20 73 71 6c 69 74 65 nt nRef = sqlite
1fc50 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 70 3PagerRefcount(p
1fc60 50 61 67 65 72 29 3b 20 29 0a 0a 20 20 61 73 73 Pager); ).. ass
1fc70 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
1fc80 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
1fc90 65 78 29 20 29 3b 0a 20 20 69 6e 76 61 6c 69 64 ex) );. invalid
1fca0 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 61 ateAllOverflowCa
1fcb0 63 68 65 28 70 42 74 29 3b 0a 20 20 61 73 73 65 che(pBt);. asse
1fcc0 72 74 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 rt(pBt->autoVacu
1fcd0 75 6d 29 3b 0a 20 20 69 66 28 20 21 70 42 74 2d um);. if( !pBt-
1fce0 3e 69 6e 63 72 56 61 63 75 75 6d 20 29 7b 0a 20 >incrVacuum ){.
1fcf0 20 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 20 Pgno nFin;
1fd00 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1fd10 6f 66 20 70 61 67 65 73 20 69 6e 20 64 61 74 61 of pages in data
1fd20 62 61 73 65 20 61 66 74 65 72 20 61 75 74 6f 76 base after autov
1fd30 61 63 75 75 6d 69 6e 67 20 2a 2f 0a 20 20 20 20 acuuming */.
1fd40 50 67 6e 6f 20 6e 46 72 65 65 3b 20 20 20 20 20 Pgno nFree;
1fd50 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1fd60 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 pages on the fre
1fd70 65 6c 69 73 74 20 69 6e 69 74 69 61 6c 6c 79 20 elist initially
1fd80 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 69 46 72 65 */. Pgno iFre
1fd90 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 e; /* The
1fda0 20 6e 65 78 74 20 70 61 67 65 20 74 6f 20 62 65 next page to be
1fdb0 20 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 50 67 freed */. Pg
1fdc0 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 20 20 20 20 no nOrig;
1fdd0 20 2f 2a 20 44 61 74 61 62 61 73 65 20 73 69 7a /* Database siz
1fde0 65 20 62 65 66 6f 72 65 20 66 72 65 65 69 6e 67 e before freeing
1fdf0 20 2a 2f 0a 0a 20 20 20 20 6e 4f 72 69 67 20 3d */.. nOrig =
1fe00 20 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 btreePagecount(
1fe10 70 42 74 29 3b 0a 20 20 20 20 69 66 28 20 50 54 pBt);. if( PT
1fe20 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c RMAP_ISPAGE(pBt,
1fe30 20 6e 4f 72 69 67 29 20 7c 7c 20 6e 4f 72 69 67 nOrig) || nOrig
1fe40 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 ==PENDING_BYTE_P
1fe50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 20 AGE(pBt) ){.
1fe60 20 20 2f 2a 20 49 74 20 69 73 20 6e 6f 74 20 70 /* It is not p
1fe70 6f 73 73 69 62 6c 65 20 74 6f 20 63 72 65 61 74 ossible to creat
1fe80 65 20 61 20 64 61 74 61 62 61 73 65 20 66 6f 72 e a database for
1fe90 20 77 68 69 63 68 20 74 68 65 20 66 69 6e 61 6c which the final
1fea0 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 69 page. ** i
1feb0 73 20 65 69 74 68 65 72 20 61 20 70 6f 69 6e 74 s either a point
1fec0 65 72 2d 6d 61 70 20 70 61 67 65 20 6f 72 20 74 er-map page or t
1fed0 68 65 20 70 65 6e 64 69 6e 67 2d 62 79 74 65 20 he pending-byte
1fee0 70 61 67 65 2e 20 49 66 20 6f 6e 65 0a 20 20 20 page. If one.
1fef0 20 20 20 2a 2a 20 69 73 20 65 6e 63 6f 75 6e 74 ** is encount
1ff00 65 72 65 64 2c 20 74 68 69 73 20 69 6e 64 69 63 ered, this indic
1ff10 61 74 65 73 20 63 6f 72 72 75 70 74 69 6f 6e 2e ates corruption.
1ff20 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
1ff30 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
1ff40 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
1ff50 7d 0a 0a 20 20 20 20 6e 46 72 65 65 20 3d 20 67 }.. nFree = g
1ff60 65 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 et4byte(&pBt->pP
1ff70 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 age1->aData[36])
1ff80 3b 0a 20 20 20 20 6e 46 69 6e 20 3d 20 66 69 6e ;. nFin = fin
1ff90 61 6c 44 62 53 69 7a 65 28 70 42 74 2c 20 6e 4f alDbSize(pBt, nO
1ffa0 72 69 67 2c 20 6e 46 72 65 65 29 3b 0a 20 20 20 rig, nFree);.
1ffb0 20 69 66 28 20 6e 46 69 6e 3e 6e 4f 72 69 67 20 if( nFin>nOrig
1ffc0 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
1ffd0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
1ffe0 20 20 69 66 28 20 6e 46 69 6e 3c 6e 4f 72 69 67 if( nFin<nOrig
1fff0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
20000 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 aveAllCursors(pB
20010 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a t, 0, 0);. }.
20020 20 20 20 20 66 6f 72 28 69 46 72 65 65 3d 6e 4f for(iFree=nO
20030 72 69 67 3b 20 69 46 72 65 65 3e 6e 46 69 6e 20 rig; iFree>nFin
20040 26 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b && rc==SQLITE_OK
20050 3b 20 69 46 72 65 65 2d 2d 29 7b 0a 20 20 20 20 ; iFree--){.
20060 20 20 72 63 20 3d 20 69 6e 63 72 56 61 63 75 75 rc = incrVacuu
20070 6d 53 74 65 70 28 70 42 74 2c 20 6e 46 69 6e 2c mStep(pBt, nFin,
20080 20 69 46 72 65 65 2c 20 31 29 3b 0a 20 20 20 20 iFree, 1);.
20090 7d 0a 20 20 20 20 69 66 28 20 28 72 63 3d 3d 53 }. if( (rc==S
200a0 51 4c 49 54 45 5f 44 4f 4e 45 20 7c 7c 20 72 63 QLITE_DONE || rc
200b0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 26 26 20 ==SQLITE_OK) &&
200c0 6e 46 72 65 65 3e 30 20 29 7b 0a 20 20 20 20 20 nFree>0 ){.
200d0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
200e0 65 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 erWrite(pBt->pPa
200f0 67 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 ge1->pDbPage);.
20100 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
20110 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 Bt->pPage1->aDat
20120 61 5b 33 32 5d 2c 20 30 29 3b 0a 20 20 20 20 20 a[32], 0);.
20130 20 70 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e put4byte(&pBt->
20140 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 pPage1->aData[36
20150 5d 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 75 74 ], 0);. put
20160 34 62 79 74 65 28 26 70 42 74 2d 3e 70 50 61 67 4byte(&pBt->pPag
20170 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 6e e1->aData[28], n
20180 46 69 6e 29 3b 0a 20 20 20 20 20 20 70 42 74 2d Fin);. pBt-
20190 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 3d 20 31 >bDoTruncate = 1
201a0 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 ;. pBt->nPa
201b0 67 65 20 3d 20 6e 46 69 6e 3b 0a 20 20 20 20 7d ge = nFin;. }
201c0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
201d0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
201e0 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c sqlite3PagerRoll
201f0 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 back(pPager);.
20200 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 }. }.. asser
20210 74 28 20 6e 52 65 66 3e 3d 73 71 6c 69 74 65 33 t( nRef>=sqlite3
20220 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 70 50 PagerRefcount(pP
20230 61 67 65 72 29 20 29 3b 0a 20 20 72 65 74 75 72 ager) );. retur
20240 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6c 73 65 20 2f n rc;.}..#else /
20250 2a 20 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f * ifndef SQLITE_
20260 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 20 OMIT_AUTOVACUUM
20270 2a 2f 0a 23 20 64 65 66 69 6e 65 20 73 65 74 43 */.# define setC
20280 68 69 6c 64 50 74 72 6d 61 70 73 28 78 29 20 53 hildPtrmaps(x) S
20290 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 66 0a QLITE_OK.#endif.
202a0 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 ./*.** This rout
202b0 69 6e 65 20 64 6f 65 73 20 74 68 65 20 66 69 72 ine does the fir
202c0 73 74 20 70 68 61 73 65 20 6f 66 20 61 20 74 77 st phase of a tw
202d0 6f 2d 70 68 61 73 65 20 63 6f 6d 6d 69 74 2e 20 o-phase commit.
202e0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a This routine.**
202f0 20 63 61 75 73 65 73 20 61 20 72 6f 6c 6c 62 61 causes a rollba
20300 63 6b 20 6a 6f 75 72 6e 61 6c 20 74 6f 20 62 65 ck journal to be
20310 20 63 72 65 61 74 65 64 20 28 69 66 20 69 74 20 created (if it
20320 64 6f 65 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 does not already
20330 20 65 78 69 73 74 29 0a 2a 2a 20 61 6e 64 20 70 exist).** and p
20340 6f 70 75 6c 61 74 65 64 20 77 69 74 68 20 65 6e opulated with en
20350 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ough information
20360 20 73 6f 20 74 68 61 74 20 69 66 20 61 20 70 6f so that if a po
20370 77 65 72 20 6c 6f 73 73 20 6f 63 63 75 72 73 0a wer loss occurs.
20380 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ** the database
20390 63 61 6e 20 62 65 20 72 65 73 74 6f 72 65 64 20 can be restored
203a0 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 to its original
203b0 73 74 61 74 65 20 62 79 20 70 6c 61 79 69 6e 67 state by playing
203c0 20 62 61 63 6b 0a 2a 2a 20 74 68 65 20 6a 6f 75 back.** the jou
203d0 72 6e 61 6c 2e 20 20 54 68 65 6e 20 74 68 65 20 rnal. Then the
203e0 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
203f0 6a 6f 75 72 6e 61 6c 20 61 72 65 20 66 6c 75 73 journal are flus
20400 68 65 64 20 6f 75 74 20 74 6f 0a 2a 2a 20 74 68 hed out to.** th
20410 65 20 64 69 73 6b 2e 20 20 41 66 74 65 72 20 74 e disk. After t
20420 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 61 he journal is sa
20430 66 65 6c 79 20 6f 6e 20 6f 78 69 64 65 2c 20 74 fely on oxide, t
20440 68 65 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 he changes to th
20450 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 61 72 e.** database ar
20460 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 e written into t
20470 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
20480 20 61 6e 64 20 66 6c 75 73 68 65 64 20 74 6f 20 and flushed to
20490 6f 78 69 64 65 2e 0a 2a 2a 20 41 74 20 74 68 65 oxide..** At the
204a0 20 65 6e 64 20 6f 66 20 74 68 69 73 20 63 61 6c end of this cal
204b0 6c 2c 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 l, the rollback
204c0 6a 6f 75 72 6e 61 6c 20 73 74 69 6c 6c 20 65 78 journal still ex
204d0 69 73 74 73 20 6f 6e 20 74 68 65 0a 2a 2a 20 64 ists on the.** d
204e0 69 73 6b 20 61 6e 64 20 77 65 20 61 72 65 20 73 isk and we are s
204f0 74 69 6c 6c 20 68 6f 6c 64 69 6e 67 20 61 6c 6c till holding all
20500 20 6c 6f 63 6b 73 2c 20 73 6f 20 74 68 65 20 74 locks, so the t
20510 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 6e ransaction has n
20520 6f 74 0a 2a 2a 20 63 6f 6d 6d 69 74 74 65 64 2e ot.** committed.
20530 20 20 53 65 65 20 73 71 6c 69 74 65 33 42 74 72 See sqlite3Btr
20540 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f eeCommitPhaseTwo
20550 28 29 20 66 6f 72 20 74 68 65 20 73 65 63 6f 6e () for the secon
20560 64 20 70 68 61 73 65 20 6f 66 20 74 68 65 0a 2a d phase of the.*
20570 2a 20 63 6f 6d 6d 69 74 20 70 72 6f 63 65 73 73 * commit process
20580 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 61 6c ..**.** This cal
20590 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 l is a no-op if
205a0 6e 6f 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 no write-transac
205b0 74 69 6f 6e 20 69 73 20 63 75 72 72 65 6e 74 6c tion is currentl
205c0 79 20 61 63 74 69 76 65 20 6f 6e 20 70 42 74 2e y active on pBt.
205d0 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 .**.** Otherwise
205e0 2c 20 73 79 6e 63 20 74 68 65 20 64 61 74 61 62 , sync the datab
205f0 61 73 65 20 66 69 6c 65 20 66 6f 72 20 74 68 65 ase file for the
20600 20 62 74 72 65 65 20 70 42 74 2e 20 7a 4d 61 73 btree pBt. zMas
20610 74 65 72 20 70 6f 69 6e 74 73 20 74 6f 0a 2a 2a ter points to.**
20620 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 6d the name of a m
20630 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
20640 6c 65 20 74 68 61 74 20 73 68 6f 75 6c 64 20 62 le that should b
20650 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 e written into t
20660 68 65 0a 2a 2a 20 69 6e 64 69 76 69 64 75 61 6c he.** individual
20670 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 6f journal file, o
20680 72 20 69 73 20 4e 55 4c 4c 2c 20 69 6e 64 69 63 r is NULL, indic
20690 61 74 69 6e 67 20 6e 6f 20 6d 61 73 74 65 72 20 ating no master
206a0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 0a 2a 2a journal file .**
206b0 20 28 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 (single databas
206c0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 0a e transaction)..
206d0 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 **.** When this
206e0 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 6d is called, the m
206f0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 73 68 aster journal sh
20700 6f 75 6c 64 20 61 6c 72 65 61 64 79 20 68 61 76 ould already hav
20710 65 20 62 65 65 6e 0a 2a 2a 20 63 72 65 61 74 65 e been.** create
20720 64 2c 20 70 6f 70 75 6c 61 74 65 64 20 77 69 74 d, populated wit
20730 68 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c 20 70 h this journal p
20740 6f 69 6e 74 65 72 20 61 6e 64 20 73 79 6e 63 65 ointer and synce
20750 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a d to disk..**.**
20760 20 4f 6e 63 65 20 74 68 69 73 20 69 73 20 72 6f Once this is ro
20770 75 74 69 6e 65 20 68 61 73 20 72 65 74 75 72 6e utine has return
20780 65 64 2c 20 74 68 65 20 6f 6e 6c 79 20 74 68 69 ed, the only thi
20790 6e 67 20 72 65 71 75 69 72 65 64 20 74 6f 20 63 ng required to c
207a0 6f 6d 6d 69 74 0a 2a 2a 20 74 68 65 20 77 72 69 ommit.** the wri
207b0 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 66 te-transaction f
207c0 6f 72 20 74 68 69 73 20 64 61 74 61 62 61 73 65 or this database
207d0 20 66 69 6c 65 20 69 73 20 74 6f 20 64 65 6c 65 file is to dele
207e0 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a te the journal..
207f0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
20800 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e reeCommitPhaseOn
20810 65 28 42 74 72 65 65 20 2a 70 2c 20 63 6f 6e 73 e(Btree *p, cons
20820 74 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 29 t char *zMaster)
20830 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
20840 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 2d ITE_OK;. if( p-
20850 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
20860 57 52 49 54 45 20 29 7b 0a 20 20 20 20 42 74 53 WRITE ){. BtS
20870 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
20880 70 42 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 pBt;. sqlite3
20890 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 23 BtreeEnter(p);.#
208a0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
208b0 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
208c0 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 if( pBt->autoV
208d0 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 20 72 acuum ){. r
208e0 63 20 3d 20 61 75 74 6f 56 61 63 75 75 6d 43 6f c = autoVacuumCo
208f0 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20 20 mmit(pBt);.
20900 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
20910 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 OK ){. sq
20920 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
20930 70 29 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 p);. retu
20940 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 rn rc;. }.
20950 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 42 74 }. if( pBt
20960 2d 3e 62 44 6f 54 72 75 6e 63 61 74 65 20 29 7b ->bDoTruncate ){
20970 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 . sqlite3Pa
20980 67 65 72 54 72 75 6e 63 61 74 65 49 6d 61 67 65 gerTruncateImage
20990 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 42 (pBt->pPager, pB
209a0 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 7d t->nPage);. }
209b0 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 63 20 3d .#endif. rc =
209c0 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d sqlite3PagerCom
209d0 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 42 74 2d mitPhaseOne(pBt-
209e0 3e 70 50 61 67 65 72 2c 20 7a 4d 61 73 74 65 72 >pPager, zMaster
209f0 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 , 0);. sqlite
20a00 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
20a10 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
20a20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 .}../*.** This f
20a30 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
20a40 64 20 66 72 6f 6d 20 62 6f 74 68 20 42 74 72 65 d from both Btre
20a50 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 eCommitPhaseTwo(
20a60 29 20 61 6e 64 20 42 74 72 65 65 52 6f 6c 6c 62 ) and BtreeRollb
20a70 61 63 6b 28 29 0a 2a 2a 20 61 74 20 74 68 65 20 ack().** at the
20a80 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 61 20 conclusion of a
20a90 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a transaction..*/.
20aa0 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 static void btre
20ab0 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 eEndTransaction(
20ac0 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 Btree *p){. BtS
20ad0 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e hared *pBt = p->
20ae0 70 42 74 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a pBt;. sqlite3 *
20af0 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 61 73 db = p->db;. as
20b00 73 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 sert( sqlite3Btr
20b10 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 eeHoldsMutex(p)
20b20 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 );..#ifndef SQLI
20b30 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 TE_OMIT_AUTOVACU
20b40 55 4d 0a 20 20 70 42 74 2d 3e 62 44 6f 54 72 75 UM. pBt->bDoTru
20b50 6e 63 61 74 65 20 3d 20 30 3b 0a 23 65 6e 64 69 ncate = 0;.#endi
20b60 66 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 61 f. if( p->inTra
20b70 6e 73 3e 54 52 41 4e 53 5f 4e 4f 4e 45 20 26 26 ns>TRANS_NONE &&
20b80 20 64 62 2d 3e 6e 56 64 62 65 52 65 61 64 3e 31 db->nVdbeRead>1
20b90 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 ){. /* If th
20ba0 65 72 65 20 61 72 65 20 6f 74 68 65 72 20 61 63 ere are other ac
20bb0 74 69 76 65 20 73 74 61 74 65 6d 65 6e 74 73 20 tive statements
20bc0 74 68 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 74 that belong to t
20bd0 68 69 73 20 64 61 74 61 62 61 73 65 0a 20 20 20 his database.
20be0 20 2a 2a 20 68 61 6e 64 6c 65 2c 20 64 6f 77 6e ** handle, down
20bf0 67 72 61 64 65 20 74 6f 20 61 20 72 65 61 64 2d grade to a read-
20c00 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e only transaction
20c10 2e 20 54 68 65 20 6f 74 68 65 72 20 73 74 61 74 . The other stat
20c20 65 6d 65 6e 74 73 0a 20 20 20 20 2a 2a 20 6d 61 ements. ** ma
20c30 79 20 73 74 69 6c 6c 20 62 65 20 72 65 61 64 69 y still be readi
20c40 6e 67 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ng from the data
20c50 62 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 64 6f base. */. do
20c60 77 6e 67 72 61 64 65 41 6c 6c 53 68 61 72 65 64 wngradeAllShared
20c70 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 CacheTableLocks(
20c80 70 29 3b 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 p);. p->inTra
20c90 6e 73 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b ns = TRANS_READ;
20ca0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a . }else{. /*
20cb0 20 49 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 If the handle h
20cc0 61 64 20 61 6e 79 20 6b 69 6e 64 20 6f 66 20 74 ad any kind of t
20cd0 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 2c ransaction open,
20ce0 20 64 65 63 72 65 6d 65 6e 74 20 74 68 65 20 0a decrement the .
20cf0 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 ** transacti
20d00 6f 6e 20 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 on count of the
20d10 73 68 61 72 65 64 20 62 74 72 65 65 2e 20 49 66 shared btree. If
20d20 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
20d30 20 63 6f 75 6e 74 20 0a 20 20 20 20 2a 2a 20 72 count . ** r
20d40 65 61 63 68 65 73 20 30 2c 20 73 65 74 20 74 68 eaches 0, set th
20d50 65 20 73 68 61 72 65 64 20 73 74 61 74 65 20 74 e shared state t
20d60 6f 20 54 52 41 4e 53 5f 4e 4f 4e 45 2e 20 54 68 o TRANS_NONE. Th
20d70 65 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 e unlockBtreeIfU
20d80 6e 75 73 65 64 28 29 0a 20 20 20 20 2a 2a 20 63 nused(). ** c
20d90 61 6c 6c 20 62 65 6c 6f 77 20 77 69 6c 6c 20 75 all below will u
20da0 6e 6c 6f 63 6b 20 74 68 65 20 70 61 67 65 72 2e nlock the pager.
20db0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e */. if( p->
20dc0 69 6e 54 72 61 6e 73 21 3d 54 52 41 4e 53 5f 4e inTrans!=TRANS_N
20dd0 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 63 6c 65 ONE ){. cle
20de0 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 arAllSharedCache
20df0 54 61 62 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 TableLocks(p);.
20e00 20 20 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 pBt->nTrans
20e10 61 63 74 69 6f 6e 2d 2d 3b 0a 20 20 20 20 20 20 action--;.
20e20 69 66 28 20 30 3d 3d 70 42 74 2d 3e 6e 54 72 61 if( 0==pBt->nTra
20e30 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 nsaction ){.
20e40 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 pBt->inTrans
20e50 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 4e action = TRANS_N
20e60 4f 4e 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 ONE;. }.
20e70 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 }.. /* Set t
20e80 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 he current trans
20e90 61 63 74 69 6f 6e 20 73 74 61 74 65 20 74 6f 20 action state to
20ea0 54 52 41 4e 53 5f 4e 4f 4e 45 20 61 6e 64 20 75 TRANS_NONE and u
20eb0 6e 6c 6f 63 6b 20 74 68 65 20 0a 20 20 20 20 2a nlock the . *
20ec0 2a 20 70 61 67 65 72 20 69 66 20 74 68 69 73 20 * pager if this
20ed0 63 61 6c 6c 20 63 6c 6f 73 65 64 20 74 68 65 20 call closed the
20ee0 6f 6e 6c 79 20 72 65 61 64 20 6f 72 20 77 72 69 only read or wri
20ef0 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 te transaction.
20f00 20 2a 2f 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 */. p->inTra
20f10 6e 73 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b ns = TRANS_NONE;
20f20 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 . unlockBtree
20f30 49 66 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 IfUnused(pBt);.
20f40 20 7d 0a 0a 20 20 62 74 72 65 65 49 6e 74 65 67 }.. btreeInteg
20f50 72 69 74 79 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a rity(p);.}../*.*
20f60 2a 20 43 6f 6d 6d 69 74 20 74 68 65 20 74 72 61 * Commit the tra
20f70 6e 73 61 63 74 69 6f 6e 20 63 75 72 72 65 6e 74 nsaction current
20f80 6c 79 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 0a ly in progress..
20f90 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
20fa0 6e 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 ne implements th
20fb0 65 20 73 65 63 6f 6e 64 20 70 68 61 73 65 20 6f e second phase o
20fc0 66 20 61 20 32 2d 70 68 61 73 65 20 63 6f 6d 6d f a 2-phase comm
20fd0 69 74 2e 20 20 54 68 65 0a 2a 2a 20 73 71 6c 69 it. The.** sqli
20fe0 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 te3BtreeCommitPh
20ff0 61 73 65 4f 6e 65 28 29 20 72 6f 75 74 69 6e 65 aseOne() routine
21000 20 64 6f 65 73 20 74 68 65 20 66 69 72 73 74 20 does the first
21010 70 68 61 73 65 20 61 6e 64 20 73 68 6f 75 6c 64 phase and should
21020 0a 2a 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20 70 .** be invoked p
21030 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 20 rior to calling
21040 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 54 this routine. T
21050 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 he sqlite3BtreeC
21060 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 0a ommitPhaseOne().
21070 2a 2a 20 72 6f 75 74 69 6e 65 20 64 69 64 20 61 ** routine did a
21080 6c 6c 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 77 ll the work of w
21090 72 69 74 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 riting informati
210a0 6f 6e 20 6f 75 74 20 74 6f 20 64 69 73 6b 20 61 on out to disk a
210b0 6e 64 20 66 6c 75 73 68 69 6e 67 20 74 68 65 0a nd flushing the.
210c0 2a 2a 20 63 6f 6e 74 65 6e 74 73 20 73 6f 20 74 ** contents so t
210d0 68 61 74 20 74 68 65 79 20 61 72 65 20 77 72 69 hat they are wri
210e0 74 74 65 6e 20 6f 6e 74 6f 20 74 68 65 20 64 69 tten onto the di
210f0 73 6b 20 70 6c 61 74 74 65 72 2e 20 20 41 6c 6c sk platter. All
21100 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 this.** routine
21110 20 68 61 73 20 74 6f 20 64 6f 20 69 73 20 64 65 has to do is de
21120 6c 65 74 65 20 6f 72 20 74 72 75 6e 63 61 74 65 lete or truncate
21130 20 6f 72 20 7a 65 72 6f 20 74 68 65 20 68 65 61 or zero the hea
21140 64 65 72 20 69 6e 20 74 68 65 0a 2a 2a 20 74 68 der in the.** th
21150 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
21160 61 6c 20 28 77 68 69 63 68 20 63 61 75 73 65 73 al (which causes
21170 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
21180 20 74 6f 20 63 6f 6d 6d 69 74 29 20 61 6e 64 0a to commit) and.
21190 2a 2a 20 64 72 6f 70 20 6c 6f 63 6b 73 2e 0a 2a ** drop locks..*
211a0 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 *.** Normally, i
211b0 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
211c0 73 20 77 68 69 6c 65 20 74 68 65 20 70 61 67 65 s while the page
211d0 72 20 6c 61 79 65 72 20 69 73 20 61 74 74 65 6d r layer is attem
211e0 70 74 69 6e 67 20 74 6f 20 0a 2a 2a 20 66 69 6e pting to .** fin
211f0 61 6c 69 7a 65 20 74 68 65 20 75 6e 64 65 72 6c alize the underl
21200 79 69 6e 67 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ying journal fil
21210 65 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e e, this function
21220 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f returns an erro
21230 72 20 61 6e 64 0a 2a 2a 20 74 68 65 20 75 70 70 r and.** the upp
21240 65 72 20 6c 61 79 65 72 20 77 69 6c 6c 20 61 74 er layer will at
21250 74 65 6d 70 74 20 61 20 72 6f 6c 6c 62 61 63 6b tempt a rollback
21260 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 . However, if th
21270 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e e second argumen
21280 74 0a 2a 2a 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f t.** is non-zero
21290 20 74 68 65 6e 20 74 68 69 73 20 62 2d 74 72 65 then this b-tre
212a0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 e transaction is
212b0 20 70 61 72 74 20 6f 66 20 61 20 6d 75 6c 74 69 part of a multi
212c0 2d 66 69 6c 65 20 0a 2a 2a 20 74 72 61 6e 73 61 -file .** transa
212d0 63 74 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 63 ction. In this c
212e0 61 73 65 2c 20 74 68 65 20 74 72 61 6e 73 61 63 ase, the transac
212f0 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 79 tion has already
21300 20 62 65 65 6e 20 63 6f 6d 6d 69 74 74 65 64 20 been committed
21310 0a 2a 2a 20 28 62 79 20 64 65 6c 65 74 69 6e 67 .** (by deleting
21320 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 a master journa
21330 6c 20 66 69 6c 65 29 20 61 6e 64 20 74 68 65 20 l file) and the
21340 63 61 6c 6c 65 72 20 77 69 6c 6c 20 69 67 6e 6f caller will igno
21350 72 65 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 re this .** func
21360 74 69 6f 6e 73 20 72 65 74 75 72 6e 20 63 6f 64 tions return cod
21370 65 2e 20 53 6f 2c 20 65 76 65 6e 20 69 66 20 61 e. So, even if a
21380 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 69 n error occurs i
21390 6e 20 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 n the pager laye
213a0 72 2c 0a 2a 2a 20 72 65 73 65 74 20 74 68 65 20 r,.** reset the
213b0 62 2d 74 72 65 65 20 6f 62 6a 65 63 74 73 20 69 b-tree objects i
213c0 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 20 74 6f nternal state to
213d0 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 indicate that t
213e0 68 65 20 77 72 69 74 65 0a 2a 2a 20 74 72 61 6e he write.** tran
213f0 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e saction has been
21400 20 63 6c 6f 73 65 64 2e 20 54 68 69 73 20 69 73 closed. This is
21410 20 71 75 69 74 65 20 73 61 66 65 2c 20 61 73 20 quite safe, as
21420 74 68 65 20 70 61 67 65 72 20 77 69 6c 6c 20 68 the pager will h
21430 61 76 65 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f ave.** transitio
21440 6e 65 64 20 74 6f 20 74 68 65 20 65 72 72 6f 72 ned to the error
21450 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 state..**.** Th
21460 69 73 20 77 69 6c 6c 20 72 65 6c 65 61 73 65 20 is will release
21470 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 6f the write lock o
21480 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
21490 69 6c 65 2e 20 20 49 66 20 74 68 65 72 65 0a 2a ile. If there.*
214a0 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 * are no active
214b0 63 75 72 73 6f 72 73 2c 20 69 74 20 61 6c 73 6f cursors, it also
214c0 20 72 65 6c 65 61 73 65 73 20 74 68 65 20 72 65 releases the re
214d0 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 ad lock..*/.int
214e0 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d sqlite3BtreeComm
214f0 69 74 50 68 61 73 65 54 77 6f 28 42 74 72 65 65 itPhaseTwo(Btree
21500 20 2a 70 2c 20 69 6e 74 20 62 43 6c 65 61 6e 75 *p, int bCleanu
21510 70 29 7b 0a 0a 20 20 69 66 28 20 70 2d 3e 69 6e p){.. if( p->in
21520 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 4e 4f 4e Trans==TRANS_NON
21530 45 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 E ) return SQLIT
21540 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 42 E_OK;. sqlite3B
21550 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
21560 62 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 btreeIntegrity(p
21570 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 );.. /* If the
21580 68 61 6e 64 6c 65 20 68 61 73 20 61 20 77 72 69 handle has a wri
21590 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f te-transaction o
215a0 70 65 6e 2c 20 63 6f 6d 6d 69 74 20 74 68 65 20 pen, commit the
215b0 73 68 61 72 65 64 2d 62 74 72 65 65 73 20 0a 20 shared-btrees .
215c0 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ** transaction
215d0 61 6e 64 20 73 65 74 20 74 68 65 20 73 68 61 72 and set the shar
215e0 65 64 20 73 74 61 74 65 20 74 6f 20 54 52 41 4e ed state to TRAN
215f0 53 5f 52 45 41 44 2e 0a 20 20 2a 2f 0a 20 20 69 S_READ.. */. i
21600 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
21610 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 RANS_WRITE ){.
21620 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 42 74 int rc;. Bt
21630 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
21640 3e 70 42 74 3b 0a 20 20 20 20 61 73 73 65 72 74 >pBt;. assert
21650 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 ( pBt->inTransac
21660 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 tion==TRANS_WRIT
21670 45 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 E );. assert(
21680 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 pBt->nTransacti
21690 6f 6e 3e 30 20 29 3b 0a 20 20 20 20 72 63 20 3d on>0 );. rc =
216a0 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d sqlite3PagerCom
216b0 6d 69 74 50 68 61 73 65 54 77 6f 28 70 42 74 2d mitPhaseTwo(pBt-
216c0 3e 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 >pPager);. if
216d0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
216e0 26 26 20 62 43 6c 65 61 6e 75 70 3d 3d 30 20 29 && bCleanup==0 )
216f0 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 {. sqlite3B
21700 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
21710 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
21720 20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 44 61 74 }. p->iDat
21730 61 56 65 72 73 69 6f 6e 2d 2d 3b 20 20 2f 2a 20 aVersion--; /*
21740 43 6f 6d 70 65 6e 73 61 74 65 20 66 6f 72 20 70 Compensate for p
21750 50 61 67 65 72 2d 3e 69 44 61 74 61 56 65 72 73 Pager->iDataVers
21760 69 6f 6e 2b 2b 3b 20 2a 2f 0a 20 20 20 20 70 42 ion++; */. pB
21770 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e t->inTransaction
21780 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b 0a 20 = TRANS_READ;.
21790 20 20 20 62 74 72 65 65 43 6c 65 61 72 48 61 73 btreeClearHas
217a0 43 6f 6e 74 65 6e 74 28 70 42 74 29 3b 0a 20 20 Content(pBt);.
217b0 7d 0a 0a 20 20 62 74 72 65 65 45 6e 64 54 72 61 }.. btreeEndTra
217c0 6e 73 61 63 74 69 6f 6e 28 70 29 3b 0a 20 20 73 nsaction(p);. s
217d0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
217e0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 (p);. return SQ
217f0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
21800 2a 20 44 6f 20 62 6f 74 68 20 70 68 61 73 65 73 * Do both phases
21810 20 6f 66 20 61 20 63 6f 6d 6d 69 74 2e 0a 2a 2f of a commit..*/
21820 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
21830 65 43 6f 6d 6d 69 74 28 42 74 72 65 65 20 2a 70 eCommit(Btree *p
21840 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 ){. int rc;. s
21850 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
21860 28 70 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 (p);. rc = sqli
21870 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 te3BtreeCommitPh
21880 61 73 65 4f 6e 65 28 70 2c 20 30 29 3b 0a 20 20 aseOne(p, 0);.
21890 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
218a0 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 K ){. rc = sq
218b0 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
218c0 50 68 61 73 65 54 77 6f 28 70 2c 20 30 29 3b 0a PhaseTwo(p, 0);.
218d0 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 }. sqlite3Btr
218e0 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
218f0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
21900 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 * This routine s
21910 65 74 73 20 74 68 65 20 73 74 61 74 65 20 74 6f ets the state to
21920 20 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 61 6e CURSOR_FAULT an
21930 64 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a 20 63 d the error.** c
21940 6f 64 65 20 74 6f 20 65 72 72 43 6f 64 65 20 66 ode to errCode f
21950 6f 72 20 65 76 65 72 79 20 63 75 72 73 6f 72 20 or every cursor
21960 6f 6e 20 61 6e 79 20 42 74 53 68 61 72 65 64 20 on any BtShared
21970 74 68 61 74 20 70 42 74 72 65 65 0a 2a 2a 20 72 that pBtree.** r
21980 65 66 65 72 65 6e 63 65 73 2e 20 20 4f 72 20 69 eferences. Or i
21990 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c 79 20 f the writeOnly
219a0 66 6c 61 67 20 69 73 20 73 65 74 20 74 6f 20 31 flag is set to 1
219b0 2c 20 74 68 65 6e 20 6f 6e 6c 79 0a 2a 2a 20 74 , then only.** t
219c0 72 69 70 20 77 72 69 74 65 20 63 75 72 73 6f 72 rip write cursor
219d0 73 20 61 6e 64 20 6c 65 61 76 65 20 72 65 61 64 s and leave read
219e0 20 63 75 72 73 6f 72 73 20 75 6e 63 68 61 6e 67 cursors unchang
219f0 65 64 2e 0a 2a 2a 0a 2a 2a 20 45 76 65 72 79 20 ed..**.** Every
21a00 63 75 72 73 6f 72 20 69 73 20 61 20 63 61 6e 64 cursor is a cand
21a10 69 64 61 74 65 20 74 6f 20 62 65 20 74 72 69 70 idate to be trip
21a20 70 65 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 63 ped, including c
21a30 75 72 73 6f 72 73 0a 2a 2a 20 74 68 61 74 20 62 ursors.** that b
21a40 65 6c 6f 6e 67 20 74 6f 20 6f 74 68 65 72 20 64 elong to other d
21a50 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
21a60 6f 6e 73 20 74 68 61 74 20 68 61 70 70 65 6e 20 ons that happen
21a70 74 6f 20 62 65 0a 2a 2a 20 73 68 61 72 69 6e 67 to be.** sharing
21a80 20 74 68 65 20 63 61 63 68 65 20 77 69 74 68 20 the cache with
21a90 70 42 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 pBtree..**.** Th
21aa0 69 73 20 72 6f 75 74 69 6e 65 20 67 65 74 73 20 is routine gets
21ab0 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 72 6f called when a ro
21ac0 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 2e 20 49 llback occurs. I
21ad0 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c 79 0a f the writeOnly.
21ae0 2a 2a 20 66 6c 61 67 20 69 73 20 74 72 75 65 2c ** flag is true,
21af0 20 74 68 65 6e 20 6f 6e 6c 79 20 77 72 69 74 65 then only write
21b00 2d 63 75 72 73 6f 72 73 20 6e 65 65 64 20 62 65 -cursors need be
21b10 20 74 72 69 70 70 65 64 20 2d 20 72 65 61 64 2d tripped - read-
21b20 6f 6e 6c 79 0a 2a 2a 20 63 75 72 73 6f 72 73 20 only.** cursors
21b30 73 61 76 65 20 74 68 65 69 72 20 63 75 72 72 65 save their curre
21b40 6e 74 20 70 6f 73 69 74 69 6f 6e 73 20 73 6f 20 nt positions so
21b50 74 68 61 74 20 74 68 65 79 20 6d 61 79 20 63 6f that they may co
21b60 6e 74 69 6e 75 65 20 0a 2a 2a 20 66 6f 6c 6c 6f ntinue .** follo
21b70 77 69 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 wing the rollbac
21b80 6b 2e 20 4f 72 2c 20 69 66 20 77 72 69 74 65 4f k. Or, if writeO
21b90 6e 6c 79 20 69 73 20 66 61 6c 73 65 2c 20 61 6c nly is false, al
21ba0 6c 20 63 75 72 73 6f 72 73 20 61 72 65 20 0a 2a l cursors are .*
21bb0 2a 20 74 72 69 70 70 65 64 2e 20 49 6e 20 67 65 * tripped. In ge
21bc0 6e 65 72 61 6c 2c 20 77 72 69 74 65 4f 6e 6c 79 neral, writeOnly
21bd0 20 69 73 20 66 61 6c 73 65 20 69 66 20 74 68 65 is false if the
21be0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 62 65 69 transaction bei
21bf0 6e 67 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 63 ng.** rolled bac
21c00 6b 20 6d 6f 64 69 66 69 65 64 20 74 68 65 20 64 k modified the d
21c10 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 atabase schema.
21c20 49 6e 20 74 68 69 73 20 63 61 73 65 20 62 2d 74 In this case b-t
21c30 72 65 65 20 72 6f 6f 74 0a 2a 2a 20 70 61 67 65 ree root.** page
21c40 73 20 6d 61 79 20 62 65 20 6d 6f 76 65 64 20 6f s may be moved o
21c50 72 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74 r deleted from t
21c60 68 65 20 64 61 74 61 62 61 73 65 20 61 6c 74 6f he database alto
21c70 67 65 74 68 65 72 2c 20 6d 61 6b 69 6e 67 0a 2a gether, making.*
21c80 2a 20 69 74 20 75 6e 73 61 66 65 20 66 6f 72 20 * it unsafe for
21c90 72 65 61 64 20 63 75 72 73 6f 72 73 20 74 6f 20 read cursors to
21ca0 63 6f 6e 74 69 6e 75 65 2e 0a 2a 2a 0a 2a 2a 20 continue..**.**
21cb0 49 66 20 74 68 65 20 77 72 69 74 65 4f 6e 6c 79 If the writeOnly
21cc0 20 66 6c 61 67 20 69 73 20 74 72 75 65 20 61 6e flag is true an
21cd0 64 20 61 6e 20 65 72 72 6f 72 20 69 73 20 65 6e d an error is en
21ce0 63 6f 75 6e 74 65 72 65 64 20 77 68 69 6c 65 20 countered while
21cf0 0a 2a 2a 20 73 61 76 69 6e 67 20 74 68 65 20 63 .** saving the c
21d00 75 72 72 65 6e 74 20 70 6f 73 69 74 69 6f 6e 20 urrent position
21d10 6f 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 of a read-only c
21d20 75 72 73 6f 72 2c 20 61 6c 6c 20 63 75 72 73 6f ursor, all curso
21d30 72 73 2c 20 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e rs, .** includin
21d40 67 20 61 6c 6c 20 72 65 61 64 2d 63 75 72 73 6f g all read-curso
21d50 72 73 20 61 72 65 20 74 72 69 70 70 65 64 2e 0a rs are tripped..
21d60 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 **.** SQLITE_OK
21d70 69 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 73 is returned if s
21d80 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 69 66 uccessful, or if
21d90 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
21da0 20 77 68 69 6c 65 0a 2a 2a 20 73 61 76 69 6e 67 while.** saving
21db0 20 61 20 63 75 72 73 6f 72 20 70 6f 73 69 74 69 a cursor positi
21dc0 6f 6e 2c 20 61 6e 20 53 51 4c 69 74 65 20 65 72 on, an SQLite er
21dd0 72 6f 72 20 63 6f 64 65 2e 0a 2a 2f 0a 69 6e 74 ror code..*/.int
21de0 20 73 71 6c 69 74 65 33 42 74 72 65 65 54 72 69 sqlite3BtreeTri
21df0 70 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 72 65 pAllCursors(Btre
21e00 65 20 2a 70 42 74 72 65 65 2c 20 69 6e 74 20 65 e *pBtree, int e
21e10 72 72 43 6f 64 65 2c 20 69 6e 74 20 77 72 69 74 rrCode, int writ
21e20 65 4f 6e 6c 79 29 7b 0a 20 20 42 74 43 75 72 73 eOnly){. BtCurs
21e30 6f 72 20 2a 70 3b 0a 20 20 69 6e 74 20 72 63 20 or *p;. int rc
21e40 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 = SQLITE_OK;..
21e50 61 73 73 65 72 74 28 20 28 77 72 69 74 65 4f 6e assert( (writeOn
21e60 6c 79 3d 3d 30 20 7c 7c 20 77 72 69 74 65 4f 6e ly==0 || writeOn
21e70 6c 79 3d 3d 31 29 20 26 26 20 42 54 43 46 5f 57 ly==1) && BTCF_W
21e80 72 69 74 65 46 6c 61 67 3d 3d 31 20 29 3b 0a 20 riteFlag==1 );.
21e90 20 69 66 28 20 70 42 74 72 65 65 20 29 7b 0a 20 if( pBtree ){.
21ea0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 sqlite3BtreeE
21eb0 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
21ec0 20 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e for(p=pBtree->
21ed0 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b pBt->pCursor; p;
21ee0 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 p=p->pNext){.
21ef0 20 20 20 20 69 66 28 20 77 72 69 74 65 4f 6e 6c if( writeOnl
21f00 79 20 26 26 20 28 70 2d 3e 63 75 72 46 6c 61 67 y && (p->curFlag
21f10 73 20 26 20 42 54 43 46 5f 57 72 69 74 65 46 6c s & BTCF_WriteFl
21f20 61 67 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ag)==0 ){.
21f30 20 20 69 66 28 20 70 2d 3e 65 53 74 61 74 65 3d if( p->eState=
21f40 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c =CURSOR_VALID ||
21f50 20 70 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 p->eState==CURS
21f60 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 7b 0a 20 OR_SKIPNEXT ){.
21f70 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 61 rc = sa
21f80 76 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e veCursorPosition
21f90 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 (p);. i
21fa0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
21fb0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
21fc0 28 76 6f 69 64 29 73 71 6c 69 74 65 33 42 74 72 (void)sqlite3Btr
21fd0 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 73 eeTripAllCursors
21fe0 28 70 42 74 72 65 65 2c 20 72 63 2c 20 30 29 3b (pBtree, rc, 0);
21ff0 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 . bre
22000 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ak;. }.
22010 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
22020 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 }else{. s
22030 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 72 qlite3BtreeClear
22040 43 75 72 73 6f 72 28 70 29 3b 0a 20 20 20 20 20 Cursor(p);.
22050 20 20 20 70 2d 3e 65 53 74 61 74 65 20 3d 20 43 p->eState = C
22060 55 52 53 4f 52 5f 46 41 55 4c 54 3b 0a 20 20 20 URSOR_FAULT;.
22070 20 20 20 20 20 70 2d 3e 73 6b 69 70 4e 65 78 74 p->skipNext
22080 20 3d 20 65 72 72 43 6f 64 65 3b 0a 20 20 20 20 = errCode;.
22090 20 20 7d 0a 20 20 20 20 20 20 62 74 72 65 65 52 }. btreeR
220a0 65 6c 65 61 73 65 41 6c 6c 43 75 72 73 6f 72 50 eleaseAllCursorP
220b0 61 67 65 73 28 70 29 3b 0a 20 20 20 20 7d 0a 20 ages(p);. }.
220c0 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c sqlite3BtreeL
220d0 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a 20 20 eave(pBtree);.
220e0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
220f0 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 6b ../*.** Rollback
22100 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
22110 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 0a 2a 2a in progress..**
22120 0a 2a 2a 20 49 66 20 74 72 69 70 43 6f 64 65 20 .** If tripCode
22130 69 73 20 6e 6f 74 20 53 51 4c 49 54 45 5f 4f 4b is not SQLITE_OK
22140 20 74 68 65 6e 20 63 75 72 73 6f 72 73 20 77 69 then cursors wi
22150 6c 6c 20 62 65 20 69 6e 76 61 6c 69 64 61 74 65 ll be invalidate
22160 64 20 28 74 72 69 70 70 65 64 29 2e 0a 2a 2a 20 d (tripped)..**
22170 4f 6e 6c 79 20 77 72 69 74 65 20 63 75 72 73 6f Only write curso
22180 72 73 20 61 72 65 20 74 72 69 70 70 65 64 20 69 rs are tripped i
22190 66 20 77 72 69 74 65 4f 6e 6c 79 20 69 73 20 74 f writeOnly is t
221a0 72 75 65 20 62 75 74 20 61 6c 6c 20 63 75 72 73 rue but all curs
221b0 6f 72 73 20 61 72 65 0a 2a 2a 20 74 72 69 70 70 ors are.** tripp
221c0 65 64 20 69 66 20 77 72 69 74 65 4f 6e 6c 79 20 ed if writeOnly
221d0 69 73 20 66 61 6c 73 65 2e 20 20 41 6e 79 20 61 is false. Any a
221e0 74 74 65 6d 70 74 20 74 6f 20 75 73 65 0a 2a 2a ttempt to use.**
221f0 20 61 20 74 72 69 70 70 65 64 20 63 75 72 73 6f a tripped curso
22200 72 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e r will result in
22210 20 61 6e 20 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a an error..**.**
22220 20 54 68 69 73 20 77 69 6c 6c 20 72 65 6c 65 61 This will relea
22230 73 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 se the write loc
22240 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 k on the databas
22250 65 20 66 69 6c 65 2e 20 20 49 66 20 74 68 65 72 e file. If ther
22260 65 0a 2a 2a 20 61 72 65 20 6e 6f 20 61 63 74 69 e.** are no acti
22270 76 65 20 63 75 72 73 6f 72 73 2c 20 69 74 20 61 ve cursors, it a
22280 6c 73 6f 20 72 65 6c 65 61 73 65 73 20 74 68 65 lso releases the
22290 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 2a 2f 0a 69 read lock..*/.i
222a0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 nt sqlite3BtreeR
222b0 6f 6c 6c 62 61 63 6b 28 42 74 72 65 65 20 2a 70 ollback(Btree *p
222c0 2c 20 69 6e 74 20 74 72 69 70 43 6f 64 65 2c 20 , int tripCode,
222d0 69 6e 74 20 77 72 69 74 65 4f 6e 6c 79 29 7b 0a int writeOnly){.
222e0 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 53 68 int rc;. BtSh
222f0 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
22300 42 74 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 Bt;. MemPage *p
22310 50 61 67 65 31 3b 0a 0a 20 20 61 73 73 65 72 74 Page1;.. assert
22320 28 20 77 72 69 74 65 4f 6e 6c 79 3d 3d 31 20 7c ( writeOnly==1 |
22330 7c 20 77 72 69 74 65 4f 6e 6c 79 3d 3d 30 20 29 | writeOnly==0 )
22340 3b 0a 20 20 61 73 73 65 72 74 28 20 74 72 69 70 ;. assert( trip
22350 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 41 42 4f Code==SQLITE_ABO
22360 52 54 5f 52 4f 4c 4c 42 41 43 4b 20 7c 7c 20 74 RT_ROLLBACK || t
22370 72 69 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f ripCode==SQLITE_
22380 4f 4b 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 OK );. sqlite3B
22390 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
223a0 69 66 28 20 74 72 69 70 43 6f 64 65 3d 3d 53 51 if( tripCode==SQ
223b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
223c0 63 20 3d 20 74 72 69 70 43 6f 64 65 20 3d 20 73 c = tripCode = s
223d0 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 aveAllCursors(pB
223e0 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 69 66 t, 0, 0);. if
223f0 28 20 72 63 20 29 20 77 72 69 74 65 4f 6e 6c 79 ( rc ) writeOnly
22400 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 = 0;. }else{.
22410 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
22420 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 74 72 69 K;. }. if( tri
22430 70 43 6f 64 65 20 29 7b 0a 20 20 20 20 69 6e 74 pCode ){. int
22440 20 72 63 32 20 3d 20 73 71 6c 69 74 65 33 42 74 rc2 = sqlite3Bt
22450 72 65 65 54 72 69 70 41 6c 6c 43 75 72 73 6f 72 reeTripAllCursor
22460 73 28 70 2c 20 74 72 69 70 43 6f 64 65 2c 20 77 s(p, tripCode, w
22470 72 69 74 65 4f 6e 6c 79 29 3b 0a 20 20 20 20 61 riteOnly);. a
22480 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
22490 45 5f 4f 4b 20 7c 7c 20 28 77 72 69 74 65 4f 6e E_OK || (writeOn
224a0 6c 79 3d 3d 30 20 26 26 20 72 63 32 3d 3d 53 51 ly==0 && rc2==SQ
224b0 4c 49 54 45 5f 4f 4b 29 20 29 3b 0a 20 20 20 20 LITE_OK) );.
224c0 69 66 28 20 72 63 32 21 3d 53 51 4c 49 54 45 5f if( rc2!=SQLITE_
224d0 4f 4b 20 29 20 72 63 20 3d 20 72 63 32 3b 0a 20 OK ) rc = rc2;.
224e0 20 7d 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 }. btreeIntegr
224f0 69 74 79 28 70 29 3b 0a 0a 20 20 69 66 28 20 70 ity(p);.. if( p
22500 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 ->inTrans==TRANS
22510 5f 57 52 49 54 45 20 29 7b 0a 20 20 20 20 69 6e _WRITE ){. in
22520 74 20 72 63 32 3b 0a 0a 20 20 20 20 61 73 73 65 t rc2;.. asse
22530 72 74 28 20 54 52 41 4e 53 5f 57 52 49 54 45 3d rt( TRANS_WRITE=
22540 3d 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 =pBt->inTransact
22550 69 6f 6e 20 29 3b 0a 20 20 20 20 72 63 32 20 3d ion );. rc2 =
22560 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c sqlite3PagerRol
22570 6c 62 61 63 6b 28 70 42 74 2d 3e 70 50 61 67 65 lback(pBt->pPage
22580 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 32 21 r);. if( rc2!
22590 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
225a0 20 20 20 20 72 63 20 3d 20 72 63 32 3b 0a 20 20 rc = rc2;.
225b0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 }.. /* The
225c0 72 6f 6c 6c 62 61 63 6b 20 6d 61 79 20 68 61 76 rollback may hav
225d0 65 20 64 65 73 74 72 6f 79 65 64 20 74 68 65 20 e destroyed the
225e0 70 50 61 67 65 31 2d 3e 61 44 61 74 61 20 76 61 pPage1->aData va
225f0 6c 75 65 2e 20 20 53 6f 0a 20 20 20 20 2a 2a 20 lue. So. **
22600 63 61 6c 6c 20 62 74 72 65 65 47 65 74 50 61 67 call btreeGetPag
22610 65 28 29 20 6f 6e 20 70 61 67 65 20 31 20 61 67 e() on page 1 ag
22620 61 69 6e 20 74 6f 20 6d 61 6b 65 0a 20 20 20 20 ain to make.
22630 2a 2a 20 73 75 72 65 20 70 50 61 67 65 31 2d 3e ** sure pPage1->
22640 61 44 61 74 61 20 69 73 20 73 65 74 20 63 6f 72 aData is set cor
22650 72 65 63 74 6c 79 2e 20 2a 2f 0a 20 20 20 20 69 rectly. */. i
22660 66 28 20 62 74 72 65 65 47 65 74 50 61 67 65 28 f( btreeGetPage(
22670 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 31 2c pBt, 1, &pPage1,
22680 20 30 29 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 0)==SQLITE_OK )
22690 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 50 61 67 {. int nPag
226a0 65 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 2b e = get4byte(28+
226b0 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 (u8*)pPage1->aDa
226c0 74 61 29 3b 0a 20 20 20 20 20 20 74 65 73 74 63 ta);. testc
226d0 61 73 65 28 20 6e 50 61 67 65 3d 3d 30 20 29 3b ase( nPage==0 );
226e0 0a 20 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 . if( nPage
226f0 3d 3d 30 20 29 20 73 71 6c 69 74 65 33 50 61 67 ==0 ) sqlite3Pag
22700 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d erPagecount(pBt-
22710 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 29 >pPager, &nPage)
22720 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 ;. testcase
22730 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 3d 6e 50 ( pBt->nPage!=nP
22740 61 67 65 20 29 3b 0a 20 20 20 20 20 20 70 42 74 age );. pBt
22750 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 3b ->nPage = nPage;
22760 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 . releasePa
22770 67 65 4f 6e 65 28 70 50 61 67 65 31 29 3b 0a 20 geOne(pPage1);.
22780 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 }. assert(
22790 20 63 6f 75 6e 74 56 61 6c 69 64 43 75 72 73 6f countValidCurso
227a0 72 73 28 70 42 74 2c 20 31 29 3d 3d 30 20 29 3b rs(pBt, 1)==0 );
227b0 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e . pBt->inTran
227c0 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f saction = TRANS_
227d0 52 45 41 44 3b 0a 20 20 20 20 62 74 72 65 65 43 READ;. btreeC
227e0 6c 65 61 72 48 61 73 43 6f 6e 74 65 6e 74 28 70 learHasContent(p
227f0 42 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 Bt);. }.. btre
22800 65 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 eEndTransaction(
22810 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 p);. sqlite3Btr
22820 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
22830 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
22840 2a 20 53 74 61 72 74 20 61 20 73 74 61 74 65 6d * Start a statem
22850 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 69 ent subtransacti
22860 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 61 6e 73 on. The subtrans
22870 61 63 74 69 6f 6e 20 63 61 6e 20 62 65 20 72 6f action can be ro
22880 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 69 6e 64 lled.** back ind
22890 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 20 74 68 ependently of th
228a0 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 63 74 69 e main transacti
228b0 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 73 74 61 on. You must sta
228c0 72 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e rt a transaction
228d0 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 74 61 72 .** before star
228e0 74 69 6e 67 20 61 20 73 75 62 74 72 61 6e 73 61 ting a subtransa
228f0 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 62 74 72 ction. The subtr
22900 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 65 6e 64 ansaction is end
22910 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 ed automatically
22920 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d 61 69 6e .** if the main
22930 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d transaction com
22940 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 20 62 61 mits or rolls ba
22950 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 74 65 6d ck..**.** Statem
22960 65 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 69 ent subtransacti
22970 6f 6e 73 20 61 72 65 20 75 73 65 64 20 61 72 6f ons are used aro
22980 75 6e 64 20 69 6e 64 69 76 69 64 75 61 6c 20 53 und individual S
22990 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a QL statements.**
229a0 20 74 68 61 74 20 61 72 65 20 63 6f 6e 74 61 69 that are contai
229b0 6e 65 64 20 77 69 74 68 69 6e 20 61 20 42 45 47 ned within a BEG
229c0 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 6c 6f 63 IN...COMMIT bloc
229d0 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 74 72 61 k. If a constra
229e0 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 63 int.** error occ
229f0 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 73 urs within the s
22a00 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 20 65 66 tatement, the ef
22a10 66 65 63 74 20 6f 66 20 74 68 61 74 20 6f 6e 65 fect of that one
22a20 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 63 61 statement.** ca
22a30 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b n be rolled back
22a40 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 without having
22a50 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 20 to rollback the
22a60 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74 69 entire transacti
22a70 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 74 61 74 on..**.** A stat
22a80 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 6e 73 61 ement sub-transa
22a90 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c 65 6d 65 ction is impleme
22aa0 6e 74 65 64 20 61 73 20 61 6e 20 61 6e 6f 6e 79 nted as an anony
22ab0 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 2e 20 mous savepoint.
22ac0 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 70 61 73 The.** value pas
22ad0 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e sed as the secon
22ae0 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 74 d parameter is t
22af0 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 he total number
22b00 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 2c 0a 2a of savepoints,.*
22b10 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 * including the
22b20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 20 73 61 new anonymous sa
22b30 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e 20 6f 6e vepoint, open on
22b40 20 74 68 65 20 42 2d 54 72 65 65 2e 20 69 2e 65 the B-Tree. i.e
22b50 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 . if there.** ar
22b60 65 20 6e 6f 20 61 63 74 69 76 65 20 73 61 76 65 e no active save
22b70 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f 20 6f 74 points and no ot
22b80 68 65 72 20 73 74 61 74 65 6d 65 6e 74 2d 74 72 her statement-tr
22b90 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 65 6e 2c ansactions open,
22ba0 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e 74 20 69 .** iStatement i
22bb0 73 20 31 2e 20 54 68 69 73 20 61 6e 6f 6e 79 6d s 1. This anonym
22bc0 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 20 63 61 ous savepoint ca
22bd0 6e 20 62 65 20 72 65 6c 65 61 73 65 64 20 6f 72 n be released or
22be0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a 2a 2a 20 rolled back.**
22bf0 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 using the sqlite
22c00 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 28 3BtreeSavepoint(
22c10 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 ) function..*/.i
22c20 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 nt sqlite3BtreeB
22c30 65 67 69 6e 53 74 6d 74 28 42 74 72 65 65 20 2a eginStmt(Btree *
22c40 70 2c 20 69 6e 74 20 69 53 74 61 74 65 6d 65 6e p, int iStatemen
22c50 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 t){. int rc;.
22c60 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
22c70 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c 69 74 65 p->pBt;. sqlite
22c80 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
22c90 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 6e 54 assert( p->inT
22ca0 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 rans==TRANS_WRIT
22cb0 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 E );. assert( (
22cc0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
22cd0 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d 3d BTS_READ_ONLY)==
22ce0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 0 );. assert( i
22cf0 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 3b 0a 20 Statement>0 );.
22d00 20 61 73 73 65 72 74 28 20 69 53 74 61 74 65 6d assert( iStatem
22d10 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 61 76 65 ent>p->db->nSave
22d20 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 73 65 72 point );. asser
22d30 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 t( pBt->inTransa
22d40 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 ction==TRANS_WRI
22d50 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 20 74 68 TE );. /* At th
22d60 65 20 70 61 67 65 72 20 6c 65 76 65 6c 2c 20 61 e pager level, a
22d70 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 statement trans
22d80 61 63 74 69 6f 6e 20 69 73 20 61 20 73 61 76 65 action is a save
22d90 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 2a 2a 20 point with. **
22da0 61 6e 20 69 6e 64 65 78 20 67 72 65 61 74 65 72 an index greater
22db0 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 65 70 6f than all savepo
22dc0 69 6e 74 73 20 63 72 65 61 74 65 64 20 65 78 70 ints created exp
22dd0 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 0a 20 20 licitly using.
22de0 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ** SQL statement
22df0 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 67 61 6c s. It is illegal
22e00 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c 65 61 73 to open, releas
22e10 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 61 6e e or rollback an
22e20 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 61 76 65 y. ** such save
22e30 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 74 68 65 points while the
22e40 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 statement trans
22e50 61 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e 74 action savepoint
22e60 20 69 73 20 61 63 74 69 76 65 2e 0a 20 20 2a 2f is active.. */
22e70 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
22e80 61 67 65 72 4f 70 65 6e 53 61 76 65 70 6f 69 6e agerOpenSavepoin
22e90 74 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 69 t(pBt->pPager, i
22ea0 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 20 73 71 Statement);. sq
22eb0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
22ec0 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b p);. return rc;
22ed0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 65 .}../*.** The se
22ee0 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 6f cond argument to
22ef0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 this function,
22f00 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 20 53 41 op, is always SA
22f10 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b VEPOINT_ROLLBACK
22f20 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f 49 4e 54 .** or SAVEPOINT
22f30 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 73 20 66 _RELEASE. This f
22f40 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 72 20 72 unction either r
22f50 65 6c 65 61 73 65 73 20 6f 72 20 72 6f 6c 6c 73 eleases or rolls
22f60 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 73 61 76 back the.** sav
22f70 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 66 69 65 epoint identifie
22f80 64 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 69 d by parameter i
22f90 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 70 65 6e Savepoint, depen
22fa0 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 61 6c 75 ding on the valu
22fb0 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a 2a 2a 0a e .** of op..**.
22fc0 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 53 61 ** Normally, iSa
22fd0 76 65 70 6f 69 6e 74 20 69 73 20 67 72 65 61 74 vepoint is great
22fe0 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c er than or equal
22ff0 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 65 76 65 to zero. Howeve
23000 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a 2a 20 53 r, if op is.** S
23010 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
23020 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 70 6f 69 K, then iSavepoi
23030 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 2d nt may also be -
23040 31 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 1. In this case
23050 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 73 the .** contents
23060 20 6f 66 20 74 68 65 20 65 6e 74 69 72 65 20 74 of the entire t
23070 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 20 72 ransaction are r
23080 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 69 73 olled back. This
23090 20 69 73 20 64 69 66 66 65 72 65 6e 74 0a 2a 2a is different.**
230a0 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 6c 20 74 from a normal t
230b0 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c 62 ransaction rollb
230c0 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f 63 6b 73 ack, as no locks
230d0 20 61 72 65 20 72 65 6c 65 61 73 65 64 20 61 6e are released an
230e0 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 63 d the.** transac
230f0 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 6f 70 65 tion remains ope
23100 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 n..*/.int sqlite
23110 33 42 74 72 65 65 53 61 76 65 70 6f 69 6e 74 28 3BtreeSavepoint(
23120 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 20 6f 70 Btree *p, int op
23130 2c 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 , int iSavepoint
23140 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
23150 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 LITE_OK;. if( p
23160 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d && p->inTrans==
23170 54 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 TRANS_WRITE ){.
23180 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 BtShared *pBt
23190 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 20 20 61 = p->pBt;. a
231a0 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 56 45 50 ssert( op==SAVEP
231b0 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 7c 7c 20 OINT_RELEASE ||
231c0 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f op==SAVEPOINT_RO
231d0 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 20 61 73 LLBACK );. as
231e0 73 65 72 74 28 20 69 53 61 76 65 70 6f 69 6e 74 sert( iSavepoint
231f0 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 70 6f 69 >=0 || (iSavepoi
23200 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d 3d 53 41 nt==-1 && op==SA
23210 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b VEPOINT_ROLLBACK
23220 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ) );. sqlite3
23230 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
23240 20 20 20 69 66 28 20 6f 70 3d 3d 53 41 56 45 50 if( op==SAVEP
23250 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 20 29 7b OINT_ROLLBACK ){
23260 0a 20 20 20 20 20 20 72 63 20 3d 20 73 61 76 65 . rc = save
23270 41 6c 6c 43 75 72 73 6f 72 73 28 70 42 74 2c 20 AllCursors(pBt,
23280 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 20 0, 0);. }.
23290 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
232a0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d OK ){. rc =
232b0 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 61 76 sqlite3PagerSav
232c0 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 epoint(pBt->pPag
232d0 65 72 2c 20 6f 70 2c 20 69 53 61 76 65 70 6f 69 er, op, iSavepoi
232e0 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 nt);. }. i
232f0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
23300 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 69 53 ){. if( iS
23310 61 76 65 70 6f 69 6e 74 3c 30 20 26 26 20 28 70 avepoint<0 && (p
23320 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
23330 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d 50 TS_INITIALLY_EMP
23340 54 59 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 TY)!=0 ){.
23350 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 30 pBt->nPage = 0
23360 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
23370 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 rc = newDatabase
23380 28 70 42 74 29 3b 0a 20 20 20 20 20 20 70 42 74 (pBt);. pBt
23390 2d 3e 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 ->nPage = get4by
233a0 74 65 28 32 38 20 2b 20 70 42 74 2d 3e 70 50 61 te(28 + pBt->pPa
233b0 67 65 31 2d 3e 61 44 61 74 61 29 3b 0a 0a 20 20 ge1->aData);..
233c0 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 /* The datab
233d0 61 73 65 20 73 69 7a 65 20 77 61 73 20 77 72 69 ase size was wri
233e0 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6f 66 tten into the of
233f0 66 73 65 74 20 32 38 20 6f 66 20 74 68 65 20 68 fset 28 of the h
23400 65 61 64 65 72 0a 20 20 20 20 20 20 2a 2a 20 77 eader. ** w
23410 68 65 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74 hen the transact
23420 69 6f 6e 20 73 74 61 72 74 65 64 2c 20 73 6f 20 ion started, so
23430 77 65 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 we know that the
23440 20 76 61 6c 75 65 20 61 74 20 6f 66 66 73 65 74 value at offset
23450 0a 20 20 20 20 20 20 2a 2a 20 32 38 20 69 73 20 . ** 28 is
23460 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a 20 20 20 20 nonzero. */.
23470 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 6e assert( pBt->n
23480 50 61 67 65 3e 30 20 29 3b 0a 20 20 20 20 7d 0a Page>0 );. }.
23490 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
234a0 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 20 Leave(p);. }.
234b0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
234c0 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 .** Create a new
234d0 20 63 75 72 73 6f 72 20 66 6f 72 20 74 68 65 20 cursor for the
234e0 42 54 72 65 65 20 77 68 6f 73 65 20 72 6f 6f 74 BTree whose root
234f0 20 69 73 20 6f 6e 20 74 68 65 20 70 61 67 65 0a is on the page.
23500 2a 2a 20 69 54 61 62 6c 65 2e 20 49 66 20 61 20 ** iTable. If a
23510 72 65 61 64 2d 6f 6e 6c 79 20 63 75 72 73 6f 72 read-only cursor
23520 20 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 69 is requested, i
23530 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 t is assumed tha
23540 74 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 20 t.** the caller
23550 61 6c 72 65 61 64 79 20 68 61 73 20 61 74 20 6c already has at l
23560 65 61 73 74 20 61 20 72 65 61 64 2d 6f 6e 6c 79 east a read-only
23570 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 transaction ope
23580 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 64 61 74 61 n.** on the data
23590 62 61 73 65 20 61 6c 72 65 61 64 79 2e 20 49 66 base already. If
235a0 20 61 20 77 72 69 74 65 2d 63 75 72 73 6f 72 20 a write-cursor
235b0 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 68 is requested, th
235c0 65 6e 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 en.** the caller
235d0 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 68 is assumed to h
235e0 61 76 65 20 61 6e 20 6f 70 65 6e 20 77 72 69 74 ave an open writ
235f0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a e transaction..*
23600 2a 0a 2a 2a 20 49 66 20 74 68 65 20 42 54 52 45 *.** If the BTRE
23610 45 5f 57 52 43 53 52 20 62 69 74 20 6f 66 20 77 E_WRCSR bit of w
23620 72 46 6c 61 67 20 69 73 20 63 6c 65 61 72 2c 20 rFlag is clear,
23630 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 20 then the cursor
23640 63 61 6e 20 6f 6e 6c 79 0a 2a 2a 20 62 65 20 75 can only.** be u
23650 73 65 64 20 66 6f 72 20 72 65 61 64 69 6e 67 2e sed for reading.
23660 20 20 49 66 20 74 68 65 20 42 54 52 45 45 5f 57 If the BTREE_W
23670 52 43 53 52 20 62 69 74 20 69 73 20 73 65 74 2c RCSR bit is set,
23680 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
23690 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 .** can be used
236a0 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 20 66 for reading or f
236b0 6f 72 20 77 72 69 74 69 6e 67 20 69 66 20 6f 74 or writing if ot
236c0 68 65 72 20 63 6f 6e 64 69 74 69 6f 6e 73 20 66 her conditions f
236d0 6f 72 20 77 72 69 74 69 6e 67 0a 2a 2a 20 61 72 or writing.** ar
236e0 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 54 68 65 e also met. The
236f0 73 65 20 61 72 65 20 74 68 65 20 63 6f 6e 64 69 se are the condi
23700 74 69 6f 6e 73 20 74 68 61 74 20 6d 75 73 74 20 tions that must
23710 62 65 20 6d 65 74 20 69 6e 20 6f 72 64 65 72 0a be met in order.
23720 2a 2a 20 66 6f 72 20 77 72 69 74 69 6e 67 20 74 ** for writing t
23730 6f 20 62 65 20 61 6c 6c 6f 77 65 64 3a 0a 2a 2a o be allowed:.**
23740 0a 2a 2a 20 31 3a 20 20 54 68 65 20 63 75 72 73 .** 1: The curs
23750 6f 72 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 or must have bee
23760 6e 20 6f 70 65 6e 65 64 20 77 69 74 68 20 77 72 n opened with wr
23770 46 6c 61 67 20 63 6f 6e 74 61 69 6e 69 6e 67 20 Flag containing
23780 42 54 52 45 45 5f 57 52 43 53 52 0a 2a 2a 0a 2a BTREE_WRCSR.**.*
23790 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 61 74 61 * 2: Other data
237a0 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
237b0 20 74 68 61 74 20 73 68 61 72 65 20 74 68 65 20 that share the
237c0 73 61 6d 65 20 70 61 67 65 72 20 63 61 63 68 65 same pager cache
237d0 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 68 69 63 .** but whic
237e0 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 h are not in the
237f0 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 READ_UNCOMMITTE
23800 44 20 73 74 61 74 65 20 6d 61 79 20 6e 6f 74 20 D state may not
23810 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 72 73 have.** curs
23820 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 20 77 72 ors open with wr
23830 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 20 73 Flag==0 on the s
23840 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 68 65 ame table. Othe
23850 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 68 65 rwise.** the
23860 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 62 79 changes made by
23870 20 74 68 69 73 20 77 72 69 74 65 20 63 75 72 73 this write curs
23880 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 69 73 69 or would be visi
23890 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 74 68 ble to.** th
238a0 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 69 e read cursors i
238b0 6e 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 61 n the other data
238c0 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e base connection.
238d0 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 20 64 .**.** 3: The d
238e0 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 atabase must be
238f0 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 6f 6e writable (not on
23900 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 61 read-only media
23910 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 65 72 ).**.** 4: Ther
23920 65 20 6d 75 73 74 20 62 65 20 61 6e 20 61 63 74 e must be an act
23930 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e ive transaction.
23940 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 54 52 45 45 .**.** The BTREE
23950 5f 46 4f 52 44 45 4c 45 54 45 20 62 69 74 20 6f _FORDELETE bit o
23960 66 20 77 72 46 6c 61 67 20 6d 61 79 20 6f 70 74 f wrFlag may opt
23970 69 6f 6e 61 6c 6c 79 20 62 65 20 73 65 74 20 69 ionally be set i
23980 66 20 42 54 52 45 45 5f 57 52 43 53 52 0a 2a 2a f BTREE_WRCSR.**
23990 20 69 73 20 73 65 74 2e 20 20 49 66 20 46 4f 52 is set. If FOR
239a0 44 45 4c 45 54 45 20 69 73 20 73 65 74 2c 20 74 DELETE is set, t
239b0 68 61 74 20 69 73 20 61 20 68 69 6e 74 20 74 6f hat is a hint to
239c0 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 the implementat
239d0 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 69 73 ion that.** this
239e0 20 63 75 72 73 6f 72 20 77 69 6c 6c 20 6f 6e 6c cursor will onl
239f0 79 20 62 65 20 75 73 65 64 20 74 6f 20 73 65 65 y be used to see
23a00 6b 20 74 6f 20 61 6e 64 20 64 65 6c 65 74 65 20 k to and delete
23a10 65 6e 74 72 69 65 73 20 6f 66 20 61 6e 20 69 6e entries of an in
23a20 64 65 78 0a 2a 2a 20 61 73 20 70 61 72 74 20 6f dex.** as part o
23a30 66 20 61 20 6c 61 72 67 65 72 20 44 45 4c 45 54 f a larger DELET
23a40 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 68 E statement. Th
23a50 65 20 46 4f 52 44 45 4c 45 54 45 20 68 69 6e 74 e FORDELETE hint
23a60 20 69 73 20 6e 6f 74 20 75 73 65 64 20 62 79 0a is not used by.
23a70 2a 2a 20 74 68 69 73 20 69 6d 70 6c 65 6d 65 6e ** this implemen
23a80 74 61 74 69 6f 6e 2e 20 20 42 75 74 20 69 6e 20 tation. But in
23a90 61 20 68 79 70 6f 74 68 65 74 69 63 61 6c 20 61 a hypothetical a
23aa0 6c 74 65 72 6e 61 74 69 76 65 20 73 74 6f 72 61 lternative stora
23ab0 67 65 20 65 6e 67 69 6e 65 20 0a 2a 2a 20 69 6e ge engine .** in
23ac0 20 77 68 69 63 68 20 69 6e 64 65 78 20 65 6e 74 which index ent
23ad0 72 69 65 73 20 61 72 65 20 61 75 74 6f 6d 61 74 ries are automat
23ae0 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 77 ically deleted w
23af0 68 65 6e 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e hen correspondin
23b00 67 20 74 61 62 6c 65 0a 2a 2a 20 72 6f 77 73 20 g table.** rows
23b10 61 72 65 20 64 65 6c 65 74 65 64 2c 20 74 68 65 are deleted, the
23b20 20 46 4f 52 44 45 4c 45 54 45 20 66 6c 61 67 20 FORDELETE flag
23b30 69 73 20 61 20 68 69 6e 74 20 74 68 61 74 20 61 is a hint that a
23b40 6c 6c 20 53 45 45 4b 20 61 6e 64 20 44 45 4c 45 ll SEEK and DELE
23b50 54 45 0a 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 73 TE.** operations
23b60 20 6f 6e 20 74 68 69 73 20 63 75 72 73 6f 72 20 on this cursor
23b70 63 61 6e 20 62 65 20 6e 6f 2d 6f 70 73 20 61 6e can be no-ops an
23b80 64 20 61 6c 6c 20 52 45 41 44 20 6f 70 65 72 61 d all READ opera
23b90 74 69 6f 6e 73 20 63 61 6e 20 0a 2a 2a 20 72 65 tions can .** re
23ba0 74 75 72 6e 20 61 20 6e 75 6c 6c 20 72 6f 77 20 turn a null row
23bb0 28 32 2d 62 79 74 65 73 3a 20 30 78 30 31 20 30 (2-bytes: 0x01 0
23bc0 78 30 30 29 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 20 63 x00)..**.** No c
23bd0 68 65 63 6b 69 6e 67 20 69 73 20 64 6f 6e 65 20 hecking is done
23be0 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 to make sure tha
23bf0 74 20 70 61 67 65 20 69 54 61 62 6c 65 20 72 65 t page iTable re
23c00 61 6c 6c 79 20 69 73 20 74 68 65 0a 2a 2a 20 72 ally is the.** r
23c10 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 20 62 2d oot page of a b-
23c20 74 72 65 65 2e 20 20 49 66 20 69 74 20 69 73 20 tree. If it is
23c30 6e 6f 74 2c 20 74 68 65 6e 20 74 68 65 20 63 75 not, then the cu
23c40 72 73 6f 72 20 61 63 71 75 69 72 65 64 0a 2a 2a rsor acquired.**
23c50 20 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 63 will not work c
23c60 6f 72 72 65 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 orrectly..**.**
23c70 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68 It is assumed th
23c80 61 74 20 74 68 65 20 73 71 6c 69 74 65 33 42 74 at the sqlite3Bt
23c90 72 65 65 43 75 72 73 6f 72 5a 65 72 6f 28 29 20 reeCursorZero()
23ca0 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 0a has been called.
23cb0 2a 2a 20 6f 6e 20 70 43 75 72 20 74 6f 20 69 6e ** on pCur to in
23cc0 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6d 65 6d itialize the mem
23cd0 6f 72 79 20 73 70 61 63 65 20 70 72 69 6f 72 20 ory space prior
23ce0 74 6f 20 69 6e 76 6f 6b 69 6e 67 20 74 68 69 73 to invoking this
23cf0 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 routine..*/.sta
23d00 74 69 63 20 69 6e 74 20 62 74 72 65 65 43 75 72 tic int btreeCur
23d10 73 6f 72 28 0a 20 20 42 74 72 65 65 20 2a 70 2c sor(. Btree *p,
23d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23d40 20 54 68 65 20 62 74 72 65 65 20 2a 2f 0a 20 20 The btree */.
23d50 69 6e 74 20 69 54 61 62 6c 65 2c 20 20 20 20 20 int iTable,
23d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d70 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 /* Root p
23d80 61 67 65 20 6f 66 20 74 61 62 6c 65 20 74 6f 20 age of table to
23d90 6f 70 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 72 open */. int wr
23da0 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 20 Flag,
23db0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23dc0 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 65 2e 20 /* 1 to write.
23dd0 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 0 read-only */.
23de0 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 struct KeyInfo
23df0 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 20 20 20 *pKeyInfo,
23e00 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
23e10 20 61 72 67 20 74 6f 20 63 6f 6d 70 61 72 69 73 arg to comparis
23e20 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 on function */.
23e30 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 20 BtCursor *pCur
23e40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23e50 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 65 /* Space
23e60 20 66 6f 72 20 6e 65 77 20 63 75 72 73 6f 72 20 for new cursor
23e70 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 72 65 64 */.){. BtShared
23e80 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 20 *pBt = p->pBt;
23e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23ea0 2a 20 53 68 61 72 65 64 20 62 2d 74 72 65 65 20 * Shared b-tree
23eb0 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 42 74 43 75 handle */. BtCu
23ec0 72 73 6f 72 20 2a 70 58 3b 20 20 20 20 20 20 20 rsor *pX;
23ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23ee0 20 20 20 2f 2a 20 4c 6f 6f 70 69 6e 67 20 6f 76 /* Looping ov
23ef0 65 72 20 6f 74 68 65 72 20 61 6c 6c 20 63 75 72 er other all cur
23f00 73 6f 72 73 20 2a 2f 0a 0a 20 20 61 73 73 65 72 sors */.. asser
23f10 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 t( sqlite3BtreeH
23f20 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a oldsMutex(p) );.
23f30 20 20 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 assert( wrFlag
23f40 3d 3d 30 20 0a 20 20 20 20 20 20 20 7c 7c 20 77 ==0 . || w
23f50 72 46 6c 61 67 3d 3d 42 54 52 45 45 5f 57 52 43 rFlag==BTREE_WRC
23f60 53 52 20 0a 20 20 20 20 20 20 20 7c 7c 20 77 72 SR . || wr
23f70 46 6c 61 67 3d 3d 28 42 54 52 45 45 5f 57 52 43 Flag==(BTREE_WRC
23f80 53 52 7c 42 54 52 45 45 5f 46 4f 52 44 45 4c 45 SR|BTREE_FORDELE
23f90 54 45 29 20 0a 20 20 29 3b 0a 0a 20 20 2f 2a 20 TE) . );.. /*
23fa0 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 The following as
23fb0 73 65 72 74 20 73 74 61 74 65 6d 65 6e 74 73 20 sert statements
23fc0 76 65 72 69 66 79 20 74 68 61 74 20 69 66 20 74 verify that if t
23fd0 68 69 73 20 69 73 20 61 20 73 68 61 72 61 62 6c his is a sharabl
23fe0 65 20 0a 20 20 2a 2a 20 62 2d 74 72 65 65 20 64 e . ** b-tree d
23ff0 61 74 61 62 61 73 65 2c 20 74 68 65 20 63 6f 6e atabase, the con
24000 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 nection is holdi
24010 6e 67 20 74 68 65 20 72 65 71 75 69 72 65 64 20 ng the required
24020 74 61 62 6c 65 20 6c 6f 63 6b 73 2c 20 0a 20 20 table locks, .
24030 2a 2a 20 61 6e 64 20 74 68 61 74 20 6e 6f 20 6f ** and that no o
24040 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 ther connection
24050 68 61 73 20 61 6e 79 20 6f 70 65 6e 20 63 75 72 has any open cur
24060 73 6f 72 20 74 68 61 74 20 63 6f 6e 66 6c 69 63 sor that conflic
24070 74 73 20 77 69 74 68 20 0a 20 20 2a 2a 20 74 68 ts with . ** th
24080 69 73 20 6c 6f 63 6b 2e 20 20 2a 2f 0a 20 20 61 is lock. */. a
24090 73 73 65 72 74 28 20 68 61 73 53 68 61 72 65 64 ssert( hasShared
240a0 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 70 CacheTableLock(p
240b0 2c 20 69 54 61 62 6c 65 2c 20 70 4b 65 79 49 6e , iTable, pKeyIn
240c0 66 6f 21 3d 30 2c 20 28 77 72 46 6c 61 67 3f 32 fo!=0, (wrFlag?2
240d0 3a 31 29 29 20 29 3b 0a 20 20 61 73 73 65 72 74 :1)) );. assert
240e0 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 21 ( wrFlag==0 || !
240f0 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 hasReadConflicts
24100 28 70 2c 20 69 54 61 62 6c 65 29 20 29 3b 0a 0a (p, iTable) );..
24110 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 /* Assert that
24120 20 74 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 the caller has
24130 6f 70 65 6e 65 64 20 74 68 65 20 72 65 71 75 69 opened the requi
24140 72 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e red transaction.
24150 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d */. assert( p-
24160 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f 4e >inTrans>TRANS_N
24170 4f 4e 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ONE );. assert(
24180 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 70 2d wrFlag==0 || p-
24190 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f >inTrans==TRANS_
241a0 57 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 WRITE );. asser
241b0 74 28 20 70 42 74 2d 3e 70 50 61 67 65 31 20 26 t( pBt->pPage1 &
241c0 26 20 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 & pBt->pPage1->a
241d0 44 61 74 61 20 29 3b 0a 20 20 61 73 73 65 72 74 Data );. assert
241e0 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c 7c 20 28 ( wrFlag==0 || (
241f0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 pBt->btsFlags &
24200 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 3d 3d BTS_READ_ONLY)==
24210 30 20 29 3b 0a 0a 20 20 69 66 28 20 77 72 46 6c 0 );.. if( wrFl
24220 61 67 20 29 7b 0a 20 20 20 20 61 6c 6c 6f 63 61 ag ){. alloca
24230 74 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 29 teTempSpace(pBt)
24240 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 70 ;. if( pBt->p
24250 54 6d 70 53 70 61 63 65 3d 3d 30 20 29 20 72 65 TmpSpace==0 ) re
24260 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
24270 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 69 66 M_BKPT;. }. if
24280 28 20 69 54 61 62 6c 65 3d 3d 31 20 26 26 20 62 ( iTable==1 && b
24290 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 treePagecount(pB
242a0 74 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 t)==0 ){. ass
242b0 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 29 ert( wrFlag==0 )
242c0 3b 0a 20 20 20 20 69 54 61 62 6c 65 20 3d 20 30 ;. iTable = 0
242d0 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 ;. }.. /* Now
242e0 74 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 65 72 that no other er
242f0 72 6f 72 73 20 63 61 6e 20 6f 63 63 75 72 2c 20 rors can occur,
24300 66 69 6e 69 73 68 20 66 69 6c 6c 69 6e 67 20 69 finish filling i
24310 6e 20 74 68 65 20 42 74 43 75 72 73 6f 72 0a 20 n the BtCursor.
24320 20 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 61 6e ** variables an
24330 64 20 6c 69 6e 6b 20 74 68 65 20 63 75 72 73 6f d link the curso
24340 72 20 69 6e 74 6f 20 74 68 65 20 42 74 53 68 61 r into the BtSha
24350 72 65 64 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 red list. */.
24360 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 3d pCur->pgnoRoot =
24370 20 28 50 67 6e 6f 29 69 54 61 62 6c 65 3b 0a 20 (Pgno)iTable;.
24380 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d pCur->iPage = -
24390 31 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 1;. pCur->pKeyI
243a0 6e 66 6f 20 3d 20 70 4b 65 79 49 6e 66 6f 3b 0a nfo = pKeyInfo;.
243b0 20 20 70 43 75 72 2d 3e 70 42 74 72 65 65 20 3d pCur->pBtree =
243c0 20 70 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 20 p;. pCur->pBt
243d0 3d 20 70 42 74 3b 0a 20 20 70 43 75 72 2d 3e 63 = pBt;. pCur->c
243e0 75 72 46 6c 61 67 73 20 3d 20 77 72 46 6c 61 67 urFlags = wrFlag
243f0 20 3f 20 42 54 43 46 5f 57 72 69 74 65 46 6c 61 ? BTCF_WriteFla
24400 67 20 3a 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 g : 0;. pCur->c
24410 75 72 50 61 67 65 72 46 6c 61 67 73 20 3d 20 77 urPagerFlags = w
24420 72 46 6c 61 67 20 3f 20 30 20 3a 20 50 41 47 45 rFlag ? 0 : PAGE
24430 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c 59 3b 0a R_GET_READONLY;.
24440 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 /* If there ar
24450 65 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 63 75 e two or more cu
24460 72 73 6f 72 73 20 6f 6e 20 74 68 65 20 73 61 6d rsors on the sam
24470 65 20 62 74 72 65 65 2c 20 74 68 65 6e 20 61 6c e btree, then al
24480 6c 20 73 75 63 68 0a 20 20 2a 2a 20 63 75 72 73 l such. ** curs
24490 6f 72 73 20 2a 6d 75 73 74 2a 20 68 61 76 65 20 ors *must* have
244a0 74 68 65 20 42 54 43 46 5f 4d 75 6c 74 69 70 6c the BTCF_Multipl
244b0 65 20 66 6c 61 67 20 73 65 74 2e 20 2a 2f 0a 20 e flag set. */.
244c0 20 66 6f 72 28 70 58 3d 70 42 74 2d 3e 70 43 75 for(pX=pBt->pCu
244d0 72 73 6f 72 3b 20 70 58 3b 20 70 58 3d 70 58 2d rsor; pX; pX=pX-
244e0 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 >pNext){. if(
244f0 20 70 58 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 28 pX->pgnoRoot==(
24500 50 67 6e 6f 29 69 54 61 62 6c 65 20 29 7b 0a 20 Pgno)iTable ){.
24510 20 20 20 20 20 70 58 2d 3e 63 75 72 46 6c 61 67 pX->curFlag
24520 73 20 7c 3d 20 42 54 43 46 5f 4d 75 6c 74 69 70 s |= BTCF_Multip
24530 6c 65 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e le;. pCur->
24540 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 curFlags |= BTCF
24550 5f 4d 75 6c 74 69 70 6c 65 3b 0a 20 20 20 20 7d _Multiple;. }
24560 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 70 4e 65 . }. pCur->pNe
24570 78 74 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f xt = pBt->pCurso
24580 72 3b 0a 20 20 70 42 74 2d 3e 70 43 75 72 73 6f r;. pBt->pCurso
24590 72 20 3d 20 70 43 75 72 3b 0a 20 20 70 43 75 72 r = pCur;. pCur
245a0 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f ->eState = CURSO
245b0 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 72 65 74 R_INVALID;. ret
245c0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
245d0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
245e0 65 43 75 72 73 6f 72 28 0a 20 20 42 74 72 65 65 eCursor(. Btree
245f0 20 2a 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 *p,
24600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24610 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 /* The bt
24620 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 54 61 ree */. int iTa
24630 62 6c 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 ble,
24640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24650 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 /* Root pag
24660 65 20 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f 70 e of table to op
24670 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 6c en */. int wrFl
24680 61 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ag,
24690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
246a0 20 20 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 /* 1 to writ
246b0 65 2e 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a e. 0 read-only *
246c0 2f 0a 20 20 73 74 72 75 63 74 20 4b 65 79 49 6e /. struct KeyIn
246d0 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 fo *pKeyInfo,
246e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
246f0 2f 2a 20 46 69 72 73 74 20 61 72 67 20 74 6f 20 /* First arg to
24700 78 43 6f 6d 70 61 72 65 28 29 20 2a 2f 0a 20 20 xCompare() */.
24710 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 20 20 BtCursor *pCur
24720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24730 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
24740 72 69 74 65 20 6e 65 77 20 63 75 72 73 6f 72 20 rite new cursor
24750 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
24760 20 72 63 3b 0a 20 20 69 66 28 20 69 54 61 62 6c rc;. if( iTabl
24770 65 3c 31 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 e<1 ){. rc =
24780 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
24790 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 KPT;. }else{.
247a0 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e sqlite3BtreeEn
247b0 74 65 72 28 70 29 3b 0a 20 20 20 20 72 63 20 3d ter(p);. rc =
247c0 20 62 74 72 65 65 43 75 72 73 6f 72 28 70 2c 20 btreeCursor(p,
247d0 69 54 61 62 6c 65 2c 20 77 72 46 6c 61 67 2c 20 iTable, wrFlag,
247e0 70 4b 65 79 49 6e 66 6f 2c 20 70 43 75 72 29 3b pKeyInfo, pCur);
247f0 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
24800 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 7d 0a 20 eLeave(p);. }.
24810 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
24820 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
24830 73 69 7a 65 20 6f 66 20 61 20 42 74 43 75 72 73 size of a BtCurs
24840 6f 72 20 6f 62 6a 65 63 74 20 69 6e 20 62 79 74 or object in byt
24850 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 es..**.** This i
24860 6e 74 65 72 66 61 63 65 73 20 69 73 20 6e 65 65 nterfaces is nee
24870 64 65 64 20 73 6f 20 74 68 61 74 20 75 73 65 72 ded so that user
24880 73 20 6f 66 20 63 75 72 73 6f 72 73 20 63 61 6e s of cursors can
24890 20 70 72 65 61 6c 6c 6f 63 61 74 65 0a 2a 2a 20 preallocate.**
248a0 73 75 66 66 69 63 69 65 6e 74 20 73 74 6f 72 61 sufficient stora
248b0 67 65 20 74 6f 20 68 6f 6c 64 20 61 20 63 75 72 ge to hold a cur
248c0 73 6f 72 2e 20 20 54 68 65 20 42 74 43 75 72 73 sor. The BtCurs
248d0 6f 72 20 6f 62 6a 65 63 74 20 69 73 20 6f 70 61 or object is opa
248e0 71 75 65 0a 2a 2a 20 74 6f 20 75 73 65 72 73 20 que.** to users
248f0 73 6f 20 74 68 65 79 20 63 61 6e 6e 6f 74 20 64 so they cannot d
24900 6f 20 74 68 65 20 73 69 7a 65 6f 66 28 29 20 74 o the sizeof() t
24910 68 65 6d 73 65 6c 76 65 73 20 2d 20 74 68 65 79 hemselves - they
24920 20 6d 75 73 74 20 63 61 6c 6c 0a 2a 2a 20 74 68 must call.** th
24930 69 73 20 72 6f 75 74 69 6e 65 2e 0a 2a 2f 0a 69 is routine..*/.i
24940 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 nt sqlite3BtreeC
24950 75 72 73 6f 72 53 69 7a 65 28 76 6f 69 64 29 7b ursorSize(void){
24960 0a 20 20 72 65 74 75 72 6e 20 52 4f 55 4e 44 38 . return ROUND8
24970 28 73 69 7a 65 6f 66 28 42 74 43 75 72 73 6f 72 (sizeof(BtCursor
24980 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 ));.}../*.** Ini
24990 74 69 61 6c 69 7a 65 20 6d 65 6d 6f 72 79 20 74 tialize memory t
249a0 68 61 74 20 77 69 6c 6c 20 62 65 20 63 6f 6e 76 hat will be conv
249b0 65 72 74 65 64 20 69 6e 74 6f 20 61 20 42 74 43 erted into a BtC
249c0 75 72 73 6f 72 20 6f 62 6a 65 63 74 2e 0a 2a 2a ursor object..**
249d0 0a 2a 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 61 .** The simple a
249e0 70 70 72 6f 61 63 68 20 68 65 72 65 20 77 6f 75 pproach here wou
249f0 6c 64 20 62 65 20 74 6f 20 6d 65 6d 73 65 74 28 ld be to memset(
24a00 29 20 74 68 65 20 65 6e 74 69 72 65 20 6f 62 6a ) the entire obj
24a10 65 63 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f 2e 20 ect.** to zero.
24a20 20 42 75 74 20 69 74 20 74 75 72 6e 73 20 6f 75 But it turns ou
24a30 74 20 74 68 61 74 20 74 68 65 20 61 70 50 61 67 t that the apPag
24a40 65 5b 5d 20 61 6e 64 20 61 69 49 64 78 5b 5d 20 e[] and aiIdx[]
24a50 61 72 72 61 79 73 0a 2a 2a 20 64 6f 20 6e 6f 74 arrays.** do not
24a60 20 6e 65 65 64 20 74 6f 20 62 65 20 7a 65 72 6f need to be zero
24a70 65 64 20 61 6e 64 20 74 68 65 79 20 61 72 65 20 ed and they are
24a80 6c 61 72 67 65 2c 20 73 6f 20 77 65 20 63 61 6e large, so we can
24a90 20 73 61 76 65 20 61 20 6c 6f 74 0a 2a 2a 20 6f save a lot.** o
24aa0 66 20 72 75 6e 2d 74 69 6d 65 20 62 79 20 73 6b f run-time by sk
24ab0 69 70 70 69 6e 67 20 74 68 65 20 69 6e 69 74 69 ipping the initi
24ac0 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 68 6f alization of tho
24ad0 73 65 20 65 6c 65 6d 65 6e 74 73 2e 0a 2a 2f 0a se elements..*/.
24ae0 76 6f 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 void sqlite3Btre
24af0 65 43 75 72 73 6f 72 5a 65 72 6f 28 42 74 43 75 eCursorZero(BtCu
24b00 72 73 6f 72 20 2a 70 29 7b 0a 20 20 6d 65 6d 73 rsor *p){. mems
24b10 65 74 28 70 2c 20 30 2c 20 6f 66 66 73 65 74 6f et(p, 0, offseto
24b20 66 28 42 74 43 75 72 73 6f 72 2c 20 42 54 43 55 f(BtCursor, BTCU
24b30 52 53 4f 52 5f 46 49 52 53 54 5f 55 4e 49 4e 49 RSOR_FIRST_UNINI
24b40 54 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c T));.}../*.** Cl
24b50 6f 73 65 20 61 20 63 75 72 73 6f 72 2e 20 20 54 ose a cursor. T
24b60 68 65 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 he read lock on
24b70 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
24b80 65 20 69 73 20 72 65 6c 65 61 73 65 64 0a 2a 2a e is released.**
24b90 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 63 when the last c
24ba0 75 72 73 6f 72 20 69 73 20 63 6c 6f 73 65 64 2e ursor is closed.
24bb0 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 .*/.int sqlite3B
24bc0 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 treeCloseCursor(
24bd0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
24be0 0a 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 65 . Btree *pBtree
24bf0 20 3d 20 70 43 75 72 2d 3e 70 42 74 72 65 65 3b = pCur->pBtree;
24c00 0a 20 20 69 66 28 20 70 42 74 72 65 65 20 29 7b . if( pBtree ){
24c10 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a 70 . BtShared *p
24c20 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a Bt = pCur->pBt;.
24c30 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
24c40 45 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 Enter(pBtree);.
24c50 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e assert( pBt->
24c60 70 43 75 72 73 6f 72 21 3d 30 20 29 3b 0a 20 20 pCursor!=0 );.
24c70 20 20 69 66 28 20 70 42 74 2d 3e 70 43 75 72 73 if( pBt->pCurs
24c80 6f 72 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 20 or==pCur ){.
24c90 20 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 3d pBt->pCursor =
24ca0 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 pCur->pNext;.
24cb0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 42 }else{. B
24cc0 74 43 75 72 73 6f 72 20 2a 70 50 72 65 76 20 3d tCursor *pPrev =
24cd0 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a 20 pBt->pCursor;.
24ce0 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 20 do{.
24cf0 20 69 66 28 20 70 50 72 65 76 2d 3e 70 4e 65 78 if( pPrev->pNex
24d00 74 3d 3d 70 43 75 72 20 29 7b 0a 20 20 20 20 20 t==pCur ){.
24d10 20 20 20 20 20 70 50 72 65 76 2d 3e 70 4e 65 78 pPrev->pNex
24d20 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b t = pCur->pNext;
24d30 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b . break
24d40 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
24d50 20 20 20 20 70 50 72 65 76 20 3d 20 70 50 72 65 pPrev = pPre
24d60 76 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 v->pNext;.
24d70 7d 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 70 }while( ALWAYS(p
24d80 50 72 65 76 29 20 29 3b 0a 20 20 20 20 7d 0a 20 Prev) );. }.
24d90 20 20 20 62 74 72 65 65 52 65 6c 65 61 73 65 41 btreeReleaseA
24da0 6c 6c 43 75 72 73 6f 72 50 61 67 65 73 28 70 43 llCursorPages(pC
24db0 75 72 29 3b 0a 20 20 20 20 75 6e 6c 6f 63 6b 42 ur);. unlockB
24dc0 74 72 65 65 49 66 55 6e 75 73 65 64 28 70 42 74 treeIfUnused(pBt
24dd0 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 );. sqlite3_f
24de0 72 65 65 28 70 43 75 72 2d 3e 61 4f 76 65 72 66 ree(pCur->aOverf
24df0 6c 6f 77 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 low);. sqlite
24e00 33 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 3_free(pCur->pKe
24e10 79 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 y);. sqlite3B
24e20 74 72 65 65 4c 65 61 76 65 28 70 42 74 72 65 65 treeLeave(pBtree
24e30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
24e40 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
24e50 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 .** Make sure th
24e60 65 20 42 74 43 75 72 73 6f 72 2a 20 67 69 76 65 e BtCursor* give
24e70 6e 20 69 6e 20 74 68 65 20 61 72 67 75 6d 65 6e n in the argumen
24e80 74 20 68 61 73 20 61 20 76 61 6c 69 64 0a 2a 2a t has a valid.**
24e90 20 42 74 43 75 72 73 6f 72 2e 69 6e 66 6f 20 73 BtCursor.info s
24ea0 74 72 75 63 74 75 72 65 2e 20 20 49 66 20 69 74 tructure. If it
24eb0 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
24ec0 76 61 6c 69 64 2c 20 63 61 6c 6c 0a 2a 2a 20 62 valid, call.** b
24ed0 74 72 65 65 50 61 72 73 65 43 65 6c 6c 28 29 20 treeParseCell()
24ee0 74 6f 20 66 69 6c 6c 20 69 74 20 69 6e 2e 0a 2a to fill it in..*
24ef0 2a 0a 2a 2a 20 42 74 43 75 72 73 6f 72 2e 69 6e *.** BtCursor.in
24f00 66 6f 20 69 73 20 61 20 63 61 63 68 65 20 6f 66 fo is a cache of
24f10 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e the information
24f20 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 in the current
24f30 63 65 6c 6c 2e 0a 2a 2a 20 55 73 69 6e 67 20 74 cell..** Using t
24f40 68 69 73 20 63 61 63 68 65 20 72 65 64 75 63 65 his cache reduce
24f50 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
24f60 63 61 6c 6c 73 20 74 6f 20 62 74 72 65 65 50 61 calls to btreePa
24f70 72 73 65 43 65 6c 6c 28 29 2e 0a 2a 2f 0a 23 69 rseCell()..*/.#i
24f80 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 73 fndef NDEBUG. s
24f90 74 61 74 69 63 20 69 6e 74 20 63 65 6c 6c 49 6e tatic int cellIn
24fa0 66 6f 45 71 75 61 6c 28 43 65 6c 6c 49 6e 66 6f foEqual(CellInfo
24fb0 20 2a 61 2c 20 43 65 6c 6c 49 6e 66 6f 20 2a 62 *a, CellInfo *b
24fc0 29 7b 0a 20 20 20 20 69 66 28 20 61 2d 3e 6e 4b ){. if( a->nK
24fd0 65 79 21 3d 62 2d 3e 6e 4b 65 79 20 29 20 72 65 ey!=b->nKey ) re
24fe0 74 75 72 6e 20 30 3b 0a 20 20 20 20 69 66 28 20 turn 0;. if(
24ff0 61 2d 3e 70 50 61 79 6c 6f 61 64 21 3d 62 2d 3e a->pPayload!=b->
25000 70 50 61 79 6c 6f 61 64 20 29 20 72 65 74 75 72 pPayload ) retur
25010 6e 20 30 3b 0a 20 20 20 20 69 66 28 20 61 2d 3e n 0;. if( a->
25020 6e 50 61 79 6c 6f 61 64 21 3d 62 2d 3e 6e 50 61 nPayload!=b->nPa
25030 79 6c 6f 61 64 20 29 20 72 65 74 75 72 6e 20 30 yload ) return 0
25040 3b 0a 20 20 20 20 69 66 28 20 61 2d 3e 6e 4c 6f ;. if( a->nLo
25050 63 61 6c 21 3d 62 2d 3e 6e 4c 6f 63 61 6c 20 29 cal!=b->nLocal )
25060 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 69 return 0;. i
25070 66 28 20 61 2d 3e 6e 53 69 7a 65 21 3d 62 2d 3e f( a->nSize!=b->
25080 6e 53 69 7a 65 20 29 20 72 65 74 75 72 6e 20 30 nSize ) return 0
25090 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a ;. return 1;.
250a0 20 20 7d 0a 20 20 73 74 61 74 69 63 20 76 6f 69 }. static voi
250b0 64 20 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f d assertCellInfo
250c0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
250d0 7b 0a 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 {. CellInfo i
250e0 6e 66 6f 3b 0a 20 20 20 20 6d 65 6d 73 65 74 28 nfo;. memset(
250f0 26 69 6e 66 6f 2c 20 30 2c 20 73 69 7a 65 6f 66 &info, 0, sizeof
25100 28 69 6e 66 6f 29 29 3b 0a 20 20 20 20 62 74 72 (info));. btr
25110 65 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 eeParseCell(pCur
25120 2d 3e 70 50 61 67 65 2c 20 70 43 75 72 2d 3e 69 ->pPage, pCur->i
25130 78 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 61 x, &info);. a
25140 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f 44 ssert( CORRUPT_D
25150 42 20 7c 7c 20 63 65 6c 6c 49 6e 66 6f 45 71 75 B || cellInfoEqu
25160 61 6c 28 26 69 6e 66 6f 2c 20 26 70 43 75 72 2d al(&info, &pCur-
25170 3e 69 6e 66 6f 29 20 29 3b 0a 20 20 7d 0a 23 65 >info) );. }.#e
25180 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 61 73 lse. #define as
25190 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 78 29 0a sertCellInfo(x).
251a0 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 53 51 #endif.static SQ
251b0 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 76 6f LITE_NOINLINE vo
251c0 69 64 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 42 id getCellInfo(B
251d0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
251e0 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f if( pCur->info
251f0 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 0a 20 20 20 .nSize==0 ){.
25200 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 pCur->curFlags
25210 7c 3d 20 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 |= BTCF_ValidNKe
25220 79 3b 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 y;. btreePars
25230 65 43 65 6c 6c 28 70 43 75 72 2d 3e 70 50 61 67 eCell(pCur->pPag
25240 65 2c 70 43 75 72 2d 3e 69 78 2c 26 70 43 75 72 e,pCur->ix,&pCur
25250 2d 3e 69 6e 66 6f 29 3b 0a 20 20 7d 65 6c 73 65 ->info);. }else
25260 7b 0a 20 20 20 20 61 73 73 65 72 74 43 65 6c 6c {. assertCell
25270 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 7d 0a Info(pCur);. }.
25280 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 }..#ifndef NDEBU
25290 47 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 72 G /* The next r
252a0 6f 75 74 69 6e 65 20 75 73 65 64 20 6f 6e 6c 79 outine used only
252b0 20 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 within assert()
252c0 20 73 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 2f statements */./
252d0 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 *.** Return true
252e0 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 42 74 if the given Bt
252f0 43 75 72 73 6f 72 20 69 73 20 76 61 6c 69 64 2e Cursor is valid.
25300 20 20 41 20 76 61 6c 69 64 20 63 75 72 73 6f 72 A valid cursor
25310 20 69 73 20 6f 6e 65 0a 2a 2a 20 74 68 61 74 20 is one.** that
25320 69 73 20 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 is currently poi
25330 6e 74 69 6e 67 20 74 6f 20 61 20 72 6f 77 20 69 nting to a row i
25340 6e 20 61 20 28 6e 6f 6e 2d 65 6d 70 74 79 29 20 n a (non-empty)
25350 74 61 62 6c 65 2e 0a 2a 2a 20 54 68 69 73 20 69 table..** This i
25360 73 20 61 20 76 65 72 69 66 69 63 61 74 69 6f 6e s a verification
25370 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64 routine is used
25380 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 73 only within ass
25390 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
253a0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
253b0 42 74 72 65 65 43 75 72 73 6f 72 49 73 56 61 6c BtreeCursorIsVal
253c0 69 64 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 id(BtCursor *pCu
253d0 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 r){. return pCu
253e0 72 20 26 26 20 70 43 75 72 2d 3e 65 53 74 61 74 r && pCur->eStat
253f0 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b e==CURSOR_VALID;
25400 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 4e 44 45 .}.#endif /* NDE
25410 42 55 47 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 BUG */.int sqlit
25420 65 33 42 74 72 65 65 43 75 72 73 6f 72 49 73 56 e3BtreeCursorIsV
25430 61 6c 69 64 4e 4e 28 42 74 43 75 72 73 6f 72 20 alidNN(BtCursor
25440 2a 70 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 *pCur){. assert
25450 28 20 70 43 75 72 21 3d 30 20 29 3b 0a 20 20 72 ( pCur!=0 );. r
25460 65 74 75 72 6e 20 70 43 75 72 2d 3e 65 53 74 61 eturn pCur->eSta
25470 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
25480 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
25490 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 n the value of t
254a0 68 65 20 69 6e 74 65 67 65 72 20 6b 65 79 20 6f he integer key o
254b0 72 20 22 72 6f 77 69 64 22 20 66 6f 72 20 61 20 r "rowid" for a
254c0 74 61 62 6c 65 20 62 74 72 65 65 2e 0a 2a 2a 20 table btree..**
254d0 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
254e0 6f 6e 6c 79 20 76 61 6c 69 64 20 66 6f 72 20 61 only valid for a
254f0 20 63 75 72 73 6f 72 20 74 68 61 74 20 69 73 20 cursor that is
25500 70 6f 69 6e 74 69 6e 67 20 69 6e 74 6f 20 61 0a pointing into a.
25510 2a 2a 20 6f 72 64 69 6e 61 72 79 20 74 61 62 6c ** ordinary tabl
25520 65 20 62 74 72 65 65 2e 20 20 49 66 20 74 68 65 e btree. If the
25530 20 63 75 72 73 6f 72 20 70 6f 69 6e 74 73 20 74 cursor points t
25540 6f 20 61 6e 20 69 6e 64 65 78 20 62 74 72 65 65 o an index btree
25550 20 6f 72 0a 2a 2a 20 69 73 20 69 6e 76 61 6c 69 or.** is invali
25560 64 2c 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 d, the result of
25570 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
25580 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 69 undefined..*/.i
25590 36 34 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 64 sqlite3BtreeI
255a0 6e 74 65 67 65 72 4b 65 79 28 42 74 43 75 72 73 ntegerKey(BtCurs
255b0 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 61 73 73 or *pCur){. ass
255c0 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 ert( cursorHolds
255d0 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a 20 Mutex(pCur) );.
255e0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
255f0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
25600 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 LID );. assert(
25610 20 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 pCur->curIntKey
25620 20 29 3b 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 );. getCellInf
25630 6f 28 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 o(pCur);. retur
25640 6e 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 n pCur->info.nKe
25650 79 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c y;.}..#ifdef SQL
25660 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 46 46 53 45 ITE_ENABLE_OFFSE
25670 54 5f 53 51 4c 5f 46 55 4e 43 0a 2f 2a 0a 2a 2a T_SQL_FUNC./*.**
25680 20 52 65 74 75 72 6e 20 74 68 65 20 6f 66 66 73 Return the offs
25690 65 74 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 et into the data
256a0 62 61 73 65 20 66 69 6c 65 20 66 6f 72 20 74 68 base file for th
256b0 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 0a 2a e start of the.*
256c0 2a 20 70 61 79 6c 6f 61 64 20 74 6f 20 77 68 69 * payload to whi
256d0 63 68 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 ch the cursor is
256e0 20 70 6f 69 6e 74 69 6e 67 2e 0a 2a 2f 0a 69 36 pointing..*/.i6
256f0 34 20 73 71 6c 69 74 65 33 42 74 72 65 65 4f 66 4 sqlite3BtreeOf
25700 66 73 65 74 28 42 74 43 75 72 73 6f 72 20 2a 70 fset(BtCursor *p
25710 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 Cur){. assert(
25720 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
25730 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
25740 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
25750 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
25760 3b 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 ;. getCellInfo(
25770 70 43 75 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 pCur);. return
25780 28 69 36 34 29 70 43 75 72 2d 3e 70 42 74 2d 3e (i64)pCur->pBt->
25790 70 61 67 65 53 69 7a 65 2a 28 28 69 36 34 29 70 pageSize*((i64)p
257a0 43 75 72 2d 3e 70 50 61 67 65 2d 3e 70 67 6e 6f Cur->pPage->pgno
257b0 20 2d 20 31 29 20 2b 0a 20 20 20 20 20 20 20 20 - 1) +.
257c0 20 28 69 36 34 29 28 70 43 75 72 2d 3e 69 6e 66 (i64)(pCur->inf
257d0 6f 2e 70 50 61 79 6c 6f 61 64 20 2d 20 70 43 75 o.pPayload - pCu
257e0 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 61 29 r->pPage->aData)
257f0 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
25800 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 46 46 53 LITE_ENABLE_OFFS
25810 45 54 5f 53 51 4c 5f 46 55 4e 43 20 2a 2f 0a 0a ET_SQL_FUNC */..
25820 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
25830 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
25840 20 6f 66 20 70 61 79 6c 6f 61 64 20 66 6f 72 20 of payload for
25850 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 70 the entry that p
25860 43 75 72 20 69 73 0a 2a 2a 20 63 75 72 72 65 6e Cur is.** curren
25870 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e tly pointing to.
25880 20 20 46 6f 72 20 74 61 62 6c 65 20 62 74 72 65 For table btre
25890 65 73 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 es, this will be
258a0 20 74 68 65 20 61 6d 6f 75 6e 74 0a 2a 2a 20 6f the amount.** o
258b0 66 20 64 61 74 61 2e 20 20 46 6f 72 20 69 6e 64 f data. For ind
258c0 65 78 20 62 74 72 65 65 73 2c 20 74 68 69 73 20 ex btrees, this
258d0 77 69 6c 6c 20 62 65 20 74 68 65 20 73 69 7a 65 will be the size
258e0 20 6f 66 20 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a of the key..**.
258f0 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 ** The caller mu
25900 73 74 20 67 75 61 72 61 6e 74 65 65 20 74 68 61 st guarantee tha
25910 74 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 t the cursor is
25920 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 6e 6f pointing to a no
25930 6e 2d 4e 55 4c 4c 0a 2a 2a 20 76 61 6c 69 64 20 n-NULL.** valid
25940 65 6e 74 72 79 2e 20 20 49 6e 20 6f 74 68 65 72 entry. In other
25950 20 77 6f 72 64 73 2c 20 74 68 65 20 63 61 6c 6c words, the call
25960 69 6e 67 20 70 72 6f 63 65 64 75 72 65 20 6d 75 ing procedure mu
25970 73 74 20 67 75 61 72 61 6e 74 65 65 0a 2a 2a 20 st guarantee.**
25980 74 68 61 74 20 74 68 65 20 63 75 72 73 6f 72 20 that the cursor
25990 68 61 73 20 43 75 72 73 6f 72 2e 65 53 74 61 74 has Cursor.eStat
259a0 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e e==CURSOR_VALID.
259b0 0a 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33 42 .*/.u32 sqlite3B
259c0 74 72 65 65 50 61 79 6c 6f 61 64 53 69 7a 65 28 treePayloadSize(
259d0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
259e0 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f . assert( curso
259f0 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 rHoldsMutex(pCur
25a00 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
25a10 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 Cur->eState==CUR
25a20 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 67 SOR_VALID );. g
25a30 65 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 etCellInfo(pCur)
25a40 3b 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d ;. return pCur-
25a50 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 3b 0a >info.nPayload;.
25a60 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 74 }../*.** Given t
25a70 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
25a80 66 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 f an overflow pa
25a90 67 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 ge in the databa
25aa0 73 65 20 28 70 61 72 61 6d 65 74 65 72 0a 2a 2a se (parameter.**
25ab0 20 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 75 6e ovfl), this fun
25ac0 63 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 65 20 ction finds the
25ad0 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 page number of t
25ae0 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 he next page in
25af0 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 6c the .** linked l
25b00 69 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f 77 20 ist of overflow
25b10 70 61 67 65 73 2e 20 49 66 20 70 6f 73 73 69 62 pages. If possib
25b20 6c 65 2c 20 69 74 20 75 73 65 73 20 74 68 65 20 le, it uses the
25b30 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 70 auto-vacuum.** p
25b40 6f 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 61 20 ointer-map data
25b50 69 6e 73 74 65 61 64 20 6f 66 20 72 65 61 64 69 instead of readi
25b60 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f ng the content o
25b70 66 20 70 61 67 65 20 6f 76 66 6c 20 74 6f 20 64 f page ovfl to d
25b80 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 o so. .**.** If
25b90 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 an error occurs
25ba0 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
25bb0 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 code is returned
25bc0 2e 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a 2a 0a . Otherwise:.**.
25bd0 2a 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d 62 ** The page numb
25be0 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 6f er of the next o
25bf0 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 verflow page in
25c00 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 the linked list
25c10 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 74 is .** written t
25c20 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 49 66 o *pPgnoNext. If
25c30 20 70 61 67 65 20 6f 76 66 6c 20 69 73 20 74 68 page ovfl is th
25c40 65 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 69 e last page in i
25c50 74 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c 69 ts linked .** li
25c60 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 20 69 st, *pPgnoNext i
25c70 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 0a s set to zero. .
25c80 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 65 20 **.** If ppPage
25c90 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e 64 is not NULL, and
25ca0 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 a reference to
25cb0 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a 65 the MemPage obje
25cc0 63 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 ct corresponding
25cd0 0a 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 6d 62 .** to page numb
25ce0 65 72 20 70 4f 76 66 6c 20 77 61 73 20 6f 62 74 er pOvfl was obt
25cf0 61 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 70 50 ained, then *ppP
25d00 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 70 6f age is set to po
25d10 69 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a 20 72 int to that.** r
25d20 65 66 65 72 65 6e 63 65 2e 20 49 74 20 69 73 20 eference. It is
25d30 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
25d40 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 ty of the caller
25d50 20 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 73 65 to call release
25d60 50 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 70 Page().** on *pp
25d70 50 61 67 65 20 74 6f 20 66 72 65 65 20 74 68 65 Page to free the
25d80 20 72 65 66 65 72 65 6e 63 65 2e 20 49 6e 20 6e reference. In n
25d90 6f 20 72 65 66 65 72 65 6e 63 65 20 77 61 73 20 o reference was
25da0 6f 62 74 61 69 6e 65 64 20 28 62 65 63 61 75 73 obtained (becaus
25db0 65 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 72 e.** the pointer
25dc0 2d 6d 61 70 20 77 61 73 20 75 73 65 64 20 74 6f -map was used to
25dd0 20 6f 62 74 61 69 6e 20 74 68 65 20 76 61 6c 75 obtain the valu
25de0 65 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 74 e for *pPgnoNext
25df0 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 61 ), then.** *ppPa
25e00 67 65 20 69 73 20 73 65 74 20 74 6f 20 7a 65 72 ge is set to zer
25e10 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 o..*/.static int
25e20 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 getOverflowPage
25e30 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 (. BtShared *pB
25e40 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
25e50 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
25e60 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
25e70 6f 76 66 6c 2c 20 20 20 20 20 20 20 20 20 20 20 ovfl,
25e80 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 /* Curre
25e90 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 nt overflow page
25ea0 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 6d number */. Mem
25eb0 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 Page **ppPage,
25ec0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 /* OUT
25ed0 3a 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 6c 65 : MemPage handle
25ee0 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a (may be NULL) *
25ef0 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f 4e /. Pgno *pPgnoN
25f00 65 78 74 20 20 20 20 20 20 20 20 20 20 20 20 20 ext
25f10 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 6f 76 /* OUT: Next ov
25f20 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d 62 erflow page numb
25f30 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f 20 er */.){. Pgno
25f40 6e 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 next = 0;. MemP
25f50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b 0a age *pPage = 0;.
25f60 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
25f70 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 E_OK;.. assert(
25f80 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
25f90 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
25fa0 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 67 6e );. assert(pPgn
25fb0 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 65 66 oNext);..#ifndef
25fc0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 SQLITE_OMIT_AUT
25fd0 4f 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 72 79 OVACUUM. /* Try
25fe0 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 65 78 to find the nex
25ff0 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 6f 76 t page in the ov
26000 65 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 69 6e erflow list usin
26010 67 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 6f 76 g the. ** autov
26020 61 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d 6d 61 acuum pointer-ma
26030 70 20 70 61 67 65 73 2e 20 47 75 65 73 73 20 74 p pages. Guess t
26040 68 61 74 20 74 68 65 20 6e 65 78 74 20 70 61 67 hat the next pag
26050 65 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 20 6f e in . ** the o
26060 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 73 20 verflow list is
26070 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6f 76 66 page number (ovf
26080 6c 2b 31 29 2e 20 49 66 20 74 68 61 74 20 67 75 l+1). If that gu
26090 65 73 73 20 74 75 72 6e 73 20 0a 20 20 2a 2a 20 ess turns . **
260a0 6f 75 74 20 74 6f 20 62 65 20 77 72 6f 6e 67 2c out to be wrong,
260b0 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 6c 6f fall back to lo
260c0 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 20 6f ading the data o
260d0 66 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e 75 6d f page . ** num
260e0 62 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 74 65 ber ovfl to dete
260f0 72 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 20 70 rmine the next p
26100 61 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 2a 2f age number.. */
26110 0a 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 6f . if( pBt->auto
26120 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 67 Vacuum ){. Pg
26130 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 67 6e no pgno;. Pgn
26140 6f 20 69 47 75 65 73 73 20 3d 20 6f 76 66 6c 2b o iGuess = ovfl+
26150 31 3b 0a 20 20 20 20 75 38 20 65 54 79 70 65 3b 1;. u8 eType;
26160 0a 0a 20 20 20 20 77 68 69 6c 65 28 20 50 54 52 .. while( PTR
26170 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
26180 69 47 75 65 73 73 29 20 7c 7c 20 69 47 75 65 73 iGuess) || iGues
26190 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f s==PENDING_BYTE_
261a0 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 20 PAGE(pBt) ){.
261b0 20 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 20 20 iGuess++;.
261c0 20 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 75 65 }.. if( iGue
261d0 73 73 3c 3d 62 74 72 65 65 50 61 67 65 63 6f 75 ss<=btreePagecou
261e0 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 nt(pBt) ){.
261f0 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 28 rc = ptrmapGet(
26200 70 42 74 2c 20 69 47 75 65 73 73 2c 20 26 65 54 pBt, iGuess, &eT
26210 79 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 20 ype, &pgno);.
26220 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
26230 45 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d 3d 50 E_OK && eType==P
26240 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 TRMAP_OVERFLOW2
26250 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 7b && pgno==ovfl ){
26260 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 3d 20 . next =
26270 69 47 75 65 73 73 3b 0a 20 20 20 20 20 20 20 20 iGuess;.
26280 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e 45 rc = SQLITE_DONE
26290 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
262a0 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 }.#endif.. as
262b0 73 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 7c 7c sert( next==0 ||
262c0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 rc==SQLITE_DONE
262d0 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );. if( rc==SQ
262e0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
262f0 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
26300 28 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 50 61 (pBt, ovfl, &pPa
26310 67 65 2c 20 28 70 70 50 61 67 65 3d 3d 30 29 20 ge, (ppPage==0)
26320 3f 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 44 ? PAGER_GET_READ
26330 4f 4e 4c 59 20 3a 20 30 29 3b 0a 20 20 20 20 61 ONLY : 0);. a
26340 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
26350 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 3d 3d 30 E_OK || pPage==0
26360 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d );. if( rc==
26370 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
26380 20 20 20 6e 65 78 74 20 3d 20 67 65 74 34 62 79 next = get4by
26390 74 65 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 te(pPage->aData)
263a0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a ;. }. }.. *
263b0 70 50 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 78 74 pPgnoNext = next
263c0 3b 0a 20 20 69 66 28 20 70 70 50 61 67 65 20 29 ;. if( ppPage )
263d0 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 {. *ppPage =
263e0 70 50 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a pPage;. }else{.
263f0 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
26400 70 50 61 67 65 29 3b 0a 20 20 7d 0a 20 20 72 65 pPage);. }. re
26410 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 turn (rc==SQLITE
26420 5f 44 4f 4e 45 20 3f 20 53 51 4c 49 54 45 5f 4f _DONE ? SQLITE_O
26430 4b 20 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a K : rc);.}../*.*
26440 2a 20 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d * Copy data from
26450 20 61 20 62 75 66 66 65 72 20 74 6f 20 61 20 70 a buffer to a p
26460 61 67 65 2c 20 6f 72 20 66 72 6f 6d 20 61 20 70 age, or from a p
26470 61 67 65 20 74 6f 20 61 20 62 75 66 66 65 72 2e age to a buffer.
26480 0a 2a 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 64 20 .**.** pPayload
26490 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
264a0 64 61 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 64 data stored on d
264b0 61 74 61 62 61 73 65 20 70 61 67 65 20 70 44 62 atabase page pDb
264c0 50 61 67 65 2e 0a 2a 2a 20 49 66 20 61 72 67 75 Page..** If argu
264d0 6d 65 6e 74 20 65 4f 70 20 69 73 20 66 61 6c 73 ment eOp is fals
264e0 65 2c 20 74 68 65 6e 20 6e 42 79 74 65 20 62 79 e, then nByte by
264f0 74 65 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 tes of data are
26500 63 6f 70 69 65 64 0a 2a 2a 20 66 72 6f 6d 20 70 copied.** from p
26510 50 61 79 6c 6f 61 64 20 74 6f 20 74 68 65 20 62 Payload to the b
26520 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 61 74 uffer pointed at
26530 20 62 79 20 70 42 75 66 2e 20 49 66 20 65 4f 70 by pBuf. If eOp
26540 20 69 73 20 74 72 75 65 2c 0a 2a 2a 20 74 68 65 is true,.** the
26550 6e 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 n sqlite3PagerWr
26560 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 ite() is called
26570 6f 6e 20 70 44 62 50 61 67 65 20 61 6e 64 20 6e on pDbPage and n
26580 42 79 74 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 Byte bytes.** of
26590 20 64 61 74 61 20 61 72 65 20 63 6f 70 69 65 64 data are copied
265a0 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
265b0 20 70 42 75 66 20 74 6f 20 70 50 61 79 6c 6f 61 pBuf to pPayloa
265c0 64 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f d..**.** SQLITE_
265d0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f OK is returned o
265e0 6e 20 73 75 63 63 65 73 73 2c 20 6f 74 68 65 72 n success, other
265f0 77 69 73 65 20 61 6e 20 65 72 72 6f 72 20 63 6f wise an error co
26600 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e de..*/.static in
26610 74 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 0a 20 t copyPayload(.
26620 20 76 6f 69 64 20 2a 70 50 61 79 6c 6f 61 64 2c void *pPayload,
26630 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
26640 69 6e 74 65 72 20 74 6f 20 70 61 67 65 20 64 61 inter to page da
26650 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 ta */. void *pB
26660 75 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 uf,
26670 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
26680 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 buffer */. int
26690 6e 42 79 74 65 2c 20 20 20 20 20 20 20 20 20 20 nByte,
266a0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
266b0 6f 66 20 62 79 74 65 73 20 74 6f 20 63 6f 70 79 of bytes to copy
266c0 20 2a 2f 0a 20 20 69 6e 74 20 65 4f 70 2c 20 20 */. int eOp,
266d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
266e0 2f 2a 20 30 20 2d 3e 20 63 6f 70 79 20 66 72 6f /* 0 -> copy fro
266f0 6d 20 70 61 67 65 2c 20 31 20 2d 3e 20 63 6f 70 m page, 1 -> cop
26700 79 20 74 6f 20 70 61 67 65 20 2a 2f 0a 20 20 44 y to page */. D
26710 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 20 20 bPage *pDbPage
26720 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
26730 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 50 61 79 containing pPay
26740 6c 6f 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 load */.){. if(
26750 20 65 4f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 43 eOp ){. /* C
26760 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 62 75 opy data from bu
26770 66 66 65 72 20 74 6f 20 70 61 67 65 20 28 61 20 ffer to page (a
26780 77 72 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 29 write operation)
26790 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d */. int rc =
267a0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
267b0 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 te(pDbPage);.
267c0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
267d0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 OK ){. retu
267e0 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
267f0 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 memcpy(pPayload
26800 2c 20 70 42 75 66 2c 20 6e 42 79 74 65 29 3b 0a , pBuf, nByte);.
26810 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 }else{. /*
26820 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 70 Copy data from p
26830 61 67 65 20 74 6f 20 62 75 66 66 65 72 20 28 61 age to buffer (a
26840 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 29 read operation)
26850 20 2a 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 */. memcpy(p
26860 42 75 66 2c 20 70 50 61 79 6c 6f 61 64 2c 20 6e Buf, pPayload, n
26870 42 79 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 Byte);. }. ret
26880 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
26890 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
268a0 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
268b0 20 72 65 61 64 20 6f 72 20 6f 76 65 72 77 72 69 read or overwri
268c0 74 65 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 te payload infor
268d0 6d 61 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 74 68 mation.** for th
268e0 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 e entry that the
268f0 20 70 43 75 72 20 63 75 72 73 6f 72 20 69 73 20 pCur cursor is
26900 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 54 68 65 pointing to. The
26910 20 65 4f 70 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 eOp.** argument
26920 20 69 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 is interpreted
26930 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a as follows:.**.*
26940 2a 20 20 20 30 3a 20 54 68 65 20 6f 70 65 72 61 * 0: The opera
26950 74 69 6f 6e 20 69 73 20 61 20 72 65 61 64 2e 20 tion is a read.
26960 50 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 Populate the ove
26970 72 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 20 rflow cache..**
26980 20 20 31 3a 20 54 68 65 20 6f 70 65 72 61 74 69 1: The operati
26990 6f 6e 20 69 73 20 61 20 77 72 69 74 65 2e 20 50 on is a write. P
269a0 6f 70 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 opulate the over
269b0 66 6c 6f 77 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a flow cache..**.*
269c0 2a 20 41 20 74 6f 74 61 6c 20 6f 66 20 22 61 6d * A total of "am
269d0 74 22 20 62 79 74 65 73 20 61 72 65 20 72 65 61 t" bytes are rea
269e0 64 20 6f 72 20 77 72 69 74 74 65 6e 20 62 65 67 d or written beg
269f0 69 6e 6e 69 6e 67 20 61 74 20 22 6f 66 66 73 65 inning at "offse
26a00 74 22 2e 0a 2a 2a 20 44 61 74 61 20 69 73 20 72 t"..** Data is r
26a10 65 61 64 20 74 6f 20 6f 72 20 66 72 6f 6d 20 74 ead to or from t
26a20 68 65 20 62 75 66 66 65 72 20 70 42 75 66 2e 0a he buffer pBuf..
26a30 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6e 74 65 6e **.** The conten
26a40 74 20 62 65 69 6e 67 20 72 65 61 64 20 6f 72 20 t being read or
26a50 77 72 69 74 74 65 6e 20 6d 69 67 68 74 20 61 70 written might ap
26a60 70 65 61 72 20 6f 6e 20 74 68 65 20 6d 61 69 6e pear on the main
26a70 20 70 61 67 65 0a 2a 2a 20 6f 72 20 62 65 20 73 page.** or be s
26a80 63 61 74 74 65 72 65 64 20 6f 75 74 20 6f 6e 20 cattered out on
26a90 6d 75 6c 74 69 70 6c 65 20 6f 76 65 72 66 6c 6f multiple overflo
26aa0 77 20 70 61 67 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 w pages..**.** I
26ab0 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 63 75 f the current cu
26ac0 72 73 6f 72 20 65 6e 74 72 79 20 75 73 65 73 20 rsor entry uses
26ad0 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 65 72 one or more over
26ae0 66 6c 6f 77 20 70 61 67 65 73 0a 2a 2a 20 74 68 flow pages.** th
26af0 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 is function may
26b00 61 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 allocate space f
26b10 6f 72 20 61 6e 64 20 6c 61 7a 69 6c 79 20 70 6f or and lazily po
26b20 70 75 6c 61 74 65 0a 2a 2a 20 74 68 65 20 6f 76 pulate.** the ov
26b30 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 erflow page-list
26b40 20 63 61 63 68 65 20 61 72 72 61 79 20 28 42 74 cache array (Bt
26b50 43 75 72 73 6f 72 2e 61 4f 76 65 72 66 6c 6f 77 Cursor.aOverflow
26b60 29 2e 20 0a 2a 2a 20 53 75 62 73 65 71 75 65 6e ). .** Subsequen
26b70 74 20 63 61 6c 6c 73 20 75 73 65 20 74 68 69 73 t calls use this
26b80 20 63 61 63 68 65 20 74 6f 20 6d 61 6b 65 20 73 cache to make s
26b90 65 65 6b 69 6e 67 20 74 6f 20 74 68 65 20 73 75 eeking to the su
26ba0 70 70 6c 69 65 64 20 6f 66 66 73 65 74 20 0a 2a pplied offset .*
26bb0 2a 20 6d 6f 72 65 20 65 66 66 69 63 69 65 6e 74 * more efficient
26bc0 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 20 61 6e 20 ..**.** Once an
26bd0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 overflow page-li
26be0 73 74 20 63 61 63 68 65 20 68 61 73 20 62 65 65 st cache has bee
26bf0 6e 20 61 6c 6c 6f 63 61 74 65 64 2c 20 69 74 20 n allocated, it
26c00 6d 75 73 74 20 62 65 0a 2a 2a 20 69 6e 76 61 6c must be.** inval
26c10 69 64 61 74 65 64 20 69 66 20 73 6f 6d 65 20 6f idated if some o
26c20 74 68 65 72 20 63 75 72 73 6f 72 20 77 72 69 74 ther cursor writ
26c30 65 73 20 74 6f 20 74 68 65 20 73 61 6d 65 20 74 es to the same t
26c40 61 62 6c 65 2c 20 6f 72 20 69 66 0a 2a 2a 20 74 able, or if.** t
26c50 68 65 20 63 75 72 73 6f 72 20 69 73 20 6d 6f 76 he cursor is mov
26c60 65 64 20 74 6f 20 61 20 64 69 66 66 65 72 65 6e ed to a differen
26c70 74 20 72 6f 77 2e 20 41 64 64 69 74 69 6f 6e 61 t row. Additiona
26c80 6c 6c 79 2c 20 69 6e 20 61 75 74 6f 2d 76 61 63 lly, in auto-vac
26c90 75 75 6d 0a 2a 2a 20 6d 6f 64 65 2c 20 74 68 65 uum.** mode, the
26ca0 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 76 65 6e 74 following event
26cb0 73 20 6d 61 79 20 69 6e 76 61 6c 69 64 61 74 65 s may invalidate
26cc0 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
26cd0 65 2d 6c 69 73 74 20 63 61 63 68 65 2e 0a 2a 2a e-list cache..**
26ce0 0a 2a 2a 20 20 20 2a 20 41 6e 20 69 6e 63 72 65 .** * An incre
26cf0 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2c 0a 2a mental vacuum,.*
26d00 2a 20 20 20 2a 20 41 20 63 6f 6d 6d 69 74 20 69 * * A commit i
26d10 6e 20 61 75 74 6f 5f 76 61 63 75 75 6d 3d 22 66 n auto_vacuum="f
26d20 75 6c 6c 22 20 6d 6f 64 65 2c 0a 2a 2a 20 20 20 ull" mode,.**
26d30 2a 20 43 72 65 61 74 69 6e 67 20 61 20 74 61 62 * Creating a tab
26d40 6c 65 20 28 6d 61 79 20 72 65 71 75 69 72 65 20 le (may require
26d50 6d 6f 76 69 6e 67 20 61 6e 20 6f 76 65 72 66 6c moving an overfl
26d60 6f 77 20 70 61 67 65 29 2e 0a 2a 2f 0a 73 74 61 ow page)..*/.sta
26d70 74 69 63 20 69 6e 74 20 61 63 63 65 73 73 50 61 tic int accessPa
26d80 79 6c 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f yload(. BtCurso
26d90 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a r *pCur, /*
26da0 20 43 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 Cursor pointing
26db0 20 74 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 to entry to rea
26dc0 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 d from */. u32
26dd0 6f 66 66 73 65 74 2c 20 20 20 20 20 20 20 20 20 offset,
26de0 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 64 69 6e /* Begin readin
26df0 67 20 74 68 69 73 20 66 61 72 20 69 6e 74 6f 20 g this far into
26e00 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 75 33 32 payload */. u32
26e10 20 61 6d 74 2c 20 20 20 20 20 20 20 20 20 20 20 amt,
26e20 20 20 2f 2a 20 52 65 61 64 20 74 68 69 73 20 6d /* Read this m
26e30 61 6e 79 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 any bytes */. u
26e40 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 42 nsigned char *pB
26e50 75 66 2c 20 2f 2a 20 57 72 69 74 65 20 74 68 65 uf, /* Write the
26e60 20 62 79 74 65 73 20 69 6e 74 6f 20 74 68 69 73 bytes into this
26e70 20 62 75 66 66 65 72 20 2a 2f 20 0a 20 20 69 6e buffer */ . in
26e80 74 20 65 4f 70 20 20 20 20 20 20 20 20 20 20 20 t eOp
26e90 20 20 20 2f 2a 20 7a 65 72 6f 20 74 6f 20 72 65 /* zero to re
26ea0 61 64 2e 20 6e 6f 6e 2d 7a 65 72 6f 20 74 6f 20 ad. non-zero to
26eb0 77 72 69 74 65 2e 20 2a 2f 0a 29 7b 0a 20 20 75 write. */.){. u
26ec0 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 61 50 nsigned char *aP
26ed0 61 79 6c 6f 61 64 3b 0a 20 20 69 6e 74 20 72 63 ayload;. int rc
26ee0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
26ef0 69 6e 74 20 69 49 64 78 20 3d 20 30 3b 0a 20 20 int iIdx = 0;.
26f00 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
26f10 20 70 43 75 72 2d 3e 70 50 61 67 65 3b 20 20 20 pCur->pPage;
26f20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
26f30 74 72 65 65 20 70 61 67 65 20 6f 66 20 63 75 72 tree page of cur
26f40 72 65 6e 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 rent entry */.
26f50 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 BtShared *pBt =
26f60 70 43 75 72 2d 3e 70 42 74 3b 20 20 20 20 20 20 pCur->pBt;
26f70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
26f80 74 72 65 65 20 74 68 69 73 20 63 75 72 73 6f 72 tree this cursor
26f90 20 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 23 belongs to */.#
26fa0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 52 ifdef SQLITE_DIR
26fb0 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 ECT_OVERFLOW_REA
26fc0 44 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 D. unsigned cha
26fd0 72 20 2a 20 63 6f 6e 73 74 20 70 42 75 66 53 74 r * const pBufSt
26fe0 61 72 74 20 3d 20 70 42 75 66 3b 20 20 20 20 20 art = pBuf;
26ff0 2f 2a 20 53 74 61 72 74 20 6f 66 20 6f 72 69 67 /* Start of orig
27000 69 6e 61 6c 20 6f 75 74 20 62 75 66 66 65 72 20 inal out buffer
27010 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73 73 */.#endif.. ass
27020 65 72 74 28 20 70 50 61 67 65 20 29 3b 0a 20 20 ert( pPage );.
27030 61 73 73 65 72 74 28 20 65 4f 70 3d 3d 30 20 7c assert( eOp==0 |
27040 7c 20 65 4f 70 3d 3d 31 20 29 3b 0a 20 20 61 73 | eOp==1 );. as
27050 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
27060 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
27070 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
27080 75 72 2d 3e 69 78 3c 70 50 61 67 65 2d 3e 6e 43 ur->ix<pPage->nC
27090 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ell );. assert(
270a0 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
270b0 78 28 70 43 75 72 29 20 29 3b 0a 0a 20 20 67 65 x(pCur) );.. ge
270c0 74 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b tCellInfo(pCur);
270d0 0a 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 70 43 . aPayload = pC
270e0 75 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 ur->info.pPayloa
270f0 64 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 d;. assert( off
27100 73 65 74 2b 61 6d 74 20 3c 3d 20 70 43 75 72 2d set+amt <= pCur-
27110 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 >info.nPayload )
27120 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 61 50 61 ;.. assert( aPa
27130 79 6c 6f 61 64 20 3e 20 70 50 61 67 65 2d 3e 61 yload > pPage->a
27140 44 61 74 61 20 29 3b 0a 20 20 69 66 28 20 28 75 Data );. if( (u
27150 70 74 72 29 28 61 50 61 79 6c 6f 61 64 20 2d 20 ptr)(aPayload -
27160 70 50 61 67 65 2d 3e 61 44 61 74 61 29 20 3e 20 pPage->aData) >
27170 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 (pBt->usableSize
27180 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c - pCur->info.nL
27190 6f 63 61 6c 29 20 29 7b 0a 20 20 20 20 2f 2a 20 ocal) ){. /*
271a0 54 72 79 69 6e 67 20 74 6f 20 72 65 61 64 20 6f Trying to read o
271b0 72 20 77 72 69 74 65 20 70 61 73 74 20 74 68 65 r write past the
271c0 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 61 end of the data
271d0 20 69 73 20 61 6e 20 65 72 72 6f 72 2e 20 20 54 is an error. T
271e0 68 65 0a 20 20 20 20 2a 2a 20 63 6f 6e 64 69 74 he. ** condit
271f0 69 6f 6e 61 6c 20 61 62 6f 76 65 20 69 73 20 72 ional above is r
27200 65 61 6c 6c 79 3a 0a 20 20 20 20 2a 2a 20 20 20 eally:. **
27210 20 26 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d &aPayload[pCur-
27220 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 20 3e 20 >info.nLocal] >
27230 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 &pPage->aData[pB
27240 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 5d 0a 20 t->usableSize].
27250 20 20 20 2a 2a 20 62 75 74 20 69 73 20 72 65 63 ** but is rec
27260 61 73 74 20 69 6e 74 6f 20 69 74 73 20 63 75 72 ast into its cur
27270 72 65 6e 74 20 66 6f 72 6d 20 74 6f 20 61 76 6f rent form to avo
27280 69 64 20 69 6e 74 65 67 65 72 20 6f 76 65 72 66 id integer overf
27290 6c 6f 77 20 70 72 6f 62 6c 65 6d 73 0a 20 20 20 low problems.
272a0 20 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 */. return S
272b0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 41 QLITE_CORRUPT_PA
272c0 47 45 28 70 50 61 67 65 29 3b 0a 20 20 7d 0a 0a GE(pPage);. }..
272d0 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 64 61 /* Check if da
272e0 74 61 20 6d 75 73 74 20 62 65 20 72 65 61 64 2f ta must be read/
272f0 77 72 69 74 74 65 6e 20 74 6f 2f 66 72 6f 6d 20 written to/from
27300 74 68 65 20 62 74 72 65 65 20 70 61 67 65 20 69 the btree page i
27310 74 73 65 6c 66 2e 20 2a 2f 0a 20 20 69 66 28 20 tself. */. if(
27320 6f 66 66 73 65 74 3c 70 43 75 72 2d 3e 69 6e 66 offset<pCur->inf
27330 6f 2e 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 o.nLocal ){.
27340 69 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 20 20 int a = amt;.
27350 20 69 66 28 20 61 2b 6f 66 66 73 65 74 3e 70 43 if( a+offset>pC
27360 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 ur->info.nLocal
27370 29 7b 0a 20 20 20 20 20 20 61 20 3d 20 70 43 75 ){. a = pCu
27380 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d r->info.nLocal -
27390 20 6f 66 66 73 65 74 3b 0a 20 20 20 20 7d 0a 20 offset;. }.
273a0 20 20 20 72 63 20 3d 20 63 6f 70 79 50 61 79 6c rc = copyPayl
273b0 6f 61 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f 66 oad(&aPayload[of
273c0 66 73 65 74 5d 2c 20 70 42 75 66 2c 20 61 2c 20 fset], pBuf, a,
273d0 65 4f 70 2c 20 70 50 61 67 65 2d 3e 70 44 62 50 eOp, pPage->pDbP
273e0 61 67 65 29 3b 0a 20 20 20 20 6f 66 66 73 65 74 age);. offset
273f0 20 3d 20 30 3b 0a 20 20 20 20 70 42 75 66 20 2b = 0;. pBuf +
27400 3d 20 61 3b 0a 20 20 20 20 61 6d 74 20 2d 3d 20 = a;. amt -=
27410 61 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 a;. }else{.
27420 6f 66 66 73 65 74 20 2d 3d 20 70 43 75 72 2d 3e offset -= pCur->
27430 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a 20 20 7d info.nLocal;. }
27440 0a 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c ... if( rc==SQL
27450 49 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 ITE_OK && amt>0
27460 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 75 33 32 ){. const u32
27470 20 6f 76 66 6c 53 69 7a 65 20 3d 20 70 42 74 2d ovflSize = pBt-
27480 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b >usableSize - 4;
27490 20 20 2f 2a 20 42 79 74 65 73 20 63 6f 6e 74 65 /* Bytes conte
274a0 6e 74 20 70 65 72 20 6f 76 66 6c 20 70 61 67 65 nt per ovfl page
274b0 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 65 78 */. Pgno nex
274c0 74 50 61 67 65 3b 0a 0a 20 20 20 20 6e 65 78 74 tPage;.. next
274d0 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
274e0 26 61 50 61 79 6c 6f 61 64 5b 70 43 75 72 2d 3e &aPayload[pCur->
274f0 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 5d 29 3b 0a 0a info.nLocal]);..
27500 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 42 74 /* If the Bt
27510 43 75 72 73 6f 72 2e 61 4f 76 65 72 66 6c 6f 77 Cursor.aOverflow
27520 5b 5d 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 [] has not been
27530 61 6c 6c 6f 63 61 74 65 64 2c 20 61 6c 6c 6f 63 allocated, alloc
27540 61 74 65 20 69 74 20 6e 6f 77 2e 0a 20 20 20 20 ate it now..
27550 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 61 4f **. ** The aO
27560 76 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 20 verflow[] array
27570 69 73 20 73 69 7a 65 64 20 61 74 20 6f 6e 65 20 is sized at one
27580 65 6e 74 72 79 20 66 6f 72 20 65 61 63 68 20 6f entry for each o
27590 76 65 72 66 6c 6f 77 20 70 61 67 65 0a 20 20 20 verflow page.
275a0 20 2a 2a 20 69 6e 20 74 68 65 20 6f 76 65 72 66 ** in the overf
275b0 6c 6f 77 20 63 68 61 69 6e 2e 20 54 68 65 20 70 low chain. The p
275c0 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 age number of th
275d0 65 20 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 e first overflow
275e0 20 70 61 67 65 20 69 73 0a 20 20 20 20 2a 2a 20 page is. **
275f0 73 74 6f 72 65 64 20 69 6e 20 61 4f 76 65 72 66 stored in aOverf
27600 6c 6f 77 5b 30 5d 2c 20 65 74 63 2e 20 41 20 76 low[0], etc. A v
27610 61 6c 75 65 20 6f 66 20 30 20 69 6e 20 74 68 65 alue of 0 in the
27620 20 61 4f 76 65 72 66 6c 6f 77 5b 5d 20 61 72 72 aOverflow[] arr
27630 61 79 0a 20 20 20 20 2a 2a 20 6d 65 61 6e 73 20 ay. ** means
27640 22 6e 6f 74 20 79 65 74 20 6b 6e 6f 77 6e 22 20 "not yet known"
27650 28 74 68 65 20 63 61 63 68 65 20 69 73 20 6c 61 (the cache is la
27660 7a 69 6c 79 20 70 6f 70 75 6c 61 74 65 64 29 2e zily populated).
27670 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 . */. if(
27680 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 20 (pCur->curFlags
27690 26 20 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c & BTCF_ValidOvfl
276a0 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 6e )==0 ){. in
276b0 74 20 6e 4f 76 66 6c 20 3d 20 28 70 43 75 72 2d t nOvfl = (pCur-
276c0 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 2d 70 >info.nPayload-p
276d0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c Cur->info.nLocal
276e0 2b 6f 76 66 6c 53 69 7a 65 2d 31 29 2f 6f 76 66 +ovflSize-1)/ovf
276f0 6c 53 69 7a 65 3b 0a 20 20 20 20 20 20 69 66 28 lSize;. if(
27700 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 pCur->aOverflow
27710 3d 3d 30 0a 20 20 20 20 20 20 20 7c 7c 20 6e 4f ==0. || nO
27720 76 66 6c 2a 28 69 6e 74 29 73 69 7a 65 6f 66 28 vfl*(int)sizeof(
27730 50 67 6e 6f 29 20 3e 20 73 71 6c 69 74 65 33 4d Pgno) > sqlite3M
27740 61 6c 6c 6f 63 53 69 7a 65 28 70 43 75 72 2d 3e allocSize(pCur->
27750 61 4f 76 65 72 66 6c 6f 77 29 0a 20 20 20 20 20 aOverflow).
27760 20 29 7b 0a 20 20 20 20 20 20 20 20 50 67 6e 6f ){. Pgno
27770 20 2a 61 4e 65 77 20 3d 20 28 50 67 6e 6f 2a 29 *aNew = (Pgno*)
27780 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 0a sqlite3Realloc(.
27790 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 pCur
277a0 2d 3e 61 4f 76 65 72 66 6c 6f 77 2c 20 6e 4f 76 ->aOverflow, nOv
277b0 66 6c 2a 32 2a 73 69 7a 65 6f 66 28 50 67 6e 6f fl*2*sizeof(Pgno
277c0 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 ). );.
277d0 20 20 20 20 20 69 66 28 20 61 4e 65 77 3d 3d 30 if( aNew==0
277e0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
277f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
27800 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 M_BKPT;.
27810 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
27820 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 pCur->aOverflow
27830 20 3d 20 61 4e 65 77 3b 0a 20 20 20 20 20 20 20 = aNew;.
27840 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }. }.
27850 20 6d 65 6d 73 65 74 28 70 43 75 72 2d 3e 61 4f memset(pCur->aO
27860 76 65 72 66 6c 6f 77 2c 20 30 2c 20 6e 4f 76 66 verflow, 0, nOvf
27870 6c 2a 73 69 7a 65 6f 66 28 50 67 6e 6f 29 29 3b l*sizeof(Pgno));
27880 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 63 75 72 . pCur->cur
27890 46 6c 61 67 73 20 7c 3d 20 42 54 43 46 5f 56 61 Flags |= BTCF_Va
278a0 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 20 7d 65 6c lidOvfl;. }el
278b0 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 se{. /* If
278c0 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 the overflow pag
278d0 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 73 e-list cache has
278e0 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 been allocated
278f0 61 6e 64 20 74 68 65 0a 20 20 20 20 20 20 2a 2a and the. **
27900 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 66 entry for the f
27910 69 72 73 74 20 72 65 71 75 69 72 65 64 20 6f 76 irst required ov
27920 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 20 76 erflow page is v
27930 61 6c 69 64 2c 20 73 6b 69 70 0a 20 20 20 20 20 alid, skip.
27940 20 2a 2a 20 64 69 72 65 63 74 6c 79 20 74 6f 20 ** directly to
27950 69 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 it.. */.
27960 20 20 20 69 66 28 20 70 43 75 72 2d 3e 61 4f 76 if( pCur->aOv
27970 65 72 66 6c 6f 77 5b 6f 66 66 73 65 74 2f 6f 76 erflow[offset/ov
27980 66 6c 53 69 7a 65 5d 20 29 7b 0a 20 20 20 20 20 flSize] ){.
27990 20 20 20 69 49 64 78 20 3d 20 28 6f 66 66 73 65 iIdx = (offse
279a0 74 2f 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 20 t/ovflSize);.
279b0 20 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 nextPage =
279c0 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
279d0 69 49 64 78 5d 3b 0a 20 20 20 20 20 20 20 20 6f iIdx];. o
279e0 66 66 73 65 74 20 3d 20 28 6f 66 66 73 65 74 25 ffset = (offset%
279f0 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 20 20 20 20 ovflSize);.
27a00 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 73 }. }.. as
27a10 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
27a20 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 3b 0a _OK && amt>0 );.
27a30 20 20 20 20 77 68 69 6c 65 28 20 6e 65 78 74 50 while( nextP
27a40 61 67 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 age ){. /*
27a50 49 66 20 72 65 71 75 69 72 65 64 2c 20 70 6f 70 If required, pop
27a60 75 6c 61 74 65 20 74 68 65 20 6f 76 65 72 66 6c ulate the overfl
27a70 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 63 ow page-list cac
27a80 68 65 2e 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 he. */. ass
27a90 65 72 74 28 20 70 43 75 72 2d 3e 61 4f 76 65 72 ert( pCur->aOver
27aa0 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d 30 0a 20 20 flow[iIdx]==0.
27ab0 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 || p
27ac0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b 69 Cur->aOverflow[i
27ad0 49 64 78 5d 3d 3d 6e 65 78 74 50 61 67 65 0a 20 Idx]==nextPage.
27ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ||
27af0 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 CORRUPT_DB );.
27b00 20 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 pCur->aOverf
27b10 6c 6f 77 5b 69 49 64 78 5d 20 3d 20 6e 65 78 74 low[iIdx] = next
27b20 50 61 67 65 3b 0a 0a 20 20 20 20 20 20 69 66 28 Page;.. if(
27b30 20 6f 66 66 73 65 74 3e 3d 6f 76 66 6c 53 69 7a offset>=ovflSiz
27b40 65 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 e ){. /*
27b50 54 68 65 20 6f 6e 6c 79 20 72 65 61 73 6f 6e 20 The only reason
27b60 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 61 67 to read this pag
27b70 65 20 69 73 20 74 6f 20 6f 62 74 61 69 6e 20 74 e is to obtain t
27b80 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 he page.
27b90 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 ** number for th
27ba0 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 e next page in t
27bb0 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 he overflow chai
27bc0 6e 2e 20 54 68 65 20 70 61 67 65 0a 20 20 20 20 n. The page.
27bd0 20 20 20 20 2a 2a 20 64 61 74 61 20 69 73 20 6e ** data is n
27be0 6f 74 20 72 65 71 75 69 72 65 64 2e 20 53 6f 20 ot required. So
27bf0 66 69 72 73 74 20 74 72 79 20 74 6f 20 6c 6f 6f first try to loo
27c00 6b 75 70 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 kup the overflow
27c10 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 . ** page
27c20 2d 6c 69 73 74 20 63 61 63 68 65 2c 20 69 66 20 -list cache, if
27c30 61 6e 79 2c 20 74 68 65 6e 20 66 61 6c 6c 20 62 any, then fall b
27c40 61 63 6b 20 74 6f 20 74 68 65 20 67 65 74 4f 76 ack to the getOv
27c50 65 72 66 6c 6f 77 50 61 67 65 28 29 0a 20 20 20 erflowPage().
27c60 20 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e ** function
27c70 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
27c80 20 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 assert( pCu
27c90 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 r->curFlags & BT
27ca0 43 46 5f 56 61 6c 69 64 4f 76 66 6c 20 29 3b 0a CF_ValidOvfl );.
27cb0 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
27cc0 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 pCur->pBtree->db
27cd0 3d 3d 70 42 74 2d 3e 64 62 20 29 3b 0a 20 20 20 ==pBt->db );.
27ce0 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 61 if( pCur->a
27cf0 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 5d Overflow[iIdx+1]
27d00 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 ){. ne
27d10 78 74 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 xtPage = pCur->a
27d20 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 5d Overflow[iIdx+1]
27d30 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
27d40 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
27d50 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 getOverflowPage(
27d60 70 42 74 2c 20 6e 65 78 74 50 61 67 65 2c 20 30 pBt, nextPage, 0
27d70 2c 20 26 6e 65 78 74 50 61 67 65 29 3b 0a 20 20 , &nextPage);.
27d80 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
27d90 6f 66 66 73 65 74 20 2d 3d 20 6f 76 66 6c 53 69 offset -= ovflSi
27da0 7a 65 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b ze;. }else{
27db0 0a 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 65 64 . /* Need
27dc0 20 74 6f 20 72 65 61 64 20 74 68 69 73 20 70 61 to read this pa
27dd0 67 65 20 70 72 6f 70 65 72 6c 79 2e 20 49 74 20 ge properly. It
27de0 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 6f 66 contains some of
27df0 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 the. **
27e00 72 61 6e 67 65 20 6f 66 20 64 61 74 61 20 74 68 range of data th
27e10 61 74 20 69 73 20 62 65 69 6e 67 20 72 65 61 64 at is being read
27e20 20 28 65 4f 70 3d 3d 30 29 20 6f 72 20 77 72 69 (eOp==0) or wri
27e30 74 74 65 6e 20 28 65 4f 70 21 3d 30 29 2e 0a 20 tten (eOp!=0)..
27e40 20 20 20 20 20 20 20 2a 2f 0a 23 69 66 64 65 66 */.#ifdef
27e50 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f SQLITE_DIRECT_O
27e60 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 20 VERFLOW_READ.
27e70 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69 6c sqlite3_fil
27e80 65 20 2a 66 64 3b 20 20 20 20 20 20 2f 2a 20 46 e *fd; /* F
27e90 69 6c 65 20 66 72 6f 6d 20 77 68 69 63 68 20 74 ile from which t
27ea0 6f 20 64 6f 20 64 69 72 65 63 74 20 6f 76 65 72 o do direct over
27eb0 66 6c 6f 77 20 72 65 61 64 20 2a 2f 0a 23 65 6e flow read */.#en
27ec0 64 69 66 0a 20 20 20 20 20 20 20 20 69 6e 74 20 dif. int
27ed0 61 20 3d 20 61 6d 74 3b 0a 20 20 20 20 20 20 20 a = amt;.
27ee0 20 69 66 28 20 61 20 2b 20 6f 66 66 73 65 74 20 if( a + offset
27ef0 3e 20 6f 76 66 6c 53 69 7a 65 20 29 7b 0a 20 20 > ovflSize ){.
27f00 20 20 20 20 20 20 20 20 61 20 3d 20 6f 76 66 6c a = ovfl
27f10 53 69 7a 65 20 2d 20 6f 66 66 73 65 74 3b 0a 20 Size - offset;.
27f20 20 20 20 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 }..#ifdef
27f30 20 53 51 4c 49 54 45 5f 44 49 52 45 43 54 5f 4f SQLITE_DIRECT_O
27f40 56 45 52 46 4c 4f 57 5f 52 45 41 44 0a 20 20 20 VERFLOW_READ.
27f50 20 20 20 20 20 2f 2a 20 49 66 20 61 6c 6c 20 74 /* If all t
27f60 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 he following are
27f70 20 74 72 75 65 3a 0a 20 20 20 20 20 20 20 20 2a true:. *
27f80 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 31 *. ** 1
27f90 29 20 74 68 69 73 20 69 73 20 61 20 72 65 61 64 ) this is a read
27fa0 20 6f 70 65 72 61 74 69 6f 6e 2c 20 61 6e 64 20 operation, and
27fb0 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 32 29 . ** 2)
27fc0 20 64 61 74 61 20 69 73 20 72 65 71 75 69 72 65 data is require
27fd0 64 20 66 72 6f 6d 20 74 68 65 20 73 74 61 72 74 d from the start
27fe0 20 6f 66 20 74 68 69 73 20 6f 76 65 72 66 6c 6f of this overflo
27ff0 77 20 70 61 67 65 2c 20 61 6e 64 0a 20 20 20 20 w page, and.
28000 20 20 20 20 2a 2a 20 20 20 33 29 20 74 68 65 72 ** 3) ther
28010 65 20 69 73 20 6e 6f 20 6f 70 65 6e 20 77 72 69 e is no open wri
28020 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 te-transaction,
28030 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 and. **
28040 20 34 29 20 74 68 65 20 64 61 74 61 62 61 73 65 4) the database
28050 20 69 73 20 66 69 6c 65 2d 62 61 63 6b 65 64 2c is file-backed,
28060 20 61 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 and. **
28070 20 20 35 29 20 74 68 65 20 70 61 67 65 20 69 73 5) the page is
28080 20 6e 6f 74 20 69 6e 20 74 68 65 20 57 41 4c 20 not in the WAL
28090 66 69 6c 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 file. **
280a0 20 20 36 29 20 61 74 20 6c 65 61 73 74 20 34 20 6) at least 4
280b0 62 79 74 65 73 20 68 61 76 65 20 61 6c 72 65 61 bytes have alrea
280c0 64 79 20 62 65 65 6e 20 72 65 61 64 20 69 6e 74 dy been read int
280d0 6f 20 74 68 65 20 6f 75 74 70 75 74 20 62 75 66 o the output buf
280e0 66 65 72 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a fer . **.
280f0 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 ** then
28100 64 61 74 61 20 63 61 6e 20 62 65 20 72 65 61 64 data can be read
28110 20 64 69 72 65 63 74 6c 79 20 66 72 6f 6d 20 74 directly from t
28120 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
28130 20 69 6e 74 6f 20 74 68 65 0a 20 20 20 20 20 20 into the.
28140 20 20 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 66 ** output buff
28150 65 72 2c 20 62 79 70 61 73 73 69 6e 67 20 74 68 er, bypassing th
28160 65 20 70 61 67 65 2d 63 61 63 68 65 20 61 6c 74 e page-cache alt
28170 6f 67 65 74 68 65 72 2e 20 54 68 69 73 20 73 70 ogether. This sp
28180 65 65 64 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 eeds. **
28190 75 70 20 6c 6f 61 64 69 6e 67 20 6c 61 72 67 65 up loading large
281a0 20 72 65 63 6f 72 64 73 20 74 68 61 74 20 73 70 records that sp
281b0 61 6e 20 6d 61 6e 79 20 6f 76 65 72 66 6c 6f 77 an many overflow
281c0 20 70 61 67 65 73 2e 0a 20 20 20 20 20 20 20 20 pages..
281d0 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 65 */. if( e
281e0 4f 70 3d 3d 30 20 20 20 20 20 20 20 20 20 20 20 Op==0
281f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28210 20 20 2f 2a 20 28 31 29 20 2a 2f 0a 20 20 20 20 /* (1) */.
28220 20 20 20 20 20 26 26 20 6f 66 66 73 65 74 3d 3d && offset==
28230 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
28240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28250 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 32 /* (2
28260 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 26 ) */. &&
28270 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
28280 69 6f 6e 3d 3d 54 52 41 4e 53 5f 52 45 41 44 20 ion==TRANS_READ
28290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
282a0 20 20 20 20 2f 2a 20 28 33 29 20 2a 2f 0a 20 20 /* (3) */.
282b0 20 20 20 20 20 20 20 26 26 20 28 66 64 20 3d 20 && (fd =
282c0 73 71 6c 69 74 65 33 50 61 67 65 72 46 69 6c 65 sqlite3PagerFile
282d0 28 70 42 74 2d 3e 70 50 61 67 65 72 29 29 2d 3e (pBt->pPager))->
282e0 70 4d 65 74 68 6f 64 73 20 20 20 20 20 2f 2a 20 pMethods /*
282f0 28 34 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 (4) */.
28300 26 26 20 30 3d 3d 73 71 6c 69 74 65 33 50 61 67 && 0==sqlite3Pag
28310 65 72 55 73 65 57 61 6c 28 70 42 74 2d 3e 70 50 erUseWal(pBt->pP
28320 61 67 65 72 2c 20 6e 65 78 74 50 61 67 65 29 20 ager, nextPage)
28330 20 20 20 20 20 20 2f 2a 20 28 35 29 20 2a 2f 0a /* (5) */.
28340 20 20 20 20 20 20 20 20 20 26 26 20 26 70 42 75 && &pBu
28350 66 5b 2d 34 5d 3e 3d 70 42 75 66 53 74 61 72 74 f[-4]>=pBufStart
28360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28370 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
28380 2a 20 28 36 29 20 2a 2f 0a 20 20 20 20 20 20 20 * (6) */.
28390 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 38 ){. u8
283a0 20 61 53 61 76 65 5b 34 5d 3b 0a 20 20 20 20 20 aSave[4];.
283b0 20 20 20 20 20 75 38 20 2a 61 57 72 69 74 65 20 u8 *aWrite
283c0 3d 20 26 70 42 75 66 5b 2d 34 5d 3b 0a 20 20 20 = &pBuf[-4];.
283d0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 61 assert( a
283e0 57 72 69 74 65 3e 3d 70 42 75 66 53 74 61 72 74 Write>=pBufStart
283f0 20 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 );
28400 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 64 /* d
28410 75 65 20 74 6f 20 28 36 29 20 2a 2f 0a 20 20 20 ue to (6) */.
28420 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 53 memcpy(aS
28430 61 76 65 2c 20 61 57 72 69 74 65 2c 20 34 29 3b ave, aWrite, 4);
28440 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
28450 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 66 64 sqlite3OsRead(fd
28460 2c 20 61 57 72 69 74 65 2c 20 61 2b 34 2c 20 28 , aWrite, a+4, (
28470 69 36 34 29 70 42 74 2d 3e 70 61 67 65 53 69 7a i64)pBt->pageSiz
28480 65 2a 28 6e 65 78 74 50 61 67 65 2d 31 29 29 3b e*(nextPage-1));
28490 0a 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 50 . nextP
284a0 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 61 age = get4byte(a
284b0 57 72 69 74 65 29 3b 0a 20 20 20 20 20 20 20 20 Write);.
284c0 20 20 6d 65 6d 63 70 79 28 61 57 72 69 74 65 2c memcpy(aWrite,
284d0 20 61 53 61 76 65 2c 20 34 29 3b 0a 20 20 20 20 aSave, 4);.
284e0 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 }else.#endif
284f0 0a 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 20 .. {.
28500 20 20 20 20 20 20 44 62 50 61 67 65 20 2a 70 44 DbPage *pD
28510 62 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 bPage;.
28520 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
28530 65 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 65 erGet(pBt->pPage
28540 72 2c 20 6e 65 78 74 50 61 67 65 2c 20 26 70 44 r, nextPage, &pD
28550 62 50 61 67 65 2c 0a 20 20 20 20 20 20 20 20 20 bPage,.
28560 20 20 20 20 20 28 65 4f 70 3d 3d 30 20 3f 20 50 (eOp==0 ? P
28570 41 47 45 52 5f 47 45 54 5f 52 45 41 44 4f 4e 4c AGER_GET_READONL
28580 59 20 3a 20 30 29 0a 20 20 20 20 20 20 20 20 20 Y : 0).
28590 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 );. if
285a0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
285b0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 ){. a
285c0 50 61 79 6c 6f 61 64 20 3d 20 73 71 6c 69 74 65 Payload = sqlite
285d0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 44 3PagerGetData(pD
285e0 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
285f0 20 20 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 nextPage = g
28600 65 74 34 62 79 74 65 28 61 50 61 79 6c 6f 61 64 et4byte(aPayload
28610 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
28620 63 20 3d 20 63 6f 70 79 50 61 79 6c 6f 61 64 28 c = copyPayload(
28630 26 61 50 61 79 6c 6f 61 64 5b 6f 66 66 73 65 74 &aPayload[offset
28640 2b 34 5d 2c 20 70 42 75 66 2c 20 61 2c 20 65 4f +4], pBuf, a, eO
28650 70 2c 20 70 44 62 50 61 67 65 29 3b 0a 20 20 20 p, pDbPage);.
28660 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
28670 50 61 67 65 72 55 6e 72 65 66 28 70 44 62 50 61 PagerUnref(pDbPa
28680 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ge);.
28690 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 offset = 0;.
286a0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
286b0 20 7d 0a 20 20 20 20 20 20 20 20 61 6d 74 20 2d }. amt -
286c0 3d 20 61 3b 0a 20 20 20 20 20 20 20 20 69 66 28 = a;. if(
286d0 20 61 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 6e amt==0 ) return
286e0 20 72 63 3b 0a 20 20 20 20 20 20 20 20 70 42 75 rc;. pBu
286f0 66 20 2b 3d 20 61 3b 0a 20 20 20 20 20 20 7d 0a f += a;. }.
28700 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 62 if( rc ) b
28710 72 65 61 6b 3b 0a 20 20 20 20 20 20 69 49 64 78 reak;. iIdx
28720 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 ++;. }. }..
28730 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
28740 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a 20 OK && amt>0 ){.
28750 20 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 63 /* Overflow c
28760 68 61 69 6e 20 65 6e 64 73 20 70 72 65 6d 61 74 hain ends premat
28770 75 72 65 6c 79 20 2a 2f 0a 20 20 20 20 72 65 74 urely */. ret
28780 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 urn SQLITE_CORRU
28790 50 54 5f 50 41 47 45 28 70 50 61 67 65 29 3b 0a PT_PAGE(pPage);.
287a0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
287b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 .}../*.** Read p
287c0 61 72 74 20 6f 66 20 74 68 65 20 70 61 79 6c 6f art of the paylo
287d0 61 64 20 66 6f 72 20 74 68 65 20 72 6f 77 20 61 ad for the row a
287e0 74 20 77 68 69 63 68 20 74 68 61 74 20 63 75 72 t which that cur
287f0 73 6f 72 20 70 43 75 72 20 69 73 20 63 75 72 72 sor pCur is curr
28800 65 6e 74 6c 79 0a 2a 2a 20 70 6f 69 6e 74 69 6e ently.** pointin
28810 67 2e 20 20 22 61 6d 74 22 20 62 79 74 65 73 20 g. "amt" bytes
28820 77 69 6c 6c 20 62 65 20 74 72 61 6e 73 66 65 72 will be transfer
28830 72 65 64 20 69 6e 74 6f 20 70 42 75 66 5b 5d 2e red into pBuf[].
28840 20 20 54 68 65 20 74 72 61 6e 73 66 65 72 0a 2a The transfer.*
28850 2a 20 62 65 67 69 6e 73 20 61 74 20 22 6f 66 66 * begins at "off
28860 73 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 set"..**.** pCur
28870 20 63 61 6e 20 62 65 20 70 6f 69 6e 74 69 6e 67 can be pointing
28880 20 74 6f 20 65 69 74 68 65 72 20 61 20 74 61 62 to either a tab
28890 6c 65 20 6f 72 20 61 6e 20 69 6e 64 65 78 20 62 le or an index b
288a0 2d 74 72 65 65 2e 0a 2a 2a 20 49 66 20 70 6f 69 -tree..** If poi
288b0 6e 74 69 6e 67 20 74 6f 20 61 20 74 61 62 6c 65 nting to a table
288c0 20 62 74 72 65 65 2c 20 74 68 65 6e 20 74 68 65 btree, then the
288d0 20 63 6f 6e 74 65 6e 74 20 73 65 63 74 69 6f 6e content section
288e0 20 69 73 20 72 65 61 64 2e 20 20 49 66 0a 2a 2a is read. If.**
288f0 20 70 43 75 72 20 69 73 20 70 6f 69 6e 74 69 6e pCur is pointin
28900 67 20 74 6f 20 61 6e 20 69 6e 64 65 78 20 62 2d g to an index b-
28910 74 72 65 65 20 74 68 65 6e 20 74 68 65 20 6b 65 tree then the ke
28920 79 20 73 65 63 74 69 6f 6e 20 69 73 20 72 65 61 y section is rea
28930 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 73 71 6c d..**.** For sql
28940 69 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 ite3BtreePayload
28950 28 29 2c 20 74 68 65 20 63 61 6c 6c 65 72 20 6d (), the caller m
28960 75 73 74 20 65 6e 73 75 72 65 20 74 68 61 74 20 ust ensure that
28970 70 43 75 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 pCur is pointing
28980 0a 2a 2a 20 74 6f 20 61 20 76 61 6c 69 64 20 72 .** to a valid r
28990 6f 77 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e ow in the table.
289a0 20 20 46 6f 72 20 73 71 6c 69 74 65 33 42 74 72 For sqlite3Btr
289b0 65 65 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 eePayloadChecked
289c0 28 29 2c 20 74 68 65 0a 2a 2a 20 63 75 72 73 6f (), the.** curso
289d0 72 20 6d 69 67 68 74 20 62 65 20 69 6e 76 61 6c r might be inval
289e0 69 64 20 6f 72 20 6d 69 67 68 74 20 6e 65 65 64 id or might need
289f0 20 74 6f 20 62 65 20 72 65 73 74 6f 72 65 64 20 to be restored
28a00 62 65 66 6f 72 65 20 62 65 69 6e 67 20 72 65 61 before being rea
28a10 64 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 d..**.** Return
28a20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 SQLITE_OK on suc
28a30 63 65 73 73 20 6f 72 20 61 6e 20 65 72 72 6f 72 cess or an error
28a40 20 63 6f 64 65 20 69 66 20 61 6e 79 74 68 69 6e code if anythin
28a50 67 20 67 6f 65 73 0a 2a 2a 20 77 72 6f 6e 67 2e g goes.** wrong.
28a60 20 20 41 6e 20 65 72 72 6f 72 20 69 73 20 72 65 An error is re
28a70 74 75 72 6e 65 64 20 69 66 20 22 6f 66 66 73 65 turned if "offse
28a80 74 2b 61 6d 74 22 20 69 73 20 6c 61 72 67 65 72 t+amt" is larger
28a90 20 74 68 61 6e 0a 2a 2a 20 74 68 65 20 61 76 61 than.** the ava
28aa0 69 6c 61 62 6c 65 20 70 61 79 6c 6f 61 64 2e 0a ilable payload..
28ab0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 */.int sqlite3Bt
28ac0 72 65 65 50 61 79 6c 6f 61 64 28 42 74 43 75 72 reePayload(BtCur
28ad0 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6f sor *pCur, u32 o
28ae0 66 66 73 65 74 2c 20 75 33 32 20 61 6d 74 2c 20 ffset, u32 amt,
28af0 76 6f 69 64 20 2a 70 42 75 66 29 7b 0a 20 20 61 void *pBuf){. a
28b00 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
28b10 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
28b20 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
28b30 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
28b40 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
28b50 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d t( pCur->iPage>=
28b60 30 20 26 26 20 70 43 75 72 2d 3e 70 50 61 67 65 0 && pCur->pPage
28b70 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
28b80 75 72 2d 3e 69 78 3c 70 43 75 72 2d 3e 70 50 61 ur->ix<pCur->pPa
28b90 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 72 ge->nCell );. r
28ba0 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 79 6c eturn accessPayl
28bb0 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 65 74 oad(pCur, offset
28bc0 2c 20 61 6d 74 2c 20 28 75 6e 73 69 67 6e 65 64 , amt, (unsigned
28bd0 20 63 68 61 72 2a 29 70 42 75 66 2c 20 30 29 3b char*)pBuf, 0);
28be0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 76 .}../*.** This v
28bf0 61 72 69 61 6e 74 20 6f 66 20 73 71 6c 69 74 65 ariant of sqlite
28c00 33 42 74 72 65 65 50 61 79 6c 6f 61 64 28 29 20 3BtreePayload()
28c10 77 6f 72 6b 73 20 65 76 65 6e 20 69 66 20 74 68 works even if th
28c20 65 20 63 75 72 73 6f 72 20 68 61 73 20 6e 6f 74 e cursor has not
28c30 0a 2a 2a 20 69 6e 20 74 68 65 20 43 55 52 53 4f .** in the CURSO
28c40 52 5f 56 41 4c 49 44 20 73 74 61 74 65 2e 20 20 R_VALID state.
28c50 49 74 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 It is only used
28c60 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 5f 62 by the sqlite3_b
28c70 6c 6f 62 5f 72 65 61 64 28 29 0a 2a 2a 20 69 6e lob_read().** in
28c80 74 65 72 66 61 63 65 2e 0a 2a 2f 0a 23 69 66 6e terface..*/.#ifn
28c90 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
28ca0 49 4e 43 52 42 4c 4f 42 0a 73 74 61 74 69 63 20 INCRBLOB.static
28cb0 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 SQLITE_NOINLINE
28cc0 69 6e 74 20 61 63 63 65 73 73 50 61 79 6c 6f 61 int accessPayloa
28cd0 64 43 68 65 63 6b 65 64 28 0a 20 20 42 74 43 75 dChecked(. BtCu
28ce0 72 73 6f 72 20 2a 70 43 75 72 2c 0a 20 20 75 33 rsor *pCur,. u3
28cf0 32 20 6f 66 66 73 65 74 2c 0a 20 20 75 33 32 20 2 offset,. u32
28d00 61 6d 74 2c 0a 20 20 76 6f 69 64 20 2a 70 42 75 amt,. void *pBu
28d10 66 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 f.){. int rc;.
28d20 20 69 66 20 28 20 70 43 75 72 2d 3e 65 53 74 61 if ( pCur->eSta
28d30 74 65 3d 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c te==CURSOR_INVAL
28d40 49 44 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ID ){. return
28d50 20 53 51 4c 49 54 45 5f 41 42 4f 52 54 3b 0a 20 SQLITE_ABORT;.
28d60 20 7d 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 }. assert( cur
28d70 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 sorOwnsBtShared(
28d80 70 43 75 72 29 20 29 3b 0a 20 20 72 63 20 3d 20 pCur) );. rc =
28d90 62 74 72 65 65 52 65 73 74 6f 72 65 43 75 72 73 btreeRestoreCurs
28da0 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 29 orPosition(pCur)
28db0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 20 3f 20 ;. return rc ?
28dc0 72 63 20 3a 20 61 63 63 65 73 73 50 61 79 6c 6f rc : accessPaylo
28dd0 61 64 28 70 43 75 72 2c 20 6f 66 66 73 65 74 2c ad(pCur, offset,
28de0 20 61 6d 74 2c 20 70 42 75 66 2c 20 30 29 3b 0a amt, pBuf, 0);.
28df0 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 }.int sqlite3Btr
28e00 65 65 50 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 eePayloadChecked
28e10 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c (BtCursor *pCur,
28e20 20 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 u32 offset, u32
28e30 20 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 amt, void *pBuf
28e40 29 7b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 ){. if( pCur->e
28e50 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
28e60 4c 49 44 20 29 7b 0a 20 20 20 20 61 73 73 65 72 LID ){. asser
28e70 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
28e80 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
28e90 20 20 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 return access
28ea0 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 Payload(pCur, of
28eb0 66 73 65 74 2c 20 61 6d 74 2c 20 70 42 75 66 2c fset, amt, pBuf,
28ec0 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 0);. }else{.
28ed0 20 20 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 return accessP
28ee0 61 79 6c 6f 61 64 43 68 65 63 6b 65 64 28 70 43 ayloadChecked(pC
28ef0 75 72 2c 20 6f 66 66 73 65 74 2c 20 61 6d 74 2c ur, offset, amt,
28f00 20 70 42 75 66 29 3b 0a 20 20 7d 0a 7d 0a 23 65 pBuf);. }.}.#e
28f10 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
28f20 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 20 2a 2f 0a MIT_INCRBLOB */.
28f30 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 ./*.** Return a
28f40 70 6f 69 6e 74 65 72 20 74 6f 20 70 61 79 6c 6f pointer to paylo
28f50 61 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 ad information f
28f60 72 6f 6d 20 74 68 65 20 65 6e 74 72 79 20 74 68 rom the entry th
28f70 61 74 20 74 68 65 20 0a 2a 2a 20 70 43 75 72 20 at the .** pCur
28f80 63 75 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 cursor is pointi
28f90 6e 67 20 74 6f 2e 20 20 54 68 65 20 70 6f 69 6e ng to. The poin
28fa0 74 65 72 20 69 73 20 74 6f 20 74 68 65 20 62 65 ter is to the be
28fb0 67 69 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 74 68 ginning of.** th
28fc0 65 20 6b 65 79 20 69 66 20 69 6e 64 65 78 20 62 e key if index b
28fd0 74 72 65 65 73 20 28 70 50 61 67 65 2d 3e 69 6e trees (pPage->in
28fe0 74 4b 65 79 3d 3d 30 29 20 61 6e 64 20 69 73 20 tKey==0) and is
28ff0 74 68 65 20 64 61 74 61 20 66 6f 72 0a 2a 2a 20 the data for.**
29000 74 61 62 6c 65 20 62 74 72 65 65 73 20 28 70 50 table btrees (pP
29010 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 31 29 2e age->intKey==1).
29020 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 The number of b
29030 79 74 65 73 20 6f 66 20 61 76 61 69 6c 61 62 6c ytes of availabl
29040 65 0a 2a 2a 20 6b 65 79 2f 64 61 74 61 20 69 73 e.** key/data is
29050 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 written into *p
29060 41 6d 74 2e 20 20 49 66 20 2a 70 41 6d 74 3d 3d Amt. If *pAmt==
29070 30 2c 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 0, then the valu
29080 65 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 77 69 e.** returned wi
29090 6c 6c 20 6e 6f 74 20 62 65 20 61 20 76 61 6c 69 ll not be a vali
290a0 64 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a d pointer..**.**
290b0 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 This routine is
290c0 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e an optimization
290d0 2e 20 20 49 74 20 69 73 20 63 6f 6d 6d 6f 6e 20 . It is common
290e0 66 6f 72 20 74 68 65 20 65 6e 74 69 72 65 20 6b for the entire k
290f0 65 79 0a 2a 2a 20 61 6e 64 20 64 61 74 61 20 74 ey.** and data t
29100 6f 20 66 69 74 20 6f 6e 20 74 68 65 20 6c 6f 63 o fit on the loc
29110 61 6c 20 70 61 67 65 20 61 6e 64 20 66 6f 72 20 al page and for
29120 74 68 65 72 65 20 74 6f 20 62 65 20 6e 6f 20 6f there to be no o
29130 76 65 72 66 6c 6f 77 0a 2a 2a 20 70 61 67 65 73 verflow.** pages
29140 2e 20 20 57 68 65 6e 20 74 68 61 74 20 69 73 20 . When that is
29150 73 6f 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 so, this routine
29160 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 can be used to
29170 61 63 63 65 73 73 20 74 68 65 0a 2a 2a 20 6b 65 access the.** ke
29180 79 20 61 6e 64 20 64 61 74 61 20 77 69 74 68 6f y and data witho
29190 75 74 20 6d 61 6b 69 6e 67 20 61 20 63 6f 70 79 ut making a copy
291a0 2e 20 20 49 66 20 74 68 65 20 6b 65 79 20 61 6e . If the key an
291b0 64 2f 6f 72 20 64 61 74 61 20 73 70 69 6c 6c 73 d/or data spills
291c0 0a 2a 2a 20 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f .** onto overflo
291d0 77 20 70 61 67 65 73 2c 20 74 68 65 6e 20 61 63 w pages, then ac
291e0 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 6d 75 cessPayload() mu
291f0 73 74 20 62 65 20 75 73 65 64 20 74 6f 20 72 65 st be used to re
29200 61 73 73 65 6d 62 6c 65 0a 2a 2a 20 74 68 65 20 assemble.** the
29210 6b 65 79 2f 64 61 74 61 20 61 6e 64 20 63 6f 70 key/data and cop
29220 79 20 69 74 20 69 6e 74 6f 20 61 20 70 72 65 61 y it into a prea
29230 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e llocated buffer.
29240 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 6f 69 6e 74 .**.** The point
29250 65 72 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 er returned by t
29260 68 69 73 20 72 6f 75 74 69 6e 65 20 6c 6f 6f 6b his routine look
29270 73 20 64 69 72 65 63 74 6c 79 20 69 6e 74 6f 20 s directly into
29280 74 68 65 20 63 61 63 68 65 64 0a 2a 2a 20 70 61 the cached.** pa
29290 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ge of the databa
292a0 73 65 2e 20 20 54 68 65 20 64 61 74 61 20 6d 69 se. The data mi
292b0 67 68 74 20 63 68 61 6e 67 65 20 6f 72 20 6d 6f ght change or mo
292c0 76 65 20 74 68 65 20 6e 65 78 74 20 74 69 6d 65 ve the next time
292d0 0a 2a 2a 20 61 6e 79 20 62 74 72 65 65 20 72 6f .** any btree ro
292e0 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e utine is called.
292f0 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 .*/.static const
29300 20 76 6f 69 64 20 2a 66 65 74 63 68 50 61 79 6c void *fetchPayl
29310 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f 72 20 oad(. BtCursor
29320 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 *pCur, /* C
29330 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 ursor pointing t
29340 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 64 20 o entry to read
29350 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 2a 70 from */. u32 *p
29360 41 6d 74 20 20 20 20 20 20 20 20 20 20 20 20 2f Amt /
29370 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 6d 62 * Write the numb
29380 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 er of available
29390 62 79 74 65 73 20 68 65 72 65 20 2a 2f 0a 29 7b bytes here */.){
293a0 0a 20 20 69 6e 74 20 61 6d 74 3b 0a 20 20 61 73 . int amt;. as
293b0 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 26 26 sert( pCur!=0 &&
293c0 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 20 pCur->iPage>=0
293d0 26 26 20 70 43 75 72 2d 3e 70 50 61 67 65 29 3b && pCur->pPage);
293e0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
293f0 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f >eState==CURSOR_
29400 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
29410 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
29420 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 _held(pCur->pBtr
29430 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 ee->db->mutex) )
29440 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
29450 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
29460 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
29470 28 20 70 43 75 72 2d 3e 69 78 3c 70 43 75 72 2d ( pCur->ix<pCur-
29480 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b >pPage->nCell );
29490 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
294a0 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3e 30 20 29 3b >info.nSize>0 );
294b0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
294c0 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 3e 70 >info.pPayload>p
294d0 43 75 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 Cur->pPage->aDat
294e0 61 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 a || CORRUPT_DB
294f0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
29500 72 2d 3e 69 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 r->info.pPayload
29510 3c 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 61 44 <pCur->pPage->aD
29520 61 74 61 45 6e 64 20 7c 7c 43 4f 52 52 55 50 54 ataEnd ||CORRUPT
29530 5f 44 42 29 3b 0a 20 20 61 6d 74 20 3d 20 70 43 _DB);. amt = pC
29540 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b ur->info.nLocal;
29550 0a 20 20 69 66 28 20 61 6d 74 3e 28 69 6e 74 29 . if( amt>(int)
29560 28 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 61 44 (pCur->pPage->aD
29570 61 74 61 45 6e 64 20 2d 20 70 43 75 72 2d 3e 69 ataEnd - pCur->i
29580 6e 66 6f 2e 70 50 61 79 6c 6f 61 64 29 20 29 7b nfo.pPayload) ){
29590 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 . /* There is
295a0 20 74 6f 6f 20 6c 69 74 74 6c 65 20 73 70 61 63 too little spac
295b0 65 20 6f 6e 20 74 68 65 20 70 61 67 65 20 66 6f e on the page fo
295c0 72 20 74 68 65 20 65 78 70 65 63 74 65 64 20 61 r the expected a
295d0 6d 6f 75 6e 74 0a 20 20 20 20 2a 2a 20 6f 66 20 mount. ** of
295e0 6c 6f 63 61 6c 20 63 6f 6e 74 65 6e 74 2e 20 44 local content. D
295f0 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 atabase must be
29600 63 6f 72 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 corrupt. */.
29610 61 73 73 65 72 74 28 20 43 4f 52 52 55 50 54 5f assert( CORRUPT_
29620 44 42 20 29 3b 0a 20 20 20 20 61 6d 74 20 3d 20 DB );. amt =
29630 4d 41 58 28 30 2c 20 28 69 6e 74 29 28 70 43 75 MAX(0, (int)(pCu
29640 72 2d 3e 70 50 61 67 65 2d 3e 61 44 61 74 61 45 r->pPage->aDataE
29650 6e 64 20 2d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e nd - pCur->info.
29660 70 50 61 79 6c 6f 61 64 29 29 3b 0a 20 20 7d 0a pPayload));. }.
29670 20 20 2a 70 41 6d 74 20 3d 20 28 75 33 32 29 61 *pAmt = (u32)a
29680 6d 74 3b 0a 20 20 72 65 74 75 72 6e 20 28 76 6f mt;. return (vo
29690 69 64 2a 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 id*)pCur->info.p
296a0 50 61 79 6c 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a 0a Payload;.}.../*.
296b0 2a 2a 20 46 6f 72 20 74 68 65 20 65 6e 74 72 79 ** For the entry
296c0 20 74 68 61 74 20 63 75 72 73 6f 72 20 70 43 75 that cursor pCu
296d0 72 20 69 73 20 70 6f 69 6e 74 20 74 6f 2c 20 72 r is point to, r
296e0 65 74 75 72 6e 20 61 73 0a 2a 2a 20 6d 61 6e 79 eturn as.** many
296f0 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 6b 65 bytes of the ke
29700 79 20 6f 72 20 64 61 74 61 20 61 73 20 61 72 65 y or data as are
29710 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 74 68 available on th
29720 65 20 6c 6f 63 61 6c 0a 2a 2a 20 62 2d 74 72 65 e local.** b-tre
29730 65 20 70 61 67 65 2e 20 20 57 72 69 74 65 20 74 e page. Write t
29740 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 76 61 he number of ava
29750 69 6c 61 62 6c 65 20 62 79 74 65 73 20 69 6e 74 ilable bytes int
29760 6f 20 2a 70 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 54 o *pAmt..**.** T
29770 68 65 20 70 6f 69 6e 74 65 72 20 72 65 74 75 72 he pointer retur
29780 6e 65 64 20 69 73 20 65 70 68 65 6d 65 72 61 6c ned is ephemeral
29790 2e 20 20 54 68 65 20 6b 65 79 2f 64 61 74 61 20 . The key/data
297a0 6d 61 79 20 6d 6f 76 65 0a 2a 2a 20 6f 72 20 62 may move.** or b
297b0 65 20 64 65 73 74 72 6f 79 65 64 20 6f 6e 20 74 e destroyed on t
297c0 68 65 20 6e 65 78 74 20 63 61 6c 6c 20 74 6f 20 he next call to
297d0 61 6e 79 20 42 74 72 65 65 20 72 6f 75 74 69 6e any Btree routin
297e0 65 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 e,.** including
297f0 63 61 6c 6c 73 20 66 72 6f 6d 20 6f 74 68 65 72 calls from other
29800 20 74 68 72 65 61 64 73 20 61 67 61 69 6e 73 74 threads against
29810 20 74 68 65 20 73 61 6d 65 20 63 61 63 68 65 2e the same cache.
29820 0a 2a 2a 20 48 65 6e 63 65 2c 20 61 20 6d 75 74 .** Hence, a mut
29830 65 78 20 6f 6e 20 74 68 65 20 42 74 53 68 61 72 ex on the BtShar
29840 65 64 20 73 68 6f 75 6c 64 20 62 65 20 68 65 6c ed should be hel
29850 64 20 70 72 69 6f 72 20 74 6f 20 63 61 6c 6c 69 d prior to calli
29860 6e 67 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 ng.** this routi
29870 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 ne..**.** These
29880 72 6f 75 74 69 6e 65 73 20 69 73 20 75 73 65 64 routines is used
29890 20 74 6f 20 67 65 74 20 71 75 69 63 6b 20 61 63 to get quick ac
298a0 63 65 73 73 20 74 6f 20 6b 65 79 20 61 6e 64 20 cess to key and
298b0 64 61 74 61 0a 2a 2a 20 69 6e 20 74 68 65 20 63 data.** in the c
298c0 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 65 72 65 ommon case where
298d0 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 no overflow pag
298e0 65 73 20 61 72 65 20 75 73 65 64 2e 0a 2a 2f 0a es are used..*/.
298f0 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 const void *sqli
29900 74 65 33 42 74 72 65 65 50 61 79 6c 6f 61 64 46 te3BtreePayloadF
29910 65 74 63 68 28 42 74 43 75 72 73 6f 72 20 2a 70 etch(BtCursor *p
29920 43 75 72 2c 20 75 33 32 20 2a 70 41 6d 74 29 7b Cur, u32 *pAmt){
29930 0a 20 20 72 65 74 75 72 6e 20 66 65 74 63 68 50 . return fetchP
29940 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 41 6d ayload(pCur, pAm
29950 74 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 6f t);.}.../*.** Mo
29960 76 65 20 74 68 65 20 63 75 72 73 6f 72 20 64 6f ve the cursor do
29970 77 6e 20 74 6f 20 61 20 6e 65 77 20 63 68 69 6c wn to a new chil
29980 64 20 70 61 67 65 2e 20 20 54 68 65 20 6e 65 77 d page. The new
29990 50 67 6e 6f 20 61 72 67 75 6d 65 6e 74 20 69 73 Pgno argument is
299a0 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 6e 75 6d the.** page num
299b0 62 65 72 20 6f 66 20 74 68 65 20 63 68 69 6c 64 ber of the child
299c0 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 20 74 6f page to move to
299d0 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
299e0 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 ction returns SQ
299f0 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 69 66 20 LITE_CORRUPT if
29a00 74 68 65 20 70 61 67 65 2d 68 65 61 64 65 72 20 the page-header
29a10 66 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 0a 2a flags field of.*
29a20 2a 20 74 68 65 20 6e 65 77 20 63 68 69 6c 64 20 * the new child
29a30 70 61 67 65 20 64 6f 65 73 20 6e 6f 74 20 6d 61 page does not ma
29a40 74 63 68 20 74 68 65 20 66 6c 61 67 73 20 66 69 tch the flags fi
29a50 65 6c 64 20 6f 66 20 74 68 65 20 70 61 72 65 6e eld of the paren
29a60 74 20 28 69 2e 65 2e 0a 2a 2a 20 69 66 20 61 6e t (i.e..** if an
29a70 20 69 6e 74 6b 65 79 20 70 61 67 65 20 61 70 70 intkey page app
29a80 65 61 72 73 20 74 6f 20 62 65 20 74 68 65 20 70 ears to be the p
29a90 61 72 65 6e 74 20 6f 66 20 61 20 6e 6f 6e 2d 69 arent of a non-i
29aa0 6e 74 6b 65 79 20 70 61 67 65 2c 20 6f 72 0a 2a ntkey page, or.*
29ab0 2a 20 76 69 63 65 2d 76 65 72 73 61 29 2e 0a 2a * vice-versa)..*
29ac0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 /.static int mov
29ad0 65 54 6f 43 68 69 6c 64 28 42 74 43 75 72 73 6f eToChild(BtCurso
29ae0 72 20 2a 70 43 75 72 2c 20 75 33 32 20 6e 65 77 r *pCur, u32 new
29af0 50 67 6e 6f 29 7b 0a 20 20 42 74 53 68 61 72 65 Pgno){. BtShare
29b00 64 20 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 d *pBt = pCur->p
29b10 42 74 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 Bt;.. assert( c
29b20 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
29b30 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 d(pCur) );. ass
29b40 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
29b50 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
29b60 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
29b70 72 2d 3e 69 50 61 67 65 3c 42 54 43 55 52 53 4f r->iPage<BTCURSO
29b80 52 5f 4d 41 58 5f 44 45 50 54 48 20 29 3b 0a 20 R_MAX_DEPTH );.
29b90 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
29ba0 50 61 67 65 3e 3d 30 20 29 3b 0a 20 20 69 66 28 Page>=0 );. if(
29bb0 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 28 42 pCur->iPage>=(B
29bc0 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 45 50 54 TCURSOR_MAX_DEPT
29bd0 48 2d 31 29 20 29 7b 0a 20 20 20 20 72 65 74 75 H-1) ){. retu
29be0 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
29bf0 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 70 43 T_BKPT;. }. pC
29c00 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d ur->info.nSize =
29c10 20 30 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 0;. pCur->curF
29c20 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 56 lags &= ~(BTCF_V
29c30 61 6c 69 64 4e 4b 65 79 7c 42 54 43 46 5f 56 61 alidNKey|BTCF_Va
29c40 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 70 43 75 72 lidOvfl);. pCur
29c50 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
29c60 61 67 65 5d 20 3d 20 70 43 75 72 2d 3e 69 78 3b age] = pCur->ix;
29c70 0a 20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b . pCur->apPage[
29c80 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 70 pCur->iPage] = p
29c90 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 70 43 Cur->pPage;. pC
29ca0 75 72 2d 3e 69 78 20 3d 20 30 3b 0a 20 20 70 43 ur->ix = 0;. pC
29cb0 75 72 2d 3e 69 50 61 67 65 2b 2b 3b 0a 20 20 72 ur->iPage++;. r
29cc0 65 74 75 72 6e 20 67 65 74 41 6e 64 49 6e 69 74 eturn getAndInit
29cd0 50 61 67 65 28 70 42 74 2c 20 6e 65 77 50 67 6e Page(pBt, newPgn
29ce0 6f 2c 20 26 70 43 75 72 2d 3e 70 50 61 67 65 2c o, &pCur->pPage,
29cf0 20 70 43 75 72 2c 20 70 43 75 72 2d 3e 63 75 72 pCur, pCur->cur
29d00 50 61 67 65 72 46 6c 61 67 73 29 3b 0a 7d 0a 0a PagerFlags);.}..
29d10 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
29d20 42 55 47 0a 2f 2a 0a 2a 2a 20 50 61 67 65 20 70 BUG./*.** Page p
29d30 50 61 72 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 Parent is an int
29d40 65 72 6e 61 6c 20 28 6e 6f 6e 2d 6c 65 61 66 29 ernal (non-leaf)
29d50 20 74 72 65 65 20 70 61 67 65 2e 20 54 68 69 73 tree page. This
29d60 20 66 75 6e 63 74 69 6f 6e 20 0a 2a 2a 20 61 73 function .** as
29d70 73 65 72 74 73 20 74 68 61 74 20 70 61 67 65 20 serts that page
29d80 6e 75 6d 62 65 72 20 69 43 68 69 6c 64 20 69 73 number iChild is
29d90 20 74 68 65 20 6c 65 66 74 2d 63 68 69 6c 64 20 the left-child
29da0 69 66 20 74 68 65 20 69 49 64 78 27 74 68 0a 2a if the iIdx'th.*
29db0 2a 20 63 65 6c 6c 20 69 6e 20 70 61 67 65 20 70 * cell in page p
29dc0 50 61 72 65 6e 74 2e 20 4f 72 2c 20 69 66 20 69 Parent. Or, if i
29dd0 49 64 78 20 69 73 20 65 71 75 61 6c 20 74 6f 20 Idx is equal to
29de0 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 the total number
29df0 20 6f 66 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 of.** cells in
29e00 70 50 61 72 65 6e 74 2c 20 74 68 61 74 20 70 61 pParent, that pa
29e10 67 65 20 6e 75 6d 62 65 72 20 69 43 68 69 6c 64 ge number iChild
29e20 20 69 73 20 74 68 65 20 72 69 67 68 74 2d 63 68 is the right-ch
29e30 69 6c 64 20 6f 66 0a 2a 2a 20 74 68 65 20 70 61 ild of.** the pa
29e40 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ge..*/.static vo
29e50 69 64 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 id assertParentI
29e60 6e 64 65 78 28 4d 65 6d 50 61 67 65 20 2a 70 50 ndex(MemPage *pP
29e70 61 72 65 6e 74 2c 20 69 6e 74 20 69 49 64 78 2c arent, int iIdx,
29e80 20 50 67 6e 6f 20 69 43 68 69 6c 64 29 7b 0a 20 Pgno iChild){.
29e90 20 69 66 28 20 43 4f 52 52 55 50 54 5f 44 42 20 if( CORRUPT_DB
29ea0 29 20 72 65 74 75 72 6e 3b 20 20 2f 2a 20 54 68 ) return; /* Th
29eb0 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 74 65 73 e conditions tes
29ec0 74 65 64 20 62 65 6c 6f 77 20 6d 69 67 68 74 20 ted below might
29ed0 6e 6f 74 20 62 65 20 74 72 75 65 0a 20 20 20 20 not be true.
29ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29ef0 20 20 20 20 20 20 20 20 2a 2a 20 69 6e 20 61 20 ** in a
29f00 63 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 corrupt database
29f10 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 69 49 */. assert( iI
29f20 64 78 3c 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 dx<=pParent->nCe
29f30 6c 6c 20 29 3b 0a 20 20 69 66 28 20 69 49 64 78 ll );. if( iIdx
29f40 3d 3d 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c ==pParent->nCell
29f50 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
29f60 67 65 74 34 62 79 74 65 28 26 70 50 61 72 65 6e get4byte(&pParen
29f70 74 2d 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 t->aData[pParent
29f80 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3d ->hdrOffset+8])=
29f90 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d 65 6c =iChild );. }el
29fa0 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 se{. assert(
29fb0 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c get4byte(findCel
29fc0 6c 28 70 50 61 72 65 6e 74 2c 20 69 49 64 78 29 l(pParent, iIdx)
29fd0 29 3d 3d 69 43 68 69 6c 64 20 29 3b 0a 20 20 7d )==iChild );. }
29fe0 0a 7d 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 69 .}.#else.# defi
29ff0 6e 65 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 ne assertParentI
2a000 6e 64 65 78 28 78 2c 79 2c 7a 29 20 0a 23 65 6e ndex(x,y,z) .#en
2a010 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 dif../*.** Move
2a020 74 68 65 20 63 75 72 73 6f 72 20 75 70 20 74 6f the cursor up to
2a030 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 the parent page
2a040 2e 0a 2a 2a 0a 2a 2a 20 70 43 75 72 2d 3e 69 64 ..**.** pCur->id
2a050 78 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 x is set to the
2a060 63 65 6c 6c 20 69 6e 64 65 78 20 74 68 61 74 20 cell index that
2a070 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 6f 69 contains the poi
2a080 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 70 nter.** to the p
2a090 61 67 65 20 77 65 20 61 72 65 20 63 6f 6d 69 6e age we are comin
2a0a0 67 20 66 72 6f 6d 2e 20 20 49 66 20 77 65 20 61 g from. If we a
2a0b0 72 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 74 re coming from t
2a0c0 68 65 0a 2a 2a 20 72 69 67 68 74 2d 6d 6f 73 74 he.** right-most
2a0d0 20 63 68 69 6c 64 20 70 61 67 65 20 74 68 65 6e child page then
2a0e0 20 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 65 pCur->idx is se
2a0f0 74 20 74 6f 20 6f 6e 65 20 6d 6f 72 65 20 74 68 t to one more th
2a100 61 6e 0a 2a 2a 20 74 68 65 20 6c 61 72 67 65 73 an.** the larges
2a110 74 20 63 65 6c 6c 20 69 6e 64 65 78 2e 0a 2a 2f t cell index..*/
2a120 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d 6f 76 .static void mov
2a130 65 54 6f 50 61 72 65 6e 74 28 42 74 43 75 72 73 eToParent(BtCurs
2a140 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 4d 65 6d or *pCur){. Mem
2a150 50 61 67 65 20 2a 70 4c 65 61 66 3b 0a 20 20 61 Page *pLeaf;. a
2a160 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e ssert( cursorOwn
2a170 73 42 74 53 68 61 72 65 64 28 70 43 75 72 29 20 sBtShared(pCur)
2a180 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2a190 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
2a1a0 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 R_VALID );. ass
2a1b0 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 65 ert( pCur->iPage
2a1c0 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 >0 );. assert(
2a1d0 70 43 75 72 2d 3e 70 50 61 67 65 20 29 3b 0a 20 pCur->pPage );.
2a1e0 20 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 assertParentInd
2a1f0 65 78 28 0a 20 20 20 20 70 43 75 72 2d 3e 61 70 ex(. pCur->ap
2a200 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 Page[pCur->iPage
2a210 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d 3e -1], . pCur->
2a220 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
2a230 65 2d 31 5d 2c 20 0a 20 20 20 20 70 43 75 72 2d e-1], . pCur-
2a240 3e 70 50 61 67 65 2d 3e 70 67 6e 6f 0a 20 20 29 >pPage->pgno. )
2a250 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 43 ;. testcase( pC
2a260 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
2a270 69 50 61 67 65 2d 31 5d 20 3e 20 70 43 75 72 2d iPage-1] > pCur-
2a280 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
2a290 61 67 65 2d 31 5d 2d 3e 6e 43 65 6c 6c 20 29 3b age-1]->nCell );
2a2a0 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 . pCur->info.nS
2a2b0 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d ize = 0;. pCur-
2a2c0 3e 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 >curFlags &= ~(B
2a2d0 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 TCF_ValidNKey|BT
2a2e0 43 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 CF_ValidOvfl);.
2a2f0 20 70 43 75 72 2d 3e 69 78 20 3d 20 70 43 75 72 pCur->ix = pCur
2a300 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
2a310 61 67 65 2d 31 5d 3b 0a 20 20 70 4c 65 61 66 20 age-1];. pLeaf
2a320 3d 20 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 = pCur->pPage;.
2a330 20 70 43 75 72 2d 3e 70 50 61 67 65 20 3d 20 70 pCur->pPage = p
2a340 43 75 72 2d 3e 61 70 50 61 67 65 5b 2d 2d 70 43 Cur->apPage[--pC
2a350 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 72 65 ur->iPage];. re
2a360 6c 65 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c leasePageNotNull
2a370 28 70 4c 65 61 66 29 3b 0a 7d 0a 0a 2f 2a 0a 2a (pLeaf);.}../*.*
2a380 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 6f * Move the curso
2a390 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 r to point to th
2a3a0 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 69 e root page of i
2a3b0 74 73 20 62 2d 74 72 65 65 20 73 74 72 75 63 74 ts b-tree struct
2a3c0 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ure..**.** If th
2a3d0 65 20 74 61 62 6c 65 20 68 61 73 20 61 20 76 69 e table has a vi
2a3e0 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2c rtual root page,
2a3f0 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
2a400 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 70 6f 69 is moved to poi
2a410 6e 74 0a 2a 2a 20 74 6f 20 74 68 65 20 76 69 72 nt.** to the vir
2a420 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 69 tual root page i
2a430 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 61 63 nstead of the ac
2a440 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e 20 tual root page.
2a450 41 20 74 61 62 6c 65 20 68 61 73 20 61 0a 2a 2a A table has a.**
2a460 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 virtual root pa
2a470 67 65 20 77 68 65 6e 20 74 68 65 20 61 63 74 75 ge when the actu
2a480 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 63 6f 6e al root page con
2a490 74 61 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 61 tains no cells a
2a4a0 6e 64 20 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 20 nd a .** single
2a4b0 63 68 69 6c 64 20 70 61 67 65 2e 20 54 68 69 73 child page. This
2a4c0 20 63 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 6e can only happen
2a4d0 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 20 with the table
2a4e0 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 31 rooted at page 1
2a4f0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 ..**.** If the b
2a500 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 -tree structure
2a510 69 73 20 65 6d 70 74 79 2c 20 74 68 65 20 63 75 is empty, the cu
2a520 72 73 6f 72 20 73 74 61 74 65 20 69 73 20 73 65 rsor state is se
2a530 74 20 74 6f 20 0a 2a 2a 20 43 55 52 53 4f 52 5f t to .** CURSOR_
2a540 49 4e 56 41 4c 49 44 20 61 6e 64 20 74 68 69 73 INVALID and this
2a550 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e 73 routine returns
2a560 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 2e 20 4f SQLITE_EMPTY. O
2a570 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 74 68 65 therwise,.** the
2a580 20 63 75 72 73 6f 72 20 69 73 20 73 65 74 20 74 cursor is set t
2a590 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 o point to the f
2a5a0 69 72 73 74 20 63 65 6c 6c 20 6c 6f 63 61 74 65 irst cell locate
2a5b0 64 20 6f 6e 20 74 68 65 20 72 6f 6f 74 0a 2a 2a d on the root.**
2a5c0 20 28 6f 72 20 76 69 72 74 75 61 6c 20 72 6f 6f (or virtual roo
2a5d0 74 29 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 t) page and the
2a5e0 63 75 72 73 6f 72 20 73 74 61 74 65 20 69 73 20 cursor state is
2a5f0 73 65 74 20 74 6f 20 43 55 52 53 4f 52 5f 56 41 set to CURSOR_VA
2a600 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 LID..**.** If th
2a610 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 is function retu
2a620 72 6e 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 rns successfully
2a630 2c 20 69 74 20 6d 61 79 20 62 65 20 61 73 73 75 , it may be assu
2a640 6d 65 64 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 med that the.**
2a650 70 61 67 65 2d 68 65 61 64 65 72 20 66 6c 61 67 page-header flag
2a660 73 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 s indicate that
2a670 74 68 65 20 5b 76 69 72 74 75 61 6c 5d 20 72 6f the [virtual] ro
2a680 6f 74 2d 70 61 67 65 20 69 73 20 74 68 65 20 65 ot-page is the e
2a690 78 70 65 63 74 65 64 20 0a 2a 2a 20 6b 69 6e 64 xpected .** kind
2a6a0 20 6f 66 20 62 2d 74 72 65 65 20 70 61 67 65 20 of b-tree page
2a6b0 28 69 2e 65 2e 20 69 66 20 77 68 65 6e 20 6f 70 (i.e. if when op
2a6c0 65 6e 69 6e 67 20 74 68 65 20 63 75 72 73 6f 72 ening the cursor
2a6d0 20 74 68 65 20 63 61 6c 6c 65 72 20 64 69 64 20 the caller did
2a6e0 6e 6f 74 0a 2a 2a 20 73 70 65 63 69 66 79 20 61 not.** specify a
2a6f0 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 KeyInfo structu
2a700 72 65 20 74 68 65 20 66 6c 61 67 73 20 62 79 74 re the flags byt
2a710 65 20 69 73 20 73 65 74 20 74 6f 20 30 78 30 35 e is set to 0x05
2a720 20 6f 72 20 30 78 30 44 2c 0a 2a 2a 20 69 6e 64 or 0x0D,.** ind
2a730 69 63 61 74 69 6e 67 20 61 20 74 61 62 6c 65 20 icating a table
2a740 62 2d 74 72 65 65 2c 20 6f 72 20 69 66 20 74 68 b-tree, or if th
2a750 65 20 63 61 6c 6c 65 72 20 64 69 64 20 73 70 65 e caller did spe
2a760 63 69 66 79 20 61 20 4b 65 79 49 6e 66 6f 20 0a cify a KeyInfo .
2a770 2a 2a 20 73 74 72 75 63 74 75 72 65 20 74 68 65 ** structure the
2a780 20 66 6c 61 67 73 20 62 79 74 65 20 69 73 20 73 flags byte is s
2a790 65 74 20 74 6f 20 30 78 30 32 20 6f 72 20 30 78 et to 0x02 or 0x
2a7a0 30 41 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 61 0A, indicating a
2a7b0 6e 20 69 6e 64 65 78 0a 2a 2a 20 62 2d 74 72 65 n index.** b-tre
2a7c0 65 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e e)..*/.static in
2a7d0 74 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 42 74 43 t moveToRoot(BtC
2a7e0 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
2a7f0 4d 65 6d 50 61 67 65 20 2a 70 52 6f 6f 74 3b 0a MemPage *pRoot;.
2a800 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
2a810 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 E_OK;.. assert(
2a820 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 cursorOwnsBtSha
2a830 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 red(pCur) );. a
2a840 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 49 4e ssert( CURSOR_IN
2a850 56 41 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f 52 VALID < CURSOR_R
2a860 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
2a870 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 assert( CURSOR_V
2a880 41 4c 49 44 20 20 20 3c 20 43 55 52 53 4f 52 5f ALID < CURSOR_
2a890 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 REQUIRESEEK );.
2a8a0 20 61 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f assert( CURSOR_
2a8b0 46 41 55 4c 54 20 20 20 3e 20 43 55 52 53 4f 52 FAULT > CURSOR
2a8c0 5f 52 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a _REQUIRESEEK );.
2a8d0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2a8e0 65 53 74 61 74 65 20 3c 20 43 55 52 53 4f 52 5f eState < CURSOR_
2a8f0 52 45 51 55 49 52 45 53 45 45 4b 20 7c 7c 20 70 REQUIRESEEK || p
2a900 43 75 72 2d 3e 69 50 61 67 65 3c 30 20 29 3b 0a Cur->iPage<0 );.
2a910 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
2a920 70 67 6e 6f 52 6f 6f 74 3e 30 20 7c 7c 20 70 43 pgnoRoot>0 || pC
2a930 75 72 2d 3e 69 50 61 67 65 3c 30 20 29 3b 0a 0a ur->iPage<0 );..
2a940 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 if( pCur->iPag
2a950 65 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 e>=0 ){. if(
2a960 70 43 75 72 2d 3e 69 50 61 67 65 20 29 7b 0a 20 pCur->iPage ){.
2a970 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
2a980 4e 6f 74 4e 75 6c 6c 28 70 43 75 72 2d 3e 70 50 NotNull(pCur->pP
2a990 61 67 65 29 3b 0a 20 20 20 20 20 20 77 68 69 6c age);. whil
2a9a0 65 28 20 2d 2d 70 43 75 72 2d 3e 69 50 61 67 65 e( --pCur->iPage
2a9b0 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 6c 65 ){. rele
2a9c0 61 73 65 50 61 67 65 4e 6f 74 4e 75 6c 6c 28 70 asePageNotNull(p
2a9d0 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
2a9e0 2d 3e 69 50 61 67 65 5d 29 3b 0a 20 20 20 20 20 ->iPage]);.
2a9f0 20 7d 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 70 }. pCur->p
2aa00 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 Page = pCur->apP
2aa10 61 67 65 5b 30 5d 3b 0a 20 20 20 20 20 20 67 6f age[0];. go
2aa20 74 6f 20 73 6b 69 70 5f 69 6e 69 74 3b 0a 20 20 to skip_init;.
2aa30 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 }. }else if(
2aa40 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d pCur->pgnoRoot==
2aa50 30 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 0 ){. pCur->e
2aa60 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 State = CURSOR_I
2aa70 4e 56 41 4c 49 44 3b 0a 20 20 20 20 72 65 74 75 NVALID;. retu
2aa80 72 6e 20 53 51 4c 49 54 45 5f 45 4d 50 54 59 3b rn SQLITE_EMPTY;
2aa90 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 . }else{. as
2aaa0 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 sert( pCur->iPag
2aab0 65 3d 3d 28 2d 31 29 20 29 3b 0a 20 20 20 20 69 e==(-1) );. i
2aac0 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3e f( pCur->eState>
2aad0 3d 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 53 =CURSOR_REQUIRES
2aae0 45 45 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 28 EEK ){. if(
2aaf0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
2ab00 55 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a 20 URSOR_FAULT ){.
2ab10 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 assert( p
2ab20 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 Cur->skipNext!=S
2ab30 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 QLITE_OK );.
2ab40 20 20 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d return pCur-
2ab50 3e 73 6b 69 70 4e 65 78 74 3b 0a 20 20 20 20 20 >skipNext;.
2ab60 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
2ab70 42 74 72 65 65 43 6c 65 61 72 43 75 72 73 6f 72 BtreeClearCursor
2ab80 28 70 43 75 72 29 3b 0a 20 20 20 20 7d 0a 20 20 (pCur);. }.
2ab90 20 20 72 63 20 3d 20 67 65 74 41 6e 64 49 6e 69 rc = getAndIni
2aba0 74 50 61 67 65 28 70 43 75 72 2d 3e 70 42 74 72 tPage(pCur->pBtr
2abb0 65 65 2d 3e 70 42 74 2c 20 70 43 75 72 2d 3e 70 ee->pBt, pCur->p
2abc0 67 6e 6f 52 6f 6f 74 2c 20 26 70 43 75 72 2d 3e gnoRoot, &pCur->
2abd0 70 50 61 67 65 2c 0a 20 20 20 20 20 20 20 20 20 pPage,.
2abe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0
2abf0 2c 20 70 43 75 72 2d 3e 63 75 72 50 61 67 65 72 , pCur->curPager
2ac00 46 6c 61 67 73 29 3b 0a 20 20 20 20 69 66 28 20 Flags);. if(
2ac10 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
2ac20 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 74 . pCur->eSt
2ac30 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 ate = CURSOR_INV
2ac40 41 4c 49 44 3b 0a 20 20 20 20 20 20 72 65 74 75 ALID;. retu
2ac50 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 rn rc;. }.
2ac60 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 30 pCur->iPage = 0
2ac70 3b 0a 20 20 20 20 70 43 75 72 2d 3e 63 75 72 49 ;. pCur->curI
2ac80 6e 74 4b 65 79 20 3d 20 70 43 75 72 2d 3e 70 50 ntKey = pCur->pP
2ac90 61 67 65 2d 3e 69 6e 74 4b 65 79 3b 0a 20 20 7d age->intKey;. }
2aca0 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 75 72 2d . pRoot = pCur-
2acb0 3e 70 50 61 67 65 3b 0a 20 20 61 73 73 65 72 74 >pPage;. assert
2acc0 28 20 70 52 6f 6f 74 2d 3e 70 67 6e 6f 3d 3d 70 ( pRoot->pgno==p
2acd0 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 29 3b Cur->pgnoRoot );
2ace0 0a 0a 20 20 2f 2a 20 49 66 20 70 43 75 72 2d 3e .. /* If pCur->
2acf0 70 4b 65 79 49 6e 66 6f 20 69 73 20 6e 6f 74 20 pKeyInfo is not
2ad00 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65 20 63 NULL, then the c
2ad10 61 6c 6c 65 72 20 74 68 61 74 20 6f 70 65 6e 65 aller that opene
2ad20 64 20 74 68 69 73 20 63 75 72 73 6f 72 0a 20 20 d this cursor.
2ad30 2a 2a 20 65 78 70 65 63 74 65 64 20 74 6f 20 6f ** expected to o
2ad40 70 65 6e 20 69 74 20 6f 6e 20 61 6e 20 69 6e 64 pen it on an ind
2ad50 65 78 20 62 2d 74 72 65 65 2e 20 4f 74 68 65 72 ex b-tree. Other
2ad60 77 69 73 65 2c 20 69 66 20 70 4b 65 79 49 6e 66 wise, if pKeyInf
2ad70 6f 20 69 73 0a 20 20 2a 2a 20 4e 55 4c 4c 2c 20 o is. ** NULL,
2ad80 74 68 65 20 63 61 6c 6c 65 72 20 65 78 70 65 63 the caller expec
2ad90 74 73 20 61 20 74 61 62 6c 65 20 62 2d 74 72 65 ts a table b-tre
2ada0 65 2e 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f e. If this is no
2adb0 74 20 74 68 65 20 63 61 73 65 2c 0a 20 20 2a 2a t the case,. **
2adc0 20 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 49 54 return an SQLIT
2add0 45 5f 43 4f 52 52 55 50 54 20 65 72 72 6f 72 2e E_CORRUPT error.
2ade0 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 45 61 72 6c . **. ** Earl
2adf0 69 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 ier versions of
2ae00 53 51 4c 69 74 65 20 61 73 73 75 6d 65 64 20 74 SQLite assumed t
2ae10 68 61 74 20 74 68 69 73 20 74 65 73 74 20 63 6f hat this test co
2ae20 75 6c 64 20 6e 6f 74 20 66 61 69 6c 0a 20 20 2a uld not fail. *
2ae30 2a 20 69 66 20 74 68 65 20 72 6f 6f 74 20 70 61 * if the root pa
2ae40 67 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 6c ge was already l
2ae50 6f 61 64 65 64 20 77 68 65 6e 20 74 68 69 73 20 oaded when this
2ae60 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 61 6c function was cal
2ae70 6c 65 64 20 28 69 2e 65 2e 0a 20 20 2a 2a 20 69 led (i.e.. ** i
2ae80 66 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 f pCur->iPage>=0
2ae90 29 2e 20 42 75 74 20 74 68 69 73 20 69 73 20 6e ). But this is n
2aea0 6f 74 20 73 6f 20 69 66 20 74 68 65 20 64 61 74 ot so if the dat
2aeb0 61 62 61 73 65 20 69 73 20 63 6f 72 72 75 70 74 abase is corrupt
2aec0 65 64 20 0a 20 20 2a 2a 20 69 6e 20 73 75 63 68 ed . ** in such
2aed0 20 61 20 77 61 79 20 74 68 61 74 20 70 61 67 65 a way that page
2aee0 20 70 52 6f 6f 74 20 69 73 20 6c 69 6e 6b 65 64 pRoot is linked
2aef0 20 69 6e 74 6f 20 61 20 73 65 63 6f 6e 64 20 62 into a second b
2af00 2d 74 72 65 65 20 74 61 62 6c 65 20 0a 20 20 2a -tree table . *
2af10 2a 20 28 6f 72 20 74 68 65 20 66 72 65 65 6c 69 * (or the freeli
2af20 73 74 29 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 st). */. asser
2af30 74 28 20 70 52 6f 6f 74 2d 3e 69 6e 74 4b 65 79 t( pRoot->intKey
2af40 3d 3d 31 20 7c 7c 20 70 52 6f 6f 74 2d 3e 69 6e ==1 || pRoot->in
2af50 74 4b 65 79 3d 3d 30 20 29 3b 0a 20 20 69 66 28 tKey==0 );. if(
2af60 20 70 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 3d 3d pRoot->isInit==
2af70 30 20 7c 7c 20 28 70 43 75 72 2d 3e 70 4b 65 79 0 || (pCur->pKey
2af80 49 6e 66 6f 3d 3d 30 29 21 3d 70 52 6f 6f 74 2d Info==0)!=pRoot-
2af90 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 72 >intKey ){. r
2afa0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
2afb0 52 55 50 54 5f 50 41 47 45 28 70 43 75 72 2d 3e RUPT_PAGE(pCur->
2afc0 70 50 61 67 65 29 3b 0a 20 20 7d 0a 0a 73 6b 69 pPage);. }..ski
2afd0 70 5f 69 6e 69 74 3a 20 20 0a 20 20 70 43 75 72 p_init: . pCur
2afe0 2d 3e 69 78 20 3d 20 30 3b 0a 20 20 70 43 75 72 ->ix = 0;. pCur
2aff0 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
2b000 3b 0a 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 ;. pCur->curFla
2b010 67 73 20 26 3d 20 7e 28 42 54 43 46 5f 41 74 4c gs &= ~(BTCF_AtL
2b020 61 73 74 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b ast|BTCF_ValidNK
2b030 65 79 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 ey|BTCF_ValidOvf
2b040 6c 29 3b 0a 0a 20 20 70 52 6f 6f 74 20 3d 20 70 l);.. pRoot = p
2b050 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 69 66 Cur->pPage;. if
2b060 28 20 70 52 6f 6f 74 2d 3e 6e 43 65 6c 6c 3e 30 ( pRoot->nCell>0
2b070 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 ){. pCur->eS
2b080 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 tate = CURSOR_VA
2b090 4c 49 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 LID;. }else if(
2b0a0 20 21 70 52 6f 6f 74 2d 3e 6c 65 61 66 20 29 7b !pRoot->leaf ){
2b0b0 0a 20 20 20 20 50 67 6e 6f 20 73 75 62 70 61 67 . Pgno subpag
2b0c0 65 3b 0a 20 20 20 20 69 66 28 20 70 52 6f 6f 74 e;. if( pRoot
2b0d0 2d 3e 70 67 6e 6f 21 3d 31 20 29 20 72 65 74 75 ->pgno!=1 ) retu
2b0e0 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
2b0f0 54 5f 42 4b 50 54 3b 0a 20 20 20 20 73 75 62 70 T_BKPT;. subp
2b100 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 26 age = get4byte(&
2b110 70 52 6f 6f 74 2d 3e 61 44 61 74 61 5b 70 52 6f pRoot->aData[pRo
2b120 6f 74 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d ot->hdrOffset+8]
2b130 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 );. pCur->eSt
2b140 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 4c ate = CURSOR_VAL
2b150 49 44 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 ID;. rc = mov
2b160 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c 20 73 eToChild(pCur, s
2b170 75 62 70 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 ubpage);. }else
2b180 7b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 74 61 {. pCur->eSta
2b190 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 te = CURSOR_INVA
2b1a0 4c 49 44 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 LID;. rc = SQ
2b1b0 4c 49 54 45 5f 45 4d 50 54 59 3b 0a 20 20 7d 0a LITE_EMPTY;. }.
2b1c0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
2b1d0 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 /*.** Move the c
2b1e0 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f 20 74 68 ursor down to th
2b1f0 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6c 65 61 66 e left-most leaf
2b200 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 entry beneath t
2b210 68 65 0a 2a 2a 20 65 6e 74 72 79 20 74 6f 20 77 he.** entry to w
2b220 68 69 63 68 20 69 74 20 69 73 20 63 75 72 72 65 hich it is curre
2b230 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 2e 0a 2a ntly pointing..*
2b240 2a 0a 2a 2a 20 54 68 65 20 6c 65 66 74 2d 6d 6f *.** The left-mo
2b250 73 74 20 6c 65 61 66 20 69 73 20 74 68 65 20 6f st leaf is the o
2b260 6e 65 20 77 69 74 68 20 74 68 65 20 73 6d 61 6c ne with the smal
2b270 6c 65 73 74 20 6b 65 79 20 2d 20 74 68 65 20 66 lest key - the f
2b280 69 72 73 74 0a 2a 2a 20 69 6e 20 61 73 63 65 6e irst.** in ascen
2b290 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 ding order..*/.s
2b2a0 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f tatic int moveTo
2b2b0 4c 65 66 74 6d 6f 73 74 28 42 74 43 75 72 73 6f Leftmost(BtCurso
2b2c0 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e 6f r *pCur){. Pgno
2b2d0 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 20 pgno;. int rc
2b2e0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 4d = SQLITE_OK;. M
2b2f0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a emPage *pPage;..
2b300 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
2b310 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 OwnsBtShared(pCu
2b320 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
2b330 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
2b340 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
2b350 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 while( rc==SQLIT
2b360 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 67 65 20 E_OK && !(pPage
2b370 3d 20 70 43 75 72 2d 3e 70 50 61 67 65 29 2d 3e = pCur->pPage)->
2b380 6c 65 61 66 20 29 7b 0a 20 20 20 20 61 73 73 65 leaf ){. asse
2b390 72 74 28 20 70 43 75 72 2d 3e 69 78 3c 70 50 61 rt( pCur->ix<pPa
2b3a0 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 ge->nCell );.
2b3b0 20 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 pgno = get4byte
2b3c0 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c (findCell(pPage,
2b3d0 20 70 43 75 72 2d 3e 69 78 29 29 3b 0a 20 20 20 pCur->ix));.
2b3e0 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c rc = moveToChil
2b3f0 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a 20 d(pCur, pgno);.
2b400 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
2b410 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 }../*.** Move th
2b420 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 6f e cursor down to
2b430 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 the right-most
2b440 6c 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 61 leaf entry benea
2b450 74 68 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 74 th the.** page t
2b460 6f 20 77 68 69 63 68 20 69 74 20 69 73 20 63 75 o which it is cu
2b470 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 rrently pointing
2b480 2e 20 20 4e 6f 74 69 63 65 20 74 68 65 20 64 69 . Notice the di
2b490 66 66 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 77 fference.** betw
2b4a0 65 65 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f een moveToLeftmo
2b4b0 73 74 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f 52 st() and moveToR
2b4c0 69 67 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f 76 ightmost(). mov
2b4d0 65 54 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a 2a eToLeftmost().**
2b4e0 20 66 69 6e 64 73 20 74 68 65 20 6c 65 66 74 2d finds the left-
2b4f0 6d 6f 73 74 20 65 6e 74 72 79 20 62 65 6e 65 61 most entry benea
2b500 74 68 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 77 th the *entry* w
2b510 68 65 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 67 hereas moveToRig
2b520 68 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e 64 htmost().** find
2b530 73 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 s the right-most
2b540 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 74 entry beneath t
2b550 68 65 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a 2a he *page*..**.**
2b560 20 54 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 The right-most
2b570 65 6e 74 72 79 20 69 73 20 74 68 65 20 6f 6e 65 entry is the one
2b580 20 77 69 74 68 20 74 68 65 20 6c 61 72 67 65 73 with the larges
2b590 74 20 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 74 t key - the last
2b5a0 0a 2a 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 6e .** key in ascen
2b5b0 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 ding order..*/.s
2b5c0 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 6f tatic int moveTo
2b5d0 52 69 67 68 74 6d 6f 73 74 28 42 74 43 75 72 73 Rightmost(BtCurs
2b5e0 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 6e or *pCur){. Pgn
2b5f0 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 63 o pgno;. int rc
2b600 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
2b610 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
2b620 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 0;.. assert( c
2b630 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 ursorOwnsBtShare
2b640 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 d(pCur) );. ass
2b650 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 ert( pCur->eStat
2b660 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 e==CURSOR_VALID
2b670 29 3b 0a 20 20 77 68 69 6c 65 28 20 21 28 70 50 );. while( !(pP
2b680 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 age = pCur->pPag
2b690 65 29 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 e)->leaf ){.
2b6a0 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 pgno = get4byte(
2b6b0 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 &pPage->aData[pP
2b6c0 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 age->hdrOffset+8
2b6d0 5d 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 ]);. pCur->ix
2b6e0 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b = pPage->nCell;
2b6f0 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f . rc = moveTo
2b700 43 68 69 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f Child(pCur, pgno
2b710 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 );. if( rc )
2b720 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 return rc;. }.
2b730 20 70 43 75 72 2d 3e 69 78 20 3d 20 70 50 61 67 pCur->ix = pPag
2b740 65 2d 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 61 73 e->nCell-1;. as
2b750 73 65 72 74 28 20 70 43 75 72 2d 3e 69 6e 66 6f sert( pCur->info
2b760 2e 6e 53 69 7a 65 3d 3d 30 20 29 3b 0a 20 20 61 .nSize==0 );. a
2b770 73 73 65 72 74 28 20 28 70 43 75 72 2d 3e 63 75 ssert( (pCur->cu
2b780 72 46 6c 61 67 73 20 26 20 42 54 43 46 5f 56 61 rFlags & BTCF_Va
2b790 6c 69 64 4e 4b 65 79 29 3d 3d 30 20 29 3b 0a 20 lidNKey)==0 );.
2b7a0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2b7b0 4b 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 K;.}../* Move th
2b7c0 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 e cursor to the
2b7d0 66 69 72 73 74 20 65 6e 74 72 79 20 69 6e 20 74 first entry in t
2b7e0 68 65 20 74 61 62 6c 65 2e 20 20 52 65 74 75 72 he table. Retur
2b7f0 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f n SQLITE_OK.** o
2b800 6e 20 73 75 63 63 65 73 73 2e 20 20 53 65 74 20 n success. Set
2b810 2a 70 52 65 73 20 74 6f 20 30 20 69 66 20 74 68 *pRes to 0 if th
2b820 65 20 63 75 72 73 6f 72 20 61 63 74 75 61 6c 6c e cursor actuall
2b830 79 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 y points to some
2b840 74 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 thing.** or set
2b850 2a 70 52 65 73 20 74 6f 20 31 20 69 66 20 74 68 *pRes to 1 if th
2b860 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 74 79 e table is empty
2b870 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
2b880 42 74 72 65 65 46 69 72 73 74 28 42 74 43 75 72 BtreeFirst(BtCur
2b890 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a sor *pCur, int *
2b8a0 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b pRes){. int rc;
2b8b0 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 .. assert( curs
2b8c0 6f 72 4f 77 6e 73 42 74 53 68 61 72 65 64 28 70 orOwnsBtShared(p
2b8d0 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
2b8e0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2b8f0 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 held(pCur->pBtre
2b900 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b e->db->mutex) );
2b910 0a 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f . rc = moveToRo
2b920 6f 74 28 70 43 75 72 29 3b 0a 20 20 69 66 28 20 ot(pCur);. if(
2b930 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2b940 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 . assert( pCu
2b950 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e r->pPage->nCell>
2b960 30 20 29 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d 0 );. *pRes =
2b970 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 0;. rc = mov
2b980 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 eToLeftmost(pCur
2b990 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 72 );. }else if( r
2b9a0 63 3d 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59 20 c==SQLITE_EMPTY
2b9b0 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 ){. assert( p
2b9c0 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 Cur->pgnoRoot==0
2b9d0 20 7c 7c 20 70 43 75 72 2d 3e 70 50 61 67 65 2d || pCur->pPage-
2b9e0 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 >nCell==0 );.
2b9f0 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 *pRes = 1;.
2ba00 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
2ba10 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
2ba20 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 .}../* Move the
2ba30 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 6c 61 cursor to the la
2ba40 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 st entry in the
2ba50 74 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 table. Return S
2ba60 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 QLITE_OK.** on s
2ba70 75 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 52 uccess. Set *pR
2ba80 65 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 63 es to 0 if the c
2ba90 75 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 70 ursor actually p
2baa0 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 oints to somethi
2bab0 6e 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 52 ng.** or set *pR
2bac0 65 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 74 es to 1 if the t
2bad0 61 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a able is empty..*
2bae0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
2baf0 65 65 4c 61 73 74 28 42 74 43 75 72 73 6f 72 20 eeLast(BtCursor
2bb00 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 *pCur, int *pRes
2bb10 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 0a 20 ){. int rc;. .
2bb20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 4f assert( cursorO
2bb30 77 6e 73 42 74 53 68 61 72 65 64 28 70 43 75 72 wnsBtShared(pCur
2bb40 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2bb50 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2bb60 64 28 70 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e d(pCur->pBtree->
2bb70 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20 db->mutex) );..
2bb80 20 2f 2a 20 49 66 20 74 68 65 20 63 75 72 73 6f /* If the curso
2bb90 72 20 61 6c 72 65 61 64 79 20 70 6f 69 6e 74 73 r already points
2bba0 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e 74 to the last ent
2bbb0 72 79 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f ry, this is a no
2bbc0 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 20 43 55 -op. */. if( CU
2bbd0 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 43 75 72 RSOR_VALID==pCur
2bbe0 2d 3e 65 53 74 61 74 65 20 26 26 20 28 70 43 75 ->eState && (pCu
2bbf0 72 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 r->curFlags & BT
2bc00 43 46 5f 41 74 4c 61 73 74 29 21 3d 30 20 29 7b CF_AtLast)!=0 ){
2bc10 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
2bc20 45 42 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 73 EBUG. /* This
2bc30 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 6f block serves to
2bc40 20 61 73 73 65 72 74 28 29 20 74 68 61 74 20 74 assert() that t
2bc50 68 65 20 63 75 72 73 6f 72 20 72 65 61 6c 6c 79 he cursor really
2bc60 20 64 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 20 does point .
2bc70 20 2a 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 20 ** to the last
2bc80 65 6e 74 72 79 20 69 6e 20 74 68 65 20 62 2d 74 entry in the b-t
2bc90 72 65 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ree. */. int
2bca0 69 69 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 ii;. for(ii=0
2bcb0 3b 20 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 65 ; ii<pCur->iPage
2bcc0 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 ; ii++){. a
2bcd0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 ssert( pCur->aiI
2bce0 64 78 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 70 dx[ii]==pCur->ap
2bcf0 50 61 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c 20 Page[ii]->nCell
2bd00 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 );. }. ass
2bd10 65 72 74 28 20 70 43 75 72 2d 3e 69 78 3d 3d 70 ert( pCur->ix==p
2bd20 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c Cur->pPage->nCel
2bd30 6c 2d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 l-1 );. asser
2bd40 74 28 20 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e t( pCur->pPage->
2bd50 6c 65 61 66 20 29 3b 0a 23 65 6e 64 69 66 0a 20 leaf );.#endif.
2bd60 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2bd70 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d _OK;. }.. rc =
2bd80 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 moveToRoot(pCur
2bd90 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
2bda0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 61 73 ITE_OK ){. as
2bdb0 73 65 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 sert( pCur->eSta
2bdc0 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 te==CURSOR_VALID
2bdd0 20 29 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d 20 );. *pRes =
2bde0 30 3b 0a 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 0;. rc = move
2bdf0 54 6f 52 69 67 68 74 6d 6f 73 74 28 70 43 75 72 ToRightmost(pCur
2be00 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 );. if( rc==S
2be10 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2be20 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
2be30 20 7c 3d 20 42 54 43 46 5f 41 74 4c 61 73 74 3b |= BTCF_AtLast;
2be40 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
2be50 20 20 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 73 pCur->curFlags
2be60 20 26 3d 20 7e 42 54 43 46 5f 41 74 4c 61 73 74 &= ~BTCF_AtLast
2be70 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 ;. }. }else
2be80 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45 if( rc==SQLITE_E
2be90 4d 50 54 59 20 29 7b 0a 20 20 20 20 61 73 73 65 MPTY ){. asse
2bea0 72 74 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f rt( pCur->pgnoRo
2beb0 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 70 ot==0 || pCur->p
2bec0 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 Page->nCell==0 )
2bed0 3b 0a 20 20 20 20 2a 70 52 65 73 20 3d 20 31 3b ;. *pRes = 1;
2bee0 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
2bef0 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 _OK;. }. retur
2bf00 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 n rc;.}../* Move
2bf10 20 74 68 65 20 63 75 72 73 6f 72 20 73 6f 20 74 the cursor so t
2bf20 68 61 74 20 69 74 20 70 6f 69 6e 74 73 20 74 6f hat it points to
2bf30 20 61 6e 20 65 6e 74 72 79 20 6e 65 61 72 20 74 an entry near t
2bf40 68 65 20 6b 65 79 20 0a 2a 2a 20 73 70 65 63 69 he key .** speci
2bf50 66 69 65 64 20 62 79 20 70 49 64 78 4b 65 79 20 fied by pIdxKey
2bf60 6f 72 20 69 6e 74 4b 65 79 2e 20 20 20 52 65 74 or intKey. Ret
2bf70 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 6f urn a success co
2bf80 64 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 49 4e de..**.** For IN
2bf90 54 4b 45 59 20 74 61 62 6c 65 73 2c 20 74 68 65 TKEY tables, the
2bfa0 20 69 6e 74 4b 65 79 20 70 61 72 61 6d 65 74 65 intKey paramete
2bfb0 72 20 69 73 20 75 73 65 64 2e 20 20 70 49 64 78 r is used. pIdx
2bfc0 4b 65 79 20 0a 2a 2a 20 6d 75 73 74 20 62 65 20 Key .** must be
2bfd0 4e 55 4c 4c 2e 20 20 46 6f 72 20 69 6e 64 65 78 NULL. For index
2bfe0 20 74 61 62 6c 65 73 2c 20 70 49 64 78 4b 65 79 tables, pIdxKey
2bff0 20 69 73 20 75 73 65 64 20 61 6e 64 20 69 6e 74 is used and int
2c000 4b 65 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 Key.** is ignore
2c010 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 d..**.** If an e
2c020 78 61 63 74 20 6d 61 74 63 68 20 69 73 20 6e 6f xact match is no
2c030 74 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 74 68 t found, then th
2c040 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c 77 61 e cursor is alwa
2c050 79 73 0a 2a 2a 20 6c 65 66 74 20 70 6f 69 6e 74 ys.** left point
2c060 69 6e 67 20 61 74 20 61 20 6c 65 61 66 20 70 61 ing at a leaf pa
2c070 67 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 68 ge which would h
2c080 6f 6c 64 20 74 68 65 20 65 6e 74 72 79 20 69 66 old the entry if
2c090 20 69 74 0a 2a 2a 20 77 65 72 65 20 70 72 65 73 it.** were pres
2c0a0 65 6e 74 2e 20 20 54 68 65 20 63 75 72 73 6f 72 ent. The cursor
2c0b0 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 might point to
2c0c0 61 6e 20 65 6e 74 72 79 20 74 68 61 74 20 63 6f an entry that co
2c0d0 6d 65 73 0a 2a 2a 20 62 65 66 6f 72 65 20 6f 72 mes.** before or
2c0e0 20 61 66 74 65 72 20 74 68 65 20 6b 65 79 2e 0a after the key..
2c0f0 2a 2a 0a 2a 2a 20 41 6e 20 69 6e 74 65 67 65 72 **.** An integer
2c100 20 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f is written into
2c110 20 2a 70 52 65 73 20 77 68 69 63 68 20 69 73 20 *pRes which is
2c120 74 68 65 20 72 65 73 75 6c 74 20 6f 66 0a 2a 2a the result of.**
2c130 20 63 6f 6d 70 61 72 69 6e 67 20 74 68 65 20 6b comparing the k
2c140 65 79 20 77 69 74 68 20 74 68 65 20 65 6e 74 72 ey with the entr
2c150 79 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 63 y to which the c
2c160 75 72 73 6f 72 20 69 73 20 0a 2a 2a 20 70 6f 69 ursor is .** poi
2c170 6e 74 69 6e 67 2e 20 20 54 68 65 20 6d 65 61 6e nting. The mean
2c180 69 6e 67 20 6f 66 20 74 68 65 20 69 6e 74 65 67 ing of the integ
2c190 65 72 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 0a er written into.
2c1a0 2a 2a 20 2a 70 52 65 73 20 69 73 20 61 73 20 66 ** *pRes is as f
2c1b0 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 ollows:.**.**
2c1c0 20 20 2a 70 52 65 73 3c 30 20 20 20 20 20 20 54 *pRes<0 T
2c1d0 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 he cursor is lef
2c1e0 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e t pointing at an
2c1f0 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 entry that.**
2c200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2c210 69 73 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 is smaller than
2c220 69 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 20 6f intKey/pIdxKey o
2c230 72 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 69 r if the table i
2c240 73 20 65 6d 70 74 79 0a 2a 2a 20 20 20 20 20 20 s empty.**
2c250 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 20 and
2c260 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 74 68 the cursor is th
2c270 65 72 65 66 6f 72 65 20 6c 65 66 74 20 70 6f 69 erefore left poi
2c280 6e 74 20 74 6f 20 6e 6f 74 68 69 6e 67 2e 0a 2a nt to nothing..*
2c290 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 73 3d 3d *.** *pRes==
2c2a0 30 20 20 20 20 20 54 68 65 20 63 75 72 73 6f 72 0 The cursor
2c2b0 20 69 73 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e is left pointin
2c2c0 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 74 68 g at an entry th
2c2d0 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 at.**
2c2e0 20 20 20 20 20 20 20 65 78 61 63 74 6c 79 20 6d exactly m
2c2f0 61 74 63 68 65 73 20 69 6e 74 4b 65 79 2f 70 49 atches intKey/pI
2c300 64 78 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 dxKey..**.**
2c310 20 2a 70 52 65 73 3e 30 20 20 20 20 20 20 54 68 *pRes>0 Th
2c320 65 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 e cursor is left
2c330 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 61 6e 20 pointing at an
2c340 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 20 20 entry that.**
2c350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
2c360 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 69 6e s larger than in
2c370 74 4b 65 79 2f 70 49 64 78 4b 65 79 2e 0a 2a 2a tKey/pIdxKey..**
2c380 0a 2a 2a 20 46 6f 72 20 69 6e 64 65 78 20 74 61 .** For index ta
2c390 62 6c 65 73 2c 20 74 68 65 20 70 49 64 78 4b 65 bles, the pIdxKe
2c3a0 79 2d 3e 65 71 53 65 65 6e 20 66 69 65 6c 64 20 y->eqSeen field
2c3b0 69 73 20 73 65 74 20 74 6f 20 31 20 69 66 20 74 is set to 1 if t
2c3c0 68 65 72 65 0a 2a 2a 20 65 78 69 73 74 73 20 61 here.** exists a
2c3d0 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 n entry in the t
2c3e0 61 62 6c 65 20 74 68 61 74 20 65 78 61 63 74 6c able that exactl
2c3f0 79 20 6d 61 74 63 68 65 73 20 70 49 64 78 4b 65 y matches pIdxKe
2c400 79 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 y. .*/.int sqli
2c410 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f 55 6e te3BtreeMovetoUn
2c420 70 61 63 6b 65 64 28 0a 20 20 42 74 43 75 72 73 packed(. BtCurs
2c430 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 20 20 or *pCur,
2c440 20 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 /* The cursor
2c450 20 74 6f 20 62 65 20 6d 6f 76 65 64 20 2a 2f 0a to be moved */.
2c460 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 UnpackedRecord
2c470 20 2a 70 49 64 78 4b 65 79 2c 20 2f 2a 20 55 6e *pIdxKey, /* Un
2c480 70 61 63 6b 65 64 20 69 6e 64 65 78 20 6b 65 79 packed index key
2c490 20 2a 2f 0a 20 20 69 36 34 20 69 6e 74 4b 65 79 */. i64 intKey
2c4a0 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
2c4b0 2a 20 54 68 65 20 74 61 62 6c 65 20 6b 65 79 20 * The table key
2c4c0 2a 2f 0a 20 20 69 6e 74 20 62 69 61 73 52 69 67 */. int biasRig
2c4d0 68 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a ht, /*
2c4e0 20 49 66 20 74 72 75 65 2c 20 62 69 61 73 20 74 If true, bias t
2c4f0 68 65 20 73 65 61 72 63 68 20 74 6f 20 74 68 65 he search to the
2c500 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a 20 20 69 high end */. i
2c510 6e 74 20 2a 70 52 65 73 20 20 20 20 20 20 20 20 nt *pRes
2c520 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 /* Write
2c530 20 73 65 61 72 63 68 20 72 65 73 75 6c 74 73 20 search results
2c540 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 here */.){. int
2c550 20 72 63 3b 0a 20 20 52 65 63 6f 72 64 43 6f 6d rc;. RecordCom
2c560 70 61 72 65 20 78 52 65 63 6f 72 64 43 6f 6d 70 pare xRecordComp
2c570 61 72 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 are;.. assert(
2c580 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
2c590 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
2c5a0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
2c5b0 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 tex_held(pCur->p
2c5c0 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 Btree->db->mutex
2c5d0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
2c5e0 52 65 73 20 29 3b 0a 20 20 61 73 73 65 72 74 28 Res );. assert(
2c5f0 20 28 70 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 (pIdxKey==0)==(
2c600 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 3d 3d pCur->pKeyInfo==
2c610 30 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 0) );. assert(
2c620 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
2c630 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 28 70 RSOR_VALID || (p
2c640 49 64 78 4b 65 79 3d 3d 30 29 3d 3d 28 70 43 75 IdxKey==0)==(pCu
2c650 72 2d 3e 63 75 72 49 6e 74 4b 65 79 21 3d 30 29 r->curIntKey!=0)
2c660 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 );.. /* If the
2c670 20 63 75 72 73 6f 72 20 69 73 20 61 6c 72 65 61 cursor is alrea
2c680 64 79 20 70 6f 73 69 74 69 6f 6e 65 64 20 61 74 dy positioned at
2c690 20 74 68 65 20 70 6f 69 6e 74 20 77 65 20 61 72 the point we ar
2c6a0 65 20 74 72 79 69 6e 67 0a 20 20 2a 2a 20 74 6f e trying. ** to
2c6b0 20 6d 6f 76 65 20 74 6f 2c 20 74 68 65 6e 20 6a move to, then j
2c6c0 75 73 74 20 72 65 74 75 72 6e 20 77 69 74 68 6f ust return witho
2c6d0 75 74 20 64 6f 69 6e 67 20 61 6e 79 20 77 6f 72 ut doing any wor
2c6e0 6b 20 2a 2f 0a 20 20 69 66 28 20 70 49 64 78 4b k */. if( pIdxK
2c6f0 65 79 3d 3d 30 0a 20 20 20 26 26 20 70 43 75 72 ey==0. && pCur
2c700 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
2c710 5f 56 41 4c 49 44 20 26 26 20 28 70 43 75 72 2d _VALID && (pCur-
2c720 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 46 >curFlags & BTCF
2c730 5f 56 61 6c 69 64 4e 4b 65 79 29 21 3d 30 0a 20 _ValidNKey)!=0.
2c740 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 ){. if( pCur
2c750 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e 74 ->info.nKey==int
2c760 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 Key ){. *pR
2c770 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 65 es = 0;. re
2c780 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2c790 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 43 }. if( pC
2c7a0 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3c 69 6e ur->info.nKey<in
2c7b0 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 69 66 tKey ){. if
2c7c0 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 67 ( (pCur->curFlag
2c7d0 73 20 26 20 42 54 43 46 5f 41 74 4c 61 73 74 29 s & BTCF_AtLast)
2c7e0 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2a !=0 ){. *
2c7f0 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 20 pRes = -1;.
2c800 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2c810 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 _OK;. }.
2c820 20 20 20 2f 2a 20 49 66 20 74 68 65 20 72 65 71 /* If the req
2c830 75 65 73 74 65 64 20 6b 65 79 20 69 73 20 6f 6e uested key is on
2c840 65 20 6d 6f 72 65 20 74 68 61 6e 20 74 68 65 20 e more than the
2c850 70 72 65 76 69 6f 75 73 20 6b 65 79 2c 20 74 68 previous key, th
2c860 65 6e 0a 20 20 20 20 20 20 2a 2a 20 74 72 79 20 en. ** try
2c870 74 6f 20 67 65 74 20 74 68 65 72 65 20 75 73 69 to get there usi
2c880 6e 67 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e ng sqlite3BtreeN
2c890 65 78 74 28 29 20 72 61 74 68 65 72 20 74 68 61 ext() rather tha
2c8a0 6e 20 61 20 66 75 6c 6c 0a 20 20 20 20 20 20 2a n a full. *
2c8b0 2a 20 62 69 6e 61 72 79 20 73 65 61 72 63 68 2e * binary search.
2c8c0 20 20 54 68 69 73 20 69 73 20 61 6e 20 6f 70 74 This is an opt
2c8d0 69 6d 69 7a 61 74 69 6f 6e 20 6f 6e 6c 79 2e 20 imization only.
2c8e0 20 54 68 65 20 63 6f 72 72 65 63 74 20 61 6e 73 The correct ans
2c8f0 77 65 72 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 wer. ** is
2c900 73 74 69 6c 6c 20 6f 62 74 61 69 6e 65 64 20 77 still obtained w
2c910 69 74 68 6f 75 74 20 74 68 69 73 20 63 61 73 65 ithout this case
2c920 2c 20 6f 6e 6c 79 20 61 20 6c 69 74 74 6c 65 20 , only a little
2c930 6d 6f 72 65 20 73 6c 6f 77 65 6c 79 20 2a 2f 0a more slowely */.
2c940 20 20 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e if( pCur->
2c950 69 6e 66 6f 2e 6e 4b 65 79 2b 31 3d 3d 69 6e 74 info.nKey+1==int
2c960 4b 65 79 20 26 26 20 21 70 43 75 72 2d 3e 73 6b Key && !pCur->sk
2c970 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 20 ipNext ){.
2c980 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 *pRes = 0;.
2c990 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
2c9a0 33 42 74 72 65 65 4e 65 78 74 28 70 43 75 72 2c 3BtreeNext(pCur,
2c9b0 20 30 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 0);. if(
2c9c0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
2c9d0 7b 0a 20 20 20 20 20 20 20 20 20 20 67 65 74 43 {. getC
2c9e0 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 ellInfo(pCur);.
2c9f0 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 75 if( pCu
2ca00 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e r->info.nKey==in
2ca10 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 tKey ){.
2ca20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2ca30 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 E_OK;.
2ca40 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 }. }else
2ca50 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 if( rc==SQLITE_D
2ca60 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ONE ){.
2ca70 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
2ca80 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
2ca90 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
2caa0 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 rc;. }.
2cab0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
2cac0 0a 0a 20 20 69 66 28 20 70 49 64 78 4b 65 79 20 .. if( pIdxKey
2cad0 29 7b 0a 20 20 20 20 78 52 65 63 6f 72 64 43 6f ){. xRecordCo
2cae0 6d 70 61 72 65 20 3d 20 73 71 6c 69 74 65 33 56 mpare = sqlite3V
2caf0 64 62 65 46 69 6e 64 43 6f 6d 70 61 72 65 28 70 dbeFindCompare(p
2cb00 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 70 49 64 IdxKey);. pId
2cb10 78 4b 65 79 2d 3e 65 72 72 43 6f 64 65 20 3d 20 xKey->errCode =
2cb20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 0;. assert( p
2cb30 49 64 78 4b 65 79 2d 3e 64 65 66 61 75 6c 74 5f IdxKey->default_
2cb40 72 63 3d 3d 31 20 0a 20 20 20 20 20 20 20 20 20 rc==1 .
2cb50 7c 7c 20 70 49 64 78 4b 65 79 2d 3e 64 65 66 61 || pIdxKey->defa
2cb60 75 6c 74 5f 72 63 3d 3d 30 20 0a 20 20 20 20 20 ult_rc==0 .
2cb70 20 20 20 20 7c 7c 20 70 49 64 78 4b 65 79 2d 3e || pIdxKey->
2cb80 64 65 66 61 75 6c 74 5f 72 63 3d 3d 2d 31 0a 20 default_rc==-1.
2cb90 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 );. }else{.
2cba0 20 20 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 xRecordCompar
2cbb0 65 20 3d 20 30 3b 20 2f 2a 20 41 6c 6c 20 6b 65 e = 0; /* All ke
2cbc0 79 73 20 61 72 65 20 69 6e 74 65 67 65 72 73 20 ys are integers
2cbd0 2a 2f 0a 20 20 7d 0a 0a 20 20 72 63 20 3d 20 6d */. }.. rc = m
2cbe0 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 72 29 3b oveToRoot(pCur);
2cbf0 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 . if( rc ){.
2cc00 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2cc10 45 4d 50 54 59 20 29 7b 0a 20 20 20 20 20 20 61 EMPTY ){. a
2cc20 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 6e ssert( pCur->pgn
2cc30 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 72 oRoot==0 || pCur
2cc40 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3d 3d ->pPage->nCell==
2cc50 30 20 29 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 0 );. *pRes
2cc60 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 72 65 74 = -1;. ret
2cc70 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2cc80 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
2cc90 72 63 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 rc;. }. assert
2cca0 28 20 70 43 75 72 2d 3e 70 50 61 67 65 20 29 3b ( pCur->pPage );
2ccb0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
2ccc0 3e 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 >pPage->isInit )
2ccd0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
2cce0 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
2ccf0 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 _VALID );. asse
2cd00 72 74 28 20 70 43 75 72 2d 3e 70 50 61 67 65 2d rt( pCur->pPage-
2cd10 3e 6e 43 65 6c 6c 20 3e 20 30 20 29 3b 0a 20 20 >nCell > 0 );.
2cd20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 assert( pCur->iP
2cd30 61 67 65 3d 3d 30 20 7c 7c 20 70 43 75 72 2d 3e age==0 || pCur->
2cd40 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 apPage[0]->intKe
2cd50 79 3d 3d 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b y==pCur->curIntK
2cd60 65 79 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ey );. assert(
2cd70 70 43 75 72 2d 3e 63 75 72 49 6e 74 4b 65 79 20 pCur->curIntKey
2cd80 7c 7c 20 70 49 64 78 4b 65 79 20 29 3b 0a 20 20 || pIdxKey );.
2cd90 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 for(;;){. int
2cda0 20 6c 77 72 2c 20 75 70 72 2c 20 69 64 78 2c 20 lwr, upr, idx,
2cdb0 63 3b 0a 20 20 20 20 50 67 6e 6f 20 63 68 6c 64 c;. Pgno chld
2cdc0 50 67 3b 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 Pg;. MemPage
2cdd0 2a 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 *pPage = pCur->p
2cde0 50 61 67 65 3b 0a 20 20 20 20 75 38 20 2a 70 43 Page;. u8 *pC
2cdf0 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ell;
2ce00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
2ce10 20 50 6f 69 6e 74 65 72 20 74 6f 20 63 75 72 72 Pointer to curr
2ce20 65 6e 74 20 63 65 6c 6c 20 69 6e 20 70 50 61 67 ent cell in pPag
2ce30 65 20 2a 2f 0a 0a 20 20 20 20 2f 2a 20 70 50 61 e */.. /* pPa
2ce40 67 65 2d 3e 6e 43 65 6c 6c 20 6d 75 73 74 20 62 ge->nCell must b
2ce50 65 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 7a e greater than z
2ce60 65 72 6f 2e 20 49 66 20 74 68 69 73 20 69 73 20 ero. If this is
2ce70 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 0a 20 20 the root-page.
2ce80 20 20 2a 2a 20 74 68 65 20 63 75 72 73 6f 72 20 ** the cursor
2ce90 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 would have been
2cea0 49 4e 56 41 4c 49 44 20 61 62 6f 76 65 20 61 6e INVALID above an
2ceb0 64 20 74 68 69 73 20 66 6f 72 28 3b 3b 29 20 6c d this for(;;) l
2cec0 6f 6f 70 0a 20 20 20 20 2a 2a 20 6e 6f 74 20 72 oop. ** not r
2ced0 75 6e 2e 20 49 66 20 74 68 69 73 20 69 73 20 6e un. If this is n
2cee0 6f 74 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 ot the root-page
2cef0 2c 20 74 68 65 6e 20 74 68 65 20 6d 6f 76 65 54 , then the moveT
2cf00 6f 43 68 69 6c 64 28 29 20 72 6f 75 74 69 6e 65 oChild() routine
2cf10 0a 20 20 20 20 2a 2a 20 77 6f 75 6c 64 20 68 61 . ** would ha
2cf20 76 65 20 61 6c 72 65 61 64 79 20 64 65 74 65 63 ve already detec
2cf30 74 65 64 20 64 62 20 63 6f 72 72 75 70 74 69 6f ted db corruptio
2cf40 6e 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 20 70 50 n. Similarly, pP
2cf50 61 67 65 20 6d 75 73 74 0a 20 20 20 20 2a 2a 20 age must. **
2cf60 62 65 20 74 68 65 20 72 69 67 68 74 20 6b 69 6e be the right kin
2cf70 64 20 28 69 6e 64 65 78 20 6f 72 20 74 61 62 6c d (index or tabl
2cf80 65 29 20 6f 66 20 62 2d 74 72 65 65 20 70 61 67 e) of b-tree pag
2cf90 65 2e 20 4f 74 68 65 72 77 69 73 65 0a 20 20 20 e. Otherwise.
2cfa0 20 2a 2a 20 61 20 6d 6f 76 65 54 6f 43 68 69 6c ** a moveToChil
2cfb0 64 28 29 20 6f 72 20 6d 6f 76 65 54 6f 52 6f 6f d() or moveToRoo
2cfc0 74 28 29 20 63 61 6c 6c 20 77 6f 75 6c 64 20 68 t() call would h
2cfd0 61 76 65 20 64 65 74 65 63 74 65 64 20 63 6f 72 ave detected cor
2cfe0 72 75 70 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 ruption. */.
2cff0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
2d000 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 20 61 nCell>0 );. a
2d010 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 6e ssert( pPage->in
2d020 74 4b 65 79 3d 3d 28 70 49 64 78 4b 65 79 3d 3d tKey==(pIdxKey==
2d030 30 29 20 29 3b 0a 20 20 20 20 6c 77 72 20 3d 20 0) );. lwr =
2d040 30 3b 0a 20 20 20 20 75 70 72 20 3d 20 70 50 61 0;. upr = pPa
2d050 67 65 2d 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 20 ge->nCell-1;.
2d060 20 61 73 73 65 72 74 28 20 62 69 61 73 52 69 67 assert( biasRig
2d070 68 74 3d 3d 30 20 7c 7c 20 62 69 61 73 52 69 67 ht==0 || biasRig
2d080 68 74 3d 3d 31 20 29 3b 0a 20 20 20 20 69 64 78 ht==1 );. idx
2d090 20 3d 20 75 70 72 3e 3e 28 31 2d 62 69 61 73 52 = upr>>(1-biasR
2d0a0 69 67 68 74 29 3b 20 2f 2a 20 69 64 78 20 3d 20 ight); /* idx =
2d0b0 62 69 61 73 52 69 67 68 74 20 3f 20 75 70 72 20 biasRight ? upr
2d0c0 3a 20 28 6c 77 72 2b 75 70 72 29 2f 32 3b 20 2a : (lwr+upr)/2; *
2d0d0 2f 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 20 3d /. pCur->ix =
2d0e0 20 28 75 31 36 29 69 64 78 3b 0a 20 20 20 20 69 (u16)idx;. i
2d0f0 66 28 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 f( xRecordCompar
2d100 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 66 6f e==0 ){. fo
2d110 72 28 3b 3b 29 7b 0a 20 20 20 20 20 20 20 20 69 r(;;){. i
2d120 36 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 64 nCellKey;.
2d130 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 66 69 6e pCell = fin
2d140 64 43 65 6c 6c 50 61 73 74 50 74 72 28 70 50 61 dCellPastPtr(pPa
2d150 67 65 2c 20 69 64 78 29 3b 0a 20 20 20 20 20 20 ge, idx);.
2d160 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 if( pPage->int
2d170 4b 65 79 4c 65 61 66 20 29 7b 0a 20 20 20 20 20 KeyLeaf ){.
2d180 20 20 20 20 20 77 68 69 6c 65 28 20 30 78 38 30 while( 0x80
2d190 20 3c 3d 20 2a 28 70 43 65 6c 6c 2b 2b 29 20 29 <= *(pCell++) )
2d1a0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 {. if
2d1b0 28 20 70 43 65 6c 6c 3e 3d 70 50 61 67 65 2d 3e ( pCell>=pPage->
2d1c0 61 44 61 74 61 45 6e 64 20 29 7b 0a 20 20 20 20 aDataEnd ){.
2d1d0 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 6e return
2d1e0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2d1f0 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
2d200 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2d210 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
2d220 0a 20 20 20 20 20 20 20 20 67 65 74 56 61 72 69 . getVari
2d230 6e 74 28 70 43 65 6c 6c 2c 20 28 75 36 34 2a 29 nt(pCell, (u64*)
2d240 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 &nCellKey);.
2d250 20 20 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 if( nCellKey
2d260 3c 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 <intKey ){.
2d270 20 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 lwr = idx+1
2d280 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
2d290 6c 77 72 3e 75 70 72 20 29 7b 20 63 20 3d 20 2d lwr>upr ){ c = -
2d2a0 31 3b 20 62 72 65 61 6b 3b 20 7d 0a 20 20 20 20 1; break; }.
2d2b0 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6e 43 }else if( nC
2d2c0 65 6c 6c 4b 65 79 3e 69 6e 74 4b 65 79 20 29 7b ellKey>intKey ){
2d2d0 0a 20 20 20 20 20 20 20 20 20 20 75 70 72 20 3d . upr =
2d2e0 20 69 64 78 2d 31 3b 0a 20 20 20 20 20 20 20 20 idx-1;.
2d2f0 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 7b if( lwr>upr ){
2d300 20 63 20 3d 20 2b 31 3b 20 62 72 65 61 6b 3b 20 c = +1; break;
2d310 7d 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b }. }else{
2d320 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
2d330 74 28 20 6e 43 65 6c 6c 4b 65 79 3d 3d 69 6e 74 t( nCellKey==int
2d340 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 20 20 20 Key );.
2d350 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 pCur->ix = (u16
2d360 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 20 )idx;.
2d370 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 if( !pPage->leaf
2d380 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
2d390 6c 77 72 20 3d 20 69 64 78 3b 0a 20 20 20 20 20 lwr = idx;.
2d3a0 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 goto move
2d3b0 74 6f 5f 6e 65 78 74 5f 6c 61 79 65 72 3b 0a 20 to_next_layer;.
2d3c0 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }else{.
2d3d0 20 20 20 20 20 20 20 20 20 20 20 20 70 43 75 72 pCur
2d3e0 2d 3e 63 75 72 46 6c 61 67 73 20 7c 3d 20 42 54 ->curFlags |= BT
2d3f0 43 46 5f 56 61 6c 69 64 4e 4b 65 79 3b 0a 20 20 CF_ValidNKey;.
2d400 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
2d410 69 6e 66 6f 2e 6e 4b 65 79 20 3d 20 6e 43 65 6c info.nKey = nCel
2d420 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 lKey;.
2d430 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 pCur->info.nSi
2d440 7a 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ze = 0;.
2d450 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
2d460 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
2d470 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 n SQLITE_OK;.
2d480 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
2d490 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 }. asser
2d4a0 74 28 20 6c 77 72 2b 75 70 72 3e 3d 30 20 29 3b t( lwr+upr>=0 );
2d4b0 0a 20 20 20 20 20 20 20 20 69 64 78 20 3d 20 28 . idx = (
2d4c0 6c 77 72 2b 75 70 72 29 3e 3e 31 3b 20 20 2f 2a lwr+upr)>>1; /*
2d4d0 20 69 64 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 idx = (lwr+upr)
2d4e0 2f 32 3b 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 /2; */. }.
2d4f0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
2d500 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 20 20 20 for(;;){.
2d510 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 2f 2a 20 int nCell; /*
2d520 53 69 7a 65 20 6f 66 20 74 68 65 20 70 43 65 6c Size of the pCel
2d530 6c 20 63 65 6c 6c 20 69 6e 20 62 79 74 65 73 20 l cell in bytes
2d540 2a 2f 0a 20 20 20 20 20 20 20 20 70 43 65 6c 6c */. pCell
2d550 20 3d 20 66 69 6e 64 43 65 6c 6c 50 61 73 74 50 = findCellPastP
2d560 74 72 28 70 50 61 67 65 2c 20 69 64 78 29 3b 0a tr(pPage, idx);.
2d570 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 . /* The
2d580 6d 61 78 69 6d 75 6d 20 73 75 70 70 6f 72 74 65 maximum supporte
2d590 64 20 70 61 67 65 2d 73 69 7a 65 20 69 73 20 36 d page-size is 6
2d5a0 35 35 33 36 20 62 79 74 65 73 2e 20 54 68 69 73 5536 bytes. This
2d5b0 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 20 20 20 means that.
2d5c0 20 20 20 20 2a 2a 20 74 68 65 20 6d 61 78 69 6d ** the maxim
2d5d0 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 63 um number of rec
2d5e0 6f 72 64 20 62 79 74 65 73 20 73 74 6f 72 65 64 ord bytes stored
2d5f0 20 6f 6e 20 61 6e 20 69 6e 64 65 78 20 42 2d 54 on an index B-T
2d600 72 65 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 ree. ** p
2d610 61 67 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e age is less than
2d620 20 31 36 33 38 34 20 62 79 74 65 73 20 61 6e 64 16384 bytes and
2d630 20 6d 61 79 20 62 65 20 73 74 6f 72 65 64 20 61 may be stored a
2d640 73 20 61 20 32 2d 62 79 74 65 0a 20 20 20 20 20 s a 2-byte.
2d650 20 20 20 2a 2a 20 76 61 72 69 6e 74 2e 20 54 68 ** varint. Th
2d660 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 is information i
2d670 73 20 75 73 65 64 20 74 6f 20 61 74 74 65 6d 70 s used to attemp
2d680 74 20 74 6f 20 61 76 6f 69 64 20 70 61 72 73 69 t to avoid parsi
2d690 6e 67 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 ng . ** t
2d6a0 68 65 20 65 6e 74 69 72 65 20 63 65 6c 6c 20 62 he entire cell b
2d6b0 79 20 63 68 65 63 6b 69 6e 67 20 66 6f 72 20 74 y checking for t
2d6c0 68 65 20 63 61 73 65 73 20 77 68 65 72 65 20 74 he cases where t
2d6d0 68 65 20 72 65 63 6f 72 64 20 69 73 20 0a 20 20 he record is .
2d6e0 20 20 20 20 20 20 2a 2a 20 73 74 6f 72 65 64 20 ** stored
2d6f0 65 6e 74 69 72 65 6c 79 20 77 69 74 68 69 6e 20 entirely within
2d700 74 68 65 20 62 2d 74 72 65 65 20 70 61 67 65 20 the b-tree page
2d710 62 79 20 69 6e 73 70 65 63 74 69 6e 67 20 74 68 by inspecting th
2d720 65 20 66 69 72 73 74 20 0a 20 20 20 20 20 20 20 e first .
2d730 20 2a 2a 20 32 20 62 79 74 65 73 20 6f 66 20 74 ** 2 bytes of t
2d740 68 65 20 63 65 6c 6c 2e 0a 20 20 20 20 20 20 20 he cell..
2d750 20 2a 2f 0a 20 20 20 20 20 20 20 20 6e 43 65 6c */. nCel
2d760 6c 20 3d 20 70 43 65 6c 6c 5b 30 5d 3b 0a 20 20 l = pCell[0];.
2d770 20 20 20 20 20 20 69 66 28 20 6e 43 65 6c 6c 3c if( nCell<
2d780 3d 70 50 61 67 65 2d 3e 6d 61 78 31 62 79 74 65 =pPage->max1byte
2d790 50 61 79 6c 6f 61 64 20 29 7b 0a 20 20 20 20 20 Payload ){.
2d7a0 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 72 61 /* This bra
2d7b0 6e 63 68 20 72 75 6e 73 20 69 66 20 74 68 65 20 nch runs if the
2d7c0 72 65 63 6f 72 64 2d 73 69 7a 65 20 66 69 65 6c record-size fiel
2d7d0 64 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 69 73 d of the cell is
2d7e0 20 61 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 a. **
2d7f0 73 69 6e 67 6c 65 20 62 79 74 65 20 76 61 72 69 single byte vari
2d800 6e 74 20 61 6e 64 20 74 68 65 20 72 65 63 6f 72 nt and the recor
2d810 64 20 66 69 74 73 20 65 6e 74 69 72 65 6c 79 20 d fits entirely
2d820 6f 6e 20 74 68 65 20 6d 61 69 6e 0a 20 20 20 20 on the main.
2d830 20 20 20 20 20 20 2a 2a 20 62 2d 74 72 65 65 20 ** b-tree
2d840 70 61 67 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 page. */.
2d850 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 43 testcase( pC
2d860 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d 3d 70 50 61 ell+nCell+1==pPa
2d870 67 65 2d 3e 61 44 61 74 61 45 6e 64 20 29 3b 0a ge->aDataEnd );.
2d880 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 52 c = xR
2d890 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 ecordCompare(nCe
2d8a0 6c 6c 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 6c ll, (void*)&pCel
2d8b0 6c 5b 31 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a l[1], pIdxKey);.
2d8c0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
2d8d0 28 20 21 28 70 43 65 6c 6c 5b 31 5d 20 26 20 30 ( !(pCell[1] & 0
2d8e0 78 38 30 29 20 0a 20 20 20 20 20 20 20 20 20 20 x80) .
2d8f0 26 26 20 28 6e 43 65 6c 6c 20 3d 20 28 28 6e 43 && (nCell = ((nC
2d900 65 6c 6c 26 30 78 37 66 29 3c 3c 37 29 20 2b 20 ell&0x7f)<<7) +
2d910 70 43 65 6c 6c 5b 31 5d 29 3c 3d 70 50 61 67 65 pCell[1])<=pPage
2d920 2d 3e 6d 61 78 4c 6f 63 61 6c 0a 20 20 20 20 20 ->maxLocal.
2d930 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ){.
2d940 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 2d 73 69 /* The record-si
2d950 7a 65 20 66 69 65 6c 64 20 69 73 20 61 20 32 20 ze field is a 2
2d960 62 79 74 65 20 76 61 72 69 6e 74 20 61 6e 64 20 byte varint and
2d970 74 68 65 20 72 65 63 6f 72 64 20 0a 20 20 20 20 the record .
2d980 20 20 20 20 20 20 2a 2a 20 66 69 74 73 20 65 6e ** fits en
2d990 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 tirely on the ma
2d9a0 69 6e 20 62 2d 74 72 65 65 20 70 61 67 65 2e 20 in b-tree page.
2d9b0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 */. te
2d9c0 73 74 63 61 73 65 28 20 70 43 65 6c 6c 2b 6e 43 stcase( pCell+nC
2d9d0 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d 3e 61 44 ell+2==pPage->aD
2d9e0 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 20 20 20 ataEnd );.
2d9f0 20 20 20 20 63 20 3d 20 78 52 65 63 6f 72 64 43 c = xRecordC
2da00 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 28 76 ompare(nCell, (v
2da10 6f 69 64 2a 29 26 70 43 65 6c 6c 5b 32 5d 2c 20 oid*)&pCell[2],
2da20 70 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 pIdxKey);.
2da30 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2da40 20 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 /* The record
2da50 20 66 6c 6f 77 73 20 6f 76 65 72 20 6f 6e 74 6f flows over onto
2da60 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 76 65 one or more ove
2da70 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 49 6e 0a rflow pages. In.
2da80 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 69 ** thi
2da90 73 20 63 61 73 65 20 74 68 65 20 77 68 6f 6c 65 s case the whole
2daa0 20 63 65 6c 6c 20 6e 65 65 64 73 20 74 6f 20 62 cell needs to b
2dab0 65 20 70 61 72 73 65 64 2c 20 61 20 62 75 66 66 e parsed, a buff
2dac0 65 72 20 61 6c 6c 6f 63 61 74 65 64 0a 20 20 20 er allocated.
2dad0 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 61 63 ** and ac
2dae0 63 65 73 73 50 61 79 6c 6f 61 64 28 29 20 75 73 cessPayload() us
2daf0 65 64 20 74 6f 20 72 65 74 72 69 65 76 65 20 74 ed to retrieve t
2db00 68 65 20 72 65 63 6f 72 64 20 69 6e 74 6f 20 74 he record into t
2db10 68 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 he. **
2db20 62 75 66 66 65 72 20 62 65 66 6f 72 65 20 56 64 buffer before Vd
2db30 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 beRecordCompare(
2db40 29 20 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 2e ) can be called.
2db50 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 0a 20 . **.
2db60 20 20 20 20 20 20 20 20 20 2a 2a 20 49 66 20 74 ** If t
2db70 68 65 20 72 65 63 6f 72 64 20 69 73 20 63 6f 72 he record is cor
2db80 72 75 70 74 2c 20 74 68 65 20 78 52 65 63 6f 72 rupt, the xRecor
2db90 64 43 6f 6d 70 61 72 65 20 72 6f 75 74 69 6e 65 dCompare routine
2dba0 20 6d 61 79 20 72 65 61 64 0a 20 20 20 20 20 20 may read.
2dbb0 20 20 20 20 2a 2a 20 75 70 20 74 6f 20 74 77 6f ** up to two
2dbc0 20 76 61 72 69 6e 74 73 20 70 61 73 74 20 74 68 varints past th
2dbd0 65 20 65 6e 64 20 6f 66 20 74 68 65 20 62 75 66 e end of the buf
2dbe0 66 65 72 2e 20 41 6e 20 65 78 74 72 61 20 31 38 fer. An extra 18
2dbf0 20 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 62 . ** b
2dc00 79 74 65 73 20 6f 66 20 70 61 64 64 69 6e 67 20 ytes of padding
2dc10 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 74 20 is allocated at
2dc20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 62 the end of the b
2dc30 75 66 66 65 72 20 69 6e 0a 20 20 20 20 20 20 20 uffer in.
2dc40 20 20 20 2a 2a 20 63 61 73 65 20 74 68 69 73 20 ** case this
2dc50 68 61 70 70 65 6e 73 2e 20 20 2a 2f 0a 20 20 20 happens. */.
2dc60 20 20 20 20 20 20 20 76 6f 69 64 20 2a 70 43 65 void *pCe
2dc70 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 20 20 20 llKey;.
2dc80 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 43 65 6c u8 * const pCel
2dc90 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c 20 2d 20 lBody = pCell -
2dca0 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 pPage->childPtrS
2dcb0 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 20 20 70 ize;. p
2dcc0 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 6c 6c Page->xParseCell
2dcd0 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 42 6f 64 (pPage, pCellBod
2dce0 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b y, &pCur->info);
2dcf0 0a 20 20 20 20 20 20 20 20 20 20 6e 43 65 6c 6c . nCell
2dd00 20 3d 20 28 69 6e 74 29 70 43 75 72 2d 3e 69 6e = (int)pCur->in
2dd10 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 20 20 20 fo.nKey;.
2dd20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 65 testcase( nCe
2dd30 6c 6c 3c 30 20 29 3b 20 20 20 2f 2a 20 54 72 75 ll<0 ); /* Tru
2dd40 65 20 69 66 20 6b 65 79 20 73 69 7a 65 20 69 73 e if key size is
2dd50 20 32 5e 33 32 20 6f 72 20 6d 6f 72 65 20 2a 2f 2^32 or more */
2dd60 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 . testc
2dd70 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 30 20 29 3b ase( nCell==0 );
2dd80 20 20 2f 2a 20 49 6e 76 61 6c 69 64 20 6b 65 79 /* Invalid key
2dd90 20 73 69 7a 65 3a 20 20 30 78 38 30 20 30 78 38 size: 0x80 0x8
2dda0 30 20 30 78 30 30 20 2a 2f 0a 20 20 20 20 20 20 0 0x00 */.
2ddb0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 43 testcase( nC
2ddc0 65 6c 6c 3d 3d 31 20 29 3b 20 20 2f 2a 20 49 6e ell==1 ); /* In
2ddd0 76 61 6c 69 64 20 6b 65 79 20 73 69 7a 65 3a 20 valid key size:
2dde0 20 30 78 38 30 20 30 78 38 30 20 30 78 30 31 20 0x80 0x80 0x01
2ddf0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 */. tes
2de00 74 63 61 73 65 28 20 6e 43 65 6c 6c 3d 3d 32 20 tcase( nCell==2
2de10 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 6c ); /* Minimum l
2de20 65 67 61 6c 20 69 6e 64 65 78 20 6b 65 79 20 73 egal index key s
2de30 69 7a 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 ize */.
2de40 20 69 66 28 20 6e 43 65 6c 6c 3c 32 20 29 7b 0a if( nCell<2 ){.
2de50 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
2de60 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2de70 50 41 47 45 28 70 50 61 67 65 29 3b 0a 20 20 20 PAGE(pPage);.
2de80 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f goto mo
2de90 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 veto_finish;.
2dea0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
2deb0 20 20 20 70 43 65 6c 6c 4b 65 79 20 3d 20 73 71 pCellKey = sq
2dec0 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 6e 43 65 lite3Malloc( nCe
2ded0 6c 6c 2b 31 38 20 29 3b 0a 20 20 20 20 20 20 20 ll+18 );.
2dee0 20 20 20 69 66 28 20 70 43 65 6c 6c 4b 65 79 3d if( pCellKey=
2def0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
2df00 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
2df10 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 MEM_BKPT;.
2df20 20 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 goto movet
2df30 6f 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 o_finish;.
2df40 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
2df50 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 31 36 29 pCur->ix = (u16)
2df60 69 64 78 3b 0a 20 20 20 20 20 20 20 20 20 20 72 idx;. r
2df70 63 20 3d 20 61 63 63 65 73 73 50 61 79 6c 6f 61 c = accessPayloa
2df80 64 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c d(pCur, 0, nCell
2df90 2c 20 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 , (unsigned char
2dfa0 2a 29 70 43 65 6c 6c 4b 65 79 2c 20 30 29 3b 0a *)pCellKey, 0);.
2dfb0 20 20 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e pCur->
2dfc0 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 42 54 43 curFlags &= ~BTC
2dfd0 46 5f 56 61 6c 69 64 4f 76 66 6c 3b 0a 20 20 20 F_ValidOvfl;.
2dfe0 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b if( rc ){
2dff0 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
2e000 69 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b ite3_free(pCellK
2e010 65 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ey);.
2e020 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e goto moveto_fin
2e030 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d ish;. }
2e040 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 78 . c = x
2e050 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 RecordCompare(nC
2e060 65 6c 6c 2c 20 70 43 65 6c 6c 4b 65 79 2c 20 70 ell, pCellKey, p
2e070 49 64 78 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 IdxKey);.
2e080 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
2e090 70 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 20 20 20 pCellKey);.
2e0a0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 }. ass
2e0b0 65 72 74 28 20 0a 20 20 20 20 20 20 20 20 20 20 ert( .
2e0c0 20 20 28 70 49 64 78 4b 65 79 2d 3e 65 72 72 43 (pIdxKey->errC
2e0d0 6f 64 65 21 3d 53 51 4c 49 54 45 5f 43 4f 52 52 ode!=SQLITE_CORR
2e0e0 55 50 54 20 7c 7c 20 63 3d 3d 30 29 0a 20 20 20 UPT || c==0).
2e0f0 20 20 20 20 20 20 26 26 20 28 70 49 64 78 4b 65 && (pIdxKe
2e100 79 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 y->errCode!=SQLI
2e110 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 70 43 75 72 TE_NOMEM || pCur
2e120 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 61 ->pBtree->db->ma
2e130 6c 6c 6f 63 46 61 69 6c 65 64 29 0a 20 20 20 20 llocFailed).
2e140 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 );. i
2e150 66 28 20 63 3c 30 20 29 7b 0a 20 20 20 20 20 20 f( c<0 ){.
2e160 20 20 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 3b lwr = idx+1;
2e170 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 . }else i
2e180 66 28 20 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 f( c>0 ){.
2e190 20 20 20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b upr = idx-1;
2e1a0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
2e1b0 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 assert
2e1c0 28 20 63 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ( c==0 );.
2e1d0 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
2e1e0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
2e1f0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
2e200 20 20 20 70 43 75 72 2d 3e 69 78 20 3d 20 28 75 pCur->ix = (u
2e210 31 36 29 69 64 78 3b 0a 20 20 20 20 20 20 20 20 16)idx;.
2e220 20 20 69 66 28 20 70 49 64 78 4b 65 79 2d 3e 65 if( pIdxKey->e
2e230 72 72 43 6f 64 65 20 29 20 72 63 20 3d 20 53 51 rrCode ) rc = SQ
2e240 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2e250 54 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 T;. got
2e260 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b o moveto_finish;
2e270 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2e280 20 20 20 69 66 28 20 6c 77 72 3e 75 70 72 20 29 if( lwr>upr )
2e290 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
2e2a0 61 73 73 65 72 74 28 20 6c 77 72 2b 75 70 72 3e assert( lwr+upr>
2e2b0 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 64 =0 );. id
2e2c0 78 20 3d 20 28 6c 77 72 2b 75 70 72 29 3e 3e 31 x = (lwr+upr)>>1
2e2d0 3b 20 20 2f 2a 20 69 64 78 20 3d 20 28 6c 77 72 ; /* idx = (lwr
2e2e0 2b 75 70 72 29 2f 32 20 2a 2f 0a 20 20 20 20 20 +upr)/2 */.
2e2f0 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 }. }. ass
2e300 65 72 74 28 20 6c 77 72 3d 3d 75 70 72 2b 31 20 ert( lwr==upr+1
2e310 7c 7c 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 || (pPage->intKe
2e320 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 y && !pPage->lea
2e330 66 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 f) );. assert
2e340 28 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 ( pPage->isInit
2e350 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 );. if( pPage
2e360 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 ->leaf ){.
2e370 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 78 assert( pCur->ix
2e380 3c 70 43 75 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 <pCur->pPage->nC
2e390 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 70 43 75 ell );. pCu
2e3a0 72 2d 3e 69 78 20 3d 20 28 75 31 36 29 69 64 78 r->ix = (u16)idx
2e3b0 3b 0a 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 ;. *pRes =
2e3c0 63 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 c;. rc = SQ
2e3d0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 67 LITE_OK;. g
2e3e0 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 oto moveto_finis
2e3f0 68 3b 0a 20 20 20 20 7d 0a 6d 6f 76 65 74 6f 5f h;. }.moveto_
2e400 6e 65 78 74 5f 6c 61 79 65 72 3a 0a 20 20 20 20 next_layer:.
2e410 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 65 2d 3e if( lwr>=pPage->
2e420 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 20 63 nCell ){. c
2e430 68 6c 64 50 67 20 3d 20 67 65 74 34 62 79 74 65 hldPg = get4byte
2e440 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 (&pPage->aData[p
2e450 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b Page->hdrOffset+
2e460 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 8]);. }else{.
2e470 20 20 20 20 20 20 63 68 6c 64 50 67 20 3d 20 67 chldPg = g
2e480 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 6c 6c et4byte(findCell
2e490 28 70 50 61 67 65 2c 20 6c 77 72 29 29 3b 0a 20 (pPage, lwr));.
2e4a0 20 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 69 }. pCur->i
2e4b0 78 20 3d 20 28 75 31 36 29 6c 77 72 3b 0a 20 20 x = (u16)lwr;.
2e4c0 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
2e4d0 6c 64 28 70 43 75 72 2c 20 63 68 6c 64 50 67 29 ld(pCur, chldPg)
2e4e0 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 62 ;. if( rc ) b
2e4f0 72 65 61 6b 3b 0a 20 20 7d 0a 6d 6f 76 65 74 6f reak;. }.moveto
2e500 5f 66 69 6e 69 73 68 3a 0a 20 20 70 43 75 72 2d _finish:. pCur-
2e510 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
2e520 0a 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 . assert( (pCur
2e530 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2e540 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 F_ValidOvfl)==0
2e550 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
2e560 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e }.../*.** Return
2e570 20 54 52 55 45 20 69 66 20 74 68 65 20 63 75 72 TRUE if the cur
2e580 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 sor is not point
2e590 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 ing at an entry
2e5a0 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a of the table..**
2e5b0 0a 2a 2a 20 54 52 55 45 20 77 69 6c 6c 20 62 65 .** TRUE will be
2e5c0 20 72 65 74 75 72 6e 65 64 20 61 66 74 65 72 20 returned after
2e5d0 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 a call to sqlite
2e5e0 33 42 74 72 65 65 4e 65 78 74 28 29 20 6d 6f 76 3BtreeNext() mov
2e5f0 65 73 0a 2a 2a 20 70 61 73 74 20 74 68 65 20 6c es.** past the l
2e600 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ast entry in the
2e610 20 74 61 62 6c 65 20 6f 72 20 73 71 6c 69 74 65 table or sqlite
2e620 33 42 74 72 65 65 50 72 65 76 28 29 20 6d 6f 76 3BtreePrev() mov
2e630 65 73 20 70 61 73 74 0a 2a 2a 20 74 68 65 20 66 es past.** the f
2e640 69 72 73 74 20 65 6e 74 72 79 2e 20 20 54 52 55 irst entry. TRU
2e650 45 20 69 73 20 61 6c 73 6f 20 72 65 74 75 72 6e E is also return
2e660 65 64 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 ed if the table
2e670 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 is empty..*/.int
2e680 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6f 66 sqlite3BtreeEof
2e690 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
2e6a0 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 57 68 61 {. /* TODO: Wha
2e6b0 74 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 t if the cursor
2e6c0 69 73 20 69 6e 20 43 55 52 53 4f 52 5f 52 45 51 is in CURSOR_REQ
2e6d0 55 49 52 45 53 45 45 4b 20 62 75 74 20 61 6c 6c UIRESEEK but all
2e6e0 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 0a 20 table entries.
2e6f0 20 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 64 65 ** have been de
2e700 6c 65 74 65 64 3f 20 54 68 69 73 20 41 50 49 20 leted? This API
2e710 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 63 68 61 will need to cha
2e720 6e 67 65 20 74 6f 20 72 65 74 75 72 6e 20 61 6e nge to return an
2e730 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a error code. **
2e740 20 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 20 as well as the
2e750 62 6f 6f 6c 65 61 6e 20 72 65 73 75 6c 74 20 76 boolean result v
2e760 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 72 65 74 alue.. */. ret
2e770 75 72 6e 20 28 43 55 52 53 4f 52 5f 56 41 4c 49 urn (CURSOR_VALI
2e780 44 21 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 29 D!=pCur->eState)
2e790 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
2e7a0 6e 20 61 6e 20 65 73 74 69 6d 61 74 65 20 66 6f n an estimate fo
2e7b0 72 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 r the number of
2e7c0 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 62 6c rows in the tabl
2e7d0 65 20 74 68 61 74 20 70 43 75 72 20 69 73 0a 2a e that pCur is.*
2e7e0 2a 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 20 * pointing to.
2e7f0 52 65 74 75 72 6e 20 61 20 6e 65 67 61 74 69 76 Return a negativ
2e800 65 20 6e 75 6d 62 65 72 20 69 66 20 6e 6f 20 65 e number if no e
2e810 73 74 69 6d 61 74 65 20 69 73 20 63 75 72 72 65 stimate is curre
2e820 6e 74 6c 79 20 0a 2a 2a 20 61 76 61 69 6c 61 62 ntly .** availab
2e830 6c 65 2e 0a 2a 2f 0a 69 36 34 20 73 71 6c 69 74 le..*/.i64 sqlit
2e840 65 33 42 74 72 65 65 52 6f 77 43 6f 75 6e 74 45 e3BtreeRowCountE
2e850 73 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 st(BtCursor *pCu
2e860 72 29 7b 0a 20 20 69 36 34 20 6e 3b 0a 20 20 75 r){. i64 n;. u
2e870 38 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 8 i;.. assert(
2e880 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
2e890 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
2e8a0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
2e8b0 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d 3e 70 tex_held(pCur->p
2e8c0 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 Btree->db->mutex
2e8d0 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 75 72 72 65 ) );.. /* Curre
2e8e0 6e 74 6c 79 20 74 68 69 73 20 69 6e 74 65 72 66 ntly this interf
2e8f0 61 63 65 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c ace is only call
2e900 65 64 20 62 79 20 74 68 65 20 4f 50 5f 49 66 53 ed by the OP_IfS
2e910 6d 61 6c 6c 65 72 0a 20 20 2a 2a 20 6f 70 63 6f maller. ** opco
2e920 64 65 2c 20 61 6e 64 20 69 74 20 74 68 61 74 20 de, and it that
2e930 63 61 73 65 20 74 68 65 20 63 75 72 73 6f 72 20 case the cursor
2e940 77 69 6c 6c 20 61 6c 77 61 79 73 20 62 65 20 76 will always be v
2e950 61 6c 69 64 20 61 6e 64 0a 20 20 2a 2a 20 77 69 alid and. ** wi
2e960 6c 6c 20 61 6c 77 61 79 73 20 70 6f 69 6e 74 20 ll always point
2e970 74 6f 20 61 20 6c 65 61 66 20 6e 6f 64 65 2e 20 to a leaf node.
2e980 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 52 28 70 */. if( NEVER(p
2e990 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2e9a0 53 4f 52 5f 56 41 4c 49 44 29 20 29 20 72 65 74 SOR_VALID) ) ret
2e9b0 75 72 6e 20 2d 31 3b 0a 20 20 69 66 28 20 4e 45 urn -1;. if( NE
2e9c0 56 45 52 28 70 43 75 72 2d 3e 70 50 61 67 65 2d VER(pCur->pPage-
2e9d0 3e 6c 65 61 66 3d 3d 30 29 20 29 20 72 65 74 75 >leaf==0) ) retu
2e9e0 72 6e 20 2d 31 3b 0a 0a 20 20 6e 20 3d 20 70 43 rn -1;.. n = pC
2e9f0 75 72 2d 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c ur->pPage->nCell
2ea00 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 ;. for(i=0; i<p
2ea10 43 75 72 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 Cur->iPage; i++)
2ea20 7b 0a 20 20 20 20 6e 20 2a 3d 20 70 43 75 72 2d {. n *= pCur-
2ea30 3e 61 70 50 61 67 65 5b 69 5d 2d 3e 6e 43 65 6c >apPage[i]->nCel
2ea40 6c 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 l;. }. return
2ea50 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 n;.}../*.** Adva
2ea60 6e 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 nce the cursor t
2ea70 6f 20 74 68 65 20 6e 65 78 74 20 65 6e 74 72 79 o the next entry
2ea80 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
2ea90 2e 20 0a 2a 2a 20 52 65 74 75 72 6e 20 76 61 6c . .** Return val
2eaa0 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 53 51 4c ue:.**.** SQL
2eab0 49 54 45 5f 4f 4b 20 20 20 20 20 20 20 20 73 75 ITE_OK su
2eac0 63 63 65 73 73 0a 2a 2a 20 20 20 20 53 51 4c 49 ccess.** SQLI
2ead0 54 45 5f 44 4f 4e 45 20 20 20 20 20 20 63 75 72 TE_DONE cur
2eae0 73 6f 72 20 69 73 20 61 6c 72 65 61 64 79 20 70 sor is already p
2eaf0 6f 69 6e 74 69 6e 67 20 61 74 20 74 68 65 20 6c ointing at the l
2eb00 61 73 74 20 65 6c 65 6d 65 6e 74 0a 2a 2a 20 20 ast element.**
2eb10 20 20 6f 74 68 65 72 77 69 73 65 20 20 20 20 20 otherwise
2eb20 20 20 20 73 6f 6d 65 20 6b 69 6e 64 20 6f 66 20 some kind of
2eb30 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 0a 2a error occurred.*
2eb40 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 65 6e *.** The main en
2eb50 74 72 79 20 70 6f 69 6e 74 20 69 73 20 73 71 6c try point is sql
2eb60 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 29 2e ite3BtreeNext().
2eb70 20 20 54 68 61 74 20 72 6f 75 74 69 6e 65 20 69 That routine i
2eb80 73 20 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 66 s optimized.** f
2eb90 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 or the common ca
2eba0 73 65 20 6f 66 20 6d 65 72 65 6c 79 20 69 6e 63 se of merely inc
2ebb0 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 65 rementing the ce
2ebc0 6c 6c 20 63 6f 75 6e 74 65 72 20 42 74 43 75 72 ll counter BtCur
2ebd0 73 6f 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f 20 sor.aiIdx.** to
2ebe0 74 68 65 20 6e 65 78 74 20 63 65 6c 6c 20 6f 6e the next cell on
2ebf0 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 67 the current pag
2ec00 65 2e 20 20 54 68 65 20 28 73 6c 6f 77 65 72 29 e. The (slower)
2ec10 20 62 74 72 65 65 4e 65 78 74 28 29 20 68 65 6c btreeNext() hel
2ec20 70 65 72 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 69 per.** routine i
2ec30 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 74 s called when it
2ec40 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f is necessary to
2ec50 20 6d 6f 76 65 20 74 6f 20 61 20 64 69 66 66 65 move to a diffe
2ec60 72 65 6e 74 20 70 61 67 65 20 6f 72 0a 2a 2a 20 rent page or.**
2ec70 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 63 to restore the c
2ec80 75 72 73 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 ursor..**.** If
2ec90 62 69 74 20 30 78 30 31 20 6f 66 20 74 68 65 20 bit 0x01 of the
2eca0 46 20 61 72 67 75 6d 65 6e 74 20 69 6e 20 73 71 F argument in sq
2ecb0 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 43 lite3BtreeNext(C
2ecc0 2c 46 29 20 69 73 20 31 2c 20 74 68 65 6e 20 74 ,F) is 1, then t
2ecd0 68 65 0a 2a 2a 20 63 75 72 73 6f 72 20 63 6f 72 he.** cursor cor
2ece0 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 6e 20 53 responds to an S
2ecf0 51 4c 20 69 6e 64 65 78 20 61 6e 64 20 74 68 69 QL index and thi
2ed00 73 20 72 6f 75 74 69 6e 65 20 63 6f 75 6c 64 20 s routine could
2ed10 68 61 76 65 20 62 65 65 6e 0a 2a 2a 20 73 6b 69 have been.** ski
2ed20 70 70 65 64 20 69 66 20 74 68 65 20 53 51 4c 20 pped if the SQL
2ed30 69 6e 64 65 78 20 68 61 64 20 62 65 65 6e 20 61 index had been a
2ed40 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 unique index.
2ed50 54 68 65 20 46 20 61 72 67 75 6d 65 6e 74 0a 2a The F argument.*
2ed60 2a 20 69 73 20 61 20 68 69 6e 74 20 74 6f 20 74 * is a hint to t
2ed70 68 65 20 69 6d 70 6c 65 6d 65 6e 74 2e 20 20 53 he implement. S
2ed80 51 4c 69 74 65 20 62 74 72 65 65 20 69 6d 70 6c QLite btree impl
2ed90 65 6d 65 6e 74 61 74 69 6f 6e 20 64 6f 65 73 20 ementation does
2eda0 6e 6f 74 20 75 73 65 0a 2a 2a 20 74 68 69 73 20 not use.** this
2edb0 68 69 6e 74 2c 20 62 75 74 20 43 4f 4d 44 42 32 hint, but COMDB2
2edc0 20 64 6f 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 does..*/.static
2edd0 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 SQLITE_NOINLINE
2ede0 20 69 6e 74 20 62 74 72 65 65 4e 65 78 74 28 42 int btreeNext(B
2edf0 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a tCursor *pCur){.
2ee00 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
2ee10 69 64 78 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a idx;. MemPage *
2ee20 70 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 pPage;.. assert
2ee30 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 ( cursorOwnsBtSh
2ee40 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 ared(pCur) );.
2ee50 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b assert( pCur->sk
2ee60 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 ipNext==0 || pCu
2ee70 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f r->eState!=CURSO
2ee80 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 69 66 28 R_VALID );. if(
2ee90 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 pCur->eState!=C
2eea0 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 URSOR_VALID ){.
2eeb0 20 20 20 61 73 73 65 72 74 28 20 28 70 43 75 72 assert( (pCur
2eec0 2d 3e 63 75 72 46 6c 61 67 73 20 26 20 42 54 43 ->curFlags & BTC
2eed0 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3d 3d 30 20 F_ValidOvfl)==0
2eee0 29 3b 0a 20 20 20 20 72 63 20 3d 20 72 65 73 74 );. rc = rest
2eef0 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
2ef00 6e 28 70 43 75 72 29 3b 0a 20 20 20 20 69 66 28 n(pCur);. if(
2ef10 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
2ef20 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
2ef30 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 c;. }. if(
2ef40 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d CURSOR_INVALID=
2ef50 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b =pCur->eState ){
2ef60 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
2ef70 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d LITE_DONE;. }
2ef80 0a 20 20 20 20 69 66 28 20 70 43 75 72 2d 3e 73 . if( pCur->s
2ef90 6b 69 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 kipNext ){.
2efa0 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 65 assert( pCur->e
2efb0 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 State==CURSOR_VA
2efc0 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e 65 53 74 LID || pCur->eSt
2efd0 61 74 65 3d 3d 43 55 52 53 4f 52 5f 53 4b 49 50 ate==CURSOR_SKIP
2efe0 4e 45 58 54 20 29 3b 0a 20 20 20 20 20 20 70 43 NEXT );. pC
2eff0 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
2f000 53 4f 52 5f 56 41 4c 49 44 3b 0a 20 20 20 20 20 SOR_VALID;.
2f010 20 69 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e if( pCur->skipN
2f020 65 78 74 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 ext>0 ){.
2f030 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 20 pCur->skipNext
2f040 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 65 74 = 0;. ret
2f050 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2f060 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 }. pCu
2f070 72 2d 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b r->skipNext = 0;
2f080 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 70 50 . }. }.. pP
2f090 61 67 65 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 age = pCur->pPag
2f0a0 65 3b 0a 20 20 69 64 78 20 3d 20 2b 2b 70 43 75 e;. idx = ++pCu
2f0b0 72 2d 3e 69 78 3b 0a 20 20 61 73 73 65 72 74 28 r->ix;. assert(
2f0c0 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 pPage->isInit )
2f0d0 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 64 ;.. /* If the d
2f0e0 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
2f0f0 63 6f 72 72 75 70 74 2c 20 69 74 20 69 73 20 70 corrupt, it is p
2f100 6f 73 73 69 62 6c 65 20 66 6f 72 20 74 68 65 20 ossible for the
2f110 76 61 6c 75 65 20 6f 66 20 69 64 78 20 0a 20 20 value of idx .
2f120 2a 2a 20 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 ** to be invalid
2f130 20 68 65 72 65 2e 20 54 68 69 73 20 63 61 6e 20 here. This can
2f140 6f 6e 6c 79 20 6f 63 63 75 72 20 69 66 20 61 20 only occur if a
2f150 73 65 63 6f 6e 64 20 63 75 72 73 6f 72 20 6d 6f second cursor mo
2f160 64 69 66 69 65 73 0a 20 20 2a 2a 20 74 68 65 20 difies. ** the
2f170 70 61 67 65 20 77 68 69 6c 65 20 63 75 72 73 6f page while curso
2f180 72 20 70 43 75 72 20 69 73 20 68 6f 6c 64 69 6e r pCur is holdin
2f190 67 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f g a reference to
2f1a0 20 69 74 2e 20 57 68 69 63 68 20 63 61 6e 0a 20 it. Which can.
2f1b0 20 2a 2a 20 6f 6e 6c 79 20 68 61 70 70 65 6e 20 ** only happen
2f1c0 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 if the database
2f1d0 69 73 20 63 6f 72 72 75 70 74 20 69 6e 20 73 75 is corrupt in su
2f1e0 63 68 20 61 20 77 61 79 20 61 73 20 74 6f 20 6c ch a way as to l
2f1f0 69 6e 6b 20 74 68 65 0a 20 20 2a 2a 20 70 61 67 ink the. ** pag
2f200 65 20 69 6e 74 6f 20 6d 6f 72 65 20 74 68 61 6e e into more than
2f210 20 6f 6e 65 20 62 2d 74 72 65 65 20 73 74 72 75 one b-tree stru
2f220 63 74 75 72 65 2e 20 2a 2f 0a 20 20 74 65 73 74 cture. */. test
2f230 63 61 73 65 28 20 69 64 78 3e 70 50 61 67 65 2d case( idx>pPage-
2f240 3e 6e 43 65 6c 6c 20 29 3b 0a 0a 20 20 69 66 28 >nCell );.. if(
2f250 20 69 64 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 idx>=pPage->nCe
2f260 6c 6c 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70 ll ){. if( !p
2f270 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
2f280 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 rc = moveToC
2f290 68 69 6c 64 28 70 43 75 72 2c 20 67 65 74 34 62 hild(pCur, get4b
2f2a0 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 yte(&pPage->aDat
2f2b0 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
2f2c0 65 74 2b 38 5d 29 29 3b 0a 20 20 20 20 20 20 69 et+8]));. i
2f2d0 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
2f2e0 63 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 c;. return
2f2f0 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 70 moveToLeftmost(p
2f300 43 75 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Cur);. }.
2f310 64 6f 7b 0a 20 20 20 20 20 20 69 66 28 20 70 43 do{. if( pC
2f320 75 72 2d 3e 69 50 61 67 65 3d 3d 30 20 29 7b 0a ur->iPage==0 ){.
2f330 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 pCur->eS
2f340 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e tate = CURSOR_IN
2f350 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 20 20 72 VALID;. r
2f360 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e eturn SQLITE_DON
2f370 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 E;. }.
2f380 20 6d 6f 76 65 54 6f 50 61 72 65 6e 74 28 70 43 moveToParent(pC
2f390 75 72 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 ur);. pPage
2f3a0 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a = pCur->pPage;.
2f3b0 20 20 20 20 7d 77 68 69 6c 65 28 20 70 43 75 72 }while( pCur
2f3c0 2d 3e 69 78 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 ->ix>=pPage->nCe
2f3d0 6c 6c 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 ll );. if( pP
2f3e0 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 age->intKey ){.
2f3f0 20 20 20 20 20 72 65 74 75 72 6e 20 73 71 6c 69 return sqli
2f400 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 43 75 te3BtreeNext(pCu
2f410 72 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 r, 0);. }else
2f420 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
2f430 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a QLITE_OK;. }.
2f440 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d }. if( pPage-
2f450 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 >leaf ){. ret
2f460 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2f470 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
2f480 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 rn moveToLeftmos
2f490 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 69 t(pCur);. }.}.i
2f4a0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e nt sqlite3BtreeN
2f4b0 65 78 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 ext(BtCursor *pC
2f4c0 75 72 2c 20 69 6e 74 20 66 6c 61 67 73 29 7b 0a ur, int flags){.
2f4d0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
2f4e0 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d ;. UNUSED_PARAM
2f4f0 45 54 45 52 28 20 66 6c 61 67 73 20 29 3b 20 20 ETER( flags );
2f500 2f 2a 20 55 73 65 64 20 69 6e 20 43 4f 4d 44 42 /* Used in COMDB
2f510 32 20 62 75 74 20 6e 6f 74 20 6e 61 74 69 76 65 2 but not native
2f520 20 53 51 4c 69 74 65 20 2a 2f 0a 20 20 61 73 73 SQLite */. ass
2f530 65 72 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 ert( cursorOwnsB
2f540 74 53 68 61 72 65 64 28 70 43 75 72 29 20 29 3b tShared(pCur) );
2f550 0a 20 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 . assert( flags
2f560 3d 3d 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 31 20 ==0 || flags==1
2f570 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
2f580 72 2d 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c r->skipNext==0 |
2f590 7c 20 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d | pCur->eState!=
2f5a0 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a CURSOR_VALID );.
2f5b0 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 pCur->info.nSi
2f5c0 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ze = 0;. pCur->
2f5d0 63 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 curFlags &= ~(BT
2f5e0 43 46 5f 56 61 6c 69 64 4e 4b 65 79 7c 42 54 43 CF_ValidNKey|BTC
2f5f0 46 5f 56 61 6c 69 64 4f 76 66 6c 29 3b 0a 20 20 F_ValidOvfl);.
2f600 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
2f610 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 !=CURSOR_VALID )
2f620 20 72 65 74 75 72 6e 20 62 74 72 65 65 4e 65 78 return btreeNex
2f630 74 28 70 43 75 72 29 3b 0a 20 20 70 50 61 67 65 t(pCur);. pPage
2f640 20 3d 20 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a = pCur->pPage;.
2f650 20 20 69 66 28 20 28 2b 2b 70 43 75 72 2d 3e 69 if( (++pCur->i
2f660 78 29 3e 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c x)>=pPage->nCell
2f670 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 69 78 ){. pCur->ix
2f680 2d 2d 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 62 --;. return b
2f690 74 72 65 65 4e 65 78 74 28 70 43 75 72 29 3b 0a treeNext(pCur);.
2f6a0 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 2d }. if( pPage-
2f6b0 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 74 >leaf ){. ret
2f6c0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
2f6d0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 }else{. retu
2f6e0 72 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 rn moveToLeftmos
2f6f0 74 28 70 43 75 72 29 3b 0a 20 20 7d 0a 7d 0a 0a t(pCur);. }.}..
2f700 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 20 63 /*.** Step the c
2f710 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 61 63 ursor to the bac
2f720 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 6f 75 k to the previou
2f730 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 64 s entry in the d
2f740 61 74 61 62 61 73 65 2e 0a 2a 2a 20 52 65 74 75 atabase..** Retu
2f750 72 6e 20 76 61 6c 75 65 73 3a 0a 2a 2a 0a 2a 2a rn values:.**.**
2f760 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b 20 20 SQLITE_OK
2f770 20 20 20 73 75 63 63 65 73 73 0a 2a 2a 20 20 20 success.**
2f780 20 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 20 20 SQLITE_DONE
2f790 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 61 6c the cursor is al
2f7a0 72 65 61 64 79 20 6f 6e 20 74 68 65 20 66 69 72 ready on the fir
2f7b0 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 st element of th
2f7c0 65 20 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 6f e table.** o
2f7d0 74 68 65 72 77 69 73 65 20 20 20 20 20 73 6f 6d therwise som
2f7e0 65 20 6b 69 6e 64 20 6f 66 20 65 72 72 6f 72 20 e kind of error
2f7f0 6f 63 63 75 72 72 65 64 0a 2a 2a 0a 2a 2a 20 54 occurred.**.** T
2f800 68 65 20 6d 61 69 6e 20 65 6e 74 72 79 20 70 6f he main entry po
2f810 69 6e 74 20 69 73 20 73 71 6c 69 74 65 33 42 74 int is sqlite3Bt
2f820 72 65 65 50 72 65 76 69 6f 75 73 28 29 2e 20 20 reePrevious().
2f830 54 68 61 74 20 72 6f 75 74 69 6e 65 20 69 73 20 That routine is
2f840 6f 70 74 69 6d 69 7a 65 64 0a 2a 2a 20 66 6f 72 optimized.** for
2f850 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 the common case
2f860 20 6f 66 20 6d 65 72 65 6c 79 20 64 65 63 72 65 of merely decre
2f870 6d 65 6e 74 69 6e 67 20 74 68 65 20 63 65 6c 6c menting the cell
2f880 20 63 6f 75 6e 74 65 72 20 42 74 43 75 72 73 6f counter BtCurso
2f890 72 2e 61 69 49 64 78 0a 2a 2a 20 74 6f 20 74 68 r.aiIdx.** to th
2f8a0 65 20 70 72 65 76 69 6f 75 73 20 63 65 6c 6c 20 e previous cell
2f8b0 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 on the current p
2f8c0 61 67 65 2e 20 20 54 68 65 20 28 73 6c 6f 77 65 age. The (slowe
2f8d0 72 29 20 62 74 72 65 65 50 72 65 76 69 6f 75 73 r) btreePrevious
2f8e0 28 29 0a 2a 2a 20 68 65 6c 70 65 72 20 72 6f 75 ().** helper rou
2f8f0 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 77 tine is called w
2f900 68 65 6e 20 69 74 20 69 73 20 6e 65 63 65 73 73 hen it is necess
2f910 61 72 79 20 74 6f 20 6d 6f 76 65 20 74 6f 20 61 ary to move to a
2f920 20 64 69 66 66 65 72 65 6e 74 20 70 61 67 65 0a different page.
2f930 2a 2a 20 6f 72 20 74 6f 20 72 65 73 74 6f 72 65 ** or to restore
2f940 20 74 68 65 20 63 75 72 73 6f 72 2e 0a 2a 2a 0a the cursor..**.
2f950 2a 2a 20 49 66 20 62 69 74 20 30 78 30 31 20 6f ** If bit 0x01 o
2f960 66 20 74 68 65 20 46 20 61 72 67 75 6d 65 6e 74 f the F argument
2f970 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 to sqlite3Btree
2f980 50 72 65 76 69 6f 75 73 28 43 2c 46 29 20 69 73 Previous(C,F) is
2f990 20 31 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 1, then.** the
2f9a0 63 75 72 73 6f 72 20 63 6f 72 72 65 73 70 6f 6e cursor correspon
2f9b0 64 73 20 74 6f 20 61 6e 20 53 51 4c 20 69 6e 64 ds to an SQL ind
2f9c0 65 78 20 61 6e 64 20 74 68 69 73 20 72 6f 75 74 ex and this rout
2f9d0 69 6e 65 20 63 6f 75 6c 64 20 68 61 76 65 20 62 ine could have b
2f9e0 65 65 6e 0a 2a 2a 20 73 6b 69 70 70 65 64 20 69 een.** skipped i
2f9f0 66 20 74 68 65 20 53 51 4c 20 69 6e 64 65 78 20 f the SQL index
2fa00 68 61 64 20 62 65 65 6e 20 61 20 75 6e 69 71 75 had been a uniqu
2fa10 65 20 69 6e 64 65 78 2e 20 20 54 68 65 20 46 20 e index. The F
2fa20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 0a 2a 2a argument is a.**
2fa30 20 68 69 6e 74 20 74 6f 20 74 68 65 20 69 6d 70 hint to the imp
2fa40 6c 65 6d 65 6e 74 2e 20 20 54 68 65 20 6e 61 74 lement. The nat
2fa50 69 76 65 20 53 51 4c 69 74 65 20 62 74 72 65 65 ive SQLite btree
2fa60 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
2fa70 64 6f 65 73 20 6e 6f 74 0a 2a 2a 20 75 73 65 20 does not.** use
2fa80 74 68 69 73 20 68 69 6e 74 2c 20 62 75 74 20 43 this hint, but C
2fa90 4f 4d 44 42 32 20 64 6f 65 73 2e 0a 2a 2f 0a 73 OMDB2 does..*/.s
2faa0 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 tatic SQLITE_NOI
2fab0 4e 4c 49 4e 45 20 69 6e 74 20 62 74 72 65 65 50 NLINE int btreeP
2fac0 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 6f 72 revious(BtCursor
2fad0 20 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 *pCur){. int r
2fae0 63 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 c;. MemPage *pP
2faf0 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 age;.. assert(
2fb00 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 68 61 72 cursorOwnsBtShar
2fb10 65 64 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 ed(pCur) );. as
2fb20 73 65 72 74 28 20 70 43 75 72 2d 3e 73 6b 69 70 sert( pCur->skip
2fb30 4e 65 78 74 3d 3d 30 20 7c 7c 20 70 43 75 72 2d Next==0 || pCur-
2fb40 3e 65 53 74 61 74 65 21 3d 43 55 52 53 4f 52 5f >eState!=CURSOR_
2fb50 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 VALID );. asser
2fb60 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 t( (pCur->curFla
2fb70 67 73 20 26 20 28 42 54 43 46 5f 41 74 4c 61 73 gs & (BTCF_AtLas
2fb80 74 7c 42 54 43 46 5f 56 61 6c 69 64 4f 76 66 6c t|BTCF_ValidOvfl
2fb90 7c 42 54 43 46 5f 56 61 6c 69 64 4e 4b 65 79 29 |BTCF_ValidNKey)
2fba0 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 )==0 );. assert
2fbb0 28 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 ( pCur->info.nSi
2fbc0 7a 65 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 ze==0 );. if( p
2fbd0 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 Cur->eState!=CUR
2fbe0 53 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 SOR_VALID ){.
2fbf0 20 72 63 20 3d 20 72 65 73 74 6f 72 65 43 75 72 rc = restoreCur
2fc00 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 75 72 sorPosition(pCur
2fc10 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
2fc20 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
2fc30 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
2fc40 20 7d 0a 20 20 20 20 69 66 28 20 43 55 52 53 4f }. if( CURSO
2fc50 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 2d R_INVALID==pCur-
2fc60 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 20 20 20 >eState ){.
2fc70 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 return SQLITE_D
2fc80 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 ONE;. }. i
2fc90 66 28 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 f( pCur->skipNex
2fca0 74 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 t ){. asser
2fcb0 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
2fcc0 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c =CURSOR_VALID ||
2fcd0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
2fce0 55 52 53 4f 52 5f 53 4b 49 50 4e 45 58 54 20 29 URSOR_SKIPNEXT )
2fcf0 3b 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 65 53 ;. pCur->eS
2fd00 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 56 41 tate = CURSOR_VA
2fd10 4c 49 44 3b 0a 20 20 20 20 20 20 69 66 28 20 70 LID;. if( p
2fd20 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3c 30 20 Cur->skipNext<0
2fd30 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 2d ){. pCur-
2fd40 3e 73 6b 69 70 4e 65 78 74 20 3d 20 30 3b 0a 20 >skipNext = 0;.
2fd50 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
2fd60 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
2fd70 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 . pCur->ski
2fd80 70 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 7d pNext = 0;. }
2fd90 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 20 3d 20 . }.. pPage =
2fda0 70 43 75 72 2d 3e 70 50 61 67 65 3b 0a 20 20 61 pCur->pPage;. a
2fdb0 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 ssert( pPage->is
2fdc0 49 6e 69 74 20 29 3b 0a 20 20 69 66 28 20 21 70 Init );. if( !p
2fdd0 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 Page->leaf ){.
2fde0 20 20 69 6e 74 20 69 64 78 20 3d 20 70 43 75 72 int idx = pCur
2fdf0 2d 3e 69 78 3b 0a 20 20 20 20 72 63 20 3d 20 6d ->ix;. rc = m
2fe00 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 72 2c oveToChild(pCur,
2fe10 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 65 get4byte(findCe
2fe20 6c 6c 28 70 50 61 67 65 2c 20 69 64 78 29 29 29 ll(pPage, idx)))
2fe30 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
2fe40 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72 63 eturn rc;. rc
2fe50 20 3d 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f = moveToRightmo
2fe60 73 74 28 70 43 75 72 29 3b 0a 20 20 7d 65 6c 73 st(pCur);. }els
2fe70 65 7b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 43 e{. while( pC
2fe80 75 72 2d 3e 69 78 3d 3d 30 20 29 7b 0a 20 20 20 ur->ix==0 ){.
2fe90 20 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 if( pCur->iPa
2fea0 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ge==0 ){.
2feb0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
2fec0 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a CURSOR_INVALID;.
2fed0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
2fee0 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 20 20 QLITE_DONE;.
2fef0 20 20 7d 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f }. moveTo
2ff00 50 61 72 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 Parent(pCur);.
2ff10 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 }. assert(
2ff20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
2ff30 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ==0 );. asser
2ff40 74 28 20 28 70 43 75 72 2d 3e 63 75 72 46 6c 61 t( (pCur->curFla
2ff50 67 73 20 26 20 28 42 54 43 46 5f 56 61 6c 69 64 gs & (BTCF_Valid
2ff60 4f 76 66 6c 29 29 3d 3d 30 20 29 3b 0a 0a 20 20 Ovfl))==0 );..
2ff70 20 20 70 43 75 72 2d 3e 69 78 2d 2d 3b 0a 20 20 pCur->ix--;.
2ff80 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 2d 3e pPage = pCur->
2ff90 70 50 61 67 65 3b 0a 20 20 20 20 69 66 28 20 70 pPage;. if( p
2ffa0 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 26 20 Page->intKey &&
2ffb0 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a !pPage->leaf ){.
2ffc0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2ffd0 65 33 42 74 72 65 65 50 72 65 76 69 6f 75 73 28 e3BtreePrevious(
2ffe0 70 43 75 72 2c 20 30 29 3b 0a 20 20 20 20 7d 65 pCur, 0);. }e
2fff0 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 lse{. rc =
30000 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 7d SQLITE_OK;. }
30010 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
30020 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 ;.}.int sqlite3B
30030 74 72 65 65 50 72 65 76 69 6f 75 73 28 42 74 43 treePrevious(BtC
30040 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 ursor *pCur, int
30050 20 66 6c 61 67 73 29 7b 0a 20 20 61 73 73 65 72 flags){. asser
30060 74 28 20 63 75 72 73 6f 72 4f 77 6e 73 42 74 53 t( cursorOwnsBtS
30070 68 61 72 65 64 28 70 43 75 72 29 20 29 3b 0a 20 hared(pCur) );.
30080 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 3d 3d assert( flags==
30090 30 20 7c 7c 20 66 6c 61 67 73 3d 3d 31 20 29 3b 0 || flags==1 );
300a0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
300b0 3e 73 6b 69 70 4e 65 78 74 3d 3d 30 20 7c 7c 20 >skipNext==0 ||
300c0 70 43 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 pCur->eState!=CU
300d0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
300e0 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
300f0 28 20 66 6c 61 67 73 20 29 3b 20 20 2f 2a 20 55 ( flags ); /* U
30100 73 65 64 20 69 6e 20 43 4f 4d 44 42 32 20 62 75 sed in COMDB2 bu
30110 74 20 6e 6f 74 20 6e 61 74 69 76 65 20 53 51 4c t not native SQL
30120 69 74 65 20 2a 2f 0a 20 20 70 43 75 72 2d 3e 63 ite */. pCur->c
30130 75 72 46 6c 61 67 73 20 26 3d 20 7e 28 42 54 43 urFlags &= ~(BTC
30140 46 5f 41 74 4c 61 73 74 7c 42 54 43 46 5f 56 61 F_AtLast|BTCF_Va
30150 6c 69 64 4f 76 66 6c 7c 42 54 43 46 5f 56 61 6c lidOvfl|BTCF_Val
30160 69 64 4e 4b 65 79 29 3b 0a 20 20 70 43 75 72 2d idNKey);. pCur-
30170 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
30180 0a 20 20 69 66 28 20 70 43 75 72 2d 3e 65 53 74 . if( pCur->eSt
30190 61 74 65 21 3d 43 55 52 53 4f 52 5f 56 41 4c 49 ate!=CURSOR_VALI
301a0 44 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e 69 78 D. || pCur->ix
301b0 3d 3d 30 0a 20 20 20 7c 7c 20 70 43 75 72 2d 3e ==0. || pCur->
301c0 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d 30 0a 20 pPage->leaf==0.
301d0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 62 ){. return b
301e0 74 72 65 65 50 72 65 76 69 6f 75 73 28 70 43 75 treePrevious(pCu
301f0 72 29 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e r);. }. pCur->
30200 69 78 2d 2d 3b 0a 20 20 72 65 74 75 72 6e 20 53 ix--;. return S
30210 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a QLITE_OK;.}../*.
30220 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 ** Allocate a ne
30230 77 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 w page from the
30240 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
30250 2a 0a 2a 2a 20 54 68 65 20 6e 65 77 20 70 61 67 *.** The new pag
30260 65 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 64 e is marked as d
30270 69 72 74 79 2e 20 20 28 49 6e 20 6f 74 68 65 72 irty. (In other
30280 20 77 6f 72 64 73 2c 20 73 71 6c 69 74 65 33 50 words, sqlite3P
30290 61 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 68 agerWrite().** h
302a0 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 as already been
302b0 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6e 65 called on the ne
302c0 77 20 70 61 67 65 2e 29 20 20 54 68 65 20 6e 65 w page.) The ne
302d0 77 20 70 61 67 65 20 68 61 73 20 61 6c 73 6f 0a w page has also.
302e0 2a 2a 20 62 65 65 6e 20 72 65 66 65 72 65 6e 63 ** been referenc
302f0 65 64 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 ed and the calli
30300 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 20 72 65 ng routine is re
30310 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 63 61 sponsible for ca
30320 6c 6c 69 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 33 lling.** sqlite3
30330 50 61 67 65 72 55 6e 72 65 66 28 29 20 6f 6e 20 PagerUnref() on
30340 74 68 65 20 6e 65 77 20 70 61 67 65 20 77 68 65 the new page whe
30350 6e 20 69 74 20 69 73 20 64 6f 6e 65 2e 0a 2a 2a n it is done..**
30360 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 .** SQLITE_OK is
30370 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 returned on suc
30380 63 65 73 73 2e 20 20 41 6e 79 20 6f 74 68 65 72 cess. Any other
30390 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 6e return value in
303a0 64 69 63 61 74 65 73 0a 2a 2a 20 61 6e 20 65 72 dicates.** an er
303b0 72 6f 72 2e 20 20 2a 70 70 50 61 67 65 20 69 73 ror. *ppPage is
303c0 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 69 6e 20 set to NULL in
303d0 74 68 65 20 65 76 65 6e 74 20 6f 66 20 61 6e 20 the event of an
303e0 65 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 error..**.** If
303f0 74 68 65 20 22 6e 65 61 72 62 79 22 20 70 61 72 the "nearby" par
30400 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 30 2c ameter is not 0,
30410 20 74 68 65 6e 20 61 6e 20 65 66 66 6f 72 74 20 then an effort
30420 69 73 20 6d 61 64 65 20 74 6f 20 0a 2a 2a 20 6c is made to .** l
30430 6f 63 61 74 65 20 61 20 70 61 67 65 20 63 6c 6f ocate a page clo
30440 73 65 20 74 6f 20 74 68 65 20 70 61 67 65 20 6e se to the page n
30450 75 6d 62 65 72 20 22 6e 65 61 72 62 79 22 2e 20 umber "nearby".
30460 20 54 68 69 73 20 63 61 6e 20 62 65 20 75 73 65 This can be use
30470 64 20 69 6e 20 61 6e 0a 2a 2a 20 61 74 74 65 6d d in an.** attem
30480 70 74 20 74 6f 20 6b 65 65 70 20 72 65 6c 61 74 pt to keep relat
30490 65 64 20 70 61 67 65 73 20 63 6c 6f 73 65 20 74 ed pages close t
304a0 6f 20 65 61 63 68 20 6f 74 68 65 72 20 69 6e 20 o each other in
304b0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
304c0 65 2c 0a 2a 2a 20 77 68 69 63 68 20 69 6e 20 74 e,.** which in t
304d0 75 72 6e 20 63 61 6e 20 6d 61 6b 65 20 64 61 74 urn can make dat
304e0 61 62 61 73 65 20 61 63 63 65 73 73 20 66 61 73 abase access fas
304f0 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ter..**.** If th
30500 65 20 65 4d 6f 64 65 20 70 61 72 61 6d 65 74 65 e eMode paramete
30510 72 20 69 73 20 42 54 41 4c 4c 4f 43 5f 45 58 41 r is BTALLOC_EXA
30520 43 54 20 61 6e 64 20 74 68 65 20 6e 65 61 72 62 CT and the nearb
30530 79 20 70 61 67 65 20 65 78 69 73 74 73 0a 2a 2a y page exists.**
30540 20 61 6e 79 77 68 65 72 65 20 6f 6e 20 74 68 65 anywhere on the
30550 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e free-list, then
30560 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 it is guarantee
30570 64 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 d to be returned
30580 2e 20 20 49 66 0a 2a 2a 20 65 4d 6f 64 65 20 69 . If.** eMode i
30590 73 20 42 54 41 4c 4c 4f 43 5f 4c 54 20 74 68 65 s BTALLOC_LT the
305a0 6e 20 74 68 65 20 70 61 67 65 20 72 65 74 75 72 n the page retur
305b0 6e 65 64 20 77 69 6c 6c 20 62 65 20 6c 65 73 73 ned will be less
305c0 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a than or equal.*
305d0 2a 20 74 6f 20 6e 65 61 72 62 79 20 69 66 20 61 * to nearby if a
305e0 6e 79 20 73 75 63 68 20 70 61 67 65 20 65 78 69 ny such page exi
305f0 73 74 73 2e 20 20 49 66 20 65 4d 6f 64 65 20 69 sts. If eMode i
30600 73 20 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 74 68 s BTALLOC_ANY th
30610 65 6e 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 en there.** are
30620 6e 6f 20 72 65 73 74 72 69 63 74 69 6f 6e 73 20 no restrictions
30630 6f 6e 20 77 68 69 63 68 20 70 61 67 65 20 69 73 on which page is
30640 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 returned..*/.st
30650 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 atic int allocat
30660 65 42 74 72 65 65 50 61 67 65 28 0a 20 20 42 74 eBtreePage(. Bt
30670 53 68 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 Shared *pBt,
30680 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 /* The btre
30690 65 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a e */. MemPage *
306a0 2a 70 70 50 61 67 65 2c 20 20 20 20 20 20 2f 2a *ppPage, /*
306b0 20 53 74 6f 72 65 20 70 6f 69 6e 74 65 72 20 74 Store pointer t
306c0 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64 20 o the allocated
306d0 70 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 20 50 page here */. P
306e0 67 6e 6f 20 2a 70 50 67 6e 6f 2c 20 20 20 20 20 gno *pPgno,
306f0 20 20 20 20 20 20 2f 2a 20 53 74 6f 72 65 20 74 /* Store t
30700 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 68 he page number h
30710 65 72 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6e 65 ere */. Pgno ne
30720 61 72 62 79 2c 20 20 20 20 20 20 20 20 20 20 20 arby,
30730 2f 2a 20 53 65 61 72 63 68 20 66 6f 72 20 61 20 /* Search for a
30740 70 61 67 65 20 6e 65 61 72 20 74 68 69 73 20 6f page near this o
30750 6e 65 20 2a 2f 0a 20 20 75 38 20 65 4d 6f 64 65 ne */. u8 eMode
30760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
30770 2a 20 42 54 41 4c 4c 4f 43 5f 45 58 41 43 54 2c * BTALLOC_EXACT,
30780 20 42 54 41 4c 4c 4f 43 5f 4c 54 2c 20 6f 72 20 BTALLOC_LT, or
30790 42 54 41 4c 4c 4f 43 5f 41 4e 59 20 2a 2f 0a 29 BTALLOC_ANY */.)
307a0 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 {. MemPage *pPa
307b0 67 65 31 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 ge1;. int rc;.
307c0 20 75 33 32 20 6e 3b 20 20 20 20 20 2f 2a 20 4e u32 n; /* N
307d0 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f umber of pages o
307e0 6e 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a n the freelist *
307f0 2f 0a 20 20 75 33 32 20 6b 3b 20 20 20 20 20 2f /. u32 k; /
30800 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 65 61 76 * Number of leav
30810 65 73 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 es on the trunk
30820 6f 66 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 of the freelist
30830 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 */. MemPage *pT
30840 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 runk = 0;. MemP
30850 61 67 65 20 2a 70 50 72 65 76 54 72 75 6e 6b 20 age *pPrevTrunk
30860 3d 20 30 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 61 = 0;. Pgno mxPa
30870 67 65 3b 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c ge; /* Total
30880 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 size of the dat
30890 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 abase file */..
308a0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
308b0 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d _mutex_held(pBt-
308c0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
308d0 65 72 74 28 20 65 4d 6f 64 65 3d 3d 42 54 41 4c ert( eMode==BTAL
308e0 4c 4f 43 5f 41 4e 59 20 7c 7c 20 28 6e 65 61 72 LOC_ANY || (near
308f0 62 79 3e 30 20 26 26 20 49 66 4e 6f 74 4f 6d 69 by>0 && IfNotOmi
30900 74 41 56 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 tAV(pBt->autoVac
30910 75 75 6d 29 29 20 29 3b 0a 20 20 70 50 61 67 65 uum)) );. pPage
30920 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 1 = pBt->pPage1;
30930 0a 20 20 6d 78 50 61 67 65 20 3d 20 62 74 72 65 . mxPage = btre
30940 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
30950 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f . /* EVIDENCE-O
30960 46 3a 20 52 2d 30 35 31 31 39 2d 30 32 36 33 37 F: R-05119-02637
30970 20 54 68 65 20 34 2d 62 79 74 65 20 62 69 67 2d The 4-byte big-
30980 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 61 endian integer a
30990 74 20 6f 66 66 73 65 74 20 33 36 0a 20 20 2a 2a t offset 36. **
309a0 20 73 74 6f 72 65 73 20 73 74 6f 72 65 73 20 74 stores stores t
309b0 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 he total number
309c0 6f 66 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 of pages on the
309d0 66 72 65 65 6c 69 73 74 2e 20 2a 2f 0a 20 20 6e freelist. */. n
309e0 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 = get4byte(&pPa
309f0 67 65 31 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b ge1->aData[36]);
30a00 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d . testcase( n==
30a10 6d 78 50 61 67 65 2d 31 20 29 3b 0a 20 20 69 66 mxPage-1 );. if
30a20 28 20 6e 3e 3d 6d 78 50 61 67 65 20 29 7b 0a 20 ( n>=mxPage ){.
30a30 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
30a40 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
30a50 20 7d 0a 20 20 69 66 28 20 6e 3e 30 20 29 7b 0a }. if( n>0 ){.
30a60 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 65 /* There are
30a70 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 pages on the fr
30a80 65 65 6c 69 73 74 2e 20 20 52 65 75 73 65 20 6f eelist. Reuse o
30a90 6e 65 20 6f 66 20 74 68 6f 73 65 20 70 61 67 65 ne of those page
30aa0 73 2e 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 69 s. */. Pgno i
30ab0 54 72 75 6e 6b 3b 0a 20 20 20 20 75 38 20 73 65 Trunk;. u8 se
30ac0 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 20 2f 2a archList = 0; /*
30ad0 20 49 66 20 74 68 65 20 66 72 65 65 2d 6c 69 73 If the free-lis
30ae0 74 20 6d 75 73 74 20 62 65 20 73 65 61 72 63 68 t must be search
30af0 65 64 20 66 6f 72 20 27 6e 65 61 72 62 79 27 20 ed for 'nearby'
30b00 2a 2f 0a 20 20 20 20 75 33 32 20 6e 53 65 61 72 */. u32 nSear
30b10 63 68 20 3d 20 30 3b 20 20 20 2f 2a 20 43 6f 75 ch = 0; /* Cou
30b20 6e 74 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 nt of the number
30b30 20 6f 66 20 73 65 61 72 63 68 20 61 74 74 65 6d of search attem
30b40 70 74 73 20 2a 2f 0a 20 20 20 20 0a 20 20 20 20 pts */. .
30b50 2f 2a 20 49 66 20 65 4d 6f 64 65 3d 3d 42 54 41 /* If eMode==BTA
30b60 4c 4c 4f 43 5f 45 58 41 43 54 20 61 6e 64 20 61 LLOC_EXACT and a
30b70 20 71 75 65 72 79 20 6f 66 20 74 68 65 20 70 6f query of the po
30b80 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 2a 2a inter-map. **
30b90 20 73 68 6f 77 73 20 74 68 61 74 20 74 68 65 20 shows that the
30ba0 70 61 67 65 20 27 6e 65 61 72 62 79 27 20 69 73 page 'nearby' is
30bb0 20 73 6f 6d 65 77 68 65 72 65 20 6f 6e 20 74 68 somewhere on th
30bc0 65 20 66 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 e free-list, the
30bd0 6e 0a 20 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 n. ** the ent
30be0 69 72 65 2d 6c 69 73 74 20 77 69 6c 6c 20 62 65 ire-list will be
30bf0 20 73 65 61 72 63 68 65 64 20 66 6f 72 20 74 68 searched for th
30c00 61 74 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f 0a at page.. */.
30c10 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
30c20 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
30c30 20 20 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 54 if( eMode==BT
30c40 41 4c 4c 4f 43 5f 45 58 41 43 54 20 29 7b 0a 20 ALLOC_EXACT ){.
30c50 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 3c if( nearby<
30c60 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 20 =mxPage ){.
30c70 20 20 20 75 38 20 65 54 79 70 65 3b 0a 20 20 20 u8 eType;.
30c80 20 20 20 20 20 61 73 73 65 72 74 28 20 6e 65 61 assert( nea
30c90 72 62 79 3e 30 20 29 3b 0a 20 20 20 20 20 20 20 rby>0 );.
30ca0 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 61 75 assert( pBt->au
30cb0 74 6f 56 61 63 75 75 6d 20 29 3b 0a 20 20 20 20 toVacuum );.
30cc0 20 20 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 rc = ptrmapG
30cd0 65 74 28 70 42 74 2c 20 6e 65 61 72 62 79 2c 20 et(pBt, nearby,
30ce0 26 65 54 79 70 65 2c 20 30 29 3b 0a 20 20 20 20 &eType, 0);.
30cf0 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
30d00 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 urn rc;.
30d10 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 if( eType==PTRMA
30d20 50 5f 46 52 45 45 50 41 47 45 20 29 7b 0a 20 20 P_FREEPAGE ){.
30d30 20 20 20 20 20 20 20 20 73 65 61 72 63 68 4c 69 searchLi
30d40 73 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 st = 1;.
30d50 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 }. }. }e
30d60 6c 73 65 20 69 66 28 20 65 4d 6f 64 65 3d 3d 42 lse if( eMode==B
30d70 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b 0a 20 20 20 TALLOC_LE ){.
30d80 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 searchList =
30d90 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 1;. }.#endif.
30da0 0a 20 20 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e . /* Decremen
30db0 74 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 t the free-list
30dc0 63 6f 75 6e 74 20 62 79 20 31 2e 20 53 65 74 20 count by 1. Set
30dd0 69 54 72 75 6e 6b 20 74 6f 20 74 68 65 20 69 6e iTrunk to the in
30de0 64 65 78 20 6f 66 20 74 68 65 0a 20 20 20 20 2a dex of the. *
30df0 2a 20 66 69 72 73 74 20 66 72 65 65 2d 6c 69 73 * first free-lis
30e00 74 20 74 72 75 6e 6b 20 70 61 67 65 2e 20 69 50 t trunk page. iP
30e10 72 65 76 54 72 75 6e 6b 20 69 73 20 69 6e 69 74 revTrunk is init
30e20 69 61 6c 6c 79 20 31 2e 0a 20 20 20 20 2a 2f 0a ially 1.. */.
30e30 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
30e40 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 PagerWrite(pPage
30e50 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 1->pDbPage);.
30e60 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
30e70 20 72 63 3b 0a 20 20 20 20 70 75 74 34 62 79 74 rc;. put4byt
30e80 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 e(&pPage1->aData
30e90 5b 33 36 5d 2c 20 6e 2d 31 29 3b 0a 0a 20 20 20 [36], n-1);..
30ea0 20 2f 2a 20 54 68 65 20 63 6f 64 65 20 77 69 74 /* The code wit
30eb0 68 69 6e 20 74 68 69 73 20 6c 6f 6f 70 20 69 73 hin this loop is
30ec0 20 72 75 6e 20 6f 6e 6c 79 20 6f 6e 63 65 20 69 run only once i
30ed0 66 20 74 68 65 20 27 73 65 61 72 63 68 4c 69 73 f the 'searchLis
30ee0 74 27 20 76 61 72 69 61 62 6c 65 0a 20 20 20 20 t' variable.
30ef0 2a 2a 20 69 73 20 6e 6f 74 20 74 72 75 65 2e 20 ** is not true.
30f00 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 72 75 Otherwise, it ru
30f10 6e 73 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 ns once for each
30f20 20 74 72 75 6e 6b 2d 70 61 67 65 20 6f 6e 20 74 trunk-page on t
30f30 68 65 0a 20 20 20 20 2a 2a 20 66 72 65 65 2d 6c he. ** free-l
30f40 69 73 74 20 75 6e 74 69 6c 20 74 68 65 20 70 61 ist until the pa
30f50 67 65 20 27 6e 65 61 72 62 79 27 20 69 73 20 6c ge 'nearby' is l
30f60 6f 63 61 74 65 64 20 28 65 4d 6f 64 65 3d 3d 42 ocated (eMode==B
30f70 54 41 4c 4c 4f 43 5f 45 58 41 43 54 29 0a 20 20 TALLOC_EXACT).
30f80 20 20 2a 2a 20 6f 72 20 75 6e 74 69 6c 20 61 20 ** or until a
30f90 70 61 67 65 20 6c 65 73 73 20 74 68 61 6e 20 27 page less than '
30fa0 6e 65 61 72 62 79 27 20 69 73 20 6c 6f 63 61 74 nearby' is locat
30fb0 65 64 20 28 65 4d 6f 64 65 3d 3d 42 54 41 4c 4c ed (eMode==BTALL
30fc0 4f 43 5f 4c 54 29 0a 20 20 20 20 2a 2f 0a 20 20 OC_LT). */.
30fd0 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 70 50 72 do {. pPr
30fe0 65 76 54 72 75 6e 6b 20 3d 20 70 54 72 75 6e 6b evTrunk = pTrunk
30ff0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 72 65 ;. if( pPre
31000 76 54 72 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 vTrunk ){.
31010 20 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 /* EVIDENCE-OF
31020 3a 20 52 2d 30 31 35 30 36 2d 31 31 30 35 33 20 : R-01506-11053
31030 54 68 65 20 66 69 72 73 74 20 69 6e 74 65 67 65 The first intege
31040 72 20 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 20 r on a freelist
31050 74 72 75 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 trunk page.
31060 20 20 20 2a 2a 20 69 73 20 74 68 65 20 70 61 67 ** is the pag
31070 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
31080 6e 65 78 74 20 66 72 65 65 6c 69 73 74 20 74 72 next freelist tr
31090 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 65 20 unk page in the
310a0 6c 69 73 74 20 6f 72 0a 20 20 20 20 20 20 20 20 list or.
310b0 2a 2a 20 7a 65 72 6f 20 69 66 20 74 68 69 73 20 ** zero if this
310c0 69 73 20 74 68 65 20 6c 61 73 74 20 66 72 65 65 is the last free
310d0 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e list trunk page.
310e0 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 54 72 75 */. iTru
310f0 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 nk = get4byte(&p
31100 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 PrevTrunk->aData
31110 5b 30 5d 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 [0]);. }els
31120 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 45 56 e{. /* EV
31130 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 39 38 IDENCE-OF: R-598
31140 34 31 2d 31 33 37 39 38 20 54 68 65 20 34 2d 62 41-13798 The 4-b
31150 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 yte big-endian i
31160 6e 74 65 67 65 72 20 61 74 20 6f 66 66 73 65 74 nteger at offset
31170 20 33 32 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 32. ** s
31180 74 6f 72 65 73 20 74 68 65 20 70 61 67 65 20 6e tores the page n
31190 75 6d 62 65 72 20 6f 66 20 74 68 65 20 66 69 72 umber of the fir
311a0 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 66 st page of the f
311b0 72 65 65 6c 69 73 74 2c 20 6f 72 20 7a 65 72 6f reelist, or zero
311c0 20 69 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 if. ** t
311d0 68 65 20 66 72 65 65 6c 69 73 74 20 69 73 20 65 he freelist is e
311e0 6d 70 74 79 2e 20 2a 2f 0a 20 20 20 20 20 20 20 mpty. */.
311f0 20 69 54 72 75 6e 6b 20 3d 20 67 65 74 34 62 79 iTrunk = get4by
31200 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 74 te(&pPage1->aDat
31210 61 5b 33 32 5d 29 3b 0a 20 20 20 20 20 20 7d 0a a[32]);. }.
31220 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
31230 69 54 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 iTrunk==mxPage )
31240 3b 0a 20 20 20 20 20 20 69 66 28 20 69 54 72 75 ;. if( iTru
31250 6e 6b 3e 6d 78 50 61 67 65 20 7c 7c 20 6e 53 65 nk>mxPage || nSe
31260 61 72 63 68 2b 2b 20 3e 20 6e 20 29 7b 0a 20 20 arch++ > n ){.
31270 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
31280 45 5f 43 4f 52 52 55 50 54 5f 50 47 4e 4f 28 70 E_CORRUPT_PGNO(p
31290 50 72 65 76 54 72 75 6e 6b 20 3f 20 70 50 72 65 PrevTrunk ? pPre
312a0 76 54 72 75 6e 6b 2d 3e 70 67 6e 6f 20 3a 20 31 vTrunk->pgno : 1
312b0 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a );. }else{.
312c0 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 rc = btr
312d0 65 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 eeGetUnusedPage(
312e0 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 pBt, iTrunk, &pT
312f0 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 runk, 0);.
31300 7d 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 }. if( rc )
31310 7b 0a 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b {. pTrunk
31320 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 67 6f = 0;. go
31330 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f to end_allocate_
31340 70 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 page;. }.
31350 20 20 20 20 61 73 73 65 72 74 28 20 70 54 72 75 assert( pTru
31360 6e 6b 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 nk!=0 );. a
31370 73 73 65 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 ssert( pTrunk->a
31380 44 61 74 61 21 3d 30 20 29 3b 0a 20 20 20 20 20 Data!=0 );.
31390 20 2f 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a /* EVIDENCE-OF:
313a0 20 52 2d 31 33 35 32 33 2d 30 34 33 39 34 20 54 R-13523-04394 T
313b0 68 65 20 73 65 63 6f 6e 64 20 69 6e 74 65 67 65 he second intege
313c0 72 20 6f 6e 20 61 20 66 72 65 65 6c 69 73 74 20 r on a freelist
313d0 74 72 75 6e 6b 20 70 61 67 65 0a 20 20 20 20 20 trunk page.
313e0 20 2a 2a 20 69 73 20 74 68 65 20 6e 75 6d 62 65 ** is the numbe
313f0 72 20 6f 66 20 6c 65 61 66 20 70 61 67 65 20 70 r of leaf page p
31400 6f 69 6e 74 65 72 73 20 74 6f 20 66 6f 6c 6c 6f ointers to follo
31410 77 2e 20 2a 2f 0a 20 20 20 20 20 20 6b 20 3d 20 w. */. k =
31420 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e 6b get4byte(&pTrunk
31430 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 20 ->aData[4]);.
31440 20 20 20 69 66 28 20 6b 3d 3d 30 20 26 26 20 21 if( k==0 && !
31450 73 65 61 72 63 68 4c 69 73 74 20 29 7b 0a 20 20 searchList ){.
31460 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 /* The tru
31470 6e 6b 20 68 61 73 20 6e 6f 20 6c 65 61 76 65 73 nk has no leaves
31480 20 61 6e 64 20 74 68 65 20 6c 69 73 74 20 69 73 and the list is
31490 20 6e 6f 74 20 62 65 69 6e 67 20 73 65 61 72 63 not being searc
314a0 68 65 64 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a hed. . **
314b0 20 53 6f 20 65 78 74 72 61 63 74 20 74 68 65 20 So extract the
314c0 74 72 75 6e 6b 20 70 61 67 65 20 69 74 73 65 6c trunk page itsel
314d0 66 20 61 6e 64 20 75 73 65 20 69 74 20 61 73 20 f and use it as
314e0 74 68 65 20 6e 65 77 6c 79 20 0a 20 20 20 20 20 the newly .
314f0 20 20 20 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 ** allocated
31500 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 page */.
31510 61 73 73 65 72 74 28 20 70 50 72 65 76 54 72 75 assert( pPrevTru
31520 6e 6b 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 nk==0 );.
31530 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
31540 65 72 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e erWrite(pTrunk->
31550 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
31560 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
31570 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 goto end_a
31580 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 llocate_page;.
31590 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
315a0 2a 70 50 67 6e 6f 20 3d 20 69 54 72 75 6e 6b 3b *pPgno = iTrunk;
315b0 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
315c0 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
315d0 32 5d 2c 20 26 70 54 72 75 6e 6b 2d 3e 61 44 61 2], &pTrunk->aDa
315e0 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[0], 4);.
315f0 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 54 72 *ppPage = pTr
31600 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 70 54 72 unk;. pTr
31610 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 unk = 0;.
31620 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 TRACE(("ALLOCAT
31630 45 3a 20 25 64 20 74 72 75 6e 6b 20 2d 20 25 64 E: %d trunk - %d
31640 20 66 72 65 65 20 70 61 67 65 73 20 6c 65 66 74 free pages left
31650 5c 6e 22 2c 20 2a 70 50 67 6e 6f 2c 20 6e 2d 31 \n", *pPgno, n-1
31660 29 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 ));. }else
31670 69 66 28 20 6b 3e 28 75 33 32 29 28 70 42 74 2d if( k>(u32)(pBt-
31680 3e 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 >usableSize/4 -
31690 32 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 2) ){. /*
316a0 20 56 61 6c 75 65 20 6f 66 20 6b 20 69 73 20 6f Value of k is o
316b0 75 74 20 6f 66 20 72 61 6e 67 65 2e 20 20 44 61 ut of range. Da
316c0 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 69 6f tabase corruptio
316d0 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 63 20 n */. rc
316e0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
316f0 5f 50 47 4e 4f 28 69 54 72 75 6e 6b 29 3b 0a 20 _PGNO(iTrunk);.
31700 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
31710 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 23 allocate_page;.#
31720 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
31730 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
31740 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73 65 }else if( se
31750 61 72 63 68 4c 69 73 74 20 0a 20 20 20 20 20 20 archList .
31760 20 20 20 20 20 20 26 26 20 28 6e 65 61 72 62 79 && (nearby
31770 3d 3d 69 54 72 75 6e 6b 20 7c 7c 20 28 69 54 72 ==iTrunk || (iTr
31780 75 6e 6b 3c 6e 65 61 72 62 79 20 26 26 20 65 4d unk<nearby && eM
31790 6f 64 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 29 ode==BTALLOC_LE)
317a0 29 20 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 ) . ){.
317b0 20 20 20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 /* The list
317c0 69 73 20 62 65 69 6e 67 20 73 65 61 72 63 68 65 is being searche
317d0 64 20 61 6e 64 20 74 68 69 73 20 74 72 75 6e 6b d and this trunk
317e0 20 70 61 67 65 20 69 73 20 74 68 65 20 70 61 67 page is the pag
317f0 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 e. ** to
31800 61 6c 6c 6f 63 61 74 65 2c 20 72 65 67 61 72 64 allocate, regard
31810 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 less of whether
31820 69 74 20 68 61 73 20 6c 65 61 76 65 73 2e 0a 20 it has leaves..
31830 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
31840 20 20 2a 70 50 67 6e 6f 20 3d 20 69 54 72 75 6e *pPgno = iTrun
31850 6b 3b 0a 20 20 20 20 20 20 20 20 2a 70 70 50 61 k;. *ppPa
31860 67 65 20 3d 20 70 54 72 75 6e 6b 3b 0a 20 20 20 ge = pTrunk;.
31870 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 20 searchList
31880 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 72 63 20 = 0;. rc
31890 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
318a0 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 ite(pTrunk->pDbP
318b0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 age);. if
318c0 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 ( rc ){.
318d0 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
318e0 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
318f0 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
31900 6b 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 k==0 ){.
31910 20 20 69 66 28 20 21 70 50 72 65 76 54 72 75 6e if( !pPrevTrun
31920 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 k ){.
31930 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 31 2d memcpy(&pPage1-
31940 3e 61 44 61 74 61 5b 33 32 5d 2c 20 26 70 54 72 >aData[32], &pTr
31950 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 unk->aData[0], 4
31960 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c );. }el
31970 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 se{.
31980 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
31990 72 57 72 69 74 65 28 70 50 72 65 76 54 72 75 6e rWrite(pPrevTrun
319a0 6b 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 k->pDbPage);.
319b0 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 if( rc!
319c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
319d0 20 20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f goto
319e0 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
319f0 67 65 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ge;.
31a00 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 }. me
31a10 6d 63 70 79 28 26 70 50 72 65 76 54 72 75 6e 6b mcpy(&pPrevTrunk
31a20 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 ->aData[0], &pTr
31a30 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 unk->aData[0], 4
31a40 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
31a50 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
31a60 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 /* The t
31a70 72 75 6e 6b 20 70 61 67 65 20 69 73 20 72 65 71 runk page is req
31a80 75 69 72 65 64 20 62 79 20 74 68 65 20 63 61 6c uired by the cal
31a90 6c 65 72 20 62 75 74 20 69 74 20 63 6f 6e 74 61 ler but it conta
31aa0 69 6e 73 20 0a 20 20 20 20 20 20 20 20 20 20 2a ins . *
31ab0 2a 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 66 72 * pointers to fr
31ac0 65 65 2d 6c 69 73 74 20 6c 65 61 76 65 73 2e 20 ee-list leaves.
31ad0 54 68 65 20 66 69 72 73 74 20 6c 65 61 66 20 62 The first leaf b
31ae0 65 63 6f 6d 65 73 20 61 20 74 72 75 6e 6b 0a 20 ecomes a trunk.
31af0 20 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 ** page
31b00 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 20 in this case..
31b10 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 */.
31b20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 MemPage *p
31b30 4e 65 77 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 NewTrunk;.
31b40 20 20 20 20 50 67 6e 6f 20 69 4e 65 77 54 72 75 Pgno iNewTru
31b50 6e 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 nk = get4byte(&p
31b60 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 38 5d 29 Trunk->aData[8])
31b70 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 ;. if(
31b80 69 4e 65 77 54 72 75 6e 6b 3e 6d 78 50 61 67 65 iNewTrunk>mxPage
31b90 20 29 7b 20 0a 20 20 20 20 20 20 20 20 20 20 20 ){ .
31ba0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 rc = SQLITE_COR
31bb0 52 55 50 54 5f 50 47 4e 4f 28 69 54 72 75 6e 6b RUPT_PGNO(iTrunk
31bc0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 67 );. g
31bd0 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
31be0 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 20 _page;.
31bf0 20 7d 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 }. tes
31c00 74 63 61 73 65 28 20 69 4e 65 77 54 72 75 6e 6b tcase( iNewTrunk
31c10 3d 3d 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 ==mxPage );.
31c20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 65 rc = btree
31c30 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 42 GetUnusedPage(pB
31c40 74 2c 20 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 t, iNewTrunk, &p
31c50 4e 65 77 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 NewTrunk, 0);.
31c60 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
31c70 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
31c80 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
31c90 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b d_allocate_page;
31ca0 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
31cb0 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
31cc0 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 4e te3PagerWrite(pN
31cd0 65 77 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 ewTrunk->pDbPage
31ce0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
31cf0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
31d00 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 {. re
31d10 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 54 72 leasePage(pNewTr
31d20 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 unk);.
31d30 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 goto end_alloc
31d40 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 ate_page;.
31d50 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
31d60 6d 65 6d 63 70 79 28 26 70 4e 65 77 54 72 75 6e memcpy(&pNewTrun
31d70 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 k->aData[0], &pT
31d80 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 runk->aData[0],
31d90 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 75 4);. pu
31da0 74 34 62 79 74 65 28 26 70 4e 65 77 54 72 75 6e t4byte(&pNewTrun
31db0 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 k->aData[4], k-1
31dc0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d );. mem
31dd0 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e cpy(&pNewTrunk->
31de0 61 44 61 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e aData[8], &pTrun
31df0 6b 2d 3e 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b k->aData[12], (k
31e00 2d 31 29 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 -1)*4);.
31e10 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e releasePage(pN
31e20 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
31e30 20 20 20 20 69 66 28 20 21 70 50 72 65 76 54 72 if( !pPrevTr
31e40 75 6e 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 unk ){.
31e50 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
31e60 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
31e70 6c 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 le(pPage1->pDbPa
31e80 67 65 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 ge) );.
31e90 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
31ea0 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 ge1->aData[32],
31eb0 69 4e 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 iNewTrunk);.
31ec0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
31ed0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 rc = sq
31ee0 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
31ef0 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 pPrevTrunk->pDbP
31f00 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
31f10 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
31f20 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 goto e
31f30 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 nd_allocate_page
31f40 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a ;. }.
31f50 20 20 20 20 20 20 20 20 20 20 20 20 70 75 74 34 put4
31f60 62 79 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b byte(&pPrevTrunk
31f70 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 ->aData[0], iNew
31f80 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 Trunk);.
31f90 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 }. }.
31fa0 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 pTrunk = 0
31fb0 3b 0a 20 20 20 20 20 20 20 20 54 52 41 43 45 28 ;. TRACE(
31fc0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 ("ALLOCATE: %d t
31fd0 72 75 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 runk - %d free p
31fe0 61 67 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 ages left\n", *p
31ff0 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e Pgno, n-1));.#en
32000 64 69 66 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 dif. }else
32010 69 66 28 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 if( k>0 ){.
32020 20 20 20 2f 2a 20 45 78 74 72 61 63 74 20 61 20 /* Extract a
32030 6c 65 61 66 20 66 72 6f 6d 20 74 68 65 20 74 72 leaf from the tr
32040 75 6e 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 unk */. u
32050 33 32 20 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 32 closest;.
32060 20 20 20 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a Pgno iPage;.
32070 20 20 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 unsigned
32080 20 63 68 61 72 20 2a 61 44 61 74 61 20 3d 20 70 char *aData = p
32090 54 72 75 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 Trunk->aData;.
320a0 20 20 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 if( nearby
320b0 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 >0 ){.
320c0 75 33 32 20 69 3b 0a 20 20 20 20 20 20 20 20 20 u32 i;.
320d0 20 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 closest = 0;.
320e0 20 20 20 20 20 20 20 20 69 66 28 20 65 4d 6f 64 if( eMod
320f0 65 3d 3d 42 54 41 4c 4c 4f 43 5f 4c 45 20 29 7b e==BTALLOC_LE ){
32100 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f 72 . for
32110 28 69 3d 30 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b (i=0; i<k; i++){
32120 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 . i
32130 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
32140 26 61 44 61 74 61 5b 38 2b 69 2a 34 5d 29 3b 0a &aData[8+i*4]);.
32150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 if
32160 28 20 69 50 61 67 65 3c 3d 6e 65 61 72 62 79 20 ( iPage<=nearby
32170 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
32180 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 3b 0a closest = i;.
32190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
321a0 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 break;.
321b0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
321c0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d }. }
321d0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
321e0 20 20 69 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 int dist;.
321f0 20 20 20 20 20 20 20 20 64 69 73 74 20 3d 20 73 dist = s
32200 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 67 qlite3AbsInt32(g
32210 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b 38 et4byte(&aData[8
32220 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a 20 20 ]) - nearby);.
32230 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
32240 31 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 1; i<k; i++){.
32250 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 int
32260 64 32 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 d2 = sqlite3AbsI
32270 6e 74 33 32 28 67 65 74 34 62 79 74 65 28 26 61 nt32(get4byte(&a
32280 44 61 74 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e Data[8+i*4]) - n
32290 65 61 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 earby);.
322a0 20 20 20 20 20 20 69 66 28 20 64 32 3c 64 69 73 if( d2<dis
322b0 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 t ){.
322c0 20 20 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 69 closest = i
322d0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;.
322e0 20 20 64 69 73 74 20 3d 20 64 32 3b 0a 20 20 20 dist = d2;.
322f0 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 }.
32300 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
32310 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
32320 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
32330 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a 20 20 20 closest = 0;.
32340 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 }..
32350 69 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 iPage = get4byte
32360 28 26 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 (&aData[8+closes
32370 74 2a 34 5d 29 3b 0a 20 20 20 20 20 20 20 20 74 t*4]);. t
32380 65 73 74 63 61 73 65 28 20 69 50 61 67 65 3d 3d estcase( iPage==
32390 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
323a0 20 20 69 66 28 20 69 50 61 67 65 3e 6d 78 50 61 if( iPage>mxPa
323b0 67 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ge ){.
323c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 rc = SQLITE_CORR
323d0 55 50 54 5f 50 47 4e 4f 28 69 54 72 75 6e 6b 29 UPT_PGNO(iTrunk)
323e0 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
323f0 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
32400 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ge;. }.
32410 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
32420 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b iPage==mxPage );
32430 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 73 65 . if( !se
32440 61 72 63 68 4c 69 73 74 20 0a 20 20 20 20 20 20 archList .
32450 20 20 20 7c 7c 20 28 69 50 61 67 65 3d 3d 6e 65 || (iPage==ne
32460 61 72 62 79 20 7c 7c 20 28 69 50 61 67 65 3c 6e arby || (iPage<n
32470 65 61 72 62 79 20 26 26 20 65 4d 6f 64 65 3d 3d earby && eMode==
32480 42 54 41 4c 4c 4f 43 5f 4c 45 29 29 20 0a 20 20 BTALLOC_LE)) .
32490 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
324a0 20 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e 74 int noContent
324b0 3b 0a 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 ;. *pPg
324c0 6e 6f 20 3d 20 69 50 61 67 65 3b 0a 20 20 20 20 no = iPage;.
324d0 20 20 20 20 20 20 54 52 41 43 45 28 28 22 41 4c TRACE(("AL
324e0 4c 4f 43 41 54 45 3a 20 25 64 20 77 61 73 20 6c LOCATE: %d was l
324f0 65 61 66 20 25 64 20 6f 66 20 25 64 20 6f 6e 20 eaf %d of %d on
32500 74 72 75 6e 6b 20 25 64 22 0a 20 20 20 20 20 20 trunk %d".
32510 20 20 20 20 20 20 20 20 20 20 20 22 3a 20 25 64 ": %d
32520 20 6d 6f 72 65 20 66 72 65 65 20 70 61 67 65 73 more free pages
32530 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
32540 20 20 20 20 20 20 2a 70 50 67 6e 6f 2c 20 63 6c *pPgno, cl
32550 6f 73 65 73 74 2b 31 2c 20 6b 2c 20 70 54 72 75 osest+1, k, pTru
32560 6e 6b 2d 3e 70 67 6e 6f 2c 20 6e 2d 31 29 29 3b nk->pgno, n-1));
32570 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
32580 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
32590 65 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 e(pTrunk->pDbPag
325a0 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 e);. if
325b0 28 20 72 63 20 29 20 67 6f 74 6f 20 65 6e 64 5f ( rc ) goto end_
325c0 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
325d0 20 20 20 20 20 20 20 20 20 69 66 28 20 63 6c 6f if( clo
325e0 73 65 73 74 3c 6b 2d 31 20 29 7b 0a 20 20 20 20 sest<k-1 ){.
325f0 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 memcpy(&
32600 61 44 61 74 61 5b 38 2b 63 6c 6f 73 65 73 74 2a aData[8+closest*
32610 34 5d 2c 20 26 61 44 61 74 61 5b 34 2b 6b 2a 34 4], &aData[4+k*4
32620 5d 2c 20 34 29 3b 0a 20 20 20 20 20 20 20 20 20 ], 4);.
32630 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 }. put
32640 34 62 79 74 65 28 26 61 44 61 74 61 5b 34 5d 2c 4byte(&aData[4],
32650 20 6b 2d 31 29 3b 0a 20 20 20 20 20 20 20 20 20 k-1);.
32660 20 6e 6f 43 6f 6e 74 65 6e 74 20 3d 20 21 62 74 noContent = !bt
32670 72 65 65 47 65 74 48 61 73 43 6f 6e 74 65 6e 74 reeGetHasContent
32680 28 70 42 74 2c 20 2a 70 50 67 6e 6f 29 3f 20 50 (pBt, *pPgno)? P
32690 41 47 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 AGER_GET_NOCONTE
326a0 4e 54 20 3a 20 30 3b 0a 20 20 20 20 20 20 20 20 NT : 0;.
326b0 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 55 rc = btreeGetU
326c0 6e 75 73 65 64 50 61 67 65 28 70 42 74 2c 20 2a nusedPage(pBt, *
326d0 70 50 67 6e 6f 2c 20 70 70 50 61 67 65 2c 20 6e pPgno, ppPage, n
326e0 6f 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 20 20 oContent);.
326f0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
32700 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
32710 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
32720 65 33 50 61 67 65 72 57 72 69 74 65 28 28 2a 70 e3PagerWrite((*p
32730 70 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 pPage)->pDbPage)
32740 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
32750 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
32760 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
32770 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 releasePage(*pp
32780 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
32790 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30 *ppPage = 0
327a0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a ;. }.
327b0 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
327c0 20 20 20 20 20 20 73 65 61 72 63 68 4c 69 73 74 searchList
327d0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a = 0;. }.
327e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 }. re
327f0 6c 65 61 73 65 50 61 67 65 28 70 50 72 65 76 54 leasePage(pPrevT
32800 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 70 50 72 runk);. pPr
32810 65 76 54 72 75 6e 6b 20 3d 20 30 3b 0a 20 20 20 evTrunk = 0;.
32820 20 7d 77 68 69 6c 65 28 20 73 65 61 72 63 68 4c }while( searchL
32830 69 73 74 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a ist );. }else{.
32840 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 72 65 /* There are
32850 20 6e 6f 20 70 61 67 65 73 20 6f 6e 20 74 68 65 no pages on the
32860 20 66 72 65 65 6c 69 73 74 2c 20 73 6f 20 61 70 freelist, so ap
32870 70 65 6e 64 20 61 20 6e 65 77 20 70 61 67 65 20 pend a new page
32880 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 to the. ** da
32890 74 61 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 20 tabase image..
328a0 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 72 6d **. ** Norm
328b0 61 6c 6c 79 2c 20 6e 65 77 20 70 61 67 65 73 20 ally, new pages
328c0 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 74 68 69 allocated by thi
328d0 73 20 62 6c 6f 63 6b 20 63 61 6e 20 62 65 20 72 s block can be r
328e0 65 71 75 65 73 74 65 64 20 66 72 6f 6d 20 74 68 equested from th
328f0 65 0a 20 20 20 20 2a 2a 20 70 61 67 65 72 20 6c e. ** pager l
32900 61 79 65 72 20 77 69 74 68 20 74 68 65 20 27 6e ayer with the 'n
32910 6f 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 61 67 20 o-content' flag
32920 73 65 74 2e 20 54 68 69 73 20 70 72 65 76 65 6e set. This preven
32930 74 73 20 74 68 65 20 70 61 67 65 72 0a 20 20 20 ts the pager.
32940 20 2a 2a 20 66 72 6f 6d 20 74 72 79 69 6e 67 20 ** from trying
32950 74 6f 20 72 65 61 64 20 74 68 65 20 70 61 67 65 to read the page
32960 73 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 s content from d
32970 69 73 6b 2e 20 48 6f 77 65 76 65 72 2c 20 69 66 isk. However, if
32980 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 75 72 72 the. ** curr
32990 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ent transaction
329a0 68 61 73 20 61 6c 72 65 61 64 79 20 72 75 6e 20 has already run
329b0 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 69 6e 63 72 one or more incr
329c0 65 6d 65 6e 74 61 6c 2d 76 61 63 75 75 6d 0a 20 emental-vacuum.
329d0 20 20 20 2a 2a 20 73 74 65 70 73 2c 20 74 68 65 ** steps, the
329e0 6e 20 74 68 65 20 70 61 67 65 20 77 65 20 61 72 n the page we ar
329f0 65 20 61 62 6f 75 74 20 74 6f 20 61 6c 6c 6f 63 e about to alloc
32a00 61 74 65 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 ate may contain
32a10 63 6f 6e 74 65 6e 74 0a 20 20 20 20 2a 2a 20 74 content. ** t
32a20 68 61 74 20 69 73 20 72 65 71 75 69 72 65 64 20 hat is required
32a30 69 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 20 in the event of
32a40 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 6e 20 74 a rollback. In t
32a50 68 69 73 20 63 61 73 65 2c 20 64 6f 0a 20 20 20 his case, do.
32a60 20 2a 2a 20 6e 6f 74 20 73 65 74 20 74 68 65 20 ** not set the
32a70 6e 6f 2d 63 6f 6e 74 65 6e 74 20 66 6c 61 67 2e no-content flag.
32a80 20 54 68 69 73 20 63 61 75 73 65 73 20 74 68 65 This causes the
32a90 20 70 61 67 65 72 20 74 6f 20 6c 6f 61 64 20 61 pager to load a
32aa0 6e 64 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a nd journal. *
32ab0 2a 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 * the current pa
32ac0 67 65 20 63 6f 6e 74 65 6e 74 20 62 65 66 6f 72 ge content befor
32ad0 65 20 6f 76 65 72 77 72 69 74 69 6e 67 20 69 74 e overwriting it
32ae0 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
32af0 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 70 61 Note that the pa
32b00 67 65 72 20 77 69 6c 6c 20 6e 6f 74 20 61 63 74 ger will not act
32b10 75 61 6c 6c 79 20 61 74 74 65 6d 70 74 20 74 6f ually attempt to
32b20 20 6c 6f 61 64 20 6f 72 20 6a 6f 75 72 6e 61 6c load or journal
32b30 20 0a 20 20 20 20 2a 2a 20 63 6f 6e 74 65 6e 74 . ** content
32b40 20 66 6f 72 20 61 6e 79 20 70 61 67 65 20 74 68 for any page th
32b50 61 74 20 72 65 61 6c 6c 79 20 64 6f 65 73 20 6c at really does l
32b60 69 65 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 ie past the end
32b70 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a of the database.
32b80 20 20 20 20 2a 2a 20 66 69 6c 65 20 6f 6e 20 64 ** file on d
32b90 69 73 6b 2e 20 53 6f 20 74 68 65 20 65 66 66 65 isk. So the effe
32ba0 63 74 73 20 6f 66 20 64 69 73 61 62 6c 69 6e 67 cts of disabling
32bb0 20 74 68 65 20 6e 6f 2d 63 6f 6e 74 65 6e 74 20 the no-content
32bc0 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 0a 20 20 20 optimization.
32bd0 20 2a 2a 20 68 65 72 65 20 61 72 65 20 63 6f 6e ** here are con
32be0 66 69 6e 65 64 20 74 6f 20 74 68 6f 73 65 20 70 fined to those p
32bf0 61 67 65 73 20 74 68 61 74 20 6c 69 65 20 62 65 ages that lie be
32c00 74 77 65 65 6e 20 74 68 65 20 65 6e 64 20 6f 66 tween the end of
32c10 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 the. ** data
32c20 62 61 73 65 20 69 6d 61 67 65 20 61 6e 64 20 74 base image and t
32c30 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 he end of the da
32c40 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 tabase file..
32c50 20 2a 2f 0a 20 20 20 20 69 6e 74 20 62 4e 6f 43 */. int bNoC
32c60 6f 6e 74 65 6e 74 20 3d 20 28 30 3d 3d 49 66 4e ontent = (0==IfN
32c70 6f 74 4f 6d 69 74 41 56 28 70 42 74 2d 3e 62 44 otOmitAV(pBt->bD
32c80 6f 54 72 75 6e 63 61 74 65 29 29 3f 20 50 41 47 oTruncate))? PAG
32c90 45 52 5f 47 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 ER_GET_NOCONTENT
32ca0 3a 30 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73 71 :0;.. rc = sq
32cb0 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
32cc0 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 70 44 62 pBt->pPage1->pDb
32cd0 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 Page);. if( r
32ce0 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
32cf0 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b pBt->nPage++;
32d00 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 . if( pBt->nP
32d10 61 67 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 age==PENDING_BYT
32d20 45 5f 50 41 47 45 28 70 42 74 29 20 29 20 70 42 E_PAGE(pBt) ) pB
32d30 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 0a 23 69 66 t->nPage++;..#if
32d40 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
32d50 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 _AUTOVACUUM.
32d60 69 66 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 if( pBt->autoVac
32d70 75 75 6d 20 26 26 20 50 54 52 4d 41 50 5f 49 53 uum && PTRMAP_IS
32d80 50 41 47 45 28 70 42 74 2c 20 70 42 74 2d 3e 6e PAGE(pBt, pBt->n
32d90 50 61 67 65 29 20 29 7b 0a 20 20 20 20 20 20 2f Page) ){. /
32da0 2a 20 49 66 20 2a 70 50 67 6e 6f 20 72 65 66 65 * If *pPgno refe
32db0 72 73 20 74 6f 20 61 20 70 6f 69 6e 74 65 72 2d rs to a pointer-
32dc0 6d 61 70 20 70 61 67 65 2c 20 61 6c 6c 6f 63 61 map page, alloca
32dd0 74 65 20 74 77 6f 20 6e 65 77 20 70 61 67 65 73 te two new pages
32de0 0a 20 20 20 20 20 20 2a 2a 20 61 74 20 74 68 65 . ** at the
32df0 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 end of the file
32e00 20 69 6e 73 74 65 61 64 20 6f 66 20 6f 6e 65 2e instead of one.
32e10 20 54 68 65 20 66 69 72 73 74 20 61 6c 6c 6f 63 The first alloc
32e20 61 74 65 64 20 70 61 67 65 0a 20 20 20 20 20 20 ated page.
32e30 2a 2a 20 62 65 63 6f 6d 65 73 20 61 20 6e 65 77 ** becomes a new
32e40 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 pointer-map pag
32e50 65 2c 20 74 68 65 20 73 65 63 6f 6e 64 20 69 73 e, the second is
32e60 20 75 73 65 64 20 62 79 20 74 68 65 20 63 61 6c used by the cal
32e70 6c 65 72 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ler.. */.
32e80 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 67 MemPage *pPg
32e90 20 3d 20 30 3b 0a 20 20 20 20 20 20 54 52 41 43 = 0;. TRAC
32ea0 45 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 E(("ALLOCATE: %d
32eb0 20 66 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c from end of fil
32ec0 65 20 28 70 6f 69 6e 74 65 72 2d 6d 61 70 20 70 e (pointer-map p
32ed0 61 67 65 29 5c 6e 22 2c 20 70 42 74 2d 3e 6e 50 age)\n", pBt->nP
32ee0 61 67 65 29 29 3b 0a 20 20 20 20 20 20 61 73 73 age));. ass
32ef0 65 72 74 28 20 70 42 74 2d 3e 6e 50 61 67 65 21 ert( pBt->nPage!
32f00 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 =PENDING_BYTE_PA
32f10 47 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 20 GE(pBt) );.
32f20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 55 6e rc = btreeGetUn
32f30 75 73 65 64 50 61 67 65 28 70 42 74 2c 20 70 42 usedPage(pBt, pB
32f40 74 2d 3e 6e 50 61 67 65 2c 20 26 70 50 67 2c 20 t->nPage, &pPg,
32f50 62 4e 6f 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 20 bNoContent);.
32f60 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
32f70 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
32f80 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
32f90 72 57 72 69 74 65 28 70 50 67 2d 3e 70 44 62 50 rWrite(pPg->pDbP
32fa0 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 72 65 age);. re
32fb0 6c 65 61 73 65 50 61 67 65 28 70 50 67 29 3b 0a leasePage(pPg);.
32fc0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
32fd0 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
32fe0 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 ;. pBt->nPa
32ff0 67 65 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 ge++;. if(
33000 70 42 74 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 pBt->nPage==PEND
33010 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 ING_BYTE_PAGE(pB
33020 74 29 20 29 7b 20 70 42 74 2d 3e 6e 50 61 67 65 t) ){ pBt->nPage
33030 2b 2b 3b 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 ++; }. }.#end
33040 69 66 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 if. put4byte(
33050 32 38 20 2b 20 28 75 38 2a 29 70 42 74 2d 3e 70 28 + (u8*)pBt->p
33060 50 61 67 65 31 2d 3e 61 44 61 74 61 2c 20 70 42 Page1->aData, pB
33070 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 20 2a t->nPage);. *
33080 70 50 67 6e 6f 20 3d 20 70 42 74 2d 3e 6e 50 61 pPgno = pBt->nPa
33090 67 65 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 28 ge;.. assert(
330a0 20 2a 70 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 *pPgno!=PENDING
330b0 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 _BYTE_PAGE(pBt)
330c0 29 3b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 65 );. rc = btre
330d0 65 47 65 74 55 6e 75 73 65 64 50 61 67 65 28 70 eGetUnusedPage(p
330e0 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 50 61 Bt, *pPgno, ppPa
330f0 67 65 2c 20 62 4e 6f 43 6f 6e 74 65 6e 74 29 3b ge, bNoContent);
33100 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
33110 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 72 63 20 turn rc;. rc
33120 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
33130 69 74 65 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 ite((*ppPage)->p
33140 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 66 28 DbPage);. if(
33150 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
33160 7b 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 {. releaseP
33170 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 age(*ppPage);.
33180 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b *ppPage = 0;
33190 0a 20 20 20 20 7d 0a 20 20 20 20 54 52 41 43 45 . }. TRACE
331a0 28 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 (("ALLOCATE: %d
331b0 66 72 6f 6d 20 65 6e 64 20 6f 66 20 66 69 6c 65 from end of file
331c0 5c 6e 22 2c 20 2a 70 50 67 6e 6f 29 29 3b 0a 20 \n", *pPgno));.
331d0 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 2a 70 }.. assert( *p
331e0 50 67 6e 6f 21 3d 50 45 4e 44 49 4e 47 5f 42 59 Pgno!=PENDING_BY
331f0 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b 0a TE_PAGE(pBt) );.
33200 0a 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 .end_allocate_pa
33210 67 65 3a 0a 20 20 72 65 6c 65 61 73 65 50 61 67 ge:. releasePag
33220 65 28 70 54 72 75 6e 6b 29 3b 0a 20 20 72 65 6c e(pTrunk);. rel
33230 65 61 73 65 50 61 67 65 28 70 50 72 65 76 54 72 easePage(pPrevTr
33240 75 6e 6b 29 3b 0a 20 20 61 73 73 65 72 74 28 20 unk);. assert(
33250 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc!=SQLITE_OK ||
33260 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
33270 65 52 65 66 63 6f 75 6e 74 28 28 2a 70 70 50 61 eRefcount((*ppPa
33280 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3c 3d 31 ge)->pDbPage)<=1
33290 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 );. assert( rc
332a0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 !=SQLITE_OK || (
332b0 2a 70 70 50 61 67 65 29 2d 3e 69 73 49 6e 69 74 *ppPage)->isInit
332c0 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 ==0 );. return
332d0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 rc;.}../*.** Thi
332e0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 s function is us
332f0 65 64 20 74 6f 20 61 64 64 20 70 61 67 65 20 69 ed to add page i
33300 50 61 67 65 20 74 6f 20 74 68 65 20 64 61 74 61 Page to the data
33310 62 61 73 65 20 66 69 6c 65 20 66 72 65 65 2d 6c base file free-l
33320 69 73 74 2e 20 0a 2a 2a 20 49 74 20 69 73 20 61 ist. .** It is a
33330 73 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 20 ssumed that the
33340 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 page is not alre
33350 61 64 79 20 61 20 70 61 72 74 20 6f 66 20 74 68 ady a part of th
33360 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a e free-list..**.
33370 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 70 61 73 ** The value pas
33380 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e sed as the secon
33390 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 d argument to th
333a0 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f is function is o
333b0 70 74 69 6f 6e 61 6c 2e 0a 2a 2a 20 49 66 20 74 ptional..** If t
333c0 68 65 20 63 61 6c 6c 65 72 20 68 61 70 70 65 6e he caller happen
333d0 73 20 74 6f 20 68 61 76 65 20 61 20 70 6f 69 6e s to have a poin
333e0 74 65 72 20 74 6f 20 74 68 65 20 4d 65 6d 50 61 ter to the MemPa
333f0 67 65 20 6f 62 6a 65 63 74 20 0a 2a 2a 20 63 6f ge object .** co
33400 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 70 rresponding to p
33410 61 67 65 20 69 50 61 67 65 20 68 61 6e 64 79 2c age iPage handy,
33420 20 69 74 20 6d 61 79 20 70 61 73 73 20 69 74 20 it may pass it
33430 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 76 61 as the second va
33440 6c 75 65 2e 20 0a 2a 2a 20 4f 74 68 65 72 77 69 lue. .** Otherwi
33450 73 65 2c 20 69 74 20 6d 61 79 20 70 61 73 73 20 se, it may pass
33460 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 NULL..**.** If a
33470 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 4d 65 pointer to a Me
33480 6d 50 61 67 65 20 6f 62 6a 65 63 74 20 69 73 20 mPage object is
33490 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65 passed as the se
334a0 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2c 0a 2a cond argument,.*
334b0 2a 20 69 74 73 20 72 65 66 65 72 65 6e 63 65 20 * its reference
334c0 63 6f 75 6e 74 20 69 73 20 6e 6f 74 20 61 6c 74 count is not alt
334d0 65 72 65 64 20 62 79 20 74 68 69 73 20 66 75 6e ered by this fun
334e0 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ction..*/.static
334f0 20 69 6e 74 20 66 72 65 65 50 61 67 65 32 28 42 int freePage2(B
33500 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 4d 65 tShared *pBt, Me
33510 6d 50 61 67 65 20 2a 70 4d 65 6d 50 61 67 65 2c mPage *pMemPage,
33520 20 50 67 6e 6f 20 69 50 61 67 65 29 7b 0a 20 20 Pgno iPage){.
33530 4d 65 6d 50 61 67 65 20 2a 70 54 72 75 6e 6b 20 MemPage *pTrunk
33540 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 0;
33550 20 20 20 20 2f 2a 20 46 72 65 65 2d 6c 69 73 74 /* Free-list
33560 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a 20 trunk page */.
33570 20 50 67 6e 6f 20 69 54 72 75 6e 6b 20 3d 20 30 Pgno iTrunk = 0
33580 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
33590 20 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d /* Page num
335a0 62 65 72 20 6f 66 20 66 72 65 65 2d 6c 69 73 74 ber of free-list
335b0 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 20 0a trunk page */ .
335c0 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
335d0 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 1 = pBt->pPage1;
335e0 20 20 20 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 72 /* Local r
335f0 65 66 65 72 65 6e 63 65 20 74 6f 20 70 61 67 65 eference to page
33600 20 31 20 2a 2f 0a 20 20 4d 65 6d 50 61 67 65 20 1 */. MemPage
33610 2a 70 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 *pPage;
33620 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
33630 61 67 65 20 62 65 69 6e 67 20 66 72 65 65 64 2e age being freed.
33640 20 4d 61 79 20 62 65 20 4e 55 4c 4c 2e 20 2a 2f May be NULL. */
33650 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
33660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
33670 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
33680 20 43 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 6e Code */. int n
33690 46 72 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 Free;
336a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
336b0 2a 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 72 * Initial number
336c0 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 66 72 65 of pages on fre
336d0 65 2d 6c 69 73 74 20 2a 2f 0a 0a 20 20 61 73 73 e-list */.. ass
336e0 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
336f0 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
33700 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
33710 20 43 4f 52 52 55 50 54 5f 44 42 20 7c 7c 20 69 CORRUPT_DB || i
33720 50 61 67 65 3e 31 20 29 3b 0a 20 20 61 73 73 65 Page>1 );. asse
33730 72 74 28 20 21 70 4d 65 6d 50 61 67 65 20 7c 7c rt( !pMemPage ||
33740 20 70 4d 65 6d 50 61 67 65 2d 3e 70 67 6e 6f 3d pMemPage->pgno=
33750 3d 69 50 61 67 65 20 29 3b 0a 0a 20 20 69 66 28 =iPage );.. if(
33760 20 69 50 61 67 65 3c 32 20 29 20 72 65 74 75 72 iPage<2 ) retur
33770 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
33780 5f 42 4b 50 54 3b 0a 20 20 69 66 28 20 70 4d 65 _BKPT;. if( pMe
33790 6d 50 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 mPage ){. pPa
337a0 67 65 20 3d 20 70 4d 65 6d 50 61 67 65 3b 0a 20 ge = pMemPage;.
337b0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 sqlite3PagerR
337c0 65 66 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 ef(pPage->pDbPag
337d0 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 e);. }else{.
337e0 20 70 50 61 67 65 20 3d 20 62 74 72 65 65 50 61 pPage = btreePa
337f0 67 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 69 50 geLookup(pBt, iP
33800 61 67 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 age);. }.. /*
33810 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 Increment the fr
33820 65 65 20 70 61 67 65 20 63 6f 75 6e 74 20 6f 6e ee page count on
33830 20 70 50 61 67 65 31 20 2a 2f 0a 20 20 72 63 20 pPage1 */. rc
33840 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
33850 69 74 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 ite(pPage1->pDbP
33860 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 20 29 age);. if( rc )
33870 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
33880 75 74 3b 0a 20 20 6e 46 72 65 65 20 3d 20 67 65 ut;. nFree = ge
33890 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
338a0 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 70 75 aData[36]);. pu
338b0 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
338c0 61 44 61 74 61 5b 33 36 5d 2c 20 6e 46 72 65 65 aData[36], nFree
338d0 2b 31 29 3b 0a 0a 20 20 69 66 28 20 70 42 74 2d +1);.. if( pBt-
338e0 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f >btsFlags & BTS_
338f0 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 7b SECURE_DELETE ){
33900 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 73 . /* If the s
33910 65 63 75 72 65 5f 64 65 6c 65 74 65 20 6f 70 74 ecure_delete opt
33920 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 ion is enabled,
33930 74 68 65 6e 0a 20 20 20 20 2a 2a 20 61 6c 77 61 then. ** alwa
33940 79 73 20 66 75 6c 6c 79 20 6f 76 65 72 77 72 69 ys fully overwri
33950 74 65 20 64 65 6c 65 74 65 64 20 69 6e 66 6f 72 te deleted infor
33960 6d 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 72 6f mation with zero
33970 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 s.. */. if
33980 28 20 28 21 70 50 61 67 65 20 26 26 20 28 28 72 ( (!pPage && ((r
33990 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 c = btreeGetPage
339a0 28 70 42 74 2c 20 69 50 61 67 65 2c 20 26 70 50 (pBt, iPage, &pP
339b0 61 67 65 2c 20 30 29 29 21 3d 30 29 20 29 0a 20 age, 0))!=0) ).
339c0 20 20 20 20 7c 7c 20 20 20 20 20 20 20 20 20 20 ||
339d0 20 20 28 28 72 63 20 3d 20 73 71 6c 69 74 65 33 ((rc = sqlite3
339e0 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 PagerWrite(pPage
339f0 2d 3e 70 44 62 50 61 67 65 29 29 21 3d 30 29 0a ->pDbPage))!=0).
33a00 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 ){. got
33a10 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
33a20 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 }. memset
33a30 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 30 (pPage->aData, 0
33a40 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 70 61 , pPage->pBt->pa
33a50 67 65 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 geSize);. }..
33a60 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 /* If the databa
33a70 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 6f se supports auto
33a80 2d 76 61 63 75 75 6d 2c 20 77 72 69 74 65 20 61 -vacuum, write a
33a90 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 70 n entry in the p
33aa0 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 2a 2a 20 ointer-map. **
33ab0 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 to indicate that
33ac0 20 74 68 65 20 70 61 67 65 20 69 73 20 66 72 65 the page is fre
33ad0 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 49 53 e.. */. if( IS
33ae0 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 20 AUTOVACUUM ){.
33af0 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 2c ptrmapPut(pBt,
33b00 20 69 50 61 67 65 2c 20 50 54 52 4d 41 50 5f 46 iPage, PTRMAP_F
33b10 52 45 45 50 41 47 45 2c 20 30 2c 20 26 72 63 29 REEPAGE, 0, &rc)
33b20 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 67 ;. if( rc ) g
33b30 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
33b40 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 ;. }.. /* Now
33b50 6d 61 6e 69 70 75 6c 61 74 65 20 74 68 65 20 61 manipulate the a
33b60 63 74 75 61 6c 20 64 61 74 61 62 61 73 65 20 66 ctual database f
33b70 72 65 65 2d 6c 69 73 74 20 73 74 72 75 63 74 75 ree-list structu
33b80 72 65 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 re. There are tw
33b90 6f 0a 20 20 2a 2a 20 70 6f 73 73 69 62 69 6c 69 o. ** possibili
33ba0 74 69 65 73 2e 20 49 66 20 74 68 65 20 66 72 65 ties. If the fre
33bb0 65 2d 6c 69 73 74 20 69 73 20 63 75 72 72 65 6e e-list is curren
33bc0 74 6c 79 20 65 6d 70 74 79 2c 20 6f 72 20 69 66 tly empty, or if
33bd0 20 74 68 65 20 66 69 72 73 74 0a 20 20 2a 2a 20 the first. **
33be0 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 74 68 trunk page in th
33bf0 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 20 66 e free-list is f
33c00 75 6c 6c 2c 20 74 68 65 6e 20 74 68 69 73 20 70 ull, then this p
33c10 61 67 65 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 age will become
33c20 61 0a 20 20 2a 2a 20 6e 65 77 20 66 72 65 65 2d a. ** new free-
33c30 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 2e list trunk page.
33c40 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 77 Otherwise, it w
33c50 69 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6c 65 61 ill become a lea
33c60 66 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 66 69 f of the. ** fi
33c70 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 rst trunk page i
33c80 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 66 72 n the current fr
33c90 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 62 6c ee-list. This bl
33ca0 6f 63 6b 20 74 65 73 74 73 20 69 66 20 69 74 0a ock tests if it.
33cb0 20 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 6c 65 ** is possible
33cc0 20 74 6f 20 61 64 64 20 74 68 65 20 70 61 67 65 to add the page
33cd0 20 61 73 20 61 20 6e 65 77 20 66 72 65 65 2d 6c as a new free-l
33ce0 69 73 74 20 6c 65 61 66 2e 0a 20 20 2a 2f 0a 20 ist leaf.. */.
33cf0 20 69 66 28 20 6e 46 72 65 65 21 3d 30 20 29 7b if( nFree!=0 ){
33d00 0a 20 20 20 20 75 33 32 20 6e 4c 65 61 66 3b 20 . u32 nLeaf;
33d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
33d20 2a 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 65 72 * Initial number
33d30 20 6f 66 20 6c 65 61 66 20 63 65 6c 6c 73 20 6f of leaf cells o
33d40 6e 20 74 72 75 6e 6b 20 70 61 67 65 20 2a 2f 0a n trunk page */.
33d50 0a 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 67 65 . iTrunk = ge
33d60 74 34 62 79 74 65 28 26 70 50 61 67 65 31 2d 3e t4byte(&pPage1->
33d70 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 20 20 aData[32]);.
33d80 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
33d90 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c 20 26 e(pBt, iTrunk, &
33da0 70 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 pTrunk, 0);.
33db0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
33dc0 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 K ){. goto
33dd0 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 freepage_out;.
33de0 20 20 7d 0a 0a 20 20 20 20 6e 4c 65 61 66 20 3d }.. nLeaf =
33df0 20 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e get4byte(&pTrun
33e00 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a 20 20 k->aData[4]);.
33e10 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 75 assert( pBt->u
33e20 73 61 62 6c 65 53 69 7a 65 3e 33 32 20 29 3b 0a sableSize>32 );.
33e30 20 20 20 20 69 66 28 20 6e 4c 65 61 66 20 3e 20 if( nLeaf >
33e40 28 75 33 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 (u32)pBt->usable
33e50 53 69 7a 65 2f 34 20 2d 20 32 20 29 7b 0a 20 20 Size/4 - 2 ){.
33e60 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
33e70 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
33e80 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 goto freepag
33e90 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 e_out;. }.
33ea0 20 69 66 28 20 6e 4c 65 61 66 20 3c 20 28 75 33 if( nLeaf < (u3
33eb0 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 2)pBt->usableSiz
33ec0 65 2f 34 20 2d 20 38 20 29 7b 0a 20 20 20 20 20 e/4 - 8 ){.
33ed0 20 2f 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 /* In this case
33ee0 20 74 68 65 72 65 20 69 73 20 72 6f 6f 6d 20 6f there is room o
33ef0 6e 20 74 68 65 20 74 72 75 6e 6b 20 70 61 67 65 n the trunk page
33f00 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 20 70 to insert the p
33f10 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 65 69 age. ** bei
33f20 6e 67 20 66 72 65 65 64 20 61 73 20 61 20 6e 65 ng freed as a ne
33f30 77 20 6c 65 61 66 2e 0a 20 20 20 20 20 20 2a 2a w leaf.. **
33f40 0a 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 . ** Note t
33f50 68 61 74 20 74 68 65 20 74 72 75 6e 6b 20 70 61 hat the trunk pa
33f60 67 65 20 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 ge is not really
33f70 20 66 75 6c 6c 20 75 6e 74 69 6c 20 69 74 20 63 full until it c
33f80 6f 6e 74 61 69 6e 73 0a 20 20 20 20 20 20 2a 2a ontains. **
33f90 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 usableSize/4 -
33fa0 32 20 65 6e 74 72 69 65 73 2c 20 6e 6f 74 20 75 2 entries, not u
33fb0 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 sableSize/4 - 8
33fc0 65 6e 74 72 69 65 73 20 61 73 20 77 65 20 68 61 entries as we ha
33fd0 76 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f 64 65 ve. ** code
33fe0 64 2e 20 20 42 75 74 20 64 75 65 20 74 6f 20 61 d. But due to a
33ff0 20 63 6f 64 69 6e 67 20 65 72 72 6f 72 20 69 6e coding error in
34000 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
34010 69 74 65 20 70 72 69 6f 72 20 74 6f 0a 20 20 20 ite prior to.
34020 20 20 20 2a 2a 20 33 2e 36 2e 30 2c 20 64 61 74 ** 3.6.0, dat
34030 61 62 61 73 65 73 20 77 69 74 68 20 66 72 65 65 abases with free
34040 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 65 73 list trunk pages
34050 20 68 6f 6c 64 69 6e 67 20 6d 6f 72 65 20 74 68 holding more th
34060 61 6e 0a 20 20 20 20 20 20 2a 2a 20 75 73 61 62 an. ** usab
34070 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 6e 74 leSize/4 - 8 ent
34080 72 69 65 73 20 77 69 6c 6c 20 62 65 20 72 65 70 ries will be rep
34090 6f 72 74 65 64 20 61 73 20 63 6f 72 72 75 70 74 orted as corrupt
340a0 2e 20 20 49 6e 20 6f 72 64 65 72 0a 20 20 20 20 . In order.
340b0 20 20 2a 2a 20 74 6f 20 6d 61 69 6e 74 61 69 6e ** to maintain
340c0 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 backwards compa
340d0 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 6f 6c tibility with ol
340e0 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 der versions of
340f0 53 51 4c 69 74 65 2c 0a 20 20 20 20 20 20 2a 2a SQLite,. **
34100 20 77 65 20 77 69 6c 6c 20 63 6f 6e 74 69 6e 75 we will continu
34110 65 20 74 6f 20 72 65 73 74 72 69 63 74 20 74 68 e to restrict th
34120 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 e number of entr
34130 69 65 73 20 74 6f 20 75 73 61 62 6c 65 53 69 7a ies to usableSiz
34140 65 2f 34 20 2d 20 38 0a 20 20 20 20 20 20 2a 2a e/4 - 8. **
34150 20 66 6f 72 20 6e 6f 77 2e 20 20 41 74 20 73 6f for now. At so
34160 6d 65 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 me point in the
34170 66 75 74 75 72 65 20 28 6f 6e 63 65 20 65 76 65 future (once eve
34180 72 79 6f 6e 65 20 68 61 73 20 75 70 67 72 61 64 ryone has upgrad
34190 65 64 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 33 ed. ** to 3
341a0 2e 36 2e 30 20 6f 72 20 6c 61 74 65 72 29 20 77 .6.0 or later) w
341b0 65 20 73 68 6f 75 6c 64 20 63 6f 6e 73 69 64 65 e should conside
341c0 72 20 66 69 78 69 6e 67 20 74 68 65 20 63 6f 6e r fixing the con
341d0 64 69 74 69 6f 6e 61 6c 20 61 62 6f 76 65 0a 20 ditional above.
341e0 20 20 20 20 20 2a 2a 20 74 6f 20 72 65 61 64 20 ** to read
341f0 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d 32 22 "usableSize/4-2"
34200 20 69 6e 73 74 65 61 64 20 6f 66 20 22 75 73 61 instead of "usa
34210 62 6c 65 53 69 7a 65 2f 34 2d 38 22 2e 0a 20 20 bleSize/4-8"..
34220 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 **. **
34230 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 EVIDENCE-OF: R-1
34240 39 39 32 30 2d 31 31 35 37 36 20 48 6f 77 65 76 9920-11576 Howev
34250 65 72 2c 20 6e 65 77 65 72 20 76 65 72 73 69 6f er, newer versio
34260 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 73 74 69 ns of SQLite sti
34270 6c 6c 0a 20 20 20 20 20 20 2a 2a 20 61 76 6f 69 ll. ** avoi
34280 64 20 75 73 69 6e 67 20 74 68 65 20 6c 61 73 74 d using the last
34290 20 73 69 78 20 65 6e 74 72 69 65 73 20 69 6e 20 six entries in
342a0 74 68 65 20 66 72 65 65 6c 69 73 74 20 74 72 75 the freelist tru
342b0 6e 6b 20 70 61 67 65 20 61 72 72 61 79 20 69 6e nk page array in
342c0 0a 20 20 20 20 20 20 2a 2a 20 6f 72 64 65 72 20 . ** order
342d0 74 68 61 74 20 64 61 74 61 62 61 73 65 20 66 69 that database fi
342e0 6c 65 73 20 63 72 65 61 74 65 64 20 62 79 20 6e les created by n
342f0 65 77 65 72 20 76 65 72 73 69 6f 6e 73 20 6f 66 ewer versions of
34300 20 53 51 4c 69 74 65 20 63 61 6e 20 62 65 0a 20 SQLite can be.
34310 20 20 20 20 20 2a 2a 20 72 65 61 64 20 62 79 20 ** read by
34320 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f older versions o
34330 66 20 53 51 4c 69 74 65 2e 0a 20 20 20 20 20 20 f SQLite..
34340 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 */. rc = sq
34350 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
34360 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 pTrunk->pDbPage)
34370 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
34380 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
34390 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 put4byte(&p
343a0 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 2c Trunk->aData[4],
343b0 20 6e 4c 65 61 66 2b 31 29 3b 0a 20 20 20 20 20 nLeaf+1);.
343c0 20 20 20 70 75 74 34 62 79 74 65 28 26 70 54 72 put4byte(&pTr
343d0 75 6e 6b 2d 3e 61 44 61 74 61 5b 38 2b 6e 4c 65 unk->aData[8+nLe
343e0 61 66 2a 34 5d 2c 20 69 50 61 67 65 29 3b 0a 20 af*4], iPage);.
343f0 20 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 if( pPage
34400 20 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 && (pBt->btsFla
34410 67 73 20 26 20 42 54 53 5f 53 45 43 55 52 45 5f gs & BTS_SECURE_
34420 44 45 4c 45 54 45 29 3d 3d 30 20 29 7b 0a 20 20 DELETE)==0 ){.
34430 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 sqlite3P
34440 61 67 65 72 44 6f 6e 74 57 72 69 74 65 28 70 50 agerDontWrite(pP
34450 61 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 age->pDbPage);.
34460 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
34470 20 72 63 20 3d 20 62 74 72 65 65 53 65 74 48 61 rc = btreeSetHa
34480 73 43 6f 6e 74 65 6e 74 28 70 42 74 2c 20 69 50 sContent(pBt, iP
34490 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 age);. }.
344a0 20 20 20 20 54 52 41 43 45 28 28 22 46 52 45 45 TRACE(("FREE
344b0 2d 50 41 47 45 3a 20 25 64 20 6c 65 61 66 20 6f -PAGE: %d leaf o
344c0 6e 20 74 72 75 6e 6b 20 70 61 67 65 20 25 64 5c n trunk page %d\
344d0 6e 22 2c 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 70 n",pPage->pgno,p
344e0 54 72 75 6e 6b 2d 3e 70 67 6e 6f 29 29 3b 0a 20 Trunk->pgno));.
344f0 20 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 goto freepa
34500 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 ge_out;. }.
34510 7d 0a 0a 20 20 2f 2a 20 49 66 20 63 6f 6e 74 72 }.. /* If contr
34520 6f 6c 20 66 6c 6f 77 73 20 74 6f 20 74 68 69 73 ol flows to this
34530 20 70 6f 69 6e 74 2c 20 74 68 65 6e 20 69 74 20 point, then it
34540 77 61 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 was not possible
34550 20 74 6f 20 61 64 64 20 74 68 65 0a 20 20 2a 2a to add the. **
34560 20 74 68 65 20 70 61 67 65 20 62 65 69 6e 67 20 the page being
34570 66 72 65 65 64 20 61 73 20 61 20 6c 65 61 66 20 freed as a leaf
34580 70 61 67 65 20 6f 66 20 74 68 65 20 66 69 72 73 page of the firs
34590 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 20 66 t trunk in the f
345a0 72 65 65 2d 6c 69 73 74 2e 0a 20 20 2a 2a 20 50 ree-list.. ** P
345b0 6f 73 73 69 62 6c 79 20 62 65 63 61 75 73 65 20 ossibly because
345c0 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 the free-list is
345d0 20 65 6d 70 74 79 2c 20 6f 72 20 70 6f 73 73 69 empty, or possi
345e0 62 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20 bly because the
345f0 0a 20 20 2a 2a 20 66 69 72 73 74 20 74 72 75 6e . ** first trun
34600 6b 20 69 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 k in the free-li
34610 73 74 20 69 73 20 66 75 6c 6c 2e 20 45 69 74 68 st is full. Eith
34620 65 72 20 77 61 79 2c 20 74 68 65 20 70 61 67 65 er way, the page
34630 20 62 65 69 6e 67 20 66 72 65 65 64 0a 20 20 2a being freed. *
34640 2a 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 * will become th
34650 65 20 6e 65 77 20 66 69 72 73 74 20 74 72 75 6e e new first trun
34660 6b 20 70 61 67 65 20 69 6e 20 74 68 65 20 66 72 k page in the fr
34670 65 65 2d 6c 69 73 74 2e 0a 20 20 2a 2f 0a 20 20 ee-list.. */.
34680 69 66 28 20 70 50 61 67 65 3d 3d 30 20 26 26 20 if( pPage==0 &&
34690 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d SQLITE_OK!=(rc =
346a0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
346b0 74 2c 20 69 50 61 67 65 2c 20 26 70 50 61 67 65 t, iPage, &pPage
346c0 2c 20 30 29 29 20 29 7b 0a 20 20 20 20 67 6f 74 , 0)) ){. got
346d0 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
346e0 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }. rc = sqlit
346f0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 e3PagerWrite(pPa
34700 67 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 ge->pDbPage);.
34710 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
34720 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 66 72 K ){. goto fr
34730 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 7d 0a eepage_out;. }.
34740 20 20 70 75 74 34 62 79 74 65 28 70 50 61 67 65 put4byte(pPage
34750 2d 3e 61 44 61 74 61 2c 20 69 54 72 75 6e 6b 29 ->aData, iTrunk)
34760 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 50 ;. put4byte(&pP
34770 61 67 65 2d 3e 61 44 61 74 61 5b 34 5d 2c 20 30 age->aData[4], 0
34780 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 26 70 );. put4byte(&p
34790 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d Page1->aData[32]
347a0 2c 20 69 50 61 67 65 29 3b 0a 20 20 54 52 41 43 , iPage);. TRAC
347b0 45 28 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 E(("FREE-PAGE: %
347c0 64 20 6e 65 77 20 74 72 75 6e 6b 20 70 61 67 65 d new trunk page
347d0 20 72 65 70 6c 61 63 69 6e 67 20 25 64 5c 6e 22 replacing %d\n"
347e0 2c 20 70 50 61 67 65 2d 3e 70 67 6e 6f 2c 20 69 , pPage->pgno, i
347f0 54 72 75 6e 6b 29 29 3b 0a 0a 66 72 65 65 70 61 Trunk));..freepa
34800 67 65 5f 6f 75 74 3a 0a 20 20 69 66 28 20 70 50 ge_out:. if( pP
34810 61 67 65 20 29 7b 0a 20 20 20 20 70 50 61 67 65 age ){. pPage
34820 2d 3e 69 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 ->isInit = 0;.
34830 7d 0a 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 }. releasePage(
34840 70 50 61 67 65 29 3b 0a 20 20 72 65 6c 65 61 73 pPage);. releas
34850 65 50 61 67 65 28 70 54 72 75 6e 6b 29 3b 0a 20 ePage(pTrunk);.
34860 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 return rc;.}.st
34870 61 74 69 63 20 76 6f 69 64 20 66 72 65 65 50 61 atic void freePa
34880 67 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 ge(MemPage *pPag
34890 65 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a 20 20 e, int *pRC){.
348a0 69 66 28 20 28 2a 70 52 43 29 3d 3d 53 51 4c 49 if( (*pRC)==SQLI
348b0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 TE_OK ){. *pR
348c0 43 20 3d 20 66 72 65 65 50 61 67 65 32 28 70 50 C = freePage2(pP
348d0 61 67 65 2d 3e 70 42 74 2c 20 70 50 61 67 65 2c age->pBt, pPage,
348e0 20 70 50 61 67 65 2d 3e 70 67 6e 6f 29 3b 0a 20 pPage->pgno);.
348f0 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 }.}../*.** Free
34900 20 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 any overflow pa
34910 67 65 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 ges associated w
34920 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 43 65 ith the given Ce
34930 6c 6c 2e 20 20 53 74 6f 72 65 0a 2a 2a 20 73 69 ll. Store.** si
34940 7a 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 ze information a
34950 62 6f 75 74 20 74 68 65 20 63 65 6c 6c 20 69 6e bout the cell in
34960 20 70 49 6e 66 6f 2e 0a 2a 2f 0a 73 74 61 74 69 pInfo..*/.stati
34970 63 20 69 6e 74 20 63 6c 65 61 72 43 65 6c 6c 28 c int clearCell(
34980 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 . MemPage *pPag
34990 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 e, /* T
349a0 68 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e he page that con
349b0 74 61 69 6e 73 20 74 68 65 20 43 65 6c 6c 20 2a tains the Cell *
349c0 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 /. unsigned cha
349d0 72 20 2a 70 43 65 6c 6c 2c 20 20 20 20 2f 2a 20 r *pCell, /*
349e0 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 First byte of th
349f0 65 20 43 65 6c 6c 20 2a 2f 0a 20 20 43 65 6c 6c e Cell */. Cell
34a00 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 20 20 20 20 Info *pInfo
34a10 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 69 6e 66 /* Size inf
34a20 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 ormation about t
34a30 68 65 20 63 65 6c 6c 20 2a 2f 0a 29 7b 0a 20 20 he cell */.){.
34a40 42 74 53 68 61 72 65 64 20 2a 70 42 74 3b 0a 20 BtShared *pBt;.
34a50 20 50 67 6e 6f 20 6f 76 66 6c 50 67 6e 6f 3b 0a Pgno ovflPgno;.
34a60 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
34a70 6e 4f 76 66 6c 3b 0a 20 20 75 33 32 20 6f 76 66 nOvfl;. u32 ovf
34a80 6c 50 61 67 65 53 69 7a 65 3b 0a 0a 20 20 61 73 lPageSize;.. as
34a90 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
34aa0 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
34ab0 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
34ac0 20 70 50 61 67 65 2d 3e 78 50 61 72 73 65 43 65 pPage->xParseCe
34ad0 6c 6c 28 70 50 61 67 65 2c 20 70 43 65 6c 6c 2c ll(pPage, pCell,
34ae0 20 70 49 6e 66 6f 29 3b 0a 20 20 69 66 28 20 70 pInfo);. if( p
34af0 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 3d 3d 70 49 Info->nLocal==pI
34b00 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 29 7b nfo->nPayload ){
34b10 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
34b20 54 45 5f 4f 4b 3b 20 20 2f 2a 20 4e 6f 20 6f 76 TE_OK; /* No ov
34b30 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 52 65 erflow pages. Re
34b40 74 75 72 6e 20 77 69 74 68 6f 75 74 20 64 6f 69 turn without doi
34b50 6e 67 20 61 6e 79 74 68 69 6e 67 20 2a 2f 0a 20 ng anything */.
34b60 20 7d 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 }. testcase( p
34b70 43 65 6c 6c 20 2b 20 70 49 6e 66 6f 2d 3e 6e 53 Cell + pInfo->nS
34b80 69 7a 65 20 3d 3d 20 70 50 61 67 65 2d 3e 61 44 ize == pPage->aD
34b90 61 74 61 45 6e 64 20 29 3b 0a 20 20 74 65 73 74 ataEnd );. test
34ba0 63 61 73 65 28 20 70 43 65 6c 6c 20 2b 20 28 70 case( pCell + (p
34bb0 49 6e 66 6f 2d 3e 6e 53 69 7a 65 2d 31 29 20 3d Info->nSize-1) =
34bc0 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e = pPage->aDataEn
34bd0 64 20 29 3b 0a 20 20 69 66 28 20 70 43 65 6c 6c d );. if( pCell
34be0 20 2b 20 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 + pInfo->nSize
34bf0 3e 20 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e > pPage->aDataEn
34c00 64 20 29 7b 0a 20 20 20 20 2f 2a 20 43 65 6c 6c d ){. /* Cell
34c10 20 65 78 74 65 6e 64 73 20 70 61 73 74 20 65 6e extends past en
34c20 64 20 6f 66 20 70 61 67 65 20 2a 2f 0a 20 20 20 d of page */.
34c30 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
34c40 4f 52 52 55 50 54 5f 50 41 47 45 28 70 50 61 67 ORRUPT_PAGE(pPag
34c50 65 29 3b 0a 20 20 7d 0a 20 20 6f 76 66 6c 50 67 e);. }. ovflPg
34c60 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 70 43 no = get4byte(pC
34c70 65 6c 6c 20 2b 20 70 49 6e 66 6f 2d 3e 6e 53 69 ell + pInfo->nSi
34c80 7a 65 20 2d 20 34 29 3b 0a 20 20 70 42 74 20 3d ze - 4);. pBt =
34c90 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 61 pPage->pBt;. a
34ca0 73 73 65 72 74 28 20 70 42 74 2d 3e 75 73 61 62 ssert( pBt->usab
34cb0 6c 65 53 69 7a 65 20 3e 20 34 20 29 3b 0a 20 20 leSize > 4 );.
34cc0 6f 76 66 6c 50 61 67 65 53 69 7a 65 20 3d 20 70 ovflPageSize = p
34cd0 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
34ce0 20 34 3b 0a 20 20 6e 4f 76 66 6c 20 3d 20 28 70 4;. nOvfl = (p
34cf0 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 20 2d Info->nPayload -
34d00 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 2b pInfo->nLocal +
34d10 20 6f 76 66 6c 50 61 67 65 53 69 7a 65 20 2d 20 ovflPageSize -
34d20 31 29 2f 6f 76 66 6c 50 61 67 65 53 69 7a 65 3b 1)/ovflPageSize;
34d30 0a 20 20 61 73 73 65 72 74 28 20 6e 4f 76 66 6c . assert( nOvfl
34d40 3e 30 20 7c 7c 20 0a 20 20 20 20 28 43 4f 52 52 >0 || . (CORR
34d50 55 50 54 5f 44 42 20 26 26 20 28 70 49 6e 66 6f UPT_DB && (pInfo
34d60 2d 3e 6e 50 61 79 6c 6f 61 64 20 2b 20 6f 76 66 ->nPayload + ovf
34d70 6c 50 61 67 65 53 69 7a 65 29 3c 6f 76 66 6c 50 lPageSize)<ovflP
34d80 61 67 65 53 69 7a 65 29 0a 20 20 29 3b 0a 20 20 ageSize). );.
34d90 77 68 69 6c 65 28 20 6e 4f 76 66 6c 2d 2d 20 29 while( nOvfl-- )
34da0 7b 0a 20 20 20 20 50 67 6e 6f 20 69 4e 65 78 74 {. Pgno iNext
34db0 20 3d 20 30 3b 0a 20 20 20 20 4d 65 6d 50 61 67 = 0;. MemPag
34dc0 65 20 2a 70 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 e *pOvfl = 0;.
34dd0 20 20 69 66 28 20 6f 76 66 6c 50 67 6e 6f 3c 32 if( ovflPgno<2
34de0 20 7c 7c 20 6f 76 66 6c 50 67 6e 6f 3e 62 74 72 || ovflPgno>btr
34df0 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 eePagecount(pBt)
34e00 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 30 20 69 ){. /* 0 i
34e10 73 20 6e 6f 74 20 61 20 6c 65 67 61 6c 20 70 61 s not a legal pa
34e20 67 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 61 ge number and pa
34e30 67 65 20 31 20 63 61 6e 6e 6f 74 20 62 65 20 61 ge 1 cannot be a
34e40 6e 20 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 n . ** over
34e50 66 6c 6f 77 20 70 61 67 65 2e 20 54 68 65 72 65 flow page. There
34e60 66 6f 72 65 20 69 66 20 6f 76 66 6c 50 67 6e 6f fore if ovflPgno
34e70 3c 32 20 6f 72 20 70 61 73 74 20 74 68 65 20 65 <2 or past the e
34e80 6e 64 20 6f 66 20 74 68 65 20 0a 20 20 20 20 20 nd of the .
34e90 20 2a 2a 20 66 69 6c 65 20 74 68 65 20 64 61 74 ** file the dat
34ea0 61 62 61 73 65 20 6d 75 73 74 20 62 65 20 63 6f abase must be co
34eb0 72 72 75 70 74 2e 20 2a 2f 0a 20 20 20 20 20 20 rrupt. */.
34ec0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
34ed0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
34ee0 7d 0a 20 20 20 20 69 66 28 20 6e 4f 76 66 6c 20 }. if( nOvfl
34ef0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 67 65 ){. rc = ge
34f00 74 4f 76 65 72 66 6c 6f 77 50 61 67 65 28 70 42 tOverflowPage(pB
34f10 74 2c 20 6f 76 66 6c 50 67 6e 6f 2c 20 26 70 4f t, ovflPgno, &pO
34f20 76 66 6c 2c 20 26 69 4e 65 78 74 29 3b 0a 20 20 vfl, &iNext);.
34f30 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 if( rc ) ret
34f40 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 urn rc;. }..
34f50 20 20 20 69 66 28 20 28 20 70 4f 76 66 6c 20 7c if( ( pOvfl |
34f60 7c 20 28 28 70 4f 76 66 6c 20 3d 20 62 74 72 65 | ((pOvfl = btre
34f70 65 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 74 2c ePageLookup(pBt,
34f80 20 6f 76 66 6c 50 67 6e 6f 29 29 21 3d 30 29 20 ovflPgno))!=0)
34f90 29 0a 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 ). && sqlite
34fa0 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 3PagerPageRefcou
34fb0 6e 74 28 70 4f 76 66 6c 2d 3e 70 44 62 50 61 67 nt(pOvfl->pDbPag
34fc0 65 29 21 3d 31 0a 20 20 20 20 29 7b 0a 20 20 20 e)!=1. ){.
34fd0 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 20 6e /* There is n
34fe0 6f 20 72 65 61 73 6f 6e 20 61 6e 79 20 63 75 72 o reason any cur
34ff0 73 6f 72 20 73 68 6f 75 6c 64 20 68 61 76 65 20 sor should have
35000 61 6e 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 an outstanding r
35010 65 66 65 72 65 6e 63 65 20 0a 20 20 20 20 20 20 eference .
35020 2a 2a 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f ** to an overflo
35030 77 20 70 61 67 65 20 62 65 6c 6f 6e 67 69 6e 67 w page belonging
35040 20 74 6f 20 61 20 63 65 6c 6c 20 74 68 61 74 20 to a cell that
35050 69 73 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 is being deleted
35060 2f 75 70 64 61 74 65 64 2e 0a 20 20 20 20 20 20 /updated..
35070 2a 2a 20 53 6f 20 69 66 20 74 68 65 72 65 20 65 ** So if there e
35080 78 69 73 74 73 20 6d 6f 72 65 20 74 68 61 6e 20 xists more than
35090 6f 6e 65 20 72 65 66 65 72 65 6e 63 65 20 74 6f one reference to
350a0 20 74 68 69 73 20 70 61 67 65 2c 20 74 68 65 6e this page, then
350b0 20 69 74 20 0a 20 20 20 20 20 20 2a 2a 20 6d 75 it . ** mu
350c0 73 74 20 6e 6f 74 20 72 65 61 6c 6c 79 20 62 65 st not really be
350d0 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
350e0 65 20 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 e and the databa
350f0 73 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 se must be corru
35100 70 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 49 74 pt. . ** It
35110 20 69 73 20 68 65 6c 70 66 75 6c 20 74 6f 20 64 is helpful to d
35120 65 74 65 63 74 20 74 68 69 73 20 62 65 66 6f 72 etect this befor
35130 65 20 63 61 6c 6c 69 6e 67 20 66 72 65 65 50 61 e calling freePa
35140 67 65 32 28 29 2c 20 61 73 20 0a 20 20 20 20 20 ge2(), as .
35150 20 2a 2a 20 66 72 65 65 50 61 67 65 32 28 29 20 ** freePage2()
35160 6d 61 79 20 7a 65 72 6f 20 74 68 65 20 70 61 67 may zero the pag
35170 65 20 63 6f 6e 74 65 6e 74 73 20 69 66 20 73 65 e contents if se
35180 63 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f 64 65 cure-delete mode
35190 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 65 6e 61 is. ** ena
351a0 62 6c 65 64 2e 20 49 66 20 74 68 69 73 20 27 6f bled. If this 'o
351b0 76 65 72 66 6c 6f 77 27 20 70 61 67 65 20 68 61 verflow' page ha
351c0 70 70 65 6e 73 20 74 6f 20 62 65 20 61 20 70 61 ppens to be a pa
351d0 67 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 ge that the.
351e0 20 20 2a 2a 20 63 61 6c 6c 65 72 20 69 73 20 69 ** caller is i
351f0 74 65 72 61 74 69 6e 67 20 74 68 72 6f 75 67 68 terating through
35200 20 6f 72 20 75 73 69 6e 67 20 69 6e 20 73 6f 6d or using in som
35210 65 20 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 e other way, thi
35220 73 0a 20 20 20 20 20 20 2a 2a 20 63 61 6e 20 62 s. ** can b
35230 65 20 70 72 6f 62 6c 65 6d 61 74 69 63 2e 0a 20 e problematic..
35240 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 */. rc
35250 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 = SQLITE_CORRUP
35260 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 65 6c 73 T_BKPT;. }els
35270 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 66 72 e{. rc = fr
35280 65 65 50 61 67 65 32 28 70 42 74 2c 20 70 4f 76 eePage2(pBt, pOv
35290 66 6c 2c 20 6f 76 66 6c 50 67 6e 6f 29 3b 0a 20 fl, ovflPgno);.
352a0 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 4f }.. if( pO
352b0 76 66 6c 20 29 7b 0a 20 20 20 20 20 20 73 71 6c vfl ){. sql
352c0 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
352d0 4f 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 3b 0a Ovfl->pDbPage);.
352e0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
352f0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
35300 20 20 6f 76 66 6c 50 67 6e 6f 20 3d 20 69 4e 65 ovflPgno = iNe
35310 78 74 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e xt;. }. return
35320 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
35330 2a 0a 2a 2a 20 43 72 65 61 74 65 20 74 68 65 20 *.** Create the
35340 62 79 74 65 20 73 65 71 75 65 6e 63 65 20 75 73 byte sequence us
35350 65 64 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 ed to represent
35360 61 20 63 65 6c 6c 20 6f 6e 20 70 61 67 65 20 70 a cell on page p
35370 50 61 67 65 0a 2a 2a 20 61 6e 64 20 77 72 69 74 Page.** and writ
35380 65 20 74 68 61 74 20 62 79 74 65 20 73 65 71 75 e that byte sequ
35390 65 6e 63 65 20 69 6e 74 6f 20 70 43 65 6c 6c 5b ence into pCell[
353a0 5d 2e 20 20 4f 76 65 72 66 6c 6f 77 20 70 61 67 ]. Overflow pag
353b0 65 73 20 61 72 65 0a 2a 2a 20 61 6c 6c 6f 63 61 es are.** alloca
353c0 74 65 64 20 61 6e 64 20 66 69 6c 6c 65 64 20 69 ted and filled i
353d0 6e 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e 20 n as necessary.
353e0 20 54 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f The calling pro
353f0 63 65 64 75 72 65 0a 2a 2a 20 69 73 20 72 65 73 cedure.** is res
35400 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 6d 61 6b ponsible for mak
35410 69 6e 67 20 73 75 72 65 20 73 75 66 66 69 63 69 ing sure suffici
35420 65 6e 74 20 73 70 61 63 65 20 68 61 73 20 62 65 ent space has be
35430 65 6e 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 en allocated.**
35440 66 6f 72 20 70 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a for pCell[]..**.
35450 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 70 43 65 ** Note that pCe
35460 6c 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65 63 65 ll does not nece
35470 73 73 61 72 79 20 6e 65 65 64 20 74 6f 20 70 6f ssary need to po
35480 69 6e 74 20 74 6f 20 74 68 65 20 70 50 61 67 65 int to the pPage
35490 2d 3e 61 44 61 74 61 0a 2a 2a 20 61 72 65 61 2e ->aData.** area.
354a0 20 20 70 43 65 6c 6c 20 6d 69 67 68 74 20 70 6f pCell might po
354b0 69 6e 74 20 74 6f 20 73 6f 6d 65 20 74 65 6d 70 int to some temp
354c0 6f 72 61 72 79 20 73 74 6f 72 61 67 65 2e 20 20 orary storage.
354d0 54 68 65 20 63 65 6c 6c 20 77 69 6c 6c 0a 2a 2a The cell will.**
354e0 20 62 65 20 63 6f 6e 73 74 72 75 63 74 65 64 20 be constructed
354f0 69 6e 20 74 68 69 73 20 74 65 6d 70 6f 72 61 72 in this temporar
35500 79 20 61 72 65 61 20 74 68 65 6e 20 63 6f 70 69 y area then copi
35510 65 64 20 69 6e 74 6f 20 70 50 61 67 65 2d 3e 61 ed into pPage->a
35520 44 61 74 61 0a 2a 2a 20 6c 61 74 65 72 2e 0a 2a Data.** later..*
35530 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 69 6c /.static int fil
35540 6c 49 6e 43 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 lInCell(. MemPa
35550 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 20 20 ge *pPage,
35560 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
35570 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 page that conta
35580 69 6e 73 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a ins the cell */.
35590 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
355a0 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 20 *pCell,
355b0 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 74 65 78 /* Complete tex
355c0 74 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 2a 2f t of the cell */
355d0 0a 20 20 63 6f 6e 73 74 20 42 74 72 65 65 50 61 . const BtreePa
355e0 79 6c 6f 61 64 20 2a 70 58 2c 20 20 20 20 20 20 yload *pX,
355f0 20 20 2f 2a 20 50 61 79 6c 6f 61 64 20 77 69 74 /* Payload wit
35600 68 20 77 68 69 63 68 20 74 6f 20 63 6f 6e 73 74 h which to const
35610 72 75 63 74 20 74 68 65 20 63 65 6c 6c 20 2a 2f ruct the cell */
35620 0a 20 20 69 6e 74 20 2a 70 6e 53 69 7a 65 20 20 . int *pnSize
35630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
35640 20 20 2f 2a 20 57 72 69 74 65 20 63 65 6c 6c 20 /* Write cell
35650 73 69 7a 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a size here */.){.
35660 20 20 69 6e 74 20 6e 50 61 79 6c 6f 61 64 3b 0a int nPayload;.
35670 20 20 63 6f 6e 73 74 20 75 38 20 2a 70 53 72 63 const u8 *pSrc
35680 3b 0a 20 20 69 6e 74 20 6e 53 72 63 2c 20 6e 2c ;. int nSrc, n,
35690 20 72 63 2c 20 6d 6e 3b 0a 20 20 69 6e 74 20 73 rc, mn;. int s
356a0 70 61 63 65 4c 65 66 74 3b 0a 20 20 4d 65 6d 50 paceLeft;. MemP
356b0 61 67 65 20 2a 70 54 6f 52 65 6c 65 61 73 65 3b age *pToRelease;
356c0 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
356d0 20 2a 70 50 72 69 6f 72 3b 0a 20 20 75 6e 73 69 *pPrior;. unsi
356e0 67 6e 65 64 20 63 68 61 72 20 2a 70 50 61 79 6c gned char *pPayl
356f0 6f 61 64 3b 0a 20 20 42 74 53 68 61 72 65 64 20 oad;. BtShared
35700 2a 70 42 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e *pBt;. Pgno pgn
35710 6f 4f 76 66 6c 3b 0a 20 20 69 6e 74 20 6e 48 65 oOvfl;. int nHe
35720 61 64 65 72 3b 0a 0a 20 20 61 73 73 65 72 74 28 ader;.. assert(
35730 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
35740 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
35750 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 mutex) );.. /*
35760 70 50 61 67 65 20 69 73 20 6e 6f 74 20 6e 65 63 pPage is not nec
35770 65 73 73 61 72 69 6c 79 20 77 72 69 74 65 61 62 essarily writeab
35780 6c 65 20 73 69 6e 63 65 20 70 43 65 6c 6c 20 6d le since pCell m
35790 69 67 68 74 20 62 65 20 61 75 78 69 6c 69 61 72 ight be auxiliar
357a0 79 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 73 70 y. ** buffer sp
357b0 61 63 65 20 74 68 61 74 20 69 73 20 73 65 70 61 ace that is sepa
357c0 72 61 74 65 20 66 72 6f 6d 20 74 68 65 20 70 50 rate from the pP
357d0 61 67 65 20 62 75 66 66 65 72 20 61 72 65 61 20 age buffer area
357e0 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 43 65 */. assert( pCe
357f0 6c 6c 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 ll<pPage->aData
35800 7c 7c 20 70 43 65 6c 6c 3e 3d 26 70 50 61 67 65 || pCell>=&pPage
35810 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 70 ->aData[pPage->p
35820 42 74 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 Bt->pageSize].
35830 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c || sql
35840 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 ite3PagerIswrite
35850 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 able(pPage->pDbP
35860 61 67 65 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 69 age) );.. /* Fi
35870 6c 6c 20 69 6e 20 74 68 65 20 68 65 61 64 65 72 ll in the header
35880 2e 20 2a 2f 0a 20 20 6e 48 65 61 64 65 72 20 3d . */. nHeader =
35890 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 74 72 pPage->childPtr
358a0 53 69 7a 65 3b 0a 20 20 69 66 28 20 70 50 61 67 Size;. if( pPag
358b0 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 e->intKey ){.
358c0 20 6e 50 61 79 6c 6f 61 64 20 3d 20 70 58 2d 3e nPayload = pX->
358d0 6e 44 61 74 61 20 2b 20 70 58 2d 3e 6e 5a 65 72 nData + pX->nZer
358e0 6f 3b 0a 20 20 20 20 70 53 72 63 20 3d 20 70 58 o;. pSrc = pX
358f0 2d 3e 70 44 61 74 61 3b 0a 20 20 20 20 6e 53 72 ->pData;. nSr
35900 63 20 3d 20 70 58 2d 3e 6e 44 61 74 61 3b 0a 20 c = pX->nData;.
35910 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
35920 2d 3e 69 6e 74 4b 65 79 4c 65 61 66 20 29 3b 20 ->intKeyLeaf );
35930 2f 2a 20 66 69 6c 6c 49 6e 43 65 6c 6c 28 29 20 /* fillInCell()
35940 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 6f 72 20 only called for
35950 6c 65 61 76 65 73 20 2a 2f 0a 20 20 20 20 6e 48 leaves */. nH
35960 65 61 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 eader += putVari
35970 6e 74 33 32 28 26 70 43 65 6c 6c 5b 6e 48 65 61 nt32(&pCell[nHea
35980 64 65 72 5d 2c 20 6e 50 61 79 6c 6f 61 64 29 3b der], nPayload);
35990 0a 20 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 . nHeader +=
359a0 70 75 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c putVarint(&pCell
359b0 5b 6e 48 65 61 64 65 72 5d 2c 20 2a 28 75 36 34 [nHeader], *(u64
359c0 2a 29 26 70 58 2d 3e 6e 4b 65 79 29 3b 0a 20 20 *)&pX->nKey);.
359d0 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 }else{. asser
359e0 74 28 20 70 58 2d 3e 6e 4b 65 79 3c 3d 30 78 37 t( pX->nKey<=0x7
359f0 66 66 66 66 66 66 66 20 26 26 20 70 58 2d 3e 70 fffffff && pX->p
35a00 4b 65 79 21 3d 30 20 29 3b 0a 20 20 20 20 6e 53 Key!=0 );. nS
35a10 72 63 20 3d 20 6e 50 61 79 6c 6f 61 64 20 3d 20 rc = nPayload =
35a20 28 69 6e 74 29 70 58 2d 3e 6e 4b 65 79 3b 0a 20 (int)pX->nKey;.
35a30 20 20 20 70 53 72 63 20 3d 20 70 58 2d 3e 70 4b pSrc = pX->pK
35a40 65 79 3b 0a 20 20 20 20 6e 48 65 61 64 65 72 20 ey;. nHeader
35a50 2b 3d 20 70 75 74 56 61 72 69 6e 74 33 32 28 26 += putVarint32(&
35a60 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 5d 2c 20 pCell[nHeader],
35a70 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 20 7d 0a 20 nPayload);. }.
35a80 20 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 . /* Fill in t
35a90 68 65 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 he payload */.
35aa0 70 50 61 79 6c 6f 61 64 20 3d 20 26 70 43 65 6c pPayload = &pCel
35ab0 6c 5b 6e 48 65 61 64 65 72 5d 3b 0a 20 20 69 66 l[nHeader];. if
35ac0 28 20 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 61 67 ( nPayload<=pPag
35ad0 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 e->maxLocal ){.
35ae0 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 74 68 /* This is th
35af0 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 68 e common case wh
35b00 65 72 65 20 65 76 65 72 79 74 68 69 6e 67 20 66 ere everything f
35b10 69 74 73 20 6f 6e 20 74 68 65 20 62 74 72 65 65 its on the btree
35b20 20 70 61 67 65 0a 20 20 20 20 2a 2a 20 61 6e 64 page. ** and
35b30 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 no overflow pag
35b40 65 73 20 61 72 65 20 72 65 71 75 69 72 65 64 2e es are required.
35b50 20 2a 2f 0a 20 20 20 20 6e 20 3d 20 6e 48 65 61 */. n = nHea
35b60 64 65 72 20 2b 20 6e 50 61 79 6c 6f 61 64 3b 0a der + nPayload;.
35b70 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 3d testcase( n=
35b80 3d 33 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 =3 );. testca
35b90 73 65 28 20 6e 3d 3d 34 20 29 3b 0a 20 20 20 20 se( n==4 );.
35ba0 69 66 28 20 6e 3c 34 20 29 20 6e 20 3d 20 34 3b if( n<4 ) n = 4;
35bb0 0a 20 20 20 20 2a 70 6e 53 69 7a 65 20 3d 20 6e . *pnSize = n
35bc0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 53 ;. assert( nS
35bd0 72 63 3c 3d 6e 50 61 79 6c 6f 61 64 20 29 3b 0a rc<=nPayload );.
35be0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6e 53 testcase( nS
35bf0 72 63 3c 6e 50 61 79 6c 6f 61 64 20 29 3b 0a 20 rc<nPayload );.
35c00 20 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f memcpy(pPaylo
35c10 61 64 2c 20 70 53 72 63 2c 20 6e 53 72 63 29 3b ad, pSrc, nSrc);
35c20 0a 20 20 20 20 6d 65 6d 73 65 74 28 70 50 61 79 . memset(pPay
35c30 6c 6f 61 64 2b 6e 53 72 63 2c 20 30 2c 20 6e 50 load+nSrc, 0, nP
35c40 61 79 6c 6f 61 64 2d 6e 53 72 63 29 3b 0a 20 20 ayload-nSrc);.
35c50 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
35c60 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 OK;. }.. /* If
35c70 20 77 65 20 72 65 61 63 68 20 74 68 69 73 20 70 we reach this p
35c80 6f 69 6e 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 oint, it means t
35c90 68 61 74 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 hat some of the
35ca0 63 6f 6e 74 65 6e 74 20 77 69 6c 6c 20 6e 65 65 content will nee
35cb0 64 0a 20 20 2a 2a 20 74 6f 20 73 70 69 6c 6c 20 d. ** to spill
35cc0 6f 6e 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 onto overflow pa
35cd0 67 65 73 2e 0a 20 20 2a 2f 0a 20 20 6d 6e 20 3d ges.. */. mn =
35ce0 20 70 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c pPage->minLocal
35cf0 3b 0a 20 20 6e 20 3d 20 6d 6e 20 2b 20 28 6e 50 ;. n = mn + (nP
35d00 61 79 6c 6f 61 64 20 2d 20 6d 6e 29 20 25 20 28 ayload - mn) % (
35d10 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 pPage->pBt->usab
35d20 6c 65 53 69 7a 65 20 2d 20 34 29 3b 0a 20 20 74 leSize - 4);. t
35d30 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 61 67 estcase( n==pPag
35d40 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 e->maxLocal );.
35d50 20 74 65 73 74 63 61 73 65 28 20 6e 3d 3d 70 50 testcase( n==pP
35d60 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 2b 31 20 age->maxLocal+1
35d70 29 3b 0a 20 20 69 66 28 20 6e 20 3e 20 70 50 61 );. if( n > pPa
35d80 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 20 6e ge->maxLocal ) n
35d90 20 3d 20 6d 6e 3b 0a 20 20 73 70 61 63 65 4c 65 = mn;. spaceLe
35da0 66 74 20 3d 20 6e 3b 0a 20 20 2a 70 6e 53 69 7a ft = n;. *pnSiz
35db0 65 20 3d 20 6e 20 2b 20 6e 48 65 61 64 65 72 20 e = n + nHeader
35dc0 2b 20 34 3b 0a 20 20 70 50 72 69 6f 72 20 3d 20 + 4;. pPrior =
35dd0 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 2b 6e &pCell[nHeader+n
35de0 5d 3b 0a 20 20 70 54 6f 52 65 6c 65 61 73 65 20 ];. pToRelease
35df0 3d 20 30 3b 0a 20 20 70 67 6e 6f 4f 76 66 6c 20 = 0;. pgnoOvfl
35e00 3d 20 30 3b 0a 20 20 70 42 74 20 3d 20 70 50 61 = 0;. pBt = pPa
35e10 67 65 2d 3e 70 42 74 3b 0a 0a 20 20 2f 2a 20 41 ge->pBt;.. /* A
35e20 74 20 74 68 69 73 20 70 6f 69 6e 74 20 76 61 72 t this point var
35e30 69 61 62 6c 65 73 20 73 68 6f 75 6c 64 20 62 65 iables should be
35e40 20 73 65 74 20 61 73 20 66 6f 6c 6c 6f 77 73 3a set as follows:
35e50 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 6e 50 61 . **. ** nPa
35e60 79 6c 6f 61 64 20 20 20 20 20 20 20 20 20 20 20 yload
35e70 54 6f 74 61 6c 20 70 61 79 6c 6f 61 64 20 73 69 Total payload si
35e80 7a 65 20 69 6e 20 62 79 74 65 73 0a 20 20 2a 2a ze in bytes. **
35e90 20 20 20 70 50 61 79 6c 6f 61 64 20 20 20 20 20 pPayload
35ea0 20 20 20 20 20 20 42 65 67 69 6e 20 77 72 69 74 Begin writ
35eb0 69 6e 67 20 70 61 79 6c 6f 61 64 20 68 65 72 65 ing payload here
35ec0 0a 20 20 2a 2a 20 20 20 73 70 61 63 65 4c 65 66 . ** spaceLef
35ed0 74 20 20 20 20 20 20 20 20 20 20 53 70 61 63 65 t Space
35ee0 20 61 76 61 69 6c 61 62 6c 65 20 61 74 20 70 50 available at pP
35ef0 61 79 6c 6f 61 64 2e 20 20 49 66 20 6e 50 61 79 ayload. If nPay
35f00 6c 6f 61 64 3e 73 70 61 63 65 4c 65 66 74 2c 0a load>spaceLeft,.
35f10 20 20 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 **
35f20 20 20 20 20 20 20 20 20 20 20 74 68 61 74 20 6d that m
35f30 65 61 6e 73 20 63 6f 6e 74 65 6e 74 20 6d 75 73 eans content mus
35f40 74 20 73 70 69 6c 6c 20 69 6e 74 6f 20 6f 76 65 t spill into ove
35f50 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a 20 20 2a rflow pages.. *
35f60 2a 20 20 20 2a 70 6e 53 69 7a 65 20 20 20 20 20 * *pnSize
35f70 20 20 20 20 20 20 20 53 69 7a 65 20 6f 66 20 74 Size of t
35f80 68 65 20 6c 6f 63 61 6c 20 63 65 6c 6c 20 28 6e he local cell (n
35f90 6f 74 20 63 6f 75 6e 74 69 6e 67 20 6f 76 65 72 ot counting over
35fa0 66 6c 6f 77 20 70 61 67 65 73 29 0a 20 20 2a 2a flow pages). **
35fb0 20 20 20 70 50 72 69 6f 72 20 20 20 20 20 20 20 pPrior
35fc0 20 20 20 20 20 20 57 68 65 72 65 20 74 6f 20 77 Where to w
35fd0 72 69 74 65 20 74 68 65 20 70 67 6e 6f 20 6f 66 rite the pgno of
35fe0 20 74 68 65 20 66 69 72 73 74 20 6f 76 65 72 66 the first overf
35ff0 6c 6f 77 20 70 61 67 65 0a 20 20 2a 2a 0a 20 20 low page. **.
36000 2a 2a 20 55 73 65 20 61 20 63 61 6c 6c 20 74 6f ** Use a call to
36010 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 btreeParseCellP
36020 74 72 28 29 20 74 6f 20 76 65 72 69 66 79 20 74 tr() to verify t
36030 68 61 74 20 74 68 65 20 76 61 6c 75 65 73 20 61 hat the values a
36040 62 6f 76 65 0a 20 20 2a 2a 20 77 65 72 65 20 63 bove. ** were c
36050 6f 6d 70 75 74 65 64 20 63 6f 72 72 65 63 74 6c omputed correctl
36060 79 2e 0a 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 y.. */.#ifdef S
36070 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 7b 0a QLITE_DEBUG. {.
36080 20 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 CellInfo inf
36090 6f 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 78 50 o;. pPage->xP
360a0 61 72 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 arseCell(pPage,
360b0 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 pCell, &info);.
360c0 20 20 20 61 73 73 65 72 74 28 20 6e 48 65 61 64 assert( nHead
360d0 65 72 3d 3d 28 69 6e 74 29 28 69 6e 66 6f 2e 70 er==(int)(info.p
360e0 50 61 79 6c 6f 61 64 20 2d 20 70 43 65 6c 6c 29 Payload - pCell)
360f0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
36100 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 70 58 2d 3e 6e info.nKey==pX->n
36110 4b 65 79 20 29 3b 0a 20 20 20 20 61 73 73 65 72 Key );. asser
36120 74 28 20 2a 70 6e 53 69 7a 65 20 3d 3d 20 69 6e t( *pnSize == in
36130 66 6f 2e 6e 53 69 7a 65 20 29 3b 0a 20 20 20 20 fo.nSize );.
36140 61 73 73 65 72 74 28 20 73 70 61 63 65 4c 65 66 assert( spaceLef
36150 74 20 3d 3d 20 69 6e 66 6f 2e 6e 4c 6f 63 61 6c t == info.nLocal
36160 20 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a );. }.#endif..
36170 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 70 /* Write the p
36180 61 79 6c 6f 61 64 20 69 6e 74 6f 20 74 68 65 20 ayload into the
36190 6c 6f 63 61 6c 20 43 65 6c 6c 20 61 6e 64 20 61 local Cell and a
361a0 6e 79 20 65 78 74 72 61 20 69 6e 74 6f 20 6f 76 ny extra into ov
361b0 65 72 66 6c 6f 77 20 70 61 67 65 73 20 2a 2f 0a erflow pages */.
361c0 20 20 77 68 69 6c 65 28 20 31 20 29 7b 0a 20 20 while( 1 ){.
361d0 20 20 6e 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a n = nPayload;.
361e0 20 20 20 20 69 66 28 20 6e 3e 73 70 61 63 65 4c if( n>spaceL
361f0 65 66 74 20 29 20 6e 20 3d 20 73 70 61 63 65 4c eft ) n = spaceL
36200 65 66 74 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 eft;.. /* If
36210 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 6e 6f pToRelease is no
36220 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 61 79 t zero than pPay
36230 6c 6f 61 64 20 70 6f 69 6e 74 73 20 69 6e 74 6f load points into
36240 20 74 68 65 20 64 61 74 61 20 61 72 65 61 0a 20 the data area.
36250 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 6c 65 ** of pToRele
36260 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 ase. Make sure
36270 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 73 74 pToRelease is st
36280 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e 20 2a ill writeable. *
36290 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 54 /. assert( pT
362a0 6f 52 65 6c 65 61 73 65 3d 3d 30 20 7c 7c 20 73 oRelease==0 || s
362b0 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
362c0 74 65 61 62 6c 65 28 70 54 6f 52 65 6c 65 61 73 teable(pToReleas
362d0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a e->pDbPage) );..
362e0 20 20 20 20 2f 2a 20 49 66 20 70 50 61 79 6c 6f /* If pPaylo
362f0 61 64 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 ad is part of th
36300 65 20 64 61 74 61 20 61 72 65 61 20 6f 66 20 70 e data area of p
36310 50 61 67 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 Page, then make
36320 73 75 72 65 20 70 50 61 67 65 0a 20 20 20 20 2a sure pPage. *
36330 2a 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 65 * is still write
36340 61 62 6c 65 20 2a 2f 0a 20 20 20 20 61 73 73 65 able */. asse
36350 72 74 28 20 70 50 61 79 6c 6f 61 64 3c 70 50 61 rt( pPayload<pPa
36360 67 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 50 61 ge->aData || pPa
36370 79 6c 6f 61 64 3e 3d 26 70 50 61 67 65 2d 3e 61 yload>=&pPage->a
36380 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 53 69 Data[pBt->pageSi
36390 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ze].
363a0 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 || sqlite3PagerI
363b0 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
363c0 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 ->pDbPage) );..
363d0 20 20 20 69 66 28 20 6e 53 72 63 3e 3d 6e 20 29 if( nSrc>=n )
363e0 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 70 {. memcpy(p
363f0 50 61 79 6c 6f 61 64 2c 20 70 53 72 63 2c 20 6e Payload, pSrc, n
36400 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 );. }else if(
36410 20 6e 53 72 63 3e 30 20 29 7b 0a 20 20 20 20 20 nSrc>0 ){.
36420 20 6e 20 3d 20 6e 53 72 63 3b 0a 20 20 20 20 20 n = nSrc;.
36430 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 memcpy(pPayload
36440 2c 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 20 20 , pSrc, n);.
36450 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 6d }else{. mem
36460 73 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 30 2c set(pPayload, 0,
36470 20 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e n);. }. n
36480 50 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a 20 20 Payload -= n;.
36490 20 20 69 66 28 20 6e 50 61 79 6c 6f 61 64 3c 3d if( nPayload<=
364a0 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 70 0 ) break;. p
364b0 50 61 79 6c 6f 61 64 20 2b 3d 20 6e 3b 0a 20 20 Payload += n;.
364c0 20 20 70 53 72 63 20 2b 3d 20 6e 3b 0a 20 20 20 pSrc += n;.
364d0 20 6e 53 72 63 20 2d 3d 20 6e 3b 0a 20 20 20 20 nSrc -= n;.
364e0 73 70 61 63 65 4c 65 66 74 20 2d 3d 20 6e 3b 0a spaceLeft -= n;.
364f0 20 20 20 20 69 66 28 20 73 70 61 63 65 4c 65 66 if( spaceLef
36500 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 4d 65 t==0 ){. Me
36510 6d 50 61 67 65 20 2a 70 4f 76 66 6c 20 3d 20 30 mPage *pOvfl = 0
36520 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
36530 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d _OMIT_AUTOVACUUM
36540 0a 20 20 20 20 20 20 50 67 6e 6f 20 70 67 6e 6f . Pgno pgno
36550 50 74 72 6d 61 70 20 3d 20 70 67 6e 6f 4f 76 66 Ptrmap = pgnoOvf
36560 6c 3b 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 l; /* Overflow p
36570 61 67 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 age pointer-map
36580 65 6e 74 72 79 20 70 61 67 65 20 2a 2f 0a 20 20 entry page */.
36590 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 if( pBt->aut
365a0 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 oVacuum ){.
365b0 20 20 20 64 6f 7b 0a 20 20 20 20 20 20 20 20 20 do{.
365c0 20 70 67 6e 6f 4f 76 66 6c 2b 2b 3b 0a 20 20 20 pgnoOvfl++;.
365d0 20 20 20 20 20 7d 20 77 68 69 6c 65 28 20 0a 20 } while( .
365e0 20 20 20 20 20 20 20 20 20 50 54 52 4d 41 50 5f PTRMAP_
365f0 49 53 50 41 47 45 28 70 42 74 2c 20 70 67 6e 6f ISPAGE(pBt, pgno
36600 4f 76 66 6c 29 20 7c 7c 20 70 67 6e 6f 4f 76 66 Ovfl) || pgnoOvf
36610 6c 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f l==PENDING_BYTE_
36620 50 41 47 45 28 70 42 74 29 20 0a 20 20 20 20 20 PAGE(pBt) .
36630 20 20 20 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 );. }.#e
36640 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d 20 ndif. rc =
36650 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 67 allocateBtreePag
36660 65 28 70 42 74 2c 20 26 70 4f 76 66 6c 2c 20 26 e(pBt, &pOvfl, &
36670 70 67 6e 6f 4f 76 66 6c 2c 20 70 67 6e 6f 4f 76 pgnoOvfl, pgnoOv
36680 66 6c 2c 20 30 29 3b 0a 23 69 66 6e 64 65 66 20 fl, 0);.#ifndef
36690 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
366a0 56 41 43 55 55 4d 0a 20 20 20 20 20 20 2f 2a 20 VACUUM. /*
366b0 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
366c0 73 75 70 70 6f 72 74 73 20 61 75 74 6f 2d 76 61 supports auto-va
366d0 63 75 75 6d 2c 20 61 6e 64 20 74 68 65 20 73 65 cuum, and the se
366e0 63 6f 6e 64 20 6f 72 20 73 75 62 73 65 71 75 65 cond or subseque
366f0 6e 74 0a 20 20 20 20 20 20 2a 2a 20 6f 76 65 72 nt. ** over
36700 66 6c 6f 77 20 70 61 67 65 20 69 73 20 62 65 69 flow page is bei
36710 6e 67 20 61 6c 6c 6f 63 61 74 65 64 2c 20 61 64 ng allocated, ad
36720 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 74 68 d an entry to th
36730 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 e pointer-map.
36740 20 20 20 20 2a 2a 20 66 6f 72 20 74 68 61 74 20 ** for that
36750 70 61 67 65 20 6e 6f 77 2e 20 0a 20 20 20 20 20 page now. .
36760 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49 66 20 **. ** If
36770 74 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 this is the firs
36780 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2c t overflow page,
36790 20 74 68 65 6e 20 77 72 69 74 65 20 61 20 70 61 then write a pa
367a0 72 74 69 61 6c 20 65 6e 74 72 79 20 0a 20 20 20 rtial entry .
367b0 20 20 20 2a 2a 20 74 6f 20 74 68 65 20 70 6f 69 ** to the poi
367c0 6e 74 65 72 2d 6d 61 70 2e 20 49 66 20 77 65 20 nter-map. If we
367d0 77 72 69 74 65 20 6e 6f 74 68 69 6e 67 20 74 6f write nothing to
367e0 20 74 68 69 73 20 70 6f 69 6e 74 65 72 2d 6d 61 this pointer-ma
367f0 70 20 73 6c 6f 74 2c 0a 20 20 20 20 20 20 2a 2a p slot,. **
36800 20 74 68 65 6e 20 74 68 65 20 6f 70 74 69 6d 69 then the optimi
36810 73 74 69 63 20 6f 76 65 72 66 6c 6f 77 20 63 68 stic overflow ch
36820 61 69 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 69 ain processing i
36830 6e 20 63 6c 65 61 72 43 65 6c 6c 28 29 0a 20 20 n clearCell().
36840 20 20 20 20 2a 2a 20 6d 61 79 20 6d 69 73 69 6e ** may misin
36850 74 65 72 70 72 65 74 20 74 68 65 20 75 6e 69 6e terpret the unin
36860 69 74 69 61 6c 69 7a 65 64 20 76 61 6c 75 65 73 itialized values
36870 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 0a and delete the.
36880 20 20 20 20 20 20 2a 2a 20 77 72 6f 6e 67 20 70 ** wrong p
36890 61 67 65 73 20 66 72 6f 6d 20 74 68 65 20 64 61 ages from the da
368a0 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 2a 2f tabase.. */
368b0 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 2d 3e . if( pBt->
368c0 61 75 74 6f 56 61 63 75 75 6d 20 26 26 20 72 63 autoVacuum && rc
368d0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
368e0 20 20 20 20 20 20 20 75 38 20 65 54 79 70 65 20 u8 eType
368f0 3d 20 28 70 67 6e 6f 50 74 72 6d 61 70 3f 50 54 = (pgnoPtrmap?PT
36900 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 3a 50 RMAP_OVERFLOW2:P
36910 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 31 29 TRMAP_OVERFLOW1)
36920 3b 0a 20 20 20 20 20 20 20 20 70 74 72 6d 61 70 ;. ptrmap
36930 50 75 74 28 70 42 74 2c 20 70 67 6e 6f 4f 76 66 Put(pBt, pgnoOvf
36940 6c 2c 20 65 54 79 70 65 2c 20 70 67 6e 6f 50 74 l, eType, pgnoPt
36950 72 6d 61 70 2c 20 26 72 63 29 3b 0a 20 20 20 20 rmap, &rc);.
36960 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 if( rc ){.
36970 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
36980 61 67 65 28 70 4f 76 66 6c 29 3b 0a 20 20 20 20 age(pOvfl);.
36990 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 23 65 }. }.#e
369a0 6e 64 69 66 0a 20 20 20 20 20 20 69 66 28 20 72 ndif. if( r
369b0 63 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 6c c ){. rel
369c0 65 61 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 easePage(pToRele
369d0 61 73 65 29 3b 0a 20 20 20 20 20 20 20 20 72 65 ase);. re
369e0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
369f0 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 54 .. /* If pT
36a00 6f 52 65 6c 65 61 73 65 20 69 73 20 6e 6f 74 20 oRelease is not
36a10 7a 65 72 6f 20 74 68 61 6e 20 70 50 72 69 6f 72 zero than pPrior
36a20 20 70 6f 69 6e 74 73 20 69 6e 74 6f 20 74 68 65 points into the
36a30 20 64 61 74 61 20 61 72 65 61 0a 20 20 20 20 20 data area.
36a40 20 2a 2a 20 6f 66 20 70 54 6f 52 65 6c 65 61 73 ** of pToReleas
36a50 65 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 70 54 e. Make sure pT
36a60 6f 52 65 6c 65 61 73 65 20 69 73 20 73 74 69 6c oRelease is stil
36a70 6c 20 77 72 69 74 65 61 62 6c 65 2e 20 2a 2f 0a l writeable. */.
36a80 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 54 assert( pT
36a90 6f 52 65 6c 65 61 73 65 3d 3d 30 20 7c 7c 20 73 oRelease==0 || s
36aa0 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 qlite3PagerIswri
36ab0 74 65 61 62 6c 65 28 70 54 6f 52 65 6c 65 61 73 teable(pToReleas
36ac0 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a e->pDbPage) );..
36ad0 20 20 20 20 20 20 2f 2a 20 49 66 20 70 50 72 69 /* If pPri
36ae0 6f 72 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 or is part of th
36af0 65 20 64 61 74 61 20 61 72 65 61 20 6f 66 20 70 e data area of p
36b00 50 61 67 65 2c 20 74 68 65 6e 20 6d 61 6b 65 20 Page, then make
36b10 73 75 72 65 20 70 50 61 67 65 0a 20 20 20 20 20 sure pPage.
36b20 20 2a 2a 20 69 73 20 73 74 69 6c 6c 20 77 72 69 ** is still wri
36b30 74 65 61 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 teable */.
36b40 61 73 73 65 72 74 28 20 70 50 72 69 6f 72 3c 70 assert( pPrior<p
36b50 50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c 20 70 Page->aData || p
36b60 50 72 69 6f 72 3e 3d 26 70 50 61 67 65 2d 3e 61 Prior>=&pPage->a
36b70 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 53 69 Data[pBt->pageSi
36b80 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 20 20 ze].
36b90 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 || sqlite3PagerI
36ba0 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 swriteable(pPage
36bb0 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 20 ->pDbPage) );..
36bc0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 70 50 put4byte(pP
36bd0 72 69 6f 72 2c 20 70 67 6e 6f 4f 76 66 6c 29 3b rior, pgnoOvfl);
36be0 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 . releasePa
36bf0 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 3b 0a ge(pToRelease);.
36c00 20 20 20 20 20 20 70 54 6f 52 65 6c 65 61 73 65 pToRelease
36c10 20 3d 20 70 4f 76 66 6c 3b 0a 20 20 20 20 20 20 = pOvfl;.
36c20 70 50 72 69 6f 72 20 3d 20 70 4f 76 66 6c 2d 3e pPrior = pOvfl->
36c30 61 44 61 74 61 3b 0a 20 20 20 20 20 20 70 75 74 aData;. put
36c40 34 62 79 74 65 28 70 50 72 69 6f 72 2c 20 30 29 4byte(pPrior, 0)
36c50 3b 0a 20 20 20 20 20 20 70 50 61 79 6c 6f 61 64 ;. pPayload
36c60 20 3d 20 26 70 4f 76 66 6c 2d 3e 61 44 61 74 61 = &pOvfl->aData
36c70 5b 34 5d 3b 0a 20 20 20 20 20 20 73 70 61 63 65 [4];. space
36c80 4c 65 66 74 20 3d 20 70 42 74 2d 3e 75 73 61 62 Left = pBt->usab
36c90 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 20 20 leSize - 4;.
36ca0 7d 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 50 }. }. releaseP
36cb0 61 67 65 28 70 54 6f 52 65 6c 65 61 73 65 29 3b age(pToRelease);
36cc0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
36cd0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 _OK;.}../*.** Re
36ce0 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 20 63 65 move the i-th ce
36cf0 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 20 20 ll from pPage.
36d00 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 66 66 This routine eff
36d10 65 63 74 73 20 70 50 61 67 65 20 6f 6e 6c 79 2e ects pPage only.
36d20 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 63 6f 6e .** The cell con
36d30 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 72 65 65 tent is not free
36d40 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 74 65 64 d or deallocated
36d50 2e 20 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 . It is assumed
36d60 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 65 6c that.** the cel
36d70 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 62 65 l content has be
36d80 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d 65 70 6c en copied somepl
36d90 61 63 65 20 65 6c 73 65 2e 20 20 54 68 69 73 20 ace else. This
36da0 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a 2a 2a 20 routine just.**
36db0 72 65 6d 6f 76 65 73 20 74 68 65 20 72 65 66 65 removes the refe
36dc0 72 65 6e 63 65 20 74 6f 20 74 68 65 20 63 65 6c rence to the cel
36dd0 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e 0a 2a 2a l from pPage..**
36de0 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 20 62 65 .** "sz" must be
36df0 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 the number of b
36e00 79 74 65 73 20 69 6e 20 74 68 65 20 63 65 6c 6c ytes in the cell
36e10 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
36e20 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d 50 61 67 dropCell(MemPag
36e30 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 69 64 e *pPage, int id
36e40 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e 74 20 2a x, int sz, int *
36e50 70 52 43 29 7b 0a 20 20 75 33 32 20 70 63 3b 20 pRC){. u32 pc;
36e60 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 /* Offse
36e70 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e 74 65 6e t to cell conten
36e80 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 6e 67 20 t of cell being
36e90 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 75 38 20 deleted */. u8
36ea0 2a 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 *data; /*
36eb0 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a 2f 0a pPage->aData */.
36ec0 20 20 75 38 20 2a 70 74 72 3b 20 20 20 20 20 20 u8 *ptr;
36ed0 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 6d 6f 76 /* Used to mov
36ee0 65 20 62 79 74 65 73 20 61 72 6f 75 6e 64 20 77 e bytes around w
36ef0 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 2a 2f 0a ithin data[] */.
36f00 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
36f10 20 20 2f 2a 20 54 68 65 20 72 65 74 75 72 6e 20 /* The return
36f20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 68 64 code */. int hd
36f30 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 42 65 67 r; /* Beg
36f40 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 68 65 inning of the he
36f50 61 64 65 72 2e 20 20 30 20 6d 6f 73 74 20 70 61 ader. 0 most pa
36f60 67 65 73 2e 20 20 31 30 30 20 70 61 67 65 20 31 ges. 100 page 1
36f70 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 20 */.. if( *pRC
36f80 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 73 65 ) return;. asse
36f90 72 74 28 20 69 64 78 3e 3d 30 20 26 26 20 69 64 rt( idx>=0 && id
36fa0 78 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 x<pPage->nCell )
36fb0 3b 0a 20 20 61 73 73 65 72 74 28 20 43 4f 52 52 ;. assert( CORR
36fc0 55 50 54 5f 44 42 20 7c 7c 20 73 7a 3d 3d 63 65 UPT_DB || sz==ce
36fd0 6c 6c 53 69 7a 65 28 70 50 61 67 65 2c 20 69 64 llSize(pPage, id
36fe0 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
36ff0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
37000 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 iteable(pPage->p
37010 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 DbPage) );. ass
37020 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
37030 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 ex_held(pPage->p
37040 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 Bt->mutex) );.
37050 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
37060 61 74 61 3b 0a 20 20 70 74 72 20 3d 20 26 70 50 ata;. ptr = &pP
37070 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a age->aCellIdx[2*
37080 69 64 78 5d 3b 0a 20 20 70 63 20 3d 20 67 65 74 idx];. pc = get
37090 32 62 79 74 65 28 70 74 72 29 3b 0a 20 20 68 64 2byte(ptr);. hd
370a0 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 r = pPage->hdrOf
370b0 66 73 65 74 3b 0a 20 20 74 65 73 74 63 61 73 65 fset;. testcase
370c0 28 20 70 63 3d 3d 67 65 74 32 62 79 74 65 28 26 ( pc==get2byte(&
370d0 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 29 3b 0a data[hdr+5]) );.
370e0 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
370f0 7a 3d 3d 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 z==pPage->pBt->u
37100 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 69 sableSize );. i
37110 66 28 20 70 63 2b 73 7a 20 3e 20 70 50 61 67 65 f( pc+sz > pPage
37120 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
37130 65 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 e ){. *pRC =
37140 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
37150 4b 50 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b KPT;. return;
37160 0a 20 20 7d 0a 20 20 72 63 20 3d 20 66 72 65 65 . }. rc = free
37170 53 70 61 63 65 28 70 50 61 67 65 2c 20 70 63 2c Space(pPage, pc,
37180 20 73 7a 29 3b 0a 20 20 69 66 28 20 72 63 20 29 sz);. if( rc )
37190 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 72 63 3b {. *pRC = rc;
371a0 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d . return;. }
371b0 0a 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2d . pPage->nCell-
371c0 2d 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e -;. if( pPage->
371d0 6e 43 65 6c 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 nCell==0 ){.
371e0 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 68 64 72 memset(&data[hdr
371f0 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a 20 20 20 20 +1], 0, 4);.
37200 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 3b data[hdr+7] = 0;
37210 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 26 64 . put2byte(&d
37220 61 74 61 5b 68 64 72 2b 35 5d 2c 20 70 50 61 67 ata[hdr+5], pPag
37230 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 e->pBt->usableSi
37240 7a 65 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e ze);. pPage->
37250 6e 46 72 65 65 20 3d 20 70 50 61 67 65 2d 3e 70 nFree = pPage->p
37260 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d Bt->usableSize -
37270 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 pPage->hdrOffse
37280 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t.
37290 20 20 20 20 20 20 20 20 20 2d 20 70 50 61 67 65 - pPage
372a0 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 2d ->childPtrSize -
372b0 20 38 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 8;. }else{.
372c0 20 6d 65 6d 6d 6f 76 65 28 70 74 72 2c 20 70 74 memmove(ptr, pt
372d0 72 2b 32 2c 20 32 2a 28 70 50 61 67 65 2d 3e 6e r+2, 2*(pPage->n
372e0 43 65 6c 6c 20 2d 20 69 64 78 29 29 3b 0a 20 20 Cell - idx));.
372f0 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
37300 5b 68 64 72 2b 33 5d 2c 20 70 50 61 67 65 2d 3e [hdr+3], pPage->
37310 6e 43 65 6c 6c 29 3b 0a 20 20 20 20 70 50 61 67 nCell);. pPag
37320 65 2d 3e 6e 46 72 65 65 20 2b 3d 20 32 3b 0a 20 e->nFree += 2;.
37330 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 73 65 }.}../*.** Inse
37340 72 74 20 61 20 6e 65 77 20 63 65 6c 6c 20 6f 6e rt a new cell on
37350 20 70 50 61 67 65 20 61 74 20 63 65 6c 6c 20 69 pPage at cell i
37360 6e 64 65 78 20 22 69 22 2e 20 20 70 43 65 6c 6c ndex "i". pCell
37370 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a points to the.*
37380 2a 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 * content of the
37390 20 63 65 6c 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 cell..**.** If
373a0 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 the cell content
373b0 20 77 69 6c 6c 20 66 69 74 20 6f 6e 20 74 68 65 will fit on the
373c0 20 70 61 67 65 2c 20 74 68 65 6e 20 70 75 74 20 page, then put
373d0 69 74 20 74 68 65 72 65 2e 20 20 49 66 20 69 74 it there. If it
373e0 0a 2a 2a 20 77 69 6c 6c 20 6e 6f 74 20 66 69 74 .** will not fit
373f0 2c 20 74 68 65 6e 20 6d 61 6b 65 20 61 20 63 6f , then make a co
37400 70 79 20 6f 66 20 74 68 65 20 63 65 6c 6c 20 63 py of the cell c
37410 6f 6e 74 65 6e 74 20 69 6e 74 6f 20 70 54 65 6d ontent into pTem
37420 70 20 69 66 0a 2a 2a 20 70 54 65 6d 70 20 69 73 p if.** pTemp is
37430 20 6e 6f 74 20 6e 75 6c 6c 2e 20 20 52 65 67 61 not null. Rega
37440 72 64 6c 65 73 73 20 6f 66 20 70 54 65 6d 70 2c rdless of pTemp,
37450 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 77 20 allocate a new
37460 65 6e 74 72 79 0a 2a 2a 20 69 6e 20 70 50 61 67 entry.** in pPag
37470 65 2d 3e 61 70 4f 76 66 6c 5b 5d 20 61 6e 64 20 e->apOvfl[] and
37480 6d 61 6b 65 20 69 74 20 70 6f 69 6e 74 20 74 6f make it point to
37490 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e the cell conten
374a0 74 20 28 65 69 74 68 65 72 0a 2a 2a 20 69 6e 20 t (either.** in
374b0 70 54 65 6d 70 20 6f 72 20 74 68 65 20 6f 72 69 pTemp or the ori
374c0 67 69 6e 61 6c 20 70 43 65 6c 6c 29 20 61 6e 64 ginal pCell) and
374d0 20 61 6c 73 6f 20 72 65 63 6f 72 64 20 69 74 73 also record its
374e0 20 69 6e 64 65 78 2e 20 0a 2a 2a 20 41 6c 6c 6f index. .** Allo
374f0 63 61 74 69 6e 67 20 61 20 6e 65 77 20 65 6e 74 cating a new ent
37500 72 79 20 69 6e 20 70 50 61 67 65 2d 3e 61 43 65 ry in pPage->aCe
37510 6c 6c 5b 5d 20 69 6d 70 6c 69 65 73 20 74 68 61 ll[] implies tha
37520 74 20 0a 2a 2a 20 70 50 61 67 65 2d 3e 6e 4f 76 t .** pPage->nOv
37530 65 72 66 6c 6f 77 20 69 73 20 69 6e 63 72 65 6d erflow is increm
37540 65 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 2a 70 52 ented..**.** *pR
37550 43 20 6d 75 73 74 20 62 65 20 53 51 4c 49 54 45 C must be SQLITE
37560 5f 4f 4b 20 77 68 65 6e 20 74 68 69 73 20 72 6f _OK when this ro
37570 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e utine is called.
37580 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
37590 69 6e 73 65 72 74 43 65 6c 6c 28 0a 20 20 4d 65 insertCell(. Me
375a0 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
375b0 2f 2a 20 50 61 67 65 20 69 6e 74 6f 20 77 68 69 /* Page into whi
375c0 63 68 20 77 65 20 61 72 65 20 63 6f 70 79 69 6e ch we are copyin
375d0 67 20 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 20 20 g */. int i,
375e0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 20 /* New
375f0 63 65 6c 6c 20 62 65 63 6f 6d 65 73 20 74 68 65 cell becomes the
37600 20 69 2d 74 68 20 63 65 6c 6c 20 6f 66 20 74 68 i-th cell of th
37610 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a e page */. u8 *
37620 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 2f 2a pCell, /*
37630 20 43 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 Content of the
37640 6e 65 77 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 6e new cell */. in
37650 74 20 73 7a 2c 20 20 20 20 20 20 20 20 20 20 20 t sz,
37660 2f 2a 20 42 79 74 65 73 20 6f 66 20 63 6f 6e 74 /* Bytes of cont
37670 65 6e 74 20 69 6e 20 70 43 65 6c 6c 20 2a 2f 0a ent in pCell */.
37680 20 20 75 38 20 2a 70 54 65 6d 70 2c 20 20 20 20 u8 *pTemp,
37690 20 20 20 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 /* Temp stor
376a0 61 67 65 20 73 70 61 63 65 20 66 6f 72 20 70 43 age space for pC
376b0 65 6c 6c 2c 20 69 66 20 6e 65 65 64 65 64 20 2a ell, if needed *
376c0 2f 0a 20 20 50 67 6e 6f 20 69 43 68 69 6c 64 2c /. Pgno iChild,
376d0 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 6e 2d /* If non-
376e0 7a 65 72 6f 2c 20 72 65 70 6c 61 63 65 20 66 69 zero, replace fi
376f0 72 73 74 20 34 20 62 79 74 65 73 20 77 69 74 68 rst 4 bytes with
37700 20 74 68 69 73 20 76 61 6c 75 65 20 2a 2f 0a 20 this value */.
37710 20 69 6e 74 20 2a 70 52 43 20 20 20 20 20 20 20 int *pRC
37720 20 20 20 2f 2a 20 52 65 61 64 20 61 6e 64 20 77 /* Read and w
37730 72 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 65 rite return code
37740 20 66 72 6f 6d 20 68 65 72 65 20 2a 2f 0a 29 7b from here */.){
37750 0a 20 20 69 6e 74 20 69 64 78 20 3d 20 30 3b 20 . int idx = 0;
37760 20 20 20 20 20 2f 2a 20 57 68 65 72 65 20 74 6f /* Where to
37770 20 77 72 69 74 65 20 6e 65 77 20 63 65 6c 6c 20 write new cell
37780 63 6f 6e 74 65 6e 74 20 69 6e 20 64 61 74 61 5b content in data[
37790 5d 20 2a 2f 0a 20 20 69 6e 74 20 6a 3b 20 20 20 ] */. int j;
377a0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
377b0 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 75 38 counter */. u8
377c0 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 20 20 *data;
377d0 2f 2a 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 6f /* The content o
377e0 66 20 74 68 65 20 77 68 6f 6c 65 20 70 61 67 65 f the whole page
377f0 20 2a 2f 0a 20 20 75 38 20 2a 70 49 6e 73 3b 20 */. u8 *pIns;
37800 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 /* The p
37810 6f 69 6e 74 20 69 6e 20 70 50 61 67 65 2d 3e 61 oint in pPage->a
37820 43 65 6c 6c 49 64 78 5b 5d 20 77 68 65 72 65 20 CellIdx[] where
37830 6e 6f 20 63 65 6c 6c 20 69 6e 73 65 72 74 65 64 no cell inserted
37840 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 2a */.. assert( *
37850 70 52 43 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 pRC==SQLITE_OK )
37860 3b 0a 20 20 61 73 73 65 72 74 28 20 69 3e 3d 30 ;. assert( i>=0
37870 20 26 26 20 69 3c 3d 70 50 61 67 65 2d 3e 6e 43 && i<=pPage->nC
37880 65 6c 6c 2b 70 50 61 67 65 2d 3e 6e 4f 76 65 72 ell+pPage->nOver
37890 66 6c 6f 77 20 29 3b 0a 20 20 61 73 73 65 72 74 flow );. assert
378a0 28 20 4d 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d ( MX_CELL(pPage-
378b0 3e 70 42 74 29 3c 3d 31 30 39 32 31 20 29 3b 0a >pBt)<=10921 );.
378c0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
378d0 3e 6e 43 65 6c 6c 3c 3d 4d 58 5f 43 45 4c 4c 28 >nCell<=MX_CELL(
378e0 70 50 61 67 65 2d 3e 70 42 74 29 20 7c 7c 20 43 pPage->pBt) || C
378f0 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 20 20 61 ORRUPT_DB );. a
37900 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f ssert( pPage->nO
37910 76 65 72 66 6c 6f 77 3c 3d 41 72 72 61 79 53 69 verflow<=ArraySi
37920 7a 65 28 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c ze(pPage->apOvfl
37930 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 41 ) );. assert( A
37940 72 72 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e rraySize(pPage->
37950 61 70 4f 76 66 6c 29 3d 3d 41 72 72 61 79 53 69 apOvfl)==ArraySi
37960 7a 65 28 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c ze(pPage->aiOvfl
37970 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
37980 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
37990 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
379a0 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 68 65 tex) );. /* The
379b0 20 63 65 6c 6c 20 73 68 6f 75 6c 64 20 6e 6f 72 cell should nor
379c0 6d 61 6c 6c 79 20 62 65 20 73 69 7a 65 64 20 63 mally be sized c
379d0 6f 72 72 65 63 74 6c 79 2e 20 20 48 6f 77 65 76 orrectly. Howev
379e0 65 72 2c 20 77 68 65 6e 20 6d 6f 76 69 6e 67 20 er, when moving
379f0 61 0a 20 20 2a 2a 20 6d 61 6c 66 6f 72 6d 65 64 a. ** malformed
37a00 20 63 65 6c 6c 20 66 72 6f 6d 20 61 20 6c 65 61 cell from a lea
37a10 66 20 70 61 67 65 20 74 6f 20 61 6e 20 69 6e 74 f page to an int
37a20 65 72 69 6f 72 20 70 61 67 65 2c 20 69 66 20 74 erior page, if t
37a30 68 65 20 63 65 6c 6c 20 73 69 7a 65 0a 20 20 2a he cell size. *
37a40 2a 20 77 61 6e 74 65 64 20 74 6f 20 62 65 20 6c * wanted to be l
37a50 65 73 73 20 74 68 61 6e 20 34 20 62 75 74 20 67 ess than 4 but g
37a60 6f 74 20 72 6f 75 6e 64 65 64 20 75 70 20 74 6f ot rounded up to
37a70 20 34 20 6f 6e 20 74 68 65 20 6c 65 61 66 2c 20 4 on the leaf,
37a80 74 68 65 6e 20 73 69 7a 65 0a 20 20 2a 2a 20 6d then size. ** m
37a90 69 67 68 74 20 62 65 20 6c 65 73 73 20 74 68 61 ight be less tha
37aa0 6e 20 38 20 28 6c 65 61 66 2d 73 69 7a 65 20 2b n 8 (leaf-size +
37ab0 20 70 6f 69 6e 74 65 72 29 20 6f 6e 20 74 68 65 pointer) on the
37ac0 20 69 6e 74 65 72 69 6f 72 20 6e 6f 64 65 2e 20 interior node.
37ad0 20 48 65 6e 63 65 0a 20 20 2a 2a 20 74 68 65 20 Hence. ** the
37ae0 74 65 72 6d 20 61 66 74 65 72 20 74 68 65 20 7c term after the |
37af0 7c 20 69 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 | in the followi
37b00 6e 67 20 61 73 73 65 72 74 28 29 2e 20 2a 2f 0a ng assert(). */.
37b10 20 20 61 73 73 65 72 74 28 20 73 7a 3d 3d 70 50 assert( sz==pP
37b20 61 67 65 2d 3e 78 43 65 6c 6c 53 69 7a 65 28 70 age->xCellSize(p
37b30 50 61 67 65 2c 20 70 43 65 6c 6c 29 20 7c 7c 20 Page, pCell) ||
37b40 28 73 7a 3d 3d 38 20 26 26 20 69 43 68 69 6c 64 (sz==8 && iChild
37b50 3e 30 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61 >0) );. if( pPa
37b60 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 7c 7c ge->nOverflow ||
37b70 20 73 7a 2b 32 3e 70 50 61 67 65 2d 3e 6e 46 72 sz+2>pPage->nFr
37b80 65 65 20 29 7b 0a 20 20 20 20 69 66 28 20 70 54 ee ){. if( pT
37b90 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d emp ){. mem
37ba0 63 70 79 28 70 54 65 6d 70 2c 20 70 43 65 6c 6c cpy(pTemp, pCell
37bb0 2c 20 73 7a 29 3b 0a 20 20 20 20 20 20 70 43 65 , sz);. pCe
37bc0 6c 6c 20 3d 20 70 54 65 6d 70 3b 0a 20 20 20 20 ll = pTemp;.
37bd0 7d 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 }. if( iChild
37be0 20 29 7b 0a 20 20 20 20 20 20 70 75 74 34 62 79 ){. put4by
37bf0 74 65 28 70 43 65 6c 6c 2c 20 69 43 68 69 6c 64 te(pCell, iChild
37c00 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6a 20 3d );. }. j =
37c10 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f pPage->nOverflo
37c20 77 2b 2b 3b 0a 20 20 20 20 2f 2a 20 43 6f 6d 70 w++;. /* Comp
37c30 61 72 69 73 6f 6e 20 61 67 61 69 6e 73 74 20 41 arison against A
37c40 72 72 61 79 53 69 7a 65 2d 31 20 73 69 6e 63 65 rraySize-1 since
37c50 20 77 65 20 68 6f 6c 64 20 62 61 63 6b 20 6f 6e we hold back on
37c60 65 20 65 78 74 72 61 20 73 6c 6f 74 0a 20 20 20 e extra slot.
37c70 20 2a 2a 20 61 73 20 61 20 63 6f 6e 74 69 6e 67 ** as a conting
37c80 65 6e 63 79 2e 20 20 49 6e 20 6f 74 68 65 72 20 ency. In other
37c90 77 6f 72 64 73 2c 20 6e 65 76 65 72 20 6e 65 65 words, never nee
37ca0 64 20 6d 6f 72 65 20 74 68 61 6e 20 33 20 6f 76 d more than 3 ov
37cb0 65 72 66 6c 6f 77 0a 20 20 20 20 2a 2a 20 73 6c erflow. ** sl
37cc0 6f 74 73 20 62 75 74 20 34 20 61 72 65 20 61 6c ots but 4 are al
37cd0 6c 6f 63 61 74 65 64 2c 20 6a 75 73 74 20 74 6f located, just to
37ce0 20 62 65 20 73 61 66 65 2e 20 2a 2f 0a 20 20 20 be safe. */.
37cf0 20 61 73 73 65 72 74 28 20 6a 20 3c 20 41 72 72 assert( j < Arr
37d00 61 79 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 aySize(pPage->ap
37d10 4f 76 66 6c 29 2d 31 20 29 3b 0a 20 20 20 20 70 Ovfl)-1 );. p
37d20 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 6a 5d 20 Page->apOvfl[j]
37d30 3d 20 70 43 65 6c 6c 3b 0a 20 20 20 20 70 50 61 = pCell;. pPa
37d40 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 5d 20 3d 20 ge->aiOvfl[j] =
37d50 28 75 31 36 29 69 3b 0a 0a 20 20 20 20 2f 2a 20 (u16)i;.. /*
37d60 57 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 6f 76 When multiple ov
37d70 65 72 66 6c 6f 77 73 20 6f 63 63 75 72 2c 20 74 erflows occur, t
37d80 68 65 79 20 61 72 65 20 61 6c 77 61 79 73 20 73 hey are always s
37d90 65 71 75 65 6e 74 69 61 6c 20 61 6e 64 20 69 6e equential and in
37da0 0a 20 20 20 20 2a 2a 20 73 6f 72 74 65 64 20 6f . ** sorted o
37db0 72 64 65 72 2e 20 20 54 68 69 73 20 69 6e 76 61 rder. This inva
37dc0 72 69 61 6e 74 73 20 61 72 69 73 65 20 62 65 63 riants arise bec
37dd0 61 75 73 65 20 6d 75 6c 74 69 70 6c 65 20 6f 76 ause multiple ov
37de0 65 72 66 6c 6f 77 73 20 63 61 6e 0a 20 20 20 20 erflows can.
37df0 2a 2a 20 6f 6e 6c 79 20 6f 63 63 75 72 20 77 68 ** only occur wh
37e00 65 6e 20 69 6e 73 65 72 74 69 6e 67 20 64 69 76 en inserting div
37e10 69 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 6f 20 ider cells into
37e20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 20 the parent page
37e30 64 75 72 69 6e 67 0a 20 20 20 20 2a 2a 20 62 61 during. ** ba
37e40 6c 61 6e 63 69 6e 67 2c 20 61 6e 64 20 74 68 65 lancing, and the
37e50 20 64 69 76 69 64 65 72 73 20 61 72 65 20 61 64 dividers are ad
37e60 6a 61 63 65 6e 74 20 61 6e 64 20 73 6f 72 74 65 jacent and sorte
37e70 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 d.. */. as
37e80 73 65 72 74 28 20 6a 3d 3d 30 20 7c 7c 20 70 50 sert( j==0 || pP
37e90 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 6a 2d 31 5d age->aiOvfl[j-1]
37ea0 3c 28 75 31 36 29 69 20 29 3b 20 2f 2a 20 4f 76 <(u16)i ); /* Ov
37eb0 65 72 66 6c 6f 77 73 20 69 6e 20 73 6f 72 74 65 erflows in sorte
37ec0 64 20 6f 72 64 65 72 20 2a 2f 0a 20 20 20 20 61 d order */. a
37ed0 73 73 65 72 74 28 20 6a 3d 3d 30 20 7c 7c 20 69 ssert( j==0 || i
37ee0 3d 3d 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b ==pPage->aiOvfl[
37ef0 6a 2d 31 5d 2b 31 20 29 3b 20 20 20 2f 2a 20 4f j-1]+1 ); /* O
37f00 76 65 72 66 6c 6f 77 73 20 61 72 65 20 73 65 71 verflows are seq
37f10 75 65 6e 74 69 61 6c 20 2a 2f 0a 20 20 7d 65 6c uential */. }el
37f20 73 65 7b 0a 20 20 20 20 69 6e 74 20 72 63 20 3d se{. int rc =
37f30 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
37f40 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 te(pPage->pDbPag
37f50 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d e);. if( rc!=
37f60 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
37f70 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 *pRC = rc;.
37f80 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 return;.
37f90 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 }. assert( sq
37fa0 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
37fb0 65 61 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 eable(pPage->pDb
37fc0 50 61 67 65 29 20 29 3b 0a 20 20 20 20 64 61 74 Page) );. dat
37fd0 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 61 74 61 a = pPage->aData
37fe0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 26 64 ;. assert( &d
37ff0 61 74 61 5b 70 50 61 67 65 2d 3e 63 65 6c 6c 4f ata[pPage->cellO
38000 66 66 73 65 74 5d 3d 3d 70 50 61 67 65 2d 3e 61 ffset]==pPage->a
38010 43 65 6c 6c 49 64 78 20 29 3b 0a 20 20 20 20 72 CellIdx );. r
38020 63 20 3d 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 c = allocateSpac
38030 65 28 70 50 61 67 65 2c 20 73 7a 2c 20 26 69 64 e(pPage, sz, &id
38040 78 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 x);. if( rc )
38050 7b 20 2a 70 52 43 20 3d 20 72 63 3b 20 72 65 74 { *pRC = rc; ret
38060 75 72 6e 3b 20 7d 0a 20 20 20 20 2f 2a 20 54 68 urn; }. /* Th
38070 65 20 61 6c 6c 6f 63 61 74 65 53 70 61 63 65 28 e allocateSpace(
38080 29 20 72 6f 75 74 69 6e 65 20 67 75 61 72 61 6e ) routine guaran
38090 74 65 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 tees the followi
380a0 6e 67 20 70 72 6f 70 65 72 74 69 65 73 0a 20 20 ng properties.
380b0 20 20 2a 2a 20 69 66 20 69 74 20 72 65 74 75 72 ** if it retur
380c0 6e 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 ns successfully
380d0 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 */. assert( i
380e0 64 78 20 3e 3d 20 30 20 29 3b 0a 20 20 20 20 61 dx >= 0 );. a
380f0 73 73 65 72 74 28 20 69 64 78 20 3e 3d 20 70 50 ssert( idx >= pP
38100 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 2b age->cellOffset+
38110 32 2a 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 2b 32 2*pPage->nCell+2
38120 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 || CORRUPT_DB )
38130 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 64 ;. assert( id
38140 78 2b 73 7a 20 3c 3d 20 28 69 6e 74 29 70 50 61 x+sz <= (int)pPa
38150 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
38160 69 7a 65 20 29 3b 0a 20 20 20 20 70 50 61 67 65 ize );. pPage
38170 2d 3e 6e 46 72 65 65 20 2d 3d 20 28 75 31 36 29 ->nFree -= (u16)
38180 28 32 20 2b 20 73 7a 29 3b 0a 20 20 20 20 6d 65 (2 + sz);. me
38190 6d 63 70 79 28 26 64 61 74 61 5b 69 64 78 5d 2c mcpy(&data[idx],
381a0 20 70 43 65 6c 6c 2c 20 73 7a 29 3b 0a 20 20 20 pCell, sz);.
381b0 20 69 66 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 if( iChild ){.
381c0 20 20 20 20 20 70 75 74 34 62 79 74 65 28 26 64 put4byte(&d
381d0 61 74 61 5b 69 64 78 5d 2c 20 69 43 68 69 6c 64 ata[idx], iChild
381e0 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 49 6e );. }. pIn
381f0 73 20 3d 20 70 50 61 67 65 2d 3e 61 43 65 6c 6c s = pPage->aCell
38200 49 64 78 20 2b 20 69 2a 32 3b 0a 20 20 20 20 6d Idx + i*2;. m
38210 65 6d 6d 6f 76 65 28 70 49 6e 73 2b 32 2c 20 70 emmove(pIns+2, p
38220 49 6e 73 2c 20 32 2a 28 70 50 61 67 65 2d 3e 6e Ins, 2*(pPage->n
38230 43 65 6c 6c 20 2d 20 69 29 29 3b 0a 20 20 20 20 Cell - i));.
38240 70 75 74 32 62 79 74 65 28 70 49 6e 73 2c 20 69 put2byte(pIns, i
38250 64 78 29 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e dx);. pPage->
38260 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 20 2f 2a 20 nCell++;. /*
38270 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 65 increment the ce
38280 6c 6c 20 63 6f 75 6e 74 20 2a 2f 0a 20 20 20 20 ll count */.
38290 69 66 28 20 28 2b 2b 64 61 74 61 5b 70 50 61 67 if( (++data[pPag
382a0 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 34 5d 29 e->hdrOffset+4])
382b0 3d 3d 30 20 29 20 64 61 74 61 5b 70 50 61 67 65 ==0 ) data[pPage
382c0 2d 3e 68 64 72 4f 66 66 73 65 74 2b 33 5d 2b 2b ->hdrOffset+3]++
382d0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 65 ;. assert( ge
382e0 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 50 61 t2byte(&data[pPa
382f0 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 33 5d ge->hdrOffset+3]
38300 29 3d 3d 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 )==pPage->nCell
38310 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
38320 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
38330 4d 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 2d M. if( pPage-
38340 3e 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d >pBt->autoVacuum
38350 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 ){. /* The
38360 20 63 65 6c 6c 20 6d 61 79 20 63 6f 6e 74 61 69 cell may contai
38370 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 n a pointer to a
38380 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e n overflow page.
38390 20 49 66 20 73 6f 2c 20 77 72 69 74 65 0a 20 20 If so, write.
383a0 20 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 72 79 ** the entry
383b0 20 66 6f 72 20 74 68 65 20 6f 76 65 72 66 6c 6f for the overflo
383c0 77 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 w page into the
383d0 70 6f 69 6e 74 65 72 20 6d 61 70 2e 0a 20 20 20 pointer map..
383e0 20 20 20 2a 2f 0a 20 20 20 20 20 20 70 74 72 6d */. ptrm
383f0 61 70 50 75 74 4f 76 66 6c 50 74 72 28 70 50 61 apPutOvflPtr(pPa
38400 67 65 2c 20 70 43 65 6c 6c 2c 20 70 52 43 29 3b ge, pCell, pRC);
38410 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
38420 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 43 65 6c }.}../*.** A Cel
38430 6c 41 72 72 61 79 20 6f 62 6a 65 63 74 20 63 6f lArray object co
38440 6e 74 61 69 6e 73 20 61 20 63 61 63 68 65 20 6f ntains a cache o
38450 66 20 70 6f 69 6e 74 65 72 73 20 61 6e 64 20 73 f pointers and s
38460 69 7a 65 73 20 66 6f 72 20 61 0a 2a 2a 20 63 6f izes for a.** co
38470 6e 73 65 63 75 74 69 76 65 20 73 65 71 75 65 6e nsecutive sequen
38480 63 65 20 6f 66 20 63 65 6c 6c 73 20 74 68 61 74 ce of cells that
38490 20 6d 69 67 68 74 20 62 65 20 68 65 6