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 20 65 78 74 65 mplements a exte
0190: 72 6e 61 6c 20 28 64 69 73 6b 2d 62 61 73 65 64 rnal (disk-based
01a0: 29 20 64 61 74 61 62 61 73 65 20 75 73 69 6e 67 ) database using
01b0: 20 42 54 72 65 65 73 2e 0a 2a 2a 20 53 65 65 20 BTrees..** See
01c0: 74 68 65 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 the header comme
01d0: 6e 74 20 6f 6e 20 22 62 74 72 65 65 49 6e 74 2e nt on "btreeInt.
01e0: 68 22 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 h" for additiona
01f0: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a l information..*
0200: 2a 20 49 6e 63 6c 75 64 69 6e 67 20 61 20 64 65 * Including a de
0210: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 66 69 6c scription of fil
0220: 65 20 66 6f 72 6d 61 74 20 61 6e 64 20 61 6e 20 e format and an
0230: 6f 76 65 72 76 69 65 77 20 6f 66 20 6f 70 65 72 overview of oper
0240: 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 ation..*/.#inclu
0250: 64 65 20 22 62 74 72 65 65 49 6e 74 2e 68 22 0a de "btreeInt.h".
0260: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 65 ./*.** The heade
0270: 72 20 73 74 72 69 6e 67 20 74 68 61 74 20 61 70 r string that ap
0280: 70 65 61 72 73 20 61 74 20 74 68 65 20 62 65 67 pears at the beg
0290: 69 6e 6e 69 6e 67 20 6f 66 20 65 76 65 72 79 0a inning of every.
02a0: 2a 2a 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 ** SQLite databa
02b0: 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 6f se..*/.static co
02c0: 6e 73 74 20 63 68 61 72 20 7a 4d 61 67 69 63 48 nst char zMagicH
02d0: 65 61 64 65 72 5b 5d 20 3d 20 53 51 4c 49 54 45 eader[] = SQLITE
02e0: 5f 46 49 4c 45 5f 48 45 41 44 45 52 3b 0a 0a 2f _FILE_HEADER;../
02f0: 2a 0a 2a 2a 20 53 65 74 20 74 68 69 73 20 67 6c *.** Set this gl
0300: 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 20 74 6f obal variable to
0310: 20 31 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 61 1 to enable tra
0320: 63 69 6e 67 20 75 73 69 6e 67 20 74 68 65 20 54 cing using the T
0330: 52 41 43 45 0a 2a 2a 20 6d 61 63 72 6f 2e 0a 2a RACE.** macro..*
0340: 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 71 6c 69 /.#if 0.int sqli
0350: 74 65 33 42 74 72 65 65 54 72 61 63 65 3d 31 3b te3BtreeTrace=1;
0360: 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 /* True to ena
0370: 62 6c 65 20 74 72 61 63 69 6e 67 20 2a 2f 0a 23 ble tracing */.#
0380: 20 64 65 66 69 6e 65 20 54 52 41 43 45 28 58 29 define TRACE(X)
0390: 20 20 69 66 28 73 71 6c 69 74 65 33 42 74 72 65 if(sqlite3Btre
03a0: 65 54 72 61 63 65 29 7b 70 72 69 6e 74 66 20 58 eTrace){printf X
03b0: 3b 66 66 6c 75 73 68 28 73 74 64 6f 75 74 29 3b ;fflush(stdout);
03c0: 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 }.#else.# define
03d0: 20 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 66 TRACE(X).#endif
03e0: 0a 0a 2f 2a 0a 2a 2a 20 45 78 74 72 61 63 74 20 ../*.** Extract
03f0: 61 20 32 2d 62 79 74 65 20 62 69 67 2d 65 6e 64 a 2-byte big-end
0400: 69 61 6e 20 69 6e 74 65 67 65 72 20 66 72 6f 6d ian integer from
0410: 20 61 6e 20 61 72 72 61 79 20 6f 66 20 75 6e 73 an array of uns
0420: 69 67 6e 65 64 20 62 79 74 65 73 2e 0a 2a 2a 20 igned bytes..**
0430: 42 75 74 20 69 66 20 74 68 65 20 76 61 6c 75 65 But if the value
0440: 20 69 73 20 7a 65 72 6f 2c 20 6d 61 6b 65 20 69 is zero, make i
0450: 74 20 36 35 35 33 36 2e 0a 2a 2a 0a 2a 2a 20 54 t 65536..**.** T
0460: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 his routine is u
0470: 73 65 64 20 74 6f 20 65 78 74 72 61 63 74 20 74 sed to extract t
0480: 68 65 20 22 6f 66 66 73 65 74 20 74 6f 20 63 65 he "offset to ce
0490: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 22 ll content area"
04a0: 20 76 61 6c 75 65 0a 2a 2a 20 66 72 6f 6d 20 74 value.** from t
04b0: 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 62 he header of a b
04c0: 74 72 65 65 20 70 61 67 65 2e 20 20 49 66 20 74 tree page. If t
04d0: 68 65 20 70 61 67 65 20 73 69 7a 65 20 69 73 20 he page size is
04e0: 36 35 35 33 36 20 61 6e 64 20 74 68 65 20 70 61 65536 and the pa
04f0: 67 65 0a 2a 2a 20 69 73 20 65 6d 70 74 79 2c 20 ge.** is empty,
0500: 74 68 65 20 6f 66 66 73 65 74 20 73 68 6f 75 6c the offset shoul
0510: 64 20 62 65 20 36 35 35 33 36 2c 20 62 75 74 20 d be 65536, but
0520: 74 68 65 20 32 2d 62 79 74 65 20 76 61 6c 75 65 the 2-byte value
0530: 20 73 74 6f 72 65 73 20 7a 65 72 6f 2e 0a 2a 2a stores zero..**
0540: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 6d 61 This routine ma
0550: 6b 65 73 20 74 68 65 20 6e 65 63 65 73 73 61 72 kes the necessar
0560: 79 20 61 64 6a 75 73 74 6d 65 6e 74 20 74 6f 20 y adjustment to
0570: 36 35 35 33 36 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65536..*/.#defin
0580: 65 20 67 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 e get2byteNotZer
0590: 6f 28 58 29 20 20 28 28 28 28 28 69 6e 74 29 67 o(X) (((((int)g
05a0: 65 74 32 62 79 74 65 28 58 29 29 2d 31 29 26 30 et2byte(X))-1)&0
05b0: 78 66 66 66 66 29 2b 31 29 0a 0a 23 69 66 6e 64 xffff)+1)..#ifnd
05c0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
05d0: 48 41 52 45 44 5f 43 41 43 48 45 0a 2f 2a 0a 2a HARED_CACHE./*.*
05e0: 2a 20 41 20 6c 69 73 74 20 6f 66 20 42 74 53 68 * A list of BtSh
05f0: 61 72 65 64 20 6f 62 6a 65 63 74 73 20 74 68 61 ared objects tha
0600: 74 20 61 72 65 20 65 6c 69 67 69 62 6c 65 20 66 t are eligible f
0610: 6f 72 20 70 61 72 74 69 63 69 70 61 74 69 6f 6e or participation
0620: 0a 2a 2a 20 69 6e 20 73 68 61 72 65 64 20 63 61 .** in shared ca
0630: 63 68 65 2e 20 20 54 68 69 73 20 76 61 72 69 61 che. This varia
0640: 62 6c 65 20 68 61 73 20 66 69 6c 65 20 73 63 6f ble has file sco
0650: 70 65 20 64 75 72 69 6e 67 20 6e 6f 72 6d 61 6c pe during normal
0660: 20 62 75 69 6c 64 73 2c 0a 2a 2a 20 62 75 74 20 builds,.** but
0670: 74 68 65 20 74 65 73 74 20 68 61 72 6e 65 73 73 the test harness
0680: 20 6e 65 65 64 73 20 74 6f 20 61 63 63 65 73 73 needs to access
0690: 20 69 74 20 73 6f 20 77 65 20 6d 61 6b 65 20 69 it so we make i
06a0: 74 20 67 6c 6f 62 61 6c 20 66 6f 72 20 0a 2a 2a t global for .**
06b0: 20 74 65 73 74 20 62 75 69 6c 64 73 2e 0a 2a 2a test builds..**
06c0: 0a 2a 2a 20 41 63 63 65 73 73 20 74 6f 20 74 68 .** Access to th
06d0: 69 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 70 is variable is p
06e0: 72 6f 74 65 63 74 65 64 20 62 79 20 53 51 4c 49 rotected by SQLI
06f0: 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f TE_MUTEX_STATIC_
0700: 4d 41 53 54 45 52 2e 0a 2a 2f 0a 23 69 66 64 65 MASTER..*/.#ifde
0710: 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 42 74 f SQLITE_TEST.Bt
0720: 53 68 61 72 65 64 20 2a 53 51 4c 49 54 45 5f 57 Shared *SQLITE_W
0730: 53 44 20 73 71 6c 69 74 65 33 53 68 61 72 65 64 SD sqlite3Shared
0740: 43 61 63 68 65 4c 69 73 74 20 3d 20 30 3b 0a 23 CacheList = 0;.#
0750: 65 6c 73 65 0a 73 74 61 74 69 63 20 42 74 53 68 else.static BtSh
0760: 61 72 65 64 20 2a 53 51 4c 49 54 45 5f 57 53 44 ared *SQLITE_WSD
0770: 20 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 sqlite3SharedCa
0780: 63 68 65 4c 69 73 74 20 3d 20 30 3b 0a 23 65 6e cheList = 0;.#en
0790: 64 69 66 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 dif.#endif /* SQ
07a0: 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
07b0: 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 69 66 6e 64 _CACHE */..#ifnd
07c0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ef SQLITE_OMIT_S
07d0: 48 41 52 45 44 5f 43 41 43 48 45 0a 2f 2a 0a 2a HARED_CACHE./*.*
07e0: 2a 20 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 * Enable or disa
07f0: 62 6c 65 20 74 68 65 20 73 68 61 72 65 64 20 70 ble the shared p
0800: 61 67 65 72 20 61 6e 64 20 73 63 68 65 6d 61 20 ager and schema
0810: 66 65 61 74 75 72 65 73 2e 0a 2a 2a 0a 2a 2a 20 features..**.**
0820: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 68 61 73 This routine has
0830: 20 6e 6f 20 65 66 66 65 63 74 20 6f 6e 20 65 78 no effect on ex
0840: 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 65 20 isting database
0850: 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 0a 2a 2a 20 connections..**
0860: 54 68 65 20 73 68 61 72 65 64 20 63 61 63 68 65 The shared cache
0870: 20 73 65 74 74 69 6e 67 20 65 66 66 65 63 74 73 setting effects
0880: 20 6f 6e 6c 79 20 66 75 74 75 72 65 20 63 61 6c only future cal
0890: 6c 73 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 ls to.** sqlite3
08a0: 5f 6f 70 65 6e 28 29 2c 20 73 71 6c 69 74 65 33 _open(), sqlite3
08b0: 5f 6f 70 65 6e 31 36 28 29 2c 20 6f 72 20 73 71 _open16(), or sq
08c0: 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28 29 2e lite3_open_v2().
08d0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f .*/.int sqlite3_
08e0: 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 5f 63 61 enable_shared_ca
08f0: 63 68 65 28 69 6e 74 20 65 6e 61 62 6c 65 29 7b che(int enable){
0900: 0a 20 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c . sqlite3Global
0910: 43 6f 6e 66 69 67 2e 73 68 61 72 65 64 43 61 63 Config.sharedCac
0920: 68 65 45 6e 61 62 6c 65 64 20 3d 20 65 6e 61 62 heEnabled = enab
0930: 6c 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c le;. return SQL
0940: 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 ITE_OK;.}.#endif
0950: 0a 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 ....#ifdef SQLIT
0960: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
0970: 43 48 45 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 CHE. /*. ** Th
0980: 65 20 66 75 6e 63 74 69 6f 6e 73 20 71 75 65 72 e functions quer
0990: 79 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c ySharedCacheTabl
09a0: 65 4c 6f 63 6b 28 29 2c 20 73 65 74 53 68 61 72 eLock(), setShar
09b0: 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b edCacheTableLock
09c0: 28 29 2c 0a 20 20 2a 2a 20 61 6e 64 20 63 6c 65 (),. ** and cle
09d0: 61 72 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 arAllSharedCache
09e0: 54 61 62 6c 65 4c 6f 63 6b 73 28 29 0a 20 20 2a TableLocks(). *
09f0: 2a 20 6d 61 6e 69 70 75 6c 61 74 65 20 65 6e 74 * manipulate ent
0a00: 72 69 65 73 20 69 6e 20 74 68 65 20 42 74 53 68 ries in the BtSh
0a10: 61 72 65 64 2e 70 4c 6f 63 6b 20 6c 69 6e 6b 65 ared.pLock linke
0a20: 64 20 6c 69 73 74 20 75 73 65 64 20 74 6f 20 73 d list used to s
0a30: 74 6f 72 65 0a 20 20 2a 2a 20 73 68 61 72 65 64 tore. ** shared
0a40: 2d 63 61 63 68 65 20 74 61 62 6c 65 20 6c 65 76 -cache table lev
0a50: 65 6c 20 6c 6f 63 6b 73 2e 20 49 66 20 74 68 65 el locks. If the
0a60: 20 6c 69 62 72 61 72 79 20 69 73 20 63 6f 6d 70 library is comp
0a70: 69 6c 65 64 20 77 69 74 68 20 74 68 65 0a 20 20 iled with the.
0a80: 2a 2a 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 ** shared-cache
0a90: 66 65 61 74 75 72 65 20 64 69 73 61 62 6c 65 64 feature disabled
0aa0: 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 , then there is
0ab0: 6f 6e 6c 79 20 65 76 65 72 20 6f 6e 65 20 75 73 only ever one us
0ac0: 65 72 0a 20 20 2a 2a 20 6f 66 20 65 61 63 68 20 er. ** of each
0ad0: 42 74 53 68 61 72 65 64 20 73 74 72 75 63 74 75 BtShared structu
0ae0: 72 65 20 61 6e 64 20 73 6f 20 74 68 69 73 20 6c re and so this l
0af0: 6f 63 6b 69 6e 67 20 69 73 20 6e 6f 74 20 6e 65 ocking is not ne
0b00: 63 65 73 73 61 72 79 2e 20 0a 20 20 2a 2a 20 53 cessary. . ** S
0b10: 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6c 6f 63 o define the loc
0b20: 6b 20 72 65 6c 61 74 65 64 20 66 75 6e 63 74 69 k related functi
0b30: 6f 6e 73 20 61 73 20 6e 6f 2d 6f 70 73 2e 0a 20 ons as no-ops..
0b40: 20 2a 2f 0a 20 20 23 64 65 66 69 6e 65 20 71 75 */. #define qu
0b50: 65 72 79 53 68 61 72 65 64 43 61 63 68 65 54 61 erySharedCacheTa
0b60: 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 29 20 53 bleLock(a,b,c) S
0b70: 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 65 66 69 QLITE_OK. #defi
0b80: 6e 65 20 73 65 74 53 68 61 72 65 64 43 61 63 68 ne setSharedCach
0b90: 65 54 61 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 eTableLock(a,b,c
0ba0: 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 20 20 23 64 ) SQLITE_OK. #d
0bb0: 65 66 69 6e 65 20 63 6c 65 61 72 41 6c 6c 53 68 efine clearAllSh
0bc0: 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f aredCacheTableLo
0bd0: 63 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e 65 cks(a). #define
0be0: 20 64 6f 77 6e 67 72 61 64 65 41 6c 6c 53 68 61 downgradeAllSha
0bf0: 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 redCacheTableLoc
0c00: 6b 73 28 61 29 0a 20 20 23 64 65 66 69 6e 65 20 ks(a). #define
0c10: 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 hasSharedCacheTa
0c20: 62 6c 65 4c 6f 63 6b 28 61 2c 62 2c 63 2c 64 29 bleLock(a,b,c,d)
0c30: 20 31 0a 20 20 23 64 65 66 69 6e 65 20 68 61 73 1. #define has
0c40: 52 65 61 64 43 6f 6e 66 6c 69 63 74 73 28 61 2c ReadConflicts(a,
0c50: 20 62 29 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 b) 0.#endif..#i
0c60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
0c70: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 0a T_SHARED_CACHE..
0c80: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
0c90: 42 55 47 0a 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 73 BUG./*.**** This
0ca0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c function is onl
0cb0: 79 20 75 73 65 64 20 61 73 20 70 61 72 74 20 6f y used as part o
0cc0: 66 20 61 6e 20 61 73 73 65 72 74 28 29 20 73 74 f an assert() st
0cd0: 61 74 65 6d 65 6e 74 2e 20 2a 2a 2a 0a 2a 2a 0a atement. ***.**.
0ce0: 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 20 ** Check to see
0cf0: 69 66 20 70 42 74 72 65 65 20 68 6f 6c 64 73 20 if pBtree holds
0d00: 74 68 65 20 72 65 71 75 69 72 65 64 20 6c 6f 63 the required loc
0d10: 6b 73 20 74 6f 20 72 65 61 64 20 6f 72 20 77 72 ks to read or wr
0d20: 69 74 65 20 74 6f 20 74 68 65 20 0a 2a 2a 20 74 ite to the .** t
0d30: 61 62 6c 65 20 77 69 74 68 20 72 6f 6f 74 20 70 able with root p
0d40: 61 67 65 20 69 52 6f 6f 74 2e 20 20 20 52 65 74 age iRoot. Ret
0d50: 75 72 6e 20 31 20 69 66 20 69 74 20 64 6f 65 73 urn 1 if it does
0d60: 20 61 6e 64 20 30 20 69 66 20 6e 6f 74 2e 0a 2a and 0 if not..*
0d70: 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 *.** For example
0d80: 2c 20 77 68 65 6e 20 77 72 69 74 69 6e 67 20 74 , when writing t
0d90: 6f 20 61 20 74 61 62 6c 65 20 77 69 74 68 20 72 o a table with r
0da0: 6f 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 20 76 oot-page iRoot v
0db0: 69 61 20 0a 2a 2a 20 42 74 72 65 65 20 63 6f 6e ia .** Btree con
0dc0: 6e 65 63 74 69 6f 6e 20 70 42 74 72 65 65 3a 0a nection pBtree:.
0dd0: 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 28 **.** assert(
0de0: 20 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 hasSharedCacheT
0df0: 61 62 6c 65 4c 6f 63 6b 28 70 42 74 72 65 65 2c ableLock(pBtree,
0e00: 20 69 52 6f 6f 74 2c 20 30 2c 20 57 52 49 54 45 iRoot, 0, WRITE
0e10: 5f 4c 4f 43 4b 29 20 29 3b 0a 2a 2a 0a 2a 2a 20 _LOCK) );.**.**
0e20: 57 68 65 6e 20 77 72 69 74 69 6e 67 20 74 6f 20 When writing to
0e30: 61 6e 20 69 6e 64 65 78 20 74 68 61 74 20 72 65 an index that re
0e40: 73 69 64 65 73 20 69 6e 20 61 20 73 68 61 72 61 sides in a shara
0e50: 62 6c 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 ble database, th
0e60: 65 20 0a 2a 2a 20 63 61 6c 6c 65 72 20 73 68 6f e .** caller sho
0e70: 75 6c 64 20 68 61 76 65 20 66 69 72 73 74 20 6f uld have first o
0e80: 62 74 61 69 6e 65 64 20 61 20 6c 6f 63 6b 20 73 btained a lock s
0e90: 70 65 63 69 66 79 69 6e 67 20 74 68 65 20 72 6f pecifying the ro
0ea0: 6f 74 20 70 61 67 65 20 6f 66 0a 2a 2a 20 74 68 ot page of.** th
0eb0: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e corresponding
0ec0: 74 61 62 6c 65 2e 20 54 68 69 73 20 6d 61 6b 65 table. This make
0ed0: 73 20 74 68 69 6e 67 73 20 61 20 62 69 74 20 6d s things a bit m
0ee0: 6f 72 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 2c ore complicated,
0ef0: 0a 2a 2a 20 61 73 20 74 68 69 73 20 6d 6f 64 75 .** as this modu
0f00: 6c 65 20 74 72 65 61 74 73 20 65 61 63 68 20 74 le treats each t
0f10: 61 62 6c 65 20 61 73 20 61 20 73 65 70 61 72 61 able as a separa
0f20: 74 65 20 73 74 72 75 63 74 75 72 65 2e 20 54 6f te structure. To
0f30: 20 64 65 74 65 72 6d 69 6e 65 0a 2a 2a 20 74 68 determine.** th
0f40: 65 20 74 61 62 6c 65 20 63 6f 72 72 65 73 70 6f e table correspo
0f50: 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 69 6e 64 nding to the ind
0f60: 65 78 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e ex being written
0f70: 2c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 , this.** functi
0f80: 6f 6e 20 68 61 73 20 74 6f 20 73 65 61 72 63 68 on has to search
0f90: 20 74 68 72 6f 75 67 68 20 74 68 65 20 64 61 74 through the dat
0fa0: 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a 2a abase schema..**
0fb0: 0a 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 61 .** Instead of a
0fc0: 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 74 61 62 lock on the tab
0fd0: 6c 65 2f 69 6e 64 65 78 20 72 6f 6f 74 65 64 20 le/index rooted
0fe0: 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 74 at page iRoot, t
0ff0: 68 65 20 63 61 6c 6c 65 72 20 6d 61 79 0a 2a 2a he caller may.**
1000: 20 68 6f 6c 64 20 61 20 77 72 69 74 65 2d 6c 6f hold a write-lo
1010: 63 6b 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 ck on the schema
1020: 20 74 61 62 6c 65 20 28 72 6f 6f 74 20 70 61 67 table (root pag
1030: 65 20 31 29 2e 20 54 68 69 73 20 69 73 20 61 6c e 1). This is al
1040: 73 6f 0a 2a 2a 20 61 63 63 65 70 74 61 62 6c 65 so.** acceptable
1050: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1060: 68 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 hasSharedCacheTa
1070: 62 6c 65 4c 6f 63 6b 28 0a 20 20 42 74 72 65 65 bleLock(. Btree
1080: 20 2a 70 42 74 72 65 65 2c 20 20 20 20 20 20 20 *pBtree,
1090: 20 20 2f 2a 20 48 61 6e 64 6c 65 20 74 68 61 74 /* Handle that
10a0: 20 6d 75 73 74 20 68 6f 6c 64 20 6c 6f 63 6b 20 must hold lock
10b0: 2a 2f 0a 20 20 50 67 6e 6f 20 69 52 6f 6f 74 2c */. Pgno iRoot,
10c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
10d0: 6f 6f 74 20 70 61 67 65 20 6f 66 20 62 2d 74 72 oot page of b-tr
10e0: 65 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e ee */. int isIn
10f0: 64 65 78 2c 20 20 20 20 20 20 20 20 20 20 20 2f dex, /
1100: 2a 20 54 72 75 65 20 69 66 20 69 52 6f 6f 74 20 * True if iRoot
1110: 69 73 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 61 is the root of a
1120: 6e 20 69 6e 64 65 78 20 62 2d 74 72 65 65 20 2a n index b-tree *
1130: 2f 0a 20 20 69 6e 74 20 65 4c 6f 63 6b 54 79 70 /. int eLockTyp
1140: 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 e /* Re
1150: 71 75 69 72 65 64 20 6c 6f 63 6b 20 74 79 70 65 quired lock type
1160: 20 28 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 57 (READ_LOCK or W
1170: 52 49 54 45 5f 4c 4f 43 4b 29 20 2a 2f 0a 29 7b RITE_LOCK) */.){
1180: 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 . Schema *pSche
1190: 6d 61 20 3d 20 28 53 63 68 65 6d 61 20 2a 29 70 ma = (Schema *)p
11a0: 42 74 72 65 65 2d 3e 70 42 74 2d 3e 70 53 63 68 Btree->pBt->pSch
11b0: 65 6d 61 3b 0a 20 20 50 67 6e 6f 20 69 54 61 62 ema;. Pgno iTab
11c0: 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a = 0;. BtLock *
11d0: 70 4c 6f 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66 20 pLock;.. /* If
11e0: 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 73 this database is
11f0: 20 6e 6f 74 20 73 68 61 72 65 61 62 6c 65 2c 20 not shareable,
1200: 6f 72 20 69 66 20 74 68 65 20 63 6c 69 65 6e 74 or if the client
1210: 20 69 73 20 72 65 61 64 69 6e 67 0a 20 20 2a 2a is reading. **
1220: 20 61 6e 64 20 68 61 73 20 74 68 65 20 72 65 61 and has the rea
1230: 64 2d 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c d-uncommitted fl
1240: 61 67 20 73 65 74 2c 20 74 68 65 6e 20 6e 6f 20 ag set, then no
1250: 6c 6f 63 6b 20 69 73 20 72 65 71 75 69 72 65 64 lock is required
1260: 2e 20 0a 20 20 2a 2a 20 52 65 74 75 72 6e 20 74 . . ** Return t
1270: 72 75 65 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e rue immediately.
1280: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 70 42 74 . */. if( (pBt
1290: 72 65 65 2d 3e 73 68 61 72 61 62 6c 65 3d 3d 30 ree->sharable==0
12a0: 29 0a 20 20 20 7c 7c 20 28 65 4c 6f 63 6b 54 79 ). || (eLockTy
12b0: 70 65 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 26 26 pe==READ_LOCK &&
12c0: 20 28 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 6c (pBtree->db->fl
12d0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 61 ags & SQLITE_Rea
12e0: 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 29 0a 20 dUncommitted)).
12f0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 ){. return 1
1300: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 ;. }.. /* If t
1310: 68 65 20 63 6c 69 65 6e 74 20 69 73 20 72 65 61 he client is rea
1320: 64 69 6e 67 20 20 6f 72 20 77 72 69 74 69 6e 67 ding or writing
1330: 20 61 6e 20 69 6e 64 65 78 20 61 6e 64 20 74 68 an index and th
1340: 65 20 73 63 68 65 6d 61 20 69 73 0a 20 20 2a 2a e schema is. **
1350: 20 6e 6f 74 20 6c 6f 61 64 65 64 2c 20 74 68 65 not loaded, the
1360: 6e 20 69 74 20 69 73 20 74 6f 6f 20 64 69 66 66 n it is too diff
1370: 69 63 75 6c 74 20 74 6f 20 61 63 74 75 61 6c 6c icult to actuall
1380: 79 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 69 y check to see i
1390: 66 0a 20 20 2a 2a 20 74 68 65 20 63 6f 72 72 65 f. ** the corre
13a0: 63 74 20 6c 6f 63 6b 73 20 61 72 65 20 68 65 6c ct locks are hel
13b0: 64 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 62 6f d. So do not bo
13c0: 74 68 65 72 20 2d 20 6a 75 73 74 20 72 65 74 75 ther - just retu
13d0: 72 6e 20 74 72 75 65 2e 0a 20 20 2a 2a 20 54 68 rn true.. ** Th
13e0: 69 73 20 63 61 73 65 20 64 6f 65 73 20 6e 6f 74 is case does not
13f0: 20 63 6f 6d 65 20 75 70 20 76 65 72 79 20 6f 66 come up very of
1400: 74 65 6e 20 61 6e 79 68 6f 77 2e 0a 20 20 2a 2f ten anyhow.. */
1410: 0a 20 20 69 66 28 20 69 73 49 6e 64 65 78 20 26 . if( isIndex &
1420: 26 20 28 21 70 53 63 68 65 6d 61 20 7c 7c 20 28 & (!pSchema || (
1430: 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 26 44 pSchema->flags&D
1440: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3d B_SchemaLoaded)=
1450: 3d 30 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 =0) ){. retur
1460: 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 n 1;. }.. /* F
1470: 69 67 75 72 65 20 6f 75 74 20 74 68 65 20 72 6f igure out the ro
1480: 6f 74 2d 70 61 67 65 20 74 68 61 74 20 74 68 65 ot-page that the
1490: 20 6c 6f 63 6b 20 73 68 6f 75 6c 64 20 62 65 20 lock should be
14a0: 68 65 6c 64 20 6f 6e 2e 20 46 6f 72 20 74 61 62 held on. For tab
14b0: 6c 65 0a 20 20 2a 2a 20 62 2d 74 72 65 65 73 2c le. ** b-trees,
14c0: 20 74 68 69 73 20 69 73 20 6a 75 73 74 20 74 68 this is just th
14d0: 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 e root page of t
14e0: 68 65 20 62 2d 74 72 65 65 20 62 65 69 6e 67 20 he b-tree being
14f0: 72 65 61 64 20 6f 72 0a 20 20 2a 2a 20 77 72 69 read or. ** wri
1500: 74 74 65 6e 2e 20 46 6f 72 20 69 6e 64 65 78 20 tten. For index
1510: 62 2d 74 72 65 65 73 2c 20 69 74 20 69 73 20 74 b-trees, it is t
1520: 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 he root page of
1530: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 the associated.
1540: 20 2a 2a 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20 ** table. */.
1550: 20 69 66 28 20 69 73 49 6e 64 65 78 20 29 7b 0a if( isIndex ){.
1560: 20 20 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 3b HashElem *p;
1570: 0a 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 . for(p=sqlit
1580: 65 48 61 73 68 46 69 72 73 74 28 26 70 53 63 68 eHashFirst(&pSch
1590: 65 6d 61 2d 3e 69 64 78 48 61 73 68 29 3b 20 70 ema->idxHash); p
15a0: 3b 20 70 3d 73 71 6c 69 74 65 48 61 73 68 4e 65 ; p=sqliteHashNe
15b0: 78 74 28 70 29 29 7b 0a 20 20 20 20 20 20 49 6e xt(p)){. In
15c0: 64 65 78 20 2a 70 49 64 78 20 3d 20 28 49 6e 64 dex *pIdx = (Ind
15d0: 65 78 20 2a 29 73 71 6c 69 74 65 48 61 73 68 44 ex *)sqliteHashD
15e0: 61 74 61 28 70 29 3b 0a 20 20 20 20 20 20 69 66 ata(p);. if
15f0: 28 20 70 49 64 78 2d 3e 74 6e 75 6d 3d 3d 28 69 ( pIdx->tnum==(i
1600: 6e 74 29 69 52 6f 6f 74 20 29 7b 0a 20 20 20 20 nt)iRoot ){.
1610: 20 20 20 20 69 54 61 62 20 3d 20 70 49 64 78 2d iTab = pIdx-
1620: 3e 70 54 61 62 6c 65 2d 3e 74 6e 75 6d 3b 0a 20 >pTable->tnum;.
1630: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
1640: 65 6c 73 65 7b 0a 20 20 20 20 69 54 61 62 20 3d else{. iTab =
1650: 20 69 52 6f 6f 74 3b 0a 20 20 7d 0a 0a 20 20 2f iRoot;. }.. /
1660: 2a 20 53 65 61 72 63 68 20 66 6f 72 20 74 68 65 * Search for the
1670: 20 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e 20 required lock.
1680: 45 69 74 68 65 72 20 61 20 77 72 69 74 65 2d 6c Either a write-l
1690: 6f 63 6b 20 6f 6e 20 72 6f 6f 74 2d 70 61 67 65 ock on root-page
16a0: 20 69 54 61 62 2c 20 61 20 0a 20 20 2a 2a 20 77 iTab, a . ** w
16b0: 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 rite-lock on the
16c0: 20 73 63 68 65 6d 61 20 74 61 62 6c 65 2c 20 6f schema table, o
16d0: 72 20 28 69 66 20 74 68 65 20 63 6c 69 65 6e 74 r (if the client
16e0: 20 69 73 20 72 65 61 64 69 6e 67 29 20 61 0a 20 is reading) a.
16f0: 20 2a 2a 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e ** read-lock on
1700: 20 69 54 61 62 20 77 69 6c 6c 20 73 75 66 66 69 iTab will suffi
1710: 63 65 2e 20 52 65 74 75 72 6e 20 31 20 69 66 20 ce. Return 1 if
1720: 61 6e 79 20 6f 66 20 74 68 65 73 65 20 61 72 65 any of these are
1730: 20 66 6f 75 6e 64 2e 20 20 2a 2f 0a 20 20 66 6f found. */. fo
1740: 72 28 70 4c 6f 63 6b 3d 70 42 74 72 65 65 2d 3e r(pLock=pBtree->
1750: 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 4c 6f 63 pBt->pLock; pLoc
1760: 6b 3b 20 70 4c 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e k; pLock=pLock->
1770: 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 pNext){. if(
1780: 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 pLock->pBtree==p
1790: 42 74 72 65 65 20 0a 20 20 20 20 20 26 26 20 28 Btree . && (
17a0: 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c 65 3d 3d 69 pLock->iTable==i
17b0: 54 61 62 20 7c 7c 20 28 70 4c 6f 63 6b 2d 3e 65 Tab || (pLock->e
17c0: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
17d0: 20 26 26 20 70 4c 6f 63 6b 2d 3e 69 54 61 62 6c && pLock->iTabl
17e0: 65 3d 3d 31 29 29 0a 20 20 20 20 20 26 26 20 70 e==1)). && p
17f0: 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 3e 3d 65 4c 6f Lock->eLock>=eLo
1800: 63 6b 54 79 70 65 20 0a 20 20 20 20 29 7b 0a 20 ckType . ){.
1810: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 return 1;.
1820: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 }. }.. /* F
1830: 61 69 6c 65 64 20 74 6f 20 66 69 6e 64 20 74 68 ailed to find th
1840: 65 20 72 65 71 75 69 72 65 64 20 6c 6f 63 6b 2e e required lock.
1850: 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a */. return 0;.
1860: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 }.#endif /* SQLI
1870: 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 23 69 66 TE_DEBUG */..#if
1880: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
1890: 0a 2f 2a 0a 2a 2a 2a 2a 20 54 68 69 73 20 66 75 ./*.**** This fu
18a0: 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 75 73 nction may be us
18b0: 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 61 73 ed as part of as
18c0: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
18d0: 73 20 6f 6e 6c 79 2e 20 2a 2a 2a 2a 0a 2a 2a 0a s only. ****.**.
18e0: 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 ** Return true i
18f0: 66 20 69 74 20 77 6f 75 6c 64 20 62 65 20 69 6c f it would be il
1900: 6c 65 67 61 6c 20 66 6f 72 20 70 42 74 72 65 65 legal for pBtree
1910: 20 74 6f 20 77 72 69 74 65 20 69 6e 74 6f 20 74 to write into t
1920: 68 65 0a 2a 2a 20 74 61 62 6c 65 20 6f 72 20 69 he.** table or i
1930: 6e 64 65 78 20 72 6f 6f 74 65 64 20 61 74 20 69 ndex rooted at i
1940: 52 6f 6f 74 20 62 65 63 61 75 73 65 20 6f 74 68 Root because oth
1950: 65 72 20 73 68 61 72 65 64 20 63 6f 6e 6e 65 63 er shared connec
1960: 74 69 6f 6e 73 20 61 72 65 0a 2a 2a 20 73 69 6d tions are.** sim
1970: 75 6c 74 61 6e 65 6f 75 73 6c 79 20 72 65 61 64 ultaneously read
1980: 69 6e 67 20 74 68 61 74 20 73 61 6d 65 20 74 61 ing that same ta
1990: 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 0a 2a 2a ble or index..**
19a0: 0a 2a 2a 20 49 74 20 69 73 20 69 6c 6c 65 67 61 .** It is illega
19b0: 6c 20 66 6f 72 20 70 42 74 72 65 65 20 74 6f 20 l for pBtree to
19c0: 77 72 69 74 65 20 69 66 20 73 6f 6d 65 20 6f 74 write if some ot
19d0: 68 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 her Btree object
19e0: 20 74 68 61 74 0a 2a 2a 20 73 68 61 72 65 73 20 that.** shares
19f0: 74 68 65 20 73 61 6d 65 20 42 74 53 68 61 72 65 the same BtShare
1a00: 64 20 6f 62 6a 65 63 74 20 69 73 20 63 75 72 72 d object is curr
1a10: 65 6e 74 6c 79 20 72 65 61 64 69 6e 67 20 6f 72 ently reading or
1a20: 20 77 72 69 74 69 6e 67 0a 2a 2a 20 74 68 65 20 writing.** the
1a30: 69 52 6f 6f 74 20 74 61 62 6c 65 2e 20 20 45 78 iRoot table. Ex
1a40: 63 65 70 74 2c 20 69 66 20 74 68 65 20 6f 74 68 cept, if the oth
1a50: 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 20 er Btree object
1a60: 68 61 73 20 74 68 65 0a 2a 2a 20 72 65 61 64 2d has the.** read-
1a70: 75 6e 63 6f 6d 6d 69 74 74 65 64 20 66 6c 61 67 uncommitted flag
1a80: 20 73 65 74 2c 20 74 68 65 6e 20 69 74 20 69 73 set, then it is
1a90: 20 4f 4b 20 66 6f 72 20 74 68 65 20 6f 74 68 65 OK for the othe
1aa0: 72 20 6f 62 6a 65 63 74 20 74 6f 0a 2a 2a 20 68 r object to.** h
1ab0: 61 76 65 20 61 20 72 65 61 64 20 63 75 72 73 6f ave a read curso
1ac0: 72 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 r..**.** For exa
1ad0: 6d 70 6c 65 2c 20 62 65 66 6f 72 65 20 77 72 69 mple, before wri
1ae0: 74 69 6e 67 20 74 6f 20 61 6e 79 20 70 61 72 74 ting to any part
1af0: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 6f 72 of the table or
1b00: 20 69 6e 64 65 78 0a 2a 2a 20 72 6f 6f 74 65 64 index.** rooted
1b10: 20 61 74 20 70 61 67 65 20 69 52 6f 6f 74 2c 20 at page iRoot,
1b20: 6f 6e 65 20 73 68 6f 75 6c 64 20 63 61 6c 6c 3a one should call:
1b30: 0a 2a 2a 0a 2a 2a 20 20 20 20 61 73 73 65 72 74 .**.** assert
1b40: 28 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c 69 ( !hasReadConfli
1b50: 63 74 73 28 70 42 74 72 65 65 2c 20 69 52 6f 6f cts(pBtree, iRoo
1b60: 74 29 20 29 3b 0a 2a 2f 0a 73 74 61 74 69 63 20 t) );.*/.static
1b70: 69 6e 74 20 68 61 73 52 65 61 64 43 6f 6e 66 6c int hasReadConfl
1b80: 69 63 74 73 28 42 74 72 65 65 20 2a 70 42 74 72 icts(Btree *pBtr
1b90: 65 65 2c 20 50 67 6e 6f 20 69 52 6f 6f 74 29 7b ee, Pgno iRoot){
1ba0: 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a . BtCursor *p;.
1bb0: 20 20 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e for(p=pBtree->
1bc0: 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b pBt->pCursor; p;
1bd0: 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 p=p->pNext){.
1be0: 20 20 69 66 28 20 70 2d 3e 70 67 6e 6f 52 6f 6f if( p->pgnoRoo
1bf0: 74 3d 3d 69 52 6f 6f 74 20 0a 20 20 20 20 20 26 t==iRoot . &
1c00: 26 20 70 2d 3e 70 42 74 72 65 65 21 3d 70 42 74 & p->pBtree!=pBt
1c10: 72 65 65 0a 20 20 20 20 20 26 26 20 30 3d 3d 28 ree. && 0==(
1c20: 70 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 66 p->pBtree->db->f
1c30: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 lags & SQLITE_Re
1c40: 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 0a 20 adUncommitted).
1c50: 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ){. retu
1c60: 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a rn 1;. }. }.
1c70: 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 23 65 return 0;.}.#e
1c80: 6e 64 69 66 20 20 20 20 2f 2a 20 23 69 66 64 65 ndif /* #ifde
1c90: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a f SQLITE_DEBUG *
1ca0: 2f 0a 0a 2f 2a 0a 2a 2a 20 51 75 65 72 79 20 74 /../*.** Query t
1cb0: 6f 20 73 65 65 20 69 66 20 42 74 72 65 65 20 68 o see if Btree h
1cc0: 61 6e 64 6c 65 20 70 20 6d 61 79 20 6f 62 74 61 andle p may obta
1cd0: 69 6e 20 61 20 6c 6f 63 6b 20 6f 66 20 74 79 70 in a lock of typ
1ce0: 65 20 65 4c 6f 63 6b 20 0a 2a 2a 20 28 52 45 41 e eLock .** (REA
1cf0: 44 5f 4c 4f 43 4b 20 6f 72 20 57 52 49 54 45 5f D_LOCK or WRITE_
1d00: 4c 4f 43 4b 29 20 6f 6e 20 74 68 65 20 74 61 62 LOCK) on the tab
1d10: 6c 65 20 77 69 74 68 20 72 6f 6f 74 2d 70 61 67 le with root-pag
1d20: 65 20 69 54 61 62 2e 20 52 65 74 75 72 6e 0a 2a e iTab. Return.*
1d30: 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 * SQLITE_OK if t
1d40: 68 65 20 6c 6f 63 6b 20 6d 61 79 20 62 65 20 6f he lock may be o
1d50: 62 74 61 69 6e 65 64 20 28 62 79 20 63 61 6c 6c btained (by call
1d60: 69 6e 67 0a 2a 2a 20 73 65 74 53 68 61 72 65 64 ing.** setShared
1d70: 43 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 CacheTableLock()
1d80: 29 2c 20 6f 72 20 53 51 4c 49 54 45 5f 4c 4f 43 ), or SQLITE_LOC
1d90: 4b 45 44 20 69 66 20 6e 6f 74 2e 0a 2a 2f 0a 73 KED if not..*/.s
1da0: 74 61 74 69 63 20 69 6e 74 20 71 75 65 72 79 53 tatic int queryS
1db0: 68 61 72 65 64 43 61 63 68 65 54 61 62 6c 65 4c haredCacheTableL
1dc0: 6f 63 6b 28 42 74 72 65 65 20 2a 70 2c 20 50 67 ock(Btree *p, Pg
1dd0: 6e 6f 20 69 54 61 62 2c 20 75 38 20 65 4c 6f 63 no iTab, u8 eLoc
1de0: 6b 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a k){. BtShared *
1df0: 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
1e00: 42 74 4c 6f 63 6b 20 2a 70 49 74 65 72 3b 0a 0a BtLock *pIter;..
1e10: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
1e20: 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 3BtreeHoldsMutex
1e30: 28 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 (p) );. assert(
1e40: 20 65 4c 6f 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 eLock==READ_LOC
1e50: 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 52 49 54 K || eLock==WRIT
1e60: 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 E_LOCK );. asse
1e70: 72 74 28 20 70 2d 3e 64 62 21 3d 30 20 29 3b 0a rt( p->db!=0 );.
1e80: 20 20 61 73 73 65 72 74 28 20 21 28 70 2d 3e 64 assert( !(p->d
1e90: 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f b->flags&SQLITE_
1ea0: 52 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 29 ReadUncommitted)
1eb0: 7c 7c 65 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c ||eLock==WRITE_L
1ec0: 4f 43 4b 7c 7c 69 54 61 62 3d 3d 31 20 29 3b 0a OCK||iTab==1 );.
1ed0: 20 20 0a 20 20 2f 2a 20 49 66 20 72 65 71 75 65 . /* If reque
1ee0: 73 74 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f sting a write-lo
1ef0: 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 42 74 72 ck, then the Btr
1f00: 65 65 20 6d 75 73 74 20 68 61 76 65 20 61 6e 20 ee must have an
1f10: 6f 70 65 6e 20 77 72 69 74 65 0a 20 20 2a 2a 20 open write. **
1f20: 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 transaction on t
1f30: 68 69 73 20 66 69 6c 65 2e 20 41 6e 64 2c 20 6f his file. And, o
1f40: 62 76 69 6f 75 73 6c 79 2c 20 66 6f 72 20 74 68 bviously, for th
1f50: 69 73 20 74 6f 20 62 65 20 73 6f 20 74 68 65 72 is to be so ther
1f60: 65 20 0a 20 20 2a 2a 20 6d 75 73 74 20 62 65 20 e . ** must be
1f70: 61 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 an open write tr
1f80: 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 65 ansaction on the
1f90: 20 66 69 6c 65 20 69 74 73 65 6c 66 2e 0a 20 20 file itself..
1fa0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f */. assert( eLo
1fb0: 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c ck==READ_LOCK ||
1fc0: 20 28 70 3d 3d 70 42 74 2d 3e 70 57 72 69 74 65 (p==pBt->pWrite
1fd0: 72 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d r && p->inTrans=
1fe0: 3d 54 52 41 4e 53 5f 57 52 49 54 45 29 20 29 3b =TRANS_WRITE) );
1ff0: 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b . assert( eLock
2000: 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 ==READ_LOCK || p
2010: 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
2020: 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 n==TRANS_WRITE )
2030: 3b 0a 20 20 0a 20 20 2f 2a 20 54 68 69 73 20 72 ;. . /* This r
2040: 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f outine is a no-o
2050: 70 20 69 66 20 74 68 65 20 73 68 61 72 65 64 2d p if the shared-
2060: 63 61 63 68 65 20 69 73 20 6e 6f 74 20 65 6e 61 cache is not ena
2070: 62 6c 65 64 20 2a 2f 0a 20 20 69 66 28 20 21 70 bled */. if( !p
2080: 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 20 ->sharable ){.
2090: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
20a0: 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 OK;. }.. /* If
20b0: 20 73 6f 6d 65 20 6f 74 68 65 72 20 63 6f 6e 6e some other conn
20c0: 65 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 6e ection is holdin
20d0: 67 20 61 6e 20 65 78 63 6c 75 73 69 76 65 20 6c g an exclusive l
20e0: 6f 63 6b 2c 20 74 68 65 0a 20 20 2a 2a 20 72 65 ock, the. ** re
20f0: 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 6d 61 79 quested lock may
2100: 20 6e 6f 74 20 62 65 20 6f 62 74 61 69 6e 65 64 not be obtained
2110: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 42 74 .. */. if( pBt
2120: 2d 3e 70 57 72 69 74 65 72 21 3d 70 20 26 26 20 ->pWriter!=p &&
2130: 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 (pBt->btsFlags &
2140: 20 42 54 53 5f 45 58 43 4c 55 53 49 56 45 29 21 BTS_EXCLUSIVE)!
2150: 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 =0 ){. sqlite
2160: 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 3ConnectionBlock
2170: 65 64 28 70 2d 3e 64 62 2c 20 70 42 74 2d 3e 70 ed(p->db, pBt->p
2180: 57 72 69 74 65 72 2d 3e 64 62 29 3b 0a 20 20 20 Writer->db);.
2190: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4c return SQLITE_L
21a0: 4f 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 OCKED_SHAREDCACH
21b0: 45 3b 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 70 49 E;. }.. for(pI
21c0: 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b 3b 20 ter=pBt->pLock;
21d0: 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 49 74 pIter; pIter=pIt
21e0: 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 er->pNext){.
21f0: 2f 2a 20 54 68 65 20 63 6f 6e 64 69 74 69 6f 6e /* The condition
2200: 20 28 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 21 3d (pIter->eLock!=
2210: 65 4c 6f 63 6b 29 20 69 6e 20 74 68 65 20 66 6f eLock) in the fo
2220: 6c 6c 6f 77 69 6e 67 20 69 66 28 2e 2e 2e 29 20 llowing if(...)
2230: 0a 20 20 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e . ** statemen
2240: 74 20 69 73 20 61 20 73 69 6d 70 6c 69 66 69 63 t is a simplific
2250: 61 74 69 6f 6e 20 6f 66 3a 0a 20 20 20 20 2a 2a ation of:. **
2260: 0a 20 20 20 20 2a 2a 20 20 20 28 65 4c 6f 63 6b . ** (eLock
2270: 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 20 7c 7c 20 ==WRITE_LOCK ||
2280: 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 52 pIter->eLock==WR
2290: 49 54 45 5f 4c 4f 43 4b 29 0a 20 20 20 20 2a 2a ITE_LOCK). **
22a0: 0a 20 20 20 20 2a 2a 20 73 69 6e 63 65 20 77 65 . ** since we
22b0: 20 6b 6e 6f 77 20 74 68 61 74 20 69 66 20 65 4c know that if eL
22c0: 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b 2c ock==WRITE_LOCK,
22d0: 20 74 68 65 6e 20 6e 6f 20 6f 74 68 65 72 20 63 then no other c
22e0: 6f 6e 6e 65 63 74 69 6f 6e 0a 20 20 20 20 2a 2a onnection. **
22f0: 20 6d 61 79 20 68 6f 6c 64 20 61 20 57 52 49 54 may hold a WRIT
2300: 45 5f 4c 4f 43 4b 20 6f 6e 20 61 6e 79 20 74 61 E_LOCK on any ta
2310: 62 6c 65 20 69 6e 20 74 68 69 73 20 66 69 6c 65 ble in this file
2320: 20 28 73 69 6e 63 65 20 74 68 65 72 65 20 63 61 (since there ca
2330: 6e 0a 20 20 20 20 2a 2a 20 6f 6e 6c 79 20 62 65 n. ** only be
2340: 20 61 20 73 69 6e 67 6c 65 20 77 72 69 74 65 72 a single writer
2350: 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 ).. */. as
2360: 73 65 72 74 28 20 70 49 74 65 72 2d 3e 65 4c 6f sert( pIter->eLo
2370: 63 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c ck==READ_LOCK ||
2380: 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 57 pIter->eLock==W
2390: 52 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 RITE_LOCK );.
23a0: 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d assert( eLock==
23b0: 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 70 49 74 READ_LOCK || pIt
23c0: 65 72 2d 3e 70 42 74 72 65 65 3d 3d 70 20 7c 7c er->pBtree==p ||
23d0: 20 70 49 74 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 52 pIter->eLock==R
23e0: 45 41 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 69 EAD_LOCK);. i
23f0: 66 28 20 70 49 74 65 72 2d 3e 70 42 74 72 65 65 f( pIter->pBtree
2400: 21 3d 70 20 26 26 20 70 49 74 65 72 2d 3e 69 54 !=p && pIter->iT
2410: 61 62 6c 65 3d 3d 69 54 61 62 20 26 26 20 70 49 able==iTab && pI
2420: 74 65 72 2d 3e 65 4c 6f 63 6b 21 3d 65 4c 6f 63 ter->eLock!=eLoc
2430: 6b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 k ){. sqlit
2440: 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 e3ConnectionBloc
2450: 6b 65 64 28 70 2d 3e 64 62 2c 20 70 49 74 65 72 ked(p->db, pIter
2460: 2d 3e 70 42 74 72 65 65 2d 3e 64 62 29 3b 0a 20 ->pBtree->db);.
2470: 20 20 20 20 20 69 66 28 20 65 4c 6f 63 6b 3d 3d if( eLock==
2480: 57 52 49 54 45 5f 4c 4f 43 4b 20 29 7b 0a 20 20 WRITE_LOCK ){.
2490: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 3d assert( p=
24a0: 3d 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 3b =pBt->pWriter );
24b0: 0a 20 20 20 20 20 20 20 20 70 42 74 2d 3e 62 74 . pBt->bt
24c0: 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 45 sFlags |= BTS_PE
24d0: 4e 44 49 4e 47 3b 0a 20 20 20 20 20 20 7d 0a 20 NDING;. }.
24e0: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 return SQLI
24f0: 54 45 5f 4c 4f 43 4b 45 44 5f 53 48 41 52 45 44 TE_LOCKED_SHARED
2500: 43 41 43 48 45 3b 0a 20 20 20 20 7d 0a 20 20 7d CACHE;. }. }
2510: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
2520: 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a _OK;.}.#endif /*
2530: 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 !SQLITE_OMIT_SH
2540: 41 52 45 44 5f 43 41 43 48 45 20 2a 2f 0a 0a 23 ARED_CACHE */..#
2550: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2560: 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
2570: 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 6c 6f 63 6b /*.** Add a lock
2580: 20 6f 6e 20 74 68 65 20 74 61 62 6c 65 20 77 69 on the table wi
2590: 74 68 20 72 6f 6f 74 2d 70 61 67 65 20 69 54 61 th root-page iTa
25a0: 62 6c 65 20 74 6f 20 74 68 65 20 73 68 61 72 65 ble to the share
25b0: 64 2d 62 74 72 65 65 20 75 73 65 64 0a 2a 2a 20 d-btree used.**
25c0: 62 79 20 42 74 72 65 65 20 68 61 6e 64 6c 65 20 by Btree handle
25d0: 70 2e 20 50 61 72 61 6d 65 74 65 72 20 65 4c 6f p. Parameter eLo
25e0: 63 6b 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 ck must be eithe
25f0: 72 20 52 45 41 44 5f 4c 4f 43 4b 20 6f 72 20 0a r READ_LOCK or .
2600: 2a 2a 20 57 52 49 54 45 5f 4c 4f 43 4b 2e 0a 2a ** WRITE_LOCK..*
2610: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
2620: 6f 6e 20 61 73 73 75 6d 65 73 20 74 68 65 20 66 on assumes the f
2630: 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 ollowing:.**.**
2640: 20 20 28 61 29 20 54 68 65 20 73 70 65 63 69 66 (a) The specif
2650: 69 65 64 20 42 74 72 65 65 20 6f 62 6a 65 63 74 ied Btree object
2660: 20 70 20 69 73 20 63 6f 6e 6e 65 63 74 65 64 20 p is connected
2670: 74 6f 20 61 20 73 68 61 72 61 62 6c 65 0a 2a 2a to a sharable.**
2680: 20 20 20 20 20 20 20 64 61 74 61 62 61 73 65 20 database
2690: 28 6f 6e 65 20 77 69 74 68 20 74 68 65 20 42 74 (one with the Bt
26a0: 53 68 61 72 65 64 2e 73 68 61 72 61 62 6c 65 20 Shared.sharable
26b0: 66 6c 61 67 20 73 65 74 29 2c 20 61 6e 64 0a 2a flag set), and.*
26c0: 2a 0a 2a 2a 20 20 20 28 62 29 20 4e 6f 20 6f 74 *.** (b) No ot
26d0: 68 65 72 20 42 74 72 65 65 20 6f 62 6a 65 63 74 her Btree object
26e0: 73 20 68 6f 6c 64 20 61 20 6c 6f 63 6b 20 74 68 s hold a lock th
26f0: 61 74 20 63 6f 6e 66 6c 69 63 74 73 0a 2a 2a 20 at conflicts.**
2700: 20 20 20 20 20 20 77 69 74 68 20 74 68 65 20 72 with the r
2710: 65 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 28 69 equested lock (i
2720: 2e 65 2e 20 71 75 65 72 79 53 68 61 72 65 64 43 .e. querySharedC
2730: 61 63 68 65 54 61 62 6c 65 4c 6f 63 6b 28 29 20 acheTableLock()
2740: 68 61 73 0a 2a 2a 20 20 20 20 20 20 20 61 6c 72 has.** alr
2750: 65 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 eady been called
2760: 20 61 6e 64 20 72 65 74 75 72 6e 65 64 20 53 51 and returned SQ
2770: 4c 49 54 45 5f 4f 4b 29 2e 0a 2a 2a 0a 2a 2a 20 LITE_OK)..**.**
2780: 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
2790: 75 72 6e 65 64 20 69 66 20 74 68 65 20 6c 6f 63 urned if the loc
27a0: 6b 20 69 73 20 61 64 64 65 64 20 73 75 63 63 65 k is added succe
27b0: 73 73 66 75 6c 6c 79 2e 20 53 51 4c 49 54 45 5f ssfully. SQLITE_
27c0: 4e 4f 4d 45 4d 20 0a 2a 2a 20 69 73 20 72 65 74 NOMEM .** is ret
27d0: 75 72 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f urned if a mallo
27e0: 63 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2e c attempt fails.
27f0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 .*/.static int s
2800: 65 74 53 68 61 72 65 64 43 61 63 68 65 54 61 62 etSharedCacheTab
2810: 6c 65 4c 6f 63 6b 28 42 74 72 65 65 20 2a 70 2c leLock(Btree *p,
2820: 20 50 67 6e 6f 20 69 54 61 62 6c 65 2c 20 75 38 Pgno iTable, u8
2830: 20 65 4c 6f 63 6b 29 7b 0a 20 20 42 74 53 68 61 eLock){. BtSha
2840: 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 red *pBt = p->pB
2850: 74 3b 0a 20 20 42 74 4c 6f 63 6b 20 2a 70 4c 6f t;. BtLock *pLo
2860: 63 6b 20 3d 20 30 3b 0a 20 20 42 74 4c 6f 63 6b ck = 0;. BtLock
2870: 20 2a 70 49 74 65 72 3b 0a 0a 20 20 61 73 73 65 *pIter;.. asse
2880: 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 rt( sqlite3Btree
2890: 48 6f 6c 64 73 4d 75 74 65 78 28 70 29 20 29 3b HoldsMutex(p) );
28a0: 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b . assert( eLock
28b0: 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 65 ==READ_LOCK || e
28c0: 4c 6f 63 6b 3d 3d 57 52 49 54 45 5f 4c 4f 43 4b Lock==WRITE_LOCK
28d0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d );. assert( p-
28e0: 3e 64 62 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 >db!=0 );.. /*
28f0: 41 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 A connection wit
2900: 68 20 74 68 65 20 72 65 61 64 2d 75 6e 63 6f 6d h the read-uncom
2910: 6d 69 74 74 65 64 20 66 6c 61 67 20 73 65 74 20 mitted flag set
2920: 77 69 6c 6c 20 6e 65 76 65 72 20 74 72 79 20 74 will never try t
2930: 6f 0a 20 20 2a 2a 20 6f 62 74 61 69 6e 20 61 20 o. ** obtain a
2940: 72 65 61 64 2d 6c 6f 63 6b 20 75 73 69 6e 67 20 read-lock using
2950: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 54 this function. T
2960: 68 65 20 6f 6e 6c 79 20 72 65 61 64 2d 6c 6f 63 he only read-loc
2970: 6b 20 6f 62 74 61 69 6e 65 64 0a 20 20 2a 2a 20 k obtained. **
2980: 62 79 20 61 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 by a connection
2990: 69 6e 20 72 65 61 64 2d 75 6e 63 6f 6d 6d 69 74 in read-uncommit
29a0: 74 65 64 20 6d 6f 64 65 20 69 73 20 6f 6e 20 74 ted mode is on t
29b0: 68 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 he sqlite_master
29c0: 20 0a 20 20 2a 2a 20 74 61 62 6c 65 2c 20 61 6e . ** table, an
29d0: 64 20 74 68 61 74 20 6c 6f 63 6b 20 69 73 20 6f d that lock is o
29e0: 62 74 61 69 6e 65 64 20 69 6e 20 42 74 72 65 65 btained in Btree
29f0: 42 65 67 69 6e 54 72 61 6e 73 28 29 2e 20 20 2a BeginTrans(). *
2a00: 2f 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 28 /. assert( 0==(
2a10: 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c p->db->flags&SQL
2a20: 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 74 ITE_ReadUncommit
2a30: 74 65 64 29 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 57 ted) || eLock==W
2a40: 52 49 54 45 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 RITE_LOCK );..
2a50: 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e /* This function
2a60: 20 73 68 6f 75 6c 64 20 6f 6e 6c 79 20 62 65 20 should only be
2a70: 63 61 6c 6c 65 64 20 6f 6e 20 61 20 73 68 61 72 called on a shar
2a80: 61 62 6c 65 20 62 2d 74 72 65 65 20 61 66 74 65 able b-tree afte
2a90: 72 20 69 74 20 0a 20 20 2a 2a 20 68 61 73 20 62 r it . ** has b
2aa0: 65 65 6e 20 64 65 74 65 72 6d 69 6e 65 64 20 74 een determined t
2ab0: 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 62 2d 74 hat no other b-t
2ac0: 72 65 65 20 68 6f 6c 64 73 20 61 20 63 6f 6e 66 ree holds a conf
2ad0: 6c 69 63 74 69 6e 67 20 6c 6f 63 6b 2e 20 20 2a licting lock. *
2ae0: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 73 /. assert( p->s
2af0: 68 61 72 61 62 6c 65 20 29 3b 0a 20 20 61 73 73 harable );. ass
2b00: 65 72 74 28 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d ert( SQLITE_OK==
2b10: 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 65 querySharedCache
2b20: 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 TableLock(p, iTa
2b30: 62 6c 65 2c 20 65 4c 6f 63 6b 29 20 29 3b 0a 0a ble, eLock) );..
2b40: 20 20 2f 2a 20 46 69 72 73 74 20 73 65 61 72 63 /* First searc
2b50: 68 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 61 h the list for a
2b60: 6e 20 65 78 69 73 74 69 6e 67 20 6c 6f 63 6b 20 n existing lock
2b70: 6f 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a on this table. *
2b80: 2f 0a 20 20 66 6f 72 28 70 49 74 65 72 3d 70 42 /. for(pIter=pB
2b90: 74 2d 3e 70 4c 6f 63 6b 3b 20 70 49 74 65 72 3b t->pLock; pIter;
2ba0: 20 70 49 74 65 72 3d 70 49 74 65 72 2d 3e 70 4e pIter=pIter->pN
2bb0: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49 ext){. if( pI
2bc0: 74 65 72 2d 3e 69 54 61 62 6c 65 3d 3d 69 54 61 ter->iTable==iTa
2bd0: 62 6c 65 20 26 26 20 70 49 74 65 72 2d 3e 70 42 ble && pIter->pB
2be0: 74 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 tree==p ){.
2bf0: 20 70 4c 6f 63 6b 20 3d 20 70 49 74 65 72 3b 0a pLock = pIter;.
2c00: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
2c10: 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 }. }.. /* If
2c20: 74 68 65 20 61 62 6f 76 65 20 73 65 61 72 63 68 the above search
2c30: 20 64 69 64 20 6e 6f 74 20 66 69 6e 64 20 61 20 did not find a
2c40: 42 74 4c 6f 63 6b 20 73 74 72 75 63 74 20 61 73 BtLock struct as
2c50: 73 6f 63 69 61 74 69 6e 67 20 42 74 72 65 65 20 sociating Btree
2c60: 70 0a 20 20 2a 2a 20 77 69 74 68 20 74 61 62 6c p. ** with tabl
2c70: 65 20 69 54 61 62 6c 65 2c 20 61 6c 6c 6f 63 61 e iTable, alloca
2c80: 74 65 20 6f 6e 65 20 61 6e 64 20 6c 69 6e 6b 20 te one and link
2c90: 69 74 20 69 6e 74 6f 20 74 68 65 20 6c 69 73 74 it into the list
2ca0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 21 70 4c .. */. if( !pL
2cb0: 6f 63 6b 20 29 7b 0a 20 20 20 20 70 4c 6f 63 6b ock ){. pLock
2cc0: 20 3d 20 28 42 74 4c 6f 63 6b 20 2a 29 73 71 6c = (BtLock *)sql
2cd0: 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 ite3MallocZero(s
2ce0: 69 7a 65 6f 66 28 42 74 4c 6f 63 6b 29 29 3b 0a izeof(BtLock));.
2cf0: 20 20 20 20 69 66 28 20 21 70 4c 6f 63 6b 20 29 if( !pLock )
2d00: 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
2d10: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 QLITE_NOMEM;.
2d20: 20 7d 0a 20 20 20 20 70 4c 6f 63 6b 2d 3e 69 54 }. pLock->iT
2d30: 61 62 6c 65 20 3d 20 69 54 61 62 6c 65 3b 0a 20 able = iTable;.
2d40: 20 20 20 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 pLock->pBtree
2d50: 20 3d 20 70 3b 0a 20 20 20 20 70 4c 6f 63 6b 2d = p;. pLock-
2d60: 3e 70 4e 65 78 74 20 3d 20 70 42 74 2d 3e 70 4c >pNext = pBt->pL
2d70: 6f 63 6b 3b 0a 20 20 20 20 70 42 74 2d 3e 70 4c ock;. pBt->pL
2d80: 6f 63 6b 20 3d 20 70 4c 6f 63 6b 3b 0a 20 20 7d ock = pLock;. }
2d90: 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 42 .. /* Set the B
2da0: 74 4c 6f 63 6b 2e 65 4c 6f 63 6b 20 76 61 72 69 tLock.eLock vari
2db0: 61 62 6c 65 20 74 6f 20 74 68 65 20 6d 61 78 69 able to the maxi
2dc0: 6d 75 6d 20 6f 66 20 74 68 65 20 63 75 72 72 65 mum of the curre
2dd0: 6e 74 20 6c 6f 63 6b 0a 20 20 2a 2a 20 61 6e 64 nt lock. ** and
2de0: 20 74 68 65 20 72 65 71 75 65 73 74 65 64 20 6c the requested l
2df0: 6f 63 6b 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 ock. This means
2e00: 69 66 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 20 if a write-lock
2e10: 77 61 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 was already held
2e20: 0a 20 20 2a 2a 20 61 6e 64 20 61 20 72 65 61 64 . ** and a read
2e30: 2d 6c 6f 63 6b 20 72 65 71 75 65 73 74 65 64 2c -lock requested,
2e40: 20 77 65 20 64 6f 6e 27 74 20 69 6e 63 6f 72 72 we don't incorr
2e50: 65 63 74 6c 79 20 64 6f 77 6e 67 72 61 64 65 20 ectly downgrade
2e60: 74 68 65 20 6c 6f 63 6b 2e 0a 20 20 2a 2f 0a 20 the lock.. */.
2e70: 20 61 73 73 65 72 74 28 20 57 52 49 54 45 5f 4c assert( WRITE_L
2e80: 4f 43 4b 3e 52 45 41 44 5f 4c 4f 43 4b 20 29 3b OCK>READ_LOCK );
2e90: 0a 20 20 69 66 28 20 65 4c 6f 63 6b 3e 70 4c 6f . if( eLock>pLo
2ea0: 63 6b 2d 3e 65 4c 6f 63 6b 20 29 7b 0a 20 20 20 ck->eLock ){.
2eb0: 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 3d 20 pLock->eLock =
2ec0: 65 4c 6f 63 6b 3b 0a 20 20 7d 0a 0a 20 20 72 65 eLock;. }.. re
2ed0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
2ee0: 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 21 53 51 4c }.#endif /* !SQL
2ef0: 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
2f00: 43 41 43 48 45 20 2a 2f 0a 0a 23 69 66 6e 64 65 CACHE */..#ifnde
2f10: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 f SQLITE_OMIT_SH
2f20: 41 52 45 44 5f 43 41 43 48 45 0a 2f 2a 0a 2a 2a ARED_CACHE./*.**
2f30: 20 52 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65 Release all the
2f40: 20 74 61 62 6c 65 20 6c 6f 63 6b 73 20 28 6c 6f table locks (lo
2f50: 63 6b 73 20 6f 62 74 61 69 6e 65 64 20 76 69 61 cks obtained via
2f60: 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20 74 68 65 calls to.** the
2f70: 20 73 65 74 53 68 61 72 65 64 43 61 63 68 65 54 setSharedCacheT
2f80: 61 62 6c 65 4c 6f 63 6b 28 29 20 70 72 6f 63 65 ableLock() proce
2f90: 64 75 72 65 29 20 68 65 6c 64 20 62 79 20 42 74 dure) held by Bt
2fa0: 72 65 65 20 6f 62 6a 65 63 74 20 70 2e 0a 2a 2a ree object p..**
2fb0: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
2fc0: 6e 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 42 n assumes that B
2fd0: 74 72 65 65 20 70 20 68 61 73 20 61 6e 20 6f 70 tree p has an op
2fe0: 65 6e 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 en read or write
2ff0: 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e .** transaction
3000: 2e 20 49 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 . If it does not
3010: 2c 20 74 68 65 6e 20 74 68 65 20 42 54 53 5f 50 , then the BTS_P
3020: 45 4e 44 49 4e 47 20 66 6c 61 67 0a 2a 2a 20 6d ENDING flag.** m
3030: 61 79 20 62 65 20 69 6e 63 6f 72 72 65 63 74 6c ay be incorrectl
3040: 79 20 63 6c 65 61 72 65 64 2e 0a 2a 2f 0a 73 74 y cleared..*/.st
3050: 61 74 69 63 20 76 6f 69 64 20 63 6c 65 61 72 41 atic void clearA
3060: 6c 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 llSharedCacheTab
3070: 6c 65 4c 6f 63 6b 73 28 42 74 72 65 65 20 2a 70 leLocks(Btree *p
3080: 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
3090: 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 42 Bt = p->pBt;. B
30a0: 74 4c 6f 63 6b 20 2a 2a 70 70 49 74 65 72 20 3d tLock **ppIter =
30b0: 20 26 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a 0a 20 &pBt->pLock;..
30c0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
30d0: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 BtreeHoldsMutex(
30e0: 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 p) );. assert(
30f0: 70 2d 3e 73 68 61 72 61 62 6c 65 20 7c 7c 20 30 p->sharable || 0
3100: 3d 3d 2a 70 70 49 74 65 72 20 29 3b 0a 20 20 61 ==*ppIter );. a
3110: 73 73 65 72 74 28 20 70 2d 3e 69 6e 54 72 61 6e ssert( p->inTran
3120: 73 3e 30 20 29 3b 0a 0a 20 20 77 68 69 6c 65 28 s>0 );.. while(
3130: 20 2a 70 70 49 74 65 72 20 29 7b 0a 20 20 20 20 *ppIter ){.
3140: 42 74 4c 6f 63 6b 20 2a 70 4c 6f 63 6b 20 3d 20 BtLock *pLock =
3150: 2a 70 70 49 74 65 72 3b 0a 20 20 20 20 61 73 73 *ppIter;. ass
3160: 65 72 74 28 20 28 70 42 74 2d 3e 62 74 73 46 6c ert( (pBt->btsFl
3170: 61 67 73 20 26 20 42 54 53 5f 45 58 43 4c 55 53 ags & BTS_EXCLUS
3180: 49 56 45 29 3d 3d 30 20 7c 7c 20 70 42 74 2d 3e IVE)==0 || pBt->
3190: 70 57 72 69 74 65 72 3d 3d 70 4c 6f 63 6b 2d 3e pWriter==pLock->
31a0: 70 42 74 72 65 65 20 29 3b 0a 20 20 20 20 61 73 pBtree );. as
31b0: 73 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 sert( pLock->pBt
31c0: 72 65 65 2d 3e 69 6e 54 72 61 6e 73 3e 3d 70 4c ree->inTrans>=pL
31d0: 6f 63 6b 2d 3e 65 4c 6f 63 6b 20 29 3b 0a 20 20 ock->eLock );.
31e0: 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 70 42 74 if( pLock->pBt
31f0: 72 65 65 3d 3d 70 20 29 7b 0a 20 20 20 20 20 20 ree==p ){.
3200: 2a 70 70 49 74 65 72 20 3d 20 70 4c 6f 63 6b 2d *ppIter = pLock-
3210: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 20 20 61 73 >pNext;. as
3220: 73 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 69 54 61 sert( pLock->iTa
3230: 62 6c 65 21 3d 31 20 7c 7c 20 70 4c 6f 63 6b 3d ble!=1 || pLock=
3240: 3d 26 70 2d 3e 6c 6f 63 6b 20 29 3b 0a 20 20 20 =&p->lock );.
3250: 20 20 20 69 66 28 20 70 4c 6f 63 6b 2d 3e 69 54 if( pLock->iT
3260: 61 62 6c 65 21 3d 31 20 29 7b 0a 20 20 20 20 20 able!=1 ){.
3270: 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 sqlite3_free(
3280: 70 4c 6f 63 6b 29 3b 0a 20 20 20 20 20 20 7d 0a pLock);. }.
3290: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
32a0: 20 70 70 49 74 65 72 20 3d 20 26 70 4c 6f 63 6b ppIter = &pLock
32b0: 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 ->pNext;. }.
32c0: 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 28 70 }.. assert( (p
32d0: 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 Bt->btsFlags & B
32e0: 54 53 5f 50 45 4e 44 49 4e 47 29 3d 3d 30 20 7c TS_PENDING)==0 |
32f0: 7c 20 70 42 74 2d 3e 70 57 72 69 74 65 72 20 29 | pBt->pWriter )
3300: 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 70 57 72 ;. if( pBt->pWr
3310: 69 74 65 72 3d 3d 70 20 29 7b 0a 20 20 20 20 70 iter==p ){. p
3320: 42 74 2d 3e 70 57 72 69 74 65 72 20 3d 20 30 3b Bt->pWriter = 0;
3330: 0a 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 . pBt->btsFla
3340: 67 73 20 26 3d 20 7e 28 42 54 53 5f 45 58 43 4c gs &= ~(BTS_EXCL
3350: 55 53 49 56 45 7c 42 54 53 5f 50 45 4e 44 49 4e USIVE|BTS_PENDIN
3360: 47 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 G);. }else if(
3370: 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f pBt->nTransactio
3380: 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 2f 2a 20 54 n==2 ){. /* T
3390: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
33a0: 63 61 6c 6c 65 64 20 77 68 65 6e 20 42 74 72 65 called when Btre
33b0: 65 20 70 20 69 73 20 63 6f 6e 63 6c 75 64 69 6e e p is concludin
33c0: 67 20 69 74 73 20 0a 20 20 20 20 2a 2a 20 74 72 g its . ** tr
33d0: 61 6e 73 61 63 74 69 6f 6e 2e 20 49 66 20 74 68 ansaction. If th
33e0: 65 72 65 20 63 75 72 72 65 6e 74 6c 79 20 65 78 ere currently ex
33f0: 69 73 74 73 20 61 20 77 72 69 74 65 72 2c 20 61 ists a writer, a
3400: 6e 64 20 70 20 69 73 20 6e 6f 74 0a 20 20 20 20 nd p is not.
3410: 2a 2a 20 74 68 61 74 20 77 72 69 74 65 72 2c 20 ** that writer,
3420: 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 then the number
3430: 6f 66 20 6c 6f 63 6b 73 20 68 65 6c 64 20 62 79 of locks held by
3440: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 6f 74 68 connections oth
3450: 65 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 er. ** than t
3460: 68 65 20 77 72 69 74 65 72 20 6d 75 73 74 20 62 he writer must b
3470: 65 20 61 62 6f 75 74 20 74 6f 20 64 72 6f 70 20 e about to drop
3480: 74 6f 20 7a 65 72 6f 2e 20 49 6e 20 74 68 69 73 to zero. In this
3490: 20 63 61 73 65 0a 20 20 20 20 2a 2a 20 73 65 74 case. ** set
34a0: 20 74 68 65 20 42 54 53 5f 50 45 4e 44 49 4e 47 the BTS_PENDING
34b0: 20 66 6c 61 67 20 74 6f 20 30 2e 0a 20 20 20 20 flag to 0..
34c0: 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 **. ** If the
34d0: 72 65 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e re is not curren
34e0: 74 6c 79 20 61 20 77 72 69 74 65 72 2c 20 74 68 tly a writer, th
34f0: 65 6e 20 42 54 53 5f 50 45 4e 44 49 4e 47 20 6d en BTS_PENDING m
3500: 75 73 74 0a 20 20 20 20 2a 2a 20 62 65 20 7a 65 ust. ** be ze
3510: 72 6f 20 61 6c 72 65 61 64 79 2e 20 53 6f 20 74 ro already. So t
3520: 68 69 73 20 6e 65 78 74 20 6c 69 6e 65 20 69 73 his next line is
3530: 20 68 61 72 6d 6c 65 73 73 20 69 6e 20 74 68 61 harmless in tha
3540: 74 20 63 61 73 65 2e 0a 20 20 20 20 2a 2f 0a 20 t case.. */.
3550: 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 pBt->btsFlags
3560: 20 26 3d 20 7e 42 54 53 5f 50 45 4e 44 49 4e 47 &= ~BTS_PENDING
3570: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 ;. }.}../*.** T
3580: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 68 61 his function cha
3590: 6e 67 65 73 20 61 6c 6c 20 77 72 69 74 65 2d 6c nges all write-l
35a0: 6f 63 6b 73 20 68 65 6c 64 20 62 79 20 42 74 72 ocks held by Btr
35b0: 65 65 20 70 20 69 6e 74 6f 20 72 65 61 64 2d 6c ee p into read-l
35c0: 6f 63 6b 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ocks..*/.static
35d0: 76 6f 69 64 20 64 6f 77 6e 67 72 61 64 65 41 6c void downgradeAl
35e0: 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 62 6c lSharedCacheTabl
35f0: 65 4c 6f 63 6b 73 28 42 74 72 65 65 20 2a 70 29 eLocks(Btree *p)
3600: 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
3610: 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 66 t = p->pBt;. if
3620: 28 20 70 42 74 2d 3e 70 57 72 69 74 65 72 3d 3d ( pBt->pWriter==
3630: 70 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 p ){. BtLock
3640: 2a 70 4c 6f 63 6b 3b 0a 20 20 20 20 70 42 74 2d *pLock;. pBt-
3650: 3e 70 57 72 69 74 65 72 20 3d 20 30 3b 0a 20 20 >pWriter = 0;.
3660: 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
3670: 26 3d 20 7e 28 42 54 53 5f 45 58 43 4c 55 53 49 &= ~(BTS_EXCLUSI
3680: 56 45 7c 42 54 53 5f 50 45 4e 44 49 4e 47 29 3b VE|BTS_PENDING);
3690: 0a 20 20 20 20 66 6f 72 28 70 4c 6f 63 6b 3d 70 . for(pLock=p
36a0: 42 74 2d 3e 70 4c 6f 63 6b 3b 20 70 4c 6f 63 6b Bt->pLock; pLock
36b0: 3b 20 70 4c 6f 63 6b 3d 70 4c 6f 63 6b 2d 3e 70 ; pLock=pLock->p
36c0: 4e 65 78 74 29 7b 0a 20 20 20 20 20 20 61 73 73 Next){. ass
36d0: 65 72 74 28 20 70 4c 6f 63 6b 2d 3e 65 4c 6f 63 ert( pLock->eLoc
36e0: 6b 3d 3d 52 45 41 44 5f 4c 4f 43 4b 20 7c 7c 20 k==READ_LOCK ||
36f0: 70 4c 6f 63 6b 2d 3e 70 42 74 72 65 65 3d 3d 70 pLock->pBtree==p
3700: 20 29 3b 0a 20 20 20 20 20 20 70 4c 6f 63 6b 2d );. pLock-
3710: 3e 65 4c 6f 63 6b 20 3d 20 52 45 41 44 5f 4c 4f >eLock = READ_LO
3720: 43 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a CK;. }. }.}.
3730: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
3740: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
3750: 43 48 45 20 2a 2f 0a 0a 73 74 61 74 69 63 20 76 CHE */..static v
3760: 6f 69 64 20 72 65 6c 65 61 73 65 50 61 67 65 28 oid releasePage(
3770: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 29 3b MemPage *pPage);
3780: 20 20 2f 2a 20 46 6f 72 77 61 72 64 20 72 65 66 /* Forward ref
3790: 65 72 65 6e 63 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a erence */../*.**
37a0: 2a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 *** This routine
37b0: 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 is used inside
37c0: 6f 66 20 61 73 73 65 72 74 28 29 20 6f 6e 6c 79 of assert() only
37d0: 20 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 56 65 72 69 ****.**.** Veri
37e0: 66 79 20 74 68 61 74 20 74 68 65 20 63 75 72 73 fy that the curs
37f0: 6f 72 20 68 6f 6c 64 73 20 74 68 65 20 6d 75 74 or holds the mut
3800: 65 78 20 6f 6e 20 69 74 73 20 42 74 53 68 61 72 ex on its BtShar
3810: 65 64 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c ed.*/.#ifdef SQL
3820: 49 54 45 5f 44 45 42 55 47 0a 73 74 61 74 69 63 ITE_DEBUG.static
3830: 20 69 6e 74 20 63 75 72 73 6f 72 48 6f 6c 64 73 int cursorHolds
3840: 4d 75 74 65 78 28 42 74 43 75 72 73 6f 72 20 2a Mutex(BtCursor *
3850: 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 73 71 6c p){. return sql
3860: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
3870: 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a p->pBt->mutex);.
3880: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 }.#endif...#ifnd
3890: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 ef SQLITE_OMIT_I
38a0: 4e 43 52 42 4c 4f 42 0a 2f 2a 0a 2a 2a 20 49 6e NCRBLOB./*.** In
38b0: 76 61 6c 69 64 61 74 65 20 74 68 65 20 6f 76 65 validate the ove
38c0: 72 66 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 rflow page-list
38d0: 63 61 63 68 65 20 66 6f 72 20 63 75 72 73 6f 72 cache for cursor
38e0: 20 70 43 75 72 2c 20 69 66 20 61 6e 79 2e 0a 2a pCur, if any..*
38f0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 69 6e /.static void in
3900: 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c 6f 77 validateOverflow
3910: 43 61 63 68 65 28 42 74 43 75 72 73 6f 72 20 2a Cache(BtCursor *
3920: 70 43 75 72 29 7b 0a 20 20 61 73 73 65 72 74 28 pCur){. assert(
3930: 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
3940: 78 28 70 43 75 72 29 20 29 3b 0a 20 20 73 71 6c x(pCur) );. sql
3950: 69 74 65 33 5f 66 72 65 65 28 70 43 75 72 2d 3e ite3_free(pCur->
3960: 61 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 20 70 43 aOverflow);. pC
3970: 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 3d 20 ur->aOverflow =
3980: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 61 0;.}../*.** Inva
3990: 6c 69 64 61 74 65 20 74 68 65 20 6f 76 65 72 66 lidate the overf
39a0: 6c 6f 77 20 70 61 67 65 2d 6c 69 73 74 20 63 61 low page-list ca
39b0: 63 68 65 20 66 6f 72 20 61 6c 6c 20 63 75 72 73 che for all curs
39c0: 6f 72 73 20 6f 70 65 6e 65 64 0a 2a 2a 20 6f 6e ors opened.** on
39d0: 20 74 68 65 20 73 68 61 72 65 64 20 62 74 72 65 the shared btre
39e0: 65 20 73 74 72 75 63 74 75 72 65 20 70 42 74 2e e structure pBt.
39f0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
3a00: 69 6e 76 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 invalidateAllOve
3a10: 72 66 6c 6f 77 43 61 63 68 65 28 42 74 53 68 61 rflowCache(BtSha
3a20: 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 42 74 43 red *pBt){. BtC
3a30: 75 72 73 6f 72 20 2a 70 3b 0a 20 20 61 73 73 65 ursor *p;. asse
3a40: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
3a50: 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
3a60: 78 29 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 42 x) );. for(p=pB
3a70: 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 t->pCursor; p; p
3a80: 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 =p->pNext){.
3a90: 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 66 6c invalidateOverfl
3aa0: 6f 77 43 61 63 68 65 28 70 29 3b 0a 20 20 7d 0a owCache(p);. }.
3ab0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
3ac0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
3ad0: 20 62 65 66 6f 72 65 20 6d 6f 64 69 66 79 69 6e before modifyin
3ae0: 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f g the contents o
3af0: 66 20 61 20 74 61 62 6c 65 0a 2a 2a 20 74 6f 20 f a table.** to
3b00: 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20 69 invalidate any i
3b10: 6e 63 72 62 6c 6f 62 20 63 75 72 73 6f 72 73 20 ncrblob cursors
3b20: 74 68 61 74 20 61 72 65 20 6f 70 65 6e 20 6f 6e that are open on
3b30: 20 74 68 65 0a 2a 2a 20 72 6f 77 20 6f 72 20 6f the.** row or o
3b40: 6e 65 20 6f 66 20 74 68 65 20 72 6f 77 73 20 62 ne of the rows b
3b50: 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 0a 2a eing modified..*
3b60: 2a 0a 2a 2a 20 49 66 20 61 72 67 75 6d 65 6e 74 *.** If argument
3b70: 20 69 73 43 6c 65 61 72 54 61 62 6c 65 20 69 73 isClearTable is
3b80: 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 true, then the
3b90: 65 6e 74 69 72 65 20 63 6f 6e 74 65 6e 74 73 20 entire contents
3ba0: 6f 66 20 74 68 65 0a 2a 2a 20 74 61 62 6c 65 20 of the.** table
3bb0: 69 73 20 61 62 6f 75 74 20 74 6f 20 62 65 20 64 is about to be d
3bc0: 65 6c 65 74 65 64 2e 20 49 6e 20 74 68 69 73 20 eleted. In this
3bd0: 63 61 73 65 20 69 6e 76 61 6c 69 64 61 74 65 20 case invalidate
3be0: 61 6c 6c 20 69 6e 63 72 62 6c 6f 62 0a 2a 2a 20 all incrblob.**
3bf0: 63 75 72 73 6f 72 73 20 6f 70 65 6e 20 6f 6e 20 cursors open on
3c00: 61 6e 79 20 72 6f 77 20 77 69 74 68 69 6e 20 74 any row within t
3c10: 68 65 20 74 61 62 6c 65 20 77 69 74 68 20 72 6f he table with ro
3c20: 6f 74 2d 70 61 67 65 20 70 67 6e 6f 52 6f 6f 74 ot-page pgnoRoot
3c30: 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 ..**.** Otherwis
3c40: 65 2c 20 69 66 20 61 72 67 75 6d 65 6e 74 20 69 e, if argument i
3c50: 73 43 6c 65 61 72 54 61 62 6c 65 20 69 73 20 66 sClearTable is f
3c60: 61 6c 73 65 2c 20 74 68 65 6e 20 74 68 65 20 72 alse, then the r
3c70: 6f 77 20 77 69 74 68 0a 2a 2a 20 72 6f 77 69 64 ow with.** rowid
3c80: 20 69 52 6f 77 20 69 73 20 62 65 69 6e 67 20 72 iRow is being r
3c90: 65 70 6c 61 63 65 64 20 6f 72 20 64 65 6c 65 74 eplaced or delet
3ca0: 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ed. In this case
3cb0: 20 69 6e 76 61 6c 69 64 61 74 65 0a 2a 2a 20 6f invalidate.** o
3cc0: 6e 6c 79 20 74 68 6f 73 65 20 69 6e 63 72 62 6c nly those incrbl
3cd0: 6f 62 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 20 ob cursors open
3ce0: 6f 6e 20 74 68 61 74 20 73 70 65 63 69 66 69 63 on that specific
3cf0: 20 72 6f 77 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 row..*/.static
3d00: 76 6f 69 64 20 69 6e 76 61 6c 69 64 61 74 65 49 void invalidateI
3d10: 6e 63 72 62 6c 6f 62 43 75 72 73 6f 72 73 28 0a ncrblobCursors(.
3d20: 20 20 42 74 72 65 65 20 2a 70 42 74 72 65 65 2c Btree *pBtree,
3d30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
3d40: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
3d50: 6f 20 63 68 65 63 6b 20 2a 2f 0a 20 20 69 36 34 o check */. i64
3d60: 20 69 52 6f 77 2c 20 20 20 20 20 20 20 20 20 20 iRow,
3d70: 20 20 20 20 20 2f 2a 20 54 68 65 20 72 6f 77 69 /* The rowi
3d80: 64 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 20 d that might be
3d90: 63 68 61 6e 67 69 6e 67 20 2a 2f 0a 20 20 69 6e changing */. in
3da0: 74 20 69 73 43 6c 65 61 72 54 61 62 6c 65 20 20 t isClearTable
3db0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
3dc0: 20 61 6c 6c 20 72 6f 77 73 20 61 72 65 20 62 65 all rows are be
3dd0: 69 6e 67 20 64 65 6c 65 74 65 64 20 2a 2f 0a 29 ing deleted */.)
3de0: 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 3b {. BtCursor *p;
3df0: 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
3e00: 20 3d 20 70 42 74 72 65 65 2d 3e 70 42 74 3b 0a = pBtree->pBt;.
3e10: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
3e20: 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 3BtreeHoldsMutex
3e30: 28 70 42 74 72 65 65 29 20 29 3b 0a 20 20 66 6f (pBtree) );. fo
3e40: 72 28 70 3d 70 42 74 2d 3e 70 43 75 72 73 6f 72 r(p=pBt->pCursor
3e50: 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 ; p; p=p->pNext)
3e60: 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 69 73 49 {. if( p->isI
3e70: 6e 63 72 62 6c 6f 62 48 61 6e 64 6c 65 20 26 26 ncrblobHandle &&
3e80: 20 28 69 73 43 6c 65 61 72 54 61 62 6c 65 20 7c (isClearTable |
3e90: 7c 20 70 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d | p->info.nKey==
3ea0: 69 52 6f 77 29 20 29 7b 0a 20 20 20 20 20 20 70 iRow) ){. p
3eb0: 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f ->eState = CURSO
3ec0: 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 7d R_INVALID;. }
3ed0: 0a 20 20 7d 0a 7d 0a 0a 23 65 6c 73 65 0a 20 20 . }.}..#else.
3ee0: 2f 2a 20 53 74 75 62 20 66 75 6e 63 74 69 6f 6e /* Stub function
3ef0: 73 20 77 68 65 6e 20 49 4e 43 52 42 4c 4f 42 20 s when INCRBLOB
3f00: 69 73 20 6f 6d 69 74 74 65 64 20 2a 2f 0a 20 20 is omitted */.
3f10: 23 64 65 66 69 6e 65 20 69 6e 76 61 6c 69 64 61 #define invalida
3f20: 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 68 65 28 teOverflowCache(
3f30: 78 29 0a 20 20 23 64 65 66 69 6e 65 20 69 6e 76 x). #define inv
3f40: 61 6c 69 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c alidateAllOverfl
3f50: 6f 77 43 61 63 68 65 28 78 29 0a 20 20 23 64 65 owCache(x). #de
3f60: 66 69 6e 65 20 69 6e 76 61 6c 69 64 61 74 65 49 fine invalidateI
3f70: 6e 63 72 62 6c 6f 62 43 75 72 73 6f 72 73 28 78 ncrblobCursors(x
3f80: 2c 79 2c 7a 29 0a 23 65 6e 64 69 66 20 2f 2a 20 ,y,z).#endif /*
3f90: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 SQLITE_OMIT_INCR
3fa0: 42 4c 4f 42 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 BLOB */../*.** S
3fb0: 65 74 20 62 69 74 20 70 67 6e 6f 20 6f 66 20 74 et bit pgno of t
3fc0: 68 65 20 42 74 53 68 61 72 65 64 2e 70 48 61 73 he BtShared.pHas
3fd0: 43 6f 6e 74 65 6e 74 20 62 69 74 76 65 63 2e 20 Content bitvec.
3fe0: 54 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 0a This is called .
3ff0: 2a 2a 20 77 68 65 6e 20 61 20 70 61 67 65 20 74 ** when a page t
4000: 68 61 74 20 70 72 65 76 69 6f 75 73 6c 79 20 63 hat previously c
4010: 6f 6e 74 61 69 6e 65 64 20 64 61 74 61 20 62 65 ontained data be
4020: 63 6f 6d 65 73 20 61 20 66 72 65 65 2d 6c 69 73 comes a free-lis
4030: 74 20 6c 65 61 66 20 0a 2a 2a 20 70 61 67 65 2e t leaf .** page.
4040: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 42 74 53 68 61 .**.** The BtSha
4050: 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 red.pHasContent
4060: 62 69 74 76 65 63 20 65 78 69 73 74 73 20 74 6f bitvec exists to
4070: 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 61 6e 20 work around an
4080: 6f 62 73 63 75 72 65 0a 2a 2a 20 62 75 67 20 63 obscure.** bug c
4090: 61 75 73 65 64 20 62 79 20 74 68 65 20 69 6e 74 aused by the int
40a0: 65 72 61 63 74 69 6f 6e 20 6f 66 20 74 77 6f 20 eraction of two
40b0: 75 73 65 66 75 6c 20 49 4f 20 6f 70 74 69 6d 69 useful IO optimi
40c0: 7a 61 74 69 6f 6e 73 20 73 75 72 72 6f 75 6e 64 zations surround
40d0: 69 6e 67 0a 2a 2a 20 66 72 65 65 2d 6c 69 73 74 ing.** free-list
40e0: 20 6c 65 61 66 20 70 61 67 65 73 3a 0a 2a 2a 0a leaf pages:.**.
40f0: 2a 2a 20 20 20 31 29 20 57 68 65 6e 20 61 6c 6c ** 1) When all
4100: 20 64 61 74 61 20 69 73 20 64 65 6c 65 74 65 64 data is deleted
4110: 20 66 72 6f 6d 20 61 20 70 61 67 65 20 61 6e 64 from a page and
4120: 20 74 68 65 20 70 61 67 65 20 62 65 63 6f 6d 65 the page become
4130: 73 0a 2a 2a 20 20 20 20 20 20 61 20 66 72 65 65 s.** a free
4140: 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 2c -list leaf page,
4150: 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 the page is not
4160: 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 written to the
4170: 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 database.**
4180: 20 28 61 73 20 66 72 65 65 2d 6c 69 73 74 20 6c (as free-list l
4190: 65 61 66 20 70 61 67 65 73 20 63 6f 6e 74 61 69 eaf pages contai
41a0: 6e 20 6e 6f 20 6d 65 61 6e 69 6e 67 66 75 6c 20 n no meaningful
41b0: 64 61 74 61 29 2e 20 53 6f 6d 65 74 69 6d 65 73 data). Sometimes
41c0: 0a 2a 2a 20 20 20 20 20 20 73 75 63 68 20 61 20 .** such a
41d0: 70 61 67 65 20 69 73 20 6e 6f 74 20 65 76 65 6e page is not even
41e0: 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 28 61 73 20 journalled (as
41f0: 69 74 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 6d it will not be m
4200: 6f 64 69 66 69 65 64 2c 0a 2a 2a 20 20 20 20 20 odified,.**
4210: 20 77 68 79 20 62 6f 74 68 65 72 20 6a 6f 75 72 why bother jour
4220: 6e 61 6c 6c 69 6e 67 20 69 74 3f 29 2e 0a 2a 2a nalling it?)..**
4230: 0a 2a 2a 20 20 20 32 29 20 57 68 65 6e 20 61 20 .** 2) When a
4240: 66 72 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 free-list leaf p
4250: 61 67 65 20 69 73 20 72 65 75 73 65 64 2c 20 69 age is reused, i
4260: 74 73 20 63 6f 6e 74 65 6e 74 20 69 73 20 6e 6f ts content is no
4270: 74 20 72 65 61 64 0a 2a 2a 20 20 20 20 20 20 66 t read.** f
4280: 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
4290: 20 6f 72 20 77 72 69 74 74 65 6e 20 74 6f 20 74 or written to t
42a0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
42b0: 28 77 68 79 20 73 68 6f 75 6c 64 20 69 74 0a 2a (why should it.*
42c0: 2a 20 20 20 20 20 20 62 65 2c 20 69 66 20 69 74 * be, if it
42d0: 20 69 73 20 6e 6f 74 20 61 74 20 61 6c 6c 20 6d is not at all m
42e0: 65 61 6e 69 6e 67 66 75 6c 3f 29 2e 0a 2a 2a 0a eaningful?)..**.
42f0: 2a 2a 20 42 79 20 74 68 65 6d 73 65 6c 76 65 73 ** By themselves
4300: 2c 20 74 68 65 73 65 20 6f 70 74 69 6d 69 7a 61 , these optimiza
4310: 74 69 6f 6e 73 20 77 6f 72 6b 20 66 69 6e 65 20 tions work fine
4320: 61 6e 64 20 70 72 6f 76 69 64 65 20 61 20 68 61 and provide a ha
4330: 6e 64 79 0a 2a 2a 20 70 65 72 66 6f 72 6d 61 6e ndy.** performan
4340: 63 65 20 62 6f 6f 73 74 20 74 6f 20 62 75 6c 6b ce boost to bulk
4350: 20 64 65 6c 65 74 65 20 6f 72 20 69 6e 73 65 72 delete or inser
4360: 74 20 6f 70 65 72 61 74 69 6f 6e 73 2e 20 48 6f t operations. Ho
4370: 77 65 76 65 72 2c 20 69 66 0a 2a 2a 20 61 20 70 wever, if.** a p
4380: 61 67 65 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 age is moved to
4390: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 61 6e the free-list an
43a0: 64 20 74 68 65 6e 20 72 65 75 73 65 64 20 77 69 d then reused wi
43b0: 74 68 69 6e 20 74 68 65 20 73 61 6d 65 0a 2a 2a thin the same.**
43c0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 20 transaction, a
43d0: 70 72 6f 62 6c 65 6d 20 63 6f 6d 65 73 20 75 70 problem comes up
43e0: 2e 20 49 66 20 74 68 65 20 70 61 67 65 20 69 73 . If the page is
43f0: 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 not journalled
4400: 77 68 65 6e 0a 2a 2a 20 69 74 20 69 73 20 6d 6f when.** it is mo
4410: 76 65 64 20 74 6f 20 74 68 65 20 66 72 65 65 2d ved to the free-
4420: 6c 69 73 74 20 61 6e 64 20 69 74 20 69 73 20 61 list and it is a
4430: 6c 73 6f 20 6e 6f 74 20 6a 6f 75 72 6e 61 6c 6c lso not journall
4440: 65 64 20 77 68 65 6e 20 69 74 0a 2a 2a 20 69 73 ed when it.** is
4450: 20 65 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 extracted from
4460: 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 61 6e the free-list an
4470: 64 20 72 65 75 73 65 64 2c 20 74 68 65 6e 20 74 d reused, then t
4480: 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 he original data
4490: 0a 2a 2a 20 6d 61 79 20 62 65 20 6c 6f 73 74 2e .** may be lost.
44a0: 20 49 6e 20 74 68 65 20 65 76 65 6e 74 20 6f 66 In the event of
44b0: 20 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 69 74 20 a rollback, it
44c0: 6d 61 79 20 6e 6f 74 20 62 65 20 70 6f 73 73 69 may not be possi
44d0: 62 6c 65 0a 2a 2a 20 74 6f 20 72 65 73 74 6f 72 ble.** to restor
44e0: 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 74 e the database t
44f0: 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 63 o its original c
4500: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 2e 0a 2a 2a onfiguration..**
4510: 0a 2a 2a 20 54 68 65 20 73 6f 6c 75 74 69 6f 6e .** The solution
4520: 20 69 73 20 74 68 65 20 42 74 53 68 61 72 65 64 is the BtShared
4530: 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 62 69 74 .pHasContent bit
4540: 76 65 63 2e 20 57 68 65 6e 65 76 65 72 20 61 20 vec. Whenever a
4550: 70 61 67 65 20 69 73 20 0a 2a 2a 20 6d 6f 76 65 page is .** move
4560: 64 20 74 6f 20 62 65 63 6f 6d 65 20 61 20 66 72 d to become a fr
4570: 65 65 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 ee-list leaf pag
4580: 65 2c 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e e, the correspon
4590: 64 69 6e 67 20 62 69 74 20 69 73 0a 2a 2a 20 73 ding bit is.** s
45a0: 65 74 20 69 6e 20 74 68 65 20 62 69 74 76 65 63 et in the bitvec
45b0: 2e 20 57 68 65 6e 65 76 65 72 20 61 20 6c 65 61 . Whenever a lea
45c0: 66 20 70 61 67 65 20 69 73 20 65 78 74 72 61 63 f page is extrac
45d0: 74 65 64 20 66 72 6f 6d 20 74 68 65 20 66 72 65 ted from the fre
45e0: 65 2d 6c 69 73 74 2c 0a 2a 2a 20 6f 70 74 69 6d e-list,.** optim
45f0: 69 7a 61 74 69 6f 6e 20 32 20 61 62 6f 76 65 20 ization 2 above
4600: 69 73 20 6f 6d 69 74 74 65 64 20 69 66 20 74 68 is omitted if th
4610: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e corresponding
4620: 62 69 74 20 69 73 20 61 6c 72 65 61 64 79 0a 2a bit is already.*
4630: 2a 20 73 65 74 20 69 6e 20 42 74 53 68 61 72 65 * set in BtShare
4640: 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 2e 20 54 d.pHasContent. T
4650: 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 he contents of t
4660: 68 65 20 62 69 74 76 65 63 20 61 72 65 20 63 6c he bitvec are cl
4670: 65 61 72 65 64 0a 2a 2a 20 61 74 20 74 68 65 20 eared.** at the
4680: 65 6e 64 20 6f 66 20 65 76 65 72 79 20 74 72 61 end of every tra
4690: 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 nsaction..*/.sta
46a0: 74 69 63 20 69 6e 74 20 62 74 72 65 65 53 65 74 tic int btreeSet
46b0: 48 61 73 43 6f 6e 74 65 6e 74 28 42 74 53 68 61 HasContent(BtSha
46c0: 72 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 red *pBt, Pgno p
46d0: 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d gno){. int rc =
46e0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
46f0: 28 20 21 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 ( !pBt->pHasCont
4700: 65 6e 74 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ent ){. asser
4710: 74 28 20 70 67 6e 6f 3c 3d 70 42 74 2d 3e 6e 50 t( pgno<=pBt->nP
4720: 61 67 65 20 29 3b 0a 20 20 20 20 70 42 74 2d 3e age );. pBt->
4730: 70 48 61 73 43 6f 6e 74 65 6e 74 20 3d 20 73 71 pHasContent = sq
4740: 6c 69 74 65 33 42 69 74 76 65 63 43 72 65 61 74 lite3BitvecCreat
4750: 65 28 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 e(pBt->nPage);.
4760: 20 20 20 69 66 28 20 21 70 42 74 2d 3e 70 48 61 if( !pBt->pHa
4770: 73 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 sContent ){.
4780: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
4790: 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 MEM;. }. }.
47a0: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
47b0: 4f 4b 20 26 26 20 70 67 6e 6f 3c 3d 73 71 6c 69 OK && pgno<=sqli
47c0: 74 65 33 42 69 74 76 65 63 53 69 7a 65 28 70 42 te3BitvecSize(pB
47d0: 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 29 20 t->pHasContent)
47e0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
47f0: 74 65 33 42 69 74 76 65 63 53 65 74 28 70 42 74 te3BitvecSet(pBt
4800: 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 2c 20 70 ->pHasContent, p
4810: 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 gno);. }. retu
4820: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
4830: 51 75 65 72 79 20 74 68 65 20 42 74 53 68 61 72 Query the BtShar
4840: 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 20 76 ed.pHasContent v
4850: 65 63 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 ector..**.** Thi
4860: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
4870: 6c 6c 65 64 20 77 68 65 6e 20 61 20 66 72 65 65 lled when a free
4880: 2d 6c 69 73 74 20 6c 65 61 66 20 70 61 67 65 20 -list leaf page
4890: 69 73 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 is removed from
48a0: 74 68 65 0a 2a 2a 20 66 72 65 65 2d 6c 69 73 74 the.** free-list
48b0: 20 66 6f 72 20 72 65 75 73 65 2e 20 49 74 20 72 for reuse. It r
48c0: 65 74 75 72 6e 73 20 66 61 6c 73 65 20 69 66 20 eturns false if
48d0: 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 72 65 it is safe to re
48e0: 74 72 69 65 76 65 20 74 68 65 0a 2a 2a 20 70 61 trieve the.** pa
48f0: 67 65 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ge from the page
4900: 72 20 6c 61 79 65 72 20 77 69 74 68 20 74 68 65 r layer with the
4910: 20 27 6e 6f 2d 63 6f 6e 74 65 6e 74 27 20 66 6c 'no-content' fl
4920: 61 67 20 73 65 74 2e 20 54 72 75 65 20 6f 74 68 ag set. True oth
4930: 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 erwise..*/.stati
4940: 63 20 69 6e 74 20 62 74 72 65 65 47 65 74 48 61 c int btreeGetHa
4950: 73 43 6f 6e 74 65 6e 74 28 42 74 53 68 61 72 65 sContent(BtShare
4960: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 70 67 6e d *pBt, Pgno pgn
4970: 6f 29 7b 0a 20 20 42 69 74 76 65 63 20 2a 70 20 o){. Bitvec *p
4980: 3d 20 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 = pBt->pHasConte
4990: 6e 74 3b 0a 20 20 72 65 74 75 72 6e 20 28 70 20 nt;. return (p
49a0: 26 26 20 28 70 67 6e 6f 3e 73 71 6c 69 74 65 33 && (pgno>sqlite3
49b0: 42 69 74 76 65 63 53 69 7a 65 28 70 29 20 7c 7c BitvecSize(p) ||
49c0: 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 sqlite3BitvecTe
49d0: 73 74 28 70 2c 20 70 67 6e 6f 29 29 29 3b 0a 7d st(p, pgno)));.}
49e0: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 28 64 ../*.** Clear (d
49f0: 65 73 74 72 6f 79 29 20 74 68 65 20 42 74 53 68 estroy) the BtSh
4a00: 61 72 65 64 2e 70 48 61 73 43 6f 6e 74 65 6e 74 ared.pHasContent
4a10: 20 62 69 74 76 65 63 2e 20 54 68 69 73 20 73 68 bitvec. This sh
4a20: 6f 75 6c 64 20 62 65 0a 2a 2a 20 69 6e 76 6f 6b ould be.** invok
4a30: 65 64 20 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 ed at the conclu
4a40: 73 69 6f 6e 20 6f 66 20 65 61 63 68 20 77 72 69 sion of each wri
4a50: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a te-transaction..
4a60: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 62 */.static void b
4a70: 74 72 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 treeClearHasCont
4a80: 65 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 ent(BtShared *pB
4a90: 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 42 69 74 t){. sqlite3Bit
4aa0: 76 65 63 44 65 73 74 72 6f 79 28 70 42 74 2d 3e vecDestroy(pBt->
4ab0: 70 48 61 73 43 6f 6e 74 65 6e 74 29 3b 0a 20 20 pHasContent);.
4ac0: 70 42 74 2d 3e 70 48 61 73 43 6f 6e 74 65 6e 74 pBt->pHasContent
4ad0: 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 = 0;.}../*.** S
4ae0: 61 76 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 ave the current
4af0: 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e 20 cursor position
4b00: 69 6e 20 74 68 65 20 76 61 72 69 61 62 6c 65 73 in the variables
4b10: 20 42 74 43 75 72 73 6f 72 2e 6e 4b 65 79 20 0a BtCursor.nKey .
4b20: 2a 2a 20 61 6e 64 20 42 74 43 75 72 73 6f 72 2e ** and BtCursor.
4b30: 70 4b 65 79 2e 20 54 68 65 20 63 75 72 73 6f 72 pKey. The cursor
4b40: 27 73 20 73 74 61 74 65 20 69 73 20 73 65 74 20 's state is set
4b50: 74 6f 20 43 55 52 53 4f 52 5f 52 45 51 55 49 52 to CURSOR_REQUIR
4b60: 45 53 45 45 4b 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 ESEEK..**.** The
4b70: 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 6e 73 caller must ens
4b80: 75 72 65 20 74 68 61 74 20 74 68 65 20 63 75 72 ure that the cur
4b90: 73 6f 72 20 69 73 20 76 61 6c 69 64 20 28 68 61 sor is valid (ha
4ba0: 73 20 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 s eState==CURSOR
4bb0: 5f 56 41 4c 49 44 29 0a 2a 2a 20 70 72 69 6f 72 _VALID).** prior
4bc0: 20 74 6f 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 to calling this
4bd0: 20 72 6f 75 74 69 6e 65 2e 20 20 0a 2a 2f 0a 73 routine. .*/.s
4be0: 74 61 74 69 63 20 69 6e 74 20 73 61 76 65 43 75 tatic int saveCu
4bf0: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 42 74 43 rsorPosition(BtC
4c00: 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 ursor *pCur){.
4c10: 69 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 int rc;.. asser
4c20: 74 28 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d t( CURSOR_VALID=
4c30: 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 20 29 3b =pCur->eState );
4c40: 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 70 43 . assert( 0==pC
4c50: 75 72 2d 3e 70 4b 65 79 20 29 3b 0a 20 20 61 73 ur->pKey );. as
4c60: 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
4c70: 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
4c80: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 . rc = sqlite3B
4c90: 74 72 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 treeKeySize(pCur
4ca0: 2c 20 26 70 43 75 72 2d 3e 6e 4b 65 79 29 3b 0a , &pCur->nKey);.
4cb0: 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 assert( rc==SQ
4cc0: 4c 49 54 45 5f 4f 4b 20 29 3b 20 20 2f 2a 20 4b LITE_OK ); /* K
4cd0: 65 79 53 69 7a 65 28 29 20 63 61 6e 6e 6f 74 20 eySize() cannot
4ce0: 66 61 69 6c 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 fail */.. /* If
4cf0: 20 74 68 69 73 20 69 73 20 61 6e 20 69 6e 74 4b this is an intK
4d00: 65 79 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 74 ey table, then t
4d10: 68 65 20 61 62 6f 76 65 20 63 61 6c 6c 20 74 6f he above call to
4d20: 20 42 74 72 65 65 4b 65 79 53 69 7a 65 28 29 0a BtreeKeySize().
4d30: 20 20 2a 2a 20 73 74 6f 72 65 73 20 74 68 65 20 ** stores the
4d40: 69 6e 74 65 67 65 72 20 6b 65 79 20 69 6e 20 70 integer key in p
4d50: 43 75 72 2d 3e 6e 4b 65 79 2e 20 49 6e 20 74 68 Cur->nKey. In th
4d60: 69 73 20 63 61 73 65 20 74 68 69 73 20 76 61 6c is case this val
4d70: 75 65 20 69 73 0a 20 20 2a 2a 20 61 6c 6c 20 74 ue is. ** all t
4d80: 68 61 74 20 69 73 20 72 65 71 75 69 72 65 64 2e hat is required.
4d90: 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 70 Otherwise, if p
4da0: 43 75 72 20 69 73 20 6e 6f 74 20 6f 70 65 6e 20 Cur is not open
4db0: 6f 6e 20 61 6e 20 69 6e 74 4b 65 79 0a 20 20 2a on an intKey. *
4dc0: 2a 20 74 61 62 6c 65 2c 20 74 68 65 6e 20 6d 61 * table, then ma
4dd0: 6c 6c 6f 63 20 73 70 61 63 65 20 66 6f 72 20 61 lloc space for a
4de0: 6e 64 20 73 74 6f 72 65 20 74 68 65 20 70 43 75 nd store the pCu
4df0: 72 2d 3e 6e 4b 65 79 20 62 79 74 65 73 20 6f 66 r->nKey bytes of
4e00: 20 6b 65 79 20 0a 20 20 2a 2a 20 64 61 74 61 2e key . ** data.
4e10: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 70 . */. if( 0==p
4e20: 43 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2d 3e Cur->apPage[0]->
4e30: 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 76 6f intKey ){. vo
4e40: 69 64 20 2a 70 4b 65 79 20 3d 20 73 71 6c 69 74 id *pKey = sqlit
4e50: 65 33 4d 61 6c 6c 6f 63 28 20 28 69 6e 74 29 70 e3Malloc( (int)p
4e60: 43 75 72 2d 3e 6e 4b 65 79 20 29 3b 0a 20 20 20 Cur->nKey );.
4e70: 20 69 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 20 if( pKey ){.
4e80: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
4e90: 74 72 65 65 4b 65 79 28 70 43 75 72 2c 20 30 2c treeKey(pCur, 0,
4ea0: 20 28 69 6e 74 29 70 43 75 72 2d 3e 6e 4b 65 79 (int)pCur->nKey
4eb0: 2c 20 70 4b 65 79 29 3b 0a 20 20 20 20 20 20 69 , pKey);. i
4ec0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
4ed0: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 43 75 72 ){. pCur
4ee0: 2d 3e 70 4b 65 79 20 3d 20 70 4b 65 79 3b 0a 20 ->pKey = pKey;.
4ef0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
4f00: 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
4f10: 28 70 4b 65 79 29 3b 0a 20 20 20 20 20 20 7d 0a (pKey);. }.
4f20: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
4f30: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
4f40: 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 EM;. }. }.
4f50: 61 73 73 65 72 74 28 20 21 70 43 75 72 2d 3e 61 assert( !pCur->a
4f60: 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 pPage[0]->intKey
4f70: 20 7c 7c 20 21 70 43 75 72 2d 3e 70 4b 65 79 20 || !pCur->pKey
4f80: 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 );.. if( rc==SQ
4f90: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
4fa0: 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d nt i;. for(i=
4fb0: 30 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 67 0; i<=pCur->iPag
4fc0: 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72 e; i++){. r
4fd0: 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 2d eleasePage(pCur-
4fe0: 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 20 >apPage[i]);.
4ff0: 20 20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b pCur->apPage[
5000: 69 5d 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 i] = 0;. }.
5010: 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 pCur->iPage =
5020: 2d 31 3b 0a 20 20 20 20 70 43 75 72 2d 3e 65 53 -1;. pCur->eS
5030: 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 52 45 tate = CURSOR_RE
5040: 51 55 49 52 45 53 45 45 4b 3b 0a 20 20 7d 0a 0a QUIRESEEK;. }..
5050: 20 20 69 6e 76 61 6c 69 64 61 74 65 4f 76 65 72 invalidateOver
5060: 66 6c 6f 77 43 61 63 68 65 28 70 43 75 72 29 3b flowCache(pCur);
5070: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
5080: 0a 2f 2a 0a 2a 2a 20 53 61 76 65 20 74 68 65 20 ./*.** Save the
5090: 70 6f 73 69 74 69 6f 6e 73 20 6f 66 20 61 6c 6c positions of all
50a0: 20 63 75 72 73 6f 72 73 20 28 65 78 63 65 70 74 cursors (except
50b0: 20 70 45 78 63 65 70 74 29 20 74 68 61 74 20 61 pExcept) that a
50c0: 72 65 20 6f 70 65 6e 20 6f 6e 0a 2a 2a 20 74 68 re open on.** th
50d0: 65 20 74 61 62 6c 65 20 20 77 69 74 68 20 72 6f e table with ro
50e0: 6f 74 2d 70 61 67 65 20 69 52 6f 6f 74 2e 20 55 ot-page iRoot. U
50f0: 73 75 61 6c 6c 79 2c 20 74 68 69 73 20 69 73 20 sually, this is
5100: 63 61 6c 6c 65 64 20 6a 75 73 74 20 62 65 66 6f called just befo
5110: 72 65 20 63 75 72 73 6f 72 0a 2a 2a 20 70 45 78 re cursor.** pEx
5120: 63 65 70 74 20 69 73 20 75 73 65 64 20 74 6f 20 cept is used to
5130: 6d 6f 64 69 66 79 20 74 68 65 20 74 61 62 6c 65 modify the table
5140: 20 28 42 74 72 65 65 44 65 6c 65 74 65 28 29 20 (BtreeDelete()
5150: 6f 72 20 42 74 72 65 65 49 6e 73 65 72 74 28 29 or BtreeInsert()
5160: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 )..*/.static int
5170: 20 73 61 76 65 41 6c 6c 43 75 72 73 6f 72 73 28 saveAllCursors(
5180: 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
5190: 67 6e 6f 20 69 52 6f 6f 74 2c 20 42 74 43 75 72 gno iRoot, BtCur
51a0: 73 6f 72 20 2a 70 45 78 63 65 70 74 29 7b 0a 20 sor *pExcept){.
51b0: 20 42 74 43 75 72 73 6f 72 20 2a 70 3b 0a 20 20 BtCursor *p;.
51c0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
51d0: 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
51e0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
51f0: 72 74 28 20 70 45 78 63 65 70 74 3d 3d 30 20 7c rt( pExcept==0 |
5200: 7c 20 70 45 78 63 65 70 74 2d 3e 70 42 74 3d 3d | pExcept->pBt==
5210: 70 42 74 20 29 3b 0a 20 20 66 6f 72 28 70 3d 70 pBt );. for(p=p
5220: 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 Bt->pCursor; p;
5230: 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 p=p->pNext){.
5240: 20 69 66 28 20 70 21 3d 70 45 78 63 65 70 74 20 if( p!=pExcept
5250: 26 26 20 28 30 3d 3d 69 52 6f 6f 74 20 7c 7c 20 && (0==iRoot ||
5260: 70 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 69 52 6f p->pgnoRoot==iRo
5270: 6f 74 29 20 26 26 20 0a 20 20 20 20 20 20 20 20 ot) && .
5280: 70 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f p->eState==CURSO
5290: 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 20 R_VALID ){.
52a0: 20 69 6e 74 20 72 63 20 3d 20 73 61 76 65 43 75 int rc = saveCu
52b0: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 29 3b rsorPosition(p);
52c0: 0a 20 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 . if( SQLIT
52d0: 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 E_OK!=rc ){.
52e0: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
52f0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
5300: 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
5310: 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c _OK;.}../*.** Cl
5320: 65 61 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 ear the current
5330: 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e 2e cursor position.
5340: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
5350: 42 74 72 65 65 43 6c 65 61 72 43 75 72 73 6f 72 BtreeClearCursor
5360: 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
5370: 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 {. assert( curs
5380: 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
5390: 72 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f r) );. sqlite3_
53a0: 66 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 29 free(pCur->pKey)
53b0: 3b 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 20 3d ;. pCur->pKey =
53c0: 20 30 3b 0a 20 20 70 43 75 72 2d 3e 65 53 74 61 0;. pCur->eSta
53d0: 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 te = CURSOR_INVA
53e0: 4c 49 44 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e LID;.}../*.** In
53f0: 20 74 68 69 73 20 76 65 72 73 69 6f 6e 20 6f 66 this version of
5400: 20 42 74 72 65 65 4d 6f 76 65 74 6f 2c 20 70 4b BtreeMoveto, pK
5410: 65 79 20 69 73 20 61 20 70 61 63 6b 65 64 20 69 ey is a packed i
5420: 6e 64 65 78 20 72 65 63 6f 72 64 0a 2a 2a 20 73 ndex record.** s
5430: 75 63 68 20 61 73 20 69 73 20 67 65 6e 65 72 61 uch as is genera
5440: 74 65 64 20 62 79 20 74 68 65 20 4f 50 5f 4d 61 ted by the OP_Ma
5450: 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e keRecord opcode.
5460: 20 20 55 6e 70 61 63 6b 20 74 68 65 0a 2a 2a 20 Unpack the.**
5470: 72 65 63 6f 72 64 20 61 6e 64 20 74 68 65 6e 20 record and then
5480: 63 61 6c 6c 20 42 74 72 65 65 4d 6f 76 65 74 6f call BtreeMoveto
5490: 55 6e 70 61 63 6b 65 64 28 29 20 74 6f 20 64 6f Unpacked() to do
54a0: 20 74 68 65 20 77 6f 72 6b 2e 0a 2a 2f 0a 73 74 the work..*/.st
54b0: 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 4d 6f atic int btreeMo
54c0: 76 65 74 6f 28 0a 20 20 42 74 43 75 72 73 6f 72 veto(. BtCursor
54d0: 20 2a 70 43 75 72 2c 20 20 20 20 20 2f 2a 20 43 *pCur, /* C
54e0: 75 72 73 6f 72 20 6f 70 65 6e 20 6f 6e 20 74 68 ursor open on th
54f0: 65 20 62 74 72 65 65 20 74 6f 20 62 65 20 73 65 e btree to be se
5500: 61 72 63 68 65 64 20 2a 2f 0a 20 20 63 6f 6e 73 arched */. cons
5510: 74 20 76 6f 69 64 20 2a 70 4b 65 79 2c 20 20 20 t void *pKey,
5520: 2f 2a 20 50 61 63 6b 65 64 20 6b 65 79 20 69 66 /* Packed key if
5530: 20 74 68 65 20 62 74 72 65 65 20 69 73 20 61 6e the btree is an
5540: 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 36 34 20 index */. i64
5550: 6e 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 nKey,
5560: 2f 2a 20 49 6e 74 65 67 65 72 20 6b 65 79 20 66 /* Integer key f
5570: 6f 72 20 74 61 62 6c 65 73 2e 20 20 53 69 7a 65 or tables. Size
5580: 20 6f 66 20 70 4b 65 79 20 66 6f 72 20 69 6e 64 of pKey for ind
5590: 69 63 65 73 20 2a 2f 0a 20 20 69 6e 74 20 62 69 ices */. int bi
55a0: 61 73 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a as, /*
55b0: 20 42 69 61 73 20 73 65 61 72 63 68 20 74 6f 20 Bias search to
55c0: 74 68 65 20 68 69 67 68 20 65 6e 64 20 2a 2f 0a the high end */.
55d0: 20 20 69 6e 74 20 2a 70 52 65 73 20 20 20 20 20 int *pRes
55e0: 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 73 /* Write s
55f0: 65 61 72 63 68 20 72 65 73 75 6c 74 73 20 68 65 earch results he
5600: 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 re */.){. int r
5610: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
5620: 20 20 20 20 20 20 2f 2a 20 53 74 61 74 75 73 20 /* Status
5630: 63 6f 64 65 20 2a 2f 0a 20 20 55 6e 70 61 63 6b code */. Unpack
5640: 65 64 52 65 63 6f 72 64 20 2a 70 49 64 78 4b 65 edRecord *pIdxKe
5650: 79 3b 20 20 20 2f 2a 20 55 6e 70 61 63 6b 65 64 y; /* Unpacked
5660: 20 69 6e 64 65 78 20 6b 65 79 20 2a 2f 0a 20 20 index key */.
5670: 63 68 61 72 20 61 53 70 61 63 65 5b 31 35 30 5d char aSpace[150]
5680: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 ; /* Te
5690: 6d 70 20 73 70 61 63 65 20 66 6f 72 20 70 49 64 mp space for pId
56a0: 78 4b 65 79 20 2d 20 74 6f 20 61 76 6f 69 64 20 xKey - to avoid
56b0: 61 20 6d 61 6c 6c 6f 63 20 2a 2f 0a 20 20 63 68 a malloc */. ch
56c0: 61 72 20 2a 70 46 72 65 65 20 3d 20 30 3b 0a 0a ar *pFree = 0;..
56d0: 20 20 69 66 28 20 70 4b 65 79 20 29 7b 0a 20 20 if( pKey ){.
56e0: 20 20 61 73 73 65 72 74 28 20 6e 4b 65 79 3d 3d assert( nKey==
56f0: 28 69 36 34 29 28 69 6e 74 29 6e 4b 65 79 20 29 (i64)(int)nKey )
5700: 3b 0a 20 20 20 20 70 49 64 78 4b 65 79 20 3d 20 ;. pIdxKey =
5710: 73 71 6c 69 74 65 33 56 64 62 65 41 6c 6c 6f 63 sqlite3VdbeAlloc
5720: 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 28 0a UnpackedRecord(.
5730: 20 20 20 20 20 20 20 20 70 43 75 72 2d 3e 70 4b pCur->pK
5740: 65 79 49 6e 66 6f 2c 20 61 53 70 61 63 65 2c 20 eyInfo, aSpace,
5750: 73 69 7a 65 6f 66 28 61 53 70 61 63 65 29 2c 20 sizeof(aSpace),
5760: 26 70 46 72 65 65 0a 20 20 20 20 29 3b 0a 20 20 &pFree. );.
5770: 20 20 69 66 28 20 70 49 64 78 4b 65 79 3d 3d 30 if( pIdxKey==0
5780: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
5790: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 _NOMEM;. sqli
57a0: 74 65 33 56 64 62 65 52 65 63 6f 72 64 55 6e 70 te3VdbeRecordUnp
57b0: 61 63 6b 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e ack(pCur->pKeyIn
57c0: 66 6f 2c 20 28 69 6e 74 29 6e 4b 65 79 2c 20 70 fo, (int)nKey, p
57d0: 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 Key, pIdxKey);.
57e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 49 64 78 }else{. pIdx
57f0: 4b 65 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 Key = 0;. }. r
5800: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 c = sqlite3Btree
5810: 4d 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 70 MovetoUnpacked(p
5820: 43 75 72 2c 20 70 49 64 78 4b 65 79 2c 20 6e 4b Cur, pIdxKey, nK
5830: 65 79 2c 20 62 69 61 73 2c 20 70 52 65 73 29 3b ey, bias, pRes);
5840: 0a 20 20 69 66 28 20 70 46 72 65 65 20 29 7b 0a . if( pFree ){.
5850: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
5860: 65 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f e(pCur->pKeyInfo
5870: 2d 3e 64 62 2c 20 70 46 72 65 65 29 3b 0a 20 20 ->db, pFree);.
5880: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
5890: 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 74 6f 72 65 20 ../*.** Restore
58a0: 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 68 the cursor to th
58b0: 65 20 70 6f 73 69 74 69 6f 6e 20 69 74 20 77 61 e position it wa
58c0: 73 20 69 6e 20 28 6f 72 20 61 73 20 63 6c 6f 73 s in (or as clos
58d0: 65 20 74 6f 20 61 73 20 70 6f 73 73 69 62 6c 65 e to as possible
58e0: 29 0a 2a 2a 20 77 68 65 6e 20 73 61 76 65 43 75 ).** when saveCu
58f0: 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 29 20 77 rsorPosition() w
5900: 61 73 20 63 61 6c 6c 65 64 2e 20 4e 6f 74 65 20 as called. Note
5910: 74 68 61 74 20 74 68 69 73 20 63 61 6c 6c 20 64 that this call d
5920: 65 6c 65 74 65 73 20 74 68 65 20 0a 2a 2a 20 73 eletes the .** s
5930: 61 76 65 64 20 70 6f 73 69 74 69 6f 6e 20 69 6e aved position in
5940: 66 6f 20 73 74 6f 72 65 64 20 62 79 20 73 61 76 fo stored by sav
5950: 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
5960: 29 2c 20 73 6f 20 74 68 65 72 65 20 63 61 6e 20 ), so there can
5970: 62 65 0a 2a 2a 20 61 74 20 6d 6f 73 74 20 6f 6e be.** at most on
5980: 65 20 65 66 66 65 63 74 69 76 65 20 72 65 73 74 e effective rest
5990: 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f oreCursorPositio
59a0: 6e 28 29 20 63 61 6c 6c 20 61 66 74 65 72 20 65 n() call after e
59b0: 61 63 68 20 0a 2a 2a 20 73 61 76 65 43 75 72 73 ach .** saveCurs
59c0: 6f 72 50 6f 73 69 74 69 6f 6e 28 29 2e 0a 2a 2f orPosition()..*/
59d0: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
59e0: 65 52 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f eRestoreCursorPo
59f0: 73 69 74 69 6f 6e 28 42 74 43 75 72 73 6f 72 20 sition(BtCursor
5a00: 2a 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 *pCur){. int rc
5a10: 3b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 ;. assert( curs
5a20: 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
5a30: 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
5a40: 70 43 75 72 2d 3e 65 53 74 61 74 65 3e 3d 43 55 pCur->eState>=CU
5a50: 52 53 4f 52 5f 52 45 51 55 49 52 45 53 45 45 4b RSOR_REQUIRESEEK
5a60: 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 2d 3e );. if( pCur->
5a70: 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 46 eState==CURSOR_F
5a80: 41 55 4c 54 20 29 7b 0a 20 20 20 20 72 65 74 75 AULT ){. retu
5a90: 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 rn pCur->skipNex
5aa0: 74 3b 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 65 t;. }. pCur->e
5ab0: 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 49 State = CURSOR_I
5ac0: 4e 56 41 4c 49 44 3b 0a 20 20 72 63 20 3d 20 62 NVALID;. rc = b
5ad0: 74 72 65 65 4d 6f 76 65 74 6f 28 70 43 75 72 2c treeMoveto(pCur,
5ae0: 20 70 43 75 72 2d 3e 70 4b 65 79 2c 20 70 43 75 pCur->pKey, pCu
5af0: 72 2d 3e 6e 4b 65 79 2c 20 30 2c 20 26 70 43 75 r->nKey, 0, &pCu
5b00: 72 2d 3e 73 6b 69 70 4e 65 78 74 29 3b 0a 20 20 r->skipNext);.
5b10: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
5b20: 4b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 K ){. sqlite3
5b30: 5f 66 72 65 65 28 70 43 75 72 2d 3e 70 4b 65 79 _free(pCur->pKey
5b40: 29 3b 0a 20 20 20 20 70 43 75 72 2d 3e 70 4b 65 );. pCur->pKe
5b50: 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 65 72 y = 0;. asser
5b60: 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
5b70: 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 7c 7c =CURSOR_VALID ||
5b80: 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
5b90: 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 3b URSOR_INVALID );
5ba0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
5bb0: 3b 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 72 65 73 ;.}..#define res
5bc0: 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 toreCursorPositi
5bd0: 6f 6e 28 70 29 20 5c 0a 20 20 28 70 2d 3e 65 53 on(p) \. (p->eS
5be0: 74 61 74 65 3e 3d 43 55 52 53 4f 52 5f 52 45 51 tate>=CURSOR_REQ
5bf0: 55 49 52 45 53 45 45 4b 20 3f 20 5c 0a 20 20 20 UIRESEEK ? \.
5c00: 20 20 20 20 20 20 62 74 72 65 65 52 65 73 74 6f btreeResto
5c10: 72 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e reCursorPosition
5c20: 28 70 29 20 3a 20 5c 0a 20 20 20 20 20 20 20 20 (p) : \.
5c30: 20 53 51 4c 49 54 45 5f 4f 4b 29 0a 0a 2f 2a 0a SQLITE_OK)../*.
5c40: 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 ** Determine whe
5c50: 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 63 75 ther or not a cu
5c60: 72 73 6f 72 20 68 61 73 20 6d 6f 76 65 64 20 66 rsor has moved f
5c70: 72 6f 6d 20 74 68 65 20 70 6f 73 69 74 69 6f 6e rom the position
5c80: 20 69 74 0a 2a 2a 20 77 61 73 20 6c 61 73 74 20 it.** was last
5c90: 70 6c 61 63 65 64 20 61 74 2e 20 20 43 75 72 73 placed at. Curs
5ca0: 6f 72 73 20 63 61 6e 20 6d 6f 76 65 20 77 68 65 ors can move whe
5cb0: 6e 20 74 68 65 20 72 6f 77 20 74 68 65 79 20 61 n the row they a
5cc0: 72 65 20 70 6f 69 6e 74 69 6e 67 0a 2a 2a 20 61 re pointing.** a
5cd0: 74 20 69 73 20 64 65 6c 65 74 65 64 20 6f 75 74 t is deleted out
5ce0: 20 66 72 6f 6d 20 75 6e 64 65 72 20 74 68 65 6d from under them
5cf0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
5d00: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 61 6e 20 tine returns an
5d10: 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 73 6f error code if so
5d20: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f mething goes wro
5d30: 6e 67 2e 20 20 54 68 65 0a 2a 2a 20 69 6e 74 65 ng. The.** inte
5d40: 67 65 72 20 2a 70 48 61 73 4d 6f 76 65 64 20 69 ger *pHasMoved i
5d50: 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 69 66 20 s set to one if
5d60: 74 68 65 20 63 75 72 73 6f 72 20 68 61 73 20 6d the cursor has m
5d70: 6f 76 65 64 20 61 6e 64 20 30 20 69 66 20 6e 6f oved and 0 if no
5d80: 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
5d90: 33 42 74 72 65 65 43 75 72 73 6f 72 48 61 73 4d 3BtreeCursorHasM
5da0: 6f 76 65 64 28 42 74 43 75 72 73 6f 72 20 2a 70 oved(BtCursor *p
5db0: 43 75 72 2c 20 69 6e 74 20 2a 70 48 61 73 4d 6f Cur, int *pHasMo
5dc0: 76 65 64 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a ved){. int rc;.
5dd0: 0a 20 20 72 63 20 3d 20 72 65 73 74 6f 72 65 43 . rc = restoreC
5de0: 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 70 43 ursorPosition(pC
5df0: 75 72 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b ur);. if( rc ){
5e00: 0a 20 20 20 20 2a 70 48 61 73 4d 6f 76 65 64 20 . *pHasMoved
5e10: 3d 20 31 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 = 1;. return
5e20: 72 63 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 rc;. }. if( pC
5e30: 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
5e40: 4f 52 5f 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 OR_VALID || pCur
5e50: 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 30 20 29 7b ->skipNext!=0 ){
5e60: 0a 20 20 20 20 2a 70 48 61 73 4d 6f 76 65 64 20 . *pHasMoved
5e70: 3d 20 31 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 = 1;. }else{.
5e80: 20 20 2a 70 48 61 73 4d 6f 76 65 64 20 3d 20 30 *pHasMoved = 0
5e90: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
5ea0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 QLITE_OK;.}..#if
5eb0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
5ec0: 5f 41 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a _AUTOVACUUM./*.*
5ed0: 2a 20 47 69 76 65 6e 20 61 20 70 61 67 65 20 6e * Given a page n
5ee0: 75 6d 62 65 72 20 6f 66 20 61 20 72 65 67 75 6c umber of a regul
5ef0: 61 72 20 64 61 74 61 62 61 73 65 20 70 61 67 65 ar database page
5f00: 2c 20 72 65 74 75 72 6e 20 74 68 65 20 70 61 67 , return the pag
5f10: 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 e.** number for
5f20: 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 the pointer-map
5f30: 70 61 67 65 20 74 68 61 74 20 63 6f 6e 74 61 69 page that contai
5f40: 6e 73 20 74 68 65 20 65 6e 74 72 79 20 66 6f 72 ns the entry for
5f50: 20 74 68 65 0a 2a 2a 20 69 6e 70 75 74 20 70 61 the.** input pa
5f60: 67 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a ge number..**.**
5f70: 20 52 65 74 75 72 6e 20 30 20 28 6e 6f 74 20 61 Return 0 (not a
5f80: 20 76 61 6c 69 64 20 70 61 67 65 29 20 66 6f 72 valid page) for
5f90: 20 70 67 6e 6f 3d 3d 31 20 73 69 6e 63 65 20 74 pgno==1 since t
5fa0: 68 65 72 65 20 69 73 0a 2a 2a 20 6e 6f 20 70 6f here is.** no po
5fb0: 69 6e 74 65 72 20 6d 61 70 20 61 73 73 6f 63 69 inter map associ
5fc0: 61 74 65 64 20 77 69 74 68 20 70 61 67 65 20 31 ated with page 1
5fd0: 2e 20 20 54 68 65 20 69 6e 74 65 67 72 69 74 79 . The integrity
5fe0: 5f 63 68 65 63 6b 20 6c 6f 67 69 63 0a 2a 2a 20 _check logic.**
5ff0: 72 65 71 75 69 72 65 73 20 74 68 61 74 20 70 74 requires that pt
6000: 72 6d 61 70 50 61 67 65 6e 6f 28 2a 2c 31 29 21 rmapPageno(*,1)!
6010: 3d 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 50 67 =1..*/.static Pg
6020: 6e 6f 20 70 74 72 6d 61 70 50 61 67 65 6e 6f 28 no ptrmapPageno(
6030: 42 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 BtShared *pBt, P
6040: 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 gno pgno){. int
6050: 20 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 nPagesPerMapPag
6060: 65 3b 0a 20 20 50 67 6e 6f 20 69 50 74 72 4d 61 e;. Pgno iPtrMa
6070: 70 2c 20 72 65 74 3b 0a 20 20 61 73 73 65 72 74 p, ret;. assert
6080: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
6090: 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
60a0: 20 29 3b 0a 20 20 69 66 28 20 70 67 6e 6f 3c 32 );. if( pgno<2
60b0: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 6e ) return 0;. n
60c0: 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 20 PagesPerMapPage
60d0: 3d 20 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 = (pBt->usableSi
60e0: 7a 65 2f 35 29 2b 31 3b 0a 20 20 69 50 74 72 4d ze/5)+1;. iPtrM
60f0: 61 70 20 3d 20 28 70 67 6e 6f 2d 32 29 2f 6e 50 ap = (pgno-2)/nP
6100: 61 67 65 73 50 65 72 4d 61 70 50 61 67 65 3b 0a agesPerMapPage;.
6110: 20 20 72 65 74 20 3d 20 28 69 50 74 72 4d 61 70 ret = (iPtrMap
6120: 2a 6e 50 61 67 65 73 50 65 72 4d 61 70 50 61 67 *nPagesPerMapPag
6130: 65 29 20 2b 20 32 3b 20 0a 20 20 69 66 28 20 72 e) + 2; . if( r
6140: 65 74 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 et==PENDING_BYTE
6150: 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 _PAGE(pBt) ){.
6160: 20 20 72 65 74 2b 2b 3b 0a 20 20 7d 0a 20 20 72 ret++;. }. r
6170: 65 74 75 72 6e 20 72 65 74 3b 0a 7d 0a 0a 2f 2a eturn ret;.}../*
6180: 0a 2a 2a 20 57 72 69 74 65 20 61 6e 20 65 6e 74 .** Write an ent
6190: 72 79 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e ry into the poin
61a0: 74 65 72 20 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 ter map..**.** T
61b0: 68 69 73 20 72 6f 75 74 69 6e 65 20 75 70 64 61 his routine upda
61c0: 74 65 73 20 74 68 65 20 70 6f 69 6e 74 65 72 20 tes the pointer
61d0: 6d 61 70 20 65 6e 74 72 79 20 66 6f 72 20 70 61 map entry for pa
61e0: 67 65 20 6e 75 6d 62 65 72 20 27 6b 65 79 27 0a ge number 'key'.
61f0: 2a 2a 20 73 6f 20 74 68 61 74 20 69 74 20 6d 61 ** so that it ma
6200: 70 73 20 74 6f 20 74 79 70 65 20 27 65 54 79 70 ps to type 'eTyp
6210: 65 27 20 61 6e 64 20 70 61 72 65 6e 74 20 70 61 e' and parent pa
6220: 67 65 20 6e 75 6d 62 65 72 20 27 70 67 6e 6f 27 ge number 'pgno'
6230: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 2a 70 52 43 20 ..**.** If *pRC
6240: 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 6e 6f 6e is initially non
6250: 2d 7a 65 72 6f 20 28 6e 6f 6e 2d 53 51 4c 49 54 -zero (non-SQLIT
6260: 45 5f 4f 4b 29 20 74 68 65 6e 20 74 68 69 73 20 E_OK) then this
6270: 72 6f 75 74 69 6e 65 20 69 73 0a 2a 2a 20 61 20 routine is.** a
6280: 6e 6f 2d 6f 70 2e 20 20 49 66 20 61 6e 20 65 72 no-op. If an er
6290: 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 65 20 ror occurs, the
62a0: 61 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f appropriate erro
62b0: 72 20 63 6f 64 65 20 69 73 20 77 72 69 74 74 65 r code is writte
62c0: 6e 0a 2a 2a 20 69 6e 74 6f 20 2a 70 52 43 2e 0a n.** into *pRC..
62d0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
62e0: 74 72 6d 61 70 50 75 74 28 42 74 53 68 61 72 65 trmapPut(BtShare
62f0: 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 79 d *pBt, Pgno key
6300: 2c 20 75 38 20 65 54 79 70 65 2c 20 50 67 6e 6f , u8 eType, Pgno
6310: 20 70 61 72 65 6e 74 2c 20 69 6e 74 20 2a 70 52 parent, int *pR
6320: 43 29 7b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 C){. DbPage *pD
6330: 62 50 61 67 65 3b 20 20 2f 2a 20 54 68 65 20 70 bPage; /* The p
6340: 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 ointer map page
6350: 2a 2f 0a 20 20 75 38 20 2a 70 50 74 72 6d 61 70 */. u8 *pPtrmap
6360: 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f ; /* The po
6370: 69 6e 74 65 72 20 6d 61 70 20 64 61 74 61 20 2a inter map data *
6380: 2f 0a 20 20 50 67 6e 6f 20 69 50 74 72 6d 61 70 /. Pgno iPtrmap
6390: 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 70 6f 69 ; /* The poi
63a0: 6e 74 65 72 20 6d 61 70 20 70 61 67 65 20 6e 75 nter map page nu
63b0: 6d 62 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6f 66 mber */. int of
63c0: 66 73 65 74 3b 20 20 20 20 20 20 20 2f 2a 20 4f fset; /* O
63d0: 66 66 73 65 74 20 69 6e 20 70 6f 69 6e 74 65 72 ffset in pointer
63e0: 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 map page */. i
63f0: 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
6400: 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 /* Return code
6410: 66 72 6f 6d 20 73 75 62 66 75 6e 63 74 69 6f 6e from subfunction
6420: 73 20 2a 2f 0a 0a 20 20 69 66 28 20 2a 70 52 43 s */.. if( *pRC
6430: 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 61 73 ) return;.. as
6440: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
6450: 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
6460: 74 65 78 29 20 29 3b 0a 20 20 2f 2a 20 54 68 65 tex) );. /* The
6470: 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 master-journal
6480: 70 61 67 65 20 6e 75 6d 62 65 72 20 6d 75 73 74 page number must
6490: 20 6e 65 76 65 72 20 62 65 20 75 73 65 64 20 61 never be used a
64a0: 73 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 s a pointer map
64b0: 70 61 67 65 20 2a 2f 0a 20 20 61 73 73 65 72 74 page */. assert
64c0: 28 20 30 3d 3d 50 54 52 4d 41 50 5f 49 53 50 41 ( 0==PTRMAP_ISPA
64d0: 47 45 28 70 42 74 2c 20 50 45 4e 44 49 4e 47 5f GE(pBt, PENDING_
64e0: 42 59 54 45 5f 50 41 47 45 28 70 42 74 29 29 20 BYTE_PAGE(pBt))
64f0: 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 42 );.. assert( pB
6500: 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 3b t->autoVacuum );
6510: 0a 20 20 69 66 28 20 6b 65 79 3d 3d 30 20 29 7b . if( key==0 ){
6520: 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 . *pRC = SQLI
6530: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
6540: 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d . return;. }
6550: 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 52 . iPtrmap = PTR
6560: 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c 20 MAP_PAGENO(pBt,
6570: 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c key);. rc = sql
6580: 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 74 ite3PagerGet(pBt
6590: 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d 61 ->pPager, iPtrma
65a0: 70 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 20 p, &pDbPage);.
65b0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
65c0: 4b 20 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 K ){. *pRC =
65d0: 72 63 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a rc;. return;.
65e0: 20 20 7d 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 }. offset = P
65f0: 54 52 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 TRMAP_PTROFFSET(
6600: 69 50 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 iPtrmap, key);.
6610: 20 69 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b if( offset<0 ){
6620: 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 4c 49 . *pRC = SQLI
6630: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
6640: 0a 20 20 20 20 67 6f 74 6f 20 70 74 72 6d 61 70 . goto ptrmap
6650: 5f 65 78 69 74 3b 0a 20 20 7d 0a 20 20 61 73 73 _exit;. }. ass
6660: 65 72 74 28 20 6f 66 66 73 65 74 20 3c 3d 20 28 ert( offset <= (
6670: 69 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 int)pBt->usableS
6680: 69 7a 65 2d 35 20 29 3b 0a 20 20 70 50 74 72 6d ize-5 );. pPtrm
6690: 61 70 20 3d 20 28 75 38 20 2a 29 73 71 6c 69 74 ap = (u8 *)sqlit
66a0: 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
66b0: 44 62 50 61 67 65 29 3b 0a 0a 20 20 69 66 28 20 DbPage);.. if(
66c0: 65 54 79 70 65 21 3d 70 50 74 72 6d 61 70 5b 6f eType!=pPtrmap[o
66d0: 66 66 73 65 74 5d 20 7c 7c 20 67 65 74 34 62 79 ffset] || get4by
66e0: 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 66 73 te(&pPtrmap[offs
66f0: 65 74 2b 31 5d 29 21 3d 70 61 72 65 6e 74 20 29 et+1])!=parent )
6700: 7b 0a 20 20 20 20 54 52 41 43 45 28 28 22 50 54 {. TRACE(("PT
6710: 52 4d 41 50 5f 55 50 44 41 54 45 3a 20 25 64 2d RMAP_UPDATE: %d-
6720: 3e 28 25 64 2c 25 64 29 5c 6e 22 2c 20 6b 65 79 >(%d,%d)\n", key
6730: 2c 20 65 54 79 70 65 2c 20 70 61 72 65 6e 74 29 , eType, parent)
6740: 29 3b 0a 20 20 20 20 2a 70 52 43 3d 20 72 63 20 );. *pRC= rc
6750: 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
6760: 69 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 20 ite(pDbPage);.
6770: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
6780: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 74 _OK ){. pPt
6790: 72 6d 61 70 5b 6f 66 66 73 65 74 5d 20 3d 20 65 rmap[offset] = e
67a0: 54 79 70 65 3b 0a 20 20 20 20 20 20 70 75 74 34 Type;. put4
67b0: 62 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 byte(&pPtrmap[of
67c0: 66 73 65 74 2b 31 5d 2c 20 70 61 72 65 6e 74 29 fset+1], parent)
67d0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 70 74 72 ;. }. }..ptr
67e0: 6d 61 70 5f 65 78 69 74 3a 0a 20 20 73 71 6c 69 map_exit:. sqli
67f0: 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 44 te3PagerUnref(pD
6800: 62 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a bPage);.}../*.**
6810: 20 52 65 61 64 20 61 6e 20 65 6e 74 72 79 20 66 Read an entry f
6820: 72 6f 6d 20 74 68 65 20 70 6f 69 6e 74 65 72 20 rom the pointer
6830: 6d 61 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 map..**.** This
6840: 72 6f 75 74 69 6e 65 20 72 65 74 72 69 65 76 65 routine retrieve
6850: 73 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 s the pointer ma
6860: 70 20 65 6e 74 72 79 20 66 6f 72 20 70 61 67 65 p entry for page
6870: 20 27 6b 65 79 27 2c 20 77 72 69 74 69 6e 67 0a 'key', writing.
6880: 2a 2a 20 74 68 65 20 74 79 70 65 20 61 6e 64 20 ** the type and
6890: 70 61 72 65 6e 74 20 70 61 67 65 20 6e 75 6d 62 parent page numb
68a0: 65 72 20 74 6f 20 2a 70 45 54 79 70 65 20 61 6e er to *pEType an
68b0: 64 20 2a 70 50 67 6e 6f 20 72 65 73 70 65 63 74 d *pPgno respect
68c0: 69 76 65 6c 79 2e 0a 2a 2a 20 41 6e 20 65 72 72 ively..** An err
68d0: 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
68e0: 6e 65 64 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 ned if something
68f0: 20 67 6f 65 73 20 77 72 6f 6e 67 2c 20 6f 74 68 goes wrong, oth
6900: 65 72 77 69 73 65 20 53 51 4c 49 54 45 5f 4f 4b erwise SQLITE_OK
6910: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
6920: 70 74 72 6d 61 70 47 65 74 28 42 74 53 68 61 72 ptrmapGet(BtShar
6930: 65 64 20 2a 70 42 74 2c 20 50 67 6e 6f 20 6b 65 ed *pBt, Pgno ke
6940: 79 2c 20 75 38 20 2a 70 45 54 79 70 65 2c 20 50 y, u8 *pEType, P
6950: 67 6e 6f 20 2a 70 50 67 6e 6f 29 7b 0a 20 20 44 gno *pPgno){. D
6960: 62 50 61 67 65 20 2a 70 44 62 50 61 67 65 3b 20 bPage *pDbPage;
6970: 20 20 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 72 /* The pointer
6980: 20 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 69 map page */. i
6990: 6e 74 20 69 50 74 72 6d 61 70 3b 20 20 20 20 20 nt iPtrmap;
69a0: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 /* Pointer map
69b0: 20 70 61 67 65 20 69 6e 64 65 78 20 2a 2f 0a 20 page index */.
69c0: 20 75 38 20 2a 70 50 74 72 6d 61 70 3b 20 20 20 u8 *pPtrmap;
69d0: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 6d /* Pointer m
69e0: 61 70 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a ap page data */.
69f0: 20 20 69 6e 74 20 6f 66 66 73 65 74 3b 20 20 20 int offset;
6a00: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f /* Offset o
6a10: 66 20 65 6e 74 72 79 20 69 6e 20 70 6f 69 6e 74 f entry in point
6a20: 65 72 20 6d 61 70 20 2a 2f 0a 20 20 69 6e 74 20 er map */. int
6a30: 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 rc;.. assert( s
6a40: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
6a50: 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b d(pBt->mutex) );
6a60: 0a 0a 20 20 69 50 74 72 6d 61 70 20 3d 20 50 54 .. iPtrmap = PT
6a70: 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 74 2c RMAP_PAGENO(pBt,
6a80: 20 6b 65 79 29 3b 0a 20 20 72 63 20 3d 20 73 71 key);. rc = sq
6a90: 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 42 lite3PagerGet(pB
6aa0: 74 2d 3e 70 50 61 67 65 72 2c 20 69 50 74 72 6d t->pPager, iPtrm
6ab0: 61 70 2c 20 26 70 44 62 50 61 67 65 29 3b 0a 20 ap, &pDbPage);.
6ac0: 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20 20 if( rc!=0 ){.
6ad0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
6ae0: 0a 20 20 70 50 74 72 6d 61 70 20 3d 20 28 75 38 . pPtrmap = (u8
6af0: 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 *)sqlite3PagerG
6b00: 65 74 44 61 74 61 28 70 44 62 50 61 67 65 29 3b etData(pDbPage);
6b10: 0a 0a 20 20 6f 66 66 73 65 74 20 3d 20 50 54 52 .. offset = PTR
6b20: 4d 41 50 5f 50 54 52 4f 46 46 53 45 54 28 69 50 MAP_PTROFFSET(iP
6b30: 74 72 6d 61 70 2c 20 6b 65 79 29 3b 0a 20 20 69 trmap, key);. i
6b40: 66 28 20 6f 66 66 73 65 74 3c 30 20 29 7b 0a 20 f( offset<0 ){.
6b50: 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 sqlite3PagerU
6b60: 6e 72 65 66 28 70 44 62 50 61 67 65 29 3b 0a 20 nref(pDbPage);.
6b70: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
6b80: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
6b90: 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 }. assert( off
6ba0: 73 65 74 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d set <= (int)pBt-
6bb0: 3e 75 73 61 62 6c 65 53 69 7a 65 2d 35 20 29 3b >usableSize-5 );
6bc0: 0a 20 20 61 73 73 65 72 74 28 20 70 45 54 79 70 . assert( pETyp
6bd0: 65 21 3d 30 20 29 3b 0a 20 20 2a 70 45 54 79 70 e!=0 );. *pETyp
6be0: 65 20 3d 20 70 50 74 72 6d 61 70 5b 6f 66 66 73 e = pPtrmap[offs
6bf0: 65 74 5d 3b 0a 20 20 69 66 28 20 70 50 67 6e 6f et];. if( pPgno
6c00: 20 29 20 2a 70 50 67 6e 6f 20 3d 20 67 65 74 34 ) *pPgno = get4
6c10: 62 79 74 65 28 26 70 50 74 72 6d 61 70 5b 6f 66 byte(&pPtrmap[of
6c20: 66 73 65 74 2b 31 5d 29 3b 0a 0a 20 20 73 71 6c fset+1]);.. sql
6c30: 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
6c40: 44 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 2a DbPage);. if( *
6c50: 70 45 54 79 70 65 3c 31 20 7c 7c 20 2a 70 45 54 pEType<1 || *pET
6c60: 79 70 65 3e 35 20 29 20 72 65 74 75 72 6e 20 53 ype>5 ) return S
6c70: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
6c80: 50 54 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c PT;. return SQL
6c90: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6c 73 65 ITE_OK;.}..#else
6ca0: 20 2f 2a 20 69 66 20 64 65 66 69 6e 65 64 20 53 /* if defined S
6cb0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 QLITE_OMIT_AUTOV
6cc0: 41 43 55 55 4d 20 2a 2f 0a 20 20 23 64 65 66 69 ACUUM */. #defi
6cd0: 6e 65 20 70 74 72 6d 61 70 50 75 74 28 77 2c 78 ne ptrmapPut(w,x
6ce0: 2c 79 2c 7a 2c 72 63 29 0a 20 20 23 64 65 66 69 ,y,z,rc). #defi
6cf0: 6e 65 20 70 74 72 6d 61 70 47 65 74 28 77 2c 78 ne ptrmapGet(w,x
6d00: 2c 79 2c 7a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a ,y,z) SQLITE_OK.
6d10: 20 20 23 64 65 66 69 6e 65 20 70 74 72 6d 61 70 #define ptrmap
6d20: 50 75 74 4f 76 66 6c 50 74 72 28 78 2c 20 79 2c PutOvflPtr(x, y,
6d30: 20 72 63 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a rc).#endif../*.
6d40: 2a 2a 20 47 69 76 65 6e 20 61 20 62 74 72 65 65 ** Given a btree
6d50: 20 70 61 67 65 20 61 6e 64 20 61 20 63 65 6c 6c page and a cell
6d60: 20 69 6e 64 65 78 20 28 30 20 6d 65 61 6e 73 20 index (0 means
6d70: 74 68 65 20 66 69 72 73 74 20 63 65 6c 6c 20 6f the first cell o
6d80: 6e 0a 2a 2a 20 74 68 65 20 70 61 67 65 2c 20 31 n.** the page, 1
6d90: 20 6d 65 61 6e 73 20 74 68 65 20 73 65 63 6f 6e means the secon
6da0: 64 20 63 65 6c 6c 2c 20 61 6e 64 20 73 6f 20 66 d cell, and so f
6db0: 6f 72 74 68 29 20 72 65 74 75 72 6e 20 61 20 70 orth) return a p
6dc0: 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 ointer.** to the
6dd0: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 2e 0a 2a cell content..*
6de0: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
6df0: 65 20 77 6f 72 6b 73 20 6f 6e 6c 79 20 66 6f 72 e works only for
6e00: 20 70 61 67 65 73 20 74 68 61 74 20 64 6f 20 6e pages that do n
6e10: 6f 74 20 63 6f 6e 74 61 69 6e 20 6f 76 65 72 66 ot contain overf
6e20: 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a 23 64 low cells..*/.#d
6e30: 65 66 69 6e 65 20 66 69 6e 64 43 65 6c 6c 28 50 efine findCell(P
6e40: 2c 49 29 20 5c 0a 20 20 28 28 50 29 2d 3e 61 44 ,I) \. ((P)->aD
6e50: 61 74 61 20 2b 20 28 28 50 29 2d 3e 6d 61 73 6b ata + ((P)->mask
6e60: 50 61 67 65 20 26 20 67 65 74 32 62 79 74 65 28 Page & get2byte(
6e70: 26 28 50 29 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 &(P)->aCellIdx[2
6e80: 2a 28 49 29 5d 29 29 29 0a 23 64 65 66 69 6e 65 *(I)]))).#define
6e90: 20 66 69 6e 64 43 65 6c 6c 76 32 28 44 2c 4d 2c findCellv2(D,M,
6ea0: 4f 2c 49 29 20 28 44 2b 28 4d 26 67 65 74 32 62 O,I) (D+(M&get2b
6eb0: 79 74 65 28 44 2b 28 4f 2b 32 2a 28 49 29 29 29 yte(D+(O+2*(I)))
6ec0: 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 )).../*.** This
6ed0: 61 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 20 76 a more complex v
6ee0: 65 72 73 69 6f 6e 20 6f 66 20 66 69 6e 64 43 65 ersion of findCe
6ef0: 6c 6c 28 29 20 74 68 61 74 20 77 6f 72 6b 73 20 ll() that works
6f00: 66 6f 72 0a 2a 2a 20 70 61 67 65 73 20 74 68 61 for.** pages tha
6f10: 74 20 64 6f 20 63 6f 6e 74 61 69 6e 20 6f 76 65 t do contain ove
6f20: 72 66 6c 6f 77 20 63 65 6c 6c 73 2e 0a 2a 2f 0a rflow cells..*/.
6f30: 73 74 61 74 69 63 20 75 38 20 2a 66 69 6e 64 4f static u8 *findO
6f40: 76 65 72 66 6c 6f 77 43 65 6c 6c 28 4d 65 6d 50 verflowCell(MemP
6f50: 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 age *pPage, int
6f60: 69 43 65 6c 6c 29 7b 0a 20 20 69 6e 74 20 69 3b iCell){. int i;
6f70: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
6f80: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 e3_mutex_held(pP
6f90: 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 age->pBt->mutex)
6fa0: 20 29 3b 0a 20 20 66 6f 72 28 69 3d 70 50 61 67 );. for(i=pPag
6fb0: 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2d 31 3b 20 e->nOverflow-1;
6fc0: 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 i>=0; i--){.
6fd0: 69 6e 74 20 6b 3b 0a 20 20 20 20 6b 20 3d 20 70 int k;. k = p
6fe0: 50 61 67 65 2d 3e 61 69 4f 76 66 6c 5b 69 5d 3b Page->aiOvfl[i];
6ff0: 0a 20 20 20 20 69 66 28 20 6b 3c 3d 69 43 65 6c . if( k<=iCel
7000: 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 6b l ){. if( k
7010: 3d 3d 69 43 65 6c 6c 20 29 7b 0a 20 20 20 20 20 ==iCell ){.
7020: 20 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 2d return pPage-
7030: 3e 61 70 4f 76 66 6c 5b 69 5d 3b 0a 20 20 20 20 >apOvfl[i];.
7040: 20 20 7d 0a 20 20 20 20 20 20 69 43 65 6c 6c 2d }. iCell-
7050: 2d 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 -;. }. }. r
7060: 65 74 75 72 6e 20 66 69 6e 64 43 65 6c 6c 28 70 eturn findCell(p
7070: 50 61 67 65 2c 20 69 43 65 6c 6c 29 3b 0a 7d 0a Page, iCell);.}.
7080: 0a 2f 2a 0a 2a 2a 20 50 61 72 73 65 20 61 20 63 ./*.** Parse a c
7090: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 6c 6f 63 ell content bloc
70a0: 6b 20 61 6e 64 20 66 69 6c 6c 20 69 6e 20 74 68 k and fill in th
70b0: 65 20 43 65 6c 6c 49 6e 66 6f 20 73 74 72 75 63 e CellInfo struc
70c0: 74 75 72 65 2e 20 20 54 68 65 72 65 0a 2a 2a 20 ture. There.**
70d0: 61 72 65 20 74 77 6f 20 76 65 72 73 69 6f 6e 73 are two versions
70e0: 20 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f of this functio
70f0: 6e 2e 20 20 62 74 72 65 65 50 61 72 73 65 43 65 n. btreeParseCe
7100: 6c 6c 28 29 20 74 61 6b 65 73 20 61 20 0a 2a 2a ll() takes a .**
7110: 20 63 65 6c 6c 20 69 6e 64 65 78 20 61 73 20 74 cell index as t
7120: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
7130: 6e 74 20 61 6e 64 20 62 74 72 65 65 50 61 72 73 nt and btreePars
7140: 65 43 65 6c 6c 50 74 72 28 29 20 0a 2a 2a 20 74 eCellPtr() .** t
7150: 61 6b 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 akes a pointer t
7160: 6f 20 74 68 65 20 62 6f 64 79 20 6f 66 20 74 68 o the body of th
7170: 65 20 63 65 6c 6c 20 61 73 20 69 74 73 20 73 65 e cell as its se
7180: 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a cond argument..*
7190: 2a 0a 2a 2a 20 57 69 74 68 69 6e 20 74 68 69 73 *.** Within this
71a0: 20 66 69 6c 65 2c 20 74 68 65 20 70 61 72 73 65 file, the parse
71b0: 43 65 6c 6c 28 29 20 6d 61 63 72 6f 20 63 61 6e Cell() macro can
71c0: 20 62 65 20 63 61 6c 6c 65 64 20 69 6e 73 74 65 be called inste
71d0: 61 64 20 6f 66 0a 2a 2a 20 62 74 72 65 65 50 61 ad of.** btreePa
71e0: 72 73 65 43 65 6c 6c 50 74 72 28 29 2e 20 55 73 rseCellPtr(). Us
71f0: 69 6e 67 20 73 6f 6d 65 20 63 6f 6d 70 69 6c 65 ing some compile
7200: 72 73 2c 20 74 68 69 73 20 77 69 6c 6c 20 62 65 rs, this will be
7210: 20 66 61 73 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 faster..*/.stat
7220: 69 63 20 76 6f 69 64 20 62 74 72 65 65 50 61 72 ic void btreePar
7230: 73 65 43 65 6c 6c 50 74 72 28 0a 20 20 4d 65 6d seCellPtr(. Mem
7240: 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 20 Page *pPage,
7250: 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f 6e /* Page con
7260: 74 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c 6c taining the cell
7270: 20 2a 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 2c */. u8 *pCell,
7280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7290: 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 Pointer to the
72a0: 63 65 6c 6c 20 74 65 78 74 2e 20 2a 2f 0a 20 20 cell text. */.
72b0: 43 65 6c 6c 49 6e 66 6f 20 2a 70 49 6e 66 6f 20 CellInfo *pInfo
72c0: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 6c 20 /* Fill
72d0: 69 6e 20 74 68 69 73 20 73 74 72 75 63 74 75 72 in this structur
72e0: 65 20 2a 2f 0a 29 7b 0a 20 20 75 31 36 20 6e 3b e */.){. u16 n;
72f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7300: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 62 79 74 65 /* Number byte
7310: 73 20 69 6e 20 63 65 6c 6c 20 63 6f 6e 74 65 6e s in cell conten
7320: 74 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 t header */. u3
7330: 32 20 6e 50 61 79 6c 6f 61 64 3b 20 20 20 20 20 2 nPayload;
7340: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
7350: 6f 66 20 62 79 74 65 73 20 6f 66 20 63 65 6c 6c of bytes of cell
7360: 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 0a 20 20 61 payload */.. a
7370: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
7380: 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
7390: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
73a0: 0a 20 20 70 49 6e 66 6f 2d 3e 70 43 65 6c 6c 20 . pInfo->pCell
73b0: 3d 20 70 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 = pCell;. asser
73c0: 74 28 20 70 50 61 67 65 2d 3e 6c 65 61 66 3d 3d t( pPage->leaf==
73d0: 30 20 7c 7c 20 70 50 61 67 65 2d 3e 6c 65 61 66 0 || pPage->leaf
73e0: 3d 3d 31 20 29 3b 0a 20 20 6e 20 3d 20 70 50 61 ==1 );. n = pPa
73f0: 67 65 2d 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 ge->childPtrSize
7400: 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 3d 3d 34 ;. assert( n==4
7410: 2d 34 2a 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 -4*pPage->leaf )
7420: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 ;. if( pPage->i
7430: 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 69 66 28 ntKey ){. if(
7440: 20 70 50 61 67 65 2d 3e 68 61 73 44 61 74 61 20 pPage->hasData
7450: 29 7b 0a 20 20 20 20 20 20 6e 20 2b 3d 20 67 65 ){. n += ge
7460: 74 56 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c tVarint32(&pCell
7470: 5b 6e 5d 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a [n], nPayload);.
7480: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
7490: 20 6e 50 61 79 6c 6f 61 64 20 3d 20 30 3b 0a 20 nPayload = 0;.
74a0: 20 20 20 7d 0a 20 20 20 20 6e 20 2b 3d 20 67 65 }. n += ge
74b0: 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e tVarint(&pCell[n
74c0: 5d 2c 20 28 75 36 34 2a 29 26 70 49 6e 66 6f 2d ], (u64*)&pInfo-
74d0: 3e 6e 4b 65 79 29 3b 0a 20 20 20 20 70 49 6e 66 >nKey);. pInf
74e0: 6f 2d 3e 6e 44 61 74 61 20 3d 20 6e 50 61 79 6c o->nData = nPayl
74f0: 6f 61 64 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 oad;. }else{.
7500: 20 20 70 49 6e 66 6f 2d 3e 6e 44 61 74 61 20 3d pInfo->nData =
7510: 20 30 3b 0a 20 20 20 20 6e 20 2b 3d 20 67 65 74 0;. n += get
7520: 56 61 72 69 6e 74 33 32 28 26 70 43 65 6c 6c 5b Varint32(&pCell[
7530: 6e 5d 2c 20 6e 50 61 79 6c 6f 61 64 29 3b 0a 20 n], nPayload);.
7540: 20 20 20 70 49 6e 66 6f 2d 3e 6e 4b 65 79 20 3d pInfo->nKey =
7550: 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 7d 0a 20 nPayload;. }.
7560: 20 70 49 6e 66 6f 2d 3e 6e 50 61 79 6c 6f 61 64 pInfo->nPayload
7570: 20 3d 20 6e 50 61 79 6c 6f 61 64 3b 0a 20 20 70 = nPayload;. p
7580: 49 6e 66 6f 2d 3e 6e 48 65 61 64 65 72 20 3d 20 Info->nHeader =
7590: 6e 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 6e n;. testcase( n
75a0: 50 61 79 6c 6f 61 64 3d 3d 70 50 61 67 65 2d 3e Payload==pPage->
75b0: 6d 61 78 4c 6f 63 61 6c 20 29 3b 0a 20 20 74 65 maxLocal );. te
75c0: 73 74 63 61 73 65 28 20 6e 50 61 79 6c 6f 61 64 stcase( nPayload
75d0: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
75e0: 6c 2b 31 20 29 3b 0a 20 20 69 66 28 20 6c 69 6b l+1 );. if( lik
75f0: 65 6c 79 28 6e 50 61 79 6c 6f 61 64 3c 3d 70 50 ely(nPayload<=pP
7600: 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 29 20 29 age->maxLocal) )
7610: 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 {. /* This is
7620: 20 74 68 65 20 28 65 61 73 79 29 20 63 6f 6d 6d the (easy) comm
7630: 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 68 on case where th
7640: 65 20 65 6e 74 69 72 65 20 70 61 79 6c 6f 61 64 e entire payload
7650: 20 66 69 74 73 0a 20 20 20 20 2a 2a 20 6f 6e 20 fits. ** on
7660: 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 2e 20 the local page.
7670: 20 4e 6f 20 6f 76 65 72 66 6c 6f 77 20 69 73 20 No overflow is
7680: 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 2a 2f required.. */
7690: 0a 20 20 20 20 69 66 28 20 28 70 49 6e 66 6f 2d . if( (pInfo-
76a0: 3e 6e 53 69 7a 65 20 3d 20 28 75 31 36 29 28 6e >nSize = (u16)(n
76b0: 2b 6e 50 61 79 6c 6f 61 64 29 29 3c 34 20 29 20 +nPayload))<4 )
76c0: 70 49 6e 66 6f 2d 3e 6e 53 69 7a 65 20 3d 20 34 pInfo->nSize = 4
76d0: 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e 6e 4c 6f ;. pInfo->nLo
76e0: 63 61 6c 20 3d 20 28 75 31 36 29 6e 50 61 79 6c cal = (u16)nPayl
76f0: 6f 61 64 3b 0a 20 20 20 20 70 49 6e 66 6f 2d 3e oad;. pInfo->
7700: 69 4f 76 65 72 66 6c 6f 77 20 3d 20 30 3b 0a 20 iOverflow = 0;.
7710: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 }else{. /* I
7720: 66 20 74 68 65 20 70 61 79 6c 6f 61 64 20 77 69 f the payload wi
7730: 6c 6c 20 6e 6f 74 20 66 69 74 20 63 6f 6d 70 6c ll not fit compl
7740: 65 74 65 6c 79 20 6f 6e 20 74 68 65 20 6c 6f 63 etely on the loc
7750: 61 6c 20 70 61 67 65 2c 20 77 65 20 68 61 76 65 al page, we have
7760: 0a 20 20 20 20 2a 2a 20 74 6f 20 64 65 63 69 64 . ** to decid
7770: 65 20 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 74 e how much to st
7780: 6f 72 65 20 6c 6f 63 61 6c 6c 79 20 61 6e 64 20 ore locally and
7790: 68 6f 77 20 6d 75 63 68 20 74 6f 20 73 70 69 6c how much to spil
77a0: 6c 20 6f 6e 74 6f 0a 20 20 20 20 2a 2a 20 6f 76 l onto. ** ov
77b0: 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 20 20 54 erflow pages. T
77c0: 68 65 20 73 74 72 61 74 65 67 79 20 69 73 20 74 he strategy is t
77d0: 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 20 61 o minimize the a
77e0: 6d 6f 75 6e 74 20 6f 66 20 75 6e 75 73 65 64 0a mount of unused.
77f0: 20 20 20 20 2a 2a 20 73 70 61 63 65 20 6f 6e 20 ** space on
7800: 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 77 overflow pages w
7810: 68 69 6c 65 20 6b 65 65 70 69 6e 67 20 74 68 65 hile keeping the
7820: 20 61 6d 6f 75 6e 74 20 6f 66 20 6c 6f 63 61 6c amount of local
7830: 20 73 74 6f 72 61 67 65 0a 20 20 20 20 2a 2a 20 storage. **
7840: 69 6e 20 62 65 74 77 65 65 6e 20 6d 69 6e 4c 6f in between minLo
7850: 63 61 6c 20 61 6e 64 20 6d 61 78 4c 6f 63 61 6c cal and maxLocal
7860: 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 .. **. **
7870: 57 61 72 6e 69 6e 67 3a 20 20 63 68 61 6e 67 69 Warning: changi
7880: 6e 67 20 74 68 65 20 77 61 79 20 6f 76 65 72 66 ng the way overf
7890: 6c 6f 77 20 70 61 79 6c 6f 61 64 20 69 73 20 64 low payload is d
78a0: 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 61 6e istributed in an
78b0: 79 0a 20 20 20 20 2a 2a 20 77 61 79 20 77 69 6c y. ** way wil
78c0: 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 69 l result in an i
78d0: 6e 63 6f 6d 70 61 74 69 62 6c 65 20 66 69 6c 65 ncompatible file
78e0: 20 66 6f 72 6d 61 74 2e 0a 20 20 20 20 2a 2f 0a format.. */.
78f0: 20 20 20 20 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c int minLocal
7900: 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 61 6d ; /* Minimum am
7910: 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 ount of payload
7920: 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a held locally */.
7930: 20 20 20 20 69 6e 74 20 6d 61 78 4c 6f 63 61 6c int maxLocal
7940: 3b 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6d ; /* Maximum am
7950: 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 ount of payload
7960: 68 65 6c 64 20 6c 6f 63 61 6c 6c 79 20 2a 2f 0a held locally */.
7970: 20 20 20 20 69 6e 74 20 73 75 72 70 6c 75 73 3b int surplus;
7980: 20 20 20 2f 2a 20 4f 76 65 72 66 6c 6f 77 20 70 /* Overflow p
7990: 61 79 6c 6f 61 64 20 61 76 61 69 6c 61 62 6c 65 ayload available
79a0: 20 66 6f 72 20 6c 6f 63 61 6c 20 73 74 6f 72 61 for local stora
79b0: 67 65 20 2a 2f 0a 0a 20 20 20 20 6d 69 6e 4c 6f ge */.. minLo
79c0: 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 69 6e cal = pPage->min
79d0: 4c 6f 63 61 6c 3b 0a 20 20 20 20 6d 61 78 4c 6f Local;. maxLo
79e0: 63 61 6c 20 3d 20 70 50 61 67 65 2d 3e 6d 61 78 cal = pPage->max
79f0: 4c 6f 63 61 6c 3b 0a 20 20 20 20 73 75 72 70 6c Local;. surpl
7a00: 75 73 20 3d 20 6d 69 6e 4c 6f 63 61 6c 20 2b 20 us = minLocal +
7a10: 28 6e 50 61 79 6c 6f 61 64 20 2d 20 6d 69 6e 4c (nPayload - minL
7a20: 6f 63 61 6c 29 25 28 70 50 61 67 65 2d 3e 70 42 ocal)%(pPage->pB
7a30: 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 t->usableSize -
7a40: 34 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 4);. testcase
7a50: 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 78 4c 6f ( surplus==maxLo
7a60: 63 61 6c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 cal );. testc
7a70: 61 73 65 28 20 73 75 72 70 6c 75 73 3d 3d 6d 61 ase( surplus==ma
7a80: 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 xLocal+1 );.
7a90: 69 66 28 20 73 75 72 70 6c 75 73 20 3c 3d 20 6d if( surplus <= m
7aa0: 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 axLocal ){.
7ab0: 20 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d pInfo->nLocal =
7ac0: 20 28 75 31 36 29 73 75 72 70 6c 75 73 3b 0a 20 (u16)surplus;.
7ad0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
7ae0: 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 3d 20 pInfo->nLocal =
7af0: 28 75 31 36 29 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 (u16)minLocal;.
7b00: 20 20 20 7d 0a 20 20 20 20 70 49 6e 66 6f 2d 3e }. pInfo->
7b10: 69 4f 76 65 72 66 6c 6f 77 20 3d 20 28 75 31 36 iOverflow = (u16
7b20: 29 28 70 49 6e 66 6f 2d 3e 6e 4c 6f 63 61 6c 20 )(pInfo->nLocal
7b30: 2b 20 6e 29 3b 0a 20 20 20 20 70 49 6e 66 6f 2d + n);. pInfo-
7b40: 3e 6e 53 69 7a 65 20 3d 20 70 49 6e 66 6f 2d 3e >nSize = pInfo->
7b50: 69 4f 76 65 72 66 6c 6f 77 20 2b 20 34 3b 0a 20 iOverflow + 4;.
7b60: 20 7d 0a 7d 0a 23 64 65 66 69 6e 65 20 70 61 72 }.}.#define par
7b70: 73 65 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 43 seCell(pPage, iC
7b80: 65 6c 6c 2c 20 70 49 6e 66 6f 29 20 5c 0a 20 20 ell, pInfo) \.
7b90: 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 btreeParseCellPt
7ba0: 72 28 28 70 50 61 67 65 29 2c 20 66 69 6e 64 43 r((pPage), findC
7bb0: 65 6c 6c 28 28 70 50 61 67 65 29 2c 20 28 69 43 ell((pPage), (iC
7bc0: 65 6c 6c 29 29 2c 20 28 70 49 6e 66 6f 29 29 0a ell)), (pInfo)).
7bd0: 73 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 static void btre
7be0: 65 50 61 72 73 65 43 65 6c 6c 28 0a 20 20 4d 65 eParseCell(. Me
7bf0: 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 20 mPage *pPage,
7c00: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 6f /* Page co
7c10: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 65 6c ntaining the cel
7c20: 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 65 6c 6c l */. int iCell
7c30: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
7c40: 2a 20 54 68 65 20 63 65 6c 6c 20 69 6e 64 65 78 * The cell index
7c50: 2e 20 20 46 69 72 73 74 20 63 65 6c 6c 20 69 73 . First cell is
7c60: 20 30 20 2a 2f 0a 20 20 43 65 6c 6c 49 6e 66 6f 0 */. CellInfo
7c70: 20 2a 70 49 6e 66 6f 20 20 20 20 20 20 20 20 20 *pInfo
7c80: 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 69 73 20 /* Fill in this
7c90: 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 29 7b 0a structure */.){.
7ca0: 20 20 70 61 72 73 65 43 65 6c 6c 28 70 50 61 67 parseCell(pPag
7cb0: 65 2c 20 69 43 65 6c 6c 2c 20 70 49 6e 66 6f 29 e, iCell, pInfo)
7cc0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 ;.}../*.** Compu
7cd0: 74 65 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d te the total num
7ce0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 74 68 61 ber of bytes tha
7cf0: 74 20 61 20 43 65 6c 6c 20 6e 65 65 64 73 20 69 t a Cell needs i
7d00: 6e 20 74 68 65 20 63 65 6c 6c 0a 2a 2a 20 64 61 n the cell.** da
7d10: 74 61 20 61 72 65 61 20 6f 66 20 74 68 65 20 62 ta area of the b
7d20: 74 72 65 65 2d 70 61 67 65 2e 20 20 54 68 65 20 tree-page. The
7d30: 72 65 74 75 72 6e 20 6e 75 6d 62 65 72 20 69 6e return number in
7d40: 63 6c 75 64 65 73 20 74 68 65 20 63 65 6c 6c 0a cludes the cell.
7d50: 2a 2a 20 64 61 74 61 20 68 65 61 64 65 72 20 61 ** data header a
7d60: 6e 64 20 74 68 65 20 6c 6f 63 61 6c 20 70 61 79 nd the local pay
7d70: 6c 6f 61 64 2c 20 62 75 74 20 6e 6f 74 20 61 6e load, but not an
7d80: 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 y overflow page
7d90: 6f 72 0a 2a 2a 20 74 68 65 20 73 70 61 63 65 20 or.** the space
7da0: 75 73 65 64 20 62 79 20 74 68 65 20 63 65 6c 6c used by the cell
7db0: 20 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 pointer..*/.sta
7dc0: 74 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 tic u16 cellSize
7dd0: 50 74 72 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 Ptr(MemPage *pPa
7de0: 67 65 2c 20 75 38 20 2a 70 43 65 6c 6c 29 7b 0a ge, u8 *pCell){.
7df0: 20 20 75 38 20 2a 70 49 74 65 72 20 3d 20 26 70 u8 *pIter = &p
7e00: 43 65 6c 6c 5b 70 50 61 67 65 2d 3e 63 68 69 6c Cell[pPage->chil
7e10: 64 50 74 72 53 69 7a 65 5d 3b 0a 20 20 75 33 32 dPtrSize];. u32
7e20: 20 6e 53 69 7a 65 3b 0a 0a 23 69 66 64 65 66 20 nSize;..#ifdef
7e30: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f SQLITE_DEBUG. /
7e40: 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 75 * The value retu
7e50: 72 6e 65 64 20 62 79 20 74 68 69 73 20 66 75 6e rned by this fun
7e60: 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 61 6c 77 ction should alw
7e70: 61 79 73 20 62 65 20 74 68 65 20 73 61 6d 65 20 ays be the same
7e80: 61 73 0a 20 20 2a 2a 20 74 68 65 20 28 43 65 6c as. ** the (Cel
7e90: 6c 49 6e 66 6f 2e 6e 53 69 7a 65 29 20 76 61 6c lInfo.nSize) val
7ea0: 75 65 20 66 6f 75 6e 64 20 62 79 20 64 6f 69 6e ue found by doin
7eb0: 67 20 61 20 66 75 6c 6c 20 70 61 72 73 65 20 6f g a full parse o
7ec0: 66 20 74 68 65 0a 20 20 2a 2a 20 63 65 6c 6c 2e f the. ** cell.
7ed0: 20 49 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 If SQLITE_DEBUG
7ee0: 20 69 73 20 64 65 66 69 6e 65 64 2c 20 61 6e 20 is defined, an
7ef0: 61 73 73 65 72 74 28 29 20 61 74 20 74 68 65 20 assert() at the
7f00: 62 6f 74 74 6f 6d 20 6f 66 0a 20 20 2a 2a 20 74 bottom of. ** t
7f10: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 76 65 72 his function ver
7f20: 69 66 69 65 73 20 74 68 61 74 20 74 68 69 73 20 ifies that this
7f30: 69 6e 76 61 72 69 61 6e 74 20 69 73 20 6e 6f 74 invariant is not
7f40: 20 76 69 6f 6c 61 74 65 64 2e 20 2a 2f 0a 20 20 violated. */.
7f50: 43 65 6c 6c 49 6e 66 6f 20 64 65 62 75 67 69 6e CellInfo debugin
7f60: 66 6f 3b 0a 20 20 62 74 72 65 65 50 61 72 73 65 fo;. btreeParse
7f70: 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 CellPtr(pPage, p
7f80: 43 65 6c 6c 2c 20 26 64 65 62 75 67 69 6e 66 6f Cell, &debuginfo
7f90: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 );.#endif.. if(
7fa0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 29 pPage->intKey )
7fb0: 7b 0a 20 20 20 20 75 38 20 2a 70 45 6e 64 3b 0a {. u8 *pEnd;.
7fc0: 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 68 if( pPage->h
7fd0: 61 73 44 61 74 61 20 29 7b 0a 20 20 20 20 20 20 asData ){.
7fe0: 70 49 74 65 72 20 2b 3d 20 67 65 74 56 61 72 69 pIter += getVari
7ff0: 6e 74 33 32 28 70 49 74 65 72 2c 20 6e 53 69 7a nt32(pIter, nSiz
8000: 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 e);. }else{.
8010: 20 20 20 20 20 6e 53 69 7a 65 20 3d 20 30 3b 0a nSize = 0;.
8020: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 70 49 }.. /* pI
8030: 74 65 72 20 6e 6f 77 20 70 6f 69 6e 74 73 20 61 ter now points a
8040: 74 20 74 68 65 20 36 34 2d 62 69 74 20 69 6e 74 t the 64-bit int
8050: 65 67 65 72 20 6b 65 79 20 76 61 6c 75 65 2c 20 eger key value,
8060: 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 74 a variable lengt
8070: 68 20 0a 20 20 20 20 2a 2a 20 69 6e 74 65 67 65 h . ** intege
8080: 72 2e 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 r. The following
8090: 20 62 6c 6f 63 6b 20 6d 6f 76 65 73 20 70 49 74 block moves pIt
80a0: 65 72 20 74 6f 20 70 6f 69 6e 74 20 61 74 20 74 er to point at t
80b0: 68 65 20 66 69 72 73 74 20 62 79 74 65 0a 20 20 he first byte.
80c0: 20 20 2a 2a 20 70 61 73 74 20 74 68 65 20 65 6e ** past the en
80d0: 64 20 6f 66 20 74 68 65 20 6b 65 79 20 76 61 6c d of the key val
80e0: 75 65 2e 20 2a 2f 0a 20 20 20 20 70 45 6e 64 20 ue. */. pEnd
80f0: 3d 20 26 70 49 74 65 72 5b 39 5d 3b 0a 20 20 20 = &pIter[9];.
8100: 20 77 68 69 6c 65 28 20 28 2a 70 49 74 65 72 2b while( (*pIter+
8110: 2b 29 26 30 78 38 30 20 26 26 20 70 49 74 65 72 +)&0x80 && pIter
8120: 3c 70 45 6e 64 20 29 3b 0a 20 20 7d 65 6c 73 65 <pEnd );. }else
8130: 7b 0a 20 20 20 20 70 49 74 65 72 20 2b 3d 20 67 {. pIter += g
8140: 65 74 56 61 72 69 6e 74 33 32 28 70 49 74 65 72 etVarint32(pIter
8150: 2c 20 6e 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 , nSize);. }..
8160: 20 74 65 73 74 63 61 73 65 28 20 6e 53 69 7a 65 testcase( nSize
8170: 3d 3d 70 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 ==pPage->maxLoca
8180: 6c 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 l );. testcase(
8190: 20 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d nSize==pPage->m
81a0: 61 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 69 axLocal+1 );. i
81b0: 66 28 20 6e 53 69 7a 65 3e 70 50 61 67 65 2d 3e f( nSize>pPage->
81c0: 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 maxLocal ){.
81d0: 69 6e 74 20 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 int minLocal = p
81e0: 50 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a Page->minLocal;.
81f0: 20 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 6e 4c nSize = minL
8200: 6f 63 61 6c 20 2b 20 28 6e 53 69 7a 65 20 2d 20 ocal + (nSize -
8210: 6d 69 6e 4c 6f 63 61 6c 29 20 25 20 28 70 50 61 minLocal) % (pPa
8220: 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
8230: 69 7a 65 20 2d 20 34 29 3b 0a 20 20 20 20 74 65 ize - 4);. te
8240: 73 74 63 61 73 65 28 20 6e 53 69 7a 65 3d 3d 70 stcase( nSize==p
8250: 50 61 67 65 2d 3e 6d 61 78 4c 6f 63 61 6c 20 29 Page->maxLocal )
8260: 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
8270: 6e 53 69 7a 65 3d 3d 70 50 61 67 65 2d 3e 6d 61 nSize==pPage->ma
8280: 78 4c 6f 63 61 6c 2b 31 20 29 3b 0a 20 20 20 20 xLocal+1 );.
8290: 69 66 28 20 6e 53 69 7a 65 3e 70 50 61 67 65 2d if( nSize>pPage-
82a0: 3e 6d 61 78 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 >maxLocal ){.
82b0: 20 20 20 6e 53 69 7a 65 20 3d 20 6d 69 6e 4c 6f nSize = minLo
82c0: 63 61 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6e cal;. }. n
82d0: 53 69 7a 65 20 2b 3d 20 34 3b 0a 20 20 7d 0a 20 Size += 4;. }.
82e0: 20 6e 53 69 7a 65 20 2b 3d 20 28 75 33 32 29 28 nSize += (u32)(
82f0: 70 49 74 65 72 20 2d 20 70 43 65 6c 6c 29 3b 0a pIter - pCell);.
8300: 0a 20 20 2f 2a 20 54 68 65 20 6d 69 6e 69 6d 75 . /* The minimu
8310: 6d 20 73 69 7a 65 20 6f 66 20 61 6e 79 20 63 65 m size of any ce
8320: 6c 6c 20 69 73 20 34 20 62 79 74 65 73 2e 20 2a ll is 4 bytes. *
8330: 2f 0a 20 20 69 66 28 20 6e 53 69 7a 65 3c 34 20 /. if( nSize<4
8340: 29 7b 0a 20 20 20 20 6e 53 69 7a 65 20 3d 20 34 ){. nSize = 4
8350: 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 ;. }.. assert(
8360: 20 6e 53 69 7a 65 3d 3d 64 65 62 75 67 69 6e 66 nSize==debuginf
8370: 6f 2e 6e 53 69 7a 65 20 29 3b 0a 20 20 72 65 74 o.nSize );. ret
8380: 75 72 6e 20 28 75 31 36 29 6e 53 69 7a 65 3b 0a urn (u16)nSize;.
8390: 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
83a0: 5f 44 45 42 55 47 0a 2f 2a 20 54 68 69 73 20 76 _DEBUG./* This v
83b0: 61 72 69 61 74 69 6f 6e 20 6f 6e 20 63 65 6c 6c ariation on cell
83c0: 53 69 7a 65 50 74 72 28 29 20 69 73 20 75 73 65 SizePtr() is use
83d0: 64 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 65 d inside of asse
83e0: 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 0a rt() statements.
83f0: 2a 2a 20 6f 6e 6c 79 2e 20 2a 2f 0a 73 74 61 74 ** only. */.stat
8400: 69 63 20 75 31 36 20 63 65 6c 6c 53 69 7a 65 28 ic u16 cellSize(
8410: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
8420: 69 6e 74 20 69 43 65 6c 6c 29 7b 0a 20 20 72 65 int iCell){. re
8430: 74 75 72 6e 20 63 65 6c 6c 53 69 7a 65 50 74 72 turn cellSizePtr
8440: 28 70 50 61 67 65 2c 20 66 69 6e 64 43 65 6c 6c (pPage, findCell
8450: 28 70 50 61 67 65 2c 20 69 43 65 6c 6c 29 29 3b (pPage, iCell));
8460: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 .}.#endif..#ifnd
8470: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
8480: 55 54 4f 56 41 43 55 55 4d 0a 2f 2a 0a 2a 2a 20 UTOVACUUM./*.**
8490: 49 66 20 74 68 65 20 63 65 6c 6c 20 70 43 65 6c If the cell pCel
84a0: 6c 2c 20 70 61 72 74 20 6f 66 20 70 61 67 65 20 l, part of page
84b0: 70 50 61 67 65 20 63 6f 6e 74 61 69 6e 73 20 61 pPage contains a
84c0: 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 61 pointer.** to a
84d0: 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2c n overflow page,
84e0: 20 69 6e 73 65 72 74 20 61 6e 20 65 6e 74 72 79 insert an entry
84f0: 20 69 6e 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 into the pointe
8500: 72 2d 6d 61 70 0a 2a 2a 20 66 6f 72 20 74 68 65 r-map.** for the
8510: 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 2e 0a overflow page..
8520: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 70 */.static void p
8530: 74 72 6d 61 70 50 75 74 4f 76 66 6c 50 74 72 28 trmapPutOvflPtr(
8540: 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 MemPage *pPage,
8550: 75 38 20 2a 70 43 65 6c 6c 2c 20 69 6e 74 20 2a u8 *pCell, int *
8560: 70 52 43 29 7b 0a 20 20 43 65 6c 6c 49 6e 66 6f pRC){. CellInfo
8570: 20 69 6e 66 6f 3b 0a 20 20 69 66 28 20 2a 70 52 info;. if( *pR
8580: 43 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 61 73 C ) return;. as
8590: 73 65 72 74 28 20 70 43 65 6c 6c 21 3d 30 20 29 sert( pCell!=0 )
85a0: 3b 0a 20 20 62 74 72 65 65 50 61 72 73 65 43 65 ;. btreeParseCe
85b0: 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 llPtr(pPage, pCe
85c0: 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 61 73 ll, &info);. as
85d0: 73 65 72 74 28 20 28 69 6e 66 6f 2e 6e 44 61 74 sert( (info.nDat
85e0: 61 2b 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 a+(pPage->intKey
85f0: 3f 30 3a 69 6e 66 6f 2e 6e 4b 65 79 29 29 3d 3d ?0:info.nKey))==
8600: 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 20 29 3b info.nPayload );
8610: 0a 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 65 . if( info.iOve
8620: 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 50 67 6e rflow ){. Pgn
8630: 6f 20 6f 76 66 6c 20 3d 20 67 65 74 34 62 79 74 o ovfl = get4byt
8640: 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f e(&pCell[info.iO
8650: 76 65 72 66 6c 6f 77 5d 29 3b 0a 20 20 20 20 70 verflow]);. p
8660: 74 72 6d 61 70 50 75 74 28 70 50 61 67 65 2d 3e trmapPut(pPage->
8670: 70 42 74 2c 20 6f 76 66 6c 2c 20 50 54 52 4d 41 pBt, ovfl, PTRMA
8680: 50 5f 4f 56 45 52 46 4c 4f 57 31 2c 20 70 50 61 P_OVERFLOW1, pPa
8690: 67 65 2d 3e 70 67 6e 6f 2c 20 70 52 43 29 3b 0a ge->pgno, pRC);.
86a0: 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 2f }.}.#endif.../
86b0: 2a 0a 2a 2a 20 44 65 66 72 61 67 6d 65 6e 74 20 *.** Defragment
86c0: 74 68 65 20 70 61 67 65 20 67 69 76 65 6e 2e 20 the page given.
86d0: 20 41 6c 6c 20 43 65 6c 6c 73 20 61 72 65 20 6d All Cells are m
86e0: 6f 76 65 64 20 74 6f 20 74 68 65 0a 2a 2a 20 65 oved to the.** e
86f0: 6e 64 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 nd of the page a
8700: 6e 64 20 61 6c 6c 20 66 72 65 65 20 73 70 61 63 nd all free spac
8710: 65 20 69 73 20 63 6f 6c 6c 65 63 74 65 64 20 69 e is collected i
8720: 6e 74 6f 20 6f 6e 65 0a 2a 2a 20 62 69 67 20 46 nto one.** big F
8730: 72 65 65 42 6c 6b 20 74 68 61 74 20 6f 63 63 75 reeBlk that occu
8740: 72 73 20 69 6e 20 62 65 74 77 65 65 6e 20 74 68 rs in between th
8750: 65 20 68 65 61 64 65 72 20 61 6e 64 20 63 65 6c e header and cel
8760: 6c 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 61 72 72 l.** pointer arr
8770: 61 79 20 61 6e 64 20 74 68 65 20 63 65 6c 6c 20 ay and the cell
8780: 63 6f 6e 74 65 6e 74 20 61 72 65 61 2e 0a 2a 2f content area..*/
8790: 0a 73 74 61 74 69 63 20 69 6e 74 20 64 65 66 72 .static int defr
87a0: 61 67 6d 65 6e 74 50 61 67 65 28 4d 65 6d 50 61 agmentPage(MemPa
87b0: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e ge *pPage){. in
87c0: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 t i;
87d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 /* Loop
87e0: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 6e counter */. in
87f0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20 t pc;
8800: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 /* Addr
8810: 65 73 73 20 6f 66 20 61 20 69 2d 74 68 20 63 65 ess of a i-th ce
8820: 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 68 64 72 3b ll */. int hdr;
8830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8840: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 74 6f 20 /* Offset to
8850: 74 68 65 20 70 61 67 65 20 68 65 61 64 65 72 20 the page header
8860: 2a 2f 0a 20 20 69 6e 74 20 73 69 7a 65 3b 20 20 */. int size;
8870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8880: 2f 2a 20 53 69 7a 65 20 6f 66 20 61 20 63 65 6c /* Size of a cel
8890: 6c 20 2a 2f 0a 20 20 69 6e 74 20 75 73 61 62 6c l */. int usabl
88a0: 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 eSize;
88b0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
88c0: 73 61 62 6c 65 20 62 79 74 65 73 20 6f 6e 20 61 sable bytes on a
88d0: 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 63 page */. int c
88e0: 65 6c 6c 4f 66 66 73 65 74 3b 20 20 20 20 20 20 ellOffset;
88f0: 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 /* Offset
8900: 74 6f 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 6e to the cell poin
8910: 74 65 72 20 61 72 72 61 79 20 2a 2f 0a 20 20 69 ter array */. i
8920: 6e 74 20 63 62 72 6b 3b 20 20 20 20 20 20 20 20 nt cbrk;
8930: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 /* Off
8940: 73 65 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 set to the cell
8950: 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a content area */.
8960: 20 20 69 6e 74 20 6e 43 65 6c 6c 3b 20 20 20 20 int nCell;
8970: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8980: 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 Number of cells
8990: 6f 6e 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 on the page */.
89a0: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
89b0: 64 61 74 61 3b 20 20 20 20 20 20 20 2f 2a 20 54 data; /* T
89c0: 68 65 20 70 61 67 65 20 64 61 74 61 20 2a 2f 0a he page data */.
89d0: 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
89e0: 2a 74 65 6d 70 3b 20 20 20 20 20 20 20 2f 2a 20 *temp; /*
89f0: 54 65 6d 70 20 61 72 65 61 20 66 6f 72 20 63 65 Temp area for ce
8a00: 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 20 20 ll content */.
8a10: 69 6e 74 20 69 43 65 6c 6c 46 69 72 73 74 3b 20 int iCellFirst;
8a20: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
8a30: 72 73 74 20 61 6c 6c 6f 77 61 62 6c 65 20 63 65 rst allowable ce
8a40: 6c 6c 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e ll index */. in
8a50: 74 20 69 43 65 6c 6c 4c 61 73 74 3b 20 20 20 20 t iCellLast;
8a60: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 /* Last
8a70: 20 70 6f 73 73 69 62 6c 65 20 63 65 6c 6c 20 69 possible cell i
8a80: 6e 64 65 78 20 2a 2f 0a 0a 0a 20 20 61 73 73 65 ndex */... asse
8a90: 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 rt( sqlite3Pager
8aa0: 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
8ab0: 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 e->pDbPage) );.
8ac0: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
8ad0: 70 42 74 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 pBt!=0 );. asse
8ae0: 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e rt( pPage->pBt->
8af0: 75 73 61 62 6c 65 53 69 7a 65 20 3c 3d 20 53 51 usableSize <= SQ
8b00: 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 LITE_MAX_PAGE_SI
8b10: 5a 45 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ZE );. assert(
8b20: 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 pPage->nOverflow
8b30: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==0 );. assert(
8b40: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
8b50: 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e eld(pPage->pBt->
8b60: 6d 75 74 65 78 29 20 29 3b 0a 20 20 74 65 6d 70 mutex) );. temp
8b70: 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 = sqlite3PagerT
8b80: 65 6d 70 53 70 61 63 65 28 70 50 61 67 65 2d 3e empSpace(pPage->
8b90: 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 pBt->pPager);.
8ba0: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
8bb0: 61 74 61 3b 0a 20 20 68 64 72 20 3d 20 70 50 61 ata;. hdr = pPa
8bc0: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a 20 ge->hdrOffset;.
8bd0: 20 63 65 6c 6c 4f 66 66 73 65 74 20 3d 20 70 50 cellOffset = pP
8be0: 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 3b age->cellOffset;
8bf0: 0a 20 20 6e 43 65 6c 6c 20 3d 20 70 50 61 67 65 . nCell = pPage
8c00: 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 61 73 73 65 72 ->nCell;. asser
8c10: 74 28 20 6e 43 65 6c 6c 3d 3d 67 65 74 32 62 79 t( nCell==get2by
8c20: 74 65 28 26 64 61 74 61 5b 68 64 72 2b 33 5d 29 te(&data[hdr+3])
8c30: 20 29 3b 0a 20 20 75 73 61 62 6c 65 53 69 7a 65 );. usableSize
8c40: 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 = pPage->pBt->u
8c50: 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 63 62 72 sableSize;. cbr
8c60: 6b 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 k = get2byte(&da
8c70: 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 6d 65 ta[hdr+5]);. me
8c80: 6d 63 70 79 28 26 74 65 6d 70 5b 63 62 72 6b 5d mcpy(&temp[cbrk]
8c90: 2c 20 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 75 , &data[cbrk], u
8ca0: 73 61 62 6c 65 53 69 7a 65 20 2d 20 63 62 72 6b sableSize - cbrk
8cb0: 29 3b 0a 20 20 63 62 72 6b 20 3d 20 75 73 61 62 );. cbrk = usab
8cc0: 6c 65 53 69 7a 65 3b 0a 20 20 69 43 65 6c 6c 46 leSize;. iCellF
8cd0: 69 72 73 74 20 3d 20 63 65 6c 6c 4f 66 66 73 65 irst = cellOffse
8ce0: 74 20 2b 20 32 2a 6e 43 65 6c 6c 3b 0a 20 20 69 t + 2*nCell;. i
8cf0: 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 61 62 6c CellLast = usabl
8d00: 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 66 6f 72 eSize - 4;. for
8d10: 28 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 (i=0; i<nCell; i
8d20: 2b 2b 29 7b 0a 20 20 20 20 75 38 20 2a 70 41 64 ++){. u8 *pAd
8d30: 64 72 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 69 dr; /* The i
8d40: 2d 74 68 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 -th cell pointer
8d50: 20 2a 2f 0a 20 20 20 20 70 41 64 64 72 20 3d 20 */. pAddr =
8d60: 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 65 74 &data[cellOffset
8d70: 20 2b 20 69 2a 32 5d 3b 0a 20 20 20 20 70 63 20 + i*2];. pc
8d80: 3d 20 67 65 74 32 62 79 74 65 28 70 41 64 64 72 = get2byte(pAddr
8d90: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
8da0: 20 70 63 3d 3d 69 43 65 6c 6c 46 69 72 73 74 20 pc==iCellFirst
8db0: 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 );. testcase(
8dc0: 20 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 pc==iCellLast )
8dd0: 3b 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 ;.#if !defined(S
8de0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4f 56 45 QLITE_ENABLE_OVE
8df0: 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 45 43 4b RSIZE_CELL_CHECK
8e00: 29 0a 20 20 20 20 2f 2a 20 54 68 65 73 65 20 63 ). /* These c
8e10: 6f 6e 64 69 74 69 6f 6e 73 20 68 61 76 65 20 61 onditions have a
8e20: 6c 72 65 61 64 79 20 62 65 65 6e 20 76 65 72 69 lready been veri
8e30: 66 69 65 64 20 69 6e 20 62 74 72 65 65 49 6e 69 fied in btreeIni
8e40: 74 50 61 67 65 28 29 0a 20 20 20 20 2a 2a 20 69 tPage(). ** i
8e50: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
8e60: 4f 56 45 52 53 49 5a 45 5f 43 45 4c 4c 5f 43 48 OVERSIZE_CELL_CH
8e70: 45 43 4b 20 69 73 20 64 65 66 69 6e 65 64 20 0a ECK is defined .
8e80: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 */. if( p
8e90: 63 3c 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 c<iCellFirst ||
8ea0: 70 63 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a pc>iCellLast ){.
8eb0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
8ec0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
8ed0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
8ee0: 20 20 20 61 73 73 65 72 74 28 20 70 63 3e 3d 69 assert( pc>=i
8ef0: 43 65 6c 6c 46 69 72 73 74 20 26 26 20 70 63 3c CellFirst && pc<
8f00: 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b 0a 20 20 =iCellLast );.
8f10: 20 20 73 69 7a 65 20 3d 20 63 65 6c 6c 53 69 7a size = cellSiz
8f20: 65 50 74 72 28 70 50 61 67 65 2c 20 26 74 65 6d ePtr(pPage, &tem
8f30: 70 5b 70 63 5d 29 3b 0a 20 20 20 20 63 62 72 6b p[pc]);. cbrk
8f40: 20 2d 3d 20 73 69 7a 65 3b 0a 23 69 66 20 64 65 -= size;.#if de
8f50: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
8f60: 42 4c 45 5f 4f 56 45 52 53 49 5a 45 5f 43 45 4c BLE_OVERSIZE_CEL
8f70: 4c 5f 43 48 45 43 4b 29 0a 20 20 20 20 69 66 28 L_CHECK). if(
8f80: 20 63 62 72 6b 3c 69 43 65 6c 6c 46 69 72 73 74 cbrk<iCellFirst
8f90: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
8fa0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
8fb0: 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 23 65 6c 73 BKPT;. }.#els
8fc0: 65 0a 20 20 20 20 69 66 28 20 63 62 72 6b 3c 69 e. if( cbrk<i
8fd0: 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 2b CellFirst || pc+
8fe0: 73 69 7a 65 3e 75 73 61 62 6c 65 53 69 7a 65 20 size>usableSize
8ff0: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
9000: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
9010: 4b 50 54 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 KPT;. }.#endi
9020: 66 0a 20 20 20 20 61 73 73 65 72 74 28 20 63 62 f. assert( cb
9030: 72 6b 2b 73 69 7a 65 3c 3d 75 73 61 62 6c 65 53 rk+size<=usableS
9040: 69 7a 65 20 26 26 20 63 62 72 6b 3e 3d 69 43 65 ize && cbrk>=iCe
9050: 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 20 20 74 llFirst );. t
9060: 65 73 74 63 61 73 65 28 20 63 62 72 6b 2b 73 69 estcase( cbrk+si
9070: 7a 65 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 ze==usableSize )
9080: 3b 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 ;. testcase(
9090: 70 63 2b 73 69 7a 65 3d 3d 75 73 61 62 6c 65 53 pc+size==usableS
90a0: 69 7a 65 20 29 3b 0a 20 20 20 20 6d 65 6d 63 70 ize );. memcp
90b0: 79 28 26 64 61 74 61 5b 63 62 72 6b 5d 2c 20 26 y(&data[cbrk], &
90c0: 74 65 6d 70 5b 70 63 5d 2c 20 73 69 7a 65 29 3b temp[pc], size);
90d0: 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 70 41 . put2byte(pA
90e0: 64 64 72 2c 20 63 62 72 6b 29 3b 0a 20 20 7d 0a ddr, cbrk);. }.
90f0: 20 20 61 73 73 65 72 74 28 20 63 62 72 6b 3e 3d assert( cbrk>=
9100: 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
9110: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 put2byte(&data[h
9120: 64 72 2b 35 5d 2c 20 63 62 72 6b 29 3b 0a 20 20 dr+5], cbrk);.
9130: 64 61 74 61 5b 68 64 72 2b 31 5d 20 3d 20 30 3b data[hdr+1] = 0;
9140: 0a 20 20 64 61 74 61 5b 68 64 72 2b 32 5d 20 3d . data[hdr+2] =
9150: 20 30 3b 0a 20 20 64 61 74 61 5b 68 64 72 2b 37 0;. data[hdr+7
9160: 5d 20 3d 20 30 3b 0a 20 20 6d 65 6d 73 65 74 28 ] = 0;. memset(
9170: 26 64 61 74 61 5b 69 43 65 6c 6c 46 69 72 73 74 &data[iCellFirst
9180: 5d 2c 20 30 2c 20 63 62 72 6b 2d 69 43 65 6c 6c ], 0, cbrk-iCell
9190: 46 69 72 73 74 29 3b 0a 20 20 61 73 73 65 72 74 First);. assert
91a0: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 ( sqlite3PagerIs
91b0: 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 65 2d writeable(pPage-
91c0: 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 69 >pDbPage) );. i
91d0: 66 28 20 63 62 72 6b 2d 69 43 65 6c 6c 46 69 72 f( cbrk-iCellFir
91e0: 73 74 21 3d 70 50 61 67 65 2d 3e 6e 46 72 65 65 st!=pPage->nFree
91f0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
9200: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
9210: 50 54 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e PT;. }. return
9220: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f SQLITE_OK;.}../
9230: 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 6e 42 *.** Allocate nB
9240: 79 74 65 20 62 79 74 65 73 20 6f 66 20 73 70 61 yte bytes of spa
9250: 63 65 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 74 ce from within t
9260: 68 65 20 42 2d 54 72 65 65 20 70 61 67 65 20 70 he B-Tree page p
9270: 61 73 73 65 64 0a 2a 2a 20 61 73 20 74 68 65 20 assed.** as the
9280: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 20 first argument.
9290: 57 72 69 74 65 20 69 6e 74 6f 20 2a 70 49 64 78 Write into *pIdx
92a0: 20 74 68 65 20 69 6e 64 65 78 20 69 6e 74 6f 20 the index into
92b0: 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 5d 0a 2a pPage->aData[].*
92c0: 2a 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 62 * of the first b
92d0: 79 74 65 20 6f 66 20 61 6c 6c 6f 63 61 74 65 64 yte of allocated
92e0: 20 73 70 61 63 65 2e 20 52 65 74 75 72 6e 20 65 space. Return e
92f0: 69 74 68 65 72 20 53 51 4c 49 54 45 5f 4f 4b 20 ither SQLITE_OK
9300: 6f 72 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 63 or.** an error c
9310: 6f 64 65 20 28 75 73 75 61 6c 6c 79 20 53 51 4c ode (usually SQL
9320: 49 54 45 5f 43 4f 52 52 55 50 54 29 2e 0a 2a 2a ITE_CORRUPT)..**
9330: 0a 2a 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 67 .** The caller g
9340: 75 61 72 61 6e 74 65 65 73 20 74 68 61 74 20 74 uarantees that t
9350: 68 65 72 65 20 69 73 20 73 75 66 66 69 63 69 65 here is sufficie
9360: 6e 74 20 73 70 61 63 65 20 74 6f 20 6d 61 6b 65 nt space to make
9370: 20 74 68 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 the.** allocati
9380: 6f 6e 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e on. This routin
9390: 65 20 6d 69 67 68 74 20 6e 65 65 64 20 74 6f 20 e might need to
93a0: 64 65 66 72 61 67 6d 65 6e 74 20 69 6e 20 6f 72 defragment in or
93b0: 64 65 72 20 74 6f 20 62 72 69 6e 67 0a 2a 2a 20 der to bring.**
93c0: 61 6c 6c 20 74 68 65 20 73 70 61 63 65 20 74 6f all the space to
93d0: 67 65 74 68 65 72 2c 20 68 6f 77 65 76 65 72 2e gether, however.
93e0: 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 This routine w
93f0: 69 6c 6c 20 61 76 6f 69 64 20 75 73 69 6e 67 0a ill avoid using.
9400: 2a 2a 20 74 68 65 20 66 69 72 73 74 20 74 77 6f ** the first two
9410: 20 62 79 74 65 73 20 70 61 73 74 20 74 68 65 20 bytes past the
9420: 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 61 72 65 cell pointer are
9430: 61 20 73 69 6e 63 65 20 70 72 65 73 75 6d 61 62 a since presumab
9440: 6c 79 20 74 68 69 73 0a 2a 2a 20 61 6c 6c 6f 63 ly this.** alloc
9450: 61 74 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 6d ation is being m
9460: 61 64 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ade in order to
9470: 69 6e 73 65 72 74 20 61 20 6e 65 77 20 63 65 6c insert a new cel
9480: 6c 2c 20 73 6f 20 77 65 20 77 69 6c 6c 0a 2a 2a l, so we will.**
9490: 20 61 6c 73 6f 20 65 6e 64 20 75 70 20 6e 65 65 also end up nee
94a0: 64 69 6e 67 20 61 20 6e 65 77 20 63 65 6c 6c 20 ding a new cell
94b0: 70 6f 69 6e 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 pointer..*/.stat
94c0: 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 65 53 ic int allocateS
94d0: 70 61 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 pace(MemPage *pP
94e0: 61 67 65 2c 20 69 6e 74 20 6e 42 79 74 65 2c 20 age, int nByte,
94f0: 69 6e 74 20 2a 70 49 64 78 29 7b 0a 20 20 63 6f int *pIdx){. co
9500: 6e 73 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 nst int hdr = pP
9510: 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 age->hdrOffset;
9520: 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 63 61 63 68 /* Local cach
9530: 65 20 6f 66 20 70 50 61 67 65 2d 3e 68 64 72 4f e of pPage->hdrO
9540: 66 66 73 65 74 20 2a 2f 0a 20 20 75 38 20 2a 20 ffset */. u8 *
9550: 63 6f 6e 73 74 20 64 61 74 61 20 3d 20 70 50 61 const data = pPa
9560: 67 65 2d 3e 61 44 61 74 61 3b 20 20 20 20 20 20 ge->aData;
9570: 2f 2a 20 4c 6f 63 61 6c 20 63 61 63 68 65 20 6f /* Local cache o
9580: 66 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 2a f pPage->aData *
9590: 2f 0a 20 20 69 6e 74 20 6e 46 72 61 67 3b 20 20 /. int nFrag;
95a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
95c0: 65 72 20 6f 66 20 66 72 61 67 6d 65 6e 74 65 64 er of fragmented
95d0: 20 62 79 74 65 73 20 6f 6e 20 70 50 61 67 65 20 bytes on pPage
95e0: 2a 2f 0a 20 20 69 6e 74 20 74 6f 70 3b 20 20 20 */. int top;
95f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9600: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
9610: 73 74 20 62 79 74 65 20 6f 66 20 63 65 6c 6c 20 st byte of cell
9620: 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 2a 2f 0a content area */.
9630: 20 20 69 6e 74 20 67 61 70 3b 20 20 20 20 20 20 int gap;
9640: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
9650: 6f 66 20 67 61 70 20 62 65 74 77 65 65 6e 20 63 of gap between c
9660: 65 6c 6c 20 70 6f 69 6e 74 65 72 73 20 61 6e 64 ell pointers and
9670: 20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 2a 2f cell content */
9680: 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
9690: 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 72 65 /* Integer re
96a0: 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 turn code */. i
96b0: 6e 74 20 75 73 61 62 6c 65 53 69 7a 65 3b 20 2f nt usableSize; /
96c0: 2a 20 55 73 61 62 6c 65 20 73 69 7a 65 20 6f 66 * Usable size of
96d0: 20 74 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 0a the page */. .
96e0: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
96f0: 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
9700: 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
9710: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
9720: 50 61 67 65 2d 3e 70 42 74 20 29 3b 0a 20 20 61 Page->pBt );. a
9730: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
9740: 75 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d utex_held(pPage-
9750: 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a >pBt->mutex) );.
9760: 20 20 61 73 73 65 72 74 28 20 6e 42 79 74 65 3e assert( nByte>
9770: 3d 30 20 29 3b 20 20 2f 2a 20 4d 69 6e 69 6d 75 =0 ); /* Minimu
9780: 6d 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 m cell size is 4
9790: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 */. assert( pP
97a0: 61 67 65 2d 3e 6e 46 72 65 65 3e 3d 6e 42 79 74 age->nFree>=nByt
97b0: 65 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 e );. assert( p
97c0: 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d Page->nOverflow=
97d0: 3d 30 20 29 3b 0a 20 20 75 73 61 62 6c 65 53 69 =0 );. usableSi
97e0: 7a 65 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 2d ze = pPage->pBt-
97f0: 3e 75 73 61 62 6c 65 53 69 7a 65 3b 0a 20 20 61 >usableSize;. a
9800: 73 73 65 72 74 28 20 6e 42 79 74 65 20 3c 20 75 ssert( nByte < u
9810: 73 61 62 6c 65 53 69 7a 65 2d 38 20 29 3b 0a 0a sableSize-8 );..
9820: 20 20 6e 46 72 61 67 20 3d 20 64 61 74 61 5b 68 nFrag = data[h
9830: 64 72 2b 37 5d 3b 0a 20 20 61 73 73 65 72 74 28 dr+7];. assert(
9840: 20 70 50 61 67 65 2d 3e 63 65 6c 6c 4f 66 66 73 pPage->cellOffs
9850: 65 74 20 3d 3d 20 68 64 72 20 2b 20 31 32 20 2d et == hdr + 12 -
9860: 20 34 2a 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 4*pPage->leaf )
9870: 3b 0a 20 20 67 61 70 20 3d 20 70 50 61 67 65 2d ;. gap = pPage-
9880: 3e 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a >cellOffset + 2*
9890: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
98a0: 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e 6f top = get2byteNo
98b0: 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 2b tZero(&data[hdr+
98c0: 35 5d 29 3b 0a 20 20 69 66 28 20 67 61 70 3e 74 5]);. if( gap>t
98d0: 6f 70 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 op ) return SQLI
98e0: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
98f0: 0a 20 20 74 65 73 74 63 61 73 65 28 20 67 61 70 . testcase( gap
9900: 2b 32 3d 3d 74 6f 70 20 29 3b 0a 20 20 74 65 73 +2==top );. tes
9910: 74 63 61 73 65 28 20 67 61 70 2b 31 3d 3d 74 6f tcase( gap+1==to
9920: 70 20 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 p );. testcase(
9930: 20 67 61 70 3d 3d 74 6f 70 20 29 3b 0a 0a 20 20 gap==top );..
9940: 69 66 28 20 6e 46 72 61 67 3e 3d 36 30 20 29 7b if( nFrag>=60 ){
9950: 0a 20 20 20 20 2f 2a 20 41 6c 77 61 79 73 20 64 . /* Always d
9960: 65 66 72 61 67 6d 65 6e 74 20 68 69 67 68 6c 79 efragment highly
9970: 20 66 72 61 67 6d 65 6e 74 65 64 20 70 61 67 65 fragmented page
9980: 73 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 64 65 s */. rc = de
9990: 66 72 61 67 6d 65 6e 74 50 61 67 65 28 70 50 61 fragmentPage(pPa
99a0: 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 ge);. if( rc
99b0: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
99c0: 20 74 6f 70 20 3d 20 67 65 74 32 62 79 74 65 4e top = get2byteN
99d0: 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 64 72 otZero(&data[hdr
99e0: 2b 35 5d 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 +5]);. }else if
99f0: 28 20 67 61 70 2b 32 3c 3d 74 6f 70 20 29 7b 0a ( gap+2<=top ){.
9a00: 20 20 20 20 2f 2a 20 53 65 61 72 63 68 20 74 68 /* Search th
9a10: 65 20 66 72 65 65 6c 69 73 74 20 6c 6f 6f 6b 69 e freelist looki
9a20: 6e 67 20 66 6f 72 20 61 20 66 72 65 65 20 73 6c ng for a free sl
9a30: 6f 74 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f ot big enough to
9a40: 20 73 61 74 69 73 66 79 20 0a 20 20 20 20 2a 2a satisfy . **
9a50: 20 74 68 65 20 72 65 71 75 65 73 74 2e 20 54 68 the request. Th
9a60: 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 e allocation is
9a70: 6d 61 64 65 20 66 72 6f 6d 20 74 68 65 20 66 69 made from the fi
9a80: 72 73 74 20 66 72 65 65 20 73 6c 6f 74 20 69 6e rst free slot in
9a90: 20 0a 20 20 20 20 2a 2a 20 74 68 65 20 6c 69 73 . ** the lis
9aa0: 74 20 74 68 61 74 20 69 73 20 6c 61 72 67 65 20 t that is large
9ab0: 65 6e 6f 75 67 68 20 74 6f 20 61 63 63 6f 6d 61 enough to accoma
9ac0: 64 61 74 65 20 69 74 2e 0a 20 20 20 20 2a 2f 0a date it.. */.
9ad0: 20 20 20 20 69 6e 74 20 70 63 2c 20 61 64 64 72 int pc, addr
9ae0: 3b 0a 20 20 20 20 66 6f 72 28 61 64 64 72 3d 68 ;. for(addr=h
9af0: 64 72 2b 31 3b 20 28 70 63 20 3d 20 67 65 74 32 dr+1; (pc = get2
9b00: 62 79 74 65 28 26 64 61 74 61 5b 61 64 64 72 5d byte(&data[addr]
9b10: 29 29 3e 30 3b 20 61 64 64 72 3d 70 63 29 7b 0a ))>0; addr=pc){.
9b20: 20 20 20 20 20 20 69 6e 74 20 73 69 7a 65 3b 20 int size;
9b30: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
9b40: 7a 65 20 6f 66 20 74 68 65 20 66 72 65 65 20 73 ze of the free s
9b50: 6c 6f 74 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 lot */. if(
9b60: 20 70 63 3e 75 73 61 62 6c 65 53 69 7a 65 2d 34 pc>usableSize-4
9b70: 20 7c 7c 20 70 63 3c 61 64 64 72 2b 34 20 29 7b || pc<addr+4 ){
9b80: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
9b90: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
9ba0: 4b 50 54 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 KPT;. }.
9bb0: 20 20 20 73 69 7a 65 20 3d 20 67 65 74 32 62 79 size = get2by
9bc0: 74 65 28 26 64 61 74 61 5b 70 63 2b 32 5d 29 3b te(&data[pc+2]);
9bd0: 0a 20 20 20 20 20 20 69 66 28 20 73 69 7a 65 3e . if( size>
9be0: 3d 6e 42 79 74 65 20 29 7b 0a 20 20 20 20 20 20 =nByte ){.
9bf0: 20 20 69 6e 74 20 78 20 3d 20 73 69 7a 65 20 2d int x = size -
9c00: 20 6e 42 79 74 65 3b 0a 20 20 20 20 20 20 20 20 nByte;.
9c10: 74 65 73 74 63 61 73 65 28 20 78 3d 3d 34 20 29 testcase( x==4 )
9c20: 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61 ;. testca
9c30: 73 65 28 20 78 3d 3d 33 20 29 3b 0a 20 20 20 20 se( x==3 );.
9c40: 20 20 20 20 69 66 28 20 78 3c 34 20 29 7b 0a 20 if( x<4 ){.
9c50: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 6d 6f /* Remo
9c60: 76 65 20 74 68 65 20 73 6c 6f 74 20 66 72 6f 6d ve the slot from
9c70: 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 20 the free-list.
9c80: 55 70 64 61 74 65 20 74 68 65 20 6e 75 6d 62 65 Update the numbe
9c90: 72 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 2a r of. *
9ca0: 2a 20 66 72 61 67 6d 65 6e 74 65 64 20 62 79 74 * fragmented byt
9cb0: 65 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 es within the pa
9cc0: 67 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 ge. */.
9cd0: 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b 61 64 memcpy(&data[ad
9ce0: 64 72 5d 2c 20 26 64 61 74 61 5b 70 63 5d 2c 20 dr], &data[pc],
9cf0: 32 29 3b 0a 20 20 20 20 20 20 20 20 20 20 64 61 2);. da
9d00: 74 61 5b 68 64 72 2b 37 5d 20 3d 20 28 75 38 29 ta[hdr+7] = (u8)
9d10: 28 6e 46 72 61 67 20 2b 20 78 29 3b 0a 20 20 20 (nFrag + x);.
9d20: 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73 }else if( s
9d30: 69 7a 65 2b 70 63 20 3e 20 75 73 61 62 6c 65 53 ize+pc > usableS
9d40: 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ize ){.
9d50: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 return SQLITE_C
9d60: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
9d70: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
9d80: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 6c 6f /* The slo
9d90: 74 20 72 65 6d 61 69 6e 73 20 6f 6e 20 74 68 65 t remains on the
9da0: 20 66 72 65 65 2d 6c 69 73 74 2e 20 52 65 64 75 free-list. Redu
9db0: 63 65 20 69 74 73 20 73 69 7a 65 20 74 6f 20 61 ce its size to a
9dc0: 63 63 6f 75 6e 74 0a 20 20 20 20 20 20 20 20 20 ccount.
9dd0: 20 2a 2a 20 66 6f 72 20 74 68 65 20 70 6f 72 74 ** for the port
9de0: 69 6f 6e 20 75 73 65 64 20 62 79 20 74 68 65 20 ion used by the
9df0: 6e 65 77 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 new allocation.
9e00: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 */. put
9e10: 32 62 79 74 65 28 26 64 61 74 61 5b 70 63 2b 32 2byte(&data[pc+2
9e20: 5d 2c 20 78 29 3b 0a 20 20 20 20 20 20 20 20 7d ], x);. }
9e30: 0a 20 20 20 20 20 20 20 20 2a 70 49 64 78 20 3d . *pIdx =
9e40: 20 70 63 20 2b 20 78 3b 0a 20 20 20 20 20 20 20 pc + x;.
9e50: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
9e60: 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d K;. }. }
9e70: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 6b . }.. /* Check
9e80: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 to make sure th
9e90: 65 72 65 20 69 73 20 65 6e 6f 75 67 68 20 73 70 ere is enough sp
9ea0: 61 63 65 20 69 6e 20 74 68 65 20 67 61 70 20 74 ace in the gap t
9eb0: 6f 20 73 61 74 69 73 66 79 0a 20 20 2a 2a 20 74 o satisfy. ** t
9ec0: 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 he allocation.
9ed0: 49 66 20 6e 6f 74 2c 20 64 65 66 72 61 67 6d 65 If not, defragme
9ee0: 6e 74 2e 0a 20 20 2a 2f 0a 20 20 74 65 73 74 63 nt.. */. testc
9ef0: 61 73 65 28 20 67 61 70 2b 32 2b 6e 42 79 74 65 ase( gap+2+nByte
9f00: 3d 3d 74 6f 70 20 29 3b 0a 20 20 69 66 28 20 67 ==top );. if( g
9f10: 61 70 2b 32 2b 6e 42 79 74 65 3e 74 6f 70 20 29 ap+2+nByte>top )
9f20: 7b 0a 20 20 20 20 72 63 20 3d 20 64 65 66 72 61 {. rc = defra
9f30: 67 6d 65 6e 74 50 61 67 65 28 70 50 61 67 65 29 gmentPage(pPage)
9f40: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
9f50: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 74 6f eturn rc;. to
9f60: 70 20 3d 20 67 65 74 32 62 79 74 65 4e 6f 74 5a p = get2byteNotZ
9f70: 65 72 6f 28 26 64 61 74 61 5b 68 64 72 2b 35 5d ero(&data[hdr+5]
9f80: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 67 );. assert( g
9f90: 61 70 2b 6e 42 79 74 65 3c 3d 74 6f 70 20 29 3b ap+nByte<=top );
9fa0: 0a 20 20 7d 0a 0a 0a 20 20 2f 2a 20 41 6c 6c 6f . }... /* Allo
9fb0: 63 61 74 65 20 6d 65 6d 6f 72 79 20 66 72 6f 6d cate memory from
9fc0: 20 74 68 65 20 67 61 70 20 69 6e 20 62 65 74 77 the gap in betw
9fd0: 65 65 6e 20 74 68 65 20 63 65 6c 6c 20 70 6f 69 een the cell poi
9fe0: 6e 74 65 72 20 61 72 72 61 79 0a 20 20 2a 2a 20 nter array. **
9ff0: 61 6e 64 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e and the cell con
a000: 74 65 6e 74 20 61 72 65 61 2e 20 20 54 68 65 20 tent area. The
a010: 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 btreeInitPage()
a020: 63 61 6c 6c 20 68 61 73 20 61 6c 72 65 61 64 79 call has already
a030: 0a 20 20 2a 2a 20 76 61 6c 69 64 61 74 65 64 20 . ** validated
a040: 74 68 65 20 66 72 65 65 6c 69 73 74 2e 20 20 47 the freelist. G
a050: 69 76 65 6e 20 74 68 61 74 20 74 68 65 20 66 72 iven that the fr
a060: 65 65 6c 69 73 74 20 69 73 20 76 61 6c 69 64 2c eelist is valid,
a070: 20 74 68 65 72 65 0a 20 20 2a 2a 20 69 73 20 6e there. ** is n
a080: 6f 20 77 61 79 20 74 68 61 74 20 74 68 65 20 61 o way that the a
a090: 6c 6c 6f 63 61 74 69 6f 6e 20 63 61 6e 20 65 78 llocation can ex
a0a0: 74 65 6e 64 20 6f 66 66 20 74 68 65 20 65 6e 64 tend off the end
a0b0: 20 6f 66 20 74 68 65 20 70 61 67 65 2e 0a 20 20 of the page..
a0c0: 2a 2a 20 54 68 65 20 61 73 73 65 72 74 28 29 20 ** The assert()
a0d0: 62 65 6c 6f 77 20 76 65 72 69 66 69 65 73 20 74 below verifies t
a0e0: 68 65 20 70 72 65 76 69 6f 75 73 20 73 65 6e 74 he previous sent
a0f0: 65 6e 63 65 2e 0a 20 20 2a 2f 0a 20 20 74 6f 70 ence.. */. top
a100: 20 2d 3d 20 6e 42 79 74 65 3b 0a 20 20 70 75 74 -= nByte;. put
a110: 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
a120: 35 5d 2c 20 74 6f 70 29 3b 0a 20 20 61 73 73 65 5], top);. asse
a130: 72 74 28 20 74 6f 70 2b 6e 42 79 74 65 20 3c 3d rt( top+nByte <=
a140: 20 28 69 6e 74 29 70 50 61 67 65 2d 3e 70 42 74 (int)pPage->pBt
a150: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 3b 0a ->usableSize );.
a160: 20 20 2a 70 49 64 78 20 3d 20 74 6f 70 3b 0a 20 *pIdx = top;.
a170: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
a180: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 K;.}../*.** Retu
a190: 72 6e 20 61 20 73 65 63 74 69 6f 6e 20 6f 66 20 rn a section of
a1a0: 74 68 65 20 70 50 61 67 65 2d 3e 61 44 61 74 61 the pPage->aData
a1b0: 20 74 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 to the freelist
a1c0: 2e 0a 2a 2a 20 54 68 65 20 66 69 72 73 74 20 62 ..** The first b
a1d0: 79 74 65 20 6f 66 20 74 68 65 20 6e 65 77 20 66 yte of the new f
a1e0: 72 65 65 20 62 6c 6f 63 6b 20 69 73 20 70 50 61 ree block is pPa
a1f0: 67 65 2d 3e 61 44 69 73 6b 5b 73 74 61 72 74 5d ge->aDisk[start]
a200: 0a 2a 2a 20 61 6e 64 20 74 68 65 20 73 69 7a 65 .** and the size
a210: 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b 20 69 73 of the block is
a220: 20 22 73 69 7a 65 22 20 62 79 74 65 73 2e 0a 2a "size" bytes..*
a230: 2a 0a 2a 2a 20 4d 6f 73 74 20 6f 66 20 74 68 65 *.** Most of the
a240: 20 65 66 66 6f 72 74 20 68 65 72 65 20 69 73 20 effort here is
a250: 69 6e 76 6f 6c 76 65 64 20 69 6e 20 63 6f 61 6c involved in coal
a260: 65 73 69 6e 67 20 61 64 6a 61 63 65 6e 74 0a 2a esing adjacent.*
a270: 2a 20 66 72 65 65 20 62 6c 6f 63 6b 73 20 69 6e * free blocks in
a280: 74 6f 20 61 20 73 69 6e 67 6c 65 20 62 69 67 20 to a single big
a290: 66 72 65 65 20 62 6c 6f 63 6b 2e 0a 2a 2f 0a 73 free block..*/.s
a2a0: 74 61 74 69 63 20 69 6e 74 20 66 72 65 65 53 70 tatic int freeSp
a2b0: 61 63 65 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 ace(MemPage *pPa
a2c0: 67 65 2c 20 69 6e 74 20 73 74 61 72 74 2c 20 69 ge, int start, i
a2d0: 6e 74 20 73 69 7a 65 29 7b 0a 20 20 69 6e 74 20 nt size){. int
a2e0: 61 64 64 72 2c 20 70 62 65 67 69 6e 2c 20 68 64 addr, pbegin, hd
a2f0: 72 3b 0a 20 20 69 6e 74 20 69 4c 61 73 74 3b 20 r;. int iLast;
a300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a310: 20 20 20 20 20 20 20 2f 2a 20 4c 61 72 67 65 73 /* Larges
a320: 74 20 70 6f 73 73 69 62 6c 65 20 66 72 65 65 62 t possible freeb
a330: 6c 6f 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 20 lock offset */.
a340: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
a350: 64 61 74 61 20 3d 20 70 50 61 67 65 2d 3e 61 44 data = pPage->aD
a360: 61 74 61 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 ata;.. assert(
a370: 70 50 61 67 65 2d 3e 70 42 74 21 3d 30 20 29 3b pPage->pBt!=0 );
a380: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
a390: 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
a3a0: 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
a3b0: 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 e) );. assert(
a3c0: 73 74 61 72 74 3e 3d 70 50 61 67 65 2d 3e 68 64 start>=pPage->hd
a3d0: 72 4f 66 66 73 65 74 2b 36 2b 70 50 61 67 65 2d rOffset+6+pPage-
a3e0: 3e 63 68 69 6c 64 50 74 72 53 69 7a 65 20 29 3b >childPtrSize );
a3f0: 0a 20 20 61 73 73 65 72 74 28 20 28 73 74 61 72 . assert( (star
a400: 74 20 2b 20 73 69 7a 65 29 20 3c 3d 20 28 69 6e t + size) <= (in
a410: 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 t)pPage->pBt->us
a420: 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 61 73 ableSize );. as
a430: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
a440: 74 65 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e tex_held(pPage->
a450: 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
a460: 20 61 73 73 65 72 74 28 20 73 69 7a 65 3e 3d 30 assert( size>=0
a470: 20 29 3b 20 20 20 2f 2a 20 4d 69 6e 69 6d 75 6d ); /* Minimum
a480: 20 63 65 6c 6c 20 73 69 7a 65 20 69 73 20 34 20 cell size is 4
a490: 2a 2f 0a 0a 20 20 69 66 28 20 70 50 61 67 65 2d */.. if( pPage-
a4a0: 3e 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 >pBt->btsFlags &
a4b0: 20 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 BTS_SECURE_DELE
a4c0: 54 45 20 29 7b 0a 20 20 20 20 2f 2a 20 4f 76 65 TE ){. /* Ove
a4d0: 72 77 72 69 74 65 20 64 65 6c 65 74 65 64 20 69 rwrite deleted i
a4e0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 20 nformation with
a4f0: 7a 65 72 6f 73 20 77 68 65 6e 20 74 68 65 20 73 zeros when the s
a500: 65 63 75 72 65 5f 64 65 6c 65 74 65 0a 20 20 20 ecure_delete.
a510: 20 2a 2a 20 6f 70 74 69 6f 6e 20 69 73 20 65 6e ** option is en
a520: 61 62 6c 65 64 20 2a 2f 0a 20 20 20 20 6d 65 6d abled */. mem
a530: 73 65 74 28 26 64 61 74 61 5b 73 74 61 72 74 5d set(&data[start]
a540: 2c 20 30 2c 20 73 69 7a 65 29 3b 0a 20 20 7d 0a , 0, size);. }.
a550: 0a 20 20 2f 2a 20 41 64 64 20 74 68 65 20 73 70 . /* Add the sp
a560: 61 63 65 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 ace back into th
a570: 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 e linked list of
a580: 20 66 72 65 65 62 6c 6f 63 6b 73 2e 20 20 4e 6f freeblocks. No
a590: 74 65 20 74 68 61 74 0a 20 20 2a 2a 20 65 76 65 te that. ** eve
a5a0: 6e 20 74 68 6f 75 67 68 20 74 68 65 20 66 72 65 n though the fre
a5b0: 65 62 6c 6f 63 6b 20 6c 69 73 74 20 77 61 73 20 eblock list was
a5c0: 63 68 65 63 6b 65 64 20 62 79 20 62 74 72 65 65 checked by btree
a5d0: 49 6e 69 74 50 61 67 65 28 29 2c 0a 20 20 2a 2a InitPage(),. **
a5e0: 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 btreeInitPage()
a5f0: 20 64 69 64 20 6e 6f 74 20 64 65 74 65 63 74 20 did not detect
a600: 6f 76 65 72 6c 61 70 70 69 6e 67 20 63 65 6c 6c overlapping cell
a610: 73 20 6f 72 0a 20 20 2a 2a 20 66 72 65 65 62 6c s or. ** freebl
a620: 6f 63 6b 73 20 74 68 61 74 20 6f 76 65 72 6c 61 ocks that overla
a630: 70 70 65 64 20 63 65 6c 6c 73 2e 20 20 20 4e 6f pped cells. No
a640: 72 20 64 6f 65 73 20 69 74 20 64 65 74 65 63 74 r does it detect
a650: 20 77 68 65 6e 20 74 68 65 0a 20 20 2a 2a 20 63 when the. ** c
a660: 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 ell content area
a670: 20 65 78 63 65 65 64 73 20 74 68 65 20 76 61 6c exceeds the val
a680: 75 65 20 69 6e 20 74 68 65 20 70 61 67 65 20 68 ue in the page h
a690: 65 61 64 65 72 2e 20 20 49 66 20 74 68 65 73 65 eader. If these
a6a0: 0a 20 20 2a 2a 20 73 69 74 75 61 74 69 6f 6e 73 . ** situations
a6b0: 20 61 72 69 73 65 2c 20 74 68 65 6e 20 73 75 62 arise, then sub
a6c0: 73 65 71 75 65 6e 74 20 69 6e 73 65 72 74 20 6f sequent insert o
a6d0: 70 65 72 61 74 69 6f 6e 73 20 6d 69 67 68 74 20 perations might
a6e0: 63 6f 72 72 75 70 74 0a 20 20 2a 2a 20 74 68 65 corrupt. ** the
a6f0: 20 66 72 65 65 6c 69 73 74 2e 20 20 53 6f 20 77 freelist. So w
a700: 65 20 64 6f 20 6e 65 65 64 20 74 6f 20 63 68 65 e do need to che
a710: 63 6b 20 66 6f 72 20 63 6f 72 72 75 70 74 69 6f ck for corruptio
a720: 6e 20 77 68 69 6c 65 20 73 63 61 6e 6e 69 6e 67 n while scanning
a730: 0a 20 20 2a 2a 20 74 68 65 20 66 72 65 65 6c 69 . ** the freeli
a740: 73 74 2e 0a 20 20 2a 2f 0a 20 20 68 64 72 20 3d st.. */. hdr =
a750: 20 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 pPage->hdrOffse
a760: 74 3b 0a 20 20 61 64 64 72 20 3d 20 68 64 72 20 t;. addr = hdr
a770: 2b 20 31 3b 0a 20 20 69 4c 61 73 74 20 3d 20 70 + 1;. iLast = p
a780: 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
a790: 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 61 73 73 eSize - 4;. ass
a7a0: 65 72 74 28 20 73 74 61 72 74 3c 3d 69 4c 61 73 ert( start<=iLas
a7b0: 74 20 29 3b 0a 20 20 77 68 69 6c 65 28 20 28 70 t );. while( (p
a7c0: 62 65 67 69 6e 20 3d 20 67 65 74 32 62 79 74 65 begin = get2byte
a7d0: 28 26 64 61 74 61 5b 61 64 64 72 5d 29 29 3c 73 (&data[addr]))<s
a7e0: 74 61 72 74 20 26 26 20 70 62 65 67 69 6e 3e 30 tart && pbegin>0
a7f0: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 62 65 67 ){. if( pbeg
a800: 69 6e 3c 61 64 64 72 2b 34 20 29 7b 0a 20 20 20 in<addr+4 ){.
a810: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a820: 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
a830: 20 20 20 7d 0a 20 20 20 20 61 64 64 72 20 3d 20 }. addr =
a840: 70 62 65 67 69 6e 3b 0a 20 20 7d 0a 20 20 69 66 pbegin;. }. if
a850: 28 20 70 62 65 67 69 6e 3e 69 4c 61 73 74 20 29 ( pbegin>iLast )
a860: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
a870: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
a880: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
a890: 70 62 65 67 69 6e 3e 61 64 64 72 20 7c 7c 20 70 pbegin>addr || p
a8a0: 62 65 67 69 6e 3d 3d 30 20 29 3b 0a 20 20 70 75 begin==0 );. pu
a8b0: 74 32 62 79 74 65 28 26 64 61 74 61 5b 61 64 64 t2byte(&data[add
a8c0: 72 5d 2c 20 73 74 61 72 74 29 3b 0a 20 20 70 75 r], start);. pu
a8d0: 74 32 62 79 74 65 28 26 64 61 74 61 5b 73 74 61 t2byte(&data[sta
a8e0: 72 74 5d 2c 20 70 62 65 67 69 6e 29 3b 0a 20 20 rt], pbegin);.
a8f0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 73 put2byte(&data[s
a900: 74 61 72 74 2b 32 5d 2c 20 73 69 7a 65 29 3b 0a tart+2], size);.
a910: 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d pPage->nFree =
a920: 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2b 20 pPage->nFree +
a930: 28 75 31 36 29 73 69 7a 65 3b 0a 0a 20 20 2f 2a (u16)size;.. /*
a940: 20 43 6f 61 6c 65 73 63 65 20 61 64 6a 61 63 65 Coalesce adjace
a950: 6e 74 20 66 72 65 65 20 62 6c 6f 63 6b 73 20 2a nt free blocks *
a960: 2f 0a 20 20 61 64 64 72 20 3d 20 68 64 72 20 2b /. addr = hdr +
a970: 20 31 3b 0a 20 20 77 68 69 6c 65 28 20 28 70 62 1;. while( (pb
a980: 65 67 69 6e 20 3d 20 67 65 74 32 62 79 74 65 28 egin = get2byte(
a990: 26 64 61 74 61 5b 61 64 64 72 5d 29 29 3e 30 20 &data[addr]))>0
a9a0: 29 7b 0a 20 20 20 20 69 6e 74 20 70 6e 65 78 74 ){. int pnext
a9b0: 2c 20 70 73 69 7a 65 2c 20 78 3b 0a 20 20 20 20 , psize, x;.
a9c0: 61 73 73 65 72 74 28 20 70 62 65 67 69 6e 3e 61 assert( pbegin>a
a9d0: 64 64 72 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ddr );. asser
a9e0: 74 28 20 70 62 65 67 69 6e 20 3c 3d 20 28 69 6e t( pbegin <= (in
a9f0: 74 29 70 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 t)pPage->pBt->us
aa00: 61 62 6c 65 53 69 7a 65 2d 34 20 29 3b 0a 20 20 ableSize-4 );.
aa10: 20 20 70 6e 65 78 74 20 3d 20 67 65 74 32 62 79 pnext = get2by
aa20: 74 65 28 26 64 61 74 61 5b 70 62 65 67 69 6e 5d te(&data[pbegin]
aa30: 29 3b 0a 20 20 20 20 70 73 69 7a 65 20 3d 20 67 );. psize = g
aa40: 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 62 et2byte(&data[pb
aa50: 65 67 69 6e 2b 32 5d 29 3b 0a 20 20 20 20 69 66 egin+2]);. if
aa60: 28 20 70 62 65 67 69 6e 20 2b 20 70 73 69 7a 65 ( pbegin + psize
aa70: 20 2b 20 33 20 3e 3d 20 70 6e 65 78 74 20 26 26 + 3 >= pnext &&
aa80: 20 70 6e 65 78 74 3e 30 20 29 7b 0a 20 20 20 20 pnext>0 ){.
aa90: 20 20 69 6e 74 20 66 72 61 67 20 3d 20 70 6e 65 int frag = pne
aaa0: 78 74 20 2d 20 28 70 62 65 67 69 6e 2b 70 73 69 xt - (pbegin+psi
aab0: 7a 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 28 ze);. if( (
aac0: 66 72 61 67 3c 30 29 20 7c 7c 20 28 66 72 61 67 frag<0) || (frag
aad0: 3e 28 69 6e 74 29 64 61 74 61 5b 68 64 72 2b 37 >(int)data[hdr+7
aae0: 5d 29 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 ]) ){. re
aaf0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
ab00: 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 UPT_BKPT;.
ab10: 7d 0a 20 20 20 20 20 20 64 61 74 61 5b 68 64 72 }. data[hdr
ab20: 2b 37 5d 20 2d 3d 20 28 75 38 29 66 72 61 67 3b +7] -= (u8)frag;
ab30: 0a 20 20 20 20 20 20 78 20 3d 20 67 65 74 32 62 . x = get2b
ab40: 79 74 65 28 26 64 61 74 61 5b 70 6e 65 78 74 5d yte(&data[pnext]
ab50: 29 3b 0a 20 20 20 20 20 20 70 75 74 32 62 79 74 );. put2byt
ab60: 65 28 26 64 61 74 61 5b 70 62 65 67 69 6e 5d 2c e(&data[pbegin],
ab70: 20 78 29 3b 0a 20 20 20 20 20 20 78 20 3d 20 70 x);. x = p
ab80: 6e 65 78 74 20 2b 20 67 65 74 32 62 79 74 65 28 next + get2byte(
ab90: 26 64 61 74 61 5b 70 6e 65 78 74 2b 32 5d 29 20 &data[pnext+2])
aba0: 2d 20 70 62 65 67 69 6e 3b 0a 20 20 20 20 20 20 - pbegin;.
abb0: 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b 70 put2byte(&data[p
abc0: 62 65 67 69 6e 2b 32 5d 2c 20 78 29 3b 0a 20 20 begin+2], x);.
abd0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 }else{. a
abe0: 64 64 72 20 3d 20 70 62 65 67 69 6e 3b 0a 20 20 ddr = pbegin;.
abf0: 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 }. }.. /* If
ac00: 20 74 68 65 20 63 65 6c 6c 20 63 6f 6e 74 65 6e the cell conten
ac10: 74 20 61 72 65 61 20 62 65 67 69 6e 73 20 77 69 t area begins wi
ac20: 74 68 20 61 20 66 72 65 65 62 6c 6f 63 6b 2c 20 th a freeblock,
ac30: 72 65 6d 6f 76 65 20 69 74 2e 20 2a 2f 0a 20 20 remove it. */.
ac40: 69 66 28 20 64 61 74 61 5b 68 64 72 2b 31 5d 3d if( data[hdr+1]=
ac50: 3d 64 61 74 61 5b 68 64 72 2b 35 5d 20 26 26 20 =data[hdr+5] &&
ac60: 64 61 74 61 5b 68 64 72 2b 32 5d 3d 3d 64 61 74 data[hdr+2]==dat
ac70: 61 5b 68 64 72 2b 36 5d 20 29 7b 0a 20 20 20 20 a[hdr+6] ){.
ac80: 69 6e 74 20 74 6f 70 3b 0a 20 20 20 20 70 62 65 int top;. pbe
ac90: 67 69 6e 20 3d 20 67 65 74 32 62 79 74 65 28 26 gin = get2byte(&
aca0: 64 61 74 61 5b 68 64 72 2b 31 5d 29 3b 0a 20 20 data[hdr+1]);.
acb0: 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b 68 memcpy(&data[h
acc0: 64 72 2b 31 5d 2c 20 26 64 61 74 61 5b 70 62 65 dr+1], &data[pbe
acd0: 67 69 6e 5d 2c 20 32 29 3b 0a 20 20 20 20 74 6f gin], 2);. to
ace0: 70 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 p = get2byte(&da
acf0: 74 61 5b 68 64 72 2b 35 5d 29 20 2b 20 67 65 74 ta[hdr+5]) + get
ad00: 32 62 79 74 65 28 26 64 61 74 61 5b 70 62 65 67 2byte(&data[pbeg
ad10: 69 6e 2b 32 5d 29 3b 0a 20 20 20 20 70 75 74 32 in+2]);. put2
ad20: 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 35 byte(&data[hdr+5
ad30: 5d 2c 20 74 6f 70 29 3b 0a 20 20 7d 0a 20 20 61 ], top);. }. a
ad40: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
ad50: 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
ad60: 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
ad70: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ;. return SQLIT
ad80: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 E_OK;.}../*.** D
ad90: 65 63 6f 64 65 20 74 68 65 20 66 6c 61 67 73 20 ecode the flags
ada0: 62 79 74 65 20 28 74 68 65 20 66 69 72 73 74 20 byte (the first
adb0: 62 79 74 65 20 6f 66 20 74 68 65 20 68 65 61 64 byte of the head
adc0: 65 72 29 20 66 6f 72 20 61 20 70 61 67 65 0a 2a er) for a page.*
add0: 2a 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 * and initialize
ade0: 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 4d fields of the M
adf0: 65 6d 50 61 67 65 20 73 74 72 75 63 74 75 72 65 emPage structure
ae00: 20 61 63 63 6f 72 64 69 6e 67 6c 79 2e 0a 2a 2a accordingly..**
ae10: 0a 2a 2a 20 4f 6e 6c 79 20 74 68 65 20 66 6f 6c .** Only the fol
ae20: 6c 6f 77 69 6e 67 20 63 6f 6d 62 69 6e 61 74 69 lowing combinati
ae30: 6f 6e 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 ons are supporte
ae40: 64 2e 20 20 41 6e 79 74 68 69 6e 67 20 64 69 66 d. Anything dif
ae50: 66 65 72 65 6e 74 0a 2a 2a 20 69 6e 64 69 63 61 ferent.** indica
ae60: 74 65 73 20 61 20 63 6f 72 72 75 70 74 20 64 61 tes a corrupt da
ae70: 74 61 62 61 73 65 20 66 69 6c 65 73 3a 0a 2a 2a tabase files:.**
ae80: 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 5f .** PTF_
ae90: 5a 45 52 4f 44 41 54 41 0a 2a 2a 20 20 20 20 20 ZERODATA.**
aea0: 20 20 20 20 50 54 46 5f 5a 45 52 4f 44 41 54 41 PTF_ZERODATA
aeb0: 20 7c 20 50 54 46 5f 4c 45 41 46 0a 2a 2a 20 20 | PTF_LEAF.**
aec0: 20 20 20 20 20 20 20 50 54 46 5f 4c 45 41 46 44 PTF_LEAFD
aed0: 41 54 41 20 7c 20 50 54 46 5f 49 4e 54 4b 45 59 ATA | PTF_INTKEY
aee0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 50 54 46 5f .** PTF_
aef0: 4c 45 41 46 44 41 54 41 20 7c 20 50 54 46 5f 49 LEAFDATA | PTF_I
af00: 4e 54 4b 45 59 20 7c 20 50 54 46 5f 4c 45 41 46 NTKEY | PTF_LEAF
af10: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 64 .*/.static int d
af20: 65 63 6f 64 65 46 6c 61 67 73 28 4d 65 6d 50 61 ecodeFlags(MemPa
af30: 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 ge *pPage, int f
af40: 6c 61 67 42 79 74 65 29 7b 0a 20 20 42 74 53 68 lagByte){. BtSh
af50: 61 72 65 64 20 2a 70 42 74 3b 20 20 20 20 20 2f ared *pBt; /
af60: 2a 20 41 20 63 6f 70 79 20 6f 66 20 70 50 61 67 * A copy of pPag
af70: 65 2d 3e 70 42 74 20 2a 2f 0a 0a 20 20 61 73 73 e->pBt */.. ass
af80: 65 72 74 28 20 70 50 61 67 65 2d 3e 68 64 72 4f ert( pPage->hdrO
af90: 66 66 73 65 74 3d 3d 28 70 50 61 67 65 2d 3e 70 ffset==(pPage->p
afa0: 67 6e 6f 3d 3d 31 20 3f 20 31 30 30 20 3a 20 30 gno==1 ? 100 : 0
afb0: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
afc0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
afd0: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
afe0: 74 65 78 29 20 29 3b 0a 20 20 70 50 61 67 65 2d tex) );. pPage-
aff0: 3e 6c 65 61 66 20 3d 20 28 75 38 29 28 66 6c 61 >leaf = (u8)(fla
b000: 67 42 79 74 65 3e 3e 33 29 3b 20 20 61 73 73 65 gByte>>3); asse
b010: 72 74 28 20 50 54 46 5f 4c 45 41 46 20 3d 3d 20 rt( PTF_LEAF ==
b020: 31 3c 3c 33 20 29 3b 0a 20 20 66 6c 61 67 42 79 1<<3 );. flagBy
b030: 74 65 20 26 3d 20 7e 50 54 46 5f 4c 45 41 46 3b te &= ~PTF_LEAF;
b040: 0a 20 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 . pPage->childP
b050: 74 72 53 69 7a 65 20 3d 20 34 2d 34 2a 70 50 61 trSize = 4-4*pPa
b060: 67 65 2d 3e 6c 65 61 66 3b 0a 20 20 70 42 74 20 ge->leaf;. pBt
b070: 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 = pPage->pBt;.
b080: 69 66 28 20 66 6c 61 67 42 79 74 65 3d 3d 28 50 if( flagByte==(P
b090: 54 46 5f 4c 45 41 46 44 41 54 41 20 7c 20 50 54 TF_LEAFDATA | PT
b0a0: 46 5f 49 4e 54 4b 45 59 29 20 29 7b 0a 20 20 20 F_INTKEY) ){.
b0b0: 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 3d pPage->intKey =
b0c0: 20 31 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 68 1;. pPage->h
b0d0: 61 73 44 61 74 61 20 3d 20 70 50 61 67 65 2d 3e asData = pPage->
b0e0: 6c 65 61 66 3b 0a 20 20 20 20 70 50 61 67 65 2d leaf;. pPage-
b0f0: 3e 6d 61 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d >maxLocal = pBt-
b100: 3e 6d 61 78 4c 65 61 66 3b 0a 20 20 20 20 70 50 >maxLeaf;. pP
b110: 61 67 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 age->minLocal =
b120: 70 42 74 2d 3e 6d 69 6e 4c 65 61 66 3b 0a 20 20 pBt->minLeaf;.
b130: 7d 65 6c 73 65 20 69 66 28 20 66 6c 61 67 42 79 }else if( flagBy
b140: 74 65 3d 3d 50 54 46 5f 5a 45 52 4f 44 41 54 41 te==PTF_ZERODATA
b150: 20 29 7b 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 ){. pPage->i
b160: 6e 74 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 70 ntKey = 0;. p
b170: 50 61 67 65 2d 3e 68 61 73 44 61 74 61 20 3d 20 Page->hasData =
b180: 30 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 6d 61 0;. pPage->ma
b190: 78 4c 6f 63 61 6c 20 3d 20 70 42 74 2d 3e 6d 61 xLocal = pBt->ma
b1a0: 78 4c 6f 63 61 6c 3b 0a 20 20 20 20 70 50 61 67 xLocal;. pPag
b1b0: 65 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 70 42 e->minLocal = pB
b1c0: 74 2d 3e 6d 69 6e 4c 6f 63 61 6c 3b 0a 20 20 7d t->minLocal;. }
b1d0: 65 6c 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e else{. return
b1e0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
b1f0: 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 70 50 61 67 BKPT;. }. pPag
b200: 65 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f e->max1bytePaylo
b210: 61 64 20 3d 20 70 42 74 2d 3e 6d 61 78 31 62 79 ad = pBt->max1by
b220: 74 65 50 61 79 6c 6f 61 64 3b 0a 20 20 72 65 74 tePayload;. ret
b230: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
b240: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 ../*.** Initiali
b250: 7a 65 20 74 68 65 20 61 75 78 69 6c 69 61 72 79 ze the auxiliary
b260: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 6f 72 information for
b270: 20 61 20 64 69 73 6b 20 62 6c 6f 63 6b 2e 0a 2a a disk block..*
b280: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 *.** Return SQLI
b290: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 TE_OK on success
b2a0: 2e 20 20 49 66 20 77 65 20 73 65 65 20 74 68 61 . If we see tha
b2b0: 74 20 74 68 65 20 70 61 67 65 20 64 6f 65 73 0a t the page does.
b2c0: 2a 2a 20 6e 6f 74 20 63 6f 6e 74 61 69 6e 20 61 ** not contain a
b2d0: 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 well-formed dat
b2e0: 61 62 61 73 65 20 70 61 67 65 2c 20 74 68 65 6e abase page, then
b2f0: 20 72 65 74 75 72 6e 20 0a 2a 2a 20 53 51 4c 49 return .** SQLI
b300: 54 45 5f 43 4f 52 52 55 50 54 2e 20 20 4e 6f 74 TE_CORRUPT. Not
b310: 65 20 74 68 61 74 20 61 20 72 65 74 75 72 6e 20 e that a return
b320: 6f 66 20 53 51 4c 49 54 45 5f 4f 4b 20 64 6f 65 of SQLITE_OK doe
b330: 73 20 6e 6f 74 0a 2a 2a 20 67 75 61 72 61 6e 74 s not.** guarant
b340: 65 65 20 74 68 61 74 20 74 68 65 20 70 61 67 65 ee that the page
b350: 20 69 73 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 2e is well-formed.
b360: 20 20 49 74 20 6f 6e 6c 79 20 73 68 6f 77 73 20 It only shows
b370: 74 68 61 74 0a 2a 2a 20 77 65 20 66 61 69 6c 65 that.** we faile
b380: 64 20 74 6f 20 64 65 74 65 63 74 20 61 6e 79 20 d to detect any
b390: 63 6f 72 72 75 70 74 69 6f 6e 2e 0a 2a 2f 0a 73 corruption..*/.s
b3a0: 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 65 49 tatic int btreeI
b3b0: 6e 69 74 50 61 67 65 28 4d 65 6d 50 61 67 65 20 nitPage(MemPage
b3c0: 2a 70 50 61 67 65 29 7b 0a 0a 20 20 61 73 73 65 *pPage){.. asse
b3d0: 72 74 28 20 70 50 61 67 65 2d 3e 70 42 74 21 3d rt( pPage->pBt!=
b3e0: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 0 );. assert( s
b3f0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
b400: 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
b410: 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
b420: 28 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 73 ( pPage->pgno==s
b430: 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 6e qlite3PagerPagen
b440: 75 6d 62 65 72 28 70 50 61 67 65 2d 3e 70 44 62 umber(pPage->pDb
b450: 50 61 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 Page) );. asser
b460: 74 28 20 70 50 61 67 65 20 3d 3d 20 73 71 6c 69 t( pPage == sqli
b470: 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 61 te3PagerGetExtra
b480: 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
b490: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
b4a0: 61 67 65 2d 3e 61 44 61 74 61 20 3d 3d 20 73 71 age->aData == sq
b4b0: 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61 74 lite3PagerGetDat
b4c0: 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 a(pPage->pDbPage
b4d0: 29 20 29 3b 0a 0a 20 20 69 66 28 20 21 70 50 61 ) );.. if( !pPa
b4e0: 67 65 2d 3e 69 73 49 6e 69 74 20 29 7b 0a 20 20 ge->isInit ){.
b4f0: 20 20 75 31 36 20 70 63 3b 20 20 20 20 20 20 20 u16 pc;
b500: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
b510: 6f 66 20 61 20 66 72 65 65 62 6c 6f 63 6b 20 77 of a freeblock w
b520: 69 74 68 69 6e 20 70 50 61 67 65 2d 3e 61 44 61 ithin pPage->aDa
b530: 74 61 5b 5d 20 2a 2f 0a 20 20 20 20 75 38 20 68 ta[] */. u8 h
b540: 64 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f dr; /
b550: 2a 20 4f 66 66 73 65 74 20 74 6f 20 62 65 67 69 * Offset to begi
b560: 6e 6e 69 6e 67 20 6f 66 20 70 61 67 65 20 68 65 nning of page he
b570: 61 64 65 72 20 2a 2f 0a 20 20 20 20 75 38 20 2a ader */. u8 *
b580: 64 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 2f data; /
b590: 2a 20 45 71 75 61 6c 20 74 6f 20 70 50 61 67 65 * Equal to pPage
b5a0: 2d 3e 61 44 61 74 61 20 2a 2f 0a 20 20 20 20 42 ->aData */. B
b5b0: 74 53 68 61 72 65 64 20 2a 70 42 74 3b 20 20 20 tShared *pBt;
b5c0: 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 69 6e /* The main
b5d0: 20 62 74 72 65 65 20 73 74 72 75 63 74 75 72 65 btree structure
b5e0: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 75 73 61 62 */. int usab
b5f0: 6c 65 53 69 7a 65 3b 20 20 20 20 2f 2a 20 41 6d leSize; /* Am
b600: 6f 75 6e 74 20 6f 66 20 75 73 61 62 6c 65 20 73 ount of usable s
b610: 70 61 63 65 20 6f 6e 20 65 61 63 68 20 70 61 67 pace on each pag
b620: 65 20 2a 2f 0a 20 20 20 20 75 31 36 20 63 65 6c e */. u16 cel
b630: 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4f lOffset; /* O
b640: 66 66 73 65 74 20 66 72 6f 6d 20 73 74 61 72 74 ffset from start
b650: 20 6f 66 20 70 61 67 65 20 74 6f 20 66 69 72 73 of page to firs
b660: 74 20 63 65 6c 6c 20 70 6f 69 6e 74 65 72 20 2a t cell pointer *
b670: 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72 65 65 3b /. int nFree;
b680: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
b690: 65 72 20 6f 66 20 75 6e 75 73 65 64 20 62 79 74 er of unused byt
b6a0: 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a es on the page *
b6b0: 2f 0a 20 20 20 20 69 6e 74 20 74 6f 70 3b 20 20 /. int top;
b6c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
b6d0: 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 63 65 t byte of the ce
b6e0: 6c 6c 20 63 6f 6e 74 65 6e 74 20 61 72 65 61 20 ll content area
b6f0: 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 65 6c 6c */. int iCell
b700: 46 69 72 73 74 3b 20 20 20 20 2f 2a 20 46 69 72 First; /* Fir
b710: 73 74 20 61 6c 6c 6f 77 61 62 6c 65 20 63 65 6c st allowable cel
b720: 6c 20 6f 72 20 66 72 65 65 62 6c 6f 63 6b 20 6f l or freeblock o
b730: 66 66 73 65 74 20 2a 2f 0a 20 20 20 20 69 6e 74 ffset */. int
b740: 20 69 43 65 6c 6c 4c 61 73 74 3b 20 20 20 20 20 iCellLast;
b750: 2f 2a 20 4c 61 73 74 20 70 6f 73 73 69 62 6c 65 /* Last possible
b760: 20 63 65 6c 6c 20 6f 72 20 66 72 65 65 62 6c 6f cell or freeblo
b770: 63 6b 20 6f 66 66 73 65 74 20 2a 2f 0a 0a 20 20 ck offset */..
b780: 20 20 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 pBt = pPage->p
b790: 42 74 3b 0a 0a 20 20 20 20 68 64 72 20 3d 20 70 Bt;.. hdr = p
b7a0: 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b Page->hdrOffset;
b7b0: 0a 20 20 20 20 64 61 74 61 20 3d 20 70 50 61 67 . data = pPag
b7c0: 65 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 69 66 e->aData;. if
b7d0: 28 20 64 65 63 6f 64 65 46 6c 61 67 73 28 70 50 ( decodeFlags(pP
b7e0: 61 67 65 2c 20 64 61 74 61 5b 68 64 72 5d 29 20 age, data[hdr])
b7f0: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
b800: 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 CORRUPT_BKPT;.
b810: 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 assert( pBt->p
b820: 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 ageSize>=512 &&
b830: 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3c 3d 36 pBt->pageSize<=6
b840: 35 35 33 36 20 29 3b 0a 20 20 20 20 70 50 61 67 5536 );. pPag
b850: 65 2d 3e 6d 61 73 6b 50 61 67 65 20 3d 20 28 75 e->maskPage = (u
b860: 31 36 29 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 16)(pBt->pageSiz
b870: 65 20 2d 20 31 29 3b 0a 20 20 20 20 70 50 61 67 e - 1);. pPag
b880: 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d 20 30 e->nOverflow = 0
b890: 3b 0a 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 ;. usableSize
b8a0: 20 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 = pBt->usableSi
b8b0: 7a 65 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 63 ze;. pPage->c
b8c0: 65 6c 6c 4f 66 66 73 65 74 20 3d 20 63 65 6c 6c ellOffset = cell
b8d0: 4f 66 66 73 65 74 20 3d 20 68 64 72 20 2b 20 31 Offset = hdr + 1
b8e0: 32 20 2d 20 34 2a 70 50 61 67 65 2d 3e 6c 65 61 2 - 4*pPage->lea
b8f0: 66 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 44 f;. pPage->aD
b900: 61 74 61 45 6e 64 20 3d 20 26 64 61 74 61 5b 75 ataEnd = &data[u
b910: 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 20 20 sableSize];.
b920: 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 20 pPage->aCellIdx
b930: 3d 20 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 = &data[cellOffs
b940: 65 74 5d 3b 0a 20 20 20 20 74 6f 70 20 3d 20 67 et];. top = g
b950: 65 74 32 62 79 74 65 4e 6f 74 5a 65 72 6f 28 26 et2byteNotZero(&
b960: 64 61 74 61 5b 68 64 72 2b 35 5d 29 3b 0a 20 20 data[hdr+5]);.
b970: 20 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 3d pPage->nCell =
b980: 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b get2byte(&data[
b990: 68 64 72 2b 33 5d 29 3b 0a 20 20 20 20 69 66 28 hdr+3]);. if(
b9a0: 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 4d 58 pPage->nCell>MX
b9b0: 5f 43 45 4c 4c 28 70 42 74 29 20 29 7b 0a 20 20 _CELL(pBt) ){.
b9c0: 20 20 20 20 2f 2a 20 54 6f 20 6d 61 6e 79 20 63 /* To many c
b9d0: 65 6c 6c 73 20 66 6f 72 20 61 20 73 69 6e 67 6c ells for a singl
b9e0: 65 20 70 61 67 65 2e 20 20 54 68 65 20 70 61 67 e page. The pag
b9f0: 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 e must be corrup
ba00: 74 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 t */. retur
ba10: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
ba20: 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 _BKPT;. }.
ba30: 20 74 65 73 74 63 61 73 65 28 20 70 50 61 67 65 testcase( pPage
ba40: 2d 3e 6e 43 65 6c 6c 3d 3d 4d 58 5f 43 45 4c 4c ->nCell==MX_CELL
ba50: 28 70 42 74 29 20 29 3b 0a 0a 20 20 20 20 2f 2a (pBt) );.. /*
ba60: 20 41 20 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 A malformed dat
ba70: 61 62 61 73 65 20 70 61 67 65 20 6d 69 67 68 74 abase page might
ba80: 20 63 61 75 73 65 20 75 73 20 74 6f 20 72 65 61 cause us to rea
ba90: 64 20 70 61 73 74 20 74 68 65 20 65 6e 64 0a 20 d past the end.
baa0: 20 20 20 2a 2a 20 6f 66 20 70 61 67 65 20 77 68 ** of page wh
bab0: 65 6e 20 70 61 72 73 69 6e 67 20 61 20 63 65 6c en parsing a cel
bac0: 6c 2e 20 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 l. . **.
bad0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
bae0: 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 63 block of code c
baf0: 68 65 63 6b 73 20 65 61 72 6c 79 20 74 6f 20 73 hecks early to s
bb00: 65 65 20 69 66 20 61 20 63 65 6c 6c 20 65 78 74 ee if a cell ext
bb10: 65 6e 64 73 0a 20 20 20 20 2a 2a 20 70 61 73 74 ends. ** past
bb20: 20 74 68 65 20 65 6e 64 20 6f 66 20 61 20 70 61 the end of a pa
bb30: 67 65 20 62 6f 75 6e 64 61 72 79 20 61 6e 64 20 ge boundary and
bb40: 63 61 75 73 65 73 20 53 51 4c 49 54 45 5f 43 4f causes SQLITE_CO
bb50: 52 52 55 50 54 20 74 6f 20 62 65 20 0a 20 20 20 RRUPT to be .
bb60: 20 2a 2a 20 72 65 74 75 72 6e 65 64 20 69 66 20 ** returned if
bb70: 69 74 20 64 6f 65 73 2e 0a 20 20 20 20 2a 2f 0a it does.. */.
bb80: 20 20 20 20 69 43 65 6c 6c 46 69 72 73 74 20 3d iCellFirst =
bb90: 20 63 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a cellOffset + 2*
bba0: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 pPage->nCell;.
bbb0: 20 20 69 43 65 6c 6c 4c 61 73 74 20 3d 20 75 73 iCellLast = us
bbc0: 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 23 69 ableSize - 4;.#i
bbd0: 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
bbe0: 5f 45 4e 41 42 4c 45 5f 4f 56 45 52 53 49 5a 45 _ENABLE_OVERSIZE
bbf0: 5f 43 45 4c 4c 5f 43 48 45 43 4b 29 0a 20 20 20 _CELL_CHECK).
bc00: 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 20 {. int i;
bc10: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
bc20: 64 65 78 20 69 6e 74 6f 20 74 68 65 20 63 65 6c dex into the cel
bc30: 6c 20 70 6f 69 6e 74 65 72 20 61 72 72 61 79 20 l pointer array
bc40: 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 73 7a 3b */. int sz;
bc50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
bc60: 7a 65 20 6f 66 20 61 20 63 65 6c 6c 20 2a 2f 0a ze of a cell */.
bc70: 0a 20 20 20 20 20 20 69 66 28 20 21 70 50 61 67 . if( !pPag
bc80: 65 2d 3e 6c 65 61 66 20 29 20 69 43 65 6c 6c 4c e->leaf ) iCellL
bc90: 61 73 74 2d 2d 3b 0a 20 20 20 20 20 20 66 6f 72 ast--;. for
bca0: 28 69 3d 30 3b 20 69 3c 70 50 61 67 65 2d 3e 6e (i=0; i<pPage->n
bcb0: 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 Cell; i++){.
bcc0: 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 79 74 pc = get2byt
bcd0: 65 28 26 64 61 74 61 5b 63 65 6c 6c 4f 66 66 73 e(&data[cellOffs
bce0: 65 74 2b 69 2a 32 5d 29 3b 0a 20 20 20 20 20 20 et+i*2]);.
bcf0: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
bd00: 69 43 65 6c 6c 46 69 72 73 74 20 29 3b 0a 20 20 iCellFirst );.
bd10: 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
bd20: 70 63 3d 3d 69 43 65 6c 6c 4c 61 73 74 20 29 3b pc==iCellLast );
bd30: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 63 3c . if( pc<
bd40: 69 43 65 6c 6c 46 69 72 73 74 20 7c 7c 20 70 63 iCellFirst || pc
bd50: 3e 69 43 65 6c 6c 4c 61 73 74 20 29 7b 0a 20 20 >iCellLast ){.
bd60: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 return S
bd70: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
bd80: 50 54 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 PT;. }.
bd90: 20 20 20 20 20 20 73 7a 20 3d 20 63 65 6c 6c 53 sz = cellS
bda0: 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 26 64 izePtr(pPage, &d
bdb0: 61 74 61 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 ata[pc]);.
bdc0: 20 20 74 65 73 74 63 61 73 65 28 20 70 63 2b 73 testcase( pc+s
bdd0: 7a 3d 3d 75 73 61 62 6c 65 53 69 7a 65 20 29 3b z==usableSize );
bde0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 63 2b . if( pc+
bdf0: 73 7a 3e 75 73 61 62 6c 65 53 69 7a 65 20 29 7b sz>usableSize ){
be00: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 . retur
be10: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
be20: 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 7d _BKPT;. }
be30: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
be40: 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 f( !pPage->leaf
be50: 29 20 69 43 65 6c 6c 4c 61 73 74 2b 2b 3b 0a 20 ) iCellLast++;.
be60: 20 20 20 7d 20 20 0a 23 65 6e 64 69 66 0a 0a 20 } .#endif..
be70: 20 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 74 68 /* Compute th
be80: 65 20 74 6f 74 61 6c 20 66 72 65 65 20 73 70 61 e total free spa
be90: 63 65 20 6f 6e 20 74 68 65 20 70 61 67 65 20 2a ce on the page *
bea0: 2f 0a 20 20 20 20 70 63 20 3d 20 67 65 74 32 62 /. pc = get2b
beb0: 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 31 5d yte(&data[hdr+1]
bec0: 29 3b 0a 20 20 20 20 6e 46 72 65 65 20 3d 20 64 );. nFree = d
bed0: 61 74 61 5b 68 64 72 2b 37 5d 20 2b 20 74 6f 70 ata[hdr+7] + top
bee0: 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 63 3e ;. while( pc>
bef0: 30 20 29 7b 0a 20 20 20 20 20 20 75 31 36 20 6e 0 ){. u16 n
bf00: 65 78 74 2c 20 73 69 7a 65 3b 0a 20 20 20 20 20 ext, size;.
bf10: 20 69 66 28 20 70 63 3c 69 43 65 6c 6c 46 69 72 if( pc<iCellFir
bf20: 73 74 20 7c 7c 20 70 63 3e 69 43 65 6c 6c 4c 61 st || pc>iCellLa
bf30: 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a st ){. /*
bf40: 20 53 74 61 72 74 20 6f 66 20 66 72 65 65 20 62 Start of free b
bf50: 6c 6f 63 6b 20 69 73 20 6f 66 66 20 74 68 65 20 lock is off the
bf60: 70 61 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 page */.
bf70: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
bf80: 52 52 55 50 54 5f 42 4b 50 54 3b 20 0a 20 20 20 RRUPT_BKPT; .
bf90: 20 20 20 7d 0a 20 20 20 20 20 20 6e 65 78 74 20 }. next
bfa0: 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 74 61 = get2byte(&data
bfb0: 5b 70 63 5d 29 3b 0a 20 20 20 20 20 20 73 69 7a [pc]);. siz
bfc0: 65 20 3d 20 67 65 74 32 62 79 74 65 28 26 64 61 e = get2byte(&da
bfd0: 74 61 5b 70 63 2b 32 5d 29 3b 0a 20 20 20 20 20 ta[pc+2]);.
bfe0: 20 69 66 28 20 28 6e 65 78 74 3e 30 20 26 26 20 if( (next>0 &&
bff0: 6e 65 78 74 3c 3d 70 63 2b 73 69 7a 65 2b 33 29 next<=pc+size+3)
c000: 20 7c 7c 20 70 63 2b 73 69 7a 65 3e 75 73 61 62 || pc+size>usab
c010: 6c 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 leSize ){.
c020: 20 20 2f 2a 20 46 72 65 65 20 62 6c 6f 63 6b 73 /* Free blocks
c030: 20 6d 75 73 74 20 62 65 20 69 6e 20 61 73 63 65 must be in asce
c040: 6e 64 69 6e 67 20 6f 72 64 65 72 2e 20 41 6e 64 nding order. And
c050: 20 74 68 65 20 6c 61 73 74 20 62 79 74 65 20 6f the last byte o
c060: 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 f. ** the
c070: 20 66 72 65 65 2d 62 6c 6f 63 6b 20 6d 75 73 74 free-block must
c080: 20 6c 69 65 20 6f 6e 20 74 68 65 20 64 61 74 61 lie on the data
c090: 62 61 73 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 base page. */.
c0a0: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
c0b0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
c0c0: 54 3b 20 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 T; . }.
c0d0: 20 20 6e 46 72 65 65 20 3d 20 6e 46 72 65 65 20 nFree = nFree
c0e0: 2b 20 73 69 7a 65 3b 0a 20 20 20 20 20 20 70 63 + size;. pc
c0f0: 20 3d 20 6e 65 78 74 3b 0a 20 20 20 20 7d 0a 0a = next;. }..
c100: 20 20 20 20 2f 2a 20 41 74 20 74 68 69 73 20 70 /* At this p
c110: 6f 69 6e 74 2c 20 6e 46 72 65 65 20 63 6f 6e 74 oint, nFree cont
c120: 61 69 6e 73 20 74 68 65 20 73 75 6d 20 6f 66 20 ains the sum of
c130: 74 68 65 20 6f 66 66 73 65 74 20 74 6f 20 74 68 the offset to th
c140: 65 20 73 74 61 72 74 0a 20 20 20 20 2a 2a 20 6f e start. ** o
c150: 66 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 65 f the cell-conte
c160: 6e 74 20 61 72 65 61 20 70 6c 75 73 20 74 68 65 nt area plus the
c170: 20 6e 75 6d 62 65 72 20 6f 66 20 66 72 65 65 20 number of free
c180: 62 79 74 65 73 20 77 69 74 68 69 6e 0a 20 20 20 bytes within.
c190: 20 2a 2a 20 74 68 65 20 63 65 6c 6c 2d 63 6f 6e ** the cell-con
c1a0: 74 65 6e 74 20 61 72 65 61 2e 20 49 66 20 74 68 tent area. If th
c1b0: 69 73 20 69 73 20 67 72 65 61 74 65 72 20 74 68 is is greater th
c1c0: 61 6e 20 74 68 65 20 75 73 61 62 6c 65 2d 73 69 an the usable-si
c1d0: 7a 65 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 ze. ** of the
c1e0: 20 70 61 67 65 2c 20 74 68 65 6e 20 74 68 65 20 page, then the
c1f0: 70 61 67 65 20 6d 75 73 74 20 62 65 20 63 6f 72 page must be cor
c200: 72 75 70 74 65 64 2e 20 54 68 69 73 20 63 68 65 rupted. This che
c210: 63 6b 20 61 6c 73 6f 0a 20 20 20 20 2a 2a 20 73 ck also. ** s
c220: 65 72 76 65 73 20 74 6f 20 76 65 72 69 66 79 20 erves to verify
c230: 74 68 61 74 20 74 68 65 20 6f 66 66 73 65 74 20 that the offset
c240: 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 to the start of
c250: 74 68 65 20 63 65 6c 6c 2d 63 6f 6e 74 65 6e 74 the cell-content
c260: 0a 20 20 20 20 2a 2a 20 61 72 65 61 2c 20 61 63 . ** area, ac
c270: 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 20 70 cording to the p
c280: 61 67 65 20 68 65 61 64 65 72 2c 20 6c 69 65 73 age header, lies
c290: 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67 65 within the page
c2a0: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
c2b0: 20 6e 46 72 65 65 3e 75 73 61 62 6c 65 53 69 7a nFree>usableSiz
c2c0: 65 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 e ){. retur
c2d0: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
c2e0: 5f 42 4b 50 54 3b 20 0a 20 20 20 20 7d 0a 20 20 _BKPT; . }.
c2f0: 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d pPage->nFree =
c300: 20 28 75 31 36 29 28 6e 46 72 65 65 20 2d 20 69 (u16)(nFree - i
c310: 43 65 6c 6c 46 69 72 73 74 29 3b 0a 20 20 20 20 CellFirst);.
c320: 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 pPage->isInit =
c330: 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 1;. }. return
c340: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
c350: 0a 2a 2a 20 53 65 74 20 75 70 20 61 20 72 61 77 .** Set up a raw
c360: 20 70 61 67 65 20 73 6f 20 74 68 61 74 20 69 74 page so that it
c370: 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 61 20 64 61 looks like a da
c380: 74 61 62 61 73 65 20 70 61 67 65 20 68 6f 6c 64 tabase page hold
c390: 69 6e 67 0a 2a 2a 20 6e 6f 20 65 6e 74 72 69 65 ing.** no entrie
c3a0: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 s..*/.static voi
c3b0: 64 20 7a 65 72 6f 50 61 67 65 28 4d 65 6d 50 61 d zeroPage(MemPa
c3c0: 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 66 ge *pPage, int f
c3d0: 6c 61 67 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 lags){. unsigne
c3e0: 64 20 63 68 61 72 20 2a 64 61 74 61 20 3d 20 70 d char *data = p
c3f0: 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 20 42 Page->aData;. B
c400: 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
c410: 50 61 67 65 2d 3e 70 42 74 3b 0a 20 20 75 38 20 Page->pBt;. u8
c420: 68 64 72 20 3d 20 70 50 61 67 65 2d 3e 68 64 72 hdr = pPage->hdr
c430: 4f 66 66 73 65 74 3b 0a 20 20 75 31 36 20 66 69 Offset;. u16 fi
c440: 72 73 74 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 rst;.. assert(
c450: 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 65 sqlite3PagerPage
c460: 6e 75 6d 62 65 72 28 70 50 61 67 65 2d 3e 70 44 number(pPage->pD
c470: 62 50 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 70 bPage)==pPage->p
c480: 67 6e 6f 20 29 3b 0a 20 20 61 73 73 65 72 74 28 gno );. assert(
c490: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
c4a0: 45 78 74 72 61 28 70 50 61 67 65 2d 3e 70 44 62 Extra(pPage->pDb
c4b0: 50 61 67 65 29 20 3d 3d 20 28 76 6f 69 64 2a 29 Page) == (void*)
c4c0: 70 50 61 67 65 20 29 3b 0a 20 20 61 73 73 65 72 pPage );. asser
c4d0: 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 t( sqlite3PagerG
c4e0: 65 74 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 etData(pPage->pD
c4f0: 62 50 61 67 65 29 20 3d 3d 20 64 61 74 61 20 29 bPage) == data )
c500: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
c510: 74 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 te3PagerIswritea
c520: 62 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ble(pPage->pDbPa
c530: 67 65 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge) );. assert(
c540: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
c550: 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
c560: 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 62 74 );. if( pBt->bt
c570: 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 45 43 sFlags & BTS_SEC
c580: 55 52 45 5f 44 45 4c 45 54 45 20 29 7b 0a 20 20 URE_DELETE ){.
c590: 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b 68 memset(&data[h
c5a0: 64 72 5d 2c 20 30 2c 20 70 42 74 2d 3e 75 73 61 dr], 0, pBt->usa
c5b0: 62 6c 65 53 69 7a 65 20 2d 20 68 64 72 29 3b 0a bleSize - hdr);.
c5c0: 20 20 7d 0a 20 20 64 61 74 61 5b 68 64 72 5d 20 }. data[hdr]
c5d0: 3d 20 28 63 68 61 72 29 66 6c 61 67 73 3b 0a 20 = (char)flags;.
c5e0: 20 66 69 72 73 74 20 3d 20 68 64 72 20 2b 20 38 first = hdr + 8
c5f0: 20 2b 20 34 2a 28 28 66 6c 61 67 73 26 50 54 46 + 4*((flags&PTF
c600: 5f 4c 45 41 46 29 3d 3d 30 20 3f 31 3a 30 29 3b _LEAF)==0 ?1:0);
c610: 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b . memset(&data[
c620: 68 64 72 2b 31 5d 2c 20 30 2c 20 34 29 3b 0a 20 hdr+1], 0, 4);.
c630: 20 64 61 74 61 5b 68 64 72 2b 37 5d 20 3d 20 30 data[hdr+7] = 0
c640: 3b 0a 20 20 70 75 74 32 62 79 74 65 28 26 64 61 ;. put2byte(&da
c650: 74 61 5b 68 64 72 2b 35 5d 2c 20 70 42 74 2d 3e ta[hdr+5], pBt->
c660: 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 70 usableSize);. p
c670: 50 61 67 65 2d 3e 6e 46 72 65 65 20 3d 20 28 75 Page->nFree = (u
c680: 31 36 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 16)(pBt->usableS
c690: 69 7a 65 20 2d 20 66 69 72 73 74 29 3b 0a 20 20 ize - first);.
c6a0: 64 65 63 6f 64 65 46 6c 61 67 73 28 70 50 61 67 decodeFlags(pPag
c6b0: 65 2c 20 66 6c 61 67 73 29 3b 0a 20 20 70 50 61 e, flags);. pPa
c6c0: 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 ge->hdrOffset =
c6d0: 68 64 72 3b 0a 20 20 70 50 61 67 65 2d 3e 63 65 hdr;. pPage->ce
c6e0: 6c 6c 4f 66 66 73 65 74 20 3d 20 66 69 72 73 74 llOffset = first
c6f0: 3b 0a 20 20 70 50 61 67 65 2d 3e 61 44 61 74 61 ;. pPage->aData
c700: 45 6e 64 20 3d 20 26 64 61 74 61 5b 70 42 74 2d End = &data[pBt-
c710: 3e 75 73 61 62 6c 65 53 69 7a 65 5d 3b 0a 20 20 >usableSize];.
c720: 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 78 20 pPage->aCellIdx
c730: 3d 20 26 64 61 74 61 5b 66 69 72 73 74 5d 3b 0a = &data[first];.
c740: 20 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 66 6c pPage->nOverfl
c750: 6f 77 20 3d 20 30 3b 0a 20 20 61 73 73 65 72 74 ow = 0;. assert
c760: 28 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e ( pBt->pageSize>
c770: 3d 35 31 32 20 26 26 20 70 42 74 2d 3e 70 61 67 =512 && pBt->pag
c780: 65 53 69 7a 65 3c 3d 36 35 35 33 36 20 29 3b 0a eSize<=65536 );.
c790: 20 20 70 50 61 67 65 2d 3e 6d 61 73 6b 50 61 67 pPage->maskPag
c7a0: 65 20 3d 20 28 75 31 36 29 28 70 42 74 2d 3e 70 e = (u16)(pBt->p
c7b0: 61 67 65 53 69 7a 65 20 2d 20 31 29 3b 0a 20 20 ageSize - 1);.
c7c0: 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 3d 20 30 pPage->nCell = 0
c7d0: 3b 0a 20 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 ;. pPage->isIni
c7e0: 74 20 3d 20 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a t = 1;.}.../*.**
c7f0: 20 43 6f 6e 76 65 72 74 20 61 20 44 62 50 61 67 Convert a DbPag
c800: 65 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 e obtained from
c810: 74 68 65 20 70 61 67 65 72 20 69 6e 74 6f 20 61 the pager into a
c820: 20 4d 65 6d 50 61 67 65 20 75 73 65 64 20 62 79 MemPage used by
c830: 0a 2a 2a 20 74 68 65 20 62 74 72 65 65 20 6c 61 .** the btree la
c840: 79 65 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4d yer..*/.static M
c850: 65 6d 50 61 67 65 20 2a 62 74 72 65 65 50 61 67 emPage *btreePag
c860: 65 46 72 6f 6d 44 62 50 61 67 65 28 44 62 50 61 eFromDbPage(DbPa
c870: 67 65 20 2a 70 44 62 50 61 67 65 2c 20 50 67 6e ge *pDbPage, Pgn
c880: 6f 20 70 67 6e 6f 2c 20 42 74 53 68 61 72 65 64 o pgno, BtShared
c890: 20 2a 70 42 74 29 7b 0a 20 20 4d 65 6d 50 61 67 *pBt){. MemPag
c8a0: 65 20 2a 70 50 61 67 65 20 3d 20 28 4d 65 6d 50 e *pPage = (MemP
c8b0: 61 67 65 2a 29 73 71 6c 69 74 65 33 50 61 67 65 age*)sqlite3Page
c8c0: 72 47 65 74 45 78 74 72 61 28 70 44 62 50 61 67 rGetExtra(pDbPag
c8d0: 65 29 3b 0a 20 20 70 50 61 67 65 2d 3e 61 44 61 e);. pPage->aDa
c8e0: 74 61 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 ta = sqlite3Page
c8f0: 72 47 65 74 44 61 74 61 28 70 44 62 50 61 67 65 rGetData(pDbPage
c900: 29 3b 0a 20 20 70 50 61 67 65 2d 3e 70 44 62 50 );. pPage->pDbP
c910: 61 67 65 20 3d 20 70 44 62 50 61 67 65 3b 0a 20 age = pDbPage;.
c920: 20 70 50 61 67 65 2d 3e 70 42 74 20 3d 20 70 42 pPage->pBt = pB
c930: 74 3b 0a 20 20 70 50 61 67 65 2d 3e 70 67 6e 6f t;. pPage->pgno
c940: 20 3d 20 70 67 6e 6f 3b 0a 20 20 70 50 61 67 65 = pgno;. pPage
c950: 2d 3e 68 64 72 4f 66 66 73 65 74 20 3d 20 70 50 ->hdrOffset = pP
c960: 61 67 65 2d 3e 70 67 6e 6f 3d 3d 31 20 3f 20 31 age->pgno==1 ? 1
c970: 30 30 20 3a 20 30 3b 0a 20 20 72 65 74 75 72 6e 00 : 0;. return
c980: 20 70 50 61 67 65 3b 20 0a 7d 0a 0a 2f 2a 0a 2a pPage; .}../*.*
c990: 2a 20 47 65 74 20 61 20 70 61 67 65 20 66 72 6f * Get a page fro
c9a0: 6d 20 74 68 65 20 70 61 67 65 72 2e 20 20 49 6e m the pager. In
c9b0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 4d 65 6d itialize the Mem
c9c0: 50 61 67 65 2e 70 42 74 20 61 6e 64 0a 2a 2a 20 Page.pBt and.**
c9d0: 4d 65 6d 50 61 67 65 2e 61 44 61 74 61 20 65 6c MemPage.aData el
c9e0: 65 6d 65 6e 74 73 20 69 66 20 6e 65 65 64 65 64 ements if needed
c9f0: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6e ..**.** If the n
ca00: 6f 43 6f 6e 74 65 6e 74 20 66 6c 61 67 20 69 73 oContent flag is
ca10: 20 73 65 74 2c 20 69 74 20 6d 65 61 6e 73 20 74 set, it means t
ca20: 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 hat we do not ca
ca30: 72 65 20 61 62 6f 75 74 0a 2a 2a 20 74 68 65 20 re about.** the
ca40: 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
ca50: 61 67 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 age at this time
ca60: 2e 20 20 53 6f 20 64 6f 20 6e 6f 74 20 67 6f 20 . So do not go
ca70: 74 6f 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 74 to the disk.** t
ca80: 6f 20 66 65 74 63 68 20 74 68 65 20 63 6f 6e 74 o fetch the cont
ca90: 65 6e 74 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 ent. Just fill
caa0: 69 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 in the content w
cab0: 69 74 68 20 7a 65 72 6f 73 20 66 6f 72 20 6e 6f ith zeros for no
cac0: 77 2e 0a 2a 2a 20 49 66 20 69 6e 20 74 68 65 20 w..** If in the
cad0: 66 75 74 75 72 65 20 77 65 20 63 61 6c 6c 20 73 future we call s
cae0: 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
caf0: 28 29 20 6f 6e 20 74 68 69 73 20 70 61 67 65 2c () on this page,
cb00: 20 74 68 61 74 0a 2a 2a 20 6d 65 61 6e 73 20 77 that.** means w
cb10: 65 20 68 61 76 65 20 73 74 61 72 74 65 64 20 74 e have started t
cb20: 6f 20 62 65 20 63 6f 6e 63 65 72 6e 65 64 20 61 o be concerned a
cb30: 62 6f 75 74 20 63 6f 6e 74 65 6e 74 20 61 6e 64 bout content and
cb40: 20 74 68 65 20 64 69 73 6b 0a 2a 2a 20 72 65 61 the disk.** rea
cb50: 64 20 73 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 d should occur a
cb60: 74 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f t that point..*/
cb70: 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 65 .static int btre
cb80: 65 47 65 74 50 61 67 65 28 0a 20 20 42 74 53 68 eGetPage(. BtSh
cb90: 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
cba0: 20 2f 2a 20 54 68 65 20 62 74 72 65 65 20 2a 2f /* The btree */
cbb0: 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 . Pgno pgno,
cbc0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
cbd0: 72 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 6f r of the page to
cbe0: 20 66 65 74 63 68 20 2a 2f 0a 20 20 4d 65 6d 50 fetch */. MemP
cbf0: 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 age **ppPage,
cc00: 20 2f 2a 20 52 65 74 75 72 6e 20 74 68 65 20 70 /* Return the p
cc10: 61 67 65 20 69 6e 20 74 68 69 73 20 70 61 72 61 age in this para
cc20: 6d 65 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6e meter */. int n
cc30: 6f 43 6f 6e 74 65 6e 74 20 20 20 20 20 20 20 20 oContent
cc40: 2f 2a 20 44 6f 20 6e 6f 74 20 6c 6f 61 64 20 70 /* Do not load p
cc50: 61 67 65 20 63 6f 6e 74 65 6e 74 20 69 66 20 74 age content if t
cc60: 72 75 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 rue */.){. int
cc70: 72 63 3b 0a 20 20 44 62 50 61 67 65 20 2a 70 44 rc;. DbPage *pD
cc80: 62 50 61 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 bPage;.. assert
cc90: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
cca0: 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
ccb0: 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 );. rc = sqlit
ccc0: 65 33 50 61 67 65 72 41 63 71 75 69 72 65 28 70 e3PagerAcquire(p
ccd0: 42 74 2d 3e 70 50 61 67 65 72 2c 20 70 67 6e 6f Bt->pPager, pgno
cce0: 2c 20 28 44 62 50 61 67 65 2a 2a 29 26 70 44 62 , (DbPage**)&pDb
ccf0: 50 61 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e 74 29 Page, noContent)
cd00: 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 ;. if( rc ) ret
cd10: 75 72 6e 20 72 63 3b 0a 20 20 2a 70 70 50 61 67 urn rc;. *ppPag
cd20: 65 20 3d 20 62 74 72 65 65 50 61 67 65 46 72 6f e = btreePageFro
cd30: 6d 44 62 50 61 67 65 28 70 44 62 50 61 67 65 2c mDbPage(pDbPage,
cd40: 20 70 67 6e 6f 2c 20 70 42 74 29 3b 0a 20 20 72 pgno, pBt);. r
cd50: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
cd60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 72 69 65 .}../*.** Retrie
cd70: 76 65 20 61 20 70 61 67 65 20 66 72 6f 6d 20 74 ve a page from t
cd80: 68 65 20 70 61 67 65 72 20 63 61 63 68 65 2e 20 he pager cache.
cd90: 49 66 20 74 68 65 20 72 65 71 75 65 73 74 65 64 If the requested
cda0: 20 70 61 67 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 page is not.**
cdb0: 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 70 already in the p
cdc0: 61 67 65 72 20 63 61 63 68 65 20 72 65 74 75 72 ager cache retur
cdd0: 6e 20 4e 55 4c 4c 2e 20 49 6e 69 74 69 61 6c 69 n NULL. Initiali
cde0: 7a 65 20 74 68 65 20 4d 65 6d 50 61 67 65 2e 70 ze the MemPage.p
cdf0: 42 74 20 61 6e 64 0a 2a 2a 20 4d 65 6d 50 61 67 Bt and.** MemPag
ce00: 65 2e 61 44 61 74 61 20 65 6c 65 6d 65 6e 74 73 e.aData elements
ce10: 20 69 66 20 6e 65 65 64 65 64 2e 0a 2a 2f 0a 73 if needed..*/.s
ce20: 74 61 74 69 63 20 4d 65 6d 50 61 67 65 20 2a 62 tatic MemPage *b
ce30: 74 72 65 65 50 61 67 65 4c 6f 6f 6b 75 70 28 42 treePageLookup(B
ce40: 74 53 68 61 72 65 64 20 2a 70 42 74 2c 20 50 67 tShared *pBt, Pg
ce50: 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 44 62 50 61 no pgno){. DbPa
ce60: 67 65 20 2a 70 44 62 50 61 67 65 3b 0a 20 20 61 ge *pDbPage;. a
ce70: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
ce80: 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
ce90: 75 74 65 78 29 20 29 3b 0a 20 20 70 44 62 50 61 utex) );. pDbPa
cea0: 67 65 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 ge = sqlite3Page
ceb0: 72 4c 6f 6f 6b 75 70 28 70 42 74 2d 3e 70 50 61 rLookup(pBt->pPa
cec0: 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 69 66 ger, pgno);. if
ced0: 28 20 70 44 62 50 61 67 65 20 29 7b 0a 20 20 20 ( pDbPage ){.
cee0: 20 72 65 74 75 72 6e 20 62 74 72 65 65 50 61 67 return btreePag
cef0: 65 46 72 6f 6d 44 62 50 61 67 65 28 70 44 62 50 eFromDbPage(pDbP
cf00: 61 67 65 2c 20 70 67 6e 6f 2c 20 70 42 74 29 3b age, pgno, pBt);
cf10: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b . }. return 0;
cf20: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
cf30: 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
cf40: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 database file i
cf50: 6e 20 70 61 67 65 73 2e 20 49 66 20 74 68 65 72 n pages. If ther
cf60: 65 20 69 73 20 61 6e 79 20 6b 69 6e 64 20 6f 66 e is any kind of
cf70: 0a 2a 2a 20 65 72 72 6f 72 2c 20 72 65 74 75 72 .** error, retur
cf80: 6e 20 28 28 75 6e 73 69 67 6e 65 64 20 69 6e 74 n ((unsigned int
cf90: 29 2d 31 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 )-1)..*/.static
cfa0: 50 67 6e 6f 20 62 74 72 65 65 50 61 67 65 63 6f Pgno btreePageco
cfb0: 75 6e 74 28 42 74 53 68 61 72 65 64 20 2a 70 42 unt(BtShared *pB
cfc0: 74 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 42 74 t){. return pBt
cfd0: 2d 3e 6e 50 61 67 65 3b 0a 7d 0a 75 33 32 20 73 ->nPage;.}.u32 s
cfe0: 71 6c 69 74 65 33 42 74 72 65 65 4c 61 73 74 50 qlite3BtreeLastP
cff0: 61 67 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 age(Btree *p){.
d000: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
d010: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 BtreeHoldsMutex(
d020: 70 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 p) );. assert(
d030: 28 28 70 2d 3e 70 42 74 2d 3e 6e 50 61 67 65 29 ((p->pBt->nPage)
d040: 26 30 78 38 30 30 30 30 30 30 29 3d 3d 30 20 29 &0x8000000)==0 )
d050: 3b 0a 20 20 72 65 74 75 72 6e 20 28 69 6e 74 29 ;. return (int)
d060: 62 74 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 btreePagecount(p
d070: 2d 3e 70 42 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ->pBt);.}../*.**
d080: 20 47 65 74 20 61 20 70 61 67 65 20 66 72 6f 6d Get a page from
d090: 20 74 68 65 20 70 61 67 65 72 20 61 6e 64 20 69 the pager and i
d0a0: 6e 69 74 69 61 6c 69 7a 65 20 69 74 2e 20 20 54 nitialize it. T
d0b0: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 6a his routine is j
d0c0: 75 73 74 20 61 0a 2a 2a 20 63 6f 6e 76 65 6e 69 ust a.** conveni
d0d0: 65 6e 63 65 20 77 72 61 70 70 65 72 20 61 72 6f ence wrapper aro
d0e0: 75 6e 64 20 73 65 70 61 72 61 74 65 20 63 61 6c und separate cal
d0f0: 6c 73 20 74 6f 20 62 74 72 65 65 47 65 74 50 61 ls to btreeGetPa
d100: 67 65 28 29 20 61 6e 64 20 0a 2a 2a 20 62 74 72 ge() and .** btr
d110: 65 65 49 6e 69 74 50 61 67 65 28 29 2e 0a 2a 2a eeInitPage()..**
d120: 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 .** If an error
d130: 6f 63 63 75 72 73 2c 20 74 68 65 6e 20 74 68 65 occurs, then the
d140: 20 76 61 6c 75 65 20 2a 70 70 50 61 67 65 20 69 value *ppPage i
d150: 73 20 73 65 74 20 74 6f 20 69 73 20 75 6e 64 65 s set to is unde
d160: 66 69 6e 65 64 2e 20 49 74 0a 2a 2a 20 6d 61 79 fined. It.** may
d170: 20 72 65 6d 61 69 6e 20 75 6e 63 68 61 6e 67 65 remain unchange
d180: 64 2c 20 6f 72 20 69 74 20 6d 61 79 20 62 65 20 d, or it may be
d190: 73 65 74 20 74 6f 20 61 6e 20 69 6e 76 61 6c 69 set to an invali
d1a0: 64 20 76 61 6c 75 65 2e 0a 2a 2f 0a 73 74 61 74 d value..*/.stat
d1b0: 69 63 20 69 6e 74 20 67 65 74 41 6e 64 49 6e 69 ic int getAndIni
d1c0: 74 50 61 67 65 28 0a 20 20 42 74 53 68 61 72 65 tPage(. BtShare
d1d0: 64 20 2a 70 42 74 2c 20 20 20 20 20 20 20 20 20 d *pBt,
d1e0: 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
d1f0: 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 file */. Pgno
d200: 70 67 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 20 pgno,
d210: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 68 65 /* Number of the
d220: 20 70 61 67 65 20 74 6f 20 67 65 74 20 2a 2f 0a page to get */.
d230: 20 20 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 MemPage **ppPa
d240: 67 65 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 ge /* Write
d250: 74 68 65 20 70 61 67 65 20 70 6f 69 6e 74 65 72 the page pointer
d260: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e here */.){. in
d270: 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 20 t rc;. assert(
d280: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
d290: 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 ld(pBt->mutex) )
d2a0: 3b 0a 0a 20 20 69 66 28 20 70 67 6e 6f 3e 62 74 ;.. if( pgno>bt
d2b0: 72 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 reePagecount(pBt
d2c0: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 ) ){. rc = SQ
d2d0: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
d2e0: 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 T;. }else{.
d2f0: 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
d300: 65 28 70 42 74 2c 20 70 67 6e 6f 2c 20 70 70 50 e(pBt, pgno, ppP
d310: 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 age, 0);. if(
d320: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
d330: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 {. rc = btr
d340: 65 65 49 6e 69 74 50 61 67 65 28 2a 70 70 50 61 eeInitPage(*ppPa
d350: 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 ge);. if( r
d360: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
d370: 20 20 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 releaseP
d380: 61 67 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 age(*ppPage);.
d390: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
d3a0: 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 67 6e . testcase( pgn
d3b0: 6f 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 o==0 );. assert
d3c0: 28 20 70 67 6e 6f 21 3d 30 20 7c 7c 20 72 63 3d ( pgno!=0 || rc=
d3d0: 3d 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 =SQLITE_CORRUPT
d3e0: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
d3f0: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 }../*.** Release
d400: 20 61 20 4d 65 6d 50 61 67 65 2e 20 20 54 68 69 a MemPage. Thi
d410: 73 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c s should be call
d420: 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 ed once for each
d430: 20 70 72 69 6f 72 0a 2a 2a 20 63 61 6c 6c 20 74 prior.** call t
d440: 6f 20 62 74 72 65 65 47 65 74 50 61 67 65 2e 0a o btreeGetPage..
d450: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 */.static void r
d460: 65 6c 65 61 73 65 50 61 67 65 28 4d 65 6d 50 61 eleasePage(MemPa
d470: 67 65 20 2a 70 50 61 67 65 29 7b 0a 20 20 69 66 ge *pPage){. if
d480: 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 20 61 ( pPage ){. a
d490: 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 61 44 ssert( pPage->aD
d4a0: 61 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 ata );. asser
d4b0: 74 28 20 70 50 61 67 65 2d 3e 70 42 74 20 29 3b t( pPage->pBt );
d4c0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
d4d0: 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 72 ite3PagerGetExtr
d4e0: 61 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 a(pPage->pDbPage
d4f0: 29 20 3d 3d 20 28 76 6f 69 64 2a 29 70 50 61 67 ) == (void*)pPag
d500: 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 e );. assert(
d510: 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
d520: 44 61 74 61 28 70 50 61 67 65 2d 3e 70 44 62 50 Data(pPage->pDbP
d530: 61 67 65 29 3d 3d 70 50 61 67 65 2d 3e 61 44 61 age)==pPage->aDa
d540: 74 61 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 ta );. assert
d550: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
d560: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
d570: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 73 >mutex) );. s
d580: 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
d590: 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 (pPage->pDbPage)
d5a0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 ;. }.}../*.** D
d5b0: 75 72 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 6b uring a rollback
d5c0: 2c 20 77 68 65 6e 20 74 68 65 20 70 61 67 65 72 , when the pager
d5d0: 20 72 65 6c 6f 61 64 73 20 69 6e 66 6f 72 6d 61 reloads informa
d5e0: 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 63 61 tion into the ca
d5f0: 63 68 65 0a 2a 2a 20 73 6f 20 74 68 61 74 20 74 che.** so that t
d600: 68 65 20 63 61 63 68 65 20 69 73 20 72 65 73 74 he cache is rest
d610: 6f 72 65 64 20 74 6f 20 69 74 73 20 6f 72 69 67 ored to its orig
d620: 69 6e 61 6c 20 73 74 61 74 65 20 61 74 20 74 68 inal state at th
d630: 65 20 73 74 61 72 74 20 6f 66 0a 2a 2a 20 74 68 e start of.** th
d640: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 66 e transaction, f
d650: 6f 72 20 65 61 63 68 20 70 61 67 65 20 72 65 73 or each page res
d660: 74 6f 72 65 64 20 74 68 69 73 20 72 6f 75 74 69 tored this routi
d670: 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a ne is called..**
d680: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
d690: 20 6e 65 65 64 73 20 74 6f 20 72 65 73 65 74 20 needs to reset
d6a0: 74 68 65 20 65 78 74 72 61 20 64 61 74 61 20 73 the extra data s
d6b0: 65 63 74 69 6f 6e 20 61 74 20 74 68 65 20 65 6e ection at the en
d6c0: 64 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 67 65 d of the.** page
d6d0: 20 74 6f 20 61 67 72 65 65 20 77 69 74 68 20 74 to agree with t
d6e0: 68 65 20 72 65 73 74 6f 72 65 64 20 64 61 74 61 he restored data
d6f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
d700: 20 70 61 67 65 52 65 69 6e 69 74 28 44 62 50 61 pageReinit(DbPa
d710: 67 65 20 2a 70 44 61 74 61 29 7b 0a 20 20 4d 65 ge *pData){. Me
d720: 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 20 mPage *pPage;.
d730: 70 50 61 67 65 20 3d 20 28 4d 65 6d 50 61 67 65 pPage = (MemPage
d740: 20 2a 29 73 71 6c 69 74 65 33 50 61 67 65 72 47 *)sqlite3PagerG
d750: 65 74 45 78 74 72 61 28 70 44 61 74 61 29 3b 0a etExtra(pData);.
d760: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
d770: 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 3PagerPageRefcou
d780: 6e 74 28 70 44 61 74 61 29 3e 30 20 29 3b 0a 20 nt(pData)>0 );.
d790: 20 69 66 28 20 70 50 61 67 65 2d 3e 69 73 49 6e if( pPage->isIn
d7a0: 69 74 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 it ){. assert
d7b0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
d7c0: 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
d7d0: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 20 20 70 >mutex) );. p
d7e0: 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 30 Page->isInit = 0
d7f0: 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 ;. if( sqlite
d800: 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 3PagerPageRefcou
d810: 6e 74 28 70 44 61 74 61 29 3e 31 20 29 7b 0a 20 nt(pData)>1 ){.
d820: 20 20 20 20 20 2f 2a 20 70 50 61 67 65 20 6d 69 /* pPage mi
d830: 67 68 74 20 6e 6f 74 20 62 65 20 61 20 62 74 72 ght not be a btr
d840: 65 65 20 70 61 67 65 3b 20 20 69 74 20 6d 69 67 ee page; it mig
d850: 68 74 20 62 65 20 61 6e 20 6f 76 65 72 66 6c 6f ht be an overflo
d860: 77 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 w page. **
d870: 6f 72 20 70 74 72 6d 61 70 20 70 61 67 65 20 6f or ptrmap page o
d880: 72 20 61 20 66 72 65 65 20 70 61 67 65 2e 20 20 r a free page.
d890: 49 6e 20 74 68 6f 73 65 20 63 61 73 65 73 2c 20 In those cases,
d8a0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 the following.
d8b0: 20 20 20 20 2a 2a 20 63 61 6c 6c 20 74 6f 20 62 ** call to b
d8c0: 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 77 treeInitPage() w
d8d0: 69 6c 6c 20 6c 69 6b 65 6c 79 20 72 65 74 75 72 ill likely retur
d8e0: 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
d8f0: 2e 0a 20 20 20 20 20 20 2a 2a 20 42 75 74 20 6e .. ** But n
d900: 6f 20 68 61 72 6d 20 69 73 20 64 6f 6e 65 20 62 o harm is done b
d910: 79 20 74 68 69 73 2e 20 20 41 6e 64 20 69 74 20 y this. And it
d920: 69 73 20 76 65 72 79 20 69 6d 70 6f 72 74 61 6e is very importan
d930: 74 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 t that. **
d940: 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 29 20 btreeInitPage()
d950: 62 65 20 63 61 6c 6c 65 64 20 6f 6e 20 65 76 65 be called on eve
d960: 72 79 20 62 74 72 65 65 20 70 61 67 65 20 73 6f ry btree page so
d970: 20 77 65 20 6d 61 6b 65 0a 20 20 20 20 20 20 2a we make. *
d980: 2a 20 74 68 65 20 63 61 6c 6c 20 66 6f 72 20 65 * the call for e
d990: 76 65 72 79 20 70 61 67 65 20 74 68 61 74 20 63 very page that c
d9a0: 6f 6d 65 73 20 69 6e 20 66 6f 72 20 72 65 2d 69 omes in for re-i
d9b0: 6e 69 74 69 6e 67 2e 20 2a 2f 0a 20 20 20 20 20 niting. */.
d9c0: 20 62 74 72 65 65 49 6e 69 74 50 61 67 65 28 70 btreeInitPage(p
d9d0: 50 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d Page);. }. }
d9e0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 6f 6b 65 .}../*.** Invoke
d9f0: 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 the busy handle
da00: 72 20 66 6f 72 20 61 20 62 74 72 65 65 2e 0a 2a r for a btree..*
da10: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 74 72 /.static int btr
da20: 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 eeInvokeBusyHand
da30: 6c 65 72 28 76 6f 69 64 20 2a 70 41 72 67 29 7b ler(void *pArg){
da40: 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
da50: 20 3d 20 28 42 74 53 68 61 72 65 64 2a 29 70 41 = (BtShared*)pA
da60: 72 67 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 rg;. assert( pB
da70: 74 2d 3e 64 62 20 29 3b 0a 20 20 61 73 73 65 72 t->db );. asser
da80: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
da90: 5f 68 65 6c 64 28 70 42 74 2d 3e 64 62 2d 3e 6d _held(pBt->db->m
daa0: 75 74 65 78 29 20 29 3b 0a 20 20 72 65 74 75 72 utex) );. retur
dab0: 6e 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 n sqlite3InvokeB
dac0: 75 73 79 48 61 6e 64 6c 65 72 28 26 70 42 74 2d usyHandler(&pBt-
dad0: 3e 64 62 2d 3e 62 75 73 79 48 61 6e 64 6c 65 72 >db->busyHandler
dae0: 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e );.}../*.** Open
daf0: 20 61 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 a database file
db00: 2e 0a 2a 2a 20 0a 2a 2a 20 7a 46 69 6c 65 6e 61 ..** .** zFilena
db10: 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f me is the name o
db20: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
db30: 69 6c 65 2e 20 20 49 66 20 7a 46 69 6c 65 6e 61 ile. If zFilena
db40: 6d 65 20 69 73 20 4e 55 4c 4c 0a 2a 2a 20 74 68 me is NULL.** th
db50: 65 6e 20 61 6e 20 65 70 68 65 6d 65 72 61 6c 20 en an ephemeral
db60: 64 61 74 61 62 61 73 65 20 69 73 20 63 72 65 61 database is crea
db70: 74 65 64 2e 20 20 54 68 65 20 65 70 68 65 6d 65 ted. The epheme
db80: 72 61 6c 20 64 61 74 61 62 61 73 65 20 6d 69 67 ral database mig
db90: 68 74 0a 2a 2a 20 62 65 20 65 78 63 6c 75 73 69 ht.** be exclusi
dba0: 76 65 6c 79 20 69 6e 20 6d 65 6d 6f 72 79 2c 20 vely in memory,
dbb0: 6f 72 20 69 74 20 6d 69 67 68 74 20 75 73 65 20 or it might use
dbc0: 61 20 64 69 73 6b 2d 62 61 73 65 64 20 6d 65 6d a disk-based mem
dbd0: 6f 72 79 20 63 61 63 68 65 2e 0a 2a 2a 20 45 69 ory cache..** Ei
dbe0: 74 68 65 72 20 77 61 79 2c 20 74 68 65 20 65 70 ther way, the ep
dbf0: 68 65 6d 65 72 61 6c 20 64 61 74 61 62 61 73 65 hemeral database
dc00: 20 77 69 6c 6c 20 62 65 20 61 75 74 6f 6d 61 74 will be automat
dc10: 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 0a ically deleted .
dc20: 2a 2a 20 77 68 65 6e 20 73 71 6c 69 74 65 33 42 ** when sqlite3B
dc30: 74 72 65 65 43 6c 6f 73 65 28 29 20 69 73 20 63 treeClose() is c
dc40: 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 alled..**.** If
dc50: 7a 46 69 6c 65 6e 61 6d 65 20 69 73 20 22 3a 6d zFilename is ":m
dc60: 65 6d 6f 72 79 3a 22 20 74 68 65 6e 20 61 6e 20 emory:" then an
dc70: 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 in-memory databa
dc80: 73 65 20 69 73 20 63 72 65 61 74 65 64 0a 2a 2a se is created.**
dc90: 20 74 68 61 74 20 69 73 20 61 75 74 6f 6d 61 74 that is automat
dca0: 69 63 61 6c 6c 79 20 64 65 73 74 72 6f 79 65 64 ically destroyed
dcb0: 20 77 68 65 6e 20 69 74 20 69 73 20 63 6c 6f 73 when it is clos
dcc0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 66 ed..**.** The "f
dcd0: 6c 61 67 73 22 20 70 61 72 61 6d 65 74 65 72 20 lags" parameter
dce0: 69 73 20 61 20 62 69 74 6d 61 73 6b 20 74 68 61 is a bitmask tha
dcf0: 74 20 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e 20 t might contain
dd00: 62 69 74 73 20 6c 69 6b 65 0a 2a 2a 20 42 54 52 bits like.** BTR
dd10: 45 45 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 20 EE_OMIT_JOURNAL
dd20: 61 6e 64 2f 6f 72 20 42 54 52 45 45 5f 4d 45 4d and/or BTREE_MEM
dd30: 4f 52 59 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ORY..**.** If th
dd40: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 6c e database is al
dd50: 72 65 61 64 79 20 6f 70 65 6e 65 64 20 69 6e 20 ready opened in
dd60: 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 the same databas
dd70: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 e connection.**
dd80: 61 6e 64 20 77 65 20 61 72 65 20 69 6e 20 73 68 and we are in sh
dd90: 61 72 65 64 20 63 61 63 68 65 20 6d 6f 64 65 2c ared cache mode,
dda0: 20 74 68 65 6e 20 74 68 65 20 6f 70 65 6e 20 77 then the open w
ddb0: 69 6c 6c 20 66 61 69 6c 20 77 69 74 68 20 61 6e ill fail with an
ddc0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 .** SQLITE_CONST
ddd0: 52 41 49 4e 54 20 65 72 72 6f 72 2e 20 20 57 65 RAINT error. We
dde0: 20 63 61 6e 6e 6f 74 20 61 6c 6c 6f 77 20 74 77 cannot allow tw
ddf0: 6f 20 6f 72 20 6d 6f 72 65 20 42 74 53 68 61 72 o or more BtShar
de00: 65 64 0a 2a 2a 20 6f 62 6a 65 63 74 73 20 69 6e ed.** objects in
de10: 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 the same databa
de20: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 73 69 se connection si
de30: 6e 63 65 20 64 6f 69 6e 67 20 73 6f 20 77 69 6c nce doing so wil
de40: 6c 20 6c 65 61 64 0a 2a 2a 20 74 6f 20 70 72 6f l lead.** to pro
de50: 62 6c 65 6d 73 20 77 69 74 68 20 6c 6f 63 6b 69 blems with locki
de60: 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ng..*/.int sqlit
de70: 65 33 42 74 72 65 65 4f 70 65 6e 28 0a 20 20 73 e3BtreeOpen(. s
de80: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 qlite3_vfs *pVfs
de90: 2c 20 20 20 20 20 20 2f 2a 20 56 46 53 20 74 6f , /* VFS to
dea0: 20 75 73 65 20 66 6f 72 20 74 68 69 73 20 62 2d use for this b-
deb0: 74 72 65 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 tree */. const
dec0: 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 6d 65 2c char *zFilename,
ded0: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
dee0: 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 file containing
def0: 20 74 68 65 20 42 54 72 65 65 20 64 61 74 61 62 the BTree datab
df00: 61 73 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ase */. sqlite3
df10: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
df20: 20 2f 2a 20 41 73 73 6f 63 69 61 74 65 64 20 64 /* Associated d
df30: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a atabase handle *
df40: 2f 0a 20 20 42 74 72 65 65 20 2a 2a 70 70 42 74 /. Btree **ppBt
df50: 72 65 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 50 ree, /* P
df60: 6f 69 6e 74 65 72 20 74 6f 20 6e 65 77 20 42 74 ointer to new Bt
df70: 72 65 65 20 6f 62 6a 65 63 74 20 77 72 69 74 74 ree object writt
df80: 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 en here */. int
df90: 20 66 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 flags,
dfa0: 20 20 20 20 20 2f 2a 20 4f 70 74 69 6f 6e 73 20 /* Options
dfb0: 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 */. int vfsFlag
dfc0: 73 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 s /*
dfd0: 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 68 72 Flags passed thr
dfe0: 6f 75 67 68 20 74 6f 20 73 71 6c 69 74 65 33 5f ough to sqlite3_
dff0: 76 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 29 vfs.xOpen() */.)
e000: 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
e010: 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 t = 0;
e020: 20 20 20 2f 2a 20 53 68 61 72 65 64 20 70 61 72 /* Shared par
e030: 74 20 6f 66 20 62 74 72 65 65 20 73 74 72 75 63 t of btree struc
e040: 74 75 72 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 ture */. Btree
e050: 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 *p;
e060: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 6e 64 /* Hand
e070: 6c 65 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a le to return */.
e080: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 sqlite3_mutex
e090: 2a 6d 75 74 65 78 4f 70 65 6e 20 3d 20 30 3b 20 *mutexOpen = 0;
e0a0: 20 2f 2a 20 50 72 65 76 65 6e 74 73 20 61 20 72 /* Prevents a r
e0b0: 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 2e 20 54 ace condition. T
e0c0: 69 63 6b 65 74 20 23 33 35 33 37 20 2a 2f 0a 20 icket #3537 */.
e0d0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
e0e0: 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 _OK;
e0f0: 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 66 /* Result code f
e100: 72 6f 6d 20 74 68 69 73 20 66 75 6e 63 74 69 6f rom this functio
e110: 6e 20 2a 2f 0a 20 20 75 38 20 6e 52 65 73 65 72 n */. u8 nReser
e120: 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ve;
e130: 20 20 20 20 20 20 2f 2a 20 42 79 74 65 20 6f 66 /* Byte of
e140: 20 75 6e 75 73 65 64 20 73 70 61 63 65 20 6f 6e unused space on
e150: 20 65 61 63 68 20 70 61 67 65 20 2a 2f 0a 20 20 each page */.
e160: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 7a 44 unsigned char zD
e170: 62 48 65 61 64 65 72 5b 31 30 30 5d 3b 20 20 2f bHeader[100]; /
e180: 2a 20 44 61 74 61 62 61 73 65 20 68 65 61 64 65 * Database heade
e190: 72 20 63 6f 6e 74 65 6e 74 20 2a 2f 0a 0a 20 20 r content */..
e1a0: 2f 2a 20 54 72 75 65 20 69 66 20 6f 70 65 6e 69 /* True if openi
e1b0: 6e 67 20 61 6e 20 65 70 68 65 6d 65 72 61 6c 2c ng an ephemeral,
e1c0: 20 74 65 6d 70 6f 72 61 72 79 20 64 61 74 61 62 temporary datab
e1d0: 61 73 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 ase */. const i
e1e0: 6e 74 20 69 73 54 65 6d 70 44 62 20 3d 20 7a 46 nt isTempDb = zF
e1f0: 69 6c 65 6e 61 6d 65 3d 3d 30 20 7c 7c 20 7a 46 ilename==0 || zF
e200: 69 6c 65 6e 61 6d 65 5b 30 5d 3d 3d 30 3b 0a 0a ilename[0]==0;..
e210: 20 20 2f 2a 20 53 65 74 20 74 68 65 20 76 61 72 /* Set the var
e220: 69 61 62 6c 65 20 69 73 4d 65 6d 64 62 20 74 6f iable isMemdb to
e230: 20 74 72 75 65 20 66 6f 72 20 61 6e 20 69 6e 2d true for an in-
e240: 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c memory database,
e250: 20 6f 72 20 0a 20 20 2a 2a 20 66 61 6c 73 65 20 or . ** false
e260: 66 6f 72 20 61 20 66 69 6c 65 2d 62 61 73 65 64 for a file-based
e270: 20 64 61 74 61 62 61 73 65 2e 0a 20 20 2a 2f 0a database.. */.
e280: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
e290: 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 20 20 63 6f IT_MEMORYDB. co
e2a0: 6e 73 74 20 69 6e 74 20 69 73 4d 65 6d 64 62 20 nst int isMemdb
e2b0: 3d 20 30 3b 0a 23 65 6c 73 65 0a 20 20 63 6f 6e = 0;.#else. con
e2c0: 73 74 20 69 6e 74 20 69 73 4d 65 6d 64 62 20 3d st int isMemdb =
e2d0: 20 28 7a 46 69 6c 65 6e 61 6d 65 20 26 26 20 73 (zFilename && s
e2e0: 74 72 63 6d 70 28 7a 46 69 6c 65 6e 61 6d 65 2c trcmp(zFilename,
e2f0: 20 22 3a 6d 65 6d 6f 72 79 3a 22 29 3d 3d 30 29 ":memory:")==0)
e300: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
e310: 20 20 20 20 20 20 20 20 7c 7c 20 28 69 73 54 65 || (isTe
e320: 6d 70 44 62 20 26 26 20 73 71 6c 69 74 65 33 54 mpDb && sqlite3T
e330: 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 64 62 29 29 empInMemory(db))
e340: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
e350: 20 20 20 20 20 20 20 20 7c 7c 20 28 76 66 73 46 || (vfsF
e360: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 4f 50 lags & SQLITE_OP
e370: 45 4e 5f 4d 45 4d 4f 52 59 29 21 3d 30 3b 0a 23 EN_MEMORY)!=0;.#
e380: 65 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 endif.. assert(
e390: 20 64 62 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 db!=0 );. asse
e3a0: 72 74 28 20 70 56 66 73 21 3d 30 20 29 3b 0a 20 rt( pVfs!=0 );.
e3b0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
e3c0: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e _mutex_held(db->
e3d0: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
e3e0: 72 74 28 20 28 66 6c 61 67 73 26 30 78 66 66 29 rt( (flags&0xff)
e3f0: 3d 3d 66 6c 61 67 73 20 29 3b 20 20 20 2f 2a 20 ==flags ); /*
e400: 66 6c 61 67 73 20 66 69 74 20 69 6e 20 38 20 62 flags fit in 8 b
e410: 69 74 73 20 2a 2f 0a 0a 20 20 2f 2a 20 4f 6e 6c its */.. /* Onl
e420: 79 20 61 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 y a BTREE_SINGLE
e430: 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 65 database can be
e440: 20 42 54 52 45 45 5f 55 4e 4f 52 44 45 52 45 44 BTREE_UNORDERED
e450: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 66 */. assert( (f
e460: 6c 61 67 73 20 26 20 42 54 52 45 45 5f 55 4e 4f lags & BTREE_UNO
e470: 52 44 45 52 45 44 29 3d 3d 30 20 7c 7c 20 28 66 RDERED)==0 || (f
e480: 6c 61 67 73 20 26 20 42 54 52 45 45 5f 53 49 4e lags & BTREE_SIN
e490: 47 4c 45 29 21 3d 30 20 29 3b 0a 0a 20 20 2f 2a GLE)!=0 );.. /*
e4a0: 20 41 20 42 54 52 45 45 5f 53 49 4e 47 4c 45 20 A BTREE_SINGLE
e4b0: 64 61 74 61 62 61 73 65 20 69 73 20 61 6c 77 61 database is alwa
e4c0: 79 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 61 ys a temporary a
e4d0: 6e 64 2f 6f 72 20 65 70 68 65 6d 65 72 61 6c 20 nd/or ephemeral
e4e0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 66 6c */. assert( (fl
e4f0: 61 67 73 20 26 20 42 54 52 45 45 5f 53 49 4e 47 ags & BTREE_SING
e500: 4c 45 29 3d 3d 30 20 7c 7c 20 69 73 54 65 6d 70 LE)==0 || isTemp
e510: 44 62 20 29 3b 0a 0a 20 20 69 66 28 20 69 73 4d Db );.. if( isM
e520: 65 6d 64 62 20 29 7b 0a 20 20 20 20 66 6c 61 67 emdb ){. flag
e530: 73 20 7c 3d 20 42 54 52 45 45 5f 4d 45 4d 4f 52 s |= BTREE_MEMOR
e540: 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 28 76 66 Y;. }. if( (vf
e550: 73 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f sFlags & SQLITE_
e560: 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 21 3d 30 OPEN_MAIN_DB)!=0
e570: 20 26 26 20 28 69 73 4d 65 6d 64 62 20 7c 7c 20 && (isMemdb ||
e580: 69 73 54 65 6d 70 44 62 29 20 29 7b 0a 20 20 20 isTempDb) ){.
e590: 20 76 66 73 46 6c 61 67 73 20 3d 20 28 76 66 73 vfsFlags = (vfs
e5a0: 46 6c 61 67 73 20 26 20 7e 53 51 4c 49 54 45 5f Flags & ~SQLITE_
e5b0: 4f 50 45 4e 5f 4d 41 49 4e 5f 44 42 29 20 7c 20 OPEN_MAIN_DB) |
e5c0: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 SQLITE_OPEN_TEMP
e5d0: 5f 44 42 3b 0a 20 20 7d 0a 20 20 70 20 3d 20 73 _DB;. }. p = s
e5e0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f qlite3MallocZero
e5f0: 28 73 69 7a 65 6f 66 28 42 74 72 65 65 29 29 3b (sizeof(Btree));
e600: 0a 20 20 69 66 28 20 21 70 20 29 7b 0a 20 20 20 . if( !p ){.
e610: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
e620: 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 69 OMEM;. }. p->i
e630: 6e 54 72 61 6e 73 20 3d 20 54 52 41 4e 53 5f 4e nTrans = TRANS_N
e640: 4f 4e 45 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 ONE;. p->db = d
e650: 62 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 b;.#ifndef SQLIT
e660: 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
e670: 43 48 45 0a 20 20 70 2d 3e 6c 6f 63 6b 2e 70 42 CHE. p->lock.pB
e680: 74 72 65 65 20 3d 20 70 3b 0a 20 20 70 2d 3e 6c tree = p;. p->l
e690: 6f 63 6b 2e 69 54 61 62 6c 65 20 3d 20 31 3b 0a ock.iTable = 1;.
e6a0: 23 65 6e 64 69 66 0a 0a 23 69 66 20 21 64 65 66 #endif..#if !def
e6b0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
e6c0: 5f 53 48 41 52 45 44 5f 43 41 43 48 45 29 20 26 _SHARED_CACHE) &
e6d0: 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 & !defined(SQLIT
e6e0: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 E_OMIT_DISKIO).
e6f0: 20 2f 2a 0a 20 20 2a 2a 20 49 66 20 74 68 69 73 /*. ** If this
e700: 20 42 74 72 65 65 20 69 73 20 61 20 63 61 6e 64 Btree is a cand
e710: 69 64 61 74 65 20 66 6f 72 20 73 68 61 72 65 64 idate for shared
e720: 20 63 61 63 68 65 2c 20 74 72 79 20 74 6f 20 66 cache, try to f
e730: 69 6e 64 20 61 6e 0a 20 20 2a 2a 20 65 78 69 73 ind an. ** exis
e740: 74 69 6e 67 20 42 74 53 68 61 72 65 64 20 6f 62 ting BtShared ob
e750: 6a 65 63 74 20 74 68 61 74 20 77 65 20 63 61 6e ject that we can
e760: 20 73 68 61 72 65 20 77 69 74 68 0a 20 20 2a 2f share with. */
e770: 0a 20 20 69 66 28 20 69 73 54 65 6d 70 44 62 3d . if( isTempDb=
e780: 3d 30 20 26 26 20 28 69 73 4d 65 6d 64 62 3d 3d =0 && (isMemdb==
e790: 30 20 7c 7c 20 28 76 66 73 46 6c 61 67 73 26 53 0 || (vfsFlags&S
e7a0: 51 4c 49 54 45 5f 4f 50 45 4e 5f 55 52 49 29 21 QLITE_OPEN_URI)!
e7b0: 3d 30 29 20 29 7b 0a 20 20 20 20 69 66 28 20 76 =0) ){. if( v
e7c0: 66 73 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 fsFlags & SQLITE
e7d0: 5f 4f 50 45 4e 5f 53 48 41 52 45 44 43 41 43 48 _OPEN_SHAREDCACH
e7e0: 45 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e E ){. int n
e7f0: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 70 FullPathname = p
e800: 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b Vfs->mxPathname+
e810: 31 3b 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 1;. char *z
e820: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 3d 20 73 FullPathname = s
e830: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 6e 46 75 qlite3Malloc(nFu
e840: 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 llPathname);.
e850: 20 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 MUTEX_LOGIC(
e860: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d sqlite3_mutex *m
e870: 75 74 65 78 53 68 61 72 65 64 3b 20 29 0a 20 20 utexShared; ).
e880: 20 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 p->sharable
e890: 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28 20 21 = 1;. if( !
e8a0: 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 20 29 7b zFullPathname ){
e8b0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
e8c0: 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 20 20 _free(p);.
e8d0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
e8e0: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 NOMEM;. }.
e8f0: 20 20 20 20 20 69 66 28 20 69 73 4d 65 6d 64 62 if( isMemdb
e900: 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 ){. memc
e910: 70 79 28 7a 46 75 6c 6c 50 61 74 68 6e 61 6d 65 py(zFullPathname
e920: 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 73 71 6c , zFilename, sql
e930: 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 69 ite3Strlen30(zFi
e940: 6c 65 6e 61 6d 65 29 2b 31 29 3b 0a 20 20 20 20 lename)+1);.
e950: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
e960: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 rc = sqlite3OsF
e970: 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56 66 73 ullPathname(pVfs
e980: 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 0a 20 20 20 , zFilename,.
e990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e9a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e9b0: 6e 46 75 6c 6c 50 61 74 68 6e 61 6d 65 2c 20 7a nFullPathname, z
e9c0: 46 75 6c 6c 50 61 74 68 6e 61 6d 65 29 3b 0a 20 FullPathname);.
e9d0: 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b if( rc ){
e9e0: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
e9f0: 65 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 e3_free(zFullPat
ea00: 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 hname);.
ea10: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
ea20: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 );. ret
ea30: 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 urn rc;.
ea40: 7d 0a 20 20 20 20 20 20 7d 0a 23 69 66 20 53 51 }. }.#if SQ
ea50: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 0a LITE_THREADSAFE.
ea60: 20 20 20 20 20 20 6d 75 74 65 78 4f 70 65 6e 20 mutexOpen
ea70: 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 6c = sqlite3MutexAl
ea80: 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 loc(SQLITE_MUTEX
ea90: 5f 53 54 41 54 49 43 5f 4f 50 45 4e 29 3b 0a 20 _STATIC_OPEN);.
eaa0: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
eab0: 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 4f 70 ex_enter(mutexOp
eac0: 65 6e 29 3b 0a 20 20 20 20 20 20 6d 75 74 65 78 en);. mutex
ead0: 53 68 61 72 65 64 20 3d 20 73 71 6c 69 74 65 33 Shared = sqlite3
eae0: 4d 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 MutexAlloc(SQLIT
eaf0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d E_MUTEX_STATIC_M
eb00: 41 53 54 45 52 29 3b 0a 20 20 20 20 20 20 73 71 ASTER);. sq
eb10: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
eb20: 72 28 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a r(mutexShared);.
eb30: 23 65 6e 64 69 66 0a 20 20 20 20 20 20 66 6f 72 #endif. for
eb40: 28 70 42 74 3d 47 4c 4f 42 41 4c 28 42 74 53 68 (pBt=GLOBAL(BtSh
eb50: 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 61 ared*,sqlite3Sha
eb60: 72 65 64 43 61 63 68 65 4c 69 73 74 29 3b 20 70 redCacheList); p
eb70: 42 74 3b 20 70 42 74 3d 70 42 74 2d 3e 70 4e 65 Bt; pBt=pBt->pNe
eb80: 78 74 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 xt){. ass
eb90: 65 72 74 28 20 70 42 74 2d 3e 6e 52 65 66 3e 30 ert( pBt->nRef>0
eba0: 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 );. if(
ebb0: 30 3d 3d 73 74 72 63 6d 70 28 7a 46 75 6c 6c 50 0==strcmp(zFullP
ebc0: 61 74 68 6e 61 6d 65 2c 20 73 71 6c 69 74 65 33 athname, sqlite3
ebd0: 50 61 67 65 72 46 69 6c 65 6e 61 6d 65 28 70 42 PagerFilename(pB
ebe0: 74 2d 3e 70 50 61 67 65 72 2c 20 30 29 29 0a 20 t->pPager, 0)).
ebf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ec00: 26 26 20 73 71 6c 69 74 65 33 50 61 67 65 72 56 && sqlite3PagerV
ec10: 66 73 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d fs(pBt->pPager)=
ec20: 3d 70 56 66 73 20 29 7b 0a 20 20 20 20 20 20 20 =pVfs ){.
ec30: 20 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 20 20 int iDb;.
ec40: 20 20 20 20 20 20 66 6f 72 28 69 44 62 3d 64 62 for(iDb=db
ec50: 2d 3e 6e 44 62 2d 31 3b 20 69 44 62 3e 3d 30 3b ->nDb-1; iDb>=0;
ec60: 20 69 44 62 2d 2d 29 7b 0a 20 20 20 20 20 20 20 iDb--){.
ec70: 20 20 20 20 20 42 74 72 65 65 20 2a 70 45 78 69 Btree *pExi
ec80: 73 74 69 6e 67 20 3d 20 64 62 2d 3e 61 44 62 5b sting = db->aDb[
ec90: 69 44 62 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 iDb].pBt;.
eca0: 20 20 20 20 20 20 69 66 28 20 70 45 78 69 73 74 if( pExist
ecb0: 69 6e 67 20 26 26 20 70 45 78 69 73 74 69 6e 67 ing && pExisting
ecc0: 2d 3e 70 42 74 3d 3d 70 42 74 20 29 7b 0a 20 20 ->pBt==pBt ){.
ecd0: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
ece0: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
ecf0: 6d 75 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 mutexShared);.
ed00: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
ed10: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 te3_mutex_leave(
ed20: 6d 75 74 65 78 4f 70 65 6e 29 3b 0a 20 20 20 20 mutexOpen);.
ed30: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
ed40: 33 5f 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 3_free(zFullPath
ed50: 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 name);.
ed60: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 sqlite3_fre
ed70: 65 28 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 e(p);.
ed80: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
ed90: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 3b 0a 20 20 E_CONSTRAINT;.
eda0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
edb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
edc0: 20 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a p->pBt = pBt;.
edd0: 20 20 20 20 20 20 20 20 20 20 70 42 74 2d 3e 6e pBt->n
ede0: 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 20 20 20 Ref++;.
edf0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
ee00: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
ee10: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
ee20: 61 76 65 28 6d 75 74 65 78 53 68 61 72 65 64 29 ave(mutexShared)
ee30: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
ee40: 66 72 65 65 28 7a 46 75 6c 6c 50 61 74 68 6e 61 free(zFullPathna
ee50: 6d 65 29 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 me);. }.#ifde
ee60: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
ee70: 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f else{. /
ee80: 2a 20 49 6e 20 64 65 62 75 67 20 6d 6f 64 65 2c * In debug mode,
ee90: 20 77 65 20 6d 61 72 6b 20 61 6c 6c 20 70 65 72 we mark all per
eea0: 73 69 73 74 65 6e 74 20 64 61 74 61 62 61 73 65 sistent database
eeb0: 73 20 61 73 20 73 68 61 72 61 62 6c 65 0a 20 20 s as sharable.
eec0: 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 68 65 6e ** even when
eed0: 20 74 68 65 79 20 61 72 65 20 6e 6f 74 2e 20 20 they are not.
eee0: 54 68 69 73 20 65 78 65 72 63 69 73 65 73 20 74 This exercises t
eef0: 68 65 20 6c 6f 63 6b 69 6e 67 20 63 6f 64 65 20 he locking code
ef00: 61 6e 64 0a 20 20 20 20 20 20 2a 2a 20 67 69 76 and. ** giv
ef10: 65 73 20 6d 6f 72 65 20 6f 70 70 6f 72 74 75 6e es more opportun
ef20: 69 74 79 20 66 6f 72 20 61 73 73 65 72 74 73 28 ity for asserts(
ef30: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
ef40: 6c 64 28 29 29 0a 20 20 20 20 20 20 2a 2a 20 73 ld()). ** s
ef50: 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 66 69 6e tatements to fin
ef60: 64 20 6c 6f 63 6b 69 6e 67 20 70 72 6f 62 6c 65 d locking proble
ef70: 6d 73 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ms.. */.
ef80: 20 20 20 70 2d 3e 73 68 61 72 61 62 6c 65 20 3d p->sharable =
ef90: 20 31 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 1;. }.#endif
efa0: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 69 66 . }.#endif. if
efb0: 28 20 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 ( pBt==0 ){.
efc0: 2f 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 6f /*. ** The fo
efd0: 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 74 73 20 llowing asserts
efe0: 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 73 make sure that s
eff0: 74 72 75 63 74 75 72 65 73 20 75 73 65 64 20 62 tructures used b
f000: 79 20 74 68 65 20 62 74 72 65 65 20 61 72 65 0a y the btree are.
f010: 20 20 20 20 2a 2a 20 74 68 65 20 72 69 67 68 74 ** the right
f020: 20 73 69 7a 65 2e 20 20 54 68 69 73 20 69 73 20 size. This is
f030: 74 6f 20 67 75 61 72 64 20 61 67 61 69 6e 73 74 to guard against
f040: 20 73 69 7a 65 20 63 68 61 6e 67 65 73 20 74 68 size changes th
f050: 61 74 20 72 65 73 75 6c 74 0a 20 20 20 20 2a 2a at result. **
f060: 20 77 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 when compiling
f070: 6f 6e 20 61 20 64 69 66 66 65 72 65 6e 74 20 61 on a different a
f080: 72 63 68 69 74 65 63 74 75 72 65 2e 0a 20 20 20 rchitecture..
f090: 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
f0a0: 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d 38 20 7c sizeof(i64)==8 |
f0b0: 7c 20 73 69 7a 65 6f 66 28 69 36 34 29 3d 3d 34 | sizeof(i64)==4
f0c0: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
f0d0: 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 38 20 7c sizeof(u64)==8 |
f0e0: 7c 20 73 69 7a 65 6f 66 28 75 36 34 29 3d 3d 34 | sizeof(u64)==4
f0f0: 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
f100: 73 69 7a 65 6f 66 28 75 33 32 29 3d 3d 34 20 29 sizeof(u32)==4 )
f110: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 69 ;. assert( si
f120: 7a 65 6f 66 28 75 31 36 29 3d 3d 32 20 29 3b 0a zeof(u16)==2 );.
f130: 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 assert( size
f140: 6f 66 28 50 67 6e 6f 29 3d 3d 34 20 29 3b 0a 20 of(Pgno)==4 );.
f150: 20 0a 20 20 20 20 70 42 74 20 3d 20 73 71 6c 69 . pBt = sqli
f160: 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 20 73 te3MallocZero( s
f170: 69 7a 65 6f 66 28 2a 70 42 74 29 20 29 3b 0a 20 izeof(*pBt) );.
f180: 20 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 7b if( pBt==0 ){
f190: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 . rc = SQLI
f1a0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 TE_NOMEM;.
f1b0: 67 6f 74 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f goto btree_open_
f1c0: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 out;. }. r
f1d0: 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
f1e0: 4f 70 65 6e 28 70 56 66 73 2c 20 26 70 42 74 2d Open(pVfs, &pBt-
f1f0: 3e 70 50 61 67 65 72 2c 20 7a 46 69 6c 65 6e 61 >pPager, zFilena
f200: 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 me,.
f210: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 58 EX
f220: 54 52 41 5f 53 49 5a 45 2c 20 66 6c 61 67 73 2c TRA_SIZE, flags,
f230: 20 76 66 73 46 6c 61 67 73 2c 20 70 61 67 65 52 vfsFlags, pageR
f240: 65 69 6e 69 74 29 3b 0a 20 20 20 20 69 66 28 20 einit);. if(
f250: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
f260: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
f270: 74 65 33 50 61 67 65 72 52 65 61 64 46 69 6c 65 te3PagerReadFile
f280: 68 65 61 64 65 72 28 70 42 74 2d 3e 70 50 61 67 header(pBt->pPag
f290: 65 72 2c 73 69 7a 65 6f 66 28 7a 44 62 48 65 61 er,sizeof(zDbHea
f2a0: 64 65 72 29 2c 7a 44 62 48 65 61 64 65 72 29 3b der),zDbHeader);
f2b0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
f2c0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
f2d0: 20 20 20 20 20 20 67 6f 74 6f 20 62 74 72 65 65 goto btree
f2e0: 5f 6f 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 7d _open_out;. }
f2f0: 0a 20 20 20 20 70 42 74 2d 3e 6f 70 65 6e 46 6c . pBt->openFl
f300: 61 67 73 20 3d 20 28 75 38 29 66 6c 61 67 73 3b ags = (u8)flags;
f310: 0a 20 20 20 20 70 42 74 2d 3e 64 62 20 3d 20 64 . pBt->db = d
f320: 62 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 b;. sqlite3Pa
f330: 67 65 72 53 65 74 42 75 73 79 68 61 6e 64 6c 65 gerSetBusyhandle
f340: 72 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 62 r(pBt->pPager, b
f350: 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 48 61 treeInvokeBusyHa
f360: 6e 64 6c 65 72 2c 20 70 42 74 29 3b 0a 20 20 20 ndler, pBt);.
f370: 20 70 2d 3e 70 42 74 20 3d 20 70 42 74 3b 0a 20 p->pBt = pBt;.
f380: 20 0a 20 20 20 20 70 42 74 2d 3e 70 43 75 72 73 . pBt->pCurs
f390: 6f 72 20 3d 20 30 3b 0a 20 20 20 20 70 42 74 2d or = 0;. pBt-
f3a0: 3e 70 50 61 67 65 31 20 3d 20 30 3b 0a 20 20 20 >pPage1 = 0;.
f3b0: 20 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 if( sqlite3Page
f3c0: 72 49 73 72 65 61 64 6f 6e 6c 79 28 70 42 74 2d rIsreadonly(pBt-
f3d0: 3e 70 50 61 67 65 72 29 20 29 20 70 42 74 2d 3e >pPager) ) pBt->
f3e0: 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
f3f0: 52 45 41 44 5f 4f 4e 4c 59 3b 0a 23 69 66 64 65 READ_ONLY;.#ifde
f400: 66 20 53 51 4c 49 54 45 5f 53 45 43 55 52 45 5f f SQLITE_SECURE_
f410: 44 45 4c 45 54 45 0a 20 20 20 20 70 42 74 2d 3e DELETE. pBt->
f420: 62 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f btsFlags |= BTS_
f430: 53 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 23 SECURE_DELETE;.#
f440: 65 6e 64 69 66 0a 20 20 20 20 70 42 74 2d 3e 70 endif. pBt->p
f450: 61 67 65 53 69 7a 65 20 3d 20 28 7a 44 62 48 65 ageSize = (zDbHe
f460: 61 64 65 72 5b 31 36 5d 3c 3c 38 29 20 7c 20 28 ader[16]<<8) | (
f470: 7a 44 62 48 65 61 64 65 72 5b 31 37 5d 3c 3c 31 zDbHeader[17]<<1
f480: 36 29 3b 0a 20 20 20 20 69 66 28 20 70 42 74 2d 6);. if( pBt-
f490: 3e 70 61 67 65 53 69 7a 65 3c 35 31 32 20 7c 7c >pageSize<512 ||
f4a0: 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 53 pBt->pageSize>S
f4b0: 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 QLITE_MAX_PAGE_S
f4c0: 49 5a 45 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 IZE. ||
f4d0: 28 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2d ((pBt->pageSize-
f4e0: 31 29 26 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 1)&pBt->pageSize
f4f0: 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 42 )!=0 ){. pB
f500: 74 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 30 3b t->pageSize = 0;
f510: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
f520: 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a OMIT_AUTOVACUUM.
f530: 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 /* If the
f540: 6d 61 67 69 63 20 6e 61 6d 65 20 22 3a 6d 65 6d magic name ":mem
f550: 6f 72 79 3a 22 20 77 69 6c 6c 20 63 72 65 61 74 ory:" will creat
f560: 65 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 e an in-memory d
f570: 61 74 61 62 61 73 65 2c 20 74 68 65 6e 0a 20 20 atabase, then.
f580: 20 20 20 20 2a 2a 20 6c 65 61 76 65 20 74 68 65 ** leave the
f590: 20 61 75 74 6f 56 61 63 75 75 6d 20 6d 6f 64 65 autoVacuum mode
f5a0: 20 61 74 20 30 20 28 64 6f 20 6e 6f 74 20 61 75 at 0 (do not au
f5b0: 74 6f 2d 76 61 63 75 75 6d 29 2c 20 65 76 65 6e to-vacuum), even
f5c0: 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 53 51 4c if. ** SQL
f5d0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 41 55 54 4f ITE_DEFAULT_AUTO
f5e0: 56 41 43 55 55 4d 20 69 73 20 74 72 75 65 2e 20 VACUUM is true.
f5f0: 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e On the other han
f600: 64 2c 20 69 66 0a 20 20 20 20 20 20 2a 2a 20 53 d, if. ** S
f610: 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 QLITE_OMIT_MEMOR
f620: 59 44 42 20 68 61 73 20 62 65 65 6e 20 64 65 66 YDB has been def
f630: 69 6e 65 64 2c 20 74 68 65 6e 20 22 3a 6d 65 6d ined, then ":mem
f640: 6f 72 79 3a 22 20 69 73 20 6a 75 73 74 20 61 0a ory:" is just a.
f650: 20 20 20 20 20 20 2a 2a 20 72 65 67 75 6c 61 72 ** regular
f660: 20 66 69 6c 65 2d 6e 61 6d 65 2e 20 49 6e 20 74 file-name. In t
f670: 68 69 73 20 63 61 73 65 20 74 68 65 20 61 75 74 his case the aut
f680: 6f 2d 76 61 63 75 75 6d 20 61 70 70 6c 69 65 73 o-vacuum applies
f690: 20 61 73 20 70 65 72 20 6e 6f 72 6d 61 6c 2e 0a as per normal..
f6a0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
f6b0: 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 26 26 20 f( zFilename &&
f6c0: 21 69 73 4d 65 6d 64 62 20 29 7b 0a 20 20 20 20 !isMemdb ){.
f6d0: 20 20 20 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 pBt->autoVac
f6e0: 75 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 45 uum = (SQLITE_DE
f6f0: 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d FAULT_AUTOVACUUM
f700: 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 20 20 ? 1 : 0);.
f710: 20 20 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 pBt->incrVacu
f720: 75 6d 20 3d 20 28 53 51 4c 49 54 45 5f 44 45 46 um = (SQLITE_DEF
f730: 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 55 4d 3d AULT_AUTOVACUUM=
f740: 3d 32 20 3f 20 31 20 3a 20 30 29 3b 0a 20 20 20 =2 ? 1 : 0);.
f750: 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 }.#endif.
f760: 20 20 6e 52 65 73 65 72 76 65 20 3d 20 30 3b 0a nReserve = 0;.
f770: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
f780: 20 6e 52 65 73 65 72 76 65 20 3d 20 7a 44 62 48 nReserve = zDbH
f790: 65 61 64 65 72 5b 32 30 5d 3b 0a 20 20 20 20 20 eader[20];.
f7a0: 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c pBt->btsFlags |
f7b0: 3d 20 42 54 53 5f 50 41 47 45 53 49 5a 45 5f 46 = BTS_PAGESIZE_F
f7c0: 49 58 45 44 3b 0a 23 69 66 6e 64 65 66 20 53 51 IXED;.#ifndef SQ
f7d0: 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
f7e0: 43 55 55 4d 0a 20 20 20 20 20 20 70 42 74 2d 3e CUUM. pBt->
f7f0: 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 65 autoVacuum = (ge
f800: 74 34 62 79 74 65 28 26 7a 44 62 48 65 61 64 65 t4byte(&zDbHeade
f810: 72 5b 33 36 20 2b 20 34 2a 34 5d 29 3f 31 3a 30 r[36 + 4*4])?1:0
f820: 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 69 6e );. pBt->in
f830: 63 72 56 61 63 75 75 6d 20 3d 20 28 67 65 74 34 crVacuum = (get4
f840: 62 79 74 65 28 26 7a 44 62 48 65 61 64 65 72 5b byte(&zDbHeader[
f850: 33 36 20 2b 20 37 2a 34 5d 29 3f 31 3a 30 29 3b 36 + 7*4])?1:0);
f860: 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 .#endif. }.
f870: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
f880: 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 gerSetPagesize(p
f890: 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 74 Bt->pPager, &pBt
f8a0: 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e 52 65 73 ->pageSize, nRes
f8b0: 65 72 76 65 29 3b 0a 20 20 20 20 69 66 28 20 72 erve);. if( r
f8c0: 63 20 29 20 67 6f 74 6f 20 62 74 72 65 65 5f 6f c ) goto btree_o
f8d0: 70 65 6e 5f 6f 75 74 3b 0a 20 20 20 20 70 42 74 pen_out;. pBt
f8e0: 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 ->usableSize = p
f8f0: 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 6e Bt->pageSize - n
f900: 52 65 73 65 72 76 65 3b 0a 20 20 20 20 61 73 73 Reserve;. ass
f910: 65 72 74 28 20 28 70 42 74 2d 3e 70 61 67 65 53 ert( (pBt->pageS
f920: 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 20 20 ize & 7)==0 );
f930: 2f 2a 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 6d /* 8-byte alignm
f940: 65 6e 74 20 6f 66 20 70 61 67 65 53 69 7a 65 20 ent of pageSize
f950: 2a 2f 0a 20 20 20 0a 23 69 66 20 21 64 65 66 69 */. .#if !defi
f960: 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
f970: 53 48 41 52 45 44 5f 43 41 43 48 45 29 20 26 26 SHARED_CACHE) &&
f980: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
f990: 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a 20 20 _OMIT_DISKIO).
f9a0: 20 20 2f 2a 20 41 64 64 20 74 68 65 20 6e 65 77 /* Add the new
f9b0: 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 BtShared object
f9c0: 20 74 6f 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c to the linked l
f9d0: 69 73 74 20 73 68 61 72 61 62 6c 65 20 42 74 53 ist sharable BtS
f9e0: 68 61 72 65 64 73 2e 0a 20 20 20 20 2a 2f 0a 20 hareds.. */.
f9f0: 20 20 20 69 66 28 20 70 2d 3e 73 68 61 72 61 62 if( p->sharab
fa00: 6c 65 20 29 7b 0a 20 20 20 20 20 20 4d 55 54 45 le ){. MUTE
fa10: 58 5f 4c 4f 47 49 43 28 20 73 71 6c 69 74 65 33 X_LOGIC( sqlite3
fa20: 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 53 68 61 _mutex *mutexSha
fa30: 72 65 64 3b 20 29 0a 20 20 20 20 20 20 70 42 74 red; ). pBt
fa40: 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20 ->nRef = 1;.
fa50: 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 6d MUTEX_LOGIC( m
fa60: 75 74 65 78 53 68 61 72 65 64 20 3d 20 73 71 6c utexShared = sql
fa70: 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 53 ite3MutexAlloc(S
fa80: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
fa90: 49 43 5f 4d 41 53 54 45 52 29 3b 29 0a 20 20 20 IC_MASTER);).
faa0: 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 54 48 if( SQLITE_TH
fab0: 52 45 41 44 53 41 46 45 20 26 26 20 73 71 6c 69 READSAFE && sqli
fac0: 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 2e te3GlobalConfig.
fad0: 62 43 6f 72 65 4d 75 74 65 78 20 29 7b 0a 20 20 bCoreMutex ){.
fae0: 20 20 20 20 20 20 70 42 74 2d 3e 6d 75 74 65 78 pBt->mutex
faf0: 20 3d 20 73 71 6c 69 74 65 33 4d 75 74 65 78 41 = sqlite3MutexA
fb00: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
fb10: 58 5f 46 41 53 54 29 3b 0a 20 20 20 20 20 20 20 X_FAST);.
fb20: 20 69 66 28 20 70 42 74 2d 3e 6d 75 74 65 78 3d if( pBt->mutex=
fb30: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
fb40: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
fb50: 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 64 62 2d M;. db-
fb60: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 3d 20 >mallocFailed =
fb70: 30 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 0;. got
fb80: 6f 20 62 74 72 65 65 5f 6f 70 65 6e 5f 6f 75 74 o btree_open_out
fb90: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
fba0: 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 }. sqlite
fbb0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 3_mutex_enter(mu
fbc0: 74 65 78 53 68 61 72 65 64 29 3b 0a 20 20 20 20 texShared);.
fbd0: 20 20 70 42 74 2d 3e 70 4e 65 78 74 20 3d 20 47 pBt->pNext = G
fbe0: 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c LOBAL(BtShared*,
fbf0: 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 sqlite3SharedCac
fc00: 68 65 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 47 heList);. G
fc10: 4c 4f 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c LOBAL(BtShared*,
fc20: 73 71 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 sqlite3SharedCac
fc30: 68 65 4c 69 73 74 29 20 3d 20 70 42 74 3b 0a 20 heList) = pBt;.
fc40: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 sqlite3_mut
fc50: 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 53 68 ex_leave(mutexSh
fc60: 61 72 65 64 29 3b 0a 20 20 20 20 7d 0a 23 65 6e ared);. }.#en
fc70: 64 69 66 0a 20 20 7d 0a 0a 23 69 66 20 21 64 65 dif. }..#if !de
fc80: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
fc90: 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 29 20 T_SHARED_CACHE)
fca0: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
fcb0: 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 29 0a TE_OMIT_DISKIO).
fcc0: 20 20 2f 2a 20 49 66 20 74 68 65 20 6e 65 77 20 /* If the new
fcd0: 42 74 72 65 65 20 75 73 65 73 20 61 20 73 68 61 Btree uses a sha
fce0: 72 61 62 6c 65 20 70 42 74 53 68 61 72 65 64 2c rable pBtShared,
fcf0: 20 74 68 65 6e 20 6c 69 6e 6b 20 74 68 65 20 6e then link the n
fd00: 65 77 0a 20 20 2a 2a 20 42 74 72 65 65 20 69 6e ew. ** Btree in
fd10: 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 20 61 to the list of a
fd20: 6c 6c 20 73 68 61 72 61 62 6c 65 20 42 74 72 65 ll sharable Btre
fd30: 65 73 20 66 6f 72 20 74 68 65 20 73 61 6d 65 20 es for the same
fd40: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 20 20 2a 2a connection.. **
fd50: 20 54 68 65 20 6c 69 73 74 20 69 73 20 6b 65 70 The list is kep
fd60: 74 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f t in ascending o
fd70: 72 64 65 72 20 62 79 20 70 42 74 20 61 64 64 72 rder by pBt addr
fd80: 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ess.. */. if(
fd90: 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 p->sharable ){.
fda0: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 42 74 int i;. Bt
fdb0: 72 65 65 20 2a 70 53 69 62 3b 0a 20 20 20 20 66 ree *pSib;. f
fdc0: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 or(i=0; i<db->nD
fdd0: 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 b; i++){. i
fde0: 66 28 20 28 70 53 69 62 20 3d 20 64 62 2d 3e 61 f( (pSib = db->a
fdf0: 44 62 5b 69 5d 2e 70 42 74 29 21 3d 30 20 26 26 Db[i].pBt)!=0 &&
fe00: 20 70 53 69 62 2d 3e 73 68 61 72 61 62 6c 65 20 pSib->sharable
fe10: 29 7b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 ){. while
fe20: 28 20 70 53 69 62 2d 3e 70 50 72 65 76 20 29 7b ( pSib->pPrev ){
fe30: 20 70 53 69 62 20 3d 20 70 53 69 62 2d 3e 70 50 pSib = pSib->pP
fe40: 72 65 76 3b 20 7d 0a 20 20 20 20 20 20 20 20 69 rev; }. i
fe50: 66 28 20 70 2d 3e 70 42 74 3c 70 53 69 62 2d 3e f( p->pBt<pSib->
fe60: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20 pBt ){.
fe70: 20 70 2d 3e 70 4e 65 78 74 20 3d 20 70 53 69 62 p->pNext = pSib
fe80: 3b 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 70 ;. p->p
fe90: 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 20 20 20 Prev = 0;.
fea0: 20 20 20 20 70 53 69 62 2d 3e 70 50 72 65 76 20 pSib->pPrev
feb0: 3d 20 70 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c = p;. }el
fec0: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 se{. wh
fed0: 69 6c 65 28 20 70 53 69 62 2d 3e 70 4e 65 78 74 ile( pSib->pNext
fee0: 20 26 26 20 70 53 69 62 2d 3e 70 4e 65 78 74 2d && pSib->pNext-
fef0: 3e 70 42 74 3c 70 2d 3e 70 42 74 20 29 7b 0a 20 >pBt<p->pBt ){.
ff00: 20 20 20 20 20 20 20 20 20 20 20 70 53 69 62 20 pSib
ff10: 3d 20 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 = pSib->pNext;.
ff20: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
ff30: 20 20 20 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20 p->pNext =
ff40: 70 53 69 62 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 pSib->pNext;.
ff50: 20 20 20 20 20 20 20 70 2d 3e 70 50 72 65 76 20 p->pPrev
ff60: 3d 20 70 53 69 62 3b 0a 20 20 20 20 20 20 20 20 = pSib;.
ff70: 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29 if( p->pNext )
ff80: 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 2d {. p-
ff90: 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 >pNext->pPrev =
ffa0: 70 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 p;. }.
ffb0: 20 20 20 20 20 20 20 20 20 70 53 69 62 2d 3e 70 pSib->p
ffc0: 4e 65 78 74 20 3d 20 70 3b 0a 20 20 20 20 20 20 Next = p;.
ffd0: 20 20 7d 0a 20 20 20 20 20 20 20 20 62 72 65 61 }. brea
ffe0: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
fff0: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 2a 70 . }.#endif. *p
10000 70 42 74 72 65 65 20 3d 20 70 3b 0a 0a 62 74 72 pBtree = p;..btr
10010 65 65 5f 6f 70 65 6e 5f 6f 75 74 3a 0a 20 20 69 ee_open_out:. i
10020 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
10030 20 29 7b 0a 20 20 20 20 69 66 28 20 70 42 74 20 ){. if( pBt
10040 26 26 20 70 42 74 2d 3e 70 50 61 67 65 72 20 29 && pBt->pPager )
10050 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 {. sqlite3P
10060 61 67 65 72 43 6c 6f 73 65 28 70 42 74 2d 3e 70 agerClose(pBt->p
10070 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 Pager);. }.
10080 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
10090 42 74 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 Bt);. sqlite3
100a0 5f 66 72 65 65 28 70 29 3b 0a 20 20 20 20 2a 70 _free(p);. *p
100b0 70 42 74 72 65 65 20 3d 20 30 3b 0a 20 20 7d 65 pBtree = 0;. }e
100c0 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 lse{. /* If t
100d0 68 65 20 42 2d 54 72 65 65 20 77 61 73 20 73 75 he B-Tree was su
100e0 63 63 65 73 73 66 75 6c 6c 79 20 6f 70 65 6e 65 ccessfully opene
100f0 64 2c 20 73 65 74 20 74 68 65 20 70 61 67 65 72 d, set the pager
10100 2d 63 61 63 68 65 20 73 69 7a 65 20 74 6f 20 74 -cache size to t
10110 68 65 0a 20 20 20 20 2a 2a 20 64 65 66 61 75 6c he. ** defaul
10120 74 20 76 61 6c 75 65 2e 20 45 78 63 65 70 74 2c t value. Except,
10130 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 20 6f 6e when opening on
10140 20 61 6e 20 65 78 69 73 74 69 6e 67 20 73 68 61 an existing sha
10150 72 65 64 20 70 61 67 65 72 2d 63 61 63 68 65 2c red pager-cache,
10160 0a 20 20 20 20 2a 2a 20 64 6f 20 6e 6f 74 20 63 . ** do not c
10170 68 61 6e 67 65 20 74 68 65 20 70 61 67 65 72 2d hange the pager-
10180 63 61 63 68 65 20 73 69 7a 65 2e 0a 20 20 20 20 cache size..
10190 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 */. if( sqlit
101a0 65 33 42 74 72 65 65 53 63 68 65 6d 61 28 70 2c e3BtreeSchema(p,
101b0 20 30 2c 20 30 29 3d 3d 30 20 29 7b 0a 20 20 20 0, 0)==0 ){.
101c0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 sqlite3PagerS
101d0 65 74 43 61 63 68 65 73 69 7a 65 28 70 2d 3e 70 etCachesize(p->p
101e0 42 74 2d 3e 70 50 61 67 65 72 2c 20 53 51 4c 49 Bt->pPager, SQLI
101f0 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45 TE_DEFAULT_CACHE
10200 5f 53 49 5a 45 29 3b 0a 20 20 20 20 7d 0a 20 20 _SIZE);. }.
10210 7d 0a 20 20 69 66 28 20 6d 75 74 65 78 4f 70 65 }. if( mutexOpe
10220 6e 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 n ){. assert(
10230 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
10240 65 6c 64 28 6d 75 74 65 78 4f 70 65 6e 29 20 29 eld(mutexOpen) )
10250 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 ;. sqlite3_mu
10260 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 4f tex_leave(mutexO
10270 70 65 6e 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 pen);. }. retu
10280 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
10290 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 42 74 Decrement the Bt
102a0 53 68 61 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e Shared.nRef coun
102b0 74 65 72 2e 20 20 57 68 65 6e 20 69 74 20 72 65 ter. When it re
102c0 61 63 68 65 73 20 7a 65 72 6f 2c 0a 2a 2a 20 72 aches zero,.** r
102d0 65 6d 6f 76 65 20 74 68 65 20 42 74 53 68 61 72 emove the BtShar
102e0 65 64 20 73 74 72 75 63 74 75 72 65 20 66 72 6f ed structure fro
102f0 6d 20 74 68 65 20 73 68 61 72 69 6e 67 20 6c 69 m the sharing li
10300 73 74 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 74 st. Return.** t
10310 72 75 65 20 69 66 20 74 68 65 20 42 74 53 68 61 rue if the BtSha
10320 72 65 64 2e 6e 52 65 66 20 63 6f 75 6e 74 65 72 red.nRef counter
10330 20 72 65 61 63 68 65 73 20 7a 65 72 6f 20 61 6e reaches zero an
10340 64 20 72 65 74 75 72 6e 0a 2a 2a 20 66 61 6c 73 d return.** fals
10350 65 20 69 66 20 69 74 20 69 73 20 73 74 69 6c 6c e if it is still
10360 20 70 6f 73 69 74 69 76 65 2e 0a 2a 2f 0a 73 74 positive..*/.st
10370 61 74 69 63 20 69 6e 74 20 72 65 6d 6f 76 65 46 atic int removeF
10380 72 6f 6d 53 68 61 72 69 6e 67 4c 69 73 74 28 42 romSharingList(B
10390 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 23 tShared *pBt){.#
103a0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
103b0 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
103c0 20 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 73 MUTEX_LOGIC( s
103d0 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 4d qlite3_mutex *pM
103e0 61 73 74 65 72 3b 20 29 0a 20 20 42 74 53 68 61 aster; ). BtSha
103f0 72 65 64 20 2a 70 4c 69 73 74 3b 0a 20 20 69 6e red *pList;. in
10400 74 20 72 65 6d 6f 76 65 64 20 3d 20 30 3b 0a 0a t removed = 0;..
10410 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
10420 33 5f 6d 75 74 65 78 5f 6e 6f 74 68 65 6c 64 28 3_mutex_notheld(
10430 70 42 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 pBt->mutex) );.
10440 20 4d 55 54 45 58 5f 4c 4f 47 49 43 28 20 70 4d MUTEX_LOGIC( pM
10450 61 73 74 65 72 20 3d 20 73 71 6c 69 74 65 33 4d aster = sqlite3M
10460 75 74 65 78 41 6c 6c 6f 63 28 53 51 4c 49 54 45 utexAlloc(SQLITE
10470 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 _MUTEX_STATIC_MA
10480 53 54 45 52 29 3b 20 29 0a 20 20 73 71 6c 69 74 STER); ). sqlit
10490 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 70 e3_mutex_enter(p
104a0 4d 61 73 74 65 72 29 3b 0a 20 20 70 42 74 2d 3e Master);. pBt->
104b0 6e 52 65 66 2d 2d 3b 0a 20 20 69 66 28 20 70 42 nRef--;. if( pB
104c0 74 2d 3e 6e 52 65 66 3c 3d 30 20 29 7b 0a 20 20 t->nRef<=0 ){.
104d0 20 20 69 66 28 20 47 4c 4f 42 41 4c 28 42 74 53 if( GLOBAL(BtS
104e0 68 61 72 65 64 2a 2c 73 71 6c 69 74 65 33 53 68 hared*,sqlite3Sh
104f0 61 72 65 64 43 61 63 68 65 4c 69 73 74 29 3d 3d aredCacheList)==
10500 70 42 74 20 29 7b 0a 20 20 20 20 20 20 47 4c 4f pBt ){. GLO
10510 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 71 BAL(BtShared*,sq
10520 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 65 lite3SharedCache
10530 4c 69 73 74 29 20 3d 20 70 42 74 2d 3e 70 4e 65 List) = pBt->pNe
10540 78 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 xt;. }else{.
10550 20 20 20 20 20 70 4c 69 73 74 20 3d 20 47 4c 4f pList = GLO
10560 42 41 4c 28 42 74 53 68 61 72 65 64 2a 2c 73 71 BAL(BtShared*,sq
10570 6c 69 74 65 33 53 68 61 72 65 64 43 61 63 68 65 lite3SharedCache
10580 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 77 68 69 List);. whi
10590 6c 65 28 20 41 4c 57 41 59 53 28 70 4c 69 73 74 le( ALWAYS(pList
105a0 29 20 26 26 20 70 4c 69 73 74 2d 3e 70 4e 65 78 ) && pList->pNex
105b0 74 21 3d 70 42 74 20 29 7b 0a 20 20 20 20 20 20 t!=pBt ){.
105c0 20 20 70 4c 69 73 74 3d 70 4c 69 73 74 2d 3e 70 pList=pList->p
105d0 4e 65 78 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 Next;. }.
105e0 20 20 20 20 69 66 28 20 41 4c 57 41 59 53 28 70 if( ALWAYS(p
105f0 4c 69 73 74 29 20 29 7b 0a 20 20 20 20 20 20 20 List) ){.
10600 20 70 4c 69 73 74 2d 3e 70 4e 65 78 74 20 3d 20 pList->pNext =
10610 70 42 74 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 pBt->pNext;.
10620 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 }. }. if
10630 28 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 ( SQLITE_THREADS
10640 41 46 45 20 29 7b 0a 20 20 20 20 20 20 73 71 6c AFE ){. sql
10650 69 74 65 33 5f 6d 75 74 65 78 5f 66 72 65 65 28 ite3_mutex_free(
10660 70 42 74 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 20 pBt->mutex);.
10670 20 7d 0a 20 20 20 20 72 65 6d 6f 76 65 64 20 3d }. removed =
10680 20 31 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 1;. }. sqlite
10690 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 70 4d 3_mutex_leave(pM
106a0 61 73 74 65 72 29 3b 0a 20 20 72 65 74 75 72 6e aster);. return
106b0 20 72 65 6d 6f 76 65 64 3b 0a 23 65 6c 73 65 0a removed;.#else.
106c0 20 20 72 65 74 75 72 6e 20 31 3b 0a 23 65 6e 64 return 1;.#end
106d0 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 if.}../*.** Make
106e0 20 73 75 72 65 20 70 42 74 2d 3e 70 54 6d 70 53 sure pBt->pTmpS
106f0 70 61 63 65 20 70 6f 69 6e 74 73 20 74 6f 20 61 pace points to a
10700 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 6f 66 20 n allocation of
10710 0a 2a 2a 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 .** MX_CELL_SIZE
10720 28 70 42 74 29 20 62 79 74 65 73 2e 0a 2a 2f 0a (pBt) bytes..*/.
10730 73 74 61 74 69 63 20 76 6f 69 64 20 61 6c 6c 6f static void allo
10740 63 61 74 65 54 65 6d 70 53 70 61 63 65 28 42 74 cateTempSpace(Bt
10750 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 Shared *pBt){.
10760 69 66 28 20 21 70 42 74 2d 3e 70 54 6d 70 53 70 if( !pBt->pTmpSp
10770 61 63 65 20 29 7b 0a 20 20 20 20 70 42 74 2d 3e ace ){. pBt->
10780 70 54 6d 70 53 70 61 63 65 20 3d 20 73 71 6c 69 pTmpSpace = sqli
10790 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 20 70 te3PageMalloc( p
107a0 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a Bt->pageSize );.
107b0 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 }.}../*.** Fre
107c0 65 20 74 68 65 20 70 42 74 2d 3e 70 54 6d 70 53 e the pBt->pTmpS
107d0 70 61 63 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a pace allocation.
107e0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 */.static void f
107f0 72 65 65 54 65 6d 70 53 70 61 63 65 28 42 74 53 reeTempSpace(BtS
10800 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 73 hared *pBt){. s
10810 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 20 qlite3PageFree(
10820 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 65 29 3b pBt->pTmpSpace);
10830 0a 20 20 70 42 74 2d 3e 70 54 6d 70 53 70 61 63 . pBt->pTmpSpac
10840 65 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 e = 0;.}../*.**
10850 43 6c 6f 73 65 20 61 6e 20 6f 70 65 6e 20 64 61 Close an open da
10860 74 61 62 61 73 65 20 61 6e 64 20 69 6e 76 61 6c tabase and inval
10870 69 64 61 74 65 20 61 6c 6c 20 63 75 72 73 6f 72 idate all cursor
10880 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 s..*/.int sqlite
10890 33 42 74 72 65 65 43 6c 6f 73 65 28 42 74 72 65 3BtreeClose(Btre
108a0 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 61 72 65 e *p){. BtShare
108b0 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b d *pBt = p->pBt;
108c0 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 . BtCursor *pCu
108d0 72 3b 0a 0a 20 20 2f 2a 20 43 6c 6f 73 65 20 61 r;.. /* Close a
108e0 6c 6c 20 63 75 72 73 6f 72 73 20 6f 70 65 6e 65 ll cursors opene
108f0 64 20 76 69 61 20 74 68 69 73 20 68 61 6e 64 6c d via this handl
10900 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 e. */. assert(
10910 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
10920 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
10930 29 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 ) );. sqlite3Bt
10940 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 70 reeEnter(p);. p
10950 43 75 72 20 3d 20 70 42 74 2d 3e 70 43 75 72 73 Cur = pBt->pCurs
10960 6f 72 3b 0a 20 20 77 68 69 6c 65 28 20 70 43 75 or;. while( pCu
10970 72 20 29 7b 0a 20 20 20 20 42 74 43 75 72 73 6f r ){. BtCurso
10980 72 20 2a 70 54 6d 70 20 3d 20 70 43 75 72 3b 0a r *pTmp = pCur;.
10990 20 20 20 20 70 43 75 72 20 3d 20 70 43 75 72 2d pCur = pCur-
109a0 3e 70 4e 65 78 74 3b 0a 20 20 20 20 69 66 28 20 >pNext;. if(
109b0 70 54 6d 70 2d 3e 70 42 74 72 65 65 3d 3d 70 20 pTmp->pBtree==p
109c0 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
109d0 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 BtreeCloseCursor
109e0 28 70 54 6d 70 29 3b 0a 20 20 20 20 7d 0a 20 20 (pTmp);. }.
109f0 7d 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b }.. /* Rollback
10a00 20 61 6e 79 20 61 63 74 69 76 65 20 74 72 61 6e any active tran
10a10 73 61 63 74 69 6f 6e 20 61 6e 64 20 66 72 65 65 saction and free
10a20 20 74 68 65 20 68 61 6e 64 6c 65 20 73 74 72 75 the handle stru
10a30 63 74 75 72 65 2e 0a 20 20 2a 2a 20 54 68 65 20 cture.. ** The
10a40 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 call to sqlite3B
10a50 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 29 20 64 treeRollback() d
10a60 72 6f 70 73 20 61 6e 79 20 74 61 62 6c 65 2d 6c rops any table-l
10a70 6f 63 6b 73 20 68 65 6c 64 20 62 79 0a 20 20 2a ocks held by. *
10a80 2a 20 74 68 69 73 20 68 61 6e 64 6c 65 2e 0a 20 * this handle..
10a90 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 */. sqlite3Btr
10aa0 65 65 52 6f 6c 6c 62 61 63 6b 28 70 2c 20 53 51 eeRollback(p, SQ
10ab0 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 73 71 6c 69 LITE_OK);. sqli
10ac0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 te3BtreeLeave(p)
10ad0 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 ;.. /* If there
10ae0 20 61 72 65 20 73 74 69 6c 6c 20 6f 74 68 65 72 are still other
10af0 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 outstanding ref
10b00 65 72 65 6e 63 65 73 20 74 6f 20 74 68 65 20 73 erences to the s
10b10 68 61 72 65 64 2d 62 74 72 65 65 0a 20 20 2a 2a hared-btree. **
10b20 20 73 74 72 75 63 74 75 72 65 2c 20 72 65 74 75 structure, retu
10b30 72 6e 20 6e 6f 77 2e 20 54 68 65 20 72 65 6d 61 rn now. The rema
10b40 69 6e 64 65 72 20 6f 66 20 74 68 69 73 20 70 72 inder of this pr
10b50 6f 63 65 64 75 72 65 20 63 6c 65 61 6e 73 20 0a ocedure cleans .
10b60 20 20 2a 2a 20 75 70 20 74 68 65 20 73 68 61 72 ** up the shar
10b70 65 64 2d 62 74 72 65 65 2e 0a 20 20 2a 2f 0a 20 ed-btree.. */.
10b80 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e 74 assert( p->want
10b90 54 6f 4c 6f 63 6b 3d 3d 30 20 26 26 20 70 2d 3e ToLock==0 && p->
10ba0 6c 6f 63 6b 65 64 3d 3d 30 20 29 3b 0a 20 20 69 locked==0 );. i
10bb0 66 28 20 21 70 2d 3e 73 68 61 72 61 62 6c 65 20 f( !p->sharable
10bc0 7c 7c 20 72 65 6d 6f 76 65 46 72 6f 6d 53 68 61 || removeFromSha
10bd0 72 69 6e 67 4c 69 73 74 28 70 42 74 29 20 29 7b ringList(pBt) ){
10be0 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 42 74 20 . /* The pBt
10bf0 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 6f 6e 20 is no longer on
10c00 74 68 65 20 73 68 61 72 69 6e 67 20 6c 69 73 74 the sharing list
10c10 2c 20 73 6f 20 77 65 20 63 61 6e 20 61 63 63 65 , so we can acce
10c20 73 73 0a 20 20 20 20 2a 2a 20 69 74 20 77 69 74 ss. ** it wit
10c30 68 6f 75 74 20 68 61 76 69 6e 67 20 74 6f 20 68 hout having to h
10c40 6f 6c 64 20 74 68 65 20 6d 75 74 65 78 2e 0a 20 old the mutex..
10c50 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 6c 65 **. ** Cle
10c60 61 6e 20 6f 75 74 20 61 6e 64 20 64 65 6c 65 74 an out and delet
10c70 65 20 74 68 65 20 42 74 53 68 61 72 65 64 20 6f e the BtShared o
10c80 62 6a 65 63 74 2e 0a 20 20 20 20 2a 2f 0a 20 20 bject.. */.
10c90 20 20 61 73 73 65 72 74 28 20 21 70 42 74 2d 3e assert( !pBt->
10ca0 70 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 20 73 pCursor );. s
10cb0 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f 73 65 qlite3PagerClose
10cc0 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3b 0a 20 (pBt->pPager);.
10cd0 20 20 20 69 66 28 20 70 42 74 2d 3e 78 46 72 65 if( pBt->xFre
10ce0 65 53 63 68 65 6d 61 20 26 26 20 70 42 74 2d 3e eSchema && pBt->
10cf0 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20 20 pSchema ){.
10d00 20 70 42 74 2d 3e 78 46 72 65 65 53 63 68 65 6d pBt->xFreeSchem
10d10 61 28 70 42 74 2d 3e 70 53 63 68 65 6d 61 29 3b a(pBt->pSchema);
10d20 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
10d30 65 33 44 62 46 72 65 65 28 30 2c 20 70 42 74 2d e3DbFree(0, pBt-
10d40 3e 70 53 63 68 65 6d 61 29 3b 0a 20 20 20 20 66 >pSchema);. f
10d50 72 65 65 54 65 6d 70 53 70 61 63 65 28 70 42 74 reeTempSpace(pBt
10d60 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 );. sqlite3_f
10d70 72 65 65 28 70 42 74 29 3b 0a 20 20 7d 0a 0a 23 ree(pBt);. }..#
10d80 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
10d90 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
10da0 20 20 61 73 73 65 72 74 28 20 70 2d 3e 77 61 6e assert( p->wan
10db0 74 54 6f 4c 6f 63 6b 3d 3d 30 20 29 3b 0a 20 20 tToLock==0 );.
10dc0 61 73 73 65 72 74 28 20 70 2d 3e 6c 6f 63 6b 65 assert( p->locke
10dd0 64 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 2d d==0 );. if( p-
10de0 3e 70 50 72 65 76 20 29 20 70 2d 3e 70 50 72 65 >pPrev ) p->pPre
10df0 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e v->pNext = p->pN
10e00 65 78 74 3b 0a 20 20 69 66 28 20 70 2d 3e 70 4e ext;. if( p->pN
10e10 65 78 74 20 29 20 70 2d 3e 70 4e 65 78 74 2d 3e ext ) p->pNext->
10e20 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65 76 pPrev = p->pPrev
10e30 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c 69 ;.#endif.. sqli
10e40 74 65 33 5f 66 72 65 65 28 70 29 3b 0a 20 20 72 te3_free(p);. r
10e50 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
10e60 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 .}../*.** Change
10e70 20 74 68 65 20 6c 69 6d 69 74 20 6f 6e 20 74 68 the limit on th
10e80 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 e number of page
10e90 73 20 61 6c 6c 6f 77 65 64 20 69 6e 20 74 68 65 s allowed in the
10ea0 20 63 61 63 68 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 cache..**.** Th
10eb0 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 e maximum number
10ec0 20 6f 66 20 63 61 63 68 65 20 70 61 67 65 73 20 of cache pages
10ed0 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 61 62 is set to the ab
10ee0 73 6f 6c 75 74 65 0a 2a 2a 20 76 61 6c 75 65 20 solute.** value
10ef0 6f 66 20 6d 78 50 61 67 65 2e 20 20 49 66 20 6d of mxPage. If m
10f00 78 50 61 67 65 20 69 73 20 6e 65 67 61 74 69 76 xPage is negativ
10f10 65 2c 20 74 68 65 20 70 61 67 65 72 20 77 69 6c e, the pager wil
10f20 6c 0a 2a 2a 20 6f 70 65 72 61 74 65 20 61 73 79 l.** operate asy
10f30 6e 63 68 72 6f 6e 6f 75 73 6c 79 20 2d 20 69 74 nchronously - it
10f40 20 77 69 6c 6c 20 6e 6f 74 20 73 74 6f 70 20 74 will not stop t
10f50 6f 20 64 6f 20 66 73 79 6e 63 28 29 73 0a 2a 2a o do fsync()s.**
10f60 20 74 6f 20 69 6e 73 75 72 65 20 64 61 74 61 20 to insure data
10f70 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 is written to th
10f80 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 20 62 e disk surface b
10f90 65 66 6f 72 65 0a 2a 2a 20 63 6f 6e 74 69 6e 75 efore.** continu
10fa0 69 6e 67 2e 20 20 54 72 61 6e 73 61 63 74 69 6f ing. Transactio
10fb0 6e 73 20 73 74 69 6c 6c 20 77 6f 72 6b 20 69 66 ns still work if
10fc0 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 69 73 20 synchronous is
10fd0 6f 66 66 2c 0a 2a 2a 20 61 6e 64 20 74 68 65 20 off,.** and the
10fe0 64 61 74 61 62 61 73 65 20 63 61 6e 6e 6f 74 20 database cannot
10ff0 62 65 20 63 6f 72 72 75 70 74 65 64 20 69 66 20 be corrupted if
11000 74 68 69 73 20 70 72 6f 67 72 61 6d 0a 2a 2a 20 this program.**
11010 63 72 61 73 68 65 73 2e 20 20 42 75 74 20 69 66 crashes. But if
11020 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 the operating s
11030 79 73 74 65 6d 20 63 72 61 73 68 65 73 20 6f 72 ystem crashes or
11040 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6e 20 there is.** an
11050 61 62 72 75 70 74 20 70 6f 77 65 72 20 66 61 69 abrupt power fai
11060 6c 75 72 65 20 77 68 65 6e 20 73 79 6e 63 68 72 lure when synchr
11070 6f 6e 6f 75 73 20 69 73 20 6f 66 66 2c 20 74 68 onous is off, th
11080 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f e database.** co
11090 75 6c 64 20 62 65 20 6c 65 66 74 20 69 6e 20 61 uld be left in a
110a0 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 61 n inconsistent a
110b0 6e 64 20 75 6e 72 65 63 6f 76 65 72 61 62 6c 65 nd unrecoverable
110c0 20 73 74 61 74 65 2e 0a 2a 2a 20 53 79 6e 63 68 state..** Synch
110d0 72 6f 6e 6f 75 73 20 69 73 20 6f 6e 20 62 79 20 ronous is on by
110e0 64 65 66 61 75 6c 74 20 73 6f 20 64 61 74 61 62 default so datab
110f0 61 73 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 69 ase corruption i
11100 73 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c s not.** normall
11110 79 20 61 20 77 6f 72 72 79 2e 0a 2a 2f 0a 69 6e y a worry..*/.in
11120 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
11130 74 43 61 63 68 65 53 69 7a 65 28 42 74 72 65 65 tCacheSize(Btree
11140 20 2a 70 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 *p, int mxPage)
11150 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
11160 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 t = p->pBt;. as
11170 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
11180 74 65 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e tex_held(p->db->
11190 6d 75 74 65 78 29 20 29 3b 0a 20 20 73 71 6c 69 mutex) );. sqli
111a0 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
111b0 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
111c0 53 65 74 43 61 63 68 65 73 69 7a 65 28 70 42 74 SetCachesize(pBt
111d0 2d 3e 70 50 61 67 65 72 2c 20 6d 78 50 61 67 65 ->pPager, mxPage
111e0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
111f0 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
11200 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
11210 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 ../*.** Change t
11220 68 65 20 77 61 79 20 64 61 74 61 20 69 73 20 73 he way data is s
11230 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 20 69 6e ynced to disk in
11240 20 6f 72 64 65 72 20 74 6f 20 69 6e 63 72 65 61 order to increa
11250 73 65 20 6f 72 20 64 65 63 72 65 61 73 65 0a 2a se or decrease.*
11260 2a 20 68 6f 77 20 77 65 6c 6c 20 74 68 65 20 64 * how well the d
11270 61 74 61 62 61 73 65 20 72 65 73 69 73 74 73 20 atabase resists
11280 64 61 6d 61 67 65 20 64 75 65 20 74 6f 20 4f 53 damage due to OS
11290 20 63 72 61 73 68 65 73 20 61 6e 64 20 70 6f 77 crashes and pow
112a0 65 72 0a 2a 2a 20 66 61 69 6c 75 72 65 73 2e 20 er.** failures.
112b0 20 4c 65 76 65 6c 20 31 20 69 73 20 74 68 65 20 Level 1 is the
112c0 73 61 6d 65 20 61 73 20 61 73 79 6e 63 68 72 6f same as asynchro
112d0 6e 6f 75 73 20 28 6e 6f 20 73 79 6e 63 73 28 29 nous (no syncs()
112e0 20 6f 63 63 75 72 20 61 6e 64 0a 2a 2a 20 74 68 occur and.** th
112f0 65 72 65 20 69 73 20 61 20 68 69 67 68 20 70 72 ere is a high pr
11300 6f 62 61 62 69 6c 69 74 79 20 6f 66 20 64 61 6d obability of dam
11310 61 67 65 29 20 20 4c 65 76 65 6c 20 32 20 69 73 age) Level 2 is
11320 20 74 68 65 20 64 65 66 61 75 6c 74 2e 20 20 54 the default. T
11330 68 65 72 65 0a 2a 2a 20 69 73 20 61 20 76 65 72 here.** is a ver
11340 79 20 6c 6f 77 20 62 75 74 20 6e 6f 6e 2d 7a 65 y low but non-ze
11350 72 6f 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f ro probability o
11360 66 20 64 61 6d 61 67 65 2e 20 20 4c 65 76 65 6c f damage. Level
11370 20 33 20 72 65 64 75 63 65 73 20 74 68 65 0a 2a 3 reduces the.*
11380 2a 20 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 * probability of
11390 20 64 61 6d 61 67 65 20 74 6f 20 6e 65 61 72 20 damage to near
113a0 7a 65 72 6f 20 62 75 74 20 77 69 74 68 20 61 20 zero but with a
113b0 77 72 69 74 65 20 70 65 72 66 6f 72 6d 61 6e 63 write performanc
113c0 65 20 72 65 64 75 63 74 69 6f 6e 2e 0a 2a 2f 0a e reduction..*/.
113d0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
113e0 4d 49 54 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 MIT_PAGER_PRAGMA
113f0 53 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 S.int sqlite3Btr
11400 65 65 53 65 74 53 61 66 65 74 79 4c 65 76 65 6c eeSetSafetyLevel
11410 28 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 20 (. Btree *p,
11420 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
11430 65 20 62 74 72 65 65 20 74 6f 20 73 65 74 20 74 e btree to set t
11440 68 65 20 73 61 66 65 74 79 20 6c 65 76 65 6c 20 he safety level
11450 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 6c 65 76 65 on */. int leve
11460 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 2f l, /
11470 2a 20 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f * PRAGMA synchro
11480 6e 6f 75 73 2e 20 20 31 3d 4f 46 46 2c 20 32 3d nous. 1=OFF, 2=
11490 4e 4f 52 4d 41 4c 2c 20 33 3d 46 55 4c 4c 20 2a NORMAL, 3=FULL *
114a0 2f 0a 20 20 69 6e 74 20 66 75 6c 6c 53 79 6e 63 /. int fullSync
114b0 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 52 , /* PR
114c0 41 47 4d 41 20 66 75 6c 6c 66 73 79 6e 63 2e 20 AGMA fullfsync.
114d0 2a 2f 0a 20 20 69 6e 74 20 63 6b 70 74 46 75 6c */. int ckptFul
114e0 6c 53 79 6e 63 20 20 20 20 20 20 20 2f 2a 20 50 lSync /* P
114f0 52 41 47 4d 41 20 63 68 65 63 6b 70 6f 69 6e 74 RAGMA checkpoint
11500 5f 66 75 6c 6c 66 79 6e 63 20 2a 2f 0a 29 7b 0a _fullfync */.){.
11510 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 20 BtShared *pBt
11520 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 65 = p->pBt;. asse
11530 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
11540 78 5f 68 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 x_held(p->db->mu
11550 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 tex) );. assert
11560 28 20 6c 65 76 65 6c 3e 3d 31 20 26 26 20 6c 65 ( level>=1 && le
11570 76 65 6c 3c 3d 33 20 29 3b 0a 20 20 73 71 6c 69 vel<=3 );. sqli
11580 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
11590 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 ;. sqlite3Pager
115a0 53 65 74 53 61 66 65 74 79 4c 65 76 65 6c 28 70 SetSafetyLevel(p
115b0 42 74 2d 3e 70 50 61 67 65 72 2c 20 6c 65 76 65 Bt->pPager, leve
115c0 6c 2c 20 66 75 6c 6c 53 79 6e 63 2c 20 63 6b 70 l, fullSync, ckp
115d0 74 46 75 6c 6c 53 79 6e 63 29 3b 0a 20 20 73 71 tFullSync);. sq
115e0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
115f0 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c p);. return SQL
11600 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 6e 64 69 66 ITE_OK;.}.#endif
11610 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 ../*.** Return T
11620 52 55 45 20 69 66 20 74 68 65 20 67 69 76 65 6e RUE if the given
11630 20 62 74 72 65 65 20 69 73 20 73 65 74 20 74 6f btree is set to
11640 20 73 61 66 65 74 79 20 6c 65 76 65 6c 20 31 2e safety level 1.
11650 20 20 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 6f In other.** wo
11660 72 64 73 2c 20 72 65 74 75 72 6e 20 54 52 55 45 rds, return TRUE
11670 20 69 66 20 6e 6f 20 73 79 6e 63 28 29 20 6f 63 if no sync() oc
11680 63 75 72 73 20 6f 6e 20 74 68 65 20 64 69 73 6b curs on the disk
11690 20 66 69 6c 65 73 2e 0a 2a 2f 0a 69 6e 74 20 73 files..*/.int s
116a0 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 44 qlite3BtreeSyncD
116b0 69 73 61 62 6c 65 64 28 42 74 72 65 65 20 2a 70 isabled(Btree *p
116c0 29 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 ){. BtShared *p
116d0 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 69 Bt = p->pBt;. i
116e0 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 nt rc;. assert(
116f0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
11700 65 6c 64 28 70 2d 3e 64 62 2d 3e 6d 75 74 65 78 eld(p->db->mutex
11710 29 20 29 3b 20 20 0a 20 20 73 71 6c 69 74 65 33 ) ); . sqlite3
11720 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
11730 20 61 73 73 65 72 74 28 20 70 42 74 20 26 26 20 assert( pBt &&
11740 70 42 74 2d 3e 70 50 61 67 65 72 20 29 3b 0a 20 pBt->pPager );.
11750 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
11760 65 72 4e 6f 73 79 6e 63 28 70 42 74 2d 3e 70 50 erNosync(pBt->pP
11770 61 67 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 ager);. sqlite3
11780 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
11790 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
117a0 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
117b0 64 65 66 61 75 6c 74 20 70 61 67 65 73 20 73 69 default pages si
117c0 7a 65 20 61 6e 64 20 74 68 65 20 6e 75 6d 62 65 ze and the numbe
117d0 72 20 6f 66 20 72 65 73 65 72 76 65 64 20 62 79 r of reserved by
117e0 74 65 73 20 70 65 72 20 70 61 67 65 2e 0a 2a 2a tes per page..**
117f0 20 4f 72 2c 20 69 66 20 74 68 65 20 70 61 67 65 Or, if the page
11800 20 73 69 7a 65 20 68 61 73 20 61 6c 72 65 61 64 size has alread
11810 79 20 62 65 65 6e 20 66 69 78 65 64 2c 20 72 65 y been fixed, re
11820 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 turn SQLITE_READ
11830 4f 4e 4c 59 20 0a 2a 2a 20 77 69 74 68 6f 75 74 ONLY .** without
11840 20 63 68 61 6e 67 69 6e 67 20 61 6e 79 74 68 69 changing anythi
11850 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 61 ng..**.** The pa
11860 67 65 20 73 69 7a 65 20 6d 75 73 74 20 62 65 20 ge size must be
11870 61 20 70 6f 77 65 72 20 6f 66 20 32 20 62 65 74 a power of 2 bet
11880 77 65 65 6e 20 35 31 32 20 61 6e 64 20 36 35 35 ween 512 and 655
11890 33 36 2e 20 20 49 66 20 74 68 65 20 70 61 67 65 36. If the page
118a0 0a 2a 2a 20 73 69 7a 65 20 73 75 70 70 6c 69 65 .** size supplie
118b0 64 20 64 6f 65 73 20 6e 6f 74 20 6d 65 65 74 20 d does not meet
118c0 74 68 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 20 this constraint
118d0 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 73 69 then the page si
118e0 7a 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 63 68 61 ze is not.** cha
118f0 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 50 61 67 65 nged..**.** Page
11900 20 73 69 7a 65 73 20 61 72 65 20 63 6f 6e 73 74 sizes are const
11910 72 61 69 6e 65 64 20 74 6f 20 62 65 20 61 20 70 rained to be a p
11920 6f 77 65 72 20 6f 66 20 74 77 6f 20 73 6f 20 74 ower of two so t
11930 68 61 74 20 74 68 65 20 72 65 67 69 6f 6e 0a 2a hat the region.*
11940 2a 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 * of the databas
11950 65 20 66 69 6c 65 20 75 73 65 64 20 66 6f 72 20 e file used for
11960 6c 6f 63 6b 69 6e 67 20 28 62 65 67 69 6e 6e 69 locking (beginni
11970 6e 67 20 61 74 20 50 45 4e 44 49 4e 47 5f 42 59 ng at PENDING_BY
11980 54 45 2c 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 TE,.** the first
11990 20 62 79 74 65 20 70 61 73 74 20 74 68 65 20 31 byte past the 1
119a0 47 42 20 62 6f 75 6e 64 61 72 79 2c 20 30 78 34 GB boundary, 0x4
119b0 30 30 30 30 30 30 30 29 20 6e 65 65 64 73 20 74 0000000) needs t
119c0 6f 20 6f 63 63 75 72 0a 2a 2a 20 61 74 20 74 68 o occur.** at th
119d0 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 61 e beginning of a
119e0 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 page..**.** If
119f0 70 61 72 61 6d 65 74 65 72 20 6e 52 65 73 65 72 parameter nReser
11a00 76 65 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 ve is less than
11a10 7a 65 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 6e zero, then the n
11a20 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 76 65 umber of reserve
11a30 64 0a 2a 2a 20 62 79 74 65 73 20 70 65 72 20 70 d.** bytes per p
11a40 61 67 65 20 69 73 20 6c 65 66 74 20 75 6e 63 68 age is left unch
11a50 61 6e 67 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 anged..**.** If
11a60 74 68 65 20 69 46 69 78 21 3d 30 20 74 68 65 6e the iFix!=0 then
11a70 20 74 68 65 20 42 54 53 5f 50 41 47 45 53 49 5a the BTS_PAGESIZ
11a80 45 5f 46 49 58 45 44 20 66 6c 61 67 20 69 73 20 E_FIXED flag is
11a90 73 65 74 20 73 6f 20 74 68 61 74 20 74 68 65 20 set so that the
11aa0 70 61 67 65 20 73 69 7a 65 0a 2a 2a 20 61 6e 64 page size.** and
11ab0 20 61 75 74 6f 76 61 63 75 75 6d 20 6d 6f 64 65 autovacuum mode
11ac0 20 63 61 6e 20 6e 6f 20 6c 6f 6e 67 65 72 20 62 can no longer b
11ad0 65 20 63 68 61 6e 67 65 64 2e 0a 2a 2f 0a 69 6e e changed..*/.in
11ae0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 t sqlite3BtreeSe
11af0 74 50 61 67 65 53 69 7a 65 28 42 74 72 65 65 20 tPageSize(Btree
11b00 2a 70 2c 20 69 6e 74 20 70 61 67 65 53 69 7a 65 *p, int pageSize
11b10 2c 20 69 6e 74 20 6e 52 65 73 65 72 76 65 2c 20 , int nReserve,
11b20 69 6e 74 20 69 46 69 78 29 7b 0a 20 20 69 6e 74 int iFix){. int
11b30 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
11b40 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
11b50 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 61 73 73 = p->pBt;. ass
11b60 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e 3d 2d ert( nReserve>=-
11b70 31 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d 32 1 && nReserve<=2
11b80 35 35 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 55 );. sqlite3B
11b90 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 treeEnter(p);.
11ba0 69 66 28 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 if( pBt->btsFlag
11bb0 73 20 26 20 42 54 53 5f 50 41 47 45 53 49 5a 45 s & BTS_PAGESIZE
11bc0 5f 46 49 58 45 44 20 29 7b 0a 20 20 20 20 73 71 _FIXED ){. sq
11bd0 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 lite3BtreeLeave(
11be0 70 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 p);. return S
11bf0 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a QLITE_READONLY;.
11c00 20 20 7d 0a 20 20 69 66 28 20 6e 52 65 73 65 72 }. if( nReser
11c10 76 65 3c 30 20 29 7b 0a 20 20 20 20 6e 52 65 73 ve<0 ){. nRes
11c20 65 72 76 65 20 3d 20 70 42 74 2d 3e 70 61 67 65 erve = pBt->page
11c30 53 69 7a 65 20 2d 20 70 42 74 2d 3e 75 73 61 62 Size - pBt->usab
11c40 6c 65 53 69 7a 65 3b 0a 20 20 7d 0a 20 20 61 73 leSize;. }. as
11c50 73 65 72 74 28 20 6e 52 65 73 65 72 76 65 3e 3d sert( nReserve>=
11c60 30 20 26 26 20 6e 52 65 73 65 72 76 65 3c 3d 32 0 && nReserve<=2
11c70 35 35 20 29 3b 0a 20 20 69 66 28 20 70 61 67 65 55 );. if( page
11c80 53 69 7a 65 3e 3d 35 31 32 20 26 26 20 70 61 67 Size>=512 && pag
11c90 65 53 69 7a 65 3c 3d 53 51 4c 49 54 45 5f 4d 41 eSize<=SQLITE_MA
11ca0 58 5f 50 41 47 45 5f 53 49 5a 45 20 26 26 0a 20 X_PAGE_SIZE &&.
11cb0 20 20 20 20 20 20 20 28 28 70 61 67 65 53 69 7a ((pageSiz
11cc0 65 2d 31 29 26 70 61 67 65 53 69 7a 65 29 3d 3d e-1)&pageSize)==
11cd0 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 0 ){. assert(
11ce0 20 28 70 61 67 65 53 69 7a 65 20 26 20 37 29 3d (pageSize & 7)=
11cf0 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 =0 );. assert
11d00 28 20 21 70 42 74 2d 3e 70 50 61 67 65 31 20 26 ( !pBt->pPage1 &
11d10 26 20 21 70 42 74 2d 3e 70 43 75 72 73 6f 72 20 & !pBt->pCursor
11d20 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 61 67 65 );. pBt->page
11d30 53 69 7a 65 20 3d 20 28 75 33 32 29 70 61 67 65 Size = (u32)page
11d40 53 69 7a 65 3b 0a 20 20 20 20 66 72 65 65 54 65 Size;. freeTe
11d50 6d 70 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 mpSpace(pBt);.
11d60 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 }. rc = sqlite3
11d70 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
11d80 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 (pBt->pPager, &p
11d90 42 74 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6e 52 Bt->pageSize, nR
11da0 65 73 65 72 76 65 29 3b 0a 20 20 70 42 74 2d 3e eserve);. pBt->
11db0 75 73 61 62 6c 65 53 69 7a 65 20 3d 20 70 42 74 usableSize = pBt
11dc0 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 28 75 31 ->pageSize - (u1
11dd0 36 29 6e 52 65 73 65 72 76 65 3b 0a 20 20 69 66 6)nReserve;. if
11de0 28 20 69 46 69 78 20 29 20 70 42 74 2d 3e 62 74 ( iFix ) pBt->bt
11df0 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 sFlags |= BTS_PA
11e00 47 45 53 49 5a 45 5f 46 49 58 45 44 3b 0a 20 20 GESIZE_FIXED;.
11e10 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
11e20 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
11e30 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 c;.}../*.** Retu
11e40 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 rn the currently
11e50 20 64 65 66 69 6e 65 64 20 70 61 67 65 20 73 69 defined page si
11e60 7a 65 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 ze.*/.int sqlite
11e70 33 42 74 72 65 65 47 65 74 50 61 67 65 53 69 7a 3BtreeGetPageSiz
11e80 65 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 72 e(Btree *p){. r
11e90 65 74 75 72 6e 20 70 2d 3e 70 42 74 2d 3e 70 61 eturn p->pBt->pa
11ea0 67 65 53 69 7a 65 3b 0a 7d 0a 0a 23 69 66 20 64 geSize;.}..#if d
11eb0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 48 41 efined(SQLITE_HA
11ec0 53 5f 43 4f 44 45 43 29 20 7c 7c 20 64 65 66 69 S_CODEC) || defi
11ed0 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
11ee0 29 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e )./*.** This fun
11ef0 63 74 69 6f 6e 20 69 73 20 73 69 6d 69 6c 61 72 ction is similar
11f00 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 to sqlite3Btree
11f10 47 65 74 52 65 73 65 72 76 65 28 29 2c 20 65 78 GetReserve(), ex
11f20 63 65 70 74 20 74 68 61 74 20 69 74 0a 2a 2a 20 cept that it.**
11f30 6d 61 79 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c may only be call
11f40 65 64 20 69 66 20 69 74 20 69 73 20 67 75 61 72 ed if it is guar
11f50 61 6e 74 65 65 64 20 74 68 61 74 20 74 68 65 20 anteed that the
11f60 62 2d 74 72 65 65 20 6d 75 74 65 78 20 69 73 20 b-tree mutex is
11f70 61 6c 72 65 61 64 79 0a 2a 2a 20 68 65 6c 64 2e already.** held.
11f80 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 75 .**.** This is u
11f90 73 65 66 75 6c 20 69 6e 20 6f 6e 65 20 73 70 65 seful in one spe
11fa0 63 69 61 6c 20 63 61 73 65 20 69 6e 20 74 68 65 cial case in the
11fb0 20 62 61 63 6b 75 70 20 41 50 49 20 63 6f 64 65 backup API code
11fc0 20 77 68 65 72 65 20 69 74 20 69 73 0a 2a 2a 20 where it is.**
11fd0 6b 6e 6f 77 6e 20 74 68 61 74 20 74 68 65 20 73 known that the s
11fe0 68 61 72 65 64 20 62 2d 74 72 65 65 20 6d 75 74 hared b-tree mut
11ff0 65 78 20 69 73 20 68 65 6c 64 2c 20 62 75 74 20 ex is held, but
12000 74 68 65 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 the mutex on the
12010 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 68 61 .** database ha
12020 6e 64 6c 65 20 74 68 61 74 20 6f 77 6e 73 20 2a ndle that owns *
12030 70 20 69 73 20 6e 6f 74 2e 20 49 6e 20 74 68 69 p is not. In thi
12040 73 20 63 61 73 65 20 69 66 20 73 71 6c 69 74 65 s case if sqlite
12050 33 42 74 72 65 65 45 6e 74 65 72 28 29 0a 2a 2a 3BtreeEnter().**
12060 20 77 65 72 65 20 74 6f 20 62 65 20 63 61 6c 6c were to be call
12070 65 64 2c 20 69 74 20 6d 69 67 68 74 20 63 6f 6c ed, it might col
12080 6c 69 64 65 20 77 69 74 68 20 73 6f 6d 65 20 6f lide with some o
12090 74 68 65 72 20 6f 70 65 72 61 74 69 6f 6e 20 6f ther operation o
120a0 6e 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 n the.** databas
120b0 65 20 68 61 6e 64 6c 65 20 74 68 61 74 20 6f 77 e handle that ow
120c0 6e 73 20 2a 70 2c 20 63 61 75 73 69 6e 67 20 75 ns *p, causing u
120d0 6e 64 65 66 69 6e 65 64 20 62 65 68 61 76 69 6f ndefined behavio
120e0 75 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ur..*/.int sqlit
120f0 65 33 42 74 72 65 65 47 65 74 52 65 73 65 72 76 e3BtreeGetReserv
12100 65 4e 6f 4d 75 74 65 78 28 42 74 72 65 65 20 2a eNoMutex(Btree *
12110 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 73 71 p){. assert( sq
12120 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
12130 28 70 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 (p->pBt->mutex)
12140 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 70 );. return p->p
12150 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 Bt->pageSize - p
12160 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a ->pBt->usableSiz
12170 65 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 e;.}.#endif /* S
12180 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 20 QLITE_HAS_CODEC
12190 7c 7c 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 || SQLITE_DEBUG
121a0 2a 2f 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 */..#if !defined
121b0 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 41 47 (SQLITE_OMIT_PAG
121c0 45 52 5f 50 52 41 47 4d 41 53 29 20 7c 7c 20 21 ER_PRAGMAS) || !
121d0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
121e0 4d 49 54 5f 56 41 43 55 55 4d 29 0a 2f 2a 0a 2a MIT_VACUUM)./*.*
121f0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
12200 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
12210 73 70 61 63 65 20 61 74 20 74 68 65 20 65 6e 64 space at the end
12220 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 20 74 of every page t
12230 68 61 74 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e hat.** are inten
12240 74 75 61 6c 6c 79 20 6c 65 66 74 20 75 6e 75 73 tually left unus
12250 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 65 ed. This is the
12260 20 22 72 65 73 65 72 76 65 64 22 20 73 70 61 63 "reserved" spac
12270 65 20 74 68 61 74 20 69 73 0a 2a 2a 20 73 6f 6d e that is.** som
12280 65 74 69 6d 65 73 20 75 73 65 64 20 62 79 20 65 etimes used by e
12290 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e xtensions..*/.in
122a0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 t sqlite3BtreeGe
122b0 74 52 65 73 65 72 76 65 28 42 74 72 65 65 20 2a tReserve(Btree *
122c0 70 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 73 p){. int n;. s
122d0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
122e0 28 70 29 3b 0a 20 20 6e 20 3d 20 70 2d 3e 70 42 (p);. n = p->pB
122f0 74 2d 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 2d t->pageSize - p-
12300 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 >pBt->usableSize
12310 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
12320 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
12330 72 6e 20 6e 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 rn n;.}../*.** S
12340 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 et the maximum p
12350 61 67 65 20 63 6f 75 6e 74 20 66 6f 72 20 61 20 age count for a
12360 64 61 74 61 62 61 73 65 20 69 66 20 6d 78 50 61 database if mxPa
12370 67 65 20 69 73 20 70 6f 73 69 74 69 76 65 2e 0a ge is positive..
12380 2a 2a 20 4e 6f 20 63 68 61 6e 67 65 73 20 61 72 ** No changes ar
12390 65 20 6d 61 64 65 20 69 66 20 6d 78 50 61 67 65 e made if mxPage
123a0 20 69 73 20 30 20 6f 72 20 6e 65 67 61 74 69 76 is 0 or negativ
123b0 65 2e 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 e..** Regardless
123c0 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 6f 66 of the value of
123d0 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 6e 20 mxPage, return
123e0 74 68 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 the maximum page
123f0 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 count..*/.int s
12400 71 6c 69 74 65 33 42 74 72 65 65 4d 61 78 50 61 qlite3BtreeMaxPa
12410 67 65 43 6f 75 6e 74 28 42 74 72 65 65 20 2a 70 geCount(Btree *p
12420 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 , int mxPage){.
12430 20 69 6e 74 20 6e 3b 0a 20 20 73 71 6c 69 74 65 int n;. sqlite
12440 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 3BtreeEnter(p);.
12450 20 20 6e 20 3d 20 73 71 6c 69 74 65 33 50 61 67 n = sqlite3Pag
12460 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 28 70 erMaxPageCount(p
12470 2d 3e 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6d ->pBt->pPager, m
12480 78 50 61 67 65 29 3b 0a 20 20 73 71 6c 69 74 65 xPage);. sqlite
12490 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 3BtreeLeave(p);.
124a0 20 20 72 65 74 75 72 6e 20 6e 3b 0a 7d 0a 0a 2f return n;.}../
124b0 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 42 54 53 *.** Set the BTS
124c0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 66 _SECURE_DELETE f
124d0 6c 61 67 20 69 66 20 6e 65 77 46 6c 61 67 20 69 lag if newFlag i
124e0 73 20 30 20 6f 72 20 31 2e 20 20 49 66 20 6e 65 s 0 or 1. If ne
124f0 77 46 6c 61 67 20 69 73 20 2d 31 2c 0a 2a 2a 20 wFlag is -1,.**
12500 74 68 65 6e 20 6d 61 6b 65 20 6e 6f 20 63 68 61 then make no cha
12510 6e 67 65 73 2e 20 20 41 6c 77 61 79 73 20 72 65 nges. Always re
12520 74 75 72 6e 20 74 68 65 20 76 61 6c 75 65 20 6f turn the value o
12530 66 20 74 68 65 20 42 54 53 5f 53 45 43 55 52 45 f the BTS_SECURE
12540 5f 44 45 4c 45 54 45 0a 2a 2a 20 73 65 74 74 69 _DELETE.** setti
12550 6e 67 20 61 66 74 65 72 20 74 68 65 20 63 68 61 ng after the cha
12560 6e 67 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 nge..*/.int sqli
12570 74 65 33 42 74 72 65 65 53 65 63 75 72 65 44 65 te3BtreeSecureDe
12580 6c 65 74 65 28 42 74 72 65 65 20 2a 70 2c 20 69 lete(Btree *p, i
12590 6e 74 20 6e 65 77 46 6c 61 67 29 7b 0a 20 20 69 nt newFlag){. i
125a0 6e 74 20 62 3b 0a 20 20 69 66 28 20 70 3d 3d 30 nt b;. if( p==0
125b0 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 73 ) return 0;. s
125c0 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
125d0 28 70 29 3b 0a 20 20 69 66 28 20 6e 65 77 46 6c (p);. if( newFl
125e0 61 67 3e 3d 30 20 29 7b 0a 20 20 20 20 70 2d 3e ag>=0 ){. p->
125f0 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 3d pBt->btsFlags &=
12600 20 7e 42 54 53 5f 53 45 43 55 52 45 5f 44 45 4c ~BTS_SECURE_DEL
12610 45 54 45 3b 0a 20 20 20 20 69 66 28 20 6e 65 77 ETE;. if( new
12620 46 6c 61 67 20 29 20 70 2d 3e 70 42 74 2d 3e 62 Flag ) p->pBt->b
12630 74 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 53 tsFlags |= BTS_S
12640 45 43 55 52 45 5f 44 45 4c 45 54 45 3b 0a 20 20 ECURE_DELETE;.
12650 7d 20 0a 20 20 62 20 3d 20 28 70 2d 3e 70 42 74 } . b = (p->pBt
12660 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
12670 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 29 21 _SECURE_DELETE)!
12680 3d 30 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 =0;. sqlite3Btr
12690 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 eeLeave(p);. re
126a0 74 75 72 6e 20 62 3b 0a 7d 0a 23 65 6e 64 69 66 turn b;.}.#endif
126b0 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 53 51 4c /* !defined(SQL
126c0 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 ITE_OMIT_PAGER_P
126d0 52 41 47 4d 41 53 29 20 7c 7c 20 21 64 65 66 69 RAGMAS) || !defi
126e0 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
126f0 56 41 43 55 55 4d 29 20 2a 2f 0a 0a 2f 2a 0a 2a VACUUM) */../*.*
12700 2a 20 43 68 61 6e 67 65 20 74 68 65 20 27 61 75 * Change the 'au
12710 74 6f 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 to-vacuum' prope
12720 72 74 79 20 6f 66 20 74 68 65 20 64 61 74 61 62 rty of the datab
12730 61 73 65 2e 20 49 66 20 74 68 65 20 27 61 75 74 ase. If the 'aut
12740 6f 56 61 63 75 75 6d 27 0a 2a 2a 20 70 61 72 61 oVacuum'.** para
12750 6d 65 74 65 72 20 69 73 20 6e 6f 6e 2d 7a 65 72 meter is non-zer
12760 6f 2c 20 74 68 65 6e 20 61 75 74 6f 2d 76 61 63 o, then auto-vac
12770 75 75 6d 20 6d 6f 64 65 20 69 73 20 65 6e 61 62 uum mode is enab
12780 6c 65 64 2e 20 49 66 20 7a 65 72 6f 2c 20 69 74 led. If zero, it
12790 0a 2a 2a 20 69 73 20 64 69 73 61 62 6c 65 64 2e .** is disabled.
127a0 20 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c The default val
127b0 75 65 20 66 6f 72 20 74 68 65 20 61 75 74 6f 2d ue for the auto-
127c0 76 61 63 75 75 6d 20 70 72 6f 70 65 72 74 79 20 vacuum property
127d0 69 73 20 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 is .** determine
127e0 64 20 62 79 20 74 68 65 20 53 51 4c 49 54 45 5f d by the SQLITE_
127f0 44 45 46 41 55 4c 54 5f 41 55 54 4f 56 41 43 55 DEFAULT_AUTOVACU
12800 55 4d 20 6d 61 63 72 6f 2e 0a 2a 2f 0a 69 6e 74 UM macro..*/.int
12810 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 65 74 sqlite3BtreeSet
12820 41 75 74 6f 56 61 63 75 75 6d 28 42 74 72 65 65 AutoVacuum(Btree
12830 20 2a 70 2c 20 69 6e 74 20 61 75 74 6f 56 61 63 *p, int autoVac
12840 75 75 6d 29 7b 0a 23 69 66 64 65 66 20 53 51 4c uum){.#ifdef SQL
12850 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
12860 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c UUM. return SQL
12870 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a 23 65 ITE_READONLY;.#e
12880 6c 73 65 0a 20 20 42 74 53 68 61 72 65 64 20 2a lse. BtShared *
12890 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
128a0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
128b0 4f 4b 3b 0a 20 20 75 38 20 61 76 20 3d 20 28 75 OK;. u8 av = (u
128c0 38 29 61 75 74 6f 56 61 63 75 75 6d 3b 0a 0a 20 8)autoVacuum;..
128d0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
128e0 65 72 28 70 29 3b 0a 20 20 69 66 28 20 28 70 42 er(p);. if( (pB
128f0 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
12900 53 5f 50 41 47 45 53 49 5a 45 5f 46 49 58 45 44 S_PAGESIZE_FIXED
12910 29 21 3d 30 20 26 26 20 28 61 76 20 3f 31 3a 30 )!=0 && (av ?1:0
12920 29 21 3d 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 )!=pBt->autoVacu
12930 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 um ){. rc = S
12940 51 4c 49 54 45 5f 52 45 41 44 4f 4e 4c 59 3b 0a QLITE_READONLY;.
12950 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 42 74 }else{. pBt
12960 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 3d 20 61 ->autoVacuum = a
12970 76 20 3f 31 3a 30 3b 0a 20 20 20 20 70 42 74 2d v ?1:0;. pBt-
12980 3e 69 6e 63 72 56 61 63 75 75 6d 20 3d 20 61 76 >incrVacuum = av
12990 3d 3d 32 20 3f 31 3a 30 3b 0a 20 20 7d 0a 20 20 ==2 ?1:0;. }.
129a0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
129b0 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
129c0 63 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a c;.#endif.}../*.
129d0 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 76 61 ** Return the va
129e0 6c 75 65 20 6f 66 20 74 68 65 20 27 61 75 74 6f lue of the 'auto
129f0 2d 76 61 63 75 75 6d 27 20 70 72 6f 70 65 72 74 -vacuum' propert
12a00 79 2e 20 49 66 20 61 75 74 6f 2d 76 61 63 75 75 y. If auto-vacuu
12a10 6d 20 69 73 20 0a 2a 2a 20 65 6e 61 62 6c 65 64 m is .** enabled
12a20 20 31 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 1 is returned.
12a30 4f 74 68 65 72 77 69 73 65 20 30 2e 0a 2a 2f 0a Otherwise 0..*/.
12a40 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 int sqlite3Btree
12a50 47 65 74 41 75 74 6f 56 61 63 75 75 6d 28 42 74 GetAutoVacuum(Bt
12a60 72 65 65 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 ree *p){.#ifdef
12a70 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
12a80 56 41 43 55 55 4d 0a 20 20 72 65 74 75 72 6e 20 VACUUM. return
12a90 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d BTREE_AUTOVACUUM
12aa0 5f 4e 4f 4e 45 3b 0a 23 65 6c 73 65 0a 20 20 69 _NONE;.#else. i
12ab0 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 nt rc;. sqlite3
12ac0 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
12ad0 20 72 63 20 3d 20 28 0a 20 20 20 20 28 21 70 2d rc = (. (!p-
12ae0 3e 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d >pBt->autoVacuum
12af0 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 55 )?BTREE_AUTOVACU
12b00 55 4d 5f 4e 4f 4e 45 3a 0a 20 20 20 20 28 21 70 UM_NONE:. (!p
12b10 2d 3e 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 ->pBt->incrVacuu
12b20 6d 29 3f 42 54 52 45 45 5f 41 55 54 4f 56 41 43 m)?BTREE_AUTOVAC
12b30 55 55 4d 5f 46 55 4c 4c 3a 0a 20 20 20 20 42 54 UUM_FULL:. BT
12b40 52 45 45 5f 41 55 54 4f 56 41 43 55 55 4d 5f 49 REE_AUTOVACUUM_I
12b50 4e 43 52 0a 20 20 29 3b 0a 20 20 73 71 6c 69 74 NCR. );. sqlit
12b60 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b e3BtreeLeave(p);
12b70 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 23 65 . return rc;.#e
12b80 6e 64 69 66 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 47 ndif.}.../*.** G
12b90 65 74 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 et a reference t
12ba0 6f 20 70 50 61 67 65 31 20 6f 66 20 74 68 65 20 o pPage1 of the
12bb0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
12bc0 54 68 69 73 20 77 69 6c 6c 0a 2a 2a 20 61 6c 73 This will.** als
12bd0 6f 20 61 63 71 75 69 72 65 20 61 20 72 65 61 64 o acquire a read
12be0 6c 6f 63 6b 20 6f 6e 20 74 68 61 74 20 66 69 6c lock on that fil
12bf0 65 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f e..**.** SQLITE_
12c00 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f OK is returned o
12c10 6e 20 73 75 63 63 65 73 73 2e 20 20 49 66 20 74 n success. If t
12c20 68 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 he file is not a
12c30 0a 2a 2a 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 .** well-formed
12c40 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 database file, t
12c50 68 65 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 hen SQLITE_CORRU
12c60 50 54 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a PT is returned..
12c70 2a 2a 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 ** SQLITE_BUSY i
12c80 73 20 72 65 74 75 72 6e 65 64 20 69 66 20 74 68 s returned if th
12c90 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f e database is lo
12ca0 63 6b 65 64 2e 20 20 53 51 4c 49 54 45 5f 4e 4f cked. SQLITE_NO
12cb0 4d 45 4d 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e MEM.** is return
12cc0 65 64 20 69 66 20 77 65 20 72 75 6e 20 6f 75 74 ed if we run out
12cd0 20 6f 66 20 6d 65 6d 6f 72 79 2e 20 0a 2a 2f 0a of memory. .*/.
12ce0 73 74 61 74 69 63 20 69 6e 74 20 6c 6f 63 6b 42 static int lockB
12cf0 74 72 65 65 28 42 74 53 68 61 72 65 64 20 2a 70 tree(BtShared *p
12d00 42 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 Bt){. int rc;
12d10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
12d20 65 73 75 6c 74 20 63 6f 64 65 20 66 72 6f 6d 20 esult code from
12d30 73 75 62 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a subfunctions */.
12d40 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
12d50 31 3b 20 20 20 20 20 2f 2a 20 50 61 67 65 20 31 1; /* Page 1
12d60 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
12d70 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e file */. int n
12d80 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
12d90 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
12da0 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 es in the databa
12db0 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 se */. int nPag
12dc0 65 46 69 6c 65 20 3d 20 30 3b 20 20 20 2f 2a 20 eFile = 0; /*
12dd0 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
12de0 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
12df0 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 file */. int nP
12e00 61 67 65 48 65 61 64 65 72 3b 20 20 20 20 20 2f ageHeader; /
12e10 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
12e20 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 s in the databas
12e30 65 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 68 e according to h
12e40 64 72 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 dr */.. assert(
12e50 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
12e60 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
12e70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 );. assert( pBt
12e80 2d 3e 70 50 61 67 65 31 3d 3d 30 20 29 3b 0a 20 ->pPage1==0 );.
12e90 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
12ea0 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 70 42 74 erSharedLock(pBt
12eb0 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 ->pPager);. if(
12ec0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
12ed0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 return rc;. rc
12ee0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
12ef0 70 42 74 2c 20 31 2c 20 26 70 50 61 67 65 31 2c pBt, 1, &pPage1,
12f00 20 30 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 0);. if( rc!=S
12f10 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 QLITE_OK ) retur
12f20 6e 20 72 63 3b 0a 0a 20 20 2f 2a 20 44 6f 20 73 n rc;.. /* Do s
12f30 6f 6d 65 20 63 68 65 63 6b 69 6e 67 20 74 6f 20 ome checking to
12f40 68 65 6c 70 20 69 6e 73 75 72 65 20 74 68 65 20 help insure the
12f50 66 69 6c 65 20 77 65 20 6f 70 65 6e 65 64 20 72 file we opened r
12f60 65 61 6c 6c 79 20 69 73 0a 20 20 2a 2a 20 61 20 eally is. ** a
12f70 76 61 6c 69 64 20 64 61 74 61 62 61 73 65 20 66 valid database f
12f80 69 6c 65 2e 20 0a 20 20 2a 2f 0a 20 20 6e 50 61 ile. . */. nPa
12f90 67 65 20 3d 20 6e 50 61 67 65 48 65 61 64 65 72 ge = nPageHeader
12fa0 20 3d 20 67 65 74 34 62 79 74 65 28 32 38 2b 28 = get4byte(28+(
12fb0 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 44 61 74 u8*)pPage1->aDat
12fc0 61 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 67 a);. sqlite3Pag
12fd0 65 72 50 61 67 65 63 6f 75 6e 74 28 70 42 74 2d erPagecount(pBt-
12fe0 3e 70 50 61 67 65 72 2c 20 26 6e 50 61 67 65 46 >pPager, &nPageF
12ff0 69 6c 65 29 3b 0a 20 20 69 66 28 20 6e 50 61 67 ile);. if( nPag
13000 65 3d 3d 30 20 7c 7c 20 6d 65 6d 63 6d 70 28 32 e==0 || memcmp(2
13010 34 2b 28 75 38 2a 29 70 50 61 67 65 31 2d 3e 61 4+(u8*)pPage1->a
13020 44 61 74 61 2c 20 39 32 2b 28 75 38 2a 29 70 50 Data, 92+(u8*)pP
13030 61 67 65 31 2d 3e 61 44 61 74 61 2c 34 29 21 3d age1->aData,4)!=
13040 30 20 29 7b 0a 20 20 20 20 6e 50 61 67 65 20 3d 0 ){. nPage =
13050 20 6e 50 61 67 65 46 69 6c 65 3b 0a 20 20 7d 0a nPageFile;. }.
13060 20 20 69 66 28 20 6e 50 61 67 65 3e 30 20 29 7b if( nPage>0 ){
13070 0a 20 20 20 20 75 33 32 20 70 61 67 65 53 69 7a . u32 pageSiz
13080 65 3b 0a 20 20 20 20 75 33 32 20 75 73 61 62 6c e;. u32 usabl
13090 65 53 69 7a 65 3b 0a 20 20 20 20 75 38 20 2a 70 eSize;. u8 *p
130a0 61 67 65 31 20 3d 20 70 50 61 67 65 31 2d 3e 61 age1 = pPage1->a
130b0 44 61 74 61 3b 0a 20 20 20 20 72 63 20 3d 20 53 Data;. rc = S
130c0 51 4c 49 54 45 5f 4e 4f 54 41 44 42 3b 0a 20 20 QLITE_NOTADB;.
130d0 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 70 61 67 if( memcmp(pag
130e0 65 31 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 72 e1, zMagicHeader
130f0 2c 20 31 36 29 21 3d 30 20 29 7b 0a 20 20 20 20 , 16)!=0 ){.
13100 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 goto page1_ini
13110 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a t_failed;. }.
13120 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
13130 4d 49 54 5f 57 41 4c 0a 20 20 20 20 69 66 28 20 MIT_WAL. if(
13140 70 61 67 65 31 5b 31 38 5d 3e 31 20 29 7b 0a 20 page1[18]>1 ){.
13150 20 20 20 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 pBt->btsFla
13160 67 73 20 7c 3d 20 42 54 53 5f 52 45 41 44 5f 4f gs |= BTS_READ_O
13170 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 NLY;. }. i
13180 66 28 20 70 61 67 65 31 5b 31 39 5d 3e 31 20 29 f( page1[19]>1 )
13190 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
131a0 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
131b0 20 20 20 20 7d 0a 23 65 6c 73 65 0a 20 20 20 20 }.#else.
131c0 69 66 28 20 70 61 67 65 31 5b 31 38 5d 3e 32 20 if( page1[18]>2
131d0 29 7b 0a 20 20 20 20 20 20 70 42 74 2d 3e 62 74 ){. pBt->bt
131e0 73 46 6c 61 67 73 20 7c 3d 20 42 54 53 5f 52 45 sFlags |= BTS_RE
131f0 41 44 5f 4f 4e 4c 59 3b 0a 20 20 20 20 7d 0a 20 AD_ONLY;. }.
13200 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
13210 3e 32 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f >2 ){. goto
13220 20 70 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c page1_init_fail
13230 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f ed;. }.. /
13240 2a 20 49 66 20 74 68 65 20 77 72 69 74 65 20 76 * If the write v
13250 65 72 73 69 6f 6e 20 69 73 20 73 65 74 20 74 6f ersion is set to
13260 20 32 2c 20 74 68 69 73 20 64 61 74 61 62 61 73 2, this databas
13270 65 20 73 68 6f 75 6c 64 20 62 65 20 61 63 63 65 e should be acce
13280 73 73 65 64 0a 20 20 20 20 2a 2a 20 69 6e 20 57 ssed. ** in W
13290 41 4c 20 6d 6f 64 65 2e 20 49 66 20 74 68 65 20 AL mode. If the
132a0 6c 6f 67 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 log is not alrea
132b0 64 79 20 6f 70 65 6e 2c 20 6f 70 65 6e 20 69 74 dy open, open it
132c0 20 6e 6f 77 2e 20 54 68 65 6e 20 0a 20 20 20 20 now. Then .
132d0 2a 2a 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ** return SQLITE
132e0 5f 4f 4b 20 61 6e 64 20 72 65 74 75 72 6e 20 77 _OK and return w
132f0 69 74 68 6f 75 74 20 70 6f 70 75 6c 61 74 69 6e ithout populatin
13300 67 20 42 74 53 68 61 72 65 64 2e 70 50 61 67 65 g BtShared.pPage
13310 31 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 63 61 1.. ** The ca
13320 6c 6c 65 72 20 64 65 74 65 63 74 73 20 74 68 69 ller detects thi
13330 73 20 61 6e 64 20 63 61 6c 6c 73 20 74 68 69 73 s and calls this
13340 20 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 2e function again.
13350 20 54 68 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 This is. **
13360 72 65 71 75 69 72 65 64 20 61 73 20 74 68 65 20 required as the
13370 76 65 72 73 69 6f 6e 20 6f 66 20 70 61 67 65 20 version of page
13380 31 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 1 currently in t
13390 68 65 20 70 61 67 65 31 20 62 75 66 66 65 72 0a he page1 buffer.
133a0 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 62 ** may not b
133b0 65 20 74 68 65 20 6c 61 74 65 73 74 20 76 65 72 e the latest ver
133c0 73 69 6f 6e 20 2d 20 74 68 65 72 65 20 6d 61 79 sion - there may
133d0 20 62 65 20 61 20 6e 65 77 65 72 20 6f 6e 65 20 be a newer one
133e0 69 6e 20 74 68 65 20 6c 6f 67 0a 20 20 20 20 2a in the log. *
133f0 2a 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 * file.. */.
13400 20 20 20 69 66 28 20 70 61 67 65 31 5b 31 39 5d if( page1[19]
13410 3d 3d 32 20 26 26 20 28 70 42 74 2d 3e 62 74 73 ==2 && (pBt->bts
13420 46 6c 61 67 73 20 26 20 42 54 53 5f 4e 4f 5f 57 Flags & BTS_NO_W
13430 41 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 AL)==0 ){.
13440 69 6e 74 20 69 73 4f 70 65 6e 20 3d 20 30 3b 0a int isOpen = 0;.
13450 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
13460 65 33 50 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 e3PagerOpenWal(p
13470 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 69 73 4f Bt->pPager, &isO
13480 70 65 6e 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pen);. if(
13490 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
134a0 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 70 61 . goto pa
134b0 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b ge1_init_failed;
134c0 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 . }else if(
134d0 20 69 73 4f 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 isOpen==0 ){.
134e0 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
134f0 65 28 70 50 61 67 65 31 29 3b 0a 20 20 20 20 20 e(pPage1);.
13500 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
13510 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 _OK;. }.
13520 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
13530 4f 54 41 44 42 3b 0a 20 20 20 20 7d 0a 23 65 6e OTADB;. }.#en
13540 64 69 66 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 dif.. /* The
13550 6d 61 78 69 6d 75 6d 20 65 6d 62 65 64 64 65 64 maximum embedded
13560 20 66 72 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 fraction must b
13570 65 20 65 78 61 63 74 6c 79 20 32 35 25 2e 20 20 e exactly 25%.
13580 41 6e 64 20 74 68 65 20 6d 69 6e 69 6d 75 6d 0a And the minimum.
13590 20 20 20 20 2a 2a 20 65 6d 62 65 64 64 65 64 20 ** embedded
135a0 66 72 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 fraction must be
135b0 20 31 32 2e 35 25 20 66 6f 72 20 62 6f 74 68 20 12.5% for both
135c0 6c 65 61 66 2d 64 61 74 61 20 61 6e 64 20 6e 6f leaf-data and no
135d0 6e 2d 6c 65 61 66 2d 64 61 74 61 2e 0a 20 20 20 n-leaf-data..
135e0 20 2a 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c ** The original
135f0 20 64 65 73 69 67 6e 20 61 6c 6c 6f 77 65 64 20 design allowed
13600 74 68 65 73 65 20 61 6d 6f 75 6e 74 73 20 74 6f these amounts to
13610 20 76 61 72 79 2c 20 62 75 74 20 61 73 20 6f 66 vary, but as of
13620 0a 20 20 20 20 2a 2a 20 76 65 72 73 69 6f 6e 20 . ** version
13630 33 2e 36 2e 30 2c 20 77 65 20 72 65 71 75 69 72 3.6.0, we requir
13640 65 20 74 68 65 6d 20 74 6f 20 62 65 20 66 69 78 e them to be fix
13650 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ed.. */. i
13660 66 28 20 6d 65 6d 63 6d 70 28 26 70 61 67 65 31 f( memcmp(&page1
13670 5b 32 31 5d 2c 20 22 5c 31 30 30 5c 30 34 30 5c [21], "\100\040\
13680 30 34 30 22 2c 33 29 21 3d 30 20 29 7b 0a 20 20 040",3)!=0 ){.
13690 20 20 20 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 goto page1_i
136a0 6e 69 74 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 nit_failed;.
136b0 7d 0a 20 20 20 20 70 61 67 65 53 69 7a 65 20 3d }. pageSize =
136c0 20 28 70 61 67 65 31 5b 31 36 5d 3c 3c 38 29 20 (page1[16]<<8)
136d0 7c 20 28 70 61 67 65 31 5b 31 37 5d 3c 3c 31 36 | (page1[17]<<16
136e0 29 3b 0a 20 20 20 20 69 66 28 20 28 28 70 61 67 );. if( ((pag
136f0 65 53 69 7a 65 2d 31 29 26 70 61 67 65 53 69 7a eSize-1)&pageSiz
13700 65 29 21 3d 30 0a 20 20 20 20 20 7c 7c 20 70 61 e)!=0. || pa
13710 67 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 geSize>SQLITE_MA
13720 58 5f 50 41 47 45 5f 53 49 5a 45 20 0a 20 20 20 X_PAGE_SIZE .
13730 20 20 7c 7c 20 70 61 67 65 53 69 7a 65 3c 3d 32 || pageSize<=2
13740 35 36 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 56 . ){.
13750 20 67 6f 74 6f 20 70 61 67 65 31 5f 69 6e 69 74 goto page1_init
13760 5f 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 20 _failed;. }.
13770 20 20 20 61 73 73 65 72 74 28 20 28 70 61 67 65 assert( (page
13780 53 69 7a 65 20 26 20 37 29 3d 3d 30 20 29 3b 0a Size & 7)==0 );.
13790 20 20 20 20 75 73 61 62 6c 65 53 69 7a 65 20 3d usableSize =
137a0 20 70 61 67 65 53 69 7a 65 20 2d 20 70 61 67 65 pageSize - page
137b0 31 5b 32 30 5d 3b 0a 20 20 20 20 69 66 28 20 28 1[20];. if( (
137c0 75 33 32 29 70 61 67 65 53 69 7a 65 21 3d 70 42 u32)pageSize!=pB
137d0 74 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a 20 t->pageSize ){.
137e0 20 20 20 20 20 2f 2a 20 41 66 74 65 72 20 72 65 /* After re
137f0 61 64 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 ading the first
13800 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 74 61 page of the data
13810 62 61 73 65 20 61 73 73 75 6d 69 6e 67 20 61 20 base assuming a
13820 70 61 67 65 20 73 69 7a 65 0a 20 20 20 20 20 20 page size.
13830 2a 2a 20 6f 66 20 42 74 53 68 61 72 65 64 2e 70 ** of BtShared.p
13840 61 67 65 53 69 7a 65 2c 20 77 65 20 68 61 76 65 ageSize, we have
13850 20 64 69 73 63 6f 76 65 72 65 64 20 74 68 61 74 discovered that
13860 20 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 69 the page-size i
13870 73 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 75 61 s. ** actua
13880 6c 6c 79 20 70 61 67 65 53 69 7a 65 2e 20 55 6e lly pageSize. Un
13890 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 73 lock the databas
138a0 65 2c 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 50 e, leave pBt->pP
138b0 61 67 65 31 20 61 74 0a 20 20 20 20 20 20 2a 2a age1 at. **
138c0 20 7a 65 72 6f 20 61 6e 64 20 72 65 74 75 72 6e zero and return
138d0 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 54 68 65 20 SQLITE_OK. The
138e0 63 61 6c 6c 65 72 20 77 69 6c 6c 20 63 61 6c 6c caller will call
138f0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 this function.
13900 20 20 20 20 20 2a 2a 20 61 67 61 69 6e 20 77 69 ** again wi
13910 74 68 20 74 68 65 20 63 6f 72 72 65 63 74 20 70 th the correct p
13920 61 67 65 2d 73 69 7a 65 2e 0a 20 20 20 20 20 20 age-size..
13930 2a 2f 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 */. release
13940 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a 20 20 Page(pPage1);.
13950 20 20 20 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 pBt->usableS
13960 69 7a 65 20 3d 20 75 73 61 62 6c 65 53 69 7a 65 ize = usableSize
13970 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 61 67 ;. pBt->pag
13980 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a 65 eSize = pageSize
13990 3b 0a 20 20 20 20 20 20 66 72 65 65 54 65 6d 70 ;. freeTemp
139a0 53 70 61 63 65 28 70 42 74 29 3b 0a 20 20 20 20 Space(pBt);.
139b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
139c0 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 gerSetPagesize(p
139d0 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 70 42 74 Bt->pPager, &pBt
139e0 2d 3e 70 61 67 65 53 69 7a 65 2c 0a 20 20 20 20 ->pageSize,.
139f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
13a10 61 67 65 53 69 7a 65 2d 75 73 61 62 6c 65 53 69 ageSize-usableSi
13a20 7a 65 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 ze);. retur
13a30 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n rc;. }.
13a40 69 66 28 20 28 70 42 74 2d 3e 64 62 2d 3e 66 6c if( (pBt->db->fl
13a50 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 63 ags & SQLITE_Rec
13a60 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 20 26 26 overyMode)==0 &&
13a70 20 6e 50 61 67 65 3e 6e 50 61 67 65 46 69 6c 65 nPage>nPageFile
13a80 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 ){. rc = S
13a90 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
13aa0 50 54 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 PT;. goto p
13ab0 61 67 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 age1_init_failed
13ac0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
13ad0 75 73 61 62 6c 65 53 69 7a 65 3c 34 38 30 20 29 usableSize<480 )
13ae0 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 {. goto pag
13af0 65 31 5f 69 6e 69 74 5f 66 61 69 6c 65 64 3b 0a e1_init_failed;.
13b00 20 20 20 20 7d 0a 20 20 20 20 70 42 74 2d 3e 70 }. pBt->p
13b10 61 67 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 ageSize = pageSi
13b20 7a 65 3b 0a 20 20 20 20 70 42 74 2d 3e 75 73 61 ze;. pBt->usa
13b30 62 6c 65 53 69 7a 65 20 3d 20 75 73 61 62 6c 65 bleSize = usable
13b40 53 69 7a 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 Size;.#ifndef SQ
13b50 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
13b60 43 55 55 4d 0a 20 20 20 20 70 42 74 2d 3e 61 75 CUUM. pBt->au
13b70 74 6f 56 61 63 75 75 6d 20 3d 20 28 67 65 74 34 toVacuum = (get4
13b80 62 79 74 65 28 26 70 61 67 65 31 5b 33 36 20 2b byte(&page1[36 +
13b90 20 34 2a 34 5d 29 3f 31 3a 30 29 3b 0a 20 20 20 4*4])?1:0);.
13ba0 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
13bb0 20 3d 20 28 67 65 74 34 62 79 74 65 28 26 70 61 = (get4byte(&pa
13bc0 67 65 31 5b 33 36 20 2b 20 37 2a 34 5d 29 3f 31 ge1[36 + 7*4])?1
13bd0 3a 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a :0);.#endif. }.
13be0 0a 20 20 2f 2a 20 6d 61 78 4c 6f 63 61 6c 20 69 . /* maxLocal i
13bf0 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 61 6d s the maximum am
13c00 6f 75 6e 74 20 6f 66 20 70 61 79 6c 6f 61 64 20 ount of payload
13c10 74 6f 20 73 74 6f 72 65 20 6c 6f 63 61 6c 6c 79 to store locally
13c20 20 66 6f 72 0a 20 20 2a 2a 20 61 20 63 65 6c 6c for. ** a cell
13c30 2e 20 20 4d 61 6b 65 20 73 75 72 65 20 69 74 20 . Make sure it
13c40 69 73 20 73 6d 61 6c 6c 20 65 6e 6f 75 67 68 20 is small enough
13c50 73 6f 20 74 68 61 74 20 61 74 20 6c 65 61 73 74 so that at least
13c60 20 6d 69 6e 46 61 6e 6f 75 74 0a 20 20 2a 2a 20 minFanout. **
13c70 63 65 6c 6c 73 20 63 61 6e 20 77 69 6c 6c 20 66 cells can will f
13c80 69 74 20 6f 6e 20 6f 6e 65 20 70 61 67 65 2e 20 it on one page.
13c90 20 57 65 20 61 73 73 75 6d 65 20 61 20 31 30 2d We assume a 10-
13ca0 62 79 74 65 20 70 61 67 65 20 68 65 61 64 65 72 byte page header
13cb0 2e 0a 20 20 2a 2a 20 42 65 73 69 64 65 73 20 74 .. ** Besides t
13cc0 68 65 20 70 61 79 6c 6f 61 64 2c 20 74 68 65 20 he payload, the
13cd0 63 65 6c 6c 20 6d 75 73 74 20 73 74 6f 72 65 3a cell must store:
13ce0 0a 20 20 2a 2a 20 20 20 20 20 32 2d 62 79 74 65 . ** 2-byte
13cf0 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
13d00 63 65 6c 6c 0a 20 20 2a 2a 20 20 20 20 20 34 2d cell. ** 4-
13d10 62 79 74 65 20 63 68 69 6c 64 20 70 6f 69 6e 74 byte child point
13d20 65 72 0a 20 20 2a 2a 20 20 20 20 20 39 2d 62 79 er. ** 9-by
13d30 74 65 20 6e 4b 65 79 20 76 61 6c 75 65 0a 20 20 te nKey value.
13d40 2a 2a 20 20 20 20 20 34 2d 62 79 74 65 20 6e 44 ** 4-byte nD
13d50 61 74 61 20 76 61 6c 75 65 0a 20 20 2a 2a 20 20 ata value. **
13d60 20 20 20 34 2d 62 79 74 65 20 6f 76 65 72 66 6c 4-byte overfl
13d70 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 0a ow page pointer.
13d80 20 20 2a 2a 20 53 6f 20 61 20 63 65 6c 6c 20 63 ** So a cell c
13d90 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 32 2d 62 onsists of a 2-b
13da0 79 74 65 20 70 6f 69 6e 74 65 72 2c 20 61 20 68 yte pointer, a h
13db0 65 61 64 65 72 20 77 68 69 63 68 20 69 73 20 61 eader which is a
13dc0 73 20 6d 75 63 68 20 61 73 0a 20 20 2a 2a 20 31 s much as. ** 1
13dd0 37 20 62 79 74 65 73 20 6c 6f 6e 67 2c 20 30 20 7 bytes long, 0
13de0 74 6f 20 4e 20 62 79 74 65 73 20 6f 66 20 70 61 to N bytes of pa
13df0 79 6c 6f 61 64 2c 20 61 6e 64 20 61 6e 20 6f 70 yload, and an op
13e00 74 69 6f 6e 61 6c 20 34 20 62 79 74 65 20 6f 76 tional 4 byte ov
13e10 65 72 66 6c 6f 77 0a 20 20 2a 2a 20 70 61 67 65 erflow. ** page
13e20 20 70 6f 69 6e 74 65 72 2e 0a 20 20 2a 2f 0a 20 pointer.. */.
13e30 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 20 3d pBt->maxLocal =
13e40 20 28 75 31 36 29 28 28 70 42 74 2d 3e 75 73 61 (u16)((pBt->usa
13e50 62 6c 65 53 69 7a 65 2d 31 32 29 2a 36 34 2f 32 bleSize-12)*64/2
13e60 35 35 20 2d 20 32 33 29 3b 0a 20 20 70 42 74 2d 55 - 23);. pBt-
13e70 3e 6d 69 6e 4c 6f 63 61 6c 20 3d 20 28 75 31 36 >minLocal = (u16
13e80 29 28 28 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 )((pBt->usableSi
13e90 7a 65 2d 31 32 29 2a 33 32 2f 32 35 35 20 2d 20 ze-12)*32/255 -
13ea0 32 33 29 3b 0a 20 20 70 42 74 2d 3e 6d 61 78 4c 23);. pBt->maxL
13eb0 65 61 66 20 3d 20 28 75 31 36 29 28 70 42 74 2d eaf = (u16)(pBt-
13ec0 3e 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 33 35 >usableSize - 35
13ed0 29 3b 0a 20 20 70 42 74 2d 3e 6d 69 6e 4c 65 61 );. pBt->minLea
13ee0 66 20 3d 20 28 75 31 36 29 28 28 70 42 74 2d 3e f = (u16)((pBt->
13ef0 75 73 61 62 6c 65 53 69 7a 65 2d 31 32 29 2a 33 usableSize-12)*3
13f00 32 2f 32 35 35 20 2d 20 32 33 29 3b 0a 20 20 69 2/255 - 23);. i
13f10 66 28 20 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c f( pBt->maxLocal
13f20 3e 31 32 37 20 29 7b 0a 20 20 20 20 70 42 74 2d >127 ){. pBt-
13f30 3e 6d 61 78 31 62 79 74 65 50 61 79 6c 6f 61 64 >max1bytePayload
13f40 20 3d 20 31 32 37 3b 0a 20 20 7d 65 6c 73 65 7b = 127;. }else{
13f50 0a 20 20 20 20 70 42 74 2d 3e 6d 61 78 31 62 79 . pBt->max1by
13f60 74 65 50 61 79 6c 6f 61 64 20 3d 20 28 75 38 29 tePayload = (u8)
13f70 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 3b 0a 20 pBt->maxLocal;.
13f80 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 }. assert( pBt
13f90 2d 3e 6d 61 78 4c 65 61 66 20 2b 20 32 33 20 3c ->maxLeaf + 23 <
13fa0 3d 20 4d 58 5f 43 45 4c 4c 5f 53 49 5a 45 28 70 = MX_CELL_SIZE(p
13fb0 42 74 29 20 29 3b 0a 20 20 70 42 74 2d 3e 70 50 Bt) );. pBt->pP
13fc0 61 67 65 31 20 3d 20 70 50 61 67 65 31 3b 0a 20 age1 = pPage1;.
13fd0 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 pBt->nPage = nP
13fe0 61 67 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 age;. return SQ
13ff0 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 31 5f LITE_OK;..page1_
14000 69 6e 69 74 5f 66 61 69 6c 65 64 3a 0a 20 20 72 init_failed:. r
14010 65 6c 65 61 73 65 50 61 67 65 28 70 50 61 67 65 eleasePage(pPage
14020 31 29 3b 0a 20 20 70 42 74 2d 3e 70 50 61 67 65 1);. pBt->pPage
14030 31 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 1 = 0;. return
14040 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 rc;.}../*.** If
14050 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 74 there are no out
14060 73 74 61 6e 64 69 6e 67 20 63 75 72 73 6f 72 73 standing cursors
14070 20 61 6e 64 20 77 65 20 61 72 65 20 6e 6f 74 20 and we are not
14080 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 0a 2a 2a in the middle.**
14090 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f of a transactio
140a0 6e 20 62 75 74 20 74 68 65 72 65 20 69 73 20 61 n but there is a
140b0 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 read lock on th
140c0 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e e database, then
140d0 0a 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 .** this routine
140e0 20 75 6e 72 65 66 73 20 74 68 65 20 66 69 72 73 unrefs the firs
140f0 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 64 61 t page of the da
14100 74 61 62 61 73 65 20 66 69 6c 65 20 77 68 69 63 tabase file whic
14110 68 20 0a 2a 2a 20 68 61 73 20 74 68 65 20 65 66 h .** has the ef
14120 66 65 63 74 20 6f 66 20 72 65 6c 65 61 73 69 6e fect of releasin
14130 67 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e g the read lock.
14140 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 .**.** If there
14150 69 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e is a transaction
14160 20 69 6e 20 70 72 6f 67 72 65 73 73 2c 20 74 68 in progress, th
14170 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 20 is routine is a
14180 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 no-op..*/.static
14190 20 76 6f 69 64 20 75 6e 6c 6f 63 6b 42 74 72 65 void unlockBtre
141a0 65 49 66 55 6e 75 73 65 64 28 42 74 53 68 61 72 eIfUnused(BtShar
141b0 65 64 20 2a 70 42 74 29 7b 0a 20 20 61 73 73 65 ed *pBt){. asse
141c0 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
141d0 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 x_held(pBt->mute
141e0 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
141f0 70 42 74 2d 3e 70 43 75 72 73 6f 72 3d 3d 30 20 pBt->pCursor==0
14200 7c 7c 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 || pBt->inTransa
14210 63 74 69 6f 6e 3e 54 52 41 4e 53 5f 4e 4f 4e 45 ction>TRANS_NONE
14220 20 29 3b 0a 20 20 69 66 28 20 70 42 74 2d 3e 69 );. if( pBt->i
14230 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 nTransaction==TR
14240 41 4e 53 5f 4e 4f 4e 45 20 26 26 20 70 42 74 2d ANS_NONE && pBt-
14250 3e 70 50 61 67 65 31 21 3d 30 20 29 7b 0a 20 20 >pPage1!=0 ){.
14260 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e 70 assert( pBt->p
14270 50 61 67 65 31 2d 3e 61 44 61 74 61 20 29 3b 0a Page1->aData );.
14280 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
14290 74 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 te3PagerRefcount
142a0 28 70 42 74 2d 3e 70 50 61 67 65 72 29 3d 3d 31 (pBt->pPager)==1
142b0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
142c0 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 pBt->pPage1->aDa
142d0 74 61 20 29 3b 0a 20 20 20 20 72 65 6c 65 61 73 ta );. releas
142e0 65 50 61 67 65 28 70 42 74 2d 3e 70 50 61 67 65 ePage(pBt->pPage
142f0 31 29 3b 0a 20 20 20 20 70 42 74 2d 3e 70 50 61 1);. pBt->pPa
14300 67 65 31 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a ge1 = 0;. }.}..
14310 2f 2a 0a 2a 2a 20 49 66 20 70 42 74 20 70 6f 69 /*.** If pBt poi
14320 6e 74 73 20 74 6f 20 61 6e 20 65 6d 70 74 79 20 nts to an empty
14330 66 69 6c 65 20 74 68 65 6e 20 63 6f 6e 76 65 72 file then conver
14340 74 20 74 68 61 74 20 65 6d 70 74 79 20 66 69 6c t that empty fil
14350 65 0a 2a 2a 20 69 6e 74 6f 20 61 20 6e 65 77 20 e.** into a new
14360 65 6d 70 74 79 20 64 61 74 61 62 61 73 65 20 62 empty database b
14370 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 y initializing t
14380 68 65 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 he first page of
14390 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
143a0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
143b0 6e 65 77 44 61 74 61 62 61 73 65 28 42 74 53 68 newDatabase(BtSh
143c0 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 20 4d 65 ared *pBt){. Me
143d0 6d 50 61 67 65 20 2a 70 50 31 3b 0a 20 20 75 6e mPage *pP1;. un
143e0 73 69 67 6e 65 64 20 63 68 61 72 20 2a 64 61 74 signed char *dat
143f0 61 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 a;. int rc;..
14400 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
14410 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
14420 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 mutex) );. if(
14430 70 42 74 2d 3e 6e 50 61 67 65 3e 30 20 29 7b 0a pBt->nPage>0 ){.
14440 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
14450 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 50 31 20 E_OK;. }. pP1
14460 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 0a 20 = pBt->pPage1;.
14470 20 61 73 73 65 72 74 28 20 70 50 31 21 3d 30 20 assert( pP1!=0
14480 29 3b 0a 20 20 64 61 74 61 20 3d 20 70 50 31 2d );. data = pP1-
14490 3e 61 44 61 74 61 3b 0a 20 20 72 63 20 3d 20 73 >aData;. rc = s
144a0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
144b0 28 70 50 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a (pP1->pDbPage);.
144c0 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 if( rc ) retur
144d0 6e 20 72 63 3b 0a 20 20 6d 65 6d 63 70 79 28 64 n rc;. memcpy(d
144e0 61 74 61 2c 20 7a 4d 61 67 69 63 48 65 61 64 65 ata, zMagicHeade
144f0 72 2c 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 63 r, sizeof(zMagic
14500 48 65 61 64 65 72 29 29 3b 0a 20 20 61 73 73 65 Header));. asse
14510 72 74 28 20 73 69 7a 65 6f 66 28 7a 4d 61 67 69 rt( sizeof(zMagi
14520 63 48 65 61 64 65 72 29 3d 3d 31 36 20 29 3b 0a cHeader)==16 );.
14530 20 20 64 61 74 61 5b 31 36 5d 20 3d 20 28 75 38 data[16] = (u8
14540 29 28 28 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 )((pBt->pageSize
14550 3e 3e 38 29 26 30 78 66 66 29 3b 0a 20 20 64 61 >>8)&0xff);. da
14560 74 61 5b 31 37 5d 20 3d 20 28 75 38 29 28 28 70 ta[17] = (u8)((p
14570 42 74 2d 3e 70 61 67 65 53 69 7a 65 3e 3e 31 36 Bt->pageSize>>16
14580 29 26 30 78 66 66 29 3b 0a 20 20 64 61 74 61 5b )&0xff);. data[
14590 31 38 5d 20 3d 20 31 3b 0a 20 20 64 61 74 61 5b 18] = 1;. data[
145a0 31 39 5d 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 19] = 1;. asser
145b0 74 28 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 t( pBt->usableSi
145c0 7a 65 3c 3d 70 42 74 2d 3e 70 61 67 65 53 69 7a ze<=pBt->pageSiz
145d0 65 20 26 26 20 70 42 74 2d 3e 75 73 61 62 6c 65 e && pBt->usable
145e0 53 69 7a 65 2b 32 35 35 3e 3d 70 42 74 2d 3e 70 Size+255>=pBt->p
145f0 61 67 65 53 69 7a 65 29 3b 0a 20 20 64 61 74 61 ageSize);. data
14600 5b 32 30 5d 20 3d 20 28 75 38 29 28 70 42 74 2d [20] = (u8)(pBt-
14610 3e 70 61 67 65 53 69 7a 65 20 2d 20 70 42 74 2d >pageSize - pBt-
14620 3e 75 73 61 62 6c 65 53 69 7a 65 29 3b 0a 20 20 >usableSize);.
14630 64 61 74 61 5b 32 31 5d 20 3d 20 36 34 3b 0a 20 data[21] = 64;.
14640 20 64 61 74 61 5b 32 32 5d 20 3d 20 33 32 3b 0a data[22] = 32;.
14650 20 20 64 61 74 61 5b 32 33 5d 20 3d 20 33 32 3b data[23] = 32;
14660 0a 20 20 6d 65 6d 73 65 74 28 26 64 61 74 61 5b . memset(&data[
14670 32 34 5d 2c 20 30 2c 20 31 30 30 2d 32 34 29 3b 24], 0, 100-24);
14680 0a 20 20 7a 65 72 6f 50 61 67 65 28 70 50 31 2c . zeroPage(pP1,
14690 20 50 54 46 5f 49 4e 54 4b 45 59 7c 50 54 46 5f PTF_INTKEY|PTF_
146a0 4c 45 41 46 7c 50 54 46 5f 4c 45 41 46 44 41 54 LEAF|PTF_LEAFDAT
146b0 41 20 29 3b 0a 20 20 70 42 74 2d 3e 62 74 73 46 A );. pBt->btsF
146c0 6c 61 67 73 20 7c 3d 20 42 54 53 5f 50 41 47 45 lags |= BTS_PAGE
146d0 53 49 5a 45 5f 46 49 58 45 44 3b 0a 23 69 66 6e SIZE_FIXED;.#ifn
146e0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
146f0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 61 73 73 AUTOVACUUM. ass
14700 65 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 ert( pBt->autoVa
14710 63 75 75 6d 3d 3d 31 20 7c 7c 20 70 42 74 2d 3e cuum==1 || pBt->
14720 61 75 74 6f 56 61 63 75 75 6d 3d 3d 30 20 29 3b autoVacuum==0 );
14730 0a 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e . assert( pBt->
14740 69 6e 63 72 56 61 63 75 75 6d 3d 3d 31 20 7c 7c incrVacuum==1 ||
14750 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
14760 3d 3d 30 20 29 3b 0a 20 20 70 75 74 34 62 79 74 ==0 );. put4byt
14770 65 28 26 64 61 74 61 5b 33 36 20 2b 20 34 2a 34 e(&data[36 + 4*4
14780 5d 2c 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 ], pBt->autoVacu
14790 75 6d 29 3b 0a 20 20 70 75 74 34 62 79 74 65 28 um);. put4byte(
147a0 26 64 61 74 61 5b 33 36 20 2b 20 37 2a 34 5d 2c &data[36 + 7*4],
147b0 20 70 42 74 2d 3e 69 6e 63 72 56 61 63 75 75 6d pBt->incrVacuum
147c0 29 3b 0a 23 65 6e 64 69 66 0a 20 20 70 42 74 2d );.#endif. pBt-
147d0 3e 6e 50 61 67 65 20 3d 20 31 3b 0a 20 20 64 61 >nPage = 1;. da
147e0 74 61 5b 33 31 5d 20 3d 20 31 3b 0a 20 20 72 65 ta[31] = 1;. re
147f0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
14800 7d 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 }../*.** Attempt
14810 20 74 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20 to start a new
14820 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 41 20 77 transaction. A w
14830 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
14840 0a 2a 2a 20 69 73 20 73 74 61 72 74 65 64 20 69 .** is started i
14850 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67 f the second arg
14860 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 7a 65 72 6f ument is nonzero
14870 2c 20 6f 74 68 65 72 77 69 73 65 20 61 20 72 65 , otherwise a re
14880 61 64 2d 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ad-.** transacti
14890 6f 6e 2e 20 20 49 66 20 74 68 65 20 73 65 63 6f on. If the seco
148a0 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 32 nd argument is 2
148b0 20 6f 72 20 6d 6f 72 65 20 61 6e 64 20 65 78 63 or more and exc
148c0 6c 75 73 69 76 65 0a 2a 2a 20 74 72 61 6e 73 61 lusive.** transa
148d0 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 64 ction is started
148e0 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 6e , meaning that n
148f0 6f 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 o other process
14900 69 73 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 74 6f is allowed.** to
14910 20 61 63 63 65 73 73 20 74 68 65 20 64 61 74 61 access the data
14920 62 61 73 65 2e 20 20 41 20 70 72 65 65 78 69 73 base. A preexis
14930 74 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f 6e ting transaction
14940 20 6d 61 79 20 6e 6f 74 20 62 65 0a 2a 2a 20 75 may not be.** u
14950 70 67 72 61 64 65 64 20 74 6f 20 65 78 63 6c 75 pgraded to exclu
14960 73 69 76 65 20 62 79 20 63 61 6c 6c 69 6e 67 20 sive by calling
14970 74 68 69 73 20 72 6f 75 74 69 6e 65 20 61 20 73 this routine a s
14980 65 63 6f 6e 64 20 74 69 6d 65 20 2d 20 74 68 65 econd time - the
14990 0a 2a 2a 20 65 78 63 6c 75 73 69 76 69 74 79 20 .** exclusivity
149a0 66 6c 61 67 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 flag only works
149b0 66 6f 72 20 61 20 6e 65 77 20 74 72 61 6e 73 61 for a new transa
149c0 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 77 ction..**.** A w
149d0 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e rite-transaction
149e0 20 6d 75 73 74 20 62 65 20 73 74 61 72 74 65 64 must be started
149f0 20 62 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 before attempti
14a00 6e 67 20 61 6e 79 20 0a 2a 2a 20 63 68 61 6e 67 ng any .** chang
14a10 65 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 es to the databa
14a20 73 65 2e 20 20 4e 6f 6e 65 20 6f 66 20 74 68 65 se. None of the
14a30 20 66 6f 6c 6c 6f 77 69 6e 67 20 72 6f 75 74 69 following routi
14a40 6e 65 73 20 0a 2a 2a 20 77 69 6c 6c 20 77 6f 72 nes .** will wor
14a50 6b 20 75 6e 6c 65 73 73 20 61 20 74 72 61 6e 73 k unless a trans
14a60 61 63 74 69 6f 6e 20 69 73 20 73 74 61 72 74 65 action is starte
14a70 64 20 66 69 72 73 74 3a 0a 2a 2a 0a 2a 2a 20 20 d first:.**.**
14a80 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
14a90 43 72 65 61 74 65 54 61 62 6c 65 28 29 0a 2a 2a CreateTable().**
14aa0 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
14ab0 65 65 43 72 65 61 74 65 49 6e 64 65 78 28 29 0a eeCreateIndex().
14ac0 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 ** sqlite3B
14ad0 74 72 65 65 43 6c 65 61 72 54 61 62 6c 65 28 29 treeClearTable()
14ae0 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
14af0 42 74 72 65 65 44 72 6f 70 54 61 62 6c 65 28 29 BtreeDropTable()
14b00 0a 2a 2a 20 20 20 20 20 20 73 71 6c 69 74 65 33 .** sqlite3
14b10 42 74 72 65 65 49 6e 73 65 72 74 28 29 0a 2a 2a BtreeInsert().**
14b20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
14b30 65 65 44 65 6c 65 74 65 28 29 0a 2a 2a 20 20 20 eeDelete().**
14b40 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 55 sqlite3BtreeU
14b50 70 64 61 74 65 4d 65 74 61 28 29 0a 2a 2a 0a 2a pdateMeta().**.*
14b60 2a 20 49 66 20 61 6e 20 69 6e 69 74 69 61 6c 20 * If an initial
14b70 61 74 74 65 6d 70 74 20 74 6f 20 61 63 71 75 69 attempt to acqui
14b80 72 65 20 74 68 65 20 6c 6f 63 6b 20 66 61 69 6c re the lock fail
14b90 73 20 62 65 63 61 75 73 65 20 6f 66 20 6c 6f 63 s because of loc
14ba0 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 0a 2a 2a 20 k contention.**
14bb0 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 73 65 and the database
14bc0 20 77 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20 was previously
14bd0 75 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 6e 20 69 unlocked, then i
14be0 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 20 68 nvoke the busy h
14bf0 61 6e 64 6c 65 72 0a 2a 2a 20 69 66 20 74 68 65 andler.** if the
14c00 72 65 20 69 73 20 6f 6e 65 2e 20 20 42 75 74 20 re is one. But
14c10 69 66 20 74 68 65 72 65 20 77 61 73 20 70 72 65 if there was pre
14c20 76 69 6f 75 73 6c 79 20 61 20 72 65 61 64 2d 6c viously a read-l
14c30 6f 63 6b 2c 20 64 6f 20 6e 6f 74 0a 2a 2a 20 69 ock, do not.** i
14c40 6e 76 6f 6b 65 20 74 68 65 20 62 75 73 79 20 68 nvoke the busy h
14c50 61 6e 64 6c 65 72 20 2d 20 6a 75 73 74 20 72 65 andler - just re
14c60 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 turn SQLITE_BUSY
14c70 2e 20 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69 . SQLITE_BUSY i
14c80 73 20 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 77 s .** returned w
14c90 68 65 6e 20 74 68 65 72 65 20 69 73 20 61 6c 72 hen there is alr
14ca0 65 61 64 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b eady a read-lock
14cb0 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 61 76 6f in order to avo
14cc0 69 64 20 61 20 64 65 61 64 6c 6f 63 6b 2e 0a 2a id a deadlock..*
14cd0 2a 0a 2a 2a 20 53 75 70 70 6f 73 65 20 74 68 65 *.** Suppose the
14ce0 72 65 20 61 72 65 20 74 77 6f 20 70 72 6f 63 65 re are two proce
14cf0 73 73 65 73 20 41 20 61 6e 64 20 42 2e 20 20 41 sses A and B. A
14d00 20 68 61 73 20 61 20 72 65 61 64 20 6c 6f 63 6b has a read lock
14d10 20 61 6e 64 20 42 20 68 61 73 0a 2a 2a 20 61 20 and B has.** a
14d20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b 2e 20 20 reserved lock.
14d30 42 20 74 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f B tries to promo
14d40 74 65 20 74 6f 20 65 78 63 6c 75 73 69 76 65 20 te to exclusive
14d50 62 75 74 20 69 73 20 62 6c 6f 63 6b 65 64 20 62 but is blocked b
14d60 65 63 61 75 73 65 0a 2a 2a 20 6f 66 20 41 27 73 ecause.** of A's
14d70 20 72 65 61 64 20 6c 6f 63 6b 2e 20 20 41 20 74 read lock. A t
14d80 72 69 65 73 20 74 6f 20 70 72 6f 6d 6f 74 65 20 ries to promote
14d90 74 6f 20 72 65 73 65 72 76 65 64 20 62 75 74 20 to reserved but
14da0 69 73 20 62 6c 6f 63 6b 65 64 20 62 79 20 42 2e is blocked by B.
14db0 0a 2a 2a 20 4f 6e 65 20 6f 72 20 74 68 65 20 6f .** One or the o
14dc0 74 68 65 72 20 6f 66 20 74 68 65 20 74 77 6f 20 ther of the two
14dd0 70 72 6f 63 65 73 73 65 73 20 6d 75 73 74 20 67 processes must g
14de0 69 76 65 20 77 61 79 20 6f 72 20 74 68 65 72 65 ive way or there
14df0 20 63 61 6e 20 62 65 0a 2a 2a 20 6e 6f 20 70 72 can be.** no pr
14e00 6f 67 72 65 73 73 2e 20 20 42 79 20 72 65 74 75 ogress. By retu
14e10 72 6e 69 6e 67 20 53 51 4c 49 54 45 5f 42 55 53 rning SQLITE_BUS
14e20 59 20 61 6e 64 20 6e 6f 74 20 69 6e 76 6f 6b 69 Y and not invoki
14e30 6e 67 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c ng the busy call
14e40 62 61 63 6b 0a 2a 2a 20 77 68 65 6e 20 41 20 61 back.** when A a
14e50 6c 72 65 61 64 79 20 68 61 73 20 61 20 72 65 61 lready has a rea
14e60 64 20 6c 6f 63 6b 2c 20 77 65 20 65 6e 63 6f 75 d lock, we encou
14e70 72 61 67 65 20 41 20 74 6f 20 67 69 76 65 20 75 rage A to give u
14e80 70 20 61 6e 64 20 6c 65 74 20 42 0a 2a 2a 20 70 p and let B.** p
14e90 72 6f 63 65 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 roceed..*/.int s
14ea0 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69 6e qlite3BtreeBegin
14eb0 54 72 61 6e 73 28 42 74 72 65 65 20 2a 70 2c 20 Trans(Btree *p,
14ec0 69 6e 74 20 77 72 66 6c 61 67 29 7b 0a 20 20 73 int wrflag){. s
14ed0 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b 20 3d qlite3 *pBlock =
14ee0 20 30 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 0;. BtShared *
14ef0 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
14f00 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
14f10 4f 4b 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 OK;.. sqlite3Bt
14f20 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 62 reeEnter(p);. b
14f30 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 treeIntegrity(p)
14f40 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 62 ;.. /* If the b
14f50 74 72 65 65 20 69 73 20 61 6c 72 65 61 64 79 20 tree is already
14f60 69 6e 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 in a write-trans
14f70 61 63 74 69 6f 6e 2c 20 6f 72 20 69 74 0a 20 20 action, or it.
14f80 2a 2a 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e ** is already in
14f90 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 a read-transact
14fa0 69 6f 6e 20 61 6e 64 20 61 20 72 65 61 64 2d 74 ion and a read-t
14fb0 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 ransaction. **
14fc0 69 73 20 72 65 71 75 65 73 74 65 64 2c 20 74 68 is requested, th
14fd0 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 20 is is a no-op..
14fe0 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 */. if( p->inT
14ff0 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 rans==TRANS_WRIT
15000 45 20 7c 7c 20 28 70 2d 3e 69 6e 54 72 61 6e 73 E || (p->inTrans
15010 3d 3d 54 52 41 4e 53 5f 52 45 41 44 20 26 26 20 ==TRANS_READ &&
15020 21 77 72 66 6c 61 67 29 20 29 7b 0a 20 20 20 20 !wrflag) ){.
15030 67 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e goto trans_begun
15040 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 72 69 74 ;. }.. /* Writ
15050 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 e transactions a
15060 72 65 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 re not possible
15070 6f 6e 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 on a read-only d
15080 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 69 66 28 atabase */. if(
15090 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 (pBt->btsFlags
150a0 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 29 & BTS_READ_ONLY)
150b0 21 3d 30 20 26 26 20 77 72 66 6c 61 67 20 29 7b !=0 && wrflag ){
150c0 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
150d0 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 67 _READONLY;. g
150e0 6f 74 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b oto trans_begun;
150f0 0a 20 20 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 . }..#ifndef SQ
15100 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
15110 5f 43 41 43 48 45 0a 20 20 2f 2a 20 49 66 20 61 _CACHE. /* If a
15120 6e 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 nother database
15130 68 61 6e 64 6c 65 20 68 61 73 20 61 6c 72 65 61 handle has alrea
15140 64 79 20 6f 70 65 6e 65 64 20 61 20 77 72 69 74 dy opened a writ
15150 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 0a 20 e transaction .
15160 20 2a 2a 20 6f 6e 20 74 68 69 73 20 73 68 61 72 ** on this shar
15170 65 64 2d 62 74 72 65 65 20 73 74 72 75 63 74 75 ed-btree structu
15180 72 65 20 61 6e 64 20 61 20 73 65 63 6f 6e 64 20 re and a second
15190 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
151a0 6e 20 69 73 0a 20 20 2a 2a 20 72 65 71 75 65 73 n is. ** reques
151b0 74 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 ted, return SQLI
151c0 54 45 5f 4c 4f 43 4b 45 44 2e 0a 20 20 2a 2f 0a TE_LOCKED.. */.
151d0 20 20 69 66 28 20 28 77 72 66 6c 61 67 20 26 26 if( (wrflag &&
151e0 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 pBt->inTransact
151f0 69 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ion==TRANS_WRITE
15200 29 0a 20 20 20 7c 7c 20 28 70 42 74 2d 3e 62 74 ). || (pBt->bt
15210 73 46 6c 61 67 73 20 26 20 42 54 53 5f 50 45 4e sFlags & BTS_PEN
15220 44 49 4e 47 29 21 3d 30 0a 20 20 29 7b 0a 20 20 DING)!=0. ){.
15230 20 20 70 42 6c 6f 63 6b 20 3d 20 70 42 74 2d 3e pBlock = pBt->
15240 70 57 72 69 74 65 72 2d 3e 64 62 3b 0a 20 20 7d pWriter->db;. }
15250 65 6c 73 65 20 69 66 28 20 77 72 66 6c 61 67 3e else if( wrflag>
15260 31 20 29 7b 0a 20 20 20 20 42 74 4c 6f 63 6b 20 1 ){. BtLock
15270 2a 70 49 74 65 72 3b 0a 20 20 20 20 66 6f 72 28 *pIter;. for(
15280 70 49 74 65 72 3d 70 42 74 2d 3e 70 4c 6f 63 6b pIter=pBt->pLock
15290 3b 20 70 49 74 65 72 3b 20 70 49 74 65 72 3d 70 ; pIter; pIter=p
152a0 49 74 65 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 Iter->pNext){.
152b0 20 20 20 20 69 66 28 20 70 49 74 65 72 2d 3e 70 if( pIter->p
152c0 42 74 72 65 65 21 3d 70 20 29 7b 0a 20 20 20 20 Btree!=p ){.
152d0 20 20 20 20 70 42 6c 6f 63 6b 20 3d 20 70 49 74 pBlock = pIt
152e0 65 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 3b 0a er->pBtree->db;.
152f0 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
15300 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
15310 0a 20 20 69 66 28 20 70 42 6c 6f 63 6b 20 29 7b . if( pBlock ){
15320 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6e 6e . sqlite3Conn
15330 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 70 2d ectionBlocked(p-
15340 3e 64 62 2c 20 70 42 6c 6f 63 6b 29 3b 0a 20 20 >db, pBlock);.
15350 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4c 4f rc = SQLITE_LO
15360 43 4b 45 44 5f 53 48 41 52 45 44 43 41 43 48 45 CKED_SHAREDCACHE
15370 3b 0a 20 20 20 20 67 6f 74 6f 20 74 72 61 6e 73 ;. goto trans
15380 5f 62 65 67 75 6e 3b 0a 20 20 7d 0a 23 65 6e 64 _begun;. }.#end
15390 69 66 0a 0a 20 20 2f 2a 20 41 6e 79 20 72 65 61 if.. /* Any rea
153a0 64 2d 6f 6e 6c 79 20 6f 72 20 72 65 61 64 2d 77 d-only or read-w
153b0 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
153c0 20 69 6d 70 6c 69 65 73 20 61 20 72 65 61 64 2d implies a read-
153d0 6c 6f 63 6b 20 6f 6e 20 0a 20 20 2a 2a 20 70 61 lock on . ** pa
153e0 67 65 20 31 2e 20 53 6f 20 69 66 20 73 6f 6d 65 ge 1. So if some
153f0 20 6f 74 68 65 72 20 73 68 61 72 65 64 2d 63 61 other shared-ca
15400 63 68 65 20 63 6c 69 65 6e 74 20 61 6c 72 65 61 che client alrea
15410 64 79 20 68 61 73 20 61 20 77 72 69 74 65 2d 6c dy has a write-l
15420 6f 63 6b 20 0a 20 20 2a 2a 20 6f 6e 20 70 61 67 ock . ** on pag
15430 65 20 31 2c 20 74 68 65 20 74 72 61 6e 73 61 63 e 1, the transac
15440 74 69 6f 6e 20 63 61 6e 6e 6f 74 20 62 65 20 6f tion cannot be o
15450 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 72 63 20 3d pened. */. rc =
15460 20 71 75 65 72 79 53 68 61 72 65 64 43 61 63 68 querySharedCach
15470 65 54 61 62 6c 65 4c 6f 63 6b 28 70 2c 20 4d 41 eTableLock(p, MA
15480 53 54 45 52 5f 52 4f 4f 54 2c 20 52 45 41 44 5f STER_ROOT, READ_
15490 4c 4f 43 4b 29 3b 0a 20 20 69 66 28 20 53 51 4c LOCK);. if( SQL
154a0 49 54 45 5f 4f 4b 21 3d 72 63 20 29 20 67 6f 74 ITE_OK!=rc ) got
154b0 6f 20 74 72 61 6e 73 5f 62 65 67 75 6e 3b 0a 0a o trans_begun;..
154c0 20 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 pBt->btsFlags
154d0 26 3d 20 7e 42 54 53 5f 49 4e 49 54 49 41 4c 4c &= ~BTS_INITIALL
154e0 59 5f 45 4d 50 54 59 3b 0a 20 20 69 66 28 20 70 Y_EMPTY;. if( p
154f0 42 74 2d 3e 6e 50 61 67 65 3d 3d 30 20 29 20 70 Bt->nPage==0 ) p
15500 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 7c 3d 20 Bt->btsFlags |=
15510 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 5f 45 4d BTS_INITIALLY_EM
15520 50 54 59 3b 0a 20 20 64 6f 20 7b 0a 20 20 20 20 PTY;. do {.
15530 2f 2a 20 43 61 6c 6c 20 6c 6f 63 6b 42 74 72 65 /* Call lockBtre
15540 65 28 29 20 75 6e 74 69 6c 20 65 69 74 68 65 72 e() until either
15550 20 70 42 74 2d 3e 70 50 61 67 65 31 20 69 73 20 pBt->pPage1 is
15560 70 6f 70 75 6c 61 74 65 64 20 6f 72 0a 20 20 20 populated or.
15570 20 2a 2a 20 6c 6f 63 6b 42 74 72 65 65 28 29 20 ** lockBtree()
15580 72 65 74 75 72 6e 73 20 73 6f 6d 65 74 68 69 6e returns somethin
15590 67 20 6f 74 68 65 72 20 74 68 61 6e 20 53 51 4c g other than SQL
155a0 49 54 45 5f 4f 4b 2e 20 6c 6f 63 6b 42 74 72 65 ITE_OK. lockBtre
155b0 65 28 29 0a 20 20 20 20 2a 2a 20 6d 61 79 20 72 e(). ** may r
155c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
155d0 62 75 74 20 6c 65 61 76 65 20 70 42 74 2d 3e 70 but leave pBt->p
155e0 50 61 67 65 31 20 73 65 74 20 74 6f 20 30 20 69 Page1 set to 0 i
155f0 66 20 61 66 74 65 72 0a 20 20 20 20 2a 2a 20 72 f after. ** r
15600 65 61 64 69 6e 67 20 70 61 67 65 20 31 20 69 74 eading page 1 it
15610 20 64 69 73 63 6f 76 65 72 73 20 74 68 61 74 20 discovers that
15620 74 68 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 the page-size of
15630 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 20 the database .
15640 20 20 20 2a 2a 20 66 69 6c 65 20 69 73 20 6e 6f ** file is no
15650 74 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 2e t pBt->pageSize.
15660 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 6c 6f In this case lo
15670 63 6b 42 74 72 65 65 28 29 20 77 69 6c 6c 20 75 ckBtree() will u
15680 70 64 61 74 65 0a 20 20 20 20 2a 2a 20 70 42 74 pdate. ** pBt
15690 2d 3e 70 61 67 65 53 69 7a 65 20 74 6f 20 74 68 ->pageSize to th
156a0 65 20 70 61 67 65 2d 73 69 7a 65 20 6f 66 20 74 e page-size of t
156b0 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 2e he file on disk.
156c0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 77 68 69 6c . */. whil
156d0 65 28 20 70 42 74 2d 3e 70 50 61 67 65 31 3d 3d e( pBt->pPage1==
156e0 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b 3d 3d 0 && SQLITE_OK==
156f0 28 72 63 20 3d 20 6c 6f 63 6b 42 74 72 65 65 28 (rc = lockBtree(
15700 70 42 74 29 29 20 29 3b 0a 0a 20 20 20 20 69 66 pBt)) );.. if
15710 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
15720 26 26 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 20 && wrflag ){.
15730 20 20 20 69 66 28 20 28 70 42 74 2d 3e 62 74 73 if( (pBt->bts
15740 46 6c 61 67 73 20 26 20 42 54 53 5f 52 45 41 44 Flags & BTS_READ
15750 5f 4f 4e 4c 59 29 21 3d 30 20 29 7b 0a 20 20 20 _ONLY)!=0 ){.
15760 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 rc = SQLITE
15770 5f 52 45 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 _READONLY;.
15780 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
15790 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
157a0 72 42 65 67 69 6e 28 70 42 74 2d 3e 70 50 61 67 rBegin(pBt->pPag
157b0 65 72 2c 77 72 66 6c 61 67 3e 31 2c 73 71 6c 69 er,wrflag>1,sqli
157c0 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 te3TempInMemory(
157d0 70 2d 3e 64 62 29 29 3b 0a 20 20 20 20 20 20 20 p->db));.
157e0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
157f0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
15800 72 63 20 3d 20 6e 65 77 44 61 74 61 62 61 73 65 rc = newDatabase
15810 28 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20 7d (pBt);. }
15820 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
15830 20 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 . if( rc!=SQ
15840 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
15850 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e unlockBtreeIfUn
15860 75 73 65 64 28 70 42 74 29 3b 0a 20 20 20 20 7d used(pBt);. }
15870 0a 20 20 7d 77 68 69 6c 65 28 20 28 72 63 26 30 . }while( (rc&0
15880 78 46 46 29 3d 3d 53 51 4c 49 54 45 5f 42 55 53 xFF)==SQLITE_BUS
15890 59 20 26 26 20 70 42 74 2d 3e 69 6e 54 72 61 6e Y && pBt->inTran
158a0 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f 4e saction==TRANS_N
158b0 4f 4e 45 20 26 26 0a 20 20 20 20 20 20 20 20 20 ONE &&.
158c0 20 62 74 72 65 65 49 6e 76 6f 6b 65 42 75 73 79 btreeInvokeBusy
158d0 48 61 6e 64 6c 65 72 28 70 42 74 29 20 29 3b 0a Handler(pBt) );.
158e0 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
158f0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 E_OK ){. if(
15900 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e p->inTrans==TRAN
15910 53 5f 4e 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 S_NONE ){.
15920 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f pBt->nTransactio
15930 6e 2b 2b 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c n++;.#ifndef SQL
15940 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
15950 43 41 43 48 45 0a 20 20 20 20 20 20 69 66 28 20 CACHE. if(
15960 70 2d 3e 73 68 61 72 61 62 6c 65 20 29 7b 0a 20 p->sharable ){.
15970 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 assert( p
15980 2d 3e 6c 6f 63 6b 2e 70 42 74 72 65 65 3d 3d 70 ->lock.pBtree==p
15990 20 26 26 20 70 2d 3e 6c 6f 63 6b 2e 69 54 61 62 && p->lock.iTab
159a0 6c 65 3d 3d 31 20 29 3b 0a 20 20 20 20 20 20 20 le==1 );.
159b0 20 70 2d 3e 6c 6f 63 6b 2e 65 4c 6f 63 6b 20 3d p->lock.eLock =
159c0 20 52 45 41 44 5f 4c 4f 43 4b 3b 0a 20 20 20 20 READ_LOCK;.
159d0 20 20 20 20 70 2d 3e 6c 6f 63 6b 2e 70 4e 65 78 p->lock.pNex
159e0 74 20 3d 20 70 42 74 2d 3e 70 4c 6f 63 6b 3b 0a t = pBt->pLock;.
159f0 20 20 20 20 20 20 20 20 70 42 74 2d 3e 70 4c 6f pBt->pLo
15a00 63 6b 20 3d 20 26 70 2d 3e 6c 6f 63 6b 3b 0a 20 ck = &p->lock;.
15a10 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
15a20 20 20 7d 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 }. p->inTra
15a30 6e 73 20 3d 20 28 77 72 66 6c 61 67 3f 54 52 41 ns = (wrflag?TRA
15a40 4e 53 5f 57 52 49 54 45 3a 54 52 41 4e 53 5f 52 NS_WRITE:TRANS_R
15a50 45 41 44 29 3b 0a 20 20 20 20 69 66 28 20 70 2d EAD);. if( p-
15a60 3e 69 6e 54 72 61 6e 73 3e 70 42 74 2d 3e 69 6e >inTrans>pBt->in
15a70 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 Transaction ){.
15a80 20 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e pBt->inTran
15a90 73 61 63 74 69 6f 6e 20 3d 20 70 2d 3e 69 6e 54 saction = p->inT
15aa0 72 61 6e 73 3b 0a 20 20 20 20 7d 0a 20 20 20 20 rans;. }.
15ab0 69 66 28 20 77 72 66 6c 61 67 20 29 7b 0a 20 20 if( wrflag ){.
15ac0 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 MemPage *pPa
15ad0 67 65 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 ge1 = pBt->pPage
15ae0 31 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 1;.#ifndef SQLIT
15af0 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
15b00 43 48 45 0a 20 20 20 20 20 20 61 73 73 65 72 74 CHE. assert
15b10 28 20 21 70 42 74 2d 3e 70 57 72 69 74 65 72 20 ( !pBt->pWriter
15b20 29 3b 0a 20 20 20 20 20 20 70 42 74 2d 3e 70 57 );. pBt->pW
15b30 72 69 74 65 72 20 3d 20 70 3b 0a 20 20 20 20 20 riter = p;.
15b40 20 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 pBt->btsFlags &
15b50 3d 20 7e 42 54 53 5f 45 58 43 4c 55 53 49 56 45 = ~BTS_EXCLUSIVE
15b60 3b 0a 20 20 20 20 20 20 69 66 28 20 77 72 66 6c ;. if( wrfl
15b70 61 67 3e 31 20 29 20 70 42 74 2d 3e 62 74 73 46 ag>1 ) pBt->btsF
15b80 6c 61 67 73 20 7c 3d 20 42 54 53 5f 45 58 43 4c lags |= BTS_EXCL
15b90 55 53 49 56 45 3b 0a 23 65 6e 64 69 66 0a 0a 20 USIVE;.#endif..
15ba0 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 64 /* If the d
15bb0 62 2d 73 69 7a 65 20 68 65 61 64 65 72 20 66 69 b-size header fi
15bc0 65 6c 64 20 69 73 20 69 6e 63 6f 72 72 65 63 74 eld is incorrect
15bd0 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 69 (as it may be i
15be0 66 20 61 6e 20 6f 6c 64 0a 20 20 20 20 20 20 2a f an old. *
15bf0 2a 20 63 6c 69 65 6e 74 20 68 61 73 20 62 65 65 * client has bee
15c00 6e 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 n writing the da
15c10 74 61 62 61 73 65 20 66 69 6c 65 29 2c 20 75 70 tabase file), up
15c20 64 61 74 65 20 69 74 20 6e 6f 77 2e 20 44 6f 69 date it now. Doi
15c30 6e 67 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 73 ng. ** this
15c40 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74 sooner rather t
15c50 68 61 6e 20 6c 61 74 65 72 20 6d 65 61 6e 73 20 han later means
15c60 74 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a the database siz
15c70 65 20 63 61 6e 20 73 61 66 65 6c 79 20 0a 20 20 e can safely .
15c80 20 20 20 20 2a 2a 20 72 65 2d 72 65 61 64 20 74 ** re-read t
15c90 68 65 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 he database size
15ca0 20 66 72 6f 6d 20 70 61 67 65 20 31 20 69 66 20 from page 1 if
15cb0 61 20 73 61 76 65 70 6f 69 6e 74 20 6f 72 20 74 a savepoint or t
15cc0 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 ransaction.
15cd0 20 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 6f 63 63 ** rollback occ
15ce0 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 20 74 urs within the t
15cf0 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 20 20 ransaction..
15d00 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 */. if( p
15d10 42 74 2d 3e 6e 50 61 67 65 21 3d 67 65 74 34 62 Bt->nPage!=get4b
15d20 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
15d30 74 61 5b 32 38 5d 29 20 29 7b 0a 20 20 20 20 20 ta[28]) ){.
15d40 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
15d50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 31 agerWrite(pPage1
15d60 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
15d70 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
15d80 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
15d90 20 20 20 70 75 74 34 62 79 74 65 28 26 70 50 61 put4byte(&pPa
15da0 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d 2c 20 ge1->aData[28],
15db0 70 42 74 2d 3e 6e 50 61 67 65 29 3b 0a 20 20 20 pBt->nPage);.
15dc0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
15dd0 20 20 20 7d 0a 20 20 7d 0a 0a 0a 74 72 61 6e 73 }. }...trans
15de0 5f 62 65 67 75 6e 3a 0a 20 20 69 66 28 20 72 63 _begun:. if( rc
15df0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 77 ==SQLITE_OK && w
15e00 72 66 6c 61 67 20 29 7b 0a 20 20 20 20 2f 2a 20 rflag ){. /*
15e10 54 68 69 73 20 63 61 6c 6c 20 6d 61 6b 65 73 20 This call makes
15e20 73 75 72 65 20 74 68 61 74 20 74 68 65 20 70 61 sure that the pa
15e30 67 65 72 20 68 61 73 20 74 68 65 20 63 6f 72 72 ger has the corr
15e40 65 63 74 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 ect number of.
15e50 20 20 2a 2a 20 6f 70 65 6e 20 73 61 76 65 70 6f ** open savepo
15e60 69 6e 74 73 2e 20 49 66 20 74 68 65 20 73 65 63 ints. If the sec
15e70 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 73 ond parameter is
15e80 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 30 20 greater than 0
15e90 61 6e 64 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 and. ** the s
15ea0 75 62 2d 6a 6f 75 72 6e 61 6c 20 69 73 20 6e 6f ub-journal is no
15eb0 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 2c 20 t already open,
15ec0 74 68 65 6e 20 69 74 20 77 69 6c 6c 20 62 65 20 then it will be
15ed0 6f 70 65 6e 65 64 20 68 65 72 65 2e 0a 20 20 20 opened here..
15ee0 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c */. rc = sql
15ef0 69 74 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 ite3PagerOpenSav
15f00 65 70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 epoint(pBt->pPag
15f10 65 72 2c 20 70 2d 3e 64 62 2d 3e 6e 53 61 76 65 er, p->db->nSave
15f20 70 6f 69 6e 74 29 3b 0a 20 20 7d 0a 0a 20 20 62 point);. }.. b
15f30 74 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 treeIntegrity(p)
15f40 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
15f50 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
15f60 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 rn rc;.}..#ifnde
15f70 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
15f80 54 4f 56 41 43 55 55 4d 0a 0a 2f 2a 0a 2a 2a 20 TOVACUUM../*.**
15f90 53 65 74 20 74 68 65 20 70 6f 69 6e 74 65 72 2d Set the pointer-
15fa0 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 map entries for
15fb0 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66 20 all children of
15fc0 70 61 67 65 20 70 50 61 67 65 2e 20 41 6c 73 6f page pPage. Also
15fd0 2c 20 69 66 0a 2a 2a 20 70 50 61 67 65 20 63 6f , if.** pPage co
15fe0 6e 74 61 69 6e 73 20 63 65 6c 6c 73 20 74 68 61 ntains cells tha
15ff0 74 20 70 6f 69 6e 74 20 74 6f 20 6f 76 65 72 66 t point to overf
16000 6c 6f 77 20 70 61 67 65 73 2c 20 73 65 74 20 74 low pages, set t
16010 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 6d 61 he pointer.** ma
16020 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 74 68 p entries for th
16030 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 e overflow pages
16040 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 as well..*/.sta
16050 74 69 63 20 69 6e 74 20 73 65 74 43 68 69 6c 64 tic int setChild
16060 50 74 72 6d 61 70 73 28 4d 65 6d 50 61 67 65 20 Ptrmaps(MemPage
16070 2a 70 50 61 67 65 29 7b 0a 20 20 69 6e 74 20 69 *pPage){. int i
16080 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
16090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
160a0 20 43 6f 75 6e 74 65 72 20 76 61 72 69 61 62 6c Counter variabl
160b0 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 6c 6c e */. int nCell
160c0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
160d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
160e0 62 65 72 20 6f 66 20 63 65 6c 6c 73 20 69 6e 20 ber of cells in
160f0 70 61 67 65 20 70 50 61 67 65 20 2a 2f 0a 20 20 page pPage */.
16100 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
16110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16120 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 /* Return cod
16130 65 20 2a 2f 0a 20 20 42 74 53 68 61 72 65 64 20 e */. BtShared
16140 2a 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 *pBt = pPage->pB
16150 74 3b 0a 20 20 75 38 20 69 73 49 6e 69 74 4f 72 t;. u8 isInitOr
16160 69 67 20 3d 20 70 50 61 67 65 2d 3e 69 73 49 6e ig = pPage->isIn
16170 69 74 3b 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 20 it;. Pgno pgno
16180 3d 20 70 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 0a = pPage->pgno;..
16190 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
161a0 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 50 61 3_mutex_held(pPa
161b0 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 29 20 ge->pBt->mutex)
161c0 29 3b 0a 20 20 72 63 20 3d 20 62 74 72 65 65 49 );. rc = btreeI
161d0 6e 69 74 50 61 67 65 28 70 50 61 67 65 29 3b 0a nitPage(pPage);.
161e0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
161f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 _OK ){. goto
16200 73 65 74 5f 63 68 69 6c 64 5f 70 74 72 6d 61 70 set_child_ptrmap
16210 73 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 6e 43 65 s_out;. }. nCe
16220 6c 6c 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c ll = pPage->nCel
16230 6c 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 l;.. for(i=0; i
16240 3c 6e 43 65 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 <nCell; i++){.
16250 20 20 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 u8 *pCell = fi
16260 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 ndCell(pPage, i)
16270 3b 0a 0a 20 20 20 20 70 74 72 6d 61 70 50 75 74 ;.. ptrmapPut
16280 4f 76 66 6c 50 74 72 28 70 50 61 67 65 2c 20 70 OvflPtr(pPage, p
16290 43 65 6c 6c 2c 20 26 72 63 29 3b 0a 0a 20 20 20 Cell, &rc);..
162a0 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 61 if( !pPage->lea
162b0 66 20 29 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 f ){. Pgno
162c0 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 34 childPgno = get4
162d0 62 79 74 65 28 70 43 65 6c 6c 29 3b 0a 20 20 20 byte(pCell);.
162e0 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 74 ptrmapPut(pBt
162f0 2c 20 63 68 69 6c 64 50 67 6e 6f 2c 20 50 54 52 , childPgno, PTR
16300 4d 41 50 5f 42 54 52 45 45 2c 20 70 67 6e 6f 2c MAP_BTREE, pgno,
16310 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d &rc);. }. }
16320 0a 0a 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e .. if( !pPage->
16330 6c 65 61 66 20 29 7b 0a 20 20 20 20 50 67 6e 6f leaf ){. Pgno
16340 20 63 68 69 6c 64 50 67 6e 6f 20 3d 20 67 65 74 childPgno = get
16350 34 62 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 4byte(&pPage->aD
16360 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 ata[pPage->hdrOf
16370 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 20 70 74 fset+8]);. pt
16380 72 6d 61 70 50 75 74 28 70 42 74 2c 20 63 68 69 rmapPut(pBt, chi
16390 6c 64 50 67 6e 6f 2c 20 50 54 52 4d 41 50 5f 42 ldPgno, PTRMAP_B
163a0 54 52 45 45 2c 20 70 67 6e 6f 2c 20 26 72 63 29 TREE, pgno, &rc)
163b0 3b 0a 20 20 7d 0a 0a 73 65 74 5f 63 68 69 6c 64 ;. }..set_child
163c0 5f 70 74 72 6d 61 70 73 5f 6f 75 74 3a 0a 20 20 _ptrmaps_out:.
163d0 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d 20 pPage->isInit =
163e0 69 73 49 6e 69 74 4f 72 69 67 3b 0a 20 20 72 65 isInitOrig;. re
163f0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
16400 2a 20 53 6f 6d 65 77 68 65 72 65 20 6f 6e 20 70 * Somewhere on p
16410 50 61 67 65 20 69 73 20 61 20 70 6f 69 6e 74 65 Page is a pointe
16420 72 20 74 6f 20 70 61 67 65 20 69 46 72 6f 6d 2e r to page iFrom.
16430 20 20 4d 6f 64 69 66 79 20 74 68 69 73 20 70 6f Modify this po
16440 69 6e 74 65 72 20 73 6f 0a 2a 2a 20 74 68 61 74 inter so.** that
16450 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 69 54 it points to iT
16460 6f 2e 20 50 61 72 61 6d 65 74 65 72 20 65 54 79 o. Parameter eTy
16470 70 65 20 64 65 73 63 72 69 62 65 73 20 74 68 65 pe describes the
16480 20 74 79 70 65 20 6f 66 20 70 6f 69 6e 74 65 72 type of pointer
16490 20 74 6f 0a 2a 2a 20 62 65 20 6d 6f 64 69 66 69 to.** be modifi
164a0 65 64 2c 20 61 73 20 20 66 6f 6c 6c 6f 77 73 3a ed, as follows:
164b0 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f 42 54 .**.** PTRMAP_BT
164c0 52 45 45 3a 20 20 20 20 20 70 50 61 67 65 20 69 REE: pPage i
164d0 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 2e 20 s a btree-page.
164e0 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f 69 6e The pointer poin
164f0 74 73 20 61 74 20 61 20 63 68 69 6c 64 20 0a 2a ts at a child .*
16500 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
16510 20 20 20 20 70 61 67 65 20 6f 66 20 70 50 61 67 page of pPag
16520 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 4d 41 50 5f e..**.** PTRMAP_
16530 4f 56 45 52 46 4c 4f 57 31 3a 20 70 50 61 67 65 OVERFLOW1: pPage
16540 20 69 73 20 61 20 62 74 72 65 65 2d 70 61 67 65 is a btree-page
16550 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 70 6f . The pointer po
16560 69 6e 74 73 20 61 74 20 61 6e 20 6f 76 65 72 66 ints at an overf
16570 6c 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 low.**
16580 20 20 20 20 20 20 20 20 20 70 61 67 65 20 70 6f page po
16590 69 6e 74 65 64 20 74 6f 20 62 79 20 6f 6e 65 20 inted to by one
165a0 6f 66 20 74 68 65 20 63 65 6c 6c 73 20 6f 6e 20 of the cells on
165b0 70 50 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 50 54 52 pPage..**.** PTR
165c0 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 3a 20 70 MAP_OVERFLOW2: p
165d0 50 61 67 65 20 69 73 20 61 6e 20 6f 76 65 72 66 Page is an overf
165e0 6c 6f 77 2d 70 61 67 65 2e 20 54 68 65 20 70 6f low-page. The po
165f0 69 6e 74 65 72 20 70 6f 69 6e 74 73 20 61 74 20 inter points at
16600 74 68 65 20 6e 65 78 74 0a 2a 2a 20 20 20 20 20 the next.**
16610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 76 ov
16620 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 erflow page in t
16630 68 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 he list..*/.stat
16640 69 63 20 69 6e 74 20 6d 6f 64 69 66 79 50 61 67 ic int modifyPag
16650 65 50 6f 69 6e 74 65 72 28 4d 65 6d 50 61 67 65 ePointer(MemPage
16660 20 2a 70 50 61 67 65 2c 20 50 67 6e 6f 20 69 46 *pPage, Pgno iF
16670 72 6f 6d 2c 20 50 67 6e 6f 20 69 54 6f 2c 20 75 rom, Pgno iTo, u
16680 38 20 65 54 79 70 65 29 7b 0a 20 20 61 73 73 65 8 eType){. asse
16690 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
166a0 78 5f 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 x_held(pPage->pB
166b0 74 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 t->mutex) );. a
166c0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
166d0 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
166e0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
166f0 3b 0a 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 ;. if( eType==P
16700 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 20 TRMAP_OVERFLOW2
16710 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 6f ){. /* The po
16720 69 6e 74 65 72 20 69 73 20 61 6c 77 61 79 73 20 inter is always
16730 74 68 65 20 66 69 72 73 74 20 34 20 62 79 74 65 the first 4 byte
16740 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 6e s of the page in
16750 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a this case. */.
16760 20 20 20 20 69 66 28 20 67 65 74 34 62 79 74 65 if( get4byte
16770 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 21 3d (pPage->aData)!=
16780 69 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 72 iFrom ){. r
16790 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 eturn SQLITE_COR
167a0 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d RUPT_BKPT;. }
167b0 0a 20 20 20 20 70 75 74 34 62 79 74 65 28 70 50 . put4byte(pP
167c0 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 54 6f 29 age->aData, iTo)
167d0 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 75 ;. }else{. u
167e0 38 20 69 73 49 6e 69 74 4f 72 69 67 20 3d 20 70 8 isInitOrig = p
167f0 50 61 67 65 2d 3e 69 73 49 6e 69 74 3b 0a 20 20 Page->isInit;.
16800 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 int i;. int
16810 20 6e 43 65 6c 6c 3b 0a 0a 20 20 20 20 62 74 72 nCell;.. btr
16820 65 65 49 6e 69 74 50 61 67 65 28 70 50 61 67 65 eeInitPage(pPage
16830 29 3b 0a 20 20 20 20 6e 43 65 6c 6c 20 3d 20 70 );. nCell = p
16840 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 0a 20 20 Page->nCell;..
16850 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 for(i=0; i<nCe
16860 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ll; i++){.
16870 75 38 20 2a 70 43 65 6c 6c 20 3d 20 66 69 6e 64 u8 *pCell = find
16880 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 29 3b 0a Cell(pPage, i);.
16890 20 20 20 20 20 20 69 66 28 20 65 54 79 70 65 3d if( eType=
168a0 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 =PTRMAP_OVERFLOW
168b0 31 20 29 7b 0a 20 20 20 20 20 20 20 20 43 65 6c 1 ){. Cel
168c0 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 lInfo info;.
168d0 20 20 20 20 62 74 72 65 65 50 61 72 73 65 43 65 btreeParseCe
168e0 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 llPtr(pPage, pCe
168f0 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 ll, &info);.
16900 20 20 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 if( info.iOv
16910 65 72 66 6c 6f 77 0a 20 20 20 20 20 20 20 20 20 erflow.
16920 26 26 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e 69 4f && pCell+info.iO
16930 76 65 72 66 6c 6f 77 2b 33 3c 3d 70 50 61 67 65 verflow+3<=pPage
16940 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 2d 3e 6d ->aData+pPage->m
16950 61 73 6b 50 61 67 65 0a 20 20 20 20 20 20 20 20 askPage.
16960 20 26 26 20 69 46 72 6f 6d 3d 3d 67 65 74 34 62 && iFrom==get4b
16970 79 74 65 28 26 70 43 65 6c 6c 5b 69 6e 66 6f 2e yte(&pCell[info.
16980 69 4f 76 65 72 66 6c 6f 77 5d 29 0a 20 20 20 20 iOverflow]).
16990 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ){.
169a0 20 70 75 74 34 62 79 74 65 28 26 70 43 65 6c 6c put4byte(&pCell
169b0 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c 6f 77 5d [info.iOverflow]
169c0 2c 20 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 , iTo);.
169d0 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
169e0 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
169f0 20 20 20 20 20 20 20 20 69 66 28 20 67 65 74 34 if( get4
16a00 62 79 74 65 28 70 43 65 6c 6c 29 3d 3d 69 46 72 byte(pCell)==iFr
16a10 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 om ){.
16a20 70 75 74 34 62 79 74 65 28 70 43 65 6c 6c 2c 20 put4byte(pCell,
16a30 69 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 iTo);.
16a40 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d break;. }
16a50 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
16a60 20 0a 20 20 20 20 69 66 28 20 69 3d 3d 6e 43 65 . if( i==nCe
16a70 6c 6c 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ll ){. if(
16a80 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f 42 54 eType!=PTRMAP_BT
16a90 52 45 45 20 7c 7c 20 0a 20 20 20 20 20 20 20 20 REE || .
16aa0 20 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 get4byte(&pPag
16ab0 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e e->aData[pPage->
16ac0 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 21 3d 69 hdrOffset+8])!=i
16ad0 46 72 6f 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 From ){.
16ae0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
16af0 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 RRUPT_BKPT;.
16b00 20 20 7d 0a 20 20 20 20 20 20 70 75 74 34 62 79 }. put4by
16b10 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
16b20 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 [pPage->hdrOffse
16b30 74 2b 38 5d 2c 20 69 54 6f 29 3b 0a 20 20 20 20 t+8], iTo);.
16b40 7d 0a 0a 20 20 20 20 70 50 61 67 65 2d 3e 69 73 }.. pPage->is
16b50 49 6e 69 74 20 3d 20 69 73 49 6e 69 74 4f 72 69 Init = isInitOri
16b60 67 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 g;. }. return
16b70 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
16b80 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 6f 70 *.** Move the op
16b90 65 6e 20 64 61 74 61 62 61 73 65 20 70 61 67 65 en database page
16ba0 20 70 44 62 50 61 67 65 20 74 6f 20 6c 6f 63 61 pDbPage to loca
16bb0 74 69 6f 6e 20 69 46 72 65 65 50 61 67 65 20 69 tion iFreePage i
16bc0 6e 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 n the .** databa
16bd0 73 65 2e 20 54 68 65 20 70 44 62 50 61 67 65 20 se. The pDbPage
16be0 72 65 66 65 72 65 6e 63 65 20 72 65 6d 61 69 6e reference remain
16bf0 73 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a 20 54 s valid..**.** T
16c00 68 65 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 he isCommit flag
16c10 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 indicates that
16c20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 there is no need
16c30 20 74 6f 20 72 65 6d 65 6d 62 65 72 20 74 68 61 to remember tha
16c40 74 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c t.** the journal
16c50 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 79 6e needs to be syn
16c60 63 28 29 65 64 20 62 65 66 6f 72 65 20 64 61 74 c()ed before dat
16c70 61 62 61 73 65 20 70 61 67 65 20 70 44 62 50 61 abase page pDbPa
16c80 67 65 2d 3e 70 67 6e 6f 20 0a 2a 2a 20 63 61 6e ge->pgno .** can
16c90 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f 2e 20 be written to.
16ca0 54 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 61 The caller has a
16cb0 6c 72 65 61 64 79 20 70 72 6f 6d 69 73 65 64 20 lready promised
16cc0 6e 6f 74 20 74 6f 20 77 72 69 74 65 20 74 6f 20 not to write to
16cd0 74 68 61 74 0a 2a 2a 20 70 61 67 65 2e 0a 2a 2f that.** page..*/
16ce0 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 6c 6f .static int relo
16cf0 63 61 74 65 50 61 67 65 28 0a 20 20 42 74 53 68 catePage(. BtSh
16d00 61 72 65 64 20 2a 70 42 74 2c 20 20 20 20 20 20 ared *pBt,
16d10 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 2a 2f /* Btree */
16d20 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 44 62 50 . MemPage *pDbP
16d30 61 67 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 4f age, /* O
16d40 70 65 6e 20 70 61 67 65 20 74 6f 20 6d 6f 76 65 pen page to move
16d50 20 2a 2f 0a 20 20 75 38 20 65 54 79 70 65 2c 20 */. u8 eType,
16d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
16d70 2a 20 50 6f 69 6e 74 65 72 20 6d 61 70 20 27 74 * Pointer map 't
16d80 79 70 65 27 20 65 6e 74 72 79 20 66 6f 72 20 70 ype' entry for p
16d90 44 62 50 61 67 65 20 2a 2f 0a 20 20 50 67 6e 6f DbPage */. Pgno
16da0 20 69 50 74 72 50 61 67 65 2c 20 20 20 20 20 20 iPtrPage,
16db0 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
16dc0 6d 61 70 20 27 70 61 67 65 2d 6e 6f 27 20 65 6e map 'page-no' en
16dd0 74 72 79 20 66 6f 72 20 70 44 62 50 61 67 65 20 try for pDbPage
16de0 2a 2f 0a 20 20 50 67 6e 6f 20 69 46 72 65 65 50 */. Pgno iFreeP
16df0 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 2f 2a age, /*
16e00 20 54 68 65 20 6c 6f 63 61 74 69 6f 6e 20 74 6f The location to
16e10 20 6d 6f 76 65 20 70 44 62 50 61 67 65 20 74 6f move pDbPage to
16e20 20 2a 2f 0a 20 20 69 6e 74 20 69 73 43 6f 6d 6d */. int isComm
16e30 69 74 20 20 20 20 20 20 20 20 20 20 20 20 20 2f it /
16e40 2a 20 69 73 43 6f 6d 6d 69 74 20 66 6c 61 67 20 * isCommit flag
16e50 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 passed to sqlite
16e60 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 20 2a 3PagerMovepage *
16e70 2f 0a 29 7b 0a 20 20 4d 65 6d 50 61 67 65 20 2a /.){. MemPage *
16e80 70 50 74 72 50 61 67 65 3b 20 20 20 2f 2a 20 54 pPtrPage; /* T
16e90 68 65 20 70 61 67 65 20 74 68 61 74 20 63 6f 6e he page that con
16ea0 74 61 69 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 tains a pointer
16eb0 74 6f 20 70 44 62 50 61 67 65 20 2a 2f 0a 20 20 to pDbPage */.
16ec0 50 67 6e 6f 20 69 44 62 50 61 67 65 20 3d 20 70 Pgno iDbPage = p
16ed0 44 62 50 61 67 65 2d 3e 70 67 6e 6f 3b 0a 20 20 DbPage->pgno;.
16ee0 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 Pager *pPager =
16ef0 70 42 74 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69 pBt->pPager;. i
16f00 6e 74 20 72 63 3b 0a 0a 20 20 61 73 73 65 72 74 nt rc;.. assert
16f10 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
16f20 4f 56 45 52 46 4c 4f 57 32 20 7c 7c 20 65 54 79 OVERFLOW2 || eTy
16f30 70 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 pe==PTRMAP_OVERF
16f40 4c 4f 57 31 20 7c 7c 20 0a 20 20 20 20 20 20 65 LOW1 || . e
16f50 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 Type==PTRMAP_BTR
16f60 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d 50 54 52 EE || eType==PTR
16f70 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 29 3b 0a MAP_ROOTPAGE );.
16f80 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
16f90 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
16fa0 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
16fb0 73 65 72 74 28 20 70 44 62 50 61 67 65 2d 3e 70 sert( pDbPage->p
16fc0 42 74 3d 3d 70 42 74 20 29 3b 0a 0a 20 20 2f 2a Bt==pBt );.. /*
16fd0 20 4d 6f 76 65 20 70 61 67 65 20 69 44 62 50 61 Move page iDbPa
16fe0 67 65 20 66 72 6f 6d 20 69 74 73 20 63 75 72 72 ge from its curr
16ff0 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 ent location to
17000 70 61 67 65 20 6e 75 6d 62 65 72 20 69 46 72 65 page number iFre
17010 65 50 61 67 65 20 2a 2f 0a 20 20 54 52 41 43 45 ePage */. TRACE
17020 28 28 22 41 55 54 4f 56 41 43 55 55 4d 3a 20 4d (("AUTOVACUUM: M
17030 6f 76 69 6e 67 20 25 64 20 74 6f 20 66 72 65 65 oving %d to free
17040 20 70 61 67 65 20 25 64 20 28 70 74 72 20 70 61 page %d (ptr pa
17050 67 65 20 25 64 20 74 79 70 65 20 25 64 29 5c 6e ge %d type %d)\n
17060 22 2c 20 0a 20 20 20 20 20 20 69 44 62 50 61 67 ", . iDbPag
17070 65 2c 20 69 46 72 65 65 50 61 67 65 2c 20 69 50 e, iFreePage, iP
17080 74 72 50 61 67 65 2c 20 65 54 79 70 65 29 29 3b trPage, eType));
17090 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
170a0 61 67 65 72 4d 6f 76 65 70 61 67 65 28 70 50 61 agerMovepage(pPa
170b0 67 65 72 2c 20 70 44 62 50 61 67 65 2d 3e 70 44 ger, pDbPage->pD
170c0 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 65 bPage, iFreePage
170d0 2c 20 69 73 43 6f 6d 6d 69 74 29 3b 0a 20 20 69 , isCommit);. i
170e0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
170f0 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 ){. return r
17100 63 3b 0a 20 20 7d 0a 20 20 70 44 62 50 61 67 65 c;. }. pDbPage
17110 2d 3e 70 67 6e 6f 20 3d 20 69 46 72 65 65 50 61 ->pgno = iFreePa
17120 67 65 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 44 62 ge;.. /* If pDb
17130 50 61 67 65 20 77 61 73 20 61 20 62 74 72 65 65 Page was a btree
17140 2d 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 6d -page, then it m
17150 61 79 20 68 61 76 65 20 63 68 69 6c 64 20 70 61 ay have child pa
17160 67 65 73 20 61 6e 64 2f 6f 72 20 63 65 6c 6c 73 ges and/or cells
17170 0a 20 20 2a 2a 20 74 68 61 74 20 70 6f 69 6e 74 . ** that point
17180 20 74 6f 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 to overflow pag
17190 65 73 2e 20 54 68 65 20 70 6f 69 6e 74 65 72 20 es. The pointer
171a0 6d 61 70 20 65 6e 74 72 69 65 73 20 66 6f 72 20 map entries for
171b0 61 6c 6c 20 74 68 65 73 65 0a 20 20 2a 2a 20 70 all these. ** p
171c0 61 67 65 73 20 6e 65 65 64 20 74 6f 20 62 65 20 ages need to be
171d0 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2a 0a 20 20 changed.. **.
171e0 2a 2a 20 49 66 20 70 44 62 50 61 67 65 20 69 73 ** If pDbPage is
171f0 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
17200 65 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 e, then the firs
17210 74 20 34 20 62 79 74 65 73 20 6d 61 79 20 73 74 t 4 bytes may st
17220 6f 72 65 20 61 0a 20 20 2a 2a 20 70 6f 69 6e 74 ore a. ** point
17230 65 72 20 74 6f 20 61 20 73 75 62 73 65 71 75 65 er to a subseque
17240 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 nt overflow page
17250 2e 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 . If this is the
17260 20 63 61 73 65 2c 20 74 68 65 6e 0a 20 20 2a 2a case, then. **
17270 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d 61 70 the pointer map
17280 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 70 64 needs to be upd
17290 61 74 65 64 20 66 6f 72 20 74 68 65 20 73 75 62 ated for the sub
172a0 73 65 71 75 65 6e 74 20 6f 76 65 72 66 6c 6f 77 sequent overflow
172b0 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 page.. */. if
172c0 28 20 65 54 79 70 65 3d 3d 50 54 52 4d 41 50 5f ( eType==PTRMAP_
172d0 42 54 52 45 45 20 7c 7c 20 65 54 79 70 65 3d 3d BTREE || eType==
172e0 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 45 20 PTRMAP_ROOTPAGE
172f0 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 65 74 43 ){. rc = setC
17300 68 69 6c 64 50 74 72 6d 61 70 73 28 70 44 62 50 hildPtrmaps(pDbP
17310 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
17320 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
17330 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
17340 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
17350 20 20 20 50 67 6e 6f 20 6e 65 78 74 4f 76 66 6c Pgno nextOvfl
17360 20 3d 20 67 65 74 34 62 79 74 65 28 70 44 62 50 = get4byte(pDbP
17370 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a 20 20 20 age->aData);.
17380 20 69 66 28 20 6e 65 78 74 4f 76 66 6c 21 3d 30 if( nextOvfl!=0
17390 20 29 7b 0a 20 20 20 20 20 20 70 74 72 6d 61 70 ){. ptrmap
173a0 50 75 74 28 70 42 74 2c 20 6e 65 78 74 4f 76 66 Put(pBt, nextOvf
173b0 6c 2c 20 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c l, PTRMAP_OVERFL
173c0 4f 57 32 2c 20 69 46 72 65 65 50 61 67 65 2c 20 OW2, iFreePage,
173d0 26 72 63 29 3b 0a 20 20 20 20 20 20 69 66 28 20 &rc);. if(
173e0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
173f0 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 . return
17400 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rc;. }.
17410 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 78 20 }. }.. /* Fix
17420 74 68 65 20 64 61 74 61 62 61 73 65 20 70 6f 69 the database poi
17430 6e 74 65 72 20 6f 6e 20 70 61 67 65 20 69 50 74 nter on page iPt
17440 72 50 61 67 65 20 74 68 61 74 20 70 6f 69 6e 74 rPage that point
17450 65 64 20 61 74 20 69 44 62 50 61 67 65 20 73 6f ed at iDbPage so
17460 0a 20 20 2a 2a 20 74 68 61 74 20 69 74 20 70 6f . ** that it po
17470 69 6e 74 73 20 61 74 20 69 46 72 65 65 50 61 67 ints at iFreePag
17480 65 2e 20 41 6c 73 6f 20 66 69 78 20 74 68 65 20 e. Also fix the
17490 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 72 pointer map entr
174a0 79 20 66 6f 72 0a 20 20 2a 2a 20 69 50 74 72 50 y for. ** iPtrP
174b0 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 age.. */. if(
174c0 65 54 79 70 65 21 3d 50 54 52 4d 41 50 5f 52 4f eType!=PTRMAP_RO
174d0 4f 54 50 41 47 45 20 29 7b 0a 20 20 20 20 72 63 OTPAGE ){. rc
174e0 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
174f0 70 42 74 2c 20 69 50 74 72 50 61 67 65 2c 20 26 pBt, iPtrPage, &
17500 70 50 74 72 50 61 67 65 2c 20 30 29 3b 0a 20 20 pPtrPage, 0);.
17510 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
17520 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 74 _OK ){. ret
17530 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 urn rc;. }.
17540 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
17550 67 65 72 57 72 69 74 65 28 70 50 74 72 50 61 67 gerWrite(pPtrPag
17560 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
17570 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
17580 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 65 6c 65 OK ){. rele
17590 61 73 65 50 61 67 65 28 70 50 74 72 50 61 67 65 asePage(pPtrPage
175a0 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
175b0 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 rc;. }. rc
175c0 20 3d 20 6d 6f 64 69 66 79 50 61 67 65 50 6f 69 = modifyPagePoi
175d0 6e 74 65 72 28 70 50 74 72 50 61 67 65 2c 20 69 nter(pPtrPage, i
175e0 44 62 50 61 67 65 2c 20 69 46 72 65 65 50 61 67 DbPage, iFreePag
175f0 65 2c 20 65 54 79 70 65 29 3b 0a 20 20 20 20 72 e, eType);. r
17600 65 6c 65 61 73 65 50 61 67 65 28 70 50 74 72 50 eleasePage(pPtrP
17610 61 67 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 age);. if( rc
17620 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
17630 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 ptrmapPut(p
17640 42 74 2c 20 69 46 72 65 65 50 61 67 65 2c 20 65 Bt, iFreePage, e
17650 54 79 70 65 2c 20 69 50 74 72 50 61 67 65 2c 20 Type, iPtrPage,
17660 26 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a &rc);. }. }.
17670 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
17680 2f 2a 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 /* Forward decla
17690 72 61 74 69 6f 6e 20 72 65 71 75 69 72 65 64 20 ration required
176a0 62 79 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 by incrVacuumSte
176b0 70 28 29 2e 20 2a 2f 0a 73 74 61 74 69 63 20 69 p(). */.static i
176c0 6e 74 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 nt allocateBtree
176d0 50 61 67 65 28 42 74 53 68 61 72 65 64 20 2a 2c Page(BtShared *,
176e0 20 4d 65 6d 50 61 67 65 20 2a 2a 2c 20 50 67 6e MemPage **, Pgn
176f0 6f 20 2a 2c 20 50 67 6e 6f 2c 20 75 38 29 3b 0a o *, Pgno, u8);.
17700 0a 2f 2a 0a 2a 2a 20 50 65 72 66 6f 72 6d 20 61 ./*.** Perform a
17710 20 73 69 6e 67 6c 65 20 73 74 65 70 20 6f 66 20 single step of
17720 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 an incremental-v
17730 61 63 75 75 6d 2e 20 49 66 20 73 75 63 63 65 73 acuum. If succes
17740 73 66 75 6c 2c 0a 2a 2a 20 72 65 74 75 72 6e 20 sful,.** return
17750 53 51 4c 49 54 45 5f 4f 4b 2e 20 49 66 20 74 68 SQLITE_OK. If th
17760 65 72 65 20 69 73 20 6e 6f 20 77 6f 72 6b 20 74 ere is no work t
17770 6f 20 64 6f 20 28 61 6e 64 20 74 68 65 72 65 66 o do (and theref
17780 6f 72 65 20 6e 6f 0a 2a 2a 20 70 6f 69 6e 74 20 ore no.** point
17790 69 6e 20 63 61 6c 6c 69 6e 67 20 74 68 69 73 20 in calling this
177a0 66 75 6e 63 74 69 6f 6e 20 61 67 61 69 6e 29 2c function again),
177b0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 return SQLITE_D
177c0 4f 4e 45 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 72 65 20 ONE..**.** More
177d0 73 70 65 63 69 66 69 63 6c 79 2c 20 74 68 69 73 specificly, this
177e0 20 66 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 function attemp
177f0 74 73 20 74 6f 20 72 65 2d 6f 72 67 61 6e 69 7a ts to re-organiz
17800 65 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 61 e the .** databa
17810 73 65 20 73 6f 20 74 68 61 74 20 74 68 65 20 6c se so that the l
17820 61 73 74 20 70 61 67 65 20 6f 66 20 74 68 65 20 ast page of the
17830 66 69 6c 65 20 63 75 72 72 65 6e 74 6c 79 20 69 file currently i
17840 6e 20 75 73 65 0a 2a 2a 20 69 73 20 6e 6f 20 6c n use.** is no l
17850 6f 6e 67 65 72 20 69 6e 20 75 73 65 2e 0a 2a 2a onger in use..**
17860 0a 2a 2a 20 49 66 20 74 68 65 20 6e 46 69 6e 20 .** If the nFin
17870 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 6e parameter is non
17880 2d 7a 65 72 6f 2c 20 74 68 69 73 20 66 75 6e 63 -zero, this func
17890 74 69 6f 6e 20 61 73 73 75 6d 65 73 0a 2a 2a 20 tion assumes.**
178a0 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 that the caller
178b0 77 69 6c 6c 20 6b 65 65 70 20 63 61 6c 6c 69 6e will keep callin
178c0 67 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 70 g incrVacuumStep
178d0 28 29 20 75 6e 74 69 6c 0a 2a 2a 20 69 74 20 72 () until.** it r
178e0 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f eturns SQLITE_DO
178f0 4e 45 20 6f 72 20 61 6e 20 65 72 72 6f 72 2c 20 NE or an error,
17900 61 6e 64 20 74 68 61 74 20 6e 46 69 6e 20 69 73 and that nFin is
17910 20 74 68 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f the.** number o
17920 66 20 70 61 67 65 73 20 74 68 65 20 64 61 74 61 f pages the data
17930 62 61 73 65 20 66 69 6c 65 20 77 69 6c 6c 20 63 base file will c
17940 6f 6e 74 61 69 6e 20 61 66 74 65 72 20 74 68 69 ontain after thi
17950 73 20 0a 2a 2a 20 70 72 6f 63 65 73 73 20 69 73 s .** process is
17960 20 63 6f 6d 70 6c 65 74 65 2e 20 20 49 66 20 6e complete. If n
17970 46 69 6e 20 69 73 20 7a 65 72 6f 2c 20 69 74 20 Fin is zero, it
17980 69 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 0a is assumed that.
17990 2a 2a 20 69 6e 63 72 56 61 63 75 75 6d 53 74 65 ** incrVacuumSte
179a0 70 28 29 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c p() will be call
179b0 65 64 20 61 20 66 69 6e 69 74 65 20 61 6d 6f 75 ed a finite amou
179c0 6e 74 20 6f 66 20 74 69 6d 65 73 0a 2a 2a 20 77 nt of times.** w
179d0 68 69 63 68 20 6d 61 79 20 6f 72 20 6d 61 79 20 hich may or may
179e0 6e 6f 74 20 65 6d 70 74 79 20 74 68 65 20 66 72 not empty the fr
179f0 65 65 6c 69 73 74 2e 20 20 41 20 66 75 6c 6c 20 eelist. A full
17a00 61 75 74 6f 76 61 63 75 75 6d 0a 2a 2a 20 68 61 autovacuum.** ha
17a10 73 20 6e 46 69 6e 3e 30 2e 20 20 41 20 22 50 52 s nFin>0. A "PR
17a20 41 47 4d 41 20 69 6e 63 72 65 6d 65 6e 74 61 6c AGMA incremental
17a30 5f 76 61 63 75 75 6d 22 20 68 61 73 20 6e 46 69 _vacuum" has nFi
17a40 6e 3d 3d 30 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 n==0..*/.static
17a50 69 6e 74 20 69 6e 63 72 56 61 63 75 75 6d 53 74 int incrVacuumSt
17a60 65 70 28 42 74 53 68 61 72 65 64 20 2a 70 42 74 ep(BtShared *pBt
17a70 2c 20 50 67 6e 6f 20 6e 46 69 6e 2c 20 50 67 6e , Pgno nFin, Pgn
17a80 6f 20 69 4c 61 73 74 50 67 29 7b 0a 20 20 50 67 o iLastPg){. Pg
17a90 6e 6f 20 6e 46 72 65 65 4c 69 73 74 3b 20 20 20 no nFreeList;
17aa0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
17ab0 72 20 6f 66 20 70 61 67 65 73 20 73 74 69 6c 6c r of pages still
17ac0 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 on the free-lis
17ad0 74 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 0a 0a t */. int rc;..
17ae0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
17af0 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 3_mutex_held(pBt
17b00 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 ->mutex) );. as
17b10 73 65 72 74 28 20 69 4c 61 73 74 50 67 3e 6e 46 sert( iLastPg>nF
17b20 69 6e 20 29 3b 0a 0a 20 20 69 66 28 20 21 50 54 in );.. if( !PT
17b30 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c RMAP_ISPAGE(pBt,
17b40 20 69 4c 61 73 74 50 67 29 20 26 26 20 69 4c 61 iLastPg) && iLa
17b50 73 74 50 67 21 3d 50 45 4e 44 49 4e 47 5f 42 59 stPg!=PENDING_BY
17b60 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
17b70 20 20 20 20 75 38 20 65 54 79 70 65 3b 0a 20 20 u8 eType;.
17b80 20 20 50 67 6e 6f 20 69 50 74 72 50 61 67 65 3b Pgno iPtrPage;
17b90 0a 0a 20 20 20 20 6e 46 72 65 65 4c 69 73 74 20 .. nFreeList
17ba0 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 2d = get4byte(&pBt-
17bb0 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 >pPage1->aData[3
17bc0 36 5d 29 3b 0a 20 20 20 20 69 66 28 20 6e 46 72 6]);. if( nFr
17bd0 65 65 4c 69 73 74 3d 3d 30 20 29 7b 0a 20 20 20 eeList==0 ){.
17be0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
17bf0 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 _DONE;. }..
17c00 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 rc = ptrmapGet
17c10 28 70 42 74 2c 20 69 4c 61 73 74 50 67 2c 20 26 (pBt, iLastPg, &
17c20 65 54 79 70 65 2c 20 26 69 50 74 72 50 61 67 65 eType, &iPtrPage
17c30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
17c40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
17c50 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
17c60 20 7d 0a 20 20 20 20 69 66 28 20 65 54 79 70 65 }. if( eType
17c70 3d 3d 50 54 52 4d 41 50 5f 52 4f 4f 54 50 41 47 ==PTRMAP_ROOTPAG
17c80 45 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 E ){. retur
17c90 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
17ca0 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 0a 20 20 _BKPT;. }..
17cb0 20 20 69 66 28 20 65 54 79 70 65 3d 3d 50 54 52 if( eType==PTR
17cc0 4d 41 50 5f 46 52 45 45 50 41 47 45 20 29 7b 0a MAP_FREEPAGE ){.
17cd0 20 20 20 20 20 20 69 66 28 20 6e 46 69 6e 3d 3d if( nFin==
17ce0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 0 ){. /*
17cf0 52 65 6d 6f 76 65 20 74 68 65 20 70 61 67 65 20 Remove the page
17d00 66 72 6f 6d 20 74 68 65 20 66 69 6c 65 73 20 66 from the files f
17d10 72 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 69 ree-list. This i
17d20 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 0a 20 s not required.
17d30 20 20 20 20 20 20 20 2a 2a 20 69 66 20 6e 46 69 ** if nFi
17d40 6e 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 49 n is non-zero. I
17d50 6e 20 74 68 61 74 20 63 61 73 65 2c 20 74 68 65 n that case, the
17d60 20 66 72 65 65 2d 6c 69 73 74 20 77 69 6c 6c 20 free-list will
17d70 62 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 be. ** tr
17d80 75 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 uncated to zero
17d90 61 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 after this funct
17da0 69 6f 6e 20 72 65 74 75 72 6e 73 2c 20 73 6f 20 ion returns, so
17db0 69 74 20 64 6f 65 73 6e 27 74 20 0a 20 20 20 20 it doesn't .
17dc0 20 20 20 20 2a 2a 20 6d 61 74 74 65 72 20 69 66 ** matter if
17dd0 20 69 74 20 73 74 69 6c 6c 20 63 6f 6e 74 61 69 it still contai
17de0 6e 73 20 73 6f 6d 65 20 67 61 72 62 61 67 65 20 ns some garbage
17df0 65 6e 74 72 69 65 73 2e 0a 20 20 20 20 20 20 20 entries..
17e00 20 2a 2f 0a 20 20 20 20 20 20 20 20 50 67 6e 6f */. Pgno
17e10 20 69 46 72 65 65 50 67 3b 0a 20 20 20 20 20 20 iFreePg;.
17e20 20 20 4d 65 6d 50 61 67 65 20 2a 70 46 72 65 65 MemPage *pFree
17e30 50 67 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d Pg;. rc =
17e40 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 65 50 61 allocateBtreePa
17e50 67 65 28 70 42 74 2c 20 26 70 46 72 65 65 50 67 ge(pBt, &pFreePg
17e60 2c 20 26 69 46 72 65 65 50 67 2c 20 69 4c 61 73 , &iFreePg, iLas
17e70 74 50 67 2c 20 31 29 3b 0a 20 20 20 20 20 20 20 tPg, 1);.
17e80 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
17e90 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
17ea0 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
17eb0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 61 73 73 }. ass
17ec0 65 72 74 28 20 69 46 72 65 65 50 67 3d 3d 69 4c ert( iFreePg==iL
17ed0 61 73 74 50 67 20 29 3b 0a 20 20 20 20 20 20 20 astPg );.
17ee0 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 46 72 releasePage(pFr
17ef0 65 65 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 eePg);. }.
17f00 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 } else {.
17f10 20 20 50 67 6e 6f 20 69 46 72 65 65 50 67 3b 20 Pgno iFreePg;
17f20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
17f30 6e 64 65 78 20 6f 66 20 66 72 65 65 20 70 61 67 ndex of free pag
17f40 65 20 74 6f 20 6d 6f 76 65 20 70 4c 61 73 74 50 e to move pLastP
17f50 67 20 74 6f 20 2a 2f 0a 20 20 20 20 20 20 4d 65 g to */. Me
17f60 6d 50 61 67 65 20 2a 70 4c 61 73 74 50 67 3b 0a mPage *pLastPg;.
17f70 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 . rc = btre
17f80 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 69 4c eGetPage(pBt, iL
17f90 61 73 74 50 67 2c 20 26 70 4c 61 73 74 50 67 2c astPg, &pLastPg,
17fa0 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 0);. if( r
17fb0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
17fc0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
17fd0 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 c;. }..
17fe0 20 20 2f 2a 20 49 66 20 6e 46 69 6e 20 69 73 20 /* If nFin is
17ff0 7a 65 72 6f 2c 20 74 68 69 73 20 6c 6f 6f 70 20 zero, this loop
18000 72 75 6e 73 20 65 78 61 63 74 6c 79 20 6f 6e 63 runs exactly onc
18010 65 20 61 6e 64 20 70 61 67 65 20 70 4c 61 73 74 e and page pLast
18020 50 67 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 73 Pg. ** is s
18030 77 61 70 70 65 64 20 77 69 74 68 20 74 68 65 20 wapped with the
18040 66 69 72 73 74 20 66 72 65 65 20 70 61 67 65 20 first free page
18050 70 75 6c 6c 65 64 20 6f 66 66 20 74 68 65 20 66 pulled off the f
18060 72 65 65 20 6c 69 73 74 2e 0a 20 20 20 20 20 20 ree list..
18070 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4f 6e 20 74 **. ** On t
18080 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20 69 he other hand, i
18090 66 20 6e 46 69 6e 20 69 73 20 67 72 65 61 74 65 f nFin is greate
180a0 72 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74 68 65 r than zero, the
180b0 6e 20 6b 65 65 70 0a 20 20 20 20 20 20 2a 2a 20 n keep. **
180c0 6c 6f 6f 70 69 6e 67 20 75 6e 74 69 6c 20 61 20 looping until a
180d0 66 72 65 65 2d 70 61 67 65 20 6c 6f 63 61 74 65 free-page locate
180e0 64 20 77 69 74 68 69 6e 20 74 68 65 20 66 69 72 d within the fir
180f0 73 74 20 6e 46 69 6e 20 70 61 67 65 73 0a 20 20 st nFin pages.
18100 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 ** of the fi
18110 6c 65 20 69 73 20 66 6f 75 6e 64 2e 0a 20 20 20 le is found..
18120 20 20 20 2a 2f 0a 20 20 20 20 20 20 64 6f 20 7b */. do {
18130 0a 20 20 20 20 20 20 20 20 4d 65 6d 50 61 67 65 . MemPage
18140 20 2a 70 46 72 65 65 50 67 3b 0a 20 20 20 20 20 *pFreePg;.
18150 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 rc = allocate
18160 42 74 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 BtreePage(pBt, &
18170 70 46 72 65 65 50 67 2c 20 26 69 46 72 65 65 50 pFreePg, &iFreeP
18180 67 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 g, 0, 0);.
18190 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
181a0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 _OK ){.
181b0 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 4c 61 releasePage(pLa
181c0 73 74 50 67 29 3b 0a 20 20 20 20 20 20 20 20 20 stPg);.
181d0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
181e0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 72 65 }. re
181f0 6c 65 61 73 65 50 61 67 65 28 70 46 72 65 65 50 leasePage(pFreeP
18200 67 29 3b 0a 20 20 20 20 20 20 7d 77 68 69 6c 65 g);. }while
18210 28 20 6e 46 69 6e 21 3d 30 20 26 26 20 69 46 72 ( nFin!=0 && iFr
18220 65 65 50 67 3e 6e 46 69 6e 20 29 3b 0a 20 20 20 eePg>nFin );.
18230 20 20 20 61 73 73 65 72 74 28 20 69 46 72 65 65 assert( iFree
18240 50 67 3c 69 4c 61 73 74 50 67 20 29 3b 0a 20 20 Pg<iLastPg );.
18250 20 20 20 20 0a 20 20 20 20 20 20 72 63 20 3d 20 . rc =
18260 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
18270 65 28 70 4c 61 73 74 50 67 2d 3e 70 44 62 50 61 e(pLastPg->pDbPa
18280 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 ge);. if( r
18290 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
182a0 20 20 20 20 20 20 20 20 72 63 20 3d 20 72 65 6c rc = rel
182b0 6f 63 61 74 65 50 61 67 65 28 70 42 74 2c 20 70 ocatePage(pBt, p
182c0 4c 61 73 74 50 67 2c 20 65 54 79 70 65 2c 20 69 LastPg, eType, i
182d0 50 74 72 50 61 67 65 2c 20 69 46 72 65 65 50 67 PtrPage, iFreePg
182e0 2c 20 6e 46 69 6e 21 3d 30 29 3b 0a 20 20 20 20 , nFin!=0);.
182f0 20 20 7d 0a 20 20 20 20 20 20 72 65 6c 65 61 73 }. releas
18300 65 50 61 67 65 28 70 4c 61 73 74 50 67 29 3b 0a ePage(pLastPg);.
18310 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
18320 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
18330 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
18340 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
18350 0a 20 20 69 66 28 20 6e 46 69 6e 3d 3d 30 20 29 . if( nFin==0 )
18360 7b 0a 20 20 20 20 69 4c 61 73 74 50 67 2d 2d 3b {. iLastPg--;
18370 0a 20 20 20 20 77 68 69 6c 65 28 20 69 4c 61 73 . while( iLas
18380 74 50 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 tPg==PENDING_BYT
18390 45 5f 50 41 47 45 28 70 42 74 29 7c 7c 50 54 52 E_PAGE(pBt)||PTR
183a0 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
183b0 69 4c 61 73 74 50 67 29 20 29 7b 0a 20 20 20 20 iLastPg) ){.
183c0 20 20 69 66 28 20 50 54 52 4d 41 50 5f 49 53 50 if( PTRMAP_ISP
183d0 41 47 45 28 70 42 74 2c 20 69 4c 61 73 74 50 67 AGE(pBt, iLastPg
183e0 29 20 29 7b 0a 20 20 20 20 20 20 20 20 4d 65 6d ) ){. Mem
183f0 50 61 67 65 20 2a 70 50 67 3b 0a 20 20 20 20 20 Page *pPg;.
18400 20 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 rc = btreeGet
18410 50 61 67 65 28 70 42 74 2c 20 69 4c 61 73 74 50 Page(pBt, iLastP
18420 67 2c 20 26 70 50 67 2c 20 30 29 3b 0a 20 20 20 g, &pPg, 0);.
18430 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
18440 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
18450 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
18460 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
18470 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
18480 65 72 57 72 69 74 65 28 70 50 67 2d 3e 70 44 62 erWrite(pPg->pDb
18490 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 72 Page);. r
184a0 65 6c 65 61 73 65 50 61 67 65 28 70 50 67 29 3b eleasePage(pPg);
184b0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 . if( rc!
184c0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
184d0 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 return r
184e0 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 c;. }.
184f0 20 20 20 7d 0a 20 20 20 20 20 20 69 4c 61 73 74 }. iLast
18500 50 67 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Pg--;. }.
18510 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e sqlite3PagerTrun
18520 63 61 74 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 cateImage(pBt->p
18530 50 61 67 65 72 2c 20 69 4c 61 73 74 50 67 29 3b Pager, iLastPg);
18540 0a 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 . pBt->nPage
18550 3d 20 69 4c 61 73 74 50 67 3b 0a 20 20 7d 0a 20 = iLastPg;. }.
18560 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
18570 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 77 72 K;.}../*.** A wr
18580 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
18590 6d 75 73 74 20 62 65 20 6f 70 65 6e 65 64 20 62 must be opened b
185a0 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 74 68 efore calling th
185b0 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 20 is function..**
185c0 49 74 20 70 65 72 66 6f 72 6d 73 20 61 20 73 69 It performs a si
185d0 6e 67 6c 65 20 75 6e 69 74 20 6f 66 20 77 6f 72 ngle unit of wor
185e0 6b 20 74 6f 77 61 72 64 73 20 61 6e 20 69 6e 63 k towards an inc
185f0 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d 2e remental vacuum.
18600 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e .**.** If the in
18610 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
18620 20 69 73 20 66 69 6e 69 73 68 65 64 20 61 66 74 is finished aft
18630 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e er this function
18640 20 68 61 73 20 72 75 6e 2c 0a 2a 2a 20 53 51 4c has run,.** SQL
18650 49 54 45 5f 44 4f 4e 45 20 69 73 20 72 65 74 75 ITE_DONE is retu
18660 72 6e 65 64 2e 20 49 66 20 69 74 20 69 73 20 6e rned. If it is n
18670 6f 74 20 66 69 6e 69 73 68 65 64 2c 20 62 75 74 ot finished, but
18680 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 72 no error occurr
18690 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b ed,.** SQLITE_OK
186a0 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f 74 is returned. Ot
186b0 68 65 72 77 69 73 65 20 61 6e 20 53 51 4c 69 74 herwise an SQLit
186c0 65 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 0a 2a e error code. .*
186d0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
186e0 65 65 49 6e 63 72 56 61 63 75 75 6d 28 42 74 72 eeIncrVacuum(Btr
186f0 65 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 ee *p){. int rc
18700 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
18710 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 0a 20 20 73 t = p->pBt;.. s
18720 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 qlite3BtreeEnter
18730 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 (p);. assert( p
18740 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 6f Bt->inTransactio
18750 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 26 n==TRANS_WRITE &
18760 26 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 & p->inTrans==TR
18770 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 69 ANS_WRITE );. i
18780 66 28 20 21 70 42 74 2d 3e 61 75 74 6f 56 61 63 f( !pBt->autoVac
18790 75 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 uum ){. rc =
187a0 53 51 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d SQLITE_DONE;. }
187b0 65 6c 73 65 7b 0a 20 20 20 20 69 6e 76 61 6c 69 else{. invali
187c0 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 dateAllOverflowC
187d0 61 63 68 65 28 70 42 74 29 3b 0a 20 20 20 20 72 ache(pBt);. r
187e0 63 20 3d 20 69 6e 63 72 56 61 63 75 75 6d 53 74 c = incrVacuumSt
187f0 65 70 28 70 42 74 2c 20 30 2c 20 62 74 72 65 65 ep(pBt, 0, btree
18800 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 29 3b Pagecount(pBt));
18810 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
18820 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
18830 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
18840 72 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 67 rWrite(pBt->pPag
18850 65 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 e1->pDbPage);.
18860 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 42 put4byte(&pB
18870 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
18880 5b 32 38 5d 2c 20 70 42 74 2d 3e 6e 50 61 67 65 [28], pBt->nPage
18890 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 );. }. }. s
188a0 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
188b0 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 (p);. return rc
188c0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ;.}../*.** This
188d0 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
188e0 64 20 70 72 69 6f 72 20 74 6f 20 73 71 6c 69 74 d prior to sqlit
188f0 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 20 77 68 e3PagerCommit wh
18900 65 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e en a transaction
18910 0a 2a 2a 20 69 73 20 63 6f 6d 6d 69 74 65 64 20 .** is commited
18920 66 6f 72 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 for an auto-vacu
18930 75 6d 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a 0a um database..**.
18940 2a 2a 20 49 66 20 53 51 4c 49 54 45 5f 4f 4b 20 ** If SQLITE_OK
18950 69 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 65 is returned, the
18960 6e 20 2a 70 6e 54 72 75 6e 63 20 69 73 20 73 65 n *pnTrunc is se
18970 74 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 t to the number
18980 6f 66 20 70 61 67 65 73 0a 2a 2a 20 74 68 65 20 of pages.** the
18990 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 73 68 database file sh
189a0 6f 75 6c 64 20 62 65 20 74 72 75 6e 63 61 74 65 ould be truncate
189b0 64 20 74 6f 20 64 75 72 69 6e 67 20 74 68 65 20 d to during the
189c0 63 6f 6d 6d 69 74 20 70 72 6f 63 65 73 73 2e 20 commit process.
189d0 0a 2a 2a 20 69 2e 65 2e 20 74 68 65 20 64 61 74 .** i.e. the dat
189e0 61 62 61 73 65 20 68 61 73 20 62 65 65 6e 20 72 abase has been r
189f0 65 6f 72 67 61 6e 69 7a 65 64 20 73 6f 20 74 68 eorganized so th
18a00 61 74 20 6f 6e 6c 79 20 74 68 65 20 66 69 72 73 at only the firs
18a10 74 20 2a 70 6e 54 72 75 6e 63 0a 2a 2a 20 70 61 t *pnTrunc.** pa
18a20 67 65 73 20 61 72 65 20 69 6e 20 75 73 65 2e 0a ges are in use..
18a30 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 61 75 */.static int au
18a40 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 42 toVacuumCommit(B
18a50 74 53 68 61 72 65 64 20 2a 70 42 74 29 7b 0a 20 tShared *pBt){.
18a60 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
18a70 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 _OK;. Pager *pP
18a80 61 67 65 72 20 3d 20 70 42 74 2d 3e 70 50 61 67 ager = pBt->pPag
18a90 65 72 3b 0a 20 20 56 56 41 5f 4f 4e 4c 59 28 20 er;. VVA_ONLY(
18aa0 69 6e 74 20 6e 52 65 66 20 3d 20 73 71 6c 69 74 int nRef = sqlit
18ab0 65 33 50 61 67 65 72 52 65 66 63 6f 75 6e 74 28 e3PagerRefcount(
18ac0 70 50 61 67 65 72 29 20 29 3b 0a 0a 20 20 61 73 pPager) );.. as
18ad0 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
18ae0 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 tex_held(pBt->mu
18af0 74 65 78 29 20 29 3b 0a 20 20 69 6e 76 61 6c 69 tex) );. invali
18b00 64 61 74 65 41 6c 6c 4f 76 65 72 66 6c 6f 77 43 dateAllOverflowC
18b10 61 63 68 65 28 70 42 74 29 3b 0a 20 20 61 73 73 ache(pBt);. ass
18b20 65 72 74 28 70 42 74 2d 3e 61 75 74 6f 56 61 63 ert(pBt->autoVac
18b30 75 75 6d 29 3b 0a 20 20 69 66 28 20 21 70 42 74 uum);. if( !pBt
18b40 2d 3e 69 6e 63 72 56 61 63 75 75 6d 20 29 7b 0a ->incrVacuum ){.
18b50 20 20 20 20 50 67 6e 6f 20 6e 46 69 6e 3b 20 20 Pgno nFin;
18b60 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
18b70 20 6f 66 20 70 61 67 65 73 20 69 6e 20 64 61 74 of pages in dat
18b80 61 62 61 73 65 20 61 66 74 65 72 20 61 75 74 6f abase after auto
18b90 76 61 63 75 75 6d 69 6e 67 20 2a 2f 0a 20 20 20 vacuuming */.
18ba0 20 50 67 6e 6f 20 6e 46 72 65 65 3b 20 20 20 20 Pgno nFree;
18bb0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
18bc0 20 70 61 67 65 73 20 6f 6e 20 74 68 65 20 66 72 pages on the fr
18bd0 65 65 6c 69 73 74 20 69 6e 69 74 69 61 6c 6c 79 eelist initially
18be0 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 6e 50 74 */. Pgno nPt
18bf0 72 6d 61 70 3b 20 20 20 20 20 20 2f 2a 20 4e 75 rmap; /* Nu
18c00 6d 62 65 72 20 6f 66 20 50 74 72 4d 61 70 20 70 mber of PtrMap p
18c10 61 67 65 73 20 74 6f 20 62 65 20 66 72 65 65 64 ages to be freed
18c20 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 69 46 72 */. Pgno iFr
18c30 65 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ee; /* Th
18c40 65 20 6e 65 78 74 20 70 61 67 65 20 74 6f 20 62 e next page to b
18c50 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 69 e freed */. i
18c60 6e 74 20 6e 45 6e 74 72 79 3b 20 20 20 20 20 20 nt nEntry;
18c70 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
18c80 6e 74 72 69 65 73 20 6f 6e 20 6f 6e 65 20 70 74 ntries on one pt
18c90 72 6d 61 70 20 70 61 67 65 20 2a 2f 0a 20 20 20 rmap page */.
18ca0 20 50 67 6e 6f 20 6e 4f 72 69 67 3b 20 20 20 20 Pgno nOrig;
18cb0 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
18cc0 73 69 7a 65 20 62 65 66 6f 72 65 20 66 72 65 65 size before free
18cd0 69 6e 67 20 2a 2f 0a 0a 20 20 20 20 6e 4f 72 69 ing */.. nOri
18ce0 67 20 3d 20 62 74 72 65 65 50 61 67 65 63 6f 75 g = btreePagecou
18cf0 6e 74 28 70 42 74 29 3b 0a 20 20 20 20 69 66 28 nt(pBt);. if(
18d00 20 50 54 52 4d 41 50 5f 49 53 50 41 47 45 28 70 PTRMAP_ISPAGE(p
18d10 42 74 2c 20 6e 4f 72 69 67 29 20 7c 7c 20 6e 4f Bt, nOrig) || nO
18d20 72 69 67 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 rig==PENDING_BYT
18d30 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 E_PAGE(pBt) ){.
18d40 20 20 20 20 20 2f 2a 20 49 74 20 69 73 20 6e 6f /* It is no
18d50 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 63 72 t possible to cr
18d60 65 61 74 65 20 61 20 64 61 74 61 62 61 73 65 20 eate a database
18d70 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 66 69 for which the fi
18d80 6e 61 6c 20 70 61 67 65 0a 20 20 20 20 20 20 2a nal page. *
18d90 2a 20 69 73 20 65 69 74 68 65 72 20 61 20 70 6f * is either a po
18da0 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 20 6f inter-map page o
18db0 72 20 74 68 65 20 70 65 6e 64 69 6e 67 2d 62 79 r the pending-by
18dc0 74 65 20 70 61 67 65 2e 20 49 66 20 6f 6e 65 0a te page. If one.
18dd0 20 20 20 20 20 20 2a 2a 20 69 73 20 65 6e 63 6f ** is enco
18de0 75 6e 74 65 72 65 64 2c 20 74 68 69 73 20 69 6e untered, this in
18df0 64 69 63 61 74 65 73 20 63 6f 72 72 75 70 74 69 dicates corrupti
18e00 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 on.. */.
18e10 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
18e20 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 _CORRUPT_BKPT;.
18e30 20 20 20 7d 0a 0a 20 20 20 20 6e 46 72 65 65 20 }.. nFree
18e40 3d 20 67 65 74 34 62 79 74 65 28 26 70 42 74 2d = get4byte(&pBt-
18e50 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 >pPage1->aData[3
18e60 36 5d 29 3b 0a 20 20 20 20 6e 45 6e 74 72 79 20 6]);. nEntry
18e70 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
18e80 65 2f 35 3b 0a 20 20 20 20 6e 50 74 72 6d 61 70 e/5;. nPtrmap
18e90 20 3d 20 28 6e 46 72 65 65 2d 6e 4f 72 69 67 2b = (nFree-nOrig+
18ea0 50 54 52 4d 41 50 5f 50 41 47 45 4e 4f 28 70 42 PTRMAP_PAGENO(pB
18eb0 74 2c 20 6e 4f 72 69 67 29 2b 6e 45 6e 74 72 79 t, nOrig)+nEntry
18ec0 29 2f 6e 45 6e 74 72 79 3b 0a 20 20 20 20 6e 46 )/nEntry;. nF
18ed0 69 6e 20 3d 20 6e 4f 72 69 67 20 2d 20 6e 46 72 in = nOrig - nFr
18ee0 65 65 20 2d 20 6e 50 74 72 6d 61 70 3b 0a 20 20 ee - nPtrmap;.
18ef0 20 20 69 66 28 20 6e 4f 72 69 67 3e 50 45 4e 44 if( nOrig>PEND
18f00 49 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 ING_BYTE_PAGE(pB
18f10 74 29 20 26 26 20 6e 46 69 6e 3c 50 45 4e 44 49 t) && nFin<PENDI
18f20 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
18f30 29 20 29 7b 0a 20 20 20 20 20 20 6e 46 69 6e 2d ) ){. nFin-
18f40 2d 3b 0a 20 20 20 20 7d 0a 20 20 20 20 77 68 69 -;. }. whi
18f50 6c 65 28 20 50 54 52 4d 41 50 5f 49 53 50 41 47 le( PTRMAP_ISPAG
18f60 45 28 70 42 74 2c 20 6e 46 69 6e 29 20 7c 7c 20 E(pBt, nFin) ||
18f70 6e 46 69 6e 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 nFin==PENDING_BY
18f80 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a TE_PAGE(pBt) ){.
18f90 20 20 20 20 20 20 6e 46 69 6e 2d 2d 3b 0a 20 20 nFin--;.
18fa0 20 20 7d 0a 20 20 20 20 69 66 28 20 6e 46 69 6e }. if( nFin
18fb0 3e 6e 4f 72 69 67 20 29 20 72 65 74 75 72 6e 20 >nOrig ) return
18fc0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
18fd0 4b 50 54 3b 0a 0a 20 20 20 20 66 6f 72 28 69 46 KPT;.. for(iF
18fe0 72 65 65 3d 6e 4f 72 69 67 3b 20 69 46 72 65 65 ree=nOrig; iFree
18ff0 3e 6e 46 69 6e 20 26 26 20 72 63 3d 3d 53 51 4c >nFin && rc==SQL
19000 49 54 45 5f 4f 4b 3b 20 69 46 72 65 65 2d 2d 29 ITE_OK; iFree--)
19010 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 69 6e 63 {. rc = inc
19020 72 56 61 63 75 75 6d 53 74 65 70 28 70 42 74 2c rVacuumStep(pBt,
19030 20 6e 46 69 6e 2c 20 69 46 72 65 65 29 3b 0a 20 nFin, iFree);.
19040 20 20 20 7d 0a 20 20 20 20 69 66 28 20 28 72 63 }. if( (rc
19050 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 7c 7c ==SQLITE_DONE ||
19060 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 rc==SQLITE_OK)
19070 26 26 20 6e 46 72 65 65 3e 30 20 29 7b 0a 20 20 && nFree>0 ){.
19080 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
19090 50 61 67 65 72 57 72 69 74 65 28 70 42 74 2d 3e PagerWrite(pBt->
190a0 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 29 pPage1->pDbPage)
190b0 3b 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 65 ;. put4byte
190c0 28 26 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 (&pBt->pPage1->a
190d0 44 61 74 61 5b 33 32 5d 2c 20 30 29 3b 0a 20 20 Data[32], 0);.
190e0 20 20 20 20 70 75 74 34 62 79 74 65 28 26 70 42 put4byte(&pB
190f0 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 t->pPage1->aData
19100 5b 33 36 5d 2c 20 30 29 3b 0a 20 20 20 20 20 20 [36], 0);.
19110 70 75 74 34 62 79 74 65 28 26 70 42 74 2d 3e 70 put4byte(&pBt->p
19120 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 32 38 5d Page1->aData[28]
19130 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 20 20 20 73 , nFin);. s
19140 71 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 qlite3PagerTrunc
19150 61 74 65 49 6d 61 67 65 28 70 42 74 2d 3e 70 50 ateImage(pBt->pP
19160 61 67 65 72 2c 20 6e 46 69 6e 29 3b 0a 20 20 20 ager, nFin);.
19170 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 pBt->nPage =
19180 6e 46 69 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 nFin;. }.
19190 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
191a0 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 K ){. sqlit
191b0 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 e3PagerRollback(
191c0 70 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 pPager);. }.
191d0 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 6e 52 }.. assert( nR
191e0 65 66 3d 3d 73 71 6c 69 74 65 33 50 61 67 65 72 ef==sqlite3Pager
191f0 52 65 66 63 6f 75 6e 74 28 70 50 61 67 65 72 29 Refcount(pPager)
19200 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );. return rc;
19210 0a 7d 0a 0a 23 65 6c 73 65 20 2f 2a 20 69 66 6e .}..#else /* ifn
19220 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
19230 41 55 54 4f 56 41 43 55 55 4d 20 2a 2f 0a 23 20 AUTOVACUUM */.#
19240 64 65 66 69 6e 65 20 73 65 74 43 68 69 6c 64 50 define setChildP
19250 74 72 6d 61 70 73 28 78 29 20 53 51 4c 49 54 45 trmaps(x) SQLITE
19260 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a _OK.#endif../*.*
19270 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 64 * This routine d
19280 6f 65 73 20 74 68 65 20 66 69 72 73 74 20 70 68 oes the first ph
19290 61 73 65 20 6f 66 20 61 20 74 77 6f 2d 70 68 61 ase of a two-pha
192a0 73 65 20 63 6f 6d 6d 69 74 2e 20 20 54 68 69 73 se commit. This
192b0 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 63 61 75 73 routine.** caus
192c0 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f es a rollback jo
192d0 75 72 6e 61 6c 20 74 6f 20 62 65 20 63 72 65 61 urnal to be crea
192e0 74 65 64 20 28 69 66 20 69 74 20 64 6f 65 73 20 ted (if it does
192f0 6e 6f 74 20 61 6c 72 65 61 64 79 20 65 78 69 73 not already exis
19300 74 29 0a 2a 2a 20 61 6e 64 20 70 6f 70 75 6c 61 t).** and popula
19310 74 65 64 20 77 69 74 68 20 65 6e 6f 75 67 68 20 ted with enough
19320 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 73 6f 20 74 information so t
19330 68 61 74 20 69 66 20 61 20 70 6f 77 65 72 20 6c hat if a power l
19340 6f 73 73 20 6f 63 63 75 72 73 0a 2a 2a 20 74 68 oss occurs.** th
19350 65 20 64 61 74 61 62 61 73 65 20 63 61 6e 20 62 e database can b
19360 65 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74 e restored to it
19370 73 20 6f 72 69 67 69 6e 61 6c 20 73 74 61 74 65 s original state
19380 20 62 79 20 70 6c 61 79 69 6e 67 20 62 61 63 6b by playing back
19390 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e .** the journal.
193a0 20 20 54 68 65 6e 20 74 68 65 20 63 6f 6e 74 65 Then the conte
193b0 6e 74 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e nts of the journ
193c0 61 6c 20 61 72 65 20 66 6c 75 73 68 65 64 20 6f al are flushed o
193d0 75 74 20 74 6f 0a 2a 2a 20 74 68 65 20 64 69 73 ut to.** the dis
193e0 6b 2e 20 20 41 66 74 65 72 20 74 68 65 20 6a 6f k. After the jo
193f0 75 72 6e 61 6c 20 69 73 20 73 61 66 65 6c 79 20 urnal is safely
19400 6f 6e 20 6f 78 69 64 65 2c 20 74 68 65 20 63 68 on oxide, the ch
19410 61 6e 67 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 anges to the.**
19420 64 61 74 61 62 61 73 65 20 61 72 65 20 77 72 69 database are wri
19430 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 64 61 tten into the da
19440 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 tabase file and
19450 66 6c 75 73 68 65 64 20 74 6f 20 6f 78 69 64 65 flushed to oxide
19460 2e 0a 2a 2a 20 41 74 20 74 68 65 20 65 6e 64 20 ..** At the end
19470 6f 66 20 74 68 69 73 20 63 61 6c 6c 2c 20 74 68 of this call, th
19480 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
19490 61 6c 20 73 74 69 6c 6c 20 65 78 69 73 74 73 20 al still exists
194a0 6f 6e 20 74 68 65 0a 2a 2a 20 64 69 73 6b 20 61 on the.** disk a
194b0 6e 64 20 77 65 20 61 72 65 20 73 74 69 6c 6c 20 nd we are still
194c0 68 6f 6c 64 69 6e 67 20 61 6c 6c 20 6c 6f 63 6b holding all lock
194d0 73 2c 20 73 6f 20 74 68 65 20 74 72 61 6e 73 61 s, so the transa
194e0 63 74 69 6f 6e 20 68 61 73 20 6e 6f 74 0a 2a 2a ction has not.**
194f0 20 63 6f 6d 6d 69 74 74 65 64 2e 20 20 53 65 65 committed. See
19500 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d sqlite3BtreeCom
19510 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 66 6f mitPhaseTwo() fo
19520 72 20 74 68 65 20 73 65 63 6f 6e 64 20 70 68 61 r the second pha
19530 73 65 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 6d se of the.** com
19540 6d 69 74 20 70 72 6f 63 65 73 73 2e 0a 2a 2a 0a mit process..**.
19550 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 69 73 20 ** This call is
19560 61 20 6e 6f 2d 6f 70 20 69 66 20 6e 6f 20 77 72 a no-op if no wr
19570 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
19580 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 is currently act
19590 69 76 65 20 6f 6e 20 70 42 74 2e 0a 2a 2a 0a 2a ive on pBt..**.*
195a0 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 73 79 6e * Otherwise, syn
195b0 63 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 c the database f
195c0 69 6c 65 20 66 6f 72 20 74 68 65 20 62 74 72 65 ile for the btre
195d0 65 20 70 42 74 2e 20 7a 4d 61 73 74 65 72 20 70 e pBt. zMaster p
195e0 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68 65 20 oints to.** the
195f0 6e 61 6d 65 20 6f 66 20 61 20 6d 61 73 74 65 72 name of a master
19600 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 journal file th
19610 61 74 20 73 68 6f 75 6c 64 20 62 65 20 77 72 69 at should be wri
19620 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 0a 2a 2a tten into the.**
19630 20 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 individual jour
19640 6e 61 6c 20 66 69 6c 65 2c 20 6f 72 20 69 73 20 nal file, or is
19650 4e 55 4c 4c 2c 20 69 6e 64 69 63 61 74 69 6e 67 NULL, indicating
19660 20 6e 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e no master journ
19670 61 6c 20 66 69 6c 65 20 0a 2a 2a 20 28 73 69 6e al file .** (sin
19680 67 6c 65 20 64 61 74 61 62 61 73 65 20 74 72 61 gle database tra
19690 6e 73 61 63 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a nsaction)..**.**
196a0 20 57 68 65 6e 20 74 68 69 73 20 69 73 20 63 61 When this is ca
196b0 6c 6c 65 64 2c 20 74 68 65 20 6d 61 73 74 65 72 lled, the master
196c0 20 6a 6f 75 72 6e 61 6c 20 73 68 6f 75 6c 64 20 journal should
196d0 61 6c 72 65 61 64 79 20 68 61 76 65 20 62 65 65 already have bee
196e0 6e 0a 2a 2a 20 63 72 65 61 74 65 64 2c 20 70 6f n.** created, po
196f0 70 75 6c 61 74 65 64 20 77 69 74 68 20 74 68 69 pulated with thi
19700 73 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 s journal pointe
19710 72 20 61 6e 64 20 73 79 6e 63 65 64 20 74 6f 20 r and synced to
19720 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 disk..**.** Once
19730 20 74 68 69 73 20 69 73 20 72 6f 75 74 69 6e 65 this is routine
19740 20 68 61 73 20 72 65 74 75 72 6e 65 64 2c 20 74 has returned, t
19750 68 65 20 6f 6e 6c 79 20 74 68 69 6e 67 20 72 65 he only thing re
19760 71 75 69 72 65 64 20 74 6f 20 63 6f 6d 6d 69 74 quired to commit
19770 0a 2a 2a 20 74 68 65 20 77 72 69 74 65 2d 74 72 .** the write-tr
19780 61 6e 73 61 63 74 69 6f 6e 20 66 6f 72 20 74 68 ansaction for th
19790 69 73 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 is database file
197a0 20 69 73 20 74 6f 20 64 65 6c 65 74 65 20 74 68 is to delete th
197b0 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e e journal..*/.in
197c0 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f t sqlite3BtreeCo
197d0 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 42 74 72 mmitPhaseOne(Btr
197e0 65 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 ee *p, const cha
197f0 72 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 69 r *zMaster){. i
19800 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
19810 4b 3b 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 K;. if( p->inTr
19820 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 ans==TRANS_WRITE
19830 20 29 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 ){. BtShared
19840 20 2a 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a *pBt = p->pBt;.
19850 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 sqlite3Btree
19860 45 6e 74 65 72 28 70 29 3b 0a 23 69 66 6e 64 65 Enter(p);.#ifnde
19870 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
19880 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
19890 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d pBt->autoVacuum
198a0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 ){. rc = a
198b0 75 74 6f 56 61 63 75 75 6d 43 6f 6d 6d 69 74 28 utoVacuumCommit(
198c0 70 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 pBt);. if(
198d0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
198e0 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
198f0 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
19900 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 return rc
19910 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
19920 23 65 6e 64 69 66 0a 20 20 20 20 72 63 20 3d 20 #endif. rc =
19930 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d sqlite3PagerComm
19940 69 74 50 68 61 73 65 4f 6e 65 28 70 42 74 2d 3e itPhaseOne(pBt->
19950 70 50 61 67 65 72 2c 20 7a 4d 61 73 74 65 72 2c pPager, zMaster,
19960 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 0);. sqlite3
19970 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
19980 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
19990 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
199a0 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
199b0 20 66 72 6f 6d 20 62 6f 74 68 20 42 74 72 65 65 from both Btree
199c0 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 29 CommitPhaseTwo()
199d0 20 61 6e 64 20 42 74 72 65 65 52 6f 6c 6c 62 61 and BtreeRollba
199e0 63 6b 28 29 0a 2a 2a 20 61 74 20 74 68 65 20 63 ck().** at the c
199f0 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 61 20 74 onclusion of a t
19a00 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 ransaction..*/.s
19a10 74 61 74 69 63 20 76 6f 69 64 20 62 74 72 65 65 tatic void btree
19a20 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 42 EndTransaction(B
19a30 74 72 65 65 20 2a 70 29 7b 0a 20 20 42 74 53 68 tree *p){. BtSh
19a40 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
19a50 42 74 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 Bt;. assert( sq
19a60 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d lite3BtreeHoldsM
19a70 75 74 65 78 28 70 29 20 29 3b 0a 0a 20 20 62 74 utex(p) );.. bt
19a80 72 65 65 43 6c 65 61 72 48 61 73 43 6f 6e 74 65 reeClearHasConte
19a90 6e 74 28 70 42 74 29 3b 0a 20 20 69 66 28 20 70 nt(pBt);. if( p
19aa0 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 4e 53 5f ->inTrans>TRANS_
19ab0 4e 4f 4e 45 20 26 26 20 70 2d 3e 64 62 2d 3e 61 NONE && p->db->a
19ac0 63 74 69 76 65 56 64 62 65 43 6e 74 3e 31 20 29 ctiveVdbeCnt>1 )
19ad0 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 {. /* If ther
19ae0 65 20 61 72 65 20 6f 74 68 65 72 20 61 63 74 69 e are other acti
19af0 76 65 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 ve statements th
19b00 61 74 20 62 65 6c 6f 6e 67 20 74 6f 20 74 68 69 at belong to thi
19b10 73 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 2a s database. *
19b20 2a 20 68 61 6e 64 6c 65 2c 20 64 6f 77 6e 67 72 * handle, downgr
19b30 61 64 65 20 74 6f 20 61 20 72 65 61 64 2d 6f 6e ade to a read-on
19b40 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 ly transaction.
19b50 54 68 65 20 6f 74 68 65 72 20 73 74 61 74 65 6d The other statem
19b60 65 6e 74 73 0a 20 20 20 20 2a 2a 20 6d 61 79 20 ents. ** may
19b70 73 74 69 6c 6c 20 62 65 20 72 65 61 64 69 6e 67 still be reading
19b80 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 from the databa
19b90 73 65 2e 20 20 2a 2f 0a 20 20 20 20 64 6f 77 6e se. */. down
19ba0 67 72 61 64 65 41 6c 6c 53 68 61 72 65 64 43 61 gradeAllSharedCa
19bb0 63 68 65 54 61 62 6c 65 4c 6f 63 6b 73 28 70 29 cheTableLocks(p)
19bc0 3b 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 ;. p->inTrans
19bd0 20 3d 20 54 52 41 4e 53 5f 52 45 41 44 3b 0a 20 = TRANS_READ;.
19be0 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 49 }else{. /* I
19bf0 66 20 74 68 65 20 68 61 6e 64 6c 65 20 68 61 64 f the handle had
19c00 20 61 6e 79 20 6b 69 6e 64 20 6f 66 20 74 72 61 any kind of tra
19c10 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 2c 20 64 nsaction open, d
19c20 65 63 72 65 6d 65 6e 74 20 74 68 65 20 0a 20 20 ecrement the .
19c30 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e ** transaction
19c40 20 63 6f 75 6e 74 20 6f 66 20 74 68 65 20 73 68 count of the sh
19c50 61 72 65 64 20 62 74 72 65 65 2e 20 49 66 20 74 ared btree. If t
19c60 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 he transaction c
19c70 6f 75 6e 74 20 0a 20 20 20 20 2a 2a 20 72 65 61 ount . ** rea
19c80 63 68 65 73 20 30 2c 20 73 65 74 20 74 68 65 20 ches 0, set the
19c90 73 68 61 72 65 64 20 73 74 61 74 65 20 74 6f 20 shared state to
19ca0 54 52 41 4e 53 5f 4e 4f 4e 45 2e 20 54 68 65 20 TRANS_NONE. The
19cb0 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 unlockBtreeIfUnu
19cc0 73 65 64 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c sed(). ** cal
19cd0 6c 20 62 65 6c 6f 77 20 77 69 6c 6c 20 75 6e 6c l below will unl
19ce0 6f 63 6b 20 74 68 65 20 70 61 67 65 72 2e 20 20 ock the pager.
19cf0 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 69 6e */. if( p->in
19d00 54 72 61 6e 73 21 3d 54 52 41 4e 53 5f 4e 4f 4e Trans!=TRANS_NON
19d10 45 20 29 7b 0a 20 20 20 20 20 20 63 6c 65 61 72 E ){. clear
19d20 41 6c 6c 53 68 61 72 65 64 43 61 63 68 65 54 61 AllSharedCacheTa
19d30 62 6c 65 4c 6f 63 6b 73 28 70 29 3b 0a 20 20 20 bleLocks(p);.
19d40 20 20 20 70 42 74 2d 3e 6e 54 72 61 6e 73 61 63 pBt->nTransac
19d50 74 69 6f 6e 2d 2d 3b 0a 20 20 20 20 20 20 69 66 tion--;. if
19d60 28 20 30 3d 3d 70 42 74 2d 3e 6e 54 72 61 6e 73 ( 0==pBt->nTrans
19d70 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 action ){.
19d80 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 pBt->inTransac
19d90 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e tion = TRANS_NON
19da0 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d E;. }. }
19db0 0a 0a 20 20 20 20 2f 2a 20 53 65 74 20 74 68 65 .. /* Set the
19dc0 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 current transac
19dd0 74 69 6f 6e 20 73 74 61 74 65 20 74 6f 20 54 52 tion state to TR
19de0 41 4e 53 5f 4e 4f 4e 45 20 61 6e 64 20 75 6e 6c ANS_NONE and unl
19df0 6f 63 6b 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 ock the . **
19e00 70 61 67 65 72 20 69 66 20 74 68 69 73 20 63 61 pager if this ca
19e10 6c 6c 20 63 6c 6f 73 65 64 20 74 68 65 20 6f 6e ll closed the on
19e20 6c 79 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 ly read or write
19e30 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 2a transaction. *
19e40 2f 0a 20 20 20 20 70 2d 3e 69 6e 54 72 61 6e 73 /. p->inTrans
19e50 20 3d 20 54 52 41 4e 53 5f 4e 4f 4e 45 3b 0a 20 = TRANS_NONE;.
19e60 20 20 20 75 6e 6c 6f 63 6b 42 74 72 65 65 49 66 unlockBtreeIf
19e70 55 6e 75 73 65 64 28 70 42 74 29 3b 0a 20 20 7d Unused(pBt);. }
19e80 0a 0a 20 20 62 74 72 65 65 49 6e 74 65 67 72 69 .. btreeIntegri
19e90 74 79 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 ty(p);.}../*.**
19ea0 43 6f 6d 6d 69 74 20 74 68 65 20 74 72 61 6e 73 Commit the trans
19eb0 61 63 74 69 6f 6e 20 63 75 72 72 65 6e 74 6c 79 action currently
19ec0 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 0a 2a 2a in progress..**
19ed0 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 .** This routine
19ee0 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 implements the
19ef0 73 65 63 6f 6e 64 20 70 68 61 73 65 20 6f 66 20 second phase of
19f00 61 20 32 2d 70 68 61 73 65 20 63 6f 6d 6d 69 74 a 2-phase commit
19f10 2e 20 20 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 . The.** sqlite
19f20 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 3BtreeCommitPhas
19f30 65 4f 6e 65 28 29 20 72 6f 75 74 69 6e 65 20 64 eOne() routine d
19f40 6f 65 73 20 74 68 65 20 66 69 72 73 74 20 70 68 oes the first ph
19f50 61 73 65 20 61 6e 64 20 73 68 6f 75 6c 64 0a 2a ase and should.*
19f60 2a 20 62 65 20 69 6e 76 6f 6b 65 64 20 70 72 69 * be invoked pri
19f70 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 20 74 68 or to calling th
19f80 69 73 20 72 6f 75 74 69 6e 65 2e 20 20 54 68 65 is routine. The
19f90 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d sqlite3BtreeCom
19fa0 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 0a 2a 2a mitPhaseOne().**
19fb0 20 72 6f 75 74 69 6e 65 20 64 69 64 20 61 6c 6c routine did all
19fc0 20 74 68 65 20 77 6f 72 6b 20 6f 66 20 77 72 69 the work of wri
19fd0 74 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ting information
19fe0 20 6f 75 74 20 74 6f 20 64 69 73 6b 20 61 6e 64 out to disk and
19ff0 20 66 6c 75 73 68 69 6e 67 20 74 68 65 0a 2a 2a flushing the.**
1a000 20 63 6f 6e 74 65 6e 74 73 20 73 6f 20 74 68 61 contents so tha
1a010 74 20 74 68 65 79 20 61 72 65 20 77 72 69 74 74 t they are writt
1a020 65 6e 20 6f 6e 74 6f 20 74 68 65 20 64 69 73 6b en onto the disk
1a030 20 70 6c 61 74 74 65 72 2e 20 20 41 6c 6c 20 74 platter. All t
1a040 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 68 his.** routine h
1a050 61 73 20 74 6f 20 64 6f 20 69 73 20 64 65 6c 65 as to do is dele
1a060 74 65 20 6f 72 20 74 72 75 6e 63 61 74 65 20 6f te or truncate o
1a070 72 20 7a 65 72 6f 20 74 68 65 20 68 65 61 64 65 r zero the heade
1a080 72 20 69 6e 20 74 68 65 0a 2a 2a 20 74 68 65 20 r in the.** the
1a090 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
1a0a0 20 28 77 68 69 63 68 20 63 61 75 73 65 73 20 74 (which causes t
1a0b0 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 he transaction t
1a0c0 6f 20 63 6f 6d 6d 69 74 29 20 61 6e 64 0a 2a 2a o commit) and.**
1a0d0 20 64 72 6f 70 20 6c 6f 63 6b 73 2e 0a 2a 2a 0a drop locks..**.
1a0e0 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 66 20 ** Normally, if
1a0f0 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 an error occurs
1a100 77 68 69 6c 65 20 74 68 65 20 70 61 67 65 72 20 while the pager
1a110 6c 61 79 65 72 20 69 73 20 61 74 74 65 6d 70 74 layer is attempt
1a120 69 6e 67 20 74 6f 20 0a 2a 2a 20 66 69 6e 61 6c ing to .** final
1a130 69 7a 65 20 74 68 65 20 75 6e 64 65 72 6c 79 69 ize the underlyi
1a140 6e 67 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c ng journal file,
1a150 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
1a160 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 eturns an error
1a170 61 6e 64 0a 2a 2a 20 74 68 65 20 75 70 70 65 72 and.** the upper
1a180 20 6c 61 79 65 72 20 77 69 6c 6c 20 61 74 74 65 layer will atte
1a190 6d 70 74 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 mpt a rollback.
1a1a0 48 6f 77 65 76 65 72 2c 20 69 66 20 74 68 65 20 However, if the
1a1b0 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 0a second argument.
1a1c0 2a 2a 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 20 74 ** is non-zero t
1a1d0 68 65 6e 20 74 68 69 73 20 62 2d 74 72 65 65 20 hen this b-tree
1a1e0 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 70 transaction is p
1a1f0 61 72 74 20 6f 66 20 61 20 6d 75 6c 74 69 2d 66 art of a multi-f
1a200 69 6c 65 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 ile .** transact
1a210 69 6f 6e 2e 20 49 6e 20 74 68 69 73 20 63 61 73 ion. In this cas
1a220 65 2c 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 e, the transacti
1a230 6f 6e 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 on has already b
1a240 65 65 6e 20 63 6f 6d 6d 69 74 74 65 64 20 0a 2a een committed .*
1a250 2a 20 28 62 79 20 64 65 6c 65 74 69 6e 67 20 61 * (by deleting a
1a260 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
1a270 66 69 6c 65 29 20 61 6e 64 20 74 68 65 20 63 61 file) and the ca
1a280 6c 6c 65 72 20 77 69 6c 6c 20 69 67 6e 6f 72 65 ller will ignore
1a290 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 74 69 this .** functi
1a2a0 6f 6e 73 20 72 65 74 75 72 6e 20 63 6f 64 65 2e ons return code.
1a2b0 20 53 6f 2c 20 65 76 65 6e 20 69 66 20 61 6e 20 So, even if an
1a2c0 65 72 72 6f 72 20 6f 63 63 75 72 73 20 69 6e 20 error occurs in
1a2d0 74 68 65 20 70 61 67 65 72 20 6c 61 79 65 72 2c the pager layer,
1a2e0 0a 2a 2a 20 72 65 73 65 74 20 74 68 65 20 62 2d .** reset the b-
1a2f0 74 72 65 65 20 6f 62 6a 65 63 74 73 20 69 6e 74 tree objects int
1a300 65 72 6e 61 6c 20 73 74 61 74 65 20 74 6f 20 69 ernal state to i
1a310 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 68 65 ndicate that the
1a320 20 77 72 69 74 65 0a 2a 2a 20 74 72 61 6e 73 61 write.** transa
1a330 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 20 63 ction has been c
1a340 6c 6f 73 65 64 2e 20 54 68 69 73 20 69 73 20 71 losed. This is q
1a350 75 69 74 65 20 73 61 66 65 2c 20 61 73 20 74 68 uite safe, as th
1a360 65 20 70 61 67 65 72 20 77 69 6c 6c 20 68 61 76 e pager will hav
1a370 65 0a 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 65 e.** transitione
1a380 64 20 74 6f 20 74 68 65 20 65 72 72 6f 72 20 73 d to the error s
1a390 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 tate..**.** This
1a3a0 20 77 69 6c 6c 20 72 65 6c 65 61 73 65 20 74 68 will release th
1a3b0 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 e write lock on
1a3c0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
1a3d0 65 2e 20 20 49 66 20 74 68 65 72 65 0a 2a 2a 20 e. If there.**
1a3e0 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 63 75 are no active cu
1a3f0 72 73 6f 72 73 2c 20 69 74 20 61 6c 73 6f 20 72 rsors, it also r
1a400 65 6c 65 61 73 65 73 20 74 68 65 20 72 65 61 64 eleases the read
1a410 20 6c 6f 63 6b 2e 0a 2a 2f 0a 69 6e 74 20 73 71 lock..*/.int sq
1a420 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 lite3BtreeCommit
1a430 50 68 61 73 65 54 77 6f 28 42 74 72 65 65 20 2a PhaseTwo(Btree *
1a440 70 2c 20 69 6e 74 20 62 43 6c 65 61 6e 75 70 29 p, int bCleanup)
1a450 7b 0a 0a 20 20 69 66 28 20 70 2d 3e 69 6e 54 72 {.. if( p->inTr
1a460 61 6e 73 3d 3d 54 52 41 4e 53 5f 4e 4f 4e 45 20 ans==TRANS_NONE
1a470 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f ) return SQLITE_
1a480 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 OK;. sqlite3Btr
1a490 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 62 74 eeEnter(p);. bt
1a4a0 72 65 65 49 6e 74 65 67 72 69 74 79 28 70 29 3b reeIntegrity(p);
1a4b0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 68 61 .. /* If the ha
1a4c0 6e 64 6c 65 20 68 61 73 20 61 20 77 72 69 74 65 ndle has a write
1a4d0 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 -transaction ope
1a4e0 6e 2c 20 63 6f 6d 6d 69 74 20 74 68 65 20 73 68 n, commit the sh
1a4f0 61 72 65 64 2d 62 74 72 65 65 73 20 0a 20 20 2a ared-btrees . *
1a500 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 6e * transaction an
1a510 64 20 73 65 74 20 74 68 65 20 73 68 61 72 65 64 d set the shared
1a520 20 73 74 61 74 65 20 74 6f 20 54 52 41 4e 53 5f state to TRANS_
1a530 52 45 41 44 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 READ.. */. if(
1a540 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 41 p->inTrans==TRA
1a550 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 20 20 NS_WRITE ){.
1a560 69 6e 74 20 72 63 3b 0a 20 20 20 20 42 74 53 68 int rc;. BtSh
1a570 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d 3e 70 ared *pBt = p->p
1a580 42 74 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 Bt;. assert(
1a590 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 63 74 69 pBt->inTransacti
1a5a0 6f 6e 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 on==TRANS_WRITE
1a5b0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
1a5c0 42 74 2d 3e 6e 54 72 61 6e 73 61 63 74 69 6f 6e Bt->nTransaction
1a5d0 3e 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 >0 );. rc = s
1a5e0 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 qlite3PagerCommi
1a5f0 74 50 68 61 73 65 54 77 6f 28 70 42 74 2d 3e 70 tPhaseTwo(pBt->p
1a600 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 Pager);. if(
1a610 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc!=SQLITE_OK &&
1a620 20 62 43 6c 65 61 6e 75 70 3d 3d 30 20 29 7b 0a bCleanup==0 ){.
1a630 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 sqlite3Btr
1a640 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 20 20 eeLeave(p);.
1a650 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
1a660 20 7d 0a 20 20 20 20 70 42 74 2d 3e 69 6e 54 72 }. pBt->inTr
1a670 61 6e 73 61 63 74 69 6f 6e 20 3d 20 54 52 41 4e ansaction = TRAN
1a680 53 5f 52 45 41 44 3b 0a 20 20 7d 0a 0a 20 20 62 S_READ;. }.. b
1a690 74 72 65 65 45 6e 64 54 72 61 6e 73 61 63 74 69 treeEndTransacti
1a6a0 6f 6e 28 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 on(p);. sqlite3
1a6b0 42 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 BtreeLeave(p);.
1a6c0 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
1a6d0 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 6f 20 62 K;.}../*.** Do b
1a6e0 6f 74 68 20 70 68 61 73 65 73 20 6f 66 20 61 20 oth phases of a
1a6f0 63 6f 6d 6d 69 74 2e 0a 2a 2f 0a 69 6e 74 20 73 commit..*/.int s
1a700 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 qlite3BtreeCommi
1a710 74 28 42 74 72 65 65 20 2a 70 29 7b 0a 20 20 69 t(Btree *p){. i
1a720 6e 74 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 nt rc;. sqlite3
1a730 42 74 72 65 65 45 6e 74 65 72 28 70 29 3b 0a 20 BtreeEnter(p);.
1a740 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 rc = sqlite3Btr
1a750 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 eeCommitPhaseOne
1a760 28 70 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 (p, 0);. if( rc
1a770 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
1a780 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 rc = sqlite3B
1a790 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 treeCommitPhaseT
1a7a0 77 6f 28 70 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 wo(p, 0);. }.
1a7b0 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 sqlite3BtreeLeav
1a7c0 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 e(p);. return r
1a7d0 63 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 c;.}..#ifndef ND
1a7e0 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 EBUG./*.** Retur
1a7f0 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 n the number of
1a800 77 72 69 74 65 2d 63 75 72 73 6f 72 73 20 6f 70 write-cursors op
1a810 65 6e 20 6f 6e 20 74 68 69 73 20 68 61 6e 64 6c en on this handl
1a820 65 2e 20 54 68 69 73 20 69 73 20 66 6f 72 20 75 e. This is for u
1a830 73 65 0a 2a 2a 20 69 6e 20 61 73 73 65 72 74 28 se.** in assert(
1a840 29 20 65 78 70 72 65 73 73 69 6f 6e 73 2c 20 73 ) expressions, s
1a850 6f 20 69 74 20 69 73 20 6f 6e 6c 79 20 63 6f 6d o it is only com
1a860 70 69 6c 65 64 20 69 66 20 4e 44 45 42 55 47 20 piled if NDEBUG
1a870 69 73 20 6e 6f 74 0a 2a 2a 20 64 65 66 69 6e 65 is not.** define
1a880 64 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 d..**.** For the
1a890 20 70 75 72 70 6f 73 65 73 20 6f 66 20 74 68 69 purposes of thi
1a8a0 73 20 72 6f 75 74 69 6e 65 2c 20 61 20 77 72 69 s routine, a wri
1a8b0 74 65 2d 63 75 72 73 6f 72 20 69 73 20 61 6e 79 te-cursor is any
1a8c0 20 63 75 72 73 6f 72 20 74 68 61 74 0a 2a 2a 20 cursor that.**
1a8d0 69 73 20 63 61 70 61 62 6c 65 20 6f 66 20 77 72 is capable of wr
1a8e0 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 iting to the dat
1a8f0 61 62 73 65 2e 20 20 54 68 61 74 20 6d 65 61 6e abse. That mean
1a900 73 20 74 68 65 20 63 75 72 73 6f 72 20 77 61 73 s the cursor was
1a910 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c 6c 79 20 6f .** originally o
1a920 70 65 6e 65 64 20 66 6f 72 20 77 72 69 74 69 6e pened for writin
1a930 67 20 61 6e 64 20 74 68 65 20 63 75 72 73 6f 72 g and the cursor
1a940 20 68 61 73 20 6e 6f 74 20 62 65 20 64 69 73 61 has not be disa
1a950 62 6c 65 64 0a 2a 2a 20 62 79 20 68 61 76 69 6e bled.** by havin
1a960 67 20 69 74 73 20 73 74 61 74 65 20 63 68 61 6e g its state chan
1a970 67 65 64 20 74 6f 20 43 55 52 53 4f 52 5f 46 41 ged to CURSOR_FA
1a980 55 4c 54 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ULT..*/.static i
1a990 6e 74 20 63 6f 75 6e 74 57 72 69 74 65 43 75 72 nt countWriteCur
1a9a0 73 6f 72 73 28 42 74 53 68 61 72 65 64 20 2a 70 sors(BtShared *p
1a9b0 42 74 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 Bt){. BtCursor
1a9c0 2a 70 43 75 72 3b 0a 20 20 69 6e 74 20 72 20 3d *pCur;. int r =
1a9d0 20 30 3b 0a 20 20 66 6f 72 28 70 43 75 72 3d 70 0;. for(pCur=p
1a9e0 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 43 75 Bt->pCursor; pCu
1a9f0 72 3b 20 70 43 75 72 3d 70 43 75 72 2d 3e 70 4e r; pCur=pCur->pN
1aa00 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 43 ext){. if( pC
1aa10 75 72 2d 3e 77 72 46 6c 61 67 20 26 26 20 70 43 ur->wrFlag && pC
1aa20 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
1aa30 4f 52 5f 46 41 55 4c 54 20 29 20 72 2b 2b 3b 20 OR_FAULT ) r++;
1aa40 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 3b . }. return r;
1aa50 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a .}.#endif../*.**
1aa60 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65 This routine se
1aa70 74 73 20 74 68 65 20 73 74 61 74 65 20 74 6f 20 ts the state to
1aa80 43 55 52 53 4f 52 5f 46 41 55 4c 54 20 61 6e 64 CURSOR_FAULT and
1aa90 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a 20 63 6f the error.** co
1aaa0 64 65 20 74 6f 20 65 72 72 43 6f 64 65 20 66 6f de to errCode fo
1aab0 72 20 65 76 65 72 79 20 63 75 72 73 6f 72 20 6f r every cursor o
1aac0 6e 20 42 74 53 68 61 72 65 64 20 74 68 61 74 20 n BtShared that
1aad0 70 42 74 72 65 65 0a 2a 2a 20 72 65 66 65 72 65 pBtree.** refere
1aae0 6e 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 45 76 65 72 nces..**.** Ever
1aaf0 79 20 63 75 72 73 6f 72 20 69 73 20 74 72 69 70 y cursor is trip
1ab00 70 65 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 63 ped, including c
1ab10 75 72 73 6f 72 73 20 74 68 61 74 20 62 65 6c 6f ursors that belo
1ab20 6e 67 0a 2a 2a 20 74 6f 20 6f 74 68 65 72 20 64 ng.** to other d
1ab30 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
1ab40 6f 6e 73 20 74 68 61 74 20 68 61 70 70 65 6e 20 ons that happen
1ab50 74 6f 20 62 65 20 73 68 61 72 69 6e 67 0a 2a 2a to be sharing.**
1ab60 20 74 68 65 20 63 61 63 68 65 20 77 69 74 68 20 the cache with
1ab70 70 42 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 pBtree..**.** Th
1ab80 69 73 20 72 6f 75 74 69 6e 65 20 67 65 74 73 20 is routine gets
1ab90 63 61 6c 6c 65 64 20 77 68 65 6e 20 61 20 72 6f called when a ro
1aba0 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 2e 0a 2a llback occurs..*
1abb0 2a 20 41 6c 6c 20 63 75 72 73 6f 72 73 20 75 73 * All cursors us
1abc0 69 6e 67 20 74 68 65 20 73 61 6d 65 20 63 61 63 ing the same cac
1abd0 68 65 20 6d 75 73 74 20 62 65 20 74 72 69 70 70 he must be tripp
1abe0 65 64 0a 2a 2a 20 74 6f 20 70 72 65 76 65 6e 74 ed.** to prevent
1abf0 20 74 68 65 6d 20 66 72 6f 6d 20 74 72 79 69 6e them from tryin
1ac00 67 20 74 6f 20 75 73 65 20 74 68 65 20 62 74 72 g to use the btr
1ac10 65 65 20 61 66 74 65 72 0a 2a 2a 20 74 68 65 20 ee after.** the
1ac20 72 6f 6c 6c 62 61 63 6b 2e 20 20 54 68 65 20 72 rollback. The r
1ac30 6f 6c 6c 62 61 63 6b 20 6d 61 79 20 68 61 76 65 ollback may have
1ac40 20 64 65 6c 65 74 65 64 20 74 61 62 6c 65 73 0a deleted tables.
1ac50 2a 2a 20 6f 72 20 6d 6f 76 65 64 20 72 6f 6f 74 ** or moved root
1ac60 20 70 61 67 65 73 2c 20 73 6f 20 69 74 20 69 73 pages, so it is
1ac70 20 6e 6f 74 20 73 75 66 66 69 63 69 65 6e 74 20 not sufficient
1ac80 74 6f 0a 2a 2a 20 73 61 76 65 20 74 68 65 20 73 to.** save the s
1ac90 74 61 74 65 20 6f 66 20 74 68 65 20 63 75 72 73 tate of the curs
1aca0 6f 72 2e 20 20 54 68 65 20 63 75 72 73 6f 72 20 or. The cursor
1acb0 6d 75 73 74 20 62 65 0a 2a 2a 20 69 6e 76 61 6c must be.** inval
1acc0 69 64 61 74 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 idated..*/.void
1acd0 73 71 6c 69 74 65 33 42 74 72 65 65 54 72 69 70 sqlite3BtreeTrip
1ace0 41 6c 6c 43 75 72 73 6f 72 73 28 42 74 72 65 65 AllCursors(Btree
1acf0 20 2a 70 42 74 72 65 65 2c 20 69 6e 74 20 65 72 *pBtree, int er
1ad00 72 43 6f 64 65 29 7b 0a 20 20 42 74 43 75 72 73 rCode){. BtCurs
1ad10 6f 72 20 2a 70 3b 0a 20 20 69 66 28 20 70 42 74 or *p;. if( pBt
1ad20 72 65 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b ree==0 ) return;
1ad30 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 . sqlite3BtreeE
1ad40 6e 74 65 72 28 70 42 74 72 65 65 29 3b 0a 20 20 nter(pBtree);.
1ad50 66 6f 72 28 70 3d 70 42 74 72 65 65 2d 3e 70 42 for(p=pBtree->pB
1ad60 74 2d 3e 70 43 75 72 73 6f 72 3b 20 70 3b 20 70 t->pCursor; p; p
1ad70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 =p->pNext){.
1ad80 69 6e 74 20 69 3b 0a 20 20 20 20 73 71 6c 69 74 int i;. sqlit
1ad90 65 33 42 74 72 65 65 43 6c 65 61 72 43 75 72 73 e3BtreeClearCurs
1ada0 6f 72 28 70 29 3b 0a 20 20 20 20 70 2d 3e 65 53 or(p);. p->eS
1adb0 74 61 74 65 20 3d 20 43 55 52 53 4f 52 5f 46 41 tate = CURSOR_FA
1adc0 55 4c 54 3b 0a 20 20 20 20 70 2d 3e 73 6b 69 70 ULT;. p->skip
1add0 4e 65 78 74 20 3d 20 65 72 72 43 6f 64 65 3b 0a Next = errCode;.
1ade0 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 3d for(i=0; i<=
1adf0 70 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 7b 0a p->iPage; i++){.
1ae00 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
1ae10 65 28 70 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b e(p->apPage[i]);
1ae20 0a 20 20 20 20 20 20 70 2d 3e 61 70 50 61 67 65 . p->apPage
1ae30 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 [i] = 0;. }.
1ae40 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 }. sqlite3Btre
1ae50 65 4c 65 61 76 65 28 70 42 74 72 65 65 29 3b 0a eLeave(pBtree);.
1ae60 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c 6c 62 61 63 }../*.** Rollbac
1ae70 6b 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f k the transactio
1ae80 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 2e 20 20 n in progress.
1ae90 41 6c 6c 20 63 75 72 73 6f 72 73 20 77 69 6c 6c All cursors will
1aea0 20 62 65 0a 2a 2a 20 69 6e 76 61 6c 69 64 65 64 be.** invalided
1aeb0 20 62 79 20 74 68 69 73 20 6f 70 65 72 61 74 69 by this operati
1aec0 6f 6e 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 on. Any attempt
1aed0 20 74 6f 20 75 73 65 20 61 20 63 75 72 73 6f 72 to use a cursor
1aee0 0a 2a 2a 20 74 68 61 74 20 77 61 73 20 6f 70 65 .** that was ope
1aef0 6e 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 n at the beginni
1af00 6e 67 20 6f 66 20 74 68 69 73 20 6f 70 65 72 61 ng of this opera
1af10 74 69 6f 6e 20 77 69 6c 6c 20 72 65 73 75 6c 74 tion will result
1af20 0a 2a 2a 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e .** in an error.
1af30 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 77 69 6c 6c .**.** This will
1af40 20 72 65 6c 65 61 73 65 20 74 68 65 20 77 72 69 release the wri
1af50 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 te lock on the d
1af60 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 49 atabase file. I
1af70 66 20 74 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e f there.** are n
1af80 6f 20 61 63 74 69 76 65 20 63 75 72 73 6f 72 73 o active cursors
1af90 2c 20 69 74 20 61 6c 73 6f 20 72 65 6c 65 61 73 , it also releas
1afa0 65 73 20 74 68 65 20 72 65 61 64 20 6c 6f 63 6b es the read lock
1afb0 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
1afc0 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 42 74 BtreeRollback(Bt
1afd0 72 65 65 20 2a 70 2c 20 69 6e 74 20 74 72 69 70 ree *p, int trip
1afe0 43 6f 64 65 29 7b 0a 20 20 69 6e 74 20 72 63 3b Code){. int rc;
1aff0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
1b000 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 4d 65 6d = p->pBt;. Mem
1b010 50 61 67 65 20 2a 70 50 61 67 65 31 3b 0a 0a 20 Page *pPage1;..
1b020 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1b030 65 72 28 70 29 3b 0a 20 20 69 66 28 20 74 72 69 er(p);. if( tri
1b040 70 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b pCode==SQLITE_OK
1b050 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 74 72 69 ){. rc = tri
1b060 70 43 6f 64 65 20 3d 20 73 61 76 65 41 6c 6c 43 pCode = saveAllC
1b070 75 72 73 6f 72 73 28 70 42 74 2c 20 30 2c 20 30 ursors(pBt, 0, 0
1b080 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
1b090 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
1b0a0 20 20 7d 0a 20 20 69 66 28 20 74 72 69 70 43 6f }. if( tripCo
1b0b0 64 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 de ){. sqlite
1b0c0 33 42 74 72 65 65 54 72 69 70 41 6c 6c 43 75 72 3BtreeTripAllCur
1b0d0 73 6f 72 73 28 70 2c 20 74 72 69 70 43 6f 64 65 sors(p, tripCode
1b0e0 29 3b 0a 20 20 7d 0a 20 20 62 74 72 65 65 49 6e );. }. btreeIn
1b0f0 74 65 67 72 69 74 79 28 70 29 3b 0a 0a 20 20 69 tegrity(p);.. i
1b100 66 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 f( p->inTrans==T
1b110 52 41 4e 53 5f 57 52 49 54 45 20 29 7b 0a 20 20 RANS_WRITE ){.
1b120 20 20 69 6e 74 20 72 63 32 3b 0a 0a 20 20 20 20 int rc2;..
1b130 61 73 73 65 72 74 28 20 54 52 41 4e 53 5f 57 52 assert( TRANS_WR
1b140 49 54 45 3d 3d 70 42 74 2d 3e 69 6e 54 72 61 6e ITE==pBt->inTran
1b150 73 61 63 74 69 6f 6e 20 29 3b 0a 20 20 20 20 72 saction );. r
1b160 63 32 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 c2 = sqlite3Page
1b170 72 52 6f 6c 6c 62 61 63 6b 28 70 42 74 2d 3e 70 rRollback(pBt->p
1b180 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 Pager);. if(
1b190 72 63 32 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc2!=SQLITE_OK )
1b1a0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 63 32 {. rc = rc2
1b1b0 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
1b1c0 54 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6d 61 79 The rollback may
1b1d0 20 68 61 76 65 20 64 65 73 74 72 6f 79 65 64 20 have destroyed
1b1e0 74 68 65 20 70 50 61 67 65 31 2d 3e 61 44 61 74 the pPage1->aDat
1b1f0 61 20 76 61 6c 75 65 2e 20 20 53 6f 0a 20 20 20 a value. So.
1b200 20 2a 2a 20 63 61 6c 6c 20 62 74 72 65 65 47 65 ** call btreeGe
1b210 74 50 61 67 65 28 29 20 6f 6e 20 70 61 67 65 20 tPage() on page
1b220 31 20 61 67 61 69 6e 20 74 6f 20 6d 61 6b 65 0a 1 again to make.
1b230 20 20 20 20 2a 2a 20 73 75 72 65 20 70 50 61 67 ** sure pPag
1b240 65 31 2d 3e 61 44 61 74 61 20 69 73 20 73 65 74 e1->aData is set
1b250 20 63 6f 72 72 65 63 74 6c 79 2e 20 2a 2f 0a 20 correctly. */.
1b260 20 20 20 69 66 28 20 62 74 72 65 65 47 65 74 50 if( btreeGetP
1b270 61 67 65 28 70 42 74 2c 20 31 2c 20 26 70 50 61 age(pBt, 1, &pPa
1b280 67 65 31 2c 20 30 29 3d 3d 53 51 4c 49 54 45 5f ge1, 0)==SQLITE_
1b290 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 OK ){. int
1b2a0 6e 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 nPage = get4byte
1b2b0 28 32 38 2b 28 75 38 2a 29 70 50 61 67 65 31 2d (28+(u8*)pPage1-
1b2c0 3e 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 74 >aData);. t
1b2d0 65 73 74 63 61 73 65 28 20 6e 50 61 67 65 3d 3d estcase( nPage==
1b2e0 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 6e 0 );. if( n
1b2f0 50 61 67 65 3d 3d 30 20 29 20 73 71 6c 69 74 65 Page==0 ) sqlite
1b300 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 3PagerPagecount(
1b310 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 26 6e 50 pBt->pPager, &nP
1b320 61 67 65 29 3b 0a 20 20 20 20 20 20 74 65 73 74 age);. test
1b330 63 61 73 65 28 20 70 42 74 2d 3e 6e 50 61 67 65 case( pBt->nPage
1b340 21 3d 6e 50 61 67 65 20 29 3b 0a 20 20 20 20 20 !=nPage );.
1b350 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 6e 50 pBt->nPage = nP
1b360 61 67 65 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 age;. relea
1b370 73 65 50 61 67 65 28 70 50 61 67 65 31 29 3b 0a sePage(pPage1);.
1b380 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
1b390 28 20 63 6f 75 6e 74 57 72 69 74 65 43 75 72 73 ( countWriteCurs
1b3a0 6f 72 73 28 70 42 74 29 3d 3d 30 20 29 3b 0a 20 ors(pBt)==0 );.
1b3b0 20 20 20 70 42 74 2d 3e 69 6e 54 72 61 6e 73 61 pBt->inTransa
1b3c0 63 74 69 6f 6e 20 3d 20 54 52 41 4e 53 5f 52 45 ction = TRANS_RE
1b3d0 41 44 3b 0a 20 20 7d 0a 0a 20 20 62 74 72 65 65 AD;. }.. btree
1b3e0 45 6e 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 EndTransaction(p
1b3f0 29 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 );. sqlite3Btre
1b400 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 eLeave(p);. ret
1b410 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
1b420 20 53 74 61 72 74 20 61 20 73 74 61 74 65 6d 65 Start a stateme
1b430 6e 74 20 73 75 62 74 72 61 6e 73 61 63 74 69 6f nt subtransactio
1b440 6e 2e 20 54 68 65 20 73 75 62 74 72 61 6e 73 61 n. The subtransa
1b450 63 74 69 6f 6e 20 63 61 6e 20 63 61 6e 20 62 65 ction can can be
1b460 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 61 63 6b 20 rolled.** back
1b470 69 6e 64 65 70 65 6e 64 65 6e 74 6c 79 20 6f 66 independently of
1b480 20 74 68 65 20 6d 61 69 6e 20 74 72 61 6e 73 61 the main transa
1b490 63 74 69 6f 6e 2e 20 59 6f 75 20 6d 75 73 74 20 ction. You must
1b4a0 73 74 61 72 74 20 61 20 74 72 61 6e 73 61 63 74 start a transact
1b4b0 69 6f 6e 20 0a 2a 2a 20 62 65 66 6f 72 65 20 73 ion .** before s
1b4c0 74 61 72 74 69 6e 67 20 61 20 73 75 62 74 72 61 tarting a subtra
1b4d0 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 75 nsaction. The su
1b4e0 62 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 btransaction is
1b4f0 65 6e 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 ended automatica
1b500 6c 6c 79 20 0a 2a 2a 20 69 66 20 74 68 65 20 6d lly .** if the m
1b510 61 69 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ain transaction
1b520 63 6f 6d 6d 69 74 73 20 6f 72 20 72 6f 6c 6c 73 commits or rolls
1b530 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 74 61 back..**.** Sta
1b540 74 65 6d 65 6e 74 20 73 75 62 74 72 61 6e 73 61 tement subtransa
1b550 63 74 69 6f 6e 73 20 61 72 65 20 75 73 65 64 20 ctions are used
1b560 61 72 6f 75 6e 64 20 69 6e 64 69 76 69 64 75 61 around individua
1b570 6c 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 l SQL statements
1b580 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 63 6f 6e .** that are con
1b590 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 61 20 tained within a
1b5a0 42 45 47 49 4e 2e 2e 2e 43 4f 4d 4d 49 54 20 62 BEGIN...COMMIT b
1b5b0 6c 6f 63 6b 2e 20 20 49 66 20 61 20 63 6f 6e 73 lock. If a cons
1b5c0 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 traint.** error
1b5d0 6f 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 occurs within th
1b5e0 65 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 e statement, the
1b5f0 20 65 66 66 65 63 74 20 6f 66 20 74 68 61 74 20 effect of that
1b600 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a one statement.**
1b610 20 63 61 6e 20 62 65 20 72 6f 6c 6c 65 64 20 62 can be rolled b
1b620 61 63 6b 20 77 69 74 68 6f 75 74 20 68 61 76 69 ack without havi
1b630 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 ng to rollback t
1b640 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 he entire transa
1b650 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 73 ction..**.** A s
1b660 74 61 74 65 6d 65 6e 74 20 73 75 62 2d 74 72 61 tatement sub-tra
1b670 6e 73 61 63 74 69 6f 6e 20 69 73 20 69 6d 70 6c nsaction is impl
1b680 65 6d 65 6e 74 65 64 20 61 73 20 61 6e 20 61 6e emented as an an
1b690 6f 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e onymous savepoin
1b6a0 74 2e 20 54 68 65 0a 2a 2a 20 76 61 6c 75 65 20 t. The.** value
1b6b0 70 61 73 73 65 64 20 61 73 20 74 68 65 20 73 65 passed as the se
1b6c0 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 69 cond parameter i
1b6d0 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 s the total numb
1b6e0 65 72 20 6f 66 20 73 61 76 65 70 6f 69 6e 74 73 er of savepoints
1b6f0 2c 0a 2a 2a 20 69 6e 63 6c 75 64 69 6e 67 20 74 ,.** including t
1b700 68 65 20 6e 65 77 20 61 6e 6f 6e 79 6d 6f 75 73 he new anonymous
1b710 20 73 61 76 65 70 6f 69 6e 74 2c 20 6f 70 65 6e savepoint, open
1b720 20 6f 6e 20 74 68 65 20 42 2d 54 72 65 65 2e 20 on the B-Tree.
1b730 69 2e 65 2e 20 69 66 20 74 68 65 72 65 0a 2a 2a i.e. if there.**
1b740 20 61 72 65 20 6e 6f 20 61 63 74 69 76 65 20 73 are no active s
1b750 61 76 65 70 6f 69 6e 74 73 20 61 6e 64 20 6e 6f avepoints and no
1b760 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 other statement
1b770 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6f 70 -transactions op
1b780 65 6e 2c 0a 2a 2a 20 69 53 74 61 74 65 6d 65 6e en,.** iStatemen
1b790 74 20 69 73 20 31 2e 20 54 68 69 73 20 61 6e 6f t is 1. This ano
1b7a0 6e 79 6d 6f 75 73 20 73 61 76 65 70 6f 69 6e 74 nymous savepoint
1b7b0 20 63 61 6e 20 62 65 20 72 65 6c 65 61 73 65 64 can be released
1b7c0 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b 0a or rolled back.
1b7d0 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c ** using the sql
1b7e0 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 ite3BtreeSavepoi
1b7f0 6e 74 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a nt() function..*
1b800 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 /.int sqlite3Btr
1b810 65 65 42 65 67 69 6e 53 74 6d 74 28 42 74 72 65 eeBeginStmt(Btre
1b820 65 20 2a 70 2c 20 69 6e 74 20 69 53 74 61 74 65 e *p, int iState
1b830 6d 65 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 3b ment){. int rc;
1b840 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
1b850 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 73 71 6c = p->pBt;. sql
1b860 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 ite3BtreeEnter(p
1b870 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e );. assert( p->
1b880 69 6e 54 72 61 6e 73 3d 3d 54 52 41 4e 53 5f 57 inTrans==TRANS_W
1b890 52 49 54 45 20 29 3b 0a 20 20 61 73 73 65 72 74 RITE );. assert
1b8a0 28 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 ( (pBt->btsFlags
1b8b0 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c 59 & BTS_READ_ONLY
1b8c0 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 )==0 );. assert
1b8d0 28 20 69 53 74 61 74 65 6d 65 6e 74 3e 30 20 29 ( iStatement>0 )
1b8e0 3b 0a 20 20 61 73 73 65 72 74 28 20 69 53 74 61 ;. assert( iSta
1b8f0 74 65 6d 65 6e 74 3e 70 2d 3e 64 62 2d 3e 6e 53 tement>p->db->nS
1b900 61 76 65 70 6f 69 6e 74 20 29 3b 0a 20 20 61 73 avepoint );. as
1b910 73 65 72 74 28 20 70 42 74 2d 3e 69 6e 54 72 61 sert( pBt->inTra
1b920 6e 73 61 63 74 69 6f 6e 3d 3d 54 52 41 4e 53 5f nsaction==TRANS_
1b930 57 52 49 54 45 20 29 3b 0a 20 20 2f 2a 20 41 74 WRITE );. /* At
1b940 20 74 68 65 20 70 61 67 65 72 20 6c 65 76 65 6c the pager level
1b950 2c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 , a statement tr
1b960 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 20 73 ansaction is a s
1b970 61 76 65 70 6f 69 6e 74 20 77 69 74 68 0a 20 20 avepoint with.
1b980 2a 2a 20 61 6e 20 69 6e 64 65 78 20 67 72 65 61 ** an index grea
1b990 74 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 76 ter than all sav
1b9a0 65 70 6f 69 6e 74 73 20 63 72 65 61 74 65 64 20 epoints created
1b9b0 65 78 70 6c 69 63 69 74 6c 79 20 75 73 69 6e 67 explicitly using
1b9c0 0a 20 20 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d . ** SQL statem
1b9d0 65 6e 74 73 2e 20 49 74 20 69 73 20 69 6c 6c 65 ents. It is ille
1b9e0 67 61 6c 20 74 6f 20 6f 70 65 6e 2c 20 72 65 6c gal to open, rel
1b9f0 65 61 73 65 20 6f 72 20 72 6f 6c 6c 62 61 63 6b ease or rollback
1ba00 20 61 6e 79 0a 20 20 2a 2a 20 73 75 63 68 20 73 any. ** such s
1ba10 61 76 65 70 6f 69 6e 74 73 20 77 68 69 6c 65 20 avepoints while
1ba20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 72 the statement tr
1ba30 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f ansaction savepo
1ba40 69 6e 74 20 69 73 20 61 63 74 69 76 65 2e 0a 20 int is active..
1ba50 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 */. rc = sqlit
1ba60 65 33 50 61 67 65 72 4f 70 65 6e 53 61 76 65 70 e3PagerOpenSavep
1ba70 6f 69 6e 74 28 70 42 74 2d 3e 70 50 61 67 65 72 oint(pBt->pPager
1ba80 2c 20 69 53 74 61 74 65 6d 65 6e 74 29 3b 0a 20 , iStatement);.
1ba90 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 sqlite3BtreeLea
1baa0 76 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 ve(p);. return
1bab0 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 rc;.}../*.** The
1bac0 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 second argument
1bad0 20 74 6f 20 74 68 69 73 20 66 75 6e 63 74 69 6f to this functio
1bae0 6e 2c 20 6f 70 2c 20 69 73 20 61 6c 77 61 79 73 n, op, is always
1baf0 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 SAVEPOINT_ROLLB
1bb00 41 43 4b 0a 2a 2a 20 6f 72 20 53 41 56 45 50 4f ACK.** or SAVEPO
1bb10 49 4e 54 5f 52 45 4c 45 41 53 45 2e 20 54 68 69 INT_RELEASE. Thi
1bb20 73 20 66 75 6e 63 74 69 6f 6e 20 65 69 74 68 65 s function eithe
1bb30 72 20 72 65 6c 65 61 73 65 73 20 6f 72 20 72 6f r releases or ro
1bb40 6c 6c 73 20 62 61 63 6b 20 74 68 65 0a 2a 2a 20 lls back the.**
1bb50 73 61 76 65 70 6f 69 6e 74 20 69 64 65 6e 74 69 savepoint identi
1bb60 66 69 65 64 20 62 79 20 70 61 72 61 6d 65 74 65 fied by paramete
1bb70 72 20 69 53 61 76 65 70 6f 69 6e 74 2c 20 64 65 r iSavepoint, de
1bb80 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 76 pending on the v
1bb90 61 6c 75 65 20 0a 2a 2a 20 6f 66 20 6f 70 2e 0a alue .** of op..
1bba0 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 **.** Normally,
1bbb0 69 53 61 76 65 70 6f 69 6e 74 20 69 73 20 67 72 iSavepoint is gr
1bbc0 65 61 74 65 72 20 74 68 61 6e 20 6f 72 20 65 71 eater than or eq
1bbd0 75 61 6c 20 74 6f 20 7a 65 72 6f 2e 20 48 6f 77 ual to zero. How
1bbe0 65 76 65 72 2c 20 69 66 20 6f 70 20 69 73 0a 2a ever, if op is.*
1bbf0 2a 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c * SAVEPOINT_ROLL
1bc00 42 41 43 4b 2c 20 74 68 65 6e 20 69 53 61 76 65 BACK, then iSave
1bc10 70 6f 69 6e 74 20 6d 61 79 20 61 6c 73 6f 20 62 point may also b
1bc20 65 20 2d 31 2e 20 49 6e 20 74 68 69 73 20 63 61 e -1. In this ca
1bc30 73 65 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 se the .** conte
1bc40 6e 74 73 20 6f 66 20 74 68 65 20 65 6e 74 69 72 nts of the entir
1bc50 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 e transaction ar
1bc60 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 e rolled back. T
1bc70 68 69 73 20 69 73 20 64 69 66 66 65 72 65 6e 74 his is different
1bc80 0a 2a 2a 20 66 72 6f 6d 20 61 20 6e 6f 72 6d 61 .** from a norma
1bc90 6c 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f l transaction ro
1bca0 6c 6c 62 61 63 6b 2c 20 61 73 20 6e 6f 20 6c 6f llback, as no lo
1bcb0 63 6b 73 20 61 72 65 20 72 65 6c 65 61 73 65 64 cks are released
1bcc0 20 61 6e 64 20 74 68 65 0a 2a 2a 20 74 72 61 6e and the.** tran
1bcd0 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73 20 saction remains
1bce0 6f 70 65 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c open..*/.int sql
1bcf0 69 74 65 33 42 74 72 65 65 53 61 76 65 70 6f 69 ite3BtreeSavepoi
1bd00 6e 74 28 42 74 72 65 65 20 2a 70 2c 20 69 6e 74 nt(Btree *p, int
1bd10 20 6f 70 2c 20 69 6e 74 20 69 53 61 76 65 70 6f op, int iSavepo
1bd20 69 6e 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d int){. int rc =
1bd30 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
1bd40 28 20 70 20 26 26 20 70 2d 3e 69 6e 54 72 61 6e ( p && p->inTran
1bd50 73 3d 3d 54 52 41 4e 53 5f 57 52 49 54 45 20 29 s==TRANS_WRITE )
1bd60 7b 0a 20 20 20 20 42 74 53 68 61 72 65 64 20 2a {. BtShared *
1bd70 70 42 74 20 3d 20 70 2d 3e 70 42 74 3b 0a 20 20 pBt = p->pBt;.
1bd80 20 20 61 73 73 65 72 74 28 20 6f 70 3d 3d 53 41 assert( op==SA
1bd90 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 VEPOINT_RELEASE
1bda0 7c 7c 20 6f 70 3d 3d 53 41 56 45 50 4f 49 4e 54 || op==SAVEPOINT
1bdb0 5f 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 20 _ROLLBACK );.
1bdc0 20 61 73 73 65 72 74 28 20 69 53 61 76 65 70 6f assert( iSavepo
1bdd0 69 6e 74 3e 3d 30 20 7c 7c 20 28 69 53 61 76 65 int>=0 || (iSave
1bde0 70 6f 69 6e 74 3d 3d 2d 31 20 26 26 20 6f 70 3d point==-1 && op=
1bdf0 3d 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 =SAVEPOINT_ROLLB
1be00 41 43 4b 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 ACK) );. sqli
1be10 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 70 29 te3BtreeEnter(p)
1be20 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
1be30 65 33 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 e3PagerSavepoint
1be40 28 70 42 74 2d 3e 70 50 61 67 65 72 2c 20 6f 70 (pBt->pPager, op
1be50 2c 20 69 53 61 76 65 70 6f 69 6e 74 29 3b 0a 20 , iSavepoint);.
1be60 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1be70 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 E_OK ){. if
1be80 28 20 69 53 61 76 65 70 6f 69 6e 74 3c 30 20 26 ( iSavepoint<0 &
1be90 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 73 & (pBt->btsFlags
1bea0 20 26 20 42 54 53 5f 49 4e 49 54 49 41 4c 4c 59 & BTS_INITIALLY
1beb0 5f 45 4d 50 54 59 29 21 3d 30 20 29 7b 0a 20 20 _EMPTY)!=0 ){.
1bec0 20 20 20 20 20 20 70 42 74 2d 3e 6e 50 61 67 65 pBt->nPage
1bed0 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 0a 20 20 = 0;. }.
1bee0 20 20 20 20 72 63 20 3d 20 6e 65 77 44 61 74 61 rc = newData
1bef0 62 61 73 65 28 70 42 74 29 3b 0a 20 20 20 20 20 base(pBt);.
1bf00 20 70 42 74 2d 3e 6e 50 61 67 65 20 3d 20 67 65 pBt->nPage = ge
1bf10 74 34 62 79 74 65 28 32 38 20 2b 20 70 42 74 2d t4byte(28 + pBt-
1bf20 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 29 3b >pPage1->aData);
1bf30 0a 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 .. /* The d
1bf40 61 74 61 62 61 73 65 20 73 69 7a 65 20 77 61 73 atabase size was
1bf50 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 written into th
1bf60 65 20 6f 66 66 73 65 74 20 32 38 20 6f 66 20 74 e offset 28 of t
1bf70 68 65 20 68 65 61 64 65 72 0a 20 20 20 20 20 20 he header.
1bf80 2a 2a 20 77 68 65 6e 20 74 68 65 20 74 72 61 6e ** when the tran
1bf90 73 61 63 74 69 6f 6e 20 73 74 61 72 74 65 64 2c saction started,
1bfa0 20 73 6f 20 77 65 20 6b 6e 6f 77 20 74 68 61 74 so we know that
1bfb0 20 74 68 65 20 76 61 6c 75 65 20 61 74 20 6f 66 the value at of
1bfc0 66 73 65 74 0a 20 20 20 20 20 20 2a 2a 20 32 38 fset. ** 28
1bfd0 20 69 73 20 6e 6f 6e 7a 65 72 6f 2e 20 2a 2f 0a is nonzero. */.
1bfe0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 42 assert( pB
1bff0 74 2d 3e 6e 50 61 67 65 3e 30 20 29 3b 0a 20 20 t->nPage>0 );.
1c000 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 42 }. sqlite3B
1c010 74 72 65 65 4c 65 61 76 65 28 70 29 3b 0a 20 20 treeLeave(p);.
1c020 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
1c030 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 ../*.** Create a
1c040 20 6e 65 77 20 63 75 72 73 6f 72 20 66 6f 72 20 new cursor for
1c050 74 68 65 20 42 54 72 65 65 20 77 68 6f 73 65 20 the BTree whose
1c060 72 6f 6f 74 20 69 73 20 6f 6e 20 74 68 65 20 70 root is on the p
1c070 61 67 65 0a 2a 2a 20 69 54 61 62 6c 65 2e 20 49 age.** iTable. I
1c080 66 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 63 75 f a read-only cu
1c090 72 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 rsor is requeste
1c0a0 64 2c 20 69 74 20 69 73 20 61 73 73 75 6d 65 64 d, it is assumed
1c0b0 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 61 6c that.** the cal
1c0c0 6c 65 72 20 61 6c 72 65 61 64 79 20 68 61 73 20 ler already has
1c0d0 61 74 20 6c 65 61 73 74 20 61 20 72 65 61 64 2d at least a read-
1c0e0 6f 6e 6c 79 20 74 72 61 6e 73 61 63 74 69 6f 6e only transaction
1c0f0 20 6f 70 65 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 open.** on the
1c100 64 61 74 61 62 61 73 65 20 61 6c 72 65 61 64 79 database already
1c110 2e 20 49 66 20 61 20 77 72 69 74 65 2d 63 75 72 . If a write-cur
1c120 73 6f 72 20 69 73 20 72 65 71 75 65 73 74 65 64 sor is requested
1c130 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 61 , then.** the ca
1c140 6c 6c 65 72 20 69 73 20 61 73 73 75 6d 65 64 20 ller is assumed
1c150 74 6f 20 68 61 76 65 20 61 6e 20 6f 70 65 6e 20 to have an open
1c160 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f write transactio
1c170 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 77 72 46 6c n..**.** If wrFl
1c180 61 67 3d 3d 30 2c 20 74 68 65 6e 20 74 68 65 20 ag==0, then the
1c190 63 75 72 73 6f 72 20 63 61 6e 20 6f 6e 6c 79 20 cursor can only
1c1a0 62 65 20 75 73 65 64 20 66 6f 72 20 72 65 61 64 be used for read
1c1b0 69 6e 67 2e 0a 2a 2a 20 49 66 20 77 72 46 6c 61 ing..** If wrFla
1c1c0 67 3d 3d 31 2c 20 74 68 65 6e 20 74 68 65 20 63 g==1, then the c
1c1d0 75 72 73 6f 72 20 63 61 6e 20 62 65 20 75 73 65 ursor can be use
1c1e0 64 20 66 6f 72 20 72 65 61 64 69 6e 67 20 6f 72 d for reading or
1c1f0 20 66 6f 72 0a 2a 2a 20 77 72 69 74 69 6e 67 20 for.** writing
1c200 69 66 20 6f 74 68 65 72 20 63 6f 6e 64 69 74 69 if other conditi
1c210 6f 6e 73 20 66 6f 72 20 77 72 69 74 69 6e 67 20 ons for writing
1c220 61 72 65 20 61 6c 73 6f 20 6d 65 74 2e 20 20 54 are also met. T
1c230 68 65 73 65 0a 2a 2a 20 61 72 65 20 74 68 65 20 hese.** are the
1c240 63 6f 6e 64 69 74 69 6f 6e 73 20 74 68 61 74 20 conditions that
1c250 6d 75 73 74 20 62 65 20 6d 65 74 20 69 6e 20 6f must be met in o
1c260 72 64 65 72 20 66 6f 72 20 77 72 69 74 69 6e 67 rder for writing
1c270 20 74 6f 0a 2a 2a 20 62 65 20 61 6c 6c 6f 77 65 to.** be allowe
1c280 64 3a 0a 2a 2a 0a 2a 2a 20 31 3a 20 20 54 68 65 d:.**.** 1: The
1c290 20 63 75 72 73 6f 72 20 6d 75 73 74 20 68 61 76 cursor must hav
1c2a0 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 77 69 e been opened wi
1c2b0 74 68 20 77 72 46 6c 61 67 3d 3d 31 0a 2a 2a 0a th wrFlag==1.**.
1c2c0 2a 2a 20 32 3a 20 20 4f 74 68 65 72 20 64 61 74 ** 2: Other dat
1c2d0 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
1c2e0 73 20 74 68 61 74 20 73 68 61 72 65 20 74 68 65 s that share the
1c2f0 20 73 61 6d 65 20 70 61 67 65 72 20 63 61 63 68 same pager cach
1c300 65 0a 2a 2a 20 20 20 20 20 62 75 74 20 77 68 69 e.** but whi
1c310 63 68 20 61 72 65 20 6e 6f 74 20 69 6e 20 74 68 ch are not in th
1c320 65 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 e READ_UNCOMMITT
1c330 45 44 20 73 74 61 74 65 20 6d 61 79 20 6e 6f 74 ED state may not
1c340 20 68 61 76 65 0a 2a 2a 20 20 20 20 20 63 75 72 have.** cur
1c350 73 6f 72 73 20 6f 70 65 6e 20 77 69 74 68 20 77 sors open with w
1c360 72 46 6c 61 67 3d 3d 30 20 6f 6e 20 74 68 65 20 rFlag==0 on the
1c370 73 61 6d 65 20 74 61 62 6c 65 2e 20 20 4f 74 68 same table. Oth
1c380 65 72 77 69 73 65 0a 2a 2a 20 20 20 20 20 74 68 erwise.** th
1c390 65 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 62 e changes made b
1c3a0 79 20 74 68 69 73 20 77 72 69 74 65 20 63 75 72 y this write cur
1c3b0 73 6f 72 20 77 6f 75 6c 64 20 62 65 20 76 69 73 sor would be vis
1c3c0 69 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 20 20 74 ible to.** t
1c3d0 68 65 20 72 65 61 64 20 63 75 72 73 6f 72 73 20 he read cursors
1c3e0 69 6e 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 in the other dat
1c3f0 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
1c400 2e 0a 2a 2a 0a 2a 2a 20 33 3a 20 20 54 68 65 20 ..**.** 3: The
1c410 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 62 65 database must be
1c420 20 77 72 69 74 61 62 6c 65 20 28 6e 6f 74 20 6f writable (not o
1c430 6e 20 72 65 61 64 2d 6f 6e 6c 79 20 6d 65 64 69 n read-only medi
1c440 61 29 0a 2a 2a 0a 2a 2a 20 34 3a 20 20 54 68 65 a).**.** 4: The
1c450 72 65 20 6d 75 73 74 20 62 65 20 61 6e 20 61 63 re must be an ac
1c460 74 69 76 65 20 74 72 61 6e 73 61 63 74 69 6f 6e tive transaction
1c470 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 20 63 68 65 63 6b ..**.** No check
1c480 69 6e 67 20 69 73 20 64 6f 6e 65 20 74 6f 20 6d ing is done to m
1c490 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 70 61 ake sure that pa
1c4a0 67 65 20 69 54 61 62 6c 65 20 72 65 61 6c 6c 79 ge iTable really
1c4b0 20 69 73 20 74 68 65 0a 2a 2a 20 72 6f 6f 74 20 is the.** root
1c4c0 70 61 67 65 20 6f 66 20 61 20 62 2d 74 72 65 65 page of a b-tree
1c4d0 2e 20 20 49 66 20 69 74 20 69 73 20 6e 6f 74 2c . If it is not,
1c4e0 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f 72 then the cursor
1c4f0 20 61 63 71 75 69 72 65 64 0a 2a 2a 20 77 69 6c acquired.** wil
1c500 6c 20 6e 6f 74 20 77 6f 72 6b 20 63 6f 72 72 65 l not work corre
1c510 63 74 6c 79 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 69 ctly..**.** It i
1c520 73 20 61 73 73 75 6d 65 64 20 74 68 61 74 20 74 s assumed that t
1c530 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 he sqlite3BtreeC
1c540 75 72 73 6f 72 5a 65 72 6f 28 29 20 68 61 73 20 ursorZero() has
1c550 62 65 65 6e 20 63 61 6c 6c 65 64 0a 2a 2a 20 6f been called.** o
1c560 6e 20 70 43 75 72 20 74 6f 20 69 6e 69 74 69 61 n pCur to initia
1c570 6c 69 7a 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 lize the memory
1c580 73 70 61 63 65 20 70 72 69 6f 72 20 74 6f 20 69 space prior to i
1c590 6e 76 6f 6b 69 6e 67 20 74 68 69 73 20 72 6f 75 nvoking this rou
1c5a0 74 69 6e 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 tine..*/.static
1c5b0 69 6e 74 20 62 74 72 65 65 43 75 72 73 6f 72 28 int btreeCursor(
1c5c0 0a 20 20 42 74 72 65 65 20 2a 70 2c 20 20 20 20 . Btree *p,
1c5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c5e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
1c5f0 20 62 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 btree */. int
1c600 69 54 61 62 6c 65 2c 20 20 20 20 20 20 20 20 20 iTable,
1c610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c620 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 20 /* Root page
1c630 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f 70 65 6e of table to open
1c640 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 6c 61 67 */. int wrFlag
1c650 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1c660 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1c670 31 20 74 6f 20 77 72 69 74 65 2e 20 30 20 72 65 1 to write. 0 re
1c680 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 20 20 73 74 72 ad-only */. str
1c690 75 63 74 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 uct KeyInfo *pKe
1c6a0 79 49 6e 66 6f 2c 20 20 20 20 20 20 20 20 20 20 yInfo,
1c6b0 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
1c6c0 20 74 6f 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 to comparison f
1c6d0 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 42 74 43 unction */. BtC
1c6e0 75 72 73 6f 72 20 2a 70 43 75 72 20 20 20 20 20 ursor *pCur
1c6f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c700 20 20 20 20 2f 2a 20 53 70 61 63 65 20 66 6f 72 /* Space for
1c710 20 6e 65 77 20 63 75 72 73 6f 72 20 2a 2f 0a 29 new cursor */.)
1c720 7b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 {. BtShared *pB
1c730 74 20 3d 20 70 2d 3e 70 42 74 3b 20 20 20 20 20 t = p->pBt;
1c740 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 68 /* Sh
1c750 61 72 65 64 20 62 2d 74 72 65 65 20 68 61 6e 64 ared b-tree hand
1c760 6c 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 le */.. assert(
1c770 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c sqlite3BtreeHol
1c780 64 73 4d 75 74 65 78 28 70 29 20 29 3b 0a 20 20 dsMutex(p) );.
1c790 61 73 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d assert( wrFlag==
1c7a0 30 20 7c 7c 20 77 72 46 6c 61 67 3d 3d 31 20 29 0 || wrFlag==1 )
1c7b0 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c ;.. /* The foll
1c7c0 6f 77 69 6e 67 20 61 73 73 65 72 74 20 73 74 61 owing assert sta
1c7d0 74 65 6d 65 6e 74 73 20 76 65 72 69 66 79 20 74 tements verify t
1c7e0 68 61 74 20 69 66 20 74 68 69 73 20 69 73 20 61 hat if this is a
1c7f0 20 73 68 61 72 61 62 6c 65 20 0a 20 20 2a 2a 20 sharable . **
1c800 62 2d 74 72 65 65 20 64 61 74 61 62 61 73 65 2c b-tree database,
1c810 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
1c820 69 73 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 72 is holding the r
1c830 65 71 75 69 72 65 64 20 74 61 62 6c 65 20 6c 6f equired table lo
1c840 63 6b 73 2c 20 0a 20 20 2a 2a 20 61 6e 64 20 74 cks, . ** and t
1c850 68 61 74 20 6e 6f 20 6f 74 68 65 72 20 63 6f 6e hat no other con
1c860 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 6e 79 20 nection has any
1c870 6f 70 65 6e 20 63 75 72 73 6f 72 20 74 68 61 74 open cursor that
1c880 20 63 6f 6e 66 6c 69 63 74 73 20 77 69 74 68 20 conflicts with
1c890 0a 20 20 2a 2a 20 74 68 69 73 20 6c 6f 63 6b 2e . ** this lock.
1c8a0 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 68 */. assert( h
1c8b0 61 73 53 68 61 72 65 64 43 61 63 68 65 54 61 62 asSharedCacheTab
1c8c0 6c 65 4c 6f 63 6b 28 70 2c 20 69 54 61 62 6c 65 leLock(p, iTable
1c8d0 2c 20 70 4b 65 79 49 6e 66 6f 21 3d 30 2c 20 77 , pKeyInfo!=0, w
1c8e0 72 46 6c 61 67 2b 31 29 20 29 3b 0a 20 20 61 73 rFlag+1) );. as
1c8f0 73 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 sert( wrFlag==0
1c900 7c 7c 20 21 68 61 73 52 65 61 64 43 6f 6e 66 6c || !hasReadConfl
1c910 69 63 74 73 28 70 2c 20 69 54 61 62 6c 65 29 20 icts(p, iTable)
1c920 29 3b 0a 0a 20 20 2f 2a 20 41 73 73 65 72 74 20 );.. /* Assert
1c930 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 that the caller
1c940 68 61 73 20 6f 70 65 6e 65 64 20 74 68 65 20 72 has opened the r
1c950 65 71 75 69 72 65 64 20 74 72 61 6e 73 61 63 74 equired transact
1c960 69 6f 6e 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 ion. */. assert
1c970 28 20 70 2d 3e 69 6e 54 72 61 6e 73 3e 54 52 41 ( p->inTrans>TRA
1c980 4e 53 5f 4e 4f 4e 45 20 29 3b 0a 20 20 61 73 73 NS_NONE );. ass
1c990 65 72 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 7c ert( wrFlag==0 |
1c9a0 7c 20 70 2d 3e 69 6e 54 72 61 6e 73 3d 3d 54 52 | p->inTrans==TR
1c9b0 41 4e 53 5f 57 52 49 54 45 20 29 3b 0a 20 20 61 ANS_WRITE );. a
1c9c0 73 73 65 72 74 28 20 70 42 74 2d 3e 70 50 61 67 ssert( pBt->pPag
1c9d0 65 31 20 26 26 20 70 42 74 2d 3e 70 50 61 67 65 e1 && pBt->pPage
1c9e0 31 2d 3e 61 44 61 74 61 20 29 3b 0a 0a 20 20 69 1->aData );.. i
1c9f0 66 28 20 4e 45 56 45 52 28 77 72 46 6c 61 67 20 f( NEVER(wrFlag
1ca00 26 26 20 28 70 42 74 2d 3e 62 74 73 46 6c 61 67 && (pBt->btsFlag
1ca10 73 20 26 20 42 54 53 5f 52 45 41 44 5f 4f 4e 4c s & BTS_READ_ONL
1ca20 59 29 21 3d 30 29 20 29 7b 0a 20 20 20 20 72 65 Y)!=0) ){. re
1ca30 74 75 72 6e 20 53 51 4c 49 54 45 5f 52 45 41 44 turn SQLITE_READ
1ca40 4f 4e 4c 59 3b 0a 20 20 7d 0a 20 20 69 66 28 20 ONLY;. }. if(
1ca50 69 54 61 62 6c 65 3d 3d 31 20 26 26 20 62 74 72 iTable==1 && btr
1ca60 65 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 eePagecount(pBt)
1ca70 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 ==0 ){. asser
1ca80 74 28 20 77 72 46 6c 61 67 3d 3d 30 20 29 3b 0a t( wrFlag==0 );.
1ca90 20 20 20 20 69 54 61 62 6c 65 20 3d 20 30 3b 0a iTable = 0;.
1caa0 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 77 20 74 68 }.. /* Now th
1cab0 61 74 20 6e 6f 20 6f 74 68 65 72 20 65 72 72 6f at no other erro
1cac0 72 73 20 63 61 6e 20 6f 63 63 75 72 2c 20 66 69 rs can occur, fi
1cad0 6e 69 73 68 20 66 69 6c 6c 69 6e 67 20 69 6e 20 nish filling in
1cae0 74 68 65 20 42 74 43 75 72 73 6f 72 0a 20 20 2a the BtCursor. *
1caf0 2a 20 76 61 72 69 61 62 6c 65 73 20 61 6e 64 20 * variables and
1cb00 6c 69 6e 6b 20 74 68 65 20 63 75 72 73 6f 72 20 link the cursor
1cb10 69 6e 74 6f 20 74 68 65 20 42 74 53 68 61 72 65 into the BtShare
1cb20 64 20 6c 69 73 74 2e 20 20 2a 2f 0a 20 20 70 43 d list. */. pC
1cb30 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 20 3d 20 28 ur->pgnoRoot = (
1cb40 50 67 6e 6f 29 69 54 61 62 6c 65 3b 0a 20 20 70 Pgno)iTable;. p
1cb50 43 75 72 2d 3e 69 50 61 67 65 20 3d 20 2d 31 3b Cur->iPage = -1;
1cb60 0a 20 20 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 . pCur->pKeyInf
1cb70 6f 20 3d 20 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 o = pKeyInfo;.
1cb80 70 43 75 72 2d 3e 70 42 74 72 65 65 20 3d 20 70 pCur->pBtree = p
1cb90 3b 0a 20 20 70 43 75 72 2d 3e 70 42 74 20 3d 20 ;. pCur->pBt =
1cba0 70 42 74 3b 0a 20 20 70 43 75 72 2d 3e 77 72 46 pBt;. pCur->wrF
1cbb0 6c 61 67 20 3d 20 28 75 38 29 77 72 46 6c 61 67 lag = (u8)wrFlag
1cbc0 3b 0a 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 20 ;. pCur->pNext
1cbd0 3d 20 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 0a = pBt->pCursor;.
1cbe0 20 20 69 66 28 20 70 43 75 72 2d 3e 70 4e 65 78 if( pCur->pNex
1cbf0 74 20 29 7b 0a 20 20 20 20 70 43 75 72 2d 3e 70 t ){. pCur->p
1cc00 4e 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 43 Next->pPrev = pC
1cc10 75 72 3b 0a 20 20 7d 0a 20 20 70 42 74 2d 3e 70 ur;. }. pBt->p
1cc20 43 75 72 73 6f 72 20 3d 20 70 43 75 72 3b 0a 20 Cursor = pCur;.
1cc30 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 pCur->eState =
1cc40 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a CURSOR_INVALID;.
1cc50 20 20 70 43 75 72 2d 3e 63 61 63 68 65 64 52 6f pCur->cachedRo
1cc60 77 69 64 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 wid = 0;. retur
1cc70 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 n SQLITE_OK;.}.i
1cc80 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 nt sqlite3BtreeC
1cc90 75 72 73 6f 72 28 0a 20 20 42 74 72 65 65 20 2a ursor(. Btree *
1cca0 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p,
1ccb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ccc0 20 20 20 20 20 2f 2a 20 54 68 65 20 62 74 72 65 /* The btre
1ccd0 65 20 2a 2f 0a 20 20 69 6e 74 20 69 54 61 62 6c e */. int iTabl
1cce0 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
1ccf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cd00 20 20 20 2f 2a 20 52 6f 6f 74 20 70 61 67 65 20 /* Root page
1cd10 6f 66 20 74 61 62 6c 65 20 74 6f 20 6f 70 65 6e of table to open
1cd20 20 2a 2f 0a 20 20 69 6e 74 20 77 72 46 6c 61 67 */. int wrFlag
1cd30 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1cd40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cd50 20 20 2f 2a 20 31 20 74 6f 20 77 72 69 74 65 2e /* 1 to write.
1cd60 20 30 20 72 65 61 64 2d 6f 6e 6c 79 20 2a 2f 0a 0 read-only */.
1cd70 20 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f struct KeyInfo
1cd80 20 2a 70 4b 65 79 49 6e 66 6f 2c 20 20 20 20 20 *pKeyInfo,
1cd90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1cda0 20 46 69 72 73 74 20 61 72 67 20 74 6f 20 78 43 First arg to xC
1cdb0 6f 6d 70 61 72 65 28 29 20 2a 2f 0a 20 20 42 74 ompare() */. Bt
1cdc0 43 75 72 73 6f 72 20 2a 70 43 75 72 20 20 20 20 Cursor *pCur
1cdd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cde0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 /* Wri
1cdf0 74 65 20 6e 65 77 20 63 75 72 73 6f 72 20 68 65 te new cursor he
1ce00 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 re */.){. int r
1ce10 63 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 c;. sqlite3Btre
1ce20 65 45 6e 74 65 72 28 70 29 3b 0a 20 20 72 63 20 eEnter(p);. rc
1ce30 3d 20 62 74 72 65 65 43 75 72 73 6f 72 28 70 2c = btreeCursor(p,
1ce40 20 69 54 61 62 6c 65 2c 20 77 72 46 6c 61 67 2c iTable, wrFlag,
1ce50 20 70 4b 65 79 49 6e 66 6f 2c 20 70 43 75 72 29 pKeyInfo, pCur)
1ce60 3b 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 ;. sqlite3Btree
1ce70 4c 65 61 76 65 28 70 29 3b 0a 20 20 72 65 74 75 Leave(p);. retu
1ce80 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1ce90 52 65 74 75 72 6e 20 74 68 65 20 73 69 7a 65 20 Return the size
1cea0 6f 66 20 61 20 42 74 43 75 72 73 6f 72 20 6f 62 of a BtCursor ob
1ceb0 6a 65 63 74 20 69 6e 20 62 79 74 65 73 2e 0a 2a ject in bytes..*
1cec0 2a 0a 2a 2a 20 54 68 69 73 20 69 6e 74 65 72 66 *.** This interf
1ced0 61 63 65 73 20 69 73 20 6e 65 65 64 65 64 20 73 aces is needed s
1cee0 6f 20 74 68 61 74 20 75 73 65 72 73 20 6f 66 20 o that users of
1cef0 63 75 72 73 6f 72 73 20 63 61 6e 20 70 72 65 61 cursors can prea
1cf00 6c 6c 6f 63 61 74 65 0a 2a 2a 20 73 75 66 66 69 llocate.** suffi
1cf10 63 69 65 6e 74 20 73 74 6f 72 61 67 65 20 74 6f cient storage to
1cf20 20 68 6f 6c 64 20 61 20 63 75 72 73 6f 72 2e 20 hold a cursor.
1cf30 20 54 68 65 20 42 74 43 75 72 73 6f 72 20 6f 62 The BtCursor ob
1cf40 6a 65 63 74 20 69 73 20 6f 70 61 71 75 65 0a 2a ject is opaque.*
1cf50 2a 20 74 6f 20 75 73 65 72 73 20 73 6f 20 74 68 * to users so th
1cf60 65 79 20 63 61 6e 6e 6f 74 20 64 6f 20 74 68 65 ey cannot do the
1cf70 20 73 69 7a 65 6f 66 28 29 20 74 68 65 6d 73 65 sizeof() themse
1cf80 6c 76 65 73 20 2d 20 74 68 65 79 20 6d 75 73 74 lves - they must
1cf90 20 63 61 6c 6c 0a 2a 2a 20 74 68 69 73 20 72 6f call.** this ro
1cfa0 75 74 69 6e 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 utine..*/.int sq
1cfb0 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 lite3BtreeCursor
1cfc0 53 69 7a 65 28 76 6f 69 64 29 7b 0a 20 20 72 65 Size(void){. re
1cfd0 74 75 72 6e 20 52 4f 55 4e 44 38 28 73 69 7a 65 turn ROUND8(size
1cfe0 6f 66 28 42 74 43 75 72 73 6f 72 29 29 3b 0a 7d of(BtCursor));.}
1cff0 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 ../*.** Initiali
1d000 7a 65 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 77 ze memory that w
1d010 69 6c 6c 20 62 65 20 63 6f 6e 76 65 72 74 65 64 ill be converted
1d020 20 69 6e 74 6f 20 61 20 42 74 43 75 72 73 6f 72 into a BtCursor
1d030 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 54 object..**.** T
1d040 68 65 20 73 69 6d 70 6c 65 20 61 70 70 72 6f 61 he simple approa
1d050 63 68 20 68 65 72 65 20 77 6f 75 6c 64 20 62 65 ch here would be
1d060 20 74 6f 20 6d 65 6d 73 65 74 28 29 20 74 68 65 to memset() the
1d070 20 65 6e 74 69 72 65 20 6f 62 6a 65 63 74 0a 2a entire object.*
1d080 2a 20 74 6f 20 7a 65 72 6f 2e 20 20 42 75 74 20 * to zero. But
1d090 69 74 20 74 75 72 6e 73 20 6f 75 74 20 74 68 61 it turns out tha
1d0a0 74 20 74 68 65 20 61 70 50 61 67 65 5b 5d 20 61 t the apPage[] a
1d0b0 6e 64 20 61 69 49 64 78 5b 5d 20 61 72 72 61 79 nd aiIdx[] array
1d0c0 73 0a 2a 2a 20 64 6f 20 6e 6f 74 20 6e 65 65 64 s.** do not need
1d0d0 20 74 6f 20 62 65 20 7a 65 72 6f 65 64 20 61 6e to be zeroed an
1d0e0 64 20 74 68 65 79 20 61 72 65 20 6c 61 72 67 65 d they are large
1d0f0 2c 20 73 6f 20 77 65 20 63 61 6e 20 73 61 76 65 , so we can save
1d100 20 61 20 6c 6f 74 0a 2a 2a 20 6f 66 20 72 75 6e a lot.** of run
1d110 2d 74 69 6d 65 20 62 79 20 73 6b 69 70 70 69 6e -time by skippin
1d120 67 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 g the initializa
1d130 74 69 6f 6e 20 6f 66 20 74 68 6f 73 65 20 65 6c tion of those el
1d140 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 76 6f 69 64 20 ements..*/.void
1d150 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
1d160 6f 72 5a 65 72 6f 28 42 74 43 75 72 73 6f 72 20 orZero(BtCursor
1d170 2a 70 29 7b 0a 20 20 6d 65 6d 73 65 74 28 70 2c *p){. memset(p,
1d180 20 30 2c 20 6f 66 66 73 65 74 6f 66 28 42 74 43 0, offsetof(BtC
1d190 75 72 73 6f 72 2c 20 69 50 61 67 65 29 29 3b 0a ursor, iPage));.
1d1a0 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 }../*.** Set the
1d1b0 20 63 61 63 68 65 64 20 72 6f 77 69 64 20 76 61 cached rowid va
1d1c0 6c 75 65 20 6f 66 20 65 76 65 72 79 20 63 75 72 lue of every cur
1d1d0 73 6f 72 20 69 6e 20 74 68 65 20 73 61 6d 65 20 sor in the same
1d1e0 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 2a 2a database file.**
1d1f0 20 61 73 20 70 43 75 72 20 61 6e 64 20 68 61 76 as pCur and hav
1d200 69 6e 67 20 74 68 65 20 73 61 6d 65 20 72 6f 6f ing the same roo
1d210 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 61 73 t page number as
1d220 20 70 43 75 72 2e 20 20 54 68 65 20 76 61 6c 75 pCur. The valu
1d230 65 20 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 69 e is.** set to i
1d240 52 6f 77 69 64 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 6c Rowid..**.** Onl
1d250 79 20 70 6f 73 69 74 69 76 65 20 72 6f 77 69 64 y positive rowid
1d260 20 76 61 6c 75 65 73 20 61 72 65 20 63 6f 6e 73 values are cons
1d270 69 64 65 72 65 64 20 76 61 6c 69 64 20 66 6f 72 idered valid for
1d280 20 74 68 69 73 20 63 61 63 68 65 2e 0a 2a 2a 20 this cache..**
1d290 54 68 65 20 63 61 63 68 65 20 69 73 20 69 6e 69 The cache is ini
1d2a0 74 69 61 6c 69 7a 65 64 20 74 6f 20 7a 65 72 6f tialized to zero
1d2b0 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 61 6e 20 , indicating an
1d2c0 69 6e 76 61 6c 69 64 20 63 61 63 68 65 2e 0a 2a invalid cache..*
1d2d0 2a 20 41 20 62 74 72 65 65 20 77 69 6c 6c 20 77 * A btree will w
1d2e0 6f 72 6b 20 66 69 6e 65 20 77 69 74 68 20 7a 65 ork fine with ze
1d2f0 72 6f 20 6f 72 20 6e 65 67 61 74 69 76 65 20 72 ro or negative r
1d300 6f 77 69 64 73 2e 20 20 57 65 20 6a 75 73 74 20 owids. We just
1d310 63 61 6e 6e 6f 74 0a 2a 2a 20 63 61 63 68 65 20 cannot.** cache
1d320 7a 65 72 6f 20 6f 72 20 6e 65 67 61 74 69 76 65 zero or negative
1d330 20 72 6f 77 69 64 73 2c 20 77 68 69 63 68 20 6d rowids, which m
1d340 65 61 6e 73 20 74 61 62 6c 65 73 20 74 68 61 74 eans tables that
1d350 20 75 73 65 20 7a 65 72 6f 20 6f 72 0a 2a 2a 20 use zero or.**
1d360 6e 65 67 61 74 69 76 65 20 72 6f 77 69 64 73 20 negative rowids
1d370 6d 69 67 68 74 20 72 75 6e 20 61 20 6c 69 74 74 might run a litt
1d380 6c 65 20 73 6c 6f 77 65 72 2e 20 20 42 75 74 20 le slower. But
1d390 69 6e 20 70 72 61 63 74 69 63 65 2c 20 7a 65 72 in practice, zer
1d3a0 6f 0a 2a 2a 20 6f 72 20 6e 65 67 61 74 69 76 65 o.** or negative
1d3b0 20 72 6f 77 69 64 73 20 61 72 65 20 76 65 72 79 rowids are very
1d3c0 20 75 6e 63 6f 6d 6d 6f 6e 20 73 6f 20 74 68 69 uncommon so thi
1d3d0 73 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 s should not be
1d3e0 61 20 70 72 6f 62 6c 65 6d 2e 0a 2a 2f 0a 76 6f a problem..*/.vo
1d3f0 69 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 id sqlite3BtreeS
1d400 65 74 43 61 63 68 65 64 52 6f 77 69 64 28 42 74 etCachedRowid(Bt
1d410 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 73 71 Cursor *pCur, sq
1d420 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 52 6f 77 lite3_int64 iRow
1d430 69 64 29 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 id){. BtCursor
1d440 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70 43 75 72 *p;. for(p=pCur
1d450 2d 3e 70 42 74 2d 3e 70 43 75 72 73 6f 72 3b 20 ->pBt->pCursor;
1d460 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a p; p=p->pNext){.
1d470 20 20 20 20 69 66 28 20 70 2d 3e 70 67 6e 6f 52 if( p->pgnoR
1d480 6f 6f 74 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f 52 oot==pCur->pgnoR
1d490 6f 6f 74 20 29 20 70 2d 3e 63 61 63 68 65 64 52 oot ) p->cachedR
1d4a0 6f 77 69 64 20 3d 20 69 52 6f 77 69 64 3b 0a 20 owid = iRowid;.
1d4b0 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 }. assert( pCu
1d4c0 72 2d 3e 63 61 63 68 65 64 52 6f 77 69 64 3d 3d r->cachedRowid==
1d4d0 69 52 6f 77 69 64 20 29 3b 0a 7d 0a 0a 2f 2a 0a iRowid );.}../*.
1d4e0 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 63 61 ** Return the ca
1d4f0 63 68 65 64 20 72 6f 77 69 64 20 66 6f 72 20 74 ched rowid for t
1d500 68 65 20 67 69 76 65 6e 20 63 75 72 73 6f 72 2e he given cursor.
1d510 20 20 41 20 6e 65 67 61 74 69 76 65 20 6f 72 20 A negative or
1d520 7a 65 72 6f 0a 2a 2a 20 72 65 74 75 72 6e 20 76 zero.** return v
1d530 61 6c 75 65 20 69 6e 64 69 63 61 74 65 73 20 74 alue indicates t
1d540 68 61 74 20 74 68 65 20 72 6f 77 69 64 20 63 61 hat the rowid ca
1d550 63 68 65 20 69 73 20 69 6e 76 61 6c 69 64 20 61 che is invalid a
1d560 6e 64 20 73 68 6f 75 6c 64 20 62 65 0a 2a 2a 20 nd should be.**
1d570 69 67 6e 6f 72 65 64 2e 20 20 49 66 20 74 68 65 ignored. If the
1d580 20 72 6f 77 69 64 20 63 61 63 68 65 20 68 61 73 rowid cache has
1d590 20 6e 65 76 65 72 20 62 65 66 6f 72 65 20 62 65 never before be
1d5a0 65 6e 20 73 65 74 2c 20 74 68 65 6e 20 61 0a 2a en set, then a.*
1d5b0 2a 20 7a 65 72 6f 20 69 73 20 72 65 74 75 72 6e * zero is return
1d5c0 65 64 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 5f 69 ed..*/.sqlite3_i
1d5d0 6e 74 36 34 20 73 71 6c 69 74 65 33 42 74 72 65 nt64 sqlite3Btre
1d5e0 65 47 65 74 43 61 63 68 65 64 52 6f 77 69 64 28 eGetCachedRowid(
1d5f0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b BtCursor *pCur){
1d600 0a 20 20 72 65 74 75 72 6e 20 70 43 75 72 2d 3e . return pCur->
1d610 63 61 63 68 65 64 52 6f 77 69 64 3b 0a 7d 0a 0a cachedRowid;.}..
1d620 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 /*.** Close a cu
1d630 72 73 6f 72 2e 20 20 54 68 65 20 72 65 61 64 20 rsor. The read
1d640 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
1d650 62 61 73 65 20 66 69 6c 65 20 69 73 20 72 65 6c base file is rel
1d660 65 61 73 65 64 0a 2a 2a 20 77 68 65 6e 20 74 68 eased.** when th
1d670 65 20 6c 61 73 74 20 63 75 72 73 6f 72 20 69 73 e last cursor is
1d680 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 69 6e 74 20 closed..*/.int
1d690 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 sqlite3BtreeClos
1d6a0 65 43 75 72 73 6f 72 28 42 74 43 75 72 73 6f 72 eCursor(BtCursor
1d6b0 20 2a 70 43 75 72 29 7b 0a 20 20 42 74 72 65 65 *pCur){. Btree
1d6c0 20 2a 70 42 74 72 65 65 20 3d 20 70 43 75 72 2d *pBtree = pCur-
1d6d0 3e 70 42 74 72 65 65 3b 0a 20 20 69 66 28 20 70 >pBtree;. if( p
1d6e0 42 74 72 65 65 20 29 7b 0a 20 20 20 20 69 6e 74 Btree ){. int
1d6f0 20 69 3b 0a 20 20 20 20 42 74 53 68 61 72 65 64 i;. BtShared
1d700 20 2a 70 42 74 20 3d 20 70 43 75 72 2d 3e 70 42 *pBt = pCur->pB
1d710 74 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 t;. sqlite3Bt
1d720 72 65 65 45 6e 74 65 72 28 70 42 74 72 65 65 29 reeEnter(pBtree)
1d730 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 ;. sqlite3Btr
1d740 65 65 43 6c 65 61 72 43 75 72 73 6f 72 28 70 43 eeClearCursor(pC
1d750 75 72 29 3b 0a 20 20 20 20 69 66 28 20 70 43 75 ur);. if( pCu
1d760 72 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 r->pPrev ){.
1d770 20 20 70 43 75 72 2d 3e 70 50 72 65 76 2d 3e 70 pCur->pPrev->p
1d780 4e 65 78 74 20 3d 20 70 43 75 72 2d 3e 70 4e 65 Next = pCur->pNe
1d790 78 74 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 xt;. }else{.
1d7a0 20 20 20 20 20 70 42 74 2d 3e 70 43 75 72 73 6f pBt->pCurso
1d7b0 72 20 3d 20 70 43 75 72 2d 3e 70 4e 65 78 74 3b r = pCur->pNext;
1d7c0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
1d7d0 43 75 72 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 Cur->pNext ){.
1d7e0 20 20 20 20 70 43 75 72 2d 3e 70 4e 65 78 74 2d pCur->pNext-
1d7f0 3e 70 50 72 65 76 20 3d 20 70 43 75 72 2d 3e 70 >pPrev = pCur->p
1d800 50 72 65 76 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Prev;. }.
1d810 66 6f 72 28 69 3d 30 3b 20 69 3c 3d 70 43 75 72 for(i=0; i<=pCur
1d820 2d 3e 69 50 61 67 65 3b 20 69 2b 2b 29 7b 0a 20 ->iPage; i++){.
1d830 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
1d840 28 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 5d (pCur->apPage[i]
1d850 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 6c );. }. unl
1d860 6f 63 6b 42 74 72 65 65 49 66 55 6e 75 73 65 64 ockBtreeIfUnused
1d870 28 70 42 74 29 3b 0a 20 20 20 20 69 6e 76 61 6c (pBt);. inval
1d880 69 64 61 74 65 4f 76 65 72 66 6c 6f 77 43 61 63 idateOverflowCac
1d890 68 65 28 70 43 75 72 29 3b 0a 20 20 20 20 2f 2a he(pCur);. /*
1d8a0 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 43 sqlite3_free(pC
1d8b0 75 72 29 3b 20 2a 2f 0a 20 20 20 20 73 71 6c 69 ur); */. sqli
1d8c0 74 65 33 42 74 72 65 65 4c 65 61 76 65 28 70 42 te3BtreeLeave(pB
1d8d0 74 72 65 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 tree);. }. ret
1d8e0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
1d8f0 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 ../*.** Make sur
1d900 65 20 74 68 65 20 42 74 43 75 72 73 6f 72 2a 20 e the BtCursor*
1d910 67 69 76 65 6e 20 69 6e 20 74 68 65 20 61 72 67 given in the arg
1d920 75 6d 65 6e 74 20 68 61 73 20 61 20 76 61 6c 69 ument has a vali
1d930 64 0a 2a 2a 20 42 74 43 75 72 73 6f 72 2e 69 6e d.** BtCursor.in
1d940 66 6f 20 73 74 72 75 63 74 75 72 65 2e 20 20 49 fo structure. I
1d950 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c 72 65 f it is not alre
1d960 61 64 79 20 76 61 6c 69 64 2c 20 63 61 6c 6c 0a ady valid, call.
1d970 2a 2a 20 62 74 72 65 65 50 61 72 73 65 43 65 6c ** btreeParseCel
1d980 6c 28 29 20 74 6f 20 66 69 6c 6c 20 69 74 20 69 l() to fill it i
1d990 6e 2e 0a 2a 2a 0a 2a 2a 20 42 74 43 75 72 73 6f n..**.** BtCurso
1d9a0 72 2e 69 6e 66 6f 20 69 73 20 61 20 63 61 63 68 r.info is a cach
1d9b0 65 20 6f 66 20 74 68 65 20 69 6e 66 6f 72 6d 61 e of the informa
1d9c0 74 69 6f 6e 20 69 6e 20 74 68 65 20 63 75 72 72 tion in the curr
1d9d0 65 6e 74 20 63 65 6c 6c 2e 0a 2a 2a 20 55 73 69 ent cell..** Usi
1d9e0 6e 67 20 74 68 69 73 20 63 61 63 68 65 20 72 65 ng this cache re
1d9f0 64 75 63 65 73 20 74 68 65 20 6e 75 6d 62 65 72 duces the number
1da00 20 6f 66 20 63 61 6c 6c 73 20 74 6f 20 62 74 72 of calls to btr
1da10 65 65 50 61 72 73 65 43 65 6c 6c 28 29 2e 0a 2a eeParseCell()..*
1da20 2a 0a 2a 2a 20 32 30 30 37 2d 30 36 2d 32 35 3a *.** 2007-06-25:
1da30 20 20 54 68 65 72 65 20 69 73 20 61 20 62 75 67 There is a bug
1da40 20 69 6e 20 73 6f 6d 65 20 76 65 72 73 69 6f 6e in some version
1da50 73 20 6f 66 20 4d 53 56 43 20 74 68 61 74 20 63 s of MSVC that c
1da60 61 75 73 65 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 ause the.** comp
1da70 69 6c 65 72 20 74 6f 20 63 72 61 73 68 20 77 68 iler to crash wh
1da80 65 6e 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 29 en getCellInfo()
1da90 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 is implemented
1daa0 61 73 20 61 20 6d 61 63 72 6f 2e 0a 2a 2a 20 42 as a macro..** B
1dab0 75 74 20 74 68 65 72 65 20 69 73 20 61 20 6d 65 ut there is a me
1dac0 61 73 75 72 65 61 62 6c 65 20 73 70 65 65 64 20 asureable speed
1dad0 61 64 76 61 6e 74 61 67 65 20 74 6f 20 75 73 69 advantage to usi
1dae0 6e 67 20 74 68 65 20 6d 61 63 72 6f 20 6f 6e 20 ng the macro on
1daf0 67 63 63 0a 2a 2a 20 28 77 68 65 6e 20 6c 65 73 gcc.** (when les
1db00 73 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6d s compiler optim
1db10 69 7a 61 74 69 6f 6e 73 20 6c 69 6b 65 20 2d 4f izations like -O
1db20 73 20 6f 72 20 2d 4f 30 20 61 72 65 20 75 73 65 s or -O0 are use
1db30 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 63 6f 6d d and the.** com
1db40 70 69 6c 65 72 20 69 73 20 6e 6f 74 20 64 6f 69 piler is not doi
1db50 6e 67 20 61 67 72 65 73 73 69 76 65 20 69 6e 6c ng agressive inl
1db60 69 6e 69 6e 67 2e 29 20 20 53 6f 20 77 65 20 75 ining.) So we u
1db70 73 65 20 61 20 72 65 61 6c 20 66 75 6e 63 74 69 se a real functi
1db80 6f 6e 0a 2a 2a 20 66 6f 72 20 4d 53 56 43 20 61 on.** for MSVC a
1db90 6e 64 20 61 20 6d 61 63 72 6f 20 66 6f 72 20 65 nd a macro for e
1dba0 76 65 72 79 74 68 69 6e 67 20 65 6c 73 65 2e 20 verything else.
1dbb0 20 54 69 63 6b 65 74 20 23 32 34 35 37 2e 0a 2a Ticket #2457..*
1dbc0 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 /.#ifndef NDEBUG
1dbd0 0a 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 61 . static void a
1dbe0 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f 28 42 74 ssertCellInfo(Bt
1dbf0 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
1dc00 20 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f CellInfo info
1dc10 3b 0a 20 20 20 20 69 6e 74 20 69 50 61 67 65 20 ;. int iPage
1dc20 3d 20 70 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 = pCur->iPage;.
1dc30 20 20 20 6d 65 6d 73 65 74 28 26 69 6e 66 6f 2c memset(&info,
1dc40 20 30 2c 20 73 69 7a 65 6f 66 28 69 6e 66 6f 29 0, sizeof(info)
1dc50 29 3b 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 );. btreePars
1dc60 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 eCell(pCur->apPa
1dc70 67 65 5b 69 50 61 67 65 5d 2c 20 70 43 75 72 2d ge[iPage], pCur-
1dc80 3e 61 69 49 64 78 5b 69 50 61 67 65 5d 2c 20 26 >aiIdx[iPage], &
1dc90 69 6e 66 6f 29 3b 0a 20 20 20 20 61 73 73 65 72 info);. asser
1dca0 74 28 20 6d 65 6d 63 6d 70 28 26 69 6e 66 6f 2c t( memcmp(&info,
1dcb0 20 26 70 43 75 72 2d 3e 69 6e 66 6f 2c 20 73 69 &pCur->info, si
1dcc0 7a 65 6f 66 28 69 6e 66 6f 29 29 3d 3d 30 20 29 zeof(info))==0 )
1dcd0 3b 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 23 64 ;. }.#else. #d
1dce0 65 66 69 6e 65 20 61 73 73 65 72 74 43 65 6c 6c efine assertCell
1dcf0 49 6e 66 6f 28 78 29 0a 23 65 6e 64 69 66 0a 23 Info(x).#endif.#
1dd00 69 66 64 65 66 20 5f 4d 53 43 5f 56 45 52 0a 20 ifdef _MSC_VER.
1dd10 20 2f 2a 20 55 73 65 20 61 20 72 65 61 6c 20 66 /* Use a real f
1dd20 75 6e 63 74 69 6f 6e 20 69 6e 20 4d 53 56 43 20 unction in MSVC
1dd30 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 62 to work around b
1dd40 75 67 73 20 69 6e 20 74 68 61 74 20 63 6f 6d 70 ugs in that comp
1dd50 69 6c 65 72 2e 20 2a 2f 0a 20 20 73 74 61 74 69 iler. */. stati
1dd60 63 20 76 6f 69 64 20 67 65 74 43 65 6c 6c 49 6e c void getCellIn
1dd70 66 6f 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 fo(BtCursor *pCu
1dd80 72 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 72 r){. if( pCur
1dd90 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 3d 3d 30 20 ->info.nSize==0
1dda0 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 50 61 ){. int iPa
1ddb0 67 65 20 3d 20 70 43 75 72 2d 3e 69 50 61 67 65 ge = pCur->iPage
1ddc0 3b 0a 20 20 20 20 20 20 62 74 72 65 65 50 61 72 ;. btreePar
1ddd0 73 65 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 50 seCell(pCur->apP
1dde0 61 67 65 5b 69 50 61 67 65 5d 2c 70 43 75 72 2d age[iPage],pCur-
1ddf0 3e 61 69 49 64 78 5b 69 50 61 67 65 5d 2c 26 70 >aiIdx[iPage],&p
1de00 43 75 72 2d 3e 69 6e 66 6f 29 3b 0a 20 20 20 20 Cur->info);.
1de10 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 pCur->validNKe
1de20 79 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 y = 1;. }else
1de30 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 43 65 {. assertCe
1de40 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 llInfo(pCur);.
1de50 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 65 20 2f 2a }. }.#else /*
1de60 20 69 66 20 6e 6f 74 20 5f 4d 53 43 5f 56 45 52 if not _MSC_VER
1de70 20 2a 2f 0a 20 20 2f 2a 20 55 73 65 20 61 20 6d */. /* Use a m
1de80 61 63 72 6f 20 69 6e 20 61 6c 6c 20 6f 74 68 65 acro in all othe
1de90 72 20 63 6f 6d 70 69 6c 65 72 73 20 73 6f 20 74 r compilers so t
1dea0 68 61 74 20 74 68 65 20 66 75 6e 63 74 69 6f 6e hat the function
1deb0 20 69 73 20 69 6e 6c 69 6e 65 64 20 2a 2f 0a 23 is inlined */.#
1dec0 64 65 66 69 6e 65 20 67 65 74 43 65 6c 6c 49 6e define getCellIn
1ded0 66 6f 28 70 43 75 72 29 20 20 20 20 20 20 20 20 fo(pCur)
1dee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1def0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1df00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a \.
1df10 20 20 69 66 28 20 70 43 75 72 2d 3e 69 6e 66 6f if( pCur->info
1df20 2e 6e 53 69 7a 65 3d 3d 30 20 29 7b 20 20 20 20 .nSize==0 ){
1df30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1df40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1df50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
1df60 0a 20 20 20 20 69 6e 74 20 69 50 61 67 65 20 3d . int iPage =
1df70 20 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 20 20 pCur->iPage;
1df80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1df90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dfa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dfb0 5c 0a 20 20 20 20 62 74 72 65 65 50 61 72 73 65 \. btreeParse
1dfc0 43 65 6c 6c 28 70 43 75 72 2d 3e 61 70 50 61 67 Cell(pCur->apPag
1dfd0 65 5b 69 50 61 67 65 5d 2c 70 43 75 72 2d 3e 61 e[iPage],pCur->a
1dfe0 69 49 64 78 5b 69 50 61 67 65 5d 2c 26 70 43 75 iIdx[iPage],&pCu
1dff0 72 2d 3e 69 6e 66 6f 29 3b 20 5c 0a 20 20 20 20 r->info); \.
1e000 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 pCur->validNKey
1e010 3d 20 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 1;
1e020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e040 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 7d \. }
1e050 65 6c 73 65 7b 20 20 20 20 20 20 20 20 20 20 20 else{
1e060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e070 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e090 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 \.
1e0a0 20 20 61 73 73 65 72 74 43 65 6c 6c 49 6e 66 6f assertCellInfo
1e0b0 28 70 43 75 72 29 3b 20 20 20 20 20 20 20 20 20 (pCur);
1e0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e0d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e0e0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
1e0f0 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 4d 53 }.#endif /* _MS
1e100 43 5f 56 45 52 20 2a 2f 0a 0a 23 69 66 6e 64 65 C_VER */..#ifnde
1e110 66 20 4e 44 45 42 55 47 20 20 2f 2a 20 54 68 65 f NDEBUG /* The
1e120 20 6e 65 78 74 20 72 6f 75 74 69 6e 65 20 75 73 next routine us
1e130 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 ed only within a
1e140 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
1e150 74 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ts */./*.** Retu
1e160 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 67 rn true if the g
1e170 69 76 65 6e 20 42 74 43 75 72 73 6f 72 20 69 73 iven BtCursor is
1e180 20 76 61 6c 69 64 2e 20 20 41 20 76 61 6c 69 64 valid. A valid
1e190 20 63 75 72 73 6f 72 20 69 73 20 6f 6e 65 0a 2a cursor is one.*
1e1a0 2a 20 74 68 61 74 20 69 73 20 63 75 72 72 65 6e * that is curren
1e1b0 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 tly pointing to
1e1c0 61 20 72 6f 77 20 69 6e 20 61 20 28 6e 6f 6e 2d a row in a (non-
1e1d0 65 6d 70 74 79 29 20 74 61 62 6c 65 2e 0a 2a 2a empty) table..**
1e1e0 20 54 68 69 73 20 69 73 20 61 20 76 65 72 69 66 This is a verif
1e1f0 69 63 61 74 69 6f 6e 20 72 6f 75 74 69 6e 65 20 ication routine
1e200 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 77 69 74 is used only wit
1e210 68 69 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 hin assert() sta
1e220 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 69 6e 74 20 tements..*/.int
1e230 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 sqlite3BtreeCurs
1e240 6f 72 49 73 56 61 6c 69 64 28 42 74 43 75 72 73 orIsValid(BtCurs
1e250 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 72 65 74 or *pCur){. ret
1e260 75 72 6e 20 70 43 75 72 20 26 26 20 70 43 75 72 urn pCur && pCur
1e270 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
1e280 5f 56 41 4c 49 44 3b 0a 7d 0a 23 65 6e 64 69 66 _VALID;.}.#endif
1e290 20 2f 2a 20 4e 44 45 42 55 47 20 2a 2f 0a 0a 2f /* NDEBUG */../
1e2a0 2a 0a 2a 2a 20 53 65 74 20 2a 70 53 69 7a 65 20 *.** Set *pSize
1e2b0 74 6f 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 to the size of t
1e2c0 68 65 20 62 75 66 66 65 72 20 6e 65 65 64 65 64 he buffer needed
1e2d0 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 76 61 6c to hold the val
1e2e0 75 65 20 6f 66 0a 2a 2a 20 74 68 65 20 6b 65 79 ue of.** the key
1e2f0 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 for the current
1e300 20 65 6e 74 72 79 2e 20 20 49 66 20 74 68 65 20 entry. If the
1e310 63 75 72 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f cursor is not po
1e320 69 6e 74 69 6e 67 0a 2a 2a 20 74 6f 20 61 20 76 inting.** to a v
1e330 61 6c 69 64 20 65 6e 74 72 79 2c 20 2a 70 53 69 alid entry, *pSi
1e340 7a 65 20 69 73 20 73 65 74 20 74 6f 20 30 2e 20 ze is set to 0.
1e350 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 74 61 62 .**.** For a tab
1e360 6c 65 20 77 69 74 68 20 74 68 65 20 49 4e 54 4b le with the INTK
1e370 45 59 20 66 6c 61 67 20 73 65 74 2c 20 74 68 69 EY flag set, thi
1e380 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75 72 6e s routine return
1e390 73 20 74 68 65 20 6b 65 79 0a 2a 2a 20 69 74 73 s the key.** its
1e3a0 65 6c 66 2c 20 6e 6f 74 20 74 68 65 20 6e 75 6d elf, not the num
1e3b0 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
1e3c0 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 the key..**.** T
1e3d0 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 70 he caller must p
1e3e0 6f 73 69 74 69 6f 6e 20 74 68 65 20 63 75 72 73 osition the curs
1e3f0 6f 72 20 70 72 69 6f 72 20 74 6f 20 69 6e 76 6f or prior to invo
1e400 6b 69 6e 67 20 74 68 69 73 20 72 6f 75 74 69 6e king this routin
1e410 65 2e 0a 2a 2a 20 0a 2a 2a 20 54 68 69 73 20 72 e..** .** This r
1e420 6f 75 74 69 6e 65 20 63 61 6e 6e 6f 74 20 66 61 outine cannot fa
1e430 69 6c 2e 20 20 49 74 20 61 6c 77 61 79 73 20 72 il. It always r
1e440 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b eturns SQLITE_OK
1e450 2e 20 20 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 . .*/.int sqlit
1e460 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28 42 e3BtreeKeySize(B
1e470 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 tCursor *pCur, i
1e480 36 34 20 2a 70 53 69 7a 65 29 7b 0a 20 20 61 73 64 *pSize){. as
1e490 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c 64 sert( cursorHold
1e4a0 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b 0a sMutex(pCur) );.
1e4b0 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
1e4c0 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 49 eState==CURSOR_I
1e4d0 4e 56 41 4c 49 44 20 7c 7c 20 70 43 75 72 2d 3e NVALID || pCur->
1e4e0 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
1e4f0 41 4c 49 44 20 29 3b 0a 20 20 69 66 28 20 70 43 ALID );. if( pC
1e500 75 72 2d 3e 65 53 74 61 74 65 21 3d 43 55 52 53 ur->eState!=CURS
1e510 4f 52 5f 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 OR_VALID ){.
1e520 2a 70 53 69 7a 65 20 3d 20 30 3b 0a 20 20 7d 65 *pSize = 0;. }e
1e530 6c 73 65 7b 0a 20 20 20 20 67 65 74 43 65 6c 6c lse{. getCell
1e540 49 6e 66 6f 28 70 43 75 72 29 3b 0a 20 20 20 20 Info(pCur);.
1e550 2a 70 53 69 7a 65 20 3d 20 70 43 75 72 2d 3e 69 *pSize = pCur->i
1e560 6e 66 6f 2e 6e 4b 65 79 3b 0a 20 20 7d 0a 20 20 nfo.nKey;. }.
1e570 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
1e580 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 2a ;.}../*.** Set *
1e590 70 53 69 7a 65 20 74 6f 20 74 68 65 20 6e 75 6d pSize to the num
1e5a0 62 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 ber of bytes of
1e5b0 64 61 74 61 20 69 6e 20 74 68 65 20 65 6e 74 72 data in the entr
1e5c0 79 20 74 68 65 0a 2a 2a 20 63 75 72 73 6f 72 20 y the.** cursor
1e5d0 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 73 currently points
1e5e0 20 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 to..**.** The c
1e5f0 61 6c 6c 65 72 20 6d 75 73 74 20 67 75 61 72 61 aller must guara
1e600 6e 74 65 65 20 74 68 61 74 20 74 68 65 20 63 75 ntee that the cu
1e610 72 73 6f 72 20 69 73 20 70 6f 69 6e 74 69 6e 67 rsor is pointing
1e620 20 74 6f 20 61 20 6e 6f 6e 2d 4e 55 4c 4c 0a 2a to a non-NULL.*
1e630 2a 20 76 61 6c 69 64 20 65 6e 74 72 79 2e 20 20 * valid entry.
1e640 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words,
1e650 74 68 65 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 the calling proc
1e660 65 64 75 72 65 20 6d 75 73 74 20 67 75 61 72 61 edure must guara
1e670 6e 74 65 65 0a 2a 2a 20 74 68 61 74 20 74 68 65 ntee.** that the
1e680 20 63 75 72 73 6f 72 20 68 61 73 20 43 75 72 73 cursor has Curs
1e690 6f 72 2e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f or.eState==CURSO
1e6a0 52 5f 56 41 4c 49 44 2e 0a 2a 2a 0a 2a 2a 20 46 R_VALID..**.** F
1e6b0 61 69 6c 75 72 65 20 69 73 20 6e 6f 74 20 70 6f ailure is not po
1e6c0 73 73 69 62 6c 65 2e 20 20 54 68 69 73 20 66 75 ssible. This fu
1e6d0 6e 63 74 69 6f 6e 20 61 6c 77 61 79 73 20 72 65 nction always re
1e6e0 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e turns SQLITE_OK.
1e6f0 0a 2a 2a 20 49 74 20 6d 69 67 68 74 20 6a 75 73 .** It might jus
1e700 74 20 61 73 20 77 65 6c 6c 20 62 65 20 61 20 70 t as well be a p
1e710 72 6f 63 65 64 75 72 65 20 28 72 65 74 75 72 6e rocedure (return
1e720 69 6e 67 20 76 6f 69 64 29 20 62 75 74 20 77 65 ing void) but we
1e730 20 63 6f 6e 74 69 6e 75 65 0a 2a 2a 20 74 6f 20 continue.** to
1e740 72 65 74 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 return an intege
1e750 72 20 72 65 73 75 6c 74 20 63 6f 64 65 20 66 6f r result code fo
1e760 72 20 68 69 73 74 6f 72 69 63 61 6c 20 72 65 61 r historical rea
1e770 73 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c sons..*/.int sql
1e780 69 74 65 33 42 74 72 65 65 44 61 74 61 53 69 7a ite3BtreeDataSiz
1e790 65 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 e(BtCursor *pCur
1e7a0 2c 20 75 33 32 20 2a 70 53 69 7a 65 29 7b 0a 20 , u32 *pSize){.
1e7b0 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
1e7c0 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
1e7d0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 );. assert( pCu
1e7e0 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f r->eState==CURSO
1e7f0 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 67 65 74 R_VALID );. get
1e800 43 65 6c 6c 49 6e 66 6f 28 70 43 75 72 29 3b 0a CellInfo(pCur);.
1e810 20 20 2a 70 53 69 7a 65 20 3d 20 70 43 75 72 2d *pSize = pCur-
1e820 3e 69 6e 66 6f 2e 6e 44 61 74 61 3b 0a 20 20 72 >info.nData;. r
1e830 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
1e840 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 .}../*.** Given
1e850 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 the page number
1e860 6f 66 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 of an overflow p
1e870 61 67 65 20 69 6e 20 74 68 65 20 64 61 74 61 62 age in the datab
1e880 61 73 65 20 28 70 61 72 61 6d 65 74 65 72 0a 2a ase (parameter.*
1e890 2a 20 6f 76 66 6c 29 2c 20 74 68 69 73 20 66 75 * ovfl), this fu
1e8a0 6e 63 74 69 6f 6e 20 66 69 6e 64 73 20 74 68 65 nction finds the
1e8b0 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 page number of
1e8c0 74 68 65 20 6e 65 78 74 20 70 61 67 65 20 69 6e the next page in
1e8d0 20 74 68 65 20 0a 2a 2a 20 6c 69 6e 6b 65 64 20 the .** linked
1e8e0 6c 69 73 74 20 6f 66 20 6f 76 65 72 66 6c 6f 77 list of overflow
1e8f0 20 70 61 67 65 73 2e 20 49 66 20 70 6f 73 73 69 pages. If possi
1e900 62 6c 65 2c 20 69 74 20 75 73 65 73 20 74 68 65 ble, it uses the
1e910 20 61 75 74 6f 2d 76 61 63 75 75 6d 0a 2a 2a 20 auto-vacuum.**
1e920 70 6f 69 6e 74 65 72 2d 6d 61 70 20 64 61 74 61 pointer-map data
1e930 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 61 64 instead of read
1e940 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 ing the content
1e950 6f 66 20 70 61 67 65 20 6f 76 66 6c 20 74 6f 20 of page ovfl to
1e960 64 6f 20 73 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 do so. .**.** If
1e970 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
1e980 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
1e990 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
1e9a0 64 2e 20 4f 74 68 65 72 77 69 73 65 3a 0a 2a 2a d. Otherwise:.**
1e9b0 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d .** The page num
1e9c0 62 65 72 20 6f 66 20 74 68 65 20 6e 65 78 74 20 ber of the next
1e9d0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e overflow page in
1e9e0 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 the linked list
1e9f0 20 69 73 20 0a 2a 2a 20 77 72 69 74 74 65 6e 20 is .** written
1ea00 74 6f 20 2a 70 50 67 6e 6f 4e 65 78 74 2e 20 49 to *pPgnoNext. I
1ea10 66 20 70 61 67 65 20 6f 76 66 6c 20 69 73 20 74 f page ovfl is t
1ea20 68 65 20 6c 61 73 74 20 70 61 67 65 20 69 6e 20 he last page in
1ea30 69 74 73 20 6c 69 6e 6b 65 64 20 0a 2a 2a 20 6c its linked .** l
1ea40 69 73 74 2c 20 2a 70 50 67 6e 6f 4e 65 78 74 20 ist, *pPgnoNext
1ea50 69 73 20 73 65 74 20 74 6f 20 7a 65 72 6f 2e 20 is set to zero.
1ea60 0a 2a 2a 0a 2a 2a 20 49 66 20 70 70 50 61 67 65 .**.** If ppPage
1ea70 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 61 6e is not NULL, an
1ea80 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f d a reference to
1ea90 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f 62 6a the MemPage obj
1eaa0 65 63 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e ect correspondin
1eab0 67 0a 2a 2a 20 74 6f 20 70 61 67 65 20 6e 75 6d g.** to page num
1eac0 62 65 72 20 70 4f 76 66 6c 20 77 61 73 20 6f 62 ber pOvfl was ob
1ead0 74 61 69 6e 65 64 2c 20 74 68 65 6e 20 2a 70 70 tained, then *pp
1eae0 50 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 70 Page is set to p
1eaf0 6f 69 6e 74 20 74 6f 20 74 68 61 74 0a 2a 2a 20 oint to that.**
1eb00 72 65 66 65 72 65 6e 63 65 2e 20 49 74 20 69 73 reference. It is
1eb10 20 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c the responsibil
1eb20 69 74 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 ity of the calle
1eb30 72 20 74 6f 20 63 61 6c 6c 20 72 65 6c 65 61 73 r to call releas
1eb40 65 50 61 67 65 28 29 0a 2a 2a 20 6f 6e 20 2a 70 ePage().** on *p
1eb50 70 50 61 67 65 20 74 6f 20 66 72 65 65 20 74 68 pPage to free th
1eb60 65 20 72 65 66 65 72 65 6e 63 65 2e 20 49 6e 20 e reference. In
1eb70 6e 6f 20 72 65 66 65 72 65 6e 63 65 20 77 61 73 no reference was
1eb80 20 6f 62 74 61 69 6e 65 64 20 28 62 65 63 61 75 obtained (becau
1eb90 73 65 0a 2a 2a 20 74 68 65 20 70 6f 69 6e 74 65 se.** the pointe
1eba0 72 2d 6d 61 70 20 77 61 73 20 75 73 65 64 20 74 r-map was used t
1ebb0 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 76 61 6c o obtain the val
1ebc0 75 65 20 66 6f 72 20 2a 70 50 67 6e 6f 4e 65 78 ue for *pPgnoNex
1ebd0 74 29 2c 20 74 68 65 6e 0a 2a 2a 20 2a 70 70 50 t), then.** *ppP
1ebe0 61 67 65 20 69 73 20 73 65 74 20 74 6f 20 7a 65 age is set to ze
1ebf0 72 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ro..*/.static in
1ec00 74 20 67 65 74 4f 76 65 72 66 6c 6f 77 50 61 67 t getOverflowPag
1ec10 65 28 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 e(. BtShared *p
1ec20 42 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 Bt,
1ec30 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 /* The databas
1ec40 65 20 66 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f e file */. Pgno
1ec50 20 6f 76 66 6c 2c 20 20 20 20 20 20 20 20 20 20 ovfl,
1ec60 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 /* Curr
1ec70 65 6e 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 ent overflow pag
1ec80 65 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 4d 65 e number */. Me
1ec90 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 2c 20 mPage **ppPage,
1eca0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 /* OU
1ecb0 54 3a 20 4d 65 6d 50 61 67 65 20 68 61 6e 64 6c T: MemPage handl
1ecc0 65 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 e (may be NULL)
1ecd0 2a 2f 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f */. Pgno *pPgno
1ece0 4e 65 78 74 20 20 20 20 20 20 20 20 20 20 20 20 Next
1ecf0 20 20 2f 2a 20 4f 55 54 3a 20 4e 65 78 74 20 6f /* OUT: Next o
1ed00 76 65 72 66 6c 6f 77 20 70 61 67 65 20 6e 75 6d verflow page num
1ed10 62 65 72 20 2a 2f 0a 29 7b 0a 20 20 50 67 6e 6f ber */.){. Pgno
1ed20 20 6e 65 78 74 20 3d 20 30 3b 0a 20 20 4d 65 6d next = 0;. Mem
1ed30 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 30 3b Page *pPage = 0;
1ed40 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
1ed50 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 TE_OK;.. assert
1ed60 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
1ed70 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 held(pBt->mutex)
1ed80 20 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 67 );. assert(pPg
1ed90 6e 6f 4e 65 78 74 29 3b 0a 0a 23 69 66 6e 64 65 noNext);..#ifnde
1eda0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
1edb0 54 4f 56 41 43 55 55 4d 0a 20 20 2f 2a 20 54 72 TOVACUUM. /* Tr
1edc0 79 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6e 65 y to find the ne
1edd0 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 20 6f xt page in the o
1ede0 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 75 73 69 verflow list usi
1edf0 6e 67 20 74 68 65 0a 20 20 2a 2a 20 61 75 74 6f ng the. ** auto
1ee00 76 61 63 75 75 6d 20 70 6f 69 6e 74 65 72 2d 6d vacuum pointer-m
1ee10 61 70 20 70 61 67 65 73 2e 20 47 75 65 73 73 20 ap pages. Guess
1ee20 74 68 61 74 20 74 68 65 20 6e 65 78 74 20 70 61 that the next pa
1ee30 67 65 20 69 6e 20 0a 20 20 2a 2a 20 74 68 65 20 ge in . ** the
1ee40 6f 76 65 72 66 6c 6f 77 20 6c 69 73 74 20 69 73 overflow list is
1ee50 20 70 61 67 65 20 6e 75 6d 62 65 72 20 28 6f 76 page number (ov
1ee60 66 6c 2b 31 29 2e 20 49 66 20 74 68 61 74 20 67 fl+1). If that g
1ee70 75 65 73 73 20 74 75 72 6e 73 20 0a 20 20 2a 2a uess turns . **
1ee80 20 6f 75 74 20 74 6f 20 62 65 20 77 72 6f 6e 67 out to be wrong
1ee90 2c 20 66 61 6c 6c 20 62 61 63 6b 20 74 6f 20 6c , fall back to l
1eea0 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 20 oading the data
1eeb0 6f 66 20 70 61 67 65 20 0a 20 20 2a 2a 20 6e 75 of page . ** nu
1eec0 6d 62 65 72 20 6f 76 66 6c 20 74 6f 20 64 65 74 mber ovfl to det
1eed0 65 72 6d 69 6e 65 20 74 68 65 20 6e 65 78 74 20 ermine the next
1eee0 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 20 20 2a page number.. *
1eef0 2f 0a 20 20 69 66 28 20 70 42 74 2d 3e 61 75 74 /. if( pBt->aut
1ef00 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 50 oVacuum ){. P
1ef10 67 6e 6f 20 70 67 6e 6f 3b 0a 20 20 20 20 50 67 gno pgno;. Pg
1ef20 6e 6f 20 69 47 75 65 73 73 20 3d 20 6f 76 66 6c no iGuess = ovfl
1ef30 2b 31 3b 0a 20 20 20 20 75 38 20 65 54 79 70 65 +1;. u8 eType
1ef40 3b 0a 0a 20 20 20 20 77 68 69 6c 65 28 20 50 54 ;.. while( PT
1ef50 52 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c RMAP_ISPAGE(pBt,
1ef60 20 69 47 75 65 73 73 29 20 7c 7c 20 69 47 75 65 iGuess) || iGue
1ef70 73 73 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 ss==PENDING_BYTE
1ef80 5f 50 41 47 45 28 70 42 74 29 20 29 7b 0a 20 20 _PAGE(pBt) ){.
1ef90 20 20 20 20 69 47 75 65 73 73 2b 2b 3b 0a 20 20 iGuess++;.
1efa0 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 69 47 75 }.. if( iGu
1efb0 65 73 73 3c 3d 62 74 72 65 65 50 61 67 65 63 6f ess<=btreePageco
1efc0 75 6e 74 28 70 42 74 29 20 29 7b 0a 20 20 20 20 unt(pBt) ){.
1efd0 20 20 72 63 20 3d 20 70 74 72 6d 61 70 47 65 74 rc = ptrmapGet
1efe0 28 70 42 74 2c 20 69 47 75 65 73 73 2c 20 26 65 (pBt, iGuess, &e
1eff0 54 79 70 65 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 Type, &pgno);.
1f000 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
1f010 54 45 5f 4f 4b 20 26 26 20 65 54 79 70 65 3d 3d TE_OK && eType==
1f020 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f 57 32 PTRMAP_OVERFLOW2
1f030 20 26 26 20 70 67 6e 6f 3d 3d 6f 76 66 6c 20 29 && pgno==ovfl )
1f040 7b 0a 20 20 20 20 20 20 20 20 6e 65 78 74 20 3d {. next =
1f050 20 69 47 75 65 73 73 3b 0a 20 20 20 20 20 20 20 iGuess;.
1f060 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f 4e rc = SQLITE_DON
1f070 45 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d E;. }. }
1f080 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 61 . }.#endif.. a
1f090 73 73 65 72 74 28 20 6e 65 78 74 3d 3d 30 20 7c ssert( next==0 |
1f0a0 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e | rc==SQLITE_DON
1f0b0 45 20 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 E );. if( rc==S
1f0c0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1f0d0 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 rc = btreeGetPag
1f0e0 65 28 70 42 74 2c 20 6f 76 66 6c 2c 20 26 70 50 e(pBt, ovfl, &pP
1f0f0 61 67 65 2c 20 30 29 3b 0a 20 20 20 20 61 73 73 age, 0);. ass
1f100 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f ert( rc==SQLITE_
1f110 4f 4b 20 7c 7c 20 70 50 61 67 65 3d 3d 30 20 29 OK || pPage==0 )
1f120 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
1f130 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1f140 20 6e 65 78 74 20 3d 20 67 65 74 34 62 79 74 65 next = get4byte
1f150 28 70 50 61 67 65 2d 3e 61 44 61 74 61 29 3b 0a (pPage->aData);.
1f160 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2a 70 50 }. }.. *pP
1f170 67 6e 6f 4e 65 78 74 20 3d 20 6e 65 78 74 3b 0a gnoNext = next;.
1f180 20 20 69 66 28 20 70 70 50 61 67 65 20 29 7b 0a if( ppPage ){.
1f190 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 50 *ppPage = pP
1f1a0 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 age;. }else{.
1f1b0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
1f1c0 61 67 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 age);. }. retu
1f1d0 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 44 rn (rc==SQLITE_D
1f1e0 4f 4e 45 20 3f 20 53 51 4c 49 54 45 5f 4f 4b 20 ONE ? SQLITE_OK
1f1f0 3a 20 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 : rc);.}../*.**
1f200 43 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 61 Copy data from a
1f210 20 62 75 66 66 65 72 20 74 6f 20 61 20 70 61 67 buffer to a pag
1f220 65 2c 20 6f 72 20 66 72 6f 6d 20 61 20 70 61 67 e, or from a pag
1f230 65 20 74 6f 20 61 20 62 75 66 66 65 72 2e 0a 2a e to a buffer..*
1f240 2a 0a 2a 2a 20 70 50 61 79 6c 6f 61 64 20 69 73 *.** pPayload is
1f250 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 64 61 a pointer to da
1f260 74 61 20 73 74 6f 72 65 64 20 6f 6e 20 64 61 74 ta stored on dat
1f270 61 62 61 73 65 20 70 61 67 65 20 70 44 62 50 61 abase page pDbPa
1f280 67 65 2e 0a 2a 2a 20 49 66 20 61 72 67 75 6d 65 ge..** If argume
1f290 6e 74 20 65 4f 70 20 69 73 20 66 61 6c 73 65 2c nt eOp is false,
1f2a0 20 74 68 65 6e 20 6e 42 79 74 65 20 62 79 74 65 then nByte byte
1f2b0 73 20 6f 66 20 64 61 74 61 20 61 72 65 20 63 6f s of data are co
1f2c0 70 69 65 64 0a 2a 2a 20 66 72 6f 6d 20 70 50 61 pied.** from pPa
1f2d0 79 6c 6f 61 64 20 74 6f 20 74 68 65 20 62 75 66 yload to the buf
1f2e0 66 65 72 20 70 6f 69 6e 74 65 64 20 61 74 20 62 fer pointed at b
1f2f0 79 20 70 42 75 66 2e 20 49 66 20 65 4f 70 20 69 y pBuf. If eOp i
1f300 73 20 74 72 75 65 2c 0a 2a 2a 20 74 68 65 6e 20 s true,.** then
1f310 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
1f320 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e e() is called on
1f330 20 70 44 62 50 61 67 65 20 61 6e 64 20 6e 42 79 pDbPage and nBy
1f340 74 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 20 64 te bytes.** of d
1f350 61 74 61 20 61 72 65 20 63 6f 70 69 65 64 20 66 ata are copied f
1f360 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 20 70 rom the buffer p
1f370 42 75 66 20 74 6f 20 70 50 61 79 6c 6f 61 64 2e Buf to pPayload.
1f380 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b .**.** SQLITE_OK
1f390 20 69 73 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 is returned on
1f3a0 73 75 63 63 65 73 73 2c 20 6f 74 68 65 72 77 69 success, otherwi
1f3b0 73 65 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 se an error code
1f3c0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1f3d0 63 6f 70 79 50 61 79 6c 6f 61 64 28 0a 20 20 76 copyPayload(. v
1f3e0 6f 69 64 20 2a 70 50 61 79 6c 6f 61 64 2c 20 20 oid *pPayload,
1f3f0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e /* Poin
1f400 74 65 72 20 74 6f 20 70 61 67 65 20 64 61 74 61 ter to page data
1f410 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 66 */. void *pBuf
1f420 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
1f430 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 62 75 /* Pointer to bu
1f440 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 ffer */. int nB
1f450 79 74 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 yte,
1f460 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1f470 20 62 79 74 65 73 20 74 6f 20 63 6f 70 79 20 2a bytes to copy *
1f480 2f 0a 20 20 69 6e 74 20 65 4f 70 2c 20 20 20 20 /. int eOp,
1f490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f4a0 20 30 20 2d 3e 20 63 6f 70 79 20 66 72 6f 6d 20 0 -> copy from
1f4b0 70 61 67 65 2c 20 31 20 2d 3e 20 63 6f 70 79 20 page, 1 -> copy
1f4c0 74 6f 20 70 61 67 65 20 2a 2f 0a 20 20 44 62 50 to page */. DbP
1f4d0 61 67 65 20 2a 70 44 62 50 61 67 65 20 20 20 20 age *pDbPage
1f4e0 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 /* Page c
1f4f0 6f 6e 74 61 69 6e 69 6e 67 20 70 50 61 79 6c 6f ontaining pPaylo
1f500 61 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 65 ad */.){. if( e
1f510 4f 70 20 29 7b 0a 20 20 20 20 2f 2a 20 43 6f 70 Op ){. /* Cop
1f520 79 20 64 61 74 61 20 66 72 6f 6d 20 62 75 66 66 y data from buff
1f530 65 72 20 74 6f 20 70 61 67 65 20 28 61 20 77 72 er to page (a wr
1f540 69 74 65 20 6f 70 65 72 61 74 69 6f 6e 29 20 2a ite operation) *
1f550 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 /. int rc = s
1f560 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
1f570 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 69 (pDbPage);. i
1f580 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1f590 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1f5a0 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d rc;. }. m
1f5b0 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 64 2c 20 emcpy(pPayload,
1f5c0 70 42 75 66 2c 20 6e 42 79 74 65 29 3b 0a 20 20 pBuf, nByte);.
1f5d0 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 43 6f }else{. /* Co
1f5e0 70 79 20 64 61 74 61 20 66 72 6f 6d 20 70 61 67 py data from pag
1f5f0 65 20 74 6f 20 62 75 66 66 65 72 20 28 61 20 72 e to buffer (a r
1f600 65 61 64 20 6f 70 65 72 61 74 69 6f 6e 29 20 2a ead operation) *
1f610 2f 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 42 75 /. memcpy(pBu
1f620 66 2c 20 70 50 61 79 6c 6f 61 64 2c 20 6e 42 79 f, pPayload, nBy
1f630 74 65 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 te);. }. retur
1f640 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a n SQLITE_OK;.}..
1f650 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
1f660 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 72 ion is used to r
1f670 65 61 64 20 6f 72 20 6f 76 65 72 77 72 69 74 65 ead or overwrite
1f680 20 70 61 79 6c 6f 61 64 20 69 6e 66 6f 72 6d 61 payload informa
1f690 74 69 6f 6e 0a 2a 2a 20 66 6f 72 20 74 68 65 20 tion.** for the
1f6a0 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 20 70 entry that the p
1f6b0 43 75 72 20 63 75 72 73 6f 72 20 69 73 20 70 6f Cur cursor is po
1f6c0 69 6e 74 69 6e 67 20 74 6f 2e 20 49 66 20 74 68 inting to. If th
1f6d0 65 20 65 4f 70 0a 2a 2a 20 70 61 72 61 6d 65 74 e eOp.** paramet
1f6e0 65 72 20 69 73 20 30 2c 20 74 68 69 73 20 69 73 er is 0, this is
1f6f0 20 61 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f a read operatio
1f700 6e 20 28 64 61 74 61 20 63 6f 70 69 65 64 20 69 n (data copied i
1f710 6e 74 6f 0a 2a 2a 20 62 75 66 66 65 72 20 70 42 nto.** buffer pB
1f720 75 66 29 2e 20 49 66 20 69 74 20 69 73 20 6e 6f uf). If it is no
1f730 6e 2d 7a 65 72 6f 2c 20 61 20 77 72 69 74 65 20 n-zero, a write
1f740 28 64 61 74 61 20 63 6f 70 69 65 64 20 66 72 6f (data copied fro
1f750 6d 0a 2a 2a 20 62 75 66 66 65 72 20 70 42 75 66 m.** buffer pBuf
1f760 29 2e 0a 2a 2a 0a 2a 2a 20 41 20 74 6f 74 61 6c )..**.** A total
1f770 20 6f 66 20 22 61 6d 74 22 20 62 79 74 65 73 20 of "amt" bytes
1f780 61 72 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 are read or writ
1f790 74 65 6e 20 62 65 67 69 6e 6e 69 6e 67 20 61 74 ten beginning at
1f7a0 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 20 44 61 "offset"..** Da
1f7b0 74 61 20 69 73 20 72 65 61 64 20 74 6f 20 6f 72 ta is read to or
1f7c0 20 66 72 6f 6d 20 74 68 65 20 62 75 66 66 65 72 from the buffer
1f7d0 20 70 42 75 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 pBuf..**.** The
1f7e0 20 63 6f 6e 74 65 6e 74 20 62 65 69 6e 67 20 72 content being r
1f7f0 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 20 6d ead or written m
1f800 69 67 68 74 20 61 70 70 65 61 72 20 6f 6e 20 74 ight appear on t
1f810 68 65 20 6d 61 69 6e 20 70 61 67 65 0a 2a 2a 20 he main page.**
1f820 6f 72 20 62 65 20 73 63 61 74 74 65 72 65 64 20 or be scattered
1f830 6f 75 74 20 6f 6e 20 6d 75 6c 74 69 70 6c 65 20 out on multiple
1f840 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2e 0a overflow pages..
1f850 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 42 74 43 **.** If the BtC
1f860 75 72 73 6f 72 2e 69 73 49 6e 63 72 62 6c 6f 62 ursor.isIncrblob
1f870 48 61 6e 64 6c 65 20 66 6c 61 67 20 69 73 20 73 Handle flag is s
1f880 65 74 2c 20 61 6e 64 20 74 68 65 20 63 75 72 72 et, and the curr
1f890 65 6e 74 0a 2a 2a 20 63 75 72 73 6f 72 20 65 6e ent.** cursor en
1f8a0 74 72 79 20 75 73 65 73 20 6f 6e 65 20 6f 72 20 try uses one or
1f8b0 6d 6f 72 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 more overflow pa
1f8c0 67 65 73 2c 20 74 68 69 73 20 66 75 6e 63 74 69 ges, this functi
1f8d0 6f 6e 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 73 20 on.** allocates
1f8e0 73 70 61 63 65 20 66 6f 72 20 61 6e 64 20 6c 61 space for and la
1f8f0 7a 69 6c 79 20 70 6f 70 6c 75 61 74 65 73 20 74 zily popluates t
1f900 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
1f910 2d 6c 69 73 74 20 0a 2a 2a 20 63 61 63 68 65 20 -list .** cache
1f920 61 72 72 61 79 20 28 42 74 43 75 72 73 6f 72 2e array (BtCursor.
1f930 61 4f 76 65 72 66 6c 6f 77 29 2e 20 53 75 62 73 aOverflow). Subs
1f940 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 75 73 65 equent calls use
1f950 20 74 68 69 73 0a 2a 2a 20 63 61 63 68 65 20 74 this.** cache t
1f960 6f 20 6d 61 6b 65 20 73 65 65 6b 69 6e 67 20 74 o make seeking t
1f970 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 6f o the supplied o
1f980 66 66 73 65 74 20 6d 6f 72 65 20 65 66 66 69 63 ffset more effic
1f990 69 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4f 6e 63 65 ient..**.** Once
1f9a0 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 an overflow pag
1f9b0 65 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 73 e-list cache has
1f9c0 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 2c been allocated,
1f9d0 20 69 74 20 6d 61 79 20 62 65 0a 2a 2a 20 69 6e it may be.** in
1f9e0 76 61 6c 69 64 61 74 65 64 20 69 66 20 73 6f 6d validated if som
1f9f0 65 20 6f 74 68 65 72 20 63 75 72 73 6f 72 20 77 e other cursor w
1fa00 72 69 74 65 73 20 74 6f 20 74 68 65 20 73 61 6d rites to the sam
1fa10 65 20 74 61 62 6c 65 2c 20 6f 72 20 69 66 0a 2a e table, or if.*
1fa20 2a 20 74 68 65 20 63 75 72 73 6f 72 20 69 73 20 * the cursor is
1fa30 6d 6f 76 65 64 20 74 6f 20 61 20 64 69 66 66 65 moved to a diffe
1fa40 72 65 6e 74 20 72 6f 77 2e 20 41 64 64 69 74 69 rent row. Additi
1fa50 6f 6e 61 6c 6c 79 2c 20 69 6e 20 61 75 74 6f 2d onally, in auto-
1fa60 76 61 63 75 75 6d 0a 2a 2a 20 6d 6f 64 65 2c 20 vacuum.** mode,
1fa70 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 76 the following ev
1fa80 65 6e 74 73 20 6d 61 79 20 69 6e 76 61 6c 69 64 ents may invalid
1fa90 61 74 65 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 ate an overflow
1faa0 70 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 2e page-list cache.
1fab0 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 6e 20 69 6e .**.** * An in
1fac0 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d cremental vacuum
1fad0 2c 0a 2a 2a 20 20 20 2a 20 41 20 63 6f 6d 6d 69 ,.** * A commi
1fae0 74 20 69 6e 20 61 75 74 6f 5f 76 61 63 75 75 6d t in auto_vacuum
1faf0 3d 22 66 75 6c 6c 22 20 6d 6f 64 65 2c 0a 2a 2a ="full" mode,.**
1fb00 20 20 20 2a 20 43 72 65 61 74 69 6e 67 20 61 20 * Creating a
1fb10 74 61 62 6c 65 20 28 6d 61 79 20 72 65 71 75 69 table (may requi
1fb20 72 65 20 6d 6f 76 69 6e 67 20 61 6e 20 6f 76 65 re moving an ove
1fb30 72 66 6c 6f 77 20 70 61 67 65 29 2e 0a 2a 2f 0a rflow page)..*/.
1fb40 73 74 61 74 69 63 20 69 6e 74 20 61 63 63 65 73 static int acces
1fb50 73 50 61 79 6c 6f 61 64 28 0a 20 20 42 74 43 75 sPayload(. BtCu
1fb60 72 73 6f 72 20 2a 70 43 75 72 2c 20 20 20 20 20 rsor *pCur,
1fb70 20 2f 2a 20 43 75 72 73 6f 72 20 70 6f 69 6e 74 /* Cursor point
1fb80 69 6e 67 20 74 6f 20 65 6e 74 72 79 20 74 6f 20 ing to entry to
1fb90 72 65 61 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 read from */. u
1fba0 33 32 20 6f 66 66 73 65 74 2c 20 20 20 20 20 20 32 offset,
1fbb0 20 20 20 20 2f 2a 20 42 65 67 69 6e 20 72 65 61 /* Begin rea
1fbc0 64 69 6e 67 20 74 68 69 73 20 66 61 72 20 69 6e ding this far in
1fbd0 74 6f 20 70 61 79 6c 6f 61 64 20 2a 2f 0a 20 20 to payload */.
1fbe0 75 33 32 20 61 6d 74 2c 20 20 20 20 20 20 20 20 u32 amt,
1fbf0 20 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 69 /* Read thi
1fc00 73 20 6d 61 6e 79 20 62 79 74 65 73 20 2a 2f 0a s many bytes */.
1fc10 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
1fc20 2a 70 42 75 66 2c 20 2f 2a 20 57 72 69 74 65 20 *pBuf, /* Write
1fc30 74 68 65 20 62 79 74 65 73 20 69 6e 74 6f 20 74 the bytes into t
1fc40 68 69 73 20 62 75 66 66 65 72 20 2a 2f 20 0a 20 his buffer */ .
1fc50 20 69 6e 74 20 65 4f 70 20 20 20 20 20 20 20 20 int eOp
1fc60 20 20 20 20 20 20 2f 2a 20 7a 65 72 6f 20 74 6f /* zero to
1fc70 20 72 65 61 64 2e 20 6e 6f 6e 2d 7a 65 72 6f 20 read. non-zero
1fc80 74 6f 20 77 72 69 74 65 2e 20 2a 2f 0a 29 7b 0a to write. */.){.
1fc90 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 unsigned char
1fca0 2a 61 50 61 79 6c 6f 61 64 3b 0a 20 20 69 6e 74 *aPayload;. int
1fcb0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
1fcc0 0a 20 20 75 33 32 20 6e 4b 65 79 3b 0a 20 20 69 . u32 nKey;. i
1fcd0 6e 74 20 69 49 64 78 20 3d 20 30 3b 0a 20 20 4d nt iIdx = 0;. M
1fce0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 emPage *pPage =
1fcf0 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
1fd00 72 2d 3e 69 50 61 67 65 5d 3b 20 2f 2a 20 42 74 r->iPage]; /* Bt
1fd10 72 65 65 20 70 61 67 65 20 6f 66 20 63 75 72 72 ree page of curr
1fd20 65 6e 74 20 65 6e 74 72 79 20 2a 2f 0a 20 20 42 ent entry */. B
1fd30 74 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 tShared *pBt = p
1fd40 43 75 72 2d 3e 70 42 74 3b 20 20 20 20 20 20 20 Cur->pBt;
1fd50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 74 /* Bt
1fd60 72 65 65 20 74 68 69 73 20 63 75 72 73 6f 72 20 ree this cursor
1fd70 62 65 6c 6f 6e 67 73 20 74 6f 20 2a 2f 0a 0a 20 belongs to */..
1fd80 20 61 73 73 65 72 74 28 20 70 50 61 67 65 20 29 assert( pPage )
1fd90 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
1fda0 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
1fdb0 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 _VALID );. asse
1fdc0 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b rt( pCur->aiIdx[
1fdd0 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 61 pCur->iPage]<pPa
1fde0 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 ge->nCell );. a
1fdf0 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
1fe00 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
1fe10 0a 0a 20 20 67 65 74 43 65 6c 6c 49 6e 66 6f 28 .. getCellInfo(
1fe20 70 43 75 72 29 3b 0a 20 20 61 50 61 79 6c 6f 61 pCur);. aPayloa
1fe30 64 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 d = pCur->info.p
1fe40 43 65 6c 6c 20 2b 20 70 43 75 72 2d 3e 69 6e 66 Cell + pCur->inf
1fe50 6f 2e 6e 48 65 61 64 65 72 3b 0a 20 20 6e 4b 65 o.nHeader;. nKe
1fe60 79 20 3d 20 28 70 50 61 67 65 2d 3e 69 6e 74 4b y = (pPage->intK
1fe70 65 79 20 3f 20 30 20 3a 20 28 69 6e 74 29 70 43 ey ? 0 : (int)pC
1fe80 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 29 3b 0a ur->info.nKey);.
1fe90 0a 20 20 69 66 28 20 4e 45 56 45 52 28 6f 66 66 . if( NEVER(off
1fea0 73 65 74 2b 61 6d 74 20 3e 20 6e 4b 65 79 2b 70 set+amt > nKey+p
1feb0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 44 61 74 61 29 Cur->info.nData)
1fec0 20 0a 20 20 20 7c 7c 20 26 61 50 61 79 6c 6f 61 . || &aPayloa
1fed0 64 5b 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f d[pCur->info.nLo
1fee0 63 61 6c 5d 20 3e 20 26 70 50 61 67 65 2d 3e 61 cal] > &pPage->a
1fef0 44 61 74 61 5b 70 42 74 2d 3e 75 73 61 62 6c 65 Data[pBt->usable
1ff00 53 69 7a 65 5d 0a 20 20 29 7b 0a 20 20 20 20 2f Size]. ){. /
1ff10 2a 20 54 72 79 69 6e 67 20 74 6f 20 72 65 61 64 * Trying to read
1ff20 20 6f 72 20 77 72 69 74 65 20 70 61 73 74 20 74 or write past t
1ff30 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 he end of the da
1ff40 74 61 20 69 73 20 61 6e 20 65 72 72 6f 72 20 2a ta is an error *
1ff50 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
1ff60 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
1ff70 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 68 65 63 ;. }.. /* Chec
1ff80 6b 20 69 66 20 64 61 74 61 20 6d 75 73 74 20 62 k if data must b
1ff90 65 20 72 65 61 64 2f 77 72 69 74 74 65 6e 20 74 e read/written t
1ffa0 6f 2f 66 72 6f 6d 20 74 68 65 20 62 74 72 65 65 o/from the btree
1ffb0 20 70 61 67 65 20 69 74 73 65 6c 66 2e 20 2a 2f page itself. */
1ffc0 0a 20 20 69 66 28 20 6f 66 66 73 65 74 3c 70 43 . if( offset<pC
1ffd0 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 ur->info.nLocal
1ffe0 29 7b 0a 20 20 20 20 69 6e 74 20 61 20 3d 20 61 ){. int a = a
1fff0 6d 74 3b 0a 20 20 20 20 69 66 28 20 61 2b 6f 66 mt;. if( a+of
20000 66 73 65 74 3e 70 43 75 72 2d 3e 69 6e 66 6f 2e fset>pCur->info.
20010 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 20 20 20 nLocal ){.
20020 61 20 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e a = pCur->info.n
20030 4c 6f 63 61 6c 20 2d 20 6f 66 66 73 65 74 3b 0a Local - offset;.
20040 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 63 }. rc = c
20050 6f 70 79 50 61 79 6c 6f 61 64 28 26 61 50 61 79 opyPayload(&aPay
20060 6c 6f 61 64 5b 6f 66 66 73 65 74 5d 2c 20 70 42 load[offset], pB
20070 75 66 2c 20 61 2c 20 65 4f 70 2c 20 70 50 61 67 uf, a, eOp, pPag
20080 65 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 e->pDbPage);.
20090 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 20 offset = 0;.
200a0 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 20 pBuf += a;.
200b0 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 7d 65 6c 73 amt -= a;. }els
200c0 65 7b 0a 20 20 20 20 6f 66 66 73 65 74 20 2d 3d e{. offset -=
200d0 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 pCur->info.nLoc
200e0 61 6c 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 al;. }.. if( r
200f0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
20100 61 6d 74 3e 30 20 29 7b 0a 20 20 20 20 63 6f 6e amt>0 ){. con
20110 73 74 20 75 33 32 20 6f 76 66 6c 53 69 7a 65 20 st u32 ovflSize
20120 3d 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a = pBt->usableSiz
20130 65 20 2d 20 34 3b 20 20 2f 2a 20 42 79 74 65 73 e - 4; /* Bytes
20140 20 63 6f 6e 74 65 6e 74 20 70 65 72 20 6f 76 66 content per ovf
20150 6c 20 70 61 67 65 20 2a 2f 0a 20 20 20 20 50 67 l page */. Pg
20160 6e 6f 20 6e 65 78 74 50 61 67 65 3b 0a 0a 20 20 no nextPage;..
20170 20 20 6e 65 78 74 50 61 67 65 20 3d 20 67 65 74 nextPage = get
20180 34 62 79 74 65 28 26 61 50 61 79 6c 6f 61 64 5b 4byte(&aPayload[
20190 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 pCur->info.nLoca
201a0 6c 5d 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 l]);..#ifndef SQ
201b0 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c LITE_OMIT_INCRBL
201c0 4f 42 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 OB. /* If the
201d0 20 69 73 49 6e 63 72 62 6c 6f 62 48 61 6e 64 6c isIncrblobHandl
201e0 65 20 66 6c 61 67 20 69 73 20 73 65 74 20 61 6e e flag is set an
201f0 64 20 74 68 65 20 42 74 43 75 72 73 6f 72 2e 61 d the BtCursor.a
20200 4f 76 65 72 66 6c 6f 77 5b 5d 0a 20 20 20 20 2a Overflow[]. *
20210 2a 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 61 * has not been a
20220 6c 6c 6f 63 61 74 65 64 2c 20 61 6c 6c 6f 63 61 llocated, alloca
20230 74 65 20 69 74 20 6e 6f 77 2e 20 54 68 65 20 61 te it now. The a
20240 72 72 61 79 20 69 73 20 73 69 7a 65 64 20 61 74 rray is sized at
20250 0a 20 20 20 20 2a 2a 20 6f 6e 65 20 65 6e 74 72 . ** one entr
20260 79 20 66 6f 72 20 65 61 63 68 20 6f 76 65 72 66 y for each overf
20270 6c 6f 77 20 70 61 67 65 20 69 6e 20 74 68 65 20 low page in the
20280 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e 20 overflow chain.
20290 54 68 65 0a 20 20 20 20 2a 2a 20 70 61 67 65 20 The. ** page
202a0 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 66 69 number of the fi
202b0 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 rst overflow pag
202c0 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 61 e is stored in a
202d0 4f 76 65 72 66 6c 6f 77 5b 30 5d 2c 0a 20 20 20 Overflow[0],.
202e0 20 2a 2a 20 65 74 63 2e 20 41 20 76 61 6c 75 65 ** etc. A value
202f0 20 6f 66 20 30 20 69 6e 20 74 68 65 20 61 4f 76 of 0 in the aOv
20300 65 72 66 6c 6f 77 5b 5d 20 61 72 72 61 79 20 6d erflow[] array m
20310 65 61 6e 73 20 22 6e 6f 74 20 79 65 74 20 6b 6e eans "not yet kn
20320 6f 77 6e 22 0a 20 20 20 20 2a 2a 20 28 74 68 65 own". ** (the
20330 20 63 61 63 68 65 20 69 73 20 6c 61 7a 69 6c 79 cache is lazily
20340 20 70 6f 70 75 6c 61 74 65 64 29 2e 0a 20 20 20 populated)..
20350 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 43 75 72 */. if( pCur
20360 2d 3e 69 73 49 6e 63 72 62 6c 6f 62 48 61 6e 64 ->isIncrblobHand
20370 6c 65 20 26 26 20 21 70 43 75 72 2d 3e 61 4f 76 le && !pCur->aOv
20380 65 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 erflow ){.
20390 69 6e 74 20 6e 4f 76 66 6c 20 3d 20 28 70 43 75 int nOvfl = (pCu
203a0 72 2d 3e 69 6e 66 6f 2e 6e 50 61 79 6c 6f 61 64 r->info.nPayload
203b0 2d 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 -pCur->info.nLoc
203c0 61 6c 2b 6f 76 66 6c 53 69 7a 65 2d 31 29 2f 6f al+ovflSize-1)/o
203d0 76 66 6c 53 69 7a 65 3b 0a 20 20 20 20 20 20 70 vflSize;. p
203e0 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 3d Cur->aOverflow =
203f0 20 28 50 67 6e 6f 20 2a 29 73 71 6c 69 74 65 33 (Pgno *)sqlite3
20400 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a 65 6f MallocZero(sizeo
20410 66 28 50 67 6e 6f 29 2a 6e 4f 76 66 6c 29 3b 0a f(Pgno)*nOvfl);.
20420 20 20 20 20 20 20 2f 2a 20 6e 4f 76 66 6c 20 69 /* nOvfl i
20430 73 20 61 6c 77 61 79 73 20 70 6f 73 69 74 69 76 s always positiv
20440 65 2e 20 20 49 66 20 69 74 20 77 65 72 65 20 7a e. If it were z
20450 65 72 6f 2c 20 66 65 74 63 68 50 61 79 6c 6f 61 ero, fetchPayloa
20460 64 20 77 6f 75 6c 64 20 68 61 76 65 0a 20 20 20 d would have.
20470 20 20 20 2a 2a 20 62 65 65 6e 20 75 73 65 64 20 ** been used
20480 69 6e 73 74 65 61 64 20 6f 66 20 74 68 69 73 20 instead of this
20490 72 6f 75 74 69 6e 65 2e 20 2a 2f 0a 20 20 20 20 routine. */.
204a0 20 20 69 66 28 20 41 4c 57 41 59 53 28 6e 4f 76 if( ALWAYS(nOv
204b0 66 6c 29 20 26 26 20 21 70 43 75 72 2d 3e 61 4f fl) && !pCur->aO
204c0 76 65 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 verflow ){.
204d0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
204e0 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 OMEM;. }.
204f0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 }.. /* If t
20500 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 he overflow page
20510 2d 6c 69 73 74 20 63 61 63 68 65 20 68 61 73 20 -list cache has
20520 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 61 been allocated a
20530 6e 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 65 6e nd the. ** en
20540 74 72 79 20 66 6f 72 20 74 68 65 20 66 69 72 73 try for the firs
20550 74 20 72 65 71 75 69 72 65 64 20 6f 76 65 72 66 t required overf
20560 6c 6f 77 20 70 61 67 65 20 69 73 20 76 61 6c 69 low page is vali
20570 64 2c 20 73 6b 69 70 0a 20 20 20 20 2a 2a 20 64 d, skip. ** d
20580 69 72 65 63 74 6c 79 20 74 6f 20 69 74 2e 0a 20 irectly to it..
20590 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 43 */. if( pC
205a0 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 26 26 ur->aOverflow &&
205b0 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 pCur->aOverflow
205c0 5b 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 7a 65 [offset/ovflSize
205d0 5d 20 29 7b 0a 20 20 20 20 20 20 69 49 64 78 20 ] ){. iIdx
205e0 3d 20 28 6f 66 66 73 65 74 2f 6f 76 66 6c 53 69 = (offset/ovflSi
205f0 7a 65 29 3b 0a 20 20 20 20 20 20 6e 65 78 74 50 ze);. nextP
20600 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 65 age = pCur->aOve
20610 72 66 6c 6f 77 5b 69 49 64 78 5d 3b 0a 20 20 20 rflow[iIdx];.
20620 20 20 20 6f 66 66 73 65 74 20 3d 20 28 6f 66 66 offset = (off
20630 73 65 74 25 6f 76 66 6c 53 69 7a 65 29 3b 0a 20 set%ovflSize);.
20640 20 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 }.#endif..
20650 20 66 6f 72 28 20 3b 20 72 63 3d 3d 53 51 4c 49 for( ; rc==SQLI
20660 54 45 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 26 TE_OK && amt>0 &
20670 26 20 6e 65 78 74 50 61 67 65 3b 20 69 49 64 78 & nextPage; iIdx
20680 2b 2b 29 7b 0a 0a 23 69 66 6e 64 65 66 20 53 51 ++){..#ifndef SQ
20690 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c LITE_OMIT_INCRBL
206a0 4f 42 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 72 OB. /* If r
206b0 65 71 75 69 72 65 64 2c 20 70 6f 70 75 6c 61 74 equired, populat
206c0 65 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 20 70 e the overflow p
206d0 61 67 65 2d 6c 69 73 74 20 63 61 63 68 65 2e 20 age-list cache.
206e0 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 43 75 */. if( pCu
206f0 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 20 29 7b 0a r->aOverflow ){.
20700 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 21 assert(!
20710 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c 6f 77 5b pCur->aOverflow[
20720 69 49 64 78 5d 20 7c 7c 20 70 43 75 72 2d 3e 61 iIdx] || pCur->a
20730 4f 76 65 72 66 6c 6f 77 5b 69 49 64 78 5d 3d 3d Overflow[iIdx]==
20740 6e 65 78 74 50 61 67 65 29 3b 0a 20 20 20 20 20 nextPage);.
20750 20 20 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 6c pCur->aOverfl
20760 6f 77 5b 69 49 64 78 5d 20 3d 20 6e 65 78 74 50 ow[iIdx] = nextP
20770 61 67 65 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e age;. }.#en
20780 64 69 66 0a 0a 20 20 20 20 20 20 69 66 28 20 6f dif.. if( o
20790 66 66 73 65 74 3e 3d 6f 76 66 6c 53 69 7a 65 20 ffset>=ovflSize
207a0 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ){. /* Th
207b0 65 20 6f 6e 6c 79 20 72 65 61 73 6f 6e 20 74 6f e only reason to
207c0 20 72 65 61 64 20 74 68 69 73 20 70 61 67 65 20 read this page
207d0 69 73 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 is to obtain the
207e0 20 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a 2a page. **
207f0 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 65 20 number for the
20800 6e 65 78 74 20 70 61 67 65 20 69 6e 20 74 68 65 next page in the
20810 20 6f 76 65 72 66 6c 6f 77 20 63 68 61 69 6e 2e overflow chain.
20820 20 54 68 65 20 70 61 67 65 0a 20 20 20 20 20 20 The page.
20830 20 20 2a 2a 20 64 61 74 61 20 69 73 20 6e 6f 74 ** data is not
20840 20 72 65 71 75 69 72 65 64 2e 20 53 6f 20 66 69 required. So fi
20850 72 73 74 20 74 72 79 20 74 6f 20 6c 6f 6f 6b 75 rst try to looku
20860 70 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 0a 20 p the overflow.
20870 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 2d 6c ** page-l
20880 69 73 74 20 63 61 63 68 65 2c 20 69 66 20 61 6e ist cache, if an
20890 79 2c 20 74 68 65 6e 20 66 61 6c 6c 20 62 61 63 y, then fall bac
208a0 6b 20 74 6f 20 74 68 65 20 67 65 74 4f 76 65 72 k to the getOver
208b0 66 6c 6f 77 50 61 67 65 28 29 0a 20 20 20 20 20 flowPage().
208c0 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 0a ** function..
208d0 20 20 20 20 20 20 20 20 2a 2f 0a 23 69 66 6e 64 */.#ifnd
208e0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 49 ef SQLITE_OMIT_I
208f0 4e 43 52 42 4c 4f 42 0a 20 20 20 20 20 20 20 20 NCRBLOB.
20900 69 66 28 20 70 43 75 72 2d 3e 61 4f 76 65 72 66 if( pCur->aOverf
20910 6c 6f 77 20 26 26 20 70 43 75 72 2d 3e 61 4f 76 low && pCur->aOv
20920 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 5d 20 29 erflow[iIdx+1] )
20930 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 {. next
20940 50 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 4f 76 Page = pCur->aOv
20950 65 72 66 6c 6f 77 5b 69 49 64 78 2b 31 5d 3b 0a erflow[iIdx+1];.
20960 20 20 20 20 20 20 20 20 7d 20 65 6c 73 65 20 0a } else .
20970 23 65 6e 64 69 66 0a 20 20 20 20 20 20 20 20 20 #endif.
20980 20 72 63 20 3d 20 67 65 74 4f 76 65 72 66 6c 6f rc = getOverflo
20990 77 50 61 67 65 28 70 42 74 2c 20 6e 65 78 74 50 wPage(pBt, nextP
209a0 61 67 65 2c 20 30 2c 20 26 6e 65 78 74 50 61 67 age, 0, &nextPag
209b0 65 29 3b 0a 20 20 20 20 20 20 20 20 6f 66 66 73 e);. offs
209c0 65 74 20 2d 3d 20 6f 76 66 6c 53 69 7a 65 3b 0a et -= ovflSize;.
209d0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
209e0 20 20 20 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 /* Need to
209f0 72 65 61 64 20 74 68 69 73 20 70 61 67 65 20 70 read this page p
20a00 72 6f 70 65 72 6c 79 2e 20 49 74 20 63 6f 6e 74 roperly. It cont
20a10 61 69 6e 73 20 73 6f 6d 65 20 6f 66 20 74 68 65 ains some of the
20a20 0a 20 20 20 20 20 20 20 20 2a 2a 20 72 61 6e 67 . ** rang
20a30 65 20 6f 66 20 64 61 74 61 20 74 68 61 74 20 69 e of data that i
20a40 73 20 62 65 69 6e 67 20 72 65 61 64 20 28 65 4f s being read (eO
20a50 70 3d 3d 30 29 20 6f 72 20 77 72 69 74 74 65 6e p==0) or written
20a60 20 28 65 4f 70 21 3d 30 29 2e 0a 20 20 20 20 20 (eOp!=0)..
20a70 20 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c */.#ifdef SQL
20a80 49 54 45 5f 44 49 52 45 43 54 5f 4f 56 45 52 46 ITE_DIRECT_OVERF
20a90 4c 4f 57 5f 52 45 41 44 0a 20 20 20 20 20 20 20 LOW_READ.
20aa0 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 sqlite3_file *f
20ab0 64 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 d;.#endif.
20ac0 20 20 69 6e 74 20 61 20 3d 20 61 6d 74 3b 0a 20 int a = amt;.
20ad0 20 20 20 20 20 20 20 69 66 28 20 61 20 2b 20 6f if( a + o
20ae0 66 66 73 65 74 20 3e 20 6f 76 66 6c 53 69 7a 65 ffset > ovflSize
20af0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 20 ){. a
20b00 3d 20 6f 76 66 6c 53 69 7a 65 20 2d 20 6f 66 66 = ovflSize - off
20b10 73 65 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a set;. }..
20b20 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 49 #ifdef SQLITE_DI
20b30 52 45 43 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 RECT_OVERFLOW_RE
20b40 41 44 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 AD. /* If
20b50 20 61 6c 6c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 all the followi
20b60 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 20 20 20 ng are true:.
20b70 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 **.
20b80 2a 2a 20 20 20 31 29 20 74 68 69 73 20 69 73 20 ** 1) this is
20b90 61 20 72 65 61 64 20 6f 70 65 72 61 74 69 6f 6e a read operation
20ba0 2c 20 61 6e 64 20 0a 20 20 20 20 20 20 20 20 2a , and . *
20bb0 2a 20 20 20 32 29 20 64 61 74 61 20 69 73 20 72 * 2) data is r
20bc0 65 71 75 69 72 65 64 20 66 72 6f 6d 20 74 68 65 equired from the
20bd0 20 73 74 61 72 74 20 6f 66 20 74 68 69 73 20 6f start of this o
20be0 76 65 72 66 6c 6f 77 20 70 61 67 65 2c 20 61 6e verflow page, an
20bf0 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 33 d. ** 3
20c00 29 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 ) the database i
20c10 73 20 66 69 6c 65 2d 62 61 63 6b 65 64 2c 20 61 s file-backed, a
20c20 6e 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 20 20 nd. **
20c30 34 29 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6f 4) there is no o
20c40 70 65 6e 20 77 72 69 74 65 2d 74 72 61 6e 73 61 pen write-transa
20c50 63 74 69 6f 6e 2c 20 61 6e 64 0a 20 20 20 20 20 ction, and.
20c60 20 20 20 2a 2a 20 20 20 35 29 20 74 68 65 20 64 ** 5) the d
20c70 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 61 atabase is not a
20c80 20 57 41 4c 20 64 61 74 61 62 61 73 65 2c 0a 20 WAL database,.
20c90 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 **.
20ca0 20 20 2a 2a 20 74 68 65 6e 20 64 61 74 61 20 63 ** then data c
20cb0 61 6e 20 62 65 20 72 65 61 64 20 64 69 72 65 63 an be read direc
20cc0 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 64 61 74 tly from the dat
20cd0 61 62 61 73 65 20 66 69 6c 65 20 69 6e 74 6f 20 abase file into
20ce0 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f the. ** o
20cf0 75 74 70 75 74 20 62 75 66 66 65 72 2c 20 62 79 utput buffer, by
20d00 70 61 73 73 69 6e 67 20 74 68 65 20 70 61 67 65 passing the page
20d10 2d 63 61 63 68 65 20 61 6c 74 6f 67 65 74 68 65 -cache altogethe
20d20 72 2e 20 54 68 69 73 20 73 70 65 65 64 73 0a 20 r. This speeds.
20d30 20 20 20 20 20 20 20 2a 2a 20 75 70 20 6c 6f 61 ** up loa
20d40 64 69 6e 67 20 6c 61 72 67 65 20 72 65 63 6f 72 ding large recor
20d50 64 73 20 74 68 61 74 20 73 70 61 6e 20 6d 61 6e ds that span man
20d60 79 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 y overflow pages
20d70 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
20d80 20 20 20 20 20 69 66 28 20 65 4f 70 3d 3d 30 20 if( eOp==0
20d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20db0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 /* (
20dc0 31 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 26 1) */. &
20dd0 26 20 6f 66 66 73 65 74 3d 3d 30 20 20 20 20 20 & offset==0
20de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20e00 20 20 20 20 20 2f 2a 20 28 32 29 20 2a 2f 0a 20 /* (2) */.
20e10 20 20 20 20 20 20 20 20 26 26 20 70 42 74 2d 3e && pBt->
20e20 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 3d 3d 54 inTransaction==T
20e30 52 41 4e 53 5f 52 45 41 44 20 20 20 20 20 20 20 RANS_READ
20e40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
20e50 20 28 34 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 (4) */.
20e60 20 26 26 20 28 66 64 20 3d 20 73 71 6c 69 74 65 && (fd = sqlite
20e70 33 50 61 67 65 72 46 69 6c 65 28 70 42 74 2d 3e 3PagerFile(pBt->
20e80 70 50 61 67 65 72 29 29 2d 3e 70 4d 65 74 68 6f pPager))->pMetho
20e90 64 73 20 20 20 20 20 2f 2a 20 28 33 29 20 2a 2f ds /* (3) */
20ea0 0a 20 20 20 20 20 20 20 20 20 26 26 20 70 42 74 . && pBt
20eb0 2d 3e 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b ->pPage1->aData[
20ec0 31 39 5d 3d 3d 30 78 30 31 20 20 20 20 20 20 20 19]==0x01
20ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20ee0 2f 2a 20 28 35 29 20 2a 2f 0a 20 20 20 20 20 20 /* (5) */.
20ef0 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 ){. u
20f00 38 20 61 53 61 76 65 5b 34 5d 3b 0a 20 20 20 20 8 aSave[4];.
20f10 20 20 20 20 20 20 75 38 20 2a 61 57 72 69 74 65 u8 *aWrite
20f20 20 3d 20 26 70 42 75 66 5b 2d 34 5d 3b 0a 20 20 = &pBuf[-4];.
20f30 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 61 memcpy(a
20f40 53 61 76 65 2c 20 61 57 72 69 74 65 2c 20 34 29 Save, aWrite, 4)
20f50 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d ;. rc =
20f60 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 66 sqlite3OsRead(f
20f70 64 2c 20 61 57 72 69 74 65 2c 20 61 2b 34 2c 20 d, aWrite, a+4,
20f80 28 69 36 34 29 70 42 74 2d 3e 70 61 67 65 53 69 (i64)pBt->pageSi
20f90 7a 65 2a 28 6e 65 78 74 50 61 67 65 2d 31 29 29 ze*(nextPage-1))
20fa0 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 78 74 ;. next
20fb0 50 61 67 65 20 3d 20 67 65 74 34 62 79 74 65 28 Page = get4byte(
20fc0 61 57 72 69 74 65 29 3b 0a 20 20 20 20 20 20 20 aWrite);.
20fd0 20 20 20 6d 65 6d 63 70 79 28 61 57 72 69 74 65 memcpy(aWrite
20fe0 2c 20 61 53 61 76 65 2c 20 34 29 3b 0a 20 20 20 , aSave, 4);.
20ff0 20 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 }else.#endi
21000 66 0a 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 f.. {.
21010 20 20 20 20 20 20 20 44 62 50 61 67 65 20 2a 70 DbPage *p
21020 44 62 50 61 67 65 3b 0a 20 20 20 20 20 20 20 20 DbPage;.
21030 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 rc = sqlite3Pa
21040 67 65 72 47 65 74 28 70 42 74 2d 3e 70 50 61 67 gerGet(pBt->pPag
21050 65 72 2c 20 6e 65 78 74 50 61 67 65 2c 20 26 70 er, nextPage, &p
21060 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
21070 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
21080 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
21090 20 20 20 20 61 50 61 79 6c 6f 61 64 20 3d 20 73 aPayload = s
210a0 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 44 61 qlite3PagerGetDa
210b0 74 61 28 70 44 62 50 61 67 65 29 3b 0a 20 20 20 ta(pDbPage);.
210c0 20 20 20 20 20 20 20 20 20 6e 65 78 74 50 61 67 nextPag
210d0 65 20 3d 20 67 65 74 34 62 79 74 65 28 61 50 61 e = get4byte(aPa
210e0 79 6c 6f 61 64 29 3b 0a 20 20 20 20 20 20 20 20 yload);.
210f0 20 20 20 20 72 63 20 3d 20 63 6f 70 79 50 61 79 rc = copyPay
21100 6c 6f 61 64 28 26 61 50 61 79 6c 6f 61 64 5b 6f load(&aPayload[o
21110 66 66 73 65 74 2b 34 5d 2c 20 70 42 75 66 2c 20 ffset+4], pBuf,
21120 61 2c 20 65 4f 70 2c 20 70 44 62 50 61 67 65 29 a, eOp, pDbPage)
21130 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 ;. sq
21140 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
21150 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 pDbPage);.
21160 20 20 20 20 20 20 6f 66 66 73 65 74 20 3d 20 30 offset = 0
21170 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
21180 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
21190 61 6d 74 20 2d 3d 20 61 3b 0a 20 20 20 20 20 20 amt -= a;.
211a0 20 20 70 42 75 66 20 2b 3d 20 61 3b 0a 20 20 20 pBuf += a;.
211b0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a }. }. }..
211c0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
211d0 5f 4f 4b 20 26 26 20 61 6d 74 3e 30 20 29 7b 0a _OK && amt>0 ){.
211e0 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
211f0 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
21200 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
21210 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 70 .}../*.** Read p
21220 61 72 74 20 6f 66 20 74 68 65 20 6b 65 79 20 61 art of the key a
21230 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 63 ssociated with c
21240 75 72 73 6f 72 20 70 43 75 72 2e 20 20 45 78 61 ursor pCur. Exa
21250 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 62 79 ctly.** "amt" by
21260 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 61 6e tes will be tran
21270 73 66 65 72 65 64 20 69 6e 74 6f 20 70 42 75 66 sfered into pBuf
21280 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e 73 66 65 []. The transfe
21290 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 74 20 22 r.** begins at "
212a0 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a 2a 20 54 offset"..**.** T
212b0 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 65 he caller must e
212c0 6e 73 75 72 65 20 74 68 61 74 20 70 43 75 72 20 nsure that pCur
212d0 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 is pointing to a
212e0 20 76 61 6c 69 64 20 72 6f 77 0a 2a 2a 20 69 6e valid row.** in
212f0 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a the table..**.*
21300 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f * Return SQLITE_
21310 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 OK on success or
21320 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 an error code i
21330 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a f anything goes.
21340 2a 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 65 72 ** wrong. An er
21350 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 20 ror is returned
21360 69 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 22 20 if "offset+amt"
21370 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 0a 2a is larger than.*
21380 2a 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 * the available
21390 70 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 payload..*/.int
213a0 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79 28 sqlite3BtreeKey(
213b0 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
213c0 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 20 u32 offset, u32
213d0 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 29 amt, void *pBuf)
213e0 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 73 {. assert( curs
213f0 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 orHoldsMutex(pCu
21400 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 r) );. assert(
21410 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
21420 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
21430 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 assert( pCur->iP
21440 61 67 65 3e 3d 30 20 26 26 20 70 43 75 72 2d 3e age>=0 && pCur->
21450 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
21460 67 65 5d 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ge] );. assert(
21470 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 pCur->aiIdx[pCu
21480 72 2d 3e 69 50 61 67 65 5d 3c 70 43 75 72 2d 3e r->iPage]<pCur->
21490 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 apPage[pCur->iPa
214a0 67 65 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 ge]->nCell );.
214b0 72 65 74 75 72 6e 20 61 63 63 65 73 73 50 61 79 return accessPay
214c0 6c 6f 61 64 28 70 43 75 72 2c 20 6f 66 66 73 65 load(pCur, offse
214d0 74 2c 20 61 6d 74 2c 20 28 75 6e 73 69 67 6e 65 t, amt, (unsigne
214e0 64 20 63 68 61 72 2a 29 70 42 75 66 2c 20 30 29 d char*)pBuf, 0)
214f0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 ;.}../*.** Read
21500 70 61 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 part of the data
21510 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
21520 20 63 75 72 73 6f 72 20 70 43 75 72 2e 20 20 45 cursor pCur. E
21530 78 61 63 74 6c 79 0a 2a 2a 20 22 61 6d 74 22 20 xactly.** "amt"
21540 62 79 74 65 73 20 77 69 6c 6c 20 62 65 20 74 72 bytes will be tr
21550 61 6e 73 66 65 72 65 64 20 69 6e 74 6f 20 70 42 ansfered into pB
21560 75 66 5b 5d 2e 20 20 54 68 65 20 74 72 61 6e 73 uf[]. The trans
21570 66 65 72 0a 2a 2a 20 62 65 67 69 6e 73 20 61 74 fer.** begins at
21580 20 22 6f 66 66 73 65 74 22 2e 0a 2a 2a 0a 2a 2a "offset"..**.**
21590 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
215a0 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 K on success or
215b0 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 an error code if
215c0 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 0a 2a anything goes.*
215d0 2a 20 77 72 6f 6e 67 2e 20 20 41 6e 20 65 72 72 * wrong. An err
215e0 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 or is returned i
215f0 66 20 22 6f 66 66 73 65 74 2b 61 6d 74 22 20 69 f "offset+amt" i
21600 73 20 6c 61 72 67 65 72 20 74 68 61 6e 0a 2a 2a s larger than.**
21610 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 70 the available p
21620 61 79 6c 6f 61 64 2e 0a 2a 2f 0a 69 6e 74 20 73 ayload..*/.int s
21630 71 6c 69 74 65 33 42 74 72 65 65 44 61 74 61 28 qlite3BtreeData(
21640 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 BtCursor *pCur,
21650 75 33 32 20 6f 66 66 73 65 74 2c 20 75 33 32 20 u32 offset, u32
21660 61 6d 74 2c 20 76 6f 69 64 20 2a 70 42 75 66 29 amt, void *pBuf)
21670 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 23 69 66 {. int rc;..#if
21680 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
21690 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69 66 20 28 _INCRBLOB. if (
216a0 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
216b0 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 29 7b URSOR_INVALID ){
216c0 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
216d0 54 45 5f 41 42 4f 52 54 3b 0a 20 20 7d 0a 23 65 TE_ABORT;. }.#e
216e0 6e 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 ndif.. assert(
216f0 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
21700 28 70 43 75 72 29 20 29 3b 0a 20 20 72 63 20 3d (pCur) );. rc =
21710 20 72 65 73 74 6f 72 65 43 75 72 73 6f 72 50 6f restoreCursorPo
21720 73 69 74 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 sition(pCur);.
21730 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
21740 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 K ){. assert(
21750 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
21760 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
21770 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
21780 3e 69 50 61 67 65 3e 3d 30 20 26 26 20 70 43 75 >iPage>=0 && pCu
21790 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
217a0 69 50 61 67 65 5d 20 29 3b 0a 20 20 20 20 61 73 iPage] );. as
217b0 73 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 sert( pCur->aiId
217c0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 x[pCur->iPage]<p
217d0 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
217e0 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 20 ->iPage]->nCell
217f0 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 63 63 65 );. rc = acce
21800 73 73 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 ssPayload(pCur,
21810 6f 66 66 73 65 74 2c 20 61 6d 74 2c 20 70 42 75 offset, amt, pBu
21820 66 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65 74 f, 0);. }. ret
21830 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a urn rc;.}../*.**
21840 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 Return a pointe
21850 72 20 74 6f 20 70 61 79 6c 6f 61 64 20 69 6e 66 r to payload inf
21860 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 ormation from th
21870 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65 e entry that the
21880 20 0a 2a 2a 20 70 43 75 72 20 63 75 72 73 6f 72 .** pCur cursor
21890 20 69 73 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e is pointing to.
218a0 20 20 54 68 65 20 70 6f 69 6e 74 65 72 20 69 73 The pointer is
218b0 20 74 6f 20 74 68 65 20 62 65 67 69 6e 6e 69 6e to the beginnin
218c0 67 20 6f 66 0a 2a 2a 20 74 68 65 20 6b 65 79 20 g of.** the key
218d0 69 66 20 73 6b 69 70 4b 65 79 3d 3d 30 20 61 6e if skipKey==0 an
218e0 64 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 20 74 d it points to t
218f0 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 he beginning of
21900 64 61 74 61 20 69 66 0a 2a 2a 20 73 6b 69 70 4b data if.** skipK
21910 65 79 3d 3d 31 2e 20 20 54 68 65 20 6e 75 6d 62 ey==1. The numb
21920 65 72 20 6f 66 20 62 79 74 65 73 20 6f 66 20 61 er of bytes of a
21930 76 61 69 6c 61 62 6c 65 20 6b 65 79 2f 64 61 74 vailable key/dat
21940 61 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 a is written.**
21950 69 6e 74 6f 20 2a 70 41 6d 74 2e 20 20 49 66 20 into *pAmt. If
21960 2a 70 41 6d 74 3d 3d 30 2c 20 74 68 65 6e 20 74 *pAmt==0, then t
21970 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 he value returne
21980 64 20 77 69 6c 6c 20 6e 6f 74 20 62 65 0a 2a 2a d will not be.**
21990 20 61 20 76 61 6c 69 64 20 70 6f 69 6e 74 65 72 a valid pointer
219a0 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ..**.** This rou
219b0 74 69 6e 65 20 69 73 20 61 6e 20 6f 70 74 69 6d tine is an optim
219c0 69 7a 61 74 69 6f 6e 2e 20 20 49 74 20 69 73 20 ization. It is
219d0 63 6f 6d 6d 6f 6e 20 66 6f 72 20 74 68 65 20 65 common for the e
219e0 6e 74 69 72 65 20 6b 65 79 0a 2a 2a 20 61 6e 64 ntire key.** and
219f0 20 64 61 74 61 20 74 6f 20 66 69 74 20 6f 6e 20 data to fit on
21a00 74 68 65 20 6c 6f 63 61 6c 20 70 61 67 65 20 61 the local page a
21a10 6e 64 20 66 6f 72 20 74 68 65 72 65 20 74 6f 20 nd for there to
21a20 62 65 20 6e 6f 20 6f 76 65 72 66 6c 6f 77 0a 2a be no overflow.*
21a30 2a 20 70 61 67 65 73 2e 20 20 57 68 65 6e 20 74 * pages. When t
21a40 68 61 74 20 69 73 20 73 6f 2c 20 74 68 69 73 20 hat is so, this
21a50 72 6f 75 74 69 6e 65 20 63 61 6e 20 62 65 20 75 routine can be u
21a60 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 sed to access th
21a70 65 0a 2a 2a 20 6b 65 79 20 61 6e 64 20 64 61 74 e.** key and dat
21a80 61 20 77 69 74 68 6f 75 74 20 6d 61 6b 69 6e 67 a without making
21a90 20 61 20 63 6f 70 79 2e 20 20 49 66 20 74 68 65 a copy. If the
21aa0 20 6b 65 79 20 61 6e 64 2f 6f 72 20 64 61 74 61 key and/or data
21ab0 20 73 70 69 6c 6c 73 0a 2a 2a 20 6f 6e 74 6f 20 spills.** onto
21ac0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 2c 20 overflow pages,
21ad0 74 68 65 6e 20 61 63 63 65 73 73 50 61 79 6c 6f then accessPaylo
21ae0 61 64 28 29 20 6d 75 73 74 20 62 65 20 75 73 65 ad() must be use
21af0 64 20 74 6f 20 72 65 61 73 73 65 6d 62 6c 65 0a d to reassemble.
21b00 2a 2a 20 74 68 65 20 6b 65 79 2f 64 61 74 61 20 ** the key/data
21b10 61 6e 64 20 63 6f 70 79 20 69 74 20 69 6e 74 6f and copy it into
21b20 20 61 20 70 72 65 61 6c 6c 6f 63 61 74 65 64 20 a preallocated
21b30 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 buffer..**.** Th
21b40 65 20 70 6f 69 6e 74 65 72 20 72 65 74 75 72 6e e pointer return
21b50 65 64 20 62 79 20 74 68 69 73 20 72 6f 75 74 69 ed by this routi
21b60 6e 65 20 6c 6f 6f 6b 73 20 64 69 72 65 63 74 6c ne looks directl
21b70 79 20 69 6e 74 6f 20 74 68 65 20 63 61 63 68 65 y into the cache
21b80 64 0a 2a 2a 20 70 61 67 65 20 6f 66 20 74 68 65 d.** page of the
21b90 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 65 20 database. The
21ba0 64 61 74 61 20 6d 69 67 68 74 20 63 68 61 6e 67 data might chang
21bb0 65 20 6f 72 20 6d 6f 76 65 20 74 68 65 20 6e 65 e or move the ne
21bc0 78 74 20 74 69 6d 65 0a 2a 2a 20 61 6e 79 20 62 xt time.** any b
21bd0 74 72 65 65 20 72 6f 75 74 69 6e 65 20 69 73 20 tree routine is
21be0 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
21bf0 63 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 c const unsigned
21c00 20 63 68 61 72 20 2a 66 65 74 63 68 50 61 79 6c char *fetchPayl
21c10 6f 61 64 28 0a 20 20 42 74 43 75 72 73 6f 72 20 oad(. BtCursor
21c20 2a 70 43 75 72 2c 20 20 20 20 20 20 2f 2a 20 43 *pCur, /* C
21c30 75 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 ursor pointing t
21c40 6f 20 65 6e 74 72 79 20 74 6f 20 72 65 61 64 20 o entry to read
21c50 66 72 6f 6d 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 from */. int *p
21c60 41 6d 74 2c 20 20 20 20 20 20 20 20 20 20 20 2f Amt, /
21c70 2a 20 57 72 69 74 65 20 74 68 65 20 6e 75 6d 62 * Write the numb
21c80 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 er of available
21c90 62 79 74 65 73 20 68 65 72 65 20 2a 2f 0a 20 20 bytes here */.
21ca0 69 6e 74 20 73 6b 69 70 4b 65 79 20 20 20 20 20 int skipKey
21cb0 20 20 20 20 20 2f 2a 20 72 65 61 64 20 62 65 67 /* read beg
21cc0 69 6e 6e 69 6e 67 20 61 74 20 64 61 74 61 20 69 inning at data i
21cd0 66 20 74 68 69 73 20 69 73 20 74 72 75 65 20 2a f this is true *
21ce0 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 /.){. unsigned
21cf0 63 68 61 72 20 2a 61 50 61 79 6c 6f 61 64 3b 0a char *aPayload;.
21d00 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
21d10 3b 0a 20 20 75 33 32 20 6e 4b 65 79 3b 0a 20 20 ;. u32 nKey;.
21d20 75 33 32 20 6e 4c 6f 63 61 6c 3b 0a 0a 20 20 61 u32 nLocal;.. a
21d30 73 73 65 72 74 28 20 70 43 75 72 21 3d 30 20 26 ssert( pCur!=0 &
21d40 26 20 70 43 75 72 2d 3e 69 50 61 67 65 3e 3d 30 & pCur->iPage>=0
21d50 20 26 26 20 70 43 75 72 2d 3e 61 70 50 61 67 65 && pCur->apPage
21d60 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 3b 0a [pCur->iPage]);.
21d70 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
21d80 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 eState==CURSOR_V
21d90 41 4c 49 44 20 29 3b 0a 20 20 61 73 73 65 72 74 ALID );. assert
21da0 28 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 ( cursorHoldsMut
21db0 65 78 28 70 43 75 72 29 20 29 3b 0a 20 20 70 50 ex(pCur) );. pP
21dc0 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
21dd0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
21de0 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d . assert( pCur-
21df0 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
21e00 67 65 5d 3c 70 50 61 67 65 2d 3e 6e 43 65 6c 6c ge]<pPage->nCell
21e10 20 29 3b 0a 20 20 69 66 28 20 4e 45 56 45 52 28 );. if( NEVER(
21e20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 pCur->info.nSize
21e30 3d 3d 30 29 20 29 7b 0a 20 20 20 20 62 74 72 65 ==0) ){. btre
21e40 65 50 61 72 73 65 43 65 6c 6c 28 70 43 75 72 2d eParseCell(pCur-
21e50 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 >apPage[pCur->iP
21e60 61 67 65 5d 2c 20 70 43 75 72 2d 3e 61 69 49 64 age], pCur->aiId
21e70 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2c 0a x[pCur->iPage],.
21e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21e90 20 20 20 26 70 43 75 72 2d 3e 69 6e 66 6f 29 3b &pCur->info);
21ea0 0a 20 20 7d 0a 20 20 61 50 61 79 6c 6f 61 64 20 . }. aPayload
21eb0 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 70 43 65 = pCur->info.pCe
21ec0 6c 6c 3b 0a 20 20 61 50 61 79 6c 6f 61 64 20 2b ll;. aPayload +
21ed0 3d 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 48 65 = pCur->info.nHe
21ee0 61 64 65 72 3b 0a 20 20 69 66 28 20 70 50 61 67 ader;. if( pPag
21ef0 65 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 e->intKey ){.
21f00 20 6e 4b 65 79 20 3d 20 30 3b 0a 20 20 7d 65 6c nKey = 0;. }el
21f10 73 65 7b 0a 20 20 20 20 6e 4b 65 79 20 3d 20 28 se{. nKey = (
21f20 69 6e 74 29 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e int)pCur->info.n
21f30 4b 65 79 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 Key;. }. if( s
21f40 6b 69 70 4b 65 79 20 29 7b 0a 20 20 20 20 61 50 kipKey ){. aP
21f50 61 79 6c 6f 61 64 20 2b 3d 20 6e 4b 65 79 3b 0a ayload += nKey;.
21f60 20 20 20 20 6e 4c 6f 63 61 6c 20 3d 20 70 43 75 nLocal = pCu
21f70 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 20 2d r->info.nLocal -
21f80 20 6e 4b 65 79 3b 0a 20 20 7d 65 6c 73 65 7b 0a nKey;. }else{.
21f90 20 20 20 20 6e 4c 6f 63 61 6c 20 3d 20 70 43 75 nLocal = pCu
21fa0 72 2d 3e 69 6e 66 6f 2e 6e 4c 6f 63 61 6c 3b 0a r->info.nLocal;.
21fb0 20 20 20 20 61 73 73 65 72 74 28 20 6e 4c 6f 63 assert( nLoc
21fc0 61 6c 3c 3d 6e 4b 65 79 20 29 3b 0a 20 20 7d 0a al<=nKey );. }.
21fd0 20 20 2a 70 41 6d 74 20 3d 20 6e 4c 6f 63 61 6c *pAmt = nLocal
21fe0 3b 0a 20 20 72 65 74 75 72 6e 20 61 50 61 79 6c ;. return aPayl
21ff0 6f 61 64 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 46 oad;.}.../*.** F
22000 6f 72 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 or the entry tha
22010 74 20 63 75 72 73 6f 72 20 70 43 75 72 20 69 73 t cursor pCur is
22020 20 70 6f 69 6e 74 20 74 6f 2c 20 72 65 74 75 72 point to, retur
22030 6e 20 61 73 0a 2a 2a 20 6d 61 6e 79 20 62 79 74 n as.** many byt
22040 65 73 20 6f 66 20 74 68 65 20 6b 65 79 20 6f 72 es of the key or
22050 20 64 61 74 61 20 61 73 20 61 72 65 20 61 76 61 data as are ava
22060 69 6c 61 62 6c 65 20 6f 6e 20 74 68 65 20 6c 6f ilable on the lo
22070 63 61 6c 0a 2a 2a 20 62 2d 74 72 65 65 20 70 61 cal.** b-tree pa
22080 67 65 2e 20 20 57 72 69 74 65 20 74 68 65 20 6e ge. Write the n
22090 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 62 umber of availab
220a0 6c 65 20 62 79 74 65 73 20 69 6e 74 6f 20 2a 70 le bytes into *p
220b0 41 6d 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 Amt..**.** The p
220c0 6f 69 6e 74 65 72 20 72 65 74 75 72 6e 65 64 20 ointer returned
220d0 69 73 20 65 70 68 65 6d 65 72 61 6c 2e 20 20 54 is ephemeral. T
220e0 68 65 20 6b 65 79 2f 64 61 74 61 20 6d 61 79 20 he key/data may
220f0 6d 6f 76 65 0a 2a 2a 20 6f 72 20 62 65 20 64 65 move.** or be de
22100 73 74 72 6f 79 65 64 20 6f 6e 20 74 68 65 20 6e stroyed on the n
22110 65 78 74 20 63 61 6c 6c 20 74 6f 20 61 6e 79 20 ext call to any
22120 42 74 72 65 65 20 72 6f 75 74 69 6e 65 2c 0a 2a Btree routine,.*
22130 2a 20 69 6e 63 6c 75 64 69 6e 67 20 63 61 6c 6c * including call
22140 73 20 66 72 6f 6d 20 6f 74 68 65 72 20 74 68 72 s from other thr
22150 65 61 64 73 20 61 67 61 69 6e 73 74 20 74 68 65 eads against the
22160 20 73 61 6d 65 20 63 61 63 68 65 2e 0a 2a 2a 20 same cache..**
22170 48 65 6e 63 65 2c 20 61 20 6d 75 74 65 78 20 6f Hence, a mutex o
22180 6e 20 74 68 65 20 42 74 53 68 61 72 65 64 20 73 n the BtShared s
22190 68 6f 75 6c 64 20 62 65 20 68 65 6c 64 20 70 72 hould be held pr
221a0 69 6f 72 20 74 6f 20 63 61 6c 6c 69 6e 67 0a 2a ior to calling.*
221b0 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 2e 0a * this routine..
221c0 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f 75 74 **.** These rout
221d0 69 6e 65 73 20 69 73 20 75 73 65 64 20 74 6f 20 ines is used to
221e0 67 65 74 20 71 75 69 63 6b 20 61 63 63 65 73 73 get quick access
221f0 20 74 6f 20 6b 65 79 20 61 6e 64 20 64 61 74 61 to key and data
22200 0a 2a 2a 20 69 6e 20 74 68 65 20 63 6f 6d 6d 6f .** in the commo
22210 6e 20 63 61 73 65 20 77 68 65 72 65 20 6e 6f 20 n case where no
22220 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 overflow pages a
22230 72 65 20 75 73 65 64 2e 0a 2a 2f 0a 63 6f 6e 73 re used..*/.cons
22240 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 42 t void *sqlite3B
22250 74 72 65 65 4b 65 79 46 65 74 63 68 28 42 74 43 treeKeyFetch(BtC
22260 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 ursor *pCur, int
22270 20 2a 70 41 6d 74 29 7b 0a 20 20 63 6f 6e 73 74 *pAmt){. const
22280 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b 0a 20 20 void *p = 0;.
22290 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
222a0 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
222b0 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
222c0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
222d0 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
222e0 78 28 70 43 75 72 29 20 29 3b 0a 20 20 69 66 28 x(pCur) );. if(
222f0 20 41 4c 57 41 59 53 28 70 43 75 72 2d 3e 65 53 ALWAYS(pCur->eS
22300 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
22310 49 44 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 28 ID) ){. p = (
22320 63 6f 6e 73 74 20 76 6f 69 64 2a 29 66 65 74 63 const void*)fetc
22330 68 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 hPayload(pCur, p
22340 41 6d 74 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 Amt, 0);. }. r
22350 65 74 75 72 6e 20 70 3b 0a 7d 0a 63 6f 6e 73 74 eturn p;.}.const
22360 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 42 74 void *sqlite3Bt
22370 72 65 65 44 61 74 61 46 65 74 63 68 28 42 74 43 reeDataFetch(BtC
22380 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 ursor *pCur, int
22390 20 2a 70 41 6d 74 29 7b 0a 20 20 63 6f 6e 73 74 *pAmt){. const
223a0 20 76 6f 69 64 20 2a 70 20 3d 20 30 3b 0a 20 20 void *p = 0;.
223b0 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
223c0 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 75 72 2d mutex_held(pCur-
223d0 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e 6d 75 74 >pBtree->db->mut
223e0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
223f0 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
22400 78 28 70 43 75 72 29 20 29 3b 0a 20 20 69 66 28 x(pCur) );. if(
22410 20 41 4c 57 41 59 53 28 70 43 75 72 2d 3e 65 53 ALWAYS(pCur->eS
22420 74 61 74 65 3d 3d 43 55 52 53 4f 52 5f 56 41 4c tate==CURSOR_VAL
22430 49 44 29 20 29 7b 0a 20 20 20 20 70 20 3d 20 28 ID) ){. p = (
22440 63 6f 6e 73 74 20 76 6f 69 64 2a 29 66 65 74 63 const void*)fetc
22450 68 50 61 79 6c 6f 61 64 28 70 43 75 72 2c 20 70 hPayload(pCur, p
22460 41 6d 74 2c 20 31 29 3b 0a 20 20 7d 0a 20 20 72 Amt, 1);. }. r
22470 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 0a 2f 2a 0a eturn p;.}.../*.
22480 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
22490 6f 72 20 64 6f 77 6e 20 74 6f 20 61 20 6e 65 77 or down to a new
224a0 20 63 68 69 6c 64 20 70 61 67 65 2e 20 20 54 68 child page. Th
224b0 65 20 6e 65 77 50 67 6e 6f 20 61 72 67 75 6d 65 e newPgno argume
224c0 6e 74 20 69 73 20 74 68 65 0a 2a 2a 20 70 61 67 nt is the.** pag
224d0 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 e number of the
224e0 63 68 69 6c 64 20 70 61 67 65 20 74 6f 20 6d 6f child page to mo
224f0 76 65 20 74 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 ve to..**.** Thi
22500 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 s function retur
22510 6e 73 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 ns SQLITE_CORRUP
22520 54 20 69 66 20 74 68 65 20 70 61 67 65 2d 68 65 T if the page-he
22530 61 64 65 72 20 66 6c 61 67 73 20 66 69 65 6c 64 ader flags field
22540 20 6f 66 0a 2a 2a 20 74 68 65 20 6e 65 77 20 63 of.** the new c
22550 68 69 6c 64 20 70 61 67 65 20 64 6f 65 73 20 6e hild page does n
22560 6f 74 20 6d 61 74 63 68 20 74 68 65 20 66 6c 61 ot match the fla
22570 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 gs field of the
22580 70 61 72 65 6e 74 20 28 69 2e 65 2e 0a 2a 2a 20 parent (i.e..**
22590 69 66 20 61 6e 20 69 6e 74 6b 65 79 20 70 61 67 if an intkey pag
225a0 65 20 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 e appears to be
225b0 74 68 65 20 70 61 72 65 6e 74 20 6f 66 20 61 20 the parent of a
225c0 6e 6f 6e 2d 69 6e 74 6b 65 79 20 70 61 67 65 2c non-intkey page,
225d0 20 6f 72 0a 2a 2a 20 76 69 63 65 2d 76 65 72 73 or.** vice-vers
225e0 61 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e a)..*/.static in
225f0 74 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 42 74 t moveToChild(Bt
22600 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 75 33 Cursor *pCur, u3
22610 32 20 6e 65 77 50 67 6e 6f 29 7b 0a 20 20 69 6e 2 newPgno){. in
22620 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 20 3d 20 t rc;. int i =
22630 70 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 4d pCur->iPage;. M
22640 65 6d 50 61 67 65 20 2a 70 4e 65 77 50 61 67 65 emPage *pNewPage
22650 3b 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 ;. BtShared *pB
22660 74 20 3d 20 70 43 75 72 2d 3e 70 42 74 3b 0a 0a t = pCur->pBt;..
22670 20 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 assert( cursor
22680 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 HoldsMutex(pCur)
22690 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 );. assert( pC
226a0 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 ur->eState==CURS
226b0 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 61 73 OR_VALID );. as
226c0 73 65 72 74 28 20 70 43 75 72 2d 3e 69 50 61 67 sert( pCur->iPag
226d0 65 3c 42 54 43 55 52 53 4f 52 5f 4d 41 58 5f 44 e<BTCURSOR_MAX_D
226e0 45 50 54 48 20 29 3b 0a 20 20 69 66 28 20 70 43 EPTH );. if( pC
226f0 75 72 2d 3e 69 50 61 67 65 3e 3d 28 42 54 43 55 ur->iPage>=(BTCU
22700 52 53 4f 52 5f 4d 41 58 5f 44 45 50 54 48 2d 31 RSOR_MAX_DEPTH-1
22710 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ) ){. return
22720 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
22730 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 KPT;. }. rc =
22740 67 65 74 41 6e 64 49 6e 69 74 50 61 67 65 28 70 getAndInitPage(p
22750 42 74 2c 20 6e 65 77 50 67 6e 6f 2c 20 26 70 4e Bt, newPgno, &pN
22760 65 77 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 ewPage);. if( r
22770 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
22780 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 2b pCur->apPage[i+
22790 31 5d 20 3d 20 70 4e 65 77 50 61 67 65 3b 0a 20 1] = pNewPage;.
227a0 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 2b 31 pCur->aiIdx[i+1
227b0 5d 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e 69 ] = 0;. pCur->i
227c0 50 61 67 65 2b 2b 3b 0a 0a 20 20 70 43 75 72 2d Page++;.. pCur-
227d0 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b >info.nSize = 0;
227e0 0a 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b . pCur->validNK
227f0 65 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 4e ey = 0;. if( pN
22800 65 77 50 61 67 65 2d 3e 6e 43 65 6c 6c 3c 31 20 ewPage->nCell<1
22810 7c 7c 20 70 4e 65 77 50 61 67 65 2d 3e 69 6e 74 || pNewPage->int
22820 4b 65 79 21 3d 70 43 75 72 2d 3e 61 70 50 61 67 Key!=pCur->apPag
22830 65 5b 69 5d 2d 3e 69 6e 74 4b 65 79 20 29 7b 0a e[i]->intKey ){.
22840 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
22850 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
22860 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
22870 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 30 ITE_OK;.}..#if 0
22880 0a 2f 2a 0a 2a 2a 20 50 61 67 65 20 70 50 61 72 ./*.** Page pPar
22890 65 6e 74 20 69 73 20 61 6e 20 69 6e 74 65 72 6e ent is an intern
228a0 61 6c 20 28 6e 6f 6e 2d 6c 65 61 66 29 20 74 72 al (non-leaf) tr
228b0 65 65 20 70 61 67 65 2e 20 54 68 69 73 20 66 75 ee page. This fu
228c0 6e 63 74 69 6f 6e 20 0a 2a 2a 20 61 73 73 65 72 nction .** asser
228d0 74 73 20 74 68 61 74 20 70 61 67 65 20 6e 75 6d ts that page num
228e0 62 65 72 20 69 43 68 69 6c 64 20 69 73 20 74 68 ber iChild is th
228f0 65 20 6c 65 66 74 2d 63 68 69 6c 64 20 69 66 20 e left-child if
22900 74 68 65 20 69 49 64 78 27 74 68 0a 2a 2a 20 63 the iIdx'th.** c
22910 65 6c 6c 20 69 6e 20 70 61 67 65 20 70 50 61 72 ell in page pPar
22920 65 6e 74 2e 20 4f 72 2c 20 69 66 20 69 49 64 78 ent. Or, if iIdx
22930 20 69 73 20 65 71 75 61 6c 20 74 6f 20 74 68 65 is equal to the
22940 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
22950 0a 2a 2a 20 63 65 6c 6c 73 20 69 6e 20 70 50 61 .** cells in pPa
22960 72 65 6e 74 2c 20 74 68 61 74 20 70 61 67 65 20 rent, that page
22970 6e 75 6d 62 65 72 20 69 43 68 69 6c 64 20 69 73 number iChild is
22980 20 74 68 65 20 72 69 67 68 74 2d 63 68 69 6c 64 the right-child
22990 20 6f 66 0a 2a 2a 20 74 68 65 20 70 61 67 65 2e of.** the page.
229a0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
229b0 61 73 73 65 72 74 50 61 72 65 6e 74 49 6e 64 65 assertParentInde
229c0 78 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 72 65 x(MemPage *pPare
229d0 6e 74 2c 20 69 6e 74 20 69 49 64 78 2c 20 50 67 nt, int iIdx, Pg
229e0 6e 6f 20 69 43 68 69 6c 64 29 7b 0a 20 20 61 73 no iChild){. as
229f0 73 65 72 74 28 20 69 49 64 78 3c 3d 70 50 61 72 sert( iIdx<=pPar
22a00 65 6e 74 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 ent->nCell );.
22a10 69 66 28 20 69 49 64 78 3d 3d 70 50 61 72 65 6e if( iIdx==pParen
22a20 74 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 t->nCell ){.
22a30 61 73 73 65 72 74 28 20 67 65 74 34 62 79 74 65 assert( get4byte
22a40 28 26 70 50 61 72 65 6e 74 2d 3e 61 44 61 74 61 (&pParent->aData
22a50 5b 70 50 61 72 65 6e 74 2d 3e 68 64 72 4f 66 66 [pParent->hdrOff
22a60 73 65 74 2b 38 5d 29 3d 3d 69 43 68 69 6c 64 20 set+8])==iChild
22a70 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
22a80 61 73 73 65 72 74 28 20 67 65 74 34 62 79 74 65 assert( get4byte
22a90 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 72 65 6e (findCell(pParen
22aa0 74 2c 20 69 49 64 78 29 29 3d 3d 69 43 68 69 6c t, iIdx))==iChil
22ab0 64 20 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6c 73 65 d );. }.}.#else
22ac0 0a 23 20 20 64 65 66 69 6e 65 20 61 73 73 65 72 .# define asser
22ad0 74 50 61 72 65 6e 74 49 6e 64 65 78 28 78 2c 79 tParentIndex(x,y
22ae0 2c 7a 29 20 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ,z) .#endif../*.
22af0 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
22b00 6f 72 20 75 70 20 74 6f 20 74 68 65 20 70 61 72 or up to the par
22b10 65 6e 74 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 ent page..**.**
22b20 70 43 75 72 2d 3e 69 64 78 20 69 73 20 73 65 74 pCur->idx is set
22b30 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 69 6e 64 to the cell ind
22b40 65 78 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 ex that contains
22b50 20 74 68 65 20 70 6f 69 6e 74 65 72 0a 2a 2a 20 the pointer.**
22b60 74 6f 20 74 68 65 20 70 61 67 65 20 77 65 20 61 to the page we a
22b70 72 65 20 63 6f 6d 69 6e 67 20 66 72 6f 6d 2e 20 re coming from.
22b80 20 49 66 20 77 65 20 61 72 65 20 63 6f 6d 69 6e If we are comin
22b90 67 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 72 69 g from the.** ri
22ba0 67 68 74 2d 6d 6f 73 74 20 63 68 69 6c 64 20 70 ght-most child p
22bb0 61 67 65 20 74 68 65 6e 20 70 43 75 72 2d 3e 69 age then pCur->i
22bc0 64 78 20 69 73 20 73 65 74 20 74 6f 20 6f 6e 65 dx is set to one
22bd0 20 6d 6f 72 65 20 74 68 61 6e 0a 2a 2a 20 74 68 more than.** th
22be0 65 20 6c 61 72 67 65 73 74 20 63 65 6c 6c 20 69 e largest cell i
22bf0 6e 64 65 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ndex..*/.static
22c00 76 6f 69 64 20 6d 6f 76 65 54 6f 50 61 72 65 6e void moveToParen
22c10 74 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 t(BtCursor *pCur
22c20 29 7b 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ){. assert( cur
22c30 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
22c40 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ur) );. assert(
22c50 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 pCur->eState==C
22c60 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 URSOR_VALID );.
22c70 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 69 assert( pCur->i
22c80 50 61 67 65 3e 30 20 29 3b 0a 20 20 61 73 73 65 Page>0 );. asse
22c90 72 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 rt( pCur->apPage
22ca0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 3b [pCur->iPage] );
22cb0 0a 0a 20 20 2f 2a 20 55 50 44 41 54 45 3a 20 49 .. /* UPDATE: I
22cc0 74 20 69 73 20 61 63 74 75 61 6c 6c 79 20 70 6f t is actually po
22cd0 73 73 69 62 6c 65 20 66 6f 72 20 74 68 65 20 63 ssible for the c
22ce0 6f 6e 64 69 74 69 6f 6e 20 74 65 73 74 65 64 20 ondition tested
22cf0 62 79 20 74 68 65 20 61 73 73 65 72 74 0a 20 20 by the assert.
22d00 2a 2a 20 62 65 6c 6f 77 20 74 6f 20 62 65 20 75 ** below to be u
22d10 6e 74 72 75 65 20 69 66 20 74 68 65 20 64 61 74 ntrue if the dat
22d20 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 63 6f abase file is co
22d30 72 72 75 70 74 2e 20 54 68 69 73 20 63 61 6e 20 rrupt. This can
22d40 6f 63 63 75 72 20 69 66 0a 20 20 2a 2a 20 6f 6e occur if. ** on
22d50 65 20 63 75 72 73 6f 72 20 68 61 73 20 6d 6f 64 e cursor has mod
22d60 69 66 69 65 64 20 70 61 67 65 20 70 50 61 72 65 ified page pPare
22d70 6e 74 20 77 68 69 6c 65 20 61 20 72 65 66 65 72 nt while a refer
22d80 65 6e 63 65 20 74 6f 20 69 74 20 69 73 20 68 65 ence to it is he
22d90 6c 64 20 0a 20 20 2a 2a 20 62 79 20 61 20 73 65 ld . ** by a se
22da0 63 6f 6e 64 20 63 75 72 73 6f 72 2e 20 57 68 69 cond cursor. Whi
22db0 63 68 20 63 61 6e 20 6f 6e 6c 79 20 68 61 70 70 ch can only happ
22dc0 65 6e 20 69 66 20 61 20 73 69 6e 67 6c 65 20 70 en if a single p
22dd0 61 67 65 20 69 73 20 6c 69 6e 6b 65 64 0a 20 20 age is linked.
22de0 2a 2a 20 69 6e 74 6f 20 6d 6f 72 65 20 74 68 61 ** into more tha
22df0 6e 20 6f 6e 65 20 62 2d 74 72 65 65 20 73 74 72 n one b-tree str
22e00 75 63 74 75 72 65 20 69 6e 20 61 20 63 6f 72 72 ucture in a corr
22e10 75 70 74 20 64 61 74 61 62 61 73 65 2e 20 20 2a upt database. *
22e20 2f 0a 23 69 66 20 30 0a 20 20 61 73 73 65 72 74 /.#if 0. assert
22e30 50 61 72 65 6e 74 49 6e 64 65 78 28 0a 20 20 20 ParentIndex(.
22e40 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
22e50 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2c 20 0a 20 ur->iPage-1], .
22e60 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 pCur->aiIdx[p
22e70 43 75 72 2d 3e 69 50 61 67 65 2d 31 5d 2c 20 0a Cur->iPage-1], .
22e80 20 20 20 20 70 43 75 72 2d 3e 61 70 50 61 67 65 pCur->apPage
22e90 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 70 [pCur->iPage]->p
22ea0 67 6e 6f 0a 20 20 29 3b 0a 23 65 6e 64 69 66 0a gno. );.#endif.
22eb0 20 20 74 65 73 74 63 61 73 65 28 20 70 43 75 72 testcase( pCur
22ec0 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
22ed0 61 67 65 2d 31 5d 20 3e 20 70 43 75 72 2d 3e 61 age-1] > pCur->a
22ee0 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 pPage[pCur->iPag
22ef0 65 2d 31 5d 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 0a e-1]->nCell );..
22f00 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 43 releasePage(pC
22f10 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d ur->apPage[pCur-
22f20 3e 69 50 61 67 65 5d 29 3b 0a 20 20 70 43 75 72 >iPage]);. pCur
22f30 2d 3e 69 50 61 67 65 2d 2d 3b 0a 20 20 70 43 75 ->iPage--;. pCu
22f40 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 r->info.nSize =
22f50 30 3b 0a 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 0;. pCur->valid
22f60 4e 4b 65 79 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a NKey = 0;.}../*.
22f70 2a 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 72 73 ** Move the curs
22f80 6f 72 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 or to point to t
22f90 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 he root page of
22fa0 69 74 73 20 62 2d 74 72 65 65 20 73 74 72 75 63 its b-tree struc
22fb0 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ture..**.** If t
22fc0 68 65 20 74 61 62 6c 65 20 68 61 73 20 61 20 76 he table has a v
22fd0 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 irtual root page
22fe0 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 73 6f , then the curso
22ff0 72 20 69 73 20 6d 6f 76 65 64 20 74 6f 20 70 6f r is moved to po
23000 69 6e 74 0a 2a 2a 20 74 6f 20 74 68 65 20 76 69 int.** to the vi
23010 72 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 rtual root page
23020 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 61 instead of the a
23030 63 74 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 2e ctual root page.
23040 20 41 20 74 61 62 6c 65 20 68 61 73 20 61 0a 2a A table has a.*
23050 2a 20 76 69 72 74 75 61 6c 20 72 6f 6f 74 20 70 * virtual root p
23060 61 67 65 20 77 68 65 6e 20 74 68 65 20 61 63 74 age when the act
23070 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 63 6f ual root page co
23080 6e 74 61 69 6e 73 20 6e 6f 20 63 65 6c 6c 73 20 ntains no cells
23090 61 6e 64 20 61 20 0a 2a 2a 20 73 69 6e 67 6c 65 and a .** single
230a0 20 63 68 69 6c 64 20 70 61 67 65 2e 20 54 68 69 child page. Thi
230b0 73 20 63 61 6e 20 6f 6e 6c 79 20 68 61 70 70 65 s can only happe
230c0 6e 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 n with the table
230d0 20 72 6f 6f 74 65 64 20 61 74 20 70 61 67 65 20 rooted at page
230e0 31 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 1..**.** If the
230f0 62 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 b-tree structure
23100 20 69 73 20 65 6d 70 74 79 2c 20 74 68 65 20 63 is empty, the c
23110 75 72 73 6f 72 20 73 74 61 74 65 20 69 73 20 73 ursor state is s
23120 65 74 20 74 6f 20 0a 2a 2a 20 43 55 52 53 4f 52 et to .** CURSOR
23130 5f 49 4e 56 41 4c 49 44 2e 20 4f 74 68 65 72 77 _INVALID. Otherw
23140 69 73 65 2c 20 74 68 65 20 63 75 72 73 6f 72 20 ise, the cursor
23150 69 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 is set to point
23160 74 6f 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 to the first.**
23170 63 65 6c 6c 20 6c 6f 63 61 74 65 64 20 6f 6e 20 cell located on
23180 74 68 65 20 72 6f 6f 74 20 28 6f 72 20 76 69 72 the root (or vir
23190 74 75 61 6c 20 72 6f 6f 74 29 20 70 61 67 65 20 tual root) page
231a0 61 6e 64 20 74 68 65 20 63 75 72 73 6f 72 20 73 and the cursor s
231b0 74 61 74 65 0a 2a 2a 20 69 73 20 73 65 74 20 74 tate.** is set t
231c0 6f 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 2e 0a o CURSOR_VALID..
231d0 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 73 20 66 75 **.** If this fu
231e0 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 73 nction returns s
231f0 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 69 74 20 uccessfully, it
23200 6d 61 79 20 62 65 20 61 73 73 75 6d 65 64 20 74 may be assumed t
23210 68 61 74 20 74 68 65 0a 2a 2a 20 70 61 67 65 2d hat the.** page-
23220 68 65 61 64 65 72 20 66 6c 61 67 73 20 69 6e 64 header flags ind
23230 69 63 61 74 65 20 74 68 61 74 20 74 68 65 20 5b icate that the [
23240 76 69 72 74 75 61 6c 5d 20 72 6f 6f 74 2d 70 61 virtual] root-pa
23250 67 65 20 69 73 20 74 68 65 20 65 78 70 65 63 74 ge is the expect
23260 65 64 20 0a 2a 2a 20 6b 69 6e 64 20 6f 66 20 62 ed .** kind of b
23270 2d 74 72 65 65 20 70 61 67 65 20 28 69 2e 65 2e -tree page (i.e.
23280 20 69 66 20 77 68 65 6e 20 6f 70 65 6e 69 6e 67 if when opening
23290 20 74 68 65 20 63 75 72 73 6f 72 20 74 68 65 20 the cursor the
232a0 63 61 6c 6c 65 72 20 64 69 64 20 6e 6f 74 0a 2a caller did not.*
232b0 2a 20 73 70 65 63 69 66 79 20 61 20 4b 65 79 49 * specify a KeyI
232c0 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 74 68 nfo structure th
232d0 65 20 66 6c 61 67 73 20 62 79 74 65 20 69 73 20 e flags byte is
232e0 73 65 74 20 74 6f 20 30 78 30 35 20 6f 72 20 30 set to 0x05 or 0
232f0 78 30 44 2c 0a 2a 2a 20 69 6e 64 69 63 61 74 69 x0D,.** indicati
23300 6e 67 20 61 20 74 61 62 6c 65 20 62 2d 74 72 65 ng a table b-tre
23310 65 2c 20 6f 72 20 69 66 20 74 68 65 20 63 61 6c e, or if the cal
23320 6c 65 72 20 64 69 64 20 73 70 65 63 69 66 79 20 ler did specify
23330 61 20 4b 65 79 49 6e 66 6f 20 0a 2a 2a 20 73 74 a KeyInfo .** st
23340 72 75 63 74 75 72 65 20 74 68 65 20 66 6c 61 67 ructure the flag
23350 73 20 62 79 74 65 20 69 73 20 73 65 74 20 74 6f s byte is set to
23360 20 30 78 30 32 20 6f 72 20 30 78 30 41 2c 20 69 0x02 or 0x0A, i
23370 6e 64 69 63 61 74 69 6e 67 20 61 6e 20 69 6e 64 ndicating an ind
23380 65 78 0a 2a 2a 20 62 2d 74 72 65 65 29 2e 0a 2a ex.** b-tree)..*
23390 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 /.static int mov
233a0 65 54 6f 52 6f 6f 74 28 42 74 43 75 72 73 6f 72 eToRoot(BtCursor
233b0 20 2a 70 43 75 72 29 7b 0a 20 20 4d 65 6d 50 61 *pCur){. MemPa
233c0 67 65 20 2a 70 52 6f 6f 74 3b 0a 20 20 69 6e 74 ge *pRoot;. int
233d0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
233e0 0a 20 20 42 74 72 65 65 20 2a 70 20 3d 20 70 43 . Btree *p = pC
233f0 75 72 2d 3e 70 42 74 72 65 65 3b 0a 20 20 42 74 ur->pBtree;. Bt
23400 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 2d Shared *pBt = p-
23410 3e 70 42 74 3b 0a 0a 20 20 61 73 73 65 72 74 28 >pBt;.. assert(
23420 20 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 cursorHoldsMute
23430 78 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 x(pCur) );. ass
23440 65 72 74 28 20 43 55 52 53 4f 52 5f 49 4e 56 41 ert( CURSOR_INVA
23450 4c 49 44 20 3c 20 43 55 52 53 4f 52 5f 52 45 51 LID < CURSOR_REQ
23460 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 73 UIRESEEK );. as
23470 73 65 72 74 28 20 43 55 52 53 4f 52 5f 56 41 4c sert( CURSOR_VAL
23480 49 44 20 20 20 3c 20 43 55 52 53 4f 52 5f 52 45 ID < CURSOR_RE
23490 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 61 QUIRESEEK );. a
234a0 73 73 65 72 74 28 20 43 55 52 53 4f 52 5f 46 41 ssert( CURSOR_FA
234b0 55 4c 54 20 20 20 3e 20 43 55 52 53 4f 52 5f 52 ULT > CURSOR_R
234c0 45 51 55 49 52 45 53 45 45 4b 20 29 3b 0a 20 20 EQUIRESEEK );.
234d0 69 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 if( pCur->eState
234e0 3e 3d 43 55 52 53 4f 52 5f 52 45 51 55 49 52 45 >=CURSOR_REQUIRE
234f0 53 45 45 4b 20 29 7b 0a 20 20 20 20 69 66 28 20 SEEK ){. if(
23500 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
23510 52 53 4f 52 5f 46 41 55 4c 54 20 29 7b 0a 20 20 RSOR_FAULT ){.
23520 20 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 assert( pCur
23530 2d 3e 73 6b 69 70 4e 65 78 74 21 3d 53 51 4c 49 ->skipNext!=SQLI
23540 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 72 TE_OK );. r
23550 65 74 75 72 6e 20 70 43 75 72 2d 3e 73 6b 69 70 eturn pCur->skip
23560 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Next;. }.
23570 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 65 61 sqlite3BtreeClea
23580 72 43 75 72 73 6f 72 28 70 43 75 72 29 3b 0a 20 rCursor(pCur);.
23590 20 7d 0a 0a 20 20 69 66 28 20 70 43 75 72 2d 3e }.. if( pCur->
235a0 69 50 61 67 65 3e 3d 30 20 29 7b 0a 20 20 20 20 iPage>=0 ){.
235b0 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 int i;. for(i
235c0 3d 31 3b 20 69 3c 3d 70 43 75 72 2d 3e 69 50 61 =1; i<=pCur->iPa
235d0 67 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ge; i++){.
235e0 72 65 6c 65 61 73 65 50 61 67 65 28 70 43 75 72 releasePage(pCur
235f0 2d 3e 61 70 50 61 67 65 5b 69 5d 29 3b 0a 20 20 ->apPage[i]);.
23600 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 69 50 }. pCur->iP
23610 61 67 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 age = 0;. }else
23620 20 69 66 28 20 70 43 75 72 2d 3e 70 67 6e 6f 52 if( pCur->pgnoR
23630 6f 6f 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70 43 oot==0 ){. pC
23640 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 55 52 ur->eState = CUR
23650 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 SOR_INVALID;.
23660 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
23670 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 K;. }else{.
23680 72 63 20 3d 20 67 65 74 41 6e 64 49 6e 69 74 50 rc = getAndInitP
23690 61 67 65 28 70 42 74 2c 20 70 43 75 72 2d 3e 70 age(pBt, pCur->p
236a0 67 6e 6f 52 6f 6f 74 2c 20 26 70 43 75 72 2d 3e gnoRoot, &pCur->
236b0 61 70 50 61 67 65 5b 30 5d 29 3b 0a 20 20 20 20 apPage[0]);.
236c0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
236d0 4b 20 29 7b 0a 20 20 20 20 20 20 70 43 75 72 2d K ){. pCur-
236e0 3e 65 53 74 61 74 65 20 3d 20 43 55 52 53 4f 52 >eState = CURSOR
236f0 5f 49 4e 56 41 4c 49 44 3b 0a 20 20 20 20 20 20 _INVALID;.
23700 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
23710 0a 20 20 20 20 70 43 75 72 2d 3e 69 50 61 67 65 . pCur->iPage
23720 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 = 0;.. /* If
23730 20 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 6f 20 pCur->pKeyInfo
23740 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 is not NULL, the
23750 6e 20 74 68 65 20 63 61 6c 6c 65 72 20 74 68 61 n the caller tha
23760 74 20 6f 70 65 6e 65 64 20 74 68 69 73 20 63 75 t opened this cu
23770 72 73 6f 72 0a 20 20 20 20 2a 2a 20 65 78 70 65 rsor. ** expe
23780 63 74 65 64 20 74 6f 20 6f 70 65 6e 20 69 74 20 cted to open it
23790 6f 6e 20 61 6e 20 69 6e 64 65 78 20 62 2d 74 72 on an index b-tr
237a0 65 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 ee. Otherwise, i
237b0 66 20 70 4b 65 79 49 6e 66 6f 20 69 73 0a 20 20 f pKeyInfo is.
237c0 20 20 2a 2a 20 4e 55 4c 4c 2c 20 74 68 65 20 63 ** NULL, the c
237d0 61 6c 6c 65 72 20 65 78 70 65 63 74 73 20 61 20 aller expects a
237e0 74 61 62 6c 65 20 62 2d 74 72 65 65 2e 20 49 66 table b-tree. If
237f0 20 74 68 69 73 20 69 73 20 6e 6f 74 20 74 68 65 this is not the
23800 20 63 61 73 65 2c 0a 20 20 20 20 2a 2a 20 72 65 case,. ** re
23810 74 75 72 6e 20 61 6e 20 53 51 4c 49 54 45 5f 43 turn an SQLITE_C
23820 4f 52 52 55 50 54 20 65 72 72 6f 72 2e 20 20 2a ORRUPT error. *
23830 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 43 /. assert( pC
23840 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 ur->apPage[0]->i
23850 6e 74 4b 65 79 3d 3d 31 20 7c 7c 20 70 43 75 72 ntKey==1 || pCur
23860 2d 3e 61 70 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 ->apPage[0]->int
23870 4b 65 79 3d 3d 30 20 29 3b 0a 20 20 20 20 69 66 Key==0 );. if
23880 28 20 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e 66 ( (pCur->pKeyInf
23890 6f 3d 3d 30 29 21 3d 70 43 75 72 2d 3e 61 70 50 o==0)!=pCur->apP
238a0 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 29 age[0]->intKey )
238b0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 {. return S
238c0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
238d0 50 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 PT;. }. }..
238e0 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 20 /* Assert that
238f0 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 69 73 the root page is
23900 20 6f 66 20 74 68 65 20 63 6f 72 72 65 63 74 20 of the correct
23910 74 79 70 65 2e 20 54 68 69 73 20 6d 75 73 74 20 type. This must
23920 62 65 20 74 68 65 0a 20 20 2a 2a 20 63 61 73 65 be the. ** case
23930 20 61 73 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 as the call to
23940 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 74 68 this function th
23950 61 74 20 6c 6f 61 64 65 64 20 74 68 65 20 72 6f at loaded the ro
23960 6f 74 2d 70 61 67 65 20 28 65 69 74 68 65 72 0a ot-page (either.
23970 20 20 2a 2a 20 74 68 69 73 20 63 61 6c 6c 20 6f ** this call o
23980 72 20 61 20 70 72 65 76 69 6f 75 73 20 69 6e 76 r a previous inv
23990 6f 63 61 74 69 6f 6e 29 20 77 6f 75 6c 64 20 68 ocation) would h
239a0 61 76 65 20 64 65 74 65 63 74 65 64 20 63 6f 72 ave detected cor
239b0 72 75 70 74 69 6f 6e 20 0a 20 20 2a 2a 20 69 66 ruption . ** if
239c0 20 74 68 65 20 61 73 73 75 6d 70 74 69 6f 6e 20 the assumption
239d0 77 65 72 65 20 6e 6f 74 20 74 72 75 65 2c 20 61 were not true, a
239e0 6e 64 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 nd it is not pos
239f0 73 69 62 6c 65 20 66 6f 72 20 74 68 65 20 66 6c sible for the fl
23a00 61 67 73 20 0a 20 20 2a 2a 20 62 79 74 65 20 74 ags . ** byte t
23a10 6f 20 68 61 76 65 20 62 65 65 6e 20 6d 6f 64 69 o have been modi
23a20 66 69 65 64 20 77 68 69 6c 65 20 74 68 69 73 20 fied while this
23a30 63 75 72 73 6f 72 20 69 73 20 68 6f 6c 64 69 6e cursor is holdin
23a40 67 20 61 20 72 65 66 65 72 65 6e 63 65 0a 20 20 g a reference.
23a50 2a 2a 20 74 6f 20 74 68 65 20 70 61 67 65 2e 20 ** to the page.
23a60 20 2a 2f 0a 20 20 70 52 6f 6f 74 20 3d 20 70 43 */. pRoot = pC
23a70 75 72 2d 3e 61 70 50 61 67 65 5b 30 5d 3b 0a 20 ur->apPage[0];.
23a80 20 61 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e assert( pRoot->
23a90 70 67 6e 6f 3d 3d 70 43 75 72 2d 3e 70 67 6e 6f pgno==pCur->pgno
23aa0 52 6f 6f 74 20 29 3b 0a 20 20 61 73 73 65 72 74 Root );. assert
23ab0 28 20 70 52 6f 6f 74 2d 3e 69 73 49 6e 69 74 20 ( pRoot->isInit
23ac0 26 26 20 28 70 43 75 72 2d 3e 70 4b 65 79 49 6e && (pCur->pKeyIn
23ad0 66 6f 3d 3d 30 29 3d 3d 70 52 6f 6f 74 2d 3e 69 fo==0)==pRoot->i
23ae0 6e 74 4b 65 79 20 29 3b 0a 0a 20 20 70 43 75 72 ntKey );.. pCur
23af0 2d 3e 61 69 49 64 78 5b 30 5d 20 3d 20 30 3b 0a ->aiIdx[0] = 0;.
23b00 20 20 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 pCur->info.nSi
23b10 7a 65 20 3d 20 30 3b 0a 20 20 70 43 75 72 2d 3e ze = 0;. pCur->
23b20 61 74 4c 61 73 74 20 3d 20 30 3b 0a 20 20 70 43 atLast = 0;. pC
23b30 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 ur->validNKey =
23b40 30 3b 0a 0a 20 20 69 66 28 20 70 52 6f 6f 74 2d 0;.. if( pRoot-
23b50 3e 6e 43 65 6c 6c 3d 3d 30 20 26 26 20 21 70 52 >nCell==0 && !pR
23b60 6f 6f 74 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 oot->leaf ){.
23b70 20 50 67 6e 6f 20 73 75 62 70 61 67 65 3b 0a 20 Pgno subpage;.
23b80 20 20 20 69 66 28 20 70 52 6f 6f 74 2d 3e 70 67 if( pRoot->pg
23b90 6e 6f 21 3d 31 20 29 20 72 65 74 75 72 6e 20 53 no!=1 ) return S
23ba0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
23bb0 50 54 3b 0a 20 20 20 20 73 75 62 70 61 67 65 20 PT;. subpage
23bc0 3d 20 67 65 74 34 62 79 74 65 28 26 70 52 6f 6f = get4byte(&pRoo
23bd0 74 2d 3e 61 44 61 74 61 5b 70 52 6f 6f 74 2d 3e t->aData[pRoot->
23be0 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 hdrOffset+8]);.
23bf0 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
23c00 3d 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3b 0a = CURSOR_VALID;.
23c10 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 rc = moveToC
23c20 68 69 6c 64 28 70 43 75 72 2c 20 73 75 62 70 61 hild(pCur, subpa
23c30 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 ge);. }else{.
23c40 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d pCur->eState =
23c50 20 28 28 70 52 6f 6f 74 2d 3e 6e 43 65 6c 6c 3e ((pRoot->nCell>
23c60 30 29 3f 43 55 52 53 4f 52 5f 56 41 4c 49 44 3a 0)?CURSOR_VALID:
23c70 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 29 3b CURSOR_INVALID);
23c80 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
23c90 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 ;.}../*.** Move
23ca0 74 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 the cursor down
23cb0 74 6f 20 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 to the left-most
23cc0 20 6c 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 leaf entry bene
23cd0 61 74 68 20 74 68 65 0a 2a 2a 20 65 6e 74 72 79 ath the.** entry
23ce0 20 74 6f 20 77 68 69 63 68 20 69 74 20 69 73 20 to which it is
23cf0 63 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 currently pointi
23d00 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 65 ng..**.** The le
23d10 66 74 2d 6d 6f 73 74 20 6c 65 61 66 20 69 73 20 ft-most leaf is
23d20 74 68 65 20 6f 6e 65 20 77 69 74 68 20 74 68 65 the one with the
23d30 20 73 6d 61 6c 6c 65 73 74 20 6b 65 79 20 2d 20 smallest key -
23d40 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 69 6e 20 the first.** in
23d50 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 2e ascending order.
23d60 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 6d .*/.static int m
23d70 6f 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 42 74 oveToLeftmost(Bt
23d80 43 75 72 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 Cursor *pCur){.
23d90 20 50 67 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e Pgno pgno;. in
23da0 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
23db0 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 ;. MemPage *pPa
23dc0 67 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 ge;.. assert( c
23dd0 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 ursorHoldsMutex(
23de0 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 pCur) );. asser
23df0 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d t( pCur->eState=
23e00 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b =CURSOR_VALID );
23e10 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 . while( rc==SQ
23e20 4c 49 54 45 5f 4f 4b 20 26 26 20 21 28 70 50 61 LITE_OK && !(pPa
23e30 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 ge = pCur->apPag
23e40 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 2d e[pCur->iPage])-
23e50 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 61 73 73 >leaf ){. ass
23e60 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ert( pCur->aiIdx
23e70 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3c 70 50 [pCur->iPage]<pP
23e80 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 age->nCell );.
23e90 20 20 70 67 6e 6f 20 3d 20 67 65 74 34 62 79 74 pgno = get4byt
23ea0 65 28 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 e(findCell(pPage
23eb0 2c 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 , pCur->aiIdx[pC
23ec0 75 72 2d 3e 69 50 61 67 65 5d 29 29 3b 0a 20 20 ur->iPage]));.
23ed0 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 rc = moveToChi
23ee0 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b 0a ld(pCur, pgno);.
23ef0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
23f00 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 .}../*.** Move t
23f10 68 65 20 63 75 72 73 6f 72 20 64 6f 77 6e 20 74 he cursor down t
23f20 6f 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 o the right-most
23f30 20 6c 65 61 66 20 65 6e 74 72 79 20 62 65 6e 65 leaf entry bene
23f40 61 74 68 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 ath the.** page
23f50 74 6f 20 77 68 69 63 68 20 69 74 20 69 73 20 63 to which it is c
23f60 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e urrently pointin
23f70 67 2e 20 20 4e 6f 74 69 63 65 20 74 68 65 20 64 g. Notice the d
23f80 69 66 66 65 72 65 6e 63 65 0a 2a 2a 20 62 65 74 ifference.** bet
23f90 77 65 65 6e 20 6d 6f 76 65 54 6f 4c 65 66 74 6d ween moveToLeftm
23fa0 6f 73 74 28 29 20 61 6e 64 20 6d 6f 76 65 54 6f ost() and moveTo
23fb0 52 69 67 68 74 6d 6f 73 74 28 29 2e 20 20 6d 6f Rightmost(). mo
23fc0 76 65 54 6f 4c 65 66 74 6d 6f 73 74 28 29 0a 2a veToLeftmost().*
23fd0 2a 20 66 69 6e 64 73 20 74 68 65 20 6c 65 66 74 * finds the left
23fe0 2d 6d 6f 73 74 20 65 6e 74 72 79 20 62 65 6e 65 -most entry bene
23ff0 61 74 68 20 74 68 65 20 2a 65 6e 74 72 79 2a 20 ath the *entry*
24000 77 68 65 72 65 61 73 20 6d 6f 76 65 54 6f 52 69 whereas moveToRi
24010 67 68 74 6d 6f 73 74 28 29 0a 2a 2a 20 66 69 6e ghtmost().** fin
24020 64 73 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 ds the right-mos
24030 74 20 65 6e 74 72 79 20 62 65 6e 65 61 74 68 20 t entry beneath
24040 74 68 65 20 2a 70 61 67 65 2a 2e 0a 2a 2a 0a 2a the *page*..**.*
24050 2a 20 54 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 * The right-most
24060 20 65 6e 74 72 79 20 69 73 20 74 68 65 20 6f 6e entry is the on
24070 65 20 77 69 74 68 20 74 68 65 20 6c 61 72 67 65 e with the large
24080 73 74 20 6b 65 79 20 2d 20 74 68 65 20 6c 61 73 st key - the las
24090 74 0a 2a 2a 20 6b 65 79 20 69 6e 20 61 73 63 65 t.** key in asce
240a0 6e 64 69 6e 67 20 6f 72 64 65 72 2e 0a 2a 2f 0a nding order..*/.
240b0 73 74 61 74 69 63 20 69 6e 74 20 6d 6f 76 65 54 static int moveT
240c0 6f 52 69 67 68 74 6d 6f 73 74 28 42 74 43 75 72 oRightmost(BtCur
240d0 73 6f 72 20 2a 70 43 75 72 29 7b 0a 20 20 50 67 sor *pCur){. Pg
240e0 6e 6f 20 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 no pgno;. int r
240f0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
24100 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 MemPage *pPage
24110 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 = 0;.. assert(
24120 63 75 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 cursorHoldsMutex
24130 28 70 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 (pCur) );. asse
24140 72 74 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 rt( pCur->eState
24150 3d 3d 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 29 ==CURSOR_VALID )
24160 3b 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 ;. while( rc==S
24170 51 4c 49 54 45 5f 4f 4b 20 26 26 20 21 28 70 50 QLITE_OK && !(pP
24180 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
24190 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 29 ge[pCur->iPage])
241a0 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 70 67 ->leaf ){. pg
241b0 6e 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 no = get4byte(&p
241c0 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 Page->aData[pPag
241d0 65 2d 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 e->hdrOffset+8])
241e0 3b 0a 20 20 20 20 70 43 75 72 2d 3e 61 69 49 64 ;. pCur->aiId
241f0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d x[pCur->iPage] =
24200 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3b 0a 20 pPage->nCell;.
24210 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 43 68 rc = moveToCh
24220 69 6c 64 28 70 43 75 72 2c 20 70 67 6e 6f 29 3b ild(pCur, pgno);
24230 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 . }. if( rc==S
24240 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
24250 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 pCur->aiIdx[pCur
24260 2d 3e 69 50 61 67 65 5d 20 3d 20 70 50 61 67 65 ->iPage] = pPage
24270 2d 3e 6e 43 65 6c 6c 2d 31 3b 0a 20 20 20 20 70 ->nCell-1;. p
24280 43 75 72 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 Cur->info.nSize
24290 3d 20 30 3b 0a 20 20 20 20 70 43 75 72 2d 3e 76 = 0;. pCur->v
242a0 61 6c 69 64 4e 4b 65 79 20 3d 20 30 3b 0a 20 20 alidNKey = 0;.
242b0 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
242c0 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 63 75 ../* Move the cu
242d0 72 73 6f 72 20 74 6f 20 74 68 65 20 66 69 72 73 rsor to the firs
242e0 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 t entry in the t
242f0 61 62 6c 65 2e 20 20 52 65 74 75 72 6e 20 53 51 able. Return SQ
24300 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 6f 6e 20 73 75 LITE_OK.** on su
24310 63 63 65 73 73 2e 20 20 53 65 74 20 2a 70 52 65 ccess. Set *pRe
24320 73 20 74 6f 20 30 20 69 66 20 74 68 65 20 63 75 s to 0 if the cu
24330 72 73 6f 72 20 61 63 74 75 61 6c 6c 79 20 70 6f rsor actually po
24340 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e ints to somethin
24350 67 0a 2a 2a 20 6f 72 20 73 65 74 20 2a 70 52 65 g.** or set *pRe
24360 73 20 74 6f 20 31 20 69 66 20 74 68 65 20 74 61 s to 1 if the ta
24370 62 6c 65 20 69 73 20 65 6d 70 74 79 2e 0a 2a 2f ble is empty..*/
24380 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
24390 65 46 69 72 73 74 28 42 74 43 75 72 73 6f 72 20 eFirst(BtCursor
243a0 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 52 65 73 *pCur, int *pRes
243b0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 ){. int rc;..
243c0 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f assert( cursorHo
243d0 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 ldsMutex(pCur) )
243e0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
243f0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
24400 43 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d Cur->pBtree->db-
24410 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20 >mutex) );. rc
24420 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 70 43 75 = moveToRoot(pCu
24430 72 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 r);. if( rc==SQ
24440 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 LITE_OK ){. i
24450 66 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d f( pCur->eState=
24460 3d 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 =CURSOR_INVALID
24470 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 ){. assert(
24480 20 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d pCur->pgnoRoot=
24490 3d 30 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 =0 || pCur->apPa
244a0 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d ge[pCur->iPage]-
244b0 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 20 20 >nCell==0 );.
244c0 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 *pRes = 1;.
244d0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 }else{. a
244e0 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 70 50 ssert( pCur->apP
244f0 61 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d age[pCur->iPage]
24500 2d 3e 6e 43 65 6c 6c 3e 30 20 29 3b 0a 20 20 20 ->nCell>0 );.
24510 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 *pRes = 0;.
24520 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c rc = moveToL
24530 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 eftmost(pCur);.
24540 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
24550 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 n rc;.}../* Move
24560 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f 20 74 the cursor to t
24570 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e he last entry in
24580 20 74 68 65 20 74 61 62 6c 65 2e 20 20 52 65 74 the table. Ret
24590 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a urn SQLITE_OK.**
245a0 20 6f 6e 20 73 75 63 63 65 73 73 2e 20 20 53 65 on success. Se
245b0 74 20 2a 70 52 65 73 20 74 6f 20 30 20 69 66 20 t *pRes to 0 if
245c0 74 68 65 20 63 75 72 73 6f 72 20 61 63 74 75 61 the cursor actua
245d0 6c 6c 79 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f lly points to so
245e0 6d 65 74 68 69 6e 67 0a 2a 2a 20 6f 72 20 73 65 mething.** or se
245f0 74 20 2a 70 52 65 73 20 74 6f 20 31 20 69 66 20 t *pRes to 1 if
24600 74 68 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 the table is emp
24610 74 79 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ty..*/.int sqlit
24620 65 33 42 74 72 65 65 4c 61 73 74 28 42 74 43 75 e3BtreeLast(BtCu
24630 72 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 rsor *pCur, int
24640 2a 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 *pRes){. int rc
24650 3b 0a 20 0a 20 20 61 73 73 65 72 74 28 20 63 75 ;. . assert( cu
24660 72 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 rsorHoldsMutex(p
24670 43 75 72 29 20 29 3b 0a 20 20 61 73 73 65 72 74 Cur) );. assert
24680 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
24690 68 65 6c 64 28 70 43 75 72 2d 3e 70 42 74 72 65 held(pCur->pBtre
246a0 65 2d 3e 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b e->db->mutex) );
246b0 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 63 75 .. /* If the cu
246c0 72 73 6f 72 20 61 6c 72 65 61 64 79 20 70 6f 69 rsor already poi
246d0 6e 74 73 20 74 6f 20 74 68 65 20 6c 61 73 74 20 nts to the last
246e0 65 6e 74 72 79 2c 20 74 68 69 73 20 69 73 20 61 entry, this is a
246f0 20 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 no-op. */. if(
24700 20 43 55 52 53 4f 52 5f 56 41 4c 49 44 3d 3d 70 CURSOR_VALID==p
24710 43 75 72 2d 3e 65 53 74 61 74 65 20 26 26 20 70 Cur->eState && p
24720 43 75 72 2d 3e 61 74 4c 61 73 74 20 29 7b 0a 23 Cur->atLast ){.#
24730 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
24740 55 47 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 62 UG. /* This b
24750 6c 6f 63 6b 20 73 65 72 76 65 73 20 74 6f 20 61 lock serves to a
24760 73 73 65 72 74 28 29 20 74 68 61 74 20 74 68 65 ssert() that the
24770 20 63 75 72 73 6f 72 20 72 65 61 6c 6c 79 20 64 cursor really d
24780 6f 65 73 20 70 6f 69 6e 74 20 0a 20 20 20 20 2a oes point . *
24790 2a 20 74 6f 20 74 68 65 20 6c 61 73 74 20 65 6e * to the last en
247a0 74 72 79 20 69 6e 20 74 68 65 20 62 2d 74 72 65 try in the b-tre
247b0 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 69 e. */. int ii
247c0 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 ;. for(ii=0;
247d0 69 69 3c 70 43 75 72 2d 3e 69 50 61 67 65 3b 20 ii<pCur->iPage;
247e0 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 73 73 ii++){. ass
247f0 65 72 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 ert( pCur->aiIdx
24800 5b 69 69 5d 3d 3d 70 43 75 72 2d 3e 61 70 50 61 [ii]==pCur->apPa
24810 67 65 5b 69 69 5d 2d 3e 6e 43 65 6c 6c 20 29 3b ge[ii]->nCell );
24820 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 . }. asser
24830 74 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 t( pCur->aiIdx[p
24840 43 75 72 2d 3e 69 50 61 67 65 5d 3d 3d 70 43 75 Cur->iPage]==pCu
24850 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
24860 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 2d 31 20 iPage]->nCell-1
24870 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
24880 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
24890 2d 3e 69 50 61 67 65 5d 2d 3e 6c 65 61 66 20 29 ->iPage]->leaf )
248a0 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74 ;.#endif. ret
248b0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
248c0 20 7d 0a 0a 20 20 72 63 20 3d 20 6d 6f 76 65 54 }.. rc = moveT
248d0 6f 52 6f 6f 74 28 70 43 75 72 29 3b 0a 20 20 69 oRoot(pCur);. i
248e0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
248f0 20 29 7b 0a 20 20 20 20 69 66 28 20 43 55 52 53 ){. if( CURS
24900 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 OR_INVALID==pCur
24910 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 20 20 ->eState ){.
24920 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e assert( pCur->
24930 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 pgnoRoot==0 || p
24940 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 Cur->apPage[pCur
24950 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d ->iPage]->nCell=
24960 3d 30 20 29 3b 0a 20 20 20 20 20 20 2a 70 52 65 =0 );. *pRe
24970 73 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 s = 1;. }else
24980 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
24990 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
249a0 52 53 4f 52 5f 56 41 4c 49 44 20 29 3b 0a 20 20 RSOR_VALID );.
249b0 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
249c0 20 20 20 20 20 72 63 20 3d 20 6d 6f 76 65 54 6f rc = moveTo
249d0 52 69 67 68 74 6d 6f 73 74 28 70 43 75 72 29 3b Rightmost(pCur);
249e0 0a 20 20 20 20 20 20 70 43 75 72 2d 3e 61 74 4c . pCur->atL
249f0 61 73 74 20 3d 20 72 63 3d 3d 53 51 4c 49 54 45 ast = rc==SQLITE
24a00 5f 4f 4b 20 3f 31 3a 30 3b 0a 20 20 20 20 7d 0a _OK ?1:0;. }.
24a10 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
24a20 0a 7d 0a 0a 2f 2a 20 4d 6f 76 65 20 74 68 65 20 .}../* Move the
24a30 63 75 72 73 6f 72 20 73 6f 20 74 68 61 74 20 69 cursor so that i
24a40 74 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 t points to an e
24a50 6e 74 72 79 20 6e 65 61 72 20 74 68 65 20 6b 65 ntry near the ke
24a60 79 20 0a 2a 2a 20 73 70 65 63 69 66 69 65 64 20 y .** specified
24a70 62 79 20 70 49 64 78 4b 65 79 20 6f 72 20 69 6e by pIdxKey or in
24a80 74 4b 65 79 2e 20 20 20 52 65 74 75 72 6e 20 61 tKey. Return a
24a90 20 73 75 63 63 65 73 73 20 63 6f 64 65 2e 0a 2a success code..*
24aa0 2a 0a 2a 2a 20 46 6f 72 20 49 4e 54 4b 45 59 20 *.** For INTKEY
24ab0 74 61 62 6c 65 73 2c 20 74 68 65 20 69 6e 74 4b tables, the intK
24ac0 65 79 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 ey parameter is
24ad0 75 73 65 64 2e 20 20 70 49 64 78 4b 65 79 20 0a used. pIdxKey .
24ae0 2a 2a 20 6d 75 73 74 20 62 65 20 4e 55 4c 4c 2e ** must be NULL.
24af0 20 20 46 6f 72 20 69 6e 64 65 78 20 74 61 62 6c For index tabl
24b00 65 73 2c 20 70 49 64 78 4b 65 79 20 69 73 20 75 es, pIdxKey is u
24b10 73 65 64 20 61 6e 64 20 69 6e 74 4b 65 79 0a 2a sed and intKey.*
24b20 2a 20 69 73 20 69 67 6e 6f 72 65 64 2e 0a 2a 2a * is ignored..**
24b30 0a 2a 2a 20 49 66 20 61 6e 20 65 78 61 63 74 20 .** If an exact
24b40 6d 61 74 63 68 20 69 73 20 6e 6f 74 20 66 6f 75 match is not fou
24b50 6e 64 2c 20 74 68 65 6e 20 74 68 65 20 63 75 72 nd, then the cur
24b60 73 6f 72 20 69 73 20 61 6c 77 61 79 73 0a 2a 2a sor is always.**
24b70 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 left pointing a
24b80 74 20 61 20 6c 65 61 66 20 70 61 67 65 20 77 68 t a leaf page wh
24b90 69 63 68 20 77 6f 75 6c 64 20 68 6f 6c 64 20 74 ich would hold t
24ba0 68 65 20 65 6e 74 72 79 20 69 66 20 69 74 0a 2a he entry if it.*
24bb0 2a 20 77 65 72 65 20 70 72 65 73 65 6e 74 2e 20 * were present.
24bc0 20 54 68 65 20 63 75 72 73 6f 72 20 6d 69 67 68 The cursor migh
24bd0 74 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20 65 6e t point to an en
24be0 74 72 79 20 74 68 61 74 20 63 6f 6d 65 73 0a 2a try that comes.*
24bf0 2a 20 62 65 66 6f 72 65 20 6f 72 20 61 66 74 65 * before or afte
24c00 72 20 74 68 65 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a r the key..**.**
24c10 20 41 6e 20 69 6e 74 65 67 65 72 20 69 73 20 77 An integer is w
24c20 72 69 74 74 65 6e 20 69 6e 74 6f 20 2a 70 52 65 ritten into *pRe
24c30 73 20 77 68 69 63 68 20 69 73 20 74 68 65 20 72 s which is the r
24c40 65 73 75 6c 74 20 6f 66 0a 2a 2a 20 63 6f 6d 70 esult of.** comp
24c50 61 72 69 6e 67 20 74 68 65 20 6b 65 79 20 77 69 aring the key wi
24c60 74 68 20 74 68 65 20 65 6e 74 72 79 20 74 6f 20 th the entry to
24c70 77 68 69 63 68 20 74 68 65 20 63 75 72 73 6f 72 which the cursor
24c80 20 69 73 20 0a 2a 2a 20 70 6f 69 6e 74 69 6e 67 is .** pointing
24c90 2e 20 20 54 68 65 20 6d 65 61 6e 69 6e 67 20 6f . The meaning o
24ca0 66 20 74 68 65 20 69 6e 74 65 67 65 72 20 77 72 f the integer wr
24cb0 69 74 74 65 6e 20 69 6e 74 6f 0a 2a 2a 20 2a 70 itten into.** *p
24cc0 52 65 73 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 Res is as follow
24cd0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 s:.**.** *pR
24ce0 65 73 3c 30 20 20 20 20 20 20 54 68 65 20 63 75 es<0 The cu
24cf0 72 73 6f 72 20 69 73 20 6c 65 66 74 20 70 6f 69 rsor is left poi
24d00 6e 74 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 nting at an entr
24d10 79 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 y that.**
24d20 20 20 20 20 20 20 20 20 20 20 20 69 73 20 73 6d is sm
24d30 61 6c 6c 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 aller than intKe
24d40 79 2f 70 49 64 78 4b 65 79 20 6f 72 20 69 66 20 y/pIdxKey or if
24d50 74 68 65 20 74 61 62 6c 65 20 69 73 20 65 6d 70 the table is emp
24d60 74 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 ty.**
24d70 20 20 20 20 20 20 20 61 6e 64 20 74 68 65 20 63 and the c
24d80 75 72 73 6f 72 20 69 73 20 74 68 65 72 65 66 6f ursor is therefo
24d90 72 65 20 6c 65 66 74 20 70 6f 69 6e 74 20 74 6f re left point to
24da0 20 6e 6f 74 68 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 nothing..**.**
24db0 20 20 20 20 2a 70 52 65 73 3d 3d 30 20 20 20 20 *pRes==0
24dc0 20 54 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c The cursor is l
24dd0 65 66 74 20 70 6f 69 6e 74 69 6e 67 20 61 74 20 eft pointing at
24de0 61 6e 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a an entry that.**
24df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24e00 20 20 65 78 61 63 74 6c 79 20 6d 61 74 63 68 65 exactly matche
24e10 73 20 69 6e 74 4b 65 79 2f 70 49 64 78 4b 65 79 s intKey/pIdxKey
24e20 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 2a 70 52 65 ..**.** *pRe
24e30 73 3e 30 20 20 20 20 20 20 54 68 65 20 63 75 72 s>0 The cur
24e40 73 6f 72 20 69 73 20 6c 65 66 74 20 70 6f 69 6e sor is left poin
24e50 74 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 ting at an entry
24e60 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 that.**
24e70 20 20 20 20 20 20 20 20 20 20 69 73 20 6c 61 72 is lar
24e80 67 65 72 20 74 68 61 6e 20 69 6e 74 4b 65 79 2f ger than intKey/
24e90 70 49 64 78 4b 65 79 2e 0a 2a 2a 0a 2a 2f 0a 69 pIdxKey..**.*/.i
24ea0 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d nt sqlite3BtreeM
24eb0 6f 76 65 74 6f 55 6e 70 61 63 6b 65 64 28 0a 20 ovetoUnpacked(.
24ec0 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c BtCursor *pCur,
24ed0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
24ee0 20 63 75 72 73 6f 72 20 74 6f 20 62 65 20 6d 6f cursor to be mo
24ef0 76 65 64 20 2a 2f 0a 20 20 55 6e 70 61 63 6b 65 ved */. Unpacke
24f00 64 52 65 63 6f 72 64 20 2a 70 49 64 78 4b 65 79 dRecord *pIdxKey
24f10 2c 20 2f 2a 20 55 6e 70 61 63 6b 65 64 20 69 6e , /* Unpacked in
24f20 64 65 78 20 6b 65 79 20 2a 2f 0a 20 20 69 36 34 dex key */. i64
24f30 20 69 6e 74 4b 65 79 2c 20 20 20 20 20 20 20 20 intKey,
24f40 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 61 62 /* The tab
24f50 6c 65 20 6b 65 79 20 2a 2f 0a 20 20 69 6e 74 20 le key */. int
24f60 62 69 61 73 52 69 67 68 74 2c 20 20 20 20 20 20 biasRight,
24f70 20 20 20 20 20 2f 2a 20 49 66 20 74 72 75 65 2c /* If true,
24f80 20 62 69 61 73 20 74 68 65 20 73 65 61 72 63 68 bias the search
24f90 20 74 6f 20 74 68 65 20 68 69 67 68 20 65 6e 64 to the high end
24fa0 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 52 65 73 20 */. int *pRes
24fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24fc0 2a 20 57 72 69 74 65 20 73 65 61 72 63 68 20 72 * Write search r
24fd0 65 73 75 6c 74 73 20 68 65 72 65 20 2a 2f 0a 29 esults here */.)
24fe0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 {. int rc;.. a
24ff0 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 6f 6c ssert( cursorHol
25000 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 29 3b dsMutex(pCur) );
25010 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 . assert( sqlit
25020 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 43 e3_mutex_held(pC
25030 75 72 2d 3e 70 42 74 72 65 65 2d 3e 64 62 2d 3e ur->pBtree->db->
25040 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 mutex) );. asse
25050 72 74 28 20 70 52 65 73 20 29 3b 0a 20 20 61 73 rt( pRes );. as
25060 73 65 72 74 28 20 28 70 49 64 78 4b 65 79 3d 3d sert( (pIdxKey==
25070 30 29 3d 3d 28 70 43 75 72 2d 3e 70 4b 65 79 49 0)==(pCur->pKeyI
25080 6e 66 6f 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a nfo==0) );.. /*
25090 20 49 66 20 74 68 65 20 63 75 72 73 6f 72 20 69 If the cursor i
250a0 73 20 61 6c 72 65 61 64 79 20 70 6f 73 69 74 69 s already positi
250b0 6f 6e 65 64 20 61 74 20 74 68 65 20 70 6f 69 6e oned at the poin
250c0 74 20 77 65 20 61 72 65 20 74 72 79 69 6e 67 0a t we are trying.
250d0 20 20 2a 2a 20 74 6f 20 6d 6f 76 65 20 74 6f 2c ** to move to,
250e0 20 74 68 65 6e 20 6a 75 73 74 20 72 65 74 75 72 then just retur
250f0 6e 20 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 n without doing
25100 61 6e 79 20 77 6f 72 6b 20 2a 2f 0a 20 20 69 66 any work */. if
25110 28 20 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d ( pCur->eState==
25120 43 55 52 53 4f 52 5f 56 41 4c 49 44 20 26 26 20 CURSOR_VALID &&
25130 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 pCur->validNKey
25140 0a 20 20 20 26 26 20 70 43 75 72 2d 3e 61 70 50 . && pCur->apP
25150 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 0a age[0]->intKey .
25160 20 20 29 7b 0a 20 20 20 20 69 66 28 20 70 43 75 ){. if( pCu
25170 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3d 3d 69 6e r->info.nKey==in
25180 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a 70 tKey ){. *p
25190 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 Res = 0;. r
251a0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
251b0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
251c0 43 75 72 2d 3e 61 74 4c 61 73 74 20 26 26 20 70 Cur->atLast && p
251d0 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 3c 69 Cur->info.nKey<i
251e0 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 2a ntKey ){. *
251f0 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 20 pRes = -1;.
25200 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
25210 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 K;. }. }..
25220 72 63 20 3d 20 6d 6f 76 65 54 6f 52 6f 6f 74 28 rc = moveToRoot(
25230 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 20 pCur);. if( rc
25240 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 ){. return rc
25250 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
25260 70 43 75 72 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d pCur->pgnoRoot==
25270 30 20 7c 7c 20 70 43 75 72 2d 3e 61 70 50 61 67 0 || pCur->apPag
25280 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 20 29 e[pCur->iPage] )
25290 3b 0a 20 20 61 73 73 65 72 74 28 20 70 43 75 72 ;. assert( pCur
252a0 2d 3e 70 67 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c ->pgnoRoot==0 ||
252b0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
252c0 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 69 73 49 6e ur->iPage]->isIn
252d0 69 74 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 it );. assert(
252e0 70 43 75 72 2d 3e 65 53 74 61 74 65 3d 3d 43 55 pCur->eState==CU
252f0 52 53 4f 52 5f 49 4e 56 41 4c 49 44 20 7c 7c 20 RSOR_INVALID ||
25300 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 pCur->apPage[pCu
25310 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c r->iPage]->nCell
25320 3e 30 20 29 3b 0a 20 20 69 66 28 20 70 43 75 72 >0 );. if( pCur
25330 2d 3e 65 53 74 61 74 65 3d 3d 43 55 52 53 4f 52 ->eState==CURSOR
25340 5f 49 4e 56 41 4c 49 44 20 29 7b 0a 20 20 20 20 _INVALID ){.
25350 2a 70 52 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 *pRes = -1;.
25360 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 70 67 assert( pCur->pg
25370 6e 6f 52 6f 6f 74 3d 3d 30 20 7c 7c 20 70 43 75 noRoot==0 || pCu
25380 72 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e r->apPage[pCur->
25390 69 50 61 67 65 5d 2d 3e 6e 43 65 6c 6c 3d 3d 30 iPage]->nCell==0
253a0 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 );. return S
253b0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 QLITE_OK;. }.
253c0 61 73 73 65 72 74 28 20 70 43 75 72 2d 3e 61 70 assert( pCur->ap
253d0 50 61 67 65 5b 30 5d 2d 3e 69 6e 74 4b 65 79 20 Page[0]->intKey
253e0 7c 7c 20 70 49 64 78 4b 65 79 20 29 3b 0a 20 20 || pIdxKey );.
253f0 66 6f 72 28 3b 3b 29 7b 0a 20 20 20 20 69 6e 74 for(;;){. int
25400 20 6c 77 72 2c 20 75 70 72 2c 20 69 64 78 3b 0a lwr, upr, idx;.
25410 20 20 20 20 50 67 6e 6f 20 63 68 6c 64 50 67 3b Pgno chldPg;
25420 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 . MemPage *pP
25430 61 67 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 age = pCur->apPa
25440 67 65 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b ge[pCur->iPage];
25450 0a 20 20 20 20 69 6e 74 20 63 3b 0a 0a 20 20 20 . int c;..
25460 20 2f 2a 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c /* pPage->nCell
25470 20 6d 75 73 74 20 62 65 20 67 72 65 61 74 65 72 must be greater
25480 20 74 68 61 6e 20 7a 65 72 6f 2e 20 49 66 20 74 than zero. If t
25490 68 69 73 20 69 73 20 74 68 65 20 72 6f 6f 74 2d his is the root-
254a0 70 61 67 65 0a 20 20 20 20 2a 2a 20 74 68 65 20 page. ** the
254b0 63 75 72 73 6f 72 20 77 6f 75 6c 64 20 68 61 76 cursor would hav
254c0 65 20 62 65 65 6e 20 49 4e 56 41 4c 49 44 20 61 e been INVALID a
254d0 62 6f 76 65 20 61 6e 64 20 74 68 69 73 20 66 6f bove and this fo
254e0 72 28 3b 3b 29 20 6c 6f 6f 70 0a 20 20 20 20 2a r(;;) loop. *
254f0 2a 20 6e 6f 74 20 72 75 6e 2e 20 49 66 20 74 68 * not run. If th
25500 69 73 20 69 73 20 6e 6f 74 20 74 68 65 20 72 6f is is not the ro
25510 6f 74 2d 70 61 67 65 2c 20 74 68 65 6e 20 74 68 ot-page, then th
25520 65 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 29 20 e moveToChild()
25530 72 6f 75 74 69 6e 65 0a 20 20 20 20 2a 2a 20 77 routine. ** w
25540 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 ould have alread
25550 79 20 64 65 74 65 63 74 65 64 20 64 62 20 63 6f y detected db co
25560 72 72 75 70 74 69 6f 6e 2e 20 53 69 6d 69 6c 61 rruption. Simila
25570 72 6c 79 2c 20 70 50 61 67 65 20 6d 75 73 74 0a rly, pPage must.
25580 20 20 20 20 2a 2a 20 62 65 20 74 68 65 20 72 69 ** be the ri
25590 67 68 74 20 6b 69 6e 64 20 28 69 6e 64 65 78 20 ght kind (index
255a0 6f 72 20 74 61 62 6c 65 29 20 6f 66 20 62 2d 74 or table) of b-t
255b0 72 65 65 20 70 61 67 65 2e 20 4f 74 68 65 72 77 ree page. Otherw
255c0 69 73 65 0a 20 20 20 20 2a 2a 20 61 20 6d 6f 76 ise. ** a mov
255d0 65 54 6f 43 68 69 6c 64 28 29 20 6f 72 20 6d 6f eToChild() or mo
255e0 76 65 54 6f 52 6f 6f 74 28 29 20 63 61 6c 6c 20 veToRoot() call
255f0 77 6f 75 6c 64 20 68 61 76 65 20 64 65 74 65 63 would have detec
25600 74 65 64 20 63 6f 72 72 75 70 74 69 6f 6e 2e 20 ted corruption.
25610 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 */. assert(
25620 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3e 30 20 29 pPage->nCell>0 )
25630 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
25640 61 67 65 2d 3e 69 6e 74 4b 65 79 3d 3d 28 70 49 age->intKey==(pI
25650 64 78 4b 65 79 3d 3d 30 29 20 29 3b 0a 20 20 20 dxKey==0) );.
25660 20 6c 77 72 20 3d 20 30 3b 0a 20 20 20 20 75 70 lwr = 0;. up
25670 72 20 3d 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c r = pPage->nCell
25680 2d 31 3b 0a 20 20 20 20 69 66 28 20 62 69 61 73 -1;. if( bias
25690 52 69 67 68 74 20 29 7b 0a 20 20 20 20 20 20 70 Right ){. p
256a0 43 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d Cur->aiIdx[pCur-
256b0 3e 69 50 61 67 65 5d 20 3d 20 28 75 31 36 29 28 >iPage] = (u16)(
256c0 69 64 78 20 3d 20 75 70 72 29 3b 0a 20 20 20 20 idx = upr);.
256d0 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 43 75 }else{. pCu
256e0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
256f0 50 61 67 65 5d 20 3d 20 28 75 31 36 29 28 69 64 Page] = (u16)(id
25700 78 20 3d 20 28 75 70 72 2b 6c 77 72 29 2f 32 29 x = (upr+lwr)/2)
25710 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 ;. }. for(
25720 3b 3b 29 7b 0a 20 20 20 20 20 20 75 38 20 2a 70 ;;){. u8 *p
25730 43 65 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Cell;
25740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
25750 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 63 75 72 * Pointer to cur
25760 72 65 6e 74 20 63 65 6c 6c 20 69 6e 20 70 50 61 rent cell in pPa
25770 67 65 20 2a 2f 0a 0a 20 20 20 20 20 20 61 73 73 ge */.. ass
25780 65 72 74 28 20 69 64 78 3d 3d 70 43 75 72 2d 3e ert( idx==pCur->
25790 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 67 aiIdx[pCur->iPag
257a0 65 5d 20 29 3b 0a 20 20 20 20 20 20 70 43 75 72 e] );. pCur
257b0 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
257c0 3b 0a 20 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 ;. pCell =
257d0 66 69 6e 64 43 65 6c 6c 28 70 50 61 67 65 2c 20 findCell(pPage,
257e0 69 64 78 29 20 2b 20 70 50 61 67 65 2d 3e 63 68 idx) + pPage->ch
257f0 69 6c 64 50 74 72 53 69 7a 65 3b 0a 20 20 20 20 ildPtrSize;.
25800 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 if( pPage->int
25810 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 69 Key ){. i
25820 36 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 64 nCellKey;.
25830 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e if( pPage->
25840 68 61 73 44 61 74 61 20 29 7b 0a 20 20 20 20 20 hasData ){.
25850 20 20 20 20 20 75 33 32 20 64 75 6d 6d 79 3b 0a u32 dummy;.
25860 20 20 20 20 20 20 20 20 20 20 70 43 65 6c 6c 20 pCell
25870 2b 3d 20 67 65 74 56 61 72 69 6e 74 33 32 28 70 += getVarint32(p
25880 43 65 6c 6c 2c 20 64 75 6d 6d 79 29 3b 0a 20 20 Cell, dummy);.
25890 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
258a0 67 65 74 56 61 72 69 6e 74 28 70 43 65 6c 6c 2c getVarint(pCell,
258b0 20 28 75 36 34 2a 29 26 6e 43 65 6c 6c 4b 65 79 (u64*)&nCellKey
258c0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e );. if( n
258d0 43 65 6c 6c 4b 65 79 3d 3d 69 6e 74 4b 65 79 20 CellKey==intKey
258e0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63 20 3d ){. c =
258f0 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 0;. }els
25900 65 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 69 e if( nCellKey<i
25910 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 ntKey ){.
25920 20 20 20 63 20 3d 20 2d 31 3b 0a 20 20 20 20 20 c = -1;.
25930 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
25940 20 20 20 20 61 73 73 65 72 74 28 20 6e 43 65 6c assert( nCel
25950 6c 4b 65 79 3e 69 6e 74 4b 65 79 20 29 3b 0a 20 lKey>intKey );.
25960 20 20 20 20 20 20 20 20 20 63 20 3d 20 2b 31 3b c = +1;
25970 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
25980 20 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b pCur->validNK
25990 65 79 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 ey = 1;.
259a0 70 43 75 72 2d 3e 69 6e 66 6f 2e 6e 4b 65 79 20 pCur->info.nKey
259b0 3d 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 = nCellKey;.
259c0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
259d0 20 2f 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 /* The maximum
259e0 73 75 70 70 6f 72 74 65 64 20 70 61 67 65 2d 73 supported page-s
259f0 69 7a 65 20 69 73 20 36 35 35 33 36 20 62 79 74 ize is 65536 byt
25a00 65 73 2e 20 54 68 69 73 20 6d 65 61 6e 73 20 74 es. This means t
25a10 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 hat. ** t
25a20 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 he maximum numbe
25a30 72 20 6f 66 20 72 65 63 6f 72 64 20 62 79 74 65 r of record byte
25a40 73 20 73 74 6f 72 65 64 20 6f 6e 20 61 6e 20 69 s stored on an i
25a50 6e 64 65 78 20 42 2d 54 72 65 65 0a 20 20 20 20 ndex B-Tree.
25a60 20 20 20 20 2a 2a 20 70 61 67 65 20 69 73 20 6c ** page is l
25a70 65 73 73 20 74 68 61 6e 20 31 36 33 38 34 20 62 ess than 16384 b
25a80 79 74 65 73 20 61 6e 64 20 6d 61 79 20 62 65 20 ytes and may be
25a90 73 74 6f 72 65 64 20 61 73 20 61 20 32 2d 62 79 stored as a 2-by
25aa0 74 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 76 61 te. ** va
25ab0 72 69 6e 74 2e 20 54 68 69 73 20 69 6e 66 6f 72 rint. This infor
25ac0 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 mation is used t
25ad0 6f 20 61 74 74 65 6d 70 74 20 74 6f 20 61 76 6f o attempt to avo
25ae0 69 64 20 70 61 72 73 69 6e 67 20 0a 20 20 20 20 id parsing .
25af0 20 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 ** the entir
25b00 65 20 63 65 6c 6c 20 62 79 20 63 68 65 63 6b 69 e cell by checki
25b10 6e 67 20 66 6f 72 20 74 68 65 20 63 61 73 65 73 ng for the cases
25b20 20 77 68 65 72 65 20 74 68 65 20 72 65 63 6f 72 where the recor
25b30 64 20 69 73 20 0a 20 20 20 20 20 20 20 20 2a 2a d is . **
25b40 20 73 74 6f 72 65 64 20 65 6e 74 69 72 65 6c 79 stored entirely
25b50 20 77 69 74 68 69 6e 20 74 68 65 20 62 2d 74 72 within the b-tr
25b60 65 65 20 70 61 67 65 20 62 79 20 69 6e 73 70 65 ee page by inspe
25b70 63 74 69 6e 67 20 74 68 65 20 66 69 72 73 74 20 cting the first
25b80 0a 20 20 20 20 20 20 20 20 2a 2a 20 32 20 62 79 . ** 2 by
25b90 74 65 73 20 6f 66 20 74 68 65 20 63 65 6c 6c 2e tes of the cell.
25ba0 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 . */.
25bb0 20 20 20 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 int nCell =
25bc0 70 43 65 6c 6c 5b 30 5d 3b 0a 20 20 20 20 20 20 pCell[0];.
25bd0 20 20 69 66 28 20 6e 43 65 6c 6c 3c 3d 70 50 61 if( nCell<=pPa
25be0 67 65 2d 3e 6d 61 78 31 62 79 74 65 50 61 79 6c ge->max1bytePayl
25bf0 6f 61 64 0a 20 20 20 20 20 20 20 20 20 2f 2a 20 oad. /*
25c00 26 26 20 28 70 43 65 6c 6c 2b 6e 43 65 6c 6c 29 && (pCell+nCell)
25c10 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 <pPage->aDataEnd
25c20 20 2a 2f 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 */. ){.
25c30 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 /* This
25c40 20 62 72 61 6e 63 68 20 72 75 6e 73 20 69 66 20 branch runs if
25c50 74 68 65 20 72 65 63 6f 72 64 2d 73 69 7a 65 20 the record-size
25c60 66 69 65 6c 64 20 6f 66 20 74 68 65 20 63 65 6c field of the cel
25c70 6c 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 20 l is a.
25c80 20 2a 2a 20 73 69 6e 67 6c 65 20 62 79 74 65 20 ** single byte
25c90 76 61 72 69 6e 74 20 61 6e 64 20 74 68 65 20 72 varint and the r
25ca0 65 63 6f 72 64 20 66 69 74 73 20 65 6e 74 69 72 ecord fits entir
25cb0 65 6c 79 20 6f 6e 20 74 68 65 20 6d 61 69 6e 0a ely on the main.
25cc0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 62 2d 74 ** b-t
25cd0 72 65 65 20 70 61 67 65 2e 20 20 2a 2f 0a 20 20 ree page. */.
25ce0 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
25cf0 28 20 70 43 65 6c 6c 2b 6e 43 65 6c 6c 2b 31 3d ( pCell+nCell+1=
25d00 3d 70 50 61 67 65 2d 3e 61 44 61 74 61 45 6e 64 =pPage->aDataEnd
25d10 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63 20 );. c
25d20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 = sqlite3VdbeRec
25d30 6f 72 64 43 6f 6d 70 61 72 65 28 6e 43 65 6c 6c ordCompare(nCell
25d40 2c 20 28 76 6f 69 64 2a 29 26 70 43 65 6c 6c 5b , (void*)&pCell[
25d50 31 5d 2c 20 70 49 64 78 4b 65 79 29 3b 0a 20 20 1], pIdxKey);.
25d60 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
25d70 21 28 70 43 65 6c 6c 5b 31 5d 20 26 20 30 78 38 !(pCell[1] & 0x8
25d80 30 29 20 0a 20 20 20 20 20 20 20 20 20 20 26 26 0) . &&
25d90 20 28 6e 43 65 6c 6c 20 3d 20 28 28 6e 43 65 6c (nCell = ((nCel
25da0 6c 26 30 78 37 66 29 3c 3c 37 29 20 2b 20 70 43 l&0x7f)<<7) + pC
25db0 65 6c 6c 5b 31 5d 29 3c 3d 70 50 61 67 65 2d 3e ell[1])<=pPage->
25dc0 6d 61 78 4c 6f 63 61 6c 0a 20 20 20 20 20 20 20 maxLocal.
25dd0 20 20 20 2f 2a 20 26 26 20 28 70 43 65 6c 6c 2b /* && (pCell+
25de0 6e 43 65 6c 6c 2b 32 29 3c 3d 70 50 61 67 65 2d nCell+2)<=pPage-
25df0 3e 61 44 61 74 61 45 6e 64 20 2a 2f 0a 20 20 20 >aDataEnd */.
25e00 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 ){.
25e10 20 20 2f 2a 20 54 68 65 20 72 65 63 6f 72 64 2d /* The record-
25e20 73 69 7a 65 20 66 69 65 6c 64 20 69 73 20 61 20 size field is a
25e30 32 20 62 79 74 65 20 76 61 72 69 6e 74 20 61 6e 2 byte varint an
25e40 64 20 74 68 65 20 72 65 63 6f 72 64 20 0a 20 20 d the record .
25e50 20 20 20 20 20 20 20 20 2a 2a 20 66 69 74 73 20 ** fits
25e60 65 6e 74 69 72 65 6c 79 20 6f 6e 20 74 68 65 20 entirely on the
25e70 6d 61 69 6e 20 62 2d 74 72 65 65 20 70 61 67 65 main b-tree page
25e80 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 . */.
25e90 74 65 73 74 63 61 73 65 28 20 70 43 65 6c 6c 2b testcase( pCell+
25ea0 6e 43 65 6c 6c 2b 32 3d 3d 70 50 61 67 65 2d 3e nCell+2==pPage->
25eb0 61 44 61 74 61 45 6e 64 20 29 3b 0a 20 20 20 20 aDataEnd );.
25ec0 20 20 20 20 20 20 63 20 3d 20 73 71 6c 69 74 65 c = sqlite
25ed0 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 3VdbeRecordCompa
25ee0 72 65 28 6e 43 65 6c 6c 2c 20 28 76 6f 69 64 2a re(nCell, (void*
25ef0 29 26 70 43 65 6c 6c 5b 32 5d 2c 20 70 49 64 78 )&pCell[2], pIdx
25f00 4b 65 79 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 Key);. }e
25f10 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f lse{. /
25f20 2a 20 54 68 65 20 72 65 63 6f 72 64 20 66 6c 6f * The record flo
25f30 77 73 20 6f 76 65 72 20 6f 6e 74 6f 20 6f 6e 65 ws over onto one
25f40 20 6f 72 20 6d 6f 72 65 20 6f 76 65 72 66 6c 6f or more overflo
25f50 77 20 70 61 67 65 73 2e 20 49 6e 0a 20 20 20 20 w pages. In.
25f60 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20 63 61 ** this ca
25f70 73 65 20 74 68 65 20 77 68 6f 6c 65 20 63 65 6c se the whole cel
25f80 6c 20 6e 65 65 64 73 20 74 6f 20 62 65 20 70 61 l needs to be pa
25f90 72 73 65 64 2c 20 61 20 62 75 66 66 65 72 20 61 rsed, a buffer a
25fa0 6c 6c 6f 63 61 74 65 64 0a 20 20 20 20 20 20 20 llocated.
25fb0 20 20 20 2a 2a 20 61 6e 64 20 61 63 63 65 73 73 ** and access
25fc0 50 61 79 6c 6f 61 64 28 29 20 75 73 65 64 20 74 Payload() used t
25fd0 6f 20 72 65 74 72 69 65 76 65 20 74 68 65 20 72 o retrieve the r
25fe0 65 63 6f 72 64 20 69 6e 74 6f 20 74 68 65 0a 20 ecord into the.
25ff0 20 20 20 20 20 20 20 20 20 2a 2a 20 62 75 66 66 ** buff
26000 65 72 20 62 65 66 6f 72 65 20 56 64 62 65 52 65 er before VdbeRe
26010 63 6f 72 64 43 6f 6d 70 61 72 65 28 29 20 63 61 cordCompare() ca
26020 6e 20 62 65 20 63 61 6c 6c 65 64 2e 20 2a 2f 0a n be called. */.
26030 20 20 20 20 20 20 20 20 20 20 76 6f 69 64 20 2a void *
26040 70 43 65 6c 6c 4b 65 79 3b 0a 20 20 20 20 20 20 pCellKey;.
26050 20 20 20 20 75 38 20 2a 20 63 6f 6e 73 74 20 70 u8 * const p
26060 43 65 6c 6c 42 6f 64 79 20 3d 20 70 43 65 6c 6c CellBody = pCell
26070 20 2d 20 70 50 61 67 65 2d 3e 63 68 69 6c 64 50 - pPage->childP
26080 74 72 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 20 trSize;.
26090 20 20 62 74 72 65 65 50 61 72 73 65 43 65 6c 6c btreeParseCell
260a0 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c Ptr(pPage, pCell
260b0 42 6f 64 79 2c 20 26 70 43 75 72 2d 3e 69 6e 66 Body, &pCur->inf
260c0 6f 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 43 o);. nC
260d0 65 6c 6c 20 3d 20 28 69 6e 74 29 70 43 75 72 2d ell = (int)pCur-
260e0 3e 69 6e 66 6f 2e 6e 4b 65 79 3b 0a 20 20 20 20 >info.nKey;.
260f0 20 20 20 20 20 20 70 43 65 6c 6c 4b 65 79 20 3d pCellKey =
26100 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 20 sqlite3Malloc(
26110 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 20 nCell );.
26120 20 20 20 69 66 28 20 70 43 65 6c 6c 4b 65 79 3d if( pCellKey=
26130 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
26140 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f rc = SQLITE_NO
26150 4d 45 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 20 MEM;.
26160 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e goto moveto_fin
26170 69 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d ish;. }
26180 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
26190 61 63 63 65 73 73 50 61 79 6c 6f 61 64 28 70 43 accessPayload(pC
261a0 75 72 2c 20 30 2c 20 6e 43 65 6c 6c 2c 20 28 75 ur, 0, nCell, (u
261b0 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 29 70 43 nsigned char*)pC
261c0 65 6c 6c 4b 65 79 2c 20 30 29 3b 0a 20 20 20 20 ellKey, 0);.
261d0 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
261e0 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 sqli
261f0 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 te3_free(pCellKe
26200 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 y);.
26210 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 goto moveto_fini
26220 73 68 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a sh;. }.
26230 20 20 20 20 20 20 20 20 20 20 63 20 3d 20 73 71 c = sq
26240 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 lite3VdbeRecordC
26250 6f 6d 70 61 72 65 28 6e 43 65 6c 6c 2c 20 70 43 ompare(nCell, pC
26260 65 6c 6c 4b 65 79 2c 20 70 49 64 78 4b 65 79 29 ellKey, pIdxKey)
26270 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 ;. sqli
26280 74 65 33 5f 66 72 65 65 28 70 43 65 6c 6c 4b 65 te3_free(pCellKe
26290 79 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 y);. }.
262a0 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
262b0 63 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 c==0 ){.
262c0 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 if( pPage->intKe
262d0 79 20 26 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 y && !pPage->lea
262e0 66 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6c f ){. l
262f0 77 72 20 3d 20 69 64 78 3b 0a 20 20 20 20 20 20 wr = idx;.
26300 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
26310 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
26320 20 20 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 *pRes = 0;.
26330 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
26340 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
26350 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f 5f 66 goto moveto_f
26360 69 6e 69 73 68 3b 0a 20 20 20 20 20 20 20 20 7d inish;. }
26370 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
26380 66 28 20 63 3c 30 20 29 7b 0a 20 20 20 20 20 20 f( c<0 ){.
26390 20 20 6c 77 72 20 3d 20 69 64 78 2b 31 3b 0a 20 lwr = idx+1;.
263a0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
263b0 20 20 20 20 75 70 72 20 3d 20 69 64 78 2d 31 3b upr = idx-1;
263c0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
263d0 66 28 20 6c 77 72 3e 75 70 72 20 29 7b 0a 20 20 f( lwr>upr ){.
263e0 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
263f0 20 20 20 7d 0a 20 20 20 20 20 20 70 43 75 72 2d }. pCur-
26400 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
26410 67 65 5d 20 3d 20 28 75 31 36 29 28 69 64 78 20 ge] = (u16)(idx
26420 3d 20 28 6c 77 72 2b 75 70 72 29 2f 32 29 3b 0a = (lwr+upr)/2);.
26430 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
26440 28 20 6c 77 72 3d 3d 75 70 72 2b 31 20 7c 7c 20 ( lwr==upr+1 ||
26450 28 70 50 61 67 65 2d 3e 69 6e 74 4b 65 79 20 26 (pPage->intKey &
26460 26 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 29 20 & !pPage->leaf)
26470 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 );. assert( p
26480 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 29 3b 0a Page->isInit );.
26490 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6c if( pPage->l
264a0 65 61 66 20 29 7b 0a 20 20 20 20 20 20 63 68 6c eaf ){. chl
264b0 64 50 67 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c dPg = 0;. }el
264c0 73 65 20 69 66 28 20 6c 77 72 3e 3d 70 50 61 67 se if( lwr>=pPag
264d0 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 e->nCell ){.
264e0 20 20 63 68 6c 64 50 67 20 3d 20 67 65 74 34 62 chldPg = get4b
264f0 79 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 yte(&pPage->aDat
26500 61 5b 70 50 61 67 65 2d 3e 68 64 72 4f 66 66 73 a[pPage->hdrOffs
26510 65 74 2b 38 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 et+8]);. }els
26520 65 7b 0a 20 20 20 20 20 20 63 68 6c 64 50 67 20 e{. chldPg
26530 3d 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 43 = get4byte(findC
26540 65 6c 6c 28 70 50 61 67 65 2c 20 6c 77 72 29 29 ell(pPage, lwr))
26550 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
26560 63 68 6c 64 50 67 3d 3d 30 20 29 7b 0a 20 20 20 chldPg==0 ){.
26570 20 20 20 61 73 73 65 72 74 28 20 70 43 75 72 2d assert( pCur-
26580 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 61 >aiIdx[pCur->iPa
26590 67 65 5d 3c 70 43 75 72 2d 3e 61 70 50 61 67 65 ge]<pCur->apPage
265a0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 2d 3e 6e [pCur->iPage]->n
265b0 43 65 6c 6c 20 29 3b 0a 20 20 20 20 20 20 2a 70 Cell );. *p
265c0 52 65 73 20 3d 20 63 3b 0a 20 20 20 20 20 20 72 Res = c;. r
265d0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
265e0 20 20 20 20 20 67 6f 74 6f 20 6d 6f 76 65 74 6f goto moveto
265f0 5f 66 69 6e 69 73 68 3b 0a 20 20 20 20 7d 0a 20 _finish;. }.
26600 20 20 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 pCur->aiIdx[p
26610 43 75 72 2d 3e 69 50 61 67 65 5d 20 3d 20 28 75 Cur->iPage] = (u
26620 31 36 29 6c 77 72 3b 0a 20 20 20 20 70 43 75 72 16)lwr;. pCur
26630 2d 3e 69 6e 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 ->info.nSize = 0
26640 3b 0a 20 20 20 20 70 43 75 72 2d 3e 76 61 6c 69 ;. pCur->vali
26650 64 4e 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 72 dNKey = 0;. r
26660 63 20 3d 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 c = moveToChild(
26670 70 43 75 72 2c 20 63 68 6c 64 50 67 29 3b 0a 20 pCur, chldPg);.
26680 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
26690 20 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 68 3b 0a moveto_finish;.
266a0 20 20 7d 0a 6d 6f 76 65 74 6f 5f 66 69 6e 69 73 }.moveto_finis
266b0 68 3a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a h:. return rc;.
266c0 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e }.../*.** Return
266d0 20 54 52 55 45 20 69 66 20 74 68 65 20 63 75 72 TRUE if the cur
266e0 73 6f 72 20 69 73 20 6e 6f 74 20 70 6f 69 6e 74 sor is not point
266f0 69 6e 67 20 61 74 20 61 6e 20 65 6e 74 72 79 20 ing at an entry
26700 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a of the table..**
26710 0a 2a 2a 20 54 52 55 45 20 77 69 6c 6c 20 62 65 .** TRUE will be
26720 20 72 65 74 75 72 6e 65 64 20 61 66 74 65 72 20 returned after
26730 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 a call to sqlite
26740 33 42 74 72 65 65 4e 65 78 74 28 29 20 6d 6f 76 3BtreeNext() mov
26750 65 73 0a 2a 2a 20 70 61 73 74 20 74 68 65 20 6c es.** past the l
26760 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ast entry in the
26770 20 74 61 62 6c 65 20 6f 72 20 73 71 6c 69 74 65 table or sqlite
26780 33 42 74 72 65 65 50 72 65 76 28 29 20 6d 6f 76 3BtreePrev() mov
26790 65 73 20 70 61 73 74 0a 2a 2a 20 74 68 65 20 66 es past.** the f
267a0 69 72 73 74 20 65 6e 74 72 79 2e 20 20 54 52 55 irst entry. TRU
267b0 45 20 69 73 20 61 6c 73 6f 20 72 65 74 75 72 6e E is also return
267c0 65 64 20 69 66 20 74 68 65 20 74 61 62 6c 65 20 ed if the table
267d0 69 73 20 65 6d 70 74 79 2e 0a 2a 2f 0a 69 6e 74 is empty..*/.int
267e0 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6f 66 sqlite3BtreeEof
267f0 28 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 29 (BtCursor *pCur)
26800 7b 0a 20 20 2f 2a 20 54 4f 44 4f 3a 20 57 68 61 {. /* TODO: Wha
26810 74 20 69 66 20 74 68 65 20 63 75 72 73 6f 72 20 t if the cursor
26820 69 73 20 69 6e 20 43 55 52 53 4f 52 5f 52 45 51 is in CURSOR_REQ
26830 55 49 52 45 53 45 45 4b 20 62 75 74 20 61 6c 6c UIRESEEK but all
26840 20 74 61 62 6c 65 20 65 6e 74 72 69 65 73 0a 20 table entries.
26850 20 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 64 65 ** have been de
26860 6c 65 74 65 64 3f 20 54 68 69 73 20 41 50 49 20 leted? This API
26870 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 63 68 61 will need to cha
26880 6e 67 65 20 74 6f 20 72 65 74 75 72 6e 20 61 6e nge to return an
26890 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a error code. **
268a0 20 61 73 20 77 65 6c 6c 20 61 73 20 74 68 65 20 as well as the
268b0 62 6f 6f 6c 65 61 6e 20 72 65 73 75 6c 74 20 76 boolean result v
268c0 61 6c 75 65 2e 0a 20 20 2a 2f 0a 20 20 72 65 74 alue.. */. ret
268d0 75 72 6e 20 28 43 55 52 53 4f 52 5f 56 41 4c 49 urn (CURSOR_VALI
268e0 44 21 3d 70 43 75 72 2d 3e 65 53 74 61 74 65 29 D!=pCur->eState)
268f0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 6e ;.}../*.** Advan
26900 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 74 6f ce the cursor to
26910 20 74 68 65 20 6e 65 78 74 20 65 6e 74 72 79 20 the next entry
26920 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e in the database.
26930 20 20 49 66 0a 2a 2a 20 73 75 63 63 65 73 73 66 If.** successf
26940 75 6c 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 ul then set *pRe
26950 73 3d 30 2e 20 20 49 66 20 74 68 65 20 63 75 72 s=0. If the cur
26960 73 6f 72 0a 2a 2a 20 77 61 73 20 61 6c 72 65 61 sor.** was alrea
26970 64 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 dy pointing to t
26980 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20 69 6e he last entry in
26990 20 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 the database be
269a0 66 6f 72 65 0a 2a 2a 20 74 68 69 73 20 72 6f 75 fore.** this rou
269b0 74 69 6e 65 20 77 61 73 20 63 61 6c 6c 65 64 2c tine was called,
269c0 20 74 68 65 6e 20 73 65 74 20 2a 70 52 65 73 3d then set *pRes=
269d0 31 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 1..*/.int sqlite
269e0 33 42 74 72 65 65 4e 65 78 74 28 42 74 43 75 72 3BtreeNext(BtCur
269f0 73 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a sor *pCur, int *
26a00 70 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b pRes){. int rc;
26a10 0a 20 20 69 6e 74 20 69 64 78 3b 0a 20 20 4d 65 . int idx;. Me
26a20 6d 50 61 67 65 20 2a 70 50 61 67 65 3b 0a 0a 20 mPage *pPage;..
26a30 20 61 73 73 65 72 74 28 20 63 75 72 73 6f 72 48 assert( cursorH
26a40 6f 6c 64 73 4d 75 74 65 78 28 70 43 75 72 29 20 oldsMutex(pCur)
26a50 29 3b 0a 20 20 72 63 20 3d 20 72 65 73 74 6f 72 );. rc = restor
26a60 65 43 75 72 73 6f 72 50 6f 73 69 74 69 6f 6e 28 eCursorPosition(
26a70 70 43 75 72 29 3b 0a 20 20 69 66 28 20 72 63 21 pCur);. if( rc!
26a80 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
26a90 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
26aa0 0a 20 20 61 73 73 65 72 74 28 20 70 52 65 73 21 . assert( pRes!
26ab0 3d 30 20 29 3b 0a 20 20 69 66 28 20 43 55 52 53 =0 );. if( CURS
26ac0 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 43 75 72 OR_INVALID==pCur
26ad0 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 20 20 20 ->eState ){.
26ae0 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 72 *pRes = 1;. r
26af0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
26b00 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 75 72 2d . }. if( pCur-
26b10 3e 73 6b 69 70 4e 65 78 74 3e 30 20 29 7b 0a 20 >skipNext>0 ){.
26b20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 pCur->skipNex
26b30 74 20 3d 20 30 3b 0a 20 20 20 20 2a 70 52 65 73 t = 0;. *pRes
26b40 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 75 72 6e = 0;. return
26b50 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a SQLITE_OK;. }.
26b60 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e 65 78 74 pCur->skipNext
26b70 20 3d 20 30 3b 0a 0a 20 20 70 50 61 67 65 20 3d = 0;.. pPage =
26b80 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 70 43 pCur->apPage[pC
26b90 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 20 69 64 ur->iPage];. id
26ba0 78 20 3d 20 2b 2b 70 43 75 72 2d 3e 61 69 49 64 x = ++pCur->aiId
26bb0 78 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a x[pCur->iPage];.
26bc0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d assert( pPage-
26bd0 3e 69 73 49 6e 69 74 20 29 3b 0a 0a 20 20 2f 2a >isInit );.. /*
26be0 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 If the database
26bf0 20 66 69 6c 65 20 69 73 20 63 6f 72 72 75 70 74 file is corrupt
26c00 2c 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 , it is possible
26c10 20 66 6f 72 20 74 68 65 20 76 61 6c 75 65 20 6f for the value o
26c20 66 20 69 64 78 20 0a 20 20 2a 2a 20 74 6f 20 62 f idx . ** to b
26c30 65 20 69 6e 76 61 6c 69 64 20 68 65 72 65 2e 20 e invalid here.
26c40 54 68 69 73 20 63 61 6e 20 6f 6e 6c 79 20 6f 63 This can only oc
26c50 63 75 72 20 69 66 20 61 20 73 65 63 6f 6e 64 20 cur if a second
26c60 63 75 72 73 6f 72 20 6d 6f 64 69 66 69 65 73 0a cursor modifies.
26c70 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 77 68 ** the page wh
26c80 69 6c 65 20 63 75 72 73 6f 72 20 70 43 75 72 20 ile cursor pCur
26c90 69 73 20 68 6f 6c 64 69 6e 67 20 61 20 72 65 66 is holding a ref
26ca0 65 72 65 6e 63 65 20 74 6f 20 69 74 2e 20 57 68 erence to it. Wh
26cb0 69 63 68 20 63 61 6e 0a 20 20 2a 2a 20 6f 6e 6c ich can. ** onl
26cc0 79 20 68 61 70 70 65 6e 20 69 66 20 74 68 65 20 y happen if the
26cd0 64 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 database is corr
26ce0 75 70 74 20 69 6e 20 73 75 63 68 20 61 20 77 61 upt in such a wa
26cf0 79 20 61 73 20 74 6f 20 6c 69 6e 6b 20 74 68 65 y as to link the
26d00 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e 74 6f 20 . ** page into
26d10 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 62 2d more than one b-
26d20 74 72 65 65 20 73 74 72 75 63 74 75 72 65 2e 20 tree structure.
26d30 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 20 69 */. testcase( i
26d40 64 78 3e 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 20 dx>pPage->nCell
26d50 29 3b 0a 0a 20 20 70 43 75 72 2d 3e 69 6e 66 6f );.. pCur->info
26d60 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 70 43 .nSize = 0;. pC
26d70 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 79 20 3d 20 ur->validNKey =
26d80 30 3b 0a 20 20 69 66 28 20 69 64 78 3e 3d 70 50 0;. if( idx>=pP
26d90 61 67 65 2d 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 age->nCell ){.
26da0 20 20 69 66 28 20 21 70 50 61 67 65 2d 3e 6c 65 if( !pPage->le
26db0 61 66 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d af ){. rc =
26dc0 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 moveToChild(pCu
26dd0 72 2c 20 67 65 74 34 62 79 74 65 28 26 70 50 61 r, get4byte(&pPa
26de0 67 65 2d 3e 61 44 61 74 61 5b 70 50 61 67 65 2d ge->aData[pPage-
26df0 3e 68 64 72 4f 66 66 73 65 74 2b 38 5d 29 29 3b >hdrOffset+8]));
26e00 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 . if( rc )
26e10 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
26e20 20 72 63 20 3d 20 6d 6f 76 65 54 6f 4c 65 66 74 rc = moveToLeft
26e30 6d 6f 73 74 28 70 43 75 72 29 3b 0a 20 20 20 20 most(pCur);.
26e40 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 *pRes = 0;.
26e50 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
26e60 20 20 7d 0a 20 20 20 20 64 6f 7b 0a 20 20 20 20 }. do{.
26e70 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 if( pCur->iPag
26e80 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 e==0 ){.
26e90 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 20 20 20 *pRes = 1;.
26ea0 20 20 20 70 43 75 72 2d 3e 65 53 74 61 74 65 20 pCur->eState
26eb0 3d 20 43 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 = CURSOR_INVALID
26ec0 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
26ed0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
26ee0 20 20 7d 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f }. moveTo
26ef0 50 61 72 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 Parent(pCur);.
26f00 20 20 20 20 70 50 61 67 65 20 3d 20 70 43 75 72 pPage = pCur
26f10 2d 3e 61 70 50 61 67 65 5b 70 43 75 72 2d 3e 69 ->apPage[pCur->i
26f20 50 61 67 65 5d 3b 0a 20 20 20 20 7d 77 68 69 6c Page];. }whil
26f30 65 28 20 70 43 75 72 2d 3e 61 69 49 64 78 5b 70 e( pCur->aiIdx[p
26f40 43 75 72 2d 3e 69 50 61 67 65 5d 3e 3d 70 50 61 Cur->iPage]>=pPa
26f50 67 65 2d 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 20 ge->nCell );.
26f60 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 *pRes = 0;.
26f70 69 66 28 20 70 50 61 67 65 2d 3e 69 6e 74 4b 65 if( pPage->intKe
26f80 79 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 y ){. rc =
26f90 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65 78 74 sqlite3BtreeNext
26fa0 28 70 43 75 72 2c 20 70 52 65 73 29 3b 0a 20 20 (pCur, pRes);.
26fb0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 }else{. r
26fc0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
26fd0 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
26fe0 72 63 3b 0a 20 20 7d 0a 20 20 2a 70 52 65 73 20 rc;. }. *pRes
26ff0 3d 20 30 3b 0a 20 20 69 66 28 20 70 50 61 67 65 = 0;. if( pPage
27000 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 72 65 ->leaf ){. re
27010 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
27020 20 20 7d 0a 20 20 72 63 20 3d 20 6d 6f 76 65 54 }. rc = moveT
27030 6f 4c 65 66 74 6d 6f 73 74 28 70 43 75 72 29 3b oLeftmost(pCur);
27040 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
27050 0a 0a 2f 2a 0a 2a 2a 20 53 74 65 70 20 74 68 65 ../*.** Step the
27060 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 62 cursor to the b
27070 61 63 6b 20 74 6f 20 74 68 65 20 70 72 65 76 69 ack to the previ
27080 6f 75 73 20 65 6e 74 72 79 20 69 6e 20 74 68 65 ous entry in the
27090 20 64 61 74 61 62 61 73 65 2e 20 20 49 66 0a 2a database. If.*
270a0 2a 20 73 75 63 63 65 73 73 66 75 6c 20 74 68 65 * successful the
270b0 6e 20 73 65 74 20 2a 70 52 65 73 3d 30 2e 20 20 n set *pRes=0.
270c0 49 66 20 74 68 65 20 63 75 72 73 6f 72 0a 2a 2a If the cursor.**
270d0 20 77 61 73 20 61 6c 72 65 61 64 79 20 70 6f 69 was already poi
270e0 6e 74 69 6e 67 20 74 6f 20 74 68 65 20 66 69 72 nting to the fir
270f0 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 st entry in the
27100 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 0a database before.
27110 2a 2a 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 ** this routine
27120 77 61 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 6e was called, then
27130 20 73 65 74 20 2a 70 52 65 73 3d 31 2e 0a 2a 2f set *pRes=1..*/
27140 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 74 72 65 .int sqlite3Btre
27150 65 50 72 65 76 69 6f 75 73 28 42 74 43 75 72 73 ePrevious(BtCurs
27160 6f 72 20 2a 70 43 75 72 2c 20 69 6e 74 20 2a 70 or *pCur, int *p
27170 52 65 73 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a Res){. int rc;.
27180 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
27190 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 63 75 72 ;.. assert( cur
271a0 73 6f 72 48 6f 6c 64 73 4d 75 74 65 78 28 70 43 sorHoldsMutex(pC
271b0 75 72 29 20 29 3b 0a 20 20 72 63 20 3d 20 72 65 ur) );. rc = re
271c0 73 74 6f 72 65 43 75 72 73 6f 72 50 6f 73 69 74 storeCursorPosit
271d0 69 6f 6e 28 70 43 75 72 29 3b 0a 20 20 69 66 28 ion(pCur);. if(
271e0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
271f0 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b {. return rc;
27200 0a 20 20 7d 0a 20 20 70 43 75 72 2d 3e 61 74 4c . }. pCur->atL
27210 61 73 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 43 ast = 0;. if( C
27220 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3d 3d 70 URSOR_INVALID==p
27230 43 75 72 2d 3e 65 53 74 61 74 65 20 29 7b 0a 20 Cur->eState ){.
27240 20 20 20 2a 70 52 65 73 20 3d 20 31 3b 0a 20 20 *pRes = 1;.
27250 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
27260 4f 4b 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 OK;. }. if( pC
27270 75 72 2d 3e 73 6b 69 70 4e 65 78 74 3c 30 20 29 ur->skipNext<0 )
27280 7b 0a 20 20 20 20 70 43 75 72 2d 3e 73 6b 69 70 {. pCur->skip
27290 4e 65 78 74 20 3d 20 30 3b 0a 20 20 20 20 2a 70 Next = 0;. *p
272a0 52 65 73 20 3d 20 30 3b 0a 20 20 20 20 72 65 74 Res = 0;. ret
272b0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
272c0 20 7d 0a 20 20 70 43 75 72 2d 3e 73 6b 69 70 4e }. pCur->skipN
272d0 65 78 74 20 3d 20 30 3b 0a 0a 20 20 70 50 61 67 ext = 0;.. pPag
272e0 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 e = pCur->apPage
272f0 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 [pCur->iPage];.
27300 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
27310 69 73 49 6e 69 74 20 29 3b 0a 20 20 69 66 28 20 isInit );. if(
27320 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a !pPage->leaf ){.
27330 20 20 20 20 69 6e 74 20 69 64 78 20 3d 20 70 43 int idx = pC
27340 75 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e ur->aiIdx[pCur->
27350 69 50 61 67 65 5d 3b 0a 20 20 20 20 72 63 20 3d iPage];. rc =
27360 20 6d 6f 76 65 54 6f 43 68 69 6c 64 28 70 43 75 moveToChild(pCu
27370 72 2c 20 67 65 74 34 62 79 74 65 28 66 69 6e 64 r, get4byte(find
27380 43 65 6c 6c 28 70 50 61 67 65 2c 20 69 64 78 29 Cell(pPage, idx)
27390 29 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 ));. if( rc )
273a0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
273b0 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 c;. }. rc
273c0 3d 20 6d 6f 76 65 54 6f 52 69 67 68 74 6d 6f 73 = moveToRightmos
273d0 74 28 70 43 75 72 29 3b 0a 20 20 7d 65 6c 73 65 t(pCur);. }else
273e0 7b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 43 75 {. while( pCu
273f0 72 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 r->aiIdx[pCur->i
27400 50 61 67 65 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 Page]==0 ){.
27410 20 20 69 66 28 20 70 43 75 72 2d 3e 69 50 61 67 if( pCur->iPag
27420 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 e==0 ){.
27430 70 43 75 72 2d 3e 65 53 74 61 74 65 20 3d 20 43 pCur->eState = C
27440 55 52 53 4f 52 5f 49 4e 56 41 4c 49 44 3b 0a 20 URSOR_INVALID;.
27450 20 20 20 20 20 20 20 2a 70 52 65 73 20 3d 20 31 *pRes = 1
27460 3b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e ;. return
27470 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 SQLITE_OK;.
27480 20 20 7d 0a 20 20 20 20 20 20 6d 6f 76 65 54 6f }. moveTo
27490 50 61 72 65 6e 74 28 70 43 75 72 29 3b 0a 20 20 Parent(pCur);.
274a0 20 20 7d 0a 20 20 20 20 70 43 75 72 2d 3e 69 6e }. pCur->in
274b0 66 6f 2e 6e 53 69 7a 65 20 3d 20 30 3b 0a 20 20 fo.nSize = 0;.
274c0 20 20 70 43 75 72 2d 3e 76 61 6c 69 64 4e 4b 65 pCur->validNKe
274d0 79 20 3d 20 30 3b 0a 0a 20 20 20 20 70 43 75 72 y = 0;.. pCur
274e0 2d 3e 61 69 49 64 78 5b 70 43 75 72 2d 3e 69 50 ->aiIdx[pCur->iP
274f0 61 67 65 5d 2d 2d 3b 0a 20 20 20 20 70 50 61 67 age]--;. pPag
27500 65 20 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 e = pCur->apPage
27510 5b 70 43 75 72 2d 3e 69 50 61 67 65 5d 3b 0a 20 [pCur->iPage];.
27520 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 69 6e if( pPage->in
27530 74 4b 65 79 20 26 26 20 21 70 50 61 67 65 2d 3e tKey && !pPage->
27540 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 72 63 leaf ){. rc
27550 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 50 = sqlite3BtreeP
27560 72 65 76 69 6f 75 73 28 70 43 75 72 2c 20 70 52 revious(pCur, pR
27570 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a es);. }else{.
27580 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
27590 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a E_OK;. }. }.
275a0 20 20 2a 70 52 65 73 20 3d 20 30 3b 0a 20 20 72 *pRes = 0;. r
275b0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
275c0 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 ** Allocate a ne
275d0 77 20 70 61 67 65 20 66 72 6f 6d 20 74 68 65 20 w page from the
275e0 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
275f0 2a 0a 2a 2a 20 54 68 65 20 6e 65 77 20 70 61 67 *.** The new pag
27600 65 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 64 e is marked as d
27610 69 72 74 79 2e 20 20 28 49 6e 20 6f 74 68 65 72 irty. (In other
27620 20 77 6f 72 64 73 2c 20 73 71 6c 69 74 65 33 50 words, sqlite3P
27630 61 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 68 agerWrite().** h
27640 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 as already been
27650 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6e 65 called on the ne
27660 77 20 70 61 67 65 2e 29 20 20 54 68 65 20 6e 65 w page.) The ne
27670 77 20 70 61 67 65 20 68 61 73 20 61 6c 73 6f 0a w page has also.
27680 2a 2a 20 62 65 65 6e 20 72 65 66 65 72 65 6e 63 ** been referenc
27690 65 64 20 61 6e 64 20 74 68 65 20 63 61 6c 6c 69 ed and the calli
276a0 6e 67 20 72 6f 75 74 69 6e 65 20 69 73 20 72 65 ng routine is re
276b0 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 63 61 sponsible for ca
276c0 6c 6c 69 6e 67 0a 2a 2a 20 73 71 6c 69 74 65 33 lling.** sqlite3
276d0 50 61 67 65 72 55 6e 72 65 66 28 29 20 6f 6e 20 PagerUnref() on
276e0 74 68 65 20 6e 65 77 20 70 61 67 65 20 77 68 65 the new page whe
276f0 6e 20 69 74 20 69 73 20 64 6f 6e 65 2e 0a 2a 2a n it is done..**
27700 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 .** SQLITE_OK is
27710 20 72 65 74 75 72 6e 65 64 20 6f 6e 20 73 75 63 returned on suc
27720 63 65 73 73 2e 20 20 41 6e 79 20 6f 74 68 65 72 cess. Any other
27730 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 69 6e return value in
27740 64 69 63 61 74 65 73 0a 2a 2a 20 61 6e 20 65 72 dicates.** an er
27750 72 6f 72 2e 20 20 2a 70 70 50 61 67 65 20 61 6e ror. *ppPage an
27760 64 20 2a 70 50 67 6e 6f 20 61 72 65 20 75 6e 64 d *pPgno are und
27770 65 66 69 6e 65 64 20 69 6e 20 74 68 65 20 65 76 efined in the ev
27780 65 6e 74 20 6f 66 20 61 6e 20 65 72 72 6f 72 2e ent of an error.
27790 0a 2a 2a 20 44 6f 20 6e 6f 74 20 69 6e 76 6f 6b .** Do not invok
277a0 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e e sqlite3PagerUn
277b0 72 65 66 28 29 20 6f 6e 20 2a 70 70 50 61 67 65 ref() on *ppPage
277c0 20 69 66 20 61 6e 20 65 72 72 6f 72 20 69 73 20 if an error is
277d0 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 returned..**.**
277e0 49 66 20 74 68 65 20 22 6e 65 61 72 62 79 22 20 If the "nearby"
277f0 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 parameter is not
27800 20 30 2c 20 74 68 65 6e 20 61 20 28 66 65 65 62 0, then a (feeb
27810 6c 65 29 20 65 66 66 6f 72 74 20 69 73 20 6d 61 le) effort is ma
27820 64 65 20 74 6f 20 0a 2a 2a 20 6c 6f 63 61 74 65 de to .** locate
27830 20 61 20 70 61 67 65 20 63 6c 6f 73 65 20 74 6f a page close to
27840 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
27850 20 22 6e 65 61 72 62 79 22 2e 20 20 54 68 69 73 "nearby". This
27860 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 can be used in
27870 61 6e 0a 2a 2a 20 61 74 74 65 6d 70 74 20 74 6f an.** attempt to
27880 20 6b 65 65 70 20 72 65 6c 61 74 65 64 20 70 61 keep related pa
27890 67 65 73 20 63 6c 6f 73 65 20 74 6f 20 65 61 63 ges close to eac
278a0 68 20 6f 74 68 65 72 20 69 6e 20 74 68 65 20 64 h other in the d
278b0 61 74 61 62 61 73 65 20 66 69 6c 65 2c 0a 2a 2a atabase file,.**
278c0 20 77 68 69 63 68 20 69 6e 20 74 75 72 6e 20 63 which in turn c
278d0 61 6e 20 6d 61 6b 65 20 64 61 74 61 62 61 73 65 an make database
278e0 20 61 63 63 65 73 73 20 66 61 73 74 65 72 2e 0a access faster..
278f0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 22 65 78 **.** If the "ex
27900 61 63 74 22 20 70 61 72 61 6d 65 74 65 72 20 69 act" parameter i
27910 73 20 6e 6f 74 20 30 2c 20 61 6e 64 20 74 68 65 s not 0, and the
27920 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 6e 65 61 page-number nea
27930 72 62 79 20 65 78 69 73 74 73 20 0a 2a 2a 20 61 rby exists .** a
27940 6e 79 77 68 65 72 65 20 6f 6e 20 74 68 65 20 66 nywhere on the f
27950 72 65 65 2d 6c 69 73 74 2c 20 74 68 65 6e 20 69 ree-list, then i
27960 74 20 69 73 20 67 75 61 72 65 6e 74 65 65 64 20 t is guarenteed
27970 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 2e 20 to be returned.
27980 54 68 69 73 0a 2a 2a 20 69 73 20 6f 6e 6c 79 20 This.** is only
27990 75 73 65 64 20 62 79 20 61 75 74 6f 2d 76 61 63 used by auto-vac
279a0 75 75 6d 20 64 61 74 61 62 61 73 65 73 20 77 68 uum databases wh
279b0 65 6e 20 61 6c 6c 6f 63 61 74 69 6e 67 20 61 20 en allocating a
279c0 6e 65 77 20 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 new table..*/.st
279d0 61 74 69 63 20 69 6e 74 20 61 6c 6c 6f 63 61 74 atic int allocat
279e0 65 42 74 72 65 65 50 61 67 65 28 0a 20 20 42 74 eBtreePage(. Bt
279f0 53 68 61 72 65 64 20 2a 70 42 74 2c 20 0a 20 20 Shared *pBt, .
27a00 4d 65 6d 50 61 67 65 20 2a 2a 70 70 50 61 67 65 MemPage **ppPage
27a10 2c 20 0a 20 20 50 67 6e 6f 20 2a 70 50 67 6e 6f , . Pgno *pPgno
27a20 2c 20 0a 20 20 50 67 6e 6f 20 6e 65 61 72 62 79 , . Pgno nearby
27a30 2c 0a 20 20 75 38 20 65 78 61 63 74 0a 29 7b 0a ,. u8 exact.){.
27a40 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 MemPage *pPage
27a50 31 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 1;. int rc;. u
27a60 33 32 20 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 32 n; /* Num
27a70 62 65 72 20 6f 66 20 70 61 67 65 73 20 6f 6e 20 ber of pages on
27a80 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f 0a the freelist */.
27a90 20 20 75 33 32 20 6b 3b 20 20 20 20 20 2f 2a 20 u32 k; /*
27aa0 4e 75 6d 62 65 72 20 6f 66 20 6c 65 61 76 65 73 Number of leaves
27ab0 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 6f 66 on the trunk of
27ac0 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 2a 2f the freelist */
27ad0 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 72 75 . MemPage *pTru
27ae0 6e 6b 20 3d 20 30 3b 0a 20 20 4d 65 6d 50 61 67 nk = 0;. MemPag
27af0 65 20 2a 70 50 72 65 76 54 72 75 6e 6b 20 3d 20 e *pPrevTrunk =
27b00 30 3b 0a 20 20 50 67 6e 6f 20 6d 78 50 61 67 65 0;. Pgno mxPage
27b10 3b 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 ; /* Total s
27b20 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ize of the datab
27b30 61 73 65 20 66 69 6c 65 20 2a 2f 0a 0a 20 20 61 ase file */.. a
27b40 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
27b50 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d utex_held(pBt->m
27b60 75 74 65 78 29 20 29 3b 0a 20 20 70 50 61 67 65 utex) );. pPage
27b70 31 20 3d 20 70 42 74 2d 3e 70 50 61 67 65 31 3b 1 = pBt->pPage1;
27b80 0a 20 20 6d 78 50 61 67 65 20 3d 20 62 74 72 65 . mxPage = btre
27b90 65 50 61 67 65 63 6f 75 6e 74 28 70 42 74 29 3b ePagecount(pBt);
27ba0 0a 20 20 6e 20 3d 20 67 65 74 34 62 79 74 65 28 . n = get4byte(
27bb0 26 70 50 61 67 65 31 2d 3e 61 44 61 74 61 5b 33 &pPage1->aData[3
27bc0 36 5d 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 6]);. testcase(
27bd0 20 6e 3d 3d 6d 78 50 61 67 65 2d 31 20 29 3b 0a n==mxPage-1 );.
27be0 20 20 69 66 28 20 6e 3e 3d 6d 78 50 61 67 65 20 if( n>=mxPage
27bf0 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
27c00 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
27c10 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 3e 30 T;. }. if( n>0
27c20 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 ){. /* There
27c30 20 61 72 65 20 70 61 67 65 73 20 6f 6e 20 74 68 are pages on th
27c40 65 20 66 72 65 65 6c 69 73 74 2e 20 20 52 65 75 e freelist. Reu
27c50 73 65 20 6f 6e 65 20 6f 66 20 74 68 6f 73 65 20 se one of those
27c60 70 61 67 65 73 2e 20 2a 2f 0a 20 20 20 20 50 67 pages. */. Pg
27c70 6e 6f 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 75 no iTrunk;. u
27c80 38 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 8 searchList = 0
27c90 3b 20 2f 2a 20 49 66 20 74 68 65 20 66 72 65 65 ; /* If the free
27ca0 2d 6c 69 73 74 20 6d 75 73 74 20 62 65 20 73 65 -list must be se
27cb0 61 72 63 68 65 64 20 66 6f 72 20 27 6e 65 61 72 arched for 'near
27cc0 62 79 27 20 2a 2f 0a 20 20 20 20 0a 20 20 20 20 by' */. .
27cd0 2f 2a 20 49 66 20 74 68 65 20 27 65 78 61 63 74 /* If the 'exact
27ce0 27 20 70 61 72 61 6d 65 74 65 72 20 77 61 73 20 ' parameter was
27cf0 74 72 75 65 20 61 6e 64 20 61 20 71 75 65 72 79 true and a query
27d00 20 6f 66 20 74 68 65 20 70 6f 69 6e 74 65 72 2d of the pointer-
27d10 6d 61 70 0a 20 20 20 20 2a 2a 20 73 68 6f 77 73 map. ** shows
27d20 20 74 68 61 74 20 74 68 65 20 70 61 67 65 20 27 that the page '
27d30 6e 65 61 72 62 79 27 20 69 73 20 73 6f 6d 65 77 nearby' is somew
27d40 68 65 72 65 20 6f 6e 20 74 68 65 20 66 72 65 65 here on the free
27d50 2d 6c 69 73 74 2c 20 74 68 65 6e 0a 20 20 20 20 -list, then.
27d60 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 2d 6c 69 ** the entire-li
27d70 73 74 20 77 69 6c 6c 20 62 65 20 73 65 61 72 63 st will be searc
27d80 68 65 64 20 66 6f 72 20 74 68 61 74 20 70 61 67 hed for that pag
27d90 65 2e 0a 20 20 20 20 2a 2f 0a 23 69 66 6e 64 65 e.. */.#ifnde
27da0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
27db0 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
27dc0 20 65 78 61 63 74 20 26 26 20 6e 65 61 72 62 79 exact && nearby
27dd0 3c 3d 6d 78 50 61 67 65 20 29 7b 0a 20 20 20 20 <=mxPage ){.
27de0 20 20 75 38 20 65 54 79 70 65 3b 0a 20 20 20 20 u8 eType;.
27df0 20 20 61 73 73 65 72 74 28 20 6e 65 61 72 62 79 assert( nearby
27e00 3e 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 >0 );. asse
27e10 72 74 28 20 70 42 74 2d 3e 61 75 74 6f 56 61 63 rt( pBt->autoVac
27e20 75 75 6d 20 29 3b 0a 20 20 20 20 20 20 72 63 20 uum );. rc
27e30 3d 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c = ptrmapGet(pBt,
27e40 20 6e 65 61 72 62 79 2c 20 26 65 54 79 70 65 2c nearby, &eType,
27e50 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 0);. if( r
27e60 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 c ) return rc;.
27e70 20 20 20 20 20 69 66 28 20 65 54 79 70 65 3d 3d if( eType==
27e80 50 54 52 4d 41 50 5f 46 52 45 45 50 41 47 45 20 PTRMAP_FREEPAGE
27e90 29 7b 0a 20 20 20 20 20 20 20 20 73 65 61 72 63 ){. searc
27ea0 68 4c 69 73 74 20 3d 20 31 3b 0a 20 20 20 20 20 hList = 1;.
27eb0 20 7d 0a 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 }. *pPgno
27ec0 3d 20 6e 65 61 72 62 79 3b 0a 20 20 20 20 7d 0a = nearby;. }.
27ed0 23 65 6e 64 69 66 0a 0a 20 20 20 20 2f 2a 20 44 #endif.. /* D
27ee0 65 63 72 65 6d 65 6e 74 20 74 68 65 20 66 72 65 ecrement the fre
27ef0 65 2d 6c 69 73 74 20 63 6f 75 6e 74 20 62 79 20 e-list count by
27f00 31 2e 20 53 65 74 20 69 54 72 75 6e 6b 20 74 6f 1. Set iTrunk to
27f10 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 the index of th
27f20 65 0a 20 20 20 20 2a 2a 20 66 69 72 73 74 20 66 e. ** first f
27f30 72 65 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 ree-list trunk p
27f40 61 67 65 2e 20 69 50 72 65 76 54 72 75 6e 6b 20 age. iPrevTrunk
27f50 69 73 20 69 6e 69 74 69 61 6c 6c 79 20 31 2e 0a is initially 1..
27f60 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 */. rc =
27f70 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
27f80 65 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 e(pPage1->pDbPag
27f90 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 e);. if( rc )
27fa0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 return rc;.
27fb0 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
27fc0 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 6e 2d 31 ->aData[36], n-1
27fd0 29 3b 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 63 );.. /* The c
27fe0 6f 64 65 20 77 69 74 68 69 6e 20 74 68 69 73 20 ode within this
27ff0 6c 6f 6f 70 20 69 73 20 72 75 6e 20 6f 6e 6c 79 loop is run only
28000 20 6f 6e 63 65 20 69 66 20 74 68 65 20 27 73 65 once if the 'se
28010 61 72 63 68 4c 69 73 74 27 20 76 61 72 69 61 62 archList' variab
28020 6c 65 0a 20 20 20 20 2a 2a 20 69 73 20 6e 6f 74 le. ** is not
28030 20 74 72 75 65 2e 20 4f 74 68 65 72 77 69 73 65 true. Otherwise
28040 2c 20 69 74 20 72 75 6e 73 20 6f 6e 63 65 20 66 , it runs once f
28050 6f 72 20 65 61 63 68 20 74 72 75 6e 6b 2d 70 61 or each trunk-pa
28060 67 65 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a ge on the. **
28070 20 66 72 65 65 2d 6c 69 73 74 20 75 6e 74 69 6c free-list until
28080 20 74 68 65 20 70 61 67 65 20 27 6e 65 61 72 62 the page 'nearb
28090 79 27 20 69 73 20 6c 6f 63 61 74 65 64 2e 0a 20 y' is located..
280a0 20 20 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 */. do {.
280b0 20 20 20 20 20 70 50 72 65 76 54 72 75 6e 6b 20 pPrevTrunk
280c0 3d 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 = pTrunk;.
280d0 69 66 28 20 70 50 72 65 76 54 72 75 6e 6b 20 29 if( pPrevTrunk )
280e0 7b 0a 20 20 20 20 20 20 20 20 69 54 72 75 6e 6b {. iTrunk
280f0 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 72 = get4byte(&pPr
28100 65 76 54 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 evTrunk->aData[0
28110 5d 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b ]);. }else{
28120 0a 20 20 20 20 20 20 20 20 69 54 72 75 6e 6b 20 . iTrunk
28130 3d 20 67 65 74 34 62 79 74 65 28 26 70 50 61 67 = get4byte(&pPag
28140 65 31 2d 3e 61 44 61 74 61 5b 33 32 5d 29 3b 0a e1->aData[32]);.
28150 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 74 65 }. te
28160 73 74 63 61 73 65 28 20 69 54 72 75 6e 6b 3d 3d stcase( iTrunk==
28170 6d 78 50 61 67 65 20 29 3b 0a 20 20 20 20 20 20 mxPage );.
28180 69 66 28 20 69 54 72 75 6e 6b 3e 6d 78 50 61 67 if( iTrunk>mxPag
28190 65 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 e ){. rc
281a0 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
281b0 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 7d 65 6c _BKPT;. }el
281c0 73 65 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d se{. rc =
281d0 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 42 btreeGetPage(pB
281e0 74 2c 20 69 54 72 75 6e 6b 2c 20 26 70 54 72 75 t, iTrunk, &pTru
281f0 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a nk, 0);. }.
28200 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
28210 20 20 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d pTrunk =
28220 20 30 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 0;. goto
28230 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
28240 67 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ge;. }.
28250 20 20 61 73 73 65 72 74 28 20 70 54 72 75 6e 6b assert( pTrunk
28260 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 !=0 );. ass
28270 65 72 74 28 20 70 54 72 75 6e 6b 2d 3e 61 44 61 ert( pTrunk->aDa
28280 74 61 21 3d 30 20 29 3b 0a 0a 20 20 20 20 20 20 ta!=0 );..
28290 6b 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 54 k = get4byte(&pT
282a0 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 3b runk->aData[4]);
282b0 20 2f 2a 20 23 20 6f 66 20 6c 65 61 76 65 73 20 /* # of leaves
282c0 6f 6e 20 74 68 69 73 20 74 72 75 6e 6b 20 70 61 on this trunk pa
282d0 67 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 ge */. if(
282e0 6b 3d 3d 30 20 26 26 20 21 73 65 61 72 63 68 4c k==0 && !searchL
282f0 69 73 74 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ist ){. /
28300 2a 20 54 68 65 20 74 72 75 6e 6b 20 68 61 73 20 * The trunk has
28310 6e 6f 20 6c 65 61 76 65 73 20 61 6e 64 20 74 68 no leaves and th
28320 65 20 6c 69 73 74 20 69 73 20 6e 6f 74 20 62 65 e list is not be
28330 69 6e 67 20 73 65 61 72 63 68 65 64 2e 20 0a 20 ing searched. .
28340 20 20 20 20 20 20 20 2a 2a 20 53 6f 20 65 78 74 ** So ext
28350 72 61 63 74 20 74 68 65 20 74 72 75 6e 6b 20 70 ract the trunk p
28360 61 67 65 20 69 74 73 65 6c 66 20 61 6e 64 20 75 age itself and u
28370 73 65 20 69 74 20 61 73 20 74 68 65 20 6e 65 77 se it as the new
28380 6c 79 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 ly . ** a
28390 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 20 2a 2f llocated page */
283a0 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
283b0 20 70 50 72 65 76 54 72 75 6e 6b 3d 3d 30 20 29 pPrevTrunk==0 )
283c0 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 ;. rc = s
283d0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
283e0 28 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 (pTrunk->pDbPage
283f0 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
28400 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 c ){. g
28410 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 oto end_allocate
28420 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d _page;. }
28430 0a 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f 20 . *pPgno
28440 3d 20 69 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 = iTrunk;.
28450 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 31 memcpy(&pPage1
28460 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 26 70 54 ->aData[32], &pT
28470 72 75 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 runk->aData[0],
28480 34 29 3b 0a 20 20 20 20 20 20 20 20 2a 70 70 50 4);. *ppP
28490 61 67 65 20 3d 20 70 54 72 75 6e 6b 3b 0a 20 20 age = pTrunk;.
284a0 20 20 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 pTrunk = 0
284b0 3b 0a 20 20 20 20 20 20 20 20 54 52 41 43 45 28 ;. TRACE(
284c0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 ("ALLOCATE: %d t
284d0 72 75 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 runk - %d free p
284e0 61 67 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 ages left\n", *p
284f0 50 67 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 20 20 20 Pgno, n-1));.
28500 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6b 3e 28 }else if( k>(
28510 75 33 32 29 28 70 42 74 2d 3e 75 73 61 62 6c 65 u32)(pBt->usable
28520 53 69 7a 65 2f 34 20 2d 20 32 29 20 29 7b 0a 20 Size/4 - 2) ){.
28530 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 /* Value
28540 6f 66 20 6b 20 69 73 20 6f 75 74 20 6f 66 20 72 of k is out of r
28550 61 6e 67 65 2e 20 20 44 61 74 61 62 61 73 65 20 ange. Database
28560 63 6f 72 72 75 70 74 69 6f 6e 20 2a 2f 0a 20 20 corruption */.
28570 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
28580 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
28590 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
285a0 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
285b0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
285c0 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 MIT_AUTOVACUUM.
285d0 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73 }else if( s
285e0 65 61 72 63 68 4c 69 73 74 20 26 26 20 6e 65 61 earchList && nea
285f0 72 62 79 3d 3d 69 54 72 75 6e 6b 20 29 7b 0a 20 rby==iTrunk ){.
28600 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6c 69 /* The li
28610 73 74 20 69 73 20 62 65 69 6e 67 20 73 65 61 72 st is being sear
28620 63 68 65 64 20 61 6e 64 20 74 68 69 73 20 74 72 ched and this tr
28630 75 6e 6b 20 70 61 67 65 20 69 73 20 74 68 65 20 unk page is the
28640 70 61 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 page. **
28650 74 6f 20 61 6c 6c 6f 63 61 74 65 2c 20 72 65 67 to allocate, reg
28660 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 ardless of wheth
28670 65 72 20 69 74 20 68 61 73 20 6c 65 61 76 65 73 er it has leaves
28680 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
28690 20 20 20 20 20 61 73 73 65 72 74 28 20 2a 70 50 assert( *pP
286a0 67 6e 6f 3d 3d 69 54 72 75 6e 6b 20 29 3b 0a 20 gno==iTrunk );.
286b0 20 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d *ppPage =
286c0 20 70 54 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 pTrunk;.
286d0 20 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b searchList = 0;
286e0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
286f0 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 lite3PagerWrite(
28700 70 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 pTrunk->pDbPage)
28710 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 ;. if( rc
28720 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f ){. go
28730 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f to end_allocate_
28740 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a page;. }.
28750 20 20 20 20 20 20 20 20 69 66 28 20 6b 3d 3d 30 if( k==0
28760 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 ){. if
28770 28 20 21 70 50 72 65 76 54 72 75 6e 6b 20 29 7b ( !pPrevTrunk ){
28780 0a 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d . mem
28790 63 70 79 28 26 70 50 61 67 65 31 2d 3e 61 44 61 cpy(&pPage1->aDa
287a0 74 61 5b 33 32 5d 2c 20 26 70 54 72 75 6e 6b 2d ta[32], &pTrunk-
287b0 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 >aData[0], 4);.
287c0 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a }else{.
287d0 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
287e0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
287f0 74 65 28 70 50 72 65 76 54 72 75 6e 6b 2d 3e 70 te(pPrevTrunk->p
28800 44 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 DbPage);.
28810 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
28820 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
28830 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
28840 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
28850 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
28860 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
28870 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e 61 44 (&pPrevTrunk->aD
28880 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 6e 6b 2d ata[0], &pTrunk-
28890 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 3b 0a 20 >aData[0], 4);.
288a0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
288b0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
288c0 20 20 20 20 2f 2a 20 54 68 65 20 74 72 75 6e 6b /* The trunk
288d0 20 70 61 67 65 20 69 73 20 72 65 71 75 69 72 65 page is require
288e0 64 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 20 d by the caller
288f0 62 75 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 but it contains
28900 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 6f . ** po
28910 69 6e 74 65 72 73 20 74 6f 20 66 72 65 65 2d 6c inters to free-l
28920 69 73 74 20 6c 65 61 76 65 73 2e 20 54 68 65 20 ist leaves. The
28930 66 69 72 73 74 20 6c 65 61 66 20 62 65 63 6f 6d first leaf becom
28940 65 73 20 61 20 74 72 75 6e 6b 0a 20 20 20 20 20 es a trunk.
28950 20 20 20 20 20 2a 2a 20 70 61 67 65 20 69 6e 20 ** page in
28960 74 68 69 73 20 63 61 73 65 2e 0a 20 20 20 20 20 this case..
28970 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
28980 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e 65 77 54 MemPage *pNewT
28990 72 75 6e 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 runk;.
289a0 50 67 6e 6f 20 69 4e 65 77 54 72 75 6e 6b 20 3d Pgno iNewTrunk =
289b0 20 67 65 74 34 62 79 74 65 28 26 70 54 72 75 6e get4byte(&pTrun
289c0 6b 2d 3e 61 44 61 74 61 5b 38 5d 29 3b 0a 20 20 k->aData[8]);.
289d0 20 20 20 20 20 20 20 20 69 66 28 20 69 4e 65 77 if( iNew
289e0 54 72 75 6e 6b 3e 6d 78 50 61 67 65 20 29 7b 20 Trunk>mxPage ){
289f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 . rc
28a00 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
28a10 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 _BKPT;.
28a20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f goto end_allo
28a30 63 61 74 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 cate_page;.
28a40 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
28a50 20 74 65 73 74 63 61 73 65 28 20 69 4e 65 77 54 testcase( iNewT
28a60 72 75 6e 6b 3d 3d 6d 78 50 61 67 65 20 29 3b 0a runk==mxPage );.
28a70 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 62 rc = b
28a80 74 72 65 65 47 65 74 50 61 67 65 28 70 42 74 2c treeGetPage(pBt,
28a90 20 69 4e 65 77 54 72 75 6e 6b 2c 20 26 70 4e 65 iNewTrunk, &pNe
28aa0 77 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 20 20 wTrunk, 0);.
28ab0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
28ac0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
28ad0 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f goto end_
28ae0 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a 20 allocate_page;.
28af0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
28b00 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
28b10 33 50 61 67 65 72 57 72 69 74 65 28 70 4e 65 77 3PagerWrite(pNew
28b20 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 65 29 3b Trunk->pDbPage);
28b30 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 . if( r
28b40 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
28b50 20 20 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 rele
28b60 61 73 65 50 61 67 65 28 70 4e 65 77 54 72 75 6e asePage(pNewTrun
28b70 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 k);.
28b80 67 6f 74 6f 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 goto end_allocat
28b90 65 5f 70 61 67 65 3b 0a 20 20 20 20 20 20 20 20 e_page;.
28ba0 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 6d 65 }. me
28bb0 6d 63 70 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d mcpy(&pNewTrunk-
28bc0 3e 61 44 61 74 61 5b 30 5d 2c 20 26 70 54 72 75 >aData[0], &pTru
28bd0 6e 6b 2d 3e 61 44 61 74 61 5b 30 5d 2c 20 34 29 nk->aData[0], 4)
28be0 3b 0a 20 20 20 20 20 20 20 20 20 20 70 75 74 34 ;. put4
28bf0 62 79 74 65 28 26 70 4e 65 77 54 72 75 6e 6b 2d byte(&pNewTrunk-
28c00 3e 61 44 61 74 61 5b 34 5d 2c 20 6b 2d 31 29 3b >aData[4], k-1);
28c10 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 . memcp
28c20 79 28 26 70 4e 65 77 54 72 75 6e 6b 2d 3e 61 44 y(&pNewTrunk->aD
28c30 61 74 61 5b 38 5d 2c 20 26 70 54 72 75 6e 6b 2d ata[8], &pTrunk-
28c40 3e 61 44 61 74 61 5b 31 32 5d 2c 20 28 6b 2d 31 >aData[12], (k-1
28c50 29 2a 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 )*4);.
28c60 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 releasePage(pNew
28c70 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 Trunk);.
28c80 20 20 69 66 28 20 21 70 50 72 65 76 54 72 75 6e if( !pPrevTrun
28c90 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 k ){.
28ca0 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
28cb0 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 PagerIswriteable
28cc0 28 70 50 61 67 65 31 2d 3e 70 44 62 50 61 67 65 (pPage1->pDbPage
28cd0 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ) );.
28ce0 20 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 put4byte(&pPage
28cf0 31 2d 3e 61 44 61 74 61 5b 33 32 5d 2c 20 69 4e 1->aData[32], iN
28d00 65 77 54 72 75 6e 6b 29 3b 0a 20 20 20 20 20 20 ewTrunk);.
28d10 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
28d20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
28d30 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
28d40 72 65 76 54 72 75 6e 6b 2d 3e 70 44 62 50 61 67 revTrunk->pDbPag
28d50 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 e);.
28d60 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
28d70 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 goto end
28d80 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 65 3b 0a _allocate_page;.
28d90 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 }.
28da0 20 20 20 20 20 20 20 20 20 20 70 75 74 34 62 79 put4by
28db0 74 65 28 26 70 50 72 65 76 54 72 75 6e 6b 2d 3e te(&pPrevTrunk->
28dc0 61 44 61 74 61 5b 30 5d 2c 20 69 4e 65 77 54 72 aData[0], iNewTr
28dd0 75 6e 6b 29 3b 0a 20 20 20 20 20 20 20 20 20 20 unk);.
28de0 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
28df0 20 20 20 20 70 54 72 75 6e 6b 20 3d 20 30 3b 0a pTrunk = 0;.
28e00 20 20 20 20 20 20 20 20 54 52 41 43 45 28 28 22 TRACE(("
28e10 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 74 72 75 ALLOCATE: %d tru
28e20 6e 6b 20 2d 20 25 64 20 66 72 65 65 20 70 61 67 nk - %d free pag
28e30 65 73 20 6c 65 66 74 5c 6e 22 2c 20 2a 70 50 67 es left\n", *pPg
28e40 6e 6f 2c 20 6e 2d 31 29 29 3b 0a 23 65 6e 64 69 no, n-1));.#endi
28e50 66 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 f. }else if
28e60 28 20 6b 3e 30 20 29 7b 0a 20 20 20 20 20 20 20 ( k>0 ){.
28e70 20 2f 2a 20 45 78 74 72 61 63 74 20 61 20 6c 65 /* Extract a le
28e80 61 66 20 66 72 6f 6d 20 74 68 65 20 74 72 75 6e af from the trun
28e90 6b 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 33 32 k */. u32
28ea0 20 63 6c 6f 73 65 73 74 3b 0a 20 20 20 20 20 20 closest;.
28eb0 20 20 50 67 6e 6f 20 69 50 61 67 65 3b 0a 20 20 Pgno iPage;.
28ec0 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 63 unsigned c
28ed0 68 61 72 20 2a 61 44 61 74 61 20 3d 20 70 54 72 har *aData = pTr
28ee0 75 6e 6b 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 unk->aData;.
28ef0 20 20 20 20 69 66 28 20 6e 65 61 72 62 79 3e 30 if( nearby>0
28f00 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33 ){. u3
28f10 32 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 69 2 i;. i
28f20 6e 74 20 64 69 73 74 3b 0a 20 20 20 20 20 20 20 nt dist;.
28f30 20 20 20 63 6c 6f 73 65 73 74 20 3d 20 30 3b 0a closest = 0;.
28f40 20 20 20 20 20 20 20 20 20 20 64 69 73 74 20 3d dist =
28f50 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 sqlite3AbsInt32
28f60 28 67 65 74 34 62 79 74 65 28 26 61 44 61 74 61 (get4byte(&aData
28f70 5b 38 5d 29 20 2d 20 6e 65 61 72 62 79 29 3b 0a [8]) - nearby);.
28f80 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d for(i=
28f90 31 3b 20 69 3c 6b 3b 20 69 2b 2b 29 7b 0a 20 20 1; i<k; i++){.
28fa0 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 64 32 int d2
28fb0 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 = sqlite3AbsInt
28fc0 33 32 28 67 65 74 34 62 79 74 65 28 26 61 44 61 32(get4byte(&aDa
28fd0 74 61 5b 38 2b 69 2a 34 5d 29 20 2d 20 6e 65 61 ta[8+i*4]) - nea
28fe0 72 62 79 29 3b 0a 20 20 20 20 20 20 20 20 20 20 rby);.
28ff0 20 20 69 66 28 20 64 32 3c 64 69 73 74 20 29 7b if( d2<dist ){
29000 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 . c
29010 6c 6f 73 65 73 74 20 3d 20 69 3b 0a 20 20 20 20 losest = i;.
29020 20 20 20 20 20 20 20 20 20 20 64 69 73 74 20 3d dist =
29030 20 64 32 3b 0a 20 20 20 20 20 20 20 20 20 20 20 d2;.
29040 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
29050 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
29060 20 20 20 20 20 20 20 20 63 6c 6f 73 65 73 74 20 closest
29070 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a = 0;. }..
29080 20 20 20 20 20 20 20 20 69 50 61 67 65 20 3d 20 iPage =
29090 67 65 74 34 62 79 74 65 28 26 61 44 61 74 61 5b get4byte(&aData[
290a0 38 2b 63 6c 6f 73 65 73 74 2a 34 5d 29 3b 0a 20 8+closest*4]);.
290b0 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 testcase(
290c0 20 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 iPage==mxPage )
290d0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 50 ;. if( iP
290e0 61 67 65 3e 6d 78 50 61 67 65 20 29 7b 0a 20 20 age>mxPage ){.
290f0 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
29100 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
29110 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f ;. goto
29120 20 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 end_allocate_pa
29130 67 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ge;. }.
29140 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
29150 69 50 61 67 65 3d 3d 6d 78 50 61 67 65 20 29 3b iPage==mxPage );
29160 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 73 65 . if( !se
29170 61 72 63 68 4c 69 73 74 20 7c 7c 20 69 50 61 67 archList || iPag
29180 65 3d 3d 6e 65 61 72 62 79 20 29 7b 0a 20 20 20 e==nearby ){.
29190 20 20 20 20 20 20 20 69 6e 74 20 6e 6f 43 6f 6e int noCon
291a0 74 65 6e 74 3b 0a 20 20 20 20 20 20 20 20 20 20 tent;.
291b0 2a 70 50 67 6e 6f 20 3d 20 69 50 61 67 65 3b 0a *pPgno = iPage;.
291c0 20 20 20 20 20 20 20 20 20 20 54 52 41 43 45 28 TRACE(
291d0 28 22 41 4c 4c 4f 43 41 54 45 3a 20 25 64 20 77 ("ALLOCATE: %d w
291e0 61 73 20 6c 65 61 66 20 25 64 20 6f 66 20 25 64 as leaf %d of %d
291f0 20 6f 6e 20 74 72 75 6e 6b 20 25 64 22 0a 20 20 on trunk %d".
29200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 "
29210 3a 20 25 64 20 6d 6f 72 65 20 66 72 65 65 20 70 : %d more free p
29220 61 67 65 73 5c 6e 22 2c 0a 20 20 20 20 20 20 20 ages\n",.
29230 20 20 20 20 20 20 20 20 20 20 2a 70 50 67 6e 6f *pPgno
29240 2c 20 63 6c 6f 73 65 73 74 2b 31 2c 20 6b 2c 20 , closest+1, k,
29250 70 54 72 75 6e 6b 2d 3e 70 67 6e 6f 2c 20 6e 2d pTrunk->pgno, n-
29260 31 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 1));. r
29270 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
29280 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 Write(pTrunk->pD
29290 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 bPage);.
292a0 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 if( rc ) goto
292b0 65 6e 64 5f 61 6c 6c 6f 63 61 74 65 5f 70 61 67 end_allocate_pag
292c0 65 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 e;. if(
292d0 20 63 6c 6f 73 65 73 74 3c 6b 2d 31 20 29 7b 0a closest<k-1 ){.
292e0 20 20 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 memc
292f0 70 79 28 26 61 44 61 74 61 5b 38 2b 63 6c 6f 73 py(&aData[8+clos
29300 65 73 74 2a 34 5d 2c 20 26 61 44 61 74 61 5b 34 est*4], &aData[4
29310 2b 6b 2a 34 5d 2c 20 34 29 3b 0a 20 20 20 20 20 +k*4], 4);.
29320 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
29330 20 70 75 74 34 62 79 74 65 28 26 61 44 61 74 61 put4byte(&aData
29340 5b 34 5d 2c 20 6b 2d 31 29 3b 0a 20 20 20 20 20 [4], k-1);.
29350 20 20 20 20 20 6e 6f 43 6f 6e 74 65 6e 74 20 3d noContent =
29360 20 21 62 74 72 65 65 47 65 74 48 61 73 43 6f 6e !btreeGetHasCon
29370 74 65 6e 74 28 70 42 74 2c 20 2a 70 50 67 6e 6f tent(pBt, *pPgno
29380 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 );. rc
29390 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 70 = btreeGetPage(p
293a0 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 50 61 Bt, *pPgno, ppPa
293b0 67 65 2c 20 6e 6f 43 6f 6e 74 65 6e 74 29 3b 0a ge, noContent);.
293c0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 if( rc
293d0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
293e0 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
293f0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
29400 65 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 62 e((*ppPage)->pDb
29410 50 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 Page);.
29420 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
29430 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
29440 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 releasePag
29450 65 28 2a 70 70 50 61 67 65 29 3b 0a 20 20 20 20 e(*ppPage);.
29460 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
29470 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
29480 73 65 61 72 63 68 4c 69 73 74 20 3d 20 30 3b 0a searchList = 0;.
29490 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
294a0 7d 0a 20 20 20 20 20 20 72 65 6c 65 61 73 65 50 }. releaseP
294b0 61 67 65 28 70 50 72 65 76 54 72 75 6e 6b 29 3b age(pPrevTrunk);
294c0 0a 20 20 20 20 20 20 70 50 72 65 76 54 72 75 6e . pPrevTrun
294d0 6b 20 3d 20 30 3b 0a 20 20 20 20 7d 77 68 69 6c k = 0;. }whil
294e0 65 28 20 73 65 61 72 63 68 4c 69 73 74 20 29 3b e( searchList );
294f0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a . }else{. /*
29500 20 54 68 65 72 65 20 61 72 65 20 6e 6f 20 70 61 There are no pa
29510 67 65 73 20 6f 6e 20 74 68 65 20 66 72 65 65 6c ges on the freel
29520 69 73 74 2c 20 73 6f 20 63 72 65 61 74 65 20 61 ist, so create a
29530 20 6e 65 77 20 70 61 67 65 20 61 74 20 74 68 65 new page at the
29540 0a 20 20 20 20 2a 2a 20 65 6e 64 20 6f 66 20 74 . ** end of t
29550 68 65 20 66 69 6c 65 20 2a 2f 0a 20 20 20 20 72 he file */. r
29560 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
29570 57 72 69 74 65 28 70 42 74 2d 3e 70 50 61 67 65 Write(pBt->pPage
29580 31 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 1->pDbPage);.
29590 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
295a0 20 72 63 3b 0a 20 20 20 20 70 42 74 2d 3e 6e 50 rc;. pBt->nP
295b0 61 67 65 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 age++;. if( p
295c0 42 74 2d 3e 6e 50 61 67 65 3d 3d 50 45 4e 44 49 Bt->nPage==PENDI
295d0 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
295e0 29 20 29 20 70 42 74 2d 3e 6e 50 61 67 65 2b 2b ) ) pBt->nPage++
295f0 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ;..#ifndef SQLIT
29600 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 55 55 E_OMIT_AUTOVACUU
29610 4d 0a 20 20 20 20 69 66 28 20 70 42 74 2d 3e 61 M. if( pBt->a
29620 75 74 6f 56 61 63 75 75 6d 20 26 26 20 50 54 52 utoVacuum && PTR
29630 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
29640 70 42 74 2d 3e 6e 50 61 67 65 29 20 29 7b 0a 20 pBt->nPage) ){.
29650 20 20 20 20 20 2f 2a 20 49 66 20 2a 70 50 67 6e /* If *pPgn
29660 6f 20 72 65 66 65 72 73 20 74 6f 20 61 20 70 6f o refers to a po
29670 69 6e 74 65 72 2d 6d 61 70 20 70 61 67 65 2c 20 inter-map page,
29680 61 6c 6c 6f 63 61 74 65 20 74 77 6f 20 6e 65 77 allocate two new
29690 20 70 61 67 65 73 0a 20 20 20 20 20 20 2a 2a 20 pages. **
296a0 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 at the end of th
296b0 65 20 66 69 6c 65 20 69 6e 73 74 65 61 64 20 6f e file instead o
296c0 66 20 6f 6e 65 2e 20 54 68 65 20 66 69 72 73 74 f one. The first
296d0 20 61 6c 6c 6f 63 61 74 65 64 20 70 61 67 65 0a allocated page.
296e0 20 20 20 20 20 20 2a 2a 20 62 65 63 6f 6d 65 73 ** becomes
296f0 20 61 20 6e 65 77 20 70 6f 69 6e 74 65 72 2d 6d a new pointer-m
29700 61 70 20 70 61 67 65 2c 20 74 68 65 20 73 65 63 ap page, the sec
29710 6f 6e 64 20 69 73 20 75 73 65 64 20 62 79 20 74 ond is used by t
29720 68 65 20 63 61 6c 6c 65 72 2e 0a 20 20 20 20 20 he caller..
29730 20 2a 2f 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 */. MemPag
29740 65 20 2a 70 50 67 20 3d 20 30 3b 0a 20 20 20 20 e *pPg = 0;.
29750 20 20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 TRACE(("ALLOCA
29760 54 45 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 TE: %d from end
29770 6f 66 20 66 69 6c 65 20 28 70 6f 69 6e 74 65 72 of file (pointer
29780 2d 6d 61 70 20 70 61 67 65 29 5c 6e 22 2c 20 70 -map page)\n", p
29790 42 74 2d 3e 6e 50 61 67 65 29 29 3b 0a 20 20 20 Bt->nPage));.
297a0 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d 3e assert( pBt->
297b0 6e 50 61 67 65 21 3d 50 45 4e 44 49 4e 47 5f 42 nPage!=PENDING_B
297c0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 29 3b YTE_PAGE(pBt) );
297d0 0a 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 . rc = btre
297e0 65 47 65 74 50 61 67 65 28 70 42 74 2c 20 70 42 eGetPage(pBt, pB
297f0 74 2d 3e 6e 50 61 67 65 2c 20 26 70 50 67 2c 20 t->nPage, &pPg,
29800 31 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 1);. if( rc
29810 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
29820 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
29830 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 te3PagerWrite(pP
29840 67 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 g->pDbPage);.
29850 20 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 releasePage
29860 28 70 50 67 29 3b 0a 20 20 20 20 20 20 7d 0a 20 (pPg);. }.
29870 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
29880 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 70 turn rc;. p
29890 42 74 2d 3e 6e 50 61 67 65 2b 2b 3b 0a 20 20 20 Bt->nPage++;.
298a0 20 20 20 69 66 28 20 70 42 74 2d 3e 6e 50 61 67 if( pBt->nPag
298b0 65 3d 3d 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f e==PENDING_BYTE_
298c0 50 41 47 45 28 70 42 74 29 20 29 7b 20 70 42 74 PAGE(pBt) ){ pBt
298d0 2d 3e 6e 50 61 67 65 2b 2b 3b 20 7d 0a 20 20 20 ->nPage++; }.
298e0 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 75 }.#endif. pu
298f0 74 34 62 79 74 65 28 32 38 20 2b 20 28 75 38 2a t4byte(28 + (u8*
29900 29 70 42 74 2d 3e 70 50 61 67 65 31 2d 3e 61 44 )pBt->pPage1->aD
29910 61 74 61 2c 20 70 42 74 2d 3e 6e 50 61 67 65 29 ata, pBt->nPage)
29920 3b 0a 20 20 20 20 2a 70 50 67 6e 6f 20 3d 20 70 ;. *pPgno = p
29930 42 74 2d 3e 6e 50 61 67 65 3b 0a 0a 20 20 20 20 Bt->nPage;..
29940 61 73 73 65 72 74 28 20 2a 70 50 67 6e 6f 21 3d assert( *pPgno!=
29950 50 45 4e 44 49 4e 47 5f 42 59 54 45 5f 50 41 47 PENDING_BYTE_PAG
29960 45 28 70 42 74 29 20 29 3b 0a 20 20 20 20 72 63 E(pBt) );. rc
29970 20 3d 20 62 74 72 65 65 47 65 74 50 61 67 65 28 = btreeGetPage(
29980 70 42 74 2c 20 2a 70 50 67 6e 6f 2c 20 70 70 50 pBt, *pPgno, ppP
29990 61 67 65 2c 20 31 29 3b 0a 20 20 20 20 69 66 28 age, 1);. if(
299a0 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
299b0 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
299c0 33 50 61 67 65 72 57 72 69 74 65 28 28 2a 70 70 3PagerWrite((*pp
299d0 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 3b Page)->pDbPage);
299e0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
299f0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
29a00 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 70 50 releasePage(*ppP
29a10 61 67 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 age);. }.
29a20 54 52 41 43 45 28 28 22 41 4c 4c 4f 43 41 54 45 TRACE(("ALLOCATE
29a30 3a 20 25 64 20 66 72 6f 6d 20 65 6e 64 20 6f 66 : %d from end of
29a40 20 66 69 6c 65 5c 6e 22 2c 20 2a 70 50 67 6e 6f file\n", *pPgno
29a50 29 29 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 ));. }.. asser
29a60 74 28 20 2a 70 50 67 6e 6f 21 3d 50 45 4e 44 49 t( *pPgno!=PENDI
29a70 4e 47 5f 42 59 54 45 5f 50 41 47 45 28 70 42 74 NG_BYTE_PAGE(pBt
29a80 29 20 29 3b 0a 0a 65 6e 64 5f 61 6c 6c 6f 63 61 ) );..end_alloca
29a90 74 65 5f 70 61 67 65 3a 0a 20 20 72 65 6c 65 61 te_page:. relea
29aa0 73 65 50 61 67 65 28 70 54 72 75 6e 6b 29 3b 0a sePage(pTrunk);.
29ab0 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 50 releasePage(pP
29ac0 72 65 76 54 72 75 6e 6b 29 3b 0a 20 20 69 66 28 revTrunk);. if(
29ad0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
29ae0 7b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 {. if( sqlite
29af0 33 50 61 67 65 72 50 61 67 65 52 65 66 63 6f 75 3PagerPageRefcou
29b00 6e 74 28 28 2a 70 70 50 61 67 65 29 2d 3e 70 44 nt((*ppPage)->pD
29b10 62 50 61 67 65 29 3e 31 20 29 7b 0a 20 20 20 20 bPage)>1 ){.
29b20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 2a 70 releasePage(*p
29b30 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 72 65 pPage);. re
29b40 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 turn SQLITE_CORR
29b50 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a UPT_BKPT;. }.
29b60 20 20 20 20 28 2a 70 70 50 61 67 65 29 2d 3e 69 (*ppPage)->i
29b70 73 49 6e 69 74 20 3d 20 30 3b 0a 20 20 7d 65 6c sInit = 0;. }el
29b80 73 65 7b 0a 20 20 20 20 2a 70 70 50 61 67 65 20 se{. *ppPage
29b90 3d 20 30 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 = 0;. }. asser
29ba0 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b t( rc!=SQLITE_OK
29bb0 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 || sqlite3Pager
29bc0 49 73 77 72 69 74 65 61 62 6c 65 28 28 2a 70 70 Iswriteable((*pp
29bd0 50 61 67 65 29 2d 3e 70 44 62 50 61 67 65 29 20 Page)->pDbPage)
29be0 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a );. return rc;.
29bf0 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 }../*.** This fu
29c00 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 nction is used t
29c10 6f 20 61 64 64 20 70 61 67 65 20 69 50 61 67 65 o add page iPage
29c20 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
29c30 20 66 69 6c 65 20 66 72 65 65 2d 6c 69 73 74 2e file free-list.
29c40 20 0a 2a 2a 20 49 74 20 69 73 20 61 73 73 75 6d .** It is assum
29c50 65 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 ed that the page
29c60 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
29c70 61 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 72 a part of the fr
29c80 65 65 2d 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 54 ee-list..**.** T
29c90 68 65 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 he value passed
29ca0 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 as the second ar
29cb0 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 gument to this f
29cc0 75 6e 63 74 69 6f 6e 20 69 73 20 6f 70 74 69 6f unction is optio
29cd0 6e 61 6c 2e 0a 2a 2a 20 49 66 20 74 68 65 20 63 nal..** If the c
29ce0 61 6c 6c 65 72 20 68 61 70 70 65 6e 73 20 74 6f aller happens to
29cf0 20 68 61 76 65 20 61 20 70 6f 69 6e 74 65 72 20 have a pointer
29d00 74 6f 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f to the MemPage o
29d10 62 6a 65 63 74 20 0a 2a 2a 20 63 6f 72 72 65 73 bject .** corres
29d20 70 6f 6e 64 69 6e 67 20 74 6f 20 70 61 67 65 20 ponding to page
29d30 69 50 61 67 65 20 68 61 6e 64 79 2c 20 69 74 20 iPage handy, it
29d40 6d 61 79 20 70 61 73 73 20 69 74 20 61 73 20 74 may pass it as t
29d50 68 65 20 73 65 63 6f 6e 64 20 76 61 6c 75 65 2e he second value.
29d60 20 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 .** Otherwise,
29d70 69 74 20 6d 61 79 20 70 61 73 73 20 4e 55 4c 4c it may pass NULL
29d80 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 70 6f 69 ..**.** If a poi
29d90 6e 74 65 72 20 74 6f 20 61 20 4d 65 6d 50 61 67 nter to a MemPag
29da0 65 20 6f 62 6a 65 63 74 20 69 73 20 70 61 73 73 e object is pass
29db0 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 ed as the second
29dc0 20 61 72 67 75 6d 65 6e 74 2c 0a 2a 2a 20 69 74 argument,.** it
29dd0 73 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e s reference coun
29de0 74 20 69 73 20 6e 6f 74 20 61 6c 74 65 72 65 64 t is not altered
29df0 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f by this functio
29e00 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 n..*/.static int
29e10 20 66 72 65 65 50 61 67 65 32 28 42 74 53 68 61 freePage2(BtSha
29e20 72 65 64 20 2a 70 42 74 2c 20 4d 65 6d 50 61 67 red *pBt, MemPag
29e30 65 20 2a 70 4d 65 6d 50 61 67 65 2c 20 50 67 6e e *pMemPage, Pgn
29e40 6f 20 69 50 61 67 65 29 7b 0a 20 20 4d 65 6d 50 o iPage){. MemP
29e50 61 67 65 20 2a 70 54 72 75 6e 6b 20 3d 20 30 3b age *pTrunk = 0;
29e60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29e70 2f 2a 20 46 72 65 65 2d 6c 69 73 74 20 74 72 75 /* Free-list tru
29e80 6e 6b 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 6e nk page */. Pgn
29e90 6f 20 69 54 72 75 6e 6b 20 3d 20 30 3b 20 20 20 o iTrunk = 0;
29ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29eb0 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 /* Page number
29ec0 6f 66 20 66 72 65 65 2d 6c 69 73 74 20 74 72 75 of free-list tru
29ed0 6e 6b 20 70 61 67 65 20 2a 2f 20 0a 20 20 4d 65 nk page */ . Me
29ee0 6d 50 61 67 65 20 2a 70 50 61 67 65 31 20 3d 20 mPage *pPage1 =
29ef0 70 42 74 2d 3e 70 50 61 67 65 31 3b 20 20 20 20 pBt->pPage1;
29f00 20 20 2f 2a 20 4c 6f 63 61 6c 20 72 65 66 65 72 /* Local refer
29f10 65 6e 63 65 20 74 6f 20 70 61 67 65 20 31 20 2a ence to page 1 *
29f20 2f 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 /. MemPage *pPa
29f30 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
29f40 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 /* Page
29f50 62 65 69 6e 67 20 66 72 65 65 64 2e 20 4d 61 79 being freed. May
29f60 20 62 65 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 69 be NULL. */. i
29f70 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
29f80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29f90 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f 64 /* Return Cod
29fa0 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 72 65 65 e */. int nFree
29fb0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
29fc0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
29fd0 69 74 69 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 itial number of
29fe0 70 61 67 65 73 20 6f 6e 20 66 72 65 65 2d 6c 69 pages on free-li
29ff0 73 74 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 st */.. assert(
2a000 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 sqlite3_mutex_h
2a010 65 6c 64 28 70 42 74 2d 3e 6d 75 74 65 78 29 20 eld(pBt->mutex)
2a020 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 50 61 );. assert( iPa
2a030 67 65 3e 31 20 29 3b 0a 20 20 61 73 73 65 72 74 ge>1 );. assert
2a040 28 20 21 70 4d 65 6d 50 61 67 65 20 7c 7c 20 70 ( !pMemPage || p
2a050 4d 65 6d 50 61 67 65 2d 3e 70 67 6e 6f 3d 3d 69 MemPage->pgno==i
2a060 50 61 67 65 20 29 3b 0a 0a 20 20 69 66 28 20 70 Page );.. if( p
2a070 4d 65 6d 50 61 67 65 20 29 7b 0a 20 20 20 20 70 MemPage ){. p
2a080 50 61 67 65 20 3d 20 70 4d 65 6d 50 61 67 65 3b Page = pMemPage;
2a090 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 . sqlite3Page
2a0a0 72 52 65 66 28 70 50 61 67 65 2d 3e 70 44 62 50 rRef(pPage->pDbP
2a0b0 61 67 65 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 age);. }else{.
2a0c0 20 20 20 70 50 61 67 65 20 3d 20 62 74 72 65 65 pPage = btree
2a0d0 50 61 67 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 PageLookup(pBt,
2a0e0 69 50 61 67 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f iPage);. }.. /
2a0f0 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 * Increment the
2a100 66 72 65 65 20 70 61 67 65 20 63 6f 75 6e 74 20 free page count
2a110 6f 6e 20 70 50 61 67 65 31 20 2a 2f 0a 20 20 72 on pPage1 */. r
2a120 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2a130 57 72 69 74 65 28 70 50 61 67 65 31 2d 3e 70 44 Write(pPage1->pD
2a140 62 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 bPage);. if( rc
2a150 20 29 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 ) goto freepage
2a160 5f 6f 75 74 3b 0a 20 20 6e 46 72 65 65 20 3d 20 _out;. nFree =
2a170 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 31 get4byte(&pPage1
2a180 2d 3e 61 44 61 74 61 5b 33 36 5d 29 3b 0a 20 20 ->aData[36]);.
2a190 70 75 74 34 62 79 74 65 28 26 70 50 61 67 65 31 put4byte(&pPage1
2a1a0 2d 3e 61 44 61 74 61 5b 33 36 5d 2c 20 6e 46 72 ->aData[36], nFr
2a1b0 65 65 2b 31 29 3b 0a 0a 20 20 69 66 28 20 70 42 ee+1);.. if( pB
2a1c0 74 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 t->btsFlags & BT
2a1d0 53 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 S_SECURE_DELETE
2a1e0 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 ){. /* If the
2a1f0 20 73 65 63 75 72 65 5f 64 65 6c 65 74 65 20 6f secure_delete o
2a200 70 74 69 6f 6e 20 69 73 20 65 6e 61 62 6c 65 64 ption is enabled
2a210 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 61 6c , then. ** al
2a220 77 61 79 73 20 66 75 6c 6c 79 20 6f 76 65 72 77 ways fully overw
2a230 72 69 74 65 20 64 65 6c 65 74 65 64 20 69 6e 66 rite deleted inf
2a240 6f 72 6d 61 74 69 6f 6e 20 77 69 74 68 20 7a 65 ormation with ze
2a250 72 6f 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ros.. */.
2a260 69 66 28 20 28 21 70 50 61 67 65 20 26 26 20 28 if( (!pPage && (
2a270 28 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 61 (rc = btreeGetPa
2a280 67 65 28 70 42 74 2c 20 69 50 61 67 65 2c 20 26 ge(pBt, iPage, &
2a290 70 50 61 67 65 2c 20 30 29 29 21 3d 30 29 20 29 pPage, 0))!=0) )
2a2a0 0a 20 20 20 20 20 7c 7c 20 20 20 20 20 20 20 20 . ||
2a2b0 20 20 20 20 28 28 72 63 20 3d 20 73 71 6c 69 74 ((rc = sqlit
2a2c0 65 33 50 61 67 65 72 57 72 69 74 65 28 70 50 61 e3PagerWrite(pPa
2a2d0 67 65 2d 3e 70 44 62 50 61 67 65 29 29 21 3d 30 ge->pDbPage))!=0
2a2e0 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 67 ). ){. g
2a2f0 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
2a300 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 ;. }. mems
2a310 65 74 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c et(pPage->aData,
2a320 20 30 2c 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 0, pPage->pBt->
2a330 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 7d 0a 0a pageSize);. }..
2a340 20 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 /* If the data
2a350 62 61 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 base supports au
2a360 74 6f 2d 76 61 63 75 75 6d 2c 20 77 72 69 74 65 to-vacuum, write
2a370 20 61 6e 20 65 6e 74 72 79 20 69 6e 20 74 68 65 an entry in the
2a380 20 70 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 2a pointer-map. *
2a390 2a 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 * to indicate th
2a3a0 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 66 at the page is f
2a3b0 72 65 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 ree.. */. if(
2a3c0 49 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a ISAUTOVACUUM ){.
2a3d0 20 20 20 20 70 74 72 6d 61 70 50 75 74 28 70 42 ptrmapPut(pB
2a3e0 74 2c 20 69 50 61 67 65 2c 20 50 54 52 4d 41 50 t, iPage, PTRMAP
2a3f0 5f 46 52 45 45 50 41 47 45 2c 20 30 2c 20 26 72 _FREEPAGE, 0, &r
2a400 63 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 c);. if( rc )
2a410 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f goto freepage_o
2a420 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f ut;. }.. /* No
2a430 77 20 6d 61 6e 69 70 75 6c 61 74 65 20 74 68 65 w manipulate the
2a440 20 61 63 74 75 61 6c 20 64 61 74 61 62 61 73 65 actual database
2a450 20 66 72 65 65 2d 6c 69 73 74 20 73 74 72 75 63 free-list struc
2a460 74 75 72 65 2e 20 54 68 65 72 65 20 61 72 65 20 ture. There are
2a470 74 77 6f 0a 20 20 2a 2a 20 70 6f 73 73 69 62 69 two. ** possibi
2a480 6c 69 74 69 65 73 2e 20 49 66 20 74 68 65 20 66 lities. If the f
2a490 72 65 65 2d 6c 69 73 74 20 69 73 20 63 75 72 72 ree-list is curr
2a4a0 65 6e 74 6c 79 20 65 6d 70 74 79 2c 20 6f 72 20 ently empty, or
2a4b0 69 66 20 74 68 65 20 66 69 72 73 74 0a 20 20 2a if the first. *
2a4c0 2a 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 * trunk page in
2a4d0 74 68 65 20 66 72 65 65 2d 6c 69 73 74 20 69 73 the free-list is
2a4e0 20 66 75 6c 6c 2c 20 74 68 65 6e 20 74 68 69 73 full, then this
2a4f0 20 70 61 67 65 20 77 69 6c 6c 20 62 65 63 6f 6d page will becom
2a500 65 20 61 0a 20 20 2a 2a 20 6e 65 77 20 66 72 65 e a. ** new fre
2a510 65 2d 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 e-list trunk pag
2a520 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 e. Otherwise, it
2a530 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 61 20 6c will become a l
2a540 65 61 66 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 eaf of the. **
2a550 66 69 72 73 74 20 74 72 75 6e 6b 20 70 61 67 65 first trunk page
2a560 20 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 in the current
2a570 66 72 65 65 2d 6c 69 73 74 2e 20 54 68 69 73 20 free-list. This
2a580 62 6c 6f 63 6b 20 74 65 73 74 73 20 69 66 20 69 block tests if i
2a590 74 0a 20 20 2a 2a 20 69 73 20 70 6f 73 73 69 62 t. ** is possib
2a5a0 6c 65 20 74 6f 20 61 64 64 20 74 68 65 20 70 61 le to add the pa
2a5b0 67 65 20 61 73 20 61 20 6e 65 77 20 66 72 65 65 ge as a new free
2a5c0 2d 6c 69 73 74 20 6c 65 61 66 2e 0a 20 20 2a 2f -list leaf.. */
2a5d0 0a 20 20 69 66 28 20 6e 46 72 65 65 21 3d 30 20 . if( nFree!=0
2a5e0 29 7b 0a 20 20 20 20 75 33 32 20 6e 4c 65 61 66 ){. u32 nLeaf
2a5f0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2a600 20 2f 2a 20 49 6e 69 74 69 61 6c 20 6e 75 6d 62 /* Initial numb
2a610 65 72 20 6f 66 20 6c 65 61 66 20 63 65 6c 6c 73 er of leaf cells
2a620 20 6f 6e 20 74 72 75 6e 6b 20 70 61 67 65 20 2a on trunk page *
2a630 2f 0a 0a 20 20 20 20 69 54 72 75 6e 6b 20 3d 20 /.. iTrunk =
2a640 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 31 get4byte(&pPage1
2a650 2d 3e 61 44 61 74 61 5b 33 32 5d 29 3b 0a 20 20 ->aData[32]);.
2a660 20 20 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 rc = btreeGetP
2a670 61 67 65 28 70 42 74 2c 20 69 54 72 75 6e 6b 2c age(pBt, iTrunk,
2a680 20 26 70 54 72 75 6e 6b 2c 20 30 29 3b 0a 20 20 &pTrunk, 0);.
2a690 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
2a6a0 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 _OK ){. got
2a6b0 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a o freepage_out;.
2a6c0 20 20 20 20 7d 0a 0a 20 20 20 20 6e 4c 65 61 66 }.. nLeaf
2a6d0 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 54 72 = get4byte(&pTr
2a6e0 75 6e 6b 2d 3e 61 44 61 74 61 5b 34 5d 29 3b 0a unk->aData[4]);.
2a6f0 20 20 20 20 61 73 73 65 72 74 28 20 70 42 74 2d assert( pBt-
2a700 3e 75 73 61 62 6c 65 53 69 7a 65 3e 33 32 20 29 >usableSize>32 )
2a710 3b 0a 20 20 20 20 69 66 28 20 6e 4c 65 61 66 20 ;. if( nLeaf
2a720 3e 20 28 75 33 32 29 70 42 74 2d 3e 75 73 61 62 > (u32)pBt->usab
2a730 6c 65 53 69 7a 65 2f 34 20 2d 20 32 20 29 7b 0a leSize/4 - 2 ){.
2a740 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
2a750 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a E_CORRUPT_BKPT;.
2a760 20 20 20 20 20 20 67 6f 74 6f 20 66 72 65 65 70 goto freep
2a770 61 67 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 age_out;. }.
2a780 20 20 20 69 66 28 20 6e 4c 65 61 66 20 3c 20 28 if( nLeaf < (
2a790 75 33 32 29 70 42 74 2d 3e 75 73 61 62 6c 65 53 u32)pBt->usableS
2a7a0 69 7a 65 2f 34 20 2d 20 38 20 29 7b 0a 20 20 20 ize/4 - 8 ){.
2a7b0 20 20 20 2f 2a 20 49 6e 20 74 68 69 73 20 63 61 /* In this ca
2a7c0 73 65 20 74 68 65 72 65 20 69 73 20 72 6f 6f 6d se there is room
2a7d0 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 20 70 61 on the trunk pa
2a7e0 67 65 20 74 6f 20 69 6e 73 65 72 74 20 74 68 65 ge to insert the
2a7f0 20 70 61 67 65 0a 20 20 20 20 20 20 2a 2a 20 62 page. ** b
2a800 65 69 6e 67 20 66 72 65 65 64 20 61 73 20 61 20 eing freed as a
2a810 6e 65 77 20 6c 65 61 66 2e 0a 20 20 20 20 20 20 new leaf..
2a820 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 **. ** Note
2a830 20 74 68 61 74 20 74 68 65 20 74 72 75 6e 6b 20 that the trunk
2a840 70 61 67 65 20 69 73 20 6e 6f 74 20 72 65 61 6c page is not real
2a850 6c 79 20 66 75 6c 6c 20 75 6e 74 69 6c 20 69 74 ly full until it
2a860 20 63 6f 6e 74 61 69 6e 73 0a 20 20 20 20 20 20 contains.
2a870 2a 2a 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 ** usableSize/4
2a880 2d 20 32 20 65 6e 74 72 69 65 73 2c 20 6e 6f 74 - 2 entries, not
2a890 20 75 73 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 usableSize/4 -
2a8a0 38 20 65 6e 74 72 69 65 73 20 61 73 20 77 65 20 8 entries as we
2a8b0 68 61 76 65 0a 20 20 20 20 20 20 2a 2a 20 63 6f have. ** co
2a8c0 64 65 64 2e 20 20 42 75 74 20 64 75 65 20 74 6f ded. But due to
2a8d0 20 61 20 63 6f 64 69 6e 67 20 65 72 72 6f 72 20 a coding error
2a8e0 69 6e 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 in versions of S
2a8f0 51 4c 69 74 65 20 70 72 69 6f 72 20 74 6f 0a 20 QLite prior to.
2a900 20 20 20 20 20 2a 2a 20 33 2e 36 2e 30 2c 20 64 ** 3.6.0, d
2a910 61 74 61 62 61 73 65 73 20 77 69 74 68 20 66 72 atabases with fr
2a920 65 65 6c 69 73 74 20 74 72 75 6e 6b 20 70 61 67 eelist trunk pag
2a930 65 73 20 68 6f 6c 64 69 6e 67 20 6d 6f 72 65 20 es holding more
2a940 74 68 61 6e 0a 20 20 20 20 20 20 2a 2a 20 75 73 than. ** us
2a950 61 62 6c 65 53 69 7a 65 2f 34 20 2d 20 38 20 65 ableSize/4 - 8 e
2a960 6e 74 72 69 65 73 20 77 69 6c 6c 20 62 65 20 72 ntries will be r
2a970 65 70 6f 72 74 65 64 20 61 73 20 63 6f 72 72 75 eported as corru
2a980 70 74 2e 20 20 49 6e 20 6f 72 64 65 72 0a 20 20 pt. In order.
2a990 20 20 20 20 2a 2a 20 74 6f 20 6d 61 69 6e 74 61 ** to mainta
2a9a0 69 6e 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d in backwards com
2a9b0 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 patibility with
2a9c0 6f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 20 6f older versions o
2a9d0 66 20 53 51 4c 69 74 65 2c 0a 20 20 20 20 20 20 f SQLite,.
2a9e0 2a 2a 20 77 65 20 77 69 6c 6c 20 63 6f 6e 74 69 ** we will conti
2a9f0 6e 75 65 20 74 6f 20 72 65 73 74 72 69 63 74 20 nue to restrict
2aa00 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6e the number of en
2aa10 74 72 69 65 73 20 74 6f 20 75 73 61 62 6c 65 53 tries to usableS
2aa20 69 7a 65 2f 34 20 2d 20 38 0a 20 20 20 20 20 20 ize/4 - 8.
2aa30 2a 2a 20 66 6f 72 20 6e 6f 77 2e 20 20 41 74 20 ** for now. At
2aa40 73 6f 6d 65 20 70 6f 69 6e 74 20 69 6e 20 74 68 some point in th
2aa50 65 20 66 75 74 75 72 65 20 28 6f 6e 63 65 20 65 e future (once e
2aa60 76 65 72 79 6f 6e 65 20 68 61 73 20 75 70 67 72 veryone has upgr
2aa70 61 64 65 64 0a 20 20 20 20 20 20 2a 2a 20 74 6f aded. ** to
2aa80 20 33 2e 36 2e 30 20 6f 72 20 6c 61 74 65 72 29 3.6.0 or later)
2aa90 20 77 65 20 73 68 6f 75 6c 64 20 63 6f 6e 73 69 we should consi
2aaa0 64 65 72 20 66 69 78 69 6e 67 20 74 68 65 20 63 der fixing the c
2aab0 6f 6e 64 69 74 69 6f 6e 61 6c 20 61 62 6f 76 65 onditional above
2aac0 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 72 65 61 . ** to rea
2aad0 64 20 22 75 73 61 62 6c 65 53 69 7a 65 2f 34 2d d "usableSize/4-
2aae0 32 22 20 69 6e 73 74 65 61 64 20 6f 66 20 22 75 2" instead of "u
2aaf0 73 61 62 6c 65 53 69 7a 65 2f 34 2d 38 22 2e 0a sableSize/4-8"..
2ab00 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 */. r
2ab10 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
2ab20 57 72 69 74 65 28 70 54 72 75 6e 6b 2d 3e 70 44 Write(pTrunk->pD
2ab30 62 50 61 67 65 29 3b 0a 20 20 20 20 20 20 69 66 bPage);. if
2ab40 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2ab50 29 7b 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 ){. put4b
2ab60 79 74 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 yte(&pTrunk->aDa
2ab70 74 61 5b 34 5d 2c 20 6e 4c 65 61 66 2b 31 29 3b ta[4], nLeaf+1);
2ab80 0a 20 20 20 20 20 20 20 20 70 75 74 34 62 79 74 . put4byt
2ab90 65 28 26 70 54 72 75 6e 6b 2d 3e 61 44 61 74 61 e(&pTrunk->aData
2aba0 5b 38 2b 6e 4c 65 61 66 2a 34 5d 2c 20 69 50 61 [8+nLeaf*4], iPa
2abb0 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ge);. if(
2abc0 20 70 50 61 67 65 20 26 26 20 28 70 42 74 2d 3e pPage && (pBt->
2abd0 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 5f 53 btsFlags & BTS_S
2abe0 45 43 55 52 45 5f 44 45 4c 45 54 45 29 3d 3d 30 ECURE_DELETE)==0
2abf0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
2ac00 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 lite3PagerDontWr
2ac10 69 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 ite(pPage->pDbPa
2ac20 67 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ge);. }.
2ac30 20 20 20 20 20 20 20 72 63 20 3d 20 62 74 72 65 rc = btre
2ac40 65 53 65 74 48 61 73 43 6f 6e 74 65 6e 74 28 70 eSetHasContent(p
2ac50 42 74 2c 20 69 50 61 67 65 29 3b 0a 20 20 20 20 Bt, iPage);.
2ac60 20 20 7d 0a 20 20 20 20 20 20 54 52 41 43 45 28 }. TRACE(
2ac70 28 22 46 52 45 45 2d 50 41 47 45 3a 20 25 64 20 ("FREE-PAGE: %d
2ac80 6c 65 61 66 20 6f 6e 20 74 72 75 6e 6b 20 70 61 leaf on trunk pa
2ac90 67 65 20 25 64 5c 6e 22 2c 70 50 61 67 65 2d 3e ge %d\n",pPage->
2aca0 70 67 6e 6f 2c 70 54 72 75 6e 6b 2d 3e 70 67 6e pgno,pTrunk->pgn
2acb0 6f 29 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 o));. goto
2acc0 66 72 65 65 70 61 67 65 5f 6f 75 74 3b 0a 20 20 freepage_out;.
2acd0 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 }. }.. /* If
2ace0 20 63 6f 6e 74 72 6f 6c 20 66 6c 6f 77 73 20 74 control flows t
2acf0 6f 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 74 68 o this point, th
2ad00 65 6e 20 69 74 20 77 61 73 20 6e 6f 74 20 70 6f en it was not po
2ad10 73 73 69 62 6c 65 20 74 6f 20 61 64 64 20 74 68 ssible to add th
2ad20 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 67 65 20 e. ** the page
2ad30 62 65 69 6e 67 20 66 72 65 65 64 20 61 73 20 61 being freed as a
2ad40 20 6c 65 61 66 20 70 61 67 65 20 6f 66 20 74 68 leaf page of th
2ad50 65 20 66 69 72 73 74 20 74 72 75 6e 6b 20 69 6e e first trunk in
2ad60 20 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a the free-list..
2ad70 20 20 2a 2a 20 50 6f 73 73 69 62 6c 79 20 62 65 ** Possibly be
2ad80 63 61 75 73 65 20 74 68 65 20 66 72 65 65 2d 6c cause the free-l
2ad90 69 73 74 20 69 73 20 65 6d 70 74 79 2c 20 6f 72 ist is empty, or
2ada0 20 70 6f 73 73 69 62 6c 79 20 62 65 63 61 75 73 possibly becaus
2adb0 65 20 74 68 65 20 0a 20 20 2a 2a 20 66 69 72 73 e the . ** firs
2adc0 74 20 74 72 75 6e 6b 20 69 6e 20 74 68 65 20 66 t trunk in the f
2add0 72 65 65 2d 6c 69 73 74 20 69 73 20 66 75 6c 6c ree-list is full
2ade0 2e 20 45 69 74 68 65 72 20 77 61 79 2c 20 74 68 . Either way, th
2adf0 65 20 70 61 67 65 20 62 65 69 6e 67 20 66 72 65 e page being fre
2ae00 65 64 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 63 ed. ** will bec
2ae10 6f 6d 65 20 74 68 65 20 6e 65 77 20 66 69 72 73 ome the new firs
2ae20 74 20 74 72 75 6e 6b 20 70 61 67 65 20 69 6e 20 t trunk page in
2ae30 74 68 65 20 66 72 65 65 2d 6c 69 73 74 2e 0a 20 the free-list..
2ae40 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 3d */. if( pPage=
2ae50 3d 30 20 26 26 20 53 51 4c 49 54 45 5f 4f 4b 21 =0 && SQLITE_OK!
2ae60 3d 28 72 63 20 3d 20 62 74 72 65 65 47 65 74 50 =(rc = btreeGetP
2ae70 61 67 65 28 70 42 74 2c 20 69 50 61 67 65 2c 20 age(pBt, iPage,
2ae80 26 70 50 61 67 65 2c 20 30 29 29 20 29 7b 0a 20 &pPage, 0)) ){.
2ae90 20 20 20 67 6f 74 6f 20 66 72 65 65 70 61 67 65 goto freepage
2aea0 5f 6f 75 74 3b 0a 20 20 7d 0a 20 20 72 63 20 3d _out;. }. rc =
2aeb0 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 sqlite3PagerWri
2aec0 74 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 te(pPage->pDbPag
2aed0 65 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 e);. if( rc!=SQ
2aee0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 67 LITE_OK ){. g
2aef0 6f 74 6f 20 66 72 65 65 70 61 67 65 5f 6f 75 74 oto freepage_out
2af00 3b 0a 20 20 7d 0a 20 20 70 75 74 34 62 79 74 65 ;. }. put4byte
2af10 28 70 50 61 67 65 2d 3e 61 44 61 74 61 2c 20 69 (pPage->aData, i
2af20 54 72 75 6e 6b 29 3b 0a 20 20 70 75 74 34 62 79 Trunk);. put4by
2af30 74 65 28 26 70 50 61 67 65 2d 3e 61 44 61 74 61 te(&pPage->aData
2af40 5b 34 5d 2c 20 30 29 3b 0a 20 20 70 75 74 34 62 [4], 0);. put4b
2af50 79 74 65 28 26 70 50 61 67 65 31 2d 3e 61 44 61 yte(&pPage1->aDa
2af60 74 61 5b 33 32 5d 2c 20 69 50 61 67 65 29 3b 0a ta[32], iPage);.
2af70 20 20 54 52 41 43 45 28 28 22 46 52 45 45 2d 50 TRACE(("FREE-P
2af80 41 47 45 3a 20 25 64 20 6e 65 77 20 74 72 75 6e AGE: %d new trun
2af90 6b 20 70 61 67 65 20 72 65 70 6c 61 63 69 6e 67 k page replacing
2afa0 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 2d 3e 70 %d\n", pPage->p
2afb0 67 6e 6f 2c 20 69 54 72 75 6e 6b 29 29 3b 0a 0a gno, iTrunk));..
2afc0 66 72 65 65 70 61 67 65 5f 6f 75 74 3a 0a 20 20 freepage_out:.
2afd0 69 66 28 20 70 50 61 67 65 20 29 7b 0a 20 20 20 if( pPage ){.
2afe0 20 70 50 61 67 65 2d 3e 69 73 49 6e 69 74 20 3d pPage->isInit =
2aff0 20 30 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 0;. }. releas
2b000 65 50 61 67 65 28 70 50 61 67 65 29 3b 0a 20 20 ePage(pPage);.
2b010 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 72 75 releasePage(pTru
2b020 6e 6b 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 nk);. return rc
2b030 3b 0a 7d 0a 73 74 61 74 69 63 20 76 6f 69 64 20 ;.}.static void
2b040 66 72 65 65 50 61 67 65 28 4d 65 6d 50 61 67 65 freePage(MemPage
2b050 20 2a 70 50 61 67 65 2c 20 69 6e 74 20 2a 70 52 *pPage, int *pR
2b060 43 29 7b 0a 20 20 69 66 28 20 28 2a 70 52 43 29 C){. if( (*pRC)
2b070 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
2b080 20 20 20 2a 70 52 43 20 3d 20 66 72 65 65 50 61 *pRC = freePa
2b090 67 65 32 28 70 50 61 67 65 2d 3e 70 42 74 2c 20 ge2(pPage->pBt,
2b0a0 70 50 61 67 65 2c 20 70 50 61 67 65 2d 3e 70 67 pPage, pPage->pg
2b0b0 6e 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a no);. }.}../*.*
2b0c0 2a 20 46 72 65 65 20 61 6e 79 20 6f 76 65 72 66 * Free any overf
2b0d0 6c 6f 77 20 70 61 67 65 73 20 61 73 73 6f 63 69 low pages associ
2b0e0 61 74 65 64 20 77 69 74 68 20 74 68 65 20 67 69 ated with the gi
2b0f0 76 65 6e 20 43 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 ven Cell..*/.sta
2b100 74 69 63 20 69 6e 74 20 63 6c 65 61 72 43 65 6c tic int clearCel
2b110 6c 28 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 l(MemPage *pPage
2b120 2c 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 , unsigned char
2b130 2a 70 43 65 6c 6c 29 7b 0a 20 20 42 74 53 68 61 *pCell){. BtSha
2b140 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 67 65 red *pBt = pPage
2b150 2d 3e 70 42 74 3b 0a 20 20 43 65 6c 6c 49 6e 66 ->pBt;. CellInf
2b160 6f 20 69 6e 66 6f 3b 0a 20 20 50 67 6e 6f 20 6f o info;. Pgno o
2b170 76 66 6c 50 67 6e 6f 3b 0a 20 20 69 6e 74 20 72 vflPgno;. int r
2b180 63 3b 0a 20 20 69 6e 74 20 6e 4f 76 66 6c 3b 0a c;. int nOvfl;.
2b190 20 20 75 33 32 20 6f 76 66 6c 50 61 67 65 53 69 u32 ovflPageSi
2b1a0 7a 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 ze;.. assert( s
2b1b0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2b1c0 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
2b1d0 74 65 78 29 20 29 3b 0a 20 20 62 74 72 65 65 50 tex) );. btreeP
2b1e0 61 72 73 65 43 65 6c 6c 50 74 72 28 70 50 61 67 arseCellPtr(pPag
2b1f0 65 2c 20 70 43 65 6c 6c 2c 20 26 69 6e 66 6f 29 e, pCell, &info)
2b200 3b 0a 20 20 69 66 28 20 69 6e 66 6f 2e 69 4f 76 ;. if( info.iOv
2b210 65 72 66 6c 6f 77 3d 3d 30 20 29 7b 0a 20 20 20 erflow==0 ){.
2b220 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
2b230 4b 3b 20 20 2f 2a 20 4e 6f 20 6f 76 65 72 66 6c K; /* No overfl
2b240 6f 77 20 70 61 67 65 73 2e 20 52 65 74 75 72 6e ow pages. Return
2b250 20 77 69 74 68 6f 75 74 20 64 6f 69 6e 67 20 61 without doing a
2b260 6e 79 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 0a 20 nything */. }.
2b270 20 69 66 28 20 70 43 65 6c 6c 2b 69 6e 66 6f 2e if( pCell+info.
2b280 69 4f 76 65 72 66 6c 6f 77 2b 33 20 3e 20 70 50 iOverflow+3 > pP
2b290 61 67 65 2d 3e 61 44 61 74 61 2b 70 50 61 67 65 age->aData+pPage
2b2a0 2d 3e 6d 61 73 6b 50 61 67 65 20 29 7b 0a 20 20 ->maskPage ){.
2b2b0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2b2c0 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 20 20 2f CORRUPT_BKPT; /
2b2d0 2a 20 43 65 6c 6c 20 65 78 74 65 6e 64 73 20 70 * Cell extends p
2b2e0 61 73 74 20 65 6e 64 20 6f 66 20 70 61 67 65 20 ast end of page
2b2f0 2a 2f 0a 20 20 7d 0a 20 20 6f 76 66 6c 50 67 6e */. }. ovflPgn
2b300 6f 20 3d 20 67 65 74 34 62 79 74 65 28 26 70 43 o = get4byte(&pC
2b310 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 6c ell[info.iOverfl
2b320 6f 77 5d 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ow]);. assert(
2b330 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
2b340 3e 20 34 20 29 3b 0a 20 20 6f 76 66 6c 50 61 67 > 4 );. ovflPag
2b350 65 53 69 7a 65 20 3d 20 70 42 74 2d 3e 75 73 61 eSize = pBt->usa
2b360 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a 20 20 6e bleSize - 4;. n
2b370 4f 76 66 6c 20 3d 20 28 69 6e 66 6f 2e 6e 50 61 Ovfl = (info.nPa
2b380 79 6c 6f 61 64 20 2d 20 69 6e 66 6f 2e 6e 4c 6f yload - info.nLo
2b390 63 61 6c 20 2b 20 6f 76 66 6c 50 61 67 65 53 69 cal + ovflPageSi
2b3a0 7a 65 20 2d 20 31 29 2f 6f 76 66 6c 50 61 67 65 ze - 1)/ovflPage
2b3b0 53 69 7a 65 3b 0a 20 20 61 73 73 65 72 74 28 20 Size;. assert(
2b3c0 6f 76 66 6c 50 67 6e 6f 3d 3d 30 20 7c 7c 20 6e ovflPgno==0 || n
2b3d0 4f 76 66 6c 3e 30 20 29 3b 0a 20 20 77 68 69 6c Ovfl>0 );. whil
2b3e0 65 28 20 6e 4f 76 66 6c 2d 2d 20 29 7b 0a 20 20 e( nOvfl-- ){.
2b3f0 20 20 50 67 6e 6f 20 69 4e 65 78 74 20 3d 20 30 Pgno iNext = 0
2b400 3b 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 ;. MemPage *p
2b410 4f 76 66 6c 20 3d 20 30 3b 0a 20 20 20 20 69 66 Ovfl = 0;. if
2b420 28 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 7c 7c 20 ( ovflPgno<2 ||
2b430 6f 76 66 6c 50 67 6e 6f 3e 62 74 72 65 65 50 61 ovflPgno>btreePa
2b440 67 65 63 6f 75 6e 74 28 70 42 74 29 20 29 7b 0a gecount(pBt) ){.
2b450 20 20 20 20 20 20 2f 2a 20 30 20 69 73 20 6e 6f /* 0 is no
2b460 74 20 61 20 6c 65 67 61 6c 20 70 61 67 65 20 6e t a legal page n
2b470 75 6d 62 65 72 20 61 6e 64 20 70 61 67 65 20 31 umber and page 1
2b480 20 63 61 6e 6e 6f 74 20 62 65 20 61 6e 20 0a 20 cannot be an .
2b490 20 20 20 20 20 2a 2a 20 6f 76 65 72 66 6c 6f 77 ** overflow
2b4a0 20 70 61 67 65 2e 20 54 68 65 72 65 66 6f 72 65 page. Therefore
2b4b0 20 69 66 20 6f 76 66 6c 50 67 6e 6f 3c 32 20 6f if ovflPgno<2 o
2b4c0 72 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f r past the end o
2b4d0 66 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 f the . **
2b4e0 66 69 6c 65 20 74 68 65 20 64 61 74 61 62 61 73 file the databas
2b4f0 65 20 6d 75 73 74 20 62 65 20 63 6f 72 72 75 70 e must be corrup
2b500 74 2e 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 t. */. retu
2b510 72 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 rn SQLITE_CORRUP
2b520 54 5f 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 T_BKPT;. }.
2b530 20 20 69 66 28 20 6e 4f 76 66 6c 20 29 7b 0a 20 if( nOvfl ){.
2b540 20 20 20 20 20 72 63 20 3d 20 67 65 74 4f 76 65 rc = getOve
2b550 72 66 6c 6f 77 50 61 67 65 28 70 42 74 2c 20 6f rflowPage(pBt, o
2b560 76 66 6c 50 67 6e 6f 2c 20 26 70 4f 76 66 6c 2c vflPgno, &pOvfl,
2b570 20 26 69 4e 65 78 74 29 3b 0a 20 20 20 20 20 20 &iNext);.
2b580 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
2b590 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 rc;. }.. i
2b5a0 66 28 20 28 20 70 4f 76 66 6c 20 7c 7c 20 28 28 f( ( pOvfl || ((
2b5b0 70 4f 76 66 6c 20 3d 20 62 74 72 65 65 50 61 67 pOvfl = btreePag
2b5c0 65 4c 6f 6f 6b 75 70 28 70 42 74 2c 20 6f 76 66 eLookup(pBt, ovf
2b5d0 6c 50 67 6e 6f 29 29 21 3d 30 29 20 29 0a 20 20 lPgno))!=0) ).
2b5e0 20 20 20 26 26 20 73 71 6c 69 74 65 33 50 61 67 && sqlite3Pag
2b5f0 65 72 50 61 67 65 52 65 66 63 6f 75 6e 74 28 70 erPageRefcount(p
2b600 4f 76 66 6c 2d 3e 70 44 62 50 61 67 65 29 21 3d Ovfl->pDbPage)!=
2b610 31 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 2f 1. ){. /
2b620 2a 20 54 68 65 72 65 20 69 73 20 6e 6f 20 72 65 * There is no re
2b630 61 73 6f 6e 20 61 6e 79 20 63 75 72 73 6f 72 20 ason any cursor
2b640 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6e 20 6f should have an o
2b650 75 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 utstanding refer
2b660 65 6e 63 65 20 0a 20 20 20 20 20 20 2a 2a 20 74 ence . ** t
2b670 6f 20 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 o an overflow pa
2b680 67 65 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 ge belonging to
2b690 61 20 63 65 6c 6c 20 74 68 61 74 20 69 73 20 62 a cell that is b
2b6a0 65 69 6e 67 20 64 65 6c 65 74 65 64 2f 75 70 64 eing deleted/upd
2b6b0 61 74 65 64 2e 0a 20 20 20 20 20 20 2a 2a 20 53 ated.. ** S
2b6c0 6f 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 o if there exist
2b6d0 73 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 s more than one
2b6e0 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 69 reference to thi
2b6f0 73 20 70 61 67 65 2c 20 74 68 65 6e 20 69 74 20 s page, then it
2b700 0a 20 20 20 20 20 20 2a 2a 20 6d 75 73 74 20 6e . ** must n
2b710 6f 74 20 72 65 61 6c 6c 79 20 62 65 20 61 6e 20 ot really be an
2b720 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 61 6e overflow page an
2b730 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d d the database m
2b740 75 73 74 20 62 65 20 63 6f 72 72 75 70 74 2e 20 ust be corrupt.
2b750 0a 20 20 20 20 20 20 2a 2a 20 49 74 20 69 73 20 . ** It is
2b760 68 65 6c 70 66 75 6c 20 74 6f 20 64 65 74 65 63 helpful to detec
2b770 74 20 74 68 69 73 20 62 65 66 6f 72 65 20 63 61 t this before ca
2b780 6c 6c 69 6e 67 20 66 72 65 65 50 61 67 65 32 28 lling freePage2(
2b790 29 2c 20 61 73 20 0a 20 20 20 20 20 20 2a 2a 20 ), as . **
2b7a0 66 72 65 65 50 61 67 65 32 28 29 20 6d 61 79 20 freePage2() may
2b7b0 7a 65 72 6f 20 74 68 65 20 70 61 67 65 20 63 6f zero the page co
2b7c0 6e 74 65 6e 74 73 20 69 66 20 73 65 63 75 72 65 ntents if secure
2b7d0 2d 64 65 6c 65 74 65 20 6d 6f 64 65 20 69 73 0a -delete mode is.
2b7e0 20 20 20 20 20 20 2a 2a 20 65 6e 61 62 6c 65 64 ** enabled
2b7f0 2e 20 49 66 20 74 68 69 73 20 27 6f 76 65 72 66 . If this 'overf
2b800 6c 6f 77 27 20 70 61 67 65 20 68 61 70 70 65 6e low' page happen
2b810 73 20 74 6f 20 62 65 20 61 20 70 61 67 65 20 74 s to be a page t
2b820 68 61 74 20 74 68 65 0a 20 20 20 20 20 20 2a 2a hat the. **
2b830 20 63 61 6c 6c 65 72 20 69 73 20 69 74 65 72 61 caller is itera
2b840 74 69 6e 67 20 74 68 72 6f 75 67 68 20 6f 72 20 ting through or
2b850 75 73 69 6e 67 20 69 6e 20 73 6f 6d 65 20 6f 74 using in some ot
2b860 68 65 72 20 77 61 79 2c 20 74 68 69 73 0a 20 20 her way, this.
2b870 20 20 20 20 2a 2a 20 63 61 6e 20 62 65 20 70 72 ** can be pr
2b880 6f 62 6c 65 6d 61 74 69 63 2e 0a 20 20 20 20 20 oblematic..
2b890 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 53 */. rc = S
2b8a0 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
2b8b0 50 54 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 PT;. }else{.
2b8c0 20 20 20 20 20 72 63 20 3d 20 66 72 65 65 50 61 rc = freePa
2b8d0 67 65 32 28 70 42 74 2c 20 70 4f 76 66 6c 2c 20 ge2(pBt, pOvfl,
2b8e0 6f 76 66 6c 50 67 6e 6f 29 3b 0a 20 20 20 20 7d ovflPgno);. }
2b8f0 0a 0a 20 20 20 20 69 66 28 20 70 4f 76 66 6c 20 .. if( pOvfl
2b900 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
2b910 50 61 67 65 72 55 6e 72 65 66 28 70 4f 76 66 6c PagerUnref(pOvfl
2b920 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2b930 7d 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 }. if( rc ) r
2b940 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 6f 76 eturn rc;. ov
2b950 66 6c 50 67 6e 6f 20 3d 20 69 4e 65 78 74 3b 0a flPgno = iNext;.
2b960 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c }. return SQL
2b970 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
2b980 20 43 72 65 61 74 65 20 74 68 65 20 62 79 74 65 Create the byte
2b990 20 73 65 71 75 65 6e 63 65 20 75 73 65 64 20 74 sequence used t
2b9a0 6f 20 72 65 70 72 65 73 65 6e 74 20 61 20 63 65 o represent a ce
2b9b0 6c 6c 20 6f 6e 20 70 61 67 65 20 70 50 61 67 65 ll on page pPage
2b9c0 0a 2a 2a 20 61 6e 64 20 77 72 69 74 65 20 74 68 .** and write th
2b9d0 61 74 20 62 79 74 65 20 73 65 71 75 65 6e 63 65 at byte sequence
2b9e0 20 69 6e 74 6f 20 70 43 65 6c 6c 5b 5d 2e 20 20 into pCell[].
2b9f0 4f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 20 61 Overflow pages a
2ba00 72 65 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 re.** allocated
2ba10 61 6e 64 20 66 69 6c 6c 65 64 20 69 6e 20 61 73 and filled in as
2ba20 20 6e 65 63 65 73 73 61 72 79 2e 20 20 54 68 65 necessary. The
2ba30 20 63 61 6c 6c 69 6e 67 20 70 72 6f 63 65 64 75 calling procedu
2ba40 72 65 0a 2a 2a 20 69 73 20 72 65 73 70 6f 6e 73 re.** is respons
2ba50 69 62 6c 65 20 66 6f 72 20 6d 61 6b 69 6e 67 20 ible for making
2ba60 73 75 72 65 20 73 75 66 66 69 63 69 65 6e 74 20 sure sufficient
2ba70 73 70 61 63 65 20 68 61 73 20 62 65 65 6e 20 61 space has been a
2ba80 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 66 6f 72 20 llocated.** for
2ba90 70 43 65 6c 6c 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 4e pCell[]..**.** N
2baa0 6f 74 65 20 74 68 61 74 20 70 43 65 6c 6c 20 64 ote that pCell d
2bab0 6f 65 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 oes not necessar
2bac0 79 20 6e 65 65 64 20 74 6f 20 70 6f 69 6e 74 20 y need to point
2bad0 74 6f 20 74 68 65 20 70 50 61 67 65 2d 3e 61 44 to the pPage->aD
2bae0 61 74 61 0a 2a 2a 20 61 72 65 61 2e 20 20 70 43 ata.** area. pC
2baf0 65 6c 6c 20 6d 69 67 68 74 20 70 6f 69 6e 74 20 ell might point
2bb00 74 6f 20 73 6f 6d 65 20 74 65 6d 70 6f 72 61 72 to some temporar
2bb10 79 20 73 74 6f 72 61 67 65 2e 20 20 54 68 65 20 y storage. The
2bb20 63 65 6c 6c 20 77 69 6c 6c 0a 2a 2a 20 62 65 20 cell will.** be
2bb30 63 6f 6e 73 74 72 75 63 74 65 64 20 69 6e 20 74 constructed in t
2bb40 68 69 73 20 74 65 6d 70 6f 72 61 72 79 20 61 72 his temporary ar
2bb50 65 61 20 74 68 65 6e 20 63 6f 70 69 65 64 20 69 ea then copied i
2bb60 6e 74 6f 20 70 50 61 67 65 2d 3e 61 44 61 74 61 nto pPage->aData
2bb70 0a 2a 2a 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 .** later..*/.st
2bb80 61 74 69 63 20 69 6e 74 20 66 69 6c 6c 49 6e 43 atic int fillInC
2bb90 65 6c 6c 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a ell(. MemPage *
2bba0 70 50 61 67 65 2c 20 20 20 20 20 20 20 20 20 20 pPage,
2bbb0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 /* The pag
2bbc0 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 e that contains
2bbd0 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 75 6e the cell */. un
2bbe0 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 43 65 signed char *pCe
2bbf0 6c 6c 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ll, /*
2bc00 43 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 Complete text of
2bc10 20 74 68 65 20 63 65 6c 6c 20 2a 2f 0a 20 20 63 the cell */. c
2bc20 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79 2c onst void *pKey,
2bc30 20 69 36 34 20 6e 4b 65 79 2c 20 20 20 20 2f 2a i64 nKey, /*
2bc40 20 54 68 65 20 6b 65 79 20 2a 2f 0a 20 20 63 6f The key */. co
2bc50 6e 73 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c nst void *pData,
2bc60 69 6e 74 20 6e 44 61 74 61 2c 20 20 20 2f 2a 20 int nData, /*
2bc70 54 68 65 20 64 61 74 61 20 2a 2f 0a 20 20 69 6e The data */. in
2bc80 74 20 6e 5a 65 72 6f 2c 20 20 20 20 20 20 20 20 t nZero,
2bc90 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2bca0 45 78 74 72 61 20 7a 65 72 6f 20 62 79 74 65 73 Extra zero bytes
2bcb0 20 74 6f 20 61 70 70 65 6e 64 20 74 6f 20 70 44 to append to pD
2bcc0 61 74 61 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e ata */. int *pn
2bcd0 53 69 7a 65 20 20 20 20 20 20 20 20 20 20 20 20 Size
2bce0 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 /* Write
2bcf0 20 63 65 6c 6c 20 73 69 7a 65 20 68 65 72 65 20 cell size here
2bd00 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 50 61 79 */.){. int nPay
2bd10 6c 6f 61 64 3b 0a 20 20 63 6f 6e 73 74 20 75 38 load;. const u8
2bd20 20 2a 70 53 72 63 3b 0a 20 20 69 6e 74 20 6e 53 *pSrc;. int nS
2bd30 72 63 2c 20 6e 2c 20 72 63 3b 0a 20 20 69 6e 74 rc, n, rc;. int
2bd40 20 73 70 61 63 65 4c 65 66 74 3b 0a 20 20 4d 65 spaceLeft;. Me
2bd50 6d 50 61 67 65 20 2a 70 4f 76 66 6c 20 3d 20 30 mPage *pOvfl = 0
2bd60 3b 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 6f ;. MemPage *pTo
2bd70 52 65 6c 65 61 73 65 20 3d 20 30 3b 0a 20 20 75 Release = 0;. u
2bd80 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 70 50 nsigned char *pP
2bd90 72 69 6f 72 3b 0a 20 20 75 6e 73 69 67 6e 65 64 rior;. unsigned
2bda0 20 63 68 61 72 20 2a 70 50 61 79 6c 6f 61 64 3b char *pPayload;
2bdb0 0a 20 20 42 74 53 68 61 72 65 64 20 2a 70 42 74 . BtShared *pBt
2bdc0 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 3b 0a 20 = pPage->pBt;.
2bdd0 20 50 67 6e 6f 20 70 67 6e 6f 4f 76 66 6c 20 3d Pgno pgnoOvfl =
2bde0 20 30 3b 0a 20 20 69 6e 74 20 6e 48 65 61 64 65 0;. int nHeade
2bdf0 72 3b 0a 20 20 43 65 6c 6c 49 6e 66 6f 20 69 6e r;. CellInfo in
2be00 66 6f 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 fo;.. assert( s
2be10 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2be20 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
2be30 74 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 70 50 tex) );.. /* pP
2be40 61 67 65 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 age is not neces
2be50 73 61 72 69 6c 79 20 77 72 69 74 65 61 62 6c 65 sarily writeable
2be60 20 73 69 6e 63 65 20 70 43 65 6c 6c 20 6d 69 67 since pCell mig
2be70 68 74 20 62 65 20 61 75 78 69 6c 69 61 72 79 0a ht be auxiliary.
2be80 20 20 2a 2a 20 62 75 66 66 65 72 20 73 70 61 63 ** buffer spac
2be90 65 20 74 68 61 74 20 69 73 20 73 65 70 61 72 61 e that is separa
2bea0 74 65 20 66 72 6f 6d 20 74 68 65 20 70 50 61 67 te from the pPag
2beb0 65 20 62 75 66 66 65 72 20 61 72 65 61 20 2a 2f e buffer area */
2bec0 0a 20 20 61 73 73 65 72 74 28 20 70 43 65 6c 6c . assert( pCell
2bed0 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 7c 7c <pPage->aData ||
2bee0 20 70 43 65 6c 6c 3e 3d 26 70 50 61 67 65 2d 3e pCell>=&pPage->
2bef0 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 67 65 53 aData[pBt->pageS
2bf00 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 20 20 20 ize].
2bf10 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 || sqlite3Pager
2bf20 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 67 Iswriteable(pPag
2bf30 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a e->pDbPage) );..
2bf40 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 65 /* Fill in the
2bf50 20 68 65 61 64 65 72 2e 20 2a 2f 0a 20 20 6e 48 header. */. nH
2bf60 65 61 64 65 72 20 3d 20 30 3b 0a 20 20 69 66 28 eader = 0;. if(
2bf70 20 21 70 50 61 67 65 2d 3e 6c 65 61 66 20 29 7b !pPage->leaf ){
2bf80 0a 20 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 . nHeader +=
2bf90 34 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 4;. }. if( pPa
2bfa0 67 65 2d 3e 68 61 73 44 61 74 61 20 29 7b 0a 20 ge->hasData ){.
2bfb0 20 20 20 6e 48 65 61 64 65 72 20 2b 3d 20 70 75 nHeader += pu
2bfc0 74 56 61 72 69 6e 74 28 26 70 43 65 6c 6c 5b 6e tVarint(&pCell[n
2bfd0 48 65 61 64 65 72 5d 2c 20 6e 44 61 74 61 2b 6e Header], nData+n
2bfe0 5a 65 72 6f 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a Zero);. }else{.
2bff0 20 20 20 20 6e 44 61 74 61 20 3d 20 6e 5a 65 72 nData = nZer
2c000 6f 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 6e 48 65 o = 0;. }. nHe
2c010 61 64 65 72 20 2b 3d 20 70 75 74 56 61 72 69 6e ader += putVarin
2c020 74 28 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 t(&pCell[nHeader
2c030 5d 2c 20 2a 28 75 36 34 2a 29 26 6e 4b 65 79 29 ], *(u64*)&nKey)
2c040 3b 0a 20 20 62 74 72 65 65 50 61 72 73 65 43 65 ;. btreeParseCe
2c050 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 llPtr(pPage, pCe
2c060 6c 6c 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 61 73 ll, &info);. as
2c070 73 65 72 74 28 20 69 6e 66 6f 2e 6e 48 65 61 64 sert( info.nHead
2c080 65 72 3d 3d 6e 48 65 61 64 65 72 20 29 3b 0a 20 er==nHeader );.
2c090 20 61 73 73 65 72 74 28 20 69 6e 66 6f 2e 6e 4b assert( info.nK
2c0a0 65 79 3d 3d 6e 4b 65 79 20 29 3b 0a 20 20 61 73 ey==nKey );. as
2c0b0 73 65 72 74 28 20 69 6e 66 6f 2e 6e 44 61 74 61 sert( info.nData
2c0c0 3d 3d 28 75 33 32 29 28 6e 44 61 74 61 2b 6e 5a ==(u32)(nData+nZ
2c0d0 65 72 6f 29 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 ero) );. . /*
2c0e0 46 69 6c 6c 20 69 6e 20 74 68 65 20 70 61 79 6c Fill in the payl
2c0f0 6f 61 64 20 2a 2f 0a 20 20 6e 50 61 79 6c 6f 61 oad */. nPayloa
2c100 64 20 3d 20 6e 44 61 74 61 20 2b 20 6e 5a 65 72 d = nData + nZer
2c110 6f 3b 0a 20 20 69 66 28 20 70 50 61 67 65 2d 3e o;. if( pPage->
2c120 69 6e 74 4b 65 79 20 29 7b 0a 20 20 20 20 70 53 intKey ){. pS
2c130 72 63 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 rc = pData;.
2c140 6e 53 72 63 20 3d 20 6e 44 61 74 61 3b 0a 20 20 nSrc = nData;.
2c150 20 20 6e 44 61 74 61 20 3d 20 30 3b 0a 20 20 7d nData = 0;. }
2c160 65 6c 73 65 7b 20 0a 20 20 20 20 69 66 28 20 4e else{ . if( N
2c170 45 56 45 52 28 6e 4b 65 79 3e 30 78 37 66 66 66 EVER(nKey>0x7fff
2c180 66 66 66 66 20 7c 7c 20 70 4b 65 79 3d 3d 30 29 ffff || pKey==0)
2c190 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
2c1a0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
2c1b0 42 4b 50 54 3b 0a 20 20 20 20 7d 0a 20 20 20 20 BKPT;. }.
2c1c0 6e 50 61 79 6c 6f 61 64 20 2b 3d 20 28 69 6e 74 nPayload += (int
2c1d0 29 6e 4b 65 79 3b 0a 20 20 20 20 70 53 72 63 20 )nKey;. pSrc
2c1e0 3d 20 70 4b 65 79 3b 0a 20 20 20 20 6e 53 72 63 = pKey;. nSrc
2c1f0 20 3d 20 28 69 6e 74 29 6e 4b 65 79 3b 0a 20 20 = (int)nKey;.
2c200 7d 0a 20 20 2a 70 6e 53 69 7a 65 20 3d 20 69 6e }. *pnSize = in
2c210 66 6f 2e 6e 53 69 7a 65 3b 0a 20 20 73 70 61 63 fo.nSize;. spac
2c220 65 4c 65 66 74 20 3d 20 69 6e 66 6f 2e 6e 4c 6f eLeft = info.nLo
2c230 63 61 6c 3b 0a 20 20 70 50 61 79 6c 6f 61 64 20 cal;. pPayload
2c240 3d 20 26 70 43 65 6c 6c 5b 6e 48 65 61 64 65 72 = &pCell[nHeader
2c250 5d 3b 0a 20 20 70 50 72 69 6f 72 20 3d 20 26 70 ];. pPrior = &p
2c260 43 65 6c 6c 5b 69 6e 66 6f 2e 69 4f 76 65 72 66 Cell[info.iOverf
2c270 6c 6f 77 5d 3b 0a 0a 20 20 77 68 69 6c 65 28 20 low];.. while(
2c280 6e 50 61 79 6c 6f 61 64 3e 30 20 29 7b 0a 20 20 nPayload>0 ){.
2c290 20 20 69 66 28 20 73 70 61 63 65 4c 65 66 74 3d if( spaceLeft=
2c2a0 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 =0 ){.#ifndef SQ
2c2b0 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 LITE_OMIT_AUTOVA
2c2c0 43 55 55 4d 0a 20 20 20 20 20 20 50 67 6e 6f 20 CUUM. Pgno
2c2d0 70 67 6e 6f 50 74 72 6d 61 70 20 3d 20 70 67 6e pgnoPtrmap = pgn
2c2e0 6f 4f 76 66 6c 3b 20 2f 2a 20 4f 76 65 72 66 6c oOvfl; /* Overfl
2c2f0 6f 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 2d ow page pointer-
2c300 6d 61 70 20 65 6e 74 72 79 20 70 61 67 65 20 2a map entry page *
2c310 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 2d /. if( pBt-
2c320 3e 61 75 74 6f 56 61 63 75 75 6d 20 29 7b 0a 20 >autoVacuum ){.
2c330 20 20 20 20 20 20 20 64 6f 7b 0a 20 20 20 20 20 do{.
2c340 20 20 20 20 20 70 67 6e 6f 4f 76 66 6c 2b 2b 3b pgnoOvfl++;
2c350 0a 20 20 20 20 20 20 20 20 7d 20 77 68 69 6c 65 . } while
2c360 28 20 0a 20 20 20 20 20 20 20 20 20 20 50 54 52 ( . PTR
2c370 4d 41 50 5f 49 53 50 41 47 45 28 70 42 74 2c 20 MAP_ISPAGE(pBt,
2c380 70 67 6e 6f 4f 76 66 6c 29 20 7c 7c 20 70 67 6e pgnoOvfl) || pgn
2c390 6f 4f 76 66 6c 3d 3d 50 45 4e 44 49 4e 47 5f 42 oOvfl==PENDING_B
2c3a0 59 54 45 5f 50 41 47 45 28 70 42 74 29 20 0a 20 YTE_PAGE(pBt) .
2c3b0 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 );.
2c3c0 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 }.#endif. r
2c3d0 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 72 65 c = allocateBtre
2c3e0 65 50 61 67 65 28 70 42 74 2c 20 26 70 4f 76 66 ePage(pBt, &pOvf
2c3f0 6c 2c 20 26 70 67 6e 6f 4f 76 66 6c 2c 20 70 67 l, &pgnoOvfl, pg
2c400 6e 6f 4f 76 66 6c 2c 20 30 29 3b 0a 23 69 66 6e noOvfl, 0);.#ifn
2c410 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2c420 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 AUTOVACUUM.
2c430 20 2f 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 /* If the datab
2c440 61 73 65 20 73 75 70 70 6f 72 74 73 20 61 75 74 ase supports aut
2c450 6f 2d 76 61 63 75 75 6d 2c 20 61 6e 64 20 74 68 o-vacuum, and th
2c460 65 20 73 65 63 6f 6e 64 20 6f 72 20 73 75 62 73 e second or subs
2c470 65 71 75 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 equent. **
2c480 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 73 overflow page is
2c490 20 62 65 69 6e 67 20 61 6c 6c 6f 63 61 74 65 64 being allocated
2c4a0 2c 20 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 , add an entry t
2c4b0 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 o the pointer-ma
2c4c0 70 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 74 p. ** for t
2c4d0 68 61 74 20 70 61 67 65 20 6e 6f 77 2e 20 0a 20 hat page now. .
2c4e0 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a **. **
2c4f0 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
2c500 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 20 70 first overflow p
2c510 61 67 65 2c 20 74 68 65 6e 20 77 72 69 74 65 20 age, then write
2c520 61 20 70 61 72 74 69 61 6c 20 65 6e 74 72 79 20 a partial entry
2c530 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 65 . ** to the
2c540 20 70 6f 69 6e 74 65 72 2d 6d 61 70 2e 20 49 66 pointer-map. If
2c550 20 77 65 20 77 72 69 74 65 20 6e 6f 74 68 69 6e we write nothin
2c560 67 20 74 6f 20 74 68 69 73 20 70 6f 69 6e 74 65 g to this pointe
2c570 72 2d 6d 61 70 20 73 6c 6f 74 2c 0a 20 20 20 20 r-map slot,.
2c580 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 6f 70 ** then the op
2c590 74 69 6d 69 73 74 69 63 20 6f 76 65 72 66 6c 6f timistic overflo
2c5a0 77 20 63 68 61 69 6e 20 70 72 6f 63 65 73 73 69 w chain processi
2c5b0 6e 67 20 69 6e 20 63 6c 65 61 72 43 65 6c 6c 28 ng in clearCell(
2c5c0 29 0a 20 20 20 20 20 20 2a 2a 20 6d 61 79 20 6d ). ** may m
2c5d0 69 73 69 6e 74 65 72 70 72 65 74 20 74 68 65 20 isinterpret the
2c5e0 75 6e 69 6e 69 74 69 61 6c 69 73 65 64 20 76 61 uninitialised va
2c5f0 6c 75 65 73 20 61 6e 64 20 64 65 6c 65 74 65 20 lues and delete
2c600 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 77 72 6f the. ** wro
2c610 6e 67 20 70 61 67 65 73 20 66 72 6f 6d 20 74 68 ng pages from th
2c620 65 20 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 e database..
2c630 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 */. if( p
2c640 42 74 2d 3e 61 75 74 6f 56 61 63 75 75 6d 20 26 Bt->autoVacuum &
2c650 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
2c660 29 7b 0a 20 20 20 20 20 20 20 20 75 38 20 65 54 ){. u8 eT
2c670 79 70 65 20 3d 20 28 70 67 6e 6f 50 74 72 6d 61 ype = (pgnoPtrma
2c680 70 3f 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c 4f p?PTRMAP_OVERFLO
2c690 57 32 3a 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c W2:PTRMAP_OVERFL
2c6a0 4f 57 31 29 3b 0a 20 20 20 20 20 20 20 20 70 74 OW1);. pt
2c6b0 72 6d 61 70 50 75 74 28 70 42 74 2c 20 70 67 6e rmapPut(pBt, pgn
2c6c0 6f 4f 76 66 6c 2c 20 65 54 79 70 65 2c 20 70 67 oOvfl, eType, pg
2c6d0 6e 6f 50 74 72 6d 61 70 2c 20 26 72 63 29 3b 0a noPtrmap, &rc);.
2c6e0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 29 if( rc )
2c6f0 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 6c 65 {. rele
2c700 61 73 65 50 61 67 65 28 70 4f 76 66 6c 29 3b 0a asePage(pOvfl);.
2c710 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2c720 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 69 }.#endif. i
2c730 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20 f( rc ){.
2c740 20 72 65 6c 65 61 73 65 50 61 67 65 28 70 54 6f releasePage(pTo
2c750 52 65 6c 65 61 73 65 29 3b 0a 20 20 20 20 20 20 Release);.
2c760 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
2c770 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 }.. /* I
2c780 66 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 f pToRelease is
2c790 6e 6f 74 20 7a 65 72 6f 20 74 68 61 6e 20 70 50 not zero than pP
2c7a0 72 69 6f 72 20 70 6f 69 6e 74 73 20 69 6e 74 6f rior points into
2c7b0 20 74 68 65 20 64 61 74 61 20 61 72 65 61 0a 20 the data area.
2c7c0 20 20 20 20 20 2a 2a 20 6f 66 20 70 54 6f 52 65 ** of pToRe
2c7d0 6c 65 61 73 65 2e 20 20 4d 61 6b 65 20 73 75 72 lease. Make sur
2c7e0 65 20 70 54 6f 52 65 6c 65 61 73 65 20 69 73 20 e pToRelease is
2c7f0 73 74 69 6c 6c 20 77 72 69 74 65 61 62 6c 65 2e still writeable.
2c800 20 2a 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 */. assert
2c810 28 20 70 54 6f 52 65 6c 65 61 73 65 3d 3d 30 20 ( pToRelease==0
2c820 7c 7c 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 || sqlite3PagerI
2c830 73 77 72 69 74 65 61 62 6c 65 28 70 54 6f 52 65 swriteable(pToRe
2c840 6c 65 61 73 65 2d 3e 70 44 62 50 61 67 65 29 20 lease->pDbPage)
2c850 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 );.. /* If
2c860 70 50 72 69 6f 72 20 69 73 20 70 61 72 74 20 6f pPrior is part o
2c870 66 20 74 68 65 20 64 61 74 61 20 61 72 65 61 20 f the data area
2c880 6f 66 20 70 50 61 67 65 2c 20 74 68 65 6e 20 6d of pPage, then m
2c890 61 6b 65 20 73 75 72 65 20 70 50 61 67 65 0a 20 ake sure pPage.
2c8a0 20 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c ** is still
2c8b0 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a 20 20 writeable */.
2c8c0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 72 69 assert( pPri
2c8d0 6f 72 3c 70 50 61 67 65 2d 3e 61 44 61 74 61 20 or<pPage->aData
2c8e0 7c 7c 20 70 50 72 69 6f 72 3e 3d 26 70 50 61 67 || pPrior>=&pPag
2c8f0 65 2d 3e 61 44 61 74 61 5b 70 42 74 2d 3e 70 61 e->aData[pBt->pa
2c900 67 65 53 69 7a 65 5d 0a 20 20 20 20 20 20 20 20 geSize].
2c910 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 || sqlite3Pa
2c920 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
2c930 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
2c940 3b 0a 0a 20 20 20 20 20 20 70 75 74 34 62 79 74 ;.. put4byt
2c950 65 28 70 50 72 69 6f 72 2c 20 70 67 6e 6f 4f 76 e(pPrior, pgnoOv
2c960 66 6c 29 3b 0a 20 20 20 20 20 20 72 65 6c 65 61 fl);. relea
2c970 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 sePage(pToReleas
2c980 65 29 3b 0a 20 20 20 20 20 20 70 54 6f 52 65 6c e);. pToRel
2c990 65 61 73 65 20 3d 20 70 4f 76 66 6c 3b 0a 20 20 ease = pOvfl;.
2c9a0 20 20 20 20 70 50 72 69 6f 72 20 3d 20 70 4f 76 pPrior = pOv
2c9b0 66 6c 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 20 fl->aData;.
2c9c0 20 70 75 74 34 62 79 74 65 28 70 50 72 69 6f 72 put4byte(pPrior
2c9d0 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 50 61 79 , 0);. pPay
2c9e0 6c 6f 61 64 20 3d 20 26 70 4f 76 66 6c 2d 3e 61 load = &pOvfl->a
2c9f0 44 61 74 61 5b 34 5d 3b 0a 20 20 20 20 20 20 73 Data[4];. s
2ca00 70 61 63 65 4c 65 66 74 20 3d 20 70 42 74 2d 3e paceLeft = pBt->
2ca10 75 73 61 62 6c 65 53 69 7a 65 20 2d 20 34 3b 0a usableSize - 4;.
2ca20 20 20 20 20 7d 0a 20 20 20 20 6e 20 3d 20 6e 50 }. n = nP
2ca30 61 79 6c 6f 61 64 3b 0a 20 20 20 20 69 66 28 20 ayload;. if(
2ca40 6e 3e 73 70 61 63 65 4c 65 66 74 20 29 20 6e 20 n>spaceLeft ) n
2ca50 3d 20 73 70 61 63 65 4c 65 66 74 3b 0a 0a 20 20 = spaceLeft;..
2ca60 20 20 2f 2a 20 49 66 20 70 54 6f 52 65 6c 65 61 /* If pToRelea
2ca70 73 65 20 69 73 20 6e 6f 74 20 7a 65 72 6f 20 74 se is not zero t
2ca80 68 61 6e 20 70 50 61 79 6c 6f 61 64 20 70 6f 69 han pPayload poi
2ca90 6e 74 73 20 69 6e 74 6f 20 74 68 65 20 64 61 74 nts into the dat
2caa0 61 20 61 72 65 61 0a 20 20 20 20 2a 2a 20 6f 66 a area. ** of
2cab0 20 70 54 6f 52 65 6c 65 61 73 65 2e 20 20 4d 61 pToRelease. Ma
2cac0 6b 65 20 73 75 72 65 20 70 54 6f 52 65 6c 65 61 ke sure pToRelea
2cad0 73 65 20 69 73 20 73 74 69 6c 6c 20 77 72 69 74 se is still writ
2cae0 65 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 61 73 eable. */. as
2caf0 73 65 72 74 28 20 70 54 6f 52 65 6c 65 61 73 65 sert( pToRelease
2cb00 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 50 61 ==0 || sqlite3Pa
2cb10 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
2cb20 54 6f 52 65 6c 65 61 73 65 2d 3e 70 44 62 50 61 ToRelease->pDbPa
2cb30 67 65 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 ge) );.. /* I
2cb40 66 20 70 50 61 79 6c 6f 61 64 20 69 73 20 70 61 f pPayload is pa
2cb50 72 74 20 6f 66 20 74 68 65 20 64 61 74 61 20 61 rt of the data a
2cb60 72 65 61 20 6f 66 20 70 50 61 67 65 2c 20 74 68 rea of pPage, th
2cb70 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 70 50 61 en make sure pPa
2cb80 67 65 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 69 ge. ** is sti
2cb90 6c 6c 20 77 72 69 74 65 61 62 6c 65 20 2a 2f 0a ll writeable */.
2cba0 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 79 assert( pPay
2cbb0 6c 6f 61 64 3c 70 50 61 67 65 2d 3e 61 44 61 74 load<pPage->aDat
2cbc0 61 20 7c 7c 20 70 50 61 79 6c 6f 61 64 3e 3d 26 a || pPayload>=&
2cbd0 70 50 61 67 65 2d 3e 61 44 61 74 61 5b 70 42 74 pPage->aData[pBt
2cbe0 2d 3e 70 61 67 65 53 69 7a 65 5d 0a 20 20 20 20 ->pageSize].
2cbf0 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 || sqlit
2cc00 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
2cc10 6c 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 le(pPage->pDbPag
2cc20 65 29 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 6e e) );.. if( n
2cc30 53 72 63 3e 30 20 29 7b 0a 20 20 20 20 20 20 69 Src>0 ){. i
2cc40 66 28 20 6e 3e 6e 53 72 63 20 29 20 6e 20 3d 20 f( n>nSrc ) n =
2cc50 6e 53 72 63 3b 0a 20 20 20 20 20 20 61 73 73 65 nSrc;. asse
2cc60 72 74 28 20 70 53 72 63 20 29 3b 0a 20 20 20 20 rt( pSrc );.
2cc70 20 20 6d 65 6d 63 70 79 28 70 50 61 79 6c 6f 61 memcpy(pPayloa
2cc80 64 2c 20 70 53 72 63 2c 20 6e 29 3b 0a 20 20 20 d, pSrc, n);.
2cc90 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6d 65 }else{. me
2cca0 6d 73 65 74 28 70 50 61 79 6c 6f 61 64 2c 20 30 mset(pPayload, 0
2ccb0 2c 20 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 , n);. }.
2ccc0 6e 50 61 79 6c 6f 61 64 20 2d 3d 20 6e 3b 0a 20 nPayload -= n;.
2ccd0 20 20 20 70 50 61 79 6c 6f 61 64 20 2b 3d 20 6e pPayload += n
2cce0 3b 0a 20 20 20 20 70 53 72 63 20 2b 3d 20 6e 3b ;. pSrc += n;
2ccf0 0a 20 20 20 20 6e 53 72 63 20 2d 3d 20 6e 3b 0a . nSrc -= n;.
2cd00 20 20 20 20 73 70 61 63 65 4c 65 66 74 20 2d 3d spaceLeft -=
2cd10 20 6e 3b 0a 20 20 20 20 69 66 28 20 6e 53 72 63 n;. if( nSrc
2cd20 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 6e 53 72 ==0 ){. nSr
2cd30 63 20 3d 20 6e 44 61 74 61 3b 0a 20 20 20 20 20 c = nData;.
2cd40 20 70 53 72 63 20 3d 20 70 44 61 74 61 3b 0a 20 pSrc = pData;.
2cd50 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 6c 65 61 }. }. relea
2cd60 73 65 50 61 67 65 28 70 54 6f 52 65 6c 65 61 73 sePage(pToReleas
2cd70 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c e);. return SQL
2cd80 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ITE_OK;.}../*.**
2cd90 20 52 65 6d 6f 76 65 20 74 68 65 20 69 2d 74 68 Remove the i-th
2cda0 20 63 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 cell from pPage
2cdb0 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
2cdc0 65 66 66 65 63 74 73 20 70 50 61 67 65 20 6f 6e effects pPage on
2cdd0 6c 79 2e 0a 2a 2a 20 54 68 65 20 63 65 6c 6c 20 ly..** The cell
2cde0 63 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20 66 content is not f
2cdf0 72 65 65 64 20 6f 72 20 64 65 61 6c 6c 6f 63 61 reed or dealloca
2ce00 74 65 64 2e 20 20 49 74 20 69 73 20 61 73 73 75 ted. It is assu
2ce10 6d 65 64 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 med that.** the
2ce20 63 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 cell content has
2ce30 20 62 65 65 6e 20 63 6f 70 69 65 64 20 73 6f 6d been copied som
2ce40 65 70 6c 61 63 65 20 65 6c 73 65 2e 20 20 54 68 eplace else. Th
2ce50 69 73 20 72 6f 75 74 69 6e 65 20 6a 75 73 74 0a is routine just.
2ce60 2a 2a 20 72 65 6d 6f 76 65 73 20 74 68 65 20 72 ** removes the r
2ce70 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 eference to the
2ce80 63 65 6c 6c 20 66 72 6f 6d 20 70 50 61 67 65 2e cell from pPage.
2ce90 0a 2a 2a 0a 2a 2a 20 22 73 7a 22 20 6d 75 73 74 .**.** "sz" must
2cea0 20 62 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f be the number o
2ceb0 66 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 63 f bytes in the c
2cec0 65 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ell..*/.static v
2ced0 6f 69 64 20 64 72 6f 70 43 65 6c 6c 28 4d 65 6d oid dropCell(Mem
2cee0 50 61 67 65 20 2a 70 50 61 67 65 2c 20 69 6e 74 Page *pPage, int
2cef0 20 69 64 78 2c 20 69 6e 74 20 73 7a 2c 20 69 6e idx, int sz, in
2cf00 74 20 2a 70 52 43 29 7b 0a 20 20 75 33 32 20 70 t *pRC){. u32 p
2cf10 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 c; /* Of
2cf20 66 73 65 74 20 74 6f 20 63 65 6c 6c 20 63 6f 6e fset to cell con
2cf30 74 65 6e 74 20 6f 66 20 63 65 6c 6c 20 62 65 69 tent of cell bei
2cf40 6e 67 20 64 65 6c 65 74 65 64 20 2a 2f 0a 20 20 ng deleted */.
2cf50 75 38 20 2a 64 61 74 61 3b 20 20 20 20 20 20 20 u8 *data;
2cf60 2f 2a 20 70 50 61 67 65 2d 3e 61 44 61 74 61 20 /* pPage->aData
2cf70 2a 2f 0a 20 20 75 38 20 2a 70 74 72 3b 20 20 20 */. u8 *ptr;
2cf80 20 20 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 /* Used to
2cf90 6d 6f 76 65 20 62 79 74 65 73 20 61 72 6f 75 6e move bytes aroun
2cfa0 64 20 77 69 74 68 69 6e 20 64 61 74 61 5b 5d 20 d within data[]
2cfb0 2a 2f 0a 20 20 75 38 20 2a 65 6e 64 50 74 72 3b */. u8 *endPtr;
2cfc0 20 20 20 20 20 2f 2a 20 45 6e 64 20 6f 66 20 6c /* End of l
2cfd0 6f 6f 70 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b oop */. int rc;
2cfe0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
2cff0 72 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 return code */.
2d000 20 69 6e 74 20 68 64 72 3b 20 20 20 20 20 20 20 int hdr;
2d010 20 2f 2a 20 42 65 67 69 6e 6e 69 6e 67 20 6f 66 /* Beginning of
2d020 20 74 68 65 20 68 65 61 64 65 72 2e 20 20 30 20 the header. 0
2d030 6d 6f 73 74 20 70 61 67 65 73 2e 20 20 31 30 30 most pages. 100
2d040 20 70 61 67 65 20 31 20 2a 2f 0a 0a 20 20 69 66 page 1 */.. if
2d050 28 20 2a 70 52 43 20 29 20 72 65 74 75 72 6e 3b ( *pRC ) return;
2d060 0a 0a 20 20 61 73 73 65 72 74 28 20 69 64 78 3e .. assert( idx>
2d070 3d 30 20 26 26 20 69 64 78 3c 70 50 61 67 65 2d =0 && idx<pPage-
2d080 3e 6e 43 65 6c 6c 20 29 3b 0a 20 20 61 73 73 65 >nCell );. asse
2d090 72 74 28 20 73 7a 3d 3d 63 65 6c 6c 53 69 7a 65 rt( sz==cellSize
2d0a0 28 70 50 61 67 65 2c 20 69 64 78 29 20 29 3b 0a (pPage, idx) );.
2d0b0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
2d0c0 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 6c 3PagerIswriteabl
2d0d0 65 28 70 50 61 67 65 2d 3e 70 44 62 50 61 67 65 e(pPage->pDbPage
2d0e0 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 ) );. assert( s
2d0f0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
2d100 64 28 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 d(pPage->pBt->mu
2d110 74 65 78 29 20 29 3b 0a 20 20 64 61 74 61 20 3d tex) );. data =
2d120 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 0a 20 pPage->aData;.
2d130 20 70 74 72 20 3d 20 26 70 50 61 67 65 2d 3e 61 ptr = &pPage->a
2d140 43 65 6c 6c 49 64 78 5b 32 2a 69 64 78 5d 3b 0a CellIdx[2*idx];.
2d150 20 20 70 63 20 3d 20 67 65 74 32 62 79 74 65 28 pc = get2byte(
2d160 70 74 72 29 3b 0a 20 20 68 64 72 20 3d 20 70 50 ptr);. hdr = pP
2d170 61 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 0a age->hdrOffset;.
2d180 20 20 74 65 73 74 63 61 73 65 28 20 70 63 3d 3d testcase( pc==
2d190 67 65 74 32 62 79 74 65 28 26 64 61 74 61 5b 68 get2byte(&data[h
2d1a0 64 72 2b 35 5d 29 20 29 3b 0a 20 20 74 65 73 74 dr+5]) );. test
2d1b0 63 61 73 65 28 20 70 63 2b 73 7a 3d 3d 70 50 61 case( pc+sz==pPa
2d1c0 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c 65 53 ge->pBt->usableS
2d1d0 69 7a 65 20 29 3b 0a 20 20 69 66 28 20 70 63 20 ize );. if( pc
2d1e0 3c 20 28 75 33 32 29 67 65 74 32 62 79 74 65 28 < (u32)get2byte(
2d1f0 26 64 61 74 61 5b 68 64 72 2b 35 5d 29 20 7c 7c &data[hdr+5]) ||
2d200 20 70 63 2b 73 7a 20 3e 20 70 50 61 67 65 2d 3e pc+sz > pPage->
2d210 70 42 74 2d 3e 75 73 61 62 6c 65 53 69 7a 65 20 pBt->usableSize
2d220 29 7b 0a 20 20 20 20 2a 70 52 43 20 3d 20 53 51 ){. *pRC = SQ
2d230 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2d240 54 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 T;. return;.
2d250 20 7d 0a 20 20 72 63 20 3d 20 66 72 65 65 53 70 }. rc = freeSp
2d260 61 63 65 28 70 50 61 67 65 2c 20 70 63 2c 20 73 ace(pPage, pc, s
2d270 7a 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a z);. if( rc ){.
2d280 20 20 20 20 2a 70 52 43 20 3d 20 72 63 3b 0a 20 *pRC = rc;.
2d290 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 return;. }.
2d2a0 20 65 6e 64 50 74 72 20 3d 20 26 70 50 61 67 65 endPtr = &pPage
2d2b0 2d 3e 61 43 65 6c 6c 49 64 78 5b 32 2a 70 50 61 ->aCellIdx[2*pPa
2d2c0 67 65 2d 3e 6e 43 65 6c 6c 20 2d 20 32 5d 3b 0a ge->nCell - 2];.
2d2d0 20 20 61 73 73 65 72 74 28 20 28 53 51 4c 49 54 assert( (SQLIT
2d2e0 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 74 72 E_PTR_TO_INT(ptr
2d2f0 29 26 31 29 3d 3d 30 20 29 3b 20 20 2f 2a 20 70 )&1)==0 ); /* p
2d300 74 72 20 69 73 20 61 6c 77 61 79 73 20 32 2d 62 tr is always 2-b
2d310 79 74 65 20 61 6c 69 67 6e 65 64 20 2a 2f 0a 20 yte aligned */.
2d320 20 77 68 69 6c 65 28 20 70 74 72 3c 65 6e 64 50 while( ptr<endP
2d330 74 72 20 29 7b 0a 20 20 20 20 2a 28 75 31 36 2a tr ){. *(u16*
2d340 29 70 74 72 20 3d 20 2a 28 75 31 36 2a 29 26 70 )ptr = *(u16*)&p
2d350 74 72 5b 32 5d 3b 0a 20 20 20 20 70 74 72 20 2b tr[2];. ptr +
2d360 3d 20 32 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 = 2;. }. pPage
2d370 2d 3e 6e 43 65 6c 6c 2d 2d 3b 0a 20 20 70 75 74 ->nCell--;. put
2d380 32 62 79 74 65 28 26 64 61 74 61 5b 68 64 72 2b 2byte(&data[hdr+
2d390 33 5d 2c 20 70 50 61 67 65 2d 3e 6e 43 65 6c 6c 3], pPage->nCell
2d3a0 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 65 );. pPage->nFre
2d3b0 65 20 2b 3d 20 32 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a e += 2;.}../*.**
2d3c0 20 49 6e 73 65 72 74 20 61 20 6e 65 77 20 63 65 Insert a new ce
2d3d0 6c 6c 20 6f 6e 20 70 50 61 67 65 20 61 74 20 63 ll on pPage at c
2d3e0 65 6c 6c 20 69 6e 64 65 78 20 22 69 22 2e 20 20 ell index "i".
2d3f0 70 43 65 6c 6c 20 70 6f 69 6e 74 73 20 74 6f 20 pCell points to
2d400 74 68 65 0a 2a 2a 20 63 6f 6e 74 65 6e 74 20 6f the.** content o
2d410 66 20 74 68 65 20 63 65 6c 6c 2e 0a 2a 2a 0a 2a f the cell..**.*
2d420 2a 20 49 66 20 74 68 65 20 63 65 6c 6c 20 63 6f * If the cell co
2d430 6e 74 65 6e 74 20 77 69 6c 6c 20 66 69 74 20 6f ntent will fit o
2d440 6e 20 74 68 65 20 70 61 67 65 2c 20 74 68 65 6e n the page, then
2d450 20 70 75 74 20 69 74 20 74 68 65 72 65 2e 20 20 put it there.
2d460 49 66 20 69 74 0a 2a 2a 20 77 69 6c 6c 20 6e 6f If it.** will no
2d470 74 20 66 69 74 2c 20 74 68 65 6e 20 6d 61 6b 65 t fit, then make
2d480 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 63 a copy of the c
2d490 65 6c 6c 20 63 6f 6e 74 65 6e 74 20 69 6e 74 6f ell content into
2d4a0 20 70 54 65 6d 70 20 69 66 0a 2a 2a 20 70 54 65 pTemp if.** pTe
2d4b0 6d 70 20 69 73 20 6e 6f 74 20 6e 75 6c 6c 2e 20 mp is not null.
2d4c0 20 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 70 Regardless of p
2d4d0 54 65 6d 70 2c 20 61 6c 6c 6f 63 61 74 65 20 61 Temp, allocate a
2d4e0 20 6e 65 77 20 65 6e 74 72 79 0a 2a 2a 20 69 6e new entry.** in
2d4f0 20 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 5d pPage->apOvfl[]
2d500 20 61 6e 64 20 6d 61 6b 65 20 69 74 20 70 6f 69 and make it poi
2d510 6e 74 20 74 6f 20 74 68 65 20 63 65 6c 6c 20 63 nt to the cell c
2d520 6f 6e 74 65 6e 74 20 28 65 69 74 68 65 72 0a 2a ontent (either.*
2d530 2a 20 69 6e 20 70 54 65 6d 70 20 6f 72 20 74 68 * in pTemp or th
2d540 65 20 6f 72 69 67 69 6e 61 6c 20 70 43 65 6c 6c e original pCell
2d550 29 20 61 6e 64 20 61 6c 73 6f 20 72 65 63 6f 72 ) and also recor
2d560 64 20 69 74 73 20 69 6e 64 65 78 2e 20 0a 2a 2a d its index. .**
2d570 20 41 6c 6c 6f 63 61 74 69 6e 67 20 61 20 6e 65 Allocating a ne
2d580 77 20 65 6e 74 72 79 20 69 6e 20 70 50 61 67 65 w entry in pPage
2d590 2d 3e 61 43 65 6c 6c 5b 5d 20 69 6d 70 6c 69 65 ->aCell[] implie
2d5a0 73 20 74 68 61 74 20 0a 2a 2a 20 70 50 61 67 65 s that .** pPage
2d5b0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 69 73 20 69 ->nOverflow is i
2d5c0 6e 63 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a 2a ncremented..**.*
2d5d0 2a 20 49 66 20 6e 53 6b 69 70 20 69 73 20 6e 6f * If nSkip is no
2d5e0 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 64 6f 20 n-zero, then do
2d5f0 6e 6f 74 20 63 6f 70 79 20 74 68 65 20 66 69 72 not copy the fir
2d600 73 74 20 6e 53 6b 69 70 20 62 79 74 65 73 20 6f st nSkip bytes o
2d610 66 20 74 68 65 0a 2a 2a 20 63 65 6c 6c 2e 20 54 f the.** cell. T
2d620 68 65 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6f he caller will o
2d630 76 65 72 77 72 69 74 65 20 74 68 65 6d 20 61 66 verwrite them af
2d640 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 6f ter this functio
2d650 6e 20 72 65 74 75 72 6e 73 2e 20 49 66 0a 2a 2a n returns. If.**
2d660 20 6e 53 6b 69 70 20 69 73 20 6e 6f 6e 2d 7a 65 nSkip is non-ze
2d670 72 6f 2c 20 74 68 65 6e 20 70 43 65 6c 6c 20 6d ro, then pCell m
2d680 61 79 20 6e 6f 74 20 70 6f 69 6e 74 20 74 6f 20 ay not point to
2d690 61 6e 20 69 6e 76 61 6c 69 64 20 6d 65 6d 6f 72 an invalid memor
2d6a0 79 20 6c 6f 63 61 74 69 6f 6e 20 0a 2a 2a 20 28 y location .** (
2d6b0 62 75 74 20 70 43 65 6c 6c 2b 6e 53 6b 69 70 20 but pCell+nSkip
2d6c0 69 73 20 61 6c 77 61 79 73 20 76 61 6c 69 64 29 is always valid)
2d6d0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
2d6e0 20 69 6e 73 65 72 74 43 65 6c 6c 28 0a 20 20 4d insertCell(. M
2d6f0 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c 20 20 emPage *pPage,
2d700 20 2f 2a 20 50 61 67 65 20 69 6e 74 6f 20 77 68 /* Page into wh
2d710 69 63 68 20 77 65 20 61 72 65 20 63 6f 70 79 69 ich we are copyi
2d720 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 20 ng */. int i,
2d730 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 /* New
2d740 20 63 65 6c 6c 20 62 65 63 6f 6d 65 73 20 74 68 cell becomes th
2d750 65 20 69 2d 74 68 20 63 65 6c 6c 20 6f 66 20 74 e i-th cell of t
2d760 68 65 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 he page */. u8
2d770 2a 70 43 65 6c 6c 2c 20 20 20 20 20 20 20 20 2f *pCell, /
2d780 2a 20 43 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 * Content of the
2d790 20 6e 65 77 20 63 65 6c 6c 20 2a 2f 0a 20 20 69 new cell */. i
2d7a0 6e 74 20 73 7a 2c 20 20 20 20 20 20 20 20 20 20 nt sz,
2d7b0 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 63 6f 6e /* Bytes of con
2d7c0 74 65 6e 74 20 69 6e 20 70 43 65 6c 6c 20 2a 2f tent in pCell */
2d7d0 0a 20 20 75 38 20 2a 70 54 65 6d 70 2c 20 20 20 . u8 *pTemp,
2d7e0 20 20 20 20 20 2f 2a 20 54 65 6d 70 20 73 74 6f /* Temp sto
2d7f0 72 61 67 65 20 73 70 61 63 65 20 66 6f 72 20 70 rage space for p
2d800 43 65 6c 6c 2c 20 69 66 20 6e 65 65 64 65 64 20 Cell, if needed
2d810 2a 2f 0a 20 20 50 67 6e 6f 20 69 43 68 69 6c 64 */. Pgno iChild
2d820 2c 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 6e , /* If non
2d830 2d 7a 65 72 6f 2c 20 72 65 70 6c 61 63 65 20 66 -zero, replace f
2d840 69 72 73 74 20 34 20 62 79 74 65 73 20 77 69 74 irst 4 bytes wit
2d850 68 20 74 68 69 73 20 76 61 6c 75 65 20 2a 2f 0a h this value */.
2d860 20 20 69 6e 74 20 2a 70 52 43 20 20 20 20 20 20 int *pRC
2d870 20 20 20 20 2f 2a 20 52 65 61 64 20 61 6e 64 20 /* Read and
2d880 77 72 69 74 65 20 72 65 74 75 72 6e 20 63 6f 64 write return cod
2d890 65 20 66 72 6f 6d 20 68 65 72 65 20 2a 2f 0a 29 e from here */.)
2d8a0 7b 0a 20 20 69 6e 74 20 69 64 78 20 3d 20 30 3b {. int idx = 0;
2d8b0 20 20 20 20 20 20 2f 2a 20 57 68 65 72 65 20 74 /* Where t
2d8c0 6f 20 77 72 69 74 65 20 6e 65 77 20 63 65 6c 6c o write new cell
2d8d0 20 63 6f 6e 74 65 6e 74 20 69 6e 20 64 61 74 61 content in data
2d8e0 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6a 3b 20 20 [] */. int j;
2d8f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f /* Loo
2d900 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 p counter */. i
2d910 6e 74 20 65 6e 64 3b 20 20 20 20 20 20 20 20 20 nt end;
2d920 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 70 /* First byte p
2d930 61 73 74 20 74 68 65 20 6c 61 73 74 20 63 65 6c ast the last cel
2d940 6c 20 70 6f 69 6e 74 65 72 20 69 6e 20 64 61 74 l pointer in dat
2d950 61 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 6e 73 a[] */. int ins
2d960 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e ; /* In
2d970 64 65 78 20 69 6e 20 64 61 74 61 5b 5d 20 77 68 dex in data[] wh
2d980 65 72 65 20 6e 65 77 20 63 65 6c 6c 20 70 6f 69 ere new cell poi
2d990 6e 74 65 72 20 69 73 20 69 6e 73 65 72 74 65 64 nter is inserted
2d9a0 20 2a 2f 0a 20 20 69 6e 74 20 63 65 6c 6c 4f 66 */. int cellOf
2d9b0 66 73 65 74 3b 20 20 20 2f 2a 20 41 64 64 72 65 fset; /* Addre
2d9c0 73 73 20 6f 66 20 66 69 72 73 74 20 63 65 6c 6c ss of first cell
2d9d0 20 70 6f 69 6e 74 65 72 20 69 6e 20 64 61 74 61 pointer in data
2d9e0 5b 5d 20 2a 2f 0a 20 20 75 38 20 2a 64 61 74 61 [] */. u8 *data
2d9f0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ; /* The
2da00 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 content of the
2da10 77 68 6f 6c 65 20 70 61 67 65 20 2a 2f 0a 20 20 whole page */.
2da20 75 38 20 2a 70 74 72 3b 20 20 20 20 20 20 20 20 u8 *ptr;
2da30 20 20 2f 2a 20 55 73 65 64 20 66 6f 72 20 6d 6f /* Used for mo
2da40 76 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ving information
2da50 20 61 72 6f 75 6e 64 20 69 6e 20 64 61 74 61 5b around in data[
2da60 5d 20 2a 2f 0a 20 20 75 38 20 2a 65 6e 64 50 74 ] */. u8 *endPt
2da70 72 3b 20 20 20 20 20 20 20 2f 2a 20 45 6e 64 20 r; /* End
2da80 6f 66 20 74 68 65 20 6c 6f 6f 70 20 2a 2f 0a 0a of the loop */..
2da90 20 20 69 6e 74 20 6e 53 6b 69 70 20 3d 20 28 69 int nSkip = (i
2daa0 43 68 69 6c 64 20 3f 20 34 20 3a 20 30 29 3b 0a Child ? 4 : 0);.
2dab0 0a 20 20 69 66 28 20 2a 70 52 43 20 29 20 72 65 . if( *pRC ) re
2dac0 74 75 72 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28 turn;.. assert(
2dad0 20 69 3e 3d 30 20 26 26 20 69 3c 3d 70 50 61 67 i>=0 && i<=pPag
2dae0 65 2d 3e 6e 43 65 6c 6c 2b 70 50 61 67 65 2d 3e e->nCell+pPage->
2daf0 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 0a 20 20 61 nOverflow );. a
2db00 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e 6e 43 ssert( pPage->nC
2db10 65 6c 6c 3c 3d 4d 58 5f 43 45 4c 4c 28 70 50 61 ell<=MX_CELL(pPa
2db20 67 65 2d 3e 70 42 74 29 20 26 26 20 4d 58 5f 43 ge->pBt) && MX_C
2db30 45 4c 4c 28 70 50 61 67 65 2d 3e 70 42 74 29 3c ELL(pPage->pBt)<
2db40 3d 31 30 39 32 31 20 29 3b 0a 20 20 61 73 73 65 =10921 );. asse
2db50 72 74 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 72 rt( pPage->nOver
2db60 66 6c 6f 77 3c 3d 41 72 72 61 79 53 69 7a 65 28 flow<=ArraySize(
2db70 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 29 20 29 pPage->apOvfl) )
2db80 3b 0a 20 20 61 73 73 65 72 74 28 20 41 72 72 61 ;. assert( Arra
2db90 79 53 69 7a 65 28 70 50 61 67 65 2d 3e 61 70 4f ySize(pPage->apO
2dba0 76 66 6c 29 3d 3d 41 72 72 61 79 53 69 7a 65 28 vfl)==ArraySize(
2dbb0 70 50 61 67 65 2d 3e 61 69 4f 76 66 6c 29 20 29 pPage->aiOvfl) )
2dbc0 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
2dbd0 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 70 te3_mutex_held(p
2dbe0 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 78 Page->pBt->mutex
2dbf0 29 20 29 3b 0a 20 20 2f 2a 20 54 68 65 20 63 65 ) );. /* The ce
2dc00 6c 6c 20 73 68 6f 75 6c 64 20 6e 6f 72 6d 61 6c ll should normal
2dc10 6c 79 20 62 65 20 73 69 7a 65 64 20 63 6f 72 72 ly be sized corr
2dc20 65 63 74 6c 79 2e 20 20 48 6f 77 65 76 65 72 2c ectly. However,
2dc30 20 77 68 65 6e 20 6d 6f 76 69 6e 67 20 61 0a 20 when moving a.
2dc40 20 2a 2a 20 6d 61 6c 66 6f 72 6d 65 64 20 63 65 ** malformed ce
2dc50 6c 6c 20 66 72 6f 6d 20 61 20 6c 65 61 66 20 70 ll from a leaf p
2dc60 61 67 65 20 74 6f 20 61 6e 20 69 6e 74 65 72 69 age to an interi
2dc70 6f 72 20 70 61 67 65 2c 20 69 66 20 74 68 65 20 or page, if the
2dc80 63 65 6c 6c 20 73 69 7a 65 0a 20 20 2a 2a 20 77 cell size. ** w
2dc90 61 6e 74 65 64 20 74 6f 20 62 65 20 6c 65 73 73 anted to be less
2dca0 20 74 68 61 6e 20 34 20 62 75 74 20 67 6f 74 20 than 4 but got
2dcb0 72 6f 75 6e 64 65 64 20 75 70 20 74 6f 20 34 20 rounded up to 4
2dcc0 6f 6e 20 74 68 65 20 6c 65 61 66 2c 20 74 68 65 on the leaf, the
2dcd0 6e 20 73 69 7a 65 0a 20 20 2a 2a 20 6d 69 67 68 n size. ** migh
2dce0 74 20 62 65 20 6c 65 73 73 20 74 68 61 6e 20 38 t be less than 8
2dcf0 20 28 6c 65 61 66 2d 73 69 7a 65 20 2b 20 70 6f (leaf-size + po
2dd00 69 6e 74 65 72 29 20 6f 6e 20 74 68 65 20 69 6e inter) on the in
2dd10 74 65 72 69 6f 72 20 6e 6f 64 65 2e 20 20 48 65 terior node. He
2dd20 6e 63 65 0a 20 20 2a 2a 20 74 68 65 20 74 65 72 nce. ** the ter
2dd30 6d 20 61 66 74 65 72 20 74 68 65 20 7c 7c 20 69 m after the || i
2dd40 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
2dd50 61 73 73 65 72 74 28 29 2e 20 2a 2f 0a 20 20 61 assert(). */. a
2dd60 73 73 65 72 74 28 20 73 7a 3d 3d 63 65 6c 6c 53 ssert( sz==cellS
2dd70 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 70 43 izePtr(pPage, pC
2dd80 65 6c 6c 29 20 7c 7c 20 28 73 7a 3d 3d 38 20 26 ell) || (sz==8 &
2dd90 26 20 69 43 68 69 6c 64 3e 30 29 20 29 3b 0a 20 & iChild>0) );.
2dda0 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 if( pPage->nOve
2ddb0 72 66 6c 6f 77 20 7c 7c 20 73 7a 2b 32 3e 70 50 rflow || sz+2>pP
2ddc0 61 67 65 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 age->nFree ){.
2ddd0 20 20 69 66 28 20 70 54 65 6d 70 20 29 7b 0a 20 if( pTemp ){.
2dde0 20 20 20 20 20 6d 65 6d 63 70 79 28 70 54 65 6d memcpy(pTem
2ddf0 70 2b 6e 53 6b 69 70 2c 20 70 43 65 6c 6c 2b 6e p+nSkip, pCell+n
2de00 53 6b 69 70 2c 20 73 7a 2d 6e 53 6b 69 70 29 3b Skip, sz-nSkip);
2de10 0a 20 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 70 . pCell = p
2de20 54 65 6d 70 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Temp;. }.
2de30 69 66 28 20 69 43 68 69 6c 64 20 29 7b 0a 20 20 if( iChild ){.
2de40 20 20 20 20 70 75 74 34 62 79 74 65 28 70 43 65 put4byte(pCe
2de50 6c 6c 2c 20 69 43 68 69 6c 64 29 3b 0a 20 20 20 ll, iChild);.
2de60 20 7d 0a 20 20 20 20 6a 20 3d 20 70 50 61 67 65 }. j = pPage
2de70 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2b 2b 3b 0a 20 ->nOverflow++;.
2de80 20 20 20 61 73 73 65 72 74 28 20 6a 3c 28 69 6e assert( j<(in
2de90 74 29 28 73 69 7a 65 6f 66 28 70 50 61 67 65 2d t)(sizeof(pPage-
2dea0 3e 61 70 4f 76 66 6c 29 2f 73 69 7a 65 6f 66 28 >apOvfl)/sizeof(
2deb0 70 50 61 67 65 2d 3e 61 70 4f 76 66 6c 5b 30 5d pPage->apOvfl[0]
2dec0 29 29 20 29 3b 0a 20 20 20 20 70 50 61 67 65 2d )) );. pPage-
2ded0 3e 61 70 4f 76 66 6c 5b 6a 5d 20 3d 20 70 43 65 >apOvfl[j] = pCe
2dee0 6c 6c 3b 0a 20 20 20 20 70 50 61 67 65 2d 3e 61 ll;. pPage->a
2def0 69 4f 76 66 6c 5b 6a 5d 20 3d 20 28 75 31 36 29 iOvfl[j] = (u16)
2df00 69 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 i;. }else{.
2df10 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 int rc = sqlite3
2df20 50 61 67 65 72 57 72 69 74 65 28 70 50 61 67 65 PagerWrite(pPage
2df30 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 20 20 20 ->pDbPage);.
2df40 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
2df50 4b 20 29 7b 0a 20 20 20 20 20 20 2a 70 52 43 20 K ){. *pRC
2df60 3d 20 72 63 3b 0a 20 20 20 20 20 20 72 65 74 75 = rc;. retu
2df70 72 6e 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 rn;. }. as
2df80 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
2df90 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 erIswriteable(pP
2dfa0 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 3b age->pDbPage) );
2dfb0 0a 20 20 20 20 64 61 74 61 20 3d 20 70 50 61 67 . data = pPag
2dfc0 65 2d 3e 61 44 61 74 61 3b 0a 20 20 20 20 63 65 e->aData;. ce
2dfd0 6c 6c 4f 66 66 73 65 74 20 3d 20 70 50 61 67 65 llOffset = pPage
2dfe0 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 3b 0a 20 20 ->cellOffset;.
2dff0 20 20 65 6e 64 20 3d 20 63 65 6c 6c 4f 66 66 73 end = cellOffs
2e000 65 74 20 2b 20 32 2a 70 50 61 67 65 2d 3e 6e 43 et + 2*pPage->nC
2e010 65 6c 6c 3b 0a 20 20 20 20 69 6e 73 20 3d 20 63 ell;. ins = c
2e020 65 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 69 3b ellOffset + 2*i;
2e030 0a 20 20 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 . rc = alloca
2e040 74 65 53 70 61 63 65 28 70 50 61 67 65 2c 20 73 teSpace(pPage, s
2e050 7a 2c 20 26 69 64 78 29 3b 0a 20 20 20 20 69 66 z, &idx);. if
2e060 28 20 72 63 20 29 7b 20 2a 70 52 43 20 3d 20 72 ( rc ){ *pRC = r
2e070 63 3b 20 72 65 74 75 72 6e 3b 20 7d 0a 20 20 20 c; return; }.
2e080 20 2f 2a 20 54 68 65 20 61 6c 6c 6f 63 61 74 65 /* The allocate
2e090 53 70 61 63 65 28 29 20 72 6f 75 74 69 6e 65 20 Space() routine
2e0a0 67 75 61 72 61 6e 74 65 65 73 20 74 68 65 20 66 guarantees the f
2e0b0 6f 6c 6c 6f 77 69 6e 67 20 74 77 6f 20 70 72 6f ollowing two pro
2e0c0 70 65 72 74 69 65 73 0a 20 20 20 20 2a 2a 20 69 perties. ** i
2e0d0 66 20 69 74 20 72 65 74 75 72 6e 73 20 73 75 63 f it returns suc
2e0e0 63 65 73 73 20 2a 2f 0a 20 20 20 20 61 73 73 65 cess */. asse
2e0f0 72 74 28 20 69 64 78 20 3e 3d 20 65 6e 64 2b 32 rt( idx >= end+2
2e100 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
2e110 69 64 78 2b 73 7a 20 3c 3d 20 28 69 6e 74 29 70 idx+sz <= (int)p
2e120 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
2e130 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 70 50 61 eSize );. pPa
2e140 67 65 2d 3e 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 20 ge->nCell++;.
2e150 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 20 2d 3d pPage->nFree -=
2e160 20 28 75 31 36 29 28 32 20 2b 20 73 7a 29 3b 0a (u16)(2 + sz);.
2e170 20 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 memcpy(&data
2e180 5b 69 64 78 2b 6e 53 6b 69 70 5d 2c 20 70 43 65 [idx+nSkip], pCe
2e190 6c 6c 2b 6e 53 6b 69 70 2c 20 73 7a 2d 6e 53 6b ll+nSkip, sz-nSk
2e1a0 69 70 29 3b 0a 20 20 20 20 69 66 28 20 69 43 68 ip);. if( iCh
2e1b0 69 6c 64 20 29 7b 0a 20 20 20 20 20 20 70 75 74 ild ){. put
2e1c0 34 62 79 74 65 28 26 64 61 74 61 5b 69 64 78 5d 4byte(&data[idx]
2e1d0 2c 20 69 43 68 69 6c 64 29 3b 0a 20 20 20 20 7d , iChild);. }
2e1e0 0a 20 20 20 20 70 74 72 20 3d 20 26 64 61 74 61 . ptr = &data
2e1f0 5b 65 6e 64 5d 3b 0a 20 20 20 20 65 6e 64 50 74 [end];. endPt
2e200 72 20 3d 20 26 64 61 74 61 5b 69 6e 73 5d 3b 0a r = &data[ins];.
2e210 20 20 20 20 61 73 73 65 72 74 28 20 28 53 51 4c assert( (SQL
2e220 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 ITE_PTR_TO_INT(p
2e230 74 72 29 26 31 29 3d 3d 30 20 29 3b 20 20 2f 2a tr)&1)==0 ); /*
2e240 20 70 74 72 20 69 73 20 61 6c 77 61 79 73 20 32 ptr is always 2
2e250 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 20 2a 2f -byte aligned */
2e260 0a 20 20 20 20 77 68 69 6c 65 28 20 70 74 72 3e . while( ptr>
2e270 65 6e 64 50 74 72 20 29 7b 0a 20 20 20 20 20 20 endPtr ){.
2e280 2a 28 75 31 36 2a 29 70 74 72 20 3d 20 2a 28 75 *(u16*)ptr = *(u
2e290 31 36 2a 29 26 70 74 72 5b 2d 32 5d 3b 0a 20 20 16*)&ptr[-2];.
2e2a0 20 20 20 20 70 74 72 20 2d 3d 20 32 3b 0a 20 20 ptr -= 2;.
2e2b0 20 20 7d 0a 20 20 20 20 70 75 74 32 62 79 74 65 }. put2byte
2e2c0 28 26 64 61 74 61 5b 69 6e 73 5d 2c 20 69 64 78 (&data[ins], idx
2e2d0 29 3b 0a 20 20 20 20 70 75 74 32 62 79 74 65 28 );. put2byte(
2e2e0 26 64 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 72 &data[pPage->hdr
2e2f0 4f 66 66 73 65 74 2b 33 5d 2c 20 70 50 61 67 65 Offset+3], pPage
2e300 2d 3e 6e 43 65 6c 6c 29 3b 0a 23 69 66 6e 64 65 ->nCell);.#ifnde
2e310 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
2e320 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 69 66 28 TOVACUUM. if(
2e330 20 70 50 61 67 65 2d 3e 70 42 74 2d 3e 61 75 74 pPage->pBt->aut
2e340 6f 56 61 63 75 75 6d 20 29 7b 0a 20 20 20 20 20 oVacuum ){.
2e350 20 2f 2a 20 54 68 65 20 63 65 6c 6c 20 6d 61 79 /* The cell may
2e360 20 63 6f 6e 74 61 69 6e 20 61 20 70 6f 69 6e 74 contain a point
2e370 65 72 20 74 6f 20 61 6e 20 6f 76 65 72 66 6c 6f er to an overflo
2e380 77 20 70 61 67 65 2e 20 49 66 20 73 6f 2c 20 77 w page. If so, w
2e390 72 69 74 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 rite. ** th
2e3a0 65 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 e entry for the
2e3b0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 20 69 6e overflow page in
2e3c0 74 6f 20 74 68 65 20 70 6f 69 6e 74 65 72 20 6d to the pointer m
2e3d0 61 70 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ap.. */.
2e3e0 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 66 6c ptrmapPutOvfl
2e3f0 50 74 72 28 70 50 61 67 65 2c 20 70 43 65 6c 6c Ptr(pPage, pCell
2e400 2c 20 70 52 43 29 3b 0a 20 20 20 20 7d 0a 23 65 , pRC);. }.#e
2e410 6e 64 69 66 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a ndif. }.}../*.*
2e420 2a 20 41 64 64 20 61 20 6c 69 73 74 20 6f 66 20 * Add a list of
2e430 63 65 6c 6c 73 20 74 6f 20 61 20 70 61 67 65 2e cells to a page.
2e440 20 20 54 68 65 20 70 61 67 65 20 73 68 6f 75 6c The page shoul
2e450 64 20 62 65 20 69 6e 69 74 69 61 6c 6c 79 20 65 d be initially e
2e460 6d 70 74 79 2e 0a 2a 2a 20 54 68 65 20 63 65 6c mpty..** The cel
2e470 6c 73 20 61 72 65 20 67 75 61 72 61 6e 74 65 65 ls are guarantee
2e480 64 20 74 6f 20 66 69 74 20 6f 6e 20 74 68 65 20 d to fit on the
2e490 70 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 page..*/.static
2e4a0 76 6f 69 64 20 61 73 73 65 6d 62 6c 65 50 61 67 void assemblePag
2e4b0 65 28 0a 20 20 4d 65 6d 50 61 67 65 20 2a 70 50 e(. MemPage *pP
2e4c0 61 67 65 2c 20 20 20 2f 2a 20 54 68 65 20 70 61 age, /* The pa
2e4d0 67 65 20 74 6f 20 62 65 20 61 73 73 65 6d 62 6c ge to be assembl
2e4e0 69 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 65 ied */. int nCe
2e4f0 6c 6c 2c 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ll, /* Th
2e500 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 65 6c 6c e number of cell
2e510 73 20 74 6f 20 61 64 64 20 74 6f 20 74 68 69 73 s to add to this
2e520 20 70 61 67 65 20 2a 2f 0a 20 20 75 38 20 2a 2a page */. u8 **
2e530 61 70 43 65 6c 6c 2c 20 20 20 20 20 20 2f 2a 20 apCell, /*
2e540 50 6f 69 6e 74 65 72 73 20 74 6f 20 63 65 6c 6c Pointers to cell
2e550 20 62 6f 64 69 65 73 20 2a 2f 0a 20 20 75 31 36 bodies */. u16
2e560 20 2a 61 53 69 7a 65 20 20 20 20 20 20 20 20 2f *aSize /
2e570 2a 20 53 69 7a 65 73 20 6f 66 20 74 68 65 20 63 * Sizes of the c
2e580 65 6c 6c 73 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ells */.){. int
2e590 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f i; /
2e5a0 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
2e5b0 2f 0a 20 20 75 38 20 2a 70 43 65 6c 6c 70 74 72 /. u8 *pCellptr
2e5c0 3b 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 ; /* Address
2e5d0 20 6f 66 20 6e 65 78 74 20 63 65 6c 6c 20 70 6f of next cell po
2e5e0 69 6e 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 63 inter */. int c
2e5f0 65 6c 6c 62 6f 64 79 3b 20 20 20 20 20 2f 2a 20 ellbody; /*
2e600 41 64 64 72 65 73 73 20 6f 66 20 6e 65 78 74 20 Address of next
2e610 63 65 6c 6c 20 62 6f 64 79 20 2a 2f 0a 20 20 75 cell body */. u
2e620 38 20 2a 20 63 6f 6e 73 74 20 64 61 74 61 20 3d 8 * const data =
2e630 20 70 50 61 67 65 2d 3e 61 44 61 74 61 3b 20 20 pPage->aData;
2e640 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
2e650 69 6e 74 65 72 20 74 6f 20 64 61 74 61 20 66 6f inter to data fo
2e660 72 20 70 50 61 67 65 20 2a 2f 0a 20 20 63 6f 6e r pPage */. con
2e670 73 74 20 69 6e 74 20 68 64 72 20 3d 20 70 50 61 st int hdr = pPa
2e680 67 65 2d 3e 68 64 72 4f 66 66 73 65 74 3b 20 20 ge->hdrOffset;
2e690 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
2e6a0 65 74 20 6f 66 20 68 65 61 64 65 72 20 6f 6e 20 et of header on
2e6b0 70 50 61 67 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 pPage */. const
2e6c0 20 69 6e 74 20 6e 55 73 61 62 6c 65 20 3d 20 70 int nUsable = p
2e6d0 50 61 67 65 2d 3e 70 42 74 2d 3e 75 73 61 62 6c Page->pBt->usabl
2e6e0 65 53 69 7a 65 3b 20 2f 2a 20 55 73 61 62 6c 65 eSize; /* Usable
2e6f0 20 73 69 7a 65 20 6f 66 20 70 61 67 65 20 2a 2f size of page */
2e700 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 .. assert( pPag
2e710 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 e->nOverflow==0
2e720 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
2e730 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
2e740 70 50 61 67 65 2d 3e 70 42 74 2d 3e 6d 75 74 65 pPage->pBt->mute
2e750 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
2e760 6e 43 65 6c 6c 3e 3d 30 20 26 26 20 6e 43 65 6c nCell>=0 && nCel
2e770 6c 3c 3d 28 69 6e 74 29 4d 58 5f 43 45 4c 4c 28 l<=(int)MX_CELL(
2e780 70 50 61 67 65 2d 3e 70 42 74 29 0a 20 20 20 20 pPage->pBt).
2e790 20 20 20 20 20 20 20 20 26 26 20 28 69 6e 74 29 && (int)
2e7a0 4d 58 5f 43 45 4c 4c 28 70 50 61 67 65 2d 3e 70 MX_CELL(pPage->p
2e7b0 42 74 29 3c 3d 31 30 39 32 31 29 3b 0a 20 20 61 Bt)<=10921);. a
2e7c0 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 ssert( sqlite3Pa
2e7d0 67 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 gerIswriteable(p
2e7e0 50 61 67 65 2d 3e 70 44 62 50 61 67 65 29 20 29 Page->pDbPage) )
2e7f0 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 68 ;.. /* Check th
2e800 61 74 20 74 68 65 20 70 61 67 65 20 68 61 73 20 at the page has
2e810 6a 75 73 74 20 62 65 65 6e 20 7a 65 72 6f 65 64 just been zeroed
2e820 20 62 79 20 7a 65 72 6f 50 61 67 65 28 29 20 2a by zeroPage() *
2e830 2f 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 /. assert( pPag
2e840 65 2d 3e 6e 43 65 6c 6c 3d 3d 30 20 29 3b 0a 20 e->nCell==0 );.
2e850 20 61 73 73 65 72 74 28 20 67 65 74 32 62 79 74 assert( get2byt
2e860 65 4e 6f 74 5a 65 72 6f 28 26 64 61 74 61 5b 68 eNotZero(&data[h
2e870 64 72 2b 35 5d 29 3d 3d 6e 55 73 61 62 6c 65 20 dr+5])==nUsable
2e880 29 3b 0a 0a 20 20 70 43 65 6c 6c 70 74 72 20 3d );.. pCellptr =
2e890 20 26 70 50 61 67 65 2d 3e 61 43 65 6c 6c 49 64 &pPage->aCellId
2e8a0 78 5b 6e 43 65 6c 6c 2a 32 5d 3b 0a 20 20 63 65 x[nCell*2];. ce
2e8b0 6c 6c 62 6f 64 79 20 3d 20 6e 55 73 61 62 6c 65 llbody = nUsable
2e8c0 3b 0a 20 20 66 6f 72 28 69 3d 6e 43 65 6c 6c 2d ;. for(i=nCell-
2e8d0 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 1; i>=0; i--){.
2e8e0 20 20 20 75 31 36 20 73 7a 20 3d 20 61 53 69 7a u16 sz = aSiz
2e8f0 65 5b 69 5d 3b 0a 20 20 20 20 70 43 65 6c 6c 70 e[i];. pCellp
2e900 74 72 20 2d 3d 20 32 3b 0a 20 20 20 20 63 65 6c tr -= 2;. cel
2e910 6c 62 6f 64 79 20 2d 3d 20 73 7a 3b 0a 20 20 20 lbody -= sz;.
2e920 20 70 75 74 32 62 79 74 65 28 70 43 65 6c 6c 70 put2byte(pCellp
2e930 74 72 2c 20 63 65 6c 6c 62 6f 64 79 29 3b 0a 20 tr, cellbody);.
2e940 20 20 20 6d 65 6d 63 70 79 28 26 64 61 74 61 5b memcpy(&data[
2e950 63 65 6c 6c 62 6f 64 79 5d 2c 20 61 70 43 65 6c cellbody], apCel
2e960 6c 5b 69 5d 2c 20 73 7a 29 3b 0a 20 20 7d 0a 20 l[i], sz);. }.
2e970 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 5b put2byte(&data[
2e980 68 64 72 2b 33 5d 2c 20 6e 43 65 6c 6c 29 3b 0a hdr+3], nCell);.
2e990 20 20 70 75 74 32 62 79 74 65 28 26 64 61 74 61 put2byte(&data
2e9a0 5b 68 64 72 2b 35 5d 2c 20 63 65 6c 6c 62 6f 64 [hdr+5], cellbod
2e9b0 79 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e 46 72 y);. pPage->nFr
2e9c0 65 65 20 2d 3d 20 28 6e 43 65 6c 6c 2a 32 20 2b ee -= (nCell*2 +
2e9d0 20 6e 55 73 61 62 6c 65 20 2d 20 63 65 6c 6c 62 nUsable - cellb
2e9e0 6f 64 79 29 3b 0a 20 20 70 50 61 67 65 2d 3e 6e ody);. pPage->n
2e9f0 43 65 6c 6c 20 3d 20 28 75 31 36 29 6e 43 65 6c Cell = (u16)nCel
2ea00 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 l;.}../*.** The
2ea10 66 6f 6c 6c 6f 77 69 6e 67 20 70 61 72 61 6d 65 following parame
2ea20 74 65 72 73 20 64 65 74 65 72 6d 69 6e 65 20 68 ters determine h
2ea30 6f 77 20 6d 61 6e 79 20 61 64 6a 61 63 65 6e 74 ow many adjacent
2ea40 20 70 61 67 65 73 20 67 65 74 20 69 6e 76 6f 6c pages get invol
2ea50 76 65 64 0a 2a 2a 20 69 6e 20 61 20 62 61 6c 61 ved.** in a bala
2ea60 6e 63 69 6e 67 20 6f 70 65 72 61 74 69 6f 6e 2e ncing operation.
2ea70 20 20 4e 4e 20 69 73 20 74 68 65 20 6e 75 6d 62 NN is the numb
2ea80 65 72 20 6f 66 20 6e 65 69 67 68 62 6f 72 73 20 er of neighbors
2ea90 6f 6e 20 65 69 74 68 65 72 20 73 69 64 65 0a 2a on either side.*
2eaa0 2a 20 6f 66 20 74 68 65 20 70 61 67 65 20 74 68 * of the page th
2eab0 61 74 20 70 61 72 74 69 63 69 70 61 74 65 20 69 at participate i
2eac0 6e 20 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 20 n the balancing
2ead0 6f 70 65 72 61 74 69 6f 6e 2e 20 20 4e 42 20 69 operation. NB i
2eae0 73 20 74 68 65 0a 2a 2a 20 74 6f 74 61 6c 20 6e s the.** total n
2eaf0 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 umber of pages t
2eb00 68 61 74 20 70 61 72 74 69 63 69 70 61 74 65 2c hat participate,
2eb10 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 74 including the t
2eb20 61 72 67 65 74 20 70 61 67 65 20 61 6e 64 0a 2a arget page and.*
2eb30 2a 20 4e 4e 20 6e 65 69 67 68 62 6f 72 73 20 6f * NN neighbors o
2eb40 6e 20 65 69 74 68 65 72 20 73 69 64 65 2e 0a 2a n either side..*
2eb50 2a 0a 2a 2a 20 54 68 65 20 6d 69 6e 69 6d 75 6d *.** The minimum
2eb60 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 69 73 20 value of NN is
2eb70 31 20 28 6f 66 20 63 6f 75 72 73 65 29 2e 20 20 1 (of course).
2eb80 49 6e 63 72 65 61 73 69 6e 67 20 4e 4e 20 61 62 Increasing NN ab
2eb90 6f 76 65 20 31 0a 2a 2a 20 28 74 6f 20 32 20 6f ove 1.** (to 2 o
2eba0 72 20 33 29 20 67 69 76 65 73 20 61 20 6d 6f 64 r 3) gives a mod
2ebb0 65 73 74 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20 est improvement
2ebc0 69 6e 20 53 45 4c 45 43 54 20 61 6e 64 20 44 45 in SELECT and DE
2ebd0 4c 45 54 45 20 70 65 72 66 6f 72 6d 61 6e 63 65 LETE performance
2ebe0 0a 2a 2a 20 69 6e 20 65 78 63 68 61 6e 67 65 20 .** in exchange
2ebf0 66 6f 72 20 61 20 6c 61 72 67 65 72 20 64 65 67 for a larger deg
2ec00 72 61 64 61 74 69 6f 6e 20 69 6e 20 49 4e 53 45 radation in INSE
2ec10 52 54 20 61 6e 64 20 55 50 44 41 54 45 20 70 65 RT and UPDATE pe
2ec20 72 66 6f 72 6d 61 6e 63 65 2e 0a 2a 2a 20 54 68 rformance..** Th
2ec30 65 20 76 61 6c 75 65 20 6f 66 20 4e 4e 20 61 70 e value of NN ap
2ec40 70 65 61 72 73 20 74 6f 20 67 69 76 65 20 74 68 pears to give th
2ec50 65 20 62 65 73 74 20 72 65 73 75 6c 74 73 20 6f e best results o
2ec60 76 65 72 61 6c 6c 2e 0a 2a 2f 0a 23 64 65 66 69 verall..*/.#defi
2ec70 6e 65 20 4e 4e 20 31 20 20 20 20 20 20 20 20 20 ne NN 1
2ec80 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
2ec90 20 6e 65 69 67 68 62 6f 72 73 20 6f 6e 20 65 69 neighbors on ei
2eca0 74 68 65 72 20 73 69 64 65 20 6f 66 20 70 50 61 ther side of pPa
2ecb0 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 42 ge */.#define NB
2ecc0 20 28 4e 4e 2a 32 2b 31 29 20 20 20 20 20 20 2f (NN*2+1) /
2ecd0 2a 20 54 6f 74 61 6c 20 70 61 67 65 73 20 69 6e * Total pages in
2ece0 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 62 61 volved in the ba
2ecf0 6c 61 6e 63 65 20 2a 2f 0a 0a 0a 23 69 66 6e 64 lance */...#ifnd
2ed00 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 ef SQLITE_OMIT_Q
2ed10 55 49 43 4b 42 41 4c 41 4e 43 45 0a 2f 2a 0a 2a UICKBALANCE./*.*
2ed20 2a 20 54 68 69 73 20 76 65 72 73 69 6f 6e 20 6f * This version o
2ed30 66 20 62 61 6c 61 6e 63 65 28 29 20 68 61 6e 64 f balance() hand
2ed40 6c 65 73 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 73 les the common s
2ed50 70 65 63 69 61 6c 20 63 61 73 65 20 77 68 65 72 pecial case wher
2ed60 65 0a 2a 2a 20 61 20 6e 65 77 20 65 6e 74 72 79 e.** a new entry
2ed70 20 69 73 20 62 65 69 6e 67 20 69 6e 73 65 72 74 is being insert
2ed80 65 64 20 6f 6e 20 74 68 65 20 65 78 74 72 65 6d ed on the extrem
2ed90 65 20 72 69 67 68 74 2d 65 6e 64 20 6f 66 20 74 e right-end of t
2eda0 68 65 0a 2a 2a 20 74 72 65 65 2c 20 69 6e 20 6f he.** tree, in o
2edb0 74 68 65 72 20 77 6f 72 64 73 2c 20 77 68 65 6e ther words, when
2edc0 20 74 68 65 20 6e 65 77 20 65 6e 74 72 79 20 77 the new entry w
2edd0 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 20 6c ill become the l
2ede0 61 72 67 65 73 74 0a 2a 2a 20 65 6e 74 72 79 20 argest.** entry
2edf0 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a 2a 0a in the tree..**.
2ee00 2a 2a 20 49 6e 73 74 65 61 64 20 6f 66 20 74 72 ** Instead of tr
2ee10 79 69 6e 67 20 74 6f 20 62 61 6c 61 6e 63 65 20 ying to balance
2ee20 74 68 65 20 33 20 72 69 67 68 74 2d 6d 6f 73 74 the 3 right-most
2ee30 20 6c 65 61 66 20 70 61 67 65 73 2c 20 6a 75 73 leaf pages, jus
2ee40 74 20 61 64 64 0a 2a 2a 20 61 20 6e 65 77 20 70 t add.** a new p
2ee50 61 67 65 20 74 6f 20 74 68 65 20 72 69 67 68 74 age to the right
2ee60 2d 68 61 6e 64 20 73 69 64 65 20 61 6e 64 20 70 -hand side and p
2ee70 75 74 20 74 68 65 20 6f 6e 65 20 6e 65 77 20 65 ut the one new e
2ee80 6e 74 72 79 20 69 6e 0a 2a 2a 20 74 68 61 74 20 ntry in.** that
2ee90 70 61 67 65 2e 20 20 54 68 69 73 20 6c 65 61 76 page. This leav
2eea0 65 73 20 74 68 65 20 72 69 67 68 74 20 73 69 64 es the right sid
2eeb0 65 20 6f 66 20 74 68 65 20 74 72 65 65 20 73 6f e of the tree so
2eec0 6d 65 77 68 61 74 0a 2a 2a 20 75 6e 62 61 6c 61 mewhat.** unbala
2eed0 6e 63 65 64 2e 20 20 42 75 74 20 6f 64 64 73 20 nced. But odds
2eee0 61 72 65 20 74 68 61 74 20 77 65 20 77 69 6c 6c are that we will
2eef0 20 62 65 20 69 6e 73 65 72 74 69 6e 67 20 6e 65 be inserting ne
2ef00 77 20 65 6e 74 72 69 65 73 0a 2a 2a 20 61 74 20 w entries.** at
2ef10 74 68 65 20 65 6e 64 20 73 6f 6f 6e 20 61 66 74 the end soon aft
2ef20 65 72 77 61 72 64 73 20 73 6f 20 74 68 65 20 6e erwards so the n
2ef30 65 61 72 6c 79 20 65 6d 70 74 79 20 70 61 67 65 early empty page
2ef40 20 77 69 6c 6c 20 71 75 69 63 6b 6c 79 0a 2a 2a will quickly.**
2ef50 20 66 69 6c 6c 20 75 70 2e 20 20 4f 6e 20 61 76 fill up. On av
2ef60 65 72 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 70 50 61 erage..**.** pPa
2ef70 67 65 20 69 73 20 74 68 65 20 6c 65 61 66 20 70 ge is the leaf p
2ef80 61 67 65 20 77 68 69 63 68 20 69 73 20 74 68 65 age which is the
2ef90 20 72 69 67 68 74 2d 6d 6f 73 74 20 70 61 67 65 right-most page
2efa0 20 69 6e 20 74 68 65 20 74 72 65 65 2e 0a 2a 2a in the tree..**
2efb0 20 70 50 61 72 65 6e 74 20 69 73 20 69 74 73 20 pParent is its
2efc0 70 61 72 65 6e 74 2e 20 20 70 50 61 67 65 20 6d parent. pPage m
2efd0 75 73 74 20 68 61 76 65 20 61 20 73 69 6e 67 6c ust have a singl
2efe0 65 20 6f 76 65 72 66 6c 6f 77 20 65 6e 74 72 79 e overflow entry
2eff0 0a 2a 2a 20 77 68 69 63 68 20 69 73 20 61 6c 73 .** which is als
2f000 6f 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 o the right-most
2f010 20 65 6e 74 72 79 20 6f 6e 20 74 68 65 20 70 61 entry on the pa
2f020 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 53 ge..**.** The pS
2f030 70 61 63 65 20 62 75 66 66 65 72 20 69 73 20 75 pace buffer is u
2f040 73 65 64 20 74 6f 20 73 74 6f 72 65 20 61 20 74 sed to store a t
2f050 65 6d 70 6f 72 61 72 79 20 63 6f 70 79 20 6f 66 emporary copy of
2f060 20 74 68 65 20 64 69 76 69 64 65 72 0a 2a 2a 20 the divider.**
2f070 63 65 6c 6c 20 74 68 61 74 20 77 69 6c 6c 20 62 cell that will b
2f080 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 e inserted into
2f090 70 50 61 72 65 6e 74 2e 20 53 75 63 68 20 61 20 pParent. Such a
2f0a0 63 65 6c 6c 20 63 6f 6e 73 69 73 74 73 20 6f 66 cell consists of
2f0b0 20 61 20 34 0a 2a 2a 20 62 79 74 65 20 70 61 67 a 4.** byte pag
2f0c0 65 20 6e 75 6d 62 65 72 20 66 6f 6c 6c 6f 77 65 e number followe
2f0d0 64 20 62 79 20 61 20 76 61 72 69 61 62 6c 65 20 d by a variable
2f0e0 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 2e 20 length integer.
2f0f0 49 6e 20 6f 74 68 65 72 0a 2a 2a 20 77 6f 72 64 In other.** word
2f100 73 2c 20 61 74 20 6d 6f 73 74 20 31 33 20 62 79 s, at most 13 by
2f110 74 65 73 2e 20 48 65 6e 63 65 20 74 68 65 20 70 tes. Hence the p
2f120 53 70 61 63 65 20 62 75 66 66 65 72 20 6d 75 73 Space buffer mus
2f130 74 20 62 65 20 61 74 0a 2a 2a 20 6c 65 61 73 74 t be at.** least
2f140 20 31 33 20 62 79 74 65 73 20 69 6e 20 73 69 7a 13 bytes in siz
2f150 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
2f160 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b 28 4d balance_quick(M
2f170 65 6d 50 61 67 65 20 2a 70 50 61 72 65 6e 74 2c emPage *pParent,
2f180 20 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 2c MemPage *pPage,
2f190 20 75 38 20 2a 70 53 70 61 63 65 29 7b 0a 20 20 u8 *pSpace){.
2f1a0 42 74 53 68 61 72 65 64 20 2a 63 6f 6e 73 74 20 BtShared *const
2f1b0 70 42 74 20 3d 20 70 50 61 67 65 2d 3e 70 42 74 pBt = pPage->pBt
2f1c0 3b 20 20 20 20 2f 2a 20 42 2d 54 72 65 65 20 44 ; /* B-Tree D
2f1d0 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 4d 65 6d atabase */. Mem
2f1e0 50 61 67 65 20 2a 70 4e 65 77 3b 20 20 20 20 20 Page *pNew;
2f1f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f200 20 20 2f 2a 20 4e 65 77 6c 79 20 61 6c 6c 6f 63 /* Newly alloc
2f210 61 74 65 64 20 70 61 67 65 20 2a 2f 0a 20 20 69 ated page */. i
2f220 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
2f230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f240 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 43 6f /* Return Co
2f250 64 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e de */. Pgno pgn
2f260 6f 4e 65 77 3b 20 20 20 20 20 20 20 20 20 20 20 oNew;
2f270 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2f280 50 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 Page number of p
2f290 4e 65 77 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 New */.. assert
2f2a0 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
2f2b0 68 65 6c 64 28 70 50 61 67 65 2d 3e 70 42 74 2d held(pPage->pBt-
2f2c0 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 >mutex) );. ass
2f2d0 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 ert( sqlite3Page
2f2e0 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 50 61 rIswriteable(pPa
2f2f0 72 65 6e 74 2d 3e 70 44 62 50 61 67 65 29 20 29 rent->pDbPage) )
2f300 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
2f310 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 31 20 e->nOverflow==1
2f320 29 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 65 72 );.. /* This er
2f330 72 6f 72 20 63 6f 6e 64 69 74 69 6f 6e 20 69 73 ror condition is
2f340 20 6e 6f 77 20 63 61 75 67 68 74 20 70 72 69 6f now caught prio
2f350 72 20 74 6f 20 72 65 61 63 68 69 6e 67 20 74 68 r to reaching th
2f360 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 is function */.
2f370 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 43 65 6c if( pPage->nCel
2f380 6c 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 l<=0 ) return SQ
2f390 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 LITE_CORRUPT_BKP
2f3a0 54 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 T;.. /* Allocat
2f3b0 65 20 61 20 6e 65 77 20 70 61 67 65 2e 20 54 68 e a new page. Th
2f3c0 69 73 20 70 61 67 65 20 77 69 6c 6c 20 62 65 63 is page will bec
2f3d0 6f 6d 65 20 74 68 65 20 72 69 67 68 74 2d 73 69 ome the right-si
2f3e0 62 6c 69 6e 67 20 6f 66 20 0a 20 20 2a 2a 20 70 bling of . ** p
2f3f0 50 61 67 65 2e 20 4d 61 6b 65 20 74 68 65 20 70 Page. Make the p
2f400 61 72 65 6e 74 20 70 61 67 65 20 77 72 69 74 61 arent page writa
2f410 62 6c 65 2c 20 73 6f 20 74 68 61 74 20 74 68 65 ble, so that the
2f420 20 6e 65 77 20 64 69 76 69 64 65 72 20 63 65 6c new divider cel
2f430 6c 0a 20 20 2a 2a 20 6d 61 79 20 62 65 20 69 6e l. ** may be in
2f440 73 65 72 74 65 64 2e 20 49 66 20 62 6f 74 68 20 serted. If both
2f450 74 68 65 73 65 20 6f 70 65 72 61 74 69 6f 6e 73 these operations
2f460 20 61 72 65 20 73 75 63 63 65 73 73 66 75 6c 2c are successful,
2f470 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2f 0a 20 proceed.. */.
2f480 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 74 rc = allocateBt
2f490 72 65 65 50 61 67 65 28 70 42 74 2c 20 26 70 4e reePage(pBt, &pN
2f4a0 65 77 2c 20 26 70 67 6e 6f 4e 65 77 2c 20 30 2c ew, &pgnoNew, 0,
2f4b0 20 30 29 3b 0a 0a 20 20 69 66 28 20 72 63 3d 3d 0);.. if( rc==
2f4c0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 0a 20 20 SQLITE_OK ){..
2f4d0 20 20 75 38 20 2a 70 4f 75 74 20 3d 20 26 70 53 u8 *pOut = &pS
2f4e0 70 61 63 65 5b 34 5d 3b 0a 20 20 20 20 75 38 20 pace[4];. u8
2f4f0 2a 70 43 65 6c 6c 20 3d 20 70 50 61 67 65 2d 3e *pCell = pPage->
2f500 61 70 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 20 75 apOvfl[0];. u
2f510 31 36 20 73 7a 43 65 6c 6c 20 3d 20 63 65 6c 6c 16 szCell = cell
2f520 53 69 7a 65 50 74 72 28 70 50 61 67 65 2c 20 70 SizePtr(pPage, p
2f530 43 65 6c 6c 29 3b 0a 20 20 20 20 75 38 20 2a 70 Cell);. u8 *p
2f540 53 74 6f 70 3b 0a 0a 20 20 20 20 61 73 73 65 72 Stop;.. asser
2f550 74 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 t( sqlite3PagerI
2f560 73 77 72 69 74 65 61 62 6c 65 28 70 4e 65 77 2d swriteable(pNew-
2f570 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 20 >pDbPage) );.
2f580 20 61 73 73 65 72 74 28 20 70 50 61 67 65 2d 3e assert( pPage->
2f590 61 44 61 74 61 5b 30 5d 3d 3d 28 50 54 46 5f 49 aData[0]==(PTF_I
2f5a0 4e 54 4b 45 59 7c 50 54 46 5f 4c 45 41 46 44 41 NTKEY|PTF_LEAFDA
2f5b0 54 41 7c 50 54 46 5f 4c 45 41 46 29 20 29 3b 0a TA|PTF_LEAF) );.
2f5c0 20 20 20 20 7a 65 72 6f 50 61 67 65 28 70 4e 65 zeroPage(pNe
2f5d0 77 2c 20 50 54 46 5f 49 4e 54 4b 45 59 7c 50 54 w, PTF_INTKEY|PT
2f5e0 46 5f 4c 45 41 46 44 41 54 41 7c 50 54 46 5f 4c F_LEAFDATA|PTF_L
2f5f0 45 41 46 29 3b 0a 20 20 20 20 61 73 73 65 6d 62 EAF);. assemb
2f600 6c 65 50 61 67 65 28 70 4e 65 77 2c 20 31 2c 20 lePage(pNew, 1,
2f610 26 70 43 65 6c 6c 2c 20 26 73 7a 43 65 6c 6c 29 &pCell, &szCell)
2f620 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 ;.. /* If thi
2f630 73 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 63 s is an auto-vac
2f640 75 75 6d 20 64 61 74 61 62 61 73 65 2c 20 75 70 uum database, up
2f650 64 61 74 65 20 74 68 65 20 70 6f 69 6e 74 65 72 date the pointer
2f660 20 6d 61 70 0a 20 20 20 20 2a 2a 20 77 69 74 68 map. ** with
2f670 20 65 6e 74 72 69 65 73 20 66 6f 72 20 74 68 65 entries for the
2f680 20 6e 65 77 20 70 61 67 65 2c 20 61 6e 64 20 61 new page, and a
2f690 6e 79 20 70 6f 69 6e 74 65 72 20 66 72 6f 6d 20 ny pointer from
2f6a0 74 68 65 20 0a 20 20 20 20 2a 2a 20 63 65 6c 6c the . ** cell
2f6b0 20 6f 6e 20 74 68 65 20 70 61 67 65 20 74 6f 20 on the page to
2f6c0 61 6e 20 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 an overflow page
2f6d0 2e 20 49 66 20 65 69 74 68 65 72 20 6f 66 20 74 . If either of t
2f6e0 68 65 73 65 0a 20 20 20 20 2a 2a 20 6f 70 65 72 hese. ** oper
2f6f0 61 74 69 6f 6e 73 20 66 61 69 6c 73 2c 20 74 68 ations fails, th
2f700 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69 73 e return code is
2f710 20 73 65 74 2c 20 62 75 74 20 74 68 65 20 63 6f set, but the co
2f720 6e 74 65 6e 74 73 0a 20 20 20 20 2a 2a 20 6f 66 ntents. ** of
2f730 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 the parent page
2f740 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 6e 69 70 are still manip
2f750 75 6c 61 74 65 64 20 62 79 20 74 68 68 20 63 6f ulated by thh co
2f760 64 65 20 62 65 6c 6f 77 2e 0a 20 20 20 20 2a 2a de below.. **
2f770 20 54 68 61 74 20 69 73 20 4f 6b 2c 20 61 74 20 That is Ok, at
2f780 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 20 70 this point the p
2f790 61 72 65 6e 74 20 70 61 67 65 20 69 73 20 67 75 arent page is gu
2f7a0 61 72 61 6e 74 65 65 64 20 74 6f 0a 20 20 20 20 aranteed to.
2f7b0 2a 2a 20 62 65 20 6d 61 72 6b 65 64 20 61 73 20 ** be marked as
2f7c0 64 69 72 74 79 2e 20 52 65 74 75 72 6e 69 6e 67 dirty. Returning
2f7d0 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 77 an error code w
2f7e0 69 6c 6c 20 63 61 75 73 65 20 61 0a 20 20 20 20 ill cause a.
2f7f0 2a 2a 20 72 6f 6c 6c 62 61 63 6b 2c 20 75 6e 64 ** rollback, und
2f800 6f 69 6e 67 20 61 6e 79 20 63 68 61 6e 67 65 73 oing any changes
2f810 20 6d 61 64 65 20 74 6f 20 74 68 65 20 70 61 72 made to the par
2f820 65 6e 74 20 70 61 67 65 2e 0a 20 20 20 20 2a 2f ent page.. */
2f830 0a 20 20 20 20 69 66 28 20 49 53 41 55 54 4f 56 . if( ISAUTOV
2f840 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 20 20 70 ACUUM ){. p
2f850 74 72 6d 61 70 50 75 74 28 70 42 74 2c 20 70 67 trmapPut(pBt, pg
2f860 6e 6f 4e 65 77 2c 20 50 54 52 4d 41 50 5f 42 54 noNew, PTRMAP_BT
2f870 52 45 45 2c 20 70 50 61 72 65 6e 74 2d 3e 70 67 REE, pParent->pg
2f880 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 no, &rc);.
2f890 69 66 28 20 73 7a 43 65 6c 6c 3e 70 4e 65 77 2d if( szCell>pNew-
2f8a0 3e 6d 69 6e 4c 6f 63 61 6c 20 29 7b 0a 20 20 20 >minLocal ){.
2f8b0 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 4f 76 ptrmapPutOv
2f8c0 66 6c 50 74 72 28 70 4e 65 77 2c 20 70 43 65 6c flPtr(pNew, pCel
2f8d0 6c 2c 20 26 72 63 29 3b 0a 20 20 20 20 20 20 7d l, &rc);. }
2f8e0 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a . }. . /*
2f8f0 20 43 72 65 61 74 65 20 61 20 64 69 76 69 64 65 Create a divide
2f900 72 20 63 65 6c 6c 20 74 6f 20 69 6e 73 65 72 74 r cell to insert
2f910 20 69 6e 74 6f 20 70 50 61 72 65 6e 74 2e 20 54 into pParent. T
2f920 68 65 20 64 69 76 69 64 65 72 20 63 65 6c 6c 0a he divider cell.
2f930 20 20 20 20 2a 2a 20 63 6f 6e 73 69 73 74 73 20 ** consists
2f940 6f 66 20 61 20 34 2d 62 79 74 65 20 70 61 67 65 of a 4-byte page
2f950 20 6e 75 6d 62 65 72 20 28 74 68 65 20 70 61 67 number (the pag
2f960 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 50 61 67 e number of pPag
2f970 65 29 20 61 6e 64 0a 20 20 20 20 2a 2a 20 61 20 e) and. ** a
2f980 76 61 72 69 61 62 6c 65 20 6c 65 6e 67 74 68 20 variable length
2f990 6b 65 79 20 76 61 6c 75 65 20 28 77 68 69 63 68 key value (which
2f9a0 20 6d 75 73 74 20 62 65 20 74 68 65 20 73 61 6d must be the sam
2f9b0 65 20 76 61 6c 75 65 20 61 73 20 74 68 65 0a 20 e value as the.
2f9c0 20 20 20 2a 2a 20 6c 61 72 67 65 73 74 20 6b 65 ** largest ke
2f9d0 79 20 6f 6e 20 70 50 61 67 65 29 2e 0a 20 20 20 y on pPage)..
2f9e0 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 6f 20 66 69 **. ** To fi
2f9f0 6e 64 20 74 68 65 20 6c 61 72 67 65 73 74 20 6b nd the largest k
2fa00 65 79 20 76 61 6c 75 65 20 6f 6e 20 70 50 61 67 ey value on pPag
2fa10 65 2c 20 66 69 72 73 74 20 66 69 6e 64 20 74 68 e, first find th
2fa20 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 0a 20 20 e right-most .
2fa30 20 20 2a 2a 20 63 65 6c 6c 20 6f 6e 20 70 50 61 ** cell on pPa
2fa40 67 65 2e 20 54 68 65 20 66 69 72 73 74 20 74 77 ge. The first tw
2fa50 6f 20 66 69 65 6c 64 73 20 6f 66 20 74 68 69 73 o fields of this
2fa60 20 63 65 6c 6c 20 61 72 65 20 74 68 65 20 0a 20 cell are the .
2fa70 20 20 20 2a 2a 20 72 65 63 6f 72 64 2d 6c 65 6e ** record-len
2fa80 67 74 68 20 28 61 20 76 61 72 69 61 62 6c 65 20 gth (a variable
2fa90 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 20 61 length integer a
2faa0 74 20 6d 6f 73 74 20 33 32 2d 62 69 74 73 20 69 t most 32-bits i
2fab0 6e 20 73 69 7a 65 29 0a 20 20 20 20 2a 2a 20 61 n size). ** a
2fac0 6e 64 20 74 68 65 20 6b 65 79 20 76 61 6c 75 65 nd the key value
2fad0 20 28 61 20 76 61 72 69 61 62 6c 65 20 6c 65 6e (a variable len
2fae0 67 74 68 20 69 6e 74 65 67 65 72 2c 20 6d 61 79 gth integer, may
2faf0 20 68 61 76 65 20 61 6e 79 20 76 61 6c 75 65 29 have any value)
2fb00 2e 0a 20 20 20 20 2a 2a 20 54 68 65 20 66 69 72 .. ** The fir
2fb10 73 74 20 6f 66 20 74 68 65 20 77 68 69 6c 65 28 st of the while(
2fb20 2e 2e 2e 29 20 6c 6f 6f 70 73 20 62 65 6c 6f 77 ...) loops below
2fb30 20 73 6b 69 70 73 20 6f 76 65 72 20 74 68 65 20 skips over the
2fb40 72 65 63 6f 72 64 2d 6c 65 6e 67 74 68 0a 20 20 record-length.
2fb50 20 20 2a 2a 20 66 69 65 6c 64 2e 20 54 68 65 20 ** field. The
2fb60 73 65 63 6f 6e 64 20 77 68 69 6c 65 28 2e 2e 2e second while(...
2fb70 29 20 6c 6f 6f 70 20 63 6f 70 69 65 73 20 74 68 ) loop copies th
2fb80 65 20 6b 65 79 20 76 61 6c 75 65 20 66 72 6f 6d e key value from
2fb90 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 65 6c 6c the. ** cell
2fba0 20 6f 6e 20 70 50 61 67 65 20 69 6e 74 6f 20 74 on pPage into t
2fbb0 68 65 20 70 53 70 61 63 65 20 62 75 66 66 65 72 he pSpace buffer
2fbc0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 43 65 .. */. pCe
2fbd0 6c 6c 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 ll = findCell(pP
2fbe0 61 67 65 2c 20 70 50 61 67 65 2d 3e 6e 43 65 6c age, pPage->nCel
2fbf0 6c 2d 31 29 3b 0a 20 20 20 20 70 53 74 6f 70 20 l-1);. pStop
2fc00 3d 20 26 70 43 65 6c 6c 5b 39 5d 3b 0a 20 20 20 = &pCell[9];.
2fc10 20 77 68 69 6c 65 28 20 28 2a 28 70 43 65 6c 6c while( (*(pCell
2fc20 2b 2b 29 26 30 78 38 30 29 20 26 26 20 70 43 65 ++)&0x80) && pCe
2fc30 6c 6c 3c 70 53 74 6f 70 20 29 3b 0a 20 20 20 20 ll<pStop );.
2fc40 70 53 74 6f 70 20 3d 20 26 70 43 65 6c 6c 5b 39 pStop = &pCell[9
2fc50 5d 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 28 28 ];. while( ((
2fc60 2a 28 70 4f 75 74 2b 2b 29 20 3d 20 2a 28 70 43 *(pOut++) = *(pC
2fc70 65 6c 6c 2b 2b 29 29 26 30 78 38 30 29 20 26 26 ell++))&0x80) &&
2fc80 20 70 43 65 6c 6c 3c 70 53 74 6f 70 20 29 3b 0a pCell<pStop );.
2fc90 0a 20 20 20 20 2f 2a 20 49 6e 73 65 72 74 20 74 . /* Insert t
2fca0 68 65 20 6e 65 77 20 64 69 76 69 64 65 72 20 63 he new divider c
2fcb0 65 6c 6c 20 69 6e 74 6f 20 70 50 61 72 65 6e 74 ell into pParent
2fcc0 2e 20 2a 2f 0a 20 20 20 20 69 6e 73 65 72 74 43 . */. insertC
2fcd0 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 70 50 61 ell(pParent, pPa
2fce0 72 65 6e 74 2d 3e 6e 43 65 6c 6c 2c 20 70 53 70 rent->nCell, pSp
2fcf0 61 63 65 2c 20 28 69 6e 74 29 28 70 4f 75 74 2d ace, (int)(pOut-
2fd00 70 53 70 61 63 65 29 2c 0a 20 20 20 20 20 20 20 pSpace),.
2fd10 20 20 20 20 20 20 20 20 30 2c 20 70 50 61 67 65 0, pPage
2fd20 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 0a 20 ->pgno, &rc);..
2fd30 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 72 69 /* Set the ri
2fd40 67 68 74 2d 63 68 69 6c 64 20 70 6f 69 6e 74 65 ght-child pointe
2fd50 72 20 6f 66 20 70 50 61 72 65 6e 74 20 74 6f 20 r of pParent to
2fd60 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 6e 65 77 point to the new
2fd70 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 70 75 page. */. pu
2fd80 74 34 62 79 74 65 28 26 70 50 61 72 65 6e 74 2d t4byte(&pParent-
2fd90 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d 3e >aData[pParent->
2fda0 68 64 72 4f 66 66 73 65 74 2b 38 5d 2c 20 70 67 hdrOffset+8], pg
2fdb0 6e 6f 4e 65 77 29 3b 0a 20 20 0a 20 20 20 20 2f noNew);. . /
2fdc0 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20 72 65 * Release the re
2fdd0 66 65 72 65 6e 63 65 20 74 6f 20 74 68 65 20 6e ference to the n
2fde0 65 77 20 70 61 67 65 2e 20 2a 2f 0a 20 20 20 20 ew page. */.
2fdf0 72 65 6c 65 61 73 65 50 61 67 65 28 70 4e 65 77 releasePage(pNew
2fe00 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e );. }.. return
2fe10 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a rc;.}.#endif /*
2fe20 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 51 55 49 SQLITE_OMIT_QUI
2fe30 43 4b 42 41 4c 41 4e 43 45 20 2a 2f 0a 0a 23 69 CKBALANCE */..#i
2fe40 66 20 30 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 f 0./*.** This f
2fe50 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 unction does not
2fe60 20 63 6f 6e 74 72 69 62 75 74 65 20 61 6e 79 74 contribute anyt
2fe70 68 69 6e 67 20 74 6f 20 74 68 65 20 6f 70 65 72 hing to the oper
2fe80 61 74 69 6f 6e 20 6f 66 20 53 51 4c 69 74 65 2e ation of SQLite.
2fe90 0a 2a 2a 20 69 74 20 69 73 20 73 6f 6d 65 74 69 .** it is someti
2fea0 6d 65 73 20 61 63 74 69 76 61 74 65 64 20 74 65 mes activated te
2feb0 6d 70 6f 72 61 72 69 6c 79 20 77 68 69 6c 65 20 mporarily while
2fec0 64 65 62 75 67 67 69 6e 67 20 63 6f 64 65 20 72 debugging code r
2fed0 65 73 70 6f 6e 73 69 62 6c 65 20 0a 2a 2a 20 66 esponsible .** f
2fee0 6f 72 20 73 65 74 74 69 6e 67 20 70 6f 69 6e 74 or setting point
2fef0 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 2e 0a er-map entries..
2ff00 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 74 */.static int pt
2ff10 72 6d 61 70 43 68 65 63 6b 50 61 67 65 73 28 4d rmapCheckPages(M
2ff20 65 6d 50 61 67 65 20 2a 2a 61 70 50 61 67 65 2c emPage **apPage,
2ff30 20 69 6e 74 20 6e 50 61 67 65 29 7b 0a 20 20 69 int nPage){. i
2ff40 6e 74 20 69 2c 20 6a 3b 0a 20 20 66 6f 72 28 69 nt i, j;. for(i
2ff50 3d 30 3b 20 69 3c 6e 50 61 67 65 3b 20 69 2b 2b =0; i<nPage; i++
2ff60 29 7b 0a 20 20 20 20 50 67 6e 6f 20 6e 3b 0a 20 ){. Pgno n;.
2ff70 20 20 20 75 38 20 65 3b 0a 20 20 20 20 4d 65 6d u8 e;. Mem
2ff80 50 61 67 65 20 2a 70 50 61 67 65 20 3d 20 61 70 Page *pPage = ap
2ff90 50 61 67 65 5b 69 5d 3b 0a 20 20 20 20 42 74 53 Page[i];. BtS
2ffa0 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 50 61 hared *pBt = pPa
2ffb0 67 65 2d 3e 70 42 74 3b 0a 20 20 20 20 61 73 73 ge->pBt;. ass
2ffc0 65 72 74 28 20 70 50 61 67 65 2d 3e 69 73 49 6e ert( pPage->isIn
2ffd0 69 74 20 29 3b 0a 0a 20 20 20 20 66 6f 72 28 6a it );.. for(j
2ffe0 3d 30 3b 20 6a 3c 70 50 61 67 65 2d 3e 6e 43 65 =0; j<pPage->nCe
2fff0 6c 6c 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 ll; j++){.
30000 43 65 6c 6c 49 6e 66 6f 20 69 6e 66 6f 3b 0a 20 CellInfo info;.
30010 20 20 20 20 20 75 38 20 2a 7a 3b 0a 20 20 20 20 u8 *z;.
30020 20 0a 20 20 20 20 20 20 7a 20 3d 20 66 69 6e 64 . z = find
30030 43 65 6c 6c 28 70 50 61 67 65 2c 20 6a 29 3b 0a Cell(pPage, j);.
30040 20 20 20 20 20 20 62 74 72 65 65 50 61 72 73 65 btreeParse
30050 43 65 6c 6c 50 74 72 28 70 50 61 67 65 2c 20 7a CellPtr(pPage, z
30060 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 20 20 , &info);.
30070 69 66 28 20 69 6e 66 6f 2e 69 4f 76 65 72 66 6c if( info.iOverfl
30080 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 20 50 67 ow ){. Pg
30090 6e 6f 20 6f 76 66 6c 20 3d 20 67 65 74 34 62 79 no ovfl = get4by
300a0 74 65 28 26 7a 5b 69 6e 66 6f 2e 69 4f 76 65 72 te(&z[info.iOver
300b0 66 6c 6f 77 5d 29 3b 0a 20 20 20 20 20 20 20 20 flow]);.
300c0 70 74 72 6d 61 70 47 65 74 28 70 42 74 2c 20 6f ptrmapGet(pBt, o
300d0 76 66 6c 2c 20 26 65 2c 20 26 6e 29 3b 0a 20 20 vfl, &e, &n);.
300e0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6e 3d assert( n=
300f0 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 26 26 20 =pPage->pgno &&
30100 65 3d 3d 50 54 52 4d 41 50 5f 4f 56 45 52 46 4c e==PTRMAP_OVERFL
30110 4f 57 31 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 OW1 );. }.
30120 20 20 20 20 20 69 66 28 20 21 70 50 61 67 65 2d if( !pPage-
30130 3e 6c 65 61 66 20 29 7b 0a 20 20 20 20 20 20 20 >leaf ){.
30140 20 50 67 6e 6f 20 63 68 69 6c 64 20 3d 20 67 65 Pgno child = ge
30150 74 34 62 79 74 65 28 7a 29 3b 0a 20 20 20 20 20 t4byte(z);.
30160 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 ptrmapGet(pBt
30170 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 26 6e 29 , child, &e, &n)
30180 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 ;. assert
30190 28 20 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e 6f ( n==pPage->pgno
301a0 20 26 26 20 65 3d 3d 50 54 52 4d 41 50 5f 42 54 && e==PTRMAP_BT
301b0 52 45 45 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 REE );. }.
301c0 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21 70 50 }. if( !pP
301d0 61 67 65 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 20 age->leaf ){.
301e0 20 20 20 50 67 6e 6f 20 63 68 69 6c 64 20 3d 20 Pgno child =
301f0 67 65 74 34 62 79 74 65 28 26 70 50 61 67 65 2d get4byte(&pPage-
30200 3e 61 44 61 74 61 5b 70 50 61 67 65 2d 3e 68 64 >aData[pPage->hd
30210 72 4f 66 66 73 65 74 2b 38 5d 29 3b 0a 20 20 20 rOffset+8]);.
30220 20 20 20 70 74 72 6d 61 70 47 65 74 28 70 42 74 ptrmapGet(pBt
30230 2c 20 63 68 69 6c 64 2c 20 26 65 2c 20 26 6e 29 , child, &e, &n)
30240 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
30250 6e 3d 3d 70 50 61 67 65 2d 3e 70 67 6e 6f 20 26 n==pPage->pgno &
30260 26 20 65 3d 3d 50 54 52 4d 41 50 5f 42 54 52 45 & e==PTRMAP_BTRE
30270 45 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 E );. }. }.
30280 20 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 23 65 6e return 1;.}.#en
30290 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 dif../*.** This
302a0 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 64 function is used
302b0 20 74 6f 20 63 6f 70 79 20 74 68 65 20 63 6f 6e to copy the con
302c0 74 65 6e 74 73 20 6f 66 20 74 68 65 20 62 2d 74 tents of the b-t
302d0 72 65 65 20 6e 6f 64 65 20 73 74 6f 72 65 64 20 ree node stored
302e0 0a 2a 2a 20 6f 6e 20 70 61 67 65 20 70 46 72 6f .** on page pFro
302f0 6d 20 74 6f 20 70 61 67 65 20 70 54 6f 2e 20 49 m to page pTo. I
30300 66 20 70 61 67 65 20 70 46 72 6f 6d 20 77 61 73 f page pFrom was
30310 20 6e 6f 74 20 61 20 6c 65 61 66 20 70 61 67 65 not a leaf page
30320 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 70 6f , then.** the po
30330 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 inter-map entrie
30340 73 20 66 6f 72 20 65 61 63 68 20 63 68 69 6c 64 s for each child
30350 20 70 61 67 65 20 61 72 65 20 75 70 64 61 74 65 page are update
30360 64 20 73 6f 20 74 68 61 74 20 74 68 65 0a 2a 2a d so that the.**
30370 20 70 61 72 65 6e 74 20 70 61 67 65 20 73 74 6f parent page sto
30380 72 65 64 20 69 6e 20 74 68 65 20 70 6f 69 6e 74 red in the point
30390 65 72 20 6d 61 70 20 69 73 20 70 61 67 65 20 70 er map is page p
303a0 54 6f 2e 20 49 66 20 70 46 72 6f 6d 20 63 6f 6e To. If pFrom con
303b0 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 79 20 63 65 tained.** any ce
303c0 6c 6c 73 20 77 69 74 68 20 6f 76 65 72 66 6c 6f lls with overflo
303d0 77 20 70 61 67 65 20 70 6f 69 6e 74 65 72 73 2c w page pointers,
303e0 20 74 68 65 6e 20 74 68 65 20 63 6f 72 72 65 73 then the corres
303f0 70 6f 6e 64 69 6e 67 20 70 6f 69 6e 74 65 72 0a ponding pointer.
30400 2a 2a 20 6d 61 70 20 65 6e 74 72 69 65 73 20 61 ** map entries a
30410 72 65 20 61 6c 73 6f 20 75 70 64 61 74 65 64 20 re also updated
30420 73 6f 20 74 68 61 74 20 74 68 65 20 70 61 72 65 so that the pare
30430 6e 74 20 70 61 67 65 20 69 73 20 70 61 67 65 20 nt page is page
30440 70 54 6f 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 46 pTo..**.** If pF
30450 72 6f 6d 20 69 73 20 63 75 72 72 65 6e 74 6c 79 rom is currently
30460 20 63 61 72 72 79 69 6e 67 20 61 6e 79 20 6f 76 carrying any ov
30470 65 72 66 6c 6f 77 20 63 65 6c 6c 73 20 28 65 6e erflow cells (en
30480 74 72 69 65 73 20 69 6e 20 74 68 65 0a 2a 2a 20 tries in the.**
30490 4d 65 6d 50 61 67 65 2e 61 70 4f 76 66 6c 5b 5d MemPage.apOvfl[]
304a0 20 61 72 72 61 79 29 2c 20 74 68 65 79 20 61 72 array), they ar
304b0 65 20 6e 6f 74 20 63 6f 70 69 65 64 20 74 6f 20 e not copied to
304c0 70 54 6f 2e 20 0a 2a 2a 0a 2a 2a 20 42 65 66 6f pTo. .**.** Befo
304d0 72 65 20 72 65 74 75 72 6e 69 6e 67 2c 20 70 61 re returning, pa
304e0 67 65 20 70 54 6f 20 69 73 20 72 65 69 6e 69 74 ge pTo is reinit
304f0 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 62 74 ialized using bt
30500 72 65 65 49 6e 69 74 50 61 67 65 28 29 2e 0a 2a reeInitPage()..*
30510 2a 0a 2a 2a 20 54 68 65 20 70 65 72 66 6f 72 6d *.** The perform
30520 61 6e 63 65 20 6f 66 20 74 68 69 73 20 66 75 6e ance of this fun
30530 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 63 72 69 ction is not cri
30540 74 69 63 61 6c 2e 20 49 74 20 69 73 20 6f 6e 6c tical. It is onl
30550 79 20 75 73 65 64 20 62 79 20 0a 2a 2a 20 74 68 y used by .** th
30560 65 20 62 61 6c 61 6e 63 65 5f 73 68 61 6c 6c 6f e balance_shallo
30570 77 65 72 28 29 20 61 6e 64 20 62 61 6c 61 6e 63 wer() and balanc
30580 65 5f 64 65 65 70 65 72 28 29 20 70 72 6f 63 65 e_deeper() proce
30590 64 75 72 65 73 2c 20 6e 65 69 74 68 65 72 20 6f dures, neither o
305a0 66 0a 2a 2a 20 77 68 69 63 68 20 61 72 65 20 63 f.** which are c
305b0 61 6c 6c 65 64 20 6f 66 74 65 6e 20 75 6e 64 65 alled often unde
305c0 72 20 6e 6f 72 6d 61 6c 20 63 69 72 63 75 6d 73 r normal circums
305d0 74 61 6e 63 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 tances..*/.stati
305e0 63 20 76 6f 69 64 20 63 6f 70 79 4e 6f 64 65 43 c void copyNodeC
305f0 6f 6e 74 65 6e 74 28 4d 65 6d 50 61 67 65 20 2a ontent(MemPage *
30600 70 46 72 6f 6d 2c 20 4d 65 6d 50 61 67 65 20 2a pFrom, MemPage *
30610 70 54 6f 2c 20 69 6e 74 20 2a 70 52 43 29 7b 0a pTo, int *pRC){.
30620 20 20 69 66 28 20 28 2a 70 52 43 29 3d 3d 53 51 if( (*pRC)==SQ
30630 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 42 LITE_OK ){. B
30640 74 53 68 61 72 65 64 20 2a 20 63 6f 6e 73 74 20 tShared * const
30650 70 42 74 20 3d 20 70 46 72 6f 6d 2d 3e 70 42 74 pBt = pFrom->pBt
30660 3b 0a 20 20 20 20 75 38 20 2a 20 63 6f 6e 73 74 ;. u8 * const
30670 20 61 46 72 6f 6d 20 3d 20 70 46 72 6f 6d 2d 3e aFrom = pFrom->
30680 61 44 61 74 61 3b 0a 20 20 20 20 75 38 20 2a 20 aData;. u8 *
30690 63 6f 6e 73 74 20 61 54 6f 20 3d 20 70 54 6f 2d const aTo = pTo-
306a0 3e 61 44 61 74 61 3b 0a 20 20 20 20 69 6e 74 20 >aData;. int
306b0 63 6f 6e 73 74 20 69 46 72 6f 6d 48 64 72 20 3d const iFromHdr =
306c0 20 70 46 72 6f 6d 2d 3e 68 64 72 4f 66 66 73 65 pFrom->hdrOffse
306d0 74 3b 0a 20 20 20 20 69 6e 74 20 63 6f 6e 73 74 t;. int const
306e0 20 69 54 6f 48 64 72 20 3d 20 28 28 70 54 6f 2d iToHdr = ((pTo-
306f0 3e 70 67 6e 6f 3d 3d 31 29 20 3f 20 31 30 30 20 >pgno==1) ? 100
30700 3a 20 30 29 3b 0a 20 20 20 20 69 6e 74 20 72 63 : 0);. int rc
30710 3b 0a 20 20 20 20 69 6e 74 20 69 44 61 74 61 3b ;. int iData;
30720 0a 20 20 0a 20 20 0a 20 20 20 20 61 73 73 65 72 . . . asser
30730 74 28 20 70 46 72 6f 6d 2d 3e 69 73 49 6e 69 74 t( pFrom->isInit
30740 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
30750 70 46 72 6f 6d 2d 3e 6e 46 72 65 65 3e 3d 69 54 pFrom->nFree>=iT
30760 6f 48 64 72 20 29 3b 0a 20 20 20 20 61 73 73 65 oHdr );. asse
30770 72 74 28 20 67 65 74 32 62 79 74 65 28 26 61 46 rt( get2byte(&aF
30780 72 6f 6d 5b 69 46 72 6f 6d 48 64 72 2b 35 5d 29 rom[iFromHdr+5])
30790 20 3c 3d 20 28 69 6e 74 29 70 42 74 2d 3e 75 73 <= (int)pBt->us
307a0 61 62 6c 65 53 69 7a 65 20 29 3b 0a 20 20 0a 20 ableSize );. .
307b0 20 20 20 2f 2a 20 43 6f 70 79 20 74 68 65 20 62 /* Copy the b
307c0 2d 74 72 65 65 20 6e 6f 64 65 20 63 6f 6e 74 65 -tree node conte
307d0 6e 74 20 66 72 6f 6d 20 70 61 67 65 20 70 46 72 nt from page pFr
307e0 6f 6d 20 74 6f 20 70 61 67 65 20 70 54 6f 2e 20 om to page pTo.
307f0 2a 2f 0a 20 20 20 20 69 44 61 74 61 20 3d 20 67 */. iData = g
30800 65 74 32 62 79 74 65 28 26 61 46 72 6f 6d 5b 69 et2byte(&aFrom[i
30810 46 72 6f 6d 48 64 72 2b 35 5d 29 3b 0a 20 20 20 FromHdr+5]);.
30820 20 6d 65 6d 63 70 79 28 26 61 54 6f 5b 69 44 61 memcpy(&aTo[iDa
30830 74 61 5d 2c 20 26 61 46 72 6f 6d 5b 69 44 61 74 ta], &aFrom[iDat
30840 61 5d 2c 20 70 42 74 2d 3e 75 73 61 62 6c 65 53 a], pBt->usableS
30850 69 7a 65 2d 69 44 61 74 61 29 3b 0a 20 20 20 20 ize-iData);.
30860 6d 65 6d 63 70 79 28 26 61 54 6f 5b 69 54 6f 48 memcpy(&aTo[iToH
30870 64 72 5d 2c 20 26 61 46 72 6f 6d 5b 69 46 72 6f dr], &aFrom[iFro
30880 6d 48 64 72 5d 2c 20 70 46 72 6f 6d 2d 3e 63 65 mHdr], pFrom->ce
30890 6c 6c 4f 66 66 73 65 74 20 2b 20 32 2a 70 46 72 llOffset + 2*pFr
308a0 6f 6d 2d 3e 6e 43 65 6c 6c 29 3b 0a 20 20 0a 20 om->nCell);. .
308b0 20 20 20 2f 2a 20 52 65 69 6e 69 74 69 61 6c 69 /* Reinitiali
308c0 7a 65 20 70 61 67 65 20 70 54 6f 20 73 6f 20 74 ze page pTo so t
308d0 68 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 hat the contents
308e0 20 6f 66 20 74 68 65 20 4d 65 6d 50 61 67 65 20 of the MemPage
308f0 73 74 72 75 63 74 75 72 65 0a 20 20 20 20 2a 2a structure. **
30900 20 6d 61 74 63 68 20 74 68 65 20 6e 65 77 20 64 match the new d
30910 61 74 61 2e 20 54 68 65 20 69 6e 69 74 69 61 6c ata. The initial
30920 69 7a 61 74 69 6f 6e 20 6f 66 20 70 54 6f 20 63 ization of pTo c
30930 61 6e 20 61 63 74 75 61 6c 6c 79 20 66 61 69 6c an actually fail
30940 20 75 6e 64 65 72 0a 20 20 20 20 2a 2a 20 66 61 under. ** fa
30950 69 72 6c 79 20 6f 62 73 63 75 72 65 20 63 69 72 irly obscure cir
30960 63 75 6d 73 74 61 6e 63 65 73 2c 20 65 76 65 6e cumstances, even
30970 20 74 68 6f 75 67 68 20 69 74 20 69 73 20 61 20 though it is a
30980 63 6f 70 79 20 6f 66 20 69 6e 69 74 69 61 6c 69 copy of initiali
30990 7a 65 64 20 0a 20 20 20 20 2a 2a 20 70 61 67 65 zed . ** page
309a0 20 70 46 72 6f 6d 2e 0a 20 20 20 20 2a 2f 0a 20 pFrom.. */.
309b0 20 20 20 70 54 6f 2d 3e 69 73 49 6e 69 74 20 3d pTo->isInit =
309c0 20 30 3b 0a 20 20 20 20 72 63 20 3d 20 62 74 72 0;. rc = btr
309d0 65 65 49 6e 69 74 50 61 67 65 28 70 54 6f 29 3b eeInitPage(pTo);
309e0 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
309f0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
30a00 2a 70 52 43 20 3d 20 72 63 3b 0a 20 20 20 20 20 *pRC = rc;.
30a10 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 7d 0a 20 return;. }.
30a20 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 . /* If this
30a30 20 69 73 20 61 6e 20 61 75 74 6f 2d 76 61 63 75 is an auto-vacu
30a40 75 6d 20 64 61 74 61 62 61 73 65 2c 20 75 70 64 um database, upd
30a50 61 74 65 20 74 68 65 20 70 6f 69 6e 74 65 72 2d ate the pointer-
30a60 6d 61 70 20 65 6e 74 72 69 65 73 0a 20 20 20 20 map entries.
30a70 2a 2a 20 66 6f 72 20 61 6e 79 20 62 2d 74 72 65 ** for any b-tre
30a80 65 20 6f 72 20 6f 76 65 72 66 6c 6f 77 20 70 61 e or overflow pa
30a90 67 65 73 20 74 68 61 74 20 70 54 6f 20 6e 6f 77 ges that pTo now
30aa0 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 70 6f contains the po
30ab0 69 6e 74 65 72 73 20 74 6f 2e 0a 20 20 20 20 2a inters to.. *
30ac0 2f 0a 20 20 20 20 69 66 28 20 49 53 41 55 54 4f /. if( ISAUTO
30ad0 56 41 43 55 55 4d 20 29 7b 0a 20 20 20 20 20 20 VACUUM ){.
30ae0 2a 70 52 43 20 3d 20 73 65 74 43 68 69 6c 64 50 *pRC = setChildP
30af0 74 72 6d 61 70 73 28 70 54 6f 29 3b 0a 20 20 20 trmaps(pTo);.
30b00 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 }. }.}../*.**
30b10 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 64 This routine red
30b20 69 73 74 72 69 62 75 74 65 73 20 63 65 6c 6c 73 istributes cells
30b30 20 6f 6e 20 74 68 65 20 69 50 61 72 65 6e 74 49 on the iParentI
30b40 64 78 27 74 68 20 63 68 69 6c 64 20 6f 66 20 70 dx'th child of p
30b50 50 61 72 65 6e 74 0a 2a 2a 20 28 68 65 72 65 61 Parent.** (herea
30b60 66 74 65 72 20 22 74 68 65 20 70 61 67 65 22 29 fter "the page")
30b70 20 61 6e 64 20 75 70 20 74 6f 20 32 20 73 69 62 and up to 2 sib
30b80 6c 69 6e 67 73 20 73 6f 20 74 68 61 74 20 61 6c lings so that al
30b90 6c 20 70 61 67 65 73 20 68 61 76 65 20 61 62 6f l pages have abo
30ba0 75 74 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 61 ut the.** same a
30bb0 6d 6f 75 6e 74 20 6f 66 20 66 72 65 65 20 73 70 mount of free sp
30bc0 61 63 65 2e 20 55 73 75 61 6c 6c 79 20 61 20 73 ace. Usually a s
30bd0 69 6e 67 6c 65 20 73 69 62 6c 69 6e 67 20 6f 6e ingle sibling on
30be0 20 65 69 74 68 65 72 20 73 69 64 65 20 6f 66 20 either side of
30bf0 74 68 65 0a 2a 2a 20 70 61 67 65 20 61 72 65 20 the.** page are
30c00 75 73 65 64 20 69 6e 20 74 68 65 20 62 61 6c 61 used in the bala
30c10 6e 63 69 6e 67 2c 20 74 68 6f 75 67 68 20 62 6f ncing, though bo
30c20 74 68 20 73 69 62 6c 69 6e 67 73 20 6d 69 67 68 th siblings migh
30c30 74 20 63 6f 6d 65 20 66 72 6f 6d 20 6f 6e 65 0a t come from one.
30c40 2a 2a 20 73 69 64 65 20 69 66 20 74 68 65 20 70 ** side if the p
30c50 61 67 65 20 69 73 20 74 68 65 20 66 69 72 73 74 age is the first
30c60 20 6f 72 20 6c 61 73 74 20 63 68 69 6c 64 20 6f or last child o
30c70 66 20 69 74 73 20 70 61 72 65 6e 74 2e 20 49 66 f its parent. If
30c80 20 74 68 65 20 70 61 67 65 20 0a 2a 2a 20 68 61 the page .** ha
30c90 73 20 66 65 77 65 72 20 74 68 61 6e 20 32 20 73 s fewer than 2 s
30ca0 69 62 6c 69 6e 67 73 20 28 73 6f 6d 65 74 68 69 iblings (somethi
30cb0 6e 67 20 77 68 69 63 68 20 63 61 6e 20 6f 6e 6c ng which can onl
30cc0 79 20 68 61 70 70 65 6e 20 69 66 20 74 68 65 20 y happen if the
30cd0 70 61 67 65 0a 2a 2a 20 69 73 20 61 20 72 6f 6f page.** is a roo
30ce0 74 20 70 61 67 65 20 6f 72 20 61 20 63 68 69 6c t page or a chil
30cf0 64 20 6f 66 20 61 20 72 6f 6f 74 20 70 61 67 65 d of a root page
30d00 29 20 74 68 65 6e 20 61 6c 6c 20 61 76 61 69 6c ) then all avail
30d10 61 62 6c 65 20 73 69 62 6c 69 6e 67 73 0a 2a 2a able siblings.**
30d20 20 70 61 72 74 69 63 69 70 61 74 65 20 69 6e 20 participate in
30d30 74 68 65 20 62 61 6c 61 6e 63 69 6e 67 2e 0a 2a the balancing..*
30d40 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 *.** The number
30d50 6f 66 20 73 69 62 6c 69 6e 67 73 20 6f 66 20 74 of siblings of t
30d60 68 65 20 70 61 67 65 20 6d 69 67 68 74 20 62 65 he page might be
30d70 20 69 6e 63 72 65 61 73 65 64 20 6f 72 20 64 65 increased or de
30d80 63 72 65 61 73 65 64 20 62 79 20 0a 2a 2a 20 6f creased by .** o
30d90 6e 65 20 6f 72 20 74 77 6f 20 69 6e 20 61 6e 20 ne or two in an
30da0 65 66 66 6f 72 74 20 74 6f 20 6b 65 65 70 20 70 effort to keep p
30db0 61 67 65 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c ages nearly full
30dc0 20 62 75 74 20 6e 6f 74 20 6f 76 65 72 20 66 75 but not over fu
30dd0 6c 6c 2e 20 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 ll. .**.** Note
30de0 74 68 61 74 20 77 68 65 6e 20 74 68 69 73 20 72 that when this r
30df0 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
30e00 2c 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 63 65 , some of the ce
30e10 6c 6c 73 20 6f 6e 20 74 68 65 20 70 61 67 65 0a lls on the page.
30e20 2a 2a 20 6d 69 67 68 74 20 6e 6f 74 20 61 63 74 ** might not act
30e30 75 61 6c 6c 79 20 62 65 20 73 74 6f 72 65 64 20 ually be stored
30e40 69 6e 20 4d 65 6d 50 61 67 65 2e 61 44 61 74 61 in MemPage.aData
30e50 5b 5d 2e 20 54 68 69 73 20 63 61 6e 20 68 61 70 []. This can hap
30e60 70 65 6e 0a 2a 2a 20 69 66 20 74 68 65 20 70 61 pen.** if the pa
30e70 67 65 20 69 73 20 6f 76 65 72 66 75 6c 6c 2e 20 ge is overfull.
30e80 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e 73 This routine ens
30e90 75 72 65 73 20 74 68 61 74 20 61 6c 6c 20 63 65 ures that all ce
30ea0 6c 6c 73 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a lls allocated.**
30eb0 20 74 6f 20 74 68 65 20 70 61 67 65 20 61 6e 64 to the page and
30ec0 20 69 74 73 20 73 69 62 6c 69 6e 67 73 20 66 69 its siblings fi
30ed0 74 20 69 6e 74 6f 20 4d 65 6d 50 61 67 65 2e 61 t into MemPage.a
30ee0 44 61 74 61 5b 5d 20 62 65 66 6f 72 65 20 72 65 Data[] before re
30ef0 74 75 72 6e 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 turning..**.** I
30f00 6e 20 74 68 65 20 63 6f 75 72 73 65 20 6f 66 20 n the course of
30f10 62 61 6c 61 6e 63 69 6e 67 20 74 68 65 20 70 61 balancing the pa
30f20 67 65 20 61 6e 64 20 69 74 73 20 73 69 62 6c 69 ge and its sibli
30f30 6e 67 73 2c 20 63 65 6c 6c 73 20 6d 61 79 20 62 ngs, cells may b
30f40 65 0a 2a 2a 20 69 6e 73 65 72 74 65 64 20 69 6e e.** inserted in
30f50 74 6f 20 6f 72 20 72 65 6d 6f 76 65 64 20 66 72 to or removed fr
30f60 6f 6d 20 74 68 65 20 70 61 72 65 6e 74 20 70 61 om the parent pa
30f70 67 65 20 28 70 50 61 72 65 6e 74 29 2e 20 44 6f ge (pParent). Do
30f80 69 6e 67 20 73 6f 0a 2a 2a 20 6d 61 79 20 63 61 ing so.** may ca
30f90 75 73 65 20 74 68 65 20 70 61 72 65 6e 74 20 70 use the parent p
30fa0 61 67 65 20 74 6f 20 62 65 63 6f 6d 65 20 6f 76 age to become ov
30fb0 65 72 66 75 6c 6c 20 6f 72 20 75 6e 64 65 72 66 erfull or underf
30fc0 75 6c 6c 2e 20 49 66 20 74 68 69 73 0a 2a 2a 20 ull. If this.**
30fd0 68 61 70 70 65 6e 73 2c 20 69 74 20 69 73 20 74 happens, it is t
30fe0 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 he responsibilit
30ff0 79 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 20 y of the caller
31000 74 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 6f to invoke the co
31010 72 72 65 63 74 0a 2a 2a 20 62 61 6c 61 6e 63 69 rrect.** balanci
31020 6e 67 20 72 6f 75 74 69 6e 65 20 74 6f 20 66 69 ng routine to fi
31030 78 20 74 68 69 73 20 70 72 6f 62 6c 65 6d 20 28 x this problem (
31040 73 65 65 20 74 68 65 20 62 61 6c 61 6e 63 65 28 see the balance(
31050 29 20 72 6f 75 74 69 6e 65 29 2e 20 0a 2a 2a 0a ) routine). .**.
31060 2a 2a 20 49 66 20 74 68 69 73 20 72 6f 75 74 69 ** If this routi
31070 6e 65 20 66 61 69 6c 73 20 66 6f 72 20 61 6e 79 ne fails for any
31080 20 72 65 61 73 6f 6e 2c 20 69 74 20 6d 69 67 68 reason, it migh
31090 74 20 6c 65 61 76 65 20 74 68 65 20 64 61 74 61 t leave the data
310a0 62 61 73 65 0a 2a 2a 20 69 6e 20 61 20 63 6f 72 base.** in a cor
310b0 72 75 70 74 65 64 20 73 74 61 74 65 2e 20 53 6f rupted state. So
310c0 20 69 66 20 74 68 69 73 20 72 6f 75 74 69 6e 65 if this routine
310d0 20 66 61 69 6c 73 2c 20 74 68 65 20 64 61 74 61 fails, the data
310e0 62 61 73 65 20 73 68 6f 75 6c 64 0a 2a 2a 20 62 base should.** b
310f0 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a e rolled back..*
31100 2a 0a 2a 2a 20 54 68 65 20 74 68 69 72 64 20 61 *.** The third a
31110 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 rgument to this
31120 66 75 6e 63 74 69 6f 6e 2c 20 61 4f 76 66 6c 53 function, aOvflS
31130 70 61 63 65 2c 20 69 73 20 61 20 70 6f 69 6e 74 pace, is a point
31140 65 72 20 74 6f 20 61 0a 2a 2a 20 62 75 66 66 65 er to a.** buffe
31150 72 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f 20 r big enough to
31160 68 6f 6c 64 20 6f 6e 65 20 70 61 67 65 2e 20 49 hold one page. I
31170 66 20 77 68 69 6c 65 20 69 6e 73 65 72 74 69 6e f while insertin
31180 67 20 63 65 6c 6c 73 20 69 6e 74 6f 20 74 68 65 g cells into the
31190 20 70 61 72 65 6e 74 0a 2a 2a 20 70 61 67 65 20 parent.** page
311a0 28 70 50 61 72 65 6e 74 29 20 74 68 65 20 70 61 (pParent) the pa
311b0 72 65 6e 74 20 70 61 67 65 20 62 65 63 6f 6d 65 rent page become
311c0 73 20 6f 76 65 72 66 75 6c 6c 2c 20 74 68 69 73 s overfull, this
311d0 20 62 75 66 66 65 72 20 69 73 0a 2a 2a 20 75 73 buffer is.** us
311e0 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 ed to store the
311f0 70 61 72 65 6e 74 27 73 20 6f 76 65 72 66 6c 6f parent's overflo
31200 77 20 63 65 6c 6c 73 2e 20 42 65 63 61 75 73 65 w cells. Because
31210 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
31220 6e 73 65 72 74 73 0a 2a 2a 20 61 20 6d 61 78 69 nserts.** a maxi
31230 6d 75 6d 20 6f 66 20 66 6f 75 72 20 64 69 76 69 mum of four divi
31240 64 65 72 20 63 65 6c 6c 73 20 69 6e 74 6f 20 74 der cells into t
31250 68 65 20 70 61 72 65 6e 74 20 70 61 67 65 2c 20 he parent page,
31260 61 6e 64 20 74 68 65 20 6d 61 78 69 6d 75 6d 0a and the maximum.
31270 2a 2a 20 73 69 7a 65 20 6f 66 20 61 20 63 65 6c ** size of a cel
31280 6c 20 73 74 6f 72 65 64 20 77 69 74 68 69 6e 20 l stored within
31290 61 6e 20 69 6e 74 65 72 6e 61 6c 20 6e 6f 64 65 an internal node
312a0 20 69 73 20 61 6c 77 61 79 73 20 6c 65 73 73 20 is always less
312b0 74 68 61 6e 20 31 2f 34 0a 2a 2a 20 6f 66 20 74 than 1/4.** of t
312c0 68 65 20 70 61 67 65 2d 73 69 7a 65 2c 20 74 68 he page-size, th
312d0 65 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d 20 62 e aOvflSpace[] b
312e0 75 66 66 65 72 20 69 73 20 67 75 61 72 61 6e 74 uffer is guarant
312f0 65 65 64 20 74 6f 20 62 65 20 6c 61 72 67 65 0a eed to be large.
31300 2a 2a 20 65 6e 6f 75 67 68 20 66 6f 72 20 61 6c ** enough for al
31310 6c 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 73 l overflow cells
31320 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 4f 76 66 6c ..**.** If aOvfl
31330 53 70 61 63 65 20 69 73 20 73 65 74 20 74 6f 20 Space is set to
31340 61 20 6e 75 6c 6c 20 70 6f 69 6e 74 65 72 2c 20 a null pointer,
31350 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 this function re
31360 74 75 72 6e 73 20 0a 2a 2a 20 53 51 4c 49 54 45 turns .** SQLITE
31370 5f 4e 4f 4d 45 4d 2e 0a 2a 2f 0a 73 74 61 74 69 _NOMEM..*/.stati
31380 63 20 69 6e 74 20 62 61 6c 61 6e 63 65 5f 6e 6f c int balance_no
31390 6e 72 6f 6f 74 28 0a 20 20 4d 65 6d 50 61 67 65 nroot(. MemPage
313a0 20 2a 70 50 61 72 65 6e 74 2c 20 20 20 20 20 20 *pParent,
313b0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 65 /* Pare
313c0 6e 74 20 70 61 67 65 20 6f 66 20 73 69 62 6c 69 nt page of sibli
313d0 6e 67 73 20 62 65 69 6e 67 20 62 61 6c 61 6e 63 ngs being balanc
313e0 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 50 61 72 ed */. int iPar
313f0 65 6e 74 49 64 78 2c 20 20 20 20 20 20 20 20 20 entIdx,
31400 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 /* Index
31410 20 6f 66 20 22 74 68 65 20 70 61 67 65 22 20 69 of "the page" i
31420 6e 20 70 50 61 72 65 6e 74 20 2a 2f 0a 20 20 75 n pParent */. u
31430 38 20 2a 61 4f 76 66 6c 53 70 61 63 65 2c 20 20 8 *aOvflSpace,
31440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
31450 2a 20 70 61 67 65 2d 73 69 7a 65 20 62 79 74 65 * page-size byte
31460 73 20 6f 66 20 73 70 61 63 65 20 66 6f 72 20 70 s of space for p
31470 61 72 65 6e 74 20 6f 76 66 6c 20 2a 2f 0a 20 20 arent ovfl */.
31480 69 6e 74 20 69 73 52 6f 6f 74 2c 20 20 20 20 20 int isRoot,
31490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
314a0 2f 2a 20 54 72 75 65 20 69 66 20 70 50 61 72 65 /* True if pPare
314b0 6e 74 20 69 73 20 61 20 72 6f 6f 74 2d 70 61 67 nt is a root-pag
314c0 65 20 2a 2f 0a 20 20 69 6e 74 20 62 42 75 6c 6b e */. int bBulk
314d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
314e0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
314f0 66 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 70 f this call is p
31500 61 72 74 20 6f 66 20 61 20 62 75 6c 6b 20 6c 6f art of a bulk lo
31510 61 64 20 2a 2f 0a 29 7b 0a 20 20 42 74 53 68 61 ad */.){. BtSha
31520 72 65 64 20 2a 70 42 74 3b 20 20 20 20 20 20 20 red *pBt;
31530 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 77 /* The w
31540 68 6f 6c 65 20 64 61 74 61 62 61 73 65 20 2a 2f hole database */
31550 0a 20 20 69 6e 74 20 6e 43 65 6c 6c 20 3d 20 30 . int nCell = 0
31560 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
31570 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 65 6c /* Number of cel
31580 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 2a ls in apCell[] *
31590 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 43 65 6c 6c /. int nMaxCell
315a0 73 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 s = 0;
315b0 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 69 /* Allocated si
315c0 7a 65 20 6f 66 20 61 70 43 65 6c 6c 2c 20 73 7a ze of apCell, sz
315d0 43 65 6c 6c 2c 20 61 46 72 6f 6d 2e 20 2a 2f 0a Cell, aFrom. */.
315e0 20 20 69 6e 74 20 6e 4e 65 77 20 3d 20 30 3b 20 int nNew = 0;
315f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
31600 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
31610 73 20 69 6e 20 61 70 4e 65 77 5b 5d 20 2a 2f 0a s in apNew[] */.
31620 20 20 69 6e 74 20 6e 4f 6c 64 3b 20 20 20 20 20 int nOld;
31630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
31640 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
31650 73 20 69 6e 20 61 70 4f 6c 64 5b 5d 20 2a 2f 0a s in apOld[] */.
31660 20 20 69 6e 74 20 69 2c 20 6a 2c 20 6b 3b 20 20 int i, j, k;
31670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
31680 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 73 20 * Loop counters
31690 2a 2f 0a 20 20 69 6e 74 20 6e 78 44 69 76 3b 20 */. int nxDiv;
316a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
316b0 20 20 2f 2a 20 4e 65 78 74 20 64 69 76 69 64 65 /* Next divide
316c0 72 20 73 6c 6f 74 20 69 6e 20 70 50 61 72 65 6e r slot in pParen
316d0 74 2d 3e 61 43 65 6c 6c 5b 5d 20 2a 2f 0a 20 20 t->aCell[] */.
316e0 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
316f0 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 OK; /*
31700 54 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 The return code
31710 2a 2f 0a 20 20 75 31 36 20 6c 65 61 66 43 6f 72 */. u16 leafCor
31720 72 65 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 rection;
31730 20 20 2f 2a 20 34 20 69 66 20 70 50 61 67 65 20 /* 4 if pPage
31740 69 73 20 61 20 6c 65 61 66 2e 20 20 30 20 69 66 is a leaf. 0 if
31750 20 6e 6f 74 20 2a 2f 0a 20 20 69 6e 74 20 6c 65 not */. int le
31760 61 66 44 61 74 61 3b 20 20 20 20 20 20 20 20 20 afData;
31770 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
31780 66 20 70 50 61 67 65 20 69 73 20 61 20 6c 65 61 f pPage is a lea
31790 66 20 6f 66 20 61 20 4c 45 41 46 44 41 54 41 20 f of a LEAFDATA
317a0 74 72 65 65 20 2a 2f 0a 20 20 69 6e 74 20 75 73 tree */. int us
317b0 61 62 6c 65 53 70 61 63 65 3b 20 20 20 20 20 20 ableSpace;
317c0 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 /* Bytes
317d0 69 6e 20 70 50 61 67 65 20 62 65 79 6f 6e 64 20 in pPage beyond
317e0 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 the header */.
317f0 69 6e 74 20 70 61 67 65 46 6c 61 67 73 3b 20 20 int pageFlags;
31800 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
31810 56 61 6c 75 65 20 6f 66 20 70 50 61 67 65 2d 3e Value of pPage->
31820 61 44 61 74 61 5b 30 5d 20 2a 2f 0a 20 20 69 6e aData[0] */. in
31830 74 20 73 75 62 74 6f 74 61 6c 3b 20 20 20 20 20 t subtotal;
31840 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 75 /* Su
31850 62 74 6f 74 61 6c 20 6f 66 20 62 79 74 65 73 20 btotal of bytes
31860 69 6e 20 63 65 6c 6c 73 20 6f 6e 20 6f 6e 65 20 in cells on one
31870 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 69 53 page */. int iS
31880 70 61 63 65 31 20 3d 20 30 3b 20 20 20 20 20 20 pace1 = 0;
31890 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
318a0 75 6e 75 73 65 64 20 62 79 74 65 20 6f 66 20 61 unused byte of a
318b0 53 70 61 63 65 31 5b 5d 20 2a 2f 0a 20 20 69 6e Space1[] */. in
318c0 74 20 69 4f 76 66 6c 53 70 61 63 65 20 3d 20 30 t iOvflSpace = 0
318d0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 ; /* Fi
318e0 72 73 74 20 75 6e 75 73 65 64 20 62 79 74 65 20 rst unused byte
318f0 6f 66 20 61 4f 76 66 6c 53 70 61 63 65 5b 5d 20 of aOvflSpace[]
31900 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 63 72 61 74 */. int szScrat
31910 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ch;
31920 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 73 63 72 /* Size of scr
31930 61 74 63 68 20 6d 65 6d 6f 72 79 20 72 65 71 75 atch memory requ
31940 65 73 74 65 64 20 2a 2f 0a 20 20 4d 65 6d 50 61 ested */. MemPa
31950 67 65 20 2a 61 70 4f 6c 64 5b 4e 42 5d 3b 20 20 ge *apOld[NB];
31960 20 20 20 20 20 20 20 20 2f 2a 20 70 50 61 67 65 /* pPage
31970 20 61 6e 64 20 75 70 20 74 6f 20 74 77 6f 20 73 and up to two s
31980 69 62 6c 69 6e 67 73 20 2a 2f 0a 20 20 4d 65 6d iblings */. Mem
31990 50 61 67 65 20 2a 61 70 43 6f 70 79 5b 4e 42 5d Page *apCopy[NB]
319a0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 69 ; /* Pri
319b0 76 61 74 65 20 63 6f 70 69 65 73 20 6f 66 20 61 vate copies of a
319c0 70 4f 6c 64 5b 5d 20 70 61 67 65 73 20 2a 2f 0a pOld[] pages */.
319d0 20 20 4d 65 6d 50 61 67 65 20 2a 61 70 4e 65 77 MemPage *apNew
319e0 5b 4e 42 2b 32 5d 3b 20 20 20 20 20 20 20 20 2f [NB+2]; /
319f0 2a 20 70 50 61 67 65 20 61 6e 64 20 75 70 20 74 * pPage and up t
31a00 6f 20 4e 42 20 73 69 62 6c 69 6e 67 73 20 61 66 o NB siblings af
31a10 74 65 72 20 62 61 6c 61 6e 63 69 6e 67 20 2a 2f ter balancing */
31a20 0a 20 20 75 38 20 2a 70 52 69 67 68 74 3b 20 20 . u8 *pRight;
31a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
31a40 2f 2a 20 4c 6f 63 61 74 69 6f 6e 20 69 6e 20 70 /* Location in p
31a50 61 72 65 6e 74 20 6f 66 20 72 69 67 68 74 2d 73 arent of right-s
31a60 69 62 6c 69 6e 67 20 70 6f 69 6e 74 65 72 20 2a ibling pointer *
31a70 2f 0a 20 20 75 38 20 2a 61 70 44 69 76 5b 4e 42 /. u8 *apDiv[NB
31a80 2d 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 -1];
31a90 20 2f 2a 20 44 69 76 69 64 65 72 20 63 65 6c 6c /* Divider cell
31aa0 73 20 69 6e 20 70 50 61 72 65 6e 74 20 2a 2f 0a s in pParent */.
31ab0 20 20 69 6e 74 20 63 6e 74 4e 65 77 5b 4e 42 2b int cntNew[NB+
31ac0 32 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2]; /
31ad0 2a 20 49 6e 64 65 78 20 69 6e 20 61 43 65 6c 6c * Index in aCell
31ae0 5b 5d 20 6f 66 20 63 65 6c 6c 20 61 66 74 65 72 [] of cell after
31af0 20 69 2d 74 68 20 70 61 67 65 20 2a 2f 0a 20 20 i-th page */.
31b00 69 6e 74 20 73 7a 4e 65 77 5b 4e 42 2b 32 5d 3b int szNew[NB+2];
31b10 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
31b20 43 6f 6d 62 69 6e 65 64 20 73 69 7a 65 20 6f 66 Combined size of
31b30 20 63 65 6c 6c 73 20 70 6c 61 63 65 20 6f 6e 20 cells place on
31b40 69 2d 74 68 20 70 61 67 65 20 2a 2f 0a 20 20 75 i-th page */. u
31b50 38 20 2a 2a 61 70 43 65 6c 6c 20 3d 20 30 3b 20 8 **apCell = 0;
31b60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
31b70 6c 6c 20 63 65 6c 6c 73 20 62 65 67 69 6e 20 62 ll cells begin b
31b80 61 6c 61 6e 63 65 64 20 2a 2f 0a 20 20 75 31 36 alanced */. u16
31b90 20 2a 73 7a 43 65 6c 6c 3b 20 20 20 20 20 20 20 *szCell;
31ba0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 63 /* Loc
31bb0 61 6c 20 73 69 7a 65 20 6f 66 20 61 6c 6c 20 63 al size of all c
31bc0 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c 6c 5b 5d ells in apCell[]
31bd0 20 2a 2f 0a 20 20 75 38 20 2a 61 53 70 61 63 65 */. u8 *aSpace
31be0 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1;
31bf0 20 20 20 2f 2a 20 53 70 61 63 65 20 66 6f 72 20 /* Space for
31c00 63 6f 70 69 65 73 20 6f 66 20 64 69 76 69 64 65 copies of divide
31c10 72 73 20 63 65 6c 6c 73 20 2a 2f 0a 20 20 50 67 rs cells */. Pg
31c20 6e 6f 20 70 67 6e 6f 3b 20 20 20 20 20 20 20 20 no pgno;
31c30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 /* Te
31c40 6d 70 20 76 61 72 20 74 6f 20 73 74 6f 72 65 20 mp var to store
31c50 61 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 6e a page number in
31c60 20 2a 2f 0a 0a 20 20 70 42 74 20 3d 20 70 50 61 */.. pBt = pPa
31c70 72 65 6e 74 2d 3e 70 42 74 3b 0a 20 20 61 73 73 rent->pBt;. ass
31c80 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
31c90 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e 6d 75 74 ex_held(pBt->mut
31ca0 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
31cb0 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 sqlite3PagerIsw
31cc0 72 69 74 65 61 62 6c 65 28 70 50 61 72 65 6e 74 riteable(pParent
31cd0 2d 3e 70 44 62 50 61 67 65 29 20 29 3b 0a 0a 23 ->pDbPage) );..#
31ce0 69 66 20 30 0a 20 20 54 52 41 43 45 28 28 22 42 if 0. TRACE(("B
31cf0 41 4c 41 4e 43 45 3a 20 62 65 67 69 6e 20 70 61 ALANCE: begin pa
31d00 67 65 20 25 64 20 63 68 69 6c 64 20 6f 66 20 25 ge %d child of %
31d10 64 5c 6e 22 2c 20 70 50 61 67 65 2d 3e 70 67 6e d\n", pPage->pgn
31d20 6f 2c 20 70 50 61 72 65 6e 74 2d 3e 70 67 6e 6f o, pParent->pgno
31d30 29 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a ));.#endif.. /*
31d40 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 70 At this point p
31d50 50 61 72 65 6e 74 20 6d 61 79 20 68 61 76 65 20 Parent may have
31d60 61 74 20 6d 6f 73 74 20 6f 6e 65 20 6f 76 65 72 at most one over
31d70 66 6c 6f 77 20 63 65 6c 6c 2e 20 41 6e 64 20 69 flow cell. And i
31d80 66 0a 20 20 2a 2a 20 74 68 69 73 20 6f 76 65 72 f. ** this over
31d90 66 6c 6f 77 20 63 65 6c 6c 20 69 73 20 70 72 65 flow cell is pre
31da0 73 65 6e 74 2c 20 69 74 20 6d 75 73 74 20 62 65 sent, it must be
31db0 20 74 68 65 20 63 65 6c 6c 20 77 69 74 68 20 0a the cell with .
31dc0 20 20 2a 2a 20 69 6e 64 65 78 20 69 50 61 72 65 ** index iPare
31dd0 6e 74 49 64 78 2e 20 54 68 69 73 20 73 63 65 6e ntIdx. This scen
31de0 61 72 69 6f 20 63 6f 6d 65 73 20 61 62 6f 75 74 ario comes about
31df0 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 when this funct
31e00 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 63 61 6c 6c ion. ** is call
31e10 65 64 20 28 69 6e 64 69 72 65 63 74 6c 79 29 20 ed (indirectly)
31e20 66 72 6f 6d 20 73 71 6c 69 74 65 33 42 74 72 65 from sqlite3Btre
31e30 65 44 65 6c 65 74 65 28 29 2e 0a 20 20 2a 2f 0a eDelete().. */.
31e40 20 20 61 73 73 65 72 74 28 20 70 50 61 72 65 6e assert( pParen
31e50 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 t->nOverflow==0
31e60 7c 7c 20 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 || pParent->nOve
31e70 72 66 6c 6f 77 3d 3d 31 20 29 3b 0a 20 20 61 73 rflow==1 );. as
31e80 73 65 72 74 28 20 70 50 61 72 65 6e 74 2d 3e 6e sert( pParent->n
31e90 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 7c 7c 20 70 Overflow==0 || p
31ea0 50 61 72 65 6e 74 2d 3e 61 69 4f 76 66 6c 5b 30 Parent->aiOvfl[0
31eb0 5d 3d 3d 69 50 61 72 65 6e 74 49 64 78 20 29 3b ]==iParentIdx );
31ec0 0a 0a 20 20 69 66 28 20 21 61 4f 76 66 6c 53 70 .. if( !aOvflSp
31ed0 61 63 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ace ){. retur
31ee0 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a n SQLITE_NOMEM;.
31ef0 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 6e 64 20 74 }.. /* Find t
31f00 68 65 20 73 69 62 6c 69 6e 67 20 70 61 67 65 73 he sibling pages
31f10 20 74 6f 20 62 61 6c 61 6e 63 65 2e 20 41 6c 73 to balance. Als
31f20 6f 20 6c 6f 63 61 74 65 20 74 68 65 20 63 65 6c o locate the cel
31f30 6c 73 20 69 6e 20 70 50 61 72 65 6e 74 20 0a 20 ls in pParent .
31f40 20 2a 2a 20 74 68 61 74 20 64 69 76 69 64 65 20 ** that divide
31f50 74 68 65 20 73 69 62 6c 69 6e 67 73 2e 20 41 6e the siblings. An
31f60 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 attempt is made
31f70 20 74 6f 20 66 69 6e 64 20 4e 4e 20 73 69 62 6c to find NN sibl
31f80 69 6e 67 73 20 6f 6e 20 0a 20 20 2a 2a 20 65 69 ings on . ** ei
31f90 74 68 65 72 20 73 69 64 65 20 6f 66 20 70 50 61 ther side of pPa
31fa0 67 65 2e 20 4d 6f 72 65 20 73 69 62 6c 69 6e 67 ge. More sibling
31fb0 73 20 61 72 65 20 74 61 6b 65 6e 20 66 72 6f 6d s are taken from
31fc0 20 6f 6e 65 20 73 69 64 65 2c 20 68 6f 77 65 76 one side, howev
31fd0 65 72 2c 20 0a 20 20 2a 2a 20 69 66 20 74 68 65 er, . ** if the
31fe0 72 65 20 61 72 65 20 66 65 77 65 72 20 74 68 61 re are fewer tha
31ff0 6e 20 4e 4e 20 73 69 62 6c 69 6e 67 73 20 6f 6e n NN siblings on
32000 20 74 68 65 20 6f 74 68 65 72 20 73 69 64 65 2e the other side.
32010 20 49 66 20 70 50 61 72 65 6e 74 0a 20 20 2a 2a If pParent. **
32020 20 68 61 73 20 4e 42 20 6f 72 20 66 65 77 65 72 has NB or fewer
32030 20 63 68 69 6c 64 72 65 6e 20 74 68 65 6e 20 61 children then a
32040 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66 20 70 ll children of p
32050 50 61 72 65 6e 74 20 61 72 65 20 74 61 6b 65 6e Parent are taken
32060 2e 20 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 . . **. ** Th
32070 69 73 20 6c 6f 6f 70 20 61 6c 73 6f 20 64 72 6f is loop also dro
32080 70 73 20 74 68 65 20 64 69 76 69 64 65 72 20 63 ps the divider c
32090 65 6c 6c 73 20 66 72 6f 6d 20 74 68 65 20 70 61 ells from the pa
320a0 72 65 6e 74 20 70 61 67 65 2e 20 54 68 69 73 0a rent page. This.
320b0 20 20 2a 2a 20 77 61 79 2c 20 74 68 65 20 72 65 ** way, the re
320c0 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 65 20 66 mainder of the f
320d0 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 unction does not
320e0 20 68 61 76 65 20 74 6f 20 64 65 61 6c 20 77 69 have to deal wi
320f0 74 68 20 61 6e 79 0a 20 20 2a 2a 20 6f 76 65 72 th any. ** over
32100 66 6c 6f 77 20 63 65 6c 6c 73 20 69 6e 20 74 68 flow cells in th
32110 65 20 70 61 72 65 6e 74 20 70 61 67 65 2c 20 73 e parent page, s
32120 69 6e 63 65 20 69 66 20 61 6e 79 20 65 78 69 73 ince if any exis
32130 74 65 64 20 74 68 65 79 20 77 69 6c 6c 0a 20 20 ted they will.
32140 2a 2a 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 ** have already
32150 62 65 65 6e 20 72 65 6d 6f 76 65 64 2e 0a 20 20 been removed..
32160 2a 2f 0a 20 20 69 20 3d 20 70 50 61 72 65 6e 74 */. i = pParent
32170 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 2b 20 70 50 ->nOverflow + pP
32180 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 3b 0a 20 20 arent->nCell;.
32190 69 66 28 20 69 3c 32 20 29 7b 0a 20 20 20 20 6e if( i<2 ){. n
321a0 78 44 69 76 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 xDiv = 0;. }els
321b0 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 62 e{. assert( b
321c0 42 75 6c 6b 3d 3d 30 20 7c 7c 20 62 42 75 6c 6b Bulk==0 || bBulk
321d0 3d 3d 31 20 29 3b 0a 20 20 20 20 69 66 28 20 69 ==1 );. if( i
321e0 50 61 72 65 6e 74 49 64 78 3d 3d 30 20 29 7b 20 ParentIdx==0 ){
321f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32200 0a 20 20 20 20 20 20 6e 78 44 69 76 20 3d 20 30 . nxDiv = 0
32210 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
32220 69 50 61 72 65 6e 74 49 64 78 3d 3d 69 20 29 7b iParentIdx==i ){
32230 0a 20 20 20 20 20 20 6e 78 44 69 76 20 3d 20 69 . nxDiv = i
32240 2d 32 2b 62 42 75 6c 6b 3b 0a 20 20 20 20 7d 65 -2+bBulk;. }e
32250 6c 73 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 lse{. asser
32260 74 28 20 62 42 75 6c 6b 3d 3d 30 20 29 3b 0a 20 t( bBulk==0 );.
32270 20 20 20 20 20 6e 78 44 69 76 20 3d 20 69 50 61 nxDiv = iPa
32280 72 65 6e 74 49 64 78 2d 31 3b 0a 20 20 20 20 7d rentIdx-1;. }
32290 0a 20 20 20 20 69 20 3d 20 32 2d 62 42 75 6c 6b . i = 2-bBulk
322a0 3b 0a 20 20 7d 0a 20 20 6e 4f 6c 64 20 3d 20 69 ;. }. nOld = i
322b0 2b 31 3b 0a 20 20 69 66 28 20 28 69 2b 6e 78 44 +1;. if( (i+nxD
322c0 69 76 2d 70 50 61 72 65 6e 74 2d 3e 6e 4f 76 65 iv-pParent->nOve
322d0 72 66 6c 6f 77 29 3d 3d 70 50 61 72 65 6e 74 2d rflow)==pParent-
322e0 3e 6e 43 65 6c 6c 20 29 7b 0a 20 20 20 20 70 52 >nCell ){. pR
322f0 69 67 68 74 20 3d 20 26 70 50 61 72 65 6e 74 2d ight = &pParent-
32300 3e 61 44 61 74 61 5b 70 50 61 72 65 6e 74 2d 3e >aData[pParent->
32310 68 64 72 4f 66 66 73 65 74 2b 38 5d 3b 0a 20 20 hdrOffset+8];.
32320 7d 65 6c 73 65 7b 0a 20 20 20 20 70 52 69 67 68 }else{. pRigh
32330 74 20 3d 20 66 69 6e 64 43 65 6c 6c 28 70 50 61 t = findCell(pPa
32340 72 65 6e 74 2c 20 69 2b 6e 78 44 69 76 2d 70 50 rent, i+nxDiv-pP
32350 61 72 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 arent->nOverflow
32360 29 3b 0a 20 20 7d 0a 20 20 70 67 6e 6f 20 3d 20 );. }. pgno =
32370 67 65 74 34 62 79 74 65 28 70 52 69 67 68 74 29 get4byte(pRight)
32380 3b 0a 20 20 77 68 69 6c 65 28 20 31 20 29 7b 0a ;. while( 1 ){.
32390 20 20 20 20 72 63 20 3d 20 67 65 74 41 6e 64 49 rc = getAndI
323a0 6e 69 74 50 61 67 65 28 70 42 74 2c 20 70 67 6e nitPage(pBt, pgn
323b0 6f 2c 20 26 61 70 4f 6c 64 5b 69 5d 29 3b 0a 20 o, &apOld[i]);.
323c0 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 if( rc ){.
323d0 20 20 20 6d 65 6d 73 65 74 28 61 70 4f 6c 64 2c memset(apOld,
323e0 20 30 2c 20 28 69 2b 31 29 2a 73 69 7a 65 6f 66 0, (i+1)*sizeof
323f0 28 4d 65 6d 50 61 67 65 2a 29 29 3b 0a 20 20 20 (MemPage*));.
32400 20 20 20 67 6f 74 6f 20 62 61 6c 61 6e 63 65 5f goto balance_
32410 63 6c 65 61 6e 75 70 3b 0a 20 20 20 20 7d 0a 20 cleanup;. }.
32420 20 20 20 6e 4d 61 78 43 65 6c 6c 73 20 2b 3d 20 nMaxCells +=
32430 31 2b 61 70 4f 6c 64 5b 69 5d 2d 3e 6e 43 65 6c 1+apOld[i]->nCel
32440 6c 2b 61 70 4f 6c 64 5b 69 5d 2d 3e 6e 4f 76 65 l+apOld[i]->nOve
32450 72 66 6c 6f 77 3b 0a 20 20 20 20 69 66 28 20 28 rflow;. if( (
32460 69 2d 2d 29 3d 3d 30 20 29 20 62 72 65 61 6b 3b i--)==0 ) break;
32470 0a 0a 20 20 20 20 69 66 28 20 69 2b 6e 78 44 69 .. if( i+nxDi
32480 76 3d 3d 70 50 61 72 65 6e 74 2d 3e 61 69 4f 76 v==pParent->aiOv
32490 66 6c 5b 30 5d 20 26 26 20 70 50 61 72 65 6e 74 fl[0] && pParent
324a0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 7b 0a 20 ->nOverflow ){.
324b0 20 20 20 20 20 61 70 44 69 76 5b 69 5d 20 3d 20 apDiv[i] =
324c0 70 50 61 72 65 6e 74 2d 3e 61 70 4f 76 66 6c 5b pParent->apOvfl[
324d0 30 5d 3b 0a 20 20 20 20 20 20 70 67 6e 6f 20 3d 0];. pgno =
324e0 20 67 65 74 34 62 79 74 65 28 61 70 44 69 76 5b get4byte(apDiv[
324f0 69 5d 29 3b 0a 20 20 20 20 20 20 73 7a 4e 65 77 i]);. szNew
32500 5b 69 5d 20 3d 20 63 65 6c 6c 53 69 7a 65 50 74 [i] = cellSizePt
32510 72 28 70 50 61 72 65 6e 74 2c 20 61 70 44 69 76 r(pParent, apDiv
32520 5b 69 5d 29 3b 0a 20 20 20 20 20 20 70 50 61 72 [i]);. pPar
32530 65 6e 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 3d ent->nOverflow =
32540 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 0;. }else{.
32550 20 20 20 20 20 61 70 44 69 76 5b 69 5d 20 3d 20 apDiv[i] =
32560 66 69 6e 64 43 65 6c 6c 28 70 50 61 72 65 6e 74 findCell(pParent
32570 2c 20 69 2b 6e 78 44 69 76 2d 70 50 61 72 65 6e , i+nxDiv-pParen
32580 74 2d 3e 6e 4f 76 65 72 66 6c 6f 77 29 3b 0a 20 t->nOverflow);.
32590 20 20 20 20 20 70 67 6e 6f 20 3d 20 67 65 74 34 pgno = get4
325a0 62 79 74 65 28 61 70 44 69 76 5b 69 5d 29 3b 0a byte(apDiv[i]);.
325b0 20 20 20 20 20 20 73 7a 4e 65 77 5b 69 5d 20 3d szNew[i] =
325c0 20 63 65 6c 6c 53 69 7a 65 50 74 72 28 70 50 61 cellSizePtr(pPa
325d0 72 65 6e 74 2c 20 61 70 44 69 76 5b 69 5d 29 3b rent, apDiv[i]);
325e0 0a 0a 20 20 20 20 20 20 2f 2a 20 44 72 6f 70 20 .. /* Drop
325f0 74 68 65 20 63 65 6c 6c 20 66 72 6f 6d 20 74 68 the cell from th
32600 65 20 70 61 72 65 6e 74 20 70 61 67 65 2e 20 61 e parent page. a
32610 70 44 69 76 5b 69 5d 20 73 74 69 6c 6c 20 70 6f pDiv[i] still po
32620 69 6e 74 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a ints to. **
32630 20 74 68 65 20 63 65 6c 6c 20 77 69 74 68 69 6e the cell within
32640 20 74 68 65 20 70 61 72 65 6e 74 2c 20 65 76 65 the parent, eve
32650 6e 20 74 68 6f 75 67 68 20 69 74 20 68 61 73 20 n though it has
32660 62 65 65 6e 20 64 72 6f 70 70 65 64 2e 0a 20 20 been dropped..
32670 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 20 73 ** This is s
32680 61 66 65 20 62 65 63 61 75 73 65 20 64 72 6f 70 afe because drop
32690 70 69 6e 67 20 61 20 63 65 6c 6c 20 6f 6e 6c 79 ping a cell only
326a0 20 6f 76 65 72 77 72 69 74 65 73 20 74 68 65 20 overwrites the
326b0 66 69 72 73 74 0a 20 20 20 20 20 20 2a 2a 20 66 first. ** f
326c0 6f 75 72 20 62 79 74 65 73 20 6f 66 20 69 74 2c our bytes of it,
326d0 20 61 6e 64 20 74 68 69 73 20 66 75 6e 63 74 69 and this functi
326e0 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 on does not need
326f0 20 74 68 65 20 66 69 72 73 74 0a 20 20 20 20 20 the first.
32700 20 2a 2a 20 66 6f 75 72 20 62 79 74 65 73 20 6f ** four bytes o
32710 66 20 74 68 65 20 64 69 76 69 64 65 72 20 63 65 f the divider ce
32720 6c 6c 2e 20 53 6f 20 74 68 65 20 70 6f 69 6e 74 ll. So the point
32730 65 72 20 69 73 20 73 61 66 65 20 74 6f 20 75 73 er is safe to us
32740 65 0a 20 20 20 20 20 20 2a 2a 20 6c 61 74 65 72 e. ** later
32750 20 6f 6e 2e 20 20 0a 20 20 20 20 20 20 2a 2a 0a on. . **.
32760 20 20 20 20 20 20 2a 2a 20 42 75 74 20 6e 6f 74 ** But not
32770 20 69 66 20 77 65 20 61 72 65 20 69 6e 20 73 65 if we are in se
32780 63 75 72 65 2d 64 65 6c 65 74 65 20 6d 6f 64 65 cure-delete mode
32790 2e 20 49 6e 20 73 65 63 75 72 65 2d 64 65 6c 65 . In secure-dele
327a0 74 65 20 6d 6f 64 65 2c 0a 20 20 20 20 20 20 2a te mode,. *
327b0 2a 20 74 68 65 20 64 72 6f 70 43 65 6c 6c 28 29 * the dropCell()
327c0 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 6f 76 routine will ov
327d0 65 72 77 72 69 74 65 20 74 68 65 20 65 6e 74 69 erwrite the enti
327e0 72 65 20 63 65 6c 6c 20 77 69 74 68 20 7a 65 72 re cell with zer
327f0 6f 65 73 2e 0a 20 20 20 20 20 20 2a 2a 20 49 6e oes.. ** In
32800 20 74 68 69 73 20 63 61 73 65 2c 20 74 65 6d 70 this case, temp
32810 6f 72 61 72 69 6c 79 20 63 6f 70 79 20 74 68 65 orarily copy the
32820 20 63 65 6c 6c 20 69 6e 74 6f 20 74 68 65 20 61 cell into the a
32830 4f 76 66 6c 53 70 61 63 65 5b 5d 0a 20 20 20 20 OvflSpace[].
32840 20 20 2a 2a 20 62 75 66 66 65 72 2e 20 49 74 20 ** buffer. It
32850 77 69 6c 6c 20 62 65 20 63 6f 70 69 65 64 20 6f will be copied o
32860 75 74 20 61 67 61 69 6e 20 61 73 20 73 6f 6f 6e ut again as soon
32870 20 61 73 20 74 68 65 20 61 53 70 61 63 65 5b 5d as the aSpace[]
32880 20 62 75 66 66 65 72 0a 20 20 20 20 20 20 2a 2a buffer. **
32890 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 2e 20 20 is allocated.
328a0 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 */. if( pBt
328b0 2d 3e 62 74 73 46 6c 61 67 73 20 26 20 42 54 53 ->btsFlags & BTS
328c0 5f 53 45 43 55 52 45 5f 44 45 4c 45 54 45 20 29 _SECURE_DELETE )
328d0 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69 4f {. int iO
328e0 66 66 3b 0a 0a 20 20 20 20 20 20 20 20 69 4f 66 ff;.. iOf
328f0 66 20 3d 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 f = SQLITE_PTR_T
32900 4f 5f 49 4e 54 28 61 70 44 69 76 5b 69 5d 29 20 O_INT(apDiv[i])
32910 2d 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f - SQLITE_PTR_TO_
32920 49 4e 54 28 70 50 61 72 65 6e 74 2d 3e 61 44 61 INT(pParent->aDa
32930 74 61 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ta);. if(
32940 20 28 69 4f 66 66 2b 73 7a 4e 65 77 5b 69 5d 29 (iOff+szNew[i])
32950 3e 28 69 6e 74 29 70 42 74 2d 3e 75 73 61 62 6c >(int)pBt->usabl
32960 65 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 eSize ){.
32970 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 rc = SQLITE_C
32980 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 20 ORRUPT_BKPT;.
32990 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 61 70 memset(ap
329a0 4f 6c 64 2c 20 30 2c 20 28 69 2b 31 29 2a 73 69 Old, 0, (i+1)*si
329b0 7a 65 6f 66 28 4d 65 6d 50 61 67 65 2a 29 29 3b zeof(MemPage*));
329c0 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 . goto
329d0 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b balance_cleanup;
329e0 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
329f0 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 memcpy
32a00 28 26 61 4f 76 66 6c 53 70 61 63 65 5b 69 4f 66 (&aOvflSpace[iOf
32a10 66 5d 2c 20 61 70 44 69 76 5b 69 5d 2c 20 73 7a f], apDiv[i], sz
32a20 4e 65 77 5b 69 5d 29 3b 0a 20 20 20 20 20 20 20 New[i]);.
32a30 20 20 20 61 70 44 69 76 5b 69 5d 20 3d 20 26 61 apDiv[i] = &a
32a40 4f 76 66 6c 53 70 61 63 65 5b 61 70 44 69 76 5b OvflSpace[apDiv[
32a50 69 5d 2d 70 50 61 72 65 6e 74 2d 3e 61 44 61 74 i]-pParent->aDat
32a60 61 5d 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 a];. }.
32a70 20 20 20 20 7d 0a 20 20 20 20 20 20 64 72 6f 70 }. drop
32a80 43 65 6c 6c 28 70 50 61 72 65 6e 74 2c 20 69 2b Cell(pParent, i+
32a90 6e 78 44 69 76 2d 70 50 61 72 65 6e 74 2d 3e 6e nxDiv-pParent->n
32aa0 4f 76 65 72 66 6c 6f 77 2c 20 73 7a 4e 65 77 5b Overflow, szNew[
32ab0 69 5d 2c 20 26 72 63 29 3b 0a 20 20 20 20 7d 0a i], &rc);. }.
32ac0 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 6b 65 20 6e }.. /* Make n
32ad0 4d 61 78 43 65 6c 6c 73 20 61 20 6d 75 6c 74 69 MaxCells a multi
32ae0 70 6c 65 20 6f 66 20 34 20 69 6e 20 6f 72 64 65 ple of 4 in orde
32af0 72 20 74 6f 20 70 72 65 73 65 72 76 65 20 38 2d r to preserve 8-
32b00 62 79 74 65 0a 20 20 2a 2a 20 61 6c 69 67 6e 6d byte. ** alignm
32b10 65 6e 74 20 2a 2f 0a 20 20 6e 4d 61 78 43 65 6c ent */. nMaxCel
32b20 6c 73 20 3d 20 28 6e 4d 61 78 43 65 6c 6c 73 20 ls = (nMaxCells
32b30 2b 20 33 29 26 7e 33 3b 0a 0a 20 20 2f 2a 0a 20 + 3)&~3;.. /*.
32b40 20 2a 2a 20 41 6c 6c 6f 63 61 74 65 20 73 70 61 ** Allocate spa
32b50 63 65 20 66 6f 72 20 6d 65 6d 6f 72 79 20 73 74 ce for memory st
32b60 72 75 63 74 75 72 65 73 0a 20 20 2a 2f 0a 20 20 ructures. */.
32b70 6b 20 3d 20 70 42 74 2d 3e 70 61 67 65 53 69 7a k = pBt->pageSiz
32b80 65 20 2b 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f e + ROUND8(sizeo
32b90 66 28 4d 65 6d 50 61 67 65 29 29 3b 0a 20 20 73 f(MemPage));. s
32ba0 7a 53 63 72 61 74 63 68 20 3d 0a 20 20 20 20 20 zScratch =.
32bb0 20 20 6e 4d 61 78 43 65 6c 6c 73 2a 73 69 7a 65 nMaxCells*size
32bc0 6f 66 28 75 38 2a 29 20 20 20 20 20 20 20 20 20 of(u8*)
32bd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
32be0 20 61 70 43 65 6c 6c 20 2a 2f 0a 20 20 20 20 20 apCell */.
32bf0 2b 20 6e 4d 61 78 43 65 6c 6c 73 2a 73 69 7a 65 + nMaxCells*size
32c00 6f 66 28 75 31 36 29 20 20 20 20 20 20 20 20 20 of(u16)
32c10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
32c20 20 73 7a 43 65 6c 6c 20 2a 2f 0a 20 20 20 20 20 szCell */.
32c30 2b 20 70 42 74 2d 3e 70 61 67 65 53 69 7a 65 20 + pBt->pageSize
32c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32c50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
32c60 20 61 53 70 61 63 65 31 20 2a 2f 0a 20 20 20 20 aSpace1 */.
32c70 20 2b 20 6b 2a 6e 4f 6c 64 3b 20 20 20 20 20 20 + k*nOld;
32c80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
32c90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
32ca0 2a 20 50 61 67 65 20 63 6f 70 69 65 73 20 28 61 * Page copies (a
32cb0 70 43 6f 70 79 29 20 2a 2f 0a 20 20 61 70 43 65 pCopy) */. apCe
32cc0 6c 6c 20 3d 20 73 71 6c 69 74 65 33 53 63 72 61 ll = sqlite3Scra
32cd0 74 63 68 4d 61 6c 6c 6f 63 28 20 73 7a 53 63 72 tchMalloc( szScr
32ce0 61 74 63 68 20 29 3b 20 0a 20 20 69 66 28 20 61 atch ); . if( a
32cf0 70 43 65 6c 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 pCell==0 ){.
32d00 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
32d10 4d 3b 0a 20 20 20 20 67 6f 74 6f 20 62 61 6c 61 M;. goto bala
32d20 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 20 7d nce_cleanup;. }
32d30 0a 20 20 73 7a 43 65 6c 6c 20 3d 20 28 75 31 36 . szCell = (u16
32d40 2a 29 26 61 70 43 65 6c 6c 5b 6e 4d 61 78 43 65 *)&apCell[nMaxCe
32d50 6c 6c 73 5d 3b 0a 20 20 61 53 70 61 63 65 31 20 lls];. aSpace1
32d60 3d 20 28 75 38 2a 29 26 73 7a 43 65 6c 6c 5b 6e = (u8*)&szCell[n
32d70 4d 61 78 43 65 6c 6c 73 5d 3b 0a 20 20 61 73 73 MaxCells];. ass
32d80 65 72 74 28 20 45 49 47 48 54 5f 42 59 54 45 5f ert( EIGHT_BYTE_
32d90 41 4c 49 47 4e 4d 45 4e 54 28 61 53 70 61 63 65 ALIGNMENT(aSpace
32da0 31 29 20 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 1) );.. /*. **
32db0 20 4c 6f 61 64 20 70 6f 69 6e 74 65 72 73 20 74 Load pointers t
32dc0 6f 20 61 6c 6c 20 63 65 6c 6c 73 20 6f 6e 20 73 o all cells on s
32dd0 69 62 6c 69 6e 67 20 70 61 67 65 73 20 61 6e 64 ibling pages and
32de0 20 74 68 65 20 64 69 76 69 64 65 72 20 63 65 6c the divider cel
32df0 6c 73 0a 20 20 2a 2a 20 69 6e 74 6f 20 74 68 65 ls. ** into the
32e00 20 6c 6f 63 61 6c 20 61 70 43 65 6c 6c 5b 5d 20 local apCell[]
32e10 61 72 72 61 79 2e 20 20 4d 61 6b 65 20 63 6f 70 array. Make cop
32e20 69 65 73 20 6f 66 20 74 68 65 20 64 69 76 69 64 ies of the divid
32e30 65 72 20 63 65 6c 6c 73 0a 20 20 2a 2a 20 69 6e er cells. ** in
32e40 74 6f 20 73 70 61 63 65 20 6f 62 74 61 69 6e 65 to space obtaine
32e50 64 20 66 72 6f 6d 20 61 53 70 61 63 65 31 5b 5d d from aSpace1[]
32e60 20 61 6e 64 20 72 65 6d 6f 76 65 20 74 68 65 20 and remove the
32e70 64 69 76 69 64 65 72 20 63 65 6c 6c 73 0a 20 20 divider cells.
32e80 2a 2a 20 66 72 6f 6d 20 70 50 61 72 65 6e 74 2e ** from pParent.
32e90 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68 . **. ** If th
32ea0 65 20 73 69 62 6c 69 6e 67 73 20 61 72 65 20 6f e siblings are o
32eb0 6e 20 6c 65 61 66 20 70 61 67 65 73 2c 20 74 68 n leaf pages, th
32ec0 65 6e 20 74 68 65 20 63 68 69 6c 64 20 70 6f 69 en the child poi
32ed0 6e 74 65 72 73 20 6f 66 20 74 68 65 0a 20 20 2a nters of the. *
32ee0 2a 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 20 * divider cells
32ef0 61 72 65 20 73 74 72 69 70 70 65 64 20 66 72 6f are stripped fro
32f00 6d 20 74 68 65 20 63 65 6c 6c 73 20 62 65 66 6f m the cells befo
32f10 72 65 20 74 68 65 79 20 61 72 65 20 63 6f 70 69 re they are copi
32f20 65 64 0a 20 20 2a 2a 20 69 6e 74 6f 20 61 53 70 ed. ** into aSp
32f30 61 63 65 31 5b 5d 2e 20 20 49 6e 20 74 68 69 73 ace1[]. In this
32f40 20 77 61 79 2c 20 61 6c 6c 20 63 65 6c 6c 73 20 way, all cells
32f50 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 61 72 65 20 in apCell[] are
32f60 77 69 74 68 6f 75 74 0a 20 20 2a 2a 20 63 68 69 without. ** chi
32f70 6c 64 20 70 6f 69 6e 74 65 72 73 2e 20 20 49 66 ld pointers. If
32f80 20 73 69 62 6c 69 6e 67 73 20 61 72 65 20 6e 6f siblings are no
32f90 74 20 6c 65 61 76 65 73 2c 20 74 68 65 6e 20 61 t leaves, then a
32fa0 6c 6c 20 63 65 6c 6c 20 69 6e 0a 20 20 2a 2a 20 ll cell in. **
32fb0 61 70 43 65 6c 6c 5b 5d 20 69 6e 63 6c 75 64 65 apCell[] include
32fc0 20 63 68 69 6c 64 20 70 6f 69 6e 74 65 72 73 2e child pointers.
32fd0 20 20 45 69 74 68 65 72 20 77 61 79 2c 20 61 6c Either way, al
32fe0 6c 20 63 65 6c 6c 73 20 69 6e 20 61 70 43 65 6c l cells in apCel
32ff0 6c 5b 5d 0a 20 20 2a 2a 20 61 72 65 20 61 6c 69 l[]. ** are ali
33000 6b 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 6c 65 ke.. **. ** le
33010 61 66 43 6f 72 72 65 63 74 69 6f 6e 3a 20 20 34 afCorrection: 4
33020 20 69 66 20 70 50 61 67 65 20 69 73 20 61 20 6c if pPage is a l
33030 65 61 66 2e 20 20 30 20 69 66 20 70 50 61 67 65 eaf. 0 if pPage
33040 20 69 73 20 6e 6f 74 20 61 20 6c 65 61 66 2e 0a is not a leaf..
33050 20 20 2a 2a 20 20 20 20 20 20 20 6c 65 61 66 44 ** leafD
33060 61 74 61 3a 20 20 31 20 69 66 20 70 50 61 67 65 ata: 1 if pPage
33070 20 68 6f 6c 64 73 20 6b 65 79 2b 64 61 74 61 20 holds key+data
33080 61 6e 64 20 70 50 61 72 65 6e 74 20 68 6f 6c 64 and pParent hold
33090 73 20 6f 6e 6c 79 20 6b 65 79 73 2e 0a 20 20 2a s only keys.. *
330a0 2f 0a 20 20 6c 65 61 66 43 6f 72 72 65 63 74 69 /. leafCorrecti
330b0 6f 6e 20 3d 20 61 70 4f 6c 64 5b 30 5d 2d 3e 6c on = apOld[0]->l
330c0 65 61 66 2a 34 3b 0a 20 20 6c 65 61 66 44 61 74 eaf*4;. leafDat
330d0 61 20 3d 20 61 70 4f 6c 64 5b 30 5d 2d 3e 68 61 a = apOld[0]->ha
330e0 73 44 61 74 61 3b 0a 20 20 66 6f 72 28 69 3d 30 sData;. for(i=0
330f0 3b 20 69 3c 6e 4f 6c 64 3b 20 69 2b 2b 29 7b 0a ; i<nOld; i++){.
33100 20 20 20 20 69 6e 74 20 6c 69 6d 69 74 3b 0a 20 int limit;.
33110 20 20 20 0a 20 20 20 20 2f 2a 20 42 65 66 6f 72 . /* Befor
33120 65 20 64 6f 69 6e 67 20 61 6e 79 74 68 69 6e 67 e doing anything
33130 20 65 6c 73 65 2c 20 74 61 6b 65 20 61 20 63 6f else, take a co
33140 70 79 20 6f 66 20 74 68 65 20 69 27 74 68 20 6f py of the i'th o
33150 72 69 67 69 6e 61 6c 20 73 69 62 6c 69 6e 67 0a riginal sibling.
33160 20 20 20 20 2a 2a 20 54 68 65 20 72 65 73 74 20 ** The rest
33170 6f 66 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e of this function
33180 20 77 69 6c 6c 20 75 73 65 20 64 61 74 61 20 66 will use data f
33190 72 6f 6d 20 74 68 65 20 63 6f 70 69 65 73 20 72 rom the copies r
331a0 61 74 68 65 72 0a 20 20 20 20 2a 2a 20 74 68 61 ather. ** tha
331b0 74 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 t the original p
331c0 61 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 6f ages since the o
331d0 72 69 67 69 6e 61 6c 20 70 61 67 65 73 20 77 69 riginal pages wi
331e0 6c 6c 20 62 65 20 69 6e 20 74 68 65 0a 20 20 20 ll be in the.
331f0 20 2a 2a 20 70 72 6f 63 65 73 73 20 6f 66 20 62 ** process of b
33200 65 69 6e 67 20 6f 76 65 72 77 72 69 74 74 65 6e eing overwritten
33210 2e 20 20 2a 2f 0a 20 20 20 20 4d 65 6d 50 61 67 . */. MemPag
33220 65 20 2a 70 4f 6c 64 20 3d 20 61 70 43 6f 70 79 e *pOld = apCopy
33230 5b 69 5d 20 3d 20 28 4d 65 6d 50 61 67 65 2a 29 [i] = (MemPage*)
33240 26 61 53 70 61 63 65 31 5b 70 42 74 2d 3e 70 61 &aSpace1[pBt->pa
33250 67 65 53 69 7a 65 20 2b 20 6b 2a 69 5d 3b 0a 20 geSize + k*i];.
33260 20 20 20 6d 65 6d 63 70 79 28 70 4f 6c 64 2c 20 memcpy(pOld,
33270 61 70 4f 6c 64 5b 69 5d 2c 20 73 69 7a 65 6f 66 apOld[i], sizeof
33280 28 4d 65 6d 50 61 67 65 29 29 3b 0a 20 20 20 20 (MemPage));.
33290 70 4f 6c 64 2d 3e 61 44 61 74 61 20 3d 20 28 76 pOld->aData = (v
332a0 6f 69 64 2a 29 26 70 4f 6c 64 5b 31 5d 3b 0a 20 oid*)&pOld[1];.
332b0 20 20 20 6d 65 6d 63 70 79 28 70 4f 6c 64 2d 3e memcpy(pOld->
332c0 61 44 61 74 61 2c 20 61 70 4f 6c 64 5b 69 5d 2d aData, apOld[i]-
332d0 3e 61 44 61 74 61 2c 20 70 42 74 2d 3e 70 61 67 >aData, pBt->pag
332e0 65 53 69 7a 65 29 3b 0a 0a 20 20 20 20 6c 69 6d eSize);.. lim
332f0 69 74 20 3d 20 70 4f 6c 64 2d 3e 6e 43 65 6c 6c it = pOld->nCell
33300 2b 70 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f 77 +pOld->nOverflow
33310 3b 0a 20 20 20 20 69 66 28 20 70 4f 6c 64 2d 3e ;. if( pOld->
33320 6e 4f 76 65 72 66 6c 6f 77 3e 30 20 29 7b 0a 20 nOverflow>0 ){.
33330 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c for(j=0; j<
33340 6c 69 6d 69 74 3b 20 6a 2b 2b 29 7b 0a 20 20 20 limit; j++){.
33350 20 20 20 20 20 61 73 73 65 72 74 28 20 6e 43 65 assert( nCe
33360 6c 6c 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b 0a ll<nMaxCells );.
33370 20 20 20 20 20 20 20 20 61 70 43 65 6c 6c 5b 6e apCell[n
33380 43 65 6c 6c 5d 20 3d 20 66 69 6e 64 4f 76 65 72 Cell] = findOver
33390 66 6c 6f 77 43 65 6c 6c 28 70 4f 6c 64 2c 20 6a flowCell(pOld, j
333a0 29 3b 0a 20 20 20 20 20 20 20 20 73 7a 43 65 6c );. szCel
333b0 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 63 65 6c 6c 53 l[nCell] = cellS
333c0 69 7a 65 50 74 72 28 70 4f 6c 64 2c 20 61 70 43 izePtr(pOld, apC
333d0 65 6c 6c 5b 6e 43 65 6c 6c 5d 29 3b 0a 20 20 20 ell[nCell]);.
333e0 20 20 20 20 20 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 nCell++;.
333f0 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b }. }else{
33400 0a 20 20 20 20 20 20 75 38 20 2a 61 44 61 74 61 . u8 *aData
33410 20 3d 20 70 4f 6c 64 2d 3e 61 44 61 74 61 3b 0a = pOld->aData;.
33420 20 20 20 20 20 20 75 31 36 20 6d 61 73 6b 50 61 u16 maskPa
33430 67 65 20 3d 20 70 4f 6c 64 2d 3e 6d 61 73 6b 50 ge = pOld->maskP
33440 61 67 65 3b 0a 20 20 20 20 20 20 75 31 36 20 63 age;. u16 c
33450 65 6c 6c 4f 66 66 73 65 74 20 3d 20 70 4f 6c 64 ellOffset = pOld
33460 2d 3e 63 65 6c 6c 4f 66 66 73 65 74 3b 0a 20 20 ->cellOffset;.
33470 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 6c for(j=0; j<l
33480 69 6d 69 74 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 imit; j++){.
33490 20 20 20 20 61 73 73 65 72 74 28 20 6e 43 65 6c assert( nCel
334a0 6c 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b 0a 20 l<nMaxCells );.
334b0 20 20 20 20 20 20 20 61 70 43 65 6c 6c 5b 6e 43 apCell[nC
334c0 65 6c 6c 5d 20 3d 20 66 69 6e 64 43 65 6c 6c 76 ell] = findCellv
334d0 32 28 61 44 61 74 61 2c 20 6d 61 73 6b 50 61 67 2(aData, maskPag
334e0 65 2c 20 63 65 6c 6c 4f 66 66 73 65 74 2c 20 6a e, cellOffset, j
334f0 29 3b 0a 20 20 20 20 20 20 20 20 73 7a 43 65 6c );. szCel
33500 6c 5b 6e 43 65 6c 6c 5d 20 3d 20 63 65 6c 6c 53 l[nCell] = cellS
33510 69 7a 65 50 74 72 28 70 4f 6c 64 2c 20 61 70 43 izePtr(pOld, apC
33520 65 6c 6c 5b 6e 43 65 6c 6c 5d 29 3b 0a 20 20 20 ell[nCell]);.
33530 20 20 20 20 20 6e 43 65 6c 6c 2b 2b 3b 0a 20 20 nCell++;.
33540 20 20 20 20 7d 0a 20 20 20 20 7d 20 20 20 20 20 }. }
33550 20 20 0a 20 20 20 20 69 66 28 20 69 3c 6e 4f 6c . if( i<nOl
33560 64 2d 31 20 26 26 20 21 6c 65 61 66 44 61 74 61 d-1 && !leafData
33570 29 7b 0a 20 20 20 20 20 20 75 31 36 20 73 7a 20 ){. u16 sz
33580 3d 20 28 75 31 36 29 73 7a 4e 65 77 5b 69 5d 3b = (u16)szNew[i];
33590 0a 20 20 20 20 20 20 75 38 20 2a 70 54 65 6d 70 . u8 *pTemp
335a0 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
335b0 6e 43 65 6c 6c 3c 6e 4d 61 78 43 65 6c 6c 73 20 nCell<nMaxCells
335c0 29 3b 0a 20 20 20 20 20 20 73 7a 43 65 6c 6c 5b );. szCell[
335d0 6e 43 65 6c 6c 5d 20 3d 20 73 7a 3b 0a 20 20 20 nCell] = sz;.
335e0 20 20 20 70 54 65 6d 70 20 3d 20 26 61 53 70 61 pTemp = &aSpa
335f0 63 65 31 5b 69 53 70 61 63 65 31 5d 3b 0a 20 20 ce1[iSpace1];.
33600 20 20 20 20 69 53 70 61 63 65 31 20 2b 3d 20 73 iSpace1 += s
33610 7a 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 z;. assert(
33620 20 73 7a 3c 3d 70 42 74 2d 3e 6d 61 78 4c 6f 63 sz<=pBt->maxLoc
33630 61 6c 2b 32 33 20 29 3b 0a 20 20 20 20 20 20 61 al+23 );. a
33640 73 73 65 72 74 28 20 69 53 70 61 63 65 31 20 3c ssert( iSpace1 <
33650 3d 20 28 69 6e 74 29 70 42 74 2d 3e 70 61 67 65 = (int)pBt->page
33660 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 6d 65 Size );. me
33670 6d 63 70 79 28 70 54 65 6d 70 2c 20 61 70 44 69 mcpy(pTemp, apDi
33680 76 5b 69 5d 2c 20 73 7a 29 3b 0a 20 20 20 20 20 v[i], sz);.
33690 20 61 70 43 65 6c 6c 5b 6e 43 65 6c 6c 5d 20 3d apCell[nCell] =
336a0 20 70 54 65 6d 70 2b 6c 65 61 66 43 6f 72 72 65 pTemp+leafCorre
336b0 63 74 69 6f 6e 3b 0a 20 20 20 20 20 20 61 73 73 ction;. ass
336c0 65 72 74 28 20 6c 65 61 66 43 6f 72 72 65 63 74 ert( leafCorrect
336d0 69 6f 6e 3d 3d 30 20 7c 7c 20 6c 65 61 66 43 6f ion==0 || leafCo
336e0 72 72 65 63 74 69 6f 6e 3d 3d 34 20 29 3b 0a 20 rrection==4 );.
336f0 20 20 20 20 20 73 7a 43 65 6c 6c 5b 6e 43 65 6c szCell[nCel
33700 6c 5d 20 3d 20 73 7a 43 65 6c 6c 5b 6e 43 65 6c l] = szCell[nCel
33710 6c 5d 20 2d 20 6c 65 61 66 43 6f 72 72 65 63 74 l] - leafCorrect
33720 69 6f 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 21 ion;. if( !
33730 70 4f 6c 64 2d 3e 6c 65 61 66 20 29 7b 0a 20 20 pOld->leaf ){.
33740 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6c 65 assert( le
33750 61 66 43 6f 72 72 65 63 74 69 6f 6e 3d 3d 30 20 afCorrection==0
33760 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
33770 74 28 20 70 4f 6c 64 2d 3e 68 64 72 4f 66 66 73 t( pOld->hdrOffs
33780 65 74 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 et==0 );.
33790 20 2f 2a 20 54 68 65 20 72 69 67 68 74 20 70 6f /* The right po
337a0 69 6e 74 65 72 20 6f 66 20 74 68 65 20 63 68 69 inter of the chi
337b0 6c 64 20 70 61 67 65 20 70 4f 6c 64 20 62 65 63 ld page pOld bec
337c0 6f 6d 65 73 20 74 68 65 20 6c 65 66 74 0a 20 20 omes the left.
337d0 20 20 20 20 20 20 2a 2a 20 70 6f 69 6e 74 65 72 ** pointer
337e0 20 6f 66 20 74 68 65 20 64 69 76 69 64 65 72 20 of the divider
337f0 63 65 6c 6c 20 2a 2f 0a 20 20 20 20 20 20 20 20 cell */.
33800 6d 65 6d 63 70 79 28 61 70 43 65 6c 6c 5b 6e 43 memcpy(apCell[nC
33810 65 6c 6c 5d 2c 20 26 70 4f 6c 64 2d 3e 61 44 61 ell], &pOld->aDa
33820 74 61 5b 38 5d 2c 20 34 29 3b 0a 20 20 20 20 20 ta[8], 4);.
33830 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
33840 61 73 73 65 72 74 28 20 6c 65 61 66 43 6f 72 72 assert( leafCorr
33850 65 63 74 69 6f 6e 3d 3d 34 20 29 3b 0a 20 20 20 ection==4 );.
33860 20 20 20 20 20 69 66 28 20 73 7a 43 65 6c 6c 5b if( szCell[
33870 6e 43 65 6c 6c 5d 3c 34 20 29 7b 0a 20 20 20 20 nCell]<4 ){.
33880 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 /* Do not
33890 61 6c 6c 6f 77 20 61 6e 79 20 63 65 6c 6c 73 20 allow any cells
338a0 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 34 20 62 smaller than 4 b
338b0 79 74 65 73 2e 20 2a 2f 0a 20 20 20 20 20 20 20 ytes. */.
338c0 20 20 20 73 7a 43 65 6c 6c 5b 6e 43 65 6c 6c 5d szCell[nCell]
338d0 20 3d 20 34 3b 0a 20 20 20 20 20 20 20 20 7d 0a = 4;. }.
338e0 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 43 }. nC
338f0 65 6c 6c 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d ell++;. }. }
33900 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 46 69 67 75 .. /*. ** Figu
33910 72 65 20 6f 75 74 20 74 68 65 20 6e 75 6d 62 65 re out the numbe
33920 72 20 6f 66 20 70 61 67 65 73 20 6e 65 65 64 65 r of pages neede
33930 64 20 74 6f 20 68 6f 6c 64 20 61 6c 6c 20 6e 43 d to hold all nC
33940 65 6c 6c 20 63 65 6c 6c 73 2e 0a 20 20 2a 2a 20 ell cells.. **
33950 53 74 6f 72 65 20 74 68 69 73 20 6e 75 6d 62 65 Store this numbe
33960 72 20 69 6e 20 22 6b 22 2e 20 20 41 6c 73 6f 20 r in "k". Also
33970 63 6f 6d 70 75 74 65 20 73 7a 4e 65 77 5b 5d 20 compute szNew[]
33980 77 68 69 63 68 20 69 73 20 74 68 65 20 74 6f 74 which is the tot
33990 61 6c 0a 20 20 2a 2a 20 73 69 7a 65 20 6f 66 20 al. ** size of
339a0 61 6c 6c 20 63 65 6c 6c 73 20 6f 6e 20 74 68 65 all cells on the
339b0 20 69 2d 74 68 20 70 61 67 65 20 61 6e 64 20 63 i-th page and c
339c0 6e 74 4e 65 77 5b 5d 20 77 68 69 63 68 20 69 73 ntNew[] which is
339d0 20 74 68 65 20 69 6e 64 65 78 0a 20 20 2a 2a 20 the index. **
339e0 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 6f 66 20 74 in apCell[] of t
339f0 68 65 20 63 65 6c 6c 20 74 68 61 74 20 64 69 76 he cell that div
33a00 69 64 65 73 20 70 61 67 65 20 69 20 66 72 6f 6d ides page i from
33a10 20 70 61 67 65 20 69 2b 31 2e 20 20 0a 20 20 2a page i+1. . *
33a20 2a 20 63 6e 74 4e 65 77 5b 6b 5d 20 73 68 6f 75 * cntNew[k] shou
33a30 6c 64 20 65 71 75 61 6c 20 6e 43 65 6c 6c 2e 0a ld equal nCell..
33a40 20 20 2a 2a 0a 20 20 2a 2a 20 56 61 6c 75 65 73 **. ** Values
33a50 20 63 6f 6d 70 75 74 65 64 20 62 79 20 74 68 69 computed by thi
33a60 73 20 62 6c 6f 63 6b 3a 0a 20 20 2a 2a 0a 20 20 s block:. **.
33a70 2a 2a 20 20 20 20 20 20 20 20 20 20 20 6b 3a 20 ** k:
33a80 54 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 The total number
33a90 20 6f 66 20 73 69 62 6c 69 6e 67 20 70 61 67 65 of sibling page
33aa0 73 0a 20 20 2a 2a 20 20 20 20 73 7a 4e 65 77 5b s. ** szNew[
33ab0 69 5d 3a 20 53 70 61 63 65 64 20 75 73 65 64 20 i]: Spaced used
33ac0 6f 6e 20 74 68 65 20 69 2d 74 68 20 73 69 62 6c on the i-th sibl
33ad0 69 6e 67 20 70 61 67 65 2e 0a 20 20 2a 2a 20 20 ing page.. **
33ae0 20 63 6e 74 4e 65 77 5b 69 5d 3a 20 49 6e 64 65 cntNew[i]: Inde
33af0 78 20 69 6e 20 61 70 43 65 6c 6c 5b 5d 20 61 6e x in apCell[] an
33b00 64 20 73 7a 43 65 6c 6c 5b 5d 20 66 6f 72 20 74 d szCell[] for t
33b10 68 65 20 66 69 72 73 74 20 63 65 6c 6c 20 74 6f he first cell to
33b20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 20 20 20 . **
33b30 20 20 20 74 68 65 20 72 69 67 68 74 20 6f 66 20 the right of
33b40 74 68 65 20 69 2d 74 68 20 73 69 62 6c 69 6e 67 the i-th sibling
33b50 20 70 61 67 65 2e 0a 20 20 2a 2a 20 75 73 61 62 page.. ** usab
33b60 6c 65 53 70 61 63 65 3a 20 4e 75 6d 62 65 72 20 leSpace: Number
33b70 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 of bytes of spac
33b80 65 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 65 e available on e
33b90 61 63 68 20 73 69 62 6c 69 6e 67 2e 0a 20 20 2a ach sibling.. *
33ba0 2a 20 0a 20 20 2a 2f 0a 20 20 75 73 61 62 6c 65 * . */. usable
33bb0 53 70 61 63 65 20 3d 20 70 42 74 2d 3e 75 73 61 Space = pBt->usa
33bc0 62 6c 65 53 69 7a 65 20 2d 20 31 32 20 2b 20 6c bleSize - 12 + l
33bd0 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 3b 0a 20 eafCorrection;.
33be0 20 66 6f 72 28 73 75 62 74 6f 74 61 6c 3d 6b 3d for(subtotal=k=
33bf0 69 3d 30 3b 20 69 3c 6e 43 65 6c 6c 3b 20 69 2b i=0; i<nCell; i+
33c00 2b 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 +){. assert(
33c10 69 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b 0a 20 i<nMaxCells );.
33c20 20 20 20 73 75 62 74 6f 74 61 6c 20 2b 3d 20 73 subtotal += s
33c30 7a 43 65 6c 6c 5b 69 5d 20 2b 20 32 3b 0a 20 20 zCell[i] + 2;.
33c40 20 20 69 66 28 20 73 75 62 74 6f 74 61 6c 20 3e if( subtotal >
33c50 20 75 73 61 62 6c 65 53 70 61 63 65 20 29 7b 0a usableSpace ){.
33c60 20 20 20 20 20 20 73 7a 4e 65 77 5b 6b 5d 20 3d szNew[k] =
33c70 20 73 75 62 74 6f 74 61 6c 20 2d 20 73 7a 43 65 subtotal - szCe
33c80 6c 6c 5b 69 5d 3b 0a 20 20 20 20 20 20 63 6e 74 ll[i];. cnt
33c90 4e 65 77 5b 6b 5d 20 3d 20 69 3b 0a 20 20 20 20 New[k] = i;.
33ca0 20 20 69 66 28 20 6c 65 61 66 44 61 74 61 20 29 if( leafData )
33cb0 7b 20 69 2d 2d 3b 20 7d 0a 20 20 20 20 20 20 73 { i--; }. s
33cc0 75 62 74 6f 74 61 6c 20 3d 20 30 3b 0a 20 20 20 ubtotal = 0;.
33cd0 20 20 20 6b 2b 2b 3b 0a 20 20 20 20 20 20 69 66 k++;. if
33ce0 28 20 6b 3e 4e 42 2b 31 20 29 7b 20 72 63 20 3d ( k>NB+1 ){ rc =
33cf0 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
33d00 42 4b 50 54 3b 20 67 6f 74 6f 20 62 61 6c 61 6e BKPT; goto balan
33d10 63 65 5f 63 6c 65 61 6e 75 70 3b 20 7d 0a 20 20 ce_cleanup; }.
33d20 20 20 7d 0a 20 20 7d 0a 20 20 73 7a 4e 65 77 5b }. }. szNew[
33d30 6b 5d 20 3d 20 73 75 62 74 6f 74 61 6c 3b 0a 20 k] = subtotal;.
33d40 20 63 6e 74 4e 65 77 5b 6b 5d 20 3d 20 6e 43 65 cntNew[k] = nCe
33d50 6c 6c 3b 0a 20 20 6b 2b 2b 3b 0a 0a 20 20 2f 2a ll;. k++;.. /*
33d60 0a 20 20 2a 2a 20 54 68 65 20 70 61 63 6b 69 6e . ** The packin
33d70 67 20 63 6f 6d 70 75 74 65 64 20 62 79 20 74 68 g computed by th
33d80 65 20 70 72 65 76 69 6f 75 73 20 62 6c 6f 63 6b e previous block
33d90 20 69 73 20 62 69 61 73 65 64 20 74 6f 77 61 72 is biased towar
33da0 64 20 74 68 65 20 73 69 62 6c 69 6e 67 73 0a 20 d the siblings.
33db0 20 2a 2a 20 6f 6e 20 74 68 65 20 6c 65 66 74 20 ** on the left
33dc0 73 69 64 65 2e 20 20 54 68 65 20 6c 65 66 74 20 side. The left
33dd0 73 69 62 6c 69 6e 67 73 20 61 72 65 20 61 6c 77 siblings are alw
33de0 61 79 73 20 6e 65 61 72 6c 79 20 66 75 6c 6c 2c ays nearly full,
33df0 20 77 68 69 6c 65 20 74 68 65 0a 20 20 2a 2a 20 while the. **
33e00 72 69 67 68 74 2d 6d 6f 73 74 20 73 69 62 6c 69 right-most sibli
33e10 6e 67 20 6d 69 67 68 74 20 62 65 20 6e 65 61 72 ng might be near
33e20 6c 79 20 65 6d 70 74 79 2e 20 20 54 68 69 73 20 ly empty. This
33e30 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 61 74 block of code at
33e40 74 65 6d 70 74 73 0a 20 20 2a 2a 20 74 6f 20 61 tempts. ** to a
33e50 64 6a 75 73 74 20 74 68 65 20 70 61 63 6b 69 6e djust the packin
33e60 67 20 6f 66 20 73 69 62 6c 69 6e 67 73 20 74 6f g of siblings to
33e70 20 67 65 74 20 61 20 62 65 74 74 65 72 20 62 61 get a better ba
33e80 6c 61 6e 63 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a lance.. **. **
33e90 20 54 68 69 73 20 61 64 6a 75 73 74 6d 65 6e 74 This adjustment
33ea0 20 69 73 20 6d 6f 72 65 20 74 68 61 6e 20 61 6e is more than an
33eb0 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 20 20 optimization.
33ec0 54 68 65 20 70 61 63 6b 69 6e 67 20 61 62 6f 76 The packing abov
33ed0 65 20 6d 69 67 68 74 0a 20 20 2a 2a 20 62 65 20 e might. ** be
33ee0 73 6f 20 6f 75 74 20 6f 66 20 62 61 6c 61 6e 63 so out of balanc
33ef0 65 20 61 73 20 74 6f 20 62 65 20 69 6c 6c 65 67 e as to be illeg
33f00 61 6c 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 al. For example
33f10 2c 20 74 68 65 20 72 69 67 68 74 2d 6d 6f 73 74 , the right-most
33f20 0a 20 20 2a 2a 20 73 69 62 6c 69 6e 67 20 6d 69 . ** sibling mi
33f30 67 68 74 20 62 65 20 63 6f 6d 70 6c 65 74 65 6c ght be completel
33f40 79 20 65 6d 70 74 79 2e 20 20 54 68 69 73 20 61 y empty. This a
33f50 64 6a 75 73 74 6d 65 6e 74 20 69 73 20 6e 6f 74 djustment is not
33f60 20 6f 70 74 69 6f 6e 61 6c 2e 0a 20 20 2a 2f 0a optional.. */.
33f70 20 20 66 6f 72 28 69 3d 6b 2d 31 3b 20 69 3e 30 for(i=k-1; i>0
33f80 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 69 6e 74 20 ; i--){. int
33f90 73 7a 52 69 67 68 74 20 3d 20 73 7a 4e 65 77 5b szRight = szNew[
33fa0 69 5d 3b 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 i]; /* Size of
33fb0 73 69 62 6c 69 6e 67 20 6f 6e 20 74 68 65 20 72 sibling on the r
33fc0 69 67 68 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ight */. int
33fd0 73 7a 4c 65 66 74 20 3d 20 73 7a 4e 65 77 5b 69 szLeft = szNew[i
33fe0 2d 31 5d 3b 20 2f 2a 20 53 69 7a 65 20 6f 66 20 -1]; /* Size of
33ff0 73 69 62 6c 69 6e 67 20 6f 6e 20 74 68 65 20 6c sibling on the l
34000 65 66 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 eft */. int r
34010 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
34020 2a 20 49 6e 64 65 78 20 6f 66 20 72 69 67 68 74 * Index of right
34030 2d 6d 6f 73 74 20 63 65 6c 6c 20 69 6e 20 6c 65 -most cell in le
34040 66 74 20 73 69 62 6c 69 6e 67 20 2a 2f 0a 20 20 ft sibling */.
34050 20 20 69 6e 74 20 64 3b 20 20 20 20 20 20 20 20 int d;
34060 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f /* Index o
34070 66 20 66 69 72 73 74 20 63 65 6c 6c 20 74 6f 20 f first cell to
34080 74 68 65 20 6c 65 66 74 20 6f 66 20 72 69 67 68 the left of righ
34090 74 20 73 69 62 6c 69 6e 67 20 2a 2f 0a 0a 20 20 t sibling */..
340a0 20 20 72 20 3d 20 63 6e 74 4e 65 77 5b 69 2d 31 r = cntNew[i-1
340b0 5d 20 2d 20 31 3b 0a 20 20 20 20 64 20 3d 20 72 ] - 1;. d = r
340c0 20 2b 20 31 20 2d 20 6c 65 61 66 44 61 74 61 3b + 1 - leafData;
340d0 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 3c 6e . assert( d<n
340e0 4d 61 78 43 65 6c 6c 73 20 29 3b 0a 20 20 20 20 MaxCells );.
340f0 61 73 73 65 72 74 28 20 72 3c 6e 4d 61 78 43 65 assert( r<nMaxCe
34100 6c 6c 73 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 lls );. while
34110 28 20 73 7a 52 69 67 68 74 3d 3d 30 20 0a 20 20 ( szRight==0 .
34120 20 20 20 20 20 7c 7c 20 28 21 62 42 75 6c 6b 20 || (!bBulk
34130 26 26 20 73 7a 52 69 67 68 74 2b 73 7a 43 65 6c && szRight+szCel
34140 6c 5b 64 5d 2b 32 3c 3d 73 7a 4c 65 66 74 2d 28 l[d]+2<=szLeft-(
34150 73 7a 43 65 6c 6c 5b 72 5d 2b 32 29 29 20 0a 20 szCell[r]+2)) .
34160 20 20 20 29 7b 0a 20 20 20 20 20 20 73 7a 52 69 ){. szRi
34170 67 68 74 20 2b 3d 20 73 7a 43 65 6c 6c 5b 64 5d ght += szCell[d]
34180 20 2b 20 32 3b 0a 20 20 20 20 20 20 73 7a 4c 65 + 2;. szLe
34190 66 74 20 2d 3d 20 73 7a 43 65 6c 6c 5b 72 5d 20 ft -= szCell[r]
341a0 2b 20 32 3b 0a 20 20 20 20 20 20 63 6e 74 4e 65 + 2;. cntNe
341b0 77 5b 69 2d 31 5d 2d 2d 3b 0a 20 20 20 20 20 20 w[i-1]--;.
341c0 72 20 3d 20 63 6e 74 4e 65 77 5b 69 2d 31 5d 20 r = cntNew[i-1]
341d0 2d 20 31 3b 0a 20 20 20 20 20 20 64 20 3d 20 72 - 1;. d = r
341e0 20 2b 20 31 20 2d 20 6c 65 61 66 44 61 74 61 3b + 1 - leafData;
341f0 0a 20 20 20 20 7d 0a 20 20 20 20 73 7a 4e 65 77 . }. szNew
34200 5b 69 5d 20 3d 20 73 7a 52 69 67 68 74 3b 0a 20 [i] = szRight;.
34210 20 20 20 73 7a 4e 65 77 5b 69 2d 31 5d 20 3d 20 szNew[i-1] =
34220 73 7a 4c 65 66 74 3b 0a 20 20 7d 0a 0a 20 20 2f szLeft;. }.. /
34230 2a 20 45 69 74 68 65 72 20 77 65 20 66 6f 75 6e * Either we foun
34240 64 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 63 65 d one or more ce
34250 6c 6c 73 20 28 63 6e 74 6e 65 77 5b 30 5d 29 3e lls (cntnew[0])>
34260 30 29 20 6f 72 20 70 50 61 67 65 20 69 73 0a 20 0) or pPage is.
34270 20 2a 2a 20 61 20 76 69 72 74 75 61 6c 20 72 6f ** a virtual ro
34280 6f 74 20 70 61 67 65 2e 20 20 41 20 76 69 72 74 ot page. A virt
34290 75 61 6c 20 72 6f 6f 74 20 70 61 67 65 20 69 73 ual root page is
342a0 20 77 68 65 6e 20 74 68 65 20 72 65 61 6c 20 72 when the real r
342b0 6f 6f 74 0a 20 20 2a 2a 20 70 61 67 65 20 69 73 oot. ** page is
342c0 20 70 61 67 65 20 31 20 61 6e 64 20 77 65 20 61 page 1 and we a
342d0 72 65 20 74 68 65 20 6f 6e 6c 79 20 63 68 69 6c re the only chil
342e0 64 20 6f 66 20 74 68 61 74 20 70 61 67 65 2e 0a d of that page..
342f0 20 20 2a 2a 0a 20 20 2a 2a 20 55 50 44 41 54 45 **. ** UPDATE
34300 3a 20 20 54 68 65 20 61 73 73 65 72 74 28 29 20 : The assert()
34310 62 65 6c 6f 77 20 69 73 20 6e 6f 74 20 6e 65 63 below is not nec
34320 65 73 73 61 72 69 6c 79 20 74 72 75 65 20 69 66 essarily true if
34330 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
34340 2a 2a 20 66 69 6c 65 20 69 73 20 63 6f 72 72 75 ** file is corru
34350 70 74 2e 20 20 54 68 65 20 63 6f 72 72 75 70 74 pt. The corrupt
34360 69 6f 6e 20 77 69 6c 6c 20 62 65 20 64 65 74 65 ion will be dete
34370 63 74 65 64 20 61 6e 64 20 72 65 70 6f 72 74 65 cted and reporte
34380 64 20 6c 61 74 65 72 0a 20 20 2a 2a 20 69 6e 20 d later. ** in
34390 74 68 69 73 20 70 72 6f 63 65 64 75 72 65 20 73 this procedure s
343a0 6f 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 o there is no ne
343b0 65 64 20 74 6f 20 61 63 74 20 75 70 6f 6e 20 69 ed to act upon i
343c0 74 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 23 69 66 20 t now.. */.#if
343d0 30 0a 20 20 61 73 73 65 72 74 28 20 63 6e 74 4e 0. assert( cntN
343e0 65 77 5b 30 5d 3e 30 20 7c 7c 20 28 70 50 61 72 ew[0]>0 || (pPar
343f0 65 6e 74 2d 3e 70 67 6e 6f 3d 3d 31 20 26 26 20 ent->pgno==1 &&
34400 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 3d 3d pParent->nCell==
34410 30 29 20 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 0) );.#endif..
34420 54 52 41 43 45 28 28 22 42 41 4c 41 4e 43 45 3a TRACE(("BALANCE:
34430 20 6f 6c 64 3a 20 25 64 20 25 64 20 25 64 20 20 old: %d %d %d
34440 22 2c 0a 20 20 20 20 61 70 4f 6c 64 5b 30 5d 2d ",. apOld[0]-
34450 3e 70 67 6e 6f 2c 20 0a 20 20 20 20 6e 4f 6c 64 >pgno, . nOld
34460 3e 3d 32 20 3f 20 61 70 4f 6c 64 5b 31 5d 2d 3e >=2 ? apOld[1]->
34470 70 67 6e 6f 20 3a 20 30 2c 0a 20 20 20 20 6e 4f pgno : 0,. nO
34480 6c 64 3e 3d 33 20 3f 20 61 70 4f 6c 64 5b 32 5d ld>=3 ? apOld[2]
34490 2d 3e 70 67 6e 6f 20 3a 20 30 0a 20 20 29 29 3b ->pgno : 0. ));
344a0 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 41 6c 6c 6f .. /*. ** Allo
344b0 63 61 74 65 20 6b 20 6e 65 77 20 70 61 67 65 73 cate k new pages
344c0 2e 20 20 52 65 75 73 65 20 6f 6c 64 20 70 61 67 . Reuse old pag
344d0 65 73 20 77 68 65 72 65 20 70 6f 73 73 69 62 6c es where possibl
344e0 65 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 61 70 e.. */. if( ap
344f0 4f 6c 64 5b 30 5d 2d 3e 70 67 6e 6f 3c 3d 31 20 Old[0]->pgno<=1
34500 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 ){. rc = SQLI
34510 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b TE_CORRUPT_BKPT;
34520 0a 20 20 20 20 67 6f 74 6f 20 62 61 6c 61 6e 63 . goto balanc
34530 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 20 7d 0a 20 e_cleanup;. }.
34540 20 70 61 67 65 46 6c 61 67 73 20 3d 20 61 70 4f pageFlags = apO
34550 6c 64 5b 30 5d 2d 3e 61 44 61 74 61 5b 30 5d 3b ld[0]->aData[0];
34560 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6b 3b . for(i=0; i<k;
34570 20 69 2b 2b 29 7b 0a 20 20 20 20 4d 65 6d 50 61 i++){. MemPa
34580 67 65 20 2a 70 4e 65 77 3b 0a 20 20 20 20 69 66 ge *pNew;. if
34590 28 20 69 3c 6e 4f 6c 64 20 29 7b 0a 20 20 20 20 ( i<nOld ){.
345a0 20 20 70 4e 65 77 20 3d 20 61 70 4e 65 77 5b 69 pNew = apNew[i
345b0 5d 20 3d 20 61 70 4f 6c 64 5b 69 5d 3b 0a 20 20 ] = apOld[i];.
345c0 20 20 20 20 61 70 4f 6c 64 5b 69 5d 20 3d 20 30 apOld[i] = 0
345d0 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
345e0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
345f0 4e 65 77 2d 3e 70 44 62 50 61 67 65 29 3b 0a 20 New->pDbPage);.
34600 20 20 20 20 20 6e 4e 65 77 2b 2b 3b 0a 20 20 20 nNew++;.
34610 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
34620 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 balance_cleanup
34630 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
34640 20 20 20 61 73 73 65 72 74 28 20 69 3e 30 20 29 assert( i>0 )
34650 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 61 6c 6c ;. rc = all
34660 6f 63 61 74 65 42 74 72 65 65 50 61 67 65 28 70 ocateBtreePage(p
34670 42 74 2c 20 26 70 4e 65 77 2c 20 26 70 67 6e 6f Bt, &pNew, &pgno
34680 2c 20 28 62 42 75 6c 6b 20 3f 20 31 20 3a 20 70 , (bBulk ? 1 : p
34690 67 6e 6f 29 2c 20 30 29 3b 0a 20 20 20 20 20 20 gno), 0);.
346a0 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 62 61 if( rc ) goto ba
346b0 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 lance_cleanup;.
346c0 20 20 20 20 20 61 70 4e 65 77 5b 69 5d 20 3d 20 apNew[i] =
346d0 70 4e 65 77 3b 0a 20 20 20 20 20 20 6e 4e 65 77 pNew;. nNew
346e0 2b 2b 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 53 65 ++;.. /* Se
346f0 74 20 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 t the pointer-ma
34700 70 20 65 6e 74 72 79 20 66 6f 72 20 74 68 65 20 p entry for the
34710 6e 65 77 20 73 69 62 6c 69 6e 67 20 70 61 67 65 new sibling page
34720 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 49 . */. if( I
34730 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b 0a 20 SAUTOVACUUM ){.
34740 20 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 ptrmapPut
34750 28 70 42 74 2c 20 70 4e 65 77 2d 3e 70 67 6e 6f (pBt, pNew->pgno
34760 2c 20 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 , PTRMAP_BTREE,
34770 70 50 61 72 65 6e 74 2d 3e 70 67 6e 6f 2c 20 26 pParent->pgno, &
34780 72 63 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 rc);. if(
34790 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
347a0 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 6f {. goto
347b0 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 balance_cleanup
347c0 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
347d0 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 }. }. }..
347e0 20 2f 2a 20 46 72 65 65 20 61 6e 79 20 6f 6c 64 /* Free any old
347f0 20 70 61 67 65 73 20 74 68 61 74 20 77 65 72 65 pages that were
34800 20 6e 6f 74 20 72 65 75 73 65 64 20 61 73 20 6e not reused as n
34810 65 77 20 70 61 67 65 73 2e 0a 20 20 2a 2f 0a 20 ew pages.. */.
34820 20 77 68 69 6c 65 28 20 69 3c 6e 4f 6c 64 20 29 while( i<nOld )
34830 7b 0a 20 20 20 20 66 72 65 65 50 61 67 65 28 61 {. freePage(a
34840 70 4f 6c 64 5b 69 5d 2c 20 26 72 63 29 3b 0a 20 pOld[i], &rc);.
34850 20 20 20 69 66 28 20 72 63 20 29 20 67 6f 74 6f if( rc ) goto
34860 20 62 61 6c 61 6e 63 65 5f 63 6c 65 61 6e 75 70 balance_cleanup
34870 3b 0a 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 ;. releasePag
34880 65 28 61 70 4f 6c 64 5b 69 5d 29 3b 0a 20 20 20 e(apOld[i]);.
34890 20 61 70 4f 6c 64 5b 69 5d 20 3d 20 30 3b 0a 20 apOld[i] = 0;.
348a0 20 20 20 69 2b 2b 3b 0a 20 20 7d 0a 0a 20 20 2f i++;. }.. /
348b0 2a 0a 20 20 2a 2a 20 50 75 74 20 74 68 65 20 6e *. ** Put the n
348c0 65 77 20 70 61 67 65 73 20 69 6e 20 61 63 63 65 ew pages in acce
348d0 6e 64 69 6e 67 20 6f 72 64 65 72 2e 20 20 54 68 nding order. Th
348e0 69 73 20 68 65 6c 70 73 20 74 6f 0a 20 20 2a 2a is helps to. **
348f0 20 6b 65 65 70 20 65 6e 74 72 69 65 73 20 69 6e keep entries in
34900 20 74 68 65 20 64 69 73 6b 20 66 69 6c 65 20 69 the disk file i
34910 6e 20 6f 72 64 65 72 20 73 6f 20 74 68 61 74 20 n order so that
34920 61 20 73 63 61 6e 0a 20 20 2a 2a 20 6f 66 20 74 a scan. ** of t
34930 68 65 20 74 61 62 6c 65 20 69 73 20 61 20 6c 69 he table is a li
34940 6e 65 61 72 20 73 63 61 6e 20 74 68 72 6f 75 67 near scan throug
34950 68 20 74 68 65 20 66 69 6c 65 2e 20 20 54 68 61 h the file. Tha
34960 74 0a 20 20 2a 2a 20 69 6e 20 74 75 72 6e 20 68 t. ** in turn h
34970 65 6c 70 73 20 74 68 65 20 6f 70 65 72 61 74 69 elps the operati
34980 6e 67 20 73 79 73 74 65 6d 20 74 6f 20 64 65 6c ng system to del
34990 69 76 65 72 20 70 61 67 65 73 0a 20 20 2a 2a 20 iver pages. **
349a0 66 72 6f 6d 20 74 68 65 20 64 69 73 6b 20 6d 6f from the disk mo
349b0 72 65 20 72 61 70 69 64 6c 79 2e 0a 20 20 2a 2a re rapidly.. **
349c0 0a 20 20 2a 2a 20 41 6e 20 4f 28 6e 5e 32 29 20 . ** An O(n^2)
349d0 69 6e 73 65 72 74 69 6f 6e 20 73 6f 72 74 20 61 insertion sort a
349e0 6c 67 6f 72 69 74 68 6d 20 69 73 20 75 73 65 64 lgorithm is used
349f0 2c 20 62 75 74 20 73 69 6e 63 65 0a 20 20 2a 2a , but since. **
34a00 20 6e 20 69 73 20 6e 65 76 65 72 20 6d 6f 72 65 n is never more
34a10 20 74 68 61 6e 20 4e 42 20 28 61 20 73 6d 61 6c than NB (a smal
34a20 6c 20 63 6f 6e 73 74 61 6e 74 29 2c 20 74 68 61 l constant), tha
34a30 74 20 73 68 6f 75 6c 64 0a 20 20 2a 2a 20 6e 6f t should. ** no
34a40 74 20 62 65 20 61 20 70 72 6f 62 6c 65 6d 2e 0a t be a problem..
34a50 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 4e **. ** When N
34a60 42 3d 3d 33 2c 20 74 68 69 73 20 6f 6e 65 20 6f B==3, this one o
34a70 70 74 69 6d 69 7a 61 74 69 6f 6e 20 6d 61 6b 65 ptimization make
34a80 73 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 s the database.
34a90 20 2a 2a 20 61 62 6f 75 74 20 32 35 25 20 66 61 ** about 25% fa
34aa0 73 74 65 72 20 66 6f 72 20 6c 61 72 67 65 20 69 ster for large i
34ab0 6e 73 65 72 74 69 6f 6e 73 20 61 6e 64 20 64 65 nsertions and de
34ac0 6c 65 74 69 6f 6e 73 2e 0a 20 20 2a 2f 0a 20 20 letions.. */.
34ad0 66 6f 72 28 69 3d 30 3b 20 69 3c 6b 2d 31 3b 20 for(i=0; i<k-1;
34ae0 69 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 6d 69 i++){. int mi
34af0 6e 56 20 3d 20 61 70 4e 65 77 5b 69 5d 2d 3e 70 nV = apNew[i]->p
34b00 67 6e 6f 3b 0a 20 20 20 20 69 6e 74 20 6d 69 6e gno;. int min
34b10 49 20 3d 20 69 3b 0a 20 20 20 20 66 6f 72 28 6a I = i;. for(j
34b20 3d 69 2b 31 3b 20 6a 3c 6b 3b 20 6a 2b 2b 29 7b =i+1; j<k; j++){
34b30 0a 20 20 20 20 20 20 69 66 28 20 61 70 4e 65 77 . if( apNew
34b40 5b 6a 5d 2d 3e 70 67 6e 6f 3c 28 75 6e 73 69 67 [j]->pgno<(unsig
34b50 6e 65 64 29 6d 69 6e 56 20 29 7b 0a 20 20 20 20 ned)minV ){.
34b60 20 20 20 20 6d 69 6e 49 20 3d 20 6a 3b 0a 20 20 minI = j;.
34b70 20 20 20 20 20 20 6d 69 6e 56 20 3d 20 61 70 4e minV = apN
34b80 65 77 5b 6a 5d 2d 3e 70 67 6e 6f 3b 0a 20 20 20 ew[j]->pgno;.
34b90 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 69 }. }. i
34ba0 66 28 20 6d 69 6e 49 3e 69 20 29 7b 0a 20 20 20 f( minI>i ){.
34bb0 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 54 3b 0a MemPage *pT;.
34bc0 20 20 20 20 20 20 70 54 20 3d 20 61 70 4e 65 77 pT = apNew
34bd0 5b 69 5d 3b 0a 20 20 20 20 20 20 61 70 4e 65 77 [i];. apNew
34be0 5b 69 5d 20 3d 20 61 70 4e 65 77 5b 6d 69 6e 49 [i] = apNew[minI
34bf0 5d 3b 0a 20 20 20 20 20 20 61 70 4e 65 77 5b 6d ];. apNew[m
34c00 69 6e 49 5d 20 3d 20 70 54 3b 0a 20 20 20 20 7d inI] = pT;. }
34c10 0a 20 20 7d 0a 20 20 54 52 41 43 45 28 28 22 6e . }. TRACE(("n
34c20 65 77 3a 20 25 64 28 25 64 29 20 25 64 28 25 64 ew: %d(%d) %d(%d
34c30 29 20 25 64 28 25 64 29 20 25 64 28 25 64 29 20 ) %d(%d) %d(%d)
34c40 25 64 28 25 64 29 5c 6e 22 2c 0a 20 20 20 20 61 %d(%d)\n",. a
34c50 70 4e 65 77 5b 30 5d 2d 3e 70 67 6e 6f 2c 20 73 pNew[0]->pgno, s
34c60 7a 4e 65 77 5b 30 5d 2c 0a 20 20 20 20 6e 4e 65 zNew[0],. nNe
34c70 77 3e 3d 32 20 3f 20 61 70 4e 65 77 5b 31 5d 2d w>=2 ? apNew[1]-
34c80 3e 70 67 6e 6f 20 3a 20 30 2c 20 6e 4e 65 77 3e >pgno : 0, nNew>
34c90 3d 32 20 3f 20 73 7a 4e 65 77 5b 31 5d 20 3a 20 =2 ? szNew[1] :
34ca0 30 2c 0a 20 20 20 20 6e 4e 65 77 3e 3d 33 20 3f 0,. nNew>=3 ?
34cb0 20 61 70 4e 65 77 5b 32 5d 2d 3e 70 67 6e 6f 20 apNew[2]->pgno
34cc0 3a 20 30 2c 20 6e 4e 65 77 3e 3d 33 20 3f 20 73 : 0, nNew>=3 ? s
34cd0 7a 4e 65 77 5b 32 5d 20 3a 20 30 2c 0a 20 20 20 zNew[2] : 0,.
34ce0 20 6e 4e 65 77 3e 3d 34 20 3f 20 61 70 4e 65 77 nNew>=4 ? apNew
34cf0 5b 33 5d 2d 3e 70 67 6e 6f 20 3a 20 30 2c 20 6e [3]->pgno : 0, n
34d00 4e 65 77 3e 3d 34 20 3f 20 73 7a 4e 65 77 5b 33 New>=4 ? szNew[3
34d10 5d 20 3a 20 30 2c 0a 20 20 20 20 6e 4e 65 77 3e ] : 0,. nNew>
34d20 3d 35 20 3f 20 61 70 4e 65 77 5b 34 5d 2d 3e 70 =5 ? apNew[4]->p
34d30 67 6e 6f 20 3a 20 30 2c 20 6e 4e 65 77 3e 3d 35 gno : 0, nNew>=5
34d40 20 3f 20 73 7a 4e 65 77 5b 34 5d 20 3a 20 30 29 ? szNew[4] : 0)
34d50 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73 71 );.. assert( sq
34d60 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 69 74 lite3PagerIswrit
34d70 65 61 62 6c 65 28 70 50 61 72 65 6e 74 2d 3e 70 eable(pParent->p
34d80 44 62 50 61 67 65 29 20 29 3b 0a 20 20 70 75 74 DbPage) );. put
34d90 34 62 79 74 65 28 70 52 69 67 68 74 2c 20 61 70 4byte(pRight, ap
34da0 4e 65 77 5b 6e 4e 65 77 2d 31 5d 2d 3e 70 67 6e New[nNew-1]->pgn
34db0 6f 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 45 o);.. /*. ** E
34dc0 76 65 6e 6c 79 20 64 69 73 74 72 69 62 75 74 65 venly distribute
34dd0 20 74 68 65 20 64 61 74 61 20 69 6e 20 61 70 43 the data in apC
34de0 65 6c 6c 5b 5d 20 61 63 72 6f 73 73 20 74 68 65 ell[] across the
34df0 20 6e 65 77 20 70 61 67 65 73 2e 0a 20 20 2a 2a new pages.. **
34e00 20 49 6e 73 65 72 74 20 64 69 76 69 64 65 72 20 Insert divider
34e10 63 65 6c 6c 73 20 69 6e 74 6f 20 70 50 61 72 65 cells into pPare
34e20 6e 74 20 61 73 20 6e 65 63 65 73 73 61 72 79 2e nt as necessary.
34e30 0a 20 20 2a 2f 0a 20 20 6a 20 3d 20 30 3b 0a 20 . */. j = 0;.
34e40 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 4e 65 77 for(i=0; i<nNew
34e50 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 2f 2a 20 41 ; i++){. /* A
34e60 73 73 65 6d 62 6c 65 20 74 68 65 20 6e 65 77 20 ssemble the new
34e70 73 69 62 6c 69 6e 67 20 70 61 67 65 2e 20 2a 2f sibling page. */
34e80 0a 20 20 20 20 4d 65 6d 50 61 67 65 20 2a 70 4e . MemPage *pN
34e90 65 77 20 3d 20 61 70 4e 65 77 5b 69 5d 3b 0a 20 ew = apNew[i];.
34ea0 20 20 20 61 73 73 65 72 74 28 20 6a 3c 6e 4d 61 assert( j<nMa
34eb0 78 43 65 6c 6c 73 20 29 3b 0a 20 20 20 20 7a 65 xCells );. ze
34ec0 72 6f 50 61 67 65 28 70 4e 65 77 2c 20 70 61 67 roPage(pNew, pag
34ed0 65 46 6c 61 67 73 29 3b 0a 20 20 20 20 61 73 73 eFlags);. ass
34ee0 65 6d 62 6c 65 50 61 67 65 28 70 4e 65 77 2c 20 emblePage(pNew,
34ef0 63 6e 74 4e 65 77 5b 69 5d 2d 6a 2c 20 26 61 70 cntNew[i]-j, &ap
34f00 43 65 6c 6c 5b 6a 5d 2c 20 26 73 7a 43 65 6c 6c Cell[j], &szCell
34f10 5b 6a 5d 29 3b 0a 20 20 20 20 61 73 73 65 72 74 [j]);. assert
34f20 28 20 70 4e 65 77 2d 3e 6e 43 65 6c 6c 3e 30 20 ( pNew->nCell>0
34f30 7c 7c 20 28 6e 4e 65 77 3d 3d 31 20 26 26 20 63 || (nNew==1 && c
34f40 6e 74 4e 65 77 5b 30 5d 3d 3d 30 29 20 29 3b 0a ntNew[0]==0) );.
34f50 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77 assert( pNew
34f60 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 20 29 ->nOverflow==0 )
34f70 3b 0a 0a 20 20 20 20 6a 20 3d 20 63 6e 74 4e 65 ;.. j = cntNe
34f80 77 5b 69 5d 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 w[i];.. /* If
34f90 20 74 68 65 20 73 69 62 6c 69 6e 67 20 70 61 67 the sibling pag
34fa0 65 20 61 73 73 65 6d 62 6c 65 64 20 61 62 6f 76 e assembled abov
34fb0 65 20 77 61 73 20 6e 6f 74 20 74 68 65 20 72 69 e was not the ri
34fc0 67 68 74 2d 6d 6f 73 74 20 73 69 62 6c 69 6e 67 ght-most sibling
34fd0 2c 0a 20 20 20 20 2a 2a 20 69 6e 73 65 72 74 20 ,. ** insert
34fe0 61 20 64 69 76 69 64 65 72 20 63 65 6c 6c 20 69 a divider cell i
34ff0 6e 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20 70 nto the parent p
35000 61 67 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 age.. */.
35010 61 73 73 65 72 74 28 20 69 3c 6e 4e 65 77 2d 31 assert( i<nNew-1
35020 20 7c 7c 20 6a 3d 3d 6e 43 65 6c 6c 20 29 3b 0a || j==nCell );.
35030 20 20 20 20 69 66 28 20 6a 3c 6e 43 65 6c 6c 20 if( j<nCell
35040 29 7b 0a 20 20 20 20 20 20 75 38 20 2a 70 43 65 ){. u8 *pCe
35050 6c 6c 3b 0a 20 20 20 20 20 20 75 38 20 2a 70 54 ll;. u8 *pT
35060 65 6d 70 3b 0a 20 20 20 20 20 20 69 6e 74 20 73 emp;. int s
35070 7a 3b 0a 0a 20 20 20 20 20 20 61 73 73 65 72 74 z;.. assert
35080 28 20 6a 3c 6e 4d 61 78 43 65 6c 6c 73 20 29 3b ( j<nMaxCells );
35090 0a 20 20 20 20 20 20 70 43 65 6c 6c 20 3d 20 61 . pCell = a
350a0 70 43 65 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 20 20 pCell[j];.
350b0 73 7a 20 3d 20 73 7a 43 65 6c 6c 5b 6a 5d 20 2b sz = szCell[j] +
350c0 20 6c 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 3b leafCorrection;
350d0 0a 20 20 20 20 20 20 70 54 65 6d 70 20 3d 20 26 . pTemp = &
350e0 61 4f 76 66 6c 53 70 61 63 65 5b 69 4f 76 66 6c aOvflSpace[iOvfl
350f0 53 70 61 63 65 5d 3b 0a 20 20 20 20 20 20 69 66 Space];. if
35100 28 20 21 70 4e 65 77 2d 3e 6c 65 61 66 20 29 7b ( !pNew->leaf ){
35110 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
35120 26 70 4e 65 77 2d 3e 61 44 61 74 61 5b 38 5d 2c &pNew->aData[8],
35130 20 70 43 65 6c 6c 2c 20 34 29 3b 0a 20 20 20 20 pCell, 4);.
35140 20 20 7d 65 6c 73 65 20 69 66 28 20 6c 65 61 66 }else if( leaf
35150 44 61 74 61 20 29 7b 0a 20 20 20 20 20 20 20 20 Data ){.
35160 2f 2a 20 49 66 20 74 68 65 20 74 72 65 65 20 69 /* If the tree i
35170 73 20 61 20 6c 65 61 66 2d 64 61 74 61 20 74 72 s a leaf-data tr
35180 65 65 2c 20 61 6e 64 20 74 68 65 20 73 69 62 6c ee, and the sibl
35190 69 6e 67 73 20 61 72 65 20 6c 65 61 76 65 73 2c ings are leaves,
351a0 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 . ** the
351b0 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64 69 n there is no di
351c0 76 69 64 65 72 20 63 65 6c 6c 20 69 6e 20 61 70 vider cell in ap
351d0 43 65 6c 6c 5b 5d 2e 20 49 6e 73 74 65 61 64 2c Cell[]. Instead,
351e0 20 74 68 65 20 64 69 76 69 64 65 72 20 0a 20 20 the divider .
351f0 20 20 20 20 20 20 2a 2a 20 63 65 6c 6c 20 63 6f ** cell co
35200 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20 69 6e nsists of the in
35210 74 65 67 65 72 20 6b 65 79 20 66 6f 72 20 74 68 teger key for th
35220 65 20 72 69 67 68 74 2d 6d 6f 73 74 20 63 65 6c e right-most cel
35230 6c 20 6f 66 20 0a 20 20 20 20 20 20 20 20 2a 2a l of . **
35240 20 74 68 65 20 73 69 62 6c 69 6e 67 2d 70 61 67 the sibling-pag
35250 65 20 61 73 73 65 6d 62 6c 65 64 20 61 62 6f 76 e assembled abov
35260 65 20 6f 6e 6c 79 2e 0a 20 20 20 20 20 20 20 20 e only..
35270 2a 2f 0a 20 20 20 20 20 20 20 20 43 65 6c 6c 49 */. CellI
35280 6e 66 6f 20 69 6e 66 6f 3b 0a 20 20 20 20 20 20 nfo info;.
35290 20 20 6a 2d 2d 3b 0a 20 20 20 20 20 20 20 20 62 j--;. b
352a0 74 72 65 65 50 61 72 73 65 43 65 6c 6c 50 74 72 treeParseCellPtr
352b0 28 70 4e 65 77 2c 20 61 70 43 65 6c 6c 5b 6a 5d (pNew, apCell[j]
352c0 2c 20 26 69 6e 66 6f 29 3b 0a 20 20 20 20 20 20 , &info);.
352d0 20 20 70 43 65 6c 6c 20 3d 20 70 54 65 6d 70 3b pCell = pTemp;
352e0 0a 20 20 20 20 20 20 20 20 73 7a 20 3d 20 34 20 . sz = 4
352f0 2b 20 70 75 74 56 61 72 69 6e 74 28 26 70 43 65 + putVarint(&pCe
35300 6c 6c 5b 34 5d 2c 20 69 6e 66 6f 2e 6e 4b 65 79 ll[4], info.nKey
35310 29 3b 0a 20 20 20 20 20 20 20 20 70 54 65 6d 70 );. pTemp
35320 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 = 0;. }els
35330 65 7b 0a 20 20 20 20 20 20 20 20 70 43 65 6c 6c e{. pCell
35340 20 2d 3d 20 34 3b 0a 20 20 20 20 20 20 20 20 2f -= 4;. /
35350 2a 20 4f 62 73 63 75 72 65 20 63 61 73 65 20 66 * Obscure case f
35360 6f 72 20 6e 6f 6e 2d 6c 65 61 66 2d 64 61 74 61 or non-leaf-data
35370 20 74 72 65 65 73 3a 20 49 66 20 74 68 65 20 63 trees: If the c
35380 65 6c 6c 20 61 74 20 70 43 65 6c 6c 20 77 61 73 ell at pCell was
35390 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 72 65 76 . ** prev
353a0 69 6f 75 73 6c 79 20 73 74 6f 72 65 64 20 6f 6e iously stored on
353b0 20 61 20 6c 65 61 66 20 6e 6f 64 65 2c 20 61 6e a leaf node, an
353c0 64 20 69 74 73 20 72 65 70 6f 72 74 65 64 20 73 d its reported s
353d0 69 7a 65 20 77 61 73 20 34 0a 20 20 20 20 20 20 ize was 4.
353e0 20 20 2a 2a 20 62 79 74 65 73 2c 20 74 68 65 6e ** bytes, then
353f0 20 69 74 20 6d 61 79 20 61 63 74 75 61 6c 6c 79 it may actually
35400 20 62 65 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e be smaller than
35410 20 74 68 69 73 20 0a 20 20 20 20 20 20 20 20 2a this . *
35420 2a 20 28 73 65 65 20 62 74 72 65 65 50 61 72 73 * (see btreePars
35430 65 43 65 6c 6c 50 74 72 28 29 2c 20 34 20 62 79 eCellPtr(), 4 by
35440 74 65 73 20 69 73 20 74 68 65 20 6d 69 6e 69 6d tes is the minim
35450 75 6d 20 73 69 7a 65 20 6f 66 0a 20 20 20 20 20 um size of.
35460 20 20 20 2a 2a 20 61 6e 79 20 63 65 6c 6c 29 2e ** any cell).
35470 20 42 75 74 20 69 74 20 69 73 20 69 6d 70 6f 72 But it is impor
35480 74 61 6e 74 20 74 6f 20 70 61 73 73 20 74 68 65 tant to pass the
35490 20 63 6f 72 72 65 63 74 20 73 69 7a 65 20 74 6f correct size to
354a0 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 6e 73 . ** ins
354b0 65 72 74 43 65 6c 6c 28 29 2c 20 73 6f 20 72 65 ertCell(), so re
354c0 70 61 72 73 65 20 74 68 65 20 63 65 6c 6c 20 6e parse the cell n
354d0 6f 77 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 ow.. **.
354e0 20 20 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 ** Note t
354f0 68 61 74 20 74 68 69 73 20 63 61 6e 20 6e 65 76 hat this can nev
35500 65 72 20 68 61 70 70 65 6e 20 69 6e 20 61 6e 20 er happen in an
35510 53 51 4c 69 74 65 20 64 61 74 61 20 66 69 6c 65 SQLite data file
35520 2c 20 61 73 20 61 6c 6c 0a 20 20 20 20 20 20 20 , as all.
35530 20 2a 2a 20 63 65 6c 6c 73 20 61 72 65 20 61 74 ** cells are at
35540 20 6c 65 61 73 74 20 34 20 62 79 74 65 73 2e 20 least 4 bytes.
35550 49 74 20 6f 6e 6c 79 20 68 61 70 70 65 6e 73 20 It only happens
35560 69 6e 20 62 2d 74 72 65 65 73 20 75 73 65 64 0a in b-trees used.
35570 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 65 76 ** to ev
35580 61 6c 75 61 74 65 20 22 49 4e 20 28 53 45 4c 45 aluate "IN (SELE
35590 43 54 20 2e 2e 2e 29 22 20 61 6e 64 20 73 69 6d CT ...)" and sim
355a0 69 6c 61 72 20 63 6c 61 75 73 65 73 2e 0a 20 20 ilar clauses..
355b0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
355c0 20 69 66 28 20 73 7a 43 65 6c 6c 5b 6a 5d 3d 3d if( szCell[j]==
355d0 34 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 61 4 ){. a
355e0 73 73 65 72 74 28 6c 65 61 66 43 6f 72 72 65 63 ssert(leafCorrec
355f0 74 69 6f 6e 3d 3d 34 29 3b 0a 20 20 20 20 20 20 tion==4);.
35600 20 20 20 20 73 7a 20 3d 20 63 65 6c 6c 53 69 7a sz = cellSiz
35610 65 50 74 72 28 70 50 61 72 65 6e 74 2c 20 70 43 ePtr(pParent, pC
35620 65 6c 6c 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a ell);. }.
35630 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 4f }. iO
35640 76 66 6c 53 70 61 63 65 20 2b 3d 20 73 7a 3b 0a vflSpace += sz;.
35650 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 7a assert( sz
35660 3c 3d 70 42 74 2d 3e 6d 61 78 4c 6f 63 61 6c 2b <=pBt->maxLocal+
35670 32 33 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 23 );. asse
35680 72 74 28 20 69 4f 76 66 6c 53 70 61 63 65 20 3c rt( iOvflSpace <
35690 3d 20 28 69 6e 74 29 70 42 74 2d 3e 70 61 67 65 = (int)pBt->page
356a0 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 69 6e Size );. in
356b0 73 65 72 74 43 65 6c 6c 28 70 50 61 72 65 6e 74 sertCell(pParent
356c0 2c 20 6e 78 44 69 76 2c 20 70 43 65 6c 6c 2c 20 , nxDiv, pCell,
356d0 73 7a 2c 20 70 54 65 6d 70 2c 20 70 4e 65 77 2d sz, pTemp, pNew-
356e0 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a 20 20 20 >pgno, &rc);.
356f0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
35700 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 62 61 6c 61 E_OK ) goto bala
35710 6e 63 65 5f 63 6c 65 61 6e 75 70 3b 0a 20 20 20 nce_cleanup;.
35720 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 assert( sqlit
35730 65 33 50 61 67 65 72 49 73 77 72 69 74 65 61 62 e3PagerIswriteab
35740 6c 65 28 70 50 61 72 65 6e 74 2d 3e 70 44 62 50 le(pParent->pDbP
35750 61 67 65 29 20 29 3b 0a 0a 20 20 20 20 20 20 6a age) );.. j
35760 2b 2b 3b 0a 20 20 20 20 20 20 6e 78 44 69 76 2b ++;. nxDiv+
35770 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 +;. }. }. a
35780 73 73 65 72 74 28 20 6a 3d 3d 6e 43 65 6c 6c 20 ssert( j==nCell
35790 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 4f 6c );. assert( nOl
357a0 64 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 d>0 );. assert(
357b0 20 6e 4e 65 77 3e 30 20 29 3b 0a 20 20 69 66 28 nNew>0 );. if(
357c0 20 28 70 61 67 65 46 6c 61 67 73 20 26 20 50 54 (pageFlags & PT
357d0 46 5f 4c 45 41 46 29 3d 3d 30 20 29 7b 0a 20 20 F_LEAF)==0 ){.
357e0 20 20 75 38 20 2a 7a 43 68 69 6c 64 20 3d 20 26 u8 *zChild = &
357f0 61 70 43 6f 70 79 5b 6e 4f 6c 64 2d 31 5d 2d 3e apCopy[nOld-1]->
35800 61 44 61 74 61 5b 38 5d 3b 0a 20 20 20 20 6d 65 aData[8];. me
35810 6d 63 70 79 28 26 61 70 4e 65 77 5b 6e 4e 65 77 mcpy(&apNew[nNew
35820 2d 31 5d 2d 3e 61 44 61 74 61 5b 38 5d 2c 20 7a -1]->aData[8], z
35830 43 68 69 6c 64 2c 20 34 29 3b 0a 20 20 7d 0a 0a Child, 4);. }..
35840 20 20 69 66 28 20 69 73 52 6f 6f 74 20 26 26 20 if( isRoot &&
35850 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c 3d 3d pParent->nCell==
35860 30 20 26 26 20 70 50 61 72 65 6e 74 2d 3e 68 64 0 && pParent->hd
35870 72 4f 66 66 73 65 74 3c 3d 61 70 4e 65 77 5b 30 rOffset<=apNew[0
35880 5d 2d 3e 6e 46 72 65 65 20 29 7b 0a 20 20 20 20 ]->nFree ){.
35890 2f 2a 20 54 68 65 20 72 6f 6f 74 20 70 61 67 65 /* The root page
358a0 20 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 6e of the b-tree n
358b0 6f 77 20 63 6f 6e 74 61 69 6e 73 20 6e 6f 20 63 ow contains no c
358c0 65 6c 6c 73 2e 20 54 68 65 20 6f 6e 6c 79 20 73 ells. The only s
358d0 69 62 6c 69 6e 67 0a 20 20 20 20 2a 2a 20 70 61 ibling. ** pa
358e0 67 65 20 69 73 20 74 68 65 20 72 69 67 68 74 2d ge is the right-
358f0 63 68 69 6c 64 20 6f 66 20 74 68 65 20 70 61 72 child of the par
35900 65 6e 74 2e 20 43 6f 70 79 20 74 68 65 20 63 6f ent. Copy the co
35910 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 0a 20 20 ntents of the.
35920 20 20 2a 2a 20 63 68 69 6c 64 20 70 61 67 65 20 ** child page
35930 69 6e 74 6f 20 74 68 65 20 70 61 72 65 6e 74 2c into the parent,
35940 20 64 65 63 72 65 61 73 69 6e 67 20 74 68 65 20 decreasing the
35950 6f 76 65 72 61 6c 6c 20 68 65 69 67 68 74 20 6f overall height o
35960 66 20 74 68 65 0a 20 20 20 20 2a 2a 20 62 2d 74 f the. ** b-t
35970 72 65 65 20 73 74 72 75 63 74 75 72 65 20 62 79 ree structure by
35980 20 6f 6e 65 2e 20 54 68 69 73 20 69 73 20 64 65 one. This is de
35990 73 63 72 69 62 65 64 20 61 73 20 74 68 65 20 22 scribed as the "
359a0 62 61 6c 61 6e 63 65 2d 73 68 61 6c 6c 6f 77 65 balance-shallowe
359b0 72 22 0a 20 20 20 20 2a 2a 20 73 75 62 2d 61 6c r". ** sub-al
359c0 67 6f 72 69 74 68 6d 20 69 6e 20 73 6f 6d 65 20 gorithm in some
359d0 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 0a 20 documentation..
359e0 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 **. ** If
359f0 74 68 69 73 20 69 73 20 61 6e 20 61 75 74 6f 2d this is an auto-
35a00 76 61 63 75 75 6d 20 64 61 74 61 62 61 73 65 2c vacuum database,
35a10 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 63 6f 70 the call to cop
35a20 79 4e 6f 64 65 43 6f 6e 74 65 6e 74 28 29 20 0a yNodeContent() .
35a30 20 20 20 20 2a 2a 20 73 65 74 73 20 61 6c 6c 20 ** sets all
35a40 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 pointer-map entr
35a50 69 65 73 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e ies correspondin
35a60 67 20 74 6f 20 64 61 74 61 62 61 73 65 20 69 6d g to database im
35a70 61 67 65 20 70 61 67 65 73 20 0a 20 20 20 20 2a age pages . *
35a80 2a 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 * for which the
35a90 70 6f 69 6e 74 65 72 20 69 73 20 73 74 6f 72 65 pointer is store
35aa0 64 20 77 69 74 68 69 6e 20 74 68 65 20 63 6f 6e d within the con
35ab0 74 65 6e 74 20 62 65 69 6e 67 20 63 6f 70 69 65 tent being copie
35ac0 64 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a d.. **. **
35ad0 20 54 68 65 20 73 65 63 6f 6e 64 20 61 73 73 65 The second asse
35ae0 72 74 20 62 65 6c 6f 77 20 76 65 72 69 66 69 65 rt below verifie
35af0 73 20 74 68 61 74 20 74 68 65 20 63 68 69 6c 64 s that the child
35b00 20 70 61 67 65 20 69 73 20 64 65 66 72 61 67 6d page is defragm
35b10 65 6e 74 65 64 0a 20 20 20 20 2a 2a 20 28 69 74 ented. ** (it
35b20 20 6d 75 73 74 20 62 65 2c 20 61 73 20 69 74 20 must be, as it
35b30 77 61 73 20 6a 75 73 74 20 72 65 63 6f 6e 73 74 was just reconst
35b40 72 75 63 74 65 64 20 75 73 69 6e 67 20 61 73 73 ructed using ass
35b50 65 6d 62 6c 65 50 61 67 65 28 29 29 2e 20 54 68 emblePage()). Th
35b60 69 73 0a 20 20 20 20 2a 2a 20 69 73 20 69 6d 70 is. ** is imp
35b70 6f 72 74 61 6e 74 20 69 66 20 74 68 65 20 70 61 ortant if the pa
35b80 72 65 6e 74 20 70 61 67 65 20 68 61 70 70 65 6e rent page happen
35b90 73 20 74 6f 20 62 65 20 70 61 67 65 20 31 20 6f s to be page 1 o
35ba0 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 f the database.
35bb0 20 20 20 2a 2a 20 69 6d 61 67 65 2e 20 20 2a 2f ** image. */
35bc0 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 4e 65 . assert( nNe
35bd0 77 3d 3d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 w==1 );. asse
35be0 72 74 28 20 61 70 4e 65 77 5b 30 5d 2d 3e 6e 46 rt( apNew[0]->nF
35bf0 72 65 65 20 3d 3d 20 0a 20 20 20 20 20 20 20 20 ree == .
35c00 28 67 65 74 32 62 79 74 65 28 26 61 70 4e 65 77 (get2byte(&apNew
35c10 5b 30 5d 2d 3e 61 44 61 74 61 5b 35 5d 29 2d 61 [0]->aData[5])-a
35c20 70 4e 65 77 5b 30 5d 2d 3e 63 65 6c 6c 4f 66 66 pNew[0]->cellOff
35c30 73 65 74 2d 61 70 4e 65 77 5b 30 5d 2d 3e 6e 43 set-apNew[0]->nC
35c40 65 6c 6c 2a 32 29 20 0a 20 20 20 20 29 3b 0a 20 ell*2) . );.
35c50 20 20 20 63 6f 70 79 4e 6f 64 65 43 6f 6e 74 65 copyNodeConte
35c60 6e 74 28 61 70 4e 65 77 5b 30 5d 2c 20 70 50 61 nt(apNew[0], pPa
35c70 72 65 6e 74 2c 20 26 72 63 29 3b 0a 20 20 20 20 rent, &rc);.
35c80 66 72 65 65 50 61 67 65 28 61 70 4e 65 77 5b 30 freePage(apNew[0
35c90 5d 2c 20 26 72 63 29 3b 0a 20 20 7d 65 6c 73 65 ], &rc);. }else
35ca0 20 69 66 28 20 49 53 41 55 54 4f 56 41 43 55 55 if( ISAUTOVACUU
35cb0 4d 20 29 7b 0a 20 20 20 20 2f 2a 20 46 69 78 20 M ){. /* Fix
35cc0 74 68 65 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 the pointer-map
35cd0 65 6e 74 72 69 65 73 20 66 6f 72 20 61 6c 6c 20 entries for all
35ce0 74 68 65 20 63 65 6c 6c 73 20 74 68 61 74 20 77 the cells that w
35cf0 65 72 65 20 73 68 69 66 74 65 64 20 61 72 6f 75 ere shifted arou
35d00 6e 64 2e 20 0a 20 20 20 20 2a 2a 20 54 68 65 72 nd. . ** Ther
35d10 65 20 61 72 65 20 73 65 76 65 72 61 6c 20 64 69 e are several di
35d20 66 66 65 72 65 6e 74 20 74 79 70 65 73 20 6f 66 fferent types of
35d30 20 70 6f 69 6e 74 65 72 2d 6d 61 70 20 65 6e 74 pointer-map ent
35d40 72 69 65 73 20 74 68 61 74 20 6e 65 65 64 20 74 ries that need t
35d50 6f 0a 20 20 20 20 2a 2a 20 62 65 20 64 65 61 6c o. ** be deal
35d60 74 20 77 69 74 68 20 62 79 20 74 68 69 73 20 72 t with by this r
35d70 6f 75 74 69 6e 65 2e 20 53 6f 6d 65 20 6f 66 20 outine. Some of
35d80 74 68 65 73 65 20 68 61 76 65 20 62 65 65 6e 20 these have been
35d90 73 65 74 20 61 6c 72 65 61 64 79 2c 20 62 75 74 set already, but
35da0 0a 20 20 20 20 2a 2a 20 6d 61 6e 79 20 68 61 76 . ** many hav
35db0 65 20 6e 6f 74 2e 20 54 68 65 20 66 6f 6c 6c 6f e not. The follo
35dc0 77 69 6e 67 20 69 73 20 61 20 73 75 6d 6d 61 72 wing is a summar
35dd0 79 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a y:. **. **
35de0 20 20 20 31 29 20 54 68 65 20 65 6e 74 72 69 65 1) The entrie
35df0 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
35e00 68 20 6e 65 77 20 73 69 62 6c 69 6e 67 20 70 61 h new sibling pa
35e10 67 65 73 20 74 68 61 74 20 77 65 72 65 20 6e 6f ges that were no
35e20 74 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 73 69 t. ** si
35e30 62 6c 69 6e 67 73 20 77 68 65 6e 20 74 68 69 73 blings when this
35e40 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 61 function was ca
35e50 6c 6c 65 64 2e 20 54 68 65 73 65 20 68 61 76 65 lled. These have
35e60 20 61 6c 72 65 61 64 79 0a 20 20 20 20 2a 2a 20 already. **
35e70 20 20 20 20 20 62 65 65 6e 20 73 65 74 2e 20 57 been set. W
35e80 65 20 64 6f 6e 27 74 20 6e 65 65 64 20 74 6f 20 e don't need to
35e90 77 6f 72 72 79 20 61 62 6f 75 74 20 6f 6c 64 20 worry about old
35ea0 73 69 62 6c 69 6e 67 73 20 74 68 61 74 20 77 65 siblings that we
35eb0 72 65 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 6d re. ** m
35ec0 6f 76 65 64 20 74 6f 20 74 68 65 20 66 72 65 65 oved to the free
35ed0 2d 6c 69 73 74 20 2d 20 74 68 65 20 66 72 65 65 -list - the free
35ee0 50 61 67 65 28 29 20 63 6f 64 65 20 68 61 73 20 Page() code has
35ef0 74 61 6b 65 6e 20 63 61 72 65 0a 20 20 20 20 2a taken care. *
35f00 2a 20 20 20 20 20 20 6f 66 20 74 68 6f 73 65 2e * of those.
35f10 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 . **. **
35f20 20 32 29 20 54 68 65 20 70 6f 69 6e 74 65 72 2d 2) The pointer-
35f30 6d 61 70 20 65 6e 74 72 69 65 73 20 61 73 73 6f map entries asso
35f40 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 ciated with the
35f50 66 69 72 73 74 20 6f 76 65 72 66 6c 6f 77 0a 20 first overflow.
35f60 20 20 20 2a 2a 20 20 20 20 20 20 70 61 67 65 20 ** page
35f70 69 6e 20 61 6e 79 20 6f 76 65 72 66 6c 6f 77 20 in any overflow
35f80 63 68 61 69 6e 73 20 75 73 65 64 20 62 79 20 6e chains used by n
35f90 65 77 20 64 69 76 69 64 65 72 20 63 65 6c 6c 73 ew divider cells
35fa0 2e 20 54 68 65 73 65 20 0a 20 20 20 20 2a 2a 20 . These . **
35fb0 20 20 20 20 20 68 61 76 65 20 61 6c 73 6f 20 61 have also a
35fc0 6c 72 65 61 64 79 20 62 65 65 6e 20 74 61 6b 65 lready been take
35fd0 6e 20 63 61 72 65 20 6f 66 20 62 79 20 74 68 65 n care of by the
35fe0 20 69 6e 73 65 72 74 43 65 6c 6c 28 29 20 63 6f insertCell() co
35ff0 64 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a de.. **. *
36000 2a 20 20 20 33 29 20 49 66 20 74 68 65 20 73 69 * 3) If the si
36010 62 6c 69 6e 67 20 70 61 67 65 73 20 61 72 65 20 bling pages are
36020 6e 6f 74 20 6c 65 61 76 65 73 2c 20 74 68 65 6e not leaves, then
36030 20 74 68 65 20 63 68 69 6c 64 20 70 61 67 65 73 the child pages
36040 20 6f 66 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 of. **
36050 63 65 6c 6c 73 20 73 74 6f 72 65 64 20 6f 6e 20 cells stored on
36060 74 68 65 20 73 69 62 6c 69 6e 67 20 70 61 67 65 the sibling page
36070 73 20 6d 61 79 20 6e 65 65 64 20 74 6f 20 62 65 s may need to be
36080 20 75 70 64 61 74 65 64 2e 0a 20 20 20 20 2a 2a updated.. **
36090 0a 20 20 20 20 2a 2a 20 20 20 34 29 20 49 66 20 . ** 4) If
360a0 74 68 65 20 73 69 62 6c 69 6e 67 20 70 61 67 65 the sibling page
360b0 73 20 61 72 65 20 6e 6f 74 20 69 6e 74 65 72 6e s are not intern
360c0 61 6c 20 69 6e 74 6b 65 79 20 6e 6f 64 65 73 2c al intkey nodes,
360d0 20 74 68 65 6e 20 61 6e 79 0a 20 20 20 20 2a 2a then any. **
360e0 20 20 20 20 20 20 6f 76 65 72 66 6c 6f 77 20 70 overflow p
360f0 61 67 65 73 20 75 73 65 64 20 62 79 20 74 68 65 ages used by the
36100 73 65 20 63 65 6c 6c 73 20 6d 61 79 20 6e 65 65 se cells may nee
36110 64 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 0a d to be updated.
36120 20 20 20 20 2a 2a 20 20 20 20 20 20 28 69 6e 74 ** (int
36130 65 72 6e 61 6c 20 69 6e 74 6b 65 79 20 6e 6f 64 ernal intkey nod
36140 65 73 20 6e 65 76 65 72 20 63 6f 6e 74 61 69 6e es never contain
36150 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 6f 76 65 pointers to ove
36160 72 66 6c 6f 77 20 70 61 67 65 73 29 2e 0a 20 20 rflow pages)..
36170 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20 35 29 **. ** 5)
36180 20 49 66 20 74 68 65 20 73 69 62 6c 69 6e 67 20 If the sibling
36190 70 61 67 65 73 20 61 72 65 20 6e 6f 74 20 6c 65 pages are not le
361a0 61 76 65 73 2c 20 74 68 65 6e 20 74 68 65 20 70 aves, then the p
361b0 6f 69 6e 74 65 72 2d 6d 61 70 0a 20 20 20 20 2a ointer-map. *
361c0 2a 20 20 20 20 20 20 65 6e 74 72 69 65 73 20 66 * entries f
361d0 6f 72 20 74 68 65 20 72 69 67 68 74 2d 63 68 69 or the right-chi
361e0 6c 64 20 70 61 67 65 73 20 6f 66 20 65 61 63 68 ld pages of each
361f0 20 73 69 62 6c 69 6e 67 20 6d 61 79 20 6e 65 65 sibling may nee
36200 64 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 74 6f d. ** to
36210 20 62 65 20 75 70 64 61 74 65 64 2e 0a 20 20 20 be updated..
36220 20 2a 2a 0a 20 20 20 20 2a 2a 20 43 61 73 65 73 **. ** Cases
36230 20 31 20 61 6e 64 20 32 20 61 72 65 20 64 65 61 1 and 2 are dea
36240 6c 74 20 77 69 74 68 20 61 62 6f 76 65 20 62 79 lt with above by
36250 20 6f 74 68 65 72 20 63 6f 64 65 2e 20 54 68 65 other code. The
36260 20 6e 65 78 74 0a 20 20 20 20 2a 2a 20 62 6c 6f next. ** blo
36270 63 6b 20 64 65 61 6c 73 20 77 69 74 68 20 63 61 ck deals with ca
36280 73 65 73 20 33 20 61 6e 64 20 34 20 61 6e 64 20 ses 3 and 4 and
36290 74 68 65 20 6f 6e 65 20 61 66 74 65 72 20 74 68 the one after th
362a0 61 74 2c 20 63 61 73 65 20 35 2e 20 53 69 6e 63 at, case 5. Sinc
362b0 65 0a 20 20 20 20 2a 2a 20 73 65 74 74 69 6e 67 e. ** setting
362c0 20 61 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 a pointer map e
362d0 6e 74 72 79 20 69 73 20 61 20 72 65 6c 61 74 69 ntry is a relati
362e0 76 65 6c 79 20 65 78 70 65 6e 73 69 76 65 20 6f vely expensive o
362f0 70 65 72 61 74 69 6f 6e 2c 20 74 68 69 73 0a 20 peration, this.
36300 20 20 20 2a 2a 20 63 6f 64 65 20 6f 6e 6c 79 20 ** code only
36310 73 65 74 73 20 70 6f 69 6e 74 65 72 20 6d 61 70 sets pointer map
36320 20 65 6e 74 72 69 65 73 20 66 6f 72 20 63 68 69 entries for chi
36330 6c 64 20 6f 72 20 6f 76 65 72 66 6c 6f 77 20 70 ld or overflow p
36340 61 67 65 73 20 74 68 61 74 20 68 61 76 65 0a 20 ages that have.
36350 20 20 20 2a 2a 20 61 63 74 75 61 6c 6c 79 20 6d ** actually m
36360 6f 76 65 64 20 62 65 74 77 65 65 6e 20 70 61 67 oved between pag
36370 65 73 2e 20 20 2a 2f 0a 20 20 20 20 4d 65 6d 50 es. */. MemP
36380 61 67 65 20 2a 70 4e 65 77 20 3d 20 61 70 4e 65 age *pNew = apNe
36390 77 5b 30 5d 3b 0a 20 20 20 20 4d 65 6d 50 61 67 w[0];. MemPag
363a0 65 20 2a 70 4f 6c 64 20 3d 20 61 70 43 6f 70 79 e *pOld = apCopy
363b0 5b 30 5d 3b 0a 20 20 20 20 69 6e 74 20 6e 4f 76 [0];. int nOv
363c0 65 72 66 6c 6f 77 20 3d 20 70 4f 6c 64 2d 3e 6e erflow = pOld->n
363d0 4f 76 65 72 66 6c 6f 77 3b 0a 20 20 20 20 69 6e Overflow;. in
363e0 74 20 69 4e 65 78 74 4f 6c 64 20 3d 20 70 4f 6c t iNextOld = pOl
363f0 64 2d 3e 6e 43 65 6c 6c 20 2b 20 6e 4f 76 65 72 d->nCell + nOver
36400 66 6c 6f 77 3b 0a 20 20 20 20 69 6e 74 20 69 4f flow;. int iO
36410 76 65 72 66 6c 6f 77 20 3d 20 28 6e 4f 76 65 72 verflow = (nOver
36420 66 6c 6f 77 20 3f 20 70 4f 6c 64 2d 3e 61 69 4f flow ? pOld->aiO
36430 76 66 6c 5b 30 5d 20 3a 20 2d 31 29 3b 0a 20 20 vfl[0] : -1);.
36440 20 20 6a 20 3d 20 30 3b 20 20 20 20 20 20 20 20 j = 0;
36450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
36460 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 /* Current
36470 27 6f 6c 64 27 20 73 69 62 6c 69 6e 67 20 70 61 'old' sibling pa
36480 67 65 20 2a 2f 0a 20 20 20 20 6b 20 3d 20 30 3b ge */. k = 0;
36490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
364a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
364b0 43 75 72 72 65 6e 74 20 27 6e 65 77 27 20 73 69 Current 'new' si
364c0 62 6c 69 6e 67 20 70 61 67 65 20 2a 2f 0a 20 20 bling page */.
364d0 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 65 for(i=0; i<nCe
364e0 6c 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 ll; i++){.
364f0 69 6e 74 20 69 73 44 69 76 69 64 65 72 20 3d 20 int isDivider =
36500 30 3b 0a 20 20 20 20 20 20 77 68 69 6c 65 28 20 0;. while(
36510 69 3d 3d 69 4e 65 78 74 4f 6c 64 20 29 7b 0a 20 i==iNextOld ){.
36520 20 20 20 20 20 20 20 2f 2a 20 43 65 6c 6c 20 69 /* Cell i
36530 20 69 73 20 74 68 65 20 63 65 6c 6c 20 69 6d 6d is the cell imm
36540 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c 6f 77 69 ediately followi
36550 6e 67 20 74 68 65 20 6c 61 73 74 20 63 65 6c 6c ng the last cell
36560 20 6f 6e 20 6f 6c 64 0a 20 20 20 20 20 20 20 20 on old.
36570 2a 2a 20 73 69 62 6c 69 6e 67 20 70 61 67 65 20 ** sibling page
36580 6a 2e 20 49 66 20 74 68 65 20 73 69 62 6c 69 6e j. If the siblin
36590 67 73 20 61 72 65 20 6e 6f 74 20 6c 65 61 66 20 gs are not leaf
365a0 70 61 67 65 73 20 6f 66 20 61 6e 0a 20 20 20 20 pages of an.
365b0 20 20 20 20 2a 2a 20 69 6e 74 6b 65 79 20 62 2d ** intkey b-
365c0 74 72 65 65 2c 20 74 68 65 6e 20 63 65 6c 6c 20 tree, then cell
365d0 69 20 77 61 73 20 61 20 64 69 76 69 64 65 72 20 i was a divider
365e0 63 65 6c 6c 2e 20 2a 2f 0a 20 20 20 20 20 20 20 cell. */.
365f0 20 61 73 73 65 72 74 28 20 6a 2b 31 20 3c 20 41 assert( j+1 < A
36600 72 72 61 79 53 69 7a 65 28 61 70 43 6f 70 79 29 rraySize(apCopy)
36610 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 );. asse
36620 72 74 28 20 6a 2b 31 20 3c 20 6e 4f 6c 64 20 29 rt( j+1 < nOld )
36630 3b 0a 20 20 20 20 20 20 20 20 70 4f 6c 64 20 3d ;. pOld =
36640 20 61 70 43 6f 70 79 5b 2b 2b 6a 5d 3b 0a 20 20 apCopy[++j];.
36650 20 20 20 20 20 20 69 4e 65 78 74 4f 6c 64 20 3d iNextOld =
36660 20 69 20 2b 20 21 6c 65 61 66 44 61 74 61 20 2b i + !leafData +
36670 20 70 4f 6c 64 2d 3e 6e 43 65 6c 6c 20 2b 20 70 pOld->nCell + p
36680 4f 6c 64 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a Old->nOverflow;.
36690 20 20 20 20 20 20 20 20 69 66 28 20 70 4f 6c 64 if( pOld
366a0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 7b 0a 20 ->nOverflow ){.
366b0 20 20 20 20 20 20 20 20 20 6e 4f 76 65 72 66 6c nOverfl
366c0 6f 77 20 3d 20 70 4f 6c 64 2d 3e 6e 4f 76 65 72 ow = pOld->nOver
366d0 66 6c 6f 77 3b 0a 20 20 20 20 20 20 20 20 20 20 flow;.
366e0 69 4f 76 65 72 66 6c 6f 77 20 3d 20 69 20 2b 20 iOverflow = i +
366f0 21 6c 65 61 66 44 61 74 61 20 2b 20 70 4f 6c 64 !leafData + pOld
36700 2d 3e 61 69 4f 76 66 6c 5b 30 5d 3b 0a 20 20 20 ->aiOvfl[0];.
36710 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 }. i
36720 73 44 69 76 69 64 65 72 20 3d 20 21 6c 65 61 66 sDivider = !leaf
36730 44 61 74 61 3b 20 20 0a 20 20 20 20 20 20 7d 0a Data; . }.
36740 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 6e 4f . assert(nO
36750 76 65 72 66 6c 6f 77 3e 30 20 7c 7c 20 69 4f 76 verflow>0 || iOv
36760 65 72 66 6c 6f 77 3c 69 20 29 3b 0a 20 20 20 20 erflow<i );.
36770 20 20 61 73 73 65 72 74 28 6e 4f 76 65 72 66 6c assert(nOverfl
36780 6f 77 3c 32 20 7c 7c 20 70 4f 6c 64 2d 3e 61 69 ow<2 || pOld->ai
36790 4f 76 66 6c 5b 30 5d 3d 3d 70 4f 6c 64 2d 3e 61 Ovfl[0]==pOld->a
367a0 69 4f 76 66 6c 5b 31 5d 2d 31 29 3b 0a 20 20 20 iOvfl[1]-1);.
367b0 20 20 20 61 73 73 65 72 74 28 6e 4f 76 65 72 66 assert(nOverf
367c0 6c 6f 77 3c 33 20 7c 7c 20 70 4f 6c 64 2d 3e 61 low<3 || pOld->a
367d0 69 4f 76 66 6c 5b 31 5d 3d 3d 70 4f 6c 64 2d 3e iOvfl[1]==pOld->
367e0 61 69 4f 76 66 6c 5b 32 5d 2d 31 29 3b 0a 20 20 aiOvfl[2]-1);.
367f0 20 20 20 20 69 66 28 20 69 3d 3d 69 4f 76 65 72 if( i==iOver
36800 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 20 flow ){.
36810 69 73 44 69 76 69 64 65 72 20 3d 20 31 3b 0a 20 isDivider = 1;.
36820 20 20 20 20 20 20 20 69 66 28 20 28 2d 2d 6e 4f if( (--nO
36830 76 65 72 66 6c 6f 77 29 3e 30 20 29 7b 0a 20 20 verflow)>0 ){.
36840 20 20 20 20 20 20 20 20 69 4f 76 65 72 66 6c 6f iOverflo
36850 77 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 w++;. }.
36860 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 }.. if
36870 28 20 69 3d 3d 63 6e 74 4e 65 77 5b 6b 5d 20 29 ( i==cntNew[k] )
36880 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 43 65 6c {. /* Cel
36890 6c 20 69 20 69 73 20 74 68 65 20 63 65 6c 6c 20 l i is the cell
368a0 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f 6c 6c immediately foll
368b0 6f 77 69 6e 67 20 74 68 65 20 6c 61 73 74 20 63 owing the last c
368c0 65 6c 6c 20 6f 6e 20 6e 65 77 0a 20 20 20 20 20 ell on new.
368d0 20 20 20 2a 2a 20 73 69 62 6c 69 6e 67 20 70 61 ** sibling pa
368e0 67 65 20 6b 2e 20 49 66 20 74 68 65 20 73 69 62 ge k. If the sib
368f0 6c 69 6e 67 73 20 61 72 65 20 6e 6f 74 20 6c 65 lings are not le
36900 61 66 20 70 61 67 65 73 20 6f 66 20 61 6e 0a 20 af pages of an.
36910 20 20 20 20 20 20 20 2a 2a 20 69 6e 74 6b 65 79 ** intkey
36920 20 62 2d 74 72 65 65 2c 20 74 68 65 6e 20 63 65 b-tree, then ce
36930 6c 6c 20 69 20 69 73 20 61 20 64 69 76 69 64 65 ll i is a divide
36940 72 20 63 65 6c 6c 2e 20 20 2a 2f 0a 20 20 20 20 r cell. */.
36950 20 20 20 20 70 4e 65 77 20 3d 20 61 70 4e 65 77 pNew = apNew
36960 5b 2b 2b 6b 5d 3b 0a 20 20 20 20 20 20 20 20 69 [++k];. i
36970 66 28 20 21 6c 65 61 66 44 61 74 61 20 29 20 63 f( !leafData ) c
36980 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 7d ontinue;. }
36990 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6a . assert( j
369a0 3c 6e 4f 6c 64 20 29 3b 0a 20 20 20 20 20 20 61 <nOld );. a
369b0 73 73 65 72 74 28 20 6b 3c 6e 4e 65 77 20 29 3b ssert( k<nNew );
369c0 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 .. /* If th
369d0 65 20 63 65 6c 6c 20 77 61 73 20 6f 72 69 67 69 e cell was origi
369e0 6e 61 6c 6c 79 20 64 69 76 69 64 65 72 20 63 65 nally divider ce
369f0 6c 6c 20 28 61 6e 64 20 69 73 20 6e 6f 74 20 6e ll (and is not n
36a00 6f 77 29 20 6f 72 0a 20 20 20 20 20 20 2a 2a 20 ow) or. **
36a10 61 6e 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c an overflow cell
36a20 2c 20 6f 72 20 69 66 20 74 68 65 20 63 65 6c 6c , or if the cell
36a30 20 77 61 73 20 6c 6f 63 61 74 65 64 20 6f 6e 20 was located on
36a40 61 20 64 69 66 66 65 72 65 6e 74 20 73 69 62 6c a different sibl
36a50 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 70 61 67 ing. ** pag
36a60 65 20 62 65 66 6f 72 65 20 74 68 65 20 62 61 6c e before the bal
36a70 61 6e 63 69 6e 67 2c 20 74 68 65 6e 20 74 68 65 ancing, then the
36a80 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 65 6e 74 pointer map ent
36a90 72 69 65 73 20 61 73 73 6f 63 69 61 74 65 64 0a ries associated.
36aa0 20 20 20 20 20 20 2a 2a 20 77 69 74 68 20 61 6e ** with an
36ab0 79 20 63 68 69 6c 64 20 6f 72 20 6f 76 65 72 66 y child or overf
36ac0 6c 6f 77 20 70 61 67 65 73 20 6e 65 65 64 20 74 low pages need t
36ad0 6f 20 62 65 20 75 70 64 61 74 65 64 2e 20 20 2a o be updated. *
36ae0 2f 0a 20 20 20 20 20 20 69 66 28 20 69 73 44 69 /. if( isDi
36af0 76 69 64 65 72 20 7c 7c 20 70 4f 6c 64 2d 3e 70 vider || pOld->p
36b00 67 6e 6f 21 3d 70 4e 65 77 2d 3e 70 67 6e 6f 20 gno!=pNew->pgno
36b10 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 ){. if( !
36b20 6c 65 61 66 43 6f 72 72 65 63 74 69 6f 6e 20 29 leafCorrection )
36b30 7b 0a 20 20 20 20 20 20 20 20 20 20 70 74 72 6d {. ptrm
36b40 61 70 50 75 74 28 70 42 74 2c 20 67 65 74 34 62 apPut(pBt, get4b
36b50 79 74 65 28 61 70 43 65 6c 6c 5b 69 5d 29 2c 20 yte(apCell[i]),
36b60 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 4e PTRMAP_BTREE, pN
36b70 65 77 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 3b 0a ew->pgno, &rc);.
36b80 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
36b90 20 20 69 66 28 20 73 7a 43 65 6c 6c 5b 69 5d 3e if( szCell[i]>
36ba0 70 4e 65 77 2d 3e 6d 69 6e 4c 6f 63 61 6c 20 29 pNew->minLocal )
36bb0 7b 0a 20 20 20 20 20 20 20 20 20 20 70 74 72 6d {. ptrm
36bc0 61 70 50 75 74 4f 76 66 6c 50 74 72 28 70 4e 65 apPutOvflPtr(pNe
36bd0 77 2c 20 61 70 43 65 6c 6c 5b 69 5d 2c 20 26 72 w, apCell[i], &r
36be0 63 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 c);. }.
36bf0 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 }. }..
36c00 20 69 66 28 20 21 6c 65 61 66 43 6f 72 72 65 63 if( !leafCorrec
36c10 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 66 6f tion ){. fo
36c20 72 28 69 3d 30 3b 20 69 3c 6e 4e 65 77 3b 20 69 r(i=0; i<nNew; i
36c30 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 75 33 32 ++){. u32
36c40 20 6b 65 79 20 3d 20 67 65 74 34 62 79 74 65 28 key = get4byte(
36c50 26 61 70 4e 65 77 5b 69 5d 2d 3e 61 44 61 74 61 &apNew[i]->aData
36c60 5b 38 5d 29 3b 0a 20 20 20 20 20 20 20 20 70 74 [8]);. pt
36c70 72 6d 61 70 50 75 74 28 70 42 74 2c 20 6b 65 79 rmapPut(pBt, key
36c80 2c 20 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 , PTRMAP_BTREE,
36c90 61 70 4e 65 77 5b 69 5d 2d 3e 70 67 6e 6f 2c 20 apNew[i]->pgno,
36ca0 26 72 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 &rc);. }.
36cb0 20 20 7d 0a 0a 23 69 66 20 30 0a 20 20 20 20 2f }..#if 0. /
36cc0 2a 20 54 68 65 20 70 74 72 6d 61 70 43 68 65 63 * The ptrmapChec
36cd0 6b 50 61 67 65 73 28 29 20 63 6f 6e 74 61 69 6e kPages() contain
36ce0 73 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 s assert() state
36cf0 6d 65 6e 74 73 20 74 68 61 74 20 76 65 72 69 66 ments that verif
36d00 79 20 74 68 61 74 0a 20 20 20 20 2a 2a 20 61 6c y that. ** al
36d10 6c 20 70 6f 69 6e 74 65 72 20 6d 61 70 20 70 61 l pointer map pa
36d20 67 65 73 20 61 72 65 20 73 65 74 20 63 6f 72 72 ges are set corr
36d30 65 63 74 6c 79 2e 20 54 68 69 73 20 69 73 20 68 ectly. This is h
36d40 65 6c 70 66 75 6c 20 77 68 69 6c 65 20 0a 20 20 elpful while .
36d50 20 20 2a 2a 20 64 65 62 75 67 67 69 6e 67 2e 20 ** debugging.
36d60 54 68 69 73 20 69 73 20 75 73 75 61 6c 6c 79 20 This is usually
36d70 64 69 73 61 62 6c 65 64 20 62 65 63 61 75 73 65 disabled because
36d80 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 a corrupt datab
36d90 61 73 65 20 6d 61 79 0a 20 20 20 20 2a 2a 20 63 ase may. ** c
36da0 61 75 73 65 20 61 6e 20 61 73 73 65 72 74 28 29 ause an assert()
36db0 20 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 66 61 statement to fa
36dc0 69 6c 2e 20 20 2a 2f 0a 20 20 20 20 70 74 72 6d il. */. ptrm
36dd0 61 70 43 68 65 63 6b 50 61 67 65 73 28 61 70 4e apCheckPages(apN
36de0 65 77 2c 20 6e 4e 65 77 29 3b 0a 20 20 20 20 70 ew, nNew);. p
36df0 74 72 6d 61 70 43 68 65 63 6b 50 61 67 65 73 28 trmapCheckPages(
36e00 26 70 50 61 72 65 6e 74 2c 20 31 29 3b 0a 23 65 &pParent, 1);.#e
36e10 6e 64 69 66 0a 20 20 7d 0a 0a 20 20 61 73 73 65 ndif. }.. asse
36e20 72 74 28 20 70 50 61 72 65 6e 74 2d 3e 69 73 49 rt( pParent->isI
36e30 6e 69 74 20 29 3b 0a 20 20 54 52 41 43 45 28 28 nit );. TRACE((
36e40 22 42 41 4c 41 4e 43 45 3a 20 66 69 6e 69 73 68 "BALANCE: finish
36e50 65 64 3a 20 6f 6c 64 3d 25 64 20 6e 65 77 3d 25 ed: old=%d new=%
36e60 64 20 63 65 6c 6c 73 3d 25 64 5c 6e 22 2c 0a 20 d cells=%d\n",.
36e70 20 20 20 20 20 20 20 20 20 6e 4f 6c 64 2c 20 6e nOld, n
36e80 4e 65 77 2c 20 6e 43 65 6c 6c 29 29 3b 0a 0a 20 New, nCell));..
36e90 20 2f 2a 0a 20 20 2a 2a 20 43 6c 65 61 6e 75 70 /*. ** Cleanup
36ea0 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
36eb0 67 2e 0a 20 20 2a 2f 0a 62 61 6c 61 6e 63 65 5f g.. */.balance_
36ec0 63 6c 65 61 6e 75 70 3a 0a 20 20 73 71 6c 69 74 cleanup:. sqlit
36ed0 65 33 53 63 72 61 74 63 68 46 72 65 65 28 61 70 e3ScratchFree(ap
36ee0 43 65 6c 6c 29 3b 0a 20 20 66 6f 72 28 69 3d 30 Cell);. for(i=0
36ef0 3b 20 69 3c 6e 4f 6c 64 3b 20 69 2b 2b 29 7b 0a ; i<nOld; i++){.
36f00 20 20 20 20 72 65 6c 65 61 73 65 50 61 67 65 28 releasePage(
36f10 61 70 4f 6c 64 5b 69 5d 29 3b 0a 20 20 7d 0a 20 apOld[i]);. }.
36f20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 4e 65 77 for(i=0; i<nNew
36f30 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 72 65 6c 65 ; i++){. rele
36f40 61 73 65 50 61 67 65 28 61 70 4e 65 77 5b 69 5d asePage(apNew[i]
36f50 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e );. }.. return
36f60 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 rc;.}.../*.** T
36f70 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
36f80 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 20 called when the
36f90 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 61 20 62 root page of a b
36fa0 2d 74 72 65 65 20 73 74 72 75 63 74 75 72 65 20 -tree structure
36fb0 69 73 0a 2a 2a 20 6f 76 65 72 66 75 6c 6c 20 28 is.** overfull (
36fc0 68 61 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 has one or more
36fd0 6f 76 65 72 66 6c 6f 77 20 70 61 67 65 73 29 2e overflow pages).
36fe0 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 77 20 63 68 69 .**.** A new chi
36ff0 6c 64 20 70 61 67 65 20 69 73 20 61 6c 6c 6f 63 ld page is alloc
37000 61 74 65 64 20 61 6e 64 20 74 68 65 20 63 6f 6e ated and the con
37010 74 65 6e 74 73 20 6f 66 20 74 68 65 20 63 75 72 tents of the cur
37020 72 65 6e 74 20 72 6f 6f 74 0a 2a 2a 20 70 61 67 rent root.** pag
37030 65 2c 20 69 6e 63 6c 75 64 69 6e 67 20 6f 76 65 e, including ove
37040 72 66 6c 6f 77 20 63 65 6c 6c 73 2c 20 61 72 65 rflow cells, are
37050 20 63 6f 70 69 65 64 20 69 6e 74 6f 20 74 68 65 copied into the
37060 20 63 68 69 6c 64 2e 20 54 68 65 20 72 6f 6f 74 child. The root
37070 0a 2a 2a 20 70 61 67 65 20 69 73 20 74 68 65 6e .** page is then
37080 20 6f 76 65 72 77 72 69 74 74 65 6e 20 74 6f 20 overwritten to
37090 6d 61 6b 65 20 69 74 20 61 6e 20 65 6d 70 74 79 make it an empty
370a0 20 70 61 67 65 20 77 69 74 68 20 74 68 65 20 72 page with the r
370b0 69 67 68 74 2d 63 68 69 6c 64 20 0a 2a 2a 20 70 ight-child .** p
370c0 6f 69 6e 74 65 72 20 70 6f 69 6e 74 69 6e 67 20 ointer pointing
370d0 74 6f 20 74 68 65 20 6e 65 77 20 70 61 67 65 2e to the new page.
370e0 0a 2a 2a 0a 2a 2a 20 42 65 66 6f 72 65 20 72 65 .**.** Before re
370f0 74 75 72 6e 69 6e 67 2c 20 61 6c 6c 20 70 6f 69 turning, all poi
37100 6e 74 65 72 2d 6d 61 70 20 65 6e 74 72 69 65 73 nter-map entries
37110 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 corresponding t
37120 6f 20 70 61 67 65 73 20 0a 2a 2a 20 74 68 61 74 o pages .** that
37130 20 74 68 65 20 6e 65 77 20 63 68 69 6c 64 2d 70 the new child-p
37140 61 67 65 20 6e 6f 77 20 63 6f 6e 74 61 69 6e 73 age now contains
37150 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 61 72 65 pointers to are
37160 20 75 70 64 61 74 65 64 2e 20 54 68 65 0a 2a 2a updated. The.**
37170 20 65 6e 74 72 79 20 63 6f 72 72 65 73 70 6f 6e entry correspon
37180 64 69 6e 67 20 74 6f 20 74 68 65 20 6e 65 77 20 ding to the new
37190 72 69 67 68 74 2d 63 68 69 6c 64 20 70 6f 69 6e right-child poin
371a0 74 65 72 20 6f 66 20 74 68 65 20 72 6f 6f 74 0a ter of the root.
371b0 2a 2a 20 70 61 67 65 20 69 73 20 61 6c 73 6f 20 ** page is also
371c0 75 70 64 61 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 updated..**.** I
371d0 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 2a 70 f successful, *p
371e0 70 43 68 69 6c 64 20 69 73 20 73 65 74 20 74 6f pChild is set to
371f0 20 63 6f 6e 74 61 69 6e 20 61 20 72 65 66 65 72 contain a refer
37200 65 6e 63 65 20 74 6f 20 74 68 65 20 63 68 69 6c ence to the chil
37210 64 20 0a 2a 2a 20 70 61 67 65 20 61 6e 64 20 53 d .** page and S
37220 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
37230 72 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 rned. In this ca
37240 73 65 20 74 68 65 20 63 61 6c 6c 65 72 20 69 73 se the caller is
37250 20 72 65 71 75 69 72 65 64 0a 2a 2a 20 74 6f 20 required.** to
37260 63 61 6c 6c 20 72 65 6c 65 61 73 65 50 61 67 65 call releasePage
37270 28 29 20 6f 6e 20 2a 70 70 43 68 69 6c 64 20 65 () on *ppChild e
37280 78 61 63 74 6c 79 20 6f 6e 63 65 2e 20 49 66 20 xactly once. If
37290 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c an error occurs,
372a0 0a 2a 2a 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 .** an error cod
372b0 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e e is returned an
372c0 64 20 2a 70 70 43 68 69 6c 64 20 69 73 20 73 65 d *ppChild is se
372d0 74 20 74 6f 20 30 2e 0a 2a 2f 0a 73 74 61 74 69 t to 0..*/.stati
372e0 63 20 69 6e 74 20 62 61 6c 61 6e 63 65 5f 64 65 c int balance_de
372f0 65 70 65 72 28 4d 65 6d 50 61 67 65 20 2a 70 52 eper(MemPage *pR
37300 6f 6f 74 2c 20 4d 65 6d 50 61 67 65 20 2a 2a 70 oot, MemPage **p
37310 70 43 68 69 6c 64 29 7b 0a 20 20 69 6e 74 20 72 pChild){. int r
37320 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
37330 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
37340 75 72 6e 20 76 61 6c 75 65 20 66 72 6f 6d 20 73 urn value from s
37350 75 62 70 72 6f 63 65 64 75 72 65 73 20 2a 2f 0a ubprocedures */.
37360 20 20 4d 65 6d 50 61 67 65 20 2a 70 43 68 69 6c MemPage *pChil
37370 64 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 d = 0;
37380 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 61 /* Pointer to a
37390 20 6e 65 77 20 63 68 69 6c 64 20 70 61 67 65 20 new child page
373a0 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 43 68 */. Pgno pgnoCh
373b0 69 6c 64 20 3d 20 30 3b 20 20 20 20 20 20 20 20 ild = 0;
373c0 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 /* Page numb
373d0 65 72 20 6f 66 20 74 68 65 20 6e 65 77 20 63 68 er of the new ch
373e0 69 6c 64 20 70 61 67 65 20 2a 2f 0a 20 20 42 74 ild page */. Bt
373f0 53 68 61 72 65 64 20 2a 70 42 74 20 3d 20 70 52 Shared *pBt = pR
37400 6f 6f 74 2d 3e 70 42 74 3b 20 20 20 20 2f 2a 20 oot->pBt; /*
37410 54 68 65 20 42 54 72 65 65 20 2a 2f 0a 0a 20 20 The BTree */..
37420 61 73 73 65 72 74 28 20 70 52 6f 6f 74 2d 3e 6e assert( pRoot->n
37430 4f 76 65 72 66 6c 6f 77 3e 30 20 29 3b 0a 20 20 Overflow>0 );.
37440 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f assert( sqlite3_
37450 6d 75 74 65 78 5f 68 65 6c 64 28 70 42 74 2d 3e mutex_held(pBt->
37460 6d 75 74 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 mutex) );.. /*
37470 4d 61 6b 65 20 70 52 6f 6f 74 2c 20 74 68 65 20 Make pRoot, the
37480 72 6f 6f 74 20 70 61 67 65 20 6f 66 20 74 68 65 root page of the
37490 20 62 2d 74 72 65 65 2c 20 77 72 69 74 61 62 6c b-tree, writabl
374a0 65 2e 20 41 6c 6c 6f 63 61 74 65 20 61 20 6e 65 e. Allocate a ne
374b0 77 20 0a 20 20 2a 2a 20 70 61 67 65 20 74 68 61 w . ** page tha
374c0 74 20 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 t will become th
374d0 65 20 6e 65 77 20 72 69 67 68 74 2d 63 68 69 6c e new right-chil
374e0 64 20 6f 66 20 70 50 61 67 65 2e 20 43 6f 70 79 d of pPage. Copy
374f0 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 0a 20 20 the contents.
37500 2a 2a 20 6f 66 20 74 68 65 20 6e 6f 64 65 20 73 ** of the node s
37510 74 6f 72 65 64 20 6f 6e 20 70 52 6f 6f 74 20 69 tored on pRoot i
37520 6e 74 6f 20 74 68 65 20 6e 65 77 20 63 68 69 6c nto the new chil
37530 64 20 70 61 67 65 2e 0a 20 20 2a 2f 0a 20 20 72 d page.. */. r
37540 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
37550 57 72 69 74 65 28 70 52 6f 6f 74 2d 3e 70 44 62 Write(pRoot->pDb
37560 50 61 67 65 29 3b 0a 20 20 69 66 28 20 72 63 3d Page);. if( rc=
37570 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
37580 20 20 72 63 20 3d 20 61 6c 6c 6f 63 61 74 65 42 rc = allocateB
37590 74 72 65 65 50 61 67 65 28 70 42 74 2c 26 70 43 treePage(pBt,&pC
375a0 68 69 6c 64 2c 26 70 67 6e 6f 43 68 69 6c 64 2c hild,&pgnoChild,
375b0 70 52 6f 6f 74 2d 3e 70 67 6e 6f 2c 30 29 3b 0a pRoot->pgno,0);.
375c0 20 20 20 20 63 6f 70 79 4e 6f 64 65 43 6f 6e 74 copyNodeCont
375d0 65 6e 74 28 70 52 6f 6f 74 2c 20 70 43 68 69 6c ent(pRoot, pChil
375e0 64 2c 20 26 72 63 29 3b 0a 20 20 20 20 69 66 28 d, &rc);. if(
375f0 20 49 53 41 55 54 4f 56 41 43 55 55 4d 20 29 7b ISAUTOVACUUM ){
37600 0a 20 20 20 20 20 20 70 74 72 6d 61 70 50 75 74 . ptrmapPut
37610 28 70 42 74 2c 20 70 67 6e 6f 43 68 69 6c 64 2c (pBt, pgnoChild,
37620 20 50 54 52 4d 41 50 5f 42 54 52 45 45 2c 20 70 PTRMAP_BTREE, p
37630 52 6f 6f 74 2d 3e 70 67 6e 6f 2c 20 26 72 63 29 Root->pgno, &rc)
37640 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 ;. }. }. if
37650 28 20 72 63 20 29 7b 0a 20 20 20 20 2a 70 70 43 ( rc ){. *ppC
37660 68 69 6c 64 20 3d 20 30 3b 0a 20 20 20 20 72 65 hild = 0;. re
37670 6c 65 61 73 65 50 61 67 65 28 70 43 68 69 6c 64 leasePage(pChild
37680 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 );. return rc
37690 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ;. }. assert(
376a0 73 71 6c 69 74 65 33 50 61 67 65 72 49 73 77 72 sqlite3PagerIswr
376b0 69 74 65 61 62 6c 65 28 70 43 68 69 6c 64 2d 3e iteable(pChild->
376c0 70 44 62 50 61 67 65 29 20 29 3b 0a 20 20 61 73 pDbPage) );. as
376d0 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 61 67 sert( sqlite3Pag
376e0 65 72 49 73 77 72 69 74 65 61 62 6c 65 28 70 52 erIswriteable(pR
376f0 6f 6f 74 2d 3e 70 44 62 50 61 67 65 29 20 29 3b oot->pDbPage) );
37700 0a 20 20 61 73 73 65 72 74 28 20 70 43 68 69 6c . assert( pChil
37710 64 2d 3e 6e 43 65 6c 6c 3d 3d 70 52 6f 6f 74 2d d->nCell==pRoot-
37720 3e 6e 43 65 6c 6c 20 29 3b 0a 0a 20 20 54 52 41 >nCell );.. TRA
37730 43 45 28 28 22 42 41 4c 41 4e 43 45 3a 20 63 6f CE(("BALANCE: co
37740 70 79 20 72 6f 6f 74 20 25 64 20 69 6e 74 6f 20 py root %d into
37750 25 64 5c 6e 22 2c 20 70 52 6f 6f 74 2d 3e 70 67 %d\n", pRoot->pg
37760 6e 6f 2c 20 70 43 68 69 6c 64 2d 3e 70 67 6e 6f no, pChild->pgno
37770 29 29 3b 0a 0a 20 20 2f 2a 20 43 6f 70 79 20 74 ));.. /* Copy t
37780 68 65 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c he overflow cell
37790 73 20 66 72 6f 6d 20 70 52 6f 6f 74 20 74 6f 20 s from pRoot to
377a0 70 43 68 69 6c 64 20 2a 2f 0a 20 20 6d 65 6d 63 pChild */. memc
377b0 70 79 28 70 43 68 69 6c 64 2d 3e 61 69 4f 76 66 py(pChild->aiOvf
377c0 6c 2c 20 70 52 6f 6f 74 2d 3e 61 69 4f 76 66 6c l, pRoot->aiOvfl
377d0 2c 0a 20 20 20 20 20 20 20 20 20 70 52 6f 6f 74 ,. pRoot
377e0 2d 3e 6e 4f 76 65 72 66 6c 6f 77 2a 73 69 7a 65 ->nOverflow*size
377f0 6f 66 28 70 52 6f 6f 74 2d 3e 61 69 4f 76 66 6c of(pRoot->aiOvfl
37800 5b 30 5d 29 29 3b 0a 20 20 6d 65 6d 63 70 79 28 [0]));. memcpy(
37810 70 43 68 69 6c 64 2d 3e 61 70 4f 76 66 6c 2c 20 pChild->apOvfl,
37820 70 52 6f 6f 74 2d 3e 61 70 4f 76 66 6c 2c 0a 20 pRoot->apOvfl,.
37830 20 20 20 20 20 20 20 20 70 52 6f 6f 74 2d 3e 6e pRoot->n
37840 4f 76 65 72 66 6c 6f 77 2a 73 69 7a 65 6f 66 28 Overflow*sizeof(
37850 70 52 6f 6f 74 2d 3e 61 70 4f 76 66 6c 5b 30 5d pRoot->apOvfl[0]
37860 29 29 3b 0a 20 20 70 43 68 69 6c 64 2d 3e 6e 4f ));. pChild->nO
37870 76 65 72 66 6c 6f 77 20 3d 20 70 52 6f 6f 74 2d verflow = pRoot-
37880 3e 6e 4f 76 65 72 66 6c 6f 77 3b 0a 0a 20 20 2f >nOverflow;.. /
37890 2a 20 5a 65 72 6f 20 74 68 65 20 63 6f 6e 74 65 * Zero the conte
378a0 6e 74 73 20 6f 66 20 70 52 6f 6f 74 2e 20 54 68 nts of pRoot. Th
378b0 65 6e 20 69 6e 73 74 61 6c 6c 20 70 43 68 69 6c en install pChil
378c0 64 20 61 73 20 74 68 65 20 72 69 67 68 74 2d 63 d as the right-c
378d0 68 69 6c 64 2e 20 2a 2f 0a 20 20 7a 65 72 6f 50 hild. */. zeroP
378e0 61 67 65 28 70 52 6f 6f 74 2c 20 70 43 68 69 6c age(pRoot, pChil
378f0 64 2d 3e 61 44 61 74 61 5b 30 5d 20 26 20 7e 50 d->aData[0] & ~P
37900 54 46 5f 4c 45 41 46 29 3b 0a 20 20 70 75 74 34 TF_LEAF);. put4
37910 62 79 74 65 28 26 70 52 6f 6f 74 2d 3e 61 44 61 byte(&pRoot->aDa
37920 74 61 5b 70 52 6f 6f 74 2d 3e 68 64 72 4f 66 66 ta[pRoot->hdrOff
37930 73 65 74 2b 38 5d 2c 20 70 67 6e 6f 43 68 69 6c set+8], pgnoChil
37940 64 29 3b 0a 0a 20 20 2a 70 70 43 68 69 6c 64 20 d);.. *ppChild
37950 3d 20 70 43 68 69 6c 64 3b 0a 20 20 72 65 74 75 = pChild;. retu
37960 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
37970 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 ./*.** The page
37980 74 68 61 74 20 70 43 75 72 20 63 75 72 72 65 6e that pCur curren
37990 74 6c 79 20 70 6f 69 6e 74 73 20 74 6f 20 68 61 tly points to ha
379a0 73 20 6a 75 73 74 20 62 65 65 6e 20 6d 6f 64 69 s just been modi
379b0 66 69 65 64 20 69 6e 0a 2a 2a 20 73 6f 6d 65 20 fied in.** some
379c0 77 61 79 2e 20 54 68 69 73 20 66 75 6e 63 74 69 way. This functi
379d0 6f 6e 20 66 69 67 75 72 65 73 20 6f 75 74 20 69 on figures out i
379e0 66 20 74 68 69 73 20 6d 6f 64 69 66 69 63 61 74 f this modificat
379f0 69 6f 6e 20 6d 65 61 6e 73 20 74 68 65 0a 2a 2a ion means the.**
37a00 20 74 72 65 65 20 6e 65 65 64 73 20 74 6f 20 62 tree needs to b
37a10 65 20 62 61 6c 61 6e 63 65 64 2c 20 61 6e 64 20 e balanced, and
37a20 69 66 20 73 6f 20 63 61 6c 6c 73 20 74 68 65 20 if so calls the
37a30 61 70 70 72 6f 70 72 69 61 74 65 20 62 61 6c 61 appropriate bala
37a40 6e 63 69 6e 67 20 0a 2a 2a 20 72 6f 75 74 69 6e ncing .** routin
37a50 65 2e 20 42 61 6c 61 6e 63 69 6e 67 20 72 6f 75 e. Balancing rou
37a60 74 69 6e 65 73 20 61 72 65 3a 0a 2a 2a 0a 2a 2a tines are:.**.**
37a70 20 20 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b balance_quick
37a80 28 29 0a 2a 2a 20 20 20 62 61 6c 61 6e 63 65 5f ().** balance_
37a90 64 65 65 70 65 72 28 29 0a 2a 2a 20 20 20 62 61 deeper().** ba
37aa0 6c 61 6e 63 65 5f 6e 6f 6e 72 6f 6f 74 28 29 0a lance_nonroot().
37ab0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 62 61 */.static int ba
37ac0 6c 61 6e 63 65 28 42 74 43 75 72 73 6f 72 20 2a lance(BtCursor *
37ad0 70 43 75 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 pCur){. int rc
37ae0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 = SQLITE_OK;. c
37af0 6f 6e 73 74 20 69 6e 74 20 6e 4d 69 6e 20 3d 20 onst int nMin =
37b00 70 43 75 72 2d 3e 70 42 74 2d 3e 75 73 61 62 6c pCur->pBt->usabl
37b10 65 53 69 7a 65 20 2a 20 32 20 2f 20 33 3b 0a 20 eSize * 2 / 3;.
37b20 20 75 38 20 61 42 61 6c 61 6e 63 65 51 75 69 63 u8 aBalanceQuic
37b30 6b 53 70 61 63 65 5b 31 33 5d 3b 0a 20 20 75 38 kSpace[13];. u8
37b40 20 2a 70 46 72 65 65 20 3d 20 30 3b 0a 0a 20 20 *pFree = 0;..
37b50 54 45 53 54 4f 4e 4c 59 28 20 69 6e 74 20 62 61 TESTONLY( int ba
37b60 6c 61 6e 63 65 5f 71 75 69 63 6b 5f 63 61 6c 6c lance_quick_call
37b70 65 64 20 3d 20 30 20 29 3b 0a 20 20 54 45 53 54 ed = 0 );. TEST
37b80 4f 4e 4c 59 28 20 69 6e 74 20 62 61 6c 61 6e 63 ONLY( int balanc
37b90 65 5f 64 65 65 70 65 72 5f 63 61 6c 6c 65 64 20 e_deeper_called
37ba0 3d 20 30 20 29 3b 0a 0a 20 20 64 6f 20 7b 0a 20 = 0 );.. do {.
37bb0 20 20 20 69 6e 74 20 69 50 61 67 65 20 3d 20 70 int iPage = p
37bc0 43 75 72 2d 3e 69 50 61 67 65 3b 0a 20 20 20 20 Cur->iPage;.
37bd0 4d 65 6d 50 61 67 65 20 2a 70 50 61 67 65 20 3d MemPage *pPage =
37be0 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 50 pCur->apPage[iP
37bf0 61 67 65 5d 3b 0a 0a 20 20 20 20 69 66 28 20 69 age];.. if( i
37c00 50 61 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 Page==0 ){.
37c10 20 69 66 28 20 70 50 61 67 65 2d 3e 6e 4f 76 65 if( pPage->nOve
37c20 72 66 6c 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 rflow ){.
37c30 20 2f 2a 20 54 68 65 20 72 6f 6f 74 20 70 61 67 /* The root pag
37c40 65 20 6f 66 20 74 68 65 20 62 2d 74 72 65 65 20 e of the b-tree
37c50 69 73 20 6f 76 65 72 66 75 6c 6c 2e 20 49 6e 20 is overfull. In
37c60 74 68 69 73 20 63 61 73 65 20 63 61 6c 6c 20 74 this case call t
37c70 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 61 he. ** ba
37c80 6c 61 6e 63 65 5f 64 65 65 70 65 72 28 29 20 66 lance_deeper() f
37c90 75 6e 63 74 69 6f 6e 20 74 6f 20 63 72 65 61 74 unction to creat
37ca0 65 20 61 20 6e 65 77 20 63 68 69 6c 64 20 66 6f e a new child fo
37cb0 72 20 74 68 65 20 72 6f 6f 74 2d 70 61 67 65 0a r the root-page.
37cc0 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 20 63 ** and c
37cd0 6f 70 79 20 74 68 65 20 63 75 72 72 65 6e 74 20 opy the current
37ce0 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
37cf0 72 6f 6f 74 2d 70 61 67 65 20 74 6f 20 69 74 2e root-page to it.
37d00 20 54 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 The. **
37d10 6e 65 78 74 20 69 74 65 72 61 74 69 6f 6e 20 6f next iteration o
37d20 66 20 74 68 65 20 64 6f 2d 6c 6f 6f 70 20 77 69 f the do-loop wi
37d30 6c 6c 20 62 61 6c 61 6e 63 65 20 74 68 65 20 63 ll balance the c
37d40 68 69 6c 64 20 70 61 67 65 2e 0a 20 20 20 20 20 hild page..
37d50 20 20 20 2a 2f 20 0a 20 20 20 20 20 20 20 20 61 */ . a
37d60 73 73 65 72 74 28 20 28 62 61 6c 61 6e 63 65 5f ssert( (balance_
37d70 64 65 65 70 65 72 5f 63 61 6c 6c 65 64 2b 2b 29 deeper_called++)
37d80 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 72 ==0 );. r
37d90 63 20 3d 20 62 61 6c 61 6e 63 65 5f 64 65 65 70 c = balance_deep
37da0 65 72 28 70 50 61 67 65 2c 20 26 70 43 75 72 2d er(pPage, &pCur-
37db0 3e 61 70 50 61 67 65 5b 31 5d 29 3b 0a 20 20 20 >apPage[1]);.
37dc0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
37dd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
37de0 20 20 20 20 70 43 75 72 2d 3e 69 50 61 67 65 20 pCur->iPage
37df0 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 70 = 1;. p
37e00 43 75 72 2d 3e 61 69 49 64 78 5b 30 5d 20 3d 20 Cur->aiIdx[0] =
37e10 30 3b 0a 20 20 20 20 20 20 20 20 20 20 70 43 75 0;. pCu
37e20 72 2d 3e 61 69 49 64 78 5b 31 5d 20 3d 20 30 3b r->aiIdx[1] = 0;
37e30 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
37e40 74 28 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b t( pCur->apPage[
37e50 31 5d 2d 3e 6e 4f 76 65 72 66 6c 6f 77 20 29 3b 1]->nOverflow );
37e60 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
37e70 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
37e80 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 break;. }.
37e90 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 50 61 }else if( pPa
37ea0 67 65 2d 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 30 ge->nOverflow==0
37eb0 20 26 26 20 70 50 61 67 65 2d 3e 6e 46 72 65 65 && pPage->nFree
37ec0 3c 3d 6e 4d 69 6e 20 29 7b 0a 20 20 20 20 20 20 <=nMin ){.
37ed0 62 72 65 61 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 break;. }else
37ee0 7b 0a 20 20 20 20 20 20 4d 65 6d 50 61 67 65 20 {. MemPage
37ef0 2a 20 63 6f 6e 73 74 20 70 50 61 72 65 6e 74 20 * const pParent
37f00 3d 20 70 43 75 72 2d 3e 61 70 50 61 67 65 5b 69 = pCur->apPage[i
37f10 50 61 67 65 2d 31 5d 3b 0a 20 20 20 20 20 20 69 Page-1];. i
37f20 6e 74 20 63 6f 6e 73 74 20 69 49 64 78 20 3d 20 nt const iIdx =
37f30 70 43 75 72 2d 3e 61 69 49 64 78 5b 69 50 61 67 pCur->aiIdx[iPag
37f40 65 2d 31 5d 3b 0a 0a 20 20 20 20 20 20 72 63 20 e-1];.. rc
37f50 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 = sqlite3PagerWr
37f60 69 74 65 28 70 50 61 72 65 6e 74 2d 3e 70 44 62 ite(pParent->pDb
37f70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 Page);. if(
37f80 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
37f90 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
37fa0 5f 4f 4d 49 54 5f 51 55 49 43 4b 42 41 4c 41 4e _OMIT_QUICKBALAN
37fb0 43 45 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 CE. if( p
37fc0 50 61 67 65 2d 3e 68 61 73 44 61 74 61 0a 20 20 Page->hasData.
37fd0 20 20 20 20 20 20 20 26 26 20 70 50 61 67 65 2d && pPage-
37fe0 3e 6e 4f 76 65 72 66 6c 6f 77 3d 3d 31 0a 20 20 >nOverflow==1.
37ff0 20 20 20 20 20 20 20 26 26 20 70 50 61 67 65 2d && pPage-
38000 3e 61 69 4f 76 66 6c 5b 30 5d 3d 3d 70 50 61 67 >aiOvfl[0]==pPag
38010 65 2d 3e 6e 43 65 6c 6c 0a 20 20 20 20 20 20 20 e->nCell.
38020 20 20 26 26 20 70 50 61 72 65 6e 74 2d 3e 70 67 && pParent->pg
38030 6e 6f 21 3d 31 0a 20 20 20 20 20 20 20 20 20 26 no!=1. &
38040 26 20 70 50 61 72 65 6e 74 2d 3e 6e 43 65 6c 6c & pParent->nCell
38050 3d 3d 69 49 64 78 0a 20 20 20 20 20 20 20 20 29 ==iIdx. )
38060 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 {. /* C
38070 61 6c 6c 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 all balance_quic
38080 6b 28 29 20 74 6f 20 63 72 65 61 74 65 20 61 20 k() to create a
38090 6e 65 77 20 73 69 62 6c 69 6e 67 20 6f 66 20 70 new sibling of p
380a0 50 61 67 65 20 6f 6e 20 77 68 69 63 68 0a 20 20 Page on which.
380b0 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 73 74 ** to st
380c0 6f 72 65 20 74 68 65 20 6f 76 65 72 66 6c 6f 77 ore the overflow
380d0 20 63 65 6c 6c 2e 20 62 61 6c 61 6e 63 65 5f 71 cell. balance_q
380e0 75 69 63 6b 28 29 20 69 6e 73 65 72 74 73 20 61 uick() inserts a
380f0 20 6e 65 77 20 63 65 6c 6c 0a 20 20 20 20 20 20 new cell.
38100 20 20 20 20 2a 2a 20 69 6e 74 6f 20 70 50 61 72 ** into pPar
38110 65 6e 74 2c 20 77 68 69 63 68 20 6d 61 79 20 63 ent, which may c
38120 61 75 73 65 20 70 50 61 72 65 6e 74 20 6f 76 65 ause pParent ove
38130 72 66 6c 6f 77 2e 20 49 66 20 74 68 69 73 0a 20 rflow. If this.
38140 20 20 20 20 20 20 20 20 20 2a 2a 20 68 61 70 70 ** happ
38150 65 6e 73 2c 20 74 68 65 20 6e 65 78 74 20 69 6e ens, the next in
38160 74 65 72 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 teration of the
38170 64 6f 2d 6c 6f 6f 70 20 77 69 6c 6c 20 62 61 6c do-loop will bal
38180 61 6e 63 65 20 70 50 61 72 65 6e 74 20 0a 20 20 ance pParent .
38190 20 20 20 20 20 20 20 20 2a 2a 20 75 73 65 20 65 ** use e
381a0 69 74 68 65 72 20 62 61 6c 61 6e 63 65 5f 6e 6f ither balance_no
381b0 6e 72 6f 6f 74 28 29 20 6f 72 20 62 61 6c 61 6e nroot() or balan
381c0 63 65 5f 64 65 65 70 65 72 28 29 2e 20 55 6e 74 ce_deeper(). Unt
381d0 69 6c 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 il this.
381e0 20 20 2a 2a 20 68 61 70 70 65 6e 73 2c 20 74 68 ** happens, th
381f0 65 20 6f 76 65 72 66 6c 6f 77 20 63 65 6c 6c 20 e overflow cell
38200 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 is stored in the
38210 20 61 42 61 6c 61 6e 63 65 51 75 69 63 6b 53 70 aBalanceQuickSp
38220 61 63 65 5b 5d 0a 20 20 20 20 20 20 20 20 20 20 ace[].
38230 2a 2a 20 62 75 66 66 65 72 2e 20 0a 20 20 20 20 ** buffer. .
38240 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 **.
38250 20 20 20 2a 2a 20 54 68 65 20 70 75 72 70 6f 73 ** The purpos
38260 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
38270 6e 67 20 61 73 73 65 72 74 28 29 20 69 73 20 74 ng assert() is t
38280 6f 20 63 68 65 63 6b 20 74 68 61 74 20 6f 6e 6c o check that onl
38290 79 20 61 0a 20 20 20 20 20 20 20 20 20 20 2a 2a y a. **
382a0 20 73 69 6e 67 6c 65 20 63 61 6c 6c 20 74 6f 20 single call to
382b0 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b 28 29 20 balance_quick()
382c0 69 73 20 6d 61 64 65 20 66 6f 72 20 65 61 63 68 is made for each
382d0 20 63 61 6c 6c 20 74 6f 20 74 68 69 73 0a 20 20 call to this.
382e0 20 20 20 20 20 20 20 20 2a 2a 20 66 75 6e 63 74 ** funct
382f0 69 6f 6e 2e 20 49 66 20 74 68 69 73 20 77 65 72 ion. If this wer
38300 65 20 6e 6f 74 20 76 65 72 69 66 69 65 64 2c 20 e not verified,
38310 61 20 73 75 62 74 6c 65 20 62 75 67 20 69 6e 76 a subtle bug inv
38320 6f 6c 76 69 6e 67 20 72 65 75 73 65 0a 20 20 20 olving reuse.
38330 20 20 20 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 ** of the
38340 20 61 42 61 6c 61 6e 63 65 51 75 69 63 6b 53 70 aBalanceQuickSp
38350 61 63 65 5b 5d 20 6d 69 67 68 74 20 73 6e 65 61 ace[] might snea
38360 6b 20 69 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 k in..
38370 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 */. ass
38380 65 72 74 28 20 28 62 61 6c 61 6e 63 65 5f 71 75 ert( (balance_qu
38390 69 63 6b 5f 63 61 6c 6c 65 64 2b 2b 29 3d 3d 30 ick_called++)==0
383a0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 );. rc
383b0 20 3d 20 62 61 6c 61 6e 63 65 5f 71 75 69 63 6b = balance_quick
383c0 28 70 50 61 72 65 6e 74 2c 20 70 50 61 67 65 2c (pParent, pPage,
383d0 20 61 42 61 6c 61 6e 63 65 51 75 69 63 6b 53 70 aBalanceQuickSp
383e0 61 63 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 ace);. }e
383f0 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 lse.#endif.
38400 20 20 20 7b 0a 20 20 20 20 20 20 20 20 20 20 2f {. /
38410 2a 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 * In this case,
38420 63 61 6c 6c 20 62 61 6c 61 6e 63 65 5f 6e 6f 6e call balance_non
38430 72 6f 6f 74 28 29 20 74 6f 20 72 65 64 69 73 74 root() to redist
38440 72 69 62 75 74 65 20 63 65 6c 6c 73 0a 20 20 20 ribute cells.
38450 20 20 20 20 20 20 20 2a 2a 20 62 65 74 77 65 65 ** betwee
38460 6e 20 70 50 61 67 65 2