0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
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 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 ******.** This i
0180: 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 s the implementa
0190: 74 69 6f 6e 20 6f 66 20 74 68 65 20 70 61 67 65 tion of the page
01a0: 20 63 61 63 68 65 20 73 75 62 73 79 73 74 65 6d cache subsystem
01b0: 20 6f 72 20 22 70 61 67 65 72 22 2e 0a 2a 2a 20 or "pager"..**
01c0: 0a 2a 2a 20 54 68 65 20 70 61 67 65 72 20 69 73 .** The pager is
01d0: 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 used to access
01e0: 61 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 a database disk
01f0: 66 69 6c 65 2e 20 20 49 74 20 69 6d 70 6c 65 6d file. It implem
0200: 65 6e 74 73 0a 2a 2a 20 61 74 6f 6d 69 63 20 63 ents.** atomic c
0210: 6f 6d 6d 69 74 20 61 6e 64 20 72 6f 6c 6c 62 61 ommit and rollba
0220: 63 6b 20 74 68 72 6f 75 67 68 20 74 68 65 20 75 ck through the u
0230: 73 65 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c 20 se of a journal
0240: 66 69 6c 65 20 74 68 61 74 0a 2a 2a 20 69 73 20 file that.** is
0250: 73 65 70 61 72 61 74 65 20 66 72 6f 6d 20 74 68 separate from th
0260: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
0270: 20 20 54 68 65 20 70 61 67 65 72 20 61 6c 73 6f The pager also
0280: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 66 69 6c 65 implements file
0290: 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 20 74 6f 20 70 .** locking to p
02a0: 72 65 76 65 6e 74 20 74 77 6f 20 70 72 6f 63 65 revent two proce
02b0: 73 73 65 73 20 66 72 6f 6d 20 77 72 69 74 69 6e sses from writin
02c0: 67 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 62 g the same datab
02d0: 61 73 65 0a 2a 2a 20 66 69 6c 65 20 73 69 6d 75 ase.** file simu
02e0: 6c 74 61 6e 65 6f 75 73 6c 79 2c 20 6f 72 20 6f ltaneously, or o
02f0: 6e 65 20 70 72 6f 63 65 73 73 20 66 72 6f 6d 20 ne process from
0300: 72 65 61 64 69 6e 67 20 74 68 65 20 64 61 74 61 reading the data
0310: 62 61 73 65 20 77 68 69 6c 65 0a 2a 2a 20 61 6e base while.** an
0320: 6f 74 68 65 72 20 69 73 20 77 72 69 74 69 6e 67 other is writing
0330: 2e 0a 2a 2a 0a 2a 2a 20 40 28 23 29 20 24 49 64 ..**.** @(#) $Id
0340: 3a 20 70 61 67 65 72 2e 63 2c 76 20 31 2e 34 33 : pager.c,v 1.43
0350: 33 20 32 30 30 38 2f 30 34 2f 32 32 20 31 37 3a 3 2008/04/22 17:
0360: 31 35 3a 31 38 20 64 72 68 20 45 78 70 20 24 0a 15:18 drh Exp $.
0370: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
0380: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 23 69 E_OMIT_DISKIO.#i
0390: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e nclude "sqliteIn
03a0: 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c 61 t.h".#include <a
03b0: 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 6c 75 64 ssert.h>.#includ
03c0: 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 0a 2f 2a e <string.h>../*
03d0: 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 .** Macros for t
03e0: 72 6f 75 62 6c 65 73 68 6f 6f 74 69 6e 67 2e 20 roubleshooting.
03f0: 20 4e 6f 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 Normally turned
0400: 20 6f 66 66 0a 2a 2f 0a 23 69 66 20 30 0a 23 64 off.*/.#if 0.#d
0410: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 44 65 62 efine sqlite3Deb
0420: 75 67 50 72 69 6e 74 66 20 70 72 69 6e 74 66 0a ugPrintf printf.
0430: 23 64 65 66 69 6e 65 20 50 41 47 45 52 54 52 41 #define PAGERTRA
0440: 43 45 31 28 58 29 20 20 20 20 20 20 20 73 71 6c CE1(X) sql
0450: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
0460: 58 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 X).#define PAGER
0470: 54 52 41 43 45 32 28 58 2c 59 29 20 20 20 20 20 TRACE2(X,Y)
0480: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
0490: 74 66 28 58 2c 59 29 0a 23 64 65 66 69 6e 65 20 tf(X,Y).#define
04a0: 50 41 47 45 52 54 52 41 43 45 33 28 58 2c 59 2c PAGERTRACE3(X,Y,
04b0: 5a 29 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 Z) sqlite3Debu
04c0: 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 29 0a 23 gPrintf(X,Y,Z).#
04d0: 64 65 66 69 6e 65 20 50 41 47 45 52 54 52 41 43 define PAGERTRAC
04e0: 45 34 28 58 2c 59 2c 5a 2c 57 29 20 73 71 6c 69 E4(X,Y,Z,W) sqli
04f0: 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 58 te3DebugPrintf(X
0500: 2c 59 2c 5a 2c 57 29 0a 23 64 65 66 69 6e 65 20 ,Y,Z,W).#define
0510: 50 41 47 45 52 54 52 41 43 45 35 28 58 2c 59 2c PAGERTRACE5(X,Y,
0520: 5a 2c 57 2c 56 29 20 73 71 6c 69 74 65 33 44 65 Z,W,V) sqlite3De
0530: 62 75 67 50 72 69 6e 74 66 28 58 2c 59 2c 5a 2c bugPrintf(X,Y,Z,
0540: 57 2c 56 29 0a 23 65 6c 73 65 0a 23 64 65 66 69 W,V).#else.#defi
0550: 6e 65 20 50 41 47 45 52 54 52 41 43 45 31 28 58 ne PAGERTRACE1(X
0560: 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 54 ).#define PAGERT
0570: 52 41 43 45 32 28 58 2c 59 29 0a 23 64 65 66 69 RACE2(X,Y).#defi
0580: 6e 65 20 50 41 47 45 52 54 52 41 43 45 33 28 58 ne PAGERTRACE3(X
0590: 2c 59 2c 5a 29 0a 23 64 65 66 69 6e 65 20 50 41 ,Y,Z).#define PA
05a0: 47 45 52 54 52 41 43 45 34 28 58 2c 59 2c 5a 2c GERTRACE4(X,Y,Z,
05b0: 57 29 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 W).#define PAGER
05c0: 54 52 41 43 45 35 28 58 2c 59 2c 5a 2c 57 2c 56 TRACE5(X,Y,Z,W,V
05d0: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
05e0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 77 The following tw
05f0: 6f 20 6d 61 63 72 6f 73 20 61 72 65 20 75 73 65 o macros are use
0600: 64 20 77 69 74 68 69 6e 20 74 68 65 20 50 41 47 d within the PAG
0610: 45 52 54 52 41 43 45 58 28 29 20 6d 61 63 72 6f ERTRACEX() macro
0620: 73 20 61 62 6f 76 65 0a 2a 2a 20 74 6f 20 70 72 s above.** to pr
0630: 69 6e 74 20 6f 75 74 20 66 69 6c 65 2d 64 65 73 int out file-des
0640: 63 72 69 70 74 6f 72 73 2e 20 0a 2a 2a 0a 2a 2a criptors. .**.**
0650: 20 50 41 47 45 52 49 44 28 29 20 74 61 6b 65 73 PAGERID() takes
0660: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
0670: 50 61 67 65 72 20 73 74 72 75 63 74 20 61 73 20 Pager struct as
0680: 69 74 73 20 61 72 67 75 6d 65 6e 74 2e 20 54 68 its argument. Th
0690: 65 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 e.** associated
06a0: 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 20 file-descriptor
06b0: 69 73 20 72 65 74 75 72 6e 65 64 2e 20 46 49 4c is returned. FIL
06c0: 45 48 41 4e 44 4c 45 49 44 28 29 20 74 61 6b 65 EHANDLEID() take
06d0: 73 20 61 6e 20 73 71 6c 69 74 65 33 5f 66 69 6c s an sqlite3_fil
06e0: 65 0a 2a 2a 20 73 74 72 75 63 74 20 61 73 20 69 e.** struct as i
06f0: 74 73 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a ts argument..*/.
0700: 23 64 65 66 69 6e 65 20 50 41 47 45 52 49 44 28 #define PAGERID(
0710: 70 29 20 28 28 69 6e 74 29 28 70 2d 3e 66 64 29 p) ((int)(p->fd)
0720: 29 0a 23 64 65 66 69 6e 65 20 46 49 4c 45 48 41 ).#define FILEHA
0730: 4e 44 4c 45 49 44 28 66 64 29 20 28 28 69 6e 74 NDLEID(fd) ((int
0740: 29 66 64 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 )fd)../*.** The
0750: 70 61 67 65 20 63 61 63 68 65 20 61 73 20 61 20 page cache as a
0760: 77 68 6f 6c 65 20 69 73 20 61 6c 77 61 79 73 20 whole is always
0770: 69 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f in one of the fo
0780: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 61 74 65 llowing.** state
0790: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 50 41 47 45 52 s:.**.** PAGER
07a0: 5f 55 4e 4c 4f 43 4b 20 20 20 20 20 20 20 20 54 _UNLOCK T
07b0: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 he page cache is
07c0: 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 72 not currently r
07d0: 65 61 64 69 6e 67 20 6f 72 20 0a 2a 2a 20 20 20 eading or .**
07e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
07f0: 20 20 20 20 77 72 69 74 69 6e 67 20 74 68 65 20 writing the
0800: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
0810: 54 68 65 72 65 20 69 73 20 6e 6f 0a 2a 2a 20 20 There is no.**
0820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0830: 20 20 20 20 20 64 61 74 61 20 68 65 6c 64 20 69 data held i
0840: 6e 20 6d 65 6d 6f 72 79 2e 20 20 54 68 69 73 20 n memory. This
0850: 69 73 20 74 68 65 20 69 6e 69 74 69 61 6c 0a 2a is the initial.*
0860: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
0870: 20 20 20 20 20 20 20 20 73 74 61 74 65 2e 0a 2a state..*
0880: 2a 0a 2a 2a 20 20 20 50 41 47 45 52 5f 53 48 41 *.** PAGER_SHA
0890: 52 45 44 20 20 20 20 20 20 20 20 54 68 65 20 70 RED The p
08a0: 61 67 65 20 63 61 63 68 65 20 69 73 20 72 65 61 age cache is rea
08b0: 64 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 ding the databas
08c0: 65 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 e..**
08d0: 20 20 20 20 20 20 20 20 20 20 20 20 57 72 69 74 Writ
08e0: 69 6e 67 20 69 73 20 6e 6f 74 20 70 65 72 6d 69 ing is not permi
08f0: 74 74 65 64 2e 20 20 54 68 65 72 65 20 63 61 6e tted. There can
0900: 20 62 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 be.**
0910: 20 20 20 20 20 20 20 20 20 20 20 20 20 6d 75 6c mul
0920: 74 69 70 6c 65 20 72 65 61 64 65 72 73 20 61 63 tiple readers ac
0930: 63 65 73 73 69 6e 67 20 74 68 65 20 73 61 6d 65 cessing the same
0940: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 database.**
0950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0960: 20 20 20 66 69 6c 65 20 61 74 20 74 68 65 20 73 file at the s
0970: 61 6d 65 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 ame time..**.**
0980: 20 20 50 41 47 45 52 5f 52 45 53 45 52 56 45 44 PAGER_RESERVED
0990: 20 20 20 20 20 20 54 68 69 73 20 70 72 6f 63 65 This proce
09a0: 73 73 20 68 61 73 20 72 65 73 65 72 76 65 64 20 ss has reserved
09b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 6f 72 the database for
09c0: 20 77 72 69 74 69 6e 67 0a 2a 2a 20 20 20 20 20 writing.**
09d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
09e0: 20 20 62 75 74 20 68 61 73 20 6e 6f 74 20 79 65 but has not ye
09f0: 74 20 6d 61 64 65 20 61 6e 79 20 63 68 61 6e 67 t made any chang
0a00: 65 73 2e 20 20 4f 6e 6c 79 20 6f 6e 65 20 70 72 es. Only one pr
0a10: 6f 63 65 73 73 0a 2a 2a 20 20 20 20 20 20 20 20 ocess.**
0a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
0a30: 74 20 61 20 74 69 6d 65 20 63 61 6e 20 72 65 73 t a time can res
0a40: 65 72 76 65 20 74 68 65 20 64 61 74 61 62 61 73 erve the databas
0a50: 65 2e 20 20 54 68 65 20 6f 72 69 67 69 6e 61 6c e. The original
0a60: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
0a70: 20 20 20 20 20 20 20 20 20 20 64 61 74 61 62 61 databa
0a80: 73 65 20 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 se file has not
0a90: 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 73 6f been modified so
0aa0: 20 6f 74 68 65 72 0a 2a 2a 20 20 20 20 20 20 20 other.**
0ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0ac0: 70 72 6f 63 65 73 73 65 73 20 6d 61 79 20 73 74 processes may st
0ad0: 69 6c 6c 20 62 65 20 72 65 61 64 69 6e 67 20 74 ill be reading t
0ae0: 68 65 20 6f 6e 2d 64 69 73 6b 0a 2a 2a 20 20 20 he on-disk.**
0af0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b00: 20 20 20 20 64 61 74 61 62 61 73 65 20 66 69 6c database fil
0b10: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 50 41 47 45 52 e..**.** PAGER
0b20: 5f 45 58 43 4c 55 53 49 56 45 20 20 20 20 20 54 _EXCLUSIVE T
0b30: 68 65 20 70 61 67 65 20 63 61 63 68 65 20 69 73 he page cache is
0b40: 20 77 72 69 74 69 6e 67 20 74 68 65 20 64 61 74 writing the dat
0b50: 61 62 61 73 65 2e 0a 2a 2a 20 20 20 20 20 20 20 abase..**
0b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0b70: 41 63 63 65 73 73 20 69 73 20 65 78 63 6c 75 73 Access is exclus
0b80: 69 76 65 2e 20 20 4e 6f 20 6f 74 68 65 72 20 70 ive. No other p
0b90: 72 6f 63 65 73 73 65 73 20 6f 72 0a 2a 2a 20 20 rocesses or.**
0ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0bb0: 20 20 20 20 20 74 68 72 65 61 64 73 20 63 61 6e threads can
0bc0: 20 62 65 20 72 65 61 64 69 6e 67 20 6f 72 20 77 be reading or w
0bd0: 72 69 74 69 6e 67 20 77 68 69 6c 65 20 6f 6e 65 riting while one
0be0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
0bf0: 20 20 20 20 20 20 20 20 20 20 70 72 6f 63 65 73 proces
0c00: 73 20 69 73 20 77 72 69 74 69 6e 67 2e 0a 2a 2a s is writing..**
0c10: 0a 2a 2a 20 20 20 50 41 47 45 52 5f 53 59 4e 43 .** PAGER_SYNC
0c20: 45 44 20 20 20 20 20 20 20 20 54 68 65 20 70 61 ED The pa
0c30: 67 65 72 20 6d 6f 76 65 73 20 74 6f 20 74 68 69 ger moves to thi
0c40: 73 20 73 74 61 74 65 20 66 72 6f 6d 20 50 41 47 s state from PAG
0c50: 45 52 5f 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 ER_EXCLUSIVE.**
0c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0c70: 20 20 20 20 20 20 61 66 74 65 72 20 61 6c 6c 20 after all
0c80: 64 69 72 74 79 20 70 61 67 65 73 20 68 61 76 65 dirty pages have
0c90: 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f been written to
0ca0: 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 the.**
0cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 61 da
0cc0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 20 tabase file and
0cd0: 74 68 65 20 66 69 6c 65 20 68 61 73 20 62 65 65 the file has bee
0ce0: 6e 20 73 79 6e 63 65 64 20 74 6f 0a 2a 2a 20 20 n synced to.**
0cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0d00: 20 20 20 20 20 64 69 73 6b 2e 20 41 6c 6c 20 74 disk. All t
0d10: 68 61 74 20 72 65 6d 61 69 6e 73 20 74 6f 20 64 hat remains to d
0d20: 6f 20 69 73 20 74 6f 20 72 65 6d 6f 76 65 20 6f o is to remove o
0d30: 72 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 r.**
0d40: 20 20 20 20 20 20 20 20 20 20 20 74 72 75 6e 63 trunc
0d50: 61 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ate the journal
0d60: 66 69 6c 65 20 61 6e 64 20 74 68 65 20 74 72 61 file and the tra
0d70: 6e 73 61 63 74 69 6f 6e 20 0a 2a 2a 20 20 20 20 nsaction .**
0d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0d90: 20 20 20 77 69 6c 6c 20 62 65 20 63 6f 6d 6d 69 will be commi
0da0: 74 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 tted..**.** The
0db0: 70 61 67 65 20 63 61 63 68 65 20 63 6f 6d 65 73 page cache comes
0dc0: 20 75 70 20 69 6e 20 50 41 47 45 52 5f 55 4e 4c up in PAGER_UNL
0dd0: 4f 43 4b 2e 20 20 54 68 65 20 66 69 72 73 74 20 OCK. The first
0de0: 74 69 6d 65 20 61 0a 2a 2a 20 73 71 6c 69 74 65 time a.** sqlite
0df0: 33 50 61 67 65 72 47 65 74 28 29 20 6f 63 63 75 3PagerGet() occu
0e00: 72 73 2c 20 74 68 65 20 73 74 61 74 65 20 74 72 rs, the state tr
0e10: 61 6e 73 69 74 69 6f 6e 73 20 74 6f 20 50 41 47 ansitions to PAG
0e20: 45 52 5f 53 48 41 52 45 44 2e 0a 2a 2a 20 41 66 ER_SHARED..** Af
0e30: 74 65 72 20 61 6c 6c 20 70 61 67 65 73 20 68 61 ter all pages ha
0e40: 76 65 20 62 65 65 6e 20 72 65 6c 65 61 73 65 64 ve been released
0e50: 20 75 73 69 6e 67 20 73 71 6c 69 74 65 5f 70 61 using sqlite_pa
0e60: 67 65 5f 75 6e 72 65 66 28 29 2c 0a 2a 2a 20 74 ge_unref(),.** t
0e70: 68 65 20 73 74 61 74 65 20 74 72 61 6e 73 69 74 he state transit
0e80: 69 6f 6e 73 20 62 61 63 6b 20 74 6f 20 50 41 47 ions back to PAG
0e90: 45 52 5f 55 4e 4c 4f 43 4b 2e 20 20 54 68 65 20 ER_UNLOCK. The
0ea0: 66 69 72 73 74 20 74 69 6d 65 0a 2a 2a 20 74 68 first time.** th
0eb0: 61 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 57 at sqlite3PagerW
0ec0: 72 69 74 65 28 29 20 69 73 20 63 61 6c 6c 65 64 rite() is called
0ed0: 2c 20 74 68 65 20 73 74 61 74 65 20 74 72 61 6e , the state tran
0ee0: 73 69 74 69 6f 6e 73 20 74 6f 0a 2a 2a 20 50 41 sitions to.** PA
0ef0: 47 45 52 5f 52 45 53 45 52 56 45 44 2e 20 20 28 GER_RESERVED. (
0f00: 4e 6f 74 65 20 74 68 61 74 20 73 71 6c 69 74 65 Note that sqlite
0f10: 33 50 61 67 65 72 57 72 69 74 65 28 29 20 63 61 3PagerWrite() ca
0f20: 6e 20 6f 6e 6c 79 20 62 65 0a 2a 2a 20 63 61 6c n only be.** cal
0f30: 6c 65 64 20 6f 6e 20 61 6e 20 6f 75 74 73 74 61 led on an outsta
0f40: 6e 64 69 6e 67 20 70 61 67 65 20 77 68 69 63 68 nding page which
0f50: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
0f60: 70 61 67 65 72 20 6d 75 73 74 0a 2a 2a 20 62 65 pager must.** be
0f70: 20 69 6e 20 50 41 47 45 52 5f 53 48 41 52 45 44 in PAGER_SHARED
0f80: 20 62 65 66 6f 72 65 20 69 74 20 74 72 61 6e 73 before it trans
0f90: 69 74 69 6f 6e 73 20 74 6f 20 50 41 47 45 52 5f itions to PAGER_
0fa0: 52 45 53 45 52 56 45 44 2e 29 0a 2a 2a 20 50 41 RESERVED.).** PA
0fb0: 47 45 52 5f 52 45 53 45 52 56 45 44 20 6d 65 61 GER_RESERVED mea
0fc0: 6e 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 ns that there is
0fd0: 20 61 6e 20 6f 70 65 6e 20 72 6f 6c 6c 62 61 63 an open rollbac
0fe0: 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 54 68 k journal..** Th
0ff0: 65 20 74 72 61 6e 73 69 74 69 6f 6e 20 74 6f 20 e transition to
1000: 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 PAGER_EXCLUSIVE
1010: 6f 63 63 75 72 73 20 62 65 66 6f 72 65 20 61 6e occurs before an
1020: 79 20 63 68 61 6e 67 65 73 0a 2a 2a 20 61 72 65 y changes.** are
1030: 20 6d 61 64 65 20 74 6f 20 74 68 65 20 64 61 74 made to the dat
1040: 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 6f 75 abase file, thou
1050: 67 68 20 77 72 69 74 65 73 20 74 6f 20 74 68 65 gh writes to the
1060: 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 6a 6f 75 rollback.** jou
1070: 72 6e 61 6c 20 6f 63 63 75 72 73 20 77 69 74 68 rnal occurs with
1080: 20 6a 75 73 74 20 50 41 47 45 52 5f 52 45 53 45 just PAGER_RESE
1090: 52 56 45 44 2e 20 20 41 66 74 65 72 20 61 6e 20 RVED. After an
10a0: 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c sqlite3PagerRoll
10b0: 62 61 63 6b 28 29 0a 2a 2a 20 6f 72 20 73 71 6c back().** or sql
10c0: 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 ite3PagerCommitP
10d0: 68 61 73 65 54 77 6f 28 29 2c 20 74 68 65 20 73 haseTwo(), the s
10e0: 74 61 74 65 20 63 61 6e 20 67 6f 20 62 61 63 6b tate can go back
10f0: 20 74 6f 20 50 41 47 45 52 5f 53 48 41 52 45 44 to PAGER_SHARED
1100: 2c 0a 2a 2a 20 6f 72 20 69 74 20 63 61 6e 20 73 ,.** or it can s
1110: 74 61 79 20 61 74 20 50 41 47 45 52 5f 45 58 43 tay at PAGER_EXC
1120: 4c 55 53 49 56 45 20 69 66 20 77 65 20 61 72 65 LUSIVE if we are
1130: 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 61 63 in exclusive ac
1140: 63 65 73 73 20 6d 6f 64 65 2e 0a 2a 2f 0a 23 64 cess mode..*/.#d
1150: 65 66 69 6e 65 20 50 41 47 45 52 5f 55 4e 4c 4f efine PAGER_UNLO
1160: 43 4b 20 20 20 20 20 20 30 0a 23 64 65 66 69 6e CK 0.#defin
1170: 65 20 50 41 47 45 52 5f 53 48 41 52 45 44 20 20 e PAGER_SHARED
1180: 20 20 20 20 31 20 20 20 2f 2a 20 73 61 6d 65 20 1 /* same
1190: 61 73 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 2a as SHARED_LOCK *
11a0: 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f /.#define PAGER_
11b0: 52 45 53 45 52 56 45 44 20 20 20 20 32 20 20 20 RESERVED 2
11c0: 2f 2a 20 73 61 6d 65 20 61 73 20 52 45 53 45 52 /* same as RESER
11d0: 56 45 44 5f 4c 4f 43 4b 20 2a 2f 0a 23 64 65 66 VED_LOCK */.#def
11e0: 69 6e 65 20 50 41 47 45 52 5f 45 58 43 4c 55 53 ine PAGER_EXCLUS
11f0: 49 56 45 20 20 20 34 20 20 20 2f 2a 20 73 61 6d IVE 4 /* sam
1200: 65 20 61 73 20 45 58 43 4c 55 53 49 56 45 5f 4c e as EXCLUSIVE_L
1210: 4f 43 4b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 OCK */.#define P
1220: 41 47 45 52 5f 53 59 4e 43 45 44 20 20 20 20 20 AGER_SYNCED
1230: 20 35 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 5../*.** If the
1240: 20 53 51 4c 49 54 45 5f 42 55 53 59 5f 52 45 53 SQLITE_BUSY_RES
1250: 45 52 56 45 44 5f 4c 4f 43 4b 20 6d 61 63 72 6f ERVED_LOCK macro
1260: 20 69 73 20 73 65 74 20 74 6f 20 74 72 75 65 20 is set to true
1270: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c at compile-time,
1280: 0a 2a 2a 20 74 68 65 6e 20 66 61 69 6c 65 64 20 .** then failed
1290: 61 74 74 65 6d 70 74 73 20 74 6f 20 67 65 74 20 attempts to get
12a0: 61 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b 20 a reserved lock
12b0: 77 69 6c 6c 20 69 6e 76 6f 6b 65 20 74 68 65 20 will invoke the
12c0: 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 2e 0a 2a busy callback..*
12d0: 2a 20 54 68 69 73 20 69 73 20 6f 66 66 20 62 79 * This is off by
12e0: 20 64 65 66 61 75 6c 74 2e 20 20 54 6f 20 73 65 default. To se
12f0: 65 20 77 68 79 2c 20 63 6f 6e 73 69 64 65 72 20 e why, consider
1300: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 63 the following sc
1310: 65 6e 61 72 69 6f 3a 0a 2a 2a 20 0a 2a 2a 20 53 enario:.** .** S
1320: 75 70 70 6f 73 65 20 74 68 72 65 61 64 20 41 20 uppose thread A
1330: 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 73 68 already has a sh
1340: 61 72 65 64 20 6c 6f 63 6b 20 61 6e 64 20 77 61 ared lock and wa
1350: 6e 74 73 20 61 20 72 65 73 65 72 76 65 64 20 6c nts a reserved l
1360: 6f 63 6b 2e 0a 2a 2a 20 54 68 72 65 61 64 20 42 ock..** Thread B
1370: 20 61 6c 72 65 61 64 79 20 68 61 73 20 61 20 72 already has a r
1380: 65 73 65 72 76 65 64 20 6c 6f 63 6b 20 61 6e 64 eserved lock and
1390: 20 77 61 6e 74 73 20 61 6e 20 65 78 63 6c 75 73 wants an exclus
13a0: 69 76 65 20 6c 6f 63 6b 2e 20 20 49 66 0a 2a 2a ive lock. If.**
13b0: 20 62 6f 74 68 20 74 68 72 65 61 64 73 20 61 72 both threads ar
13c0: 65 20 75 73 69 6e 67 20 74 68 65 69 72 20 62 75 e using their bu
13d0: 73 79 20 63 61 6c 6c 62 61 63 6b 73 2c 20 69 74 sy callbacks, it
13e0: 20 6d 69 67 68 74 20 62 65 20 61 20 6c 6f 6e 67 might be a long
13f0: 20 74 69 6d 65 0a 2a 2a 20 62 65 20 66 6f 72 20 time.** be for
1400: 6f 6e 65 20 6f 66 20 74 68 65 20 74 68 72 65 61 one of the threa
1410: 64 73 20 67 69 76 65 20 75 70 20 61 6e 64 20 61 ds give up and a
1420: 6c 6c 6f 77 73 20 74 68 65 20 6f 74 68 65 72 20 llows the other
1430: 74 6f 20 70 72 6f 63 65 65 64 2e 0a 2a 2a 20 42 to proceed..** B
1440: 75 74 20 69 66 20 74 68 65 20 74 68 72 65 61 64 ut if the thread
1450: 20 74 72 79 69 6e 67 20 74 6f 20 67 65 74 20 74 trying to get t
1460: 68 65 20 72 65 73 65 72 76 65 64 20 6c 6f 63 6b he reserved lock
1470: 20 67 69 76 65 73 20 75 70 20 71 75 69 63 6b 6c gives up quickl
1480: 79 0a 2a 2a 20 28 69 66 20 69 74 20 6e 65 76 65 y.** (if it neve
1490: 72 20 69 6e 76 6f 6b 65 73 20 69 74 73 20 62 75 r invokes its bu
14a0: 73 79 20 63 61 6c 6c 62 61 63 6b 29 20 74 68 65 sy callback) the
14b0: 6e 20 74 68 65 20 63 6f 6e 74 65 6e 74 69 6f 6e n the contention
14c0: 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 72 65 73 6f will be.** reso
14d0: 6c 76 65 64 20 71 75 69 63 6b 6c 79 2e 0a 2a 2f lved quickly..*/
14e0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
14f0: 42 55 53 59 5f 52 45 53 45 52 56 45 44 5f 4c 4f BUSY_RESERVED_LO
1500: 43 4b 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 CK.# define SQLI
1510: 54 45 5f 42 55 53 59 5f 52 45 53 45 52 56 45 44 TE_BUSY_RESERVED
1520: 5f 4c 4f 43 4b 20 30 0a 23 65 6e 64 69 66 0a 0a _LOCK 0.#endif..
1530: 2f 2a 0a 2a 2a 20 54 68 69 73 20 6d 61 63 72 6f /*.** This macro
1540: 20 72 6f 75 6e 64 73 20 76 61 6c 75 65 73 20 75 rounds values u
1550: 70 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65 p so that if the
1560: 20 76 61 6c 75 65 20 69 73 20 61 6e 20 61 64 64 value is an add
1570: 72 65 73 73 20 69 74 0a 2a 2a 20 69 73 20 67 75 ress it.** is gu
1580: 61 72 61 6e 74 65 65 64 20 74 6f 20 62 65 20 61 aranteed to be a
1590: 6e 20 61 64 64 72 65 73 73 20 74 68 61 74 20 69 n address that i
15a0: 73 20 61 6c 69 67 6e 65 64 20 74 6f 20 61 6e 20 s aligned to an
15b0: 38 2d 62 79 74 65 20 62 6f 75 6e 64 61 72 79 2e 8-byte boundary.
15c0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 46 4f 52 43 .*/.#define FORC
15d0: 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 E_ALIGNMENT(X)
15e0: 20 28 28 28 58 29 2b 37 29 26 7e 37 29 0a 0a 74 (((X)+7)&~7)..t
15f0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 50 67 ypedef struct Pg
1600: 48 64 72 20 50 67 48 64 72 3b 0a 0a 2f 2a 0a 2a Hdr PgHdr;../*.*
1610: 2a 20 45 61 63 68 20 70 61 67 65 72 20 73 74 6f * Each pager sto
1620: 72 65 73 20 61 6c 6c 20 63 75 72 72 65 6e 74 6c res all currentl
1630: 79 20 75 6e 72 65 66 65 72 65 6e 63 65 64 20 70 y unreferenced p
1640: 61 67 65 73 20 69 6e 20 61 20 6c 69 73 74 20 73 ages in a list s
1650: 6f 72 74 65 64 0a 2a 2a 20 69 6e 20 6c 65 61 73 orted.** in leas
1660: 74 2d 72 65 63 65 6e 74 6c 79 2d 75 73 65 64 20 t-recently-used
1670: 28 4c 52 55 29 20 6f 72 64 65 72 20 28 69 2e 65 (LRU) order (i.e
1680: 2e 20 74 68 65 20 66 69 72 73 74 20 69 74 65 6d . the first item
1690: 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 68 61 73 on the list has
16a0: 20 0a 2a 2a 20 6e 6f 74 20 62 65 65 6e 20 72 65 .** not been re
16b0: 66 65 72 65 6e 63 65 64 20 69 6e 20 61 20 6c 6f ferenced in a lo
16c0: 6e 67 20 74 69 6d 65 2c 20 74 68 65 20 6c 61 73 ng time, the las
16d0: 74 20 69 74 65 6d 20 68 61 73 20 62 65 65 6e 20 t item has been
16e0: 72 65 63 65 6e 74 6c 79 0a 2a 2a 20 75 73 65 64 recently.** used
16f0: 29 2e 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ). An instance o
1700: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 f this structure
1710: 20 69 73 20 69 6e 63 6c 75 64 65 64 20 61 73 20 is included as
1720: 70 61 72 74 20 6f 66 20 65 61 63 68 0a 2a 2a 20 part of each.**
1730: 70 61 67 65 72 20 73 74 72 75 63 74 75 72 65 20 pager structure
1740: 66 6f 72 20 74 68 69 73 20 70 75 72 70 6f 73 65 for this purpose
1750: 20 28 76 61 72 69 61 62 6c 65 20 50 61 67 65 72 (variable Pager
1760: 2e 6c 72 75 29 2e 0a 2a 2a 0a 2a 2a 20 41 64 64 .lru)..**.** Add
1770: 69 74 69 6f 6e 61 6c 6c 79 2c 20 69 66 20 6d 65 itionally, if me
1780: 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d 65 6e 74 20 mory-management
1790: 69 73 20 65 6e 61 62 6c 65 64 2c 20 61 6c 6c 20 is enabled, all
17a0: 75 6e 72 65 66 65 72 65 6e 63 65 64 20 70 61 67 unreferenced pag
17b0: 65 73 20 0a 2a 2a 20 61 72 65 20 73 74 6f 72 65 es .** are store
17c0: 64 20 69 6e 20 61 20 67 6c 6f 62 61 6c 20 4c 52 d in a global LR
17d0: 55 20 6c 69 73 74 20 28 67 6c 6f 62 61 6c 20 76 U list (global v
17e0: 61 72 69 61 62 6c 65 20 73 71 6c 69 74 65 33 4c ariable sqlite3L
17f0: 72 75 50 61 67 65 4c 69 73 74 29 2e 0a 2a 2a 0a ruPageList)..**.
1800: 2a 2a 20 49 6e 20 62 6f 74 68 20 63 61 73 65 73 ** In both cases
1810: 2c 20 74 68 65 20 50 61 67 65 72 4c 72 75 4c 69 , the PagerLruLi
1820: 73 74 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20 st.pFirstSynced
1830: 76 61 72 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 variable points
1840: 74 6f 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 to.** the first
1850: 70 61 67 65 20 69 6e 20 74 68 65 20 63 6f 72 72 page in the corr
1860: 65 73 70 6f 6e 64 69 6e 67 20 6c 69 73 74 20 74 esponding list t
1870: 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 hat does not req
1880: 75 69 72 65 20 61 6e 0a 2a 2a 20 66 73 79 6e 63 uire an.** fsync
1890: 28 29 20 6f 70 65 72 61 74 69 6f 6e 20 62 65 66 () operation bef
18a0: 6f 72 65 20 69 74 73 20 6d 65 6d 6f 72 79 20 63 ore its memory c
18b0: 61 6e 20 62 65 20 72 65 63 6c 61 69 6d 65 64 2e an be reclaimed.
18c0: 20 49 66 20 6e 6f 20 73 75 63 68 0a 2a 2a 20 70 If no such.** p
18d0: 61 67 65 20 65 78 69 73 74 73 2c 20 50 61 67 65 age exists, Page
18e0: 72 4c 72 75 4c 69 73 74 2e 70 46 69 72 73 74 53 rLruList.pFirstS
18f0: 79 6e 63 65 64 20 69 73 20 73 65 74 20 74 6f 20 ynced is set to
1900: 4e 55 4c 4c 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 NULL..*/.typedef
1910: 20 73 74 72 75 63 74 20 50 61 67 65 72 4c 72 75 struct PagerLru
1920: 4c 69 73 74 20 50 61 67 65 72 4c 72 75 4c 69 73 List PagerLruLis
1930: 74 3b 0a 73 74 72 75 63 74 20 50 61 67 65 72 4c t;.struct PagerL
1940: 72 75 4c 69 73 74 20 7b 0a 20 20 50 67 48 64 72 ruList {. PgHdr
1950: 20 2a 70 46 69 72 73 74 3b 20 20 20 20 20 20 20 *pFirst;
1960: 20 20 2f 2a 20 46 69 72 73 74 20 70 61 67 65 20 /* First page
1970: 69 6e 20 4c 52 55 20 6c 69 73 74 20 2a 2f 0a 20 in LRU list */.
1980: 20 50 67 48 64 72 20 2a 70 4c 61 73 74 3b 20 20 PgHdr *pLast;
1990: 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 /* Last
19a0: 70 61 67 65 20 69 6e 20 4c 52 55 20 6c 69 73 74 page in LRU list
19b0: 20 28 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e (the most recen
19c0: 74 6c 79 20 75 73 65 64 29 20 2a 2f 0a 20 20 50 tly used) */. P
19d0: 67 48 64 72 20 2a 70 46 69 72 73 74 53 79 6e 63 gHdr *pFirstSync
19e0: 65 64 3b 20 20 20 2f 2a 20 46 69 72 73 74 20 70 ed; /* First p
19f0: 61 67 65 20 69 6e 20 6c 69 73 74 20 77 69 74 68 age in list with
1a00: 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 3d PgHdr.needSync=
1a10: 3d 30 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 =0 */.};../*.**
1a20: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 The following st
1a30: 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 ructure contains
1a40: 20 74 68 65 20 6e 65 78 74 20 61 6e 64 20 70 72 the next and pr
1a50: 65 76 69 6f 75 73 20 70 6f 69 6e 74 65 72 73 20 evious pointers
1a60: 75 73 65 64 0a 2a 2a 20 74 6f 20 6c 69 6e 6b 20 used.** to link
1a70: 61 20 50 67 48 64 72 20 73 74 72 75 63 74 75 72 a PgHdr structur
1a80: 65 20 69 6e 74 6f 20 61 20 50 61 67 65 72 4c 72 e into a PagerLr
1a90: 75 4c 69 73 74 20 6c 69 6e 6b 65 64 20 6c 69 73 uList linked lis
1aa0: 74 2e 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 t. .*/.typedef s
1ab0: 74 72 75 63 74 20 50 61 67 65 72 4c 72 75 4c 69 truct PagerLruLi
1ac0: 6e 6b 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 3b nk PagerLruLink;
1ad0: 0a 73 74 72 75 63 74 20 50 61 67 65 72 4c 72 75 .struct PagerLru
1ae0: 4c 69 6e 6b 20 7b 0a 20 20 50 67 48 64 72 20 2a Link {. PgHdr *
1af0: 70 4e 65 78 74 3b 0a 20 20 50 67 48 64 72 20 2a pNext;. PgHdr *
1b00: 70 50 72 65 76 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a pPrev;.};../*.**
1b10: 20 45 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 Each in-memory
1b20: 69 6d 61 67 65 20 6f 66 20 61 20 70 61 67 65 20 image of a page
1b30: 62 65 67 69 6e 73 20 77 69 74 68 20 74 68 65 20 begins with the
1b40: 66 6f 6c 6c 6f 77 69 6e 67 20 68 65 61 64 65 72 following header
1b50: 2e 0a 2a 2a 20 54 68 69 73 20 68 65 61 64 65 72 ..** This header
1b60: 20 69 73 20 6f 6e 6c 79 20 76 69 73 69 62 6c 65 is only visible
1b70: 20 74 6f 20 74 68 69 73 20 70 61 67 65 72 20 6d to this pager m
1b80: 6f 64 75 6c 65 2e 20 20 54 68 65 20 63 6c 69 65 odule. The clie
1b90: 6e 74 0a 2a 2a 20 63 6f 64 65 20 74 68 61 74 20 nt.** code that
1ba0: 63 61 6c 6c 73 20 70 61 67 65 72 20 73 65 65 73 calls pager sees
1bb0: 20 6f 6e 6c 79 20 74 68 65 20 64 61 74 61 20 74 only the data t
1bc0: 68 61 74 20 66 6f 6c 6c 6f 77 73 20 74 68 65 20 hat follows the
1bd0: 68 65 61 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 43 6c header..**.** Cl
1be0: 69 65 6e 74 20 63 6f 64 65 20 73 68 6f 75 6c 64 ient code should
1bf0: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 call sqlite3Pag
1c00: 65 72 57 72 69 74 65 28 29 20 6f 6e 20 61 20 70 erWrite() on a p
1c10: 61 67 65 20 70 72 69 6f 72 20 74 6f 20 6d 61 6b age prior to mak
1c20: 69 6e 67 0a 2a 2a 20 61 6e 79 20 6d 6f 64 69 66 ing.** any modif
1c30: 69 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 61 74 ications to that
1c40: 20 70 61 67 65 2e 20 20 54 68 65 20 66 69 72 73 page. The firs
1c50: 74 20 74 69 6d 65 20 73 71 6c 69 74 65 33 50 61 t time sqlite3Pa
1c60: 67 65 72 57 72 69 74 65 28 29 0a 2a 2a 20 69 73 gerWrite().** is
1c70: 20 63 61 6c 6c 65 64 2c 20 74 68 65 20 6f 72 69 called, the ori
1c80: 67 69 6e 61 6c 20 70 61 67 65 20 63 6f 6e 74 65 ginal page conte
1c90: 6e 74 73 20 61 72 65 20 77 72 69 74 74 65 6e 20 nts are written
1ca0: 69 6e 74 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63 into the rollbac
1cb0: 6b 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 k.** journal and
1cc0: 20 50 67 48 64 72 2e 69 6e 4a 6f 75 72 6e 61 6c PgHdr.inJournal
1cd0: 20 61 6e 64 20 50 67 48 64 72 2e 6e 65 65 64 53 and PgHdr.needS
1ce0: 79 6e 63 20 61 72 65 20 73 65 74 2e 20 20 4c 61 ync are set. La
1cf0: 74 65 72 2c 20 6f 6e 63 65 0a 2a 2a 20 74 68 65 ter, once.** the
1d00: 20 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 68 61 journal page ha
1d10: 73 20 6d 61 64 65 20 69 74 20 6f 6e 74 6f 20 74 s made it onto t
1d20: 68 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 2c he disk surface,
1d30: 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 0a PgHdr.needSync.
1d40: 2a 2a 20 69 73 20 63 6c 65 61 72 65 64 2e 20 20 ** is cleared.
1d50: 54 68 65 20 6d 6f 64 69 66 69 65 64 20 70 61 67 The modified pag
1d60: 65 20 63 61 6e 6e 6f 74 20 62 65 20 77 72 69 74 e cannot be writ
1d70: 74 65 6e 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 ten back into th
1d80: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 64 61 e original.** da
1d90: 74 61 62 61 73 65 20 66 69 6c 65 20 75 6e 74 69 tabase file unti
1da0: 6c 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 70 61 l the journal pa
1db0: 67 65 73 20 68 61 73 20 62 65 65 6e 20 73 79 6e ges has been syn
1dc0: 63 65 64 20 74 6f 20 64 69 73 6b 20 61 6e 64 20 ced to disk and
1dd0: 74 68 65 0a 2a 2a 20 50 67 48 64 72 2e 6e 65 65 the.** PgHdr.nee
1de0: 64 53 79 6e 63 20 68 61 73 20 62 65 65 6e 20 63 dSync has been c
1df0: 6c 65 61 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 leared..**.** Th
1e00: 65 20 50 67 48 64 72 2e 64 69 72 74 79 20 66 6c e PgHdr.dirty fl
1e10: 61 67 20 69 73 20 73 65 74 20 77 68 65 6e 20 73 ag is set when s
1e20: 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
1e30: 28 29 20 69 73 20 63 61 6c 6c 65 64 20 61 6e 64 () is called and
1e40: 0a 2a 2a 20 69 73 20 63 6c 65 61 72 65 64 20 61 .** is cleared a
1e50: 67 61 69 6e 20 77 68 65 6e 20 74 68 65 20 70 61 gain when the pa
1e60: 67 65 20 63 6f 6e 74 65 6e 74 20 69 73 20 77 72 ge content is wr
1e70: 69 74 74 65 6e 20 62 61 63 6b 20 74 6f 20 74 68 itten back to th
1e80: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 64 61 e original.** da
1e90: 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 0a tabase file..**.
1ea0: 2a 2a 20 44 65 74 61 69 6c 73 20 6f 66 20 69 6d ** Details of im
1eb0: 70 6f 72 74 61 6e 74 20 73 74 72 75 63 74 75 72 portant structur
1ec0: 65 20 65 6c 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a e elements:.**.*
1ed0: 2a 20 6e 65 65 64 53 79 6e 63 0a 2a 2a 0a 2a 2a * needSync.**.**
1ee0: 20 20 20 20 20 49 66 20 74 68 69 73 20 69 73 20 If this is
1ef0: 74 72 75 65 2c 20 74 68 69 73 20 6d 65 61 6e 73 true, this means
1f00: 20 74 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 that it is not
1f10: 73 61 66 65 20 74 6f 20 77 72 69 74 65 20 74 68 safe to write th
1f20: 65 20 70 61 67 65 0a 2a 2a 20 20 20 20 20 63 6f e page.** co
1f30: 6e 74 65 6e 74 20 74 6f 20 74 68 65 20 64 61 74 ntent to the dat
1f40: 61 62 61 73 65 20 62 65 63 61 75 73 65 20 74 68 abase because th
1f50: 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 74 65 e original conte
1f60: 6e 74 20 6e 65 65 64 65 64 0a 2a 2a 20 20 20 20 nt needed.**
1f70: 20 66 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 68 61 for rollback ha
1f80: 73 20 6e 6f 74 20 62 79 20 73 79 6e 63 65 64 20 s not by synced
1f90: 74 6f 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c 6c to the main roll
1fa0: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a back journal..**
1fb0: 20 20 20 20 20 54 68 65 20 6f 72 69 67 69 6e 61 The origina
1fc0: 6c 20 63 6f 6e 74 65 6e 74 20 6d 61 79 20 68 61 l content may ha
1fd0: 76 65 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 ve been written
1fe0: 74 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 to the rollback
1ff0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 62 journal.** b
2000: 75 74 20 69 74 20 68 61 73 20 6e 6f 74 20 79 65 ut it has not ye
2010: 74 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 20 20 t been synced.
2020: 53 6f 20 77 65 20 63 61 6e 6e 6f 74 20 77 72 69 So we cannot wri
2030: 74 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 te to the databa
2040: 73 65 0a 2a 2a 20 20 20 20 20 66 69 6c 65 20 62 se.** file b
2050: 65 63 61 75 73 65 20 70 6f 77 65 72 20 66 61 69 ecause power fai
2060: 6c 75 72 65 20 6d 69 67 68 74 20 63 61 75 73 65 lure might cause
2070: 20 74 68 65 20 70 61 67 65 20 69 6e 20 74 68 65 the page in the
2080: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a journal file.**
2090: 20 20 20 20 20 74 6f 20 6e 65 76 65 72 20 72 65 to never re
20a0: 61 63 68 20 74 68 65 20 64 69 73 6b 2e 20 20 49 ach the disk. I
20b0: 74 20 69 73 20 61 73 20 69 66 20 74 68 65 20 77 t is as if the w
20c0: 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 72 rite to the jour
20d0: 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 nal file.**
20e0: 64 6f 65 73 20 6e 6f 74 20 6f 63 63 75 72 20 75 does not occur u
20f0: 6e 74 69 6c 20 74 68 65 20 6a 6f 75 72 6e 61 6c ntil the journal
2100: 20 66 69 6c 65 20 69 73 20 73 79 6e 63 65 64 2e file is synced.
2110: 0a 2a 2a 20 20 20 20 20 0a 2a 2a 20 20 20 20 20 .** .**
2120: 54 68 69 73 20 66 6c 61 67 20 69 73 20 66 61 6c This flag is fal
2130: 73 65 20 69 66 20 74 68 65 20 70 61 67 65 20 63 se if the page c
2140: 6f 6e 74 65 6e 74 20 65 78 61 63 74 6c 79 20 6d ontent exactly m
2150: 61 74 63 68 65 73 20 77 68 61 74 0a 2a 2a 20 20 atches what.**
2160: 20 20 20 63 75 72 72 65 6e 74 6c 79 20 65 78 69 currently exi
2170: 73 74 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 sts in the datab
2180: 61 73 65 20 66 69 6c 65 2e 20 20 54 68 65 20 6e ase file. The n
2190: 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 73 20 eedSync flag is
21a0: 61 6c 73 6f 0a 2a 2a 20 20 20 20 20 66 61 6c 73 also.** fals
21b0: 65 20 69 66 20 74 68 65 20 6f 72 69 67 69 6e 61 e if the origina
21c0: 6c 20 63 6f 6e 74 65 6e 74 20 68 61 73 20 62 65 l content has be
21d0: 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 en written to th
21e0: 65 20 6d 61 69 6e 20 72 6f 6c 6c 62 61 63 6b 0a e main rollback.
21f0: 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 61 ** journal a
2200: 6e 64 20 73 79 6e 63 65 64 2e 20 20 49 66 20 74 nd synced. If t
2210: 68 65 20 70 61 67 65 20 72 65 70 72 65 73 65 6e he page represen
2220: 74 73 20 61 20 6e 65 77 20 70 61 67 65 20 74 68 ts a new page th
2230: 61 74 20 68 61 73 0a 2a 2a 20 20 20 20 20 62 65 at has.** be
2240: 65 6e 20 61 64 64 65 64 20 6f 6e 74 6f 20 74 68 en added onto th
2250: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 64 61 74 e end of the dat
2260: 61 62 61 73 65 20 64 75 72 69 6e 67 20 74 68 65 abase during the
2270: 20 63 75 72 72 65 6e 74 0a 2a 2a 20 20 20 20 20 current.**
2280: 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 transaction, the
2290: 20 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 needSync flag i
22a0: 73 20 74 72 75 65 20 75 6e 74 69 6c 20 74 68 65 s true until the
22b0: 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61 original databa
22c0: 73 65 0a 2a 2a 20 20 20 20 20 73 69 7a 65 20 69 se.** size i
22d0: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 n the journal he
22e0: 61 64 65 72 20 68 61 73 20 62 65 65 6e 20 73 79 ader has been sy
22f0: 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a 2a nced to disk..**
2300: 0a 2a 2a 20 69 6e 4a 6f 75 72 6e 61 6c 0a 2a 2a .** inJournal.**
2310: 0a 2a 2a 20 20 20 20 20 54 68 69 73 20 69 73 20 .** This is
2320: 74 72 75 65 20 69 66 20 74 68 65 20 6f 72 69 67 true if the orig
2330: 69 6e 61 6c 20 70 61 67 65 20 68 61 73 20 62 65 inal page has be
2340: 65 6e 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 en written into
2350: 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 20 20 20 20 the main.**
2360: 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
2370: 2e 20 20 54 68 69 73 20 69 73 20 61 6c 77 61 79 . This is alway
2380: 73 20 66 61 6c 73 65 20 66 6f 72 20 6e 65 77 20 s false for new
2390: 70 61 67 65 73 20 61 64 64 65 64 20 74 6f 0a 2a pages added to.*
23a0: 2a 20 20 20 20 20 74 68 65 20 65 6e 64 20 6f 66 * the end of
23b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
23c0: 6c 65 20 64 75 72 69 6e 67 20 74 68 65 20 63 75 le during the cu
23d0: 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f rrent transactio
23e0: 6e 2e 0a 2a 2a 20 20 20 20 20 41 6e 64 20 74 68 n..** And th
23f0: 69 73 20 66 6c 61 67 20 73 61 79 73 20 6e 6f 74 is flag says not
2400: 68 69 6e 67 20 61 62 6f 75 74 20 77 68 65 74 68 hing about wheth
2410: 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 6a 6f er or not the jo
2420: 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 68 61 73 urnal.** has
2430: 20 62 65 65 6e 20 73 79 6e 63 65 64 20 74 6f 20 been synced to
2440: 64 69 73 6b 2e 20 20 46 6f 72 20 70 61 67 65 73 disk. For pages
2450: 20 74 68 61 74 20 61 72 65 20 69 6e 20 74 68 65 that are in the
2460: 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 20 20 20 original.**
2470: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
2480: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 the following ex
2490: 70 72 65 73 73 69 6f 6e 20 73 68 6f 75 6c 64 20 pression should
24a0: 61 6c 77 61 79 73 20 62 65 20 74 72 75 65 3a 0a always be true:.
24b0: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 69 6e 4a 6f **.** inJo
24c0: 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 65 33 42 urnal = sqlite3B
24d0: 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 72 itvecTest(pPager
24e0: 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 ->pInJournal, pg
24f0: 6e 6f 29 0a 2a 2a 0a 2a 2a 20 20 20 20 20 54 68 no).**.** Th
2500: 65 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 e pPager->pInJou
2510: 72 6e 61 6c 20 6f 62 6a 65 63 74 20 69 73 20 6f rnal object is o
2520: 6e 6c 79 20 76 61 6c 69 64 20 66 6f 72 20 74 68 nly valid for th
2530: 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 20 20 e original.**
2540: 20 20 70 61 67 65 73 20 6f 66 20 74 68 65 20 64 pages of the d
2550: 61 74 61 62 61 73 65 2c 20 6e 6f 74 20 6e 65 77 atabase, not new
2560: 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20 pages that are
2570: 61 64 64 65 64 20 74 6f 20 74 68 65 20 65 6e 64 added to the end
2580: 0a 2a 2a 20 20 20 20 20 6f 66 20 74 68 65 20 64 .** of the d
2590: 61 74 61 62 61 73 65 2c 20 73 6f 20 6f 62 76 69 atabase, so obvi
25a0: 6f 75 73 6c 79 20 74 68 65 20 61 62 6f 76 65 20 ously the above
25b0: 65 78 70 72 65 73 73 69 6f 6e 20 63 61 6e 6e 6f expression canno
25c0: 74 20 62 65 0a 2a 2a 20 20 20 20 20 76 61 6c 69 t be.** vali
25d0: 64 20 66 6f 72 20 6e 65 77 20 70 61 67 65 73 2e d for new pages.
25e0: 20 20 46 6f 72 20 6e 65 77 20 70 61 67 65 73 20 For new pages
25f0: 69 6e 4a 6f 75 72 6e 61 6c 20 69 73 20 61 6c 77 inJournal is alw
2600: 61 79 73 20 30 2e 0a 2a 2a 0a 2a 2a 20 64 69 72 ays 0..**.** dir
2610: 74 79 0a 2a 2a 0a 2a 2a 20 20 20 20 20 57 68 65 ty.**.** Whe
2620: 6e 20 74 72 75 65 2c 20 74 68 69 73 20 6d 65 61 n true, this mea
2630: 6e 73 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74 ns that the cont
2640: 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 ent of the page
2650: 68 61 73 20 62 65 65 6e 0a 2a 2a 20 20 20 20 20 has been.**
2660: 6d 6f 64 69 66 69 65 64 20 61 6e 64 20 6e 65 65 modified and nee
2670: 64 73 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e ds to be written
2680: 20 62 61 63 6b 20 74 6f 20 74 68 65 20 64 61 74 back to the dat
2690: 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 abase file..**
26a0: 20 20 20 49 66 20 66 61 6c 73 65 2c 20 69 74 20 If false, it
26b0: 6d 65 61 6e 73 20 74 68 61 74 20 65 69 74 68 65 means that eithe
26c0: 72 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 r the content of
26d0: 20 74 68 65 20 70 61 67 65 20 69 73 0a 2a 2a 20 the page is.**
26e0: 20 20 20 20 75 6e 63 68 61 6e 67 65 64 20 6f 72 unchanged or
26f0: 20 65 6c 73 65 20 74 68 65 20 63 6f 6e 74 65 6e else the conten
2700: 74 20 69 73 20 75 6e 69 6d 70 6f 72 74 61 6e 74 t is unimportant
2710: 20 61 6e 64 20 77 65 20 64 6f 20 6e 6f 74 0a 2a and we do not.*
2720: 2a 20 20 20 20 20 63 61 72 65 20 77 68 65 74 68 * care wheth
2730: 65 72 20 6f 72 20 6e 6f 74 20 69 74 20 69 73 20 er or not it is
2740: 70 72 65 73 65 72 76 65 64 2e 0a 2a 2a 0a 2a 2a preserved..**.**
2750: 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 0a alwaysRollback.
2760: 2a 2a 0a 2a 2a 20 20 20 20 20 54 68 69 73 20 6d **.** This m
2770: 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 73 71 eans that the sq
2780: 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52 6f lite3PagerDontRo
2790: 6c 6c 62 61 63 6b 28 29 20 41 50 49 20 73 68 6f llback() API sho
27a0: 75 6c 64 20 62 65 0a 2a 2a 20 20 20 20 20 69 67 uld be.** ig
27b0: 6e 6f 72 65 64 20 66 6f 72 20 74 68 69 73 20 70 nored for this p
27c0: 61 67 65 2e 20 20 54 68 65 20 44 6f 6e 74 52 6f age. The DontRo
27d0: 6c 6c 62 61 63 6b 28 29 20 41 50 49 20 61 74 74 llback() API att
27e0: 65 6d 70 74 73 20 74 6f 20 73 61 79 0a 2a 2a 20 empts to say.**
27f0: 20 20 20 20 74 68 61 74 20 74 68 65 20 63 6f 6e that the con
2800: 74 65 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 tent of the page
2810: 20 6f 6e 20 64 69 73 6b 20 69 73 20 75 6e 69 6d on disk is unim
2820: 70 6f 72 74 61 6e 74 20 28 69 74 20 69 73 20 61 portant (it is a
2830: 6e 0a 2a 2a 20 20 20 20 20 75 6e 75 73 65 64 20 n.** unused
2840: 70 61 67 65 20 6f 6e 20 74 68 65 20 66 72 65 65 page on the free
2850: 6c 69 73 74 29 20 73 6f 20 74 68 61 74 20 69 74 list) so that it
2860: 20 69 73 20 75 6e 6e 65 63 65 73 73 61 72 79 20 is unnecessary
2870: 74 6f 20 0a 2a 2a 20 20 20 20 20 72 6f 6c 6c 62 to .** rollb
2880: 61 63 6b 20 63 68 61 6e 67 65 73 20 74 6f 20 74 ack changes to t
2890: 68 69 73 20 70 61 67 65 20 62 65 63 61 75 73 65 his page because
28a0: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 the content of
28b0: 74 68 65 20 70 61 67 65 0a 2a 2a 20 20 20 20 20 the page.**
28c0: 63 61 6e 20 63 68 61 6e 67 65 20 77 69 74 68 6f can change witho
28d0: 75 74 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 ut changing the
28e0: 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 65 20 64 meaning of the d
28f0: 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 0a 2a atabase. This.*
2900: 2a 20 20 20 20 20 66 6c 61 67 20 6f 76 65 72 72 * flag overr
2910: 69 64 65 73 20 61 6e 79 20 44 6f 6e 74 52 6f 6c ides any DontRol
2920: 6c 62 61 63 6b 28 29 20 61 74 74 65 6d 70 74 2e lback() attempt.
2930: 20 20 54 68 69 73 20 66 6c 61 67 20 69 73 20 73 This flag is s
2940: 65 74 0a 2a 2a 20 20 20 20 20 77 68 65 6e 20 61 et.** when a
2950: 20 70 61 67 65 20 74 68 61 74 20 6f 72 69 67 69 page that origi
2960: 6e 61 6c 6c 79 20 63 6f 6e 74 61 69 6e 65 64 20 nally contained
2970: 76 61 6c 69 64 20 64 61 74 61 20 69 73 20 61 64 valid data is ad
2980: 64 65 64 20 74 6f 0a 2a 2a 20 20 20 20 20 74 68 ded to.** th
2990: 65 20 66 72 65 65 6c 69 73 74 2e 20 20 4c 61 74 e freelist. Lat
29a0: 65 72 20 69 6e 20 74 68 65 20 73 61 6d 65 20 74 er in the same t
29b0: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 69 73 ransaction, this
29c0: 20 70 61 67 65 20 6d 69 67 68 74 0a 2a 2a 20 20 page might.**
29d0: 20 20 20 62 65 20 70 75 6c 6c 65 64 20 66 72 6f be pulled fro
29e0: 6d 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 61 m the freelist a
29f0: 6e 64 20 72 65 75 73 65 64 20 66 6f 72 20 73 6f nd reused for so
2a00: 6d 65 74 68 69 6e 67 20 64 69 66 66 65 72 65 6e mething differen
2a10: 74 0a 2a 2a 20 20 20 20 20 61 6e 64 20 61 74 20 t.** and at
2a20: 74 68 61 74 20 70 6f 69 6e 74 20 74 68 65 20 44 that point the D
2a30: 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 41 50 ontRollback() AP
2a40: 49 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c 65 64 I will be called
2a50: 20 62 65 63 61 75 73 65 0a 2a 2a 20 20 20 20 20 because.**
2a60: 70 61 67 65 73 20 74 61 6b 65 6e 20 66 72 6f 6d pages taken from
2a70: 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 64 6f the freelist do
2a80: 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 not need to be
2a90: 70 72 6f 74 65 63 74 65 64 20 62 79 0a 2a 2a 20 protected by.**
2aa0: 20 20 20 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b the rollback
2ab0: 20 6a 6f 75 72 6e 61 6c 2e 20 20 42 75 74 20 74 journal. But t
2ac0: 68 69 73 20 66 6c 61 67 20 73 61 79 73 20 74 68 his flag says th
2ad0: 61 74 20 74 68 65 20 70 61 67 65 20 77 61 73 0a at the page was.
2ae0: 2a 2a 20 20 20 20 20 6e 6f 74 20 6f 72 69 67 69 ** not origi
2af0: 6e 61 6c 6c 79 20 70 61 72 74 20 6f 66 20 74 68 nally part of th
2b00: 65 20 66 72 65 65 6c 69 73 74 20 73 6f 20 74 68 e freelist so th
2b10: 61 74 20 69 74 20 73 74 69 6c 6c 20 6e 65 65 64 at it still need
2b20: 73 20 74 6f 0a 2a 2a 20 20 20 20 20 62 65 20 72 s to.** be r
2b30: 6f 6c 6c 65 64 20 62 61 63 6b 20 69 6e 20 73 70 olled back in sp
2b40: 69 74 65 20 6f 66 20 61 6e 79 20 73 75 62 73 65 ite of any subse
2b50: 71 75 65 6e 74 20 44 6f 6e 74 52 6f 6c 6c 62 61 quent DontRollba
2b60: 63 6b 28 29 20 63 61 6c 6c 73 2e 0a 2a 2a 0a 2a ck() calls..**.*
2b70: 2a 20 6e 65 65 64 52 65 61 64 20 0a 2a 2a 0a 2a * needRead .**.*
2b80: 2a 20 20 20 20 20 54 68 69 73 20 66 6c 61 67 20 * This flag
2b90: 6d 65 61 6e 73 20 28 77 68 65 6e 20 74 72 75 65 means (when true
2ba0: 29 20 74 68 61 74 20 74 68 65 20 63 6f 6e 74 65 ) that the conte
2bb0: 6e 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 68 nt of the page h
2bc0: 61 73 0a 2a 2a 20 20 20 20 20 6e 6f 74 20 79 65 as.** not ye
2bd0: 74 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 66 72 t been loaded fr
2be0: 6f 6d 20 64 69 73 6b 2e 20 20 54 68 65 20 69 6e om disk. The in
2bf0: 2d 6d 65 6d 6f 72 79 20 63 6f 6e 74 65 6e 74 20 -memory content
2c00: 69 73 20 6a 75 73 74 0a 2a 2a 20 20 20 20 20 67 is just.** g
2c10: 61 72 62 61 67 65 2e 20 20 28 41 63 74 75 61 6c arbage. (Actual
2c20: 6c 79 2c 20 77 65 20 7a 65 72 6f 20 74 68 65 20 ly, we zero the
2c30: 63 6f 6e 74 65 6e 74 2c 20 62 75 74 20 79 6f 75 content, but you
2c40: 20 73 68 6f 75 6c 64 20 6e 6f 74 0a 2a 2a 20 20 should not.**
2c50: 20 20 20 6d 61 6b 65 20 61 6e 79 20 61 73 73 75 make any assu
2c60: 6d 70 74 69 6f 6e 73 20 61 62 6f 75 74 20 74 68 mptions about th
2c70: 65 20 63 6f 6e 74 65 6e 74 20 6e 65 76 65 72 74 e content nevert
2c80: 68 65 6c 65 73 73 2e 29 20 20 49 66 20 74 68 65 heless.) If the
2c90: 0a 2a 2a 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 .** content
2ca0: 69 73 20 6e 65 65 64 65 64 20 69 6e 20 74 68 65 is needed in the
2cb0: 20 66 75 74 75 72 65 2c 20 69 74 20 73 68 6f 75 future, it shou
2cc0: 6c 64 20 62 65 20 72 65 61 64 20 66 72 6f 6d 20 ld be read from
2cd0: 74 68 65 0a 2a 2a 20 20 20 20 20 6f 72 69 67 69 the.** origi
2ce0: 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c nal database fil
2cf0: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 67 48 e..*/.struct PgH
2d00: 64 72 20 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 dr {. Pager *pP
2d10: 61 67 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 ager;
2d20: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 /* The pag
2d30: 65 72 20 74 6f 20 77 68 69 63 68 20 74 68 69 73 er to which this
2d40: 20 70 61 67 65 20 62 65 6c 6f 6e 67 73 20 2a 2f page belongs */
2d50: 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20 . Pgno pgno;
2d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d70: 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75 /* The page nu
2d80: 6d 62 65 72 20 66 6f 72 20 74 68 69 73 20 70 61 mber for this pa
2d90: 67 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 ge */. PgHdr *p
2da0: 4e 65 78 74 48 61 73 68 2c 20 2a 70 50 72 65 76 NextHash, *pPrev
2db0: 48 61 73 68 3b 20 20 2f 2a 20 48 61 73 68 20 63 Hash; /* Hash c
2dc0: 6f 6c 6c 69 73 69 6f 6e 20 63 68 61 69 6e 20 66 ollision chain f
2dd0: 6f 72 20 50 67 48 64 72 2e 70 67 6e 6f 20 2a 2f or PgHdr.pgno */
2de0: 0a 20 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20 . PagerLruLink
2df0: 66 72 65 65 3b 20 20 20 20 20 20 20 20 20 20 20 free;
2e00: 20 20 2f 2a 20 4e 65 78 74 20 61 6e 64 20 70 72 /* Next and pr
2e10: 65 76 69 6f 75 73 20 66 72 65 65 20 70 61 67 65 evious free page
2e20: 73 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 4e s */. PgHdr *pN
2e30: 65 78 74 41 6c 6c 3b 20 20 20 20 20 20 20 20 20 extAll;
2e40: 20 20 20 20 20 20 2f 2a 20 41 20 6c 69 73 74 20 /* A list
2e50: 6f 66 20 61 6c 6c 20 70 61 67 65 73 20 2a 2f 0a of all pages */.
2e60: 20 20 75 38 20 69 6e 4a 6f 75 72 6e 61 6c 3b 20 u8 inJournal;
2e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2e80: 20 2f 2a 20 54 52 55 45 20 69 66 20 68 61 73 20 /* TRUE if has
2e90: 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 been written to
2ea0: 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 journal */. u8
2eb0: 64 69 72 74 79 3b 20 20 20 20 20 20 20 20 20 20 dirty;
2ec0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
2ed0: 52 55 45 20 69 66 20 77 65 20 6e 65 65 64 20 74 RUE if we need t
2ee0: 6f 20 77 72 69 74 65 20 62 61 63 6b 20 63 68 61 o write back cha
2ef0: 6e 67 65 73 20 2a 2f 0a 20 20 75 38 20 6e 65 65 nges */. u8 nee
2f00: 64 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20 dSync;
2f10: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 79 6e 63 /* Sync
2f20: 20 6a 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 journal before
2f30: 77 72 69 74 69 6e 67 20 74 68 69 73 20 70 61 67 writing this pag
2f40: 65 20 2a 2f 0a 20 20 75 38 20 61 6c 77 61 79 73 e */. u8 always
2f50: 52 6f 6c 6c 62 61 63 6b 3b 20 20 20 20 20 20 20 Rollback;
2f60: 20 20 20 20 20 20 2f 2a 20 44 69 73 61 62 6c 65 /* Disable
2f70: 20 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 DontRollback()
2f80: 66 6f 72 20 74 68 69 73 20 70 61 67 65 20 2a 2f for this page */
2f90: 0a 20 20 75 38 20 6e 65 65 64 52 65 61 64 3b 20 . u8 needRead;
2fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2fb0: 20 20 2f 2a 20 52 65 61 64 20 63 6f 6e 74 65 6e /* Read conten
2fc0: 74 20 69 66 20 50 61 67 65 72 57 72 69 74 65 28 t if PagerWrite(
2fd0: 29 20 69 73 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 ) is called */.
2fe0: 20 73 68 6f 72 74 20 69 6e 74 20 6e 52 65 66 3b short int nRef;
2ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3000: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65 /* Number of use
3010: 72 73 20 6f 66 20 74 68 69 73 20 70 61 67 65 20 rs of this page
3020: 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 44 69 72 */. PgHdr *pDir
3030: 74 79 2c 20 2a 70 50 72 65 76 44 69 72 74 79 3b ty, *pPrevDirty;
3040: 20 20 20 20 2f 2a 20 44 69 72 74 79 20 70 61 67 /* Dirty pag
3050: 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c es */.#ifdef SQL
3060: 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 ITE_ENABLE_MEMOR
3070: 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 50 Y_MANAGEMENT. P
3080: 61 67 65 72 4c 72 75 4c 69 6e 6b 20 67 66 72 65 agerLruLink gfre
3090: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
30a0: 20 47 6c 6f 62 61 6c 20 6c 69 73 74 20 6f 66 20 Global list of
30b0: 6e 52 65 66 3d 3d 30 20 70 61 67 65 73 20 2a 2f nRef==0 pages */
30c0: 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 .#endif.#ifdef S
30d0: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
30e0: 53 0a 20 20 75 33 32 20 70 61 67 65 48 61 73 68 S. u32 pageHash
30f0: 3b 0a 23 65 6e 64 69 66 0a 20 20 76 6f 69 64 20 ;.#endif. void
3100: 2a 70 44 61 74 61 3b 20 20 20 20 20 20 20 20 20 *pData;
3110: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
3120: 65 20 64 61 74 61 20 2a 2f 0a 20 20 2f 2a 20 50 e data */. /* P
3130: 61 67 65 72 2e 6e 45 78 74 72 61 20 62 79 74 65 ager.nExtra byte
3140: 73 20 6f 66 20 6c 6f 63 61 6c 20 64 61 74 61 20 s of local data
3150: 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 69 73 appended to this
3160: 20 68 65 61 64 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f header */.};../
3170: 2a 0a 2a 2a 20 46 6f 72 20 61 6e 20 69 6e 2d 6d *.** For an in-m
3180: 65 6d 6f 72 79 20 6f 6e 6c 79 20 64 61 74 61 62 emory only datab
3190: 61 73 65 2c 20 73 6f 6d 65 20 65 78 74 72 61 20 ase, some extra
31a0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 72 information is r
31b0: 65 63 6f 72 64 65 64 20 61 62 6f 75 74 0a 2a 2a ecorded about.**
31c0: 20 65 61 63 68 20 70 61 67 65 20 73 6f 20 74 68 each page so th
31d0: 61 74 20 63 68 61 6e 67 65 73 20 63 61 6e 20 62 at changes can b
31e0: 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 e rolled back.
31f0: 28 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 61 (Journal files a
3200: 72 65 20 6e 6f 74 0a 2a 2a 20 75 73 65 64 20 66 re not.** used f
3210: 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 or in-memory dat
3220: 61 62 61 73 65 73 2e 29 20 20 54 68 65 20 66 6f abases.) The fo
3230: 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 llowing informat
3240: 69 6f 6e 20 69 73 20 61 64 64 65 64 20 74 6f 0a ion is added to.
3250: 2a 2a 20 74 68 65 20 65 6e 64 20 6f 66 20 65 76 ** the end of ev
3260: 65 72 79 20 45 58 54 52 41 20 62 6c 6f 63 6b 20 ery EXTRA block
3270: 66 6f 72 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 for in-memory da
3280: 74 61 62 61 73 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 tabases..**.** T
3290: 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 his information
32a0: 63 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20 could have been
32b0: 61 64 64 65 64 20 64 69 72 65 63 74 6c 79 20 74 added directly t
32c0: 6f 20 74 68 65 20 50 67 48 64 72 20 73 74 72 75 o the PgHdr stru
32d0: 63 74 75 72 65 2e 0a 2a 2a 20 42 75 74 20 74 68 cture..** But th
32e0: 65 6e 20 69 74 20 77 6f 75 6c 64 20 74 61 6b 65 en it would take
32f0: 20 75 70 20 61 6e 20 65 78 74 72 61 20 38 20 62 up an extra 8 b
3300: 79 74 65 73 20 6f 66 20 73 74 6f 72 61 67 65 20 ytes of storage
3310: 6f 6e 20 65 76 65 72 79 20 50 67 48 64 72 0a 2a on every PgHdr.*
3320: 2a 20 65 76 65 6e 20 66 6f 72 20 64 69 73 6b 2d * even for disk-
3330: 62 61 73 65 64 20 64 61 74 61 62 61 73 65 73 2e based databases.
3340: 20 20 53 70 6c 69 74 74 69 6e 67 20 69 74 20 6f Splitting it o
3350: 75 74 20 73 61 76 65 73 20 38 20 62 79 74 65 73 ut saves 8 bytes
3360: 2e 20 20 54 68 69 73 0a 2a 2a 20 69 73 20 6f 6e . This.** is on
3370: 6c 79 20 61 20 73 61 76 69 6e 67 73 20 6f 66 20 ly a savings of
3380: 30 2e 38 25 20 62 75 74 20 74 68 6f 73 65 20 70 0.8% but those p
3390: 65 72 63 65 6e 74 61 67 65 73 20 61 64 64 20 75 ercentages add u
33a0: 70 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 p..*/.typedef st
33b0: 72 75 63 74 20 50 67 48 69 73 74 6f 72 79 20 50 ruct PgHistory P
33c0: 67 48 69 73 74 6f 72 79 3b 0a 73 74 72 75 63 74 gHistory;.struct
33d0: 20 50 67 48 69 73 74 6f 72 79 20 7b 0a 20 20 75 PgHistory {. u
33e0: 38 20 2a 70 4f 72 69 67 3b 20 20 20 20 20 2f 2a 8 *pOrig; /*
33f0: 20 4f 72 69 67 69 6e 61 6c 20 70 61 67 65 20 74 Original page t
3400: 65 78 74 2e 20 20 52 65 73 74 6f 72 65 20 74 6f ext. Restore to
3410: 20 74 68 69 73 20 6f 6e 20 61 20 66 75 6c 6c 20 this on a full
3420: 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 75 38 rollback */. u8
3430: 20 2a 70 53 74 6d 74 3b 20 20 20 20 20 2f 2a 20 *pStmt; /*
3440: 54 65 78 74 20 61 73 20 69 74 20 77 61 73 20 61 Text as it was a
3450: 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 t the beginning
3460: 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 of the current s
3470: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 50 67 tatement */. Pg
3480: 48 64 72 20 2a 70 4e 65 78 74 53 74 6d 74 2c 20 Hdr *pNextStmt,
3490: 2a 70 50 72 65 76 53 74 6d 74 3b 20 20 2f 2a 20 *pPrevStmt; /*
34a0: 4c 69 73 74 20 6f 66 20 70 61 67 65 73 20 69 6e List of pages in
34b0: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a the statement j
34c0: 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 69 ournal */. u8 i
34d0: 6e 53 74 6d 74 3b 20 20 20 20 20 20 20 20 20 20 nStmt;
34e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 52 /* TR
34f0: 55 45 20 69 66 20 69 6e 20 74 68 65 20 73 74 61 UE if in the sta
3500: 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75 72 6e 61 tement subjourna
3510: 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 l */.};../*.** A
3520: 20 6d 61 63 72 6f 20 75 73 65 64 20 66 6f 72 20 macro used for
3530: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 64 invoking the cod
3540: 65 63 20 69 66 20 74 68 65 72 65 20 69 73 20 6f ec if there is o
3550: 6e 65 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c ne.*/.#ifdef SQL
3560: 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 23 20 ITE_HAS_CODEC.#
3570: 64 65 66 69 6e 65 20 43 4f 44 45 43 31 28 50 2c define CODEC1(P,
3580: 44 2c 4e 2c 58 29 20 69 66 28 20 50 2d 3e 78 43 D,N,X) if( P->xC
3590: 6f 64 65 63 21 3d 30 20 29 7b 20 50 2d 3e 78 43 odec!=0 ){ P->xC
35a0: 6f 64 65 63 28 50 2d 3e 70 43 6f 64 65 63 41 72 odec(P->pCodecAr
35b0: 67 2c 44 2c 4e 2c 58 29 3b 20 7d 0a 23 20 64 65 g,D,N,X); }.# de
35c0: 66 69 6e 65 20 43 4f 44 45 43 32 28 50 2c 44 2c fine CODEC2(P,D,
35d0: 4e 2c 58 29 20 28 28 63 68 61 72 2a 29 28 50 2d N,X) ((char*)(P-
35e0: 3e 78 43 6f 64 65 63 21 3d 30 3f 50 2d 3e 78 43 >xCodec!=0?P->xC
35f0: 6f 64 65 63 28 50 2d 3e 70 43 6f 64 65 63 41 72 odec(P->pCodecAr
3600: 67 2c 44 2c 4e 2c 58 29 3a 44 29 29 0a 23 65 6c g,D,N,X):D)).#el
3610: 73 65 0a 23 20 64 65 66 69 6e 65 20 43 4f 44 45 se.# define CODE
3620: 43 31 28 50 2c 44 2c 4e 2c 58 29 20 2f 2a 20 4e C1(P,D,N,X) /* N
3630: 4f 2d 4f 50 20 2a 2f 0a 23 20 64 65 66 69 6e 65 O-OP */.# define
3640: 20 43 4f 44 45 43 32 28 50 2c 44 2c 4e 2c 58 29 CODEC2(P,D,N,X)
3650: 20 28 28 63 68 61 72 2a 29 44 29 0a 23 65 6e 64 ((char*)D).#end
3660: 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 if../*.** Conver
3670: 74 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 t a pointer to a
3680: 20 50 67 48 64 72 20 69 6e 74 6f 20 61 20 70 6f PgHdr into a po
3690: 69 6e 74 65 72 20 74 6f 20 69 74 73 20 64 61 74 inter to its dat
36a0: 61 0a 2a 2a 20 61 6e 64 20 62 61 63 6b 20 61 67 a.** and back ag
36b0: 61 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ain..*/.#define
36c0: 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 50 29 PGHDR_TO_DATA(P)
36d0: 20 20 20 20 28 28 50 29 2d 3e 70 44 61 74 61 29 ((P)->pData)
36e0: 0a 23 64 65 66 69 6e 65 20 50 47 48 44 52 5f 54 .#define PGHDR_T
36f0: 4f 5f 45 58 54 52 41 28 47 2c 50 29 20 28 28 76 O_EXTRA(G,P) ((v
3700: 6f 69 64 2a 29 26 28 28 47 29 5b 31 5d 29 29 0a oid*)&((G)[1])).
3710: 23 64 65 66 69 6e 65 20 50 47 48 44 52 5f 54 4f #define PGHDR_TO
3720: 5f 48 49 53 54 28 50 2c 50 47 52 29 20 20 5c 0a _HIST(P,PGR) \.
3730: 20 20 20 20 20 20 20 20 20 20 20 20 28 28 50 67 ((Pg
3740: 48 69 73 74 6f 72 79 2a 29 26 28 28 63 68 61 72 History*)&((char
3750: 2a 29 28 26 28 50 29 5b 31 5d 29 29 5b 28 50 47 *)(&(P)[1]))[(PG
3760: 52 29 2d 3e 6e 45 78 74 72 61 5d 29 0a 0a 2f 2a R)->nExtra])../*
3770: 0a 2a 2a 20 41 20 6f 70 65 6e 20 70 61 67 65 20 .** A open page
3780: 63 61 63 68 65 20 69 73 20 61 6e 20 69 6e 73 74 cache is an inst
3790: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
37a0: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e owing structure.
37b0: 0a 2a 2a 0a 2a 2a 20 50 61 67 65 72 2e 65 72 72 .**.** Pager.err
37c0: 43 6f 64 65 20 6d 61 79 20 62 65 20 73 65 74 20 Code may be set
37d0: 74 6f 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 2c to SQLITE_IOERR,
37e0: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 2c SQLITE_CORRUPT,
37f0: 20 6f 72 0a 2a 2a 20 6f 72 20 53 51 4c 49 54 45 or.** or SQLITE
3800: 5f 46 55 4c 4c 2e 20 4f 6e 63 65 20 6f 6e 65 20 _FULL. Once one
3810: 6f 66 20 74 68 65 20 66 69 72 73 74 20 74 68 72 of the first thr
3820: 65 65 20 65 72 72 6f 72 73 20 6f 63 63 75 72 73 ee errors occurs
3830: 2c 20 69 74 20 70 65 72 73 69 73 74 73 0a 2a 2a , it persists.**
3840: 20 61 6e 64 20 69 73 20 72 65 74 75 72 6e 65 64 and is returned
3850: 20 61 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f as the result o
3860: 66 20 65 76 65 72 79 20 6d 61 6a 6f 72 20 70 61 f every major pa
3870: 67 65 72 20 41 50 49 20 63 61 6c 6c 2e 20 20 54 ger API call. T
3880: 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4c he.** SQLITE_FUL
3890: 4c 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69 73 L return code is
38a0: 20 73 6c 69 67 68 74 6c 79 20 64 69 66 66 65 72 slightly differ
38b0: 65 6e 74 2e 20 49 74 20 70 65 72 73 69 73 74 73 ent. It persists
38c0: 20 6f 6e 6c 79 20 75 6e 74 69 6c 20 74 68 65 0a only until the.
38d0: 2a 2a 20 6e 65 78 74 20 73 75 63 63 65 73 73 66 ** next successf
38e0: 75 6c 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 70 ul rollback is p
38f0: 65 72 66 6f 72 6d 65 64 20 6f 6e 20 74 68 65 20 erformed on the
3900: 70 61 67 65 72 20 63 61 63 68 65 2e 20 41 6c 73 pager cache. Als
3910: 6f 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4c o,.** SQLITE_FUL
3920: 4c 20 64 6f 65 73 20 6e 6f 74 20 61 66 66 65 63 L does not affec
3930: 74 20 74 68 65 20 73 71 6c 69 74 65 33 50 61 67 t the sqlite3Pag
3940: 65 72 47 65 74 28 29 20 61 6e 64 20 73 71 6c 69 erGet() and sqli
3950: 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29 te3PagerLookup()
3960: 0a 2a 2a 20 41 50 49 73 2c 20 74 68 65 79 20 6d .** APIs, they m
3970: 61 79 20 73 74 69 6c 6c 20 62 65 20 75 73 65 64 ay still be used
3980: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 2e 0a 2a successfully..*
3990: 2f 0a 73 74 72 75 63 74 20 50 61 67 65 72 20 7b /.struct Pager {
39a0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
39b0: 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 20 2f pVfs; /
39c0: 2a 20 4f 53 20 66 75 6e 63 74 69 6f 6e 73 20 74 * OS functions t
39d0: 6f 20 75 73 65 20 66 6f 72 20 49 4f 20 2a 2f 0a o use for IO */.
39e0: 20 20 75 38 20 6a 6f 75 72 6e 61 6c 4f 70 65 6e u8 journalOpen
39f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
3a00: 20 54 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 6c True if journal
3a10: 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 file descriptor
3a20: 73 20 69 73 20 76 61 6c 69 64 20 2a 2f 0a 20 20 s is valid */.
3a30: 75 38 20 6a 6f 75 72 6e 61 6c 53 74 61 72 74 65 u8 journalStarte
3a40: 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 d; /* T
3a50: 72 75 65 20 69 66 20 68 65 61 64 65 72 20 6f 66 rue if header of
3a60: 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e 63 journal is sync
3a70: 65 64 20 2a 2f 0a 20 20 75 38 20 75 73 65 4a 6f ed */. u8 useJo
3a80: 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20 urnal;
3a90: 20 20 20 20 2f 2a 20 55 73 65 20 61 20 72 6f 6c /* Use a rol
3aa0: 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 6f 6e lback journal on
3ab0: 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 this file */.
3ac0: 75 38 20 6e 6f 52 65 61 64 6c 6f 63 6b 3b 20 20 u8 noReadlock;
3ad0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
3ae0: 6f 20 6e 6f 74 20 62 6f 74 68 65 72 20 74 6f 20 o not bother to
3af0: 6f 62 74 61 69 6e 20 72 65 61 64 6c 6f 63 6b 73 obtain readlocks
3b00: 20 2a 2f 0a 20 20 75 38 20 73 74 6d 74 4f 70 65 */. u8 stmtOpe
3b10: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n;
3b20: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 /* True if the
3b30: 20 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f statement subjo
3b40: 75 72 6e 61 6c 20 69 73 20 6f 70 65 6e 20 2a 2f urnal is open */
3b50: 0a 20 20 75 38 20 73 74 6d 74 49 6e 55 73 65 3b . u8 stmtInUse;
3b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
3b70: 2a 20 54 72 75 65 20 77 65 20 61 72 65 20 69 6e * True we are in
3b80: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 73 75 62 a statement sub
3b90: 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 transaction */.
3ba0: 20 75 38 20 73 74 6d 74 41 75 74 6f 6f 70 65 6e u8 stmtAutoopen
3bb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
3bc0: 4f 70 65 6e 20 73 74 6d 74 20 6a 6f 75 72 6e 61 Open stmt journa
3bd0: 6c 20 77 68 65 6e 20 6d 61 69 6e 20 6a 6f 75 72 l when main jour
3be0: 6e 61 6c 20 69 73 20 6f 70 65 6e 65 64 2a 2f 0a nal is opened*/.
3bf0: 20 20 75 38 20 6e 6f 53 79 6e 63 3b 20 20 20 20 u8 noSync;
3c00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
3c10: 20 44 6f 20 6e 6f 74 20 73 79 6e 63 20 74 68 65 Do not sync the
3c20: 20 6a 6f 75 72 6e 61 6c 20 69 66 20 74 72 75 65 journal if true
3c30: 20 2a 2f 0a 20 20 75 38 20 66 75 6c 6c 53 79 6e */. u8 fullSyn
3c40: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
3c50: 20 20 2f 2a 20 44 6f 20 65 78 74 72 61 20 73 79 /* Do extra sy
3c60: 6e 63 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e ncs of the journ
3c70: 61 6c 20 66 6f 72 20 72 6f 62 75 73 74 6e 65 73 al for robustnes
3c80: 73 20 2a 2f 0a 20 20 75 38 20 73 79 6e 63 5f 66 s */. u8 sync_f
3c90: 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 lags;
3ca0: 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 53 59 4e /* One of SYN
3cb0: 43 5f 4e 4f 52 4d 41 4c 20 6f 72 20 53 59 4e 43 C_NORMAL or SYNC
3cc0: 5f 46 55 4c 4c 20 2a 2f 0a 20 20 75 38 20 73 74 _FULL */. u8 st
3cd0: 61 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ate;
3ce0: 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f /* PAGER_
3cf0: 55 4e 4c 4f 43 4b 2c 20 5f 53 48 41 52 45 44 2c UNLOCK, _SHARED,
3d00: 20 5f 52 45 53 45 52 56 45 44 2c 20 65 74 63 2e _RESERVED, etc.
3d10: 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 46 69 6c */. u8 tempFil
3d20: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
3d30: 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 20 69 /* zFilename i
3d40: 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 66 69 s a temporary fi
3d50: 6c 65 20 2a 2f 0a 20 20 75 38 20 72 65 61 64 4f le */. u8 readO
3d60: 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 nly;
3d70: 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 /* True for
3d80: 61 20 72 65 61 64 2d 6f 6e 6c 79 20 64 61 74 61 a read-only data
3d90: 62 61 73 65 20 2a 2f 0a 20 20 75 38 20 6e 65 65 base */. u8 nee
3da0: 64 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20 dSync;
3db0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
3dc0: 20 61 6e 20 66 73 79 6e 63 28 29 20 69 73 20 6e an fsync() is n
3dd0: 65 65 64 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75 eeded on the jou
3de0: 72 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 64 69 72 rnal */. u8 dir
3df0: 74 79 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 tyCache;
3e00: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
3e10: 20 63 61 63 68 65 64 20 70 61 67 65 73 20 68 61 cached pages ha
3e20: 76 65 20 63 68 61 6e 67 65 64 20 2a 2f 0a 20 20 ve changed */.
3e30: 75 38 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 u8 alwaysRollbac
3e40: 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 k; /* D
3e50: 69 73 61 62 6c 65 20 44 6f 6e 74 52 6f 6c 6c 62 isable DontRollb
3e60: 61 63 6b 28 29 20 66 6f 72 20 61 6c 6c 20 70 61 ack() for all pa
3e70: 67 65 73 20 2a 2f 0a 20 20 75 38 20 6d 65 6d 44 ges */. u8 memD
3e80: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
3e90: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
3ea0: 69 6e 68 69 62 69 74 20 61 6c 6c 20 66 69 6c 65 inhibit all file
3eb0: 20 49 2f 4f 20 2a 2f 0a 20 20 75 38 20 73 65 74 I/O */. u8 set
3ec0: 4d 61 73 74 65 72 3b 20 20 20 20 20 20 20 20 20 Master;
3ed0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
3ee0: 20 61 20 6d 2d 6a 20 6e 61 6d 65 20 68 61 73 20 a m-j name has
3ef0: 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 been written to
3f00: 6a 72 6e 6c 20 2a 2f 0a 20 20 75 38 20 64 6f 4e jrnl */. u8 doN
3f10: 6f 74 53 79 6e 63 3b 20 20 20 20 20 20 20 20 20 otSync;
3f20: 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e /* Boolean
3f30: 2e 20 57 68 69 6c 65 20 74 72 75 65 2c 20 64 6f . While true, do
3f40: 20 6e 6f 74 20 73 70 69 6c 6c 20 74 68 65 20 63 not spill the c
3f50: 61 63 68 65 20 2a 2f 0a 20 20 75 38 20 65 78 63 ache */. u8 exc
3f60: 6c 75 73 69 76 65 4d 6f 64 65 3b 20 20 20 20 20 lusiveMode;
3f70: 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e /* Boolean
3f80: 2e 20 54 72 75 65 20 69 66 20 6c 6f 63 6b 69 6e . True if lockin
3f90: 67 5f 6d 6f 64 65 3d 3d 45 58 43 4c 55 53 49 56 g_mode==EXCLUSIV
3fa0: 45 20 2a 2f 0a 20 20 75 38 20 6a 6f 75 72 6e 61 E */. u8 journa
3fb0: 6c 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 lMode;
3fc0: 20 20 20 2f 2a 20 4f 6e 20 6f 66 20 74 68 65 20 /* On of the
3fd0: 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
3fe0: 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 E_* values */.
3ff0: 75 38 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f u8 changeCountDo
4000: 6e 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ne; /* S
4010: 65 74 20 61 66 74 65 72 20 69 6e 63 72 65 6d 65 et after increme
4020: 6e 74 69 6e 67 20 74 68 65 20 63 68 61 6e 67 65 nting the change
4030: 2d 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 75 33 -counter */. u3
4040: 32 20 76 66 73 46 6c 61 67 73 3b 20 20 20 20 20 2 vfsFlags;
4050: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 /* Fla
4060: 67 73 20 66 6f 72 20 73 71 6c 69 74 65 33 5f 76 gs for sqlite3_v
4070: 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 fs.xOpen() */.
4080: 69 6e 74 20 65 72 72 43 6f 64 65 3b 20 20 20 20 int errCode;
4090: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
40a0: 6e 65 20 6f 66 20 73 65 76 65 72 61 6c 20 6b 69 ne of several ki
40b0: 6e 64 73 20 6f 66 20 65 72 72 6f 72 73 20 2a 2f nds of errors */
40c0: 0a 20 20 69 6e 74 20 64 62 53 69 7a 65 3b 20 20 . int dbSize;
40d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
40e0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
40f0: 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 2a 2f s in the file */
4100: 0a 20 20 69 6e 74 20 6f 72 69 67 44 62 53 69 7a . int origDbSiz
4110: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f e; /
4120: 2a 20 64 62 53 69 7a 65 20 62 65 66 6f 72 65 20 * dbSize before
4130: 74 68 65 20 63 75 72 72 65 6e 74 20 63 68 61 6e the current chan
4140: 67 65 20 2a 2f 0a 20 20 69 6e 74 20 73 74 6d 74 ge */. int stmt
4150: 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 Size;
4160: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 /* Size of d
4170: 61 74 61 62 61 73 65 20 28 69 6e 20 70 61 67 65 atabase (in page
4180: 73 29 20 61 74 20 73 74 6d 74 5f 62 65 67 69 6e s) at stmt_begin
4190: 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 63 () */. int nRec
41a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
41b0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
41c0: 20 70 61 67 65 73 20 77 72 69 74 74 65 6e 20 74 pages written t
41d0: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 2a 2f o the journal */
41e0: 0a 20 20 75 33 32 20 63 6b 73 75 6d 49 6e 69 74 . u32 cksumInit
41f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
4200: 2a 20 51 75 61 73 69 2d 72 61 6e 64 6f 6d 20 76 * Quasi-random v
4210: 61 6c 75 65 20 61 64 64 65 64 20 74 6f 20 65 76 alue added to ev
4220: 65 72 79 20 63 68 65 63 6b 73 75 6d 20 2a 2f 0a ery checksum */.
4230: 20 20 69 6e 74 20 73 74 6d 74 4e 52 65 63 3b 20 int stmtNRec;
4240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
4250: 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 63 6f 72 Number of recor
4260: 64 73 20 69 6e 20 73 74 6d 74 20 73 75 62 6a 6f ds in stmt subjo
4270: 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e urnal */. int n
4280: 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 Extra;
4290: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68 /* Add th
42a0: 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 74 6f is many bytes to
42b0: 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 each in-memory
42c0: 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 70 61 page */. int pa
42d0: 67 65 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 geSize;
42e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
42f0: 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20 70 61 of bytes in a pa
4300: 67 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 ge */. int nPag
4310: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
4320: 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d /* Total num
4330: 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 ber of in-memory
4340: 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20 pages */. int
4350: 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 nRef;
4360: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
4370: 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 r of in-memory p
4380: 61 67 65 73 20 77 69 74 68 20 50 67 48 64 72 2e ages with PgHdr.
4390: 6e 52 65 66 3e 30 20 2a 2f 0a 20 20 69 6e 74 20 nRef>0 */. int
43a0: 6d 78 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 mxPage;
43b0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d /* Maxim
43c0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 um number of pag
43d0: 65 73 20 74 6f 20 68 6f 6c 64 20 69 6e 20 63 61 es to hold in ca
43e0: 63 68 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 6d 78 che */. Pgno mx
43f0: 50 67 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 20 Pgno;
4400: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 /* Maximum
4410: 61 6c 6c 6f 77 65 64 20 73 69 7a 65 20 6f 66 20 allowed size of
4420: 74 68 65 20 64 61 74 61 62 61 73 65 20 2a 2f 0a the database */.
4430: 20 20 42 69 74 76 65 63 20 2a 70 49 6e 4a 6f 75 Bitvec *pInJou
4440: 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a rnal; /*
4450: 20 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63 One bit for eac
4460: 68 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 h page in the da
4470: 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
4480: 20 42 69 74 76 65 63 20 2a 70 49 6e 53 74 6d 74 Bitvec *pInStmt
4490: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
44a0: 4f 6e 65 20 62 69 74 20 66 6f 72 20 65 61 63 68 One bit for each
44b0: 20 70 61 67 65 20 69 6e 20 74 68 65 20 64 61 74 page in the dat
44c0: 61 62 61 73 65 20 2a 2f 0a 20 20 63 68 61 72 20 abase */. char
44d0: 2a 7a 46 69 6c 65 6e 61 6d 65 3b 20 20 20 20 20 *zFilename;
44e0: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
44f0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
4500: 69 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ile */. char *z
4510: 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 Journal;
4520: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
4530: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
4540: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 44 69 72 */. char *zDir
4550: 65 63 74 6f 72 79 3b 20 20 20 20 20 20 20 20 20 ectory;
4560: 20 20 2f 2a 20 44 69 72 65 63 74 6f 72 79 20 68 /* Directory h
4570: 6f 6c 64 20 64 61 74 61 62 61 73 65 20 61 6e 64 old database and
4580: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a journal files *
4590: 2f 0a 20 20 63 68 61 72 20 2a 7a 53 74 6d 74 4a /. char *zStmtJ
45a0: 72 6e 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 rnl;
45b0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 73 /* Name of the s
45c0: 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c tatement journal
45d0: 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 file */. sqlit
45e0: 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 2a 6a 66 e3_file *fd, *jf
45f0: 64 3b 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 d; /* File d
4600: 65 73 63 72 69 70 74 6f 72 73 20 66 6f 72 20 64 escriptors for d
4610: 61 74 61 62 61 73 65 20 61 6e 64 20 6a 6f 75 72 atabase and jour
4620: 6e 61 6c 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 nal */. sqlite3
4630: 5f 66 69 6c 65 20 2a 73 74 66 64 3b 20 20 20 20 _file *stfd;
4640: 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 73 /* File des
4650: 63 72 69 70 74 6f 72 20 66 6f 72 20 74 68 65 20 criptor for the
4660: 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75 statement subjou
4670: 72 6e 61 6c 2a 2f 0a 20 20 42 75 73 79 48 61 6e rnal*/. BusyHan
4680: 64 6c 65 72 20 2a 70 42 75 73 79 48 61 6e 64 6c dler *pBusyHandl
4690: 65 72 3b 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 er; /* Pointer
46a0: 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 61 to sqlite.busyHa
46b0: 6e 64 6c 65 72 20 2a 2f 0a 20 20 50 61 67 65 72 ndler */. Pager
46c0: 4c 72 75 4c 69 73 74 20 6c 72 75 3b 20 20 20 20 LruList lru;
46d0: 20 20 20 20 20 20 20 2f 2a 20 4c 52 55 20 6c 69 /* LRU li
46e0: 73 74 20 6f 66 20 66 72 65 65 20 70 61 67 65 73 st of free pages
46f0: 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a 70 41 6c */. PgHdr *pAl
4700: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l;
4710: 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61 6c 6c /* List of all
4720: 20 70 61 67 65 73 20 2a 2f 0a 20 20 50 67 48 64 pages */. PgHd
4730: 72 20 2a 70 53 74 6d 74 3b 20 20 20 20 20 20 20 r *pStmt;
4740: 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 /* List
4750: 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 of pages in the
4760: 73 74 61 74 65 6d 65 6e 74 20 73 75 62 6a 6f 75 statement subjou
4770: 72 6e 61 6c 20 2a 2f 0a 20 20 50 67 48 64 72 20 rnal */. PgHdr
4780: 2a 70 44 69 72 74 79 3b 20 20 20 20 20 20 20 20 *pDirty;
4790: 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
47a0: 20 61 6c 6c 20 64 69 72 74 79 20 70 61 67 65 73 all dirty pages
47b0: 20 2a 2f 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61 */. i64 journa
47c0: 6c 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 lOff;
47d0: 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 62 79 74 /* Current byt
47e0: 65 20 6f 66 66 73 65 74 20 69 6e 20 74 68 65 20 e offset in the
47f0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a journal file */.
4800: 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c 48 64 72 i64 journalHdr
4810: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
4820: 20 42 79 74 65 20 6f 66 66 73 65 74 20 74 6f 20 Byte offset to
4830: 70 72 65 76 69 6f 75 73 20 6a 6f 75 72 6e 61 6c previous journal
4840: 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 36 34 header */. i64
4850: 20 73 74 6d 74 48 64 72 4f 66 66 3b 20 20 20 20 stmtHdrOff;
4860: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
4870: 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 t journal header
4880: 20 77 72 69 74 74 65 6e 20 74 68 69 73 20 73 74 written this st
4890: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 36 34 atement */. i64
48a0: 20 73 74 6d 74 43 6b 73 75 6d 3b 20 20 20 20 20 stmtCksum;
48b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 63 6b 73 75 /* cksu
48c0: 6d 49 6e 69 74 20 77 68 65 6e 20 73 74 61 74 65 mInit when state
48d0: 6d 65 6e 74 20 77 61 73 20 73 74 61 72 74 65 64 ment was started
48e0: 20 2a 2f 0a 20 20 69 36 34 20 73 74 6d 74 4a 53 */. i64 stmtJS
48f0: 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ize;
4900: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6a 6f 75 /* Size of jou
4910: 72 6e 61 6c 20 61 74 20 73 74 6d 74 5f 62 65 67 rnal at stmt_beg
4920: 69 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 73 65 in() */. int se
4930: 63 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 20 ctorSize;
4940: 20 20 20 20 20 20 2f 2a 20 41 73 73 75 6d 65 64 /* Assumed
4950: 20 73 65 63 74 6f 72 20 73 69 7a 65 20 64 75 72 sector size dur
4960: 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a ing rollback */.
4970: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 #ifdef SQLITE_TE
4980: 53 54 0a 20 20 69 6e 74 20 6e 48 69 74 2c 20 6e ST. int nHit, n
4990: 4d 69 73 73 3b 20 20 20 20 20 20 20 20 20 20 20 Miss;
49a0: 20 2f 2a 20 43 61 63 68 65 20 68 69 74 73 20 61 /* Cache hits a
49b0: 6e 64 20 6d 69 73 73 69 6e 67 20 2a 2f 0a 20 20 nd missing */.
49c0: 69 6e 74 20 6e 52 65 61 64 2c 20 6e 57 72 69 74 int nRead, nWrit
49d0: 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 e; /* D
49e0: 61 74 61 62 61 73 65 20 70 61 67 65 73 20 72 65 atabase pages re
49f0: 61 64 2f 77 72 69 74 74 65 6e 20 2a 2f 0a 23 65 ad/written */.#e
4a00: 6e 64 69 66 0a 20 20 76 6f 69 64 20 28 2a 78 44 ndif. void (*xD
4a10: 65 73 74 72 75 63 74 6f 72 29 28 44 62 50 61 67 estructor)(DbPag
4a20: 65 2a 2c 69 6e 74 29 3b 20 2f 2a 20 43 61 6c 6c e*,int); /* Call
4a30: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 this routine wh
4a40: 65 6e 20 66 72 65 65 69 6e 67 20 70 61 67 65 73 en freeing pages
4a50: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 52 65 */. void (*xRe
4a60: 69 6e 69 74 65 72 29 28 44 62 50 61 67 65 2a 2c initer)(DbPage*,
4a70: 69 6e 74 29 3b 20 20 20 2f 2a 20 43 61 6c 6c 20 int); /* Call
4a80: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 this routine whe
4a90: 6e 20 72 65 6c 6f 61 64 69 6e 67 20 70 61 67 65 n reloading page
4aa0: 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 s */.#ifdef SQLI
4ab0: 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 76 TE_HAS_CODEC. v
4ac0: 6f 69 64 20 2a 28 2a 78 43 6f 64 65 63 29 28 76 oid *(*xCodec)(v
4ad0: 6f 69 64 2a 2c 76 6f 69 64 2a 2c 50 67 6e 6f 2c oid*,void*,Pgno,
4ae0: 69 6e 74 29 3b 20 2f 2a 20 52 6f 75 74 69 6e 65 int); /* Routine
4af0: 20 66 6f 72 20 65 6e 2f 64 65 63 6f 64 69 6e 67 for en/decoding
4b00: 20 64 61 74 61 20 2a 2f 0a 20 20 76 6f 69 64 20 data */. void
4b10: 2a 70 43 6f 64 65 63 41 72 67 3b 20 20 20 20 20 *pCodecArg;
4b20: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
4b30: 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6f 64 argument to xCod
4b40: 65 63 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 ec() */.#endif.
4b50: 20 69 6e 74 20 6e 48 61 73 68 3b 20 20 20 20 20 int nHash;
4b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
4b70: 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65 Size of the page
4b80: 72 20 68 61 73 68 20 74 61 62 6c 65 20 2a 2f 0a r hash table */.
4b90: 20 20 50 67 48 64 72 20 2a 2a 61 48 61 73 68 3b PgHdr **aHash;
4ba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
4bb0: 20 48 61 73 68 20 74 61 62 6c 65 20 74 6f 20 6d Hash table to m
4bc0: 61 70 20 70 61 67 65 20 6e 75 6d 62 65 72 20 74 ap page number t
4bd0: 6f 20 50 67 48 64 72 20 2a 2f 0a 23 69 66 64 65 o PgHdr */.#ifde
4be0: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
4bf0: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e MEMORY_MANAGEMEN
4c00: 54 0a 20 20 50 61 67 65 72 20 2a 70 4e 65 78 74 T. Pager *pNext
4c10: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
4c20: 2f 2a 20 44 6f 75 62 6c 79 20 6c 69 6e 6b 65 64 /* Doubly linked
4c30: 20 6c 69 73 74 20 6f 66 20 70 61 67 65 72 73 20 list of pagers
4c40: 6f 6e 20 77 68 69 63 68 20 2a 2f 0a 20 20 50 61 on which */. Pa
4c50: 67 65 72 20 2a 70 50 72 65 76 3b 20 20 20 20 20 ger *pPrev;
4c60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 71 6c /* sql
4c70: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d ite3_release_mem
4c80: 6f 72 79 28 29 20 77 69 6c 6c 20 77 6f 72 6b 20 ory() will work
4c90: 2a 2f 0a 20 20 69 6e 74 20 69 49 6e 55 73 65 4d */. int iInUseM
4ca0: 4d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 M;
4cb0: 20 2f 2a 20 4e 6f 6e 2d 7a 65 72 6f 20 69 66 20 /* Non-zero if
4cc0: 75 6e 61 76 61 69 6c 61 62 6c 65 20 74 6f 20 4d unavailable to M
4cd0: 4d 20 2a 2f 0a 20 20 69 6e 74 20 69 49 6e 55 73 M */. int iInUs
4ce0: 65 44 42 3b 20 20 20 20 20 20 20 20 20 20 20 20 eDB;
4cf0: 20 20 20 2f 2a 20 4e 6f 6e 2d 7a 65 72 6f 20 69 /* Non-zero i
4d00: 66 20 69 6e 20 73 71 6c 69 74 65 33 5f 72 65 6c f in sqlite3_rel
4d10: 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 20 2a 2f ease_memory() */
4d20: 0a 23 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a .#endif. char *
4d30: 70 54 6d 70 53 70 61 63 65 3b 20 20 20 20 20 20 pTmpSpace;
4d40: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 2e 70 /* Pager.p
4d50: 61 67 65 53 69 7a 65 20 62 79 74 65 73 20 6f 66 ageSize bytes of
4d60: 20 73 70 61 63 65 20 66 6f 72 20 74 6d 70 20 75 space for tmp u
4d70: 73 65 20 2a 2f 0a 20 20 63 68 61 72 20 64 62 46 se */. char dbF
4d80: 69 6c 65 56 65 72 73 5b 31 36 5d 3b 20 20 20 20 ileVers[16];
4d90: 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 73 20 77 /* Changes w
4da0: 68 65 6e 65 76 65 72 20 64 61 74 61 62 61 73 65 henever database
4db0: 20 66 69 6c 65 20 63 68 61 6e 67 65 73 20 2a 2f file changes */
4dc0: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 .};../*.** The f
4dd0: 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 ollowing global
4de0: 76 61 72 69 61 62 6c 65 73 20 68 6f 6c 64 20 63 variables hold c
4df0: 6f 75 6e 74 65 72 73 20 75 73 65 64 20 66 6f 72 ounters used for
4e00: 0a 2a 2a 20 74 65 73 74 69 6e 67 20 70 75 72 70 .** testing purp
4e10: 6f 73 65 73 20 6f 6e 6c 79 2e 20 20 54 68 65 73 oses only. Thes
4e20: 65 20 76 61 72 69 61 62 6c 65 73 20 64 6f 20 6e e variables do n
4e30: 6f 74 20 65 78 69 73 74 20 69 6e 0a 2a 2a 20 61 ot exist in.** a
4e40: 20 6e 6f 6e 2d 74 65 73 74 69 6e 67 20 62 75 69 non-testing bui
4e50: 6c 64 2e 20 20 54 68 65 73 65 20 76 61 72 69 61 ld. These varia
4e60: 62 6c 65 73 20 61 72 65 20 6e 6f 74 20 74 68 72 bles are not thr
4e70: 65 61 64 2d 73 61 66 65 2e 0a 2a 2f 0a 23 69 66 ead-safe..*/.#if
4e80: 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a def SQLITE_TEST.
4e90: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 int sqlite3_page
4ea0: 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 20 3d r_readdb_count =
4eb0: 20 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 0; /* Number
4ec0: 20 6f 66 20 66 75 6c 6c 20 70 61 67 65 73 20 72 of full pages r
4ed0: 65 61 64 20 66 72 6f 6d 20 44 42 20 2a 2f 0a 69 ead from DB */.i
4ee0: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 nt sqlite3_pager
4ef0: 5f 77 72 69 74 65 64 62 5f 63 6f 75 6e 74 20 3d _writedb_count =
4f00: 20 30 3b 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 0; /* Number
4f10: 6f 66 20 66 75 6c 6c 20 70 61 67 65 73 20 77 72 of full pages wr
4f20: 69 74 74 65 6e 20 74 6f 20 44 42 20 2a 2f 0a 69 itten to DB */.i
4f30: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 nt sqlite3_pager
4f40: 5f 77 72 69 74 65 6a 5f 63 6f 75 6e 74 20 3d 20 _writej_count =
4f50: 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 0; /* Number
4f60: 6f 66 20 70 61 67 65 73 20 77 72 69 74 74 65 6e of pages written
4f70: 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 69 to journal */.i
4f80: 6e 74 20 73 71 6c 69 74 65 33 5f 70 61 67 65 72 nt sqlite3_pager
4f90: 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 20 3d 20 _pgfree_count =
4fa0: 30 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 0; /* Number
4fb0: 6f 66 20 63 61 63 68 65 20 70 61 67 65 73 20 66 of cache pages f
4fc0: 72 65 65 64 20 2a 2f 0a 23 20 64 65 66 69 6e 65 reed */.# define
4fd0: 20 50 41 47 45 52 5f 49 4e 43 52 28 76 29 20 20 PAGER_INCR(v)
4fe0: 76 2b 2b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 v++.#else.# defi
4ff0: 6e 65 20 50 41 47 45 52 5f 49 4e 43 52 28 76 29 ne PAGER_INCR(v)
5000: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
5010: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 he following var
5020: 69 61 62 6c 65 20 70 6f 69 6e 74 73 20 74 6f 20 iable points to
5030: 74 68 65 20 68 65 61 64 20 6f 66 20 61 20 64 6f the head of a do
5040: 75 62 6c 65 2d 6c 69 6e 6b 65 64 20 6c 69 73 74 uble-linked list
5050: 0a 2a 2a 20 6f 66 20 61 6c 6c 20 70 61 67 65 72 .** of all pager
5060: 73 20 74 68 61 74 20 61 72 65 20 65 6c 69 67 69 s that are eligi
5070: 62 6c 65 20 66 6f 72 20 70 61 67 65 20 73 74 65 ble for page ste
5080: 61 6c 69 6e 67 20 62 79 20 74 68 65 0a 2a 2a 20 aling by the.**
5090: 73 71 6c 69 74 65 33 5f 72 65 6c 65 61 73 65 5f sqlite3_release_
50a0: 6d 65 6d 6f 72 79 28 29 20 69 6e 74 65 72 66 61 memory() interfa
50b0: 63 65 2e 20 20 41 63 63 65 73 73 20 74 6f 20 74 ce. Access to t
50c0: 68 69 73 20 6c 69 73 74 20 69 73 0a 2a 2a 20 70 his list is.** p
50d0: 72 6f 74 65 63 74 65 64 20 62 79 20 74 68 65 20 rotected by the
50e0: 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 SQLITE_MUTEX_STA
50f0: 54 49 43 5f 4d 45 4d 32 20 6d 75 74 65 78 2e 0a TIC_MEM2 mutex..
5100: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
5110: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
5120: 41 4e 41 47 45 4d 45 4e 54 0a 73 74 61 74 69 63 ANAGEMENT.static
5130: 20 50 61 67 65 72 20 2a 73 71 6c 69 74 65 33 50 Pager *sqlite3P
5140: 61 67 65 72 4c 69 73 74 20 3d 20 30 3b 0a 73 74 agerList = 0;.st
5150: 61 74 69 63 20 50 61 67 65 72 4c 72 75 4c 69 73 atic PagerLruLis
5160: 74 20 73 71 6c 69 74 65 33 4c 72 75 50 61 67 65 t sqlite3LruPage
5170: 4c 69 73 74 20 3d 20 7b 30 2c 20 30 2c 20 30 7d List = {0, 0, 0}
5180: 3b 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a ;.#endif.../*.**
5190: 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 62 Journal files b
51a0: 65 67 69 6e 20 77 69 74 68 20 74 68 65 20 66 6f egin with the fo
51b0: 6c 6c 6f 77 69 6e 67 20 6d 61 67 69 63 20 73 74 llowing magic st
51c0: 72 69 6e 67 2e 20 20 54 68 65 20 64 61 74 61 0a ring. The data.
51d0: 2a 2a 20 77 61 73 20 6f 62 74 61 69 6e 65 64 20 ** was obtained
51e0: 66 72 6f 6d 20 2f 64 65 76 2f 72 61 6e 64 6f 6d from /dev/random
51f0: 2e 20 20 49 74 20 69 73 20 75 73 65 64 20 6f 6e . It is used on
5200: 6c 79 20 61 73 20 61 20 73 61 6e 69 74 79 20 63 ly as a sanity c
5210: 68 65 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 69 6e 63 heck..**.** Sinc
5220: 65 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 30 2c e version 2.8.0,
5230: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 the journal for
5240: 6d 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 64 64 mat contains add
5250: 69 74 69 6f 6e 61 6c 20 73 61 6e 69 74 79 0a 2a itional sanity.*
5260: 2a 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72 * checking infor
5270: 6d 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 mation. If the
5280: 70 6f 77 65 72 20 66 61 69 6c 73 20 77 68 69 6c power fails whil
5290: 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 e the journal is
52a0: 20 62 65 67 69 6e 0a 2a 2a 20 77 72 69 74 74 65 begin.** writte
52b0: 6e 2c 20 73 65 6d 69 2d 72 61 6e 64 6f 6d 20 67 n, semi-random g
52c0: 61 72 62 61 67 65 20 64 61 74 61 20 6d 69 67 68 arbage data migh
52d0: 74 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 20 t appear in the
52e0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20 journal.** file
52f0: 61 66 74 65 72 20 70 6f 77 65 72 20 69 73 20 72 after power is r
5300: 65 73 74 6f 72 65 64 2e 20 20 49 66 20 61 6e 20 estored. If an
5310: 61 74 74 65 6d 70 74 20 69 73 20 74 68 65 6e 20 attempt is then
5320: 6d 61 64 65 0a 2a 2a 20 74 6f 20 72 6f 6c 6c 20 made.** to roll
5330: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 62 61 63 6b the journal back
5340: 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 , the database c
5350: 6f 75 6c 64 20 62 65 20 63 6f 72 72 75 70 74 65 ould be corrupte
5360: 64 2e 20 20 54 68 65 20 61 64 64 69 74 69 6f 6e d. The addition
5370: 61 6c 0a 2a 2a 20 73 61 6e 69 74 79 20 63 68 65 al.** sanity che
5380: 63 6b 69 6e 67 20 64 61 74 61 20 69 73 20 61 6e cking data is an
5390: 20 61 74 74 65 6d 70 74 20 74 6f 20 64 69 73 63 attempt to disc
53a0: 6f 76 65 72 20 74 68 65 20 67 61 72 62 61 67 65 over the garbage
53b0: 20 69 6e 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e in the.** journ
53c0: 61 6c 20 61 6e 64 20 69 67 6e 6f 72 65 20 69 74 al and ignore it
53d0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 61 6e 69 ..**.** The sani
53e0: 74 79 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f ty checking info
53f0: 72 6d 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 rmation for the
5400: 6e 65 77 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d new journal form
5410: 61 74 20 63 6f 6e 73 69 73 74 73 0a 2a 2a 20 6f at consists.** o
5420: 66 20 61 20 33 32 2d 62 69 74 20 63 68 65 63 6b f a 32-bit check
5430: 73 75 6d 20 6f 6e 20 65 61 63 68 20 70 61 67 65 sum on each page
5440: 20 6f 66 20 64 61 74 61 2e 20 20 54 68 65 20 63 of data. The c
5450: 68 65 63 6b 73 75 6d 20 63 6f 76 65 72 73 20 62 hecksum covers b
5460: 6f 74 68 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 oth.** the page
5470: 6e 75 6d 62 65 72 20 61 6e 64 20 74 68 65 20 70 number and the p
5480: 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
5490: 62 79 74 65 73 20 6f 66 20 64 61 74 61 20 66 6f bytes of data fo
54a0: 72 20 74 68 65 20 70 61 67 65 2e 0a 2a 2a 20 54 r the page..** T
54b0: 68 69 73 20 63 6b 73 75 6d 20 69 73 20 69 6e 69 his cksum is ini
54c0: 74 69 61 6c 69 7a 65 64 20 74 6f 20 61 20 33 32 tialized to a 32
54d0: 2d 62 69 74 20 72 61 6e 64 6f 6d 20 76 61 6c 75 -bit random valu
54e0: 65 20 74 68 61 74 20 61 70 70 65 61 72 73 20 69 e that appears i
54f0: 6e 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c n the.** journal
5500: 20 66 69 6c 65 20 72 69 67 68 74 20 61 66 74 65 file right afte
5510: 72 20 74 68 65 20 68 65 61 64 65 72 2e 20 20 54 r the header. T
5520: 68 65 20 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61 he random initia
5530: 6c 69 7a 65 72 20 69 73 20 69 6d 70 6f 72 74 61 lizer is importa
5540: 6e 74 2c 0a 2a 2a 20 62 65 63 61 75 73 65 20 67 nt,.** because g
5550: 61 72 62 61 67 65 20 64 61 74 61 20 74 68 61 74 arbage data that
5560: 20 61 70 70 65 61 72 73 20 61 74 20 74 68 65 20 appears at the
5570: 65 6e 64 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c end of a journal
5580: 20 69 73 20 6c 69 6b 65 6c 79 0a 2a 2a 20 64 61 is likely.** da
5590: 74 61 20 74 68 61 74 20 77 61 73 20 6f 6e 63 65 ta that was once
55a0: 20 69 6e 20 6f 74 68 65 72 20 66 69 6c 65 73 20 in other files
55b0: 74 68 61 74 20 68 61 76 65 20 6e 6f 77 20 62 65 that have now be
55c0: 65 6e 20 64 65 6c 65 74 65 64 2e 20 20 49 66 20 en deleted. If
55d0: 74 68 65 0a 2a 2a 20 67 61 72 62 61 67 65 20 64 the.** garbage d
55e0: 61 74 61 20 63 61 6d 65 20 66 72 6f 6d 20 61 6e ata came from an
55f0: 20 6f 62 73 6f 6c 65 74 65 20 6a 6f 75 72 6e 61 obsolete journa
5600: 6c 20 66 69 6c 65 2c 20 74 68 65 20 63 68 65 63 l file, the chec
5610: 6b 73 75 6d 73 20 6d 69 67 68 74 0a 2a 2a 20 62 ksums might.** b
5620: 65 20 63 6f 72 72 65 63 74 2e 20 20 42 75 74 20 e correct. But
5630: 62 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 by initializing
5640: 74 68 65 20 63 68 65 63 6b 73 75 6d 20 74 6f 20 the checksum to
5650: 72 61 6e 64 6f 6d 20 76 61 6c 75 65 20 77 68 69 random value whi
5660: 63 68 0a 2a 2a 20 69 73 20 64 69 66 66 65 72 65 ch.** is differe
5670: 6e 74 20 66 6f 72 20 65 76 65 72 79 20 6a 6f 75 nt for every jou
5680: 72 6e 61 6c 2c 20 77 65 20 6d 69 6e 69 6d 69 7a rnal, we minimiz
5690: 65 20 74 68 61 74 20 72 69 73 6b 2e 0a 2a 2f 0a e that risk..*/.
56a0: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 6e 73 static const uns
56b0: 69 67 6e 65 64 20 63 68 61 72 20 61 4a 6f 75 72 igned char aJour
56c0: 6e 61 6c 4d 61 67 69 63 5b 5d 20 3d 20 7b 0a 20 nalMagic[] = {.
56d0: 20 30 78 64 39 2c 20 30 78 64 35 2c 20 30 78 30 0xd9, 0xd5, 0x0
56e0: 35 2c 20 30 78 66 39 2c 20 30 78 32 30 2c 20 30 5, 0xf9, 0x20, 0
56f0: 78 61 31 2c 20 30 78 36 33 2c 20 30 78 64 37 2c xa1, 0x63, 0xd7,
5700: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 .};../*.** The s
5710: 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 ize of the heade
5720: 72 20 61 6e 64 20 6f 66 20 65 61 63 68 20 70 61 r and of each pa
5730: 67 65 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 ge in the journa
5740: 6c 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a l is determined.
5750: 2a 2a 20 62 79 20 74 68 65 20 66 6f 6c 6c 6f 77 ** by the follow
5760: 69 6e 67 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 23 ing macros..*/.#
5770: 64 65 66 69 6e 65 20 4a 4f 55 52 4e 41 4c 5f 50 define JOURNAL_P
5780: 47 5f 53 5a 28 70 50 61 67 65 72 29 20 20 28 28 G_SZ(pPager) ((
5790: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
57a0: 29 20 2b 20 38 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 ) + 8)../*.** Th
57b0: 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 e journal header
57c0: 20 73 69 7a 65 20 66 6f 72 20 74 68 69 73 20 70 size for this p
57d0: 61 67 65 72 2e 20 49 6e 20 74 68 65 20 66 75 74 ager. In the fut
57e0: 75 72 65 2c 20 74 68 69 73 20 63 6f 75 6c 64 20 ure, this could
57f0: 62 65 0a 2a 2a 20 73 65 74 20 74 6f 20 73 6f 6d be.** set to som
5800: 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 72 6f e value read fro
5810: 6d 20 74 68 65 20 64 69 73 6b 20 63 6f 6e 74 72 m the disk contr
5820: 6f 6c 6c 65 72 2e 20 54 68 65 20 69 6d 70 6f 72 oller. The impor
5830: 74 61 6e 74 0a 2a 2a 20 63 68 61 72 61 63 74 65 tant.** characte
5840: 72 69 73 74 69 63 20 69 73 20 74 68 61 74 20 69 ristic is that i
5850: 74 20 69 73 20 74 68 65 20 73 61 6d 65 20 73 69 t is the same si
5860: 7a 65 20 61 73 20 61 20 64 69 73 6b 20 73 65 63 ze as a disk sec
5870: 74 6f 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 tor..*/.#define
5880: 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 JOURNAL_HDR_SZ(p
5890: 50 61 67 65 72 29 20 28 70 50 61 67 65 72 2d 3e Pager) (pPager->
58a0: 73 65 63 74 6f 72 53 69 7a 65 29 0a 0a 2f 2a 0a sectorSize)../*.
58b0: 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 4d 45 4d ** The macro MEM
58c0: 44 42 20 69 73 20 74 72 75 65 20 69 66 20 77 65 DB is true if we
58d0: 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77 69 74 are dealing wit
58e0: 68 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 h an in-memory d
58f0: 61 74 61 62 61 73 65 2e 0a 2a 2a 20 57 65 20 64 atabase..** We d
5900: 6f 20 74 68 69 73 20 61 73 20 61 20 6d 61 63 72 o this as a macr
5910: 6f 20 73 6f 20 74 68 61 74 20 69 66 20 74 68 65 o so that if the
5920: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d SQLITE_OMIT_MEM
5930: 4f 52 59 44 42 20 6d 61 63 72 6f 20 69 73 20 73 ORYDB macro is s
5940: 65 74 2c 0a 2a 2a 20 74 68 65 20 76 61 6c 75 65 et,.** the value
5950: 20 6f 66 20 4d 45 4d 44 42 20 77 69 6c 6c 20 62 of MEMDB will b
5960: 65 20 61 20 63 6f 6e 73 74 61 6e 74 20 61 6e 64 e a constant and
5970: 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 77 69 the compiler wi
5980: 6c 6c 20 6f 70 74 69 6d 69 7a 65 0a 2a 2a 20 6f ll optimize.** o
5990: 75 74 20 63 6f 64 65 20 74 68 61 74 20 77 6f 75 ut code that wou
59a0: 6c 64 20 6e 65 76 65 72 20 65 78 65 63 75 74 65 ld never execute
59b0: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
59c0: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 TE_OMIT_MEMORYDB
59d0: 0a 23 20 64 65 66 69 6e 65 20 4d 45 4d 44 42 20 .# define MEMDB
59e0: 30 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 0.#else.# define
59f0: 20 4d 45 4d 44 42 20 70 50 61 67 65 72 2d 3e 6d MEMDB pPager->m
5a00: 65 6d 44 62 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a emDb.#endif../*.
5a10: 2a 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 20 50 ** Page number P
5a20: 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 20 69 73 20 AGER_MJ_PGNO is
5a30: 6e 65 76 65 72 20 75 73 65 64 20 69 6e 20 61 6e never used in an
5a40: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 SQLite database
5a50: 20 28 69 74 20 69 73 0a 2a 2a 20 72 65 73 65 72 (it is.** reser
5a60: 76 65 64 20 66 6f 72 20 77 6f 72 6b 69 6e 67 20 ved for working
5a70: 61 72 6f 75 6e 64 20 61 20 77 69 6e 64 6f 77 73 around a windows
5a80: 2f 70 6f 73 69 78 20 69 6e 63 6f 6d 70 61 74 69 /posix incompati
5a90: 62 69 6c 69 74 79 29 2e 20 49 74 20 69 73 0a 2a bility). It is.*
5aa0: 2a 20 75 73 65 64 20 69 6e 20 74 68 65 20 6a 6f * used in the jo
5ab0: 75 72 6e 61 6c 20 74 6f 20 73 69 67 6e 69 66 79 urnal to signify
5ac0: 20 74 68 61 74 20 74 68 65 20 72 65 6d 61 69 6e that the remain
5ad0: 64 65 72 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e der of the journ
5ae0: 61 6c 20 66 69 6c 65 20 0a 2a 2a 20 69 73 20 64 al file .** is d
5af0: 65 76 6f 74 65 64 20 74 6f 20 73 74 6f 72 69 6e evoted to storin
5b00: 67 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e g a master journ
5b10: 61 6c 20 6e 61 6d 65 20 2d 20 74 68 65 72 65 20 al name - there
5b20: 61 72 65 20 6e 6f 20 6d 6f 72 65 20 70 61 67 65 are no more page
5b30: 73 20 74 6f 0a 2a 2a 20 72 6f 6c 6c 20 62 61 63 s to.** roll bac
5b40: 6b 2e 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 k. See comments
5b50: 66 6f 72 20 66 75 6e 63 74 69 6f 6e 20 77 72 69 for function wri
5b60: 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 teMasterJournal(
5b70: 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a ) for details..*
5b80: 2f 0a 2f 2a 20 23 64 65 66 69 6e 65 20 50 41 47 /./* #define PAG
5b90: 45 52 5f 4d 4a 5f 50 47 4e 4f 28 78 29 20 28 50 ER_MJ_PGNO(x) (P
5ba0: 45 4e 44 49 4e 47 5f 42 59 54 45 2f 28 28 78 29 ENDING_BYTE/((x)
5bb0: 2d 3e 70 61 67 65 53 69 7a 65 29 29 20 2a 2f 0a ->pageSize)) */.
5bc0: 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 4d 4a #define PAGER_MJ
5bd0: 5f 50 47 4e 4f 28 78 29 20 28 28 50 45 4e 44 49 _PGNO(x) ((PENDI
5be0: 4e 47 5f 42 59 54 45 2f 28 28 78 29 2d 3e 70 61 NG_BYTE/((x)->pa
5bf0: 67 65 53 69 7a 65 29 29 2b 31 29 0a 0a 2f 2a 0a geSize))+1)../*.
5c00: 2a 2a 20 54 68 65 20 6d 61 78 69 6d 75 6d 20 6c ** The maximum l
5c10: 65 67 61 6c 20 70 61 67 65 20 6e 75 6d 62 65 72 egal page number
5c20: 20 69 73 20 28 32 5e 33 31 20 2d 20 31 29 2e 0a is (2^31 - 1)..
5c30: 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 */.#define PAGER
5c40: 5f 4d 41 58 5f 50 47 4e 4f 20 32 31 34 37 34 38 _MAX_PGNO 214748
5c50: 33 36 34 37 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 3647../*.** The
5c60: 70 61 67 65 72 45 6e 74 65 72 28 29 20 61 6e 64 pagerEnter() and
5c70: 20 70 61 67 65 72 4c 65 61 76 65 28 29 20 72 6f pagerLeave() ro
5c80: 75 74 69 6e 65 73 20 61 63 71 75 69 72 65 20 61 utines acquire a
5c90: 6e 64 20 72 65 6c 65 61 73 65 0a 2a 2a 20 61 20 nd release.** a
5ca0: 6d 75 74 65 78 20 6f 6e 20 65 61 63 68 20 70 61 mutex on each pa
5cb0: 67 65 72 2e 20 20 54 68 65 20 6d 75 74 65 78 20 ger. The mutex
5cc0: 69 73 20 72 65 63 75 72 73 69 76 65 2e 0a 2a 2a is recursive..**
5cd0: 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 73 70 .** This is a sp
5ce0: 65 63 69 61 6c 2d 70 75 72 70 6f 73 65 20 6d 75 ecial-purpose mu
5cf0: 74 65 78 2e 20 20 49 74 20 6f 6e 6c 79 20 70 72 tex. It only pr
5d00: 6f 76 69 64 65 73 20 6d 75 74 75 61 6c 20 65 78 ovides mutual ex
5d10: 63 6c 75 73 69 6f 6e 0a 2a 2a 20 62 65 74 77 65 clusion.** betwe
5d20: 65 6e 20 74 68 65 20 42 74 72 65 65 20 61 6e 64 en the Btree and
5d30: 20 74 68 65 20 4d 65 6d 6f 72 79 20 4d 61 6e 61 the Memory Mana
5d40: 67 65 6d 65 6e 74 20 73 71 6c 69 74 65 33 5f 72 gement sqlite3_r
5d50: 65 6c 65 61 73 65 5f 6d 65 6d 6f 72 79 28 29 0a elease_memory().
5d60: 2a 2a 20 66 75 6e 63 74 69 6f 6e 2e 20 20 49 74 ** function. It
5d70: 20 64 6f 65 73 20 6e 6f 74 20 70 72 65 76 65 6e does not preven
5d80: 74 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 t, for example,
5d90: 74 77 6f 20 42 74 72 65 65 73 20 66 72 6f 6d 20 two Btrees from
5da0: 61 63 63 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 accessing.** the
5db0: 20 73 61 6d 65 20 70 61 67 65 72 20 61 74 20 74 same pager at t
5dc0: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 20 20 4f he same time. O
5dd0: 74 68 65 72 20 67 65 6e 65 72 61 6c 2d 70 75 72 ther general-pur
5de0: 70 6f 73 65 20 6d 75 74 65 78 65 73 20 69 6e 0a pose mutexes in.
5df0: 2a 2a 20 74 68 65 20 62 74 72 65 65 20 6c 61 79 ** the btree lay
5e00: 65 72 20 68 61 6e 64 6c 65 20 74 68 61 74 20 63 er handle that c
5e10: 68 6f 72 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 hore..*/.#ifdef
5e20: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
5e30: 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a MORY_MANAGEMENT.
5e40: 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 static void pa
5e50: 67 65 72 45 6e 74 65 72 28 50 61 67 65 72 20 2a gerEnter(Pager *
5e60: 70 29 7b 0a 20 20 20 20 70 2d 3e 69 49 6e 55 73 p){. p->iInUs
5e70: 65 44 42 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 eDB++;. if( p
5e80: 2d 3e 69 49 6e 55 73 65 4d 4d 20 26 26 20 70 2d ->iInUseMM && p-
5e90: 3e 69 49 6e 55 73 65 44 42 3d 3d 31 20 29 7b 0a >iInUseDB==1 ){.
5ea0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
5eb0: 74 65 78 20 2a 6d 75 74 65 78 3b 0a 20 20 20 20 tex *mutex;.
5ec0: 20 20 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 mutex = sqlite
5ed0: 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 3_mutex_alloc(SQ
5ee0: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
5ef0: 43 5f 4d 45 4d 32 29 3b 0a 20 20 20 20 20 20 70 C_MEM2);. p
5f00: 2d 3e 69 49 6e 55 73 65 44 42 20 3d 20 30 3b 0a ->iInUseDB = 0;.
5f10: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 sqlite3_mu
5f20: 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 29 tex_enter(mutex)
5f30: 3b 0a 20 20 20 20 20 20 70 2d 3e 69 49 6e 55 73 ;. p->iInUs
5f40: 65 44 42 20 3d 20 31 3b 0a 20 20 20 20 20 20 73 eDB = 1;. s
5f50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 qlite3_mutex_lea
5f60: 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 7d ve(mutex);. }
5f70: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e . assert( p->
5f80: 69 49 6e 55 73 65 4d 4d 3d 3d 30 20 29 3b 0a 20 iInUseMM==0 );.
5f90: 20 7d 0a 20 20 73 74 61 74 69 63 20 76 6f 69 64 }. static void
5fa0: 20 70 61 67 65 72 4c 65 61 76 65 28 50 61 67 65 pagerLeave(Page
5fb0: 72 20 2a 70 29 7b 0a 20 20 20 20 70 2d 3e 69 49 r *p){. p->iI
5fc0: 6e 55 73 65 44 42 2d 2d 3b 0a 20 20 20 20 61 73 nUseDB--;. as
5fd0: 73 65 72 74 28 20 70 2d 3e 69 49 6e 55 73 65 44 sert( p->iInUseD
5fe0: 42 3e 3d 30 20 29 3b 0a 20 20 7d 0a 23 65 6c 73 B>=0 );. }.#els
5ff0: 65 0a 23 20 64 65 66 69 6e 65 20 70 61 67 65 72 e.# define pager
6000: 45 6e 74 65 72 28 58 29 0a 23 20 64 65 66 69 6e Enter(X).# defin
6010: 65 20 70 61 67 65 72 4c 65 61 76 65 28 58 29 0a e pagerLeave(X).
6020: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 64 #endif../*.** Ad
6030: 64 20 70 61 67 65 20 70 50 67 20 74 6f 20 74 68 d page pPg to th
6040: 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6c 69 6e e end of the lin
6050: 6b 65 64 20 6c 69 73 74 20 6d 61 6e 61 67 65 64 ked list managed
6060: 20 62 79 20 73 74 72 75 63 74 75 72 65 0a 2a 2a by structure.**
6070: 20 70 4c 69 73 74 20 28 70 50 67 20 62 65 63 6f pList (pPg beco
6080: 6d 65 73 20 74 68 65 20 6c 61 73 74 20 65 6e 74 mes the last ent
6090: 72 79 20 69 6e 20 74 68 65 20 6c 69 73 74 20 2d ry in the list -
60a0: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
60b0: 6c 79 20 0a 2a 2a 20 75 73 65 64 29 2e 20 41 72 ly .** used). Ar
60c0: 67 75 6d 65 6e 74 20 70 4c 69 6e 6b 20 73 68 6f gument pLink sho
60d0: 75 6c 64 20 70 6f 69 6e 74 20 74 6f 20 65 69 74 uld point to eit
60e0: 68 65 72 20 70 50 67 2d 3e 66 72 65 65 20 6f 72 her pPg->free or
60f0: 20 70 50 67 2d 3e 67 66 72 65 65 2c 0a 2a 2a 20 pPg->gfree,.**
6100: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 depending on whe
6110: 74 68 65 72 20 70 50 67 20 69 73 20 62 65 69 6e ther pPg is bein
6120: 67 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 70 g added to the p
6130: 61 67 65 72 2d 73 70 65 63 69 66 69 63 20 6f 72 ager-specific or
6140: 0a 2a 2a 20 67 6c 6f 62 61 6c 20 4c 52 55 20 6c .** global LRU l
6150: 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ist..*/.static v
6160: 6f 69 64 20 6c 69 73 74 41 64 64 28 50 61 67 65 oid listAdd(Page
6170: 72 4c 72 75 4c 69 73 74 20 2a 70 4c 69 73 74 2c rLruList *pList,
6180: 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70 PagerLruLink *p
6190: 4c 69 6e 6b 2c 20 50 67 48 64 72 20 2a 70 50 67 Link, PgHdr *pPg
61a0: 29 7b 0a 20 20 70 4c 69 6e 6b 2d 3e 70 4e 65 78 ){. pLink->pNex
61b0: 74 20 3d 20 30 3b 0a 20 20 70 4c 69 6e 6b 2d 3e t = 0;. pLink->
61c0: 70 50 72 65 76 20 3d 20 70 4c 69 73 74 2d 3e 70 pPrev = pList->p
61d0: 4c 61 73 74 3b 0a 0a 23 69 66 64 65 66 20 53 51 Last;..#ifdef SQ
61e0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f LITE_ENABLE_MEMO
61f0: 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 RY_MANAGEMENT.
6200: 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26 70 assert(pLink==&p
6210: 50 67 2d 3e 66 72 65 65 20 7c 7c 20 70 4c 69 6e Pg->free || pLin
6220: 6b 3d 3d 26 70 50 67 2d 3e 67 66 72 65 65 29 3b k==&pPg->gfree);
6230: 0a 20 20 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d . assert(pLink=
6240: 3d 26 70 50 67 2d 3e 67 66 72 65 65 20 7c 7c 20 =&pPg->gfree ||
6250: 70 4c 69 73 74 21 3d 26 73 71 6c 69 74 65 33 4c pList!=&sqlite3L
6260: 72 75 50 61 67 65 4c 69 73 74 29 3b 0a 23 65 6e ruPageList);.#en
6270: 64 69 66 0a 0a 20 20 69 66 28 20 70 4c 69 73 74 dif.. if( pList
6280: 2d 3e 70 4c 61 73 74 20 29 7b 0a 20 20 20 20 69 ->pLast ){. i
6290: 6e 74 20 69 4f 66 66 20 3d 20 28 63 68 61 72 20 nt iOff = (char
62a0: 2a 29 70 4c 69 6e 6b 20 2d 20 28 63 68 61 72 20 *)pLink - (char
62b0: 2a 29 70 50 67 3b 0a 20 20 20 20 50 61 67 65 72 *)pPg;. Pager
62c0: 4c 72 75 4c 69 6e 6b 20 2a 70 4c 61 73 74 4c 69 LruLink *pLastLi
62d0: 6e 6b 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69 nk = (PagerLruLi
62e0: 6e 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 4c nk *)(&((u8 *)pL
62f0: 69 73 74 2d 3e 70 4c 61 73 74 29 5b 69 4f 66 66 ist->pLast)[iOff
6300: 5d 29 3b 0a 20 20 20 20 70 4c 61 73 74 4c 69 6e ]);. pLastLin
6310: 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 50 67 3b 0a k->pNext = pPg;.
6320: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 }else{. ass
6330: 65 72 74 28 21 70 4c 69 73 74 2d 3e 70 46 69 72 ert(!pList->pFir
6340: 73 74 29 3b 0a 20 20 20 20 70 4c 69 73 74 2d 3e st);. pList->
6350: 70 46 69 72 73 74 20 3d 20 70 50 67 3b 0a 20 20 pFirst = pPg;.
6360: 7d 0a 0a 20 20 70 4c 69 73 74 2d 3e 70 4c 61 73 }.. pList->pLas
6370: 74 20 3d 20 70 50 67 3b 0a 20 20 69 66 28 20 21 t = pPg;. if( !
6380: 70 4c 69 73 74 2d 3e 70 46 69 72 73 74 53 79 6e pList->pFirstSyn
6390: 63 65 64 20 26 26 20 70 50 67 2d 3e 6e 65 65 64 ced && pPg->need
63a0: 53 79 6e 63 3d 3d 30 20 29 7b 0a 20 20 20 20 70 Sync==0 ){. p
63b0: 4c 69 73 74 2d 3e 70 46 69 72 73 74 53 79 6e 63 List->pFirstSync
63c0: 65 64 20 3d 20 70 50 67 3b 0a 20 20 7d 0a 7d 0a ed = pPg;. }.}.
63d0: 0a 2f 2a 0a 2a 2a 20 52 65 6d 6f 76 65 20 70 50 ./*.** Remove pP
63e0: 67 20 66 72 6f 6d 20 74 68 65 20 6c 69 73 74 20 g from the list
63f0: 6d 61 6e 61 67 65 64 20 62 79 20 74 68 65 20 73 managed by the s
6400: 74 72 75 63 74 75 72 65 20 70 6f 69 6e 74 65 64 tructure pointed
6410: 20 74 6f 20 62 79 20 70 4c 69 73 74 2e 0a 2a 2a to by pList..**
6420: 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 70 4c 69 .** Argument pLi
6430: 6e 6b 20 73 68 6f 75 6c 64 20 70 6f 69 6e 74 20 nk should point
6440: 74 6f 20 65 69 74 68 65 72 20 70 50 67 2d 3e 66 to either pPg->f
6450: 72 65 65 20 6f 72 20 70 50 67 2d 3e 67 66 72 65 ree or pPg->gfre
6460: 65 2c 20 64 65 70 65 6e 64 69 6e 67 20 0a 2a 2a e, depending .**
6470: 20 6f 6e 20 77 68 65 74 68 65 72 20 70 50 67 20 on whether pPg
6480: 69 73 20 62 65 69 6e 67 20 61 64 64 65 64 20 74 is being added t
6490: 6f 20 74 68 65 20 70 61 67 65 72 2d 73 70 65 63 o the pager-spec
64a0: 69 66 69 63 20 6f 72 20 67 6c 6f 62 61 6c 20 4c ific or global L
64b0: 52 55 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 RU list..*/.stat
64c0: 69 63 20 76 6f 69 64 20 6c 69 73 74 52 65 6d 6f ic void listRemo
64d0: 76 65 28 50 61 67 65 72 4c 72 75 4c 69 73 74 20 ve(PagerLruList
64e0: 2a 70 4c 69 73 74 2c 20 50 61 67 65 72 4c 72 75 *pList, PagerLru
64f0: 4c 69 6e 6b 20 2a 70 4c 69 6e 6b 2c 20 50 67 48 Link *pLink, PgH
6500: 64 72 20 2a 70 50 67 29 7b 0a 20 20 69 6e 74 20 dr *pPg){. int
6510: 69 4f 66 66 20 3d 20 28 63 68 61 72 20 2a 29 70 iOff = (char *)p
6520: 4c 69 6e 6b 20 2d 20 28 63 68 61 72 20 2a 29 70 Link - (char *)p
6530: 50 67 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 Pg;..#ifdef SQLI
6540: 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 TE_ENABLE_MEMORY
6550: 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a 20 20 61 73 _MANAGEMENT. as
6560: 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26 70 50 67 sert(pLink==&pPg
6570: 2d 3e 66 72 65 65 20 7c 7c 20 70 4c 69 6e 6b 3d ->free || pLink=
6580: 3d 26 70 50 67 2d 3e 67 66 72 65 65 29 3b 0a 20 =&pPg->gfree);.
6590: 20 61 73 73 65 72 74 28 70 4c 69 6e 6b 3d 3d 26 assert(pLink==&
65a0: 70 50 67 2d 3e 67 66 72 65 65 20 7c 7c 20 70 4c pPg->gfree || pL
65b0: 69 73 74 21 3d 26 73 71 6c 69 74 65 33 4c 72 75 ist!=&sqlite3Lru
65c0: 50 61 67 65 4c 69 73 74 29 3b 0a 23 65 6e 64 69 PageList);.#endi
65d0: 66 0a 0a 20 20 69 66 28 20 70 50 67 3d 3d 70 4c f.. if( pPg==pL
65e0: 69 73 74 2d 3e 70 46 69 72 73 74 20 29 7b 0a 20 ist->pFirst ){.
65f0: 20 20 20 70 4c 69 73 74 2d 3e 70 46 69 72 73 74 pList->pFirst
6600: 20 3d 20 70 4c 69 6e 6b 2d 3e 70 4e 65 78 74 3b = pLink->pNext;
6610: 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67 3d 3d . }. if( pPg==
6620: 70 4c 69 73 74 2d 3e 70 4c 61 73 74 20 29 7b 0a pList->pLast ){.
6630: 20 20 20 20 70 4c 69 73 74 2d 3e 70 4c 61 73 74 pList->pLast
6640: 20 3d 20 70 4c 69 6e 6b 2d 3e 70 50 72 65 76 3b = pLink->pPrev;
6650: 0a 20 20 7d 0a 20 20 69 66 28 20 70 4c 69 6e 6b . }. if( pLink
6660: 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 50 ->pPrev ){. P
6670: 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70 50 72 agerLruLink *pPr
6680: 65 76 4c 69 6e 6b 20 3d 20 28 50 61 67 65 72 4c evLink = (PagerL
6690: 72 75 4c 69 6e 6b 20 2a 29 28 26 28 28 75 38 20 ruLink *)(&((u8
66a0: 2a 29 70 4c 69 6e 6b 2d 3e 70 50 72 65 76 29 5b *)pLink->pPrev)[
66b0: 69 4f 66 66 5d 29 3b 0a 20 20 20 20 70 50 72 65 iOff]);. pPre
66c0: 76 4c 69 6e 6b 2d 3e 70 4e 65 78 74 20 3d 20 70 vLink->pNext = p
66d0: 4c 69 6e 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d Link->pNext;. }
66e0: 0a 20 20 69 66 28 20 70 4c 69 6e 6b 2d 3e 70 4e . if( pLink->pN
66f0: 65 78 74 20 29 7b 0a 20 20 20 20 50 61 67 65 72 ext ){. Pager
6700: 4c 72 75 4c 69 6e 6b 20 2a 70 4e 65 78 74 4c 69 LruLink *pNextLi
6710: 6e 6b 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69 nk = (PagerLruLi
6720: 6e 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 4c nk *)(&((u8 *)pL
6730: 69 6e 6b 2d 3e 70 4e 65 78 74 29 5b 69 4f 66 66 ink->pNext)[iOff
6740: 5d 29 3b 0a 20 20 20 20 70 4e 65 78 74 4c 69 6e ]);. pNextLin
6750: 6b 2d 3e 70 50 72 65 76 20 3d 20 70 4c 69 6e 6b k->pPrev = pLink
6760: 2d 3e 70 50 72 65 76 3b 0a 20 20 7d 0a 20 20 69 ->pPrev;. }. i
6770: 66 28 20 70 50 67 3d 3d 70 4c 69 73 74 2d 3e 70 f( pPg==pList->p
6780: 46 69 72 73 74 53 79 6e 63 65 64 20 29 7b 0a 20 FirstSynced ){.
6790: 20 20 20 50 67 48 64 72 20 2a 70 20 3d 20 70 4c PgHdr *p = pL
67a0: 69 6e 6b 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 ink->pNext;.
67b0: 77 68 69 6c 65 28 20 70 20 26 26 20 70 2d 3e 6e while( p && p->n
67c0: 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 20 eedSync ){.
67d0: 20 50 61 67 65 72 4c 72 75 4c 69 6e 6b 20 2a 70 PagerLruLink *p
67e0: 4c 20 3d 20 28 50 61 67 65 72 4c 72 75 4c 69 6e L = (PagerLruLin
67f0: 6b 20 2a 29 28 26 28 28 75 38 20 2a 29 70 29 5b k *)(&((u8 *)p)[
6800: 69 4f 66 66 5d 29 3b 0a 20 20 20 20 20 20 70 20 iOff]);. p
6810: 3d 20 70 4c 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 = pL->pNext;.
6820: 20 7d 0a 20 20 20 20 70 4c 69 73 74 2d 3e 70 46 }. pList->pF
6830: 69 72 73 74 53 79 6e 63 65 64 20 3d 20 70 3b 0a irstSynced = p;.
6840: 20 20 7d 0a 0a 20 20 70 4c 69 6e 6b 2d 3e 70 4e }.. pLink->pN
6850: 65 78 74 20 3d 20 70 4c 69 6e 6b 2d 3e 70 50 72 ext = pLink->pPr
6860: 65 76 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 20 0a 2a ev = 0;.}../* .*
6870: 2a 20 41 64 64 20 70 61 67 65 20 70 50 67 20 74 * Add page pPg t
6880: 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 20 66 72 o the list of fr
6890: 65 65 20 70 61 67 65 73 20 66 6f 72 20 74 68 65 ee pages for the
68a0: 20 70 61 67 65 72 2e 20 49 66 20 0a 2a 2a 20 6d pager. If .** m
68b0: 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d 65 6e 74 emory-management
68c0: 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 61 6c 73 is enabled, als
68d0: 6f 20 61 64 64 20 74 68 65 20 70 61 67 65 20 74 o add the page t
68e0: 6f 20 74 68 65 20 67 6c 6f 62 61 6c 20 0a 2a 2a o the global .**
68f0: 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 70 61 list of free pa
6900: 67 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ges..*/.static v
6910: 6f 69 64 20 6c 72 75 4c 69 73 74 41 64 64 28 50 oid lruListAdd(P
6920: 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 6c 69 gHdr *pPg){. li
6930: 73 74 41 64 64 28 26 70 50 67 2d 3e 70 50 61 67 stAdd(&pPg->pPag
6940: 65 72 2d 3e 6c 72 75 2c 20 26 70 50 67 2d 3e 66 er->lru, &pPg->f
6950: 72 65 65 2c 20 70 50 67 29 3b 0a 23 69 66 64 65 ree, pPg);.#ifde
6960: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
6970: 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e MEMORY_MANAGEMEN
6980: 54 0a 20 20 69 66 28 20 21 70 50 67 2d 3e 70 50 T. if( !pPg->pP
6990: 61 67 65 72 2d 3e 6d 65 6d 44 62 20 29 7b 0a 20 ager->memDb ){.
69a0: 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 sqlite3_mutex
69b0: 5f 65 6e 74 65 72 28 73 71 6c 69 74 65 33 5f 6d _enter(sqlite3_m
69c0: 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 utex_alloc(SQLIT
69d0: 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4c E_MUTEX_STATIC_L
69e0: 52 55 29 29 3b 0a 20 20 20 20 6c 69 73 74 41 64 RU));. listAd
69f0: 64 28 26 73 71 6c 69 74 65 33 4c 72 75 50 61 67 d(&sqlite3LruPag
6a00: 65 4c 69 73 74 2c 20 26 70 50 67 2d 3e 67 66 72 eList, &pPg->gfr
6a10: 65 65 2c 20 70 50 67 29 3b 0a 20 20 20 20 73 71 ee, pPg);. sq
6a20: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 lite3_mutex_leav
6a30: 65 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f e(sqlite3_mutex_
6a40: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 alloc(SQLITE_MUT
6a50: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b EX_STATIC_LRU));
6a60: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f . }.#endif.}../
6a70: 2a 20 0a 2a 2a 20 52 65 6d 6f 76 65 20 70 61 67 * .** Remove pag
6a80: 65 20 70 50 67 20 66 72 6f 6d 20 74 68 65 20 6c e pPg from the l
6a90: 69 73 74 20 6f 66 20 66 72 65 65 20 70 61 67 65 ist of free page
6aa0: 73 20 66 6f 72 20 74 68 65 20 61 73 73 6f 63 69 s for the associ
6ab0: 61 74 65 64 20 70 61 67 65 72 2e 0a 2a 2a 20 49 ated pager..** I
6ac0: 66 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 6d f memory-managem
6ad0: 65 6e 74 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 ent is enabled,
6ae0: 61 6c 73 6f 20 72 65 6d 6f 76 65 20 70 50 67 20 also remove pPg
6af0: 66 72 6f 6d 20 74 68 65 20 67 6c 6f 62 61 6c 20 from the global
6b00: 6c 69 73 74 0a 2a 2a 20 6f 66 20 66 72 65 65 20 list.** of free
6b10: 70 61 67 65 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 pages..*/.static
6b20: 20 76 6f 69 64 20 6c 72 75 4c 69 73 74 52 65 6d void lruListRem
6b30: 6f 76 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b ove(PgHdr *pPg){
6b40: 0a 20 20 6c 69 73 74 52 65 6d 6f 76 65 28 26 70 . listRemove(&p
6b50: 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6c 72 75 2c Pg->pPager->lru,
6b60: 20 26 70 50 67 2d 3e 66 72 65 65 2c 20 70 50 67 &pPg->free, pPg
6b70: 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 );.#ifdef SQLITE
6b80: 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
6b90: 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28 20 ANAGEMENT. if(
6ba0: 21 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6d 65 !pPg->pPager->me
6bb0: 6d 44 62 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 mDb ){. sqlit
6bc0: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 73 e3_mutex_enter(s
6bd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c qlite3_mutex_all
6be0: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f oc(SQLITE_MUTEX_
6bf0: 53 54 41 54 49 43 5f 4c 52 55 29 29 3b 0a 20 20 STATIC_LRU));.
6c00: 20 20 6c 69 73 74 52 65 6d 6f 76 65 28 26 73 71 listRemove(&sq
6c10: 6c 69 74 65 33 4c 72 75 50 61 67 65 4c 69 73 74 lite3LruPageList
6c20: 2c 20 26 70 50 67 2d 3e 67 66 72 65 65 2c 20 70 , &pPg->gfree, p
6c30: 50 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 Pg);. sqlite3
6c40: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c _mutex_leave(sql
6c50: 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 ite3_mutex_alloc
6c60: 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 (SQLITE_MUTEX_ST
6c70: 41 54 49 43 5f 4c 52 55 29 29 3b 0a 20 20 7d 0a ATIC_LRU));. }.
6c80: 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 20 0a 2a 2a #endif.}../* .**
6c90: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 This function i
6ca0: 73 20 63 61 6c 6c 65 64 20 6a 75 73 74 20 61 66 s called just af
6cb0: 74 65 72 20 74 68 65 20 6e 65 65 64 53 79 6e 63 ter the needSync
6cc0: 20 66 6c 61 67 20 68 61 73 20 62 65 65 6e 20 63 flag has been c
6cd0: 6c 65 61 72 65 64 0a 2a 2a 20 66 72 6f 6d 20 61 leared.** from a
6ce0: 6c 6c 20 70 61 67 65 73 20 6d 61 6e 61 67 65 64 ll pages managed
6cf0: 20 62 79 20 70 50 61 67 65 72 20 28 75 73 75 61 by pPager (usua
6d00: 6c 6c 79 20 62 65 63 61 75 73 65 20 74 68 65 20 lly because the
6d10: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 journal file.**
6d20: 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 73 79 has just been sy
6d30: 6e 63 65 64 29 2e 20 49 74 20 75 70 64 61 74 65 nced). It update
6d40: 73 20 74 68 65 20 70 50 61 67 65 72 2d 3e 6c 72 s the pPager->lr
6d50: 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20 76 u.pFirstSynced v
6d60: 61 72 69 61 62 6c 65 0a 2a 2a 20 61 6e 64 2c 20 ariable.** and,
6d70: 69 66 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 67 65 if memory-manage
6d80: 6d 65 6e 74 20 69 73 20 65 6e 61 62 6c 65 64 2c ment is enabled,
6d90: 20 74 68 65 20 73 71 6c 69 74 65 33 4c 72 75 50 the sqlite3LruP
6da0: 61 67 65 4c 69 73 74 2e 70 46 69 72 73 74 53 79 ageList.pFirstSy
6db0: 6e 63 65 64 0a 2a 2a 20 76 61 72 69 61 62 6c 65 nced.** variable
6dc0: 20 61 6c 73 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 also..*/.static
6dd0: 20 76 6f 69 64 20 6c 72 75 4c 69 73 74 53 65 74 void lruListSet
6de0: 46 69 72 73 74 53 79 6e 63 65 64 28 50 61 67 65 FirstSynced(Page
6df0: 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 70 50 r *pPager){. pP
6e00: 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 ager->lru.pFirst
6e10: 53 79 6e 63 65 64 20 3d 20 70 50 61 67 65 72 2d Synced = pPager-
6e20: 3e 6c 72 75 2e 70 46 69 72 73 74 3b 0a 23 69 66 >lru.pFirst;.#if
6e30: 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
6e40: 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d E_MEMORY_MANAGEM
6e50: 45 4e 54 0a 20 20 69 66 28 20 21 70 50 61 67 65 ENT. if( !pPage
6e60: 72 2d 3e 6d 65 6d 44 62 20 29 7b 0a 20 20 20 20 r->memDb ){.
6e70: 50 67 48 64 72 20 2a 70 3b 0a 20 20 20 20 73 71 PgHdr *p;. sq
6e80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
6e90: 72 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f r(sqlite3_mutex_
6ea0: 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 alloc(SQLITE_MUT
6eb0: 45 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b EX_STATIC_LRU));
6ec0: 0a 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 . for(p=sqlit
6ed0: 65 33 4c 72 75 50 61 67 65 4c 69 73 74 2e 70 46 e3LruPageList.pF
6ee0: 69 72 73 74 3b 20 70 20 26 26 20 70 2d 3e 6e 65 irst; p && p->ne
6ef0: 65 64 53 79 6e 63 3b 20 70 3d 70 2d 3e 67 66 72 edSync; p=p->gfr
6f00: 65 65 2e 70 4e 65 78 74 29 3b 0a 20 20 20 20 61 ee.pNext);. a
6f10: 73 73 65 72 74 28 70 3d 3d 70 50 61 67 65 72 2d ssert(p==pPager-
6f20: 3e 6c 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65 >lru.pFirstSynce
6f30: 64 20 7c 7c 20 70 3d 3d 73 71 6c 69 74 65 33 4c d || p==sqlite3L
6f40: 72 75 50 61 67 65 4c 69 73 74 2e 70 46 69 72 73 ruPageList.pFirs
6f50: 74 53 79 6e 63 65 64 29 3b 0a 20 20 20 20 73 71 tSynced);. sq
6f60: 6c 69 74 65 33 4c 72 75 50 61 67 65 4c 69 73 74 lite3LruPageList
6f70: 2e 70 46 69 72 73 74 53 79 6e 63 65 64 20 3d 20 .pFirstSynced =
6f80: 70 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d p;. sqlite3_m
6f90: 75 74 65 78 5f 6c 65 61 76 65 28 73 71 6c 69 74 utex_leave(sqlit
6fa0: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 e3_mutex_alloc(S
6fb0: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
6fc0: 49 43 5f 4c 52 55 29 29 3b 0a 20 20 7d 0a 23 65 IC_LRU));. }.#e
6fd0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 ndif.}../*.** Re
6fe0: 74 75 72 6e 20 74 72 75 65 20 69 66 20 70 61 67 turn true if pag
6ff0: 65 20 2a 70 50 67 20 68 61 73 20 61 6c 72 65 61 e *pPg has alrea
7000: 64 79 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 dy been written
7010: 74 6f 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 to the statement
7020: 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 28 6f 72 20 .** journal (or
7030: 73 74 61 74 65 6d 65 6e 74 20 73 6e 61 70 73 68 statement snapsh
7040: 6f 74 20 68 61 73 20 62 65 65 6e 20 63 72 65 61 ot has been crea
7050: 74 65 64 2c 20 69 66 20 2a 70 50 67 20 69 73 20 ted, if *pPg is
7060: 70 61 72 74 0a 2a 2a 20 6f 66 20 61 6e 20 69 6e part.** of an in
7070: 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 -memory database
7080: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 )..*/.static int
7090: 20 70 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74 pageInStatement
70a0: 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 (PgHdr *pPg){.
70b0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 Pager *pPager =
70c0: 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69 pPg->pPager;. i
70d0: 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 f( MEMDB ){.
70e0: 72 65 74 75 72 6e 20 50 47 48 44 52 5f 54 4f 5f return PGHDR_TO_
70f0: 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 65 72 HIST(pPg, pPager
7100: 29 2d 3e 69 6e 53 74 6d 74 3b 0a 20 20 7d 65 6c )->inStmt;. }el
7110: 73 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 73 se{. return s
7120: 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74 qlite3BitvecTest
7130: 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 (pPager->pInStmt
7140: 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 , pPg->pgno);.
7150: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 }.}../*.** Chang
7160: 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 e the size of th
7170: 65 20 70 61 67 65 72 20 68 61 73 68 20 74 61 62 e pager hash tab
7180: 6c 65 20 74 6f 20 4e 2e 20 20 4e 20 6d 75 73 74 le to N. N must
7190: 20 62 65 20 61 20 70 6f 77 65 72 0a 2a 2a 20 6f be a power.** o
71a0: 66 20 74 77 6f 2e 0a 2a 2f 0a 73 74 61 74 69 63 f two..*/.static
71b0: 20 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73 69 void pager_resi
71c0: 7a 65 5f 68 61 73 68 5f 74 61 62 6c 65 28 50 61 ze_hash_table(Pa
71d0: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 ger *pPager, int
71e0: 20 4e 29 7b 0a 20 20 50 67 48 64 72 20 2a 2a 61 N){. PgHdr **a
71f0: 48 61 73 68 2c 20 2a 70 50 67 3b 0a 20 20 61 73 Hash, *pPg;. as
7200: 73 65 72 74 28 20 4e 3e 30 20 26 26 20 28 4e 26 sert( N>0 && (N&
7210: 28 4e 2d 31 29 29 3d 3d 30 20 29 3b 0a 23 69 66 (N-1))==0 );.#if
7220: 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f def SQLITE_MALLO
7230: 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 0a 20 20 69 C_SOFT_LIMIT. i
7240: 66 28 20 4e 2a 73 69 7a 65 6f 66 28 61 48 61 73 f( N*sizeof(aHas
7250: 68 5b 30 5d 29 3e 53 51 4c 49 54 45 5f 4d 41 4c h[0])>SQLITE_MAL
7260: 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 20 29 LOC_SOFT_LIMIT )
7270: 7b 0a 20 20 20 20 4e 20 3d 20 53 51 4c 49 54 45 {. N = SQLITE
7280: 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d _MALLOC_SOFT_LIM
7290: 49 54 2f 73 69 7a 65 6f 66 28 61 48 61 73 68 5b IT/sizeof(aHash[
72a0: 30 5d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 4e 0]);. }. if( N
72b0: 3d 3d 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 20 ==pPager->nHash
72c0: 29 20 72 65 74 75 72 6e 3b 0a 23 65 6e 64 69 66 ) return;.#endif
72d0: 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50 . pagerLeave(pP
72e0: 61 67 65 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 ager);. sqlite3
72f0: 46 61 75 6c 74 42 65 6e 69 67 6e 28 53 51 4c 49 FaultBenign(SQLI
7300: 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52 TE_FAULTINJECTOR
7310: 5f 4d 41 4c 4c 4f 43 2c 20 70 50 61 67 65 72 2d _MALLOC, pPager-
7320: 3e 61 48 61 73 68 21 3d 30 29 3b 0a 20 20 61 48 >aHash!=0);. aH
7330: 61 73 68 20 3d 20 73 71 6c 69 74 65 33 4d 61 6c ash = sqlite3Mal
7340: 6c 6f 63 5a 65 72 6f 28 20 73 69 7a 65 6f 66 28 locZero( sizeof(
7350: 61 48 61 73 68 5b 30 5d 29 2a 4e 20 29 3b 0a 20 aHash[0])*N );.
7360: 20 73 71 6c 69 74 65 33 46 61 75 6c 74 42 65 6e sqlite3FaultBen
7370: 69 67 6e 28 53 51 4c 49 54 45 5f 46 41 55 4c 54 ign(SQLITE_FAULT
7380: 49 4e 4a 45 43 54 4f 52 5f 4d 41 4c 4c 4f 43 2c INJECTOR_MALLOC,
7390: 20 30 29 3b 0a 20 20 70 61 67 65 72 45 6e 74 65 0);. pagerEnte
73a0: 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 r(pPager);. if(
73b0: 20 61 48 61 73 68 3d 3d 30 20 29 7b 0a 20 20 20 aHash==0 ){.
73c0: 20 2f 2a 20 46 61 69 6c 75 72 65 20 74 6f 20 72 /* Failure to r
73d0: 65 68 61 73 68 20 69 73 20 6e 6f 74 20 61 6e 20 ehash is not an
73e0: 65 72 72 6f 72 2e 20 20 49 74 20 69 73 20 6f 6e error. It is on
73f0: 6c 79 20 61 20 70 65 72 66 6f 72 6d 61 6e 63 65 ly a performance
7400: 20 68 69 74 2e 20 2a 2f 0a 20 20 20 20 72 65 74 hit. */. ret
7410: 75 72 6e 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 urn;. }. sqlit
7420: 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 2d 3e e3_free(pPager->
7430: 61 48 61 73 68 29 3b 0a 20 20 70 50 61 67 65 72 aHash);. pPager
7440: 2d 3e 6e 48 61 73 68 20 3d 20 4e 3b 0a 20 20 70 ->nHash = N;. p
7450: 50 61 67 65 72 2d 3e 61 48 61 73 68 20 3d 20 61 Pager->aHash = a
7460: 48 61 73 68 3b 0a 20 20 66 6f 72 28 70 50 67 3d Hash;. for(pPg=
7470: 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 pPager->pAll; pP
7480: 67 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78 g; pPg=pPg->pNex
7490: 74 41 6c 6c 29 7b 0a 20 20 20 20 69 6e 74 20 68 tAll){. int h
74a0: 3b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 ;. if( pPg->p
74b0: 67 6e 6f 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 gno==0 ){.
74c0: 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 4e 65 assert( pPg->pNe
74d0: 78 74 48 61 73 68 3d 3d 30 20 26 26 20 70 50 67 xtHash==0 && pPg
74e0: 2d 3e 70 50 72 65 76 48 61 73 68 3d 3d 30 20 29 ->pPrevHash==0 )
74f0: 3b 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 ;. continue
7500: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 68 20 3d 20 ;. }. h =
7510: 70 50 67 2d 3e 70 67 6e 6f 20 26 20 28 4e 2d 31 pPg->pgno & (N-1
7520: 29 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65 78 );. pPg->pNex
7530: 74 48 61 73 68 20 3d 20 61 48 61 73 68 5b 68 5d tHash = aHash[h]
7540: 3b 0a 20 20 20 20 69 66 28 20 61 48 61 73 68 5b ;. if( aHash[
7550: 68 5d 20 29 7b 0a 20 20 20 20 20 20 61 48 61 73 h] ){. aHas
7560: 68 5b 68 5d 2d 3e 70 50 72 65 76 48 61 73 68 20 h[h]->pPrevHash
7570: 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a 20 20 20 = pPg;. }.
7580: 20 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 3b aHash[h] = pPg;
7590: 0a 20 20 20 20 70 50 67 2d 3e 70 50 72 65 76 48 . pPg->pPrevH
75a0: 61 73 68 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a ash = 0;. }.}..
75b0: 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20 33 32 2d /*.** Read a 32-
75c0: 62 69 74 20 69 6e 74 65 67 65 72 20 66 72 6f 6d bit integer from
75d0: 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 20 the given file
75e0: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 53 74 6f descriptor. Sto
75f0: 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 0a 2a re the integer.*
7600: 2a 20 74 68 61 74 20 69 73 20 72 65 61 64 20 69 * that is read i
7610: 6e 20 2a 70 52 65 73 2e 20 20 52 65 74 75 72 6e n *pRes. Return
7620: 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 SQLITE_OK if ev
7630: 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 65 64 2c erything worked,
7640: 20 6f 72 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 20 or an.** error
7650: 63 6f 64 65 20 69 73 20 73 6f 6d 65 74 68 69 6e code is somethin
7660: 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a g goes wrong..**
7670: 0a 2a 2a 20 41 6c 6c 20 76 61 6c 75 65 73 20 61 .** All values a
7680: 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69 73 re stored on dis
7690: 6b 20 61 73 20 62 69 67 2d 65 6e 64 69 61 6e 2e k as big-endian.
76a0: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 .*/.static int r
76b0: 65 61 64 33 32 62 69 74 73 28 73 71 6c 69 74 65 ead32bits(sqlite
76c0: 33 5f 66 69 6c 65 20 2a 66 64 2c 20 69 36 34 20 3_file *fd, i64
76d0: 6f 66 66 73 65 74 2c 20 75 33 32 20 2a 70 52 65 offset, u32 *pRe
76e0: 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 s){. unsigned c
76f0: 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 69 6e 74 har ac[4];. int
7700: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 rc = sqlite3OsR
7710: 65 61 64 28 66 64 2c 20 61 63 2c 20 73 69 7a 65 ead(fd, ac, size
7720: 6f 66 28 61 63 29 2c 20 6f 66 66 73 65 74 29 3b of(ac), offset);
7730: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
7740: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 65 E_OK ){. *pRe
7750: 73 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 62 s = sqlite3Get4b
7760: 79 74 65 28 61 63 29 3b 0a 20 20 7d 0a 20 20 72 yte(ac);. }. r
7770: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
7780: 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d 62 69 ** Write a 32-bi
7790: 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f 20 61 t integer into a
77a0: 20 73 74 72 69 6e 67 20 62 75 66 66 65 72 20 69 string buffer i
77b0: 6e 20 62 69 67 2d 65 6e 64 69 61 6e 20 62 79 74 n big-endian byt
77c0: 65 20 6f 72 64 65 72 2e 0a 2a 2f 0a 23 64 65 66 e order..*/.#def
77d0: 69 6e 65 20 70 75 74 33 32 62 69 74 73 28 41 2c ine put32bits(A,
77e0: 42 29 20 20 73 71 6c 69 74 65 33 50 75 74 34 62 B) sqlite3Put4b
77f0: 79 74 65 28 28 75 38 2a 29 41 2c 42 29 0a 0a 2f yte((u8*)A,B)../
7800: 2a 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d *.** Write a 32-
7810: 62 69 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f bit integer into
7820: 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 20 the given file
7830: 64 65 73 63 72 69 70 74 6f 72 2e 20 20 52 65 74 descriptor. Ret
7840: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a urn SQLITE_OK.**
7850: 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 61 on success or a
7860: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 n error code is
7870: 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 something goes w
7880: 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 rong..*/.static
7890: 69 6e 74 20 77 72 69 74 65 33 32 62 69 74 73 28 int write32bits(
78a0: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 sqlite3_file *fd
78b0: 2c 20 69 36 34 20 6f 66 66 73 65 74 2c 20 75 33 , i64 offset, u3
78c0: 32 20 76 61 6c 29 7b 0a 20 20 63 68 61 72 20 61 2 val){. char a
78d0: 63 5b 34 5d 3b 0a 20 20 70 75 74 33 32 62 69 74 c[4];. put32bit
78e0: 73 28 61 63 2c 20 76 61 6c 29 3b 0a 20 20 72 65 s(ac, val);. re
78f0: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 57 72 turn sqlite3OsWr
7900: 69 74 65 28 66 64 2c 20 61 63 2c 20 34 2c 20 6f ite(fd, ac, 4, o
7910: 66 66 73 65 74 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a ffset);.}../*.**
7920: 20 49 66 20 66 69 6c 65 20 70 46 64 20 69 73 20 If file pFd is
7930: 6f 70 65 6e 2c 20 63 61 6c 6c 20 73 71 6c 69 74 open, call sqlit
7940: 65 33 4f 73 55 6e 6c 6f 63 6b 28 29 20 6f 6e 20 e3OsUnlock() on
7950: 69 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e it..*/.static in
7960: 74 20 6f 73 55 6e 6c 6f 63 6b 28 73 71 6c 69 74 t osUnlock(sqlit
7970: 65 33 5f 66 69 6c 65 20 2a 70 46 64 2c 20 69 6e e3_file *pFd, in
7980: 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 69 66 28 20 t eLock){. if(
7990: 21 70 46 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 !pFd->pMethods )
79a0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
79b0: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 65 ITE_OK;. }. re
79c0: 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 55 6e turn sqlite3OsUn
79d0: 6c 6f 63 6b 28 70 46 64 2c 20 65 4c 6f 63 6b 29 lock(pFd, eLock)
79e0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 ;.}../*.** This
79f0: 66 75 6e 63 74 69 6f 6e 20 64 65 74 65 72 6d 69 function determi
7a00: 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e nes whether or n
7a10: 6f 74 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72 ot the atomic-wr
7a20: 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ite optimization
7a30: 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 .** can be used
7a40: 77 69 74 68 20 74 68 69 73 20 70 61 67 65 72 2e with this pager.
7a50: 20 54 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f The optimizatio
7a60: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 66 n can be used if
7a70: 3a 0a 2a 2a 0a 2a 2a 20 20 28 61 29 20 74 68 65 :.**.** (a) the
7a80: 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 value returned
7a90: 62 79 20 4f 73 44 65 76 69 63 65 43 68 61 72 61 by OsDeviceChara
7aa0: 63 74 65 72 69 73 74 69 63 73 28 29 20 69 6e 64 cteristics() ind
7ab0: 69 63 61 74 65 73 20 74 68 61 74 0a 2a 2a 20 20 icates that.**
7ac0: 20 20 20 20 61 20 64 61 74 61 62 61 73 65 20 70 a database p
7ad0: 61 67 65 20 6d 61 79 20 62 65 20 77 72 69 74 74 age may be writt
7ae0: 65 6e 20 61 74 6f 6d 69 63 61 6c 6c 79 2c 20 61 en atomically, a
7af0: 6e 64 0a 2a 2a 20 20 28 62 29 20 74 68 65 20 76 nd.** (b) the v
7b00: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
7b10: 20 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 29 20 OsSectorSize()
7b20: 69 73 20 6c 65 73 73 20 74 68 61 6e 20 6f 72 20 is less than or
7b30: 65 71 75 61 6c 0a 2a 2a 20 20 20 20 20 20 74 6f equal.** to
7b40: 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 2e 0a the page size..
7b50: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6f 70 74 **.** If the opt
7b60: 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 6e 6f 74 imization cannot
7b70: 20 62 65 20 75 73 65 64 2c 20 30 20 69 73 20 72 be used, 0 is r
7b80: 65 74 75 72 6e 65 64 2e 20 49 66 20 69 74 20 63 eturned. If it c
7b90: 61 6e 20 62 65 20 75 73 65 64 2c 0a 2a 2a 20 74 an be used,.** t
7ba0: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 72 65 hen the value re
7bb0: 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 73 69 turned is the si
7bc0: 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ze of the journa
7bd0: 6c 20 66 69 6c 65 20 77 68 65 6e 20 69 74 0a 2a l file when it.*
7be0: 2a 20 63 6f 6e 74 61 69 6e 73 20 72 6f 6c 6c 62 * contains rollb
7bf0: 61 63 6b 20 64 61 74 61 20 66 6f 72 20 65 78 61 ack data for exa
7c00: 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 2e 0a 2a ctly one page..*
7c10: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
7c20: 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
7c30: 49 54 45 0a 73 74 61 74 69 63 20 69 6e 74 20 6a ITE.static int j
7c40: 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 50 61 rnlBufferSize(Pa
7c50: 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
7c60: 69 6e 74 20 64 63 3b 20 20 20 20 20 20 20 20 20 int dc;
7c70: 20 20 2f 2a 20 44 65 76 69 63 65 20 63 68 61 72 /* Device char
7c80: 61 63 74 65 72 69 73 74 69 63 73 20 2a 2f 0a 20 acteristics */.
7c90: 20 69 6e 74 20 6e 53 65 63 74 6f 72 3b 20 20 20 int nSector;
7ca0: 20 20 20 2f 2a 20 53 65 63 74 6f 72 20 73 69 7a /* Sector siz
7cb0: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 e */. int nPage
7cc0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 ; /* Page
7cd0: 20 73 69 7a 65 20 2a 2f 0a 20 20 73 71 6c 69 74 size */. sqlit
7ce0: 65 33 5f 66 69 6c 65 20 2a 66 64 20 3d 20 70 50 e3_file *fd = pP
7cf0: 61 67 65 72 2d 3e 66 64 3b 0a 0a 20 20 69 66 28 ager->fd;.. if(
7d00: 20 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b fd->pMethods ){
7d10: 0a 20 20 20 20 64 63 20 3d 20 73 71 6c 69 74 65 . dc = sqlite
7d20: 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 3OsDeviceCharact
7d30: 65 72 69 73 74 69 63 73 28 66 64 29 3b 0a 20 20 eristics(fd);.
7d40: 20 20 6e 53 65 63 74 6f 72 20 3d 20 73 71 6c 69 nSector = sqli
7d50: 74 65 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 te3OsSectorSize(
7d60: 66 64 29 3b 0a 20 20 20 20 6e 50 61 67 65 20 3d fd);. nPage =
7d70: 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
7d80: 65 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 e;. }.. assert
7d90: 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 (SQLITE_IOCAP_AT
7da0: 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e 38 OMIC512==(512>>8
7db0: 29 29 3b 0a 20 20 61 73 73 65 72 74 28 53 51 4c ));. assert(SQL
7dc0: 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 43 ITE_IOCAP_ATOMIC
7dd0: 36 34 4b 3d 3d 28 36 35 35 33 36 3e 3e 38 29 29 64K==(65536>>8))
7de0: 3b 0a 0a 20 20 69 66 28 20 21 66 64 2d 3e 70 4d ;.. if( !fd->pM
7df0: 65 74 68 6f 64 73 20 7c 7c 20 28 64 63 26 28 53 ethods || (dc&(S
7e00: 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d QLITE_IOCAP_ATOM
7e10: 49 43 7c 28 6e 50 61 67 65 3e 3e 38 29 29 26 26 IC|(nPage>>8))&&
7e20: 6e 53 65 63 74 6f 72 3c 3d 6e 50 61 67 65 29 20 nSector<=nPage)
7e30: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 4a 4f ){. return JO
7e40: 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 URNAL_HDR_SZ(pPa
7e50: 67 65 72 29 20 2b 20 4a 4f 55 52 4e 41 4c 5f 50 ger) + JOURNAL_P
7e60: 47 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a 20 20 G_SZ(pPager);.
7e70: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a }. return 0;.}.
7e80: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
7e90: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 is function shou
7ea0: 6c 64 20 62 65 20 63 61 6c 6c 65 64 20 77 68 65 ld be called whe
7eb0: 6e 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 n an error occur
7ec0: 73 20 77 69 74 68 69 6e 20 74 68 65 20 70 61 67 s within the pag
7ed0: 65 72 0a 2a 2a 20 63 6f 64 65 2e 20 54 68 65 20 er.** code. The
7ee0: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69 first argument i
7ef0: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 s a pointer to t
7f00: 68 65 20 70 61 67 65 72 20 73 74 72 75 63 74 75 he pager structu
7f10: 72 65 2c 20 74 68 65 0a 2a 2a 20 73 65 63 6f 6e re, the.** secon
7f20: 64 20 74 68 65 20 65 72 72 6f 72 2d 63 6f 64 65 d the error-code
7f30: 20 61 62 6f 75 74 20 74 6f 20 62 65 20 72 65 74 about to be ret
7f40: 75 72 6e 65 64 20 62 79 20 61 20 70 61 67 65 72 urned by a pager
7f50: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 2e 20 0a API function. .
7f60: 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 72 65 74 ** The value ret
7f70: 75 72 6e 65 64 20 69 73 20 61 20 63 6f 70 79 20 urned is a copy
7f80: 6f 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 of the second ar
7f90: 67 75 6d 65 6e 74 20 74 6f 20 74 68 69 73 20 66 gument to this f
7fa0: 75 6e 63 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20 unction. .**.**
7fb0: 49 66 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 If the second ar
7fc0: 67 75 6d 65 6e 74 20 69 73 20 53 51 4c 49 54 45 gument is SQLITE
7fd0: 5f 49 4f 45 52 52 2c 20 53 51 4c 49 54 45 5f 43 _IOERR, SQLITE_C
7fe0: 4f 52 52 55 50 54 2c 20 6f 72 20 53 51 4c 49 54 ORRUPT, or SQLIT
7ff0: 45 5f 46 55 4c 4c 0a 2a 2a 20 74 68 65 20 65 72 E_FULL.** the er
8000: 72 6f 72 20 62 65 63 6f 6d 65 73 20 70 65 72 73 ror becomes pers
8010: 69 73 74 65 6e 74 2e 20 55 6e 74 69 6c 20 74 68 istent. Until th
8020: 65 20 70 65 72 73 69 73 74 65 6e 20 65 72 72 6f e persisten erro
8030: 72 20 69 73 20 63 6c 65 61 72 65 64 2c 0a 2a 2a r is cleared,.**
8040: 20 73 75 62 73 65 71 75 65 6e 74 20 41 50 49 20 subsequent API
8050: 63 61 6c 6c 73 20 6f 6e 20 74 68 69 73 20 50 61 calls on this Pa
8060: 67 65 72 20 77 69 6c 6c 20 69 6d 6d 65 64 69 61 ger will immedia
8070: 74 65 6c 79 20 72 65 74 75 72 6e 20 74 68 65 20 tely return the
8080: 73 61 6d 65 20 0a 2a 2a 20 65 72 72 6f 72 20 63 same .** error c
8090: 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 70 65 72 ode..**.** A per
80a0: 73 69 73 74 65 6e 74 20 65 72 72 6f 72 20 69 6e sistent error in
80b0: 64 69 63 61 74 65 73 20 74 68 61 74 20 74 68 65 dicates that the
80c0: 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
80d0: 20 70 61 67 65 72 2d 63 61 63 68 65 20 0a 2a 2a pager-cache .**
80e0: 20 63 61 6e 6e 6f 74 20 62 65 20 74 72 75 73 74 cannot be trust
80f0: 65 64 2e 20 54 68 69 73 20 73 74 61 74 65 20 63 ed. This state c
8100: 61 6e 20 62 65 20 63 6c 65 61 72 65 64 20 62 79 an be cleared by
8110: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69 73 63 completely disc
8120: 61 72 64 69 6e 67 20 0a 2a 2a 20 74 68 65 20 63 arding .** the c
8130: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 ontents of the p
8140: 61 67 65 72 2d 63 61 63 68 65 2e 20 49 66 20 61 ager-cache. If a
8150: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 transaction was
8160: 20 61 63 74 69 76 65 20 77 68 65 6e 0a 2a 2a 20 active when.**
8170: 74 68 65 20 70 65 72 73 69 73 74 65 6e 74 20 65 the persistent e
8180: 72 72 6f 72 20 6f 63 63 75 72 65 64 2c 20 74 68 rror occured, th
8190: 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 en the rollback
81a0: 6a 6f 75 72 6e 61 6c 20 6d 61 79 20 6e 65 65 64 journal may need
81b0: 0a 2a 2a 20 74 6f 20 62 65 20 72 65 70 6c 61 79 .** to be replay
81c0: 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f ed..*/.static vo
81d0: 69 64 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 id pager_unlock(
81e0: 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 3b 0a Pager *pPager);.
81f0: 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
8200: 5f 65 72 72 6f 72 28 50 61 67 65 72 20 2a 70 50 _error(Pager *pP
8210: 61 67 65 72 2c 20 69 6e 74 20 72 63 29 7b 0a 20 ager, int rc){.
8220: 20 69 6e 74 20 72 63 32 20 3d 20 72 63 20 26 20 int rc2 = rc &
8230: 30 78 66 66 3b 0a 20 20 61 73 73 65 72 74 28 0a 0xff;. assert(.
8240: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 pPager->e
8250: 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 46 rrCode==SQLITE_F
8260: 55 4c 4c 20 7c 7c 0a 20 20 20 20 20 20 20 70 50 ULL ||. pP
8270: 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 ager->errCode==S
8280: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 20 QLITE_OK ||.
8290: 20 20 20 28 70 50 61 67 65 72 2d 3e 65 72 72 43 (pPager->errC
82a0: 6f 64 65 20 26 20 30 78 66 66 29 3d 3d 53 51 4c ode & 0xff)==SQL
82b0: 49 54 45 5f 49 4f 45 52 52 0a 20 20 29 3b 0a 20 ITE_IOERR. );.
82c0: 20 69 66 28 0a 20 20 20 20 72 63 32 3d 3d 53 51 if(. rc2==SQ
82d0: 4c 49 54 45 5f 46 55 4c 4c 20 7c 7c 0a 20 20 20 LITE_FULL ||.
82e0: 20 72 63 32 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 rc2==SQLITE_IOE
82f0: 52 52 20 7c 7c 0a 20 20 20 20 72 63 32 3d 3d 53 RR ||. rc2==S
8300: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 0a 20 20 QLITE_CORRUPT.
8310: 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 ){. pPager->e
8320: 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20 20 rrCode = rc;.
8330: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 if( pPager->sta
8340: 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b te==PAGER_UNLOCK
8350: 20 26 26 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 && pPager->nRef
8360: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 ==0 ){. /*
8370: 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 If the pager is
8380: 61 6c 72 65 61 64 79 20 75 6e 6c 6f 63 6b 65 64 already unlocked
8390: 2c 20 63 61 6c 6c 20 70 61 67 65 72 5f 75 6e 6c , call pager_unl
83a0: 6f 63 6b 28 29 20 6e 6f 77 20 74 6f 0a 20 20 20 ock() now to.
83b0: 20 20 20 2a 2a 20 63 6c 65 61 72 20 74 68 65 20 ** clear the
83c0: 65 72 72 6f 72 20 73 74 61 74 65 20 61 6e 64 20 error state and
83d0: 65 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 20 ensure that the
83e0: 70 61 67 65 72 2d 63 61 63 68 65 20 69 73 20 0a pager-cache is .
83f0: 20 20 20 20 20 20 2a 2a 20 63 6f 6d 70 6c 65 74 ** complet
8400: 65 6c 79 20 65 6d 70 74 79 2e 0a 20 20 20 20 20 ely empty..
8410: 20 2a 2f 0a 20 20 20 20 20 20 70 61 67 65 72 5f */. pager_
8420: 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a unlock(pPager);.
8430: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
8440: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
8450: 49 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f If SQLITE_CHECK_
8460: 50 41 47 45 53 20 69 73 20 64 65 66 69 6e 65 64 PAGES is defined
8470: 20 74 68 65 6e 20 77 65 20 64 6f 20 73 6f 6d 65 then we do some
8480: 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 sanity checking
8490: 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 61 63 68 65 .** on the cache
84a0: 20 75 73 69 6e 67 20 61 20 68 61 73 68 20 66 75 using a hash fu
84b0: 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 73 nction. This is
84c0: 20 75 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e used for testin
84d0: 67 0a 2a 2a 20 61 6e 64 20 64 65 62 75 67 67 69 g.** and debuggi
84e0: 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 69 66 64 ng only..*/.#ifd
84f0: 65 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f ef SQLITE_CHECK_
8500: 50 41 47 45 53 0a 2f 2a 0a 2a 2a 20 52 65 74 75 PAGES./*.** Retu
8510: 72 6e 20 61 20 33 32 2d 62 69 74 20 68 61 73 68 rn a 32-bit hash
8520: 20 6f 66 20 74 68 65 20 70 61 67 65 20 64 61 74 of the page dat
8530: 61 20 66 6f 72 20 70 50 61 67 65 2e 0a 2a 2f 0a a for pPage..*/.
8540: 73 74 61 74 69 63 20 75 33 32 20 70 61 67 65 72 static u32 pager
8550: 5f 64 61 74 61 68 61 73 68 28 69 6e 74 20 6e 42 _datahash(int nB
8560: 79 74 65 2c 20 75 6e 73 69 67 6e 65 64 20 63 68 yte, unsigned ch
8570: 61 72 20 2a 70 44 61 74 61 29 7b 0a 20 20 75 33 ar *pData){. u3
8580: 32 20 68 61 73 68 20 3d 20 30 3b 0a 20 20 69 6e 2 hash = 0;. in
8590: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 t i;. for(i=0;
85a0: 69 3c 6e 42 79 74 65 3b 20 69 2b 2b 29 7b 0a 20 i<nByte; i++){.
85b0: 20 20 20 68 61 73 68 20 3d 20 28 68 61 73 68 2a hash = (hash*
85c0: 31 30 33 39 29 20 2b 20 70 44 61 74 61 5b 69 5d 1039) + pData[i]
85d0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 68 ;. }. return h
85e0: 61 73 68 3b 0a 7d 0a 73 74 61 74 69 63 20 75 33 ash;.}.static u3
85f0: 32 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 68 2 pager_pagehash
8600: 28 50 67 48 64 72 20 2a 70 50 61 67 65 29 7b 0a (PgHdr *pPage){.
8610: 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f 64 return pager_d
8620: 61 74 61 68 61 73 68 28 70 50 61 67 65 2d 3e 70 atahash(pPage->p
8630: 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c Pager->pageSize,
8640: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
8650: 20 20 20 20 20 20 20 20 20 20 28 75 6e 73 69 67 (unsig
8660: 6e 65 64 20 63 68 61 72 20 2a 29 50 47 48 44 52 ned char *)PGHDR
8670: 5f 54 4f 5f 44 41 54 41 28 70 50 61 67 65 29 29 _TO_DATA(pPage))
8680: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 43 ;.}../*.** The C
8690: 48 45 43 4b 5f 50 41 47 45 20 6d 61 63 72 6f 20 HECK_PAGE macro
86a0: 74 61 6b 65 73 20 61 20 50 67 48 64 72 2a 20 61 takes a PgHdr* a
86b0: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 49 s an argument. I
86c0: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 f SQLITE_CHECK_P
86d0: 41 47 45 53 0a 2a 2a 20 69 73 20 64 65 66 69 6e AGES.** is defin
86e0: 65 64 2c 20 61 6e 64 20 4e 44 45 42 55 47 20 69 ed, and NDEBUG i
86f0: 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 2c 20 61 s not defined, a
8700: 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
8710: 6d 65 6e 74 20 63 68 65 63 6b 73 0a 2a 2a 20 74 ment checks.** t
8720: 68 61 74 20 74 68 65 20 70 61 67 65 20 69 73 20 hat the page is
8730: 65 69 74 68 65 72 20 64 69 72 74 79 20 6f 72 20 either dirty or
8740: 73 74 69 6c 6c 20 6d 61 74 63 68 65 73 20 74 68 still matches th
8750: 65 20 63 61 6c 63 75 6c 61 74 65 64 20 70 61 67 e calculated pag
8760: 65 2d 68 61 73 68 2e 0a 2a 2f 0a 23 64 65 66 69 e-hash..*/.#defi
8770: 6e 65 20 43 48 45 43 4b 5f 50 41 47 45 28 78 29 ne CHECK_PAGE(x)
8780: 20 63 68 65 63 6b 50 61 67 65 28 78 29 0a 73 74 checkPage(x).st
8790: 61 74 69 63 20 76 6f 69 64 20 63 68 65 63 6b 50 atic void checkP
87a0: 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b age(PgHdr *pPg){
87b0: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
87c0: 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
87d0: 20 20 61 73 73 65 72 74 28 20 21 70 50 67 2d 3e assert( !pPg->
87e0: 70 61 67 65 48 61 73 68 20 7c 7c 20 70 50 61 67 pageHash || pPag
87f0: 65 72 2d 3e 65 72 72 43 6f 64 65 20 7c 7c 20 4d er->errCode || M
8800: 45 4d 44 42 20 7c 7c 20 70 50 67 2d 3e 64 69 72 EMDB || pPg->dir
8810: 74 79 20 7c 7c 20 0a 20 20 20 20 20 20 70 50 67 ty || . pPg
8820: 2d 3e 70 61 67 65 48 61 73 68 3d 3d 70 61 67 65 ->pageHash==page
8830: 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 20 r_pagehash(pPg)
8840: 29 3b 0a 7d 0a 0a 23 65 6c 73 65 0a 23 64 65 66 );.}..#else.#def
8850: 69 6e 65 20 70 61 67 65 72 5f 64 61 74 61 68 61 ine pager_dataha
8860: 73 68 28 58 2c 59 29 20 20 30 0a 23 64 65 66 69 sh(X,Y) 0.#defi
8870: 6e 65 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 ne pager_pagehas
8880: 68 28 58 29 20 20 30 0a 23 64 65 66 69 6e 65 20 h(X) 0.#define
8890: 43 48 45 43 4b 5f 50 41 47 45 28 78 29 0a 23 65 CHECK_PAGE(x).#e
88a0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e ndif../*.** When
88b0: 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 this is called
88c0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
88d0: 20 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65 for pager pPage
88e0: 72 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 2e 0a r must be open..
88f0: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 6a 6f ** The master jo
8900: 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 urnal file name
8910: 69 73 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 is read from the
8920: 20 65 6e 64 20 6f 66 20 74 68 65 20 66 69 6c 65 end of the file
8930: 20 61 6e 64 20 0a 2a 2a 20 77 72 69 74 74 65 6e and .** written
8940: 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 73 75 70 into memory sup
8950: 70 6c 69 65 64 20 62 79 20 74 68 65 20 63 61 6c plied by the cal
8960: 6c 65 72 2e 20 0a 2a 2a 0a 2a 2a 20 7a 4d 61 73 ler. .**.** zMas
8970: 74 65 72 20 6d 75 73 74 20 70 6f 69 6e 74 20 74 ter must point t
8980: 6f 20 61 20 62 75 66 66 65 72 20 6f 66 20 61 74 o a buffer of at
8990: 20 6c 65 61 73 74 20 6e 4d 61 73 74 65 72 20 62 least nMaster b
89a0: 79 74 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 62 ytes allocated b
89b0: 79 0a 2a 2a 20 74 68 65 20 63 61 6c 6c 65 72 2e y.** the caller.
89c0: 20 54 68 69 73 20 73 68 6f 75 6c 64 20 62 65 20 This should be
89d0: 73 71 6c 69 74 65 33 5f 76 66 73 2e 6d 78 50 61 sqlite3_vfs.mxPa
89e0: 74 68 6e 61 6d 65 2b 31 20 28 74 6f 20 65 6e 73 thname+1 (to ens
89f0: 75 72 65 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 ure there is.**
8a00: 65 6e 6f 75 67 68 20 73 70 61 63 65 20 74 6f 20 enough space to
8a10: 77 72 69 74 65 20 74 68 65 20 6d 61 73 74 65 72 write the master
8a20: 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 29 2e 20 journal name).
8a30: 49 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f If the master jo
8a40: 75 72 6e 61 6c 0a 2a 2a 20 6e 61 6d 65 20 69 6e urnal.** name in
8a50: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 the journal is
8a60: 6c 6f 6e 67 65 72 20 74 68 61 6e 20 6e 4d 61 73 longer than nMas
8a70: 74 65 72 20 62 79 74 65 73 20 28 69 6e 63 6c 75 ter bytes (inclu
8a80: 64 69 6e 67 20 61 0a 2a 2a 20 6e 75 6c 2d 74 65 ding a.** nul-te
8a90: 72 6d 69 6e 61 74 6f 72 29 2c 20 74 68 65 6e 20 rminator), then
8aa0: 74 68 69 73 20 69 73 20 68 61 6e 64 6c 65 64 20 this is handled
8ab0: 61 73 20 69 66 20 6e 6f 20 6d 61 73 74 65 72 20 as if no master
8ac0: 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 0a 2a 2a 20 journal name.**
8ad0: 77 65 72 65 20 70 72 65 73 65 6e 74 20 69 6e 20 were present in
8ae0: 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a the journal..**.
8af0: 2a 2a 20 49 66 20 6e 6f 20 6d 61 73 74 65 72 20 ** If no master
8b00: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d journal file nam
8b10: 65 20 69 73 20 70 72 65 73 65 6e 74 20 7a 4d 61 e is present zMa
8b20: 73 74 65 72 5b 30 5d 20 69 73 20 73 65 74 20 74 ster[0] is set t
8b30: 6f 20 30 20 61 6e 64 0a 2a 2a 20 53 51 4c 49 54 o 0 and.** SQLIT
8b40: 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 2e 0a 2a E_OK returned..*
8b50: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 72 65 61 /.static int rea
8b60: 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 73 dMasterJournal(s
8b70: 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 72 qlite3_file *pJr
8b80: 6e 6c 2c 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 nl, char *zMaste
8b90: 72 2c 20 69 6e 74 20 6e 4d 61 73 74 65 72 29 7b r, int nMaster){
8ba0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 32 . int rc;. u32
8bb0: 20 6c 65 6e 3b 0a 20 20 69 36 34 20 73 7a 4a 3b len;. i64 szJ;
8bc0: 0a 20 20 75 33 32 20 63 6b 73 75 6d 3b 0a 20 20 . u32 cksum;.
8bd0: 69 6e 74 20 69 3b 0a 20 20 75 6e 73 69 67 6e 65 int i;. unsigne
8be0: 64 20 63 68 61 72 20 61 4d 61 67 69 63 5b 38 5d d char aMagic[8]
8bf0: 3b 20 2f 2a 20 41 20 62 75 66 66 65 72 20 74 6f ; /* A buffer to
8c00: 20 68 6f 6c 64 20 74 68 65 20 6d 61 67 69 63 20 hold the magic
8c10: 68 65 61 64 65 72 20 2a 2f 0a 0a 20 20 7a 4d 61 header */.. zMa
8c20: 73 74 65 72 5b 30 5d 20 3d 20 27 5c 30 27 3b 0a ster[0] = '\0';.
8c30: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f . rc = sqlite3O
8c40: 73 46 69 6c 65 53 69 7a 65 28 70 4a 72 6e 6c 2c sFileSize(pJrnl,
8c50: 20 26 73 7a 4a 29 3b 0a 20 20 69 66 28 20 72 63 &szJ);. if( rc
8c60: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 !=SQLITE_OK || s
8c70: 7a 4a 3c 31 36 20 29 20 72 65 74 75 72 6e 20 72 zJ<16 ) return r
8c80: 63 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 c;.. rc = read3
8c90: 32 62 69 74 73 28 70 4a 72 6e 6c 2c 20 73 7a 4a 2bits(pJrnl, szJ
8ca0: 2d 31 36 2c 20 26 6c 65 6e 29 3b 0a 20 20 69 66 -16, &len);. if
8cb0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
8cc0: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 ) return rc;..
8cd0: 69 66 28 20 6c 65 6e 3e 3d 6e 4d 61 73 74 65 72 if( len>=nMaster
8ce0: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 ){. return S
8cf0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 QLITE_OK;. }..
8d00: 20 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 rc = read32bits
8d10: 28 70 4a 72 6e 6c 2c 20 73 7a 4a 2d 31 32 2c 20 (pJrnl, szJ-12,
8d20: 26 63 6b 73 75 6d 29 3b 0a 20 20 69 66 28 20 72 &cksum);. if( r
8d30: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 c!=SQLITE_OK ) r
8d40: 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 72 63 20 eturn rc;.. rc
8d50: 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 = sqlite3OsRead(
8d60: 70 4a 72 6e 6c 2c 20 61 4d 61 67 69 63 2c 20 38 pJrnl, aMagic, 8
8d70: 2c 20 73 7a 4a 2d 38 29 3b 0a 20 20 69 66 28 20 , szJ-8);. if(
8d80: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc!=SQLITE_OK ||
8d90: 20 6d 65 6d 63 6d 70 28 61 4d 61 67 69 63 2c 20 memcmp(aMagic,
8da0: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 38 aJournalMagic, 8
8db0: 29 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a ) ) return rc;..
8dc0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
8dd0: 52 65 61 64 28 70 4a 72 6e 6c 2c 20 7a 4d 61 73 Read(pJrnl, zMas
8de0: 74 65 72 2c 20 6c 65 6e 2c 20 73 7a 4a 2d 31 36 ter, len, szJ-16
8df0: 2d 6c 65 6e 29 3b 0a 20 20 69 66 28 20 72 63 21 -len);. if( rc!
8e00: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
8e10: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d return rc;. }
8e20: 0a 20 20 7a 4d 61 73 74 65 72 5b 6c 65 6e 5d 20 . zMaster[len]
8e30: 3d 20 27 5c 30 27 3b 0a 0a 20 20 2f 2a 20 53 65 = '\0';.. /* Se
8e40: 65 20 69 66 20 74 68 65 20 63 68 65 63 6b 73 75 e if the checksu
8e50: 6d 20 6d 61 74 63 68 65 73 20 74 68 65 20 6d 61 m matches the ma
8e60: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster journal nam
8e70: 65 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 e */. for(i=0;
8e80: 69 3c 6c 65 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 i<len; i++){.
8e90: 20 63 6b 73 75 6d 20 2d 3d 20 7a 4d 61 73 74 65 cksum -= zMaste
8ea0: 72 5b 69 5d 3b 0a 20 20 20 7d 0a 20 20 69 66 28 r[i];. }. if(
8eb0: 20 63 6b 73 75 6d 20 29 7b 0a 20 20 20 20 2f 2a cksum ){. /*
8ec0: 20 49 66 20 74 68 65 20 63 68 65 63 6b 73 75 6d If the checksum
8ed0: 20 64 6f 65 73 6e 27 74 20 61 64 64 20 75 70 2c doesn't add up,
8ee0: 20 74 68 65 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 then one or mor
8ef0: 65 20 6f 66 20 74 68 65 20 64 69 73 6b 20 73 65 e of the disk se
8f00: 63 74 6f 72 73 0a 20 20 20 20 2a 2a 20 63 6f 6e ctors. ** con
8f10: 74 61 69 6e 69 6e 67 20 74 68 65 20 6d 61 73 74 taining the mast
8f20: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 6e er journal filen
8f30: 61 6d 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 ame is corrupted
8f40: 2e 20 54 68 69 73 20 6d 65 61 6e 73 0a 20 20 20 . This means.
8f50: 20 2a 2a 20 64 65 66 69 6e 69 74 65 6c 79 20 72 ** definitely r
8f60: 6f 6c 6c 20 62 61 63 6b 2c 20 73 6f 20 6a 75 73 oll back, so jus
8f70: 74 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f t return SQLITE_
8f80: 4f 4b 20 61 6e 64 20 72 65 70 6f 72 74 20 61 20 OK and report a
8f90: 28 6e 75 6c 29 0a 20 20 20 20 2a 2a 20 6d 61 73 (nul). ** mas
8fa0: 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter-journal file
8fb0: 6e 61 6d 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 name.. */.
8fc0: 20 7a 4d 61 73 74 65 72 5b 30 5d 20 3d 20 27 5c zMaster[0] = '\
8fd0: 30 27 3b 0a 20 20 7d 0a 20 20 20 0a 20 20 72 65 0';. }. . re
8fe0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
8ff0: 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 65 6b 20 74 68 }../*.** Seek th
9000: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 e journal file d
9010: 65 73 63 72 69 70 74 6f 72 20 74 6f 20 74 68 65 escriptor to the
9020: 20 6e 65 78 74 20 73 65 63 74 6f 72 20 62 6f 75 next sector bou
9030: 6e 64 61 72 79 20 77 68 65 72 65 20 61 0a 2a 2a ndary where a.**
9040: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 journal header
9050: 6d 61 79 20 62 65 20 72 65 61 64 20 6f 72 20 77 may be read or w
9060: 72 69 74 74 65 6e 2e 20 50 61 67 65 72 2e 6a 6f ritten. Pager.jo
9070: 75 72 6e 61 6c 4f 66 66 20 69 73 20 75 70 64 61 urnalOff is upda
9080: 74 65 64 20 77 69 74 68 0a 2a 2a 20 74 68 65 20 ted with.** the
9090: 6e 65 77 20 73 65 65 6b 20 6f 66 66 73 65 74 2e new seek offset.
90a0: 0a 2a 2a 0a 2a 2a 20 69 2e 65 20 66 6f 72 20 61 .**.** i.e for a
90b0: 20 73 65 63 74 6f 72 20 73 69 7a 65 20 6f 66 20 sector size of
90c0: 35 31 32 3a 0a 2a 2a 0a 2a 2a 20 49 6e 70 75 74 512:.**.** Input
90d0: 20 4f 66 66 73 65 74 20 20 20 20 20 20 20 20 20 Offset
90e0: 20 20 20 20 20 4f 75 74 70 75 74 20 4f 66 66 73 Output Offs
90f0: 65 74 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d et.** ----------
9100: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
9110: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a -------------.**
9120: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
9130: 20 20 20 20 20 20 20 20 20 20 20 30 0a 2a 2a 20 0.**
9140: 35 31 32 20 20 20 20 20 20 20 20 20 20 20 20 20 512
9150: 20 20 20 20 20 20 20 20 20 20 35 31 32 0a 2a 2a 512.**
9160: 20 31 30 30 20 20 20 20 20 20 20 20 20 20 20 20 100
9170: 20 20 20 20 20 20 20 20 20 20 20 35 31 32 0a 2a 512.*
9180: 2a 20 32 30 30 30 20 20 20 20 20 20 20 20 20 20 * 2000
9190: 20 20 20 20 20 20 20 20 20 20 20 20 32 30 34 38 2048
91a0: 0a 2a 2a 20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 .** .*/.static v
91b0: 6f 69 64 20 73 65 65 6b 4a 6f 75 72 6e 61 6c 48 oid seekJournalH
91c0: 64 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 dr(Pager *pPager
91d0: 29 7b 0a 20 20 69 36 34 20 6f 66 66 73 65 74 20 ){. i64 offset
91e0: 3d 20 30 3b 0a 20 20 69 36 34 20 63 20 3d 20 70 = 0;. i64 c = p
91f0: 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
9200: 66 3b 0a 20 20 69 66 28 20 63 20 29 7b 0a 20 20 f;. if( c ){.
9210: 20 20 6f 66 66 73 65 74 20 3d 20 28 28 63 2d 31 offset = ((c-1
9220: 29 2f 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a )/JOURNAL_HDR_SZ
9230: 28 70 50 61 67 65 72 29 20 2b 20 31 29 20 2a 20 (pPager) + 1) *
9240: 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 JOURNAL_HDR_SZ(p
9250: 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 61 73 Pager);. }. as
9260: 73 65 72 74 28 20 6f 66 66 73 65 74 25 4a 4f 55 sert( offset%JOU
9270: 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 RNAL_HDR_SZ(pPag
9280: 65 72 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 er)==0 );. asse
9290: 72 74 28 20 6f 66 66 73 65 74 3e 3d 63 20 29 3b rt( offset>=c );
92a0: 0a 20 20 61 73 73 65 72 74 28 20 28 6f 66 66 73 . assert( (offs
92b0: 65 74 2d 63 29 3c 4a 4f 55 52 4e 41 4c 5f 48 44 et-c)<JOURNAL_HD
92c0: 52 5f 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a R_SZ(pPager) );.
92d0: 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
92e0: 6c 4f 66 66 20 3d 20 6f 66 66 73 65 74 3b 0a 7d lOff = offset;.}
92f0: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 7a 65 ../*.** Write ze
9300: 72 6f 73 20 6f 76 65 72 20 74 68 65 20 68 65 61 ros over the hea
9310: 64 65 72 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e der of the journ
9320: 61 6c 20 66 69 6c 65 2e 20 20 54 68 69 73 20 68 al file. This h
9330: 61 73 20 74 68 65 0a 2a 2a 20 65 66 66 65 63 74 as the.** effect
9340: 20 6f 66 20 69 6e 76 61 6c 69 64 61 74 69 6e 67 of invalidating
9350: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
9360: 65 20 61 6e 64 20 63 6f 6d 6d 69 74 74 69 6e 67 e and committing
9370: 20 74 68 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 the.** transact
9380: 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ion..*/.static i
9390: 6e 74 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 64 nt zeroJournalHd
93a0: 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 r(Pager *pPager)
93b0: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 74 {. int rc;. st
93c0: 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 atic const char
93d0: 7a 65 72 6f 48 64 72 5b 32 38 5d 3b 0a 0a 20 20 zeroHdr[28];..
93e0: 49 4f 54 52 41 43 45 28 28 22 4a 5a 45 52 4f 48 IOTRACE(("JZEROH
93f0: 44 52 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 DR %p\n", pPager
9400: 29 29 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 )). rc = sqlite
9410: 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3OsWrite(pPager-
9420: 3e 6a 66 64 2c 20 7a 65 72 6f 48 64 72 2c 20 73 >jfd, zeroHdr, s
9430: 69 7a 65 6f 66 28 7a 65 72 6f 48 64 72 29 2c 20 izeof(zeroHdr),
9440: 30 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 0);. if( rc==SQ
9450: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
9460: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e c = sqlite3OsSyn
9470: 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 53 c(pPager->jfd, S
9480: 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 54 41 4f QLITE_SYNC_DATAO
9490: 4e 4c 59 20 7c 20 70 50 61 67 65 72 2d 3e 73 79 NLY | pPager->sy
94a0: 6e 63 5f 66 6c 61 67 73 29 3b 0a 20 20 7d 0a 20 nc_flags);. }.
94b0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
94c0: 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c *.** The journal
94d0: 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 file must be op
94e0: 65 6e 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 en when this rou
94f0: 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 tine is called.
9500: 41 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 68 65 61 A journal.** hea
9510: 64 65 72 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 der (JOURNAL_HDR
9520: 5f 53 5a 20 62 79 74 65 73 29 20 69 73 20 77 72 _SZ bytes) is wr
9530: 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a itten into the j
9540: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 61 74 20 74 ournal file at t
9550: 68 65 0a 2a 2a 20 63 75 72 72 65 6e 74 20 6c 6f he.** current lo
9560: 63 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 cation..**.** Th
9570: 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 74 68 65 e format for the
9580: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 journal header
9590: 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a is as follows:.*
95a0: 2a 20 2d 20 38 20 62 79 74 65 73 3a 20 4d 61 67 * - 8 bytes: Mag
95b0: 69 63 20 69 64 65 6e 74 69 66 79 69 6e 67 20 6a ic identifying j
95c0: 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 2e 0a 2a ournal format..*
95d0: 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 4e 75 6d * - 4 bytes: Num
95e0: 62 65 72 20 6f 66 20 72 65 63 6f 72 64 73 20 69 ber of records i
95f0: 6e 20 6a 6f 75 72 6e 61 6c 2c 20 6f 72 20 2d 31 n journal, or -1
9600: 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 20 69 73 no-sync mode is
9610: 20 6f 6e 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 on..** - 4 byte
9620: 73 3a 20 52 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 s: Random number
9630: 20 75 73 65 64 20 66 6f 72 20 70 61 67 65 20 68 used for page h
9640: 61 73 68 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 ash..** - 4 byte
9650: 73 3a 20 49 6e 69 74 69 61 6c 20 64 61 74 61 62 s: Initial datab
9660: 61 73 65 20 70 61 67 65 20 63 6f 75 6e 74 2e 0a ase page count..
9670: 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a 20 53 65 ** - 4 bytes: Se
9680: 63 74 6f 72 20 73 69 7a 65 20 75 73 65 64 20 62 ctor size used b
9690: 79 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 y the process th
96a0: 61 74 20 77 72 6f 74 65 20 74 68 69 73 20 6a 6f at wrote this jo
96b0: 75 72 6e 61 6c 2e 0a 2a 2a 20 2d 20 34 20 62 79 urnal..** - 4 by
96c0: 74 65 73 3a 20 44 61 74 61 62 61 73 65 20 70 61 tes: Database pa
96d0: 67 65 20 73 69 7a 65 2e 0a 2a 2a 20 0a 2a 2a 20 ge size..** .**
96e0: 46 6f 6c 6c 6f 77 65 64 20 62 79 20 28 4a 4f 55 Followed by (JOU
96f0: 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 2d 20 32 38 RNAL_HDR_SZ - 28
9700: 29 20 62 79 74 65 73 20 6f 66 20 75 6e 75 73 65 ) bytes of unuse
9710: 64 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74 61 74 d space..*/.stat
9720: 69 63 20 69 6e 74 20 77 72 69 74 65 4a 6f 75 72 ic int writeJour
9730: 6e 61 6c 48 64 72 28 50 61 67 65 72 20 2a 70 50 nalHdr(Pager *pP
9740: 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 ager){. int rc
9750: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 = SQLITE_OK;. c
9760: 68 61 72 20 2a 7a 48 65 61 64 65 72 20 3d 20 70 har *zHeader = p
9770: 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 Pager->pTmpSpace
9780: 3b 0a 20 20 69 6e 74 20 6e 48 65 61 64 65 72 20 ;. int nHeader
9790: 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
97a0: 7a 65 3b 0a 20 20 69 6e 74 20 6e 57 72 69 74 65 ze;. int nWrite
97b0: 3b 0a 0a 20 20 69 66 28 20 6e 48 65 61 64 65 72 ;.. if( nHeader
97c0: 3e 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 >JOURNAL_HDR_SZ(
97d0: 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 6e pPager) ){. n
97e0: 48 65 61 64 65 72 20 3d 20 4a 4f 55 52 4e 41 4c Header = JOURNAL
97f0: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b _HDR_SZ(pPager);
9800: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 . }.. if( pPag
9810: 65 72 2d 3e 73 74 6d 74 48 64 72 4f 66 66 3d 3d er->stmtHdrOff==
9820: 30 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 0 ){. pPager-
9830: 3e 73 74 6d 74 48 64 72 4f 66 66 20 3d 20 70 50 >stmtHdrOff = pP
9840: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
9850: 3b 0a 20 20 7d 0a 0a 20 20 73 65 65 6b 4a 6f 75 ;. }.. seekJou
9860: 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 29 3b rnalHdr(pPager);
9870: 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e . pPager->journ
9880: 61 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d 3e alHdr = pPager->
9890: 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 6d journalOff;.. m
98a0: 65 6d 63 70 79 28 7a 48 65 61 64 65 72 2c 20 61 emcpy(zHeader, a
98b0: 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 JournalMagic, si
98c0: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 zeof(aJournalMag
98d0: 69 63 29 29 3b 0a 0a 20 20 2f 2a 20 0a 20 20 2a ic));.. /* . *
98e0: 2a 20 57 72 69 74 65 20 74 68 65 20 6e 52 65 63 * Write the nRec
98f0: 20 46 69 65 6c 64 20 2d 20 74 68 65 20 6e 75 6d Field - the num
9900: 62 65 72 20 6f 66 20 70 61 67 65 20 72 65 63 6f ber of page reco
9910: 72 64 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 20 rds that follow
9920: 74 68 69 73 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 this. ** journa
9930: 6c 20 68 65 61 64 65 72 2e 20 4e 6f 72 6d 61 6c l header. Normal
9940: 6c 79 2c 20 7a 65 72 6f 20 69 73 20 77 72 69 74 ly, zero is writ
9950: 74 65 6e 20 74 6f 20 74 68 69 73 20 76 61 6c 75 ten to this valu
9960: 65 20 61 74 20 74 68 69 73 20 74 69 6d 65 2e 0a e at this time..
9970: 20 20 2a 2a 20 41 66 74 65 72 20 74 68 65 20 72 ** After the r
9980: 65 63 6f 72 64 73 20 61 72 65 20 61 64 64 65 64 ecords are added
9990: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 to the journal
99a0: 28 61 6e 64 20 74 68 65 20 6a 6f 75 72 6e 61 6c (and the journal
99b0: 20 73 79 6e 63 65 64 2c 20 0a 20 20 2a 2a 20 69 synced, . ** i
99c0: 66 20 69 6e 20 66 75 6c 6c 2d 73 79 6e 63 20 6d f in full-sync m
99d0: 6f 64 65 29 2c 20 74 68 65 20 7a 65 72 6f 20 69 ode), the zero i
99e0: 73 20 6f 76 65 72 77 72 69 74 74 65 6e 20 77 69 s overwritten wi
99f0: 74 68 20 74 68 65 20 74 72 75 65 20 6e 75 6d 62 th the true numb
9a00: 65 72 0a 20 20 2a 2a 20 6f 66 20 72 65 63 6f 72 er. ** of recor
9a10: 64 73 20 28 73 65 65 20 73 79 6e 63 4a 6f 75 72 ds (see syncJour
9a20: 6e 61 6c 28 29 29 2e 0a 20 20 2a 2a 0a 20 20 2a nal()).. **. *
9a30: 2a 20 41 20 66 61 73 74 65 72 20 61 6c 74 65 72 * A faster alter
9a40: 6e 61 74 69 76 65 20 69 73 20 74 6f 20 77 72 69 native is to wri
9a50: 74 65 20 30 78 46 46 46 46 46 46 46 46 20 74 6f te 0xFFFFFFFF to
9a60: 20 74 68 65 20 6e 52 65 63 20 66 69 65 6c 64 2e the nRec field.
9a70: 20 57 68 65 6e 0a 20 20 2a 2a 20 72 65 61 64 69 When. ** readi
9a80: 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74 ng the journal t
9a90: 68 69 73 20 76 61 6c 75 65 20 74 65 6c 6c 73 20 his value tells
9aa0: 53 51 4c 69 74 65 20 74 6f 20 61 73 73 75 6d 65 SQLite to assume
9ab0: 20 74 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 72 that the. ** r
9ac0: 65 73 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e est of the journ
9ad0: 61 6c 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 al file contains
9ae0: 20 76 61 6c 69 64 20 70 61 67 65 20 72 65 63 6f valid page reco
9af0: 72 64 73 2e 20 54 68 69 73 20 61 73 73 75 6d 70 rds. This assump
9b00: 74 69 6f 6e 0a 20 20 2a 2a 20 69 73 20 64 61 6e tion. ** is dan
9b10: 67 65 72 6f 75 73 2c 20 61 73 20 69 66 20 61 20 gerous, as if a
9b20: 66 61 69 6c 75 72 65 20 6f 63 63 75 72 65 64 20 failure occured
9b30: 77 68 69 6c 73 74 20 77 72 69 74 69 6e 67 20 74 whilst writing t
9b40: 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 o the journal.
9b50: 2a 2a 20 66 69 6c 65 20 69 74 20 6d 61 79 20 63 ** file it may c
9b60: 6f 6e 74 61 69 6e 20 73 6f 6d 65 20 67 61 72 62 ontain some garb
9b70: 61 67 65 20 64 61 74 61 2e 20 54 68 65 72 65 20 age data. There
9b80: 61 72 65 20 74 77 6f 20 73 63 65 6e 61 72 69 6f are two scenario
9b90: 73 0a 20 20 2a 2a 20 77 68 65 72 65 20 74 68 69 s. ** where thi
9ba0: 73 20 72 69 73 6b 20 63 61 6e 20 62 65 20 69 67 s risk can be ig
9bb0: 6e 6f 72 65 64 3a 0a 20 20 2a 2a 0a 20 20 2a 2a nored:. **. **
9bc0: 20 20 20 2a 20 57 68 65 6e 20 74 68 65 20 70 61 * When the pa
9bd0: 67 65 72 20 69 73 20 69 6e 20 6e 6f 2d 73 79 6e ger is in no-syn
9be0: 63 20 6d 6f 64 65 2e 20 43 6f 72 72 75 70 74 69 c mode. Corrupti
9bf0: 6f 6e 20 63 61 6e 20 66 6f 6c 6c 6f 77 20 61 0a on can follow a.
9c00: 20 20 2a 2a 20 20 20 20 20 70 6f 77 65 72 20 66 ** power f
9c10: 61 69 6c 75 72 65 20 69 6e 20 74 68 69 73 20 63 ailure in this c
9c20: 61 73 65 20 61 6e 79 77 61 79 2e 0a 20 20 2a 2a ase anyway.. **
9c30: 0a 20 20 2a 2a 20 20 20 2a 20 57 68 65 6e 20 74 . ** * When t
9c40: 68 65 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f he SQLITE_IOCAP_
9c50: 53 41 46 45 5f 41 50 50 45 4e 44 20 66 6c 61 67 SAFE_APPEND flag
9c60: 20 69 73 20 73 65 74 2e 20 54 68 69 73 20 67 75 is set. This gu
9c70: 61 72 61 6e 74 65 65 73 0a 20 20 2a 2a 20 20 20 arantees. **
9c80: 20 20 74 68 61 74 20 67 61 72 62 61 67 65 20 64 that garbage d
9c90: 61 74 61 20 69 73 20 6e 65 76 65 72 20 61 70 70 ata is never app
9ca0: 65 6e 64 65 64 20 74 6f 20 74 68 65 20 6a 6f 75 ended to the jou
9cb0: 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a rnal file.. */.
9cc0: 20 20 61 73 73 65 72 74 28 70 50 61 67 65 72 2d assert(pPager-
9cd0: 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 7c 7c 70 >fd->pMethods||p
9ce0: 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 29 3b 0a Pager->noSync);.
9cf0: 20 20 69 66 28 20 28 70 50 61 67 65 72 2d 3e 6e if( (pPager->n
9d00: 6f 53 79 6e 63 29 20 0a 20 20 20 7c 7c 20 28 73 oSync) . || (s
9d10: 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 qlite3OsDeviceCh
9d20: 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50 aracteristics(pP
9d30: 61 67 65 72 2d 3e 66 64 29 26 53 51 4c 49 54 45 ager->fd)&SQLITE
9d40: 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 _IOCAP_SAFE_APPE
9d50: 4e 44 29 20 0a 20 20 29 7b 0a 20 20 20 20 70 75 ND) . ){. pu
9d60: 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 t32bits(&zHeader
9d70: 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c [sizeof(aJournal
9d80: 4d 61 67 69 63 29 5d 2c 20 30 78 66 66 66 66 66 Magic)], 0xfffff
9d90: 66 66 66 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 fff);. }else{.
9da0: 20 20 20 70 75 74 33 32 62 69 74 73 28 26 7a 48 put32bits(&zH
9db0: 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f eader[sizeof(aJo
9dc0: 75 72 6e 61 6c 4d 61 67 69 63 29 5d 2c 20 30 29 urnalMagic)], 0)
9dd0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 ;. }.. /* The
9de0: 72 61 6e 64 6f 6d 20 63 68 65 63 6b 2d 68 61 73 random check-has
9df0: 68 20 69 6e 69 74 69 61 6c 69 73 65 72 20 2a 2f h initialiser */
9e00: 20 0a 20 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 . sqlite3_rand
9e10: 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 28 70 50 omness(sizeof(pP
9e20: 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 ager->cksumInit)
9e30: 2c 20 26 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d , &pPager->cksum
9e40: 49 6e 69 74 29 3b 0a 20 20 70 75 74 33 32 62 69 Init);. put32bi
9e50: 74 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 ts(&zHeader[size
9e60: 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 of(aJournalMagic
9e70: 29 2b 34 5d 2c 20 70 50 61 67 65 72 2d 3e 63 6b )+4], pPager->ck
9e80: 73 75 6d 49 6e 69 74 29 3b 0a 20 20 2f 2a 20 54 sumInit);. /* T
9e90: 68 65 20 69 6e 69 74 69 61 6c 20 64 61 74 61 62 he initial datab
9ea0: 61 73 65 20 73 69 7a 65 20 2a 2f 0a 20 20 70 75 ase size */. pu
9eb0: 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 t32bits(&zHeader
9ec0: 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c [sizeof(aJournal
9ed0: 4d 61 67 69 63 29 2b 38 5d 2c 20 70 50 61 67 65 Magic)+8], pPage
9ee0: 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 2f 2a r->dbSize);. /*
9ef0: 20 54 68 65 20 61 73 73 75 6d 65 64 20 73 65 63 The assumed sec
9f00: 74 6f 72 20 73 69 7a 65 20 66 6f 72 20 74 68 69 tor size for thi
9f10: 73 20 70 72 6f 63 65 73 73 20 2a 2f 0a 20 20 70 s process */. p
9f20: 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 ut32bits(&zHeade
9f30: 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 r[sizeof(aJourna
9f40: 6c 4d 61 67 69 63 29 2b 31 32 5d 2c 20 70 50 61 lMagic)+12], pPa
9f50: 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 29 ger->sectorSize)
9f60: 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e ;. if( pPager->
9f70: 6a 6f 75 72 6e 61 6c 48 64 72 3d 3d 30 20 29 7b journalHdr==0 ){
9f80: 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 . /* The page
9f90: 20 73 69 7a 65 20 2a 2f 0a 20 20 20 20 70 75 74 size */. put
9fa0: 33 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 32bits(&zHeader[
9fb0: 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d sizeof(aJournalM
9fc0: 61 67 69 63 29 2b 31 36 5d 2c 20 70 50 61 67 65 agic)+16], pPage
9fd0: 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 r->pageSize);.
9fe0: 7d 0a 0a 20 20 66 6f 72 28 6e 57 72 69 74 65 3d }.. for(nWrite=
9ff0: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 0; rc==SQLITE_OK
a000: 26 26 6e 57 72 69 74 65 3c 4a 4f 55 52 4e 41 4c &&nWrite<JOURNAL
a010: 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b _HDR_SZ(pPager);
a020: 20 6e 57 72 69 74 65 2b 3d 6e 48 65 61 64 65 72 nWrite+=nHeader
a030: 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 ){. IOTRACE((
a040: 22 4a 48 44 52 20 25 70 20 25 6c 6c 64 20 25 64 "JHDR %p %lld %d
a050: 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 50 61 \n", pPager, pPa
a060: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 2c ger->journalHdr,
a070: 20 6e 48 65 61 64 65 72 29 29 0a 20 20 20 20 72 nHeader)). r
a080: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 c = sqlite3OsWri
a090: 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 te(pPager->jfd,
a0a0: 7a 48 65 61 64 65 72 2c 20 6e 48 65 61 64 65 72 zHeader, nHeader
a0b0: 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 , pPager->journa
a0c0: 6c 4f 66 66 29 3b 0a 20 20 20 20 70 50 61 67 65 lOff);. pPage
a0d0: 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d r->journalOff +=
a0e0: 20 6e 48 65 61 64 65 72 3b 0a 20 20 7d 0a 0a 20 nHeader;. }..
a0f0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
a100: 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c *.** The journal
a110: 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 file must be op
a120: 65 6e 20 77 68 65 6e 20 74 68 69 73 20 69 73 20 en when this is
a130: 63 61 6c 6c 65 64 2e 20 41 20 6a 6f 75 72 6e 61 called. A journa
a140: 6c 20 68 65 61 64 65 72 20 66 69 6c 65 0a 2a 2a l header file.**
a150: 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a (JOURNAL_HDR_SZ
a160: 20 62 79 74 65 73 29 20 69 73 20 72 65 61 64 20 bytes) is read
a170: 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65 6e 74 from the current
a180: 20 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 location in the
a190: 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 journal.** file
a1a0: 2e 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 61 . See comments a
a1b0: 62 6f 76 65 20 66 75 6e 63 74 69 6f 6e 20 77 72 bove function wr
a1c0: 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 29 20 iteJournalHdr()
a1d0: 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 69 6f for a descriptio
a1e0: 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 n of.** the jour
a1f0: 6e 61 6c 20 68 65 61 64 65 72 20 66 6f 72 6d 61 nal header forma
a200: 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 t..**.** If the
a210: 68 65 61 64 65 72 20 69 73 20 72 65 61 64 20 73 header is read s
a220: 75 63 63 65 73 73 66 75 6c 6c 79 2c 20 2a 6e 52 uccessfully, *nR
a230: 65 63 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 ec is set to the
a240: 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 70 61 number of.** pa
a250: 67 65 20 72 65 63 6f 72 64 73 20 66 6f 6c 6c 6f ge records follo
a260: 77 69 6e 67 20 74 68 69 73 20 68 65 61 64 65 72 wing this header
a270: 20 61 6e 64 20 2a 64 62 53 69 7a 65 20 69 73 20 and *dbSize is
a280: 73 65 74 20 74 6f 20 74 68 65 20 73 69 7a 65 20 set to the size
a290: 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 of the.** databa
a2a0: 73 65 20 62 65 66 6f 72 65 20 74 68 65 20 74 72 se before the tr
a2b0: 61 6e 73 61 63 74 69 6f 6e 20 62 65 67 61 6e 2c ansaction began,
a2c0: 20 69 6e 20 70 61 67 65 73 2e 20 41 6c 73 6f 2c in pages. Also,
a2d0: 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e pPager->cksumIn
a2e0: 69 74 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 it.** is set to
a2f0: 74 68 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 the value read f
a300: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 rom the journal
a310: 68 65 61 64 65 72 2e 20 53 51 4c 49 54 45 5f 4f header. SQLITE_O
a320: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 0a 2a 2a K is returned.**
a330: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a in this case..*
a340: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 *.** If the jour
a350: 6e 61 6c 20 68 65 61 64 65 72 20 66 69 6c 65 20 nal header file
a360: 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 63 6f appears to be co
a370: 72 72 75 70 74 65 64 2c 20 53 51 4c 49 54 45 5f rrupted, SQLITE_
a380: 44 4f 4e 45 20 69 73 0a 2a 2a 20 72 65 74 75 72 DONE is.** retur
a390: 6e 65 64 20 61 6e 64 20 2a 6e 52 65 63 20 61 6e ned and *nRec an
a3a0: 64 20 2a 64 62 53 69 7a 65 20 61 72 65 20 6e 6f d *dbSize are no
a3b0: 74 20 73 65 74 2e 20 20 49 66 20 4a 4f 55 52 4e t set. If JOURN
a3c0: 41 4c 5f 48 44 52 5f 53 5a 20 62 79 74 65 73 0a AL_HDR_SZ bytes.
a3d0: 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 61 ** cannot be rea
a3e0: 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e d from the journ
a3f0: 61 6c 20 66 69 6c 65 20 61 6e 20 65 72 72 6f 72 al file an error
a400: 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
a410: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
a420: 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 readJournalHdr(
a430: 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
a440: 2c 20 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c , . i64 journal
a450: 53 69 7a 65 2c 0a 20 20 75 33 32 20 2a 70 4e 52 Size,. u32 *pNR
a460: 65 63 2c 20 0a 20 20 75 33 32 20 2a 70 44 62 53 ec, . u32 *pDbS
a470: 69 7a 65 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b ize.){. int rc;
a480: 0a 20 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 . unsigned char
a490: 20 61 4d 61 67 69 63 5b 38 5d 3b 20 2f 2a 20 41 aMagic[8]; /* A
a4a0: 20 62 75 66 66 65 72 20 74 6f 20 68 6f 6c 64 20 buffer to hold
a4b0: 74 68 65 20 6d 61 67 69 63 20 68 65 61 64 65 72 the magic header
a4c0: 20 2a 2f 0a 20 20 69 36 34 20 6a 72 6e 6c 4f 66 */. i64 jrnlOf
a4d0: 66 3b 0a 20 20 69 6e 74 20 69 50 61 67 65 53 69 f;. int iPageSi
a4e0: 7a 65 3b 0a 0a 20 20 73 65 65 6b 4a 6f 75 72 6e ze;.. seekJourn
a4f0: 61 6c 48 64 72 28 70 50 61 67 65 72 29 3b 0a 20 alHdr(pPager);.
a500: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 if( pPager->jou
a510: 72 6e 61 6c 4f 66 66 2b 4a 4f 55 52 4e 41 4c 5f rnalOff+JOURNAL_
a520: 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 3e HDR_SZ(pPager) >
a530: 20 6a 6f 75 72 6e 61 6c 53 69 7a 65 20 29 7b 0a journalSize ){.
a540: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
a550: 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 6a 72 E_DONE;. }. jr
a560: 6e 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e nlOff = pPager->
a570: 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 72 journalOff;.. r
a580: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 c = sqlite3OsRea
a590: 64 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61 d(pPager->jfd, a
a5a0: 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4d Magic, sizeof(aM
a5b0: 61 67 69 63 29 2c 20 6a 72 6e 6c 4f 66 66 29 3b agic), jrnlOff);
a5c0: 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75 . if( rc ) retu
a5d0: 72 6e 20 72 63 3b 0a 20 20 6a 72 6e 6c 4f 66 66 rn rc;. jrnlOff
a5e0: 20 2b 3d 20 73 69 7a 65 6f 66 28 61 4d 61 67 69 += sizeof(aMagi
a5f0: 63 29 3b 0a 0a 20 20 69 66 28 20 6d 65 6d 63 6d c);.. if( memcm
a600: 70 28 61 4d 61 67 69 63 2c 20 61 4a 6f 75 72 6e p(aMagic, aJourn
a610: 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 alMagic, sizeof(
a620: 61 4d 61 67 69 63 29 29 21 3d 30 20 29 7b 0a 20 aMagic))!=0 ){.
a630: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
a640: 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 0a 20 20 72 63 _DONE;. }.. rc
a650: 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 50 = read32bits(pP
a660: 61 67 65 72 2d 3e 6a 66 64 2c 20 6a 72 6e 6c 4f ager->jfd, jrnlO
a670: 66 66 2c 20 70 4e 52 65 63 29 3b 0a 20 20 69 66 ff, pNRec);. if
a680: 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
a690: 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32 ;.. rc = read32
a6a0: 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 bits(pPager->jfd
a6b0: 2c 20 6a 72 6e 6c 4f 66 66 2b 34 2c 20 26 70 50 , jrnlOff+4, &pP
a6c0: 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 ager->cksumInit)
a6d0: 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 74 ;. if( rc ) ret
a6e0: 75 72 6e 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20 urn rc;.. rc =
a6f0: 72 65 61 64 33 32 62 69 74 73 28 70 50 61 67 65 read32bits(pPage
a700: 72 2d 3e 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2b r->jfd, jrnlOff+
a710: 38 2c 20 70 44 62 53 69 7a 65 29 3b 0a 20 20 69 8, pDbSize);. i
a720: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 f( rc ) return r
a730: 63 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 c;.. rc = read3
a740: 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 2bits(pPager->jf
a750: 64 2c 20 6a 72 6e 6c 4f 66 66 2b 31 36 2c 20 28 d, jrnlOff+16, (
a760: 75 33 32 20 2a 29 26 69 50 61 67 65 53 69 7a 65 u32 *)&iPageSize
a770: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c );. if( rc==SQL
a780: 49 54 45 5f 4f 4b 20 0a 20 20 20 26 26 20 69 50 ITE_OK . && iP
a790: 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 0a 20 20 ageSize>=512 .
a7a0: 20 26 26 20 69 50 61 67 65 53 69 7a 65 3c 3d 53 && iPageSize<=S
a7b0: 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 5f 53 QLITE_MAX_PAGE_S
a7c0: 49 5a 45 20 0a 20 20 20 26 26 20 28 28 69 50 61 IZE . && ((iPa
a7d0: 67 65 53 69 7a 65 2d 31 29 26 69 50 61 67 65 53 geSize-1)&iPageS
a7e0: 69 7a 65 29 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 ize)==0 . ){.
a7f0: 20 20 75 31 36 20 70 61 67 65 73 69 7a 65 20 3d u16 pagesize =
a800: 20 69 50 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 iPageSize;.
a810: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
a820: 72 53 65 74 50 61 67 65 73 69 7a 65 28 70 50 61 rSetPagesize(pPa
a830: 67 65 72 2c 20 26 70 61 67 65 73 69 7a 65 29 3b ger, &pagesize);
a840: 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 20 29 20 . }. if( rc )
a850: 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 2f 2a return rc;.. /*
a860: 20 55 70 64 61 74 65 20 74 68 65 20 61 73 73 75 Update the assu
a870: 6d 65 64 20 73 65 63 74 6f 72 2d 73 69 7a 65 20 med sector-size
a880: 74 6f 20 6d 61 74 63 68 20 74 68 65 20 76 61 6c to match the val
a890: 75 65 20 75 73 65 64 20 62 79 20 0a 20 20 2a 2a ue used by . **
a8a0: 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 the process tha
a8b0: 74 20 63 72 65 61 74 65 64 20 74 68 69 73 20 6a t created this j
a8c0: 6f 75 72 6e 61 6c 2e 20 49 66 20 74 68 69 73 20 ournal. If this
a8d0: 6a 6f 75 72 6e 61 6c 20 77 61 73 0a 20 20 2a 2a journal was. **
a8e0: 20 63 72 65 61 74 65 64 20 62 79 20 61 20 70 72 created by a pr
a8f0: 6f 63 65 73 73 20 6f 74 68 65 72 20 74 68 61 6e ocess other than
a900: 20 74 68 69 73 20 6f 6e 65 2c 20 74 68 65 6e 20 this one, then
a910: 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 20 20 2a this routine. *
a920: 2a 20 69 73 20 62 65 69 6e 67 20 63 61 6c 6c 65 * is being calle
a930: 64 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 d from within pa
a940: 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 2e 20 ger_playback().
a950: 54 68 65 20 6c 6f 63 61 6c 20 76 61 6c 75 65 0a The local value.
a960: 20 20 2a 2a 20 6f 66 20 50 61 67 65 72 2e 73 65 ** of Pager.se
a970: 63 74 6f 72 53 69 7a 65 20 69 73 20 72 65 73 74 ctorSize is rest
a980: 6f 72 65 64 20 61 74 20 74 68 65 20 65 6e 64 20 ored at the end
a990: 6f 66 20 74 68 61 74 20 72 6f 75 74 69 6e 65 2e of that routine.
a9a0: 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 72 65 61 . */. rc = rea
a9b0: 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e d32bits(pPager->
a9c0: 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2b 31 32 2c jfd, jrnlOff+12,
a9d0: 20 28 75 33 32 20 2a 29 26 70 50 61 67 65 72 2d (u32 *)&pPager-
a9e0: 3e 73 65 63 74 6f 72 53 69 7a 65 29 3b 0a 20 20 >sectorSize);.
a9f0: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 if( rc ) return
aa00: 72 63 3b 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a rc;.. pPager->j
aa10: 6f 75 72 6e 61 6c 4f 66 66 20 2b 3d 20 4a 4f 55 ournalOff += JOU
aa20: 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 RNAL_HDR_SZ(pPag
aa30: 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 er);. return SQ
aa40: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a LITE_OK;.}.../*.
aa50: 2a 2a 20 57 72 69 74 65 20 74 68 65 20 73 75 70 ** Write the sup
aa60: 70 6c 69 65 64 20 6d 61 73 74 65 72 20 6a 6f 75 plied master jou
aa70: 72 6e 61 6c 20 6e 61 6d 65 20 69 6e 74 6f 20 74 rnal name into t
aa80: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
aa90: 66 6f 72 20 70 61 67 65 72 0a 2a 2a 20 70 50 61 for pager.** pPa
aaa0: 67 65 72 20 61 74 20 74 68 65 20 63 75 72 72 65 ger at the curre
aab0: 6e 74 20 6c 6f 63 61 74 69 6f 6e 2e 20 54 68 65 nt location. The
aac0: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
aad0: 6e 61 6d 65 20 6d 75 73 74 20 62 65 20 74 68 65 name must be the
aae0: 20 6c 61 73 74 0a 2a 2a 20 74 68 69 6e 67 20 77 last.** thing w
aaf0: 72 69 74 74 65 6e 20 74 6f 20 61 20 6a 6f 75 72 ritten to a jour
ab00: 6e 61 6c 20 66 69 6c 65 2e 20 49 66 20 74 68 65 nal file. If the
ab10: 20 70 61 67 65 72 20 69 73 20 69 6e 20 66 75 6c pager is in ful
ab20: 6c 2d 73 79 6e 63 20 6d 6f 64 65 2c 20 74 68 65 l-sync mode, the
ab30: 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 .** journal file
ab40: 20 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 61 descriptor is a
ab50: 64 76 61 6e 63 65 64 20 74 6f 20 74 68 65 20 6e dvanced to the n
ab60: 65 78 74 20 73 65 63 74 6f 72 20 62 6f 75 6e 64 ext sector bound
ab70: 61 72 79 20 62 65 66 6f 72 65 0a 2a 2a 20 61 6e ary before.** an
ab80: 79 74 68 69 6e 67 20 69 73 20 77 72 69 74 74 65 ything is writte
ab90: 6e 2e 20 54 68 65 20 66 6f 72 6d 61 74 20 69 73 n. The format is
aba0: 3a 0a 2a 2a 0a 2a 2a 20 2b 20 34 20 62 79 74 65 :.**.** + 4 byte
abb0: 73 3a 20 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f s: PAGER_MJ_PGNO
abc0: 2e 0a 2a 2a 20 2b 20 4e 20 62 79 74 65 73 3a 20 ..** + N bytes:
abd0: 6c 65 6e 67 74 68 20 6f 66 20 6d 61 73 74 65 72 length of master
abe0: 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 2e 0a 2a journal name..*
abf0: 2a 20 2b 20 34 20 62 79 74 65 73 3a 20 4e 0a 2a * + 4 bytes: N.*
ac00: 2a 20 2b 20 34 20 62 79 74 65 73 3a 20 4d 61 73 * + 4 bytes: Mas
ac10: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter journal name
ac20: 20 63 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 2b 20 checksum..** +
ac30: 38 20 62 79 74 65 73 3a 20 61 4a 6f 75 72 6e 61 8 bytes: aJourna
ac40: 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 lMagic[]..**.**
ac50: 54 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e The master journ
ac60: 61 6c 20 70 61 67 65 20 63 68 65 63 6b 73 75 6d al page checksum
ac70: 20 69 73 20 74 68 65 20 73 75 6d 20 6f 66 20 74 is the sum of t
ac80: 68 65 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 he bytes in the
ac90: 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61 master.** journa
aca0: 6c 20 6e 61 6d 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 l name..**.** If
acb0: 20 7a 4d 61 73 74 65 72 20 69 73 20 61 20 4e 55 zMaster is a NU
acc0: 4c 4c 20 70 6f 69 6e 74 65 72 20 28 6f 63 63 75 LL pointer (occu
acd0: 72 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 rs for a single
ace0: 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 database transac
acf0: 74 69 6f 6e 29 2c 20 0a 2a 2a 20 74 68 69 73 20 tion), .** this
ad00: 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e call is a no-op.
ad10: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77 .*/.static int w
ad20: 72 69 74 65 4d 61 73 74 65 72 4a 6f 75 72 6e 61 riteMasterJourna
ad30: 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c l(Pager *pPager,
ad40: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 const char *zMa
ad50: 73 74 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b ster){. int rc;
ad60: 0a 20 20 69 6e 74 20 6c 65 6e 3b 20 0a 20 20 69 . int len; . i
ad70: 6e 74 20 69 3b 20 0a 20 20 69 36 34 20 6a 72 6e nt i; . i64 jrn
ad80: 6c 4f 66 66 3b 0a 20 20 75 33 32 20 63 6b 73 75 lOff;. u32 cksu
ad90: 6d 20 3d 20 30 3b 0a 20 20 63 68 61 72 20 7a 42 m = 0;. char zB
ada0: 75 66 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e uf[sizeof(aJourn
adb0: 61 6c 4d 61 67 69 63 29 2b 32 2a 34 5d 3b 0a 0a alMagic)+2*4];..
adc0: 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 20 7c if( !zMaster |
add0: 7c 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 | pPager->setMas
ade0: 74 65 72 29 20 72 65 74 75 72 6e 20 53 51 4c 49 ter) return SQLI
adf0: 54 45 5f 4f 4b 3b 0a 20 20 70 50 61 67 65 72 2d TE_OK;. pPager-
ae00: 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 31 3b 0a >setMaster = 1;.
ae10: 0a 20 20 6c 65 6e 20 3d 20 73 74 72 6c 65 6e 28 . len = strlen(
ae20: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 66 6f 72 28 zMaster);. for(
ae30: 69 3d 30 3b 20 69 3c 6c 65 6e 3b 20 69 2b 2b 29 i=0; i<len; i++)
ae40: 7b 0a 20 20 20 20 63 6b 73 75 6d 20 2b 3d 20 7a {. cksum += z
ae50: 4d 61 73 74 65 72 5b 69 5d 3b 0a 20 20 7d 0a 0a Master[i];. }..
ae60: 20 20 2f 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d /* If in full-
ae70: 73 79 6e 63 20 6d 6f 64 65 2c 20 61 64 76 61 6e sync mode, advan
ae80: 63 65 20 74 6f 20 74 68 65 20 6e 65 78 74 20 64 ce to the next d
ae90: 69 73 6b 20 73 65 63 74 6f 72 20 62 65 66 6f 72 isk sector befor
aea0: 65 20 77 72 69 74 69 6e 67 0a 20 20 2a 2a 20 74 e writing. ** t
aeb0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
aec0: 6c 20 6e 61 6d 65 2e 20 54 68 69 73 20 69 73 20 l name. This is
aed0: 69 6e 20 63 61 73 65 20 74 68 65 20 70 72 65 76 in case the prev
aee0: 69 6f 75 73 20 70 61 67 65 20 77 72 69 74 74 65 ious page writte
aef0: 6e 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 6a 6f n to. ** the jo
af00: 75 72 6e 61 6c 20 68 61 73 20 61 6c 72 65 61 64 urnal has alread
af10: 79 20 62 65 65 6e 20 73 79 6e 63 65 64 2e 0a 20 y been synced..
af20: 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
af30: 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 ->fullSync ){.
af40: 20 20 73 65 65 6b 4a 6f 75 72 6e 61 6c 48 64 72 seekJournalHdr
af50: 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 (pPager);. }.
af60: 6a 72 6e 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 jrnlOff = pPager
af70: 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 ->journalOff;.
af80: 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
af90: 66 66 20 2b 3d 20 28 6c 65 6e 2b 32 30 29 3b 0a ff += (len+20);.
afa0: 0a 20 20 72 63 20 3d 20 77 72 69 74 65 33 32 62 . rc = write32b
afb0: 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c its(pPager->jfd,
afc0: 20 6a 72 6e 6c 4f 66 66 2c 20 50 41 47 45 52 5f jrnlOff, PAGER_
afd0: 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 29 MJ_PGNO(pPager))
afe0: 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
aff0: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
b000: 63 3b 0a 20 20 6a 72 6e 6c 4f 66 66 20 2b 3d 20 c;. jrnlOff +=
b010: 34 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 4;.. rc = sqlit
b020: 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
b030: 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 65 72 2c 20 ->jfd, zMaster,
b040: 6c 65 6e 2c 20 6a 72 6e 6c 4f 66 66 29 3b 0a 20 len, jrnlOff);.
b050: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
b060: 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a OK ) return rc;.
b070: 20 20 6a 72 6e 6c 4f 66 66 20 2b 3d 20 6c 65 6e jrnlOff += len
b080: 3b 0a 0a 20 20 70 75 74 33 32 62 69 74 73 28 7a ;.. put32bits(z
b090: 42 75 66 2c 20 6c 65 6e 29 3b 0a 20 20 70 75 74 Buf, len);. put
b0a0: 33 32 62 69 74 73 28 26 7a 42 75 66 5b 34 5d 2c 32bits(&zBuf[4],
b0b0: 20 63 6b 73 75 6d 29 3b 0a 20 20 6d 65 6d 63 70 cksum);. memcp
b0c0: 79 28 26 7a 42 75 66 5b 38 5d 2c 20 61 4a 6f 75 y(&zBuf[8], aJou
b0d0: 72 6e 61 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f rnalMagic, sizeo
b0e0: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
b0f0: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 );. rc = sqlite
b100: 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3OsWrite(pPager-
b110: 3e 6a 66 64 2c 20 7a 42 75 66 2c 20 38 2b 73 69 >jfd, zBuf, 8+si
b120: 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 zeof(aJournalMag
b130: 69 63 29 2c 20 6a 72 6e 6c 4f 66 66 29 3b 0a 20 ic), jrnlOff);.
b140: 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e pPager->needSyn
b150: 63 20 3d 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 c = !pPager->noS
b160: 79 6e 63 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ync;. return rc
b170: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 6f ;.}../*.** Add o
b180: 72 20 72 65 6d 6f 76 65 20 61 20 70 61 67 65 20 r remove a page
b190: 66 72 6f 6d 20 74 68 65 20 6c 69 73 74 20 6f 66 from the list of
b1a0: 20 61 6c 6c 20 70 61 67 65 73 20 74 68 61 74 20 all pages that
b1b0: 61 72 65 20 69 6e 20 74 68 65 0a 2a 2a 20 73 74 are in the.** st
b1c0: 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e atement journal.
b1d0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 50 61 67 65 72 .**.** The Pager
b1e0: 20 6b 65 65 70 73 20 61 20 73 65 70 61 72 61 74 keeps a separat
b1f0: 65 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20 e list of pages
b200: 74 68 61 74 20 61 72 65 20 63 75 72 72 65 6e 74 that are current
b210: 6c 79 20 69 6e 0a 2a 2a 20 74 68 65 20 73 74 61 ly in.** the sta
b220: 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e 20 tement journal.
b230: 20 54 68 69 73 20 68 65 6c 70 73 20 74 68 65 20 This helps the
b240: 73 71 6c 69 74 65 33 50 61 67 65 72 53 74 6d 74 sqlite3PagerStmt
b250: 43 6f 6d 6d 69 74 28 29 0a 2a 2a 20 72 6f 75 74 Commit().** rout
b260: 69 6e 65 20 72 75 6e 20 4d 55 43 48 20 66 61 73 ine run MUCH fas
b270: 74 65 72 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d ter for the comm
b280: 6f 6e 20 63 61 73 65 20 77 68 65 72 65 20 74 68 on case where th
b290: 65 72 65 20 61 72 65 20 6d 61 6e 79 0a 2a 2a 20 ere are many.**
b2a0: 70 61 67 65 73 20 69 6e 20 6d 65 6d 6f 72 79 20 pages in memory
b2b0: 62 75 74 20 6f 6e 6c 79 20 61 20 66 65 77 20 61 but only a few a
b2c0: 72 65 20 69 6e 20 74 68 65 20 73 74 61 74 65 6d re in the statem
b2d0: 65 6e 74 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a ent journal..*/.
b2e0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 static void page
b2f0: 5f 61 64 64 5f 74 6f 5f 73 74 6d 74 5f 6c 69 73 _add_to_stmt_lis
b300: 74 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 t(PgHdr *pPg){.
b310: 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d Pager *pPager =
b320: 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 pPg->pPager;.
b330: 50 67 48 69 73 74 6f 72 79 20 2a 70 48 69 73 74 PgHistory *pHist
b340: 20 3d 20 50 47 48 44 52 5f 54 4f 5f 48 49 53 54 = PGHDR_TO_HIST
b350: 28 70 50 67 2c 20 70 50 61 67 65 72 29 3b 0a 20 (pPg, pPager);.
b360: 20 61 73 73 65 72 74 28 20 4d 45 4d 44 42 20 29 assert( MEMDB )
b370: 3b 0a 20 20 69 66 28 20 21 70 48 69 73 74 2d 3e ;. if( !pHist->
b380: 69 6e 53 74 6d 74 20 29 7b 0a 20 20 20 20 61 73 inStmt ){. as
b390: 73 65 72 74 28 20 70 48 69 73 74 2d 3e 70 50 72 sert( pHist->pPr
b3a0: 65 76 53 74 6d 74 3d 3d 30 20 26 26 20 70 48 69 evStmt==0 && pHi
b3b0: 73 74 2d 3e 70 4e 65 78 74 53 74 6d 74 3d 3d 30 st->pNextStmt==0
b3c0: 20 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 );. if( pPag
b3d0: 65 72 2d 3e 70 53 74 6d 74 20 29 7b 0a 20 20 20 er->pStmt ){.
b3e0: 20 20 20 50 47 48 44 52 5f 54 4f 5f 48 49 53 54 PGHDR_TO_HIST
b3f0: 28 70 50 61 67 65 72 2d 3e 70 53 74 6d 74 2c 20 (pPager->pStmt,
b400: 70 50 61 67 65 72 29 2d 3e 70 50 72 65 76 53 74 pPager)->pPrevSt
b410: 6d 74 20 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a mt = pPg;. }.
b420: 20 20 20 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 pHist->pNext
b430: 53 74 6d 74 20 3d 20 70 50 61 67 65 72 2d 3e 70 Stmt = pPager->p
b440: 53 74 6d 74 3b 0a 20 20 20 20 70 50 61 67 65 72 Stmt;. pPager
b450: 2d 3e 70 53 74 6d 74 20 3d 20 70 50 67 3b 0a 20 ->pStmt = pPg;.
b460: 20 20 20 70 48 69 73 74 2d 3e 69 6e 53 74 6d 74 pHist->inStmt
b470: 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a = 1;. }.}../*.
b480: 2a 2a 20 46 69 6e 64 20 61 20 70 61 67 65 20 69 ** Find a page i
b490: 6e 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 n the hash table
b4a0: 20 67 69 76 65 6e 20 69 74 73 20 70 61 67 65 20 given its page
b4b0: 6e 75 6d 62 65 72 2e 20 20 52 65 74 75 72 6e 0a number. Return.
b4c0: 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 ** a pointer to
b4d0: 74 68 65 20 70 61 67 65 20 6f 72 20 4e 55 4c 4c the page or NULL
b4e0: 20 69 66 20 6e 6f 74 20 66 6f 75 6e 64 2e 0a 2a if not found..*
b4f0: 2f 0a 73 74 61 74 69 63 20 50 67 48 64 72 20 2a /.static PgHdr *
b500: 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 50 61 67 pager_lookup(Pag
b510: 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f er *pPager, Pgno
b520: 20 70 67 6e 6f 29 7b 0a 20 20 50 67 48 64 72 20 pgno){. PgHdr
b530: 2a 70 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 *p;. if( pPager
b540: 2d 3e 61 48 61 73 68 3d 3d 30 20 29 20 72 65 74 ->aHash==0 ) ret
b550: 75 72 6e 20 30 3b 0a 20 20 70 20 3d 20 70 50 61 urn 0;. p = pPa
b560: 67 65 72 2d 3e 61 48 61 73 68 5b 70 67 6e 6f 20 ger->aHash[pgno
b570: 26 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 & (pPager->nHash
b580: 2d 31 29 5d 3b 0a 20 20 77 68 69 6c 65 28 20 70 -1)];. while( p
b590: 20 26 26 20 70 2d 3e 70 67 6e 6f 21 3d 70 67 6e && p->pgno!=pgn
b5a0: 6f 20 29 7b 0a 20 20 20 20 70 20 3d 20 70 2d 3e o ){. p = p->
b5b0: 70 4e 65 78 74 48 61 73 68 3b 0a 20 20 7d 0a 20 pNextHash;. }.
b5c0: 20 72 65 74 75 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a return p;.}../*
b5d0: 0a 2a 2a 20 43 6c 65 61 72 20 74 68 65 20 69 6e .** Clear the in
b5e0: 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 2e 20 20 -memory cache.
b5f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 This routine.**
b600: 73 65 74 73 20 74 68 65 20 73 74 61 74 65 20 6f sets the state o
b610: 66 20 74 68 65 20 70 61 67 65 72 20 62 61 63 6b f the pager back
b620: 20 74 6f 20 77 68 61 74 20 69 74 20 77 61 73 20 to what it was
b630: 77 68 65 6e 20 69 74 20 77 61 73 20 66 69 72 73 when it was firs
b640: 74 0a 2a 2a 20 6f 70 65 6e 65 64 2e 20 20 41 6e t.** opened. An
b650: 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 y outstanding pa
b660: 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 ges are invalida
b670: 74 65 64 20 61 6e 64 20 73 75 62 73 65 71 75 65 ted and subseque
b680: 6e 74 20 61 74 74 65 6d 70 74 73 0a 2a 2a 20 74 nt attempts.** t
b690: 6f 20 61 63 63 65 73 73 20 74 68 6f 73 65 20 70 o access those p
b6a0: 61 67 65 73 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 ages will likely
b6b0: 20 72 65 73 75 6c 74 20 69 6e 20 61 20 63 6f 72 result in a cor
b6c0: 65 64 75 6d 70 2e 0a 2a 2f 0a 73 74 61 74 69 63 edump..*/.static
b6d0: 20 76 6f 69 64 20 70 61 67 65 72 5f 72 65 73 65 void pager_rese
b6e0: 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 t(Pager *pPager)
b6f0: 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 2c 20 {. PgHdr *pPg,
b700: 2a 70 4e 65 78 74 3b 0a 20 20 69 66 28 20 70 50 *pNext;. if( pP
b710: 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 20 ager->errCode )
b720: 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 70 50 return;. for(pP
b730: 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 g=pPager->pAll;
b740: 70 50 67 3b 20 70 50 67 3d 70 4e 65 78 74 29 7b pPg; pPg=pNext){
b750: 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 50 . IOTRACE(("P
b760: 47 46 52 45 45 20 25 70 20 25 64 5c 6e 22 2c 20 GFREE %p %d\n",
b770: 70 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e pPager, pPg->pgn
b780: 6f 29 29 3b 0a 20 20 20 20 50 41 47 45 52 5f 49 o));. PAGER_I
b790: 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 65 NCR(sqlite3_page
b7a0: 72 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 29 3b r_pgfree_count);
b7b0: 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70 50 67 . pNext = pPg
b7c0: 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20 ->pNextAll;.
b7d0: 6c 72 75 4c 69 73 74 52 65 6d 6f 76 65 28 70 50 lruListRemove(pP
b7e0: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f g);. sqlite3_
b7f0: 66 72 65 65 28 70 50 67 2d 3e 70 44 61 74 61 29 free(pPg->pData)
b800: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 ;. sqlite3_fr
b810: 65 65 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 61 ee(pPg);. }. a
b820: 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6c 72 ssert(pPager->lr
b830: 75 2e 70 46 69 72 73 74 3d 3d 30 29 3b 0a 20 20 u.pFirst==0);.
b840: 61 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6c assert(pPager->l
b850: 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 3d ru.pFirstSynced=
b860: 3d 30 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 =0);. assert(pP
b870: 61 67 65 72 2d 3e 6c 72 75 2e 70 4c 61 73 74 3d ager->lru.pLast=
b880: 3d 30 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 =0);. pPager->p
b890: 53 74 6d 74 20 3d 20 30 3b 0a 20 20 70 50 61 67 Stmt = 0;. pPag
b8a0: 65 72 2d 3e 70 41 6c 6c 20 3d 20 30 3b 0a 20 20 er->pAll = 0;.
b8b0: 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20 3d pPager->pDirty =
b8c0: 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 48 0;. pPager->nH
b8d0: 61 73 68 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 ash = 0;. sqlit
b8e0: 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 2d 3e e3_free(pPager->
b8f0: 61 48 61 73 68 29 3b 0a 20 20 70 50 61 67 65 72 aHash);. pPager
b900: 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 0a 20 20 70 ->nPage = 0;. p
b910: 50 61 67 65 72 2d 3e 61 48 61 73 68 20 3d 20 30 Pager->aHash = 0
b920: 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 ;. pPager->nRef
b930: 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 55 = 0;.}../*.** U
b940: 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 61 62 61 nlock the databa
b950: 73 65 20 66 69 6c 65 2e 20 0a 2a 2a 0a 2a 2a 20 se file. .**.**
b960: 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 If the pager is
b970: 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 65 72 72 currently in err
b980: 6f 72 20 73 74 61 74 65 2c 20 64 69 73 63 61 72 or state, discar
b990: 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f d the contents o
b9a0: 66 20 0a 2a 2a 20 74 68 65 20 63 61 63 68 65 20 f .** the cache
b9b0: 61 6e 64 20 72 65 73 65 74 20 74 68 65 20 50 61 and reset the Pa
b9c0: 67 65 72 20 73 74 72 75 63 74 75 72 65 20 69 6e ger structure in
b9d0: 74 65 72 6e 61 6c 20 73 74 61 74 65 2e 20 49 66 ternal state. If
b9e0: 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6e 20 there is.** an
b9f0: 6f 70 65 6e 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c open journal-fil
ba00: 65 2c 20 74 68 65 6e 20 74 68 65 20 6e 65 78 74 e, then the next
ba10: 20 74 69 6d 65 20 61 20 73 68 61 72 65 64 2d 6c time a shared-l
ba20: 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e 65 64 0a ock is obtained.
ba30: 2a 2a 20 6f 6e 20 74 68 65 20 70 61 67 65 72 20 ** on the pager
ba40: 66 69 6c 65 20 28 62 79 20 74 68 69 73 20 6f 72 file (by this or
ba50: 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65 any other proce
ba60: 73 73 29 2c 20 69 74 20 77 69 6c 6c 20 62 65 0a ss), it will be.
ba70: 2a 2a 20 74 72 65 61 74 65 64 20 61 73 20 61 20 ** treated as a
ba80: 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 hot-journal and
ba90: 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2f 0a rolled back..*/.
baa0: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 static void page
bab0: 72 5f 75 6e 6c 6f 63 6b 28 50 61 67 65 72 20 2a r_unlock(Pager *
bac0: 70 50 61 67 65 72 29 7b 0a 20 20 69 66 28 20 21 pPager){. if( !
bad0: 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
bae0: 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 69 66 28 eMode ){. if(
baf0: 20 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 20 !MEMDB ){.
bb00: 20 69 6e 74 20 72 63 20 3d 20 6f 73 55 6e 6c 6f int rc = osUnlo
bb10: 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 4e ck(pPager->fd, N
bb20: 4f 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 20 69 O_LOCK);. i
bb30: 66 28 20 72 63 20 29 20 70 50 61 67 65 72 2d 3e f( rc ) pPager->
bb40: 65 72 72 43 6f 64 65 20 3d 20 72 63 3b 0a 20 20 errCode = rc;.
bb50: 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 pPager->dbSi
bb60: 7a 65 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 49 ze = -1;. I
bb70: 4f 54 52 41 43 45 28 28 22 55 4e 4c 4f 43 4b 20 OTRACE(("UNLOCK
bb80: 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a %p\n", pPager)).
bb90: 0a 20 20 20 20 20 20 2f 2a 20 41 6c 77 61 79 73 . /* Always
bba0: 20 63 6c 6f 73 65 20 74 68 65 20 6a 6f 75 72 6e close the journ
bbb0: 61 6c 20 66 69 6c 65 20 77 68 65 6e 20 64 72 6f al file when dro
bbc0: 70 70 69 6e 67 20 74 68 65 20 64 61 74 61 62 61 pping the databa
bbd0: 73 65 20 6c 6f 63 6b 2e 0a 20 20 20 20 20 20 2a se lock.. *
bbe0: 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 61 6e 6f * Otherwise, ano
bbf0: 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 ther connection
bc00: 77 69 74 68 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 with journal_mod
bc10: 65 3d 64 65 6c 65 74 65 20 6d 69 67 68 74 0a 20 e=delete might.
bc20: 20 20 20 20 20 2a 2a 20 64 65 6c 65 74 65 20 74 ** delete t
bc30: 68 65 20 66 69 6c 65 20 6f 75 74 20 66 72 6f 6d he file out from
bc40: 20 75 6e 64 65 72 20 75 73 2e 0a 20 20 20 20 20 under us..
bc50: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 50 */. if( pP
bc60: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 ager->journalOpe
bc70: 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c n ){. sql
bc80: 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 ite3OsClose(pPag
bc90: 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 er->jfd);.
bca0: 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
bcb0: 6c 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 20 lOpen = 0;.
bcc0: 20 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 sqlite3Bitvec
bcd0: 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d 3e Destroy(pPager->
bce0: 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 pInJournal);.
bcf0: 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 49 6e pPager->pIn
bd00: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 20 Journal = 0;.
bd10: 20 20 20 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 }.. /* I
bd20: 66 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 20 f Pager.errCode
bd30: 69 73 20 73 65 74 2c 20 74 68 65 20 63 6f 6e 74 is set, the cont
bd40: 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 ents of the page
bd50: 72 20 63 61 63 68 65 20 63 61 6e 6e 6f 74 20 62 r cache cannot b
bd60: 65 0a 20 20 20 20 20 20 2a 2a 20 74 72 75 73 74 e. ** trust
bd70: 65 64 2e 20 4e 6f 77 20 74 68 61 74 20 74 68 65 ed. Now that the
bd80: 20 70 61 67 65 72 20 66 69 6c 65 20 69 73 20 75 pager file is u
bd90: 6e 6c 6f 63 6b 65 64 2c 20 74 68 65 20 63 6f 6e nlocked, the con
bda0: 74 65 6e 74 73 20 6f 66 20 74 68 65 0a 20 20 20 tents of the.
bdb0: 20 20 20 2a 2a 20 63 61 63 68 65 20 63 61 6e 20 ** cache can
bdc0: 62 65 20 64 69 73 63 61 72 64 65 64 20 61 6e 64 be discarded and
bdd0: 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 the error code
bde0: 73 61 66 65 6c 79 20 63 6c 65 61 72 65 64 2e 0a safely cleared..
bdf0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 */. i
be00: 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f f( pPager->errCo
be10: 64 65 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 de ){. if
be20: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
be30: 29 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 ) pPager->errCod
be40: 65 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 e = SQLITE_OK;.
be50: 20 20 20 20 20 20 20 70 61 67 65 72 5f 72 65 73 pager_res
be60: 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 et(pPager);.
be70: 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
be80: 73 74 6d 74 4f 70 65 6e 20 29 7b 0a 20 20 20 20 stmtOpen ){.
be90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
bea0: 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 73 74 66 lose(pPager->stf
beb0: 64 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 d);. sq
bec0: 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
bed0: 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 oy(pPager->pInSt
bee0: 6d 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 mt);. p
bef0: 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d Pager->pInStmt =
bf00: 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 0;. }.
bf10: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 pPager->st
bf20: 6d 74 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 mtOpen = 0;.
bf30: 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 pPager->stmt
bf40: 49 6e 55 73 65 20 3d 20 30 3b 0a 20 20 20 20 20 InUse = 0;.
bf50: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
bf60: 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20 alOff = 0;.
bf70: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
bf80: 61 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20 alStarted = 0;.
bf90: 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 pPager->s
bfa0: 74 6d 74 41 75 74 6f 6f 70 65 6e 20 3d 20 30 3b tmtAutoopen = 0;
bfb0: 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d . pPager-
bfc0: 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20 30 3b >origDbSize = 0;
bfd0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a . }. }..
bfe0: 20 20 20 20 69 66 28 20 21 4d 45 4d 44 42 20 7c if( !MEMDB |
bff0: 7c 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 | pPager->errCod
c000: 65 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a e==SQLITE_OK ){.
c010: 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 pPager->st
c020: 61 74 65 20 3d 20 50 41 47 45 52 5f 55 4e 4c 4f ate = PAGER_UNLO
c030: 43 4b 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 CK;. pPager
c040: 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e ->changeCountDon
c050: 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d e = 0;. }. }
c060: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 78 65 63 75 74 .}../*.** Execut
c070: 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 69 66 20 e a rollback if
c080: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 a transaction is
c090: 20 61 63 74 69 76 65 20 61 6e 64 20 75 6e 6c 6f active and unlo
c0a0: 63 6b 20 74 68 65 20 0a 2a 2a 20 64 61 74 61 62 ck the .** datab
c0b0: 61 73 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 ase file. If the
c0c0: 20 70 61 67 65 72 20 68 61 73 20 61 6c 72 65 61 pager has alrea
c0d0: 64 79 20 65 6e 74 65 72 65 64 20 74 68 65 20 65 dy entered the e
c0e0: 72 72 6f 72 20 73 74 61 74 65 2c 20 0a 2a 2a 20 rror state, .**
c0f0: 64 6f 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 do not attempt t
c100: 68 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a he rollback..*/.
c110: 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 static void page
c120: 72 55 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 rUnlockAndRollba
c130: 63 6b 28 50 61 67 65 72 20 2a 70 29 7b 0a 20 20 ck(Pager *p){.
c140: 2f 2a 20 61 73 73 65 72 74 28 20 70 2d 3e 73 74 /* assert( p->st
c150: 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 53 45 52 ate>=PAGER_RESER
c160: 56 45 44 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 VED || p->journa
c170: 6c 4f 70 65 6e 3d 3d 30 20 29 3b 20 2a 2f 0a 20 lOpen==0 ); */.
c180: 20 69 66 28 20 70 2d 3e 65 72 72 43 6f 64 65 3d if( p->errCode=
c190: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 2d =SQLITE_OK && p-
c1a0: 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 >state>=PAGER_RE
c1b0: 53 45 52 56 45 44 20 29 7b 0a 20 20 20 20 73 71 SERVED ){. sq
c1c0: 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 lite3PagerRollba
c1d0: 63 6b 28 70 29 3b 0a 20 20 7d 0a 20 20 70 61 67 ck(p);. }. pag
c1e0: 65 72 5f 75 6e 6c 6f 63 6b 28 70 29 3b 0a 23 69 er_unlock(p);.#i
c1f0: 66 20 30 0a 20 20 61 73 73 65 72 74 28 20 70 2d f 0. assert( p-
c200: 3e 65 72 72 43 6f 64 65 20 7c 7c 20 21 70 2d 3e >errCode || !p->
c210: 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 28 journalOpen || (
c220: 70 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 p->exclusiveMode
c230: 26 26 21 70 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 &&!p->journalOff
c240: 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 ) );. assert( p
c250: 2d 3e 65 72 72 43 6f 64 65 20 7c 7c 20 21 70 2d ->errCode || !p-
c260: 3e 73 74 6d 74 4f 70 65 6e 20 7c 7c 20 70 2d 3e >stmtOpen || p->
c270: 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 3b exclusiveMode );
c280: 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a .#endif.}../*.**
c290: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 65 6e This routine en
c2a0: 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e ds a transaction
c2b0: 2e 20 20 41 20 74 72 61 6e 73 61 63 74 69 6f 6e . A transaction
c2c0: 20 69 73 20 65 6e 64 65 64 20 62 79 20 65 69 74 is ended by eit
c2d0: 68 65 72 0a 2a 2a 20 61 20 43 4f 4d 4d 49 54 20 her.** a COMMIT
c2e0: 6f 72 20 61 20 52 4f 4c 4c 42 41 43 4b 2e 0a 2a or a ROLLBACK..*
c2f0: 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 72 *.** When this r
c300: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
c310: 2c 20 74 68 65 20 70 61 67 65 72 20 68 61 73 20 , the pager has
c320: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
c330: 20 6f 70 65 6e 20 61 6e 64 0a 2a 2a 20 61 20 52 open and.** a R
c340: 45 53 45 52 56 45 44 20 6f 72 20 45 58 43 4c 55 ESERVED or EXCLU
c350: 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 SIVE lock on the
c360: 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 database. This
c370: 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c 20 72 65 routine will re
c380: 6c 65 61 73 65 0a 2a 2a 20 74 68 65 20 64 61 74 lease.** the dat
c390: 61 62 61 73 65 20 6c 6f 63 6b 20 61 6e 64 20 61 abase lock and a
c3a0: 63 71 75 69 72 65 73 20 61 20 53 48 41 52 45 44 cquires a SHARED
c3b0: 20 6c 6f 63 6b 20 69 6e 20 69 74 73 20 70 6c 61 lock in its pla
c3c0: 63 65 20 69 66 20 74 68 61 74 20 69 73 0a 2a 2a ce if that is.**
c3d0: 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 the appropriate
c3e0: 20 74 68 69 6e 67 20 74 6f 20 64 6f 2e 20 20 52 thing to do. R
c3f0: 65 6c 65 61 73 65 20 6c 6f 63 6b 73 20 75 73 75 elease locks usu
c400: 61 6c 6c 79 20 69 73 20 61 70 70 72 6f 70 72 69 ally is appropri
c410: 61 74 65 2c 0a 2a 2a 20 75 6e 6c 65 73 73 20 77 ate,.** unless w
c420: 65 20 61 72 65 20 69 6e 20 65 78 63 6c 75 73 69 e are in exclusi
c430: 76 65 20 61 63 63 65 73 73 20 6d 6f 64 65 20 6f ve access mode o
c440: 72 20 75 6e 6c 65 73 73 20 74 68 69 73 20 69 73 r unless this is
c450: 20 61 20 0a 2a 2a 20 43 4f 4d 4d 49 54 20 41 4e a .** COMMIT AN
c460: 44 20 42 45 47 49 4e 20 6f 72 20 52 4f 4c 4c 42 D BEGIN or ROLLB
c470: 41 43 4b 20 41 4e 44 20 42 45 47 49 4e 20 6f 70 ACK AND BEGIN op
c480: 65 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 eration..**.** T
c490: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
c4a0: 69 73 20 65 69 74 68 65 72 20 64 65 6c 65 74 65 is either delete
c4b0: 64 20 6f 72 20 74 72 75 6e 63 61 74 65 64 2e 0a d or truncated..
c4c0: 2a 2a 0a 2a 2a 20 54 4f 44 4f 3a 20 43 6f 6e 73 **.** TODO: Cons
c4d0: 69 64 65 72 20 6b 65 65 70 69 6e 67 20 74 68 65 ider keeping the
c4e0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 70 journal file op
c4f0: 65 6e 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 en for temporary
c500: 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2a 20 54 databases..** T
c510: 68 69 73 20 6d 69 67 68 74 20 67 69 76 65 20 61 his might give a
c520: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 performance imp
c530: 72 6f 76 65 6d 65 6e 74 20 6f 6e 20 77 69 6e 64 rovement on wind
c540: 6f 77 73 20 77 68 65 72 65 20 6f 70 65 6e 69 6e ows where openin
c550: 67 0a 2a 2a 20 61 20 66 69 6c 65 20 69 73 20 61 g.** a file is a
c560: 6e 20 65 78 70 65 6e 73 69 76 65 20 6f 70 65 72 n expensive oper
c570: 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 ation..*/.static
c580: 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 5f 74 int pager_end_t
c590: 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 65 72 ransaction(Pager
c5a0: 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 50 67 48 *pPager){. PgH
c5b0: 64 72 20 2a 70 50 67 3b 0a 20 20 69 6e 74 20 72 dr *pPg;. int r
c5c0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
c5d0: 20 69 6e 74 20 72 63 32 20 3d 20 53 51 4c 49 54 int rc2 = SQLIT
c5e0: 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 20 E_OK;. assert(
c5f0: 21 4d 45 4d 44 42 20 29 3b 0a 20 20 69 66 28 20 !MEMDB );. if(
c600: 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3c 50 41 pPager->state<PA
c610: 47 45 52 5f 52 45 53 45 52 56 45 44 20 29 7b 0a GER_RESERVED ){.
c620: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
c630: 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 E_OK;. }. sqli
c640: 74 65 33 50 61 67 65 72 53 74 6d 74 43 6f 6d 6d te3PagerStmtComm
c650: 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 it(pPager);. if
c660: 28 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4f 70 ( pPager->stmtOp
c670: 65 6e 20 26 26 20 21 70 50 61 67 65 72 2d 3e 65 en && !pPager->e
c680: 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b 0a xclusiveMode ){.
c690: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f sqlite3OsClo
c6a0: 73 65 28 70 50 61 67 65 72 2d 3e 73 74 66 64 29 se(pPager->stfd)
c6b0: 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 ;. pPager->st
c6c0: 6d 74 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 7d 0a mtOpen = 0;. }.
c6d0: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f if( pPager->jo
c6e0: 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 20 urnalOpen ){.
c6f0: 20 69 66 28 20 28 70 50 61 67 65 72 2d 3e 65 78 if( (pPager->ex
c700: 63 6c 75 73 69 76 65 4d 6f 64 65 20 7c 7c 0a 20 clusiveMode ||.
c710: 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e pPager->
c720: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
c730: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 ER_JOURNALMODE_P
c740: 45 52 53 49 53 54 29 20 0a 20 20 20 20 20 20 20 ERSIST) .
c750: 26 26 20 28 72 63 20 3d 20 7a 65 72 6f 4a 6f 75 && (rc = zeroJou
c760: 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 29 29 rnalHdr(pPager))
c770: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
c780: 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 pPager->jou
c790: 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20 rnalOff = 0;.
c7a0: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
c7b0: 61 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20 alStarted = 0;.
c7c0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
c7d0: 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
c7e0: 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 Pager->jfd);.
c7f0: 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
c800: 61 6c 4f 70 65 6e 20 3d 20 30 3b 0a 20 20 20 20 alOpen = 0;.
c810: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
c820: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 _OK ){. r
c830: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 6c c = sqlite3OsDel
c840: 65 74 65 28 70 50 61 67 65 72 2d 3e 70 56 66 73 ete(pPager->pVfs
c850: 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e , pPager->zJourn
c860: 61 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a al, 0);. }.
c870: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
c880: 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 70 3BitvecDestroy(p
c890: 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 Pager->pInJourna
c8a0: 6c 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e l);. pPager->
c8b0: 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a pInJournal = 0;.
c8c0: 20 20 20 20 66 6f 72 28 70 50 67 3d 70 50 61 67 for(pPg=pPag
c8d0: 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67 3b 20 70 er->pAll; pPg; p
c8e0: 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c Pg=pPg->pNextAll
c8f0: 29 7b 0a 20 20 20 20 20 20 70 50 67 2d 3e 69 6e ){. pPg->in
c900: 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 20 20 Journal = 0;.
c910: 20 20 20 70 50 67 2d 3e 64 69 72 74 79 20 3d 20 pPg->dirty =
c920: 30 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 6e 65 0;. pPg->ne
c930: 65 64 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 edSync = 0;.
c940: 20 20 70 50 67 2d 3e 61 6c 77 61 79 73 52 6f 6c pPg->alwaysRol
c950: 6c 62 61 63 6b 20 3d 20 30 3b 0a 23 69 66 64 65 lback = 0;.#ifde
c960: 66 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 f SQLITE_CHECK_P
c970: 41 47 45 53 0a 20 20 20 20 20 20 70 50 67 2d 3e AGES. pPg->
c980: 70 61 67 65 48 61 73 68 20 3d 20 70 61 67 65 72 pageHash = pager
c990: 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 3b 0a _pagehash(pPg);.
c9a0: 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 #endif. }.
c9b0: 20 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20 pPager->pDirty
c9c0: 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d = 0;. pPager-
c9d0: 3e 64 69 72 74 79 43 61 63 68 65 20 3d 20 30 3b >dirtyCache = 0;
c9e0: 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 . pPager->nRe
c9f0: 63 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a c = 0;. }else{.
ca00: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
ca10: 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d er->pInJournal==
ca20: 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 0 );. }.. if(
ca30: 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 !pPager->exclusi
ca40: 76 65 4d 6f 64 65 20 29 7b 0a 20 20 20 20 72 63 veMode ){. rc
ca50: 32 20 3d 20 6f 73 55 6e 6c 6f 63 6b 28 70 50 61 2 = osUnlock(pPa
ca60: 67 65 72 2d 3e 66 64 2c 20 53 48 41 52 45 44 5f ger->fd, SHARED_
ca70: 4c 4f 43 4b 29 3b 0a 20 20 20 20 70 50 61 67 65 LOCK);. pPage
ca80: 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45 52 r->state = PAGER
ca90: 5f 53 48 41 52 45 44 3b 0a 20 20 7d 65 6c 73 65 _SHARED;. }else
caa0: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 if( pPager->sta
cab0: 74 65 3d 3d 50 41 47 45 52 5f 53 59 4e 43 45 44 te==PAGER_SYNCED
cac0: 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
cad0: 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f 45 58 state = PAGER_EX
cae0: 43 4c 55 53 49 56 45 3b 0a 20 20 7d 0a 20 20 70 CLUSIVE;. }. p
caf0: 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a Pager->origDbSiz
cb00: 65 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d e = 0;. pPager-
cb10: 3e 73 65 74 4d 61 73 74 65 72 20 3d 20 30 3b 0a >setMaster = 0;.
cb20: 20 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 pPager->needSy
cb30: 6e 63 20 3d 20 30 3b 0a 20 20 6c 72 75 4c 69 73 nc = 0;. lruLis
cb40: 74 53 65 74 46 69 72 73 74 53 79 6e 63 65 64 28 tSetFirstSynced(
cb50: 70 50 61 67 65 72 29 3b 0a 20 20 70 50 61 67 65 pPager);. pPage
cb60: 72 2d 3e 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a r->dbSize = -1;.
cb70: 0a 20 20 72 65 74 75 72 6e 20 28 72 63 3d 3d 53 . return (rc==S
cb80: 51 4c 49 54 45 5f 4f 4b 3f 72 63 32 3a 72 63 29 QLITE_OK?rc2:rc)
cb90: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 ;.}../*.** Compu
cba0: 74 65 20 61 6e 64 20 72 65 74 75 72 6e 20 61 20 te and return a
cbb0: 63 68 65 63 6b 73 75 6d 20 66 6f 72 20 74 68 65 checksum for the
cbc0: 20 70 61 67 65 20 6f 66 20 64 61 74 61 2e 0a 2a page of data..*
cbd0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 6e 6f 74 *.** This is not
cbe0: 20 61 20 72 65 61 6c 20 63 68 65 63 6b 73 75 6d a real checksum
cbf0: 2e 20 20 49 74 20 69 73 20 72 65 61 6c 6c 79 20 . It is really
cc00: 6a 75 73 74 20 74 68 65 20 73 75 6d 20 6f 66 20 just the sum of
cc10: 74 68 65 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 69 the .** random i
cc20: 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 61 6e 64 nitial value and
cc30: 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
cc40: 2e 20 20 57 65 20 65 78 70 65 72 69 6d 65 6e 74 . We experiment
cc50: 65 64 20 77 69 74 68 0a 2a 2a 20 61 20 63 68 65 ed with.** a che
cc60: 63 6b 73 75 6d 20 6f 66 20 74 68 65 20 65 6e 74 cksum of the ent
cc70: 69 72 65 20 64 61 74 61 2c 20 62 75 74 20 74 68 ire data, but th
cc80: 61 74 20 77 61 73 20 66 6f 75 6e 64 20 74 6f 20 at was found to
cc90: 62 65 20 74 6f 6f 20 73 6c 6f 77 2e 0a 2a 2a 0a be too slow..**.
cca0: 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 ** Note that the
ccb0: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 20 page number is
ccc0: 73 74 6f 72 65 64 20 61 74 20 74 68 65 20 62 65 stored at the be
ccd0: 67 69 6e 6e 69 6e 67 20 6f 66 20 64 61 74 61 20 ginning of data
cce0: 61 6e 64 0a 2a 2a 20 74 68 65 20 63 68 65 63 6b and.** the check
ccf0: 73 75 6d 20 69 73 20 73 74 6f 72 65 64 20 61 74 sum is stored at
cd00: 20 74 68 65 20 65 6e 64 2e 20 20 54 68 69 73 20 the end. This
cd10: 69 73 20 69 6d 70 6f 72 74 61 6e 74 2e 20 20 49 is important. I
cd20: 66 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 63 6f 72 f journal.** cor
cd30: 72 75 70 74 69 6f 6e 20 6f 63 63 75 72 73 20 64 ruption occurs d
cd40: 75 65 20 74 6f 20 61 20 70 6f 77 65 72 20 66 61 ue to a power fa
cd50: 69 6c 75 72 65 2c 20 74 68 65 20 6d 6f 73 74 20 ilure, the most
cd60: 6c 69 6b 65 6c 79 20 73 63 65 6e 61 72 69 6f 0a likely scenario.
cd70: 2a 2a 20 69 73 20 74 68 61 74 20 6f 6e 65 20 65 ** is that one e
cd80: 6e 64 20 6f 72 20 74 68 65 20 6f 74 68 65 72 20 nd or the other
cd90: 6f 66 20 74 68 65 20 72 65 63 6f 72 64 20 77 69 of the record wi
cda0: 6c 6c 20 62 65 20 63 68 61 6e 67 65 64 2e 20 20 ll be changed.
cdb0: 49 74 20 69 73 0a 2a 2a 20 6d 75 63 68 20 6c 65 It is.** much le
cdc0: 73 73 20 6c 69 6b 65 6c 79 20 74 68 61 74 20 74 ss likely that t
cdd0: 68 65 20 74 77 6f 20 65 6e 64 73 20 6f 66 20 74 he two ends of t
cde0: 68 65 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 he journal recor
cdf0: 64 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 63 6f 72 d will be.** cor
ce00: 72 65 63 74 20 61 6e 64 20 74 68 65 20 6d 69 64 rect and the mid
ce10: 64 6c 65 20 62 65 20 63 6f 72 72 75 70 74 2e 20 dle be corrupt.
ce20: 20 54 68 75 73 2c 20 74 68 69 73 20 22 63 68 65 Thus, this "che
ce30: 63 6b 73 75 6d 22 20 73 63 68 65 6d 65 2c 0a 2a cksum" scheme,.*
ce40: 2a 20 74 68 6f 75 67 68 20 66 61 73 74 20 61 6e * though fast an
ce50: 64 20 73 69 6d 70 6c 65 2c 20 63 61 74 63 68 65 d simple, catche
ce60: 73 20 74 68 65 20 6d 6f 73 74 6c 79 20 6c 69 6b s the mostly lik
ce70: 65 6c 79 20 6b 69 6e 64 20 6f 66 20 63 6f 72 72 ely kind of corr
ce80: 75 70 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 46 49 uption..**.** FI
ce90: 58 20 4d 45 3a 20 20 43 6f 6e 73 69 64 65 72 20 X ME: Consider
cea0: 61 64 64 69 6e 67 20 65 76 65 72 79 20 32 30 30 adding every 200
ceb0: 74 68 20 28 6f 72 20 73 6f 29 20 62 79 74 65 20 th (or so) byte
cec0: 6f 66 20 74 68 65 20 64 61 74 61 20 74 6f 20 74 of the data to t
ced0: 68 65 0a 2a 2a 20 63 68 65 63 6b 73 75 6d 2e 20 he.** checksum.
cee0: 20 54 68 61 74 20 77 61 79 20 69 66 20 61 20 73 That way if a s
cef0: 69 6e 67 6c 65 20 70 61 67 65 20 73 70 61 6e 73 ingle page spans
cf00: 20 33 20 6f 72 20 6d 6f 72 65 20 64 69 73 6b 20 3 or more disk
cf10: 73 65 63 74 6f 72 73 20 61 6e 64 0a 2a 2a 20 6f sectors and.** o
cf20: 6e 6c 79 20 74 68 65 20 6d 69 64 64 6c 65 20 73 nly the middle s
cf30: 65 63 74 6f 72 20 69 73 20 63 6f 72 72 75 70 74 ector is corrupt
cf40: 2c 20 77 65 20 77 69 6c 6c 20 73 74 69 6c 6c 20 , we will still
cf50: 68 61 76 65 20 61 20 72 65 61 73 6f 6e 61 62 6c have a reasonabl
cf60: 65 0a 2a 2a 20 63 68 61 6e 63 65 20 6f 66 20 66 e.** chance of f
cf70: 61 69 6c 69 6e 67 20 74 68 65 20 63 68 65 63 6b ailing the check
cf80: 73 75 6d 20 61 6e 64 20 74 68 75 73 20 64 65 74 sum and thus det
cf90: 65 63 74 69 6e 67 20 74 68 65 20 70 72 6f 62 6c ecting the probl
cfa0: 65 6d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 75 33 em..*/.static u3
cfb0: 32 20 70 61 67 65 72 5f 63 6b 73 75 6d 28 50 61 2 pager_cksum(Pa
cfc0: 67 65 72 20 2a 70 50 61 67 65 72 2c 20 63 6f 6e ger *pPager, con
cfd0: 73 74 20 75 38 20 2a 61 44 61 74 61 29 7b 0a 20 st u8 *aData){.
cfe0: 20 75 33 32 20 63 6b 73 75 6d 20 3d 20 70 50 61 u32 cksum = pPa
cff0: 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 3b 0a ger->cksumInit;.
d000: 20 20 69 6e 74 20 69 20 3d 20 70 50 61 67 65 72 int i = pPager
d010: 2d 3e 70 61 67 65 53 69 7a 65 2d 32 30 30 3b 0a ->pageSize-200;.
d020: 20 20 77 68 69 6c 65 28 20 69 3e 30 20 29 7b 0a while( i>0 ){.
d030: 20 20 20 20 63 6b 73 75 6d 20 2b 3d 20 61 44 61 cksum += aDa
d040: 74 61 5b 69 5d 3b 0a 20 20 20 20 69 20 2d 3d 20 ta[i];. i -=
d050: 32 30 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 200;. }. retur
d060: 6e 20 63 6b 73 75 6d 3b 0a 7d 0a 0a 2f 2a 20 46 n cksum;.}../* F
d070: 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 orward declarati
d080: 6f 6e 20 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 on */.static voi
d090: 64 20 6d 61 6b 65 43 6c 65 61 6e 28 50 67 48 64 d makeClean(PgHd
d0a0: 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 r*);../*.** Read
d0b0: 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 66 a single page f
d0c0: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 rom the journal
d0d0: 66 69 6c 65 20 6f 70 65 6e 65 64 20 6f 6e 20 66 file opened on f
d0e0: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 0a 2a ile descriptor.*
d0f0: 2a 20 6a 66 64 2e 20 20 50 6c 61 79 62 61 63 6b * jfd. Playback
d100: 20 74 68 69 73 20 6f 6e 65 20 70 61 67 65 2e 0a this one page..
d110: 2a 2a 0a 2a 2a 20 49 66 20 75 73 65 43 6b 73 75 **.** If useCksu
d120: 6d 3d 3d 30 20 69 74 20 6d 65 61 6e 73 20 74 68 m==0 it means th
d130: 69 73 20 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 20 is journal does
d140: 6e 6f 74 20 75 73 65 20 63 68 65 63 6b 73 75 6d not use checksum
d150: 73 2e 20 20 43 68 65 63 6b 73 75 6d 73 0a 2a 2a s. Checksums.**
d160: 20 61 72 65 20 6e 6f 74 20 75 73 65 64 20 69 6e are not used in
d170: 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e statement journ
d180: 61 6c 73 20 62 65 63 61 75 73 65 20 73 74 61 74 als because stat
d190: 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 73 20 64 ement journals d
d1a0: 6f 20 6e 6f 74 0a 2a 2a 20 6e 65 65 64 20 74 6f o not.** need to
d1b0: 20 73 75 72 76 69 76 65 20 70 6f 77 65 72 20 66 survive power f
d1c0: 61 69 6c 75 72 65 73 2e 0a 2a 2f 0a 73 74 61 74 ailures..*/.stat
d1d0: 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 6c 61 ic int pager_pla
d1e0: 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 0a yback_one_page(.
d1f0: 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c Pager *pPager,
d200: 20 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 . sqlite3_file
d210: 20 2a 6a 66 64 2c 0a 20 20 69 36 34 20 6f 66 66 *jfd,. i64 off
d220: 73 65 74 2c 0a 20 20 69 6e 74 20 75 73 65 43 6b set,. int useCk
d230: 73 75 6d 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b sum.){. int rc;
d240: 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 20 20 . PgHdr *pPg;
d250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d260: 20 2f 2a 20 41 6e 20 65 78 69 73 74 69 6e 67 20 /* An existing
d270: 70 61 67 65 20 69 6e 20 74 68 65 20 63 61 63 68 page in the cach
d280: 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f e */. Pgno pgno
d290: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
d2a0: 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 /* The page
d2b0: 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 70 61 67 number of a pag
d2c0: 65 20 69 6e 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a e in journal */.
d2d0: 20 20 75 33 32 20 63 6b 73 75 6d 3b 20 20 20 20 u32 cksum;
d2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d2f0: 2f 2a 20 43 68 65 63 6b 73 75 6d 20 75 73 65 64 /* Checksum used
d300: 20 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63 for sanity chec
d310: 6b 69 6e 67 20 2a 2f 0a 20 20 75 38 20 2a 61 44 king */. u8 *aD
d320: 61 74 61 20 3d 20 28 75 38 20 2a 29 70 50 61 67 ata = (u8 *)pPag
d330: 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 20 20 er->pTmpSpace;
d340: 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 61 67 65 /* Temp storage
d350: 20 66 6f 72 20 61 20 70 61 67 65 20 2a 2f 0a 0a for a page */..
d360: 20 20 2f 2a 20 75 73 65 43 6b 73 75 6d 20 73 68 /* useCksum sh
d370: 6f 75 6c 64 20 62 65 20 74 72 75 65 20 66 6f 72 ould be true for
d380: 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
d390: 6c 20 61 6e 64 20 66 61 6c 73 65 20 66 6f 72 0a l and false for.
d3a0: 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 6a ** statement j
d3b0: 6f 75 72 6e 61 6c 73 2e 20 20 56 65 72 69 66 79 ournals. Verify
d3c0: 20 74 68 61 74 20 74 68 69 73 20 69 73 20 61 6c that this is al
d3d0: 77 61 79 73 20 74 68 65 20 63 61 73 65 0a 20 20 ways the case.
d3e0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 6a 66 64 */. assert( jfd
d3f0: 20 3d 3d 20 28 75 73 65 43 6b 73 75 6d 20 3f 20 == (useCksum ?
d400: 70 50 61 67 65 72 2d 3e 6a 66 64 20 3a 20 70 50 pPager->jfd : pP
d410: 61 67 65 72 2d 3e 73 74 66 64 29 20 29 3b 0a 20 ager->stfd) );.
d420: 20 61 73 73 65 72 74 28 20 61 44 61 74 61 20 29 assert( aData )
d430: 3b 0a 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32 ;.. rc = read32
d440: 62 69 74 73 28 6a 66 64 2c 20 6f 66 66 73 65 74 bits(jfd, offset
d450: 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 , &pgno);. if(
d460: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
d470: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 20 return rc;. rc
d480: 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 = sqlite3OsRead(
d490: 6a 66 64 2c 20 61 44 61 74 61 2c 20 70 50 61 67 jfd, aData, pPag
d4a0: 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f 66 er->pageSize, of
d4b0: 66 73 65 74 2b 34 29 3b 0a 20 20 69 66 28 20 72 fset+4);. if( r
d4c0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 c!=SQLITE_OK ) r
d4d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 70 50 61 67 eturn rc;. pPag
d4e0: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b er->journalOff +
d4f0: 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
d500: 7a 65 20 2b 20 34 3b 0a 0a 20 20 2f 2a 20 53 61 ze + 4;.. /* Sa
d510: 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e nity checking on
d520: 20 74 68 65 20 70 61 67 65 2e 20 20 54 68 69 73 the page. This
d530: 20 69 73 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61 is more importa
d540: 6e 74 20 74 68 61 74 20 49 20 6f 72 69 67 69 6e nt that I origin
d550: 61 6c 6c 79 0a 20 20 2a 2a 20 74 68 6f 75 67 68 ally. ** though
d560: 74 2e 20 20 49 66 20 61 20 70 6f 77 65 72 20 66 t. If a power f
d570: 61 69 6c 75 72 65 20 6f 63 63 75 72 73 20 77 68 ailure occurs wh
d580: 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ile the journal
d590: 69 73 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e is being written
d5a0: 2c 0a 20 20 2a 2a 20 69 74 20 63 6f 75 6c 64 20 ,. ** it could
d5b0: 63 61 75 73 65 20 69 6e 76 61 6c 69 64 20 64 61 cause invalid da
d5c0: 74 61 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e ta to be written
d5d0: 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 into the journa
d5e0: 6c 2e 20 20 57 65 20 6e 65 65 64 20 74 6f 0a 20 l. We need to.
d5f0: 20 2a 2a 20 64 65 74 65 63 74 20 74 68 69 73 20 ** detect this
d600: 69 6e 76 61 6c 69 64 20 64 61 74 61 20 28 77 69 invalid data (wi
d610: 74 68 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c th high probabil
d620: 69 74 79 29 20 61 6e 64 20 69 67 6e 6f 72 65 20 ity) and ignore
d630: 69 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 it.. */. if( p
d640: 67 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d gno==0 || pgno==
d650: 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 PAGER_MJ_PGNO(pP
d660: 61 67 65 72 29 20 29 7b 0a 20 20 20 20 72 65 74 ager) ){. ret
d670: 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b urn SQLITE_DONE;
d680: 0a 20 20 7d 0a 20 20 69 66 28 20 70 67 6e 6f 3e . }. if( pgno>
d690: 28 75 6e 73 69 67 6e 65 64 29 70 50 61 67 65 72 (unsigned)pPager
d6a0: 2d 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 ->dbSize ){.
d6b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
d6c0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 75 73 65 43 ;. }. if( useC
d6d0: 6b 73 75 6d 20 29 7b 0a 20 20 20 20 72 63 20 3d ksum ){. rc =
d6e0: 20 72 65 61 64 33 32 62 69 74 73 28 6a 66 64 2c read32bits(jfd,
d6f0: 20 6f 66 66 73 65 74 2b 70 50 61 67 65 72 2d 3e offset+pPager->
d700: 70 61 67 65 53 69 7a 65 2b 34 2c 20 26 63 6b 73 pageSize+4, &cks
d710: 75 6d 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 um);. if( rc
d720: 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
d730: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
d740: 4f 66 66 20 2b 3d 20 34 3b 0a 20 20 20 20 69 66 Off += 4;. if
d750: 28 20 70 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 ( pager_cksum(pP
d760: 61 67 65 72 2c 20 61 44 61 74 61 29 21 3d 63 6b ager, aData)!=ck
d770: 73 75 6d 20 29 7b 0a 20 20 20 20 20 20 72 65 74 sum ){. ret
d780: 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 3b urn SQLITE_DONE;
d790: 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 61 73 . }. }.. as
d7a0: 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 sert( pPager->st
d7b0: 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 53 45 52 ate==PAGER_RESER
d7c0: 56 45 44 20 7c 7c 20 70 50 61 67 65 72 2d 3e 73 VED || pPager->s
d7d0: 74 61 74 65 3e 3d 50 41 47 45 52 5f 45 58 43 4c tate>=PAGER_EXCL
d7e0: 55 53 49 56 45 20 29 3b 0a 0a 20 20 2f 2a 20 49 USIVE );.. /* I
d7f0: 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69 f the pager is i
d800: 6e 20 52 45 53 45 52 56 45 44 20 73 74 61 74 65 n RESERVED state
d810: 2c 20 74 68 65 6e 20 74 68 65 72 65 20 6d 75 73 , then there mus
d820: 74 20 62 65 20 61 20 63 6f 70 79 20 6f 66 20 74 t be a copy of t
d830: 68 69 73 0a 20 20 2a 2a 20 70 61 67 65 20 69 6e his. ** page in
d840: 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
d850: 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 6a . In this case j
d860: 75 73 74 20 75 70 64 61 74 65 20 74 68 65 20 70 ust update the p
d870: 61 67 65 72 20 63 61 63 68 65 2c 0a 20 20 2a 2a ager cache,. **
d880: 20 6e 6f 74 20 74 68 65 20 64 61 74 61 62 61 73 not the databas
d890: 65 20 66 69 6c 65 2e 20 54 68 65 20 70 61 67 65 e file. The page
d8a0: 20 69 73 20 6c 65 66 74 20 6d 61 72 6b 65 64 20 is left marked
d8b0: 64 69 72 74 79 20 69 6e 20 74 68 69 73 20 63 61 dirty in this ca
d8c0: 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41 6e se.. **. ** An
d8d0: 20 65 78 63 65 70 74 69 6f 6e 20 74 6f 20 74 68 exception to th
d8e0: 65 20 61 62 6f 76 65 20 72 75 6c 65 3a 20 49 66 e above rule: If
d8f0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 the database is
d900: 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 in no-sync mode
d910: 0a 20 20 2a 2a 20 61 6e 64 20 61 20 70 61 67 65 . ** and a page
d920: 20 69 73 20 6d 6f 76 65 64 20 64 75 72 69 6e 67 is moved during
d930: 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 61 6c 20 an incremental
d940: 76 61 63 75 75 6d 20 74 68 65 6e 20 74 68 65 20 vacuum then the
d950: 70 61 67 65 20 6d 61 79 0a 20 20 2a 2a 20 6e 6f page may. ** no
d960: 74 20 62 65 20 69 6e 20 74 68 65 20 70 61 67 65 t be in the page
d970: 72 20 63 61 63 68 65 2e 20 4c 61 74 65 72 3a 20 r cache. Later:
d980: 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20 6f 72 if a malloc() or
d990: 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 IO error occurs
d9a0: 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 61 20 4d . ** during a M
d9b0: 6f 76 65 70 61 67 65 28 29 20 63 61 6c 6c 2c 20 ovepage() call,
d9c0: 74 68 65 6e 20 74 68 65 20 70 61 67 65 20 6d 61 then the page ma
d9d0: 79 20 6e 6f 74 20 62 65 20 69 6e 20 74 68 65 20 y not be in the
d9e0: 63 61 63 68 65 0a 20 20 2a 2a 20 65 69 74 68 65 cache. ** eithe
d9f0: 72 2e 20 53 6f 20 74 68 65 20 63 6f 6e 64 69 74 r. So the condit
da00: 69 6f 6e 20 64 65 73 63 72 69 62 65 64 20 69 6e ion described in
da10: 20 74 68 65 20 61 62 6f 76 65 20 70 61 72 61 67 the above parag
da20: 72 61 70 68 20 69 73 20 6e 6f 74 0a 20 20 2a 2a raph is not. **
da30: 20 61 73 73 65 72 74 28 29 61 62 6c 65 2e 0a 20 assert()able..
da40: 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 69 6e 20 45 **. ** If in E
da50: 58 43 4c 55 53 49 56 45 20 73 74 61 74 65 2c 20 XCLUSIVE state,
da60: 74 68 65 6e 20 77 65 20 75 70 64 61 74 65 20 74 then we update t
da70: 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 69 he pager cache i
da80: 66 20 69 74 20 65 78 69 73 74 73 0a 20 20 2a 2a f it exists. **
da90: 20 61 6e 64 20 74 68 65 20 6d 61 69 6e 20 66 69 and the main fi
daa0: 6c 65 2e 20 54 68 65 20 70 61 67 65 20 69 73 20 le. The page is
dab0: 74 68 65 6e 20 6d 61 72 6b 65 64 20 6e 6f 74 20 then marked not
dac0: 64 69 72 74 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a dirty.. **. **
dad0: 20 54 69 63 6b 65 74 20 23 31 31 37 31 3a 20 20 Ticket #1171:
dae0: 54 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f The statement jo
daf0: 75 72 6e 61 6c 20 6d 69 67 68 74 20 63 6f 6e 74 urnal might cont
db00: 61 69 6e 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 ain page content
db10: 20 74 68 61 74 20 69 73 0a 20 20 2a 2a 20 64 69 that is. ** di
db20: 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 fferent from the
db30: 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 61 74 page content at
db40: 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 the start of th
db50: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 e transaction..
db60: 20 2a 2a 20 54 68 69 73 20 6f 63 63 75 72 73 20 ** This occurs
db70: 77 68 65 6e 20 61 20 70 61 67 65 20 69 73 20 63 when a page is c
db80: 68 61 6e 67 65 64 20 70 72 69 6f 72 20 74 6f 20 hanged prior to
db90: 74 68 65 20 73 74 61 72 74 20 6f 66 20 61 20 73 the start of a s
dba0: 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 74 68 tatement. ** th
dbb0: 65 6e 20 63 68 61 6e 67 65 64 20 61 67 61 69 6e en changed again
dbc0: 20 77 69 74 68 69 6e 20 74 68 65 20 73 74 61 74 within the stat
dbd0: 65 6d 65 6e 74 2e 20 20 57 68 65 6e 20 72 6f 6c ement. When rol
dbe0: 6c 69 6e 67 20 62 61 63 6b 20 73 75 63 68 20 61 ling back such a
dbf0: 0a 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 . ** statement
dc00: 77 65 20 6d 75 73 74 20 6e 6f 74 20 77 72 69 74 we must not writ
dc10: 65 20 74 6f 20 74 68 65 20 6f 72 69 67 69 6e 61 e to the origina
dc20: 6c 20 64 61 74 61 62 61 73 65 20 75 6e 6c 65 73 l database unles
dc30: 73 20 77 65 20 6b 6e 6f 77 0a 20 20 2a 2a 20 66 s we know. ** f
dc40: 6f 72 20 63 65 72 74 61 69 6e 20 74 68 61 74 20 or certain that
dc50: 6f 72 69 67 69 6e 61 6c 20 70 61 67 65 20 63 6f original page co
dc60: 6e 74 65 6e 74 73 20 61 72 65 20 73 79 6e 63 65 ntents are synce
dc70: 64 20 69 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 d into the main
dc80: 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f rollback. ** jo
dc90: 75 72 6e 61 6c 2e 20 20 4f 74 68 65 72 77 69 73 urnal. Otherwis
dca0: 65 2c 20 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 e, a power loss
dcb0: 6d 69 67 68 74 20 6c 65 61 76 65 20 6d 6f 64 69 might leave modi
dcc0: 66 69 65 64 20 64 61 74 61 20 69 6e 20 74 68 65 fied data in the
dcd0: 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 . ** database f
dce0: 69 6c 65 20 77 69 74 68 6f 75 74 20 61 6e 20 65 ile without an e
dcf0: 6e 74 72 79 20 69 6e 20 74 68 65 20 72 6f 6c 6c ntry in the roll
dd00: 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 74 68 61 back journal tha
dd10: 74 20 63 61 6e 0a 20 20 2a 2a 20 72 65 73 74 6f t can. ** resto
dd20: 72 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20 re the database
dd30: 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 to its original
dd40: 66 6f 72 6d 2e 20 20 54 77 6f 20 63 6f 6e 64 69 form. Two condi
dd50: 74 69 6f 6e 73 20 6d 75 73 74 20 62 65 0a 20 20 tions must be.
dd60: 2a 2a 20 6d 65 74 20 62 65 66 6f 72 65 20 77 72 ** met before wr
dd70: 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 iting to the dat
dd80: 61 62 61 73 65 20 66 69 6c 65 73 2e 20 28 31 29 abase files. (1)
dd90: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 6d 75 the database mu
dda0: 73 74 20 62 65 0a 20 20 2a 2a 20 6c 6f 63 6b 65 st be. ** locke
ddb0: 64 2e 20 20 28 32 29 20 77 65 20 6b 6e 6f 77 20 d. (2) we know
ddc0: 74 68 61 74 20 74 68 65 20 6f 72 69 67 69 6e 61 that the origina
ddd0: 6c 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 69 l page content i
dde0: 73 20 66 75 6c 6c 79 20 73 79 6e 63 65 64 0a 20 s fully synced.
ddf0: 20 2a 2a 20 69 6e 20 74 68 65 20 6d 61 69 6e 20 ** in the main
de00: 6a 6f 75 72 6e 61 6c 20 65 69 74 68 65 72 20 62 journal either b
de10: 65 63 61 75 73 65 20 74 68 65 20 70 61 67 65 20 ecause the page
de20: 69 73 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 20 is not in cache
de30: 6f 72 20 65 6c 73 65 0a 20 20 2a 2a 20 74 68 65 or else. ** the
de40: 20 70 61 67 65 20 69 73 20 6d 61 72 6b 65 64 20 page is marked
de50: 61 73 20 6e 65 65 64 53 79 6e 63 3d 3d 30 2e 0a as needSync==0..
de60: 20 20 2a 2a 0a 20 20 2a 2a 20 32 30 30 38 2d 30 **. ** 2008-0
de70: 34 2d 31 34 3a 20 20 57 68 65 6e 20 61 74 74 65 4-14: When atte
de80: 6d 70 74 69 6e 67 20 74 6f 20 76 61 63 75 75 6d mpting to vacuum
de90: 20 61 20 63 6f 72 72 75 70 74 20 64 61 74 61 62 a corrupt datab
dea0: 61 73 65 20 66 69 6c 65 2c 20 69 74 0a 20 20 2a ase file, it. *
deb0: 2a 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f * is possible to
dec0: 20 66 61 69 6c 20 61 20 73 74 61 74 65 6d 65 6e fail a statemen
ded0: 74 20 6f 6e 20 61 20 64 61 74 61 62 61 73 65 20 t on a database
dee0: 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 79 65 that does not ye
def0: 74 20 65 78 69 73 74 2e 0a 20 20 2a 2a 20 44 6f t exist.. ** Do
df00: 20 6e 6f 74 20 61 74 74 65 6d 70 74 20 74 6f 20 not attempt to
df10: 77 72 69 74 65 20 69 66 20 64 61 74 61 62 61 73 write if databas
df20: 65 20 66 69 6c 65 20 68 61 73 20 6e 65 76 65 72 e file has never
df30: 20 62 65 65 6e 20 6f 70 65 6e 65 64 2e 0a 20 20 been opened..
df40: 2a 2f 0a 20 20 70 50 67 20 3d 20 70 61 67 65 72 */. pPg = pager
df50: 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 _lookup(pPager,
df60: 70 67 6e 6f 29 3b 0a 20 20 50 41 47 45 52 54 52 pgno);. PAGERTR
df70: 41 43 45 34 28 22 50 4c 41 59 42 41 43 4b 20 25 ACE4("PLAYBACK %
df80: 64 20 70 61 67 65 20 25 64 20 68 61 73 68 28 25 d page %d hash(%
df90: 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20 08x)\n",.
dfa0: 20 20 20 20 20 20 20 20 50 41 47 45 52 49 44 28 PAGERID(
dfb0: 70 50 61 67 65 72 29 2c 20 70 67 6e 6f 2c 20 70 pPager), pgno, p
dfc0: 61 67 65 72 5f 64 61 74 61 68 61 73 68 28 70 50 ager_datahash(pP
dfd0: 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 ager->pageSize,
dfe0: 61 44 61 74 61 29 29 3b 0a 20 20 69 66 28 20 70 aData));. if( p
dff0: 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 Pager->state>=PA
e000: 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 26 26 GER_EXCLUSIVE &&
e010: 20 28 70 50 67 3d 3d 30 20 7c 7c 20 70 50 67 2d (pPg==0 || pPg-
e020: 3e 6e 65 65 64 53 79 6e 63 3d 3d 30 29 0a 20 20 >needSync==0).
e030: 20 20 20 20 20 20 26 26 20 70 50 61 67 65 72 2d && pPager-
e040: 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 7b >fd->pMethods ){
e050: 0a 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 20 . i64 offset
e060: 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 69 36 34 29 = (pgno-1)*(i64)
e070: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
e080: 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
e090: 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
e0a0: 2d 3e 66 64 2c 20 61 44 61 74 61 2c 20 70 50 61 ->fd, aData, pPa
e0b0: 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f ger->pageSize, o
e0c0: 66 66 73 65 74 29 3b 0a 20 20 20 20 69 66 28 20 ffset);. if(
e0d0: 70 50 67 20 29 7b 0a 20 20 20 20 20 20 6d 61 6b pPg ){. mak
e0e0: 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 20 eClean(pPg);.
e0f0: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67 }. }. if( pPg
e100: 20 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 70 61 ){. /* No pa
e110: 67 65 20 73 68 6f 75 6c 64 20 65 76 65 72 20 62 ge should ever b
e120: 65 20 65 78 70 6c 69 63 69 74 6c 79 20 72 6f 6c e explicitly rol
e130: 6c 65 64 20 62 61 63 6b 20 74 68 61 74 20 69 73 led back that is
e140: 20 69 6e 20 75 73 65 2c 20 65 78 63 65 70 74 0a in use, except.
e150: 20 20 20 20 2a 2a 20 66 6f 72 20 70 61 67 65 20 ** for page
e160: 31 20 77 68 69 63 68 20 69 73 20 68 65 6c 64 20 1 which is held
e170: 69 6e 20 75 73 65 20 69 6e 20 6f 72 64 65 72 20 in use in order
e180: 74 6f 20 6b 65 65 70 20 74 68 65 20 6c 6f 63 6b to keep the lock
e190: 20 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 on the. ** d
e1a0: 61 74 61 62 61 73 65 20 61 63 74 69 76 65 2e 20 atabase active.
e1b0: 48 6f 77 65 76 65 72 20 73 75 63 68 20 61 20 70 However such a p
e1c0: 61 67 65 20 6d 61 79 20 62 65 20 72 6f 6c 6c 65 age may be rolle
e1d0: 64 20 62 61 63 6b 20 61 73 20 61 20 72 65 73 75 d back as a resu
e1e0: 6c 74 0a 20 20 20 20 2a 2a 20 6f 66 20 61 6e 20 lt. ** of an
e1f0: 69 6e 74 65 72 6e 61 6c 20 65 72 72 6f 72 20 72 internal error r
e200: 65 73 75 6c 74 69 6e 67 20 69 6e 20 61 6e 20 61 esulting in an a
e210: 75 74 6f 6d 61 74 69 63 20 63 61 6c 6c 20 74 6f utomatic call to
e220: 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 50 . ** sqlite3P
e230: 61 67 65 72 52 6f 6c 6c 62 61 63 6b 28 29 2e 0a agerRollback()..
e240: 20 20 20 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20 */. void
e250: 2a 70 44 61 74 61 3b 0a 20 20 20 20 2f 2a 20 61 *pData;. /* a
e260: 73 73 65 72 74 28 20 70 50 67 2d 3e 6e 52 65 66 ssert( pPg->nRef
e270: 3d 3d 30 20 7c 7c 20 70 50 67 2d 3e 70 67 6e 6f ==0 || pPg->pgno
e280: 3d 3d 31 20 29 3b 20 2a 2f 0a 20 20 20 20 70 44 ==1 ); */. pD
e290: 61 74 61 20 3d 20 50 47 48 44 52 5f 54 4f 5f 44 ata = PGHDR_TO_D
e2a0: 41 54 41 28 70 50 67 29 3b 0a 20 20 20 20 6d 65 ATA(pPg);. me
e2b0: 6d 63 70 79 28 70 44 61 74 61 2c 20 61 44 61 74 mcpy(pData, aDat
e2c0: 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 a, pPager->pageS
e2d0: 69 7a 65 29 3b 0a 20 20 20 20 69 66 28 20 70 50 ize);. if( pP
e2e0: 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 20 ager->xReiniter
e2f0: 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d ){. pPager-
e300: 3e 78 52 65 69 6e 69 74 65 72 28 70 50 67 2c 20 >xReiniter(pPg,
e310: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
e320: 29 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 );. }.#ifdef
e330: 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 SQLITE_CHECK_PAG
e340: 45 53 0a 20 20 20 20 70 50 67 2d 3e 70 61 67 65 ES. pPg->page
e350: 48 61 73 68 20 3d 20 70 61 67 65 72 5f 70 61 67 Hash = pager_pag
e360: 65 68 61 73 68 28 70 50 67 29 3b 0a 23 65 6e 64 ehash(pPg);.#end
e370: 69 66 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 if. /* If thi
e380: 73 20 77 61 73 20 70 61 67 65 20 31 2c 20 74 68 s was page 1, th
e390: 65 6e 20 72 65 73 74 6f 72 65 20 74 68 65 20 76 en restore the v
e3a0: 61 6c 75 65 20 6f 66 20 50 61 67 65 72 2e 64 62 alue of Pager.db
e3b0: 46 69 6c 65 56 65 72 73 2e 0a 20 20 20 20 2a 2a FileVers.. **
e3c0: 20 44 6f 20 74 68 69 73 20 62 65 66 6f 72 65 20 Do this before
e3d0: 61 6e 79 20 64 65 63 6f 64 69 6e 67 2e 20 2a 2f any decoding. */
e3e0: 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3d 3d 31 . if( pgno==1
e3f0: 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 ){. memcpy
e400: 28 26 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 (&pPager->dbFile
e410: 56 65 72 73 2c 20 26 28 28 75 38 2a 29 70 44 61 Vers, &((u8*)pDa
e420: 74 61 29 5b 32 34 5d 2c 73 69 7a 65 6f 66 28 70 ta)[24],sizeof(p
e430: 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 Pager->dbFileVer
e440: 73 29 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 s));. }..
e450: 2f 2a 20 44 65 63 6f 64 65 20 74 68 65 20 70 61 /* Decode the pa
e460: 67 65 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f ge just read fro
e470: 6d 20 64 69 73 6b 20 2a 2f 0a 20 20 20 20 43 4f m disk */. CO
e480: 44 45 43 31 28 70 50 61 67 65 72 2c 20 70 44 61 DEC1(pPager, pDa
e490: 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 ta, pPg->pgno, 3
e4a0: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 );. }. return
e4b0: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 72 rc;.}../*.** Par
e4c0: 61 6d 65 74 65 72 20 7a 4d 61 73 74 65 72 20 69 ameter zMaster i
e4d0: 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 s the name of a
e4e0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
e4f0: 69 6c 65 2e 20 41 20 73 69 6e 67 6c 65 20 6a 6f ile. A single jo
e500: 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20 74 68 urnal.** file th
e510: 61 74 20 72 65 66 65 72 72 65 64 20 74 6f 20 74 at referred to t
e520: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
e530: 6c 20 66 69 6c 65 20 68 61 73 20 6a 75 73 74 20 l file has just
e540: 62 65 65 6e 20 72 6f 6c 6c 65 64 20 62 61 63 6b been rolled back
e550: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e ..** This routin
e560: 65 20 63 68 65 63 6b 73 20 69 66 20 69 74 20 69 e checks if it i
e570: 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 64 65 s possible to de
e580: 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 lete the master
e590: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 0a 2a 2a journal file,.**
e5a0: 20 61 6e 64 20 64 6f 65 73 20 73 6f 20 69 66 20 and does so if
e5b0: 69 74 20 69 73 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 it is..**.** Arg
e5c0: 75 6d 65 6e 74 20 7a 4d 61 73 74 65 72 20 6d 61 ument zMaster ma
e5d0: 79 20 70 6f 69 6e 74 20 74 6f 20 50 61 67 65 72 y point to Pager
e5e0: 2e 70 54 6d 70 53 70 61 63 65 2e 20 53 6f 20 74 .pTmpSpace. So t
e5f0: 68 61 74 20 62 75 66 66 65 72 20 69 73 20 6e 6f hat buffer is no
e600: 74 20 0a 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 t .** available
e610: 66 6f 72 20 75 73 65 20 77 69 74 68 69 6e 20 74 for use within t
e620: 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a his function..**
e630: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 73 74 65 .**.** The maste
e640: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 r journal file c
e650: 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 ontains the name
e660: 73 20 6f 66 20 61 6c 6c 20 63 68 69 6c 64 20 6a s of all child j
e670: 6f 75 72 6e 61 6c 73 2e 0a 2a 2a 20 54 6f 20 74 ournals..** To t
e680: 65 6c 6c 20 69 66 20 61 20 6d 61 73 74 65 72 20 ell if a master
e690: 6a 6f 75 72 6e 61 6c 20 63 61 6e 20 62 65 20 64 journal can be d
e6a0: 65 6c 65 74 65 64 2c 20 63 68 65 63 6b 20 74 6f eleted, check to
e6b0: 20 65 61 63 68 20 6f 66 20 74 68 65 0a 2a 2a 20 each of the.**
e6c0: 63 68 69 6c 64 72 65 6e 2e 20 20 49 66 20 61 6c children. If al
e6d0: 6c 20 63 68 69 6c 64 72 65 6e 20 61 72 65 20 65 l children are e
e6e0: 69 74 68 65 72 20 6d 69 73 73 69 6e 67 20 6f 72 ither missing or
e6f0: 20 64 6f 20 6e 6f 74 20 72 65 66 65 72 20 74 6f do not refer to
e700: 0a 2a 2a 20 61 20 64 69 66 66 65 72 65 6e 74 20 .** a different
e710: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2c 20 master journal,
e720: 74 68 65 6e 20 74 68 69 73 20 6d 61 73 74 65 72 then this master
e730: 20 6a 6f 75 72 6e 61 6c 20 63 61 6e 20 62 65 20 journal can be
e740: 64 65 6c 65 74 65 64 2e 0a 2a 2f 0a 73 74 61 74 deleted..*/.stat
e750: 69 63 20 69 6e 74 20 70 61 67 65 72 5f 64 65 6c ic int pager_del
e760: 6d 61 73 74 65 72 28 50 61 67 65 72 20 2a 70 50 master(Pager *pP
e770: 61 67 65 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 ager, const char
e780: 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 20 73 71 *zMaster){. sq
e790: 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 20 lite3_vfs *pVfs
e7a0: 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a = pPager->pVfs;.
e7b0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 int rc;. int
e7c0: 6d 61 73 74 65 72 5f 6f 70 65 6e 20 3d 20 30 3b master_open = 0;
e7d0: 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 . sqlite3_file
e7e0: 2a 70 4d 61 73 74 65 72 3b 0a 20 20 73 71 6c 69 *pMaster;. sqli
e7f0: 74 65 33 5f 66 69 6c 65 20 2a 70 4a 6f 75 72 6e te3_file *pJourn
e800: 61 6c 3b 0a 20 20 63 68 61 72 20 2a 7a 4d 61 73 al;. char *zMas
e810: 74 65 72 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 20 terJournal = 0;
e820: 2f 2a 20 43 6f 6e 74 65 6e 74 73 20 6f 66 20 6d /* Contents of m
e830: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
e840: 6c 65 20 2a 2f 0a 20 20 69 36 34 20 6e 4d 61 73 le */. i64 nMas
e850: 74 65 72 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20 terJournal;
e860: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6d 61 73 /* Size of mas
e870: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
e880: 20 2a 2f 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 */.. /* Open t
e890: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
e8a0: 6c 20 66 69 6c 65 20 65 78 63 6c 75 73 69 76 65 l file exclusive
e8b0: 6c 79 20 69 6e 20 63 61 73 65 20 73 6f 6d 65 20 ly in case some
e8c0: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 0a 20 20 other process.
e8d0: 2a 2a 20 69 73 20 72 75 6e 6e 69 6e 67 20 74 68 ** is running th
e8e0: 69 73 20 72 6f 75 74 69 6e 65 20 61 6c 73 6f 2e is routine also.
e8f0: 20 4e 6f 74 20 74 68 61 74 20 69 74 20 6d 61 6b Not that it mak
e900: 65 73 20 74 6f 6f 20 6d 75 63 68 20 64 69 66 66 es too much diff
e910: 65 72 65 6e 63 65 2e 0a 20 20 2a 2f 0a 20 20 70 erence.. */. p
e920: 4d 61 73 74 65 72 20 3d 20 28 73 71 6c 69 74 65 Master = (sqlite
e930: 33 5f 66 69 6c 65 20 2a 29 73 71 6c 69 74 65 33 3_file *)sqlite3
e940: 5f 6d 61 6c 6c 6f 63 28 70 56 66 73 2d 3e 73 7a _malloc(pVfs->sz
e950: 4f 73 46 69 6c 65 20 2a 20 32 29 3b 0a 20 20 70 OsFile * 2);. p
e960: 4a 6f 75 72 6e 61 6c 20 3d 20 28 73 71 6c 69 74 Journal = (sqlit
e970: 65 33 5f 66 69 6c 65 20 2a 29 28 28 28 75 38 20 e3_file *)(((u8
e980: 2a 29 70 4d 61 73 74 65 72 29 20 2b 20 70 56 66 *)pMaster) + pVf
e990: 73 2d 3e 73 7a 4f 73 46 69 6c 65 29 3b 0a 20 20 s->szOsFile);.
e9a0: 69 66 28 20 21 70 4d 61 73 74 65 72 20 29 7b 0a if( !pMaster ){.
e9b0: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
e9c0: 4e 4f 4d 45 4d 3b 0a 20 20 7d 65 6c 73 65 7b 0a NOMEM;. }else{.
e9d0: 20 20 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 int flags =
e9e0: 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 (SQLITE_OPEN_REA
e9f0: 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 45 DONLY|SQLITE_OPE
ea00: 4e 5f 4d 41 53 54 45 52 5f 4a 4f 55 52 4e 41 4c N_MASTER_JOURNAL
ea10: 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 );. rc = sqli
ea20: 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 te3OsOpen(pVfs,
ea30: 7a 4d 61 73 74 65 72 2c 20 70 4d 61 73 74 65 72 zMaster, pMaster
ea40: 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a 20 20 7d , flags, 0);. }
ea50: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
ea60: 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 6c 6d E_OK ) goto delm
ea70: 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 6d 61 73 aster_out;. mas
ea80: 74 65 72 5f 6f 70 65 6e 20 3d 20 31 3b 0a 0a 20 ter_open = 1;..
ea90: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 rc = sqlite3OsF
eaa0: 69 6c 65 53 69 7a 65 28 70 4d 61 73 74 65 72 2c ileSize(pMaster,
eab0: 20 26 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c &nMasterJournal
eac0: 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
ead0: 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 ITE_OK ) goto de
eae0: 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20 20 lmaster_out;..
eaf0: 69 66 28 20 6e 4d 61 73 74 65 72 4a 6f 75 72 6e if( nMasterJourn
eb00: 61 6c 3e 30 20 29 7b 0a 20 20 20 20 63 68 61 72 al>0 ){. char
eb10: 20 2a 7a 4a 6f 75 72 6e 61 6c 3b 0a 20 20 20 20 *zJournal;.
eb20: 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 50 74 72 char *zMasterPtr
eb30: 20 3d 20 30 3b 0a 20 20 20 20 69 6e 74 20 6e 4d = 0;. int nM
eb40: 61 73 74 65 72 50 74 72 20 3d 20 70 50 61 67 65 asterPtr = pPage
eb50: 72 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e r->pVfs->mxPathn
eb60: 61 6d 65 2b 31 3b 0a 0a 20 20 20 20 2f 2a 20 4c ame+1;.. /* L
eb70: 6f 61 64 20 74 68 65 20 65 6e 74 69 72 65 20 6d oad the entire m
eb80: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
eb90: 6c 65 20 69 6e 74 6f 20 73 70 61 63 65 20 6f 62 le into space ob
eba0: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 20 20 20 20 tained from.
ebb0: 2a 2a 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f ** sqlite3_mallo
ebc0: 63 28 29 20 61 6e 64 20 70 6f 69 6e 74 65 64 20 c() and pointed
ebd0: 74 6f 20 62 79 20 7a 4d 61 73 74 65 72 4a 6f 75 to by zMasterJou
ebe0: 72 6e 61 6c 2e 20 0a 20 20 20 20 2a 2f 0a 20 20 rnal. . */.
ebf0: 20 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c zMasterJournal
ec00: 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c 69 74 = (char *)sqlit
ec10: 65 33 5f 6d 61 6c 6c 6f 63 28 6e 4d 61 73 74 65 e3_malloc(nMaste
ec20: 72 4a 6f 75 72 6e 61 6c 20 2b 20 6e 4d 61 73 74 rJournal + nMast
ec30: 65 72 50 74 72 29 3b 0a 20 20 20 20 69 66 28 20 erPtr);. if(
ec40: 21 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 20 !zMasterJournal
ec50: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
ec60: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 LITE_NOMEM;.
ec70: 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 goto delmaster
ec80: 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 _out;. }.
ec90: 7a 4d 61 73 74 65 72 50 74 72 20 3d 20 26 7a 4d zMasterPtr = &zM
eca0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 5b 6e 4d 61 asterJournal[nMa
ecb0: 73 74 65 72 4a 6f 75 72 6e 61 6c 5d 3b 0a 20 20 sterJournal];.
ecc0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
ecd0: 52 65 61 64 28 70 4d 61 73 74 65 72 2c 20 7a 4d Read(pMaster, zM
ece0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 6e 4d asterJournal, nM
ecf0: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 2c 20 30 29 asterJournal, 0)
ed00: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
ed10: 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 LITE_OK ) goto d
ed20: 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 0a 20 elmaster_out;..
ed30: 20 20 20 7a 4a 6f 75 72 6e 61 6c 20 3d 20 7a 4d zJournal = zM
ed40: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 3b 0a 20 20 asterJournal;.
ed50: 20 20 77 68 69 6c 65 28 20 28 7a 4a 6f 75 72 6e while( (zJourn
ed60: 61 6c 2d 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 al-zMasterJourna
ed70: 6c 29 3c 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 l)<nMasterJourna
ed80: 6c 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 l ){. rc =
ed90: 73 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 sqlite3OsAccess(
eda0: 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c 2c 20 pVfs, zJournal,
edb0: 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 58 SQLITE_ACCESS_EX
edc0: 49 53 54 53 29 3b 0a 20 20 20 20 20 20 69 66 28 ISTS);. if(
edd0: 20 72 63 21 3d 30 20 26 26 20 72 63 21 3d 31 20 rc!=0 && rc!=1
ede0: 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
edf0: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d SQLITE_IOERR_NOM
ee00: 45 4d 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f EM;. goto
ee10: 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a delmaster_out;.
ee20: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 }. if
ee30: 28 20 72 63 3d 3d 31 20 29 7b 0a 20 20 20 20 20 ( rc==1 ){.
ee40: 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
ee50: 20 6a 6f 75 72 6e 61 6c 73 20 70 6f 69 6e 74 65 journals pointe
ee60: 64 20 74 6f 20 62 79 20 74 68 65 20 6d 61 73 74 d to by the mast
ee70: 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 er journal exist
ee80: 73 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 4f 70 s.. ** Op
ee90: 65 6e 20 69 74 20 61 6e 64 20 63 68 65 63 6b 20 en it and check
eea0: 69 66 20 69 74 20 70 6f 69 6e 74 73 20 61 74 20 if it points at
eeb0: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e the master journ
eec0: 61 6c 2e 20 49 66 0a 20 20 20 20 20 20 20 20 2a al. If. *
eed0: 2a 20 73 6f 2c 20 72 65 74 75 72 6e 20 77 69 74 * so, return wit
eee0: 68 6f 75 74 20 64 65 6c 65 74 69 6e 67 20 74 68 hout deleting th
eef0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
ef00: 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 20 20 2a file.. *
ef10: 2f 0a 20 20 20 20 20 20 20 20 69 6e 74 20 63 3b /. int c;
ef20: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 66 6c 61 . int fla
ef30: 67 73 20 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45 gs = (SQLITE_OPE
ef40: 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 54 N_READONLY|SQLIT
ef50: 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 E_OPEN_MAIN_JOUR
ef60: 4e 41 4c 29 3b 0a 20 20 20 20 20 20 20 20 72 63 NAL);. rc
ef70: 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e = sqlite3OsOpen
ef80: 28 70 56 66 73 2c 20 7a 4a 6f 75 72 6e 61 6c 2c (pVfs, zJournal,
ef90: 20 70 4a 6f 75 72 6e 61 6c 2c 20 66 6c 61 67 73 pJournal, flags
efa0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 69 66 , 0);. if
efb0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
efc0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 ){. got
efd0: 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b o delmaster_out;
efe0: 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 . }..
eff0: 20 20 20 20 72 63 20 3d 20 72 65 61 64 4d 61 73 rc = readMas
f000: 74 65 72 4a 6f 75 72 6e 61 6c 28 70 4a 6f 75 72 terJournal(pJour
f010: 6e 61 6c 2c 20 7a 4d 61 73 74 65 72 50 74 72 2c nal, zMasterPtr,
f020: 20 6e 4d 61 73 74 65 72 50 74 72 29 3b 0a 20 20 nMasterPtr);.
f030: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
f040: 6c 6f 73 65 28 70 4a 6f 75 72 6e 61 6c 29 3b 0a lose(pJournal);.
f050: 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
f060: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
f070: 20 20 20 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d goto delm
f080: 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20 20 20 aster_out;.
f090: 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 63 20 }.. c
f0a0: 3d 20 7a 4d 61 73 74 65 72 50 74 72 5b 30 5d 21 = zMasterPtr[0]!
f0b0: 3d 30 20 26 26 20 73 74 72 63 6d 70 28 7a 4d 61 =0 && strcmp(zMa
f0c0: 73 74 65 72 50 74 72 2c 20 7a 4d 61 73 74 65 72 sterPtr, zMaster
f0d0: 29 3d 3d 30 3b 0a 20 20 20 20 20 20 20 20 69 66 )==0;. if
f0e0: 28 20 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ( c ){.
f0f0: 20 2f 2a 20 57 65 20 68 61 76 65 20 61 20 6d 61 /* We have a ma
f100: 74 63 68 2e 20 44 6f 20 6e 6f 74 20 64 65 6c 65 tch. Do not dele
f110: 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f te the master jo
f120: 75 72 6e 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 urnal file. */.
f130: 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 64 65 goto de
f140: 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20 lmaster_out;.
f150: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
f160: 20 20 20 20 20 7a 4a 6f 75 72 6e 61 6c 20 2b 3d zJournal +=
f170: 20 28 73 74 72 6c 65 6e 28 7a 4a 6f 75 72 6e 61 (strlen(zJourna
f180: 6c 29 2b 31 29 3b 0a 20 20 20 20 7d 0a 20 20 7d l)+1);. }. }
f190: 0a 20 20 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 . . rc = sqlit
f1a0: 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66 73 2c e3OsDelete(pVfs,
f1b0: 20 7a 4d 61 73 74 65 72 2c 20 30 29 3b 0a 0a 64 zMaster, 0);..d
f1c0: 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3a 0a 20 20 elmaster_out:.
f1d0: 69 66 28 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e if( zMasterJourn
f1e0: 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 al ){. sqlite
f1f0: 33 5f 66 72 65 65 28 7a 4d 61 73 74 65 72 4a 6f 3_free(zMasterJo
f200: 75 72 6e 61 6c 29 3b 0a 20 20 7d 20 20 0a 20 20 urnal);. } .
f210: 69 66 28 20 6d 61 73 74 65 72 5f 6f 70 65 6e 20 if( master_open
f220: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 ){. sqlite3Os
f230: 43 6c 6f 73 65 28 70 4d 61 73 74 65 72 29 3b 0a Close(pMaster);.
f240: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 }. sqlite3_fr
f250: 65 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72 ee(pMaster);. r
f260: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 73 74 eturn rc;.}...st
f270: 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 5f atic void pager_
f280: 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65 28 50 truncate_cache(P
f290: 61 67 65 72 20 2a 70 50 61 67 65 72 29 3b 0a 0a ager *pPager);..
f2a0: 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 65 20 74 /*.** Truncate t
f2b0: 68 65 20 6d 61 69 6e 20 66 69 6c 65 20 6f 66 20 he main file of
f2c0: 74 68 65 20 67 69 76 65 6e 20 70 61 67 65 72 20 the given pager
f2d0: 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 to the number of
f2e0: 20 70 61 67 65 73 0a 2a 2a 20 69 6e 64 69 63 61 pages.** indica
f2f0: 74 65 64 2e 20 41 6c 73 6f 20 74 72 75 6e 63 61 ted. Also trunca
f300: 74 65 20 74 68 65 20 63 61 63 68 65 64 20 72 65 te the cached re
f310: 70 72 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 presentation of
f320: 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 the file..**.**
f330: 4d 69 67 68 74 20 6d 69 67 68 74 20 62 65 20 74 Might might be t
f340: 68 65 20 63 61 73 65 20 74 68 61 74 20 74 68 65 he case that the
f350: 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 69 73 file on disk is
f360: 20 73 6d 61 6c 6c 65 72 20 74 68 61 6e 20 6e 50 smaller than nP
f370: 61 67 65 2e 0a 2a 2a 20 54 68 69 73 20 63 61 6e age..** This can
f380: 20 68 61 70 70 65 6e 2c 20 66 6f 72 20 65 78 61 happen, for exa
f390: 6d 70 6c 65 2c 20 69 66 20 77 65 20 61 72 65 20 mple, if we are
f3a0: 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 20 6f 66 in the middle of
f3b0: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a a transaction.*
f3c0: 2a 20 77 68 69 63 68 20 68 61 73 20 65 78 74 65 * which has exte
f3d0: 6e 64 65 64 20 74 68 65 20 66 69 6c 65 20 73 69 nded the file si
f3e0: 7a 65 20 61 6e 64 20 74 68 65 20 6e 65 77 20 70 ze and the new p
f3f0: 61 67 65 73 20 61 72 65 20 73 74 69 6c 6c 20 61 ages are still a
f400: 6c 6c 20 68 65 6c 64 0a 2a 2a 20 69 6e 20 63 61 ll held.** in ca
f410: 63 68 65 2c 20 74 68 65 6e 20 61 6e 20 49 4e 53 che, then an INS
f420: 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 64 6f ERT or UPDATE do
f430: 65 73 20 61 20 73 74 61 74 65 6d 65 6e 74 20 72 es a statement r
f440: 6f 6c 6c 62 61 63 6b 2e 20 20 53 6f 6d 65 0a 2a ollback. Some.*
f450: 2a 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 * operating syst
f460: 65 6d 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f em implementatio
f470: 6e 73 20 63 61 6e 20 67 65 74 20 63 6f 6e 66 75 ns can get confu
f480: 73 65 64 20 69 66 20 79 6f 75 20 74 72 79 20 74 sed if you try t
f490: 6f 0a 2a 2a 20 74 72 75 6e 63 61 74 65 20 61 20 o.** truncate a
f4a0: 66 69 6c 65 20 74 6f 20 73 6f 6d 65 20 73 69 7a file to some siz
f4b0: 65 20 74 68 61 74 20 69 73 20 6c 61 72 67 65 72 e that is larger
f4c0: 20 74 68 61 6e 20 69 74 20 63 75 72 72 65 6e 74 than it current
f4d0: 6c 79 20 69 73 2c 0a 2a 2a 20 73 6f 20 64 65 74 ly is,.** so det
f4e0: 65 63 74 20 74 68 69 73 20 63 61 73 65 20 61 6e ect this case an
f4f0: 64 20 64 6f 20 6e 6f 74 20 64 6f 20 74 68 65 20 d do not do the
f500: 74 72 75 6e 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 truncation..*/.s
f510: 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f tatic int pager_
f520: 74 72 75 6e 63 61 74 65 28 50 61 67 65 72 20 2a truncate(Pager *
f530: 70 50 61 67 65 72 2c 20 69 6e 74 20 6e 50 61 67 pPager, int nPag
f540: 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 e){. int rc = S
f550: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 QLITE_OK;. if(
f560: 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50 pPager->state>=P
f570: 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 26 AGER_EXCLUSIVE &
f580: 26 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d & pPager->fd->pM
f590: 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 69 36 ethods ){. i6
f5a0: 34 20 63 75 72 72 65 6e 74 53 69 7a 65 2c 20 6e 4 currentSize, n
f5b0: 65 77 53 69 7a 65 3b 0a 20 20 20 20 72 63 20 3d ewSize;. rc =
f5c0: 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 sqlite3OsFileSi
f5d0: 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 ze(pPager->fd, &
f5e0: 63 75 72 72 65 6e 74 53 69 7a 65 29 3b 0a 20 20 currentSize);.
f5f0: 20 20 6e 65 77 53 69 7a 65 20 3d 20 70 50 61 67 newSize = pPag
f600: 65 72 2d 3e 70 61 67 65 53 69 7a 65 2a 28 69 36 er->pageSize*(i6
f610: 34 29 6e 50 61 67 65 3b 0a 20 20 20 20 69 66 28 4)nPage;. if(
f620: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
f630: 26 20 63 75 72 72 65 6e 74 53 69 7a 65 3e 6e 65 & currentSize>ne
f640: 77 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 72 wSize ){. r
f650: 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 75 c = sqlite3OsTru
f660: 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 66 64 ncate(pPager->fd
f670: 2c 20 6e 65 77 53 69 7a 65 29 3b 0a 20 20 20 20 , newSize);.
f680: 7d 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d }. }. if( rc==
f690: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
f6a0: 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 pPager->dbSize
f6b0: 3d 20 6e 50 61 67 65 3b 0a 20 20 20 20 70 61 67 = nPage;. pag
f6c0: 65 72 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68 er_truncate_cach
f6d0: 65 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 20 e(pPager);. }.
f6e0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
f6f0: 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 73 65 63 *.** Set the sec
f700: 74 6f 72 53 69 7a 65 20 66 6f 72 20 74 68 65 20 torSize for the
f710: 67 69 76 65 6e 20 70 61 67 65 72 2e 0a 2a 2a 0a given pager..**.
f720: 2a 2a 20 54 68 65 20 73 65 63 74 6f 72 20 73 69 ** The sector si
f730: 7a 65 20 69 73 20 61 74 20 6c 65 61 73 74 20 61 ze is at least a
f740: 73 20 62 69 67 20 61 73 20 74 68 65 20 73 65 63 s big as the sec
f750: 74 6f 72 20 73 69 7a 65 20 72 65 70 6f 72 74 65 tor size reporte
f760: 64 0a 2a 2a 20 62 79 20 73 71 6c 69 74 65 33 4f d.** by sqlite3O
f770: 73 53 65 63 74 6f 72 53 69 7a 65 28 29 2e 20 20 sSectorSize().
f780: 54 68 65 20 6d 69 6e 69 6d 75 6d 20 73 65 63 74 The minimum sect
f790: 6f 72 20 73 69 7a 65 20 69 73 20 35 31 32 2e 0a or size is 512..
f7a0: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 73 */.static void s
f7b0: 65 74 53 65 63 74 6f 72 53 69 7a 65 28 50 61 67 etSectorSize(Pag
f7c0: 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 61 er *pPager){. a
f7d0: 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 66 64 ssert(pPager->fd
f7e0: 2d 3e 70 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67 ->pMethods||pPag
f7f0: 65 72 2d 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20 er->tempFile);.
f800: 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 74 65 if( !pPager->te
f810: 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 2f 2a mpFile ){. /*
f820: 20 53 65 63 74 6f 72 20 73 69 7a 65 20 64 6f 65 Sector size doe
f830: 73 6e 27 74 20 6d 61 74 74 65 72 20 66 6f 72 20 sn't matter for
f840: 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e temporary files.
f850: 20 41 6c 73 6f 2c 20 74 68 65 20 66 69 6c 65 0a Also, the file.
f860: 20 20 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 68 ** may not h
f870: 61 76 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 ave been opened
f880: 79 65 74 2c 20 69 6e 20 77 68 63 69 68 20 63 61 yet, in whcih ca
f890: 73 65 20 74 68 65 20 4f 73 53 65 63 74 6f 72 53 se the OsSectorS
f8a0: 69 7a 65 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c ize(). ** cal
f8b0: 6c 20 77 69 6c 6c 20 73 65 67 66 61 75 6c 74 2e l will segfault.
f8c0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 70 50 61 67 . */. pPag
f8d0: 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d er->sectorSize =
f8e0: 20 73 71 6c 69 74 65 33 4f 73 53 65 63 74 6f 72 sqlite3OsSector
f8f0: 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 29 Size(pPager->fd)
f900: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 61 67 ;. }. if( pPag
f910: 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 3c 35 er->sectorSize<5
f920: 31 32 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 12 ){. pPager
f930: 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 35 ->sectorSize = 5
f940: 31 32 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 12;. }.}../*.**
f950: 20 50 6c 61 79 62 61 63 6b 20 74 68 65 20 6a 6f Playback the jo
f960: 75 72 6e 61 6c 20 61 6e 64 20 74 68 75 73 20 72 urnal and thus r
f970: 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 62 estore the datab
f980: 61 73 65 20 66 69 6c 65 20 74 6f 0a 2a 2a 20 74 ase file to.** t
f990: 68 65 20 73 74 61 74 65 20 69 74 20 77 61 73 20 he state it was
f9a0: 69 6e 20 62 65 66 6f 72 65 20 77 65 20 73 74 61 in before we sta
f9b0: 72 74 65 64 20 6d 61 6b 69 6e 67 20 63 68 61 6e rted making chan
f9c0: 67 65 73 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 65 ges. .**.** The
f9d0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f journal file fo
f9e0: 72 6d 61 74 20 69 73 20 61 73 20 66 6f 6c 6c 6f rmat is as follo
f9f0: 77 73 3a 20 0a 2a 2a 0a 2a 2a 20 20 28 31 29 20 ws: .**.** (1)
fa00: 20 38 20 62 79 74 65 20 70 72 65 66 69 78 2e 20 8 byte prefix.
fa10: 20 41 20 63 6f 70 79 20 6f 66 20 61 4a 6f 75 72 A copy of aJour
fa20: 6e 61 6c 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 20 20 nalMagic[]..**
fa30: 28 32 29 20 20 34 20 62 79 74 65 20 62 69 67 2d (2) 4 byte big-
fa40: 65 6e 64 69 61 6e 20 69 6e 74 65 67 65 72 20 77 endian integer w
fa50: 68 69 63 68 20 69 73 20 74 68 65 20 6e 75 6d 62 hich is the numb
fa60: 65 72 20 6f 66 20 76 61 6c 69 64 20 70 61 67 65 er of valid page
fa70: 20 72 65 63 6f 72 64 73 0a 2a 2a 20 20 20 20 20 records.**
fa80: 20 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c in the journal
fa90: 2e 20 20 49 66 20 74 68 69 73 20 76 61 6c 75 65 . If this value
faa0: 20 69 73 20 30 78 66 66 66 66 66 66 66 66 2c 20 is 0xffffffff,
fab0: 74 68 65 6e 20 63 6f 6d 70 75 74 65 20 74 68 65 then compute the
fac0: 0a 2a 2a 20 20 20 20 20 20 20 6e 75 6d 62 65 72 .** number
fad0: 20 6f 66 20 70 61 67 65 20 72 65 63 6f 72 64 73 of page records
fae0: 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 from the journa
faf0: 6c 20 73 69 7a 65 2e 0a 2a 2a 20 20 28 33 29 20 l size..** (3)
fb00: 20 34 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69 4 byte big-endi
fb10: 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 an integer which
fb20: 20 69 73 20 74 68 65 20 69 6e 69 74 69 61 6c 20 is the initial
fb30: 76 61 6c 75 65 20 66 6f 72 20 74 68 65 20 0a 2a value for the .*
fb40: 2a 20 20 20 20 20 20 20 73 61 6e 69 74 79 20 63 * sanity c
fb50: 68 65 63 6b 73 75 6d 2e 0a 2a 2a 20 20 28 34 29 hecksum..** (4)
fb60: 20 20 34 20 62 79 74 65 20 69 6e 74 65 67 65 72 4 byte integer
fb70: 20 77 68 69 63 68 20 69 73 20 74 68 65 20 6e 75 which is the nu
fb80: 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f mber of pages to
fb90: 20 74 72 75 6e 63 61 74 65 20 74 68 65 0a 2a 2a truncate the.**
fba0: 20 20 20 20 20 20 20 64 61 74 61 62 61 73 65 20 database
fbb0: 74 6f 20 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c to during a roll
fbc0: 62 61 63 6b 2e 0a 2a 2a 20 20 28 35 29 20 20 34 back..** (5) 4
fbd0: 20 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e byte big-endian
fbe0: 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 integer which i
fbf0: 73 20 74 68 65 20 73 65 63 74 6f 72 20 73 69 7a s the sector siz
fc00: 65 2e 20 20 54 68 65 20 68 65 61 64 65 72 0a 2a e. The header.*
fc10: 2a 20 20 20 20 20 20 20 69 73 20 74 68 69 73 20 * is this
fc20: 6d 61 6e 79 20 62 79 74 65 73 20 69 6e 20 73 69 many bytes in si
fc30: 7a 65 2e 0a 2a 2a 20 20 28 36 29 20 20 34 20 62 ze..** (6) 4 b
fc40: 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 yte big-endian i
fc50: 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20 nteger which is
fc60: 74 68 65 20 70 61 67 65 20 63 61 73 65 2e 0a 2a the page case..*
fc70: 2a 20 20 28 37 29 20 20 34 20 62 79 74 65 20 69 * (7) 4 byte i
fc80: 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20 nteger which is
fc90: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 the number of by
fca0: 74 65 73 20 69 6e 20 74 68 65 20 6d 61 73 74 65 tes in the maste
fcb0: 72 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 r journal.**
fcc0: 20 20 20 6e 61 6d 65 2e 20 20 54 68 65 20 76 61 name. The va
fcd0: 6c 75 65 20 6d 61 79 20 62 65 20 7a 65 72 6f 20 lue may be zero
fce0: 28 69 6e 64 69 63 61 74 65 20 74 68 61 74 20 74 (indicate that t
fcf0: 68 65 72 65 20 69 73 20 6e 6f 20 6d 61 73 74 65 here is no maste
fd00: 72 0a 2a 2a 20 20 20 20 20 20 20 6a 6f 75 72 6e r.** journ
fd10: 61 6c 2e 29 0a 2a 2a 20 20 28 38 29 20 20 4e 20 al.).** (8) N
fd20: 62 79 74 65 73 20 6f 66 20 74 68 65 20 6d 61 73 bytes of the mas
fd30: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter journal name
fd40: 2e 20 20 54 68 65 20 6e 61 6d 65 20 77 69 6c 6c . The name will
fd50: 20 62 65 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 be nul-terminat
fd60: 65 64 0a 2a 2a 20 20 20 20 20 20 20 61 6e 64 20 ed.** and
fd70: 6d 69 67 68 74 20 62 65 20 73 68 6f 72 74 65 72 might be shorter
fd80: 20 74 68 61 6e 20 74 68 65 20 76 61 6c 75 65 20 than the value
fd90: 72 65 61 64 20 66 72 6f 6d 20 28 35 29 2e 20 20 read from (5).
fda0: 49 66 20 74 68 65 20 66 69 72 73 74 20 62 79 74 If the first byt
fdb0: 65 0a 2a 2a 20 20 20 20 20 20 20 6f 66 20 74 68 e.** of th
fdc0: 65 20 6e 61 6d 65 20 69 73 20 5c 30 30 30 20 74 e name is \000 t
fdd0: 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 20 hen there is no
fde0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 master journal.
fdf0: 20 54 68 65 20 6d 61 73 74 65 72 0a 2a 2a 20 20 The master.**
fe00: 20 20 20 20 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d journal nam
fe10: 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 55 e is stored in U
fe20: 54 46 2d 38 2e 0a 2a 2a 20 20 28 39 29 20 20 5a TF-8..** (9) Z
fe30: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 70 61 67 65 ero or more page
fe40: 73 20 69 6e 73 74 61 6e 63 65 73 2c 20 65 61 63 s instances, eac
fe50: 68 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a h as follows:.**
fe60: 20 20 20 20 20 20 20 20 2b 20 20 34 20 62 79 74 + 4 byt
fe70: 65 20 70 61 67 65 20 6e 75 6d 62 65 72 2e 0a 2a e page number..*
fe80: 2a 20 20 20 20 20 20 20 20 2b 20 20 70 50 61 67 * + pPag
fe90: 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 62 79 74 er->pageSize byt
fea0: 65 73 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 20 es of data..**
feb0: 20 20 20 20 20 20 2b 20 20 34 20 62 79 74 65 20 + 4 byte
fec0: 63 68 65 63 6b 73 75 6d 0a 2a 2a 0a 2a 2a 20 57 checksum.**.** W
fed0: 68 65 6e 20 77 65 20 73 70 65 61 6b 20 6f 66 20 hen we speak of
fee0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 the journal head
fef0: 65 72 2c 20 77 65 20 6d 65 61 6e 20 74 68 65 20 er, we mean the
ff00: 66 69 72 73 74 20 38 20 69 74 65 6d 73 20 61 62 first 8 items ab
ff10: 6f 76 65 2e 0a 2a 2a 20 45 61 63 68 20 65 6e 74 ove..** Each ent
ff20: 72 79 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 ry in the journa
ff30: 6c 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 l is an instance
ff40: 20 6f 66 20 74 68 65 20 39 74 68 20 69 74 65 6d of the 9th item
ff50: 2e 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 65 ..**.** Call the
ff60: 20 76 61 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 value from the
ff70: 73 65 63 6f 6e 64 20 62 75 6c 6c 65 74 20 22 6e second bullet "n
ff80: 52 65 63 22 2e 20 20 6e 52 65 63 20 69 73 20 74 Rec". nRec is t
ff90: 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 he number of.**
ffa0: 76 61 6c 69 64 20 70 61 67 65 20 65 6e 74 72 69 valid page entri
ffb0: 65 73 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 es in the journa
ffc0: 6c 2e 20 20 49 6e 20 6d 6f 73 74 20 63 61 73 65 l. In most case
ffd0: 73 2c 20 79 6f 75 20 63 61 6e 20 63 6f 6d 70 75 s, you can compu
ffe0: 74 65 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20 te the.** value
fff0: 6f 66 20 6e 52 65 63 20 66 72 6f 6d 20 74 68 65 of nRec from the
10000 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 size of the jou
10010 72 6e 61 6c 20 66 69 6c 65 2e 20 20 42 75 74 20 rnal file. But
10020 69 66 20 61 20 70 6f 77 65 72 0a 2a 2a 20 66 61 if a power.** fa
10030 69 6c 75 72 65 20 6f 63 63 75 72 72 65 64 20 77 ilure occurred w
10040 68 69 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c hile the journal
10050 20 77 61 73 20 62 65 69 6e 67 20 77 72 69 74 74 was being writt
10060 65 6e 2c 20 69 74 20 63 6f 75 6c 64 20 62 65 20 en, it could be
10070 74 68 65 0a 2a 2a 20 63 61 73 65 20 74 68 61 74 the.** case that
10080 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 the size of the
10090 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 journal file ha
100a0 64 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 69 d already been i
100b0 6e 63 72 65 61 73 65 64 20 62 75 74 0a 2a 2a 20 ncreased but.**
100c0 74 68 65 20 65 78 74 72 61 20 65 6e 74 72 69 65 the extra entrie
100d0 73 20 68 61 64 20 6e 6f 74 20 79 65 74 20 6d 61 s had not yet ma
100e0 64 65 20 69 74 20 73 61 66 65 6c 79 20 74 6f 20 de it safely to
100f0 64 69 73 6b 2e 20 20 49 6e 20 73 75 63 68 20 61 disk. In such a
10100 20 63 61 73 65 2c 0a 2a 2a 20 74 68 65 20 76 61 case,.** the va
10110 6c 75 65 20 6f 66 20 6e 52 65 63 20 63 6f 6d 70 lue of nRec comp
10120 75 74 65 64 20 66 72 6f 6d 20 74 68 65 20 66 69 uted from the fi
10130 6c 65 20 73 69 7a 65 20 77 6f 75 6c 64 20 62 65 le size would be
10140 20 74 6f 6f 20 6c 61 72 67 65 2e 20 20 46 6f 72 too large. For
10150 0a 2a 2a 20 74 68 61 74 20 72 65 61 73 6f 6e 2c .** that reason,
10160 20 77 65 20 61 6c 77 61 79 73 20 75 73 65 20 74 we always use t
10170 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20 69 6e he nRec value in
10180 20 74 68 65 20 68 65 61 64 65 72 2e 0a 2a 2a 0a the header..**.
10190 2a 2a 20 49 66 20 74 68 65 20 6e 52 65 63 20 76 ** If the nRec v
101a0 61 6c 75 65 20 69 73 20 30 78 66 66 66 66 66 66 alue is 0xffffff
101b0 66 66 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 ff it means that
101c0 20 6e 52 65 63 20 73 68 6f 75 6c 64 20 62 65 20 nRec should be
101d0 63 6f 6d 70 75 74 65 64 0a 2a 2a 20 66 72 6f 6d computed.** from
101e0 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 2e 20 the file size.
101f0 20 54 68 69 73 20 76 61 6c 75 65 20 69 73 20 75 This value is u
10200 73 65 64 20 77 68 65 6e 20 74 68 65 20 75 73 65 sed when the use
10210 72 20 73 65 6c 65 63 74 73 20 74 68 65 0a 2a 2a r selects the.**
10220 20 6e 6f 2d 73 79 6e 63 20 6f 70 74 69 6f 6e 20 no-sync option
10230 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e for the journal.
10240 20 20 41 20 70 6f 77 65 72 20 66 61 69 6c 75 72 A power failur
10250 65 20 63 6f 75 6c 64 20 6c 65 61 64 20 74 6f 20 e could lead to
10260 63 6f 72 72 75 70 74 69 6f 6e 0a 2a 2a 20 69 6e corruption.** in
10270 20 74 68 69 73 20 63 61 73 65 2e 20 20 42 75 74 this case. But
10280 20 66 6f 72 20 74 68 69 6e 67 73 20 6c 69 6b 65 for things like
10290 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 temporary table
102a0 20 28 77 68 69 63 68 20 77 69 6c 6c 20 62 65 0a (which will be.
102b0 2a 2a 20 64 65 6c 65 74 65 64 20 77 68 65 6e 20 ** deleted when
102c0 74 68 65 20 70 6f 77 65 72 20 69 73 20 72 65 73 the power is res
102d0 74 6f 72 65 64 29 20 77 65 20 64 6f 6e 27 74 20 tored) we don't
102e0 63 61 72 65 2e 20 20 0a 2a 2a 0a 2a 2a 20 49 66 care. .**.** If
102f0 20 74 68 65 20 66 69 6c 65 20 6f 70 65 6e 65 64 the file opened
10300 20 61 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 as the journal
10310 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 20 77 65 file is not a we
10320 6c 6c 2d 66 6f 72 6d 65 64 0a 2a 2a 20 6a 6f 75 ll-formed.** jou
10330 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 6e 20 61 rnal file then a
10340 6c 6c 20 70 61 67 65 73 20 75 70 20 74 6f 20 74 ll pages up to t
10350 68 65 20 66 69 72 73 74 20 63 6f 72 72 75 70 74 he first corrupt
10360 65 64 20 70 61 67 65 20 61 72 65 20 72 6f 6c 6c ed page are roll
10370 65 64 0a 2a 2a 20 62 61 63 6b 20 28 6f 72 20 6e ed.** back (or n
10380 6f 20 70 61 67 65 73 20 69 66 20 74 68 65 20 6a o pages if the j
10390 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 69 73 ournal header is
103a0 20 63 6f 72 72 75 70 74 65 64 29 2e 20 54 68 65 corrupted). The
103b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a journal file.**
103c0 20 69 73 20 74 68 65 6e 20 64 65 6c 65 74 65 64 is then deleted
103d0 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 72 and SQLITE_OK r
103e0 65 74 75 72 6e 65 64 2c 20 6a 75 73 74 20 61 73 eturned, just as
103f0 20 69 66 20 6e 6f 20 63 6f 72 72 75 70 74 69 6f if no corruptio
10400 6e 20 68 61 64 0a 2a 2a 20 62 65 65 6e 20 65 6e n had.** been en
10410 63 6f 75 6e 74 65 72 65 64 2e 0a 2a 2a 0a 2a 2a countered..**.**
10420 20 49 66 20 61 6e 20 49 2f 4f 20 6f 72 20 6d 61 If an I/O or ma
10430 6c 6c 6f 63 28 29 20 65 72 72 6f 72 20 6f 63 63 lloc() error occ
10440 75 72 73 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c urs, the journal
10450 2d 66 69 6c 65 20 69 73 20 6e 6f 74 20 64 65 6c -file is not del
10460 65 74 65 64 0a 2a 2a 20 61 6e 64 20 61 6e 20 65 eted.** and an e
10470 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 rror code is ret
10480 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
10490 20 69 6e 74 20 70 61 67 65 72 5f 70 6c 61 79 62 int pager_playb
104a0 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 ack(Pager *pPage
104b0 72 2c 20 69 6e 74 20 69 73 48 6f 74 29 7b 0a 20 r, int isHot){.
104c0 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 sqlite3_vfs *pV
104d0 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 fs = pPager->pVf
104e0 73 3b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 s;. i64 szJ;
104f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
10500 20 53 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 Size of the jou
10510 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 62 79 74 rnal file in byt
10520 65 73 20 2a 2f 0a 20 20 75 33 32 20 6e 52 65 63 es */. u32 nRec
10530 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
10540 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 52 65 /* Number of Re
10550 63 6f 72 64 73 20 69 6e 20 74 68 65 20 6a 6f 75 cords in the jou
10560 72 6e 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 3b rnal */. int i;
10570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10580 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 /* Loop count
10590 65 72 20 2a 2f 0a 20 20 50 67 6e 6f 20 6d 78 50 er */. Pgno mxP
105a0 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 g = 0;
105b0 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 /* Size of the
105c0 6f 72 69 67 69 6e 61 6c 20 66 69 6c 65 20 69 6e original file in
105d0 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20 pages */. int
105e0 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
105f0 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 /* Result c
10600 6f 64 65 20 6f 66 20 61 20 73 75 62 72 6f 75 74 ode of a subrout
10610 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 72 65 73 ine */. int res
10620 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
10630 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 72 /* Value retur
10640 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 4f 73 ned by sqlite3Os
10650 41 63 63 65 73 73 28 29 20 2a 2f 0a 20 20 63 68 Access() */. ch
10660 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30 3b ar *zMaster = 0;
10670 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
10680 66 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c f master journal
10690 20 66 69 6c 65 20 69 66 20 61 6e 79 20 2a 2f 0a file if any */.
106a0 0a 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 . /* Figure out
106b0 20 68 6f 77 20 6d 61 6e 79 20 72 65 63 6f 72 64 how many record
106c0 73 20 61 72 65 20 69 6e 20 74 68 65 20 6a 6f 75 s are in the jou
106d0 72 6e 61 6c 2e 20 20 41 62 6f 72 74 20 65 61 72 rnal. Abort ear
106e0 6c 79 20 69 66 0a 20 20 2a 2a 20 74 68 65 20 6a ly if. ** the j
106f0 6f 75 72 6e 61 6c 20 69 73 20 65 6d 70 74 79 2e ournal is empty.
10700 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
10710 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
10720 70 65 6e 20 29 3b 0a 20 20 72 63 20 3d 20 73 71 pen );. rc = sq
10730 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 lite3OsFileSize(
10740 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 26 73 7a pPager->jfd, &sz
10750 4a 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 J);. if( rc!=SQ
10760 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 7a 4a 3d 3d LITE_OK || szJ==
10770 30 20 29 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 0 ){. goto en
10780 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a d_playback;. }.
10790 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 6d . /* Read the m
107a0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 aster journal na
107b0 6d 65 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 me from the jour
107c0 6e 61 6c 2c 20 69 66 20 69 74 20 69 73 20 70 72 nal, if it is pr
107d0 65 73 65 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61 esent.. ** If a
107e0 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
107f0 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 73 70 65 file name is spe
10800 63 69 66 69 65 64 2c 20 62 75 74 20 74 68 65 20 cified, but the
10810 66 69 6c 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a file is not. **
10820 20 70 72 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b present on disk
10830 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e , then the journ
10840 61 6c 20 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e al is not hot an
10850 64 20 64 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 d does not need
10860 74 6f 20 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65 to be. ** playe
10870 64 20 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 20 7a d back.. */. z
10880 4d 61 73 74 65 72 20 3d 20 70 50 61 67 65 72 2d Master = pPager-
10890 3e 70 54 6d 70 53 70 61 63 65 3b 0a 20 20 72 63 >pTmpSpace;. rc
108a0 20 3d 20 72 65 61 64 4d 61 73 74 65 72 4a 6f 75 = readMasterJou
108b0 72 6e 61 6c 28 70 50 61 67 65 72 2d 3e 6a 66 64 rnal(pPager->jfd
108c0 2c 20 7a 4d 61 73 74 65 72 2c 20 70 50 61 67 65 , zMaster, pPage
108d0 72 2d 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e r->pVfs->mxPathn
108e0 61 6d 65 2b 31 29 3b 0a 20 20 69 66 28 20 72 63 ame+1);. if( rc
108f0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 !=SQLITE_OK || (
10900 7a 4d 61 73 74 65 72 5b 30 5d 20 0a 20 20 20 26 zMaster[0] . &
10910 26 20 28 72 65 73 3d 73 71 6c 69 74 65 33 4f 73 & (res=sqlite3Os
10920 41 63 63 65 73 73 28 70 56 66 73 2c 20 7a 4d 61 Access(pVfs, zMa
10930 73 74 65 72 2c 20 53 51 4c 49 54 45 5f 41 43 43 ster, SQLITE_ACC
10940 45 53 53 5f 45 58 49 53 54 53 29 29 3d 3d 30 20 ESS_EXISTS))==0
10950 29 20 0a 20 20 29 7b 0a 20 20 20 20 7a 4d 61 73 ) . ){. zMas
10960 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 67 6f 74 ter = 0;. got
10970 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a o end_playback;.
10980 20 20 7d 0a 20 20 7a 4d 61 73 74 65 72 20 3d 20 }. zMaster =
10990 30 3b 0a 20 20 69 66 28 20 72 65 73 3c 30 20 29 0;. if( res<0 )
109a0 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 {. rc = SQLIT
109b0 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3b 0a 20 E_IOERR_NOMEM;.
109c0 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 goto end_play
109d0 62 61 63 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 back;. }. pPag
109e0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d er->journalOff =
109f0 20 30 3b 0a 0a 20 20 2f 2a 20 54 68 69 73 20 6c 0;.. /* This l
10a00 6f 6f 70 20 74 65 72 6d 69 6e 61 74 65 73 20 65 oop terminates e
10a10 69 74 68 65 72 20 77 68 65 6e 20 74 68 65 20 72 ither when the r
10a20 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 29 20 eadJournalHdr()
10a30 63 61 6c 6c 20 72 65 74 75 72 6e 73 0a 20 20 2a call returns. *
10a40 2a 20 53 51 4c 49 54 45 5f 44 4f 4e 45 20 6f 72 * SQLITE_DONE or
10a50 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 an IO error occ
10a60 75 72 73 2e 20 2a 2f 0a 20 20 77 68 69 6c 65 28 urs. */. while(
10a70 20 31 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 52 65 1 ){.. /* Re
10a80 61 64 20 74 68 65 20 6e 65 78 74 20 6a 6f 75 72 ad the next jour
10a90 6e 61 6c 20 68 65 61 64 65 72 20 66 72 6f 6d 20 nal header from
10aa0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
10ab0 2e 20 20 49 66 20 74 68 65 72 65 20 61 72 65 0a . If there are.
10ac0 20 20 20 20 2a 2a 20 6e 6f 74 20 65 6e 6f 75 67 ** not enoug
10ad0 68 20 62 79 74 65 73 20 6c 65 66 74 20 69 6e 20 h bytes left in
10ae0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
10af0 20 66 6f 72 20 61 20 63 6f 6d 70 6c 65 74 65 20 for a complete
10b00 68 65 61 64 65 72 2c 20 6f 72 0a 20 20 20 20 2a header, or. *
10b10 2a 20 69 74 20 69 73 20 63 6f 72 72 75 70 74 65 * it is corrupte
10b20 64 2c 20 74 68 65 6e 20 61 20 70 72 6f 63 65 73 d, then a proces
10b30 73 20 6d 75 73 74 20 6f 66 20 66 61 69 6c 65 64 s must of failed
10b40 20 77 68 69 6c 65 20 77 72 69 74 69 6e 67 20 69 while writing i
10b50 74 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69 t.. ** This i
10b60 6e 64 69 63 61 74 65 73 20 6e 6f 74 68 69 6e 67 ndicates nothing
10b70 20 6d 6f 72 65 20 6e 65 65 64 73 20 74 6f 20 62 more needs to b
10b80 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 e rolled back..
10b90 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72 */. rc = r
10ba0 65 61 64 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 eadJournalHdr(pP
10bb0 61 67 65 72 2c 20 73 7a 4a 2c 20 26 6e 52 65 63 ager, szJ, &nRec
10bc0 2c 20 26 6d 78 50 67 29 3b 0a 20 20 20 20 69 66 , &mxPg);. if
10bd0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
10be0 29 7b 20 0a 20 20 20 20 20 20 69 66 28 20 72 63 ){ . if( rc
10bf0 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 7b ==SQLITE_DONE ){
10c00 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 . rc = SQ
10c10 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
10c20 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f . goto end_
10c30 70 6c 61 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a playback;. }.
10c40 0a 20 20 20 20 2f 2a 20 49 66 20 6e 52 65 63 20 . /* If nRec
10c50 69 73 20 30 78 66 66 66 66 66 66 66 66 2c 20 74 is 0xffffffff, t
10c60 68 65 6e 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c hen this journal
10c70 20 77 61 73 20 63 72 65 61 74 65 64 20 62 79 20 was created by
10c80 61 20 70 72 6f 63 65 73 73 0a 20 20 20 20 2a 2a a process. **
10c90 20 77 6f 72 6b 69 6e 67 20 69 6e 20 6e 6f 2d 73 working in no-s
10ca0 79 6e 63 20 6d 6f 64 65 2e 20 54 68 69 73 20 6d ync mode. This m
10cb0 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 72 65 eans that the re
10cc0 73 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 st of the journa
10cd0 6c 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 63 6f l. ** file co
10ce0 6e 73 69 73 74 73 20 6f 66 20 70 61 67 65 73 2c nsists of pages,
10cf0 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6d 6f there are no mo
10d00 72 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 re journal heade
10d10 72 73 2e 20 43 6f 6d 70 75 74 65 0a 20 20 20 20 rs. Compute.
10d20 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ** the value of
10d30 6e 52 65 63 20 62 61 73 65 64 20 6f 6e 20 74 68 nRec based on th
10d40 69 73 20 61 73 73 75 6d 70 74 69 6f 6e 2e 0a 20 is assumption..
10d50 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 6e 52 */. if( nR
10d60 65 63 3d 3d 30 78 66 66 66 66 66 66 66 66 20 29 ec==0xffffffff )
10d70 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
10d80 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
10d90 66 66 3d 3d 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f ff==JOURNAL_HDR_
10da0 53 5a 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 SZ(pPager) );.
10db0 20 20 20 20 6e 52 65 63 20 3d 20 28 73 7a 4a 20 nRec = (szJ
10dc0 2d 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a - JOURNAL_HDR_SZ
10dd0 28 70 50 61 67 65 72 29 29 2f 4a 4f 55 52 4e 41 (pPager))/JOURNA
10de0 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 29 3b L_PG_SZ(pPager);
10df0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 . }.. /* I
10e00 66 20 6e 52 65 63 20 69 73 20 30 20 61 6e 64 20 f nRec is 0 and
10e10 74 68 69 73 20 72 6f 6c 6c 62 61 63 6b 20 69 73 this rollback is
10e20 20 6f 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f of a transactio
10e30 6e 20 63 72 65 61 74 65 64 20 62 79 20 74 68 69 n created by thi
10e40 73 0a 20 20 20 20 2a 2a 20 70 72 6f 63 65 73 73 s. ** process
10e50 20 61 6e 64 20 69 66 20 74 68 69 73 20 69 73 20 and if this is
10e60 74 68 65 20 66 69 6e 61 6c 20 68 65 61 64 65 72 the final header
10e70 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c in the journal,
10e80 20 74 68 65 6e 20 69 74 20 6d 65 61 6e 73 0a 20 then it means.
10e90 20 20 20 2a 2a 20 74 68 61 74 20 74 68 69 73 20 ** that this
10ea0 70 61 72 74 20 6f 66 20 74 68 65 20 6a 6f 75 72 part of the jour
10eb0 6e 61 6c 20 77 61 73 20 62 65 69 6e 67 20 66 69 nal was being fi
10ec0 6c 6c 65 64 20 62 75 74 20 68 61 73 20 6e 6f 74 lled but has not
10ed0 20 79 65 74 20 62 65 65 6e 0a 20 20 20 20 2a 2a yet been. **
10ee0 20 73 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e synced to disk.
10ef0 20 20 43 6f 6d 70 75 74 65 20 74 68 65 20 6e 75 Compute the nu
10f00 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 62 61 mber of pages ba
10f10 73 65 64 20 6f 6e 20 74 68 65 20 72 65 6d 61 69 sed on the remai
10f20 6e 69 6e 67 0a 20 20 20 20 2a 2a 20 73 69 7a 65 ning. ** size
10f30 20 6f 66 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 of the file..
10f40 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 **. ** The
10f50 74 68 69 72 64 20 74 65 72 6d 20 6f 66 20 74 68 third term of th
10f60 65 20 74 65 73 74 20 77 61 73 20 61 64 64 65 64 e test was added
10f70 20 74 6f 20 66 69 78 20 74 69 63 6b 65 74 20 23 to fix ticket #
10f80 32 35 36 35 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 2565.. */.
10f90 20 69 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 20 if( nRec==0 &&
10fa0 21 69 73 48 6f 74 20 26 26 0a 20 20 20 20 20 20 !isHot &&.
10fb0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
10fc0 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 lHdr+JOURNAL_HDR
10fd0 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 _SZ(pPager)==pPa
10fe0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
10ff0 29 7b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 ){. nRec =
11000 28 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a (szJ - pPager->j
11010 6f 75 72 6e 61 6c 4f 66 66 29 20 2f 20 4a 4f 55 ournalOff) / JOU
11020 52 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 RNAL_PG_SZ(pPage
11030 72 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f r);. }.. /
11040 2a 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 * If this is the
11050 20 66 69 72 73 74 20 68 65 61 64 65 72 20 72 65 first header re
11060 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 ad from the jour
11070 6e 61 6c 2c 20 74 72 75 6e 63 61 74 65 20 74 68 nal, truncate th
11080 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 e. ** databas
11090 65 20 66 69 6c 65 20 62 61 63 6b 20 74 6f 20 69 e file back to i
110a0 74 73 20 6f 72 69 67 69 6e 61 6c 20 73 69 7a 65 ts original size
110b0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
110c0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
110d0 4f 66 66 3d 3d 4a 4f 55 52 4e 41 4c 5f 48 44 52 Off==JOURNAL_HDR
110e0 5f 53 5a 28 70 50 61 67 65 72 29 20 29 7b 0a 20 _SZ(pPager) ){.
110f0 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f rc = pager_
11100 74 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 2c truncate(pPager,
11110 20 6d 78 50 67 29 3b 0a 20 20 20 20 20 20 69 66 mxPg);. if
11120 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
11130 29 7b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 ){. goto
11140 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 end_playback;.
11150 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 }. }..
11160 20 2f 2a 20 43 6f 70 79 20 6f 72 69 67 69 6e 61 /* Copy origina
11170 6c 20 70 61 67 65 73 20 6f 75 74 20 6f 66 20 74 l pages out of t
11180 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 62 he journal and b
11190 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 64 61 74 ack into the dat
111a0 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 abase file..
111b0 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 */. for(i=0;
111c0 69 3c 6e 52 65 63 3b 20 69 2b 2b 29 7b 0a 20 20 i<nRec; i++){.
111d0 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 rc = pager_p
111e0 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 layback_one_page
111f0 28 70 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d (pPager, pPager-
11200 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f >jfd, pPager->jo
11210 75 72 6e 61 6c 4f 66 66 2c 20 31 29 3b 0a 20 20 urnalOff, 1);.
11220 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
11230 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
11240 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
11250 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 20 DONE ){.
11260 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b rc = SQLITE_OK
11270 3b 0a 20 20 20 20 20 20 20 20 20 20 70 50 61 67 ;. pPag
11280 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d er->journalOff =
11290 20 73 7a 4a 3b 0a 20 20 20 20 20 20 20 20 20 20 szJ;.
112a0 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d break;. }
112b0 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 else{.
112c0 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 goto end_playbac
112d0 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 k;. }.
112e0 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 }. }. }.
112f0 20 2f 2a 4e 4f 54 52 45 41 43 48 45 44 2a 2f 0a /*NOTREACHED*/.
11300 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a 0a assert( 0 );..
11310 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3a 0a 20 20 end_playback:.
11320 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
11330 4b 20 29 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 K ){. zMaster
11340 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 = pPager->pTmpS
11350 70 61 63 65 3b 0a 20 20 20 20 72 63 20 3d 20 72 pace;. rc = r
11360 65 61 64 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c eadMasterJournal
11370 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d (pPager->jfd, zM
11380 61 73 74 65 72 2c 20 70 50 61 67 65 72 2d 3e 70 aster, pPager->p
11390 56 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b Vfs->mxPathname+
113a0 31 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 1);. }. if( rc
113b0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
113c0 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 65 6e rc = pager_en
113d0 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 d_transaction(pP
113e0 61 67 65 72 29 3b 0a 20 20 7d 0a 20 20 69 66 28 ager);. }. if(
113f0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
11400 26 20 7a 4d 61 73 74 65 72 5b 30 5d 20 29 7b 0a & zMaster[0] ){.
11410 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 /* If there
11420 77 61 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 was a master jou
11430 72 6e 61 6c 20 61 6e 64 20 74 68 69 73 20 72 6f rnal and this ro
11440 75 74 69 6e 65 20 77 69 6c 6c 20 72 65 74 75 72 utine will retur
11450 6e 20 73 75 63 63 65 73 73 2c 0a 20 20 20 20 2a n success,. *
11460 2a 20 73 65 65 20 69 66 20 69 74 20 69 73 20 70 * see if it is p
11470 6f 73 73 69 62 6c 65 20 74 6f 20 64 65 6c 65 74 ossible to delet
11480 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 e the master jou
11490 72 6e 61 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 rnal.. */.
114a0 20 72 63 20 3d 20 70 61 67 65 72 5f 64 65 6c 6d rc = pager_delm
114b0 61 73 74 65 72 28 70 50 61 67 65 72 2c 20 7a 4d aster(pPager, zM
114c0 61 73 74 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f aster);. }.. /
114d0 2a 20 54 68 65 20 50 61 67 65 72 2e 73 65 63 74 * The Pager.sect
114e0 6f 72 53 69 7a 65 20 76 61 72 69 61 62 6c 65 20 orSize variable
114f0 6d 61 79 20 68 61 76 65 20 62 65 65 6e 20 75 70 may have been up
11500 64 61 74 65 64 20 77 68 69 6c 65 20 72 6f 6c 6c dated while roll
11510 69 6e 67 0a 20 20 2a 2a 20 62 61 63 6b 20 61 20 ing. ** back a
11520 6a 6f 75 72 6e 61 6c 20 63 72 65 61 74 65 64 20 journal created
11530 62 79 20 61 20 70 72 6f 63 65 73 73 20 77 69 74 by a process wit
11540 68 20 61 20 64 69 66 66 65 72 65 6e 74 20 73 65 h a different se
11550 63 74 6f 72 20 73 69 7a 65 0a 20 20 2a 2a 20 76 ctor size. ** v
11560 61 6c 75 65 2e 20 52 65 73 65 74 20 69 74 20 74 alue. Reset it t
11570 6f 20 74 68 65 20 63 6f 72 72 65 63 74 20 76 61 o the correct va
11580 6c 75 65 20 66 6f 72 20 74 68 69 73 20 70 72 6f lue for this pro
11590 63 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 73 65 74 cess.. */. set
115a0 53 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 65 SectorSize(pPage
115b0 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b r);. return rc;
115c0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 .}../*.** Playba
115d0 63 6b 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 ck the statement
115e0 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 journal..**.**
115f0 54 68 69 73 20 69 73 20 73 69 6d 69 6c 61 72 20 This is similar
11600 74 6f 20 70 6c 61 79 69 6e 67 20 62 61 63 6b 20 to playing back
11610 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
11620 6a 6f 75 72 6e 61 6c 20 62 75 74 20 77 69 74 68 journal but with
11630 0a 2a 2a 20 61 20 66 65 77 20 65 78 74 72 61 20 .** a few extra
11640 74 77 69 73 74 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 twists..**.**
11650 20 28 31 29 20 20 54 68 65 20 6e 75 6d 62 65 72 (1) The number
11660 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 of pages in the
11670 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 database file a
11680 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 0a 2a t the start of.*
11690 2a 20 20 20 20 20 20 20 20 20 74 68 65 20 73 74 * the st
116a0 61 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65 atement is store
116b0 64 20 69 6e 20 70 50 61 67 65 72 2d 3e 73 74 6d d in pPager->stm
116c0 74 53 69 7a 65 2c 20 6e 6f 74 20 69 6e 20 74 68 tSize, not in th
116d0 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 6a 6f 75 e.** jou
116e0 72 6e 61 6c 20 66 69 6c 65 20 69 74 73 65 6c 66 rnal file itself
116f0 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 28 32 29 20 20 ..**.** (2)
11700 49 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 70 In addition to p
11710 6c 61 79 69 6e 67 20 62 61 63 6b 20 74 68 65 20 laying back the
11720 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 statement journa
11730 6c 2c 20 61 6c 73 6f 0a 2a 2a 20 20 20 20 20 20 l, also.**
11740 20 20 20 70 6c 61 79 62 61 63 6b 20 61 6c 6c 20 playback all
11750 70 61 67 65 73 20 6f 66 20 74 68 65 20 74 72 61 pages of the tra
11760 6e 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c nsaction journal
11770 20 62 65 67 69 6e 6e 69 6e 67 0a 2a 2a 20 20 20 beginning.**
11780 20 20 20 20 20 20 61 74 20 6f 66 66 73 65 74 20 at offset
11790 70 50 61 67 65 72 2d 3e 73 74 6d 74 4a 53 69 7a pPager->stmtJSiz
117a0 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 e..*/.static int
117b0 20 70 61 67 65 72 5f 73 74 6d 74 5f 70 6c 61 79 pager_stmt_play
117c0 62 61 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 back(Pager *pPag
117d0 65 72 29 7b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 er){. i64 szJ;
117e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
117f0 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 66 /* Size of the f
11800 75 6c 6c 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 ull journal */.
11810 20 69 36 34 20 68 64 72 4f 66 66 3b 0a 20 20 69 i64 hdrOff;. i
11820 6e 74 20 6e 52 65 63 3b 20 20 20 20 20 20 20 20 nt nRec;
11830 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
11840 72 20 6f 66 20 52 65 63 6f 72 64 73 20 2a 2f 0a r of Records */.
11850 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 int i;
11860 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f /* Lo
11870 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 op counter */.
11880 69 6e 74 20 72 63 3b 0a 0a 20 20 73 7a 4a 20 3d int rc;.. szJ =
11890 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
118a0 4f 66 66 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 68 Off;.. /* Set h
118b0 64 72 4f 66 66 20 74 6f 20 62 65 20 74 68 65 20 drOff to be the
118c0 6f 66 66 73 65 74 20 6a 75 73 74 20 61 66 74 65 offset just afte
118d0 72 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 r the end of the
118e0 20 6c 61 73 74 20 6a 6f 75 72 6e 61 6c 0a 20 20 last journal.
118f0 2a 2a 20 70 61 67 65 20 77 72 69 74 74 65 6e 20 ** page written
11900 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 74 before the first
11910 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 journal-header
11920 66 6f 72 20 74 68 69 73 20 73 74 61 74 65 6d 65 for this stateme
11930 6e 74 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 nt. ** transact
11940 69 6f 6e 20 77 61 73 20 77 72 69 74 74 65 6e 2c ion was written,
11950 20 6f 72 20 74 68 65 20 65 6e 64 20 6f 66 20 74 or the end of t
11960 68 65 20 66 69 6c 65 20 69 66 20 6e 6f 20 6a 6f he file if no jo
11970 75 72 6e 61 6c 0a 20 20 2a 2a 20 68 65 61 64 65 urnal. ** heade
11980 72 20 77 61 73 20 77 72 69 74 74 65 6e 2e 0a 20 r was written..
11990 20 2a 2f 0a 20 20 68 64 72 4f 66 66 20 3d 20 70 */. hdrOff = p
119a0 50 61 67 65 72 2d 3e 73 74 6d 74 48 64 72 4f 66 Pager->stmtHdrOf
119b0 66 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 f;. assert( pPa
119c0 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 7c 7c ger->fullSync ||
119d0 20 21 68 64 72 4f 66 66 20 29 3b 0a 20 20 69 66 !hdrOff );. if
119e0 28 20 21 68 64 72 4f 66 66 20 29 7b 0a 20 20 20 ( !hdrOff ){.
119f0 20 68 64 72 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 hdrOff = szJ;.
11a00 20 7d 0a 20 20 0a 20 20 2f 2a 20 54 72 75 6e 63 }. . /* Trunc
11a10 61 74 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ate the database
11a20 20 62 61 63 6b 20 74 6f 20 69 74 73 20 6f 72 69 back to its ori
11a30 67 69 6e 61 6c 20 73 69 7a 65 2e 0a 20 20 2a 2f ginal size.. */
11a40 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 74 72 . rc = pager_tr
11a50 75 6e 63 61 74 65 28 70 50 61 67 65 72 2c 20 70 uncate(pPager, p
11a60 50 61 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 29 Pager->stmtSize)
11a70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
11a80 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 er->state>=PAGER
11a90 5f 53 48 41 52 45 44 20 29 3b 0a 0a 20 20 2f 2a _SHARED );.. /*
11aa0 20 46 69 67 75 72 65 20 6f 75 74 20 68 6f 77 20 Figure out how
11ab0 6d 61 6e 79 20 72 65 63 6f 72 64 73 20 61 72 65 many records are
11ac0 20 69 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e in the statemen
11ad0 74 20 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a t journal.. */.
11ae0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
11af0 2d 3e 73 74 6d 74 49 6e 55 73 65 20 26 26 20 70 ->stmtInUse && p
11b00 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 Pager->journalOp
11b10 65 6e 20 29 3b 0a 20 20 6e 52 65 63 20 3d 20 70 en );. nRec = p
11b20 50 61 67 65 72 2d 3e 73 74 6d 74 4e 52 65 63 3b Pager->stmtNRec;
11b30 0a 20 20 0a 20 20 2f 2a 20 43 6f 70 79 20 6f 72 . . /* Copy or
11b40 69 67 69 6e 61 6c 20 70 61 67 65 73 20 6f 75 74 iginal pages out
11b50 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e of the statemen
11b60 74 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 62 61 t journal and ba
11b70 63 6b 20 69 6e 74 6f 20 74 68 65 0a 20 20 2a 2a ck into the. **
11b80 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
11b90 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 73 Note that the s
11ba0 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c tatement journal
11bb0 20 6f 6d 69 74 73 20 63 68 65 63 6b 73 75 6d 73 omits checksums
11bc0 20 66 72 6f 6d 0a 20 20 2a 2a 20 65 61 63 68 20 from. ** each
11bd0 72 65 63 6f 72 64 20 73 69 6e 63 65 20 70 6f 77 record since pow
11be0 65 72 2d 66 61 69 6c 75 72 65 20 72 65 63 6f 76 er-failure recov
11bf0 65 72 79 20 69 73 20 6e 6f 74 20 69 6d 70 6f 72 ery is not impor
11c00 74 61 6e 74 20 74 6f 20 73 74 61 74 65 6d 65 6e tant to statemen
11c10 74 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e t. ** journals.
11c20 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b . */. for(i=0;
11c30 20 69 3c 6e 52 65 63 3b 20 69 2b 2b 29 7b 0a 20 i<nRec; i++){.
11c40 20 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20 i64 offset =
11c50 69 2a 28 34 2b 70 50 61 67 65 72 2d 3e 70 61 67 i*(4+pPager->pag
11c60 65 53 69 7a 65 29 3b 0a 20 20 20 20 72 63 20 3d eSize);. rc =
11c70 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f pager_playback_
11c80 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c one_page(pPager,
11c90 20 70 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 6f pPager->stfd, o
11ca0 66 66 73 65 74 2c 20 30 29 3b 0a 20 20 20 20 61 ffset, 0);. a
11cb0 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
11cc0 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 69 66 E_DONE );. if
11cd0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
11ce0 29 20 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f ) goto end_stmt_
11cf0 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20 playback;. }..
11d00 20 2f 2a 20 4e 6f 77 20 72 6f 6c 6c 20 73 6f 6d /* Now roll som
11d10 65 20 70 61 67 65 73 20 62 61 63 6b 20 66 72 6f e pages back fro
11d20 6d 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f m the transactio
11d30 6e 20 6a 6f 75 72 6e 61 6c 2e 20 50 61 67 65 72 n journal. Pager
11d40 2e 73 74 6d 74 4a 53 69 7a 65 0a 20 20 2a 2a 20 .stmtJSize. **
11d50 77 61 73 20 74 68 65 20 73 69 7a 65 20 6f 66 20 was the size of
11d60 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
11d70 20 77 68 65 6e 20 74 68 69 73 20 73 74 61 74 65 when this state
11d80 6d 65 6e 74 20 77 61 73 20 73 74 61 72 74 65 64 ment was started
11d90 2c 20 73 6f 0a 20 20 2a 2a 20 65 76 65 72 79 74 , so. ** everyt
11da0 68 69 6e 67 20 61 66 74 65 72 20 74 68 61 74 20 hing after that
11db0 6e 65 65 64 73 20 74 6f 20 62 65 20 72 6f 6c 6c needs to be roll
11dc0 65 64 20 62 61 63 6b 2c 20 65 69 74 68 65 72 20 ed back, either
11dd0 69 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 64 61 into the. ** da
11de0 74 61 62 61 73 65 2c 20 74 68 65 20 6d 65 6d 6f tabase, the memo
11df0 72 79 20 63 61 63 68 65 2c 20 6f 72 20 62 6f 74 ry cache, or bot
11e00 68 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 h.. **. ** If
11e10 69 74 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20 it is not zero,
11e20 74 68 65 6e 20 50 61 67 65 72 2e 73 74 6d 74 48 then Pager.stmtH
11e30 64 72 4f 66 66 20 69 73 20 74 68 65 20 6f 66 66 drOff is the off
11e40 73 65 74 20 74 6f 20 74 68 65 20 73 74 61 72 74 set to the start
11e50 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 69 72 . ** of the fir
11e60 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 st journal heade
11e70 72 20 77 72 69 74 74 65 6e 20 64 75 72 69 6e 67 r written during
11e80 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20 this statement
11e90 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a transaction.. *
11ea0 2f 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 /. pPager->jour
11eb0 6e 61 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d nalOff = pPager-
11ec0 3e 73 74 6d 74 4a 53 69 7a 65 3b 0a 20 20 70 50 >stmtJSize;. pP
11ed0 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 20 ager->cksumInit
11ee0 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 43 6b = pPager->stmtCk
11ef0 73 75 6d 3b 0a 20 20 77 68 69 6c 65 28 20 70 50 sum;. while( pP
11f00 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
11f10 20 3c 20 68 64 72 4f 66 66 20 29 7b 0a 20 20 20 < hdrOff ){.
11f20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 rc = pager_play
11f30 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 back_one_page(pP
11f40 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e 6a 66 ager, pPager->jf
11f50 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e d, pPager->journ
11f60 61 6c 4f 66 66 2c 20 31 29 3b 0a 20 20 20 20 61 alOff, 1);. a
11f70 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
11f80 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 69 66 E_DONE );. if
11f90 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
11fa0 29 20 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f ) goto end_stmt_
11fb0 70 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20 playback;. }..
11fc0 20 77 68 69 6c 65 28 20 70 50 61 67 65 72 2d 3e while( pPager->
11fd0 6a 6f 75 72 6e 61 6c 4f 66 66 20 3c 20 73 7a 4a journalOff < szJ
11fe0 20 29 7b 0a 20 20 20 20 75 33 32 20 6e 4a 52 65 ){. u32 nJRe
11ff0 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 c; /* Nu
12000 6d 62 65 72 20 6f 66 20 4a 6f 75 72 6e 61 6c 20 mber of Journal
12010 52 65 63 6f 72 64 73 20 2a 2f 0a 20 20 20 20 75 Records */. u
12020 33 32 20 64 75 6d 6d 79 3b 0a 20 20 20 20 72 63 32 dummy;. rc
12030 20 3d 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64 = readJournalHd
12040 72 28 70 50 61 67 65 72 2c 20 73 7a 4a 2c 20 26 r(pPager, szJ, &
12050 6e 4a 52 65 63 2c 20 26 64 75 6d 6d 79 29 3b 0a nJRec, &dummy);.
12060 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
12070 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 TE_OK ){. a
12080 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 ssert( rc!=SQLIT
12090 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 20 20 20 20 E_DONE );.
120a0 67 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f 70 6c goto end_stmt_pl
120b0 61 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 ayback;. }.
120c0 20 20 69 66 28 20 6e 4a 52 65 63 3d 3d 30 20 29 if( nJRec==0 )
120d0 7b 0a 20 20 20 20 20 20 6e 4a 52 65 63 20 3d 20 {. nJRec =
120e0 28 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a (szJ - pPager->j
120f0 6f 75 72 6e 61 6c 4f 66 66 29 20 2f 20 28 70 50 ournalOff) / (pP
12100 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2b 38 ager->pageSize+8
12110 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 );. }. for
12120 28 69 3d 6e 4a 52 65 63 2d 31 3b 20 69 3e 3d 30 (i=nJRec-1; i>=0
12130 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 && pPager->jour
12140 6e 61 6c 4f 66 66 20 3c 20 73 7a 4a 3b 20 69 2d nalOff < szJ; i-
12150 2d 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 -){. rc = p
12160 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e ager_playback_on
12170 65 5f 70 61 67 65 28 70 50 61 67 65 72 2c 20 70 e_page(pPager, p
12180 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 Pager->jfd, pPag
12190 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 er->journalOff,
121a0 31 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 1);. assert
121b0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e ( rc!=SQLITE_DON
121c0 45 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 E );. if( r
121d0 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 c!=SQLITE_OK ) g
121e0 6f 74 6f 20 65 6e 64 5f 73 74 6d 74 5f 70 6c 61 oto end_stmt_pla
121f0 79 62 61 63 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d yback;. }. }
12200 0a 0a 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 .. pPager->jour
12210 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 20 nalOff = szJ;.
12220 0a 65 6e 64 5f 73 74 6d 74 5f 70 6c 61 79 62 61 .end_stmt_playba
12230 63 6b 3a 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 ck:. if( rc==SQ
12240 4c 49 54 45 5f 4f 4b 29 20 7b 0a 20 20 20 20 70 LITE_OK) {. p
12250 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
12260 66 20 3d 20 73 7a 4a 3b 0a 20 20 20 20 2f 2a 20 f = szJ;. /*
12270 70 61 67 65 72 5f 72 65 6c 6f 61 64 5f 63 61 63 pager_reload_cac
12280 68 65 28 70 50 61 67 65 72 29 3b 20 2a 2f 0a 20 he(pPager); */.
12290 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }. return rc;.
122a0 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 }../*.** Change
122b0 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 the maximum numb
122c0 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 79 20 er of in-memory
122d0 70 61 67 65 73 20 74 68 61 74 20 61 72 65 20 61 pages that are a
122e0 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 76 6f 69 64 20 llowed..*/.void
122f0 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 43 sqlite3PagerSetC
12300 61 63 68 65 73 69 7a 65 28 50 61 67 65 72 20 2a achesize(Pager *
12310 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 50 61 pPager, int mxPa
12320 67 65 29 7b 0a 20 20 69 66 28 20 6d 78 50 61 67 ge){. if( mxPag
12330 65 3e 31 30 20 29 7b 0a 20 20 20 20 70 50 61 67 e>10 ){. pPag
12340 65 72 2d 3e 6d 78 50 61 67 65 20 3d 20 6d 78 50 er->mxPage = mxP
12350 61 67 65 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 age;. }else{.
12360 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67 65 pPager->mxPage
12370 20 3d 20 31 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a = 10;. }.}../*
12380 0a 2a 2a 20 41 64 6a 75 73 74 20 74 68 65 20 72 .** Adjust the r
12390 6f 62 75 73 74 6e 65 73 73 20 6f 66 20 74 68 65 obustness of the
123a0 20 64 61 74 61 62 61 73 65 20 74 6f 20 64 61 6d database to dam
123b0 61 67 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72 age due to OS cr
123c0 61 73 68 65 73 0a 2a 2a 20 6f 72 20 70 6f 77 65 ashes.** or powe
123d0 72 20 66 61 69 6c 75 72 65 73 20 62 79 20 63 68 r failures by ch
123e0 61 6e 67 69 6e 67 20 74 68 65 20 6e 75 6d 62 65 anging the numbe
123f0 72 20 6f 66 20 73 79 6e 63 73 28 29 73 20 77 68 r of syncs()s wh
12400 65 6e 20 77 72 69 74 69 6e 67 0a 2a 2a 20 74 68 en writing.** th
12410 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
12420 61 6c 2e 20 20 54 68 65 72 65 20 61 72 65 20 74 al. There are t
12430 68 72 65 65 20 6c 65 76 65 6c 73 3a 0a 2a 2a 0a hree levels:.**.
12440 2a 2a 20 20 20 20 4f 46 46 20 20 20 20 20 20 20 ** OFF
12450 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 29 20 sqlite3OsSync()
12460 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 2e is never called.
12470 20 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65 This is the de
12480 66 61 75 6c 74 0a 2a 2a 20 20 20 20 20 20 20 20 fault.**
12490 20 20 20 20 20 20 66 6f 72 20 74 65 6d 70 6f 72 for tempor
124a0 61 72 79 20 61 6e 64 20 74 72 61 6e 73 69 65 6e ary and transien
124b0 74 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 t files..**.**
124c0 20 20 4e 4f 52 4d 41 4c 20 20 20 20 54 68 65 20 NORMAL The
124d0 6a 6f 75 72 6e 61 6c 20 69 73 20 73 79 6e 63 65 journal is synce
124e0 64 20 6f 6e 63 65 20 62 65 66 6f 72 65 20 77 72 d once before wr
124f0 69 74 65 73 20 62 65 67 69 6e 20 6f 6e 20 74 68 ites begin on th
12500 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
12510 20 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 database. Thi
12520 73 20 69 73 20 6e 6f 72 6d 61 6c 6c 79 20 61 64 s is normally ad
12530 65 71 75 61 74 65 20 70 72 6f 74 65 63 74 69 6f equate protectio
12540 6e 2c 20 62 75 74 0a 2a 2a 20 20 20 20 20 20 20 n, but.**
12550 20 20 20 20 20 20 20 69 74 20 69 73 20 74 68 65 it is the
12560 6f 72 65 74 69 63 61 6c 6c 79 20 70 6f 73 73 69 oretically possi
12570 62 6c 65 2c 20 74 68 6f 75 67 68 20 76 65 72 79 ble, though very
12580 20 75 6e 6c 69 6b 65 6c 79 2c 0a 2a 2a 20 20 20 unlikely,.**
12590 20 20 20 20 20 20 20 20 20 20 20 74 68 61 74 20 that
125a0 61 6e 20 69 6e 6f 70 65 72 74 75 6e 65 20 70 6f an inopertune po
125b0 77 65 72 20 66 61 69 6c 75 72 65 20 63 6f 75 6c wer failure coul
125c0 64 20 6c 65 61 76 65 20 74 68 65 20 6a 6f 75 72 d leave the jour
125d0 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 nal.**
125e0 20 20 20 20 69 6e 20 61 20 73 74 61 74 65 20 77 in a state w
125f0 68 69 63 68 20 77 6f 75 6c 64 20 63 61 75 73 65 hich would cause
12600 20 64 61 6d 61 67 65 20 74 6f 20 74 68 65 20 64 damage to the d
12610 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 20 20 atabase.**
12620 20 20 20 20 20 20 20 20 77 68 65 6e 20 69 74 20 when it
12630 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a is rolled back..
12640 2a 2a 0a 2a 2a 20 20 20 20 46 55 4c 4c 20 20 20 **.** FULL
12650 20 20 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69 The journal i
12660 73 20 73 79 6e 63 65 64 20 74 77 69 63 65 20 62 s synced twice b
12670 65 66 6f 72 65 20 77 72 69 74 65 73 20 62 65 67 efore writes beg
12680 69 6e 20 6f 6e 20 74 68 65 0a 2a 2a 20 20 20 20 in on the.**
12690 20 20 20 20 20 20 20 20 20 20 64 61 74 61 62 61 databa
126a0 73 65 20 28 77 69 74 68 20 73 6f 6d 65 20 61 64 se (with some ad
126b0 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 ditional informa
126c0 74 69 6f 6e 20 2d 20 74 68 65 20 6e 52 65 63 20 tion - the nRec
126d0 66 69 65 6c 64 0a 2a 2a 20 20 20 20 20 20 20 20 field.**
126e0 20 20 20 20 20 20 6f 66 20 74 68 65 20 6a 6f 75 of the jou
126f0 72 6e 61 6c 20 68 65 61 64 65 72 20 2d 20 62 65 rnal header - be
12700 69 6e 67 20 77 72 69 74 74 65 6e 20 69 6e 20 62 ing written in b
12710 65 74 77 65 65 6e 20 74 68 65 20 74 77 6f 0a 2a etween the two.*
12720 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 * s
12730 79 6e 63 73 29 2e 20 20 49 66 20 77 65 20 61 73 yncs). If we as
12740 73 75 6d 65 20 74 68 61 74 20 77 72 69 74 69 6e sume that writin
12750 67 20 61 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 g a.**
12760 20 20 20 20 73 69 6e 67 6c 65 20 64 69 73 6b 20 single disk
12770 73 65 63 74 6f 72 20 69 73 20 61 74 6f 6d 69 63 sector is atomic
12780 2c 20 74 68 65 6e 20 74 68 69 73 20 6d 6f 64 65 , then this mode
12790 20 70 72 6f 76 69 64 65 73 0a 2a 2a 20 20 20 20 provides.**
127a0 20 20 20 20 20 20 20 20 20 20 61 73 73 75 72 61 assura
127b0 6e 63 65 20 74 68 61 74 20 74 68 65 20 6a 6f 75 nce that the jou
127c0 72 6e 61 6c 20 77 69 6c 6c 20 6e 6f 74 20 62 65 rnal will not be
127d0 20 63 6f 72 72 75 70 74 65 64 20 74 6f 20 74 68 corrupted to th
127e0 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
127f0 20 20 70 6f 69 6e 74 20 6f 66 20 63 61 75 73 69 point of causi
12800 6e 67 20 64 61 6d 61 67 65 20 74 6f 20 74 68 65 ng damage to the
12810 20 64 61 74 61 62 61 73 65 20 64 75 72 69 6e 67 database during
12820 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a rollback..**.**
12830 20 4e 75 6d 65 72 69 63 20 76 61 6c 75 65 73 20 Numeric values
12840 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
12850 74 68 65 73 65 20 73 74 61 74 65 73 20 61 72 65 these states are
12860 20 4f 46 46 3d 3d 31 2c 20 4e 4f 52 4d 41 4c 3d OFF==1, NORMAL=
12870 32 2c 0a 2a 2a 20 61 6e 64 20 46 55 4c 4c 3d 33 2,.** and FULL=3
12880 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
12890 49 54 45 5f 4f 4d 49 54 5f 50 41 47 45 52 5f 50 ITE_OMIT_PAGER_P
128a0 52 41 47 4d 41 53 0a 76 6f 69 64 20 73 71 6c 69 RAGMAS.void sqli
128b0 74 65 33 50 61 67 65 72 53 65 74 53 61 66 65 74 te3PagerSetSafet
128c0 79 4c 65 76 65 6c 28 50 61 67 65 72 20 2a 70 50 yLevel(Pager *pP
128d0 61 67 65 72 2c 20 69 6e 74 20 6c 65 76 65 6c 2c ager, int level,
128e0 20 69 6e 74 20 66 75 6c 6c 5f 66 73 79 6e 63 29 int full_fsync)
128f0 7b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 {. pPager->noSy
12900 6e 63 20 3d 20 20 6c 65 76 65 6c 3d 3d 31 20 7c nc = level==1 |
12910 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
12920 6c 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e 66 75 le;. pPager->fu
12930 6c 6c 53 79 6e 63 20 3d 20 6c 65 76 65 6c 3d 3d llSync = level==
12940 33 20 26 26 20 21 70 50 61 67 65 72 2d 3e 74 65 3 && !pPager->te
12950 6d 70 46 69 6c 65 3b 0a 20 20 70 50 61 67 65 72 mpFile;. pPager
12960 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 20 3d 20 28 ->sync_flags = (
12970 66 75 6c 6c 5f 66 73 79 6e 63 3f 53 51 4c 49 54 full_fsync?SQLIT
12980 45 5f 53 59 4e 43 5f 46 55 4c 4c 3a 53 51 4c 49 E_SYNC_FULL:SQLI
12990 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 29 3b TE_SYNC_NORMAL);
129a0 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e . if( pPager->n
129b0 6f 53 79 6e 63 20 29 20 70 50 61 67 65 72 2d 3e oSync ) pPager->
129c0 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 7d 0a needSync = 0;.}.
129d0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
129e0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 67 6c 6f 62 e following glob
129f0 61 6c 20 76 61 72 69 61 62 6c 65 20 69 73 20 69 al variable is i
12a00 6e 63 72 65 6d 65 6e 74 65 64 20 77 68 65 6e 65 ncremented whene
12a10 76 65 72 20 74 68 65 20 6c 69 62 72 61 72 79 0a ver the library.
12a20 2a 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 6f ** attempts to o
12a30 70 65 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 pen a temporary
12a40 66 69 6c 65 2e 20 20 54 68 69 73 20 69 6e 66 6f file. This info
12a50 72 6d 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 rmation is used
12a60 66 6f 72 0a 2a 2a 20 74 65 73 74 69 6e 67 20 61 for.** testing a
12a70 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79 nd analysis only
12a80 2e 20 20 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 . .*/.#ifdef SQ
12a90 4c 49 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71 LITE_TEST.int sq
12aa0 6c 69 74 65 33 5f 6f 70 65 6e 74 65 6d 70 5f 63 lite3_opentemp_c
12ab0 6f 75 6e 74 20 3d 20 30 3b 0a 23 65 6e 64 69 66 ount = 0;.#endif
12ac0 0a 0a 2f 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 74 ../*.** Open a t
12ad0 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 0a emporary file. .
12ae0 2a 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 65 20 **.** Write the
12af0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
12b00 69 6e 74 6f 20 2a 66 64 2e 20 20 52 65 74 75 72 into *fd. Retur
12b10 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73 n SQLITE_OK on s
12b20 75 63 63 65 73 73 20 6f 72 20 73 6f 6d 65 0a 2a uccess or some.*
12b30 2a 20 6f 74 68 65 72 20 65 72 72 6f 72 20 63 6f * other error co
12b40 64 65 20 69 66 20 77 65 20 66 61 69 6c 2e 20 54 de if we fail. T
12b50 68 65 20 4f 53 20 77 69 6c 6c 20 61 75 74 6f 6d he OS will autom
12b60 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 20 atically delete
12b70 74 68 65 20 74 65 6d 70 6f 72 61 72 79 0a 2a 2a the temporary.**
12b80 20 66 69 6c 65 20 77 68 65 6e 20 69 74 20 69 73 file when it is
12b90 20 63 6c 6f 73 65 64 2e 0a 2a 2f 0a 73 74 61 74 closed..*/.stat
12ba0 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50 61 ic int sqlite3Pa
12bb0 67 65 72 4f 70 65 6e 74 65 6d 70 28 0a 20 20 73 gerOpentemp(. s
12bc0 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 qlite3_vfs *pVfs
12bd0 2c 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72 74 , /* The virt
12be0 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 20 ual file system
12bf0 6c 61 79 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 layer */. sqlit
12c00 65 33 5f 66 69 6c 65 20 2a 70 46 69 6c 65 2c 20 e3_file *pFile,
12c10 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 66 69 /* Write the fi
12c20 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 68 65 le descriptor he
12c30 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46 re */. char *zF
12c40 69 6c 65 6e 61 6d 65 2c 20 20 20 20 20 20 2f 2a ilename, /*
12c50 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 66 69 6c Name of the fil
12c60 65 2e 20 20 4d 69 67 68 74 20 62 65 20 4e 55 4c e. Might be NUL
12c70 4c 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c L */. int vfsFl
12c80 61 67 73 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ags /*
12c90 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 68 72 Flags passed thr
12ca0 6f 75 67 68 20 74 6f 20 74 68 65 20 56 46 53 20 ough to the VFS
12cb0 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a */.){. int rc;.
12cc0 20 20 61 73 73 65 72 74 28 20 7a 46 69 6c 65 6e assert( zFilen
12cd0 61 6d 65 21 3d 30 20 29 3b 0a 0a 23 69 66 64 65 ame!=0 );..#ifde
12ce0 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 f SQLITE_TEST.
12cf0 73 71 6c 69 74 65 33 5f 6f 70 65 6e 74 65 6d 70 sqlite3_opentemp
12d00 5f 63 6f 75 6e 74 2b 2b 3b 20 20 2f 2a 20 55 73 _count++; /* Us
12d10 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67 20 61 ed for testing a
12d20 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c 79 nd analysis only
12d30 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 20 76 66 */.#endif.. vf
12d40 73 46 6c 61 67 73 20 7c 3d 20 20 53 51 4c 49 54 sFlags |= SQLIT
12d50 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
12d60 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 | SQLITE_OPEN_C
12d70 52 45 41 54 45 20 7c 0a 20 20 20 20 20 20 20 20 REATE |.
12d80 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f SQLITE_OPEN_
12d90 45 58 43 4c 55 53 49 56 45 20 7c 20 53 51 4c 49 EXCLUSIVE | SQLI
12da0 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 45 4f 4e TE_OPEN_DELETEON
12db0 43 4c 4f 53 45 3b 0a 20 20 72 63 20 3d 20 73 71 CLOSE;. rc = sq
12dc0 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 lite3OsOpen(pVfs
12dd0 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 46 69 , zFilename, pFi
12de0 6c 65 2c 20 76 66 73 46 6c 61 67 73 2c 20 30 29 le, vfsFlags, 0)
12df0 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 21 3d ;. assert( rc!=
12e00 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 46 69 SQLITE_OK || pFi
12e10 6c 65 2d 3e 70 4d 65 74 68 6f 64 73 20 29 3b 0a le->pMethods );.
12e20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
12e30 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e /*.** Create a n
12e40 65 77 20 70 61 67 65 20 63 61 63 68 65 20 61 6e ew page cache an
12e50 64 20 70 75 74 20 61 20 70 6f 69 6e 74 65 72 20 d put a pointer
12e60 74 6f 20 74 68 65 20 70 61 67 65 20 63 61 63 68 to the page cach
12e70 65 20 69 6e 20 2a 70 70 50 61 67 65 72 2e 0a 2a e in *ppPager..*
12e80 2a 20 54 68 65 20 66 69 6c 65 20 74 6f 20 62 65 * The file to be
12e90 20 63 61 63 68 65 64 20 6e 65 65 64 20 6e 6f 74 cached need not
12ea0 20 65 78 69 73 74 2e 20 20 54 68 65 20 66 69 6c exist. The fil
12eb0 65 20 69 73 20 6e 6f 74 20 6c 6f 63 6b 65 64 20 e is not locked
12ec0 75 6e 74 69 6c 0a 2a 2a 20 74 68 65 20 66 69 72 until.** the fir
12ed0 73 74 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 st call to sqlit
12ee0 65 33 50 61 67 65 72 47 65 74 28 29 20 61 6e 64 e3PagerGet() and
12ef0 20 69 73 20 6f 6e 6c 79 20 68 65 6c 64 20 6f 70 is only held op
12f00 65 6e 20 75 6e 74 69 6c 20 74 68 65 0a 2a 2a 20 en until the.**
12f10 6c 61 73 74 20 70 61 67 65 20 69 73 20 72 65 6c last page is rel
12f20 65 61 73 65 64 20 75 73 69 6e 67 20 73 71 6c 69 eased using sqli
12f30 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 2e te3PagerUnref().
12f40 0a 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e .**.** If zFilen
12f50 61 6d 65 20 69 73 20 4e 55 4c 4c 20 74 68 65 6e ame is NULL then
12f60 20 61 20 72 61 6e 64 6f 6d 6c 79 2d 6e 61 6d 65 a randomly-name
12f70 64 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 d temporary file
12f80 20 69 73 20 63 72 65 61 74 65 64 0a 2a 2a 20 61 is created.** a
12f90 6e 64 20 75 73 65 64 20 61 73 20 74 68 65 20 66 nd used as the f
12fa0 69 6c 65 20 74 6f 20 62 65 20 63 61 63 68 65 64 ile to be cached
12fb0 2e 20 20 54 68 65 20 66 69 6c 65 20 77 69 6c 6c . The file will
12fc0 20 62 65 20 64 65 6c 65 74 65 64 0a 2a 2a 20 61 be deleted.** a
12fd0 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 utomatically whe
12fe0 6e 20 69 74 20 69 73 20 63 6c 6f 73 65 64 2e 0a n it is closed..
12ff0 2a 2a 0a 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 **.** If zFilena
13000 6d 65 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 me is ":memory:"
13010 20 74 68 65 6e 20 61 6c 6c 20 69 6e 66 6f 72 6d then all inform
13020 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 69 6e ation is held in
13030 20 63 61 63 68 65 2e 0a 2a 2a 20 49 74 20 69 73 cache..** It is
13040 20 6e 65 76 65 72 20 77 72 69 74 74 65 6e 20 74 never written t
13050 6f 20 64 69 73 6b 2e 20 20 54 68 69 73 20 63 61 o disk. This ca
13060 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 6d 70 n be used to imp
13070 6c 65 6d 65 6e 74 20 61 6e 0a 2a 2a 20 69 6e 2d lement an.** in-
13080 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e memory database.
13090 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 .*/.int sqlite3P
130a0 61 67 65 72 4f 70 65 6e 28 0a 20 20 73 71 6c 69 agerOpen(. sqli
130b0 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 20 te3_vfs *pVfs,
130c0 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72 74 /* The virt
130d0 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d 20 ual file system
130e0 74 6f 20 75 73 65 20 2a 2f 0a 20 20 50 61 67 65 to use */. Page
130f0 72 20 2a 2a 70 70 50 61 67 65 72 2c 20 20 20 20 r **ppPager,
13100 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 74 /* Return t
13110 68 65 20 50 61 67 65 72 20 73 74 72 75 63 74 75 he Pager structu
13120 72 65 20 68 65 72 65 20 2a 2f 0a 20 20 63 6f 6e re here */. con
13130 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 6e 61 st char *zFilena
13140 6d 65 2c 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 me, /* Name of
13150 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
13160 6c 65 20 74 6f 20 6f 70 65 6e 20 2a 2f 0a 20 20 le to open */.
13170 69 6e 74 20 6e 45 78 74 72 61 2c 20 20 20 20 20 int nExtra,
13180 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 /* Extr
13190 61 20 62 79 74 65 73 20 61 70 70 65 6e 64 20 74 a bytes append t
131a0 6f 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 o each in-memory
131b0 20 70 61 67 65 20 2a 2f 0a 20 20 69 6e 74 20 66 page */. int f
131c0 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 lags,
131d0 20 20 20 20 2f 2a 20 66 6c 61 67 73 20 63 6f 6e /* flags con
131e0 74 72 6f 6c 6c 69 6e 67 20 74 68 69 73 20 66 69 trolling this fi
131f0 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 76 66 73 46 le */. int vfsF
13200 6c 61 67 73 20 20 20 20 20 20 20 20 20 20 20 20 lags
13210 20 2f 2a 20 66 6c 61 67 73 20 70 61 73 73 65 64 /* flags passed
13220 20 74 68 72 6f 75 67 68 20 74 6f 20 73 71 6c 69 through to sqli
13230 74 65 33 5f 76 66 73 2e 78 4f 70 65 6e 28 29 20 te3_vfs.xOpen()
13240 2a 2f 0a 29 7b 0a 20 20 75 38 20 2a 70 50 74 72 */.){. u8 *pPtr
13250 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 ;. Pager *pPage
13260 72 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 r = 0;. int rc
13270 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 = SQLITE_OK;. i
13280 6e 74 20 69 3b 0a 20 20 69 6e 74 20 74 65 6d 70 nt i;. int temp
13290 46 69 6c 65 20 3d 20 30 3b 0a 20 20 69 6e 74 20 File = 0;. int
132a0 6d 65 6d 44 62 20 3d 20 30 3b 0a 20 20 69 6e 74 memDb = 0;. int
132b0 20 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 0a 20 readOnly = 0;.
132c0 20 69 6e 74 20 75 73 65 4a 6f 75 72 6e 61 6c 20 int useJournal
132d0 3d 20 28 66 6c 61 67 73 20 26 20 50 41 47 45 52 = (flags & PAGER
132e0 5f 4f 4d 49 54 5f 4a 4f 55 52 4e 41 4c 29 3d 3d _OMIT_JOURNAL)==
132f0 30 3b 0a 20 20 69 6e 74 20 6e 6f 52 65 61 64 6c 0;. int noReadl
13300 6f 63 6b 20 3d 20 28 66 6c 61 67 73 20 26 20 50 ock = (flags & P
13310 41 47 45 52 5f 4e 4f 5f 52 45 41 44 4c 4f 43 4b AGER_NO_READLOCK
13320 29 21 3d 30 3b 0a 20 20 69 6e 74 20 6a 6f 75 72 )!=0;. int jour
13330 6e 61 6c 46 69 6c 65 53 69 7a 65 20 3d 20 73 71 nalFileSize = sq
13340 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 lite3JournalSize
13350 28 70 56 66 73 29 3b 0a 20 20 69 6e 74 20 6e 44 (pVfs);. int nD
13360 65 66 61 75 6c 74 50 61 67 65 20 3d 20 53 51 4c efaultPage = SQL
13370 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 ITE_DEFAULT_PAGE
13380 5f 53 49 5a 45 3b 0a 20 20 63 68 61 72 20 2a 7a _SIZE;. char *z
13390 50 61 74 68 6e 61 6d 65 3b 0a 20 20 69 6e 74 20 Pathname;. int
133a0 6e 50 61 74 68 6e 61 6d 65 3b 0a 20 20 63 68 61 nPathname;. cha
133b0 72 20 2a 7a 53 74 6d 74 4a 72 6e 6c 3b 0a 20 20 r *zStmtJrnl;.
133c0 69 6e 74 20 6e 53 74 6d 74 4a 72 6e 6c 3b 0a 0a int nStmtJrnl;..
133d0 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74 /* The default
133e0 20 72 65 74 75 72 6e 20 69 73 20 61 20 4e 55 4c return is a NUL
133f0 4c 20 70 6f 69 6e 74 65 72 20 2a 2f 0a 20 20 2a L pointer */. *
13400 70 70 50 61 67 65 72 20 3d 20 30 3b 0a 0a 20 20 ppPager = 0;..
13410 2f 2a 20 43 6f 6d 70 75 74 65 20 74 68 65 20 66 /* Compute the f
13420 75 6c 6c 20 70 61 74 68 6e 61 6d 65 20 2a 2f 0a ull pathname */.
13430 20 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 70 56 nPathname = pV
13440 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 fs->mxPathname+1
13450 3b 0a 20 20 7a 50 61 74 68 6e 61 6d 65 20 3d 20 ;. zPathname =
13460 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e sqlite3_malloc(n
13470 50 61 74 68 6e 61 6d 65 2a 32 29 3b 0a 20 20 69 Pathname*2);. i
13480 66 28 20 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20 f( zPathname==0
13490 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
134a0 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a LITE_NOMEM;. }.
134b0 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d 65 20 if( zFilename
134c0 26 26 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 && zFilename[0]
134d0 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ){.#ifndef SQLIT
134e0 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 0a E_OMIT_MEMORYDB.
134f0 20 20 20 20 69 66 28 20 73 74 72 63 6d 70 28 7a if( strcmp(z
13500 46 69 6c 65 6e 61 6d 65 2c 22 3a 6d 65 6d 6f 72 Filename,":memor
13510 79 3a 22 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 y:")==0 ){.
13520 20 6d 65 6d 44 62 20 3d 20 31 3b 0a 20 20 20 20 memDb = 1;.
13530 20 20 7a 50 61 74 68 6e 61 6d 65 5b 30 5d 20 3d zPathname[0] =
13540 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 0a 23 65 0;. }else.#e
13550 6e 64 69 66 0a 20 20 20 20 7b 0a 20 20 20 20 20 ndif. {.
13560 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 rc = sqlite3OsF
13570 75 6c 6c 50 61 74 68 6e 61 6d 65 28 70 56 66 73 ullPathname(pVfs
13580 2c 20 7a 46 69 6c 65 6e 61 6d 65 2c 20 6e 50 61 , zFilename, nPa
13590 74 68 6e 61 6d 65 2c 20 7a 50 61 74 68 6e 61 6d thname, zPathnam
135a0 65 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 e);. }. }els
135b0 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 e{. rc = sqli
135c0 74 65 33 4f 73 47 65 74 54 65 6d 70 6e 61 6d 65 te3OsGetTempname
135d0 28 70 56 66 73 2c 20 6e 50 61 74 68 6e 61 6d 65 (pVfs, nPathname
135e0 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 , zPathname);.
135f0 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 }. if( rc!=SQLI
13600 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
13610 69 74 65 33 5f 66 72 65 65 28 7a 50 61 74 68 6e ite3_free(zPathn
13620 61 6d 65 29 3b 0a 20 20 20 20 72 65 74 75 72 6e ame);. return
13630 20 72 63 3b 0a 20 20 7d 0a 20 20 6e 50 61 74 68 rc;. }. nPath
13640 6e 61 6d 65 20 3d 20 73 74 72 6c 65 6e 28 7a 50 name = strlen(zP
13650 61 74 68 6e 61 6d 65 29 3b 0a 0a 20 20 2f 2a 20 athname);.. /*
13660 50 75 74 20 74 68 65 20 73 74 61 74 65 6d 65 6e Put the statemen
13670 74 20 6a 6f 75 72 6e 61 6c 20 69 6e 20 74 65 6d t journal in tem
13680 70 6f 72 61 72 79 20 64 69 73 6b 20 73 70 61 63 porary disk spac
13690 65 20 73 69 6e 63 65 20 74 68 69 73 20 69 73 0a e since this is.
136a0 20 20 2a 2a 20 73 6f 6d 65 74 69 6d 65 73 20 52 ** sometimes R
136b0 41 4d 20 64 69 73 6b 20 6f 72 20 6f 74 68 65 72 AM disk or other
136c0 20 6f 70 74 69 6d 69 7a 65 64 20 73 74 6f 72 61 optimized stora
136d0 67 65 2e 20 20 55 6e 6c 69 6b 65 6c 79 20 74 68 ge. Unlikely th
136e0 65 20 6d 61 69 6e 0a 20 20 2a 2a 20 6d 61 69 6e e main. ** main
136f0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 journal file, t
13700 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 he statement jou
13710 72 6e 61 6c 20 64 6f 65 73 20 6e 6f 74 20 6e 65 rnal does not ne
13720 65 64 20 74 6f 20 62 65 20 0a 20 20 2a 2a 20 63 ed to be . ** c
13730 6f 6c 6f 63 61 74 65 64 20 77 69 74 68 20 74 68 olocated with th
13740 65 20 64 61 74 61 62 61 73 65 20 6e 6f 72 20 64 e database nor d
13750 6f 65 73 20 69 74 20 6e 65 65 64 20 74 6f 20 62 oes it need to b
13760 65 20 70 65 72 73 69 73 74 65 6e 74 2e 0a 20 20 e persistent..
13770 2a 2f 0a 20 20 7a 53 74 6d 74 4a 72 6e 6c 20 3d */. zStmtJrnl =
13780 20 26 7a 50 61 74 68 6e 61 6d 65 5b 6e 50 61 74 &zPathname[nPat
13790 68 6e 61 6d 65 2b 31 5d 3b 0a 20 20 72 63 20 3d hname+1];. rc =
137a0 20 73 71 6c 69 74 65 33 4f 73 47 65 74 54 65 6d sqlite3OsGetTem
137b0 70 6e 61 6d 65 28 70 56 66 73 2c 20 70 56 66 73 pname(pVfs, pVfs
137c0 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 2c 20 ->mxPathname+1,
137d0 7a 53 74 6d 74 4a 72 6e 6c 29 3b 0a 20 20 69 66 zStmtJrnl);. if
137e0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
137f0 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 ){. sqlite3_f
13800 72 65 65 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a ree(zPathname);.
13810 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
13820 20 7d 0a 20 20 6e 53 74 6d 74 4a 72 6e 6c 20 3d }. nStmtJrnl =
13830 20 73 74 72 6c 65 6e 28 7a 53 74 6d 74 4a 72 6e strlen(zStmtJrn
13840 6c 29 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 l);.. /* Alloca
13850 74 65 20 6d 65 6d 6f 72 79 20 66 6f 72 20 74 68 te memory for th
13860 65 20 70 61 67 65 72 20 73 74 72 75 63 74 75 72 e pager structur
13870 65 20 2a 2f 0a 20 20 70 50 61 67 65 72 20 3d 20 e */. pPager =
13880 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 sqlite3MallocZer
13890 6f 28 0a 20 20 20 20 73 69 7a 65 6f 66 28 2a 70 o(. sizeof(*p
138a0 50 61 67 65 72 29 20 2b 20 20 20 20 20 20 20 20 Pager) +
138b0 20 20 20 2f 2a 20 50 61 67 65 72 20 73 74 72 75 /* Pager stru
138c0 63 74 75 72 65 20 2a 2f 0a 20 20 20 20 6a 6f 75 cture */. jou
138d0 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 2b 20 20 rnalFileSize +
138e0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
138f0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 74 72 journal file str
13900 75 63 74 75 72 65 20 2a 2f 20 0a 20 20 20 20 70 ucture */ . p
13910 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 20 2a 20 Vfs->szOsFile *
13920 33 20 2b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 3 + /* Th
13930 65 20 6d 61 69 6e 20 64 62 20 61 6e 64 20 74 77 e main db and tw
13940 6f 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 o journal files
13950 2a 2f 20 0a 20 20 20 20 33 2a 6e 50 61 74 68 6e */ . 3*nPathn
13960 61 6d 65 20 2b 20 34 30 20 2b 20 20 20 20 20 20 ame + 40 +
13970 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 /* zFilename
13980 2c 20 7a 44 69 72 65 63 74 6f 72 79 2c 20 7a 4a , zDirectory, zJ
13990 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20 6e 53 ournal */. nS
139a0 74 6d 74 4a 72 6e 6c 20 20 20 20 20 20 20 20 20 tmtJrnl
139b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 53 74 /* zSt
139c0 6d 74 4a 72 6e 6c 20 2a 2f 0a 20 20 29 3b 0a 20 mtJrnl */. );.
139d0 20 69 66 28 20 21 70 50 61 67 65 72 20 29 7b 0a if( !pPager ){.
139e0 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 sqlite3_free
139f0 28 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 20 (zPathname);.
13a00 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
13a10 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 70 50 74 72 OMEM;. }. pPtr
13a20 20 3d 20 28 75 38 20 2a 29 26 70 50 61 67 65 72 = (u8 *)&pPager
13a30 5b 31 5d 3b 0a 20 20 70 50 61 67 65 72 2d 3e 76 [1];. pPager->v
13a40 66 73 46 6c 61 67 73 20 3d 20 76 66 73 46 6c 61 fsFlags = vfsFla
13a50 67 73 3b 0a 20 20 70 50 61 67 65 72 2d 3e 66 64 gs;. pPager->fd
13a60 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 = (sqlite3_file
13a70 2a 29 26 70 50 74 72 5b 70 56 66 73 2d 3e 73 7a *)&pPtr[pVfs->sz
13a80 4f 73 46 69 6c 65 2a 30 5d 3b 0a 20 20 70 50 61 OsFile*0];. pPa
13a90 67 65 72 2d 3e 73 74 66 64 20 3d 20 28 73 71 6c ger->stfd = (sql
13aa0 69 74 65 33 5f 66 69 6c 65 2a 29 26 70 50 74 72 ite3_file*)&pPtr
13ab0 5b 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 2a [pVfs->szOsFile*
13ac0 31 5d 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6a 66 1];. pPager->jf
13ad0 64 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69 6c d = (sqlite3_fil
13ae0 65 2a 29 26 70 50 74 72 5b 70 56 66 73 2d 3e 73 e*)&pPtr[pVfs->s
13af0 7a 4f 73 46 69 6c 65 2a 32 5d 3b 0a 20 20 70 50 zOsFile*2];. pP
13b00 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 20 ager->zFilename
13b10 3d 20 28 63 68 61 72 2a 29 26 70 50 74 72 5b 70 = (char*)&pPtr[p
13b20 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 2a 32 2b Vfs->szOsFile*2+
13b30 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 5d journalFileSize]
13b40 3b 0a 20 20 70 50 61 67 65 72 2d 3e 7a 44 69 72 ;. pPager->zDir
13b50 65 63 74 6f 72 79 20 3d 20 26 70 50 61 67 65 72 ectory = &pPager
13b60 2d 3e 7a 46 69 6c 65 6e 61 6d 65 5b 6e 50 61 74 ->zFilename[nPat
13b70 68 6e 61 6d 65 2b 31 5d 3b 0a 20 20 70 50 61 67 hname+1];. pPag
13b80 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 20 3d 20 26 er->zJournal = &
13b90 70 50 61 67 65 72 2d 3e 7a 44 69 72 65 63 74 6f pPager->zDirecto
13ba0 72 79 5b 6e 50 61 74 68 6e 61 6d 65 2b 31 5d 3b ry[nPathname+1];
13bb0 0a 20 20 70 50 61 67 65 72 2d 3e 7a 53 74 6d 74 . pPager->zStmt
13bc0 4a 72 6e 6c 20 3d 20 26 70 50 61 67 65 72 2d 3e Jrnl = &pPager->
13bd0 7a 4a 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 zJournal[nPathna
13be0 6d 65 2b 31 30 5d 3b 0a 20 20 70 50 61 67 65 72 me+10];. pPager
13bf0 2d 3e 70 56 66 73 20 3d 20 70 56 66 73 3b 0a 20 ->pVfs = pVfs;.
13c00 20 6d 65 6d 63 70 79 28 70 50 61 67 65 72 2d 3e memcpy(pPager->
13c10 7a 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 74 68 zFilename, zPath
13c20 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 2b name, nPathname+
13c30 31 29 3b 0a 20 20 6d 65 6d 63 70 79 28 70 50 61 1);. memcpy(pPa
13c40 67 65 72 2d 3e 7a 53 74 6d 74 4a 72 6e 6c 2c 20 ger->zStmtJrnl,
13c50 7a 53 74 6d 74 4a 72 6e 6c 2c 20 6e 53 74 6d 74 zStmtJrnl, nStmt
13c60 4a 72 6e 6c 2b 31 29 3b 0a 20 20 73 71 6c 69 74 Jrnl+1);. sqlit
13c70 65 33 5f 66 72 65 65 28 7a 50 61 74 68 6e 61 6d e3_free(zPathnam
13c80 65 29 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 e);.. /* Open t
13c90 68 65 20 70 61 67 65 72 20 66 69 6c 65 2e 0a 20 he pager file..
13ca0 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e */. if( zFilen
13cb0 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65 ame && zFilename
13cc0 5b 30 5d 20 26 26 20 21 6d 65 6d 44 62 20 29 7b [0] && !memDb ){
13cd0 0a 20 20 20 20 69 66 28 20 6e 50 61 74 68 6e 61 . if( nPathna
13ce0 6d 65 3e 28 70 56 66 73 2d 3e 6d 78 50 61 74 68 me>(pVfs->mxPath
13cf0 6e 61 6d 65 20 2d 20 73 69 7a 65 6f 66 28 22 2d name - sizeof("-
13d00 6a 6f 75 72 6e 61 6c 22 29 29 20 29 7b 0a 20 20 journal")) ){.
13d10 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
13d20 43 41 4e 54 4f 50 45 4e 3b 0a 20 20 20 20 7d 65 CANTOPEN;. }e
13d30 6c 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 66 lse{. int f
13d40 6f 75 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 72 out = 0;. r
13d50 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 c = sqlite3OsOpe
13d60 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e n(pVfs, pPager->
13d70 7a 46 69 6c 65 6e 61 6d 65 2c 20 70 50 61 67 65 zFilename, pPage
13d80 72 2d 3e 66 64 2c 0a 20 20 20 20 20 20 20 20 20 r->fd,.
13d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13da0 70 50 61 67 65 72 2d 3e 76 66 73 46 6c 61 67 73 pPager->vfsFlags
13db0 2c 20 26 66 6f 75 74 29 3b 0a 20 20 20 20 20 20 , &fout);.
13dc0 72 65 61 64 4f 6e 6c 79 20 3d 20 28 66 6f 75 74 readOnly = (fout
13dd0 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 &SQLITE_OPEN_REA
13de0 44 4f 4e 4c 59 29 3b 0a 0a 20 20 20 20 20 20 2f DONLY);.. /
13df0 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 77 61 * If the file wa
13e00 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 6f s successfully o
13e10 70 65 6e 65 64 20 66 6f 72 20 72 65 61 64 2f 77 pened for read/w
13e20 72 69 74 65 20 61 63 63 65 73 73 2c 0a 20 20 20 rite access,.
13e30 20 20 20 2a 2a 20 63 68 6f 6f 73 65 20 61 20 64 ** choose a d
13e40 65 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65 efault page size
13e50 20 69 6e 20 63 61 73 65 20 77 65 20 68 61 76 65 in case we have
13e60 20 74 6f 20 63 72 65 61 74 65 20 74 68 65 0a 20 to create the.
13e70 20 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 ** database
13e80 20 66 69 6c 65 2e 20 54 68 65 20 64 65 66 61 75 file. The defau
13e90 6c 74 20 70 61 67 65 20 73 69 7a 65 20 69 73 20 lt page size is
13ea0 74 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 3a 0a the maximum of:.
13eb0 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
13ec0 2a 20 20 20 20 2b 20 53 51 4c 49 54 45 5f 44 45 * + SQLITE_DE
13ed0 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 2c FAULT_PAGE_SIZE,
13ee0 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 2b 20 54 . ** + T
13ef0 68 65 20 76 61 6c 75 65 20 72 65 74 75 72 6e 65 he value returne
13f00 64 20 62 79 20 73 71 6c 69 74 65 33 4f 73 53 65 d by sqlite3OsSe
13f10 63 74 6f 72 53 69 7a 65 28 29 0a 20 20 20 20 20 ctorSize().
13f20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 6c 61 72 ** + The lar
13f30 67 65 73 74 20 70 61 67 65 20 73 69 7a 65 20 74 gest page size t
13f40 68 61 74 20 63 61 6e 20 62 65 20 77 72 69 74 74 hat can be writt
13f50 65 6e 20 61 74 6f 6d 69 63 61 6c 6c 79 2e 0a 20 en atomically..
13f60 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 */. if
13f70 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
13f80 26 26 20 21 72 65 61 64 4f 6e 6c 79 20 29 7b 0a && !readOnly ){.
13f90 20 20 20 20 20 20 20 20 69 6e 74 20 69 53 65 63 int iSec
13fa0 74 6f 72 53 69 7a 65 20 3d 20 73 71 6c 69 74 65 torSize = sqlite
13fb0 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 70 50 3OsSectorSize(pP
13fc0 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20 ager->fd);.
13fd0 20 20 20 69 66 28 20 6e 44 65 66 61 75 6c 74 50 if( nDefaultP
13fe0 61 67 65 3c 69 53 65 63 74 6f 72 53 69 7a 65 20 age<iSectorSize
13ff0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 44 65 ){. nDe
14000 66 61 75 6c 74 50 61 67 65 20 3d 20 69 53 65 63 faultPage = iSec
14010 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 20 20 20 torSize;.
14020 20 7d 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }.#ifdef SQLITE
14030 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 _ENABLE_ATOMIC_W
14040 52 49 54 45 0a 20 20 20 20 20 20 20 20 7b 0a 20 RITE. {.
14050 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 44 63 int iDc
14060 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 76 69 = sqlite3OsDevi
14070 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 ceCharacteristic
14080 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 s(pPager->fd);.
14090 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 69 3b int ii;
140a0 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
140b0 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 t(SQLITE_IOCAP_A
140c0 54 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e TOMIC512==(512>>
140d0 38 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 61 8));. a
140e0 73 73 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 ssert(SQLITE_IOC
140f0 41 50 5f 41 54 4f 4d 49 43 36 34 4b 3d 3d 28 36 AP_ATOMIC64K==(6
14100 35 35 33 36 3e 3e 38 29 29 3b 0a 20 20 20 20 20 5536>>8));.
14110 20 20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 assert(SQLI
14120 54 45 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 TE_MAX_DEFAULT_P
14130 41 47 45 5f 53 49 5a 45 3c 3d 36 35 35 33 36 29 AGE_SIZE<=65536)
14140 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 ;. for(
14150 69 69 3d 6e 44 65 66 61 75 6c 74 50 61 67 65 3b ii=nDefaultPage;
14160 20 69 69 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f ii<=SQLITE_MAX_
14170 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a DEFAULT_PAGE_SIZ
14180 45 3b 20 69 69 3d 69 69 2a 32 29 7b 0a 20 20 20 E; ii=ii*2){.
14190 20 20 20 20 20 20 20 20 20 69 66 28 20 69 44 63 if( iDc
141a0 26 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 &(SQLITE_IOCAP_A
141b0 54 4f 4d 49 43 7c 28 69 69 3e 3e 38 29 29 20 29 TOMIC|(ii>>8)) )
141c0 20 6e 44 65 66 61 75 6c 74 50 61 67 65 20 3d 20 nDefaultPage =
141d0 69 69 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ii;. }.
141e0 20 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 }.#endif
141f0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 44 65 . if( nDe
14200 66 61 75 6c 74 50 61 67 65 3e 53 51 4c 49 54 45 faultPage>SQLITE
14210 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 47 _MAX_DEFAULT_PAG
14220 45 5f 53 49 5a 45 20 29 7b 0a 20 20 20 20 20 20 E_SIZE ){.
14230 20 20 20 20 6e 44 65 66 61 75 6c 74 50 61 67 65 nDefaultPage
14240 20 3d 20 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 = SQLITE_MAX_DE
14250 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b FAULT_PAGE_SIZE;
14260 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
14270 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 }. }. }else
14280 20 69 66 28 20 21 6d 65 6d 44 62 20 29 7b 0a 20 if( !memDb ){.
14290 20 20 20 2f 2a 20 49 66 20 61 20 74 65 6d 70 6f /* If a tempo
142a0 72 61 72 79 20 66 69 6c 65 20 69 73 20 72 65 71 rary file is req
142b0 75 65 73 74 65 64 2c 20 69 74 20 69 73 20 6e 6f uested, it is no
142c0 74 20 6f 70 65 6e 65 64 20 69 6d 6d 65 64 69 61 t opened immedia
142d0 74 65 6c 79 2e 0a 20 20 20 20 2a 2a 20 49 6e 20 tely.. ** In
142e0 74 68 69 73 20 63 61 73 65 20 77 65 20 61 63 63 this case we acc
142f0 65 70 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 ept the default
14300 70 61 67 65 20 73 69 7a 65 20 61 6e 64 20 64 65 page size and de
14310 6c 61 79 20 61 63 74 75 61 6c 6c 79 0a 20 20 20 lay actually.
14320 20 2a 2a 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 ** opening the
14330 66 69 6c 65 20 75 6e 74 69 6c 20 74 68 65 20 66 file until the f
14340 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 4f 73 57 irst call to OsW
14350 72 69 74 65 28 29 2e 0a 20 20 20 20 2a 2f 20 0a rite().. */ .
14360 20 20 20 20 74 65 6d 70 46 69 6c 65 20 3d 20 31 tempFile = 1
14370 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 ;. pPager->st
14380 61 74 65 20 3d 20 50 41 47 45 52 5f 45 58 43 4c ate = PAGER_EXCL
14390 55 53 49 56 45 3b 0a 20 20 7d 0a 0a 20 20 69 66 USIVE;. }.. if
143a0 28 20 70 50 61 67 65 72 20 26 26 20 72 63 3d 3d ( pPager && rc==
143b0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
143c0 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 pPager->pTmpSpa
143d0 63 65 20 3d 20 28 63 68 61 72 20 2a 29 73 71 6c ce = (char *)sql
143e0 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 6e 44 65 66 ite3_malloc(nDef
143f0 61 75 6c 74 50 61 67 65 29 3b 0a 20 20 7d 0a 0a aultPage);. }..
14400 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 /* If an error
14410 20 6f 63 63 75 72 65 64 20 69 6e 20 65 69 74 68 occured in eith
14420 65 72 20 6f 66 20 74 68 65 20 62 6c 6f 63 6b 73 er of the blocks
14430 20 61 62 6f 76 65 2e 0a 20 20 2a 2a 20 46 72 65 above.. ** Fre
14440 65 20 74 68 65 20 50 61 67 65 72 20 73 74 72 75 e the Pager stru
14450 63 74 75 72 65 20 61 6e 64 20 63 6c 6f 73 65 20 cture and close
14460 74 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2a 20 53 the file.. ** S
14470 69 6e 63 65 20 74 68 65 20 70 61 67 65 72 20 69 ince the pager i
14480 73 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 64 20 s not allocated
14490 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 there is no need
144a0 20 74 6f 20 73 65 74 20 0a 20 20 2a 2a 20 61 6e to set . ** an
144b0 79 20 50 61 67 65 72 2e 65 72 72 4d 61 73 6b 20 y Pager.errMask
144c0 76 61 72 69 61 62 6c 65 73 2e 0a 20 20 2a 2f 0a variables.. */.
144d0 20 20 69 66 28 20 21 70 50 61 67 65 72 20 7c 7c if( !pPager ||
144e0 20 21 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 !pPager->pTmpSp
144f0 61 63 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ace ){. sqlit
14500 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 e3OsClose(pPager
14510 2d 3e 66 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 ->fd);. sqlit
14520 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b e3_free(pPager);
14530 0a 20 20 20 20 72 65 74 75 72 6e 20 28 28 72 63 . return ((rc
14540 3d 3d 53 51 4c 49 54 45 5f 4f 4b 29 3f 53 51 4c ==SQLITE_OK)?SQL
14550 49 54 45 5f 4e 4f 4d 45 4d 3a 72 63 29 3b 0a 20 ITE_NOMEM:rc);.
14560 20 7d 0a 0a 20 20 50 41 47 45 52 54 52 41 43 45 }.. PAGERTRACE
14570 33 28 22 4f 50 45 4e 20 25 64 20 25 73 5c 6e 22 3("OPEN %d %s\n"
14580 2c 20 46 49 4c 45 48 41 4e 44 4c 45 49 44 28 70 , FILEHANDLEID(p
14590 50 61 67 65 72 2d 3e 66 64 29 2c 20 70 50 61 67 Pager->fd), pPag
145a0 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 3b 0a er->zFilename);.
145b0 20 20 49 4f 54 52 41 43 45 28 28 22 4f 50 45 4e IOTRACE(("OPEN
145c0 20 25 70 20 25 73 5c 6e 22 2c 20 70 50 61 67 65 %p %s\n", pPage
145d0 72 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 r, pPager->zFile
145e0 6e 61 6d 65 29 29 0a 0a 20 20 2f 2a 20 46 69 6c name)).. /* Fil
145f0 6c 20 69 6e 20 50 61 67 65 72 2e 7a 44 69 72 65 l in Pager.zDire
14600 63 74 6f 72 79 5b 5d 20 2a 2f 0a 20 20 6d 65 6d ctory[] */. mem
14610 63 70 79 28 70 50 61 67 65 72 2d 3e 7a 44 69 72 cpy(pPager->zDir
14620 65 63 74 6f 72 79 2c 20 70 50 61 67 65 72 2d 3e ectory, pPager->
14630 7a 46 69 6c 65 6e 61 6d 65 2c 20 6e 50 61 74 68 zFilename, nPath
14640 6e 61 6d 65 2b 31 29 3b 0a 20 20 66 6f 72 28 69 name+1);. for(i
14650 3d 73 74 72 6c 65 6e 28 70 50 61 67 65 72 2d 3e =strlen(pPager->
14660 7a 44 69 72 65 63 74 6f 72 79 29 3b 20 69 3e 30 zDirectory); i>0
14670 20 26 26 20 70 50 61 67 65 72 2d 3e 7a 44 69 72 && pPager->zDir
14680 65 63 74 6f 72 79 5b 69 2d 31 5d 21 3d 27 2f 27 ectory[i-1]!='/'
14690 3b 20 69 2d 2d 29 7b 7d 0a 20 20 69 66 28 20 69 ; i--){}. if( i
146a0 3e 30 20 29 20 70 50 61 67 65 72 2d 3e 7a 44 69 >0 ) pPager->zDi
146b0 72 65 63 74 6f 72 79 5b 69 2d 31 5d 20 3d 20 30 rectory[i-1] = 0
146c0 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 ;.. /* Fill in
146d0 50 61 67 65 72 2e 7a 4a 6f 75 72 6e 61 6c 5b 5d Pager.zJournal[]
146e0 20 2a 2f 0a 20 20 6d 65 6d 63 70 79 28 70 50 61 */. memcpy(pPa
146f0 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 ger->zJournal, p
14700 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 Pager->zFilename
14710 2c 20 6e 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 , nPathname);.
14720 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e memcpy(&pPager->
14730 7a 4a 6f 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 zJournal[nPathna
14740 6d 65 5d 2c 20 22 2d 6a 6f 75 72 6e 61 6c 22 2c me], "-journal",
14750 20 39 29 3b 0a 0a 20 20 2f 2a 20 70 50 61 67 65 9);.. /* pPage
14760 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d r->journalOpen =
14770 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 0; */. pPager-
14780 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 3d 20 75 73 >useJournal = us
14790 65 4a 6f 75 72 6e 61 6c 20 26 26 20 21 6d 65 6d eJournal && !mem
147a0 44 62 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f Db;. pPager->no
147b0 52 65 61 64 6c 6f 63 6b 20 3d 20 6e 6f 52 65 61 Readlock = noRea
147c0 64 6c 6f 63 6b 20 26 26 20 72 65 61 64 4f 6e 6c dlock && readOnl
147d0 79 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e y;. /* pPager->
147e0 73 74 6d 74 4f 70 65 6e 20 3d 20 30 3b 20 2a 2f stmtOpen = 0; */
147f0 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 . /* pPager->st
14800 6d 74 49 6e 55 73 65 20 3d 20 30 3b 20 2a 2f 0a mtInUse = 0; */.
14810 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 6e 52 65 /* pPager->nRe
14820 66 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 f = 0; */. pPag
14830 65 72 2d 3e 64 62 53 69 7a 65 20 3d 20 6d 65 6d er->dbSize = mem
14840 44 62 2d 31 3b 0a 20 20 70 50 61 67 65 72 2d 3e Db-1;. pPager->
14850 70 61 67 65 53 69 7a 65 20 3d 20 6e 44 65 66 61 pageSize = nDefa
14860 75 6c 74 50 61 67 65 3b 0a 20 20 2f 2a 20 70 50 ultPage;. /* pP
14870 61 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3d ager->stmtSize =
14880 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 0; */. /* pPag
14890 65 72 2d 3e 73 74 6d 74 4a 53 69 7a 65 20 3d 20 er->stmtJSize =
148a0 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 0; */. /* pPage
148b0 72 2d 3e 6e 50 61 67 65 20 3d 20 30 3b 20 2a 2f r->nPage = 0; */
148c0 0a 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 61 67 . pPager->mxPag
148d0 65 20 3d 20 31 30 30 3b 0a 20 20 70 50 61 67 65 e = 100;. pPage
148e0 72 2d 3e 6d 78 50 67 6e 6f 20 3d 20 53 51 4c 49 r->mxPgno = SQLI
148f0 54 45 5f 4d 41 58 5f 50 41 47 45 5f 43 4f 55 4e TE_MAX_PAGE_COUN
14900 54 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e T;. /* pPager->
14910 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f 55 4e state = PAGER_UN
14920 4c 4f 43 4b 3b 20 2a 2f 0a 20 20 61 73 73 65 72 LOCK; */. asser
14930 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 t( pPager->state
14940 20 3d 3d 20 28 74 65 6d 70 46 69 6c 65 20 3f 20 == (tempFile ?
14950 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 20 PAGER_EXCLUSIVE
14960 3a 20 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 29 20 : PAGER_UNLOCK)
14970 29 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e );. /* pPager->
14980 65 72 72 4d 61 73 6b 20 3d 20 30 3b 20 2a 2f 0a errMask = 0; */.
14990 20 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 pPager->tempFi
149a0 6c 65 20 3d 20 74 65 6d 70 46 69 6c 65 3b 0a 20 le = tempFile;.
149b0 20 61 73 73 65 72 74 28 20 74 65 6d 70 46 69 6c assert( tempFil
149c0 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e 47 e==PAGER_LOCKING
149d0 4d 4f 44 45 5f 4e 4f 52 4d 41 4c 20 0a 20 20 20 MODE_NORMAL .
149e0 20 20 20 20 20 20 20 7c 7c 20 74 65 6d 70 46 69 || tempFi
149f0 6c 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e le==PAGER_LOCKIN
14a00 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 20 GMODE_EXCLUSIVE
14a10 29 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 );. assert( PAG
14a20 45 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 ER_LOCKINGMODE_E
14a30 58 43 4c 55 53 49 56 45 3d 3d 31 20 29 3b 0a 20 XCLUSIVE==1 );.
14a40 20 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 pPager->exclusi
14a50 76 65 4d 6f 64 65 20 3d 20 74 65 6d 70 46 69 6c veMode = tempFil
14a60 65 3b 20 0a 20 20 70 50 61 67 65 72 2d 3e 6d 65 e; . pPager->me
14a70 6d 44 62 20 3d 20 6d 65 6d 44 62 3b 0a 20 20 70 mDb = memDb;. p
14a80 50 61 67 65 72 2d 3e 72 65 61 64 4f 6e 6c 79 20 Pager->readOnly
14a90 3d 20 72 65 61 64 4f 6e 6c 79 3b 0a 20 20 2f 2a = readOnly;. /*
14aa0 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e pPager->needSyn
14ab0 63 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 67 c = 0; */. pPag
14ac0 65 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 70 50 61 er->noSync = pPa
14ad0 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 7c 7c ger->tempFile ||
14ae0 20 21 75 73 65 4a 6f 75 72 6e 61 6c 3b 0a 20 20 !useJournal;.
14af0 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 pPager->fullSync
14b00 20 3d 20 28 70 50 61 67 65 72 2d 3e 6e 6f 53 79 = (pPager->noSy
14b10 6e 63 3f 30 3a 31 29 3b 0a 20 20 70 50 61 67 65 nc?0:1);. pPage
14b20 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 20 3d 20 r->sync_flags =
14b30 53 51 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d SQLITE_SYNC_NORM
14b40 41 4c 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d AL;. /* pPager-
14b50 3e 70 46 69 72 73 74 20 3d 20 30 3b 20 2a 2f 0a >pFirst = 0; */.
14b60 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 46 69 /* pPager->pFi
14b70 72 73 74 53 79 6e 63 65 64 20 3d 20 30 3b 20 2a rstSynced = 0; *
14b80 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 70 /. /* pPager->p
14b90 4c 61 73 74 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 Last = 0; */. p
14ba0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 20 3d 20 Pager->nExtra =
14bb0 46 4f 52 43 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 FORCE_ALIGNMENT(
14bc0 6e 45 78 74 72 61 29 3b 0a 20 20 61 73 73 65 72 nExtra);. asser
14bd0 74 28 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d t(pPager->fd->pM
14be0 65 74 68 6f 64 73 7c 7c 6d 65 6d 44 62 7c 7c 74 ethods||memDb||t
14bf0 65 6d 70 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 empFile);. if(
14c00 21 6d 65 6d 44 62 20 29 7b 0a 20 20 20 20 73 65 !memDb ){. se
14c10 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 tSectorSize(pPag
14c20 65 72 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 er);. }. /* pP
14c30 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c ager->pBusyHandl
14c40 65 72 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 er = 0; */. /*
14c50 6d 65 6d 73 65 74 28 70 50 61 67 65 72 2d 3e 61 memset(pPager->a
14c60 48 61 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28 Hash, 0, sizeof(
14c70 70 50 61 67 65 72 2d 3e 61 48 61 73 68 29 29 3b pPager->aHash));
14c80 20 2a 2f 0a 20 20 2a 70 70 50 61 67 65 72 20 3d */. *ppPager =
14c90 20 70 50 61 67 65 72 3b 0a 23 69 66 64 65 66 20 pPager;.#ifdef
14ca0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
14cb0 4d 4f 52 59 5f 4d 41 4e 41 47 45 4d 45 4e 54 0a MORY_MANAGEMENT.
14cc0 20 20 70 50 61 67 65 72 2d 3e 69 49 6e 55 73 65 pPager->iInUse
14cd0 4d 4d 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 MM = 0;. pPager
14ce0 2d 3e 69 49 6e 55 73 65 44 42 20 3d 20 30 3b 0a ->iInUseDB = 0;.
14cf0 20 20 69 66 28 20 21 6d 65 6d 44 62 20 29 7b 0a if( !memDb ){.
14d00 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 sqlite3_mute
14d10 78 20 2a 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 x *mutex = sqlit
14d20 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 e3_mutex_alloc(S
14d30 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
14d40 49 43 5f 4d 45 4d 32 29 3b 0a 20 20 20 20 73 71 IC_MEM2);. sq
14d50 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
14d60 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 70 50 r(mutex);. pP
14d70 61 67 65 72 2d 3e 70 4e 65 78 74 20 3d 20 73 71 ager->pNext = sq
14d80 6c 69 74 65 33 50 61 67 65 72 4c 69 73 74 3b 0a lite3PagerList;.
14d90 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 if( sqlite3P
14da0 61 67 65 72 4c 69 73 74 20 29 7b 0a 20 20 20 20 agerList ){.
14db0 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
14dc0 33 50 61 67 65 72 4c 69 73 74 2d 3e 70 50 72 65 3PagerList->pPre
14dd0 76 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 73 71 v==0 );. sq
14de0 6c 69 74 65 33 50 61 67 65 72 4c 69 73 74 2d 3e lite3PagerList->
14df0 70 50 72 65 76 20 3d 20 70 50 61 67 65 72 3b 0a pPrev = pPager;.
14e00 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 }. pPager
14e10 2d 3e 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 20 ->pPrev = 0;.
14e20 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 69 73 sqlite3PagerLis
14e30 74 20 3d 20 70 50 61 67 65 72 3b 0a 20 20 20 20 t = pPager;.
14e40 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 sqlite3_mutex_le
14e50 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 7d 0a ave(mutex);. }.
14e60 23 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 #endif. return
14e70 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
14e80 0a 2a 2a 20 53 65 74 20 74 68 65 20 62 75 73 79 .** Set the busy
14e90 20 68 61 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f handler functio
14ea0 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 n..*/.void sqlit
14eb0 65 33 50 61 67 65 72 53 65 74 42 75 73 79 68 61 e3PagerSetBusyha
14ec0 6e 64 6c 65 72 28 50 61 67 65 72 20 2a 70 50 61 ndler(Pager *pPa
14ed0 67 65 72 2c 20 42 75 73 79 48 61 6e 64 6c 65 72 ger, BusyHandler
14ee0 20 2a 70 42 75 73 79 48 61 6e 64 6c 65 72 29 7b *pBusyHandler){
14ef0 0a 20 20 70 50 61 67 65 72 2d 3e 70 42 75 73 79 . pPager->pBusy
14f00 48 61 6e 64 6c 65 72 20 3d 20 70 42 75 73 79 48 Handler = pBusyH
14f10 61 6e 64 6c 65 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a andler;.}../*.**
14f20 20 53 65 74 20 74 68 65 20 64 65 73 74 72 75 63 Set the destruc
14f30 74 6f 72 20 66 6f 72 20 74 68 69 73 20 70 61 67 tor for this pag
14f40 65 72 2e 20 20 49 66 20 6e 6f 74 20 4e 55 4c 4c er. If not NULL
14f50 2c 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72 , the destructor
14f60 20 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 77 68 is called.** wh
14f70 65 6e 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 en the reference
14f80 20 63 6f 75 6e 74 20 6f 6e 20 65 61 63 68 20 70 count on each p
14f90 61 67 65 20 72 65 61 63 68 65 73 20 7a 65 72 6f age reaches zero
14fa0 2e 20 20 54 68 65 20 64 65 73 74 72 75 63 74 6f . The destructo
14fb0 72 20 63 61 6e 0a 2a 2a 20 62 65 20 75 73 65 64 r can.** be used
14fc0 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 69 6e 66 to clean up inf
14fd0 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 ormation in the
14fe0 65 78 74 72 61 20 73 65 67 6d 65 6e 74 20 61 70 extra segment ap
14ff0 70 65 6e 64 65 64 20 74 6f 20 65 61 63 68 20 70 pended to each p
15000 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 age..**.** The d
15010 65 73 74 72 75 63 74 6f 72 20 69 73 20 6e 6f 74 estructor is not
15020 20 63 61 6c 6c 65 64 20 61 73 20 61 20 72 65 73 called as a res
15030 75 6c 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 ult sqlite3Pager
15040 43 6c 6f 73 65 28 29 2e 20 20 0a 2a 2a 20 44 65 Close(). .** De
15050 73 74 72 75 63 74 6f 72 73 20 61 72 65 20 6f 6e structors are on
15060 6c 79 20 63 61 6c 6c 65 64 20 62 79 20 73 71 6c ly called by sql
15070 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 ite3PagerUnref()
15080 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 ..*/.void sqlite
15090 33 50 61 67 65 72 53 65 74 44 65 73 74 72 75 63 3PagerSetDestruc
150a0 74 6f 72 28 50 61 67 65 72 20 2a 70 50 61 67 65 tor(Pager *pPage
150b0 72 2c 20 76 6f 69 64 20 28 2a 78 44 65 73 63 29 r, void (*xDesc)
150c0 28 44 62 50 61 67 65 2a 2c 69 6e 74 29 29 7b 0a (DbPage*,int)){.
150d0 20 20 70 50 61 67 65 72 2d 3e 78 44 65 73 74 72 pPager->xDestr
150e0 75 63 74 6f 72 20 3d 20 78 44 65 73 63 3b 0a 7d uctor = xDesc;.}
150f0 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 ../*.** Set the
15100 72 65 69 6e 69 74 69 61 6c 69 7a 65 72 20 66 6f reinitializer fo
15110 72 20 74 68 69 73 20 70 61 67 65 72 2e 20 20 49 r this pager. I
15120 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 20 f not NULL, the
15130 72 65 69 6e 69 74 69 61 6c 69 7a 65 72 0a 2a 2a reinitializer.**
15140 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 is called when
15150 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 the content of a
15160 20 70 61 67 65 20 69 6e 20 63 61 63 68 65 20 69 page in cache i
15170 73 20 72 65 73 74 6f 72 65 64 20 74 6f 20 69 74 s restored to it
15180 73 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 76 61 s original.** va
15190 6c 75 65 20 61 73 20 61 20 72 65 73 75 6c 74 20 lue as a result
151a0 6f 66 20 61 20 72 6f 6c 6c 62 61 63 6b 2e 20 20 of a rollback.
151b0 54 68 65 20 63 61 6c 6c 62 61 63 6b 20 67 69 76 The callback giv
151c0 65 73 20 68 69 67 68 65 72 2d 6c 65 76 65 6c 20 es higher-level
151d0 63 6f 64 65 0a 2a 2a 20 61 6e 20 6f 70 70 6f 72 code.** an oppor
151e0 74 75 6e 69 74 79 20 74 6f 20 72 65 73 74 6f 72 tunity to restor
151f0 65 20 74 68 65 20 45 58 54 52 41 20 73 65 63 74 e the EXTRA sect
15200 69 6f 6e 20 74 6f 20 61 67 72 65 65 20 77 69 74 ion to agree wit
15210 68 20 74 68 65 20 72 65 73 74 6f 72 65 64 0a 2a h the restored.*
15220 2a 20 70 61 67 65 20 64 61 74 61 2e 0a 2a 2f 0a * page data..*/.
15230 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
15240 72 53 65 74 52 65 69 6e 69 74 65 72 28 50 61 67 rSetReiniter(Pag
15250 65 72 20 2a 70 50 61 67 65 72 2c 20 76 6f 69 64 er *pPager, void
15260 20 28 2a 78 52 65 69 6e 69 74 29 28 44 62 50 61 (*xReinit)(DbPa
15270 67 65 2a 2c 69 6e 74 29 29 7b 0a 20 20 70 50 61 ge*,int)){. pPa
15280 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 20 3d ger->xReiniter =
15290 20 78 52 65 69 6e 69 74 3b 0a 7d 0a 0a 2f 2a 0a xReinit;.}../*.
152a0 2a 2a 20 53 65 74 20 74 68 65 20 70 61 67 65 20 ** Set the page
152b0 73 69 7a 65 20 74 6f 20 2a 70 50 61 67 65 53 69 size to *pPageSi
152c0 7a 65 2e 20 49 66 20 74 68 65 20 73 75 67 67 65 ze. If the sugge
152d0 73 74 20 6e 65 77 20 70 61 67 65 20 73 69 7a 65 st new page size
152e0 20 69 73 0a 2a 2a 20 69 6e 61 70 70 72 6f 70 72 is.** inappropr
152f0 69 61 74 65 2c 20 74 68 65 6e 20 61 6e 20 61 6c iate, then an al
15300 74 65 72 6e 61 74 69 76 65 20 70 61 67 65 20 73 ternative page s
15310 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 74 68 ize is set to th
15320 61 74 0a 2a 2a 20 76 61 6c 75 65 20 62 65 66 6f at.** value befo
15330 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a 2a 2f re returning..*/
15340 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 .int sqlite3Page
15350 72 53 65 74 50 61 67 65 73 69 7a 65 28 50 61 67 rSetPagesize(Pag
15360 65 72 20 2a 70 50 61 67 65 72 2c 20 75 31 36 20 er *pPager, u16
15370 2a 70 50 61 67 65 53 69 7a 65 29 7b 0a 20 20 69 *pPageSize){. i
15380 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
15390 4b 3b 0a 20 20 75 31 36 20 70 61 67 65 53 69 7a K;. u16 pageSiz
153a0 65 20 3d 20 2a 70 50 61 67 65 53 69 7a 65 3b 0a e = *pPageSize;.
153b0 20 20 61 73 73 65 72 74 28 20 70 61 67 65 53 69 assert( pageSi
153c0 7a 65 3d 3d 30 20 7c 7c 20 28 70 61 67 65 53 69 ze==0 || (pageSi
153d0 7a 65 3e 3d 35 31 32 20 26 26 20 70 61 67 65 53 ze>=512 && pageS
153e0 69 7a 65 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f ize<=SQLITE_MAX_
153f0 50 41 47 45 5f 53 49 5a 45 29 20 29 3b 0a 20 20 PAGE_SIZE) );.
15400 69 66 28 20 70 61 67 65 53 69 7a 65 20 26 26 20 if( pageSize &&
15410 70 61 67 65 53 69 7a 65 21 3d 70 50 61 67 65 72 pageSize!=pPager
15420 2d 3e 70 61 67 65 53 69 7a 65 20 0a 20 20 20 26 ->pageSize . &
15430 26 20 21 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 & !pPager->memDb
15440 20 26 26 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 && pPager->nRef
15450 3d 3d 30 20 0a 20 20 29 7b 0a 20 20 20 20 63 68 ==0 . ){. ch
15460 61 72 20 2a 70 4e 65 77 20 3d 20 28 63 68 61 72 ar *pNew = (char
15470 20 2a 29 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f *)sqlite3_mallo
15480 63 28 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 c(pageSize);.
15490 20 69 66 28 20 21 70 4e 65 77 20 29 7b 0a 20 20 if( !pNew ){.
154a0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
154b0 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c 73 65 NOMEM;. }else
154c0 7b 0a 20 20 20 20 20 20 70 61 67 65 72 45 6e 74 {. pagerEnt
154d0 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 er(pPager);.
154e0 20 20 70 61 67 65 72 5f 72 65 73 65 74 28 70 50 pager_reset(pP
154f0 61 67 65 72 29 3b 0a 20 20 20 20 20 20 70 50 61 ager);. pPa
15500 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 3d 20 ger->pageSize =
15510 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 20 20 pageSize;.
15520 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50 setSectorSize(pP
15530 61 67 65 72 29 3b 0a 20 20 20 20 20 20 73 71 6c ager);. sql
15540 69 74 65 33 5f 66 72 65 65 28 70 50 61 67 65 72 ite3_free(pPager
15550 2d 3e 70 54 6d 70 53 70 61 63 65 29 3b 0a 20 20 ->pTmpSpace);.
15560 20 20 20 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 pPager->pTmp
15570 53 70 61 63 65 20 3d 20 70 4e 65 77 3b 0a 20 20 Space = pNew;.
15580 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 pagerLeave(p
15590 50 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 Pager);. }.
155a0 7d 0a 20 20 2a 70 50 61 67 65 53 69 7a 65 20 3d }. *pPageSize =
155b0 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
155c0 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a e;. return rc;.
155d0 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 }../*.** Return
155e0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
155f0 20 22 74 65 6d 70 6f 72 61 72 79 20 70 61 67 65 "temporary page
15600 22 20 62 75 66 66 65 72 20 68 65 6c 64 20 69 6e " buffer held in
15610 74 65 72 6e 61 6c 6c 79 0a 2a 2a 20 62 79 20 74 ternally.** by t
15620 68 65 20 70 61 67 65 72 2e 20 20 54 68 69 73 20 he pager. This
15630 69 73 20 61 20 62 75 66 66 65 72 20 74 68 61 74 is a buffer that
15640 20 69 73 20 62 69 67 20 65 6e 6f 75 67 68 20 74 is big enough t
15650 6f 20 68 6f 6c 64 20 74 68 65 0a 2a 2a 20 65 6e o hold the.** en
15660 74 69 72 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 tire content of
15670 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 2e a database page.
15680 20 20 54 68 69 73 20 62 75 66 66 65 72 20 69 73 This buffer is
15690 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 used internally
156a0 0a 2a 2a 20 64 75 72 69 6e 67 20 72 6f 6c 6c 62 .** during rollb
156b0 61 63 6b 20 61 6e 64 20 77 69 6c 6c 20 62 65 20 ack and will be
156c0 6f 76 65 72 77 72 69 74 74 65 6e 20 77 68 65 6e overwritten when
156d0 65 76 65 72 20 61 20 72 6f 6c 6c 62 61 63 6b 0a ever a rollback.
156e0 2a 2a 20 6f 63 63 75 72 73 2e 20 20 42 75 74 20 ** occurs. But
156f0 6f 74 68 65 72 20 6d 6f 64 75 6c 65 73 20 61 72 other modules ar
15700 65 20 66 72 65 65 20 74 6f 20 75 73 65 20 69 74 e free to use it
15710 20 74 6f 6f 2c 20 61 73 20 6c 6f 6e 67 20 61 73 too, as long as
15720 0a 2a 2a 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 73 .** no rollbacks
15730 20 61 72 65 20 68 61 70 70 65 6e 69 6e 67 2e 0a are happening..
15740 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 */.void *sqlite3
15750 50 61 67 65 72 54 65 6d 70 53 70 61 63 65 28 50 PagerTempSpace(P
15760 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
15770 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e return pPager->
15780 70 54 6d 70 53 70 61 63 65 3b 0a 7d 0a 0a 2f 2a pTmpSpace;.}../*
15790 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 73 .** Attempt to s
157a0 65 74 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 et the maximum d
157b0 61 74 61 62 61 73 65 20 70 61 67 65 20 63 6f 75 atabase page cou
157c0 6e 74 20 69 66 20 6d 78 50 61 67 65 20 69 73 20 nt if mxPage is
157d0 70 6f 73 69 74 69 76 65 2e 20 0a 2a 2a 20 4d 61 positive. .** Ma
157e0 6b 65 20 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 ke no changes if
157f0 20 6d 78 50 61 67 65 20 69 73 20 7a 65 72 6f 20 mxPage is zero
15800 6f 72 20 6e 65 67 61 74 69 76 65 2e 20 20 41 6e or negative. An
15810 64 20 6e 65 76 65 72 20 72 65 64 75 63 65 20 74 d never reduce t
15820 68 65 0a 2a 2a 20 6d 61 78 69 6d 75 6d 20 70 61 he.** maximum pa
15830 67 65 20 63 6f 75 6e 74 20 62 65 6c 6f 77 20 74 ge count below t
15840 68 65 20 63 75 72 72 65 6e 74 20 73 69 7a 65 20 he current size
15850 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 2e of the database.
15860 0a 2a 2a 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 .**.** Regardles
15870 73 20 6f 66 20 6d 78 50 61 67 65 2c 20 72 65 74 s of mxPage, ret
15880 75 72 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 urn the current
15890 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 maximum page cou
158a0 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 nt..*/.int sqlit
158b0 65 33 50 61 67 65 72 4d 61 78 50 61 67 65 43 6f e3PagerMaxPageCo
158c0 75 6e 74 28 50 61 67 65 72 20 2a 70 50 61 67 65 unt(Pager *pPage
158d0 72 2c 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a r, int mxPage){.
158e0 20 20 69 66 28 20 6d 78 50 61 67 65 3e 30 20 29 if( mxPage>0 )
158f0 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6d 78 {. pPager->mx
15900 50 67 6e 6f 20 3d 20 6d 78 50 61 67 65 3b 0a 20 Pgno = mxPage;.
15910 20 7d 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 }. sqlite3Page
15920 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65 rPagecount(pPage
15930 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 r);. return pPa
15940 67 65 72 2d 3e 6d 78 50 67 6e 6f 3b 0a 7d 0a 0a ger->mxPgno;.}..
15950 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
15960 69 6e 67 20 73 65 74 20 6f 66 20 72 6f 75 74 69 ing set of routi
15970 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 nes are used to
15980 64 69 73 61 62 6c 65 20 74 68 65 20 73 69 6d 75 disable the simu
15990 6c 61 74 65 64 0a 2a 2a 20 49 2f 4f 20 65 72 72 lated.** I/O err
159a0 6f 72 20 6d 65 63 68 61 6e 69 73 6d 2e 20 20 54 or mechanism. T
159b0 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 61 72 hese routines ar
159c0 65 20 75 73 65 64 20 74 6f 20 61 76 6f 69 64 20 e used to avoid
159d0 73 69 6d 75 6c 61 74 65 64 0a 2a 2a 20 65 72 72 simulated.** err
159e0 6f 72 73 20 69 6e 20 70 6c 61 63 65 73 20 77 68 ors in places wh
159f0 65 72 65 20 77 65 20 64 6f 20 6e 6f 74 20 63 61 ere we do not ca
15a00 72 65 20 61 62 6f 75 74 20 65 72 72 6f 72 73 2e re about errors.
15a10 0a 2a 2a 0a 2a 2a 20 55 6e 6c 65 73 73 20 2d 44 .**.** Unless -D
15a20 53 51 4c 49 54 45 5f 54 45 53 54 3d 31 20 69 73 SQLITE_TEST=1 is
15a30 20 75 73 65 64 2c 20 74 68 65 73 65 20 72 6f 75 used, these rou
15a40 74 69 6e 65 73 20 61 72 65 20 61 6c 6c 20 6e 6f tines are all no
15a50 2d 6f 70 73 0a 2a 2a 20 61 6e 64 20 67 65 6e 65 -ops.** and gene
15a60 72 61 74 65 20 6e 6f 20 63 6f 64 65 2e 0a 2a 2f rate no code..*/
15a70 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 .#ifdef SQLITE_T
15a80 45 53 54 0a 65 78 74 65 72 6e 20 69 6e 74 20 73 EST.extern int s
15a90 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f qlite3_io_error_
15aa0 70 65 6e 64 69 6e 67 3b 0a 65 78 74 65 72 6e 20 pending;.extern
15ab0 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 int sqlite3_io_e
15ac0 72 72 6f 72 5f 68 69 74 3b 0a 73 74 61 74 69 63 rror_hit;.static
15ad0 20 69 6e 74 20 73 61 76 65 64 5f 63 6e 74 3b 0a int saved_cnt;.
15ae0 76 6f 69 64 20 64 69 73 61 62 6c 65 5f 73 69 6d void disable_sim
15af0 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 ulated_io_errors
15b00 28 76 6f 69 64 29 7b 0a 20 20 73 61 76 65 64 5f (void){. saved_
15b10 63 6e 74 20 3d 20 73 71 6c 69 74 65 33 5f 69 6f cnt = sqlite3_io
15b20 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 3b 0a _error_pending;.
15b30 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 72 sqlite3_io_err
15b40 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 2d 31 3b or_pending = -1;
15b50 0a 7d 0a 76 6f 69 64 20 65 6e 61 62 6c 65 5f 73 .}.void enable_s
15b60 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f imulated_io_erro
15b70 72 73 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 rs(void){. sqli
15b80 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e te3_io_error_pen
15b90 64 69 6e 67 20 3d 20 73 61 76 65 64 5f 63 6e 74 ding = saved_cnt
15ba0 3b 0a 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 ;.}.#else.# defi
15bb0 6e 65 20 64 69 73 61 62 6c 65 5f 73 69 6d 75 6c ne disable_simul
15bc0 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29 ated_io_errors()
15bd0 0a 23 20 64 65 66 69 6e 65 20 65 6e 61 62 6c 65 .# define enable
15be0 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 _simulated_io_er
15bf0 72 6f 72 73 28 29 0a 23 65 6e 64 69 66 0a 0a 2f rors().#endif../
15c00 2a 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 66 69 *.** Read the fi
15c10 72 73 74 20 4e 20 62 79 74 65 73 20 66 72 6f 6d rst N bytes from
15c20 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f the beginning o
15c30 66 20 74 68 65 20 66 69 6c 65 20 69 6e 74 6f 20 f the file into
15c40 6d 65 6d 6f 72 79 0a 2a 2a 20 74 68 61 74 20 70 memory.** that p
15c50 44 65 73 74 20 70 6f 69 6e 74 73 20 74 6f 2e 20 Dest points to.
15c60 0a 2a 2a 0a 2a 2a 20 4e 6f 20 65 72 72 6f 72 20 .**.** No error
15c70 63 68 65 63 6b 69 6e 67 20 69 73 20 64 6f 6e 65 checking is done
15c80 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c 20 66 . The rational f
15c90 6f 72 20 74 68 69 73 20 69 73 20 74 68 61 74 20 or this is that
15ca0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 0a 2a this function .*
15cb0 2a 20 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 20 * may be called
15cc0 65 76 65 6e 20 69 66 20 74 68 65 20 66 69 6c 65 even if the file
15cd0 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 20 does not exist
15ce0 6f 72 20 63 6f 6e 74 61 69 6e 20 61 20 68 65 61 or contain a hea
15cf0 64 65 72 2e 20 49 6e 20 0a 2a 2a 20 74 68 65 73 der. In .** thes
15d00 65 20 63 61 73 65 73 20 73 71 6c 69 74 65 33 4f e cases sqlite3O
15d10 73 52 65 61 64 28 29 20 77 69 6c 6c 20 72 65 74 sRead() will ret
15d20 75 72 6e 20 61 6e 20 65 72 72 6f 72 2c 20 74 6f urn an error, to
15d30 20 77 68 69 63 68 20 74 68 65 20 63 6f 72 72 65 which the corre
15d40 63 74 20 0a 2a 2a 20 72 65 73 70 6f 6e 73 65 20 ct .** response
15d50 69 73 20 74 6f 20 7a 65 72 6f 20 74 68 65 20 6d is to zero the m
15d60 65 6d 6f 72 79 20 61 74 20 70 44 65 73 74 20 61 emory at pDest a
15d70 6e 64 20 63 6f 6e 74 69 6e 75 65 2e 20 20 41 20 nd continue. A
15d80 72 65 61 6c 20 49 4f 20 65 72 72 6f 72 20 0a 2a real IO error .*
15d90 2a 20 77 69 6c 6c 20 70 72 65 73 75 6d 61 62 6c * will presumabl
15da0 79 20 72 65 63 75 72 20 61 6e 64 20 62 65 20 70 y recur and be p
15db0 69 63 6b 65 64 20 75 70 20 6c 61 74 65 72 20 28 icked up later (
15dc0 54 6f 64 6f 3a 20 54 68 69 6e 6b 20 61 62 6f 75 Todo: Think abou
15dd0 74 20 74 68 69 73 29 2e 0a 2a 2f 0a 69 6e 74 20 t this)..*/.int
15de0 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 61 64 sqlite3PagerRead
15df0 46 69 6c 65 68 65 61 64 65 72 28 50 61 67 65 72 Fileheader(Pager
15e00 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 4e 2c *pPager, int N,
15e10 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
15e20 70 44 65 73 74 29 7b 0a 20 20 69 6e 74 20 72 63 pDest){. int rc
15e30 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
15e40 6d 65 6d 73 65 74 28 70 44 65 73 74 2c 20 30 2c memset(pDest, 0,
15e50 20 4e 29 3b 0a 20 20 61 73 73 65 72 74 28 4d 45 N);. assert(ME
15e60 4d 44 42 7c 7c 70 50 61 67 65 72 2d 3e 66 64 2d MDB||pPager->fd-
15e70 3e 70 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67 65 >pMethods||pPage
15e80 72 2d 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20 20 r->tempFile);.
15e90 69 66 28 20 70 50 61 67 65 72 2d 3e 66 64 2d 3e if( pPager->fd->
15ea0 70 4d 65 74 68 6f 64 73 20 29 7b 0a 20 20 20 20 pMethods ){.
15eb0 49 4f 54 52 41 43 45 28 28 22 44 42 48 44 52 20 IOTRACE(("DBHDR
15ec0 25 70 20 30 20 25 64 5c 6e 22 2c 20 70 50 61 67 %p 0 %d\n", pPag
15ed0 65 72 2c 20 4e 29 29 0a 20 20 20 20 72 63 20 3d er, N)). rc =
15ee0 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 sqlite3OsRead(p
15ef0 50 61 67 65 72 2d 3e 66 64 2c 20 70 44 65 73 74 Pager->fd, pDest
15f00 2c 20 4e 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 , N, 0);. if(
15f10 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 rc==SQLITE_IOER
15f20 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a R_SHORT_READ ){.
15f30 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
15f40 45 5f 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a E_OK;. }. }.
15f50 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
15f60 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
15f70 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
15f80 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 69 pages in the di
15f90 73 6b 20 66 69 6c 65 20 61 73 73 6f 63 69 61 74 sk file associat
15fa0 65 64 20 77 69 74 68 0a 2a 2a 20 70 50 61 67 65 ed with.** pPage
15fb0 72 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 r. .**.** If the
15fc0 20 50 45 4e 44 49 4e 47 5f 42 59 54 45 20 6c 69 PENDING_BYTE li
15fd0 65 73 20 6f 6e 20 74 68 65 20 70 61 67 65 20 64 es on the page d
15fe0 69 72 65 63 74 6c 79 20 61 66 74 65 72 20 74 68 irectly after th
15ff0 65 20 65 6e 64 20 6f 66 20 74 68 65 0a 2a 2a 20 e end of the.**
16000 66 69 6c 65 2c 20 74 68 65 6e 20 63 6f 6e 73 69 file, then consi
16010 64 65 72 20 74 68 69 73 20 70 61 67 65 20 70 61 der this page pa
16020 72 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 74 rt of the file t
16030 6f 6f 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c oo. For example,
16040 20 69 66 0a 2a 2a 20 50 45 4e 44 49 4e 47 5f 42 if.** PENDING_B
16050 59 54 45 20 69 73 20 62 79 74 65 20 34 30 39 36 YTE is byte 4096
16060 20 28 74 68 65 20 66 69 72 73 74 20 62 79 74 65 (the first byte
16070 20 6f 66 20 70 61 67 65 20 35 29 20 61 6e 64 20 of page 5) and
16080 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 0a the size of the.
16090 2a 2a 20 66 69 6c 65 20 69 73 20 34 30 39 36 20 ** file is 4096
160a0 62 79 74 65 73 2c 20 35 20 69 73 20 72 65 74 75 bytes, 5 is retu
160b0 72 6e 65 64 20 69 6e 73 74 65 61 64 20 6f 66 20 rned instead of
160c0 34 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 4..*/.int sqlite
160d0 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 28 3PagerPagecount(
160e0 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
160f0 20 20 69 36 34 20 6e 20 3d 20 30 3b 0a 20 20 69 i64 n = 0;. i
16100 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 74 28 nt rc;. assert(
16110 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 20 pPager!=0 );.
16120 69 66 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 if( pPager->errC
16130 6f 64 65 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ode ){. retur
16140 6e 20 2d 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 n -1;. }. if(
16150 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3e 3d pPager->dbSize>=
16160 30 20 29 7b 0a 20 20 20 20 6e 20 3d 20 70 50 61 0 ){. n = pPa
16170 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 7d ger->dbSize;. }
16180 20 65 6c 73 65 20 7b 0a 20 20 20 20 61 73 73 65 else {. asse
16190 72 74 28 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 rt(pPager->fd->p
161a0 4d 65 74 68 6f 64 73 7c 7c 70 50 61 67 65 72 2d Methods||pPager-
161b0 3e 74 65 6d 70 46 69 6c 65 29 3b 0a 20 20 20 20 >tempFile);.
161c0 69 66 28 20 28 70 50 61 67 65 72 2d 3e 66 64 2d if( (pPager->fd-
161d0 3e 70 4d 65 74 68 6f 64 73 29 0a 20 20 20 20 20 >pMethods).
161e0 26 26 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33 && (rc = sqlite3
161f0 4f 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 OsFileSize(pPage
16200 72 2d 3e 66 64 2c 20 26 6e 29 29 21 3d 53 51 4c r->fd, &n))!=SQL
16210 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
16220 70 50 61 67 65 72 2d 3e 6e 52 65 66 2b 2b 3b 0a pPager->nRef++;.
16230 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f pager_erro
16240 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20 r(pPager, rc);.
16250 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 pPager->nRe
16260 66 2d 2d 3b 0a 20 20 20 20 20 20 72 65 74 75 72 f--;. retur
16270 6e 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 n -1;. }.
16280 69 66 28 20 6e 3e 30 20 26 26 20 6e 3c 70 50 61 if( n>0 && n<pPa
16290 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b ger->pageSize ){
162a0 0a 20 20 20 20 20 20 6e 20 3d 20 31 3b 0a 20 20 . n = 1;.
162b0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 6e }else{. n
162c0 20 2f 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 /= pPager->page
162d0 53 69 7a 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 Size;. }.
162e0 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 if( pPager->stat
162f0 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 e!=PAGER_UNLOCK
16300 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d ){. pPager-
16310 3e 64 62 53 69 7a 65 20 3d 20 6e 3b 0a 20 20 20 >dbSize = n;.
16320 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 6e 3d 3d }. }. if( n==
16330 28 50 45 4e 44 49 4e 47 5f 42 59 54 45 2f 70 50 (PENDING_BYTE/pP
16340 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 20 ager->pageSize)
16350 29 7b 0a 20 20 20 20 6e 2b 2b 3b 0a 20 20 7d 0a ){. n++;. }.
16360 20 20 69 66 28 20 6e 3e 70 50 61 67 65 72 2d 3e if( n>pPager->
16370 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 20 20 70 50 mxPgno ){. pP
16380 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 3d 20 6e ager->mxPgno = n
16390 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6e ;. }. return n
163a0 3b 0a 7d 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 ;.}...#ifndef SQ
163b0 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 LITE_OMIT_MEMORY
163c0 44 42 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 72 20 61 DB./*.** Clear a
163d0 20 50 67 48 69 73 74 6f 72 79 20 62 6c 6f 63 6b PgHistory block
163e0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
163f0 63 6c 65 61 72 48 69 73 74 6f 72 79 28 50 67 48 clearHistory(PgH
16400 69 73 74 6f 72 79 20 2a 70 48 69 73 74 29 7b 0a istory *pHist){.
16410 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
16420 48 69 73 74 2d 3e 70 4f 72 69 67 29 3b 0a 20 20 Hist->pOrig);.
16430 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 48 69 sqlite3_free(pHi
16440 73 74 2d 3e 70 53 74 6d 74 29 3b 0a 20 20 70 48 st->pStmt);. pH
16450 69 73 74 2d 3e 70 4f 72 69 67 20 3d 20 30 3b 0a ist->pOrig = 0;.
16460 20 20 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 3d pHist->pStmt =
16470 20 30 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65 66 0;.}.#else.#def
16480 69 6e 65 20 63 6c 65 61 72 48 69 73 74 6f 72 79 ine clearHistory
16490 28 78 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a (x).#endif../*.*
164a0 2a 20 46 6f 72 77 61 72 64 20 64 65 63 6c 61 72 * Forward declar
164b0 61 74 69 6f 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 ation.*/.static
164c0 69 6e 74 20 73 79 6e 63 4a 6f 75 72 6e 61 6c 28 int syncJournal(
164d0 50 61 67 65 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 Pager*);../*.**
164e0 55 6e 6c 69 6e 6b 20 70 50 67 20 66 72 6f 6d 20 Unlink pPg from
164f0 69 74 73 20 68 61 73 68 20 63 68 61 69 6e 2e 20 its hash chain.
16500 41 6c 73 6f 20 73 65 74 20 74 68 65 20 70 61 67 Also set the pag
16510 65 20 6e 75 6d 62 65 72 20 74 6f 20 30 20 74 6f e number to 0 to
16520 20 69 6e 64 69 63 61 74 65 0a 2a 2a 20 74 68 61 indicate.** tha
16530 74 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f t the page is no
16540 74 20 70 61 72 74 20 6f 66 20 61 6e 79 20 68 61 t part of any ha
16550 73 68 20 63 68 61 69 6e 2e 20 54 68 69 73 20 69 sh chain. This i
16560 73 20 72 65 71 75 69 72 65 64 20 62 65 63 61 75 s required becau
16570 73 65 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65 se the.** sqlite
16580 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 29 3PagerMovepage()
16590 20 72 6f 75 74 69 6e 65 20 63 61 6e 20 6c 65 61 routine can lea
165a0 76 65 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 ve a page in the
165b0 20 0a 2a 2a 20 70 4e 65 78 74 46 72 65 65 2f 70 .** pNextFree/p
165c0 50 72 65 76 46 72 65 65 20 6c 69 73 74 20 74 68 PrevFree list th
165d0 61 74 20 69 73 20 6e 6f 74 20 61 20 70 61 72 74 at is not a part
165e0 20 6f 66 20 61 6e 79 20 68 61 73 68 2d 63 68 61 of any hash-cha
165f0 69 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f in..*/.static vo
16600 69 64 20 75 6e 6c 69 6e 6b 48 61 73 68 43 68 61 id unlinkHashCha
16610 69 6e 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 in(Pager *pPager
16620 2c 20 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 , PgHdr *pPg){.
16630 20 69 66 28 20 70 50 67 2d 3e 70 67 6e 6f 3d 3d if( pPg->pgno==
16640 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 0 ){. assert(
16650 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 3d pPg->pNextHash=
16660 3d 30 20 26 26 20 70 50 67 2d 3e 70 50 72 65 76 =0 && pPg->pPrev
16670 48 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20 72 Hash==0 );. r
16680 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 eturn;. }. if(
16690 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 20 pPg->pNextHash
166a0 29 7b 0a 20 20 20 20 70 50 67 2d 3e 70 4e 65 78 ){. pPg->pNex
166b0 74 48 61 73 68 2d 3e 70 50 72 65 76 48 61 73 68 tHash->pPrevHash
166c0 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 48 61 73 = pPg->pPrevHas
166d0 68 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67 h;. }. if( pPg
166e0 2d 3e 70 50 72 65 76 48 61 73 68 20 29 7b 0a 20 ->pPrevHash ){.
166f0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
16700 72 2d 3e 61 48 61 73 68 5b 70 50 67 2d 3e 70 67 r->aHash[pPg->pg
16710 6e 6f 20 26 20 28 70 50 61 67 65 72 2d 3e 6e 48 no & (pPager->nH
16720 61 73 68 2d 31 29 5d 21 3d 70 50 67 20 29 3b 0a ash-1)]!=pPg );.
16730 20 20 20 20 70 50 67 2d 3e 70 50 72 65 76 48 61 pPg->pPrevHa
16740 73 68 2d 3e 70 4e 65 78 74 48 61 73 68 20 3d 20 sh->pNextHash =
16750 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 3b 0a pPg->pNextHash;.
16760 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 }else{. int
16770 20 68 20 3d 20 70 50 67 2d 3e 70 67 6e 6f 20 26 h = pPg->pgno &
16780 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2d (pPager->nHash-
16790 31 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 1);. pPager->
167a0 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 2d 3e aHash[h] = pPg->
167b0 70 4e 65 78 74 48 61 73 68 3b 0a 20 20 7d 0a 20 pNextHash;. }.
167c0 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 if( MEMDB ){.
167d0 20 20 63 6c 65 61 72 48 69 73 74 6f 72 79 28 50 clearHistory(P
167e0 47 48 44 52 5f 54 4f 5f 48 49 53 54 28 70 50 67 GHDR_TO_HIST(pPg
167f0 2c 20 70 50 61 67 65 72 29 29 3b 0a 20 20 7d 0a , pPager));. }.
16800 20 20 70 50 67 2d 3e 70 67 6e 6f 20 3d 20 30 3b pPg->pgno = 0;
16810 0a 20 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 . pPg->pNextHas
16820 68 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 48 61 h = pPg->pPrevHa
16830 73 68 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a sh = 0;.}../*.**
16840 20 55 6e 6c 69 6e 6b 20 61 20 70 61 67 65 20 66 Unlink a page f
16850 72 6f 6d 20 74 68 65 20 66 72 65 65 20 6c 69 73 rom the free lis
16860 74 20 28 74 68 65 20 6c 69 73 74 20 6f 66 20 61 t (the list of a
16870 6c 6c 20 70 61 67 65 73 20 77 68 65 72 65 20 6e ll pages where n
16880 52 65 66 3d 3d 30 29 0a 2a 2a 20 61 6e 64 20 66 Ref==0).** and f
16890 72 6f 6d 20 69 74 73 20 68 61 73 68 20 63 6f 6c rom its hash col
168a0 6c 69 73 69 6f 6e 20 63 68 61 69 6e 2e 0a 2a 2f lision chain..*/
168b0 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 6c .static void unl
168c0 69 6e 6b 50 61 67 65 28 50 67 48 64 72 20 2a 70 inkPage(PgHdr *p
168d0 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 Pg){. Pager *pP
168e0 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
168f0 65 72 3b 0a 0a 20 20 2f 2a 20 55 6e 6c 69 6e 6b er;.. /* Unlink
16900 20 66 72 6f 6d 20 66 72 65 65 20 70 61 67 65 20 from free page
16910 6c 69 73 74 20 2a 2f 0a 20 20 6c 72 75 4c 69 73 list */. lruLis
16920 74 52 65 6d 6f 76 65 28 70 50 67 29 3b 0a 0a 20 tRemove(pPg);..
16930 20 2f 2a 20 55 6e 6c 69 6e 6b 20 66 72 6f 6d 20 /* Unlink from
16940 74 68 65 20 70 67 6e 6f 20 68 61 73 68 20 74 61 the pgno hash ta
16950 62 6c 65 20 2a 2f 0a 20 20 75 6e 6c 69 6e 6b 48 ble */. unlinkH
16960 61 73 68 43 68 61 69 6e 28 70 50 61 67 65 72 2c ashChain(pPager,
16970 20 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 pPg);.}../*.**
16980 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 This routine is
16990 75 73 65 64 20 74 6f 20 74 72 75 6e 63 61 74 65 used to truncate
169a0 20 74 68 65 20 63 61 63 68 65 20 77 68 65 6e 20 the cache when
169b0 61 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 69 73 a database.** is
169c0 20 74 72 75 6e 63 61 74 65 64 2e 20 20 44 72 6f truncated. Dro
169d0 70 20 66 72 6f 6d 20 74 68 65 20 63 61 63 68 65 p from the cache
169e0 20 61 6c 6c 20 70 61 67 65 73 20 77 68 6f 73 65 all pages whose
169f0 20 70 67 6e 6f 20 69 73 0a 2a 2a 20 6c 61 72 67 pgno is.** larg
16a00 65 72 20 74 68 61 6e 20 70 50 61 67 65 72 2d 3e er than pPager->
16a10 64 62 53 69 7a 65 20 61 6e 64 20 69 73 20 75 6e dbSize and is un
16a20 72 65 66 65 72 65 6e 63 65 64 2e 0a 2a 2a 0a 2a referenced..**.*
16a30 2a 20 52 65 66 65 72 65 6e 63 65 64 20 70 61 67 * Referenced pag
16a40 65 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 70 es larger than p
16a50 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 61 72 Pager->dbSize ar
16a60 65 20 7a 65 72 6f 65 64 2e 0a 2a 2a 0a 2a 2a 20 e zeroed..**.**
16a70 41 63 74 75 61 6c 6c 79 2c 20 61 74 20 74 68 65 Actually, at the
16a80 20 70 6f 69 6e 74 20 74 68 69 73 20 72 6f 75 74 point this rout
16a90 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2c 20 69 ine is called, i
16aa0 74 20 77 6f 75 6c 64 20 62 65 0a 2a 2a 20 61 6e t would be.** an
16ab0 20 65 72 72 6f 72 20 74 6f 20 68 61 76 65 20 61 error to have a
16ac0 20 72 65 66 65 72 65 6e 63 65 64 20 70 61 67 65 referenced page
16ad0 2e 20 20 42 75 74 20 72 61 74 68 65 72 20 74 68 . But rather th
16ae0 61 6e 20 64 65 6c 65 74 65 0a 2a 2a 20 74 68 61 an delete.** tha
16af0 74 20 70 61 67 65 20 61 6e 64 20 67 75 61 72 61 t page and guara
16b00 6e 74 65 65 20 61 20 73 75 62 73 65 71 75 65 6e ntee a subsequen
16b10 74 20 73 65 67 66 61 75 6c 74 2c 20 69 74 20 73 t segfault, it s
16b20 65 65 6d 73 20 62 65 74 74 65 72 0a 2a 2a 20 74 eems better.** t
16b30 6f 20 7a 65 72 6f 20 69 74 20 61 6e 64 20 68 6f o zero it and ho
16b40 70 65 20 74 68 61 74 20 77 65 20 65 72 72 6f 72 pe that we error
16b50 20 6f 75 74 20 73 61 6e 65 6c 79 2e 0a 2a 2f 0a out sanely..*/.
16b60 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 static void page
16b70 72 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65 r_truncate_cache
16b80 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
16b90 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 20 . PgHdr *pPg;.
16ba0 20 50 67 48 64 72 20 2a 2a 70 70 50 67 3b 0a 20 PgHdr **ppPg;.
16bb0 20 69 6e 74 20 64 62 53 69 7a 65 20 3d 20 70 50 int dbSize = pP
16bc0 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 0a 20 ager->dbSize;..
16bd0 20 70 70 50 67 20 3d 20 26 70 50 61 67 65 72 2d ppPg = &pPager-
16be0 3e 70 41 6c 6c 3b 0a 20 20 77 68 69 6c 65 28 20 >pAll;. while(
16bf0 28 70 50 67 20 3d 20 2a 70 70 50 67 29 21 3d 30 (pPg = *ppPg)!=0
16c00 20 29 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d ){. if( pPg-
16c10 3e 70 67 6e 6f 3c 3d 64 62 53 69 7a 65 20 29 7b >pgno<=dbSize ){
16c20 0a 20 20 20 20 20 20 70 70 50 67 20 3d 20 26 70 . ppPg = &p
16c30 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 Pg->pNextAll;.
16c40 20 20 7d 65 6c 73 65 20 69 66 28 20 70 50 67 2d }else if( pPg-
16c50 3e 6e 52 65 66 3e 30 20 29 7b 0a 20 20 20 20 20 >nRef>0 ){.
16c60 20 6d 65 6d 73 65 74 28 50 47 48 44 52 5f 54 4f memset(PGHDR_TO
16c70 5f 44 41 54 41 28 70 50 67 29 2c 20 30 2c 20 70 _DATA(pPg), 0, p
16c80 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 Pager->pageSize)
16c90 3b 0a 20 20 20 20 20 20 70 70 50 67 20 3d 20 26 ;. ppPg = &
16ca0 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 pPg->pNextAll;.
16cb0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
16cc0 2a 70 70 50 67 20 3d 20 70 50 67 2d 3e 70 4e 65 *ppPg = pPg->pNe
16cd0 78 74 41 6c 6c 3b 0a 20 20 20 20 20 20 49 4f 54 xtAll;. IOT
16ce0 52 41 43 45 28 28 22 50 47 46 52 45 45 20 25 70 RACE(("PGFREE %p
16cf0 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 %d\n", pPager,
16d00 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 pPg->pgno));.
16d10 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 PAGER_INCR(sq
16d20 6c 69 74 65 33 5f 70 61 67 65 72 5f 70 67 66 72 lite3_pager_pgfr
16d30 65 65 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 20 ee_count);.
16d40 20 75 6e 6c 69 6e 6b 50 61 67 65 28 70 50 67 29 unlinkPage(pPg)
16d50 3b 0a 20 20 20 20 20 20 6d 61 6b 65 43 6c 65 61 ;. makeClea
16d60 6e 28 70 50 67 29 3b 0a 20 20 20 20 20 20 73 71 n(pPg);. sq
16d70 6c 69 74 65 33 5f 66 72 65 65 28 70 50 67 2d 3e lite3_free(pPg->
16d80 70 44 61 74 61 29 3b 0a 20 20 20 20 20 20 73 71 pData);. sq
16d90 6c 69 74 65 33 5f 66 72 65 65 28 70 50 67 29 3b lite3_free(pPg);
16da0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e . pPager->n
16db0 50 61 67 65 2d 2d 3b 0a 20 20 20 20 7d 0a 20 20 Page--;. }.
16dc0 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 }.}../*.** Try t
16dd0 6f 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b 20 o obtain a lock
16de0 6f 6e 20 61 20 66 69 6c 65 2e 20 20 49 6e 76 6f on a file. Invo
16df0 6b 65 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c ke the busy call
16e00 62 61 63 6b 20 69 66 20 74 68 65 20 6c 6f 63 6b back if the lock
16e10 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e 74 6c 79 .** is currently
16e20 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 not available.
16e30 20 52 65 70 65 61 74 20 75 6e 74 69 6c 20 74 68 Repeat until th
16e40 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 e busy callback
16e50 72 65 74 75 72 6e 73 0a 2a 2a 20 66 61 6c 73 65 returns.** false
16e60 20 6f 72 20 75 6e 74 69 6c 20 74 68 65 20 6c 6f or until the lo
16e70 63 6b 20 73 75 63 63 65 65 64 73 2e 0a 2a 2a 0a ck succeeds..**.
16e80 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 ** Return SQLITE
16e90 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 61 _OK on success a
16ea0 6e 64 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 nd an error code
16eb0 20 69 66 20 77 65 20 63 61 6e 6e 6f 74 20 6f 62 if we cannot ob
16ec0 74 61 69 6e 0a 2a 2a 20 74 68 65 20 6c 6f 63 6b tain.** the lock
16ed0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
16ee0 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f pager_wait_on_lo
16ef0 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ck(Pager *pPager
16f00 2c 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b , int locktype){
16f10 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a . int rc;.. /*
16f20 20 54 68 65 20 4f 53 20 6c 6f 63 6b 20 76 61 6c The OS lock val
16f30 75 65 73 20 6d 75 73 74 20 62 65 20 74 68 65 20 ues must be the
16f40 73 61 6d 65 20 61 73 20 74 68 65 20 50 61 67 65 same as the Page
16f50 72 20 6c 6f 63 6b 20 76 61 6c 75 65 73 20 2a 2f r lock values */
16f60 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 45 52 . assert( PAGER
16f70 5f 53 48 41 52 45 44 3d 3d 53 48 41 52 45 44 5f _SHARED==SHARED_
16f80 4c 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 LOCK );. assert
16f90 28 20 50 41 47 45 52 5f 52 45 53 45 52 56 45 44 ( PAGER_RESERVED
16fa0 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 ==RESERVED_LOCK
16fb0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 );. assert( PAG
16fc0 45 52 5f 45 58 43 4c 55 53 49 56 45 3d 3d 45 58 ER_EXCLUSIVE==EX
16fd0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a CLUSIVE_LOCK );.
16fe0 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 66 69 6c . /* If the fil
16ff0 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 75 e is currently u
17000 6e 6c 6f 63 6b 65 64 20 74 68 65 6e 20 74 68 65 nlocked then the
17010 20 73 69 7a 65 20 6d 75 73 74 20 62 65 20 75 6e size must be un
17020 6b 6e 6f 77 6e 20 2a 2f 0a 20 20 61 73 73 65 72 known */. asser
17030 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 t( pPager->state
17040 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 7c >=PAGER_SHARED |
17050 7c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 | pPager->dbSize
17060 3c 30 20 7c 7c 20 4d 45 4d 44 42 20 29 3b 0a 0a <0 || MEMDB );..
17070 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 if( pPager->st
17080 61 74 65 3e 3d 6c 6f 63 6b 74 79 70 65 20 29 7b ate>=locktype ){
17090 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
170a0 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 _OK;. }else{.
170b0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70 42 if( pPager->pB
170c0 75 73 79 48 61 6e 64 6c 65 72 20 29 20 70 50 61 usyHandler ) pPa
170d0 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 ger->pBusyHandle
170e0 72 2d 3e 6e 42 75 73 79 20 3d 20 30 3b 0a 20 20 r->nBusy = 0;.
170f0 20 20 64 6f 20 7b 0a 20 20 20 20 20 20 72 63 20 do {. rc
17100 3d 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 = sqlite3OsLock(
17110 70 50 61 67 65 72 2d 3e 66 64 2c 20 6c 6f 63 6b pPager->fd, lock
17120 74 79 70 65 29 3b 0a 20 20 20 20 7d 77 68 69 6c type);. }whil
17130 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 e( rc==SQLITE_BU
17140 53 59 20 26 26 20 73 71 6c 69 74 65 33 49 6e 76 SY && sqlite3Inv
17150 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 70 okeBusyHandler(p
17160 50 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 Pager->pBusyHand
17170 6c 65 72 29 20 29 3b 0a 20 20 20 20 69 66 28 20 ler) );. if(
17180 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
17190 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 73 . pPager->s
171a0 74 61 74 65 20 3d 20 6c 6f 63 6b 74 79 70 65 3b tate = locktype;
171b0 0a 20 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 . IOTRACE((
171c0 22 4c 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c 20 "LOCK %p %d\n",
171d0 70 50 61 67 65 72 2c 20 6c 6f 63 6b 74 79 70 65 pPager, locktype
171e0 29 29 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 )). }. }. r
171f0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
17200 2a 2a 20 54 72 75 6e 63 61 74 65 20 74 68 65 20 ** Truncate the
17210 66 69 6c 65 20 74 6f 20 74 68 65 20 6e 75 6d 62 file to the numb
17220 65 72 20 6f 66 20 70 61 67 65 73 20 73 70 65 63 er of pages spec
17230 69 66 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ified..*/.int sq
17240 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 lite3PagerTrunca
17250 74 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 te(Pager *pPager
17260 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 7b 0a 20 , Pgno nPage){.
17270 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 int rc;. asser
17280 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 t( pPager->state
17290 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 7c >=PAGER_SHARED |
172a0 7c 20 4d 45 4d 44 42 20 29 3b 0a 20 20 73 71 6c | MEMDB );. sql
172b0 69 74 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 ite3PagerPagecou
172c0 6e 74 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 nt(pPager);. if
172d0 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 ( pPager->errCod
172e0 65 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 50 e ){. rc = pP
172f0 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 ager->errCode;.
17300 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
17310 7d 0a 20 20 69 66 28 20 6e 50 61 67 65 3e 3d 28 }. if( nPage>=(
17320 75 6e 73 69 67 6e 65 64 29 70 50 61 67 65 72 2d unsigned)pPager-
17330 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 72 >dbSize ){. r
17340 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
17350 0a 20 20 7d 0a 20 20 69 66 28 20 4d 45 4d 44 42 . }. if( MEMDB
17360 20 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e ){. pPager->
17370 64 62 53 69 7a 65 20 3d 20 6e 50 61 67 65 3b 0a dbSize = nPage;.
17380 20 20 20 20 70 61 67 65 72 5f 74 72 75 6e 63 61 pager_trunca
17390 74 65 5f 63 61 63 68 65 28 70 50 61 67 65 72 29 te_cache(pPager)
173a0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
173b0 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 61 ITE_OK;. }. pa
173c0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 gerEnter(pPager)
173d0 3b 0a 20 20 72 63 20 3d 20 73 79 6e 63 4a 6f 75 ;. rc = syncJou
173e0 72 6e 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 20 rnal(pPager);.
173f0 70 61 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 pagerLeave(pPage
17400 72 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 r);. if( rc!=SQ
17410 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
17420 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 eturn rc;. }..
17430 20 2f 2a 20 47 65 74 20 61 6e 20 65 78 63 6c 75 /* Get an exclu
17440 73 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 sive lock on the
17450 20 64 61 74 61 62 61 73 65 20 62 65 66 6f 72 65 database before
17460 20 74 72 75 6e 63 61 74 69 6e 67 2e 20 2a 2f 0a truncating. */.
17470 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 50 61 pagerEnter(pPa
17480 67 65 72 29 3b 0a 20 20 72 63 20 3d 20 70 61 67 ger);. rc = pag
17490 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 er_wait_on_lock(
174a0 70 50 61 67 65 72 2c 20 45 58 43 4c 55 53 49 56 pPager, EXCLUSIV
174b0 45 5f 4c 4f 43 4b 29 3b 0a 20 20 70 61 67 65 72 E_LOCK);. pager
174c0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 Leave(pPager);.
174d0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
174e0 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
174f0 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d rc;. }.. rc =
17500 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 pager_truncate(
17510 70 50 61 67 65 72 2c 20 6e 50 61 67 65 29 3b 0a pPager, nPage);.
17520 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
17530 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 74 /*.** Shutdown t
17540 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 20 he page cache.
17550 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 Free all memory
17560 61 6e 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 69 and close all fi
17570 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 les..**.** If a
17580 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 transaction was
17590 69 6e 20 70 72 6f 67 72 65 73 73 20 77 68 65 6e in progress when
175a0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
175b0 20 63 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a 2a called, that.**
175c0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
175d0 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 6c rolled back. Al
175e0 6c 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 61 l outstanding pa
175f0 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 61 ges are invalida
17600 74 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 72 ted.** and their
17610 20 6d 65 6d 6f 72 79 20 69 73 20 66 72 65 65 64 memory is freed
17620 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 74 . Any attempt t
17630 6f 20 75 73 65 20 61 20 70 61 67 65 20 61 73 73 o use a page ass
17640 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 ociated.** with
17650 74 68 69 73 20 70 61 67 65 20 63 61 63 68 65 20 this page cache
17660 61 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 after this funct
17670 69 6f 6e 20 72 65 74 75 72 6e 73 20 77 69 6c 6c ion returns will
17680 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 6c likely.** resul
17690 74 20 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 2e t in a coredump.
176a0 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 .**.** This func
176b0 74 69 6f 6e 20 61 6c 77 61 79 73 20 73 75 63 63 tion always succ
176c0 65 65 64 73 2e 20 49 66 20 61 20 74 72 61 6e 73 eeds. If a trans
176d0 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 action is active
176e0 20 61 6e 20 61 74 74 65 6d 70 74 0a 2a 2a 20 69 an attempt.** i
176f0 73 20 6d 61 64 65 20 74 6f 20 72 6f 6c 6c 20 69 s made to roll i
17700 74 20 62 61 63 6b 2e 20 49 66 20 61 6e 20 65 72 t back. If an er
17710 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e ror occurs durin
17720 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 0a g the rollback .
17730 2a 2a 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c ** a hot journal
17740 20 6d 61 79 20 62 65 20 6c 65 66 74 20 69 6e 20 may be left in
17750 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 62 the filesystem b
17760 75 74 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 ut no error is r
17770 65 74 75 72 6e 65 64 0a 2a 2a 20 74 6f 20 74 68 eturned.** to th
17780 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e 74 e caller..*/.int
17790 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c 6f sqlite3PagerClo
177a0 73 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 se(Pager *pPager
177b0 29 7b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ){.#ifdef SQLITE
177c0 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
177d0 41 4e 41 47 45 4d 45 4e 54 0a 20 20 69 66 28 20 ANAGEMENT. if(
177e0 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 73 71 !MEMDB ){. sq
177f0 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 lite3_mutex *mut
17800 65 78 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 ex = sqlite3_mut
17810 65 78 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f ex_alloc(SQLITE_
17820 4d 55 54 45 58 5f 53 54 41 54 49 43 5f 4d 45 4d MUTEX_STATIC_MEM
17830 32 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 2);. sqlite3_
17840 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
17850 78 29 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 x);. if( pPag
17860 65 72 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 er->pPrev ){.
17870 20 20 20 70 50 61 67 65 72 2d 3e 70 50 72 65 76 pPager->pPrev
17880 2d 3e 70 4e 65 78 74 20 3d 20 70 50 61 67 65 72 ->pNext = pPager
17890 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 7d 65 6c ->pNext;. }el
178a0 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 se{. sqlite
178b0 33 50 61 67 65 72 4c 69 73 74 20 3d 20 70 50 61 3PagerList = pPa
178c0 67 65 72 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20 ger->pNext;.
178d0 7d 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 }. if( pPager
178e0 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20 20 ->pNext ){.
178f0 20 70 50 61 67 65 72 2d 3e 70 4e 65 78 74 2d 3e pPager->pNext->
17900 70 50 72 65 76 20 3d 20 70 50 61 67 65 72 2d 3e pPrev = pPager->
17910 70 50 72 65 76 3b 0a 20 20 20 20 7d 0a 20 20 20 pPrev;. }.
17920 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c sqlite3_mutex_l
17930 65 61 76 65 28 6d 75 74 65 78 29 3b 0a 20 20 7d eave(mutex);. }
17940 0a 23 65 6e 64 69 66 0a 0a 20 20 64 69 73 61 62 .#endif.. disab
17950 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f le_simulated_io_
17960 65 72 72 6f 72 73 28 29 3b 0a 20 20 73 71 6c 69 errors();. sqli
17970 74 65 33 46 61 75 6c 74 42 65 6e 69 67 6e 28 2d te3FaultBenign(-
17980 31 2c 20 31 29 3b 0a 20 20 70 50 61 67 65 72 2d 1, 1);. pPager-
17990 3e 65 72 72 43 6f 64 65 20 3d 20 30 3b 0a 20 20 >errCode = 0;.
179a0 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
179b0 65 4d 6f 64 65 20 3d 20 30 3b 0a 20 20 70 61 67 eMode = 0;. pag
179c0 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 er_reset(pPager)
179d0 3b 0a 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 41 ;. pagerUnlockA
179e0 6e 64 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65 ndRollback(pPage
179f0 72 29 3b 0a 20 20 65 6e 61 62 6c 65 5f 73 69 6d r);. enable_sim
17a00 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 ulated_io_errors
17a10 28 29 3b 0a 20 20 73 71 6c 69 74 65 33 46 61 75 ();. sqlite3Fau
17a20 6c 74 42 65 6e 69 67 6e 28 2d 31 2c 20 30 29 3b ltBenign(-1, 0);
17a30 0a 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22 . PAGERTRACE2("
17a40 43 4c 4f 53 45 20 25 64 5c 6e 22 2c 20 50 41 47 CLOSE %d\n", PAG
17a50 45 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 ERID(pPager));.
17a60 20 49 4f 54 52 41 43 45 28 28 22 43 4c 4f 53 45 IOTRACE(("CLOSE
17a70 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 %p\n", pPager))
17a80 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a . if( pPager->j
17a90 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 ournalOpen ){.
17aa0 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 sqlite3OsClose
17ab0 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 (pPager->jfd);.
17ac0 20 7d 0a 20 20 73 71 6c 69 74 65 33 42 69 74 76 }. sqlite3Bitv
17ad0 65 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 ecDestroy(pPager
17ae0 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 ->pInJournal);.
17af0 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 6d if( pPager->stm
17b00 74 4f 70 65 6e 20 29 7b 0a 20 20 20 20 73 71 6c tOpen ){. sql
17b10 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 ite3OsClose(pPag
17b20 65 72 2d 3e 73 74 66 64 29 3b 0a 20 20 7d 0a 20 er->stfd);. }.
17b30 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 sqlite3OsClose(
17b40 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 2f pPager->fd);. /
17b50 2a 20 54 65 6d 70 20 66 69 6c 65 73 20 61 72 65 * Temp files are
17b60 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
17b70 65 6c 65 74 65 64 20 62 79 20 74 68 65 20 4f 53 eleted by the OS
17b80 0a 20 20 2a 2a 20 69 66 28 20 70 50 61 67 65 72 . ** if( pPager
17b90 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 ->tempFile ){.
17ba0 2a 2a 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 ** sqlite3OsDe
17bb0 6c 65 74 65 28 70 50 61 67 65 72 2d 3e 7a 46 69 lete(pPager->zFi
17bc0 6c 65 6e 61 6d 65 29 3b 0a 20 20 2a 2a 20 7d 0a lename);. ** }.
17bd0 20 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65 33 5f */.. sqlite3_
17be0 66 72 65 65 28 70 50 61 67 65 72 2d 3e 61 48 61 free(pPager->aHa
17bf0 73 68 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 66 sh);. sqlite3_f
17c00 72 65 65 28 70 50 61 67 65 72 2d 3e 70 54 6d 70 ree(pPager->pTmp
17c10 53 70 61 63 65 29 3b 0a 20 20 73 71 6c 69 74 65 Space);. sqlite
17c20 33 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b 0a 3_free(pPager);.
17c30 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
17c40 4f 4b 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69 OK;.}..#if !defi
17c50 6e 65 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 64 ned(NDEBUG) || d
17c60 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 efined(SQLITE_TE
17c70 53 54 29 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e ST)./*.** Return
17c80 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 the page number
17c90 20 66 6f 72 20 74 68 65 20 67 69 76 65 6e 20 70 for the given p
17ca0 61 67 65 20 64 61 74 61 2e 0a 2a 2f 0a 50 67 6e age data..*/.Pgn
17cb0 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 o sqlite3PagerPa
17cc0 67 65 6e 75 6d 62 65 72 28 44 62 50 61 67 65 20 genumber(DbPage
17cd0 2a 70 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d *p){. return p-
17ce0 3e 70 67 6e 6f 3b 0a 7d 0a 23 65 6e 64 69 66 0a >pgno;.}.#endif.
17cf0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 5f ./*.** The page_
17d00 72 65 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 69 ref() function i
17d10 6e 63 72 65 6d 65 6e 74 73 20 74 68 65 20 72 65 ncrements the re
17d20 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 20 66 6f ference count fo
17d30 72 20 61 20 70 61 67 65 2e 0a 2a 2a 20 49 66 20 r a page..** If
17d40 74 68 65 20 70 61 67 65 20 69 73 20 63 75 72 72 the page is curr
17d50 65 6e 74 6c 79 20 6f 6e 20 74 68 65 20 66 72 65 ently on the fre
17d60 65 6c 69 73 74 20 28 74 68 65 20 72 65 66 65 72 elist (the refer
17d70 65 6e 63 65 20 63 6f 75 6e 74 20 69 73 20 7a 65 ence count is ze
17d80 72 6f 29 20 74 68 65 6e 0a 2a 2a 20 72 65 6d 6f ro) then.** remo
17d90 76 65 20 69 74 20 66 72 6f 6d 20 74 68 65 20 66 ve it from the f
17da0 72 65 65 6c 69 73 74 2e 0a 2a 2a 0a 2a 2a 20 46 reelist..**.** F
17db0 6f 72 20 6e 6f 6e 2d 74 65 73 74 20 73 79 73 74 or non-test syst
17dc0 65 6d 73 2c 20 70 61 67 65 5f 72 65 66 28 29 20 ems, page_ref()
17dd0 69 73 20 61 20 6d 61 63 72 6f 20 74 68 61 74 20 is a macro that
17de0 63 61 6c 6c 73 20 5f 70 61 67 65 5f 72 65 66 28 calls _page_ref(
17df0 29 0a 2a 2a 20 6f 6e 6c 69 6e 65 20 6f 66 20 74 ).** online of t
17e00 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 he reference cou
17e10 6e 74 20 69 73 20 7a 65 72 6f 2e 20 20 46 6f 72 nt is zero. For
17e20 20 74 65 73 74 20 73 79 73 74 65 6d 73 2c 20 70 test systems, p
17e30 61 67 65 5f 72 65 66 28 29 0a 2a 2a 20 69 73 20 age_ref().** is
17e40 61 20 72 65 61 6c 20 66 75 6e 63 74 69 6f 6e 20 a real function
17e50 73 6f 20 74 68 61 74 20 77 65 20 63 61 6e 20 73 so that we can s
17e60 65 74 20 62 72 65 61 6b 70 6f 69 6e 74 73 20 61 et breakpoints a
17e70 6e 64 20 74 72 61 63 65 20 69 74 2e 0a 2a 2f 0a nd trace it..*/.
17e80 73 74 61 74 69 63 20 76 6f 69 64 20 5f 70 61 67 static void _pag
17e90 65 5f 72 65 66 28 50 67 48 64 72 20 2a 70 50 67 e_ref(PgHdr *pPg
17ea0 29 7b 0a 20 20 69 66 28 20 70 50 67 2d 3e 6e 52 ){. if( pPg->nR
17eb0 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 ef==0 ){. /*
17ec0 54 68 65 20 70 61 67 65 20 69 73 20 63 75 72 72 The page is curr
17ed0 65 6e 74 6c 79 20 6f 6e 20 74 68 65 20 66 72 65 ently on the fre
17ee0 65 6c 69 73 74 2e 20 20 52 65 6d 6f 76 65 20 69 elist. Remove i
17ef0 74 2e 20 2a 2f 0a 20 20 20 20 6c 72 75 4c 69 73 t. */. lruLis
17f00 74 52 65 6d 6f 76 65 28 70 50 67 29 3b 0a 20 20 tRemove(pPg);.
17f10 20 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 6e pPg->pPager->n
17f20 52 65 66 2b 2b 3b 0a 20 20 7d 0a 20 20 70 50 67 Ref++;. }. pPg
17f30 2d 3e 6e 52 65 66 2b 2b 3b 0a 7d 0a 23 69 66 64 ->nRef++;.}.#ifd
17f40 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
17f50 20 20 73 74 61 74 69 63 20 76 6f 69 64 20 70 61 static void pa
17f60 67 65 5f 72 65 66 28 50 67 48 64 72 20 2a 70 50 ge_ref(PgHdr *pP
17f70 67 29 7b 0a 20 20 20 20 69 66 28 20 70 50 67 2d g){. if( pPg-
17f80 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 >nRef==0 ){.
17f90 20 20 5f 70 61 67 65 5f 72 65 66 28 70 50 67 29 _page_ref(pPg)
17fa0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
17fb0 20 20 20 70 50 67 2d 3e 6e 52 65 66 2b 2b 3b 0a pPg->nRef++;.
17fc0 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6c 73 65 0a }. }.#else.
17fd0 23 20 64 65 66 69 6e 65 20 70 61 67 65 5f 72 65 # define page_re
17fe0 66 28 50 29 20 20 20 28 28 50 29 2d 3e 6e 52 65 f(P) ((P)->nRe
17ff0 66 3d 3d 30 3f 5f 70 61 67 65 5f 72 65 66 28 50 f==0?_page_ref(P
18000 29 3a 28 76 6f 69 64 29 28 50 29 2d 3e 6e 52 65 ):(void)(P)->nRe
18010 66 2b 2b 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a f++).#endif../*.
18020 2a 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 ** Increment the
18030 20 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 reference count
18040 20 66 6f 72 20 61 20 70 61 67 65 2e 20 20 54 68 for a page. Th
18050 65 20 69 6e 70 75 74 20 70 6f 69 6e 74 65 72 20 e input pointer
18060 69 73 0a 2a 2a 20 61 20 72 65 66 65 72 65 6e 63 is.** a referenc
18070 65 20 74 6f 20 74 68 65 20 70 61 67 65 20 64 61 e to the page da
18080 74 61 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ta..*/.int sqlit
18090 65 33 50 61 67 65 72 52 65 66 28 44 62 50 61 67 e3PagerRef(DbPag
180a0 65 20 2a 70 50 67 29 7b 0a 20 20 70 61 67 65 72 e *pPg){. pager
180b0 45 6e 74 65 72 28 70 50 67 2d 3e 70 50 61 67 65 Enter(pPg->pPage
180c0 72 29 3b 0a 20 20 70 61 67 65 5f 72 65 66 28 70 r);. page_ref(p
180d0 50 67 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 76 Pg);. pagerLeav
180e0 65 28 70 50 67 2d 3e 70 50 61 67 65 72 29 3b 0a e(pPg->pPager);.
180f0 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
18100 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e OK;.}../*.** Syn
18110 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 c the journal.
18120 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 In other words,
18130 6d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 74 68 make sure all th
18140 65 20 70 61 67 65 73 20 74 68 61 74 20 68 61 76 e pages that hav
18150 65 0a 2a 2a 20 62 65 65 6e 20 77 72 69 74 74 65 e.** been writte
18160 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c n to the journal
18170 20 68 61 76 65 20 61 63 74 75 61 6c 6c 79 20 72 have actually r
18180 65 61 63 68 65 64 20 74 68 65 20 73 75 72 66 61 eached the surfa
18190 63 65 20 6f 66 20 74 68 65 0a 2a 2a 20 64 69 73 ce of the.** dis
181a0 6b 2e 20 20 49 74 20 69 73 20 6e 6f 74 20 73 61 k. It is not sa
181b0 66 65 20 74 6f 20 6d 6f 64 69 66 79 20 74 68 65 fe to modify the
181c0 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 62 61 original databa
181d0 73 65 20 66 69 6c 65 20 75 6e 74 69 6c 20 61 66 se file until af
181e0 74 65 72 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e ter.** the journ
181f0 61 6c 20 68 61 73 20 62 65 65 6e 20 73 79 6e 63 al has been sync
18200 65 64 2e 20 20 49 66 20 74 68 65 20 6f 72 69 67 ed. If the orig
18210 69 6e 61 6c 20 64 61 74 61 62 61 73 65 20 69 73 inal database is
18220 20 6d 6f 64 69 66 69 65 64 20 62 65 66 6f 72 65 modified before
18230 0a 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 .** the journal
18240 69 73 20 73 79 6e 63 65 64 20 61 6e 64 20 61 20 is synced and a
18250 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 6f 63 power failure oc
18260 63 75 72 73 2c 20 74 68 65 20 75 6e 73 79 6e 63 curs, the unsync
18270 65 64 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 64 61 ed journal.** da
18280 74 61 20 77 6f 75 6c 64 20 62 65 20 6c 6f 73 74 ta would be lost
18290 20 61 6e 64 20 77 65 20 77 6f 75 6c 64 20 62 65 and we would be
182a0 20 75 6e 61 62 6c 65 20 74 6f 20 63 6f 6d 70 6c unable to compl
182b0 65 74 65 6c 79 20 72 6f 6c 6c 62 61 63 6b 20 74 etely rollback t
182c0 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 he.** database c
182d0 68 61 6e 67 65 73 2e 20 20 44 61 74 61 62 61 73 hanges. Databas
182e0 65 20 63 6f 72 72 75 70 74 69 6f 6e 20 77 6f 75 e corruption wou
182f0 6c 64 20 6f 63 63 75 72 2e 0a 2a 2a 20 0a 2a 2a ld occur..** .**
18300 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 61 6c This routine al
18310 73 6f 20 75 70 64 61 74 65 73 20 74 68 65 20 6e so updates the n
18320 52 65 63 20 66 69 65 6c 64 20 69 6e 20 74 68 65 Rec field in the
18330 20 68 65 61 64 65 72 20 6f 66 20 74 68 65 20 6a header of the j
18340 6f 75 72 6e 61 6c 2e 0a 2a 2a 20 28 53 65 65 20 ournal..** (See
18350 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 74 68 65 20 comments on the
18360 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 pager_playback()
18370 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 61 64 64 routine for add
18380 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 itional informat
18390 69 6f 6e 2e 29 0a 2a 2a 20 49 66 20 74 68 65 20 ion.).** If the
183a0 73 79 6e 63 20 6d 6f 64 65 20 69 73 20 46 55 4c sync mode is FUL
183b0 4c 2c 20 74 77 6f 20 73 79 6e 63 73 20 77 69 6c L, two syncs wil
183c0 6c 20 6f 63 63 75 72 2e 20 20 46 69 72 73 74 20 l occur. First
183d0 74 68 65 20 77 68 6f 6c 65 20 6a 6f 75 72 6e 61 the whole journa
183e0 6c 0a 2a 2a 20 69 73 20 73 79 6e 63 65 64 2c 20 l.** is synced,
183f0 74 68 65 6e 20 74 68 65 20 6e 52 65 63 20 66 69 then the nRec fi
18400 65 6c 64 20 69 73 20 75 70 64 61 74 65 64 2c 20 eld is updated,
18410 74 68 65 6e 20 61 20 73 65 63 6f 6e 64 20 73 79 then a second sy
18420 6e 63 20 6f 63 63 75 72 73 2e 0a 2a 2a 0a 2a 2a nc occurs..**.**
18430 20 46 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 64 For temporary d
18440 61 74 61 62 61 73 65 73 2c 20 77 65 20 64 6f 20 atabases, we do
18450 6e 6f 74 20 63 61 72 65 20 69 66 20 77 65 20 61 not care if we a
18460 72 65 20 61 62 6c 65 20 74 6f 20 72 6f 6c 6c 62 re able to rollb
18470 61 63 6b 0a 2a 2a 20 61 66 74 65 72 20 61 20 70 ack.** after a p
18480 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 73 6f ower failure, so
18490 20 6e 6f 20 73 79 6e 63 20 6f 63 63 75 72 73 2e no sync occurs.
184a0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 49 4f .**.** If the IO
184b0 43 41 50 5f 53 45 51 55 45 4e 54 49 41 4c 20 66 CAP_SEQUENTIAL f
184c0 6c 61 67 20 69 73 20 73 65 74 20 66 6f 72 20 74 lag is set for t
184d0 68 65 20 70 65 72 73 69 73 74 65 6e 74 20 6d 65 he persistent me
184e0 64 69 61 20 6f 6e 20 77 68 69 63 68 0a 2a 2a 20 dia on which.**
184f0 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 the database is
18500 73 74 6f 72 65 64 2c 20 74 68 65 6e 20 4f 73 53 stored, then OsS
18510 79 6e 63 28 29 20 69 73 20 6e 65 76 65 72 20 63 ync() is never c
18520 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 6a 6f 75 alled on the jou
18530 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 2e 20 49 6e rnal.** file. In
18540 20 74 68 69 73 20 63 61 73 65 20 61 6c 6c 20 74 this case all t
18550 68 61 74 20 69 73 20 72 65 71 75 69 72 65 64 20 hat is required
18560 69 73 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 is to update the
18570 20 6e 52 65 63 20 66 69 65 6c 64 20 69 6e 0a 2a nRec field in.*
18580 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 * the journal he
18590 61 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 ader..**.** This
185a0 20 72 6f 75 74 69 6e 65 20 63 6c 65 61 72 73 20 routine clears
185b0 74 68 65 20 6e 65 65 64 53 79 6e 63 20 66 69 65 the needSync fie
185c0 6c 64 20 6f 66 20 65 76 65 72 79 20 70 61 67 65 ld of every page
185d0 20 63 75 72 72 65 6e 74 20 68 65 6c 64 20 69 6e current held in
185e0 0a 2a 2a 20 6d 65 6d 6f 72 79 2e 0a 2a 2f 0a 73 .** memory..*/.s
185f0 74 61 74 69 63 20 69 6e 74 20 73 79 6e 63 4a 6f tatic int syncJo
18600 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 urnal(Pager *pPa
18610 67 65 72 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 ger){. PgHdr *p
18620 50 67 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 Pg;. int rc = S
18630 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 0a 20 20 2f 2a QLITE_OK;... /*
18640 20 53 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 Sync the journa
18650 6c 20 62 65 66 6f 72 65 20 6d 6f 64 69 66 79 69 l before modifyi
18660 6e 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 ng the main data
18670 62 61 73 65 0a 20 20 2a 2a 20 28 61 73 73 75 6d base. ** (assum
18680 69 6e 67 20 74 68 65 72 65 20 69 73 20 61 20 6a ing there is a j
18690 6f 75 72 6e 61 6c 20 61 6e 64 20 69 74 20 6e 65 ournal and it ne
186a0 65 64 73 20 74 6f 20 62 65 20 73 79 6e 63 65 64 eds to be synced
186b0 2e 29 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 .). */. if( pP
186c0 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 20 29 ager->needSync )
186d0 7b 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 {. if( !pPage
186e0 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 r->tempFile ){.
186f0 20 20 20 20 20 69 6e 74 20 69 44 63 20 3d 20 73 int iDc = s
18700 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 43 68 qlite3OsDeviceCh
18710 61 72 61 63 74 65 72 69 73 74 69 63 73 28 70 50 aracteristics(pP
18720 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 20 20 ager->fd);.
18730 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
18740 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 3b 0a >journalOpen );.
18750 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69 . if( 0==(i
18760 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f Dc&SQLITE_IOCAP_
18770 53 41 46 45 5f 41 50 50 45 4e 44 29 20 29 7b 0a SAFE_APPEND) ){.
18780 20 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 /* Write
18790 20 74 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20 the nRec value
187a0 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c into the journal
187b0 20 66 69 6c 65 20 68 65 61 64 65 72 2e 20 49 66 file header. If
187c0 20 69 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 in. ** f
187d0 75 6c 6c 2d 73 79 6e 63 68 72 6f 6e 6f 75 73 20 ull-synchronous
187e0 6d 6f 64 65 2c 20 73 79 6e 63 20 74 68 65 20 6a mode, sync the j
187f0 6f 75 72 6e 61 6c 20 66 69 72 73 74 2e 20 54 68 ournal first. Th
18800 69 73 20 65 6e 73 75 72 65 73 20 74 68 61 74 0a is ensures that.
18810 20 20 20 20 20 20 20 20 2a 2a 20 61 6c 6c 20 64 ** all d
18820 61 74 61 20 68 61 73 20 72 65 61 6c 6c 79 20 68 ata has really h
18830 69 74 20 74 68 65 20 64 69 73 6b 20 62 65 66 6f it the disk befo
18840 72 65 20 6e 52 65 63 20 69 73 20 75 70 64 61 74 re nRec is updat
18850 65 64 20 74 6f 20 6d 61 72 6b 0a 20 20 20 20 20 ed to mark.
18860 20 20 20 2a 2a 20 69 74 20 61 73 20 61 20 63 61 ** it as a ca
18870 6e 64 69 64 61 74 65 20 66 6f 72 20 72 6f 6c 6c ndidate for roll
18880 62 61 63 6b 2e 0a 20 20 20 20 20 20 20 20 2a 2a back.. **
18890 0a 20 20 20 20 20 20 20 20 2a 2a 20 54 68 69 73 . ** This
188a0 20 69 73 20 6e 6f 74 20 72 65 71 75 69 72 65 64 is not required
188b0 20 69 66 20 74 68 65 20 70 65 72 73 69 73 74 65 if the persiste
188c0 6e 74 20 6d 65 64 69 61 20 73 75 70 70 6f 72 74 nt media support
188d0 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a s the. **
188e0 20 53 41 46 45 5f 41 50 50 45 4e 44 20 70 72 6f SAFE_APPEND pro
188f0 70 65 72 74 79 2e 20 42 65 63 61 75 73 65 20 69 perty. Because i
18900 6e 20 74 68 69 73 20 63 61 73 65 20 69 74 20 69 n this case it i
18910 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 0a s not possible .
18920 20 20 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 67 ** for g
18930 61 72 62 61 67 65 20 64 61 74 61 20 74 6f 20 62 arbage data to b
18940 65 20 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 e appended to th
18950 65 20 66 69 6c 65 2c 20 74 68 65 20 6e 52 65 63 e file, the nRec
18960 20 66 69 65 6c 64 0a 20 20 20 20 20 20 20 20 2a field. *
18970 2a 20 69 73 20 70 6f 70 75 6c 61 74 65 64 20 77 * is populated w
18980 69 74 68 20 30 78 46 46 46 46 46 46 46 46 20 77 ith 0xFFFFFFFF w
18990 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
189a0 68 65 61 64 65 72 20 69 73 20 77 72 69 74 74 65 header is writte
189b0 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 6e 64 n. ** and
189c0 20 6e 65 76 65 72 20 6e 65 65 64 73 20 74 6f 20 never needs to
189d0 62 65 20 75 70 64 61 74 65 64 2e 0a 20 20 20 20 be updated..
189e0 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 */. i
189f0 36 34 20 6a 72 6e 6c 4f 66 66 3b 0a 20 20 20 20 64 jrnlOff;.
18a00 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
18a10 66 75 6c 6c 53 79 6e 63 20 26 26 20 30 3d 3d 28 fullSync && 0==(
18a20 69 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 iDc&SQLITE_IOCAP
18a30 5f 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a _SEQUENTIAL) ){.
18a40 20 20 20 20 20 20 20 20 20 20 50 41 47 45 52 54 PAGERT
18a50 52 41 43 45 32 28 22 53 59 4e 43 20 6a 6f 75 72 RACE2("SYNC jour
18a60 6e 61 6c 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41 nal of %d\n", PA
18a70 47 45 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a GERID(pPager));.
18a80 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 41 43 IOTRAC
18a90 45 28 28 22 4a 53 59 4e 43 20 25 70 5c 6e 22 2c E(("JSYNC %p\n",
18aa0 20 70 50 61 67 65 72 29 29 0a 20 20 20 20 20 20 pPager)).
18ab0 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
18ac0 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a OsSync(pPager->j
18ad0 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 fd, pPager->sync
18ae0 5f 66 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 20 _flags);.
18af0 20 20 20 69 66 28 20 72 63 21 3d 30 20 29 20 72 if( rc!=0 ) r
18b00 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
18b10 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 6a 72 6e }.. jrn
18b20 6c 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e 6a lOff = pPager->j
18b30 6f 75 72 6e 61 6c 48 64 72 20 2b 20 73 69 7a 65 ournalHdr + size
18b40 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 of(aJournalMagic
18b50 29 3b 0a 20 20 20 20 20 20 20 20 49 4f 54 52 41 );. IOTRA
18b60 43 45 28 28 22 4a 48 44 52 20 25 70 20 25 6c 6c CE(("JHDR %p %ll
18b70 64 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c d %d\n", pPager,
18b80 20 6a 72 6e 6c 4f 66 66 2c 20 34 29 29 3b 0a 20 jrnlOff, 4));.
18b90 20 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 rc = writ
18ba0 65 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e e32bits(pPager->
18bb0 6a 66 64 2c 20 6a 72 6e 6c 4f 66 66 2c 20 70 50 jfd, jrnlOff, pP
18bc0 61 67 65 72 2d 3e 6e 52 65 63 29 3b 0a 20 20 20 ager->nRec);.
18bd0 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 if( rc ) re
18be0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
18bf0 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d 28 69 . if( 0==(i
18c00 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f Dc&SQLITE_IOCAP_
18c10 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b 0a 20 SEQUENTIAL) ){.
18c20 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 PAGERTRAC
18c30 45 32 28 22 53 59 4e 43 20 6a 6f 75 72 6e 61 6c E2("SYNC journal
18c40 20 6f 66 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 of %d\n", PAGER
18c50 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 ID(pPager));.
18c60 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a IOTRACE(("J
18c70 53 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50 61 67 SYNC %p\n", pPag
18c80 65 72 29 29 0a 20 20 20 20 20 20 20 20 72 63 20 er)). rc
18c90 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 = sqlite3OsSync(
18ca0 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 pPager->jfd, pPa
18cb0 67 65 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 7c ger->sync_flags|
18cc0 20 0a 20 20 20 20 20 20 20 20 20 20 28 70 50 61 . (pPa
18cd0 67 65 72 2d 3e 73 79 6e 63 5f 66 6c 61 67 73 3d ger->sync_flags=
18ce0 3d 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 4c =SQLITE_SYNC_FUL
18cf0 4c 3f 53 51 4c 49 54 45 5f 53 59 4e 43 5f 44 41 L?SQLITE_SYNC_DA
18d00 54 41 4f 4e 4c 59 3a 30 29 0a 20 20 20 20 20 20 TAONLY:0).
18d10 20 20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 );. if(
18d20 20 72 63 21 3d 30 20 29 20 72 65 74 75 72 6e 20 rc!=0 ) return
18d30 72 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rc;. }.
18d40 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
18d50 6c 53 74 61 72 74 65 64 20 3d 20 31 3b 0a 20 20 lStarted = 1;.
18d60 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d 3e }. pPager->
18d70 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 0a 20 needSync = 0;..
18d80 20 20 20 2f 2a 20 45 72 61 73 65 20 74 68 65 20 /* Erase the
18d90 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 66 72 needSync flag fr
18da0 6f 6d 20 65 76 65 72 79 20 70 61 67 65 2e 0a 20 om every page..
18db0 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 50 */. for(pP
18dc0 67 3d 70 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 g=pPager->pAll;
18dd0 70 50 67 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e pPg; pPg=pPg->pN
18de0 65 78 74 41 6c 6c 29 7b 0a 20 20 20 20 20 20 70 extAll){. p
18df0 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 30 Pg->needSync = 0
18e00 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 72 75 4c ;. }. lruL
18e10 69 73 74 53 65 74 46 69 72 73 74 53 79 6e 63 65 istSetFirstSynce
18e20 64 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a d(pPager);. }..
18e30 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 #ifndef NDEBUG.
18e40 20 2f 2a 20 49 66 20 74 68 65 20 50 61 67 65 72 /* If the Pager
18e50 2e 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 .needSync flag i
18e60 73 20 63 6c 65 61 72 20 74 68 65 6e 20 74 68 65 s clear then the
18e70 20 50 67 48 64 72 2e 6e 65 65 64 53 79 6e 63 0a PgHdr.needSync.
18e80 20 20 2a 2a 20 66 6c 61 67 20 6d 75 73 74 20 61 ** flag must a
18e90 6c 73 6f 20 62 65 20 63 6c 65 61 72 20 66 6f 72 lso be clear for
18ea0 20 61 6c 6c 20 70 61 67 65 73 2e 20 20 56 65 72 all pages. Ver
18eb0 69 66 79 20 74 68 61 74 20 74 68 69 73 0a 20 20 ify that this.
18ec0 2a 2a 20 69 6e 76 61 72 69 61 6e 74 20 69 73 20 ** invariant is
18ed0 74 72 75 65 2e 0a 20 20 2a 2f 0a 20 20 65 6c 73 true.. */. els
18ee0 65 7b 0a 20 20 20 20 66 6f 72 28 70 50 67 3d 70 e{. for(pPg=p
18ef0 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67 Pager->pAll; pPg
18f00 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74 ; pPg=pPg->pNext
18f10 41 6c 6c 29 7b 0a 20 20 20 20 20 20 61 73 73 65 All){. asse
18f20 72 74 28 20 70 50 67 2d 3e 6e 65 65 64 53 79 6e rt( pPg->needSyn
18f30 63 3d 3d 30 20 29 3b 0a 20 20 20 20 7d 0a 20 20 c==0 );. }.
18f40 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
18f50 2d 3e 6c 72 75 2e 70 46 69 72 73 74 53 79 6e 63 ->lru.pFirstSync
18f60 65 64 3d 3d 70 50 61 67 65 72 2d 3e 6c 72 75 2e ed==pPager->lru.
18f70 70 46 69 72 73 74 20 29 3b 0a 20 20 7d 0a 23 65 pFirst );. }.#e
18f80 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72 ndif.. return r
18f90 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 65 72 67 c;.}../*.** Merg
18fa0 65 20 74 77 6f 20 6c 69 73 74 73 20 6f 66 20 70 e two lists of p
18fb0 61 67 65 73 20 63 6f 6e 6e 65 63 74 65 64 20 62 ages connected b
18fc0 79 20 70 44 69 72 74 79 20 61 6e 64 20 69 6e 20 y pDirty and in
18fd0 70 67 6e 6f 20 6f 72 64 65 72 2e 0a 2a 2a 20 44 pgno order..** D
18fe0 6f 20 6e 6f 74 20 62 6f 74 68 20 66 69 78 69 6e o not both fixin
18ff0 67 20 74 68 65 20 70 50 72 65 76 44 69 72 74 79 g the pPrevDirty
19000 20 70 6f 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 74 pointers..*/.st
19010 61 74 69 63 20 50 67 48 64 72 20 2a 6d 65 72 67 atic PgHdr *merg
19020 65 5f 70 61 67 65 6c 69 73 74 28 50 67 48 64 72 e_pagelist(PgHdr
19030 20 2a 70 41 2c 20 50 67 48 64 72 20 2a 70 42 29 *pA, PgHdr *pB)
19040 7b 0a 20 20 50 67 48 64 72 20 72 65 73 75 6c 74 {. PgHdr result
19050 2c 20 2a 70 54 61 69 6c 3b 0a 20 20 70 54 61 69 , *pTail;. pTai
19060 6c 20 3d 20 26 72 65 73 75 6c 74 3b 0a 20 20 77 l = &result;. w
19070 68 69 6c 65 28 20 70 41 20 26 26 20 70 42 20 29 hile( pA && pB )
19080 7b 0a 20 20 20 20 69 66 28 20 70 41 2d 3e 70 67 {. if( pA->pg
19090 6e 6f 3c 70 42 2d 3e 70 67 6e 6f 20 29 7b 0a 20 no<pB->pgno ){.
190a0 20 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 pTail->pDir
190b0 74 79 20 3d 20 70 41 3b 0a 20 20 20 20 20 20 70 ty = pA;. p
190c0 54 61 69 6c 20 3d 20 70 41 3b 0a 20 20 20 20 20 Tail = pA;.
190d0 20 70 41 20 3d 20 70 41 2d 3e 70 44 69 72 74 79 pA = pA->pDirty
190e0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
190f0 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 74 79 pTail->pDirty
19100 20 3d 20 70 42 3b 0a 20 20 20 20 20 20 70 54 61 = pB;. pTa
19110 69 6c 20 3d 20 70 42 3b 0a 20 20 20 20 20 20 70 il = pB;. p
19120 42 20 3d 20 70 42 2d 3e 70 44 69 72 74 79 3b 0a B = pB->pDirty;.
19130 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
19140 70 41 20 29 7b 0a 20 20 20 20 70 54 61 69 6c 2d pA ){. pTail-
19150 3e 70 44 69 72 74 79 20 3d 20 70 41 3b 0a 20 20 >pDirty = pA;.
19160 7d 65 6c 73 65 20 69 66 28 20 70 42 20 29 7b 0a }else if( pB ){.
19170 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 74 pTail->pDirt
19180 79 20 3d 20 70 42 3b 0a 20 20 7d 65 6c 73 65 7b y = pB;. }else{
19190 0a 20 20 20 20 70 54 61 69 6c 2d 3e 70 44 69 72 . pTail->pDir
191a0 74 79 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 ty = 0;. }. re
191b0 74 75 72 6e 20 72 65 73 75 6c 74 2e 70 44 69 72 turn result.pDir
191c0 74 79 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 6f 72 ty;.}../*.** Sor
191d0 74 20 74 68 65 20 6c 69 73 74 20 6f 66 20 70 61 t the list of pa
191e0 67 65 73 20 69 6e 20 61 63 63 65 6e 64 69 6e 67 ges in accending
191f0 20 6f 72 64 65 72 20 62 79 20 70 67 6e 6f 2e 20 order by pgno.
19200 20 50 61 67 65 73 20 61 72 65 0a 2a 2a 20 63 6f Pages are.** co
19210 6e 6e 65 63 74 65 64 20 62 79 20 70 44 69 72 74 nnected by pDirt
19220 79 20 70 6f 69 6e 74 65 72 73 2e 20 20 54 68 65 y pointers. The
19230 20 70 50 72 65 76 44 69 72 74 79 20 70 6f 69 6e pPrevDirty poin
19240 74 65 72 73 20 61 72 65 0a 2a 2a 20 63 6f 72 72 ters are.** corr
19250 75 70 74 65 64 20 62 79 20 74 68 69 73 20 73 6f upted by this so
19260 72 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4e rt..*/.#define N
19270 5f 53 4f 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c _SORT_BUCKET_ALL
19280 4f 43 20 32 35 0a 23 64 65 66 69 6e 65 20 4e 5f OC 25.#define N_
19290 53 4f 52 54 5f 42 55 43 4b 45 54 20 20 20 20 20 SORT_BUCKET
192a0 20 20 32 35 0a 23 69 66 64 65 66 20 53 51 4c 49 25.#ifdef SQLI
192b0 54 45 5f 54 45 53 54 0a 20 20 69 6e 74 20 73 71 TE_TEST. int sq
192c0 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e 5f 73 6f lite3_pager_n_so
192d0 72 74 5f 62 75 63 6b 65 74 20 3d 20 30 3b 0a 20 rt_bucket = 0;.
192e0 20 23 75 6e 64 65 66 20 4e 5f 53 4f 52 54 5f 42 #undef N_SORT_B
192f0 55 43 4b 45 54 0a 20 20 23 64 65 66 69 6e 65 20 UCKET. #define
19300 4e 5f 53 4f 52 54 5f 42 55 43 4b 45 54 20 5c 0a N_SORT_BUCKET \.
19310 20 20 20 28 73 71 6c 69 74 65 33 5f 70 61 67 65 (sqlite3_page
19320 72 5f 6e 5f 73 6f 72 74 5f 62 75 63 6b 65 74 3f r_n_sort_bucket?
19330 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 6e 5f sqlite3_pager_n_
19340 73 6f 72 74 5f 62 75 63 6b 65 74 3a 4e 5f 53 4f sort_bucket:N_SO
19350 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c 4f 43 29 RT_BUCKET_ALLOC)
19360 0a 23 65 6e 64 69 66 0a 73 74 61 74 69 63 20 50 .#endif.static P
19370 67 48 64 72 20 2a 73 6f 72 74 5f 70 61 67 65 6c gHdr *sort_pagel
19380 69 73 74 28 50 67 48 64 72 20 2a 70 49 6e 29 7b ist(PgHdr *pIn){
19390 0a 20 20 50 67 48 64 72 20 2a 61 5b 4e 5f 53 4f . PgHdr *a[N_SO
193a0 52 54 5f 42 55 43 4b 45 54 5f 41 4c 4c 4f 43 5d RT_BUCKET_ALLOC]
193b0 2c 20 2a 70 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 , *p;. int i;.
193c0 20 6d 65 6d 73 65 74 28 61 2c 20 30 2c 20 73 69 memset(a, 0, si
193d0 7a 65 6f 66 28 61 29 29 3b 0a 20 20 77 68 69 6c zeof(a));. whil
193e0 65 28 20 70 49 6e 20 29 7b 0a 20 20 20 20 70 20 e( pIn ){. p
193f0 3d 20 70 49 6e 3b 0a 20 20 20 20 70 49 6e 20 3d = pIn;. pIn =
19400 20 70 2d 3e 70 44 69 72 74 79 3b 0a 20 20 20 20 p->pDirty;.
19410 70 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 p->pDirty = 0;.
19420 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 4e 5f for(i=0; i<N_
19430 53 4f 52 54 5f 42 55 43 4b 45 54 2d 31 3b 20 69 SORT_BUCKET-1; i
19440 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 61 ++){. if( a
19450 5b 69 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 [i]==0 ){.
19460 20 20 61 5b 69 5d 20 3d 20 70 3b 0a 20 20 20 20 a[i] = p;.
19470 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 break;.
19480 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
19490 70 20 3d 20 6d 65 72 67 65 5f 70 61 67 65 6c 69 p = merge_pageli
194a0 73 74 28 61 5b 69 5d 2c 20 70 29 3b 0a 20 20 20 st(a[i], p);.
194b0 20 20 20 20 20 61 5b 69 5d 20 3d 20 30 3b 0a 20 a[i] = 0;.
194c0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
194d0 20 69 66 28 20 69 3d 3d 4e 5f 53 4f 52 54 5f 42 if( i==N_SORT_B
194e0 55 43 4b 45 54 2d 31 20 29 7b 0a 20 20 20 20 20 UCKET-1 ){.
194f0 20 2f 2a 20 43 6f 76 65 72 61 67 65 3a 20 54 6f /* Coverage: To
19500 20 67 65 74 20 68 65 72 65 2c 20 74 68 65 72 65 get here, there
19510 20 6e 65 65 64 20 74 6f 20 62 65 20 32 5e 28 4e need to be 2^(N
19520 5f 53 4f 52 54 5f 42 55 43 4b 45 54 29 20 0a 20 _SORT_BUCKET) .
19530 20 20 20 20 20 2a 2a 20 65 6c 65 6d 65 6e 74 73 ** elements
19540 20 69 6e 20 74 68 65 20 69 6e 70 75 74 20 6c 69 in the input li
19550 73 74 2e 20 54 68 69 73 20 69 73 20 70 6f 73 73 st. This is poss
19560 69 62 6c 65 2c 20 62 75 74 20 69 6d 70 72 61 63 ible, but imprac
19570 74 69 63 61 6c 2e 0a 20 20 20 20 20 20 2a 2a 20 tical.. **
19580 54 65 73 74 69 6e 67 20 74 68 69 73 20 6c 69 6e Testing this lin
19590 65 20 69 73 20 74 68 65 20 70 6f 69 6e 74 20 6f e is the point o
195a0 66 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c f global variabl
195b0 65 0a 20 20 20 20 20 20 2a 2a 20 73 71 6c 69 74 e. ** sqlit
195c0 65 33 5f 70 61 67 65 72 5f 6e 5f 73 6f 72 74 5f e3_pager_n_sort_
195d0 62 75 63 6b 65 74 2e 0a 20 20 20 20 20 20 2a 2f bucket.. */
195e0 0a 20 20 20 20 20 20 61 5b 69 5d 20 3d 20 6d 65 . a[i] = me
195f0 72 67 65 5f 70 61 67 65 6c 69 73 74 28 61 5b 69 rge_pagelist(a[i
19600 5d 2c 20 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d ], p);. }. }
19610 0a 20 20 70 20 3d 20 61 5b 30 5d 3b 0a 20 20 66 . p = a[0];. f
19620 6f 72 28 69 3d 31 3b 20 69 3c 4e 5f 53 4f 52 54 or(i=1; i<N_SORT
19630 5f 42 55 43 4b 45 54 3b 20 69 2b 2b 29 7b 0a 20 _BUCKET; i++){.
19640 20 20 20 70 20 3d 20 6d 65 72 67 65 5f 70 61 67 p = merge_pag
19650 65 6c 69 73 74 28 70 2c 20 61 5b 69 5d 29 3b 0a elist(p, a[i]);.
19660 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 3b 0a }. return p;.
19670 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 6e 20 61 }../*.** Given a
19680 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20 28 list of pages (
19690 63 6f 6e 6e 65 63 74 65 64 20 62 79 20 74 68 65 connected by the
196a0 20 50 67 48 64 72 2e 70 44 69 72 74 79 20 70 6f PgHdr.pDirty po
196b0 69 6e 74 65 72 29 20 77 72 69 74 65 0a 2a 2a 20 inter) write.**
196c0 65 76 65 72 79 20 6f 6e 65 20 6f 66 20 74 68 6f every one of tho
196d0 73 65 20 70 61 67 65 73 20 6f 75 74 20 74 6f 20 se pages out to
196e0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
196f0 65 20 61 6e 64 20 6d 61 72 6b 20 74 68 65 6d 20 e and mark them
19700 61 6c 6c 0a 2a 2a 20 61 73 20 63 6c 65 61 6e 2e all.** as clean.
19710 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
19720 61 67 65 72 5f 77 72 69 74 65 5f 70 61 67 65 6c ager_write_pagel
19730 69 73 74 28 50 67 48 64 72 20 2a 70 4c 69 73 74 ist(PgHdr *pList
19740 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 ){. Pager *pPag
19750 65 72 3b 0a 20 20 50 67 48 64 72 20 2a 70 3b 0a er;. PgHdr *p;.
19760 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 69 66 28 int rc;.. if(
19770 20 70 4c 69 73 74 3d 3d 30 20 29 20 72 65 74 75 pList==0 ) retu
19780 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
19790 70 50 61 67 65 72 20 3d 20 70 4c 69 73 74 2d 3e pPager = pList->
197a0 70 50 61 67 65 72 3b 0a 0a 20 20 2f 2a 20 41 74 pPager;.. /* At
197b0 20 74 68 69 73 20 70 6f 69 6e 74 20 74 68 65 72 this point ther
197c0 65 20 6d 61 79 20 62 65 20 65 69 74 68 65 72 20 e may be either
197d0 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 58 a RESERVED or EX
197e0 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 CLUSIVE lock on
197f0 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 the. ** databas
19800 65 20 66 69 6c 65 2e 20 49 66 20 74 68 65 72 65 e file. If there
19810 20 69 73 20 61 6c 72 65 61 64 79 20 61 6e 20 45 is already an E
19820 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2c 20 74 XCLUSIVE lock, t
19830 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 2a he following. *
19840 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 * calls to sqlit
19850 65 33 4f 73 4c 6f 63 6b 28 29 20 61 72 65 20 6e e3OsLock() are n
19860 6f 2d 6f 70 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a o-ops.. **. **
19870 20 4d 6f 76 69 6e 67 20 74 68 65 20 6c 6f 63 6b Moving the lock
19880 20 66 72 6f 6d 20 52 45 53 45 52 56 45 44 20 74 from RESERVED t
19890 6f 20 45 58 43 4c 55 53 49 56 45 20 61 63 74 75 o EXCLUSIVE actu
198a0 61 6c 6c 79 20 69 6e 76 6f 6c 76 65 73 20 67 6f ally involves go
198b0 69 6e 67 0a 20 20 2a 2a 20 74 68 72 6f 75 67 68 ing. ** through
198c0 20 61 6e 20 69 6e 74 65 72 6d 65 64 69 61 74 65 an intermediate
198d0 20 73 74 61 74 65 20 50 45 4e 44 49 4e 47 2e 20 state PENDING.
198e0 20 20 41 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b A PENDING lock
198f0 20 70 72 65 76 65 6e 74 73 20 6e 65 77 0a 20 20 prevents new.
19900 2a 2a 20 72 65 61 64 65 72 73 20 66 72 6f 6d 20 ** readers from
19910 61 74 74 61 63 68 69 6e 67 20 74 6f 20 74 68 65 attaching to the
19920 20 64 61 74 61 62 61 73 65 20 62 75 74 20 69 73 database but is
19930 20 75 6e 73 75 66 66 69 63 69 65 6e 74 20 66 6f unsufficient fo
19940 72 20 75 73 20 74 6f 0a 20 20 2a 2a 20 77 72 69 r us to. ** wri
19950 74 65 2e 20 20 54 68 65 20 69 64 65 61 20 6f 66 te. The idea of
19960 20 61 20 50 45 4e 44 49 4e 47 20 6c 6f 63 6b 20 a PENDING lock
19970 69 73 20 74 6f 20 70 72 65 76 65 6e 74 20 6e 65 is to prevent ne
19980 77 20 72 65 61 64 65 72 73 20 66 72 6f 6d 0a 20 w readers from.
19990 20 2a 2a 20 63 6f 6d 69 6e 67 20 69 6e 20 77 68 ** coming in wh
199a0 69 6c 65 20 77 65 20 77 61 69 74 20 66 6f 72 20 ile we wait for
199b0 65 78 69 73 74 69 6e 67 20 72 65 61 64 65 72 73 existing readers
199c0 20 74 6f 20 63 6c 65 61 72 2e 0a 20 20 2a 2a 0a to clear.. **.
199d0 20 20 2a 2a 20 57 68 69 6c 65 20 74 68 65 20 70 ** While the p
199e0 61 67 65 72 20 69 73 20 69 6e 20 74 68 65 20 52 ager is in the R
199f0 45 53 45 52 56 45 44 20 73 74 61 74 65 2c 20 74 ESERVED state, t
19a00 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 74 61 he original data
19a10 62 61 73 65 20 66 69 6c 65 0a 20 20 2a 2a 20 69 base file. ** i
19a20 73 20 75 6e 63 68 61 6e 67 65 64 20 61 6e 64 20 s unchanged and
19a30 77 65 20 63 61 6e 20 72 6f 6c 6c 62 61 63 6b 20 we can rollback
19a40 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74 without having t
19a50 6f 20 70 6c 61 79 62 61 63 6b 20 74 68 65 0a 20 o playback the.
19a60 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 69 6e 74 6f ** journal into
19a70 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 61 the original da
19a80 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 4f 6e tabase file. On
19a90 63 65 20 77 65 20 74 72 61 6e 73 69 74 69 6f 6e ce we transition
19aa0 20 74 6f 0a 20 20 2a 2a 20 45 58 43 4c 55 53 49 to. ** EXCLUSI
19ab0 56 45 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 65 VE, it means the
19ac0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 database file h
19ad0 61 73 20 62 65 65 6e 20 63 68 61 6e 67 65 64 20 as been changed
19ae0 61 6e 64 20 61 6e 79 20 72 6f 6c 6c 62 61 63 6b and any rollback
19af0 0a 20 20 2a 2a 20 77 69 6c 6c 20 72 65 71 75 69 . ** will requi
19b00 72 65 20 61 20 6a 6f 75 72 6e 61 6c 20 70 6c 61 re a journal pla
19b10 79 62 61 63 6b 2e 0a 20 20 2a 2f 0a 20 20 72 63 yback.. */. rc
19b20 20 3d 20 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e = pager_wait_on
19b30 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c 20 45 58 _lock(pPager, EX
19b40 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 CLUSIVE_LOCK);.
19b50 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
19b60 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
19b70 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 70 4c 69 73 rc;. }.. pLis
19b80 74 20 3d 20 73 6f 72 74 5f 70 61 67 65 6c 69 73 t = sort_pagelis
19b90 74 28 70 4c 69 73 74 29 3b 0a 20 20 66 6f 72 28 t(pList);. for(
19ba0 70 3d 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 2d p=pList; p; p=p-
19bb0 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 61 73 >pDirty){. as
19bc0 73 65 72 74 28 20 70 2d 3e 64 69 72 74 79 20 29 sert( p->dirty )
19bd0 3b 0a 20 20 20 20 70 2d 3e 64 69 72 74 79 20 3d ;. p->dirty =
19be0 20 30 3b 0a 20 20 7d 0a 20 20 77 68 69 6c 65 28 0;. }. while(
19bf0 20 70 4c 69 73 74 20 29 7b 0a 0a 20 20 20 20 2f pList ){.. /
19c00 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 68 61 * If the file ha
19c10 73 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6f s not yet been o
19c20 70 65 6e 65 64 2c 20 6f 70 65 6e 20 69 74 20 6e pened, open it n
19c30 6f 77 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 ow. */. if( !
19c40 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 pPager->fd->pMet
19c50 68 6f 64 73 20 29 7b 0a 20 20 20 20 20 20 61 73 hods ){. as
19c60 73 65 72 74 28 70 50 61 67 65 72 2d 3e 74 65 6d sert(pPager->tem
19c70 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 72 63 pFile);. rc
19c80 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4f = sqlite3PagerO
19c90 70 65 6e 74 65 6d 70 28 70 50 61 67 65 72 2d 3e pentemp(pPager->
19ca0 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 66 64 pVfs, pPager->fd
19cb0 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e , pPager->zFilen
19cc0 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ame,.
19cd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19ce0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 76 66 73 pPager->vfs
19cf0 46 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 69 66 Flags);. if
19d00 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 ( rc ) return rc
19d10 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
19d20 49 66 20 74 68 65 72 65 20 61 72 65 20 64 69 72 If there are dir
19d30 74 79 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 ty pages in the
19d40 70 61 67 65 20 63 61 63 68 65 20 77 69 74 68 20 page cache with
19d50 70 61 67 65 20 6e 75 6d 62 65 72 73 20 67 72 65 page numbers gre
19d60 61 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e ater. ** than
19d70 20 50 61 67 65 72 2e 64 62 53 69 7a 65 2c 20 74 Pager.dbSize, t
19d80 68 69 73 20 6d 65 61 6e 73 20 73 71 6c 69 74 65 his means sqlite
19d90 33 50 61 67 65 72 54 72 75 6e 63 61 74 65 28 29 3PagerTruncate()
19da0 20 77 61 73 20 63 61 6c 6c 65 64 20 74 6f 0a 20 was called to.
19db0 20 20 20 2a 2a 20 6d 61 6b 65 20 74 68 65 20 66 ** make the f
19dc0 69 6c 65 20 73 6d 61 6c 6c 65 72 20 28 70 72 65 ile smaller (pre
19dd0 73 75 6d 61 62 6c 79 20 62 79 20 61 75 74 6f 2d sumably by auto-
19de0 76 61 63 75 75 6d 20 63 6f 64 65 29 2e 20 44 6f vacuum code). Do
19df0 20 6e 6f 74 20 77 72 69 74 65 0a 20 20 20 20 2a not write. *
19e00 2a 20 61 6e 79 20 73 75 63 68 20 70 61 67 65 73 * any such pages
19e10 20 74 6f 20 74 68 65 20 66 69 6c 65 2e 0a 20 20 to the file..
19e20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 4c 69 */. if( pLi
19e30 73 74 2d 3e 70 67 6e 6f 3c 3d 70 50 61 67 65 72 st->pgno<=pPager
19e40 2d 3e 64 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 ->dbSize ){.
19e50 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d 20 28 i64 offset = (
19e60 70 4c 69 73 74 2d 3e 70 67 6e 6f 2d 31 29 2a 28 pList->pgno-1)*(
19e70 69 36 34 29 70 50 61 67 65 72 2d 3e 70 61 67 65 i64)pPager->page
19e80 53 69 7a 65 3b 0a 20 20 20 20 20 20 63 68 61 72 Size;. char
19e90 20 2a 70 44 61 74 61 20 3d 20 43 4f 44 45 43 32 *pData = CODEC2
19ea0 28 70 50 61 67 65 72 2c 20 50 47 48 44 52 5f 54 (pPager, PGHDR_T
19eb0 4f 5f 44 41 54 41 28 70 4c 69 73 74 29 2c 20 70 O_DATA(pList), p
19ec0 4c 69 73 74 2d 3e 70 67 6e 6f 2c 20 36 29 3b 0a List->pgno, 6);.
19ed0 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45 PAGERTRACE
19ee0 34 28 22 53 54 4f 52 45 20 25 64 20 70 61 67 65 4("STORE %d page
19ef0 20 25 64 20 68 61 73 68 28 25 30 38 78 29 5c 6e %d hash(%08x)\n
19f00 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
19f10 20 20 20 20 20 20 50 41 47 45 52 49 44 28 70 50 PAGERID(pP
19f20 61 67 65 72 29 2c 20 70 4c 69 73 74 2d 3e 70 67 ager), pList->pg
19f30 6e 6f 2c 20 70 61 67 65 72 5f 70 61 67 65 68 61 no, pager_pageha
19f40 73 68 28 70 4c 69 73 74 29 29 3b 0a 20 20 20 20 sh(pList));.
19f50 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 4f 55 IOTRACE(("PGOU
19f60 54 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 T %p %d\n", pPag
19f70 65 72 2c 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 29 er, pList->pgno)
19f80 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
19f90 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
19fa0 67 65 72 2d 3e 66 64 2c 20 70 44 61 74 61 2c 20 ger->fd, pData,
19fb0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
19fc0 2c 20 6f 66 66 73 65 74 29 3b 0a 20 20 20 20 20 , offset);.
19fd0 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 6c 69 PAGER_INCR(sqli
19fe0 74 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 64 te3_pager_writed
19ff0 62 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 20 20 b_count);.
1a000 50 41 47 45 52 5f 49 4e 43 52 28 70 50 61 67 65 PAGER_INCR(pPage
1a010 72 2d 3e 6e 57 72 69 74 65 29 3b 0a 20 20 20 20 r->nWrite);.
1a020 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 70 67 6e if( pList->pgn
1a030 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 o==1 ){.
1a040 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e memcpy(&pPager->
1a050 64 62 46 69 6c 65 56 65 72 73 2c 20 26 70 44 61 dbFileVers, &pDa
1a060 74 61 5b 32 34 5d 2c 20 73 69 7a 65 6f 66 28 70 ta[24], sizeof(p
1a070 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 Pager->dbFileVer
1a080 73 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 s));. }.
1a090 20 7d 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 }.#ifndef NDEBU
1a0a0 47 0a 20 20 20 20 65 6c 73 65 7b 0a 20 20 20 20 G. else{.
1a0b0 20 20 50 41 47 45 52 54 52 41 43 45 33 28 22 4e PAGERTRACE3("N
1a0c0 4f 53 54 4f 52 45 20 25 64 20 70 61 67 65 20 25 OSTORE %d page %
1a0d0 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 d\n", PAGERID(pP
1a0e0 61 67 65 72 29 2c 20 70 4c 69 73 74 2d 3e 70 67 ager), pList->pg
1a0f0 6e 6f 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 no);. }.#endi
1a100 66 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 f. if( rc ) r
1a110 65 74 75 72 6e 20 72 63 3b 0a 23 69 66 64 65 66 eturn rc;.#ifdef
1a120 20 53 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 SQLITE_CHECK_PA
1a130 47 45 53 0a 20 20 20 20 70 4c 69 73 74 2d 3e 70 GES. pList->p
1a140 61 67 65 48 61 73 68 20 3d 20 70 61 67 65 72 5f ageHash = pager_
1a150 70 61 67 65 68 61 73 68 28 70 4c 69 73 74 29 3b pagehash(pList);
1a160 0a 23 65 6e 64 69 66 0a 20 20 20 20 70 4c 69 73 .#endif. pLis
1a170 74 20 3d 20 70 4c 69 73 74 2d 3e 70 44 69 72 74 t = pList->pDirt
1a180 79 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 y;. }. return
1a190 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
1a1a0 0a 2a 2a 20 43 6f 6c 6c 65 63 74 20 65 76 65 72 .** Collect ever
1a1b0 79 20 64 69 72 74 79 20 70 61 67 65 20 69 6e 74 y dirty page int
1a1c0 6f 20 61 20 64 69 72 74 79 20 6c 69 73 74 20 61 o a dirty list a
1a1d0 6e 64 0a 2a 2a 20 72 65 74 75 72 6e 20 61 20 70 nd.** return a p
1a1e0 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 68 65 ointer to the he
1a1f0 61 64 20 6f 66 20 74 68 61 74 20 6c 69 73 74 2e ad of that list.
1a200 20 20 41 6c 6c 20 70 61 67 65 73 20 61 72 65 0a All pages are.
1a210 2a 2a 20 63 6f 6c 6c 65 63 74 65 64 20 65 76 65 ** collected eve
1a220 6e 20 69 66 20 74 68 65 79 20 61 72 65 20 73 74 n if they are st
1a230 69 6c 6c 20 69 6e 20 75 73 65 2e 0a 2a 2f 0a 73 ill in use..*/.s
1a240 74 61 74 69 63 20 50 67 48 64 72 20 2a 70 61 67 tatic PgHdr *pag
1a250 65 72 5f 67 65 74 5f 61 6c 6c 5f 64 69 72 74 79 er_get_all_dirty
1a260 5f 70 61 67 65 73 28 50 61 67 65 72 20 2a 70 50 _pages(Pager *pP
1a270 61 67 65 72 29 7b 0a 0a 23 69 66 6e 64 65 66 20 ager){..#ifndef
1a280 4e 44 45 42 55 47 0a 20 20 2f 2a 20 56 65 72 69 NDEBUG. /* Veri
1a290 66 79 20 74 68 65 20 73 61 6e 69 74 79 20 6f 66 fy the sanity of
1a2a0 20 74 68 65 20 64 69 72 74 79 20 6c 69 73 74 20 the dirty list
1a2b0 77 68 65 6e 20 77 65 20 61 72 65 20 72 75 6e 6e when we are runn
1a2c0 69 6e 67 0a 20 20 2a 2a 20 69 6e 20 64 65 62 75 ing. ** in debu
1a2d0 67 67 69 6e 67 20 6d 6f 64 65 2e 20 20 54 68 69 gging mode. Thi
1a2e0 73 20 69 73 20 65 78 70 65 6e 73 69 76 65 2c 20 s is expensive,
1a2f0 73 6f 20 64 6f 20 6e 6f 74 0a 20 20 2a 2a 20 64 so do not. ** d
1a300 6f 20 74 68 69 73 20 6f 6e 20 61 20 6e 6f 72 6d o this on a norm
1a310 61 6c 20 62 75 69 6c 64 2e 20 2a 2f 0a 20 20 69 al build. */. i
1a320 6e 74 20 6e 31 20 3d 20 30 3b 0a 20 20 69 6e 74 nt n1 = 0;. int
1a330 20 6e 32 20 3d 20 30 3b 0a 20 20 50 67 48 64 72 n2 = 0;. PgHdr
1a340 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 70 50 61 *p;. for(p=pPa
1a350 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 3b 20 70 3d ger->pAll; p; p=
1a360 70 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 20 69 66 p->pNextAll){ if
1a370 28 20 70 2d 3e 64 69 72 74 79 20 29 20 6e 31 2b ( p->dirty ) n1+
1a380 2b 3b 20 7d 0a 20 20 66 6f 72 28 70 3d 70 50 61 +; }. for(p=pPa
1a390 67 65 72 2d 3e 70 44 69 72 74 79 3b 20 70 3b 20 ger->pDirty; p;
1a3a0 70 3d 70 2d 3e 70 44 69 72 74 79 29 7b 20 6e 32 p=p->pDirty){ n2
1a3b0 2b 2b 3b 20 7d 0a 20 20 61 73 73 65 72 74 28 20 ++; }. assert(
1a3c0 6e 31 3d 3d 6e 32 20 29 3b 0a 23 65 6e 64 69 66 n1==n2 );.#endif
1a3d0 0a 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 .. return pPage
1a3e0 72 2d 3e 70 44 69 72 74 79 3b 0a 7d 0a 0a 2f 2a r->pDirty;.}../*
1a3f0 0a 2a 2a 20 52 65 74 75 72 6e 20 31 20 69 66 20 .** Return 1 if
1a400 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a there is a hot j
1a410 6f 75 72 6e 61 6c 20 6f 6e 20 74 68 65 20 67 69 ournal on the gi
1a420 76 65 6e 20 70 61 67 65 72 2e 0a 2a 2a 20 41 20 ven pager..** A
1a430 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 69 73 20 6f hot journal is o
1a440 6e 65 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f ne that needs to
1a450 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 6b 2e be played back.
1a460 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 63 75 .**.** If the cu
1a470 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 20 74 68 rrent size of th
1a480 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
1a490 69 73 20 30 20 62 75 74 20 61 20 6a 6f 75 72 6e is 0 but a journ
1a4a0 61 6c 20 66 69 6c 65 0a 2a 2a 20 65 78 69 73 74 al file.** exist
1a4b0 73 2c 20 74 68 61 74 20 69 73 20 70 72 6f 62 61 s, that is proba
1a4c0 62 6c 79 20 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e bly an old journ
1a4d0 61 6c 20 6c 65 66 74 20 6f 76 65 72 20 66 72 6f al left over fro
1a4e0 6d 20 61 20 70 72 69 6f 72 0a 2a 2a 20 64 61 74 m a prior.** dat
1a4f0 61 62 61 73 65 20 77 69 74 68 20 74 68 65 20 73 abase with the s
1a500 61 6d 65 20 6e 61 6d 65 2e 20 20 4a 75 73 74 20 ame name. Just
1a510 64 65 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 6e delete the journ
1a520 61 6c 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e al..**.** Return
1a530 20 6e 65 67 61 74 69 76 65 20 69 66 20 75 6e 61 negative if una
1a540 62 6c 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 ble to determine
1a550 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 74 the status of t
1a560 68 65 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 73 he journal..*/.s
1a570 74 61 74 69 63 20 69 6e 74 20 68 61 73 48 6f 74 tatic int hasHot
1a580 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 Journal(Pager *p
1a590 50 61 67 65 72 29 7b 0a 20 20 73 71 6c 69 74 65 Pager){. sqlite
1a5a0 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 70 50 3_vfs *pVfs = pP
1a5b0 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 69 6e ager->pVfs;. in
1a5c0 74 20 72 63 3b 0a 20 20 69 66 28 20 21 70 50 61 t rc;. if( !pPa
1a5d0 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 ger->useJournal
1a5e0 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 69 66 ) return 0;. if
1a5f0 28 20 21 70 50 61 67 65 72 2d 3e 66 64 2d 3e 70 ( !pPager->fd->p
1a600 4d 65 74 68 6f 64 73 20 29 20 72 65 74 75 72 6e Methods ) return
1a610 20 30 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 0;. rc = sqlit
1a620 65 33 4f 73 41 63 63 65 73 73 28 70 56 66 73 2c e3OsAccess(pVfs,
1a630 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 pPager->zJourna
1a640 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 l, SQLITE_ACCESS
1a650 5f 45 58 49 53 54 53 29 3b 0a 20 20 69 66 28 20 _EXISTS);. if(
1a660 72 63 3c 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 rc<=0 ){. ret
1a670 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 69 66 urn rc;. }. if
1a680 28 20 73 71 6c 69 74 65 33 4f 73 43 68 65 63 6b ( sqlite3OsCheck
1a690 52 65 73 65 72 76 65 64 4c 6f 63 6b 28 70 50 61 ReservedLock(pPa
1a6a0 67 65 72 2d 3e 66 64 29 20 29 7b 0a 20 20 20 20 ger->fd) ){.
1a6b0 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 return 0;. }.
1a6c0 69 66 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 if( sqlite3Pager
1a6d0 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 65 72 Pagecount(pPager
1a6e0 29 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 )==0 ){. sqli
1a6f0 74 65 33 4f 73 44 65 6c 65 74 65 28 70 56 66 73 te3OsDelete(pVfs
1a700 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e , pPager->zJourn
1a710 61 6c 2c 20 30 29 3b 0a 20 20 20 20 72 65 74 75 al, 0);. retu
1a720 72 6e 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 rn 0;. }else{.
1a730 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d return 1;. }
1a740 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f .}../*.** Try to
1a750 20 66 69 6e 64 20 61 20 70 61 67 65 20 69 6e 20 find a page in
1a760 74 68 65 20 63 61 63 68 65 20 74 68 61 74 20 63 the cache that c
1a770 61 6e 20 62 65 20 72 65 63 79 63 6c 65 64 2e 20 an be recycled.
1a780 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 .**.** This rout
1a790 69 6e 65 20 6d 61 79 20 72 65 74 75 72 6e 20 53 ine may return S
1a7a0 51 4c 49 54 45 5f 49 4f 45 52 52 2c 20 53 51 4c QLITE_IOERR, SQL
1a7b0 49 54 45 5f 46 55 4c 4c 20 6f 72 20 53 51 4c 49 ITE_FULL or SQLI
1a7c0 54 45 5f 4f 4b 2e 20 49 74 20 0a 2a 2a 20 64 6f TE_OK. It .** do
1a7d0 65 73 20 6e 6f 74 20 73 65 74 20 74 68 65 20 70 es not set the p
1a7e0 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 76 Pager->errCode v
1a7f0 61 72 69 61 62 6c 65 2e 0a 2a 2f 0a 73 74 61 74 ariable..*/.stat
1a800 69 63 20 69 6e 74 20 70 61 67 65 72 5f 72 65 63 ic int pager_rec
1a810 79 63 6c 65 28 50 61 67 65 72 20 2a 70 50 61 67 ycle(Pager *pPag
1a820 65 72 2c 20 50 67 48 64 72 20 2a 2a 70 70 50 67 er, PgHdr **ppPg
1a830 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b ){. PgHdr *pPg;
1a840 0a 20 20 2a 70 70 50 67 20 3d 20 30 3b 0a 0a 20 . *ppPg = 0;..
1a850 20 2f 2a 20 49 74 20 69 73 20 69 6c 6c 65 67 61 /* It is illega
1a860 6c 20 74 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 l to call this f
1a870 75 6e 63 74 69 6f 6e 20 75 6e 6c 65 73 73 20 74 unction unless t
1a880 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 0a he pager object.
1a890 20 20 2a 2a 20 70 6f 69 6e 74 65 64 20 74 6f 20 ** pointed to
1a8a0 62 79 20 70 50 61 67 65 72 20 68 61 73 20 61 74 by pPager has at
1a8b0 20 6c 65 61 73 74 20 6f 6e 65 20 66 72 65 65 20 least one free
1a8c0 70 61 67 65 20 28 70 61 67 65 20 77 69 74 68 20 page (page with
1a8d0 6e 52 65 66 3d 3d 30 29 2e 0a 20 20 2a 2f 20 0a nRef==0).. */ .
1a8e0 20 20 61 73 73 65 72 74 28 21 4d 45 4d 44 42 29 assert(!MEMDB)
1a8f0 3b 0a 20 20 61 73 73 65 72 74 28 70 50 61 67 65 ;. assert(pPage
1a900 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 29 3b 0a r->lru.pFirst);.
1a910 0a 20 20 2f 2a 20 46 69 6e 64 20 61 20 70 61 67 . /* Find a pag
1a920 65 20 74 6f 20 72 65 63 79 63 6c 65 2e 20 20 54 e to recycle. T
1a930 72 79 20 74 6f 20 6c 6f 63 61 74 65 20 61 20 70 ry to locate a p
1a940 61 67 65 20 74 68 61 74 20 64 6f 65 73 20 6e 6f age that does no
1a950 74 0a 20 20 2a 2a 20 72 65 71 75 69 72 65 20 75 t. ** require u
1a960 73 20 74 6f 20 64 6f 20 61 6e 20 66 73 79 6e 63 s to do an fsync
1a970 28 29 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61 () on the journa
1a980 6c 2e 0a 20 20 2a 2f 0a 20 20 70 50 67 20 3d 20 l.. */. pPg =
1a990 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72 pPager->lru.pFir
1a9a0 73 74 53 79 6e 63 65 64 3b 0a 0a 20 20 2f 2a 20 stSynced;.. /*
1a9b0 49 66 20 77 65 20 63 6f 75 6c 64 20 6e 6f 74 20 If we could not
1a9c0 66 69 6e 64 20 61 20 70 61 67 65 20 74 68 61 74 find a page that
1a9d0 20 64 6f 65 73 20 6e 6f 74 20 72 65 71 75 69 72 does not requir
1a9e0 65 20 61 6e 20 66 73 79 6e 63 28 29 0a 20 20 2a e an fsync(). *
1a9f0 2a 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c * on the journal
1aa00 20 66 69 6c 65 20 74 68 65 6e 20 66 73 79 6e 63 file then fsync
1aa10 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
1aa20 65 2e 20 20 54 68 69 73 20 69 73 20 61 0a 20 20 e. This is a.
1aa30 2a 2a 20 76 65 72 79 20 73 6c 6f 77 20 6f 70 65 ** very slow ope
1aa40 72 61 74 69 6f 6e 2c 20 73 6f 20 77 65 20 77 6f ration, so we wo
1aa50 72 6b 20 68 61 72 64 20 74 6f 20 61 76 6f 69 64 rk hard to avoid
1aa60 20 69 74 2e 20 20 42 75 74 20 73 6f 6d 65 74 69 it. But someti
1aa70 6d 65 73 0a 20 20 2a 2a 20 69 74 20 63 61 6e 27 mes. ** it can'
1aa80 74 20 62 65 20 68 65 6c 70 65 64 2e 0a 20 20 2a t be helped.. *
1aa90 2f 0a 20 20 69 66 28 20 70 50 67 3d 3d 30 20 26 /. if( pPg==0 &
1aaa0 26 20 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46 & pPager->lru.pF
1aab0 69 72 73 74 29 7b 0a 20 20 20 20 69 6e 74 20 69 irst){. int i
1aac0 44 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 Dc = sqlite3OsDe
1aad0 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
1aae0 69 63 73 28 70 50 61 67 65 72 2d 3e 66 64 29 3b ics(pPager->fd);
1aaf0 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 73 79 . int rc = sy
1ab00 6e 63 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 ncJournal(pPager
1ab10 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30 );. if( rc!=0
1ab20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e ){. return
1ab30 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 rc;. }. i
1ab40 66 28 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c 53 f( pPager->fullS
1ab50 79 6e 63 20 26 26 20 30 3d 3d 28 69 44 63 26 53 ync && 0==(iDc&S
1ab60 51 4c 49 54 45 5f 49 4f 43 41 50 5f 53 41 46 45 QLITE_IOCAP_SAFE
1ab70 5f 41 50 50 45 4e 44 29 20 29 7b 0a 20 20 20 20 _APPEND) ){.
1ab80 20 20 2f 2a 20 49 66 20 69 6e 20 66 75 6c 6c 2d /* If in full-
1ab90 73 79 6e 63 20 6d 6f 64 65 2c 20 77 72 69 74 65 sync mode, write
1aba0 20 61 20 6e 65 77 20 6a 6f 75 72 6e 61 6c 20 68 a new journal h
1abb0 65 61 64 65 72 20 69 6e 74 6f 20 74 68 65 0a 20 eader into the.
1abc0 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 ** journal
1abd0 66 69 6c 65 2e 20 54 68 69 73 20 69 73 20 64 6f file. This is do
1abe0 6e 65 20 74 6f 20 61 76 6f 69 64 20 65 76 65 72 ne to avoid ever
1abf0 20 6d 6f 64 69 66 79 69 6e 67 20 61 20 6a 6f 75 modifying a jou
1ac00 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 68 65 rnal. ** he
1ac10 61 64 65 72 20 74 68 61 74 20 69 73 20 69 6e 76 ader that is inv
1ac20 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 72 6f 6c olved in the rol
1ac30 6c 62 61 63 6b 20 6f 66 20 70 61 67 65 73 20 74 lback of pages t
1ac40 68 61 74 20 68 61 76 65 0a 20 20 20 20 20 20 2a hat have. *
1ac50 2a 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 77 * already been w
1ac60 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 64 61 ritten to the da
1ac70 74 61 62 61 73 65 20 28 69 6e 20 63 61 73 65 20 tabase (in case
1ac80 74 68 65 20 68 65 61 64 65 72 20 69 73 0a 20 20 the header is.
1ac90 20 20 20 20 2a 2a 20 74 72 61 73 68 65 64 20 77 ** trashed w
1aca0 68 65 6e 20 74 68 65 20 6e 52 65 63 20 66 69 65 hen the nRec fie
1acb0 6c 64 20 69 73 20 75 70 64 61 74 65 64 29 2e 0a ld is updated)..
1acc0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 70 */. p
1acd0 50 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b Pager->nRec = 0;
1ace0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
1acf0 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
1ad00 66 20 3e 20 30 20 29 3b 0a 20 20 20 20 20 20 61 f > 0 );. a
1ad10 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 64 ssert( pPager->d
1ad20 6f 4e 6f 74 53 79 6e 63 3d 3d 30 20 29 3b 0a 20 oNotSync==0 );.
1ad30 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 4a rc = writeJ
1ad40 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 ournalHdr(pPager
1ad50 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
1ad60 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 =0 ){. re
1ad70 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 7d turn rc;. }
1ad80 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 67 20 3d . }. pPg =
1ad90 20 70 50 61 67 65 72 2d 3e 6c 72 75 2e 70 46 69 pPager->lru.pFi
1ada0 72 73 74 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 rst;. }.. asse
1adb0 72 74 28 20 70 50 67 2d 3e 6e 52 65 66 3d 3d 30 rt( pPg->nRef==0
1adc0 20 29 3b 0a 0a 20 20 2f 2a 20 57 72 69 74 65 20 );.. /* Write
1add0 74 68 65 20 70 61 67 65 20 74 6f 20 74 68 65 20 the page to the
1ade0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 66 database file if
1adf0 20 69 74 20 69 73 20 64 69 72 74 79 2e 0a 20 20 it is dirty..
1ae00 2a 2f 0a 20 20 69 66 28 20 70 50 67 2d 3e 64 69 */. if( pPg->di
1ae10 72 74 79 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 rty ){. int r
1ae20 63 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 c;. assert( p
1ae30 50 67 2d 3e 6e 65 65 64 53 79 6e 63 3d 3d 30 20 Pg->needSync==0
1ae40 29 3b 0a 20 20 20 20 6d 61 6b 65 43 6c 65 61 6e );. makeClean
1ae50 28 70 50 67 29 3b 0a 20 20 20 20 70 50 67 2d 3e (pPg);. pPg->
1ae60 64 69 72 74 79 20 3d 20 31 3b 0a 20 20 20 20 70 dirty = 1;. p
1ae70 50 67 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a Pg->pDirty = 0;.
1ae80 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 rc = pager_w
1ae90 72 69 74 65 5f 70 61 67 65 6c 69 73 74 28 20 70 rite_pagelist( p
1aea0 50 67 20 29 3b 0a 20 20 20 20 70 50 67 2d 3e 64 Pg );. pPg->d
1aeb0 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 69 66 irty = 0;. if
1aec0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1aed0 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1aee0 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 rc;. }. }.
1aef0 61 73 73 65 72 74 28 20 70 50 67 2d 3e 64 69 72 assert( pPg->dir
1af00 74 79 3d 3d 30 20 29 3b 0a 0a 20 20 2f 2a 20 49 ty==0 );.. /* I
1af10 66 20 74 68 65 20 70 61 67 65 20 77 65 20 61 72 f the page we ar
1af20 65 20 72 65 63 79 63 6c 69 6e 67 20 69 73 20 6d e recycling is m
1af30 61 72 6b 65 64 20 61 73 20 61 6c 77 61 79 73 52 arked as alwaysR
1af40 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 6e 0a 20 20 ollback, then.
1af50 2a 2a 20 73 65 74 20 74 68 65 20 67 6c 6f 62 61 ** set the globa
1af60 6c 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b l alwaysRollback
1af70 20 66 6c 61 67 2c 20 74 68 75 73 20 64 69 73 61 flag, thus disa
1af80 62 6c 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 73 bling the. ** s
1af90 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52 qlite3PagerDontR
1afa0 6f 6c 6c 62 61 63 6b 28 29 20 6f 70 74 69 6d 69 ollback() optimi
1afb0 7a 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 72 zation for the r
1afc0 65 73 74 20 6f 66 20 74 68 69 73 20 74 72 61 6e est of this tran
1afd0 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 49 74 saction.. ** It
1afe0 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 74 6f is necessary to
1aff0 20 64 6f 20 74 68 69 73 20 62 65 63 61 75 73 65 do this because
1b000 20 74 68 65 20 70 61 67 65 20 6d 61 72 6b 65 64 the page marked
1b010 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 0a alwaysRollback.
1b020 20 20 2a 2a 20 6d 69 67 68 74 20 62 65 20 72 65 ** might be re
1b030 6c 6f 61 64 65 64 20 61 74 20 61 20 6c 61 74 65 loaded at a late
1b040 72 20 74 69 6d 65 20 62 75 74 20 61 74 20 74 68 r time but at th
1b050 61 74 20 70 6f 69 6e 74 20 77 65 20 77 6f 6e 27 at point we won'
1b060 74 20 72 65 6d 65 6d 62 65 72 0a 20 20 2a 2a 20 t remember. **
1b070 74 68 61 74 20 69 73 20 77 61 73 20 6d 61 72 6b that is was mark
1b080 65 64 20 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 ed alwaysRollbac
1b090 6b 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 k. This means t
1b0a0 68 61 74 20 61 6c 6c 20 70 61 67 65 73 20 6d 75 hat all pages mu
1b0b0 73 74 0a 20 20 2a 2a 20 62 65 20 6d 61 72 6b 65 st. ** be marke
1b0c0 64 20 61 73 20 61 6c 77 61 79 73 52 6f 6c 6c 62 d as alwaysRollb
1b0d0 61 63 6b 20 66 72 6f 6d 20 68 65 72 65 20 6f 6e ack from here on
1b0e0 20 6f 75 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 out.. */. if(
1b0f0 20 70 50 67 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c pPg->alwaysRoll
1b100 62 61 63 6b 20 29 7b 0a 20 20 20 20 49 4f 54 52 back ){. IOTR
1b110 41 43 45 28 28 22 41 4c 57 41 59 53 5f 52 4f 4c ACE(("ALWAYS_ROL
1b120 4c 42 41 43 4b 20 25 70 5c 6e 22 2c 20 70 50 61 LBACK %p\n", pPa
1b130 67 65 72 29 29 0a 20 20 20 20 70 50 61 67 65 72 ger)). pPager
1b140 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b ->alwaysRollback
1b150 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 = 1;. }.. /*
1b160 55 6e 6c 69 6e 6b 20 74 68 65 20 6f 6c 64 20 70 Unlink the old p
1b170 61 67 65 20 66 72 6f 6d 20 74 68 65 20 66 72 65 age from the fre
1b180 65 20 6c 69 73 74 20 61 6e 64 20 74 68 65 20 68 e list and the h
1b190 61 73 68 20 74 61 62 6c 65 0a 20 20 2a 2f 0a 20 ash table. */.
1b1a0 20 75 6e 6c 69 6e 6b 50 61 67 65 28 70 50 67 29 unlinkPage(pPg)
1b1b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d ;. assert( pPg-
1b1c0 3e 70 67 6e 6f 3d 3d 30 20 29 3b 0a 0a 20 20 2a >pgno==0 );.. *
1b1d0 70 70 50 67 20 3d 20 70 50 67 3b 0a 20 20 72 65 ppPg = pPg;. re
1b1e0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
1b1f0 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 }..#ifdef SQLITE
1b200 5f 45 4e 41 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d _ENABLE_MEMORY_M
1b210 41 4e 41 47 45 4d 45 4e 54 0a 2f 2a 0a 2a 2a 20 ANAGEMENT./*.**
1b220 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
1b230 20 63 61 6c 6c 65 64 20 74 6f 20 66 72 65 65 20 called to free
1b240 73 75 70 65 72 66 6c 75 6f 75 73 20 64 79 6e 61 superfluous dyna
1b250 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 mically allocate
1b260 64 20 6d 65 6d 6f 72 79 0a 2a 2a 20 68 65 6c 64 d memory.** held
1b270 20 62 79 20 74 68 65 20 70 61 67 65 72 20 73 79 by the pager sy
1b280 73 74 65 6d 2e 20 4d 65 6d 6f 72 79 20 69 6e 20 stem. Memory in
1b290 75 73 65 20 62 79 20 61 6e 79 20 53 51 4c 69 74 use by any SQLit
1b2a0 65 20 70 61 67 65 72 20 61 6c 6c 6f 63 61 74 65 e pager allocate
1b2b0 64 0a 2a 2a 20 62 79 20 74 68 65 20 63 75 72 72 d.** by the curr
1b2c0 65 6e 74 20 74 68 72 65 61 64 20 6d 61 79 20 62 ent thread may b
1b2d0 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 29 e sqlite3_free()
1b2e0 65 64 2e 0a 2a 2a 0a 2a 2a 20 6e 52 65 71 20 69 ed..**.** nReq i
1b2f0 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 s the number of
1b300 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 bytes of memory
1b310 72 65 71 75 69 72 65 64 2e 20 4f 6e 63 65 20 74 required. Once t
1b320 68 69 73 20 6d 75 63 68 20 68 61 73 0a 2a 2a 20 his much has.**
1b330 62 65 65 6e 20 72 65 6c 65 61 73 65 64 2c 20 74 been released, t
1b340 68 65 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 he function retu
1b350 72 6e 73 2e 20 54 68 65 20 72 65 74 75 72 6e 20 rns. The return
1b360 76 61 6c 75 65 20 69 73 20 74 68 65 20 74 6f 74 value is the tot
1b370 61 6c 20 6e 75 6d 62 65 72 20 0a 2a 2a 20 6f 66 al number .** of
1b380 20 62 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 bytes of memory
1b390 20 72 65 6c 65 61 73 65 64 2e 0a 2a 2f 0a 69 6e released..*/.in
1b3a0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 t sqlite3PagerRe
1b3b0 6c 65 61 73 65 4d 65 6d 6f 72 79 28 69 6e 74 20 leaseMemory(int
1b3c0 6e 52 65 71 29 7b 0a 20 20 69 6e 74 20 6e 52 65 nReq){. int nRe
1b3d0 6c 65 61 73 65 64 20 3d 20 30 3b 20 20 20 20 20 leased = 0;
1b3e0 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 /* Bytes of
1b3f0 20 6d 65 6d 6f 72 79 20 72 65 6c 65 61 73 65 64 memory released
1b400 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 73 71 6c so far */. sql
1b410 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 ite3_mutex *mute
1b420 78 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 x; /* The
1b430 4d 45 4d 32 20 6d 75 74 65 78 20 2a 2f 0a 20 20 MEM2 mutex */.
1b440 50 61 67 65 72 20 2a 70 50 61 67 65 72 3b 20 20 Pager *pPager;
1b450 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
1b460 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 or looping over
1b470 70 61 67 65 72 73 20 2a 2f 0a 20 20 42 75 73 79 pagers */. Busy
1b480 48 61 6e 64 6c 65 72 20 2a 73 61 76 65 64 42 75 Handler *savedBu
1b490 73 79 3b 20 20 20 20 20 2f 2a 20 53 61 76 65 64 sy; /* Saved
1b4a0 20 63 6f 70 79 20 6f 66 20 74 68 65 20 62 75 73 copy of the bus
1b4b0 79 20 68 61 6e 64 6c 65 72 20 2a 2f 0a 20 20 69 y handler */. i
1b4c0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
1b4d0 4b 3b 0a 0a 20 20 2f 2a 20 41 63 71 75 69 72 65 K;.. /* Acquire
1b4e0 20 74 68 65 20 6d 65 6d 6f 72 79 2d 6d 61 6e 61 the memory-mana
1b4f0 67 65 6d 65 6e 74 20 6d 75 74 65 78 0a 20 20 2a gement mutex. *
1b500 2f 0a 20 20 6d 75 74 65 78 20 3d 20 73 71 6c 69 /. mutex = sqli
1b510 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 te3_mutex_alloc(
1b520 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 SQLITE_MUTEX_STA
1b530 54 49 43 5f 4d 45 4d 32 29 3b 0a 20 20 73 71 6c TIC_MEM2);. sql
1b540 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 ite3_mutex_enter
1b550 28 6d 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 53 (mutex);.. /* S
1b560 69 67 6e 61 6c 20 61 6c 6c 20 64 61 74 61 62 61 ignal all databa
1b570 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 74 se connections t
1b580 68 61 74 20 6d 65 6d 6f 72 79 20 6d 61 6e 61 67 hat memory manag
1b590 65 6d 65 6e 74 20 77 61 6e 74 73 0a 20 20 2a 2a ement wants. **
1b5a0 20 74 6f 20 68 61 76 65 20 61 63 63 65 73 73 20 to have access
1b5b0 74 6f 20 74 68 65 20 70 61 67 65 72 73 2e 0a 20 to the pagers..
1b5c0 20 2a 2f 0a 20 20 66 6f 72 28 70 50 61 67 65 72 */. for(pPager
1b5d0 3d 73 71 6c 69 74 65 33 50 61 67 65 72 4c 69 73 =sqlite3PagerLis
1b5e0 74 3b 20 70 50 61 67 65 72 3b 20 70 50 61 67 65 t; pPager; pPage
1b5f0 72 3d 70 50 61 67 65 72 2d 3e 70 4e 65 78 74 29 r=pPager->pNext)
1b600 7b 0a 20 20 20 20 20 70 50 61 67 65 72 2d 3e 69 {. pPager->i
1b610 49 6e 55 73 65 4d 4d 20 3d 20 31 3b 0a 20 20 7d InUseMM = 1;. }
1b620 0a 0a 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 .. while( rc==S
1b630 51 4c 49 54 45 5f 4f 4b 20 26 26 20 28 6e 52 65 QLITE_OK && (nRe
1b640 71 3c 30 20 7c 7c 20 6e 52 65 6c 65 61 73 65 64 q<0 || nReleased
1b650 3c 6e 52 65 71 29 20 29 7b 0a 20 20 20 20 50 67 <nReq) ){. Pg
1b660 48 64 72 20 2a 70 50 67 3b 0a 20 20 20 20 50 67 Hdr *pPg;. Pg
1b670 48 64 72 20 2a 70 52 65 63 79 63 6c 65 64 3b 0a Hdr *pRecycled;.
1b680 20 0a 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 . /* Try to
1b690 66 69 6e 64 20 61 20 70 61 67 65 20 74 6f 20 72 find a page to r
1b6a0 65 63 79 63 6c 65 20 74 68 61 74 20 64 6f 65 73 ecycle that does
1b6b0 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61 20 73 not require a s
1b6c0 79 6e 63 28 29 2e 20 49 66 0a 20 20 20 20 2a 2a ync(). If. **
1b6d0 20 74 68 69 73 20 69 73 20 6e 6f 74 20 70 6f 73 this is not pos
1b6e0 73 69 62 6c 65 2c 20 66 69 6e 64 20 6f 6e 65 20 sible, find one
1b6f0 74 68 61 74 20 64 6f 65 73 20 72 65 71 75 69 72 that does requir
1b700 65 20 61 20 73 79 6e 63 28 29 2e 0a 20 20 20 20 e a sync()..
1b710 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d */. sqlite3_m
1b720 75 74 65 78 5f 65 6e 74 65 72 28 73 71 6c 69 74 utex_enter(sqlit
1b730 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 e3_mutex_alloc(S
1b740 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
1b750 49 43 5f 4c 52 55 29 29 3b 0a 20 20 20 20 70 50 IC_LRU));. pP
1b760 67 20 3d 20 73 71 6c 69 74 65 33 4c 72 75 50 61 g = sqlite3LruPa
1b770 67 65 4c 69 73 74 2e 70 46 69 72 73 74 53 79 6e geList.pFirstSyn
1b780 63 65 64 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 ced;. while(
1b790 70 50 67 20 26 26 20 28 70 50 67 2d 3e 6e 65 65 pPg && (pPg->nee
1b7a0 64 53 79 6e 63 20 7c 7c 20 70 50 67 2d 3e 70 50 dSync || pPg->pP
1b7b0 61 67 65 72 2d 3e 69 49 6e 55 73 65 44 42 29 20 ager->iInUseDB)
1b7c0 29 7b 0a 20 20 20 20 20 20 70 50 67 20 3d 20 70 ){. pPg = p
1b7d0 50 67 2d 3e 67 66 72 65 65 2e 70 4e 65 78 74 3b Pg->gfree.pNext;
1b7e0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21 . }. if( !
1b7f0 70 50 67 20 29 7b 0a 20 20 20 20 20 20 70 50 67 pPg ){. pPg
1b800 20 3d 20 73 71 6c 69 74 65 33 4c 72 75 50 61 67 = sqlite3LruPag
1b810 65 4c 69 73 74 2e 70 46 69 72 73 74 3b 0a 20 20 eList.pFirst;.
1b820 20 20 20 20 77 68 69 6c 65 28 20 70 50 67 20 26 while( pPg &
1b830 26 20 70 50 67 2d 3e 70 50 61 67 65 72 2d 3e 69 & pPg->pPager->i
1b840 49 6e 55 73 65 44 42 20 29 7b 0a 20 20 20 20 20 InUseDB ){.
1b850 20 20 20 70 50 67 20 3d 20 70 50 67 2d 3e 67 66 pPg = pPg->gf
1b860 72 65 65 2e 70 4e 65 78 74 3b 0a 20 20 20 20 20 ree.pNext;.
1b870 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c }. }. sql
1b880 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 ite3_mutex_leave
1b890 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 (sqlite3_mutex_a
1b8a0 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 lloc(SQLITE_MUTE
1b8b0 58 5f 53 54 41 54 49 43 5f 4c 52 55 29 29 3b 0a X_STATIC_LRU));.
1b8c0 0a 20 20 20 20 2f 2a 20 49 66 20 70 50 67 3d 3d . /* If pPg==
1b8d0 30 2c 20 74 68 65 6e 20 74 68 65 20 62 6c 6f 63 0, then the bloc
1b8e0 6b 20 61 62 6f 76 65 20 68 61 73 20 66 61 69 6c k above has fail
1b8f0 65 64 20 74 6f 20 66 69 6e 64 20 61 20 70 61 67 ed to find a pag
1b900 65 20 74 6f 0a 20 20 20 20 2a 2a 20 72 65 63 79 e to. ** recy
1b910 63 6c 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 cle. In this cas
1b920 65 20 72 65 74 75 72 6e 20 65 61 72 6c 79 20 2d e return early -
1b930 20 6e 6f 20 66 75 72 74 68 65 72 20 6d 65 6d 6f no further memo
1b940 72 79 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 62 ry will. ** b
1b950 65 20 72 65 6c 65 61 73 65 64 2e 0a 20 20 20 20 e released..
1b960 2a 2f 0a 20 20 20 20 69 66 28 20 21 70 50 67 20 */. if( !pPg
1b970 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 70 50 ) break;.. pP
1b980 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
1b990 65 72 3b 0a 20 20 20 20 61 73 73 65 72 74 28 21 er;. assert(!
1b9a0 70 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20 7c 7c pPg->needSync ||
1b9b0 20 70 50 67 3d 3d 70 50 61 67 65 72 2d 3e 6c 72 pPg==pPager->lr
1b9c0 75 2e 70 46 69 72 73 74 29 3b 0a 20 20 20 20 61 u.pFirst);. a
1b9d0 73 73 65 72 74 28 70 50 67 2d 3e 6e 65 65 64 53 ssert(pPg->needS
1b9e0 79 6e 63 20 7c 7c 20 70 50 67 3d 3d 70 50 61 67 ync || pPg==pPag
1b9f0 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 53 79 er->lru.pFirstSy
1ba00 6e 63 65 64 29 3b 0a 20 20 0a 20 20 20 20 73 61 nced);. . sa
1ba10 76 65 64 42 75 73 79 20 3d 20 70 50 61 67 65 72 vedBusy = pPager
1ba20 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a ->pBusyHandler;.
1ba30 20 20 20 20 70 50 61 67 65 72 2d 3e 70 42 75 73 pPager->pBus
1ba40 79 48 61 6e 64 6c 65 72 20 3d 20 30 3b 0a 20 20 yHandler = 0;.
1ba50 20 20 72 63 20 3d 20 70 61 67 65 72 5f 72 65 63 rc = pager_rec
1ba60 79 63 6c 65 28 70 50 61 67 65 72 2c 20 26 70 52 ycle(pPager, &pR
1ba70 65 63 79 63 6c 65 64 29 3b 0a 20 20 20 20 70 50 ecycled);. pP
1ba80 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c ager->pBusyHandl
1ba90 65 72 20 3d 20 73 61 76 65 64 42 75 73 79 3b 0a er = savedBusy;.
1baa0 20 20 20 20 61 73 73 65 72 74 28 70 52 65 63 79 assert(pRecy
1bab0 63 6c 65 64 3d 3d 70 50 67 20 7c 7c 20 72 63 21 cled==pPg || rc!
1bac0 3d 53 51 4c 49 54 45 5f 4f 4b 29 3b 0a 20 20 20 =SQLITE_OK);.
1bad0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1bae0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 57 OK ){. /* W
1baf0 65 27 76 65 20 66 6f 75 6e 64 20 61 20 70 61 67 e've found a pag
1bb00 65 20 74 6f 20 66 72 65 65 2e 20 41 74 20 74 68 e to free. At th
1bb10 69 73 20 70 6f 69 6e 74 20 74 68 65 20 70 61 67 is point the pag
1bb20 65 20 68 61 73 20 62 65 65 6e 20 0a 20 20 20 20 e has been .
1bb30 20 20 2a 2a 20 72 65 6d 6f 76 65 64 20 66 72 6f ** removed fro
1bb40 6d 20 74 68 65 20 70 61 67 65 20 68 61 73 68 2d m the page hash-
1bb50 74 61 62 6c 65 2c 20 66 72 65 65 2d 6c 69 73 74 table, free-list
1bb60 20 61 6e 64 20 73 79 6e 63 65 64 2d 6c 69 73 74 and synced-list
1bb70 20 0a 20 20 20 20 20 20 2a 2a 20 28 70 46 69 72 . ** (pFir
1bb80 73 74 53 79 6e 63 65 64 29 2e 20 49 74 20 69 73 stSynced). It is
1bb90 20 73 74 69 6c 6c 20 69 6e 20 74 68 65 20 61 6c still in the al
1bba0 6c 20 70 61 67 65 73 20 28 70 41 6c 6c 29 20 6c l pages (pAll) l
1bbb0 69 73 74 2e 20 0a 20 20 20 20 20 20 2a 2a 20 52 ist. . ** R
1bbc0 65 6d 6f 76 65 20 69 74 20 66 72 6f 6d 20 74 68 emove it from th
1bbd0 69 73 20 6c 69 73 74 20 62 65 66 6f 72 65 20 66 is list before f
1bbe0 72 65 65 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2a reeing.. **
1bbf0 0a 20 20 20 20 20 20 2a 2a 20 54 6f 64 6f 3a 20 . ** Todo:
1bc00 43 68 65 63 6b 20 74 68 65 20 50 61 67 65 72 2e Check the Pager.
1bc10 70 53 74 6d 74 20 6c 69 73 74 20 74 6f 20 6d 61 pStmt list to ma
1bc20 6b 65 20 73 75 72 65 20 74 68 69 73 20 69 73 20 ke sure this is
1bc30 4f 6b 2e 20 49 74 20 0a 20 20 20 20 20 20 2a 2a Ok. It . **
1bc40 20 70 72 6f 62 61 62 6c 79 20 69 73 20 74 68 6f probably is tho
1bc50 75 67 68 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 ugh.. */.
1bc60 20 20 20 20 50 67 48 64 72 20 2a 70 54 6d 70 3b PgHdr *pTmp;
1bc70 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
1bc80 50 67 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 Pg );. if(
1bc90 70 50 67 3d 3d 70 50 61 67 65 72 2d 3e 70 41 6c pPg==pPager->pAl
1bca0 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 70 50 l ){. pP
1bcb0 61 67 65 72 2d 3e 70 41 6c 6c 20 3d 20 70 50 67 ager->pAll = pPg
1bcc0 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 20 20 ->pNextAll;.
1bcd0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
1bce0 20 66 6f 72 28 20 70 54 6d 70 3d 70 50 61 67 65 for( pTmp=pPage
1bcf0 72 2d 3e 70 41 6c 6c 3b 20 70 54 6d 70 2d 3e 70 r->pAll; pTmp->p
1bd00 4e 65 78 74 41 6c 6c 21 3d 70 50 67 3b 20 70 54 NextAll!=pPg; pT
1bd10 6d 70 3d 70 54 6d 70 2d 3e 70 4e 65 78 74 41 6c mp=pTmp->pNextAl
1bd20 6c 20 29 7b 7d 0a 20 20 20 20 20 20 20 20 70 54 l ){}. pT
1bd30 6d 70 2d 3e 70 4e 65 78 74 41 6c 6c 20 3d 20 70 mp->pNextAll = p
1bd40 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 3b 0a 20 20 Pg->pNextAll;.
1bd50 20 20 20 20 7d 0a 20 20 20 20 20 20 6e 52 65 6c }. nRel
1bd60 65 61 73 65 64 20 2b 3d 20 28 0a 20 20 20 20 20 eased += (.
1bd70 20 20 20 20 20 73 69 7a 65 6f 66 28 2a 70 50 67 sizeof(*pPg
1bd80 29 20 2b 20 70 50 61 67 65 72 2d 3e 70 61 67 65 ) + pPager->page
1bd90 53 69 7a 65 0a 20 20 20 20 20 20 20 20 20 20 2b Size. +
1bda0 20 73 69 7a 65 6f 66 28 75 33 32 29 20 2b 20 70 sizeof(u32) + p
1bdb0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 0a 20 20 Pager->nExtra.
1bdc0 20 20 20 20 20 20 20 20 2b 20 4d 45 4d 44 42 2a + MEMDB*
1bdd0 73 69 7a 65 6f 66 28 50 67 48 69 73 74 6f 72 79 sizeof(PgHistory
1bde0 29 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 ) . );.
1bdf0 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 46 52 IOTRACE(("PGFR
1be00 45 45 20 25 70 20 25 64 20 2a 5c 6e 22 2c 20 70 EE %p %d *\n", p
1be10 50 61 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f Pager, pPg->pgno
1be20 29 29 3b 0a 20 20 20 20 20 20 50 41 47 45 52 5f ));. PAGER_
1be30 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 INCR(sqlite3_pag
1be40 65 72 5f 70 67 66 72 65 65 5f 63 6f 75 6e 74 29 er_pgfree_count)
1be50 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
1be60 66 72 65 65 28 70 50 67 2d 3e 70 44 61 74 61 29 free(pPg->pData)
1be70 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f ;. sqlite3_
1be80 66 72 65 65 28 70 50 67 29 3b 0a 20 20 20 20 20 free(pPg);.
1be90 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 2d 2d pPager->nPage--
1bea0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
1beb0 20 20 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6f /* An error o
1bec0 63 63 75 72 65 64 20 77 68 69 6c 73 74 20 77 72 ccured whilst wr
1bed0 69 74 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 iting to the dat
1bee0 61 62 61 73 65 20 66 69 6c 65 20 6f 72 20 0a 20 abase file or .
1bef0 20 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 ** journal
1bf00 69 6e 20 70 61 67 65 72 5f 72 65 63 79 63 6c 65 in pager_recycle
1bf10 28 29 2e 20 54 68 65 20 65 72 72 6f 72 20 69 73 (). The error is
1bf20 20 6e 6f 74 20 72 65 74 75 72 6e 65 64 20 74 6f not returned to
1bf30 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 63 the . ** c
1bf40 61 6c 6c 65 72 20 6f 66 20 74 68 69 73 20 66 75 aller of this fu
1bf50 6e 63 74 69 6f 6e 2e 20 49 6e 73 74 65 61 64 2c nction. Instead,
1bf60 20 73 65 74 20 74 68 65 20 50 61 67 65 72 2e 65 set the Pager.e
1bf70 72 72 43 6f 64 65 20 76 61 72 69 61 62 6c 65 2e rrCode variable.
1bf80 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 65 72 . ** The er
1bf90 72 6f 72 20 77 69 6c 6c 20 62 65 20 72 65 74 75 ror will be retu
1bfa0 72 6e 65 64 20 74 6f 20 74 68 65 20 75 73 65 72 rned to the user
1bfb0 20 28 6f 72 20 75 73 65 72 73 2c 20 69 6e 20 74 (or users, in t
1bfc0 68 65 20 63 61 73 65 20 0a 20 20 20 20 20 20 2a he case . *
1bfd0 2a 20 6f 66 20 61 20 73 68 61 72 65 64 20 70 61 * of a shared pa
1bfe0 67 65 72 20 63 61 63 68 65 29 20 6f 66 20 74 68 ger cache) of th
1bff0 65 20 70 61 67 65 72 20 66 6f 72 20 77 68 69 63 e pager for whic
1c000 68 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63 75 h the error occu
1c010 72 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 red.. */.
1c020 20 20 20 20 61 73 73 65 72 74 28 0a 20 20 20 20 assert(.
1c030 20 20 20 20 20 20 28 72 63 26 30 78 66 66 29 3d (rc&0xff)=
1c040 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 7c 7c =SQLITE_IOERR ||
1c050 0a 20 20 20 20 20 20 20 20 20 20 72 63 3d 3d 53 . rc==S
1c060 51 4c 49 54 45 5f 46 55 4c 4c 20 7c 7c 0a 20 20 QLITE_FULL ||.
1c070 20 20 20 20 20 20 20 20 72 63 3d 3d 53 51 4c 49 rc==SQLI
1c080 54 45 5f 42 55 53 59 0a 20 20 20 20 20 20 29 3b TE_BUSY. );
1c090 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
1c0a0 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 Pager->state>=PA
1c0b0 47 45 52 5f 52 45 53 45 52 56 45 44 20 29 3b 0a GER_RESERVED );.
1c0c0 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 6f pager_erro
1c0d0 72 28 70 50 61 67 65 72 2c 20 72 63 29 3b 0a 20 r(pPager, rc);.
1c0e0 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 }. }.. /* C
1c0f0 6c 65 61 72 20 74 68 65 20 6d 65 6d 6f 72 79 20 lear the memory
1c100 6d 61 6e 61 67 65 6d 65 6e 74 20 66 6c 61 67 73 management flags
1c110 20 61 6e 64 20 72 65 6c 65 61 73 65 20 74 68 65 and release the
1c120 20 6d 75 74 65 78 0a 20 20 2a 2f 0a 20 20 66 6f mutex. */. fo
1c130 72 28 70 50 61 67 65 72 3d 73 71 6c 69 74 65 33 r(pPager=sqlite3
1c140 50 61 67 65 72 4c 69 73 74 3b 20 70 50 61 67 65 PagerList; pPage
1c150 72 3b 20 70 50 61 67 65 72 3d 70 50 61 67 65 72 r; pPager=pPager
1c160 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 20 70 ->pNext){. p
1c170 50 61 67 65 72 2d 3e 69 49 6e 55 73 65 4d 4d 20 Pager->iInUseMM
1c180 3d 20 30 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 = 0;. }. sqlit
1c190 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d e3_mutex_leave(m
1c1a0 75 74 65 78 29 3b 0a 0a 20 20 2f 2a 20 52 65 74 utex);.. /* Ret
1c1b0 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f urn the number o
1c1c0 66 20 62 79 74 65 73 20 72 65 6c 65 61 73 65 64 f bytes released
1c1d0 0a 20 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 6e . */. return n
1c1e0 52 65 6c 65 61 73 65 64 3b 0a 7d 0a 23 65 6e 64 Released;.}.#end
1c1f0 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 if /* SQLITE_ENA
1c200 42 4c 45 5f 4d 45 4d 4f 52 59 5f 4d 41 4e 41 47 BLE_MEMORY_MANAG
1c210 45 4d 45 4e 54 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 EMENT */../*.**
1c220 52 65 61 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 Read the content
1c230 20 6f 66 20 70 61 67 65 20 70 50 67 20 6f 75 74 of page pPg out
1c240 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1c250 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 file..*/.static
1c260 20 69 6e 74 20 72 65 61 64 44 62 50 61 67 65 28 int readDbPage(
1c270 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 Pager *pPager, P
1c280 67 48 64 72 20 2a 70 50 67 2c 20 50 67 6e 6f 20 gHdr *pPg, Pgno
1c290 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 72 63 3b pgno){. int rc;
1c2a0 0a 20 20 69 36 34 20 6f 66 66 73 65 74 3b 0a 20 . i64 offset;.
1c2b0 20 61 73 73 65 72 74 28 20 4d 45 4d 44 42 3d 3d assert( MEMDB==
1c2c0 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 70 50 0 );. assert(pP
1c2d0 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f ager->fd->pMetho
1c2e0 64 73 7c 7c 70 50 61 67 65 72 2d 3e 74 65 6d 70 ds||pPager->temp
1c2f0 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 21 70 50 File);. if( !pP
1c300 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f ager->fd->pMetho
1c310 64 73 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ds ){. return
1c320 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 SQLITE_IOERR_SH
1c330 4f 52 54 5f 52 45 41 44 3b 0a 20 20 7d 0a 20 20 ORT_READ;. }.
1c340 6f 66 66 73 65 74 20 3d 20 28 70 67 6e 6f 2d 31 offset = (pgno-1
1c350 29 2a 28 69 36 34 29 70 50 61 67 65 72 2d 3e 70 )*(i64)pPager->p
1c360 61 67 65 53 69 7a 65 3b 0a 20 20 72 63 20 3d 20 ageSize;. rc =
1c370 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 sqlite3OsRead(pP
1c380 61 67 65 72 2d 3e 66 64 2c 20 50 47 48 44 52 5f ager->fd, PGHDR_
1c390 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 70 50 TO_DATA(pPg), pP
1c3a0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 ager->pageSize,
1c3b0 6f 66 66 73 65 74 29 3b 0a 20 20 50 41 47 45 52 offset);. PAGER
1c3c0 5f 49 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 _INCR(sqlite3_pa
1c3d0 67 65 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 ger_readdb_count
1c3e0 29 3b 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28 );. PAGER_INCR(
1c3f0 70 50 61 67 65 72 2d 3e 6e 52 65 61 64 29 3b 0a pPager->nRead);.
1c400 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 49 4e IOTRACE(("PGIN
1c410 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 %p %d\n", pPage
1c420 72 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 69 66 28 r, pgno));. if(
1c430 20 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 pgno==1 ){.
1c440 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e memcpy(&pPager->
1c450 64 62 46 69 6c 65 56 65 72 73 2c 20 26 28 28 75 dbFileVers, &((u
1c460 38 2a 29 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 8*)PGHDR_TO_DATA
1c470 28 70 50 67 29 29 5b 32 34 5d 2c 0a 20 20 20 20 (pPg))[24],.
1c480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c4a0 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 sizeof
1c4b0 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 (pPager->dbFileV
1c4c0 65 72 73 29 29 3b 0a 20 20 7d 0a 20 20 43 4f 44 ers));. }. COD
1c4d0 45 43 31 28 70 50 61 67 65 72 2c 20 50 47 48 44 EC1(pPager, PGHD
1c4e0 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 2c 20 R_TO_DATA(pPg),
1c4f0 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 29 3b 0a 20 pPg->pgno, 3);.
1c500 20 50 41 47 45 52 54 52 41 43 45 34 28 22 46 45 PAGERTRACE4("FE
1c510 54 43 48 20 25 64 20 70 61 67 65 20 25 64 20 68 TCH %d page %d h
1c520 61 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20 ash(%08x)\n",.
1c530 20 20 20 20 20 20 20 20 20 20 20 20 20 50 41 47 PAG
1c540 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50 ERID(pPager), pP
1c550 67 2d 3e 70 67 6e 6f 2c 20 70 61 67 65 72 5f 70 g->pgno, pager_p
1c560 61 67 65 68 61 73 68 28 70 50 67 29 29 3b 0a 20 agehash(pPg));.
1c570 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
1c580 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
1c590 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f ion is called to
1c5a0 20 6f 62 74 61 69 6e 20 74 68 65 20 73 68 61 72 obtain the shar
1c5b0 65 64 20 6c 6f 63 6b 20 72 65 71 75 69 72 65 64 ed lock required
1c5c0 20 62 65 66 6f 72 65 0a 2a 2a 20 64 61 74 61 20 before.** data
1c5d0 6d 61 79 20 62 65 20 72 65 61 64 20 66 72 6f 6d may be read from
1c5e0 20 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 the pager cache
1c5f0 2e 20 49 66 20 74 68 65 20 73 68 61 72 65 64 20 . If the shared
1c600 6c 6f 63 6b 20 68 61 73 20 61 6c 72 65 61 64 79 lock has already
1c610 0a 2a 2a 20 62 65 65 6e 20 6f 62 74 61 69 6e 65 .** been obtaine
1c620 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e d, this function
1c630 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a is a no-op..**.
1c640 2a 2a 20 49 6d 6d 65 64 69 61 74 65 6c 79 20 61 ** Immediately a
1c650 66 74 65 72 20 6f 62 74 61 69 6e 69 6e 67 20 74 fter obtaining t
1c660 68 65 20 73 68 61 72 65 64 20 6c 6f 63 6b 20 28 he shared lock (
1c670 69 66 20 72 65 71 75 69 72 65 64 29 2c 20 74 68 if required), th
1c680 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 63 is function.** c
1c690 68 65 63 6b 73 20 66 6f 72 20 61 20 68 6f 74 2d hecks for a hot-
1c6a0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 66 journal file. If
1c6b0 20 6f 6e 65 20 69 73 20 66 6f 75 6e 64 2c 20 61 one is found, a
1c6c0 6e 20 65 6d 65 72 67 65 6e 63 79 20 72 6f 6c 6c n emergency roll
1c6d0 62 61 63 6b 0a 2a 2a 20 69 73 20 70 65 72 66 6f back.** is perfo
1c6e0 72 6d 65 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 rmed immediately
1c6f0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
1c700 70 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 pagerSharedLock(
1c710 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
1c720 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
1c730 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 73 48 6f E_OK;. int isHo
1c740 74 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 t = 0;.. /* If
1c750 74 68 69 73 20 64 61 74 61 62 61 73 65 20 69 73 this database is
1c760 20 6f 70 65 6e 65 64 20 66 6f 72 20 65 78 63 6c opened for excl
1c770 75 73 69 76 65 20 61 63 63 65 73 73 2c 20 68 61 usive access, ha
1c780 73 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 s no outstanding
1c790 20 0a 20 20 2a 2a 20 70 61 67 65 20 72 65 66 65 . ** page refe
1c7a0 72 65 6e 63 65 73 20 61 6e 64 20 69 73 20 69 6e rences and is in
1c7b0 20 61 6e 20 65 72 72 6f 72 2d 73 74 61 74 65 2c an error-state,
1c7c0 20 6e 6f 77 20 69 73 20 74 68 65 20 63 68 61 6e now is the chan
1c7d0 63 65 20 74 6f 20 63 6c 65 61 72 0a 20 20 2a 2a ce to clear. **
1c7e0 20 74 68 65 20 65 72 72 6f 72 2e 20 44 69 73 63 the error. Disc
1c7f0 61 72 64 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 ard the contents
1c800 20 6f 66 20 74 68 65 20 70 61 67 65 72 2d 63 61 of the pager-ca
1c810 63 68 65 20 61 6e 64 20 74 72 65 61 74 20 61 6e che and treat an
1c820 79 0a 20 20 2a 2a 20 6f 70 65 6e 20 6a 6f 75 72 y. ** open jour
1c830 6e 61 6c 20 66 69 6c 65 20 61 73 20 61 20 68 6f nal file as a ho
1c840 74 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a t-journal.. */.
1c850 20 20 69 66 28 20 21 4d 45 4d 44 42 20 26 26 20 if( !MEMDB &&
1c860 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
1c870 65 4d 6f 64 65 20 26 26 20 70 50 61 67 65 72 2d eMode && pPager-
1c880 3e 6e 52 65 66 3d 3d 30 20 26 26 20 70 50 61 67 >nRef==0 && pPag
1c890 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b 0a 20 er->errCode ){.
1c8a0 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a if( pPager->j
1c8b0 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 ournalOpen ){.
1c8c0 20 20 20 20 69 73 48 6f 74 20 3d 20 31 3b 0a 20 isHot = 1;.
1c8d0 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 72 }. pager_r
1c8e0 65 73 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 eset(pPager);.
1c8f0 20 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 pPager->errCod
1c900 65 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 e = SQLITE_OK;.
1c910 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 }.. /* If the
1c920 70 61 67 65 72 20 69 73 20 73 74 69 6c 6c 20 69 pager is still i
1c930 6e 20 61 6e 20 65 72 72 6f 72 20 73 74 61 74 65 n an error state
1c940 2c 20 64 6f 20 6e 6f 74 20 70 72 6f 63 65 65 64 , do not proceed
1c950 2e 20 54 68 65 20 65 72 72 6f 72 20 0a 20 20 2a . The error . *
1c960 2a 20 73 74 61 74 65 20 77 69 6c 6c 20 62 65 20 * state will be
1c970 63 6c 65 61 72 65 64 20 61 74 20 73 6f 6d 65 20 cleared at some
1c980 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 74 point in the fut
1c990 75 72 65 20 77 68 65 6e 20 61 6c 6c 20 70 61 67 ure when all pag
1c9a0 65 20 0a 20 20 2a 2a 20 72 65 66 65 72 65 6e 63 e . ** referenc
1c9b0 65 73 20 61 72 65 20 64 72 6f 70 70 65 64 20 61 es are dropped a
1c9c0 6e 64 20 74 68 65 20 63 61 63 68 65 20 63 61 6e nd the cache can
1c9d0 20 62 65 20 64 69 73 63 61 72 64 65 64 2e 0a 20 be discarded..
1c9e0 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
1c9f0 2d 3e 65 72 72 43 6f 64 65 20 26 26 20 70 50 61 ->errCode && pPa
1ca00 67 65 72 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 ger->errCode!=SQ
1ca10 4c 49 54 45 5f 46 55 4c 4c 20 29 7b 0a 20 20 20 LITE_FULL ){.
1ca20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e return pPager->
1ca30 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a 0a 20 20 errCode;. }..
1ca40 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 if( pPager->stat
1ca50 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 e==PAGER_UNLOCK
1ca60 7c 7c 20 69 73 48 6f 74 20 29 7b 0a 20 20 20 20 || isHot ){.
1ca70 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 sqlite3_vfs *pVf
1ca80 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 s = pPager->pVfs
1ca90 3b 0a 20 20 20 20 69 66 28 20 21 4d 45 4d 44 42 ;. if( !MEMDB
1caa0 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ){. assert
1cab0 28 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 3d 3d ( pPager->nRef==
1cac0 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 0 );. if( !
1cad0 70 50 61 67 65 72 2d 3e 6e 6f 52 65 61 64 6c 6f pPager->noReadlo
1cae0 63 6b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 ck ){. rc
1caf0 20 3d 20 70 61 67 65 72 5f 77 61 69 74 5f 6f 6e = pager_wait_on
1cb00 5f 6c 6f 63 6b 28 70 50 61 67 65 72 2c 20 53 48 _lock(pPager, SH
1cb10 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 ARED_LOCK);.
1cb20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
1cb30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
1cb40 20 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 5f return pager_
1cb50 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 63 error(pPager, rc
1cb60 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
1cb70 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
1cb80 67 65 72 2d 3e 73 74 61 74 65 3e 3d 53 48 41 52 ger->state>=SHAR
1cb90 45 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 ED_LOCK );.
1cba0 20 7d 0a 20 20 0a 20 20 20 20 20 20 2f 2a 20 49 }. . /* I
1cbb0 66 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 f a journal file
1cbc0 20 65 78 69 73 74 73 2c 20 61 6e 64 20 74 68 65 exists, and the
1cbd0 72 65 20 69 73 20 6e 6f 20 52 45 53 45 52 56 45 re is no RESERVE
1cbe0 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 0a 20 20 D lock on the.
1cbf0 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 ** database
1cc00 66 69 6c 65 2c 20 74 68 65 6e 20 69 74 20 65 69 file, then it ei
1cc10 74 68 65 72 20 6e 65 65 64 73 20 74 6f 20 62 65 ther needs to be
1cc20 20 70 6c 61 79 65 64 20 62 61 63 6b 20 6f 72 20 played back or
1cc30 64 65 6c 65 74 65 64 2e 0a 20 20 20 20 20 20 2a deleted.. *
1cc40 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 68 61 73 /. rc = has
1cc50 48 6f 74 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 HotJournal(pPage
1cc60 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 r);. if( rc
1cc70 3c 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 <0 ){. re
1cc80 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 turn SQLITE_IOER
1cc90 52 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 7d R_NOMEM;. }
1cca0 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 31 . if( rc==1
1ccb0 20 7c 7c 20 69 73 48 6f 74 20 29 7b 0a 20 20 20 || isHot ){.
1ccc0 20 20 20 20 20 2f 2a 20 47 65 74 20 61 6e 20 45 /* Get an E
1ccd0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e XCLUSIVE lock on
1cce0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1ccf0 6c 65 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e le. At this poin
1cd00 74 20 69 74 20 69 73 0a 20 20 20 20 20 20 20 20 t it is.
1cd10 2a 2a 20 69 6d 70 6f 72 74 61 6e 74 20 74 68 61 ** important tha
1cd20 74 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 t a RESERVED loc
1cd30 6b 20 69 73 20 6e 6f 74 20 6f 62 74 61 69 6e 65 k is not obtaine
1cd40 64 20 6f 6e 20 74 68 65 20 77 61 79 20 74 6f 20 d on the way to
1cd50 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 45 the. ** E
1cd60 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 49 XCLUSIVE lock. I
1cd70 66 20 69 74 20 77 65 72 65 2c 20 61 6e 6f 74 68 f it were, anoth
1cd80 65 72 20 70 72 6f 63 65 73 73 20 6d 69 67 68 74 er process might
1cd90 20 6f 70 65 6e 20 74 68 65 0a 20 20 20 20 20 20 open the.
1cda0 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 ** database fi
1cdb0 6c 65 2c 20 64 65 74 65 63 74 20 74 68 65 20 52 le, detect the R
1cdc0 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 61 6e ESERVED lock, an
1cdd0 64 20 63 6f 6e 63 6c 75 64 65 20 74 68 61 74 20 d conclude that
1cde0 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 the. ** d
1cdf0 61 74 61 62 61 73 65 20 69 73 20 73 61 66 65 20 atabase is safe
1ce00 74 6f 20 72 65 61 64 20 77 68 69 6c 65 20 74 68 to read while th
1ce10 69 73 20 70 72 6f 63 65 73 73 20 69 73 20 73 74 is process is st
1ce20 69 6c 6c 20 72 6f 6c 6c 69 6e 67 20 69 74 20 0a ill rolling it .
1ce30 20 20 20 20 20 20 20 20 2a 2a 20 62 61 63 6b 2e ** back.
1ce40 0a 20 20 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 . ** .
1ce50 20 20 20 20 20 2a 2a 20 42 65 63 61 75 73 65 20 ** Because
1ce60 74 68 65 20 69 6e 74 65 72 6d 65 64 69 61 74 65 the intermediate
1ce70 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 RESERVED lock i
1ce80 73 20 6e 6f 74 20 72 65 71 75 65 73 74 65 64 2c s not requested,
1ce90 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 the. **
1cea0 73 65 63 6f 6e 64 20 70 72 6f 63 65 73 73 20 77 second process w
1ceb0 69 6c 6c 20 67 65 74 20 74 6f 20 74 68 69 73 20 ill get to this
1cec0 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 63 6f 64 point in the cod
1ced0 65 20 61 6e 64 20 66 61 69 6c 20 74 6f 0a 20 20 e and fail to.
1cee0 20 20 20 20 20 20 2a 2a 20 6f 62 74 61 69 6e 20 ** obtain
1cef0 69 74 73 20 6f 77 6e 20 45 58 43 4c 55 53 49 56 its own EXCLUSIV
1cf00 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 E lock on the da
1cf10 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 tabase file..
1cf20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
1cf30 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 if( pPager->stat
1cf40 65 3c 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b e<EXCLUSIVE_LOCK
1cf50 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 ){. rc
1cf60 20 3d 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b = sqlite3OsLock
1cf70 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 45 58 43 (pPager->fd, EXC
1cf80 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 20 LUSIVE_LOCK);.
1cf90 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
1cfa0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1cfb0 20 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 75 pager_u
1cfc0 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 nlock(pPager);.
1cfd0 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
1cfe0 6e 20 70 61 67 65 72 5f 65 72 72 6f 72 28 70 50 n pager_error(pP
1cff0 61 67 65 72 2c 20 72 63 29 3b 0a 20 20 20 20 20 ager, rc);.
1d000 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
1d010 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d pPager->state =
1d020 20 50 41 47 45 52 5f 45 58 43 4c 55 53 49 56 45 PAGER_EXCLUSIVE
1d030 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 0a 20 20 ;. }. .
1d040 20 20 20 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68 /* Open th
1d050 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 20 72 65 e journal for re
1d060 61 64 2f 77 72 69 74 65 20 61 63 63 65 73 73 2e ad/write access.
1d070 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65 This is because
1d080 20 69 6e 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 in . **
1d090 65 78 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73 exclusive-access
1d0a0 20 6d 6f 64 65 20 74 68 65 20 66 69 6c 65 20 64 mode the file d
1d0b0 65 73 63 72 69 70 74 6f 72 20 77 69 6c 6c 20 62 escriptor will b
1d0c0 65 20 6b 65 70 74 20 6f 70 65 6e 20 61 6e 64 0a e kept open and.
1d0d0 20 20 20 20 20 20 20 20 2a 2a 20 70 6f 73 73 69 ** possi
1d0e0 62 6c 79 20 75 73 65 64 20 66 6f 72 20 61 20 74 bly used for a t
1d0f0 72 61 6e 73 61 63 74 69 6f 6e 20 6c 61 74 65 72 ransaction later
1d100 20 6f 6e 2e 20 4f 6e 20 73 6f 6d 65 20 73 79 73 on. On some sys
1d110 74 65 6d 73 2c 20 74 68 65 0a 20 20 20 20 20 20 tems, the.
1d120 20 20 2a 2a 20 4f 73 54 72 75 6e 63 61 74 65 28 ** OsTruncate(
1d130 29 20 63 61 6c 6c 20 75 73 65 64 20 69 6e 20 65 ) call used in e
1d140 78 63 6c 75 73 69 76 65 2d 61 63 63 65 73 73 20 xclusive-access
1d150 6d 6f 64 65 20 61 6c 73 6f 20 72 65 71 75 69 72 mode also requir
1d160 65 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 20 es. ** a
1d170 72 65 61 64 2f 77 72 69 74 65 20 66 69 6c 65 20 read/write file
1d180 68 61 6e 64 6c 65 2e 0a 20 20 20 20 20 20 20 20 handle..
1d190 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 */. if( !
1d1a0 69 73 48 6f 74 20 26 26 20 70 50 61 67 65 72 2d isHot && pPager-
1d1b0 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 3d 3d 30 20 >journalOpen==0
1d1c0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 ){. int
1d1d0 20 72 65 73 20 3d 20 73 71 6c 69 74 65 33 4f 73 res = sqlite3Os
1d1e0 41 63 63 65 73 73 28 70 56 66 73 2c 70 50 61 67 Access(pVfs,pPag
1d1f0 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 53 51 4c er->zJournal,SQL
1d200 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54 ITE_ACCESS_EXIST
1d210 53 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 S);. if
1d220 28 20 72 65 73 3d 3d 31 20 29 7b 0a 20 20 20 20 ( res==1 ){.
1d230 20 20 20 20 20 20 20 20 69 6e 74 20 66 6f 75 74 int fout
1d240 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
1d250 20 20 69 6e 74 20 66 20 3d 20 53 51 4c 49 54 45 int f = SQLITE
1d260 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 7c _OPEN_READWRITE|
1d270 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e SQLITE_OPEN_MAIN
1d280 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 20 20 20 20 _JOURNAL;.
1d290 20 20 20 20 20 20 61 73 73 65 72 74 28 20 21 70 assert( !p
1d2a0 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
1d2b0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 );. r
1d2c0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 c = sqlite3OsOpe
1d2d0 6e 28 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e n(pVfs, pPager->
1d2e0 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 67 65 72 zJournal, pPager
1d2f0 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 6f 75 74 29 ->jfd, f, &fout)
1d300 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 73 ;. as
1d310 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
1d320 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a _OK || pPager->j
1d330 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 3b 0a fd->pMethods );.
1d340 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
1d350 66 6f 75 74 26 53 51 4c 49 54 45 5f 4f 50 45 4e fout&SQLITE_OPEN
1d360 5f 52 45 41 44 4f 4e 4c 59 20 29 7b 0a 20 20 20 _READONLY ){.
1d370 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 rc =
1d380 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 SQLITE_BUSY;.
1d390 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
1d3a0 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 e3OsClose(pPager
1d3b0 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 20 20 ->jfd);.
1d3c0 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
1d3d0 7d 65 6c 73 65 20 69 66 28 20 72 65 73 3d 3d 30 }else if( res==0
1d3e0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
1d3f0 2f 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 /* If the journa
1d400 6c 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 l does not exist
1d410 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 73 6f 6d , that means som
1d420 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 0a e other process.
1d430 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 68 ** h
1d440 61 73 20 61 6c 72 65 61 64 79 20 72 6f 6c 6c 65 as already rolle
1d450 64 20 69 74 20 62 61 63 6b 20 2a 2f 0a 20 20 20 d it back */.
1d460 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
1d470 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20 LITE_BUSY;.
1d480 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
1d490 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 73 71 /* If sq
1d4a0 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 20 lite3OsAccess()
1d4b0 72 65 74 75 72 6e 73 20 61 20 6e 65 67 61 74 69 returns a negati
1d4c0 76 65 20 76 61 6c 75 65 2c 20 74 68 61 74 20 6d ve value, that m
1d4d0 65 61 6e 73 20 69 74 0a 20 20 20 20 20 20 20 20 eans it.
1d4e0 20 20 20 20 2a 2a 20 66 61 69 6c 65 64 20 61 20 ** failed a
1d4f0 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
1d500 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 n */.
1d510 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 rc = SQLITE_IOE
1d520 52 52 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20 RR_NOMEM;.
1d530 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
1d540 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
1d550 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1d560 20 20 20 20 20 20 20 70 61 67 65 72 5f 75 6e 6c pager_unl
1d570 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 20 ock(pPager);.
1d580 20 20 20 20 20 20 20 73 77 69 74 63 68 28 20 72 switch( r
1d590 63 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 c ){.
1d5a0 20 63 61 73 65 20 53 51 4c 49 54 45 5f 4e 4f 4d case SQLITE_NOM
1d5b0 45 4d 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 EM:.
1d5c0 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 case SQLITE_IOER
1d5d0 52 5f 55 4e 4c 4f 43 4b 3a 0a 20 20 20 20 20 20 R_UNLOCK:.
1d5e0 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54 case SQLIT
1d5f0 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 3a 0a 20 E_IOERR_NOMEM:.
1d600 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
1d610 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 urn rc;.
1d620 20 20 20 20 64 65 66 61 75 6c 74 3a 0a 20 20 20 default:.
1d630 20 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72 retur
1d640 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 n SQLITE_BUSY;.
1d650 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
1d660 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 50 61 }. pPa
1d670 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e ger->journalOpen
1d680 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 70 50 = 1;. pP
1d690 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 74 61 ager->journalSta
1d6a0 72 74 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 rted = 0;.
1d6b0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
1d6c0 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 lOff = 0;.
1d6d0 20 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 pPager->setMas
1d6e0 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ter = 0;.
1d6f0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
1d700 48 64 72 20 3d 20 30 3b 0a 20 0a 20 20 20 20 20 Hdr = 0;. .
1d710 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 6b 20 61 /* Playback a
1d720 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6a 6f nd delete the jo
1d730 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 74 68 65 urnal. Drop the
1d740 20 64 61 74 61 62 61 73 65 20 77 72 69 74 65 0a database write.
1d750 20 20 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b 20 ** lock
1d760 61 6e 64 20 72 65 61 63 71 75 69 72 65 20 74 68 and reacquire th
1d770 65 20 72 65 61 64 20 6c 6f 63 6b 2e 0a 20 20 20 e read lock..
1d780 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
1d790 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 rc = pager_playb
1d7a0 61 63 6b 28 70 50 61 67 65 72 2c 20 31 29 3b 0a ack(pPager, 1);.
1d7b0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d if( rc!=
1d7c0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1d7d0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 61 return pa
1d7e0 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 72 ger_error(pPager
1d7f0 2c 20 72 63 29 3b 0a 20 20 20 20 20 20 20 20 7d , rc);. }
1d800 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
1d810 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d 50 pPager->state==P
1d820 41 47 45 52 5f 53 48 41 52 45 44 20 7c 7c 20 0a AGER_SHARED || .
1d830 20 20 20 20 20 20 20 20 20 20 20 20 28 70 50 61 (pPa
1d840 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
1d850 64 65 20 26 26 20 70 50 61 67 65 72 2d 3e 73 74 de && pPager->st
1d860 61 74 65 3e 50 41 47 45 52 5f 53 48 41 52 45 44 ate>PAGER_SHARED
1d870 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 ). );.
1d880 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 }.. if(
1d890 70 50 61 67 65 72 2d 3e 70 41 6c 6c 20 29 7b 0a pPager->pAll ){.
1d8a0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 /* The s
1d8b0 68 61 72 65 64 2d 6c 6f 63 6b 20 68 61 73 20 6a hared-lock has j
1d8c0 75 73 74 20 62 65 65 6e 20 61 63 71 75 69 72 65 ust been acquire
1d8d0 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 d on the databas
1d8e0 65 20 66 69 6c 65 0a 20 20 20 20 20 20 20 20 2a e file. *
1d8f0 2a 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 * and there are
1d900 61 6c 72 65 61 64 79 20 70 61 67 65 73 20 69 6e already pages in
1d910 20 74 68 65 20 63 61 63 68 65 20 28 66 72 6f 6d the cache (from
1d920 20 61 20 70 72 65 76 69 6f 75 73 0a 20 20 20 20 a previous.
1d930 20 20 20 20 2a 2a 20 72 65 61 64 20 6f 72 20 77 ** read or w
1d940 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
1d950 29 2e 20 20 43 68 65 63 6b 20 74 6f 20 73 65 65 ). Check to see
1d960 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 if the database
1d970 0a 20 20 20 20 20 20 20 20 2a 2a 20 68 61 73 20 . ** has
1d980 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e 20 20 been modified.
1d990 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
1d9a0 68 61 73 20 63 68 61 6e 67 65 64 2c 20 66 6c 75 has changed, flu
1d9b0 73 68 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a sh the. *
1d9c0 2a 20 63 61 63 68 65 2e 0a 20 20 20 20 20 20 20 * cache..
1d9d0 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 44 **. ** D
1d9e0 61 74 61 62 61 73 65 20 63 68 61 6e 67 65 73 20 atabase changes
1d9f0 69 73 20 64 65 74 65 63 74 65 64 20 62 79 20 6c is detected by l
1da00 6f 6f 6b 69 6e 67 20 61 74 20 31 35 20 62 79 74 ooking at 15 byt
1da10 65 73 20 62 65 67 69 6e 6e 69 6e 67 0a 20 20 20 es beginning.
1da20 20 20 20 20 20 2a 2a 20 61 74 20 6f 66 66 73 65 ** at offse
1da30 74 20 32 34 20 69 6e 74 6f 20 74 68 65 20 66 69 t 24 into the fi
1da40 6c 65 2e 20 20 54 68 65 20 66 69 72 73 74 20 34 le. The first 4
1da50 20 6f 66 20 74 68 65 73 65 20 31 36 20 62 79 74 of these 16 byt
1da60 65 73 20 61 72 65 0a 20 20 20 20 20 20 20 20 2a es are. *
1da70 2a 20 61 20 33 32 2d 62 69 74 20 63 6f 75 6e 74 * a 32-bit count
1da80 65 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65 er that is incre
1da90 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 mented with each
1daa0 20 63 68 61 6e 67 65 2e 20 20 54 68 65 0a 20 20 change. The.
1dab0 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 20 62 ** other b
1dac0 79 74 65 73 20 63 68 61 6e 67 65 20 72 61 6e 64 ytes change rand
1dad0 6f 6d 6c 79 20 77 69 74 68 20 65 61 63 68 20 66 omly with each f
1dae0 69 6c 65 20 63 68 61 6e 67 65 20 77 68 65 6e 0a ile change when.
1daf0 20 20 20 20 20 20 20 20 2a 2a 20 61 20 63 6f 64 ** a cod
1db00 65 63 20 69 73 20 69 6e 20 75 73 65 2e 0a 20 20 ec is in use..
1db10 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 ** .
1db20 20 20 2a 2a 20 54 68 65 72 65 20 69 73 20 61 20 ** There is a
1db30 76 61 6e 69 73 68 69 6e 67 6c 79 20 73 6d 61 6c vanishingly smal
1db40 6c 20 63 68 61 6e 63 65 20 74 68 61 74 20 61 20 l chance that a
1db50 63 68 61 6e 67 65 20 77 69 6c 6c 20 6e 6f 74 20 change will not
1db60 62 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 64 be . ** d
1db70 65 74 65 63 74 65 64 2e 20 20 54 68 65 20 63 68 etected. The ch
1db80 61 6e 63 65 20 6f 66 20 61 6e 20 75 6e 64 65 74 ance of an undet
1db90 65 63 74 65 64 20 63 68 61 6e 67 65 20 69 73 20 ected change is
1dba0 73 6f 20 73 6d 61 6c 6c 20 74 68 61 74 0a 20 20 so small that.
1dbb0 20 20 20 20 20 20 2a 2a 20 69 74 20 63 61 6e 20 ** it can
1dbc0 62 65 20 6e 65 67 6c 65 63 74 65 64 2e 0a 20 20 be neglected..
1dbd0 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 */.
1dbe0 20 63 68 61 72 20 64 62 46 69 6c 65 56 65 72 73 char dbFileVers
1dbf0 5b 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e [sizeof(pPager->
1dc00 64 62 46 69 6c 65 56 65 72 73 29 5d 3b 0a 20 20 dbFileVers)];.
1dc10 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
1dc20 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 67 erPagecount(pPag
1dc30 65 72 29 3b 0a 0a 20 20 20 20 20 20 20 20 69 66 er);.. if
1dc40 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 ( pPager->errCod
1dc50 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 e ){. r
1dc60 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 eturn pPager->er
1dc70 72 43 6f 64 65 3b 0a 20 20 20 20 20 20 20 20 7d rCode;. }
1dc80 0a 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 50 .. if( pP
1dc90 61 67 65 72 2d 3e 64 62 53 69 7a 65 3e 30 20 29 ager->dbSize>0 )
1dca0 7b 0a 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 {. IOTR
1dcb0 41 43 45 28 28 22 43 4b 56 45 52 53 20 25 70 20 ACE(("CKVERS %p
1dcc0 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 73 %d\n", pPager, s
1dcd0 69 7a 65 6f 66 28 64 62 46 69 6c 65 56 65 72 73 izeof(dbFileVers
1dce0 29 29 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 )));. r
1dcf0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 c = sqlite3OsRea
1dd00 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 64 d(pPager->fd, &d
1dd10 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f bFileVers, sizeo
1dd20 66 28 64 62 46 69 6c 65 56 65 72 73 29 2c 20 32 f(dbFileVers), 2
1dd30 34 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 4);. if
1dd40 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1dd50 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 ){. r
1dd60 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 eturn rc;.
1dd70 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 65 }. }e
1dd80 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 6d lse{. m
1dd90 65 6d 73 65 74 28 64 62 46 69 6c 65 56 65 72 73 emset(dbFileVers
1dda0 2c 20 30 2c 20 73 69 7a 65 6f 66 28 64 62 46 69 , 0, sizeof(dbFi
1ddb0 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 20 20 20 leVers));.
1ddc0 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 69 66 28 }.. if(
1ddd0 20 6d 65 6d 63 6d 70 28 70 50 61 67 65 72 2d 3e memcmp(pPager->
1dde0 64 62 46 69 6c 65 56 65 72 73 2c 20 64 62 46 69 dbFileVers, dbFi
1ddf0 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 leVers, sizeof(d
1de00 62 46 69 6c 65 56 65 72 73 29 29 21 3d 30 20 29 bFileVers))!=0 )
1de10 7b 0a 20 20 20 20 20 20 20 20 20 20 70 61 67 65 {. page
1de20 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 29 3b r_reset(pPager);
1de30 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
1de40 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 }. }. ass
1de50 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 78 63 ert( pPager->exc
1de60 6c 75 73 69 76 65 4d 6f 64 65 20 7c 7c 20 70 50 lusiveMode || pP
1de70 61 67 65 72 2d 3e 73 74 61 74 65 3c 3d 50 41 47 ager->state<=PAG
1de80 45 52 5f 53 48 41 52 45 44 20 29 3b 0a 20 20 20 ER_SHARED );.
1de90 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 61 if( pPager->sta
1dea0 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b te==PAGER_UNLOCK
1deb0 20 29 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 ){. pPager
1dec0 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45 52 5f ->state = PAGER_
1ded0 53 48 41 52 45 44 3b 0a 20 20 20 20 7d 0a 20 20 SHARED;. }.
1dee0 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a }.. return rc;.
1def0 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 }../*.** Allocat
1df00 65 20 61 20 50 67 48 64 72 20 6f 62 6a 65 63 74 e a PgHdr object
1df10 2e 20 20 20 45 69 74 68 65 72 20 63 72 65 61 74 . Either creat
1df20 65 20 61 20 6e 65 77 20 6f 6e 65 20 6f 72 20 72 e a new one or r
1df30 65 75 73 65 0a 2a 2a 20 61 6e 20 65 78 69 73 74 euse.** an exist
1df40 69 6e 67 20 6f 6e 65 20 74 68 61 74 20 69 73 20 ing one that is
1df50 6e 6f 74 20 6f 74 68 65 72 77 69 73 65 20 69 6e not otherwise in
1df60 20 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 6e 65 use..**.** A ne
1df70 77 20 50 67 48 64 72 20 73 74 72 75 63 74 75 72 w PgHdr structur
1df80 65 20 69 73 20 63 72 65 61 74 65 64 20 69 66 20 e is created if
1df90 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f any of the follo
1dfa0 77 69 6e 67 20 61 72 65 0a 2a 2a 20 74 72 75 65 wing are.** true
1dfb0 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 :.**.** (1)
1dfc0 20 57 65 20 68 61 76 65 20 6e 6f 74 20 65 78 63 We have not exc
1dfd0 65 65 64 65 64 20 6f 75 72 20 6d 61 78 69 6d 75 eeded our maximu
1dfe0 6d 20 61 6c 6c 6f 63 61 74 65 64 20 63 61 63 68 m allocated cach
1dff0 65 20 73 69 7a 65 0a 2a 2a 20 20 20 20 20 20 20 e size.**
1e000 20 20 20 61 73 20 73 65 74 20 62 79 20 74 68 65 as set by the
1e010 20 22 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 "PRAGMA cache_s
1e020 69 7a 65 22 20 63 6f 6d 6d 61 6e 64 2e 0a 2a 2a ize" command..**
1e030 0a 2a 2a 20 20 20 20 20 28 32 29 20 20 54 68 65 .** (2) The
1e040 72 65 20 61 72 65 20 6e 6f 20 75 6e 75 73 65 64 re are no unused
1e050 20 50 67 48 64 72 20 6f 62 6a 65 63 74 73 20 61 PgHdr objects a
1e060 76 61 69 6c 61 62 6c 65 20 61 74 20 74 68 69 73 vailable at this
1e070 20 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 time..**.**
1e080 20 28 33 29 20 20 54 68 69 73 20 69 73 20 61 6e (3) This is an
1e090 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 in-memory datab
1e0a0 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 28 ase..**.** (
1e0b0 34 29 20 20 54 68 65 72 65 20 61 72 65 20 6e 6f 4) There are no
1e0c0 20 50 67 48 64 72 20 6f 62 6a 65 63 74 73 20 74 PgHdr objects t
1e0d0 68 61 74 20 64 6f 20 6e 6f 74 20 72 65 71 75 69 hat do not requi
1e0e0 72 65 20 61 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 re a journal.**
1e0f0 20 20 20 20 20 20 20 20 20 66 69 6c 65 20 73 79 file sy
1e100 6e 63 20 61 6e 64 20 61 20 73 79 6e 63 20 6f 66 nc and a sync of
1e110 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
1e120 65 20 69 73 20 63 75 72 72 65 6e 74 6c 79 0a 2a e is currently.*
1e130 2a 20 20 20 20 20 20 20 20 20 20 70 72 6f 68 69 * prohi
1e140 62 69 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 bited..**.** Oth
1e150 65 72 77 69 73 65 2c 20 72 65 75 73 65 20 61 6e erwise, reuse an
1e160 20 65 78 69 73 74 69 6e 67 20 50 67 48 64 72 2e existing PgHdr.
1e170 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 In other words
1e180 2c 20 72 65 75 73 65 20 61 6e 0a 2a 2a 20 65 78 , reuse an.** ex
1e190 69 73 74 69 6e 67 20 50 67 48 64 72 20 69 66 20 isting PgHdr if
1e1a0 61 6c 6c 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f all of the follo
1e1b0 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a 2a wing are true:.*
1e1c0 2a 0a 2a 2a 20 20 20 20 20 28 31 29 20 20 57 65 *.** (1) We
1e1d0 20 68 61 76 65 20 72 65 61 63 68 65 64 20 6f 72 have reached or
1e1e0 20 65 78 63 65 65 64 65 64 20 74 68 65 20 6d 61 exceeded the ma
1e1f0 78 69 6d 75 6d 20 63 61 63 68 65 20 73 69 7a 65 ximum cache size
1e200 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 61 6c 6c .** all
1e210 6f 77 65 64 20 62 79 20 22 50 52 41 47 4d 41 20 owed by "PRAGMA
1e220 63 61 63 68 65 5f 73 69 7a 65 22 2e 0a 2a 2a 0a cache_size"..**.
1e230 2a 2a 20 20 20 20 20 28 32 29 20 20 54 68 65 72 ** (2) Ther
1e240 65 20 69 73 20 61 20 50 67 48 64 72 20 61 76 61 e is a PgHdr ava
1e250 69 6c 61 62 6c 65 20 77 69 74 68 20 50 67 48 64 ilable with PgHd
1e260 72 2d 3e 6e 52 65 66 3d 3d 30 0a 2a 2a 0a 2a 2a r->nRef==0.**.**
1e270 20 20 20 20 20 28 33 29 20 20 57 65 20 61 72 65 (3) We are
1e280 20 6e 6f 74 20 69 6e 20 61 6e 20 69 6e 2d 6d 65 not in an in-me
1e290 6d 6f 72 79 20 64 61 74 61 62 61 73 65 0a 2a 2a mory database.**
1e2a0 0a 2a 2a 20 20 20 20 20 28 34 29 20 20 45 69 74 .** (4) Eit
1e2b0 68 65 72 20 74 68 65 72 65 20 69 73 20 61 6e 20 her there is an
1e2c0 61 76 61 69 6c 61 62 6c 65 20 50 67 48 64 72 20 available PgHdr
1e2d0 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e 65 that does not ne
1e2e0 65 64 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 74 ed.** t
1e2f0 6f 20 62 65 20 73 79 6e 63 65 64 20 74 6f 20 64 o be synced to d
1e300 69 73 6b 20 6f 72 20 65 6c 73 65 20 64 69 73 6b isk or else disk
1e310 20 73 79 6e 63 69 6e 67 20 69 73 20 63 75 72 72 syncing is curr
1e320 65 6e 74 6c 79 0a 2a 2a 20 20 20 20 20 20 20 20 ently.**
1e330 20 20 61 6c 6c 6f 77 65 64 2e 0a 2a 2f 0a 73 74 allowed..*/.st
1e340 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 41 6c atic int pagerAl
1e350 6c 6f 63 61 74 65 50 61 67 65 28 50 61 67 65 72 locatePage(Pager
1e360 20 2a 70 50 61 67 65 72 2c 20 50 67 48 64 72 20 *pPager, PgHdr
1e370 2a 2a 70 70 50 67 29 7b 0a 20 20 69 6e 74 20 72 **ppPg){. int r
1e380 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
1e390 20 50 67 48 64 72 20 2a 70 50 67 3b 0a 20 20 69 PgHdr *pPg;. i
1e3a0 6e 74 20 6e 42 79 74 65 48 64 72 3b 0a 0a 20 20 nt nByteHdr;..
1e3b0 2f 2a 20 43 72 65 61 74 65 20 61 20 6e 65 77 20 /* Create a new
1e3c0 50 67 48 64 72 20 69 66 20 61 6e 79 20 6f 66 20 PgHdr if any of
1e3d0 74 68 65 20 66 6f 75 72 20 63 6f 6e 64 69 74 69 the four conditi
1e3e0 6f 6e 73 20 64 65 66 69 6e 65 64 20 0a 20 20 2a ons defined . *
1e3f0 2a 20 61 62 6f 76 65 20 61 72 65 20 6d 65 74 3a * above are met:
1e400 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
1e410 2d 3e 6e 50 61 67 65 3c 70 50 61 67 65 72 2d 3e ->nPage<pPager->
1e420 6d 78 50 61 67 65 0a 20 20 20 7c 7c 20 70 50 61 mxPage. || pPa
1e430 67 65 72 2d 3e 6c 72 75 2e 70 46 69 72 73 74 3d ger->lru.pFirst=
1e440 3d 30 20 0a 20 20 20 7c 7c 20 4d 45 4d 44 42 0a =0 . || MEMDB.
1e450 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 6c || (pPager->l
1e460 72 75 2e 70 46 69 72 73 74 53 79 6e 63 65 64 3d ru.pFirstSynced=
1e470 3d 30 20 26 26 20 70 50 61 67 65 72 2d 3e 64 6f =0 && pPager->do
1e480 4e 6f 74 53 79 6e 63 29 0a 20 20 29 7b 0a 20 20 NotSync). ){.
1e490 20 20 76 6f 69 64 20 2a 70 44 61 74 61 3b 0a 20 void *pData;.
1e4a0 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6e if( pPager->n
1e4b0 50 61 67 65 3e 3d 70 50 61 67 65 72 2d 3e 6e 48 Page>=pPager->nH
1e4c0 61 73 68 20 29 7b 0a 20 20 20 20 20 20 70 61 67 ash ){. pag
1e4d0 65 72 5f 72 65 73 69 7a 65 5f 68 61 73 68 5f 74 er_resize_hash_t
1e4e0 61 62 6c 65 28 70 50 61 67 65 72 2c 0a 20 20 20 able(pPager,.
1e4f0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 48 pPager->nH
1e500 61 73 68 3c 32 35 36 20 3f 20 32 35 36 20 3a 20 ash<256 ? 256 :
1e510 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2a 32 29 pPager->nHash*2)
1e520 3b 0a 20 20 20 20 20 20 69 66 28 20 70 50 61 67 ;. if( pPag
1e530 65 72 2d 3e 6e 48 61 73 68 3d 3d 30 20 29 7b 0a er->nHash==0 ){.
1e540 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c rc = SQL
1e550 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 ITE_NOMEM;.
1e560 20 20 20 67 6f 74 6f 20 70 61 67 65 72 5f 61 6c goto pager_al
1e570 6c 6f 63 61 74 65 5f 6f 75 74 3b 0a 20 20 20 20 locate_out;.
1e580 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 70 61 }. }. pa
1e590 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 gerLeave(pPager)
1e5a0 3b 0a 20 20 20 20 6e 42 79 74 65 48 64 72 20 3d ;. nByteHdr =
1e5b0 20 73 69 7a 65 6f 66 28 2a 70 50 67 29 20 2b 20 sizeof(*pPg) +
1e5c0 73 69 7a 65 6f 66 28 75 33 32 29 20 2b 20 70 50 sizeof(u32) + pP
1e5d0 61 67 65 72 2d 3e 6e 45 78 74 72 61 0a 20 20 20 ager->nExtra.
1e5e0 20 20 20 20 20 20 20 20 20 20 20 2b 20 4d 45 4d + MEM
1e5f0 44 42 2a 73 69 7a 65 6f 66 28 50 67 48 69 73 74 DB*sizeof(PgHist
1e600 6f 72 79 29 3b 0a 20 20 20 20 70 50 67 20 3d 20 ory);. pPg =
1e610 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 sqlite3_malloc(
1e620 6e 42 79 74 65 48 64 72 20 29 3b 0a 20 20 20 20 nByteHdr );.
1e630 69 66 28 20 70 50 67 20 29 7b 0a 20 20 20 20 20 if( pPg ){.
1e640 20 70 44 61 74 61 20 3d 20 73 71 6c 69 74 65 33 pData = sqlite3
1e650 5f 6d 61 6c 6c 6f 63 28 20 70 50 61 67 65 72 2d _malloc( pPager-
1e660 3e 70 61 67 65 53 69 7a 65 20 29 3b 0a 20 20 20 >pageSize );.
1e670 20 20 20 69 66 28 20 70 44 61 74 61 3d 3d 30 20 if( pData==0
1e680 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
1e690 65 33 5f 66 72 65 65 28 70 50 67 29 3b 0a 20 20 e3_free(pPg);.
1e6a0 20 20 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 pPg = 0;.
1e6b0 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
1e6c0 20 70 61 67 65 72 45 6e 74 65 72 28 70 50 61 67 pagerEnter(pPag
1e6d0 65 72 29 3b 0a 20 20 20 20 69 66 28 20 70 50 67 er);. if( pPg
1e6e0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20 ==0 ){. rc
1e6f0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a = SQLITE_NOMEM;.
1e700 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 72 goto pager
1e710 5f 61 6c 6c 6f 63 61 74 65 5f 6f 75 74 3b 0a 20 _allocate_out;.
1e720 20 20 20 7d 0a 20 20 20 20 6d 65 6d 73 65 74 28 }. memset(
1e730 70 50 67 2c 20 30 2c 20 6e 42 79 74 65 48 64 72 pPg, 0, nByteHdr
1e740 29 3b 0a 20 20 20 20 70 50 67 2d 3e 70 44 61 74 );. pPg->pDat
1e750 61 20 3d 20 70 44 61 74 61 3b 0a 20 20 20 20 70 a = pData;. p
1e760 50 67 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 Pg->pPager = pPa
1e770 67 65 72 3b 0a 20 20 20 20 70 50 67 2d 3e 70 4e ger;. pPg->pN
1e780 65 78 74 41 6c 6c 20 3d 20 70 50 61 67 65 72 2d extAll = pPager-
1e790 3e 70 41 6c 6c 3b 0a 20 20 20 20 70 50 61 67 65 >pAll;. pPage
1e7a0 72 2d 3e 70 41 6c 6c 20 3d 20 70 50 67 3b 0a 20 r->pAll = pPg;.
1e7b0 20 20 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 pPager->nPage
1e7c0 2b 2b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ++;. }else{.
1e7d0 20 2f 2a 20 52 65 63 79 63 6c 65 20 61 6e 20 65 /* Recycle an e
1e7e0 78 69 73 74 69 6e 67 20 70 61 67 65 20 77 69 74 xisting page wit
1e7f0 68 20 61 20 7a 65 72 6f 20 72 65 66 2d 63 6f 75 h a zero ref-cou
1e800 6e 74 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 nt. */. rc =
1e810 70 61 67 65 72 5f 72 65 63 79 63 6c 65 28 70 50 pager_recycle(pP
1e820 61 67 65 72 2c 20 26 70 50 67 29 3b 0a 20 20 20 ager, &pPg);.
1e830 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1e840 42 55 53 59 20 29 7b 0a 20 20 20 20 20 20 72 63 BUSY ){. rc
1e850 20 3d 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f = SQLITE_IOERR_
1e860 42 4c 4f 43 4b 45 44 3b 0a 20 20 20 20 7d 0a 20 BLOCKED;. }.
1e870 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1e880 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 67 6f E_OK ){. go
1e890 74 6f 20 70 61 67 65 72 5f 61 6c 6c 6f 63 61 74 to pager_allocat
1e8a0 65 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 e_out;. }.
1e8b0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
1e8c0 3e 73 74 61 74 65 3e 3d 53 48 41 52 45 44 5f 4c >state>=SHARED_L
1e8d0 4f 43 4b 20 29 3b 0a 20 20 20 20 61 73 73 65 72 OCK );. asser
1e8e0 74 28 70 50 67 29 3b 0a 20 20 7d 0a 20 20 2a 70 t(pPg);. }. *p
1e8f0 70 50 67 20 3d 20 70 50 67 3b 0a 0a 70 61 67 65 pPg = pPg;..page
1e900 72 5f 61 6c 6c 6f 63 61 74 65 5f 6f 75 74 3a 0a r_allocate_out:.
1e910 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1e920 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 /*.** Make sure
1e930 77 65 20 68 61 76 65 20 74 68 65 20 63 6f 6e 74 we have the cont
1e940 65 6e 74 20 66 6f 72 20 61 20 70 61 67 65 2e 20 ent for a page.
1e950 20 49 66 20 74 68 65 20 70 61 67 65 20 77 61 73 If the page was
1e960 0a 2a 2a 20 70 72 65 76 69 6f 75 73 6c 79 20 61 .** previously a
1e970 63 71 75 69 72 65 64 20 77 69 74 68 20 6e 6f 43 cquired with noC
1e980 6f 6e 74 65 6e 74 3d 3d 31 2c 20 74 68 65 6e 20 ontent==1, then
1e990 74 68 65 20 63 6f 6e 74 65 6e 74 20 77 61 73 0a the content was.
1e9a0 2a 2a 20 6a 75 73 74 20 69 6e 69 74 69 61 6c 69 ** just initiali
1e9b0 7a 65 64 20 74 6f 20 7a 65 72 6f 73 20 69 6e 73 zed to zeros ins
1e9c0 74 65 61 64 20 6f 66 20 62 65 69 6e 67 20 72 65 tead of being re
1e9d0 61 64 20 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2a ad from disk..**
1e9e0 20 42 75 74 20 6e 6f 77 20 77 65 20 6e 65 65 64 But now we need
1e9f0 20 74 68 65 20 72 65 61 6c 20 64 61 74 61 20 6f the real data o
1ea00 66 66 20 6f 66 20 64 69 73 6b 2e 20 20 53 6f 20 ff of disk. So
1ea10 6d 61 6b 65 20 73 75 72 65 20 77 65 0a 2a 2a 20 make sure we.**
1ea20 68 61 76 65 20 69 74 2e 20 20 52 65 61 64 20 69 have it. Read i
1ea30 74 20 69 6e 20 69 66 20 77 65 20 64 6f 20 6e 6f t in if we do no
1ea40 74 20 68 61 76 65 20 69 74 20 61 6c 72 65 61 64 t have it alread
1ea50 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 y..*/.static int
1ea60 20 70 61 67 65 72 5f 67 65 74 5f 63 6f 6e 74 65 pager_get_conte
1ea70 6e 74 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a nt(PgHdr *pPg){.
1ea80 20 20 69 66 28 20 70 50 67 2d 3e 6e 65 65 64 52 if( pPg->needR
1ea90 65 61 64 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 ead ){. int r
1eaa0 63 20 3d 20 72 65 61 64 44 62 50 61 67 65 28 70 c = readDbPage(p
1eab0 50 67 2d 3e 70 50 61 67 65 72 2c 20 70 50 67 2c Pg->pPager, pPg,
1eac0 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 pPg->pgno);.
1ead0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1eae0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 67 2d OK ){. pPg-
1eaf0 3e 6e 65 65 64 52 65 61 64 20 3d 20 30 3b 0a 20 >needRead = 0;.
1eb00 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1eb10 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
1eb20 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 . }. return SQ
1eb30 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
1eb40 2a 20 41 63 71 75 69 72 65 20 61 20 70 61 67 65 * Acquire a page
1eb50 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6c ..**.** A read l
1eb60 6f 63 6b 20 6f 6e 20 74 68 65 20 64 69 73 6b 20 ock on the disk
1eb70 66 69 6c 65 20 69 73 20 6f 62 74 61 69 6e 65 64 file is obtained
1eb80 20 77 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 when the first
1eb90 70 61 67 65 20 69 73 20 61 63 71 75 69 72 65 64 page is acquired
1eba0 2e 20 0a 2a 2a 20 54 68 69 73 20 72 65 61 64 20 . .** This read
1ebb0 6c 6f 63 6b 20 69 73 20 64 72 6f 70 70 65 64 20 lock is dropped
1ebc0 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 70 61 when the last pa
1ebd0 67 65 20 69 73 20 72 65 6c 65 61 73 65 64 2e 0a ge is released..
1ebe0 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
1ebf0 6e 65 20 77 6f 72 6b 73 20 66 6f 72 20 61 6e 79 ne works for any
1ec00 20 70 61 67 65 20 6e 75 6d 62 65 72 20 67 72 65 page number gre
1ec10 61 74 65 72 20 74 68 61 6e 20 30 2e 20 20 49 66 ater than 0. If
1ec20 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a the database.**
1ec30 20 66 69 6c 65 20 69 73 20 73 6d 61 6c 6c 65 72 file is smaller
1ec40 20 74 68 61 6e 20 74 68 65 20 72 65 71 75 65 73 than the reques
1ec50 74 65 64 20 70 61 67 65 2c 20 74 68 65 6e 20 6e ted page, then n
1ec60 6f 20 61 63 74 75 61 6c 20 64 69 73 6b 0a 2a 2a o actual disk.**
1ec70 20 72 65 61 64 20 6f 63 63 75 72 73 20 61 6e 64 read occurs and
1ec80 20 74 68 65 20 6d 65 6d 6f 72 79 20 69 6d 61 67 the memory imag
1ec90 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 69 73 e of the page is
1eca0 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 0a initialized to.
1ecb0 2a 2a 20 61 6c 6c 20 7a 65 72 6f 73 2e 20 20 54 ** all zeros. T
1ecc0 68 65 20 65 78 74 72 61 20 64 61 74 61 20 61 70 he extra data ap
1ecd0 70 65 6e 64 65 64 20 74 6f 20 61 20 70 61 67 65 pended to a page
1ece0 20 69 73 20 61 6c 77 61 79 73 20 69 6e 69 74 69 is always initi
1ecf0 61 6c 69 7a 65 64 0a 2a 2a 20 74 6f 20 7a 65 72 alized.** to zer
1ed00 6f 73 20 74 68 65 20 66 69 72 73 74 20 74 69 6d os the first tim
1ed10 65 20 61 20 70 61 67 65 20 69 73 20 6c 6f 61 64 e a page is load
1ed20 65 64 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 0a ed into memory..
1ed30 2a 2a 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 73 **.** The acquis
1ed40 69 74 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 6c ition might fail
1ed50 20 66 6f 72 20 73 65 76 65 72 61 6c 20 72 65 61 for several rea
1ed60 73 6f 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 61 sons. In all ca
1ed70 73 65 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 6f ses,.** an appro
1ed80 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f 64 priate error cod
1ed90 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 6e e is returned an
1eda0 64 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 74 d *ppPage is set
1edb0 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 to NULL..**.**
1edc0 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 33 See also sqlite3
1edd0 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29 2e 20 20 PagerLookup().
1ede0 42 6f 74 68 20 74 68 69 73 20 72 6f 75 74 69 6e Both this routin
1edf0 65 20 61 6e 64 20 4c 6f 6f 6b 75 70 28 29 20 61 e and Lookup() a
1ee00 74 74 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69 6e ttempt.** to fin
1ee10 64 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 20 d a page in the
1ee20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 in-memory cache
1ee30 66 69 72 73 74 2e 20 20 49 66 20 74 68 65 20 70 first. If the p
1ee40 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 age is not alrea
1ee50 64 79 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 2c dy.** in memory,
1ee60 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 67 6f this routine go
1ee70 65 73 20 74 6f 20 64 69 73 6b 20 74 6f 20 72 65 es to disk to re
1ee80 61 64 20 69 74 20 69 6e 20 77 68 65 72 65 61 73 ad it in whereas
1ee90 20 4c 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a 75 73 Lookup().** jus
1eea0 74 20 72 65 74 75 72 6e 73 20 30 2e 20 20 54 68 t returns 0. Th
1eeb0 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71 75 69 is routine acqui
1eec0 72 65 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 res a read-lock
1eed0 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 the first time i
1eee0 74 0a 2a 2a 20 68 61 73 20 74 6f 20 67 6f 20 74 t.** has to go t
1eef0 6f 20 64 69 73 6b 2c 20 61 6e 64 20 63 6f 75 6c o disk, and coul
1ef00 64 20 61 6c 73 6f 20 70 6c 61 79 62 61 63 6b 20 d also playback
1ef10 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 69 an old journal i
1ef20 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a 20 f necessary..**
1ef30 53 69 6e 63 65 20 4c 6f 6f 6b 75 70 28 29 20 6e Since Lookup() n
1ef40 65 76 65 72 20 67 6f 65 73 20 74 6f 20 64 69 73 ever goes to dis
1ef50 6b 2c 20 69 74 20 6e 65 76 65 72 20 68 61 73 20 k, it never has
1ef60 74 6f 20 64 65 61 6c 20 77 69 74 68 20 6c 6f 63 to deal with loc
1ef70 6b 73 0a 2a 2a 20 6f 72 20 6a 6f 75 72 6e 61 6c ks.** or journal
1ef80 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 files..**.** If
1ef90 20 6e 6f 43 6f 6e 74 65 6e 74 20 69 73 20 66 61 noContent is fa
1efa0 6c 73 65 2c 20 74 68 65 20 70 61 67 65 20 63 6f lse, the page co
1efb0 6e 74 65 6e 74 73 20 61 72 65 20 61 63 74 75 61 ntents are actua
1efc0 6c 6c 79 20 72 65 61 64 20 66 72 6f 6d 20 64 69 lly read from di
1efd0 73 6b 2e 0a 2a 2a 20 49 66 20 6e 6f 43 6f 6e 74 sk..** If noCont
1efe0 65 6e 74 20 69 73 20 74 72 75 65 2c 20 69 74 20 ent is true, it
1eff0 6d 65 61 6e 73 20 74 68 61 74 20 77 65 20 64 6f means that we do
1f000 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 20 not care about
1f010 74 68 65 20 63 6f 6e 74 65 6e 74 73 0a 2a 2a 20 the contents.**
1f020 6f 66 20 74 68 65 20 70 61 67 65 20 61 74 20 74 of the page at t
1f030 68 69 73 20 74 69 6d 65 2c 20 73 6f 20 64 6f 20 his time, so do
1f040 6e 6f 74 20 64 6f 20 61 20 64 69 73 6b 20 72 65 not do a disk re
1f050 61 64 2e 20 20 4a 75 73 74 20 66 69 6c 6c 20 69 ad. Just fill i
1f060 6e 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 63 6f n the.** page co
1f070 6e 74 65 6e 74 20 77 69 74 68 20 7a 65 72 6f 73 ntent with zeros
1f080 2e 20 20 42 75 74 20 6d 61 72 6b 20 74 68 65 20 . But mark the
1f090 66 61 63 74 20 74 68 61 74 20 77 65 20 68 61 76 fact that we hav
1f0a0 65 20 6e 6f 74 20 72 65 61 64 20 74 68 65 0a 2a e not read the.*
1f0b0 2a 20 63 6f 6e 74 65 6e 74 20 62 79 20 73 65 74 * content by set
1f0c0 74 69 6e 67 20 74 68 65 20 50 67 48 64 72 2e 6e ting the PgHdr.n
1f0d0 65 65 64 52 65 61 64 20 66 6c 61 67 2e 20 20 4c eedRead flag. L
1f0e0 61 74 65 72 20 6f 6e 2c 20 69 66 20 0a 2a 2a 20 ater on, if .**
1f0f0 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
1f100 65 28 29 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e e() is called on
1f110 20 74 68 69 73 20 70 61 67 65 20 6f 72 20 69 66 this page or if
1f120 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
1f130 0a 2a 2a 20 63 61 6c 6c 65 64 20 61 67 61 69 6e .** called again
1f140 20 77 69 74 68 20 6e 6f 43 6f 6e 74 65 6e 74 3d with noContent=
1f150 3d 30 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74 =0, that means t
1f160 68 61 74 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 hat the content
1f170 69 73 20 6e 65 65 64 65 64 0a 2a 2a 20 61 6e 64 is needed.** and
1f180 20 74 68 65 20 64 69 73 6b 20 72 65 61 64 20 73 the disk read s
1f190 68 6f 75 6c 64 20 6f 63 63 75 72 20 61 74 20 74 hould occur at t
1f1a0 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2f 0a 73 74 hat point..*/.st
1f1b0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 41 63 atic int pagerAc
1f1c0 71 75 69 72 65 28 0a 20 20 50 61 67 65 72 20 2a quire(. Pager *
1f1d0 70 50 61 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 pPager, /*
1f1e0 54 68 65 20 70 61 67 65 72 20 6f 70 65 6e 20 6f The pager open o
1f1f0 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
1f200 69 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 ile */. Pgno pg
1f210 6e 6f 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 no, /*
1f220 50 61 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 Page number to f
1f230 65 74 63 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 etch */. DbPage
1f240 20 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 2f 2a **ppPage, /*
1f250 20 57 72 69 74 65 20 61 20 70 6f 69 6e 74 65 72 Write a pointer
1f260 20 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 72 to the page her
1f270 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e e */. int noCon
1f280 74 65 6e 74 20 20 20 20 20 20 20 2f 2a 20 44 6f tent /* Do
1f290 20 6e 6f 74 20 62 6f 74 68 65 72 20 72 65 61 64 not bother read
1f2a0 69 6e 67 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d ing content from
1f2b0 20 64 69 73 6b 20 69 66 20 74 72 75 65 20 2a 2f disk if true */
1f2c0 0a 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 .){. PgHdr *pPg
1f2d0 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 61 ;. int rc;.. a
1f2e0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 ssert( pPager->s
1f2f0 74 61 74 65 3d 3d 50 41 47 45 52 5f 55 4e 4c 4f tate==PAGER_UNLO
1f300 43 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6e 52 CK || pPager->nR
1f310 65 66 3e 30 20 7c 7c 20 70 67 6e 6f 3d 3d 31 20 ef>0 || pgno==1
1f320 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 6d 61 78 );.. /* The max
1f330 69 6d 75 6d 20 70 61 67 65 20 6e 75 6d 62 65 72 imum page number
1f340 20 69 73 20 32 5e 33 31 2e 20 52 65 74 75 72 6e is 2^31. Return
1f350 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 20 SQLITE_CORRUPT
1f360 69 66 20 61 20 70 61 67 65 0a 20 20 2a 2a 20 6e if a page. ** n
1f370 75 6d 62 65 72 20 67 72 65 61 74 65 72 20 74 68 umber greater th
1f380 61 6e 20 74 68 69 73 2c 20 6f 72 20 7a 65 72 6f an this, or zero
1f390 2c 20 69 73 20 72 65 71 75 65 73 74 65 64 2e 0a , is requested..
1f3a0 20 20 2a 2f 0a 20 20 69 66 28 20 70 67 6e 6f 3e */. if( pgno>
1f3b0 50 41 47 45 52 5f 4d 41 58 5f 50 47 4e 4f 20 7c PAGER_MAX_PGNO |
1f3c0 7c 20 70 67 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e | pgno==0 || pgn
1f3d0 6f 3d 3d 50 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f o==PAGER_MJ_PGNO
1f3e0 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
1f3f0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f return SQLITE_CO
1f400 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a RRUPT_BKPT;. }.
1f410 0a 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 . /* Make sure
1f420 77 65 20 68 61 76 65 20 6e 6f 74 20 68 69 74 20 we have not hit
1f430 61 6e 79 20 63 72 69 74 69 63 61 6c 20 65 72 72 any critical err
1f440 6f 72 73 2e 0a 20 20 2a 2f 20 0a 20 20 61 73 73 ors.. */ . ass
1f450 65 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 29 ert( pPager!=0 )
1f460 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b ;. *ppPage = 0;
1f470 0a 0a 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 .. /* If this i
1f480 73 20 74 68 65 20 66 69 72 73 74 20 70 61 67 65 s the first page
1f490 20 61 63 63 65 73 73 65 64 2c 20 74 68 65 6e 20 accessed, then
1f4a0 67 65 74 20 61 20 53 48 41 52 45 44 20 6c 6f 63 get a SHARED loc
1f4b0 6b 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 64 61 k. ** on the da
1f4c0 74 61 62 61 73 65 20 66 69 6c 65 2e 20 70 61 67 tabase file. pag
1f4d0 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 29 20 69 erSharedLock() i
1f4e0 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 0a 20 20 s a no-op if .
1f4f0 2a 2a 20 61 20 64 61 74 61 62 61 73 65 20 6c 6f ** a database lo
1f500 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 ck is already he
1f510 6c 64 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d 20 ld.. */. rc =
1f520 70 61 67 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 pagerSharedLock(
1f530 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 72 pPager);. if( r
1f540 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
1f550 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1f560 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 }. assert( pPa
1f570 67 65 72 2d 3e 73 74 61 74 65 21 3d 50 41 47 45 ger->state!=PAGE
1f580 52 5f 55 4e 4c 4f 43 4b 20 29 3b 0a 0a 20 20 70 R_UNLOCK );.. p
1f590 50 67 20 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 Pg = pager_looku
1f5a0 70 28 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b p(pPager, pgno);
1f5b0 0a 20 20 69 66 28 20 70 50 67 3d 3d 30 20 29 7b . if( pPg==0 ){
1f5c0 0a 20 20 20 20 2f 2a 20 54 68 65 20 72 65 71 75 . /* The requ
1f5d0 65 73 74 65 64 20 70 61 67 65 20 69 73 20 6e 6f ested page is no
1f5e0 74 20 69 6e 20 74 68 65 20 70 61 67 65 20 63 61 t in the page ca
1f5f0 63 68 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 che. */. int
1f600 6e 4d 61 78 3b 0a 20 20 20 20 69 6e 74 20 68 3b nMax;. int h;
1f610 0a 20 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28 . PAGER_INCR(
1f620 70 50 61 67 65 72 2d 3e 6e 4d 69 73 73 29 3b 0a pPager->nMiss);.
1f630 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 41 6c rc = pagerAl
1f640 6c 6f 63 61 74 65 50 61 67 65 28 70 50 61 67 65 locatePage(pPage
1f650 72 2c 20 26 70 50 67 29 3b 0a 20 20 20 20 69 66 r, &pPg);. if
1f660 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1f670 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 ){. return
1f680 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 rc;. }.. p
1f690 50 67 2d 3e 70 67 6e 6f 20 3d 20 70 67 6e 6f 3b Pg->pgno = pgno;
1f6a0 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 4d 45 . assert( !ME
1f6b0 4d 44 42 20 7c 7c 20 70 67 6e 6f 3e 70 50 61 67 MDB || pgno>pPag
1f6c0 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 29 3b 0a er->stmtSize );.
1f6d0 20 20 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e pPg->inJourn
1f6e0 61 6c 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 al = sqlite3Bitv
1f6f0 65 63 54 65 73 74 28 70 50 61 67 65 72 2d 3e 70 ecTest(pPager->p
1f700 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 67 6e 6f 29 InJournal, pgno)
1f710 3b 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 ;. pPg->needS
1f720 79 6e 63 20 3d 20 30 3b 0a 0a 20 20 20 20 6d 61 ync = 0;.. ma
1f730 6b 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 keClean(pPg);.
1f740 20 20 70 50 67 2d 3e 6e 52 65 66 20 3d 20 31 3b pPg->nRef = 1;
1f750 0a 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 .. pPager->nR
1f760 65 66 2b 2b 3b 0a 20 20 20 20 69 66 28 20 70 50 ef++;. if( pP
1f770 61 67 65 72 2d 3e 6e 45 78 74 72 61 3e 30 20 29 ager->nExtra>0 )
1f780 7b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 50 {. memset(P
1f790 47 48 44 52 5f 54 4f 5f 45 58 54 52 41 28 70 50 GHDR_TO_EXTRA(pP
1f7a0 67 2c 20 70 50 61 67 65 72 29 2c 20 30 2c 20 70 g, pPager), 0, p
1f7b0 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a Pager->nExtra);.
1f7c0 20 20 20 20 7d 0a 20 20 20 20 6e 4d 61 78 20 3d }. nMax =
1f7d0 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
1f7e0 65 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b 0a ecount(pPager);.
1f7f0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
1f800 65 72 72 43 6f 64 65 20 29 7b 0a 20 20 20 20 20 errCode ){.
1f810 20 72 63 20 3d 20 70 50 61 67 65 72 2d 3e 65 72 rc = pPager->er
1f820 72 43 6f 64 65 3b 0a 20 20 20 20 20 20 73 71 6c rCode;. sql
1f830 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
1f840 50 67 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 Pg);. retur
1f850 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 n rc;. }..
1f860 20 2f 2a 20 50 6f 70 75 6c 61 74 65 20 74 68 65 /* Populate the
1f870 20 70 61 67 65 20 77 69 74 68 20 64 61 74 61 2c page with data,
1f880 20 65 69 74 68 65 72 20 62 79 20 72 65 61 64 69 either by readi
1f890 6e 67 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ng from the data
1f8a0 62 61 73 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 base. ** file
1f8b0 2c 20 6f 72 20 62 79 20 73 65 74 74 69 6e 67 20 , or by setting
1f8c0 74 68 65 20 65 6e 74 69 72 65 20 70 61 67 65 20 the entire page
1f8d0 74 6f 20 7a 65 72 6f 2e 0a 20 20 20 20 2a 2f 0a to zero.. */.
1f8e0 20 20 20 20 69 66 28 20 6e 4d 61 78 3c 28 69 6e if( nMax<(in
1f8f0 74 29 70 67 6e 6f 20 7c 7c 20 4d 45 4d 44 42 20 t)pgno || MEMDB
1f900 7c 7c 20 28 6e 6f 43 6f 6e 74 65 6e 74 20 26 26 || (noContent &&
1f910 20 21 70 50 61 67 65 72 2d 3e 61 6c 77 61 79 73 !pPager->always
1f920 52 6f 6c 6c 62 61 63 6b 29 20 29 7b 0a 20 20 20 Rollback) ){.
1f930 20 20 20 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 if( pgno>pPag
1f940 65 72 2d 3e 6d 78 50 67 6e 6f 20 29 7b 0a 20 20 er->mxPgno ){.
1f950 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 67 sqlite3Pag
1f960 65 72 55 6e 72 65 66 28 70 50 67 29 3b 0a 20 20 erUnref(pPg);.
1f970 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c return SQL
1f980 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 20 20 20 20 ITE_FULL;.
1f990 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 50 }. memset(P
1f9a0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 GHDR_TO_DATA(pPg
1f9b0 29 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e 70 61 ), 0, pPager->pa
1f9c0 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 70 geSize);. p
1f9d0 50 67 2d 3e 6e 65 65 64 52 65 61 64 20 3d 20 6e Pg->needRead = n
1f9e0 6f 43 6f 6e 74 65 6e 74 20 26 26 20 21 70 50 61 oContent && !pPa
1f9f0 67 65 72 2d 3e 61 6c 77 61 79 73 52 6f 6c 6c 62 ger->alwaysRollb
1fa00 61 63 6b 3b 0a 20 20 20 20 20 20 49 4f 54 52 41 ack;. IOTRA
1fa10 43 45 28 28 22 5a 45 52 4f 20 25 70 20 25 64 5c CE(("ZERO %p %d\
1fa20 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 67 6e 6f n", pPager, pgno
1fa30 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ));. }else{.
1fa40 20 20 20 20 20 72 63 20 3d 20 72 65 61 64 44 62 rc = readDb
1fa50 50 61 67 65 28 70 50 61 67 65 72 2c 20 70 50 67 Page(pPager, pPg
1fa60 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69 , pgno);. i
1fa70 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1fa80 20 26 26 20 72 63 21 3d 53 51 4c 49 54 45 5f 49 && rc!=SQLITE_I
1fa90 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 OERR_SHORT_READ
1faa0 29 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e ){. pPg->
1fab0 70 67 6e 6f 20 3d 20 30 3b 0a 20 20 20 20 20 20 pgno = 0;.
1fac0 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e sqlite3PagerUn
1fad0 72 65 66 28 70 50 67 29 3b 0a 20 20 20 20 20 20 ref(pPg);.
1fae0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
1faf0 20 20 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e }. pPg->
1fb00 6e 65 65 64 52 65 61 64 20 3d 20 30 3b 0a 20 20 needRead = 0;.
1fb10 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 4c 69 6e 6b }.. /* Link
1fb20 20 74 68 65 20 70 61 67 65 20 69 6e 74 6f 20 74 the page into t
1fb30 68 65 20 70 61 67 65 20 68 61 73 68 20 74 61 62 he page hash tab
1fb40 6c 65 20 2a 2f 0a 20 20 20 20 68 20 3d 20 70 67 le */. h = pg
1fb50 6e 6f 20 26 20 28 70 50 61 67 65 72 2d 3e 6e 48 no & (pPager->nH
1fb60 61 73 68 2d 31 29 3b 0a 20 20 20 20 61 73 73 65 ash-1);. asse
1fb70 72 74 28 20 70 67 6e 6f 21 3d 30 20 29 3b 0a 20 rt( pgno!=0 );.
1fb80 20 20 20 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 pPg->pNextHas
1fb90 68 20 3d 20 70 50 61 67 65 72 2d 3e 61 48 61 73 h = pPager->aHas
1fba0 68 5b 68 5d 3b 0a 20 20 20 20 70 50 61 67 65 72 h[h];. pPager
1fbb0 2d 3e 61 48 61 73 68 5b 68 5d 20 3d 20 70 50 67 ->aHash[h] = pPg
1fbc0 3b 0a 20 20 20 20 69 66 28 20 70 50 67 2d 3e 70 ;. if( pPg->p
1fbd0 4e 65 78 74 48 61 73 68 20 29 7b 0a 20 20 20 20 NextHash ){.
1fbe0 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 assert( pPg->p
1fbf0 4e 65 78 74 48 61 73 68 2d 3e 70 50 72 65 76 48 NextHash->pPrevH
1fc00 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ash==0 );.
1fc10 70 50 67 2d 3e 70 4e 65 78 74 48 61 73 68 2d 3e pPg->pNextHash->
1fc20 70 50 72 65 76 48 61 73 68 20 3d 20 70 50 67 3b pPrevHash = pPg;
1fc30 0a 20 20 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 . }..#ifdef S
1fc40 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
1fc50 53 0a 20 20 20 20 70 50 67 2d 3e 70 61 67 65 48 S. pPg->pageH
1fc60 61 73 68 20 3d 20 70 61 67 65 72 5f 70 61 67 65 ash = pager_page
1fc70 68 61 73 68 28 70 50 67 29 3b 0a 23 65 6e 64 69 hash(pPg);.#endi
1fc80 66 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f f. }else{. /
1fc90 2a 20 54 68 65 20 72 65 71 75 65 73 74 65 64 20 * The requested
1fca0 70 61 67 65 20 69 73 20 69 6e 20 74 68 65 20 70 page is in the p
1fcb0 61 67 65 20 63 61 63 68 65 2e 20 2a 2f 0a 20 20 age cache. */.
1fcc0 20 20 61 73 73 65 72 74 28 70 50 61 67 65 72 2d assert(pPager-
1fcd0 3e 6e 52 65 66 3e 30 20 7c 7c 20 70 67 6e 6f 3d >nRef>0 || pgno=
1fce0 3d 31 29 3b 0a 20 20 20 20 50 41 47 45 52 5f 49 =1);. PAGER_I
1fcf0 4e 43 52 28 70 50 61 67 65 72 2d 3e 6e 48 69 74 NCR(pPager->nHit
1fd00 29 3b 0a 20 20 20 20 69 66 28 20 21 6e 6f 43 6f );. if( !noCo
1fd10 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 72 ntent ){. r
1fd20 63 20 3d 20 70 61 67 65 72 5f 67 65 74 5f 63 6f c = pager_get_co
1fd30 6e 74 65 6e 74 28 70 50 67 29 3b 0a 20 20 20 20 ntent(pPg);.
1fd40 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 if( rc ){.
1fd50 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 return rc;.
1fd60 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
1fd70 20 70 61 67 65 5f 72 65 66 28 70 50 67 29 3b 0a page_ref(pPg);.
1fd80 20 20 7d 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 }. *ppPage =
1fd90 70 50 67 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 pPg;. return SQ
1fda0 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 69 6e 74 20 73 LITE_OK;.}.int s
1fdb0 71 6c 69 74 65 33 50 61 67 65 72 41 63 71 75 69 qlite3PagerAcqui
1fdc0 72 65 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 re(. Pager *pPa
1fdd0 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 ger, /* The
1fde0 20 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e 20 74 pager open on t
1fdf0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1fe00 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c */. Pgno pgno,
1fe10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
1fe20 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 74 63 e number to fetc
1fe30 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 2a h */. DbPage **
1fe40 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 57 72 ppPage, /* Wr
1fe50 69 74 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f ite a pointer to
1fe60 20 74 68 65 20 70 61 67 65 20 68 65 72 65 20 2a the page here *
1fe70 2f 0a 20 20 69 6e 74 20 6e 6f 43 6f 6e 74 65 6e /. int noConten
1fe80 74 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f t /* Do no
1fe90 74 20 62 6f 74 68 65 72 20 72 65 61 64 69 6e 67 t bother reading
1fea0 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d 20 64 69 content from di
1feb0 73 6b 20 69 66 20 74 72 75 65 20 2a 2f 0a 29 7b sk if true */.){
1fec0 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 61 67 . int rc;. pag
1fed0 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b erEnter(pPager);
1fee0 0a 20 20 72 63 20 3d 20 70 61 67 65 72 41 63 71 . rc = pagerAcq
1fef0 75 69 72 65 28 70 50 61 67 65 72 2c 20 70 67 6e uire(pPager, pgn
1ff00 6f 2c 20 70 70 50 61 67 65 2c 20 6e 6f 43 6f 6e o, ppPage, noCon
1ff10 74 65 6e 74 29 3b 0a 20 20 70 61 67 65 72 4c 65 tent);. pagerLe
1ff20 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 ave(pPager);. r
1ff30 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a eturn rc;.}.../*
1ff40 0a 2a 2a 20 41 63 71 75 69 72 65 20 61 20 70 61 .** Acquire a pa
1ff50 67 65 20 69 66 20 69 74 20 69 73 20 61 6c 72 65 ge if it is alre
1ff60 61 64 79 20 69 6e 20 74 68 65 20 69 6e 2d 6d 65 ady in the in-me
1ff70 6d 6f 72 79 20 63 61 63 68 65 2e 20 20 44 6f 0a mory cache. Do.
1ff80 2a 2a 20 6e 6f 74 20 72 65 61 64 20 74 68 65 20 ** not read the
1ff90 70 61 67 65 20 66 72 6f 6d 20 64 69 73 6b 2e 20 page from disk.
1ffa0 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 Return a pointe
1ffb0 72 20 74 6f 20 74 68 65 20 70 61 67 65 2c 0a 2a r to the page,.*
1ffc0 2a 20 6f 72 20 30 20 69 66 20 74 68 65 20 70 61 * or 0 if the pa
1ffd0 67 65 20 69 73 20 6e 6f 74 20 69 6e 20 63 61 63 ge is not in cac
1ffe0 68 65 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 61 6c he..**.** See al
1fff0 73 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 so sqlite3PagerG
20000 65 74 28 29 2e 20 20 54 68 65 20 64 69 66 66 65 et(). The diffe
20010 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 rence between th
20020 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 61 6e is routine.** an
20030 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 d sqlite3PagerGe
20040 74 28 29 20 69 73 20 74 68 61 74 20 5f 67 65 74 t() is that _get
20050 28 29 20 77 69 6c 6c 20 67 6f 20 74 6f 20 74 68 () will go to th
20060 65 20 64 69 73 6b 20 61 6e 64 20 72 65 61 64 0a e disk and read.
20070 2a 2a 20 69 6e 20 74 68 65 20 70 61 67 65 20 69 ** in the page i
20080 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f f the page is no
20090 74 20 61 6c 72 65 61 64 79 20 69 6e 20 63 61 63 t already in cac
200a0 68 65 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e he. This routin
200b0 65 0a 2a 2a 20 72 65 74 75 72 6e 73 20 4e 55 4c e.** returns NUL
200c0 4c 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 L if the page is
200d0 20 6e 6f 74 20 69 6e 20 63 61 63 68 65 20 6f 72 not in cache or
200e0 20 69 66 20 61 20 64 69 73 6b 20 49 2f 4f 20 65 if a disk I/O e
200f0 72 72 6f 72 20 0a 2a 2a 20 68 61 73 20 65 76 65 rror .** has eve
20100 72 20 68 61 70 70 65 6e 65 64 2e 0a 2a 2f 0a 44 r happened..*/.D
20110 62 50 61 67 65 20 2a 73 71 6c 69 74 65 33 50 61 bPage *sqlite3Pa
20120 67 65 72 4c 6f 6f 6b 75 70 28 50 61 67 65 72 20 gerLookup(Pager
20130 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67 *pPager, Pgno pg
20140 6e 6f 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 no){. PgHdr *pP
20150 67 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 g = 0;.. assert
20160 28 20 70 50 61 67 65 72 21 3d 30 20 29 3b 0a 20 ( pPager!=0 );.
20170 20 61 73 73 65 72 74 28 20 70 67 6e 6f 21 3d 30 assert( pgno!=0
20180 20 29 3b 0a 0a 20 20 70 61 67 65 72 45 6e 74 65 );.. pagerEnte
20190 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 r(pPager);. if(
201a0 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d pPager->state==
201b0 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 29 7b 0a PAGER_UNLOCK ){.
201c0 20 20 20 20 61 73 73 65 72 74 28 20 21 70 50 61 assert( !pPa
201d0 67 65 72 2d 3e 70 41 6c 6c 20 7c 7c 20 70 50 61 ger->pAll || pPa
201e0 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
201f0 64 65 20 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 de );. }else if
20200 28 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 ( pPager->errCod
20210 65 20 26 26 20 70 50 61 67 65 72 2d 3e 65 72 72 e && pPager->err
20220 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 46 55 4c Code!=SQLITE_FUL
20230 4c 20 29 7b 0a 20 20 20 20 2f 2a 20 44 6f 20 6e L ){. /* Do n
20240 6f 74 68 69 6e 67 20 2a 2f 0a 20 20 7d 65 6c 73 othing */. }els
20250 65 20 69 66 28 20 28 70 50 67 20 3d 20 70 61 67 e if( (pPg = pag
20260 65 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 er_lookup(pPager
20270 2c 20 70 67 6e 6f 29 29 21 3d 30 20 29 7b 0a 20 , pgno))!=0 ){.
20280 20 20 20 70 61 67 65 5f 72 65 66 28 70 50 67 29 page_ref(pPg)
20290 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c 65 61 ;. }. pagerLea
202a0 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65 ve(pPager);. re
202b0 74 75 72 6e 20 70 50 67 3b 0a 7d 0a 0a 2f 2a 0a turn pPg;.}../*.
202c0 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 70 61 67 ** Release a pag
202d0 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
202e0 6e 75 6d 62 65 72 20 6f 66 20 72 65 66 65 72 65 number of refere
202f0 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61 67 65 nces to the page
20300 20 64 72 6f 70 20 74 6f 20 7a 65 72 6f 2c 20 74 drop to zero, t
20310 68 65 6e 20 74 68 65 0a 2a 2a 20 70 61 67 65 20 hen the.** page
20320 69 73 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 is added to the
20330 4c 52 55 20 6c 69 73 74 2e 20 20 57 68 65 6e 20 LRU list. When
20340 61 6c 6c 20 72 65 66 65 72 65 6e 63 65 73 20 74 all references t
20350 6f 20 61 6c 6c 20 70 61 67 65 73 0a 2a 2a 20 61 o all pages.** a
20360 72 65 20 72 65 6c 65 61 73 65 64 2c 20 61 20 72 re released, a r
20370 6f 6c 6c 62 61 63 6b 20 6f 63 63 75 72 73 20 61 ollback occurs a
20380 6e 64 20 74 68 65 20 6c 6f 63 6b 20 6f 6e 20 74 nd the lock on t
20390 68 65 20 64 61 74 61 62 61 73 65 20 69 73 0a 2a he database is.*
203a0 2a 20 72 65 6d 6f 76 65 64 2e 0a 2a 2f 0a 69 6e * removed..*/.in
203b0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e t sqlite3PagerUn
203c0 72 65 66 28 44 62 50 61 67 65 20 2a 70 50 67 29 ref(DbPage *pPg)
203d0 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 {. Pager *pPage
203e0 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b r = pPg->pPager;
203f0 0a 0a 20 20 2f 2a 20 44 65 63 72 65 6d 65 6e 74 .. /* Decrement
20400 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 20 63 the reference c
20410 6f 75 6e 74 20 66 6f 72 20 74 68 69 73 20 70 61 ount for this pa
20420 67 65 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 ge. */. assert
20430 28 20 70 50 67 2d 3e 6e 52 65 66 3e 30 20 29 3b ( pPg->nRef>0 );
20440 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 50 . pagerEnter(pP
20450 67 2d 3e 70 50 61 67 65 72 29 3b 0a 20 20 70 50 g->pPager);. pP
20460 67 2d 3e 6e 52 65 66 2d 2d 3b 0a 0a 20 20 43 48 g->nRef--;.. CH
20470 45 43 4b 5f 50 41 47 45 28 70 50 67 29 3b 0a 0a ECK_PAGE(pPg);..
20480 20 20 2f 2a 20 57 68 65 6e 20 74 68 65 20 6e 75 /* When the nu
20490 6d 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 mber of referenc
204a0 65 73 20 74 6f 20 61 20 70 61 67 65 20 72 65 61 es to a page rea
204b0 63 68 20 30 2c 20 63 61 6c 6c 20 74 68 65 0a 20 ch 0, call the.
204c0 20 2a 2a 20 64 65 73 74 72 75 63 74 6f 72 20 61 ** destructor a
204d0 6e 64 20 61 64 64 20 74 68 65 20 70 61 67 65 20 nd add the page
204e0 74 6f 20 74 68 65 20 66 72 65 65 6c 69 73 74 2e to the freelist.
204f0 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 67 2d . */. if( pPg-
20500 3e 6e 52 65 66 3d 3d 30 20 29 7b 0a 0a 20 20 20 >nRef==0 ){..
20510 20 6c 72 75 4c 69 73 74 41 64 64 28 70 50 67 29 lruListAdd(pPg)
20520 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 ;. if( pPager
20530 2d 3e 78 44 65 73 74 72 75 63 74 6f 72 20 29 7b ->xDestructor ){
20540 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 78 . pPager->x
20550 44 65 73 74 72 75 63 74 6f 72 28 70 50 67 2c 20 Destructor(pPg,
20560 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
20570 29 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 );. }. .
20580 2f 2a 20 57 68 65 6e 20 61 6c 6c 20 70 61 67 65 /* When all page
20590 73 20 72 65 61 63 68 20 74 68 65 20 66 72 65 65 s reach the free
205a0 6c 69 73 74 2c 20 64 72 6f 70 20 74 68 65 20 72 list, drop the r
205b0 65 61 64 20 6c 6f 63 6b 20 66 72 6f 6d 0a 20 20 ead lock from.
205c0 20 20 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 ** the databas
205d0 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2f 0a 20 e file.. */.
205e0 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 2d pPager->nRef-
205f0 2d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 -;. assert( p
20600 50 61 67 65 72 2d 3e 6e 52 65 66 3e 3d 30 20 29 Pager->nRef>=0 )
20610 3b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 ;. if( pPager
20620 2d 3e 6e 52 65 66 3d 3d 30 20 26 26 20 28 21 70 ->nRef==0 && (!p
20630 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 Pager->exclusive
20640 4d 6f 64 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e Mode || pPager->
20650 6a 6f 75 72 6e 61 6c 4f 66 66 3e 30 29 20 29 7b journalOff>0) ){
20660 0a 20 20 20 20 20 20 70 61 67 65 72 55 6e 6c 6f . pagerUnlo
20670 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b 28 70 50 ckAndRollback(pP
20680 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d ager);. }. }
20690 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50 . pagerLeave(pP
206a0 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e 20 ager);. return
206b0 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
206c0 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6a 6f 75 .** Create a jou
206d0 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 70 50 rnal file for pP
206e0 61 67 65 72 2e 20 20 54 68 65 72 65 20 73 68 6f ager. There sho
206f0 75 6c 64 20 61 6c 72 65 61 64 79 20 62 65 20 61 uld already be a
20700 20 52 45 53 45 52 56 45 44 0a 2a 2a 20 6f 72 20 RESERVED.** or
20710 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f EXCLUSIVE lock o
20720 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
20730 69 6c 65 20 77 68 65 6e 20 74 68 69 73 20 72 6f ile when this ro
20740 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e utine is called.
20750 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 .**.** Return SQ
20760 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65 72 79 LITE_OK if every
20770 74 68 69 6e 67 2e 20 20 52 65 74 75 72 6e 20 61 thing. Return a
20780 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 n error code and
20790 20 72 65 6c 65 61 73 65 20 74 68 65 0a 2a 2a 20 release the.**
207a0 77 72 69 74 65 20 6c 6f 63 6b 20 69 66 20 61 6e write lock if an
207b0 79 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e ything goes wron
207c0 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 g..*/.static int
207d0 20 70 61 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 pager_open_jour
207e0 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 nal(Pager *pPage
207f0 72 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 r){. sqlite3_vf
20800 73 20 2a 70 56 66 73 20 3d 20 70 50 61 67 65 72 s *pVfs = pPager
20810 2d 3e 70 56 66 73 3b 0a 20 20 69 6e 74 20 66 6c ->pVfs;. int fl
20820 61 67 73 20 3d 20 28 53 51 4c 49 54 45 5f 4f 50 ags = (SQLITE_OP
20830 45 4e 5f 52 45 41 44 57 52 49 54 45 7c 53 51 4c EN_READWRITE|SQL
20840 49 54 45 5f 4f 50 45 4e 5f 45 58 43 4c 55 53 49 ITE_OPEN_EXCLUSI
20850 56 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 VE|SQLITE_OPEN_C
20860 52 45 41 54 45 29 3b 0a 0a 20 20 69 6e 74 20 72 REATE);.. int r
20870 63 3b 0a 20 20 61 73 73 65 72 74 28 20 21 4d 45 c;. assert( !ME
20880 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 28 MDB );. assert(
20890 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 3e 3d pPager->state>=
208a0 50 41 47 45 52 5f 52 45 53 45 52 56 45 44 20 29 PAGER_RESERVED )
208b0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
208c0 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 29 er->useJournal )
208d0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
208e0 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d er->pInJournal==
208f0 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 50 61 0 );. sqlite3Pa
20900 67 65 72 50 61 67 65 63 6f 75 6e 74 28 70 50 61 gerPagecount(pPa
20910 67 65 72 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 ger);. pagerLea
20920 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 70 50 ve(pPager);. pP
20930 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c ager->pInJournal
20940 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 = sqlite3Bitvec
20950 43 72 65 61 74 65 28 70 50 61 67 65 72 2d 3e 64 Create(pPager->d
20960 62 53 69 7a 65 29 3b 0a 20 20 70 61 67 65 72 45 bSize);. pagerE
20970 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 nter(pPager);.
20980 69 66 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a if( pPager->pInJ
20990 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b 0a 20 20 20 ournal==0 ){.
209a0 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d rc = SQLITE_NOM
209b0 45 4d 3b 0a 20 20 20 20 67 6f 74 6f 20 66 61 69 EM;. goto fai
209c0 6c 65 64 5f 74 6f 5f 6f 70 65 6e 5f 6a 6f 75 72 led_to_open_jour
209d0 6e 61 6c 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 nal;. }.. if(
209e0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
209f0 70 65 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 pen==0 ){. if
20a00 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 ( pPager->tempFi
20a10 6c 65 20 29 7b 0a 20 20 20 20 20 20 66 6c 61 67 le ){. flag
20a20 73 20 7c 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45 s |= (SQLITE_OPE
20a30 4e 5f 44 45 4c 45 54 45 4f 4e 43 4c 4f 53 45 7c N_DELETEONCLOSE|
20a40 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 54 45 4d 50 SQLITE_OPEN_TEMP
20a50 5f 4a 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 20 7d _JOURNAL);. }
20a60 65 6c 73 65 7b 0a 20 20 20 20 20 20 66 6c 61 67 else{. flag
20a70 73 20 7c 3d 20 28 53 51 4c 49 54 45 5f 4f 50 45 s |= (SQLITE_OPE
20a80 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 3b N_MAIN_JOURNAL);
20a90 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 53 51 . }.#ifdef SQ
20aa0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d LITE_ENABLE_ATOM
20ab0 49 43 5f 57 52 49 54 45 0a 20 20 20 20 72 63 20 IC_WRITE. rc
20ac0 3d 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c = sqlite3Journal
20ad0 4f 70 65 6e 28 0a 20 20 20 20 20 20 20 20 70 56 Open(. pV
20ae0 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 fs, pPager->zJou
20af0 72 6e 61 6c 2c 20 70 50 61 67 65 72 2d 3e 6a 66 rnal, pPager->jf
20b00 64 2c 20 66 6c 61 67 73 2c 20 6a 72 6e 6c 42 75 d, flags, jrnlBu
20b10 66 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 29 fferSize(pPager)
20b20 0a 20 20 20 20 29 3b 0a 23 65 6c 73 65 0a 20 20 . );.#else.
20b30 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
20b40 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65 Open(pVfs, pPage
20b50 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 r->zJournal, pPa
20b60 67 65 72 2d 3e 6a 66 64 2c 20 66 6c 61 67 73 2c ger->jfd, flags,
20b70 20 30 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 0);.#endif.
20b80 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
20b90 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d TE_OK || pPager-
20ba0 3e 6a 66 64 2d 3e 70 4d 65 74 68 6f 64 73 20 29 >jfd->pMethods )
20bb0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f ;. pPager->jo
20bc0 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b 0a 20 20 urnalOff = 0;.
20bd0 20 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 pPager->setMas
20be0 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 ter = 0;. pPa
20bf0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 ger->journalHdr
20c00 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 72 63 21 = 0;. if( rc!
20c10 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
20c20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
20c30 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 TE_NOMEM ){.
20c40 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c sqlite3OsDel
20c50 65 74 65 28 70 56 66 73 2c 20 70 50 61 67 65 72 ete(pVfs, pPager
20c60 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 30 29 3b 0a ->zJournal, 0);.
20c70 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 67 6f }. go
20c80 74 6f 20 66 61 69 6c 65 64 5f 74 6f 5f 6f 70 65 to failed_to_ope
20c90 6e 5f 6a 6f 75 72 6e 61 6c 3b 0a 20 20 20 20 7d n_journal;. }
20ca0 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e 6a . }. pPager->j
20cb0 6f 75 72 6e 61 6c 4f 70 65 6e 20 3d 20 31 3b 0a ournalOpen = 1;.
20cc0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
20cd0 6c 53 74 61 72 74 65 64 20 3d 20 30 3b 0a 20 20 lStarted = 0;.
20ce0 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 pPager->needSync
20cf0 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e = 0;. pPager->
20d00 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 3d alwaysRollback =
20d10 20 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52 0;. pPager->nR
20d20 65 63 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 50 ec = 0;. if( pP
20d30 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b ager->errCode ){
20d40 0a 20 20 20 20 72 63 20 3d 20 70 50 61 67 65 72 . rc = pPager
20d50 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 20 67 ->errCode;. g
20d60 6f 74 6f 20 66 61 69 6c 65 64 5f 74 6f 5f 6f 70 oto failed_to_op
20d70 65 6e 5f 6a 6f 75 72 6e 61 6c 3b 0a 20 20 7d 0a en_journal;. }.
20d80 20 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 pPager->origDb
20d90 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 Size = pPager->d
20da0 62 53 69 7a 65 3b 0a 0a 20 20 72 63 20 3d 20 77 bSize;.. rc = w
20db0 72 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70 riteJournalHdr(p
20dc0 50 61 67 65 72 29 3b 0a 0a 20 20 69 66 28 20 70 Pager);.. if( p
20dd0 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f 6f Pager->stmtAutoo
20de0 70 65 6e 20 26 26 20 72 63 3d 3d 53 51 4c 49 54 pen && rc==SQLIT
20df0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d E_OK ){. rc =
20e00 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 74 6d sqlite3PagerStm
20e10 74 42 65 67 69 6e 28 70 50 61 67 65 72 29 3b 0a tBegin(pPager);.
20e20 20 20 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 }. if( rc!=SQ
20e30 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d 53 LITE_OK && rc!=S
20e40 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 26 26 20 72 QLITE_NOMEM && r
20e50 63 21 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f c!=SQLITE_IOERR_
20e60 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 72 63 20 NOMEM ){. rc
20e70 3d 20 70 61 67 65 72 5f 65 6e 64 5f 74 72 61 6e = pager_end_tran
20e80 73 61 63 74 69 6f 6e 28 70 50 61 67 65 72 29 3b saction(pPager);
20e90 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
20ea0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
20eb0 72 63 20 3d 20 53 51 4c 49 54 45 5f 46 55 4c 4c rc = SQLITE_FULL
20ec0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
20ed0 74 75 72 6e 20 72 63 3b 0a 0a 66 61 69 6c 65 64 turn rc;..failed
20ee0 5f 74 6f 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c _to_open_journal
20ef0 3a 0a 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 :. sqlite3Bitve
20f00 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 2d cDestroy(pPager-
20f10 3e 70 49 6e 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 >pInJournal);.
20f20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e pPager->pInJourn
20f30 61 6c 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e al = 0;. return
20f40 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 rc;.}../*.** Ac
20f50 71 75 69 72 65 20 61 20 77 72 69 74 65 2d 6c 6f quire a write-lo
20f60 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ck on the databa
20f70 73 65 2e 20 20 54 68 65 20 6c 6f 63 6b 20 69 73 se. The lock is
20f80 20 72 65 6d 6f 76 65 64 20 77 68 65 6e 0a 2a 2a removed when.**
20f90 20 74 68 65 20 61 6e 79 20 6f 66 20 74 68 65 20 the any of the
20fa0 66 6f 6c 6c 6f 77 69 6e 67 20 68 61 70 70 65 6e following happen
20fb0 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 73 71 6c :.**.** * sql
20fc0 69 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 50 ite3PagerCommitP
20fd0 68 61 73 65 54 77 6f 28 29 20 69 73 20 63 61 6c haseTwo() is cal
20fe0 6c 65 64 2e 0a 2a 2a 20 20 20 2a 20 20 73 71 6c led..** * sql
20ff0 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 63 ite3PagerRollbac
21000 6b 28 29 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a k() is called..*
21010 2a 20 20 20 2a 20 20 73 71 6c 69 74 65 33 50 61 * * sqlite3Pa
21020 67 65 72 43 6c 6f 73 65 28 29 20 69 73 20 63 61 gerClose() is ca
21030 6c 6c 65 64 2e 0a 2a 2a 20 20 20 2a 20 20 73 71 lled..** * sq
21040 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 lite3PagerUnref(
21050 29 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 6f ) is called to o
21060 6e 20 65 76 65 72 79 20 6f 75 74 73 74 61 6e 64 n every outstand
21070 69 6e 67 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 ing page..**.**
21080 54 68 65 20 66 69 72 73 74 20 70 61 72 61 6d 65 The first parame
21090 74 65 72 20 74 6f 20 74 68 69 73 20 72 6f 75 74 ter to this rout
210a0 69 6e 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ine is a pointer
210b0 20 74 6f 20 61 6e 79 20 6f 70 65 6e 20 70 61 67 to any open pag
210c0 65 20 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 e of the.** data
210d0 62 61 73 65 20 66 69 6c 65 2e 20 20 4e 6f 74 68 base file. Noth
210e0 69 6e 67 20 63 68 61 6e 67 65 73 20 61 62 6f 75 ing changes abou
210f0 74 20 74 68 65 20 70 61 67 65 20 2d 20 69 74 20 t the page - it
21100 69 73 20 75 73 65 64 20 6d 65 72 65 6c 79 20 74 is used merely t
21110 6f 0a 2a 2a 20 61 63 71 75 69 72 65 20 61 20 70 o.** acquire a p
21120 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 50 61 ointer to the Pa
21130 67 65 72 20 73 74 72 75 63 74 75 72 65 20 61 6e ger structure an
21140 64 20 61 73 20 70 72 6f 6f 66 20 74 68 61 74 20 d as proof that
21150 74 68 65 72 65 20 69 73 0a 2a 2a 20 61 6c 72 65 there is.** alre
21160 61 64 79 20 61 20 72 65 61 64 2d 6c 6f 63 6b 20 ady a read-lock
21170 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e on the database.
21180 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 65 63 6f 6e .**.** The secon
21190 64 20 70 61 72 61 6d 65 74 65 72 20 69 6e 64 69 d parameter indi
211a0 63 61 74 65 73 20 68 6f 77 20 6d 75 63 68 20 73 cates how much s
211b0 70 61 63 65 20 69 6e 20 62 79 74 65 73 20 74 6f pace in bytes to
211c0 20 72 65 73 65 72 76 65 20 66 6f 72 20 61 0a 2a reserve for a.*
211d0 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c * master journal
211e0 20 66 69 6c 65 2d 6e 61 6d 65 20 61 74 20 74 68 file-name at th
211f0 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 6a e start of the j
21200 6f 75 72 6e 61 6c 20 77 68 65 6e 20 69 74 20 69 ournal when it i
21210 73 20 63 72 65 61 74 65 64 2e 0a 2a 2a 0a 2a 2a s created..**.**
21220 20 41 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 A journal file
21230 69 73 20 6f 70 65 6e 65 64 20 69 66 20 74 68 69 is opened if thi
21240 73 20 69 73 20 6e 6f 74 20 61 20 74 65 6d 70 6f s is not a tempo
21250 72 61 72 79 20 66 69 6c 65 2e 20 20 46 6f 72 20 rary file. For
21260 74 65 6d 70 6f 72 61 72 79 0a 2a 2a 20 66 69 6c temporary.** fil
21270 65 73 2c 20 74 68 65 20 6f 70 65 6e 69 6e 67 20 es, the opening
21280 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 of the journal f
21290 69 6c 65 20 69 73 20 64 65 66 65 72 72 65 64 20 ile is deferred
212a0 75 6e 74 69 6c 20 74 68 65 72 65 20 69 73 20 61 until there is a
212b0 6e 0a 2a 2a 20 61 63 74 75 61 6c 20 6e 65 65 64 n.** actual need
212c0 20 74 6f 20 77 72 69 74 65 20 74 6f 20 74 68 65 to write to the
212d0 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 journal..**.**
212e0 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
212f0 69 73 20 61 6c 72 65 61 64 79 20 72 65 73 65 72 is already reser
21300 76 65 64 20 66 6f 72 20 77 72 69 74 69 6e 67 2c ved for writing,
21310 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
21320 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 a no-op..**.**
21330 49 66 20 65 78 46 6c 61 67 20 69 73 20 74 72 75 If exFlag is tru
21340 65 2c 20 67 6f 20 61 68 65 61 64 20 61 6e 64 20 e, go ahead and
21350 67 65 74 20 61 6e 20 45 58 43 4c 55 53 49 56 45 get an EXCLUSIVE
21360 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c lock on the fil
21370 65 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 e.** immediately
21380 20 69 6e 73 74 65 61 64 20 6f 66 20 77 61 69 74 instead of wait
21390 69 6e 67 20 75 6e 74 69 6c 20 77 65 20 74 72 79 ing until we try
213a0 20 74 6f 20 66 6c 75 73 68 20 74 68 65 20 63 61 to flush the ca
213b0 63 68 65 2e 20 20 54 68 65 0a 2a 2a 20 65 78 46 che. The.** exF
213c0 6c 61 67 20 69 73 20 69 67 6e 6f 72 65 64 20 69 lag is ignored i
213d0 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 f a transaction
213e0 69 73 20 61 6c 72 65 61 64 79 20 61 63 74 69 76 is already activ
213f0 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
21400 33 50 61 67 65 72 42 65 67 69 6e 28 44 62 50 61 3PagerBegin(DbPa
21410 67 65 20 2a 70 50 67 2c 20 69 6e 74 20 65 78 46 ge *pPg, int exF
21420 6c 61 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 lag){. Pager *p
21430 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 Pager = pPg->pPa
21440 67 65 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ger;. int rc =
21450 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 70 61 67 SQLITE_OK;. pag
21460 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b erEnter(pPager);
21470 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e . assert( pPg->
21480 6e 52 65 66 3e 30 20 29 3b 0a 20 20 61 73 73 65 nRef>0 );. asse
21490 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 rt( pPager->stat
214a0 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b 20 e!=PAGER_UNLOCK
214b0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
214c0 3e 73 74 61 74 65 3d 3d 50 41 47 45 52 5f 53 48 >state==PAGER_SH
214d0 41 52 45 44 20 29 7b 0a 20 20 20 20 61 73 73 65 ARED ){. asse
214e0 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a rt( pPager->pInJ
214f0 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 20 20 20 ournal==0 );.
21500 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 if( MEMDB ){.
21510 20 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 pPager->stat
21520 65 20 3d 20 50 41 47 45 52 5f 45 58 43 4c 55 53 e = PAGER_EXCLUS
21530 49 56 45 3b 0a 20 20 20 20 20 20 70 50 61 67 65 IVE;. pPage
21540 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20 r->origDbSize =
21550 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a pPager->dbSize;.
21560 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
21570 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4c rc = sqlite3OsL
21580 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 ock(pPager->fd,
21590 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 29 3b 0a RESERVED_LOCK);.
215a0 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
215b0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
215c0 20 20 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 pPager->state
215d0 20 3d 20 50 41 47 45 52 5f 52 45 53 45 52 56 45 = PAGER_RESERVE
215e0 44 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 65 D;. if( e
215f0 78 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 20 xFlag ){.
21600 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 rc = pager_wa
21610 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 it_on_lock(pPage
21620 72 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 r, EXCLUSIVE_LOC
21630 4b 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 K);. }.
21640 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
21650 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
21660 0a 20 20 20 20 20 20 20 20 70 61 67 65 72 4c 65 . pagerLe
21670 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 ave(pPager);.
21680 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
21690 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 50 }. pP
216a0 61 67 65 72 2d 3e 64 69 72 74 79 43 61 63 68 65 ager->dirtyCache
216b0 20 3d 20 30 3b 0a 20 20 20 20 20 20 50 41 47 45 = 0;. PAGE
216c0 52 54 52 41 43 45 32 28 22 54 52 41 4e 53 41 43 RTRACE2("TRANSAC
216d0 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 41 47 45 TION %d\n", PAGE
216e0 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20 RID(pPager));.
216f0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
21700 75 73 65 4a 6f 75 72 6e 61 6c 20 26 26 20 21 70 useJournal && !p
21710 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 0a Pager->tempFile.
21720 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 20 &&
21730 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
21740 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode!=PAGER_JOURN
21750 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 7b 0a 20 20 ALMODE_OFF ){.
21760 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
21770 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 70 50 _open_journal(pP
21780 61 67 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20 ager);. }.
21790 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 }. }else if(
217a0 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
217b0 4f 70 65 6e 20 26 26 20 70 50 61 67 65 72 2d 3e Open && pPager->
217c0 6a 6f 75 72 6e 61 6c 4f 66 66 3d 3d 30 20 29 7b journalOff==0 ){
217d0 0a 20 20 20 20 2f 2a 20 54 68 69 73 20 68 61 70 . /* This hap
217e0 70 65 6e 73 20 77 68 65 6e 20 74 68 65 20 70 61 pens when the pa
217f0 67 65 72 20 77 61 73 20 69 6e 20 65 78 63 6c 75 ger was in exclu
21800 73 69 76 65 2d 61 63 63 65 73 73 20 6d 6f 64 65 sive-access mode
21810 20 6c 61 73 74 0a 20 20 20 20 2a 2a 20 74 69 6d last. ** tim
21820 65 20 61 20 28 72 65 61 64 20 6f 72 20 77 72 69 e a (read or wri
21830 74 65 29 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 te) transaction
21840 77 61 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 was successfully
21850 20 63 6f 6e 63 6c 75 64 65 64 0a 20 20 20 20 2a concluded. *
21860 2a 20 62 79 20 74 68 69 73 20 63 6f 6e 6e 65 63 * by this connec
21870 74 69 6f 6e 2e 20 49 6e 73 74 65 61 64 20 6f 66 tion. Instead of
21880 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 6a 6f deleting the jo
21890 75 72 6e 61 6c 20 66 69 6c 65 20 69 74 20 77 61 urnal file it wa
218a0 73 20 0a 20 20 20 20 2a 2a 20 6b 65 70 74 20 6f s . ** kept o
218b0 70 65 6e 20 61 6e 64 20 74 72 75 6e 63 61 74 65 pen and truncate
218c0 64 20 74 6f 20 30 20 62 79 74 65 73 2e 0a 20 20 d to 0 bytes..
218d0 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 */. assert(
218e0 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 3d 3d 30 pPager->nRec==0
218f0 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
21900 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 pPager->origDbSi
21910 7a 65 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 ze==0 );. ass
21920 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e ert( pPager->pIn
21930 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 20 20 Journal==0 );.
21940 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 sqlite3PagerPa
21950 67 65 63 6f 75 6e 74 28 70 50 61 67 65 72 29 3b gecount(pPager);
21960 0a 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 . pagerLeave(
21970 70 50 61 67 65 72 29 3b 0a 20 20 20 20 70 50 61 pPager);. pPa
21980 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 ger->pInJournal
21990 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 = sqlite3BitvecC
219a0 72 65 61 74 65 28 20 70 50 61 67 65 72 2d 3e 64 reate( pPager->d
219b0 62 53 69 7a 65 20 29 3b 0a 20 20 20 20 70 61 67 bSize );. pag
219c0 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b erEnter(pPager);
219d0 0a 20 20 20 20 69 66 28 20 21 70 50 61 67 65 72 . if( !pPager
219e0 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 29 7b 0a ->pInJournal ){.
219f0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
21a00 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c E_NOMEM;. }el
21a10 73 65 7b 0a 20 20 20 20 20 20 70 50 61 67 65 72 se{. pPager
21a20 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 3d 20 70 ->origDbSize = p
21a30 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 Pager->dbSize;.
21a40 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 4a rc = writeJ
21a50 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 72 ournalHdr(pPager
21a60 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 61 );. }. }. a
21a70 73 73 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e ssert( !pPager->
21a80 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 70 journalOpen || p
21a90 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
21aa0 66 3e 30 20 7c 7c 20 72 63 21 3d 53 51 4c 49 54 f>0 || rc!=SQLIT
21ab0 45 5f 4f 4b 20 29 3b 0a 20 20 70 61 67 65 72 4c E_OK );. pagerL
21ac0 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 eave(pPager);.
21ad0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
21ae0 0a 2a 2a 20 4d 61 6b 65 20 61 20 70 61 67 65 20 .** Make a page
21af0 64 69 72 74 79 2e 20 20 53 65 74 20 69 74 73 20 dirty. Set its
21b00 64 69 72 74 79 20 66 6c 61 67 20 61 6e 64 20 61 dirty flag and a
21b10 64 64 20 69 74 20 74 6f 20 74 68 65 20 64 69 72 dd it to the dir
21b20 74 79 0a 2a 2a 20 70 61 67 65 20 6c 69 73 74 2e ty.** page list.
21b30 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
21b40 6d 61 6b 65 44 69 72 74 79 28 50 67 48 64 72 20 makeDirty(PgHdr
21b50 2a 70 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67 *pPg){. if( pPg
21b60 2d 3e 64 69 72 74 79 3d 3d 30 20 29 7b 0a 20 20 ->dirty==0 ){.
21b70 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 20 Pager *pPager
21b80 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 = pPg->pPager;.
21b90 20 20 20 70 50 67 2d 3e 64 69 72 74 79 20 3d 20 pPg->dirty =
21ba0 31 3b 0a 20 20 20 20 70 50 67 2d 3e 70 44 69 72 1;. pPg->pDir
21bb0 74 79 20 3d 20 70 50 61 67 65 72 2d 3e 70 44 69 ty = pPager->pDi
21bc0 72 74 79 3b 0a 20 20 20 20 69 66 28 20 70 50 61 rty;. if( pPa
21bd0 67 65 72 2d 3e 70 44 69 72 74 79 20 29 7b 0a 20 ger->pDirty ){.
21be0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 44 69 pPager->pDi
21bf0 72 74 79 2d 3e 70 50 72 65 76 44 69 72 74 79 20 rty->pPrevDirty
21c00 3d 20 70 50 67 3b 0a 20 20 20 20 7d 0a 20 20 20 = pPg;. }.
21c10 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 74 79 pPg->pPrevDirty
21c20 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 = 0;. pPager
21c30 2d 3e 70 44 69 72 74 79 20 3d 20 70 50 67 3b 0a ->pDirty = pPg;.
21c40 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b }.}../*.** Mak
21c50 65 20 61 20 70 61 67 65 20 63 6c 65 61 6e 2e 20 e a page clean.
21c60 20 43 6c 65 61 72 20 69 74 73 20 64 69 72 74 79 Clear its dirty
21c70 20 62 69 74 20 61 6e 64 20 72 65 6d 6f 76 65 20 bit and remove
21c80 69 74 20 66 72 6f 6d 20 74 68 65 0a 2a 2a 20 64 it from the.** d
21c90 69 72 74 79 20 70 61 67 65 20 6c 69 73 74 2e 0a irty page list..
21ca0 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 6d */.static void m
21cb0 61 6b 65 43 6c 65 61 6e 28 50 67 48 64 72 20 2a akeClean(PgHdr *
21cc0 70 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67 2d pPg){. if( pPg-
21cd0 3e 64 69 72 74 79 20 29 7b 0a 20 20 20 20 70 50 >dirty ){. pP
21ce0 67 2d 3e 64 69 72 74 79 20 3d 20 30 3b 0a 20 20 g->dirty = 0;.
21cf0 20 20 69 66 28 20 70 50 67 2d 3e 70 44 69 72 74 if( pPg->pDirt
21d00 79 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 y ){. asser
21d10 74 28 20 70 50 67 2d 3e 70 44 69 72 74 79 2d 3e t( pPg->pDirty->
21d20 70 50 72 65 76 44 69 72 74 79 3d 3d 70 50 67 20 pPrevDirty==pPg
21d30 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 44 );. pPg->pD
21d40 69 72 74 79 2d 3e 70 50 72 65 76 44 69 72 74 79 irty->pPrevDirty
21d50 20 3d 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 = pPg->pPrevDir
21d60 74 79 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 ty;. }. if
21d70 28 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 74 ( pPg->pPrevDirt
21d80 79 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 y ){. asser
21d90 74 28 20 70 50 67 2d 3e 70 50 72 65 76 44 69 72 t( pPg->pPrevDir
21da0 74 79 2d 3e 70 44 69 72 74 79 3d 3d 70 50 67 20 ty->pDirty==pPg
21db0 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e 70 50 );. pPg->pP
21dc0 72 65 76 44 69 72 74 79 2d 3e 70 44 69 72 74 79 revDirty->pDirty
21dd0 20 3d 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a = pPg->pDirty;.
21de0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
21df0 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 50 assert( pPg->pP
21e00 61 67 65 72 2d 3e 70 44 69 72 74 79 3d 3d 70 50 ager->pDirty==pP
21e10 67 20 29 3b 0a 20 20 20 20 20 20 70 50 67 2d 3e g );. pPg->
21e20 70 50 61 67 65 72 2d 3e 70 44 69 72 74 79 20 3d pPager->pDirty =
21e30 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a 20 20 pPg->pDirty;.
21e40 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a }. }.}.../*.*
21e50 2a 20 4d 61 72 6b 20 61 20 64 61 74 61 20 70 61 * Mark a data pa
21e60 67 65 20 61 73 20 77 72 69 74 65 61 62 6c 65 2e ge as writeable.
21e70 20 20 54 68 65 20 70 61 67 65 20 69 73 20 77 72 The page is wr
21e80 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a itten into the j
21e90 6f 75 72 6e 61 6c 20 0a 2a 2a 20 69 66 20 69 74 ournal .** if it
21ea0 20 69 73 20 6e 6f 74 20 74 68 65 72 65 20 61 6c is not there al
21eb0 72 65 61 64 79 2e 20 20 54 68 69 73 20 72 6f 75 ready. This rou
21ec0 74 69 6e 65 20 6d 75 73 74 20 62 65 20 63 61 6c tine must be cal
21ed0 6c 65 64 20 62 65 66 6f 72 65 20 6d 61 6b 69 6e led before makin
21ee0 67 0a 2a 2a 20 63 68 61 6e 67 65 73 20 74 6f 20 g.** changes to
21ef0 61 20 70 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 a page..**.** Th
21f00 65 20 66 69 72 73 74 20 74 69 6d 65 20 74 68 69 e first time thi
21f10 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
21f20 6c 65 64 2c 20 74 68 65 20 70 61 67 65 72 20 63 led, the pager c
21f30 72 65 61 74 65 73 20 61 20 6e 65 77 0a 2a 2a 20 reates a new.**
21f40 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 61 63 71 75 journal and acqu
21f50 69 72 65 73 20 61 20 52 45 53 45 52 56 45 44 20 ires a RESERVED
21f60 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
21f70 62 61 73 65 2e 20 20 49 66 20 74 68 65 20 52 45 base. If the RE
21f80 53 45 52 56 45 44 0a 2a 2a 20 6c 6f 63 6b 20 63 SERVED.** lock c
21f90 6f 75 6c 64 20 6e 6f 74 20 62 65 20 61 63 71 75 ould not be acqu
21fa0 69 72 65 64 2c 20 74 68 69 73 20 72 6f 75 74 69 ired, this routi
21fb0 6e 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 ne returns SQLIT
21fc0 45 5f 42 55 53 59 2e 20 20 54 68 65 0a 2a 2a 20 E_BUSY. The.**
21fd0 63 61 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65 20 calling routine
21fe0 6d 75 73 74 20 63 68 65 63 6b 20 66 6f 72 20 74 must check for t
21ff0 68 61 74 20 72 65 74 75 72 6e 20 76 61 6c 75 65 hat return value
22000 20 61 6e 64 20 62 65 20 63 61 72 65 66 75 6c 20 and be careful
22010 6e 6f 74 20 74 6f 0a 2a 2a 20 63 68 61 6e 67 65 not to.** change
22020 20 61 6e 79 20 70 61 67 65 20 64 61 74 61 20 75 any page data u
22030 6e 74 69 6c 20 74 68 69 73 20 72 6f 75 74 69 6e ntil this routin
22040 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 e returns SQLITE
22050 5f 4f 4b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 _OK..**.** If th
22060 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 e journal file c
22070 6f 75 6c 64 20 6e 6f 74 20 62 65 20 77 72 69 74 ould not be writ
22080 74 65 6e 20 62 65 63 61 75 73 65 20 74 68 65 20 ten because the
22090 64 69 73 6b 20 69 73 20 66 75 6c 6c 2c 0a 2a 2a disk is full,.**
220a0 20 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 then this routi
220b0 6e 65 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54 ne returns SQLIT
220c0 45 5f 46 55 4c 4c 20 61 6e 64 20 64 6f 65 73 20 E_FULL and does
220d0 61 6e 20 69 6d 6d 65 64 69 61 74 65 20 72 6f 6c an immediate rol
220e0 6c 62 61 63 6b 2e 0a 2a 2a 20 41 6c 6c 20 73 75 lback..** All su
220f0 62 73 65 71 75 65 6e 74 20 77 72 69 74 65 20 61 bsequent write a
22100 74 74 65 6d 70 74 73 20 61 6c 73 6f 20 72 65 74 ttempts also ret
22110 75 72 6e 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 urn SQLITE_FULL
22120 75 6e 74 69 6c 20 74 68 65 72 65 0a 2a 2a 20 69 until there.** i
22130 73 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 s a call to sqli
22140 74 65 33 50 61 67 65 72 43 6f 6d 6d 69 74 28 29 te3PagerCommit()
22150 20 6f 72 20 73 71 6c 69 74 65 33 50 61 67 65 72 or sqlite3Pager
22160 52 6f 6c 6c 62 61 63 6b 28 29 20 74 6f 0a 2a 2a Rollback() to.**
22170 20 72 65 73 65 74 2e 0a 2a 2f 0a 73 74 61 74 69 reset..*/.stati
22180 63 20 69 6e 74 20 70 61 67 65 72 5f 77 72 69 74 c int pager_writ
22190 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 e(PgHdr *pPg){.
221a0 20 76 6f 69 64 20 2a 70 44 61 74 61 20 3d 20 50 void *pData = P
221b0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 GHDR_TO_DATA(pPg
221c0 29 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 );. Pager *pPag
221d0 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 er = pPg->pPager
221e0 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c ;. int rc = SQL
221f0 49 54 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 43 68 ITE_OK;.. /* Ch
22200 65 63 6b 20 66 6f 72 20 65 72 72 6f 72 73 0a 20 eck for errors.
22210 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 72 */. if( pPager
22220 2d 3e 65 72 72 43 6f 64 65 20 29 7b 20 0a 20 20 ->errCode ){ .
22230 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d return pPager-
22240 3e 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a 20 20 >errCode;. }.
22250 69 66 28 20 70 50 61 67 65 72 2d 3e 72 65 61 64 if( pPager->read
22260 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 72 65 74 75 Only ){. retu
22270 72 6e 20 53 51 4c 49 54 45 5f 50 45 52 4d 3b 0a rn SQLITE_PERM;.
22280 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28 20 21 }.. assert( !
22290 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 pPager->setMaste
222a0 72 20 29 3b 0a 0a 20 20 43 48 45 43 4b 5f 50 41 r );.. CHECK_PA
222b0 47 45 28 70 50 67 29 3b 0a 0a 20 20 2f 2a 20 49 GE(pPg);.. /* I
222c0 66 20 74 68 69 73 20 70 61 67 65 20 77 61 73 20 f this page was
222d0 70 72 65 76 69 6f 75 73 6c 79 20 61 63 71 75 69 previously acqui
222e0 72 65 64 20 77 69 74 68 20 6e 6f 43 6f 6e 74 65 red with noConte
222f0 6e 74 3d 3d 31 2c 20 74 68 61 74 20 6d 65 61 6e nt==1, that mean
22300 73 0a 20 20 2a 2a 20 77 65 20 64 69 64 6e 27 74 s. ** we didn't
22310 20 72 65 61 6c 6c 79 20 72 65 61 64 20 69 6e 20 really read in
22320 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 the content of t
22330 68 65 20 70 61 67 65 2e 20 20 54 68 69 73 20 63 he page. This c
22340 61 6e 20 68 61 70 70 65 6e 0a 20 20 2a 2a 20 28 an happen. ** (
22350 66 6f 72 20 65 78 61 6d 70 6c 65 29 20 77 68 65 for example) whe
22360 6e 20 74 68 65 20 70 61 67 65 20 69 73 20 62 65 n the page is be
22370 69 6e 67 20 6d 6f 76 65 64 20 74 6f 20 74 68 65 ing moved to the
22380 20 66 72 65 65 6c 69 73 74 2e 20 20 42 75 74 0a freelist. But.
22390 20 20 2a 2a 20 6e 6f 77 20 77 65 20 61 72 65 20 ** now we are
223a0 28 70 65 72 68 61 70 73 29 20 6d 6f 76 69 6e 67 (perhaps) moving
223b0 20 74 68 65 20 70 61 67 65 20 6f 66 66 20 6f 66 the page off of
223c0 20 74 68 65 20 66 72 65 65 6c 69 73 74 20 66 6f the freelist fo
223d0 72 0a 20 20 2a 2a 20 72 65 75 73 65 20 61 6e 64 r. ** reuse and
223e0 20 77 65 20 6e 65 65 64 20 74 6f 20 6b 6e 6f 77 we need to know
223f0 20 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 63 6f its original co
22400 6e 74 65 6e 74 20 73 6f 20 74 68 61 74 20 63 6f ntent so that co
22410 6e 74 65 6e 74 0a 20 20 2a 2a 20 63 61 6e 20 62 ntent. ** can b
22420 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e stored in the
22430 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
22440 2e 20 20 53 6f 20 64 6f 20 74 68 65 20 72 65 61 . So do the rea
22450 64 20 61 74 20 74 68 69 73 0a 20 20 2a 2a 20 74 d at this. ** t
22460 69 6d 65 2e 0a 20 20 2a 2f 0a 20 20 72 63 20 3d ime.. */. rc =
22470 20 70 61 67 65 72 5f 67 65 74 5f 63 6f 6e 74 65 pager_get_conte
22480 6e 74 28 70 50 67 29 3b 0a 20 20 69 66 28 20 72 nt(pPg);. if( r
22490 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 c ){. return
224a0 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4d 61 rc;. }.. /* Ma
224b0 72 6b 20 74 68 65 20 70 61 67 65 20 61 73 20 64 rk the page as d
224c0 69 72 74 79 2e 20 20 49 66 20 74 68 65 20 70 61 irty. If the pa
224d0 67 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 ge has already b
224e0 65 65 6e 20 77 72 69 74 74 65 6e 0a 20 20 2a 2a een written. **
224f0 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 to the journal
22500 74 68 65 6e 20 77 65 20 63 61 6e 20 72 65 74 75 then we can retu
22510 72 6e 20 72 69 67 68 74 20 61 77 61 79 2e 0a 20 rn right away..
22520 20 2a 2f 0a 20 20 6d 61 6b 65 44 69 72 74 79 28 */. makeDirty(
22530 70 50 67 29 3b 0a 20 20 69 66 28 20 70 50 67 2d pPg);. if( pPg-
22540 3e 69 6e 4a 6f 75 72 6e 61 6c 20 26 26 20 28 70 >inJournal && (p
22550 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74 28 70 ageInStatement(p
22560 50 67 29 20 7c 7c 20 70 50 61 67 65 72 2d 3e 73 Pg) || pPager->s
22570 74 6d 74 49 6e 55 73 65 3d 3d 30 29 20 29 7b 0a tmtInUse==0) ){.
22580 20 20 20 20 70 50 61 67 65 72 2d 3e 64 69 72 74 pPager->dirt
22590 79 43 61 63 68 65 20 3d 20 31 3b 0a 20 20 7d 65 yCache = 1;. }e
225a0 6c 73 65 7b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 lse{.. /* If
225b0 77 65 20 67 65 74 20 74 68 69 73 20 66 61 72 2c we get this far,
225c0 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 it means that t
225d0 68 65 20 70 61 67 65 20 6e 65 65 64 73 20 74 6f he page needs to
225e0 20 62 65 0a 20 20 20 20 2a 2a 20 77 72 69 74 74 be. ** writt
225f0 65 6e 20 74 6f 20 74 68 65 20 74 72 61 6e 73 61 en to the transa
22600 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c 20 6f 72 ction journal or
22610 20 74 68 65 20 63 6b 65 63 6b 70 6f 69 6e 74 20 the ckeckpoint
22620 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 6f journal. ** o
22630 72 20 62 6f 74 68 2e 0a 20 20 20 20 2a 2a 0a 20 r both.. **.
22640 20 20 20 2a 2a 20 46 69 72 73 74 20 63 68 65 63 ** First chec
22650 6b 20 74 6f 20 73 65 65 20 74 68 61 74 20 74 68 k to see that th
22660 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f e transaction jo
22670 75 72 6e 61 6c 20 65 78 69 73 74 73 20 61 6e 64 urnal exists and
22680 0a 20 20 20 20 2a 2a 20 63 72 65 61 74 65 20 69 . ** create i
22690 74 20 69 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 t if it does not
226a0 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 .. */. ass
226b0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 ert( pPager->sta
226c0 74 65 21 3d 50 41 47 45 52 5f 55 4e 4c 4f 43 4b te!=PAGER_UNLOCK
226d0 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c );. rc = sql
226e0 69 74 65 33 50 61 67 65 72 42 65 67 69 6e 28 70 ite3PagerBegin(p
226f0 50 67 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 Pg, 0);. if(
22700 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
22710 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
22720 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
22730 72 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 rt( pPager->stat
22740 65 3e 3d 50 41 47 45 52 5f 52 45 53 45 52 56 45 e>=PAGER_RESERVE
22750 44 20 29 3b 0a 20 20 20 20 69 66 28 20 21 70 50 D );. if( !pP
22760 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 ager->journalOpe
22770 6e 20 26 26 20 70 50 61 67 65 72 2d 3e 75 73 65 n && pPager->use
22780 4a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 20 20 Journal.
22790 20 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 && pPager->jou
227a0 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f rnalMode!=PAGER_
227b0 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 JOURNALMODE_OFF
227c0 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 ){. rc = pa
227d0 67 65 72 5f 6f 70 65 6e 5f 6a 6f 75 72 6e 61 6c ger_open_journal
227e0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
227f0 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
22800 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 K ) return rc;.
22810 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d }. pPager-
22820 3e 64 69 72 74 79 43 61 63 68 65 20 3d 20 31 3b >dirtyCache = 1;
22830 0a 20 20 0a 20 20 20 20 2f 2a 20 54 68 65 20 74 . . /* The t
22840 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e ransaction journ
22850 61 6c 20 6e 6f 77 20 65 78 69 73 74 73 20 61 6e al now exists an
22860 64 20 77 65 20 68 61 76 65 20 61 20 52 45 53 45 d we have a RESE
22870 52 56 45 44 20 6f 72 20 61 6e 0a 20 20 20 20 2a RVED or an. *
22880 2a 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b * EXCLUSIVE lock
22890 20 6f 6e 20 74 68 65 20 6d 61 69 6e 20 64 61 74 on the main dat
228a0 61 62 61 73 65 20 66 69 6c 65 2e 20 20 57 72 69 abase file. Wri
228b0 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 te the current p
228c0 61 67 65 20 74 6f 0a 20 20 20 20 2a 2a 20 74 68 age to. ** th
228d0 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6a 6f e transaction jo
228e0 75 72 6e 61 6c 20 69 66 20 69 74 20 69 73 20 6e urnal if it is n
228f0 6f 74 20 74 68 65 72 65 20 61 6c 72 65 61 64 79 ot there already
22900 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 .. */. if(
22910 20 21 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c !pPg->inJournal
22920 20 26 26 20 28 70 50 61 67 65 72 2d 3e 6a 6f 75 && (pPager->jou
22930 72 6e 61 6c 4f 70 65 6e 20 7c 7c 20 4d 45 4d 44 rnalOpen || MEMD
22940 42 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 B) ){. if(
22950 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f 20 3c (int)pPg->pgno <
22960 3d 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 = pPager->origDb
22970 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 Size ){.
22980 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 if( MEMDB ){.
22990 20 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79 PgHistory
229a0 20 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f *pHist = PGHDR_
229b0 54 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 TO_HIST(pPg, pPa
229c0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 ger);.
229d0 50 41 47 45 52 54 52 41 43 45 33 28 22 4a 4f 55 PAGERTRACE3("JOU
229e0 52 4e 41 4c 20 25 64 20 70 61 67 65 20 25 64 5c RNAL %d page %d\
229f0 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 n", PAGERID(pPag
22a00 65 72 29 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b er), pPg->pgno);
22a10 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 . asser
22a20 74 28 20 70 48 69 73 74 2d 3e 70 4f 72 69 67 3d t( pHist->pOrig=
22a30 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 =0 );.
22a40 70 48 69 73 74 2d 3e 70 4f 72 69 67 20 3d 20 73 pHist->pOrig = s
22a50 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 70 qlite3_malloc( p
22a60 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
22a70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 );. if(
22a80 20 21 70 48 69 73 74 2d 3e 70 4f 72 69 67 20 29 !pHist->pOrig )
22a90 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 65 {. re
22aa0 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 turn SQLITE_NOME
22ab0 4d 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 M;. }.
22ac0 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 memcpy(
22ad0 70 48 69 73 74 2d 3e 70 4f 72 69 67 2c 20 50 47 pHist->pOrig, PG
22ae0 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 HDR_TO_DATA(pPg)
22af0 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
22b00 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c ze);. }el
22b10 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 75 33 se{. u3
22b20 32 20 63 6b 73 75 6d 3b 0a 20 20 20 20 20 20 20 2 cksum;.
22b30 20 20 20 63 68 61 72 20 2a 70 44 61 74 61 32 3b char *pData2;
22b40 0a 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 .. /* W
22b50 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 77 e should never w
22b60 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f 75 72 rite to the jour
22b70 6e 61 6c 20 66 69 6c 65 20 74 68 65 20 70 61 67 nal file the pag
22b80 65 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 20 e that.
22b90 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 ** contains the
22ba0 20 64 61 74 61 62 61 73 65 20 6c 6f 63 6b 73 2e database locks.
22bb0 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 The following
22bc0 61 73 73 65 72 74 20 76 65 72 69 66 69 65 73 0a assert verifies.
22bd0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 61 ** tha
22be0 74 20 77 65 20 64 6f 20 6e 6f 74 2e 20 2a 2f 0a t we do not. */.
22bf0 20 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 assert
22c00 28 20 70 50 67 2d 3e 70 67 6e 6f 21 3d 50 41 47 ( pPg->pgno!=PAG
22c10 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 ER_MJ_PGNO(pPage
22c20 72 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 r) );.
22c30 70 44 61 74 61 32 20 3d 20 43 4f 44 45 43 32 28 pData2 = CODEC2(
22c40 70 50 61 67 65 72 2c 20 70 44 61 74 61 2c 20 70 pPager, pData, p
22c50 50 67 2d 3e 70 67 6e 6f 2c 20 37 29 3b 0a 20 20 Pg->pgno, 7);.
22c60 20 20 20 20 20 20 20 20 63 6b 73 75 6d 20 3d 20 cksum =
22c70 70 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 61 67 pager_cksum(pPag
22c80 65 72 2c 20 28 75 38 2a 29 70 44 61 74 61 32 29 er, (u8*)pData2)
22c90 3b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d ;. rc =
22ca0 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 61 write32bits(pPa
22cb0 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 65 72 ger->jfd, pPager
22cc0 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c 20 70 50 ->journalOff, pP
22cd0 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 g->pgno);.
22ce0 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
22cf0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
22d00 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
22d10 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3OsWrite(pPager-
22d20 3e 6a 66 64 2c 20 70 44 61 74 61 32 2c 20 70 50 >jfd, pData2, pP
22d30 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 0a ager->pageSize,.
22d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22d60 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
22d70 66 66 20 2b 20 34 29 3b 0a 20 20 20 20 20 20 20 ff + 4);.
22d80 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 pPager->jou
22d90 72 6e 61 6c 4f 66 66 20 2b 3d 20 70 50 61 67 65 rnalOff += pPage
22da0 72 2d 3e 70 61 67 65 53 69 7a 65 2b 34 3b 0a 20 r->pageSize+4;.
22db0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
22dc0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
22dd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
22de0 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 74 65 rc = write
22df0 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 32bits(pPager->j
22e00 66 64 2c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 fd, pPager->jour
22e10 6e 61 6c 4f 66 66 2c 20 63 6b 73 75 6d 29 3b 0a nalOff, cksum);.
22e20 20 20 20 20 20 20 20 20 20 20 20 20 70 50 61 67 pPag
22e30 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 2b er->journalOff +
22e40 3d 20 34 3b 0a 20 20 20 20 20 20 20 20 20 20 7d = 4;. }
22e50 0a 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 41 . IOTRA
22e60 43 45 28 28 22 4a 4f 55 54 20 25 70 20 25 64 20 CE(("JOUT %p %d
22e70 25 6c 6c 64 20 25 64 5c 6e 22 2c 20 70 50 61 67 %lld %d\n", pPag
22e80 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 0a er, pPg->pgno, .
22e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ea0 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
22eb0 61 6c 4f 66 66 2c 20 70 50 61 67 65 72 2d 3e 70 alOff, pPager->p
22ec0 61 67 65 53 69 7a 65 29 29 3b 0a 20 20 20 20 20 ageSize));.
22ed0 20 20 20 20 20 50 41 47 45 52 5f 49 4e 43 52 28 PAGER_INCR(
22ee0 73 71 6c 69 74 65 33 5f 70 61 67 65 72 5f 77 72 sqlite3_pager_wr
22ef0 69 74 65 6a 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 itej_count);.
22f00 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 PAGERTRAC
22f10 45 35 28 22 4a 4f 55 52 4e 41 4c 20 25 64 20 70 E5("JOURNAL %d p
22f20 61 67 65 20 25 64 20 6e 65 65 64 53 79 6e 63 3d age %d needSync=
22f30 25 64 20 68 61 73 68 28 25 30 38 78 29 5c 6e 22 %d hash(%08x)\n"
22f40 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
22f50 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 PAGERID(pPager)
22f60 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 70 50 67 , pPg->pgno, pPg
22f70 2d 3e 6e 65 65 64 53 79 6e 63 2c 20 70 61 67 65 ->needSync, page
22f80 72 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 29 r_pagehash(pPg))
22f90 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ;.. /*
22fa0 41 6e 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 An error has occ
22fb0 75 72 65 64 20 77 72 69 74 69 6e 67 20 74 6f 20 ured writing to
22fc0 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
22fd0 2e 20 54 68 65 20 0a 20 20 20 20 20 20 20 20 20 . The .
22fe0 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ** transaction
22ff0 77 69 6c 6c 20 62 65 20 72 6f 6c 6c 65 64 20 62 will be rolled b
23000 61 63 6b 20 62 79 20 74 68 65 20 6c 61 79 65 72 ack by the layer
23010 20 61 62 6f 76 65 2e 0a 20 20 20 20 20 20 20 20 above..
23020 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 69 */. i
23030 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
23040 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
23050 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
23060 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 }..
23070 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 2b 2b pPager->nRec++
23080 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 65 ;. asse
23090 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a rt( pPager->pInJ
230a0 6f 75 72 6e 61 6c 21 3d 30 20 29 3b 0a 20 20 20 ournal!=0 );.
230b0 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 69 sqlite3Bi
230c0 74 76 65 63 53 65 74 28 70 50 61 67 65 72 2d 3e tvecSet(pPager->
230d0 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 50 67 2d pInJournal, pPg-
230e0 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 >pgno);.
230f0 20 20 70 50 67 2d 3e 6e 65 65 64 53 79 6e 63 20 pPg->needSync
23100 3d 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e = !pPager->noSyn
23110 63 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 c;. if(
23120 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 6e 55 pPager->stmtInU
23130 73 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 se ){.
23140 20 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 sqlite3BitvecS
23150 65 74 28 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 et(pPager->pInSt
23160 6d 74 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a mt, pPg->pgno);.
23170 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
23180 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 }. }els
23190 65 7b 0a 20 20 20 20 20 20 20 20 70 50 67 2d 3e e{. pPg->
231a0 6e 65 65 64 53 79 6e 63 20 3d 20 21 70 50 61 67 needSync = !pPag
231b0 65 72 2d 3e 6a 6f 75 72 6e 61 6c 53 74 61 72 74 er->journalStart
231c0 65 64 20 26 26 20 21 70 50 61 67 65 72 2d 3e 6e ed && !pPager->n
231d0 6f 53 79 6e 63 3b 0a 20 20 20 20 20 20 20 20 50 oSync;. P
231e0 41 47 45 52 54 52 41 43 45 34 28 22 41 50 50 45 AGERTRACE4("APPE
231f0 4e 44 20 25 64 20 70 61 67 65 20 25 64 20 6e 65 ND %d page %d ne
23200 65 64 53 79 6e 63 3d 25 64 5c 6e 22 2c 0a 20 20 edSync=%d\n",.
23210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 50 41 PA
23220 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 GERID(pPager), p
23230 50 67 2d 3e 70 67 6e 6f 2c 20 70 50 67 2d 3e 6e Pg->pgno, pPg->n
23240 65 65 64 53 79 6e 63 29 3b 0a 20 20 20 20 20 20 eedSync);.
23250 7d 0a 20 20 20 20 20 20 69 66 28 20 70 50 67 2d }. if( pPg-
23260 3e 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 >needSync ){.
23270 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 65 65 pPager->nee
23280 64 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 dSync = 1;.
23290 20 7d 0a 20 20 20 20 20 20 70 50 67 2d 3e 69 6e }. pPg->in
232a0 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 0a 20 20 20 Journal = 1;.
232b0 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 }. . /* If
232c0 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f the statement jo
232d0 75 72 6e 61 6c 20 69 73 20 6f 70 65 6e 20 61 6e urnal is open an
232e0 64 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f d the page is no
232f0 74 20 69 6e 20 69 74 2c 0a 20 20 20 20 2a 2a 20 t in it,. **
23300 74 68 65 6e 20 77 72 69 74 65 20 74 68 65 20 63 then write the c
23310 75 72 72 65 6e 74 20 70 61 67 65 20 74 6f 20 74 urrent page to t
23320 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 he statement jou
23330 72 6e 61 6c 2e 20 20 4e 6f 74 65 20 74 68 61 74 rnal. Note that
23340 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 74 61 74 . ** the stat
23350 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 66 6f ement journal fo
23360 72 6d 61 74 20 64 69 66 66 65 72 73 20 66 72 6f rmat differs fro
23370 6d 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 6a m the standard j
23380 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 74 0a 20 20 ournal format.
23390 20 20 2a 2a 20 69 6e 20 74 68 61 74 20 69 74 20 ** in that it
233a0 6f 6d 69 74 73 20 74 68 65 20 63 68 65 63 6b 73 omits the checks
233b0 75 6d 73 20 61 6e 64 20 74 68 65 20 68 65 61 64 ums and the head
233c0 65 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 er.. */. i
233d0 66 28 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 f( pPager->stmtI
233e0 6e 55 73 65 20 0a 20 20 20 20 20 26 26 20 21 70 nUse . && !p
233f0 61 67 65 49 6e 53 74 61 74 65 6d 65 6e 74 28 70 ageInStatement(p
23400 50 67 29 20 0a 20 20 20 20 20 26 26 20 28 69 6e Pg) . && (in
23410 74 29 70 50 67 2d 3e 70 67 6e 6f 3c 3d 70 50 61 t)pPg->pgno<=pPa
23420 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 0a 20 ger->stmtSize .
23430 20 20 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 ){. asse
23440 72 74 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e rt( pPg->inJourn
23450 61 6c 20 7c 7c 20 28 69 6e 74 29 70 50 67 2d 3e al || (int)pPg->
23460 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e 6f 72 69 pgno>pPager->ori
23470 67 44 62 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 gDbSize );.
23480 20 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 if( MEMDB ){.
23490 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79 20 PgHistory
234a0 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 *pHist = PGHDR_T
234b0 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 O_HIST(pPg, pPag
234c0 65 72 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 er);. ass
234d0 65 72 74 28 20 70 48 69 73 74 2d 3e 70 53 74 6d ert( pHist->pStm
234e0 74 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 t==0 );.
234f0 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 3d 20 73 pHist->pStmt = s
23500 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 20 70 qlite3_malloc( p
23510 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 Pager->pageSize
23520 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
23530 48 69 73 74 2d 3e 70 53 74 6d 74 20 29 7b 0a 20 Hist->pStmt ){.
23540 20 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 memcpy(
23550 70 48 69 73 74 2d 3e 70 53 74 6d 74 2c 20 50 47 pHist->pStmt, PG
23560 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 29 HDR_TO_DATA(pPg)
23570 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
23580 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ze);. }.
23590 20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 PAGERTRAC
235a0 45 33 28 22 53 54 4d 54 2d 4a 4f 55 52 4e 41 4c E3("STMT-JOURNAL
235b0 20 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 %d page %d\n",
235c0 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c PAGERID(pPager),
235d0 20 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 pPg->pgno);.
235e0 20 20 20 20 20 70 61 67 65 5f 61 64 64 5f 74 6f page_add_to
235f0 5f 73 74 6d 74 5f 6c 69 73 74 28 70 50 67 29 3b _stmt_list(pPg);
23600 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
23610 20 20 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 i64 offset
23620 20 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4e = pPager->stmtN
23630 52 65 63 2a 28 34 2b 70 50 61 67 65 72 2d 3e 70 Rec*(4+pPager->p
23640 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 ageSize);.
23650 20 20 63 68 61 72 20 2a 70 44 61 74 61 32 20 3d char *pData2 =
23660 20 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 CODEC2(pPager,
23670 70 44 61 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f pData, pPg->pgno
23680 2c 20 37 29 3b 0a 20 20 20 20 20 20 20 20 72 63 , 7);. rc
23690 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 70 = write32bits(p
236a0 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 6f 66 66 Pager->stfd, off
236b0 73 65 74 2c 20 70 50 67 2d 3e 70 67 6e 6f 29 3b set, pPg->pgno);
236c0 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d . if( rc=
236d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
236e0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
236f0 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 ite3OsWrite(pPag
23700 65 72 2d 3e 73 74 66 64 2c 20 70 44 61 74 61 32 er->stfd, pData2
23710 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
23720 7a 65 2c 20 6f 66 66 73 65 74 2b 34 29 3b 0a 20 ze, offset+4);.
23730 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
23740 20 50 41 47 45 52 54 52 41 43 45 33 28 22 53 54 PAGERTRACE3("ST
23750 4d 54 2d 4a 4f 55 52 4e 41 4c 20 25 64 20 70 61 MT-JOURNAL %d pa
23760 67 65 20 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 ge %d\n", PAGERI
23770 44 28 70 50 61 67 65 72 29 2c 20 70 50 67 2d 3e D(pPager), pPg->
23780 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 20 20 69 pgno);. i
23790 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
237a0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 ){. re
237b0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 turn rc;.
237c0 20 7d 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 }. pPage
237d0 72 2d 3e 73 74 6d 74 4e 52 65 63 2b 2b 3b 0a 20 r->stmtNRec++;.
237e0 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 assert( p
237f0 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 21 3d Pager->pInStmt!=
23800 30 20 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 0 );. sql
23810 69 74 65 33 42 69 74 76 65 63 53 65 74 28 70 50 ite3BitvecSet(pP
23820 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 2c 20 70 ager->pInStmt, p
23830 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 20 20 20 Pg->pgno);.
23840 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 }. }. }..
23850 2f 2a 20 55 70 64 61 74 65 20 74 68 65 20 64 61 /* Update the da
23860 74 61 62 61 73 65 20 73 69 7a 65 20 61 6e 64 20 tabase size and
23870 72 65 74 75 72 6e 2e 0a 20 20 2a 2f 0a 20 20 61 return.. */. a
23880 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 ssert( pPager->s
23890 74 61 74 65 3e 3d 50 41 47 45 52 5f 53 48 41 52 tate>=PAGER_SHAR
238a0 45 44 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 ED );. if( pPag
238b0 65 72 2d 3e 64 62 53 69 7a 65 3c 28 69 6e 74 29 er->dbSize<(int)
238c0 70 50 67 2d 3e 70 67 6e 6f 20 29 7b 0a 20 20 20 pPg->pgno ){.
238d0 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 pPager->dbSize
238e0 3d 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 20 20 20 = pPg->pgno;.
238f0 20 69 66 28 20 21 4d 45 4d 44 42 20 26 26 20 70 if( !MEMDB && p
23900 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 50 Pager->dbSize==P
23910 45 4e 44 49 4e 47 5f 42 59 54 45 2f 70 50 61 67 ENDING_BYTE/pPag
23920 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 29 7b 0a er->pageSize ){.
23930 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 64 62 pPager->db
23940 53 69 7a 65 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 Size++;. }.
23950 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
23960 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
23970 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
23980 20 6d 61 72 6b 20 61 20 64 61 74 61 2d 70 61 67 mark a data-pag
23990 65 20 61 73 20 77 72 69 74 61 62 6c 65 2e 20 49 e as writable. I
239a0 74 20 75 73 65 73 20 0a 2a 2a 20 70 61 67 65 72 t uses .** pager
239b0 5f 77 72 69 74 65 28 29 20 74 6f 20 6f 70 65 6e _write() to open
239c0 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 a journal file
239d0 28 69 66 20 69 74 20 69 73 20 6e 6f 74 20 61 6c (if it is not al
239e0 72 65 61 64 79 20 6f 70 65 6e 29 0a 2a 2a 20 61 ready open).** a
239f0 6e 64 20 77 72 69 74 65 20 74 68 65 20 70 61 67 nd write the pag
23a00 65 20 2a 70 44 61 74 61 20 74 6f 20 74 68 65 20 e *pData to the
23a10 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 54 journal..**.** T
23a20 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 he difference be
23a30 74 77 65 65 6e 20 74 68 69 73 20 66 75 6e 63 74 tween this funct
23a40 69 6f 6e 20 61 6e 64 20 70 61 67 65 72 5f 77 72 ion and pager_wr
23a50 69 74 65 28 29 20 69 73 20 74 68 61 74 20 74 68 ite() is that th
23a60 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 61 is.** function a
23a70 6c 73 6f 20 64 65 61 6c 73 20 77 69 74 68 20 74 lso deals with t
23a80 68 65 20 73 70 65 63 69 61 6c 20 63 61 73 65 20 he special case
23a90 77 68 65 72 65 20 32 20 6f 72 20 6d 6f 72 65 20 where 2 or more
23aa0 70 61 67 65 73 0a 2a 2a 20 66 69 74 20 6f 6e 20 pages.** fit on
23ab0 61 20 73 69 6e 67 6c 65 20 64 69 73 6b 20 73 65 a single disk se
23ac0 63 74 6f 72 2e 20 49 6e 20 74 68 69 73 20 63 61 ctor. In this ca
23ad0 73 65 20 61 6c 6c 20 63 6f 2d 72 65 73 69 64 65 se all co-reside
23ae0 6e 74 20 70 61 67 65 73 0a 2a 2a 20 6d 75 73 74 nt pages.** must
23af0 20 68 61 76 65 20 62 65 65 6e 20 77 72 69 74 74 have been writt
23b00 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 en to the journa
23b10 6c 20 66 69 6c 65 20 62 65 66 6f 72 65 20 72 65 l file before re
23b20 74 75 72 6e 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 turning..*/.int
23b30 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
23b40 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 e(DbPage *pDbPag
23b50 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 e){. int rc = S
23b60 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 50 67 48 QLITE_OK;.. PgH
23b70 64 72 20 2a 70 50 67 20 3d 20 70 44 62 50 61 67 dr *pPg = pDbPag
23b80 65 3b 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 e;. Pager *pPag
23b90 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 er = pPg->pPager
23ba0 3b 0a 20 20 50 67 6e 6f 20 6e 50 61 67 65 50 65 ;. Pgno nPagePe
23bb0 72 53 65 63 74 6f 72 20 3d 20 28 70 50 61 67 65 rSector = (pPage
23bc0 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 2f 70 50 r->sectorSize/pP
23bd0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b ager->pageSize);
23be0 0a 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 .. pagerEnter(p
23bf0 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 21 4d Pager);. if( !M
23c00 45 4d 44 42 20 26 26 20 6e 50 61 67 65 50 65 72 EMDB && nPagePer
23c10 53 65 63 74 6f 72 3e 31 20 29 7b 0a 20 20 20 20 Sector>1 ){.
23c20 50 67 6e 6f 20 6e 50 61 67 65 43 6f 75 6e 74 3b Pgno nPageCount;
23c30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 /* Tot
23c40 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 al number of pag
23c50 65 73 20 69 6e 20 64 61 74 61 62 61 73 65 20 66 es in database f
23c60 69 6c 65 20 2a 2f 0a 20 20 20 20 50 67 6e 6f 20 ile */. Pgno
23c70 70 67 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 pg1;
23c80 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 70 61 /* First pa
23c90 67 65 20 6f 66 20 74 68 65 20 73 65 63 74 6f 72 ge of the sector
23ca0 20 70 50 67 20 69 73 20 6c 6f 63 61 74 65 64 20 pPg is located
23cb0 6f 6e 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e on. */. int n
23cc0 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
23cd0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
23ce0 66 20 70 61 67 65 73 20 73 74 61 72 74 69 6e 67 f pages starting
23cf0 20 61 74 20 70 67 31 20 74 6f 20 6a 6f 75 72 6e at pg1 to journ
23d00 61 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 69 al */. int ii
23d10 3b 0a 20 20 20 20 69 6e 74 20 6e 65 65 64 53 79 ;. int needSy
23d20 6e 63 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 nc = 0;.. /*
23d30 53 65 74 20 74 68 65 20 64 6f 4e 6f 74 53 79 6e Set the doNotSyn
23d40 63 20 66 6c 61 67 20 74 6f 20 31 2e 20 54 68 69 c flag to 1. Thi
23d50 73 20 69 73 20 62 65 63 61 75 73 65 20 77 65 20 s is because we
23d60 63 61 6e 6e 6f 74 20 61 6c 6c 6f 77 20 61 20 6a cannot allow a j
23d70 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 68 65 ournal. ** he
23d80 61 64 65 72 20 74 6f 20 62 65 20 77 72 69 74 74 ader to be writt
23d90 65 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 70 en between the p
23da0 61 67 65 73 20 6a 6f 75 72 6e 61 6c 65 64 20 62 ages journaled b
23db0 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e y this function.
23dc0 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 . */. asse
23dd0 72 74 28 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f rt( pPager->doNo
23de0 74 53 79 6e 63 3d 3d 30 20 29 3b 0a 20 20 20 20 tSync==0 );.
23df0 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 6e pPager->doNotSyn
23e00 63 20 3d 20 31 3b 0a 0a 20 20 20 20 2f 2a 20 54 c = 1;.. /* T
23e10 68 69 73 20 74 72 69 63 6b 20 61 73 73 75 6d 65 his trick assume
23e20 73 20 74 68 61 74 20 62 6f 74 68 20 74 68 65 20 s that both the
23e30 70 61 67 65 2d 73 69 7a 65 20 61 6e 64 20 73 65 page-size and se
23e40 63 74 6f 72 2d 73 69 7a 65 20 61 72 65 0a 20 20 ctor-size are.
23e50 20 20 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20 ** an integer
23e60 70 6f 77 65 72 20 6f 66 20 32 2e 20 49 74 20 73 power of 2. It s
23e70 65 74 73 20 76 61 72 69 61 62 6c 65 20 70 67 31 ets variable pg1
23e80 20 74 6f 20 74 68 65 20 69 64 65 6e 74 69 66 69 to the identifi
23e90 65 72 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 er. ** of the
23ea0 20 66 69 72 73 74 20 70 61 67 65 20 6f 66 20 74 first page of t
23eb0 68 65 20 73 65 63 74 6f 72 20 70 50 67 20 69 73 he sector pPg is
23ec0 20 6c 6f 63 61 74 65 64 20 6f 6e 2e 0a 20 20 20 located on..
23ed0 20 2a 2f 0a 20 20 20 20 70 67 31 20 3d 20 28 28 */. pg1 = ((
23ee0 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 20 26 20 7e pPg->pgno-1) & ~
23ef0 28 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 2d (nPagePerSector-
23f00 31 29 29 20 2b 20 31 3b 0a 0a 20 20 20 20 6e 50 1)) + 1;.. nP
23f10 61 67 65 43 6f 75 6e 74 20 3d 20 73 71 6c 69 74 ageCount = sqlit
23f20 65 33 50 61 67 65 72 50 61 67 65 63 6f 75 6e 74 e3PagerPagecount
23f30 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 (pPager);. if
23f40 28 20 70 50 67 2d 3e 70 67 6e 6f 3e 6e 50 61 67 ( pPg->pgno>nPag
23f50 65 43 6f 75 6e 74 20 29 7b 0a 20 20 20 20 20 20 eCount ){.
23f60 6e 50 61 67 65 20 3d 20 28 70 50 67 2d 3e 70 67 nPage = (pPg->pg
23f70 6e 6f 20 2d 20 70 67 31 29 2b 31 3b 0a 20 20 20 no - pg1)+1;.
23f80 20 7d 65 6c 73 65 20 69 66 28 20 28 70 67 31 2b }else if( (pg1+
23f90 6e 50 61 67 65 50 65 72 53 65 63 74 6f 72 2d 31 nPagePerSector-1
23fa0 29 3e 6e 50 61 67 65 43 6f 75 6e 74 20 29 7b 0a )>nPageCount ){.
23fb0 20 20 20 20 20 20 6e 50 61 67 65 20 3d 20 6e 50 nPage = nP
23fc0 61 67 65 43 6f 75 6e 74 2b 31 2d 70 67 31 3b 0a ageCount+1-pg1;.
23fd0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
23fe0 20 6e 50 61 67 65 20 3d 20 6e 50 61 67 65 50 65 nPage = nPagePe
23ff0 72 53 65 63 74 6f 72 3b 0a 20 20 20 20 7d 0a 20 rSector;. }.
24000 20 20 20 61 73 73 65 72 74 28 6e 50 61 67 65 3e assert(nPage>
24010 30 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 70 0);. assert(p
24020 67 31 3c 3d 70 50 67 2d 3e 70 67 6e 6f 29 3b 0a g1<=pPg->pgno);.
24030 20 20 20 20 61 73 73 65 72 74 28 28 70 67 31 2b assert((pg1+
24040 6e 50 61 67 65 29 3e 70 50 67 2d 3e 70 67 6e 6f nPage)>pPg->pgno
24050 29 3b 0a 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 );.. for(ii=0
24060 3b 20 69 69 3c 6e 50 61 67 65 20 26 26 20 72 63 ; ii<nPage && rc
24070 3d 3d 53 51 4c 49 54 45 5f 4f 4b 3b 20 69 69 2b ==SQLITE_OK; ii+
24080 2b 29 7b 0a 20 20 20 20 20 20 50 67 6e 6f 20 70 +){. Pgno p
24090 67 20 3d 20 70 67 31 2b 69 69 3b 0a 20 20 20 20 g = pg1+ii;.
240a0 20 20 50 67 48 64 72 20 2a 70 50 61 67 65 3b 0a PgHdr *pPage;.
240b0 20 20 20 20 20 20 69 66 28 20 70 67 3d 3d 70 50 if( pg==pP
240c0 67 2d 3e 70 67 6e 6f 20 7c 7c 20 21 73 71 6c 69 g->pgno || !sqli
240d0 74 65 33 42 69 74 76 65 63 54 65 73 74 28 70 50 te3BitvecTest(pP
240e0 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c ager->pInJournal
240f0 2c 20 70 67 29 20 29 7b 0a 20 20 20 20 20 20 20 , pg) ){.
24100 20 69 66 28 20 70 67 21 3d 50 41 47 45 52 5f 4d if( pg!=PAGER_M
24110 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 20 29 J_PGNO(pPager) )
24120 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d {. rc =
24130 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
24140 28 70 50 61 67 65 72 2c 20 70 67 2c 20 26 70 50 (pPager, pg, &pP
24150 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 age);.
24160 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
24170 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 K ){.
24180 20 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69 74 rc = pager_writ
24190 65 28 70 50 61 67 65 29 3b 0a 20 20 20 20 20 20 e(pPage);.
241a0 20 20 20 20 20 20 69 66 28 20 70 50 61 67 65 2d if( pPage-
241b0 3e 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 >needSync ){.
241c0 20 20 20 20 20 20 20 20 20 20 20 6e 65 65 64 53 needS
241d0 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 ync = 1;.
241e0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
241f0 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 sqlite3PagerU
24200 6e 72 65 66 28 70 50 61 67 65 29 3b 0a 20 20 20 nref(pPage);.
24210 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
24220 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 }. }else i
24230 66 28 20 28 70 50 61 67 65 20 3d 20 70 61 67 65 f( (pPage = page
24240 72 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c r_lookup(pPager,
24250 20 70 67 29 29 21 3d 30 20 29 7b 0a 20 20 20 20 pg))!=0 ){.
24260 20 20 20 20 69 66 28 20 70 50 61 67 65 2d 3e 6e if( pPage->n
24270 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 20 eedSync ){.
24280 20 20 20 20 20 6e 65 65 64 53 79 6e 63 20 3d 20 needSync =
24290 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 1;. }.
242a0 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 }. }..
242b0 2f 2a 20 49 66 20 74 68 65 20 50 67 48 64 72 2e /* If the PgHdr.
242c0 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 20 69 73 needSync flag is
242d0 20 73 65 74 20 66 6f 72 20 61 6e 79 20 6f 66 20 set for any of
242e0 74 68 65 20 6e 50 61 67 65 20 70 61 67 65 73 20 the nPage pages
242f0 0a 20 20 20 20 2a 2a 20 73 74 61 72 74 69 6e 67 . ** starting
24300 20 61 74 20 70 67 31 2c 20 74 68 65 6e 20 69 74 at pg1, then it
24310 20 6e 65 65 64 73 20 74 6f 20 62 65 20 73 65 74 needs to be set
24320 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 6d for all of them
24330 2e 20 42 65 63 61 75 73 65 0a 20 20 20 20 2a 2a . Because. **
24340 20 77 72 69 74 69 6e 67 20 74 6f 20 61 6e 79 20 writing to any
24350 6f 66 20 74 68 65 73 65 20 6e 50 61 67 65 20 70 of these nPage p
24360 61 67 65 73 20 6d 61 79 20 64 61 6d 61 67 65 20 ages may damage
24370 74 68 65 20 6f 74 68 65 72 73 2c 20 74 68 65 0a the others, the.
24380 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 ** journal f
24390 69 6c 65 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e ile must contain
243a0 20 73 79 6e 63 28 29 65 64 20 63 6f 70 69 65 73 sync()ed copies
243b0 20 6f 66 20 61 6c 6c 20 6f 66 20 74 68 65 6d 0a of all of them.
243c0 20 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 61 6e ** before an
243d0 79 20 6f 66 20 74 68 65 6d 20 63 61 6e 20 62 65 y of them can be
243e0 20 77 72 69 74 74 65 6e 20 6f 75 74 20 74 6f 20 written out to
243f0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
24400 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 e.. */. if
24410 28 20 6e 65 65 64 53 79 6e 63 20 29 7b 0a 20 20 ( needSync ){.
24420 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 for(ii=0; ii
24430 3c 6e 50 61 67 65 20 26 26 20 6e 65 65 64 53 79 <nPage && needSy
24440 6e 63 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 nc; ii++){.
24450 20 20 20 50 67 48 64 72 20 2a 70 50 61 67 65 20 PgHdr *pPage
24460 3d 20 70 61 67 65 72 5f 6c 6f 6f 6b 75 70 28 70 = pager_lookup(p
24470 50 61 67 65 72 2c 20 70 67 31 2b 69 69 29 3b 0a Pager, pg1+ii);.
24480 20 20 20 20 20 20 20 20 69 66 28 20 70 50 61 67 if( pPag
24490 65 20 29 20 70 50 61 67 65 2d 3e 6e 65 65 64 53 e ) pPage->needS
244a0 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d ync = 1;. }
244b0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 70 50 . assert(pP
244c0 61 67 65 72 2d 3e 6e 65 65 64 53 79 6e 63 29 3b ager->needSync);
244d0 0a 20 20 20 20 7d 0a 0a 20 20 20 20 61 73 73 65 . }.. asse
244e0 72 74 28 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f rt( pPager->doNo
244f0 74 53 79 6e 63 3d 3d 31 20 29 3b 0a 20 20 20 20 tSync==1 );.
24500 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 79 6e pPager->doNotSyn
24510 63 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a c = 0;. }else{.
24520 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 rc = pager_w
24530 72 69 74 65 28 70 44 62 50 61 67 65 29 3b 0a 20 rite(pDbPage);.
24540 20 7d 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 }. pagerLeave(
24550 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 pPager);. retur
24560 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 n rc;.}../*.** R
24570 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 eturn TRUE if th
24580 65 20 70 61 67 65 20 67 69 76 65 6e 20 69 6e 20 e page given in
24590 74 68 65 20 61 72 67 75 6d 65 6e 74 20 77 61 73 the argument was
245a0 20 70 72 65 76 69 6f 75 73 6c 79 20 70 61 73 73 previously pass
245b0 65 64 0a 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 ed.** to sqlite3
245c0 50 61 67 65 72 57 72 69 74 65 28 29 2e 20 20 49 PagerWrite(). I
245d0 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 72 n other words, r
245e0 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 69 74 eturn TRUE if it
245f0 20 69 73 20 6f 6b 0a 2a 2a 20 74 6f 20 63 68 61 is ok.** to cha
24600 6e 67 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 nge the content
24610 6f 66 20 74 68 65 20 70 61 67 65 2e 0a 2a 2f 0a of the page..*/.
24620 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 69 #ifndef NDEBUG.i
24630 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 49 nt sqlite3PagerI
24640 73 77 72 69 74 65 61 62 6c 65 28 44 62 50 61 67 swriteable(DbPag
24650 65 20 2a 70 50 67 29 7b 0a 20 20 72 65 74 75 72 e *pPg){. retur
24660 6e 20 70 50 67 2d 3e 64 69 72 74 79 3b 0a 7d 0a n pPg->dirty;.}.
24670 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
24680 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 41 43 55 SQLITE_OMIT_VACU
24690 55 4d 0a 2f 2a 0a 2a 2a 20 52 65 70 6c 61 63 65 UM./*.** Replace
246a0 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 the content of
246b0 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 77 69 a single page wi
246c0 74 68 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 69 th the informati
246d0 6f 6e 20 69 6e 20 74 68 65 20 74 68 69 72 64 0a on in the third.
246e0 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a ** argument..*/.
246f0 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 int sqlite3Pager
24700 4f 76 65 72 77 72 69 74 65 28 50 61 67 65 72 20 Overwrite(Pager
24710 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67 *pPager, Pgno pg
24720 6e 6f 2c 20 76 6f 69 64 20 2a 70 44 61 74 61 29 no, void *pData)
24730 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 3b 0a {. PgHdr *pPg;.
24740 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 70 61 67 int rc;.. pag
24750 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b erEnter(pPager);
24760 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 . rc = sqlite3P
24770 61 67 65 72 47 65 74 28 70 50 61 67 65 72 2c 20 agerGet(pPager,
24780 70 67 6e 6f 2c 20 26 70 50 67 29 3b 0a 20 20 69 pgno, &pPg);. i
24790 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
247a0 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c ){. rc = sql
247b0 69 74 65 33 50 61 67 65 72 57 72 69 74 65 28 70 ite3PagerWrite(p
247c0 50 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d Pg);. if( rc=
247d0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
247e0 20 20 20 20 6d 65 6d 63 70 79 28 73 71 6c 69 74 memcpy(sqlit
247f0 65 33 50 61 67 65 72 47 65 74 44 61 74 61 28 70 e3PagerGetData(p
24800 50 67 29 2c 20 70 44 61 74 61 2c 20 70 50 61 67 Pg), pData, pPag
24810 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 er->pageSize);.
24820 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
24830 50 61 67 65 72 55 6e 72 65 66 28 70 50 67 29 3b PagerUnref(pPg);
24840 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c 65 61 76 . }. pagerLeav
24850 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 e(pPager);. ret
24860 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 urn rc;.}.#endif
24870 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 61 6c 6c 20 74 ../*.** A call t
24880 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 o this routine t
24890 65 6c 6c 73 20 74 68 65 20 70 61 67 65 72 20 74 ells the pager t
248a0 68 61 74 20 69 74 20 69 73 20 6e 6f 74 20 6e 65 hat it is not ne
248b0 63 65 73 73 61 72 79 20 74 6f 0a 2a 2a 20 77 72 cessary to.** wr
248c0 69 74 65 20 74 68 65 20 69 6e 66 6f 72 6d 61 74 ite the informat
248d0 69 6f 6e 20 6f 6e 20 70 61 67 65 20 70 50 67 20 ion on page pPg
248e0 62 61 63 6b 20 74 6f 20 74 68 65 20 64 69 73 6b back to the disk
248f0 2c 20 65 76 65 6e 20 74 68 6f 75 67 68 0a 2a 2a , even though.**
24900 20 74 68 61 74 20 70 61 67 65 20 6d 69 67 68 74 that page might
24910 20 62 65 20 6d 61 72 6b 65 64 20 61 73 20 64 69 be marked as di
24920 72 74 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6f rty..**.** The o
24930 76 65 72 6c 79 69 6e 67 20 73 6f 66 74 77 61 72 verlying softwar
24940 65 20 6c 61 79 65 72 20 63 61 6c 6c 73 20 74 68 e layer calls th
24950 69 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20 is routine when
24960 61 6c 6c 20 6f 66 20 74 68 65 20 64 61 74 61 0a all of the data.
24970 2a 2a 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20 ** on the given
24980 70 61 67 65 20 69 73 20 75 6e 75 73 65 64 2e 20 page is unused.
24990 20 54 68 65 20 70 61 67 65 72 20 6d 61 72 6b 73 The pager marks
249a0 20 74 68 65 20 70 61 67 65 20 61 73 20 63 6c 65 the page as cle
249b0 61 6e 20 73 6f 0a 2a 2a 20 74 68 61 74 20 69 74 an so.** that it
249c0 20 64 6f 65 73 20 6e 6f 74 20 67 65 74 20 77 72 does not get wr
249d0 69 74 74 65 6e 20 74 6f 20 64 69 73 6b 2e 0a 2a itten to disk..*
249e0 2a 0a 2a 2a 20 54 65 73 74 73 20 73 68 6f 77 20 *.** Tests show
249f0 74 68 61 74 20 74 68 69 73 20 6f 70 74 69 6d 69 that this optimi
24a00 7a 61 74 69 6f 6e 2c 20 74 6f 67 65 74 68 65 72 zation, together
24a10 20 77 69 74 68 20 74 68 65 0a 2a 2a 20 73 71 6c with the.** sql
24a20 69 74 65 33 50 61 67 65 72 44 6f 6e 74 52 6f 6c ite3PagerDontRol
24a30 6c 62 61 63 6b 28 29 20 62 65 6c 6f 77 2c 20 6d lback() below, m
24a40 6f 72 65 20 74 68 61 6e 20 64 6f 75 62 6c 65 20 ore than double
24a50 74 68 65 20 73 70 65 65 64 0a 2a 2a 20 6f 66 20 the speed.** of
24a60 6c 61 72 67 65 20 49 4e 53 45 52 54 20 6f 70 65 large INSERT ope
24a70 72 61 74 69 6f 6e 73 20 61 6e 64 20 71 75 61 64 rations and quad
24a80 72 75 70 6c 65 20 74 68 65 20 73 70 65 65 64 20 ruple the speed
24a90 6f 66 20 6c 61 72 67 65 20 44 45 4c 45 54 45 73 of large DELETEs
24aa0 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 74 68 69 ..**.** When thi
24ab0 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c s routine is cal
24ac0 6c 65 64 2c 20 73 65 74 20 74 68 65 20 61 6c 77 led, set the alw
24ad0 61 79 73 52 6f 6c 6c 62 61 63 6b 20 66 6c 61 67 aysRollback flag
24ae0 20 74 6f 20 74 72 75 65 2e 0a 2a 2a 20 53 75 62 to true..** Sub
24af0 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f sequent calls to
24b00 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f 6e sqlite3PagerDon
24b10 74 52 6f 6c 6c 62 61 63 6b 28 29 20 66 6f 72 20 tRollback() for
24b20 74 68 65 20 73 61 6d 65 20 70 61 67 65 0a 2a 2a the same page.**
24b30 20 77 69 6c 6c 20 74 68 65 72 65 61 66 74 65 72 will thereafter
24b40 20 62 65 20 69 67 6e 6f 72 65 64 2e 20 20 54 68 be ignored. Th
24b50 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 is is necessary
24b60 74 6f 20 61 76 6f 69 64 20 61 20 70 72 6f 62 6c to avoid a probl
24b70 65 6d 0a 2a 2a 20 77 68 65 72 65 20 61 20 70 61 em.** where a pa
24b80 67 65 20 77 69 74 68 20 64 61 74 61 20 69 73 20 ge with data is
24b90 61 64 64 65 64 20 74 6f 20 74 68 65 20 66 72 65 added to the fre
24ba0 65 6c 69 73 74 20 64 75 72 69 6e 67 20 6f 6e 65 elist during one
24bb0 20 70 61 72 74 20 6f 66 0a 2a 2a 20 61 20 74 72 part of.** a tr
24bc0 61 6e 73 61 63 74 69 6f 6e 20 74 68 65 6e 20 72 ansaction then r
24bd0 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 emoved from the
24be0 66 72 65 65 6c 69 73 74 20 64 75 72 69 6e 67 20 freelist during
24bf0 61 20 6c 61 74 65 72 20 70 61 72 74 0a 2a 2a 20 a later part.**
24c00 6f 66 20 74 68 65 20 73 61 6d 65 20 74 72 61 6e of the same tran
24c10 73 61 63 74 69 6f 6e 20 61 6e 64 20 72 65 75 73 saction and reus
24c20 65 64 20 66 6f 72 20 73 6f 6d 65 20 6f 74 68 65 ed for some othe
24c30 72 20 70 75 72 70 6f 73 65 2e 20 20 57 68 65 6e r purpose. When
24c40 20 69 74 0a 2a 2a 20 69 73 20 66 69 72 73 74 20 it.** is first
24c50 61 64 64 65 64 20 74 6f 20 74 68 65 20 66 72 65 added to the fre
24c60 65 6c 69 73 74 2c 20 74 68 69 73 20 72 6f 75 74 elist, this rout
24c70 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 20 ine is called.
24c80 57 68 65 6e 20 72 65 75 73 65 64 2c 0a 2a 2a 20 When reused,.**
24c90 74 68 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 the sqlite3Pager
24ca0 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 72 DontRollback() r
24cb0 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 outine is called
24cc0 2e 20 20 42 75 74 20 62 65 63 61 75 73 65 20 74 . But because t
24cd0 68 65 0a 2a 2a 20 70 61 67 65 20 63 6f 6e 74 61 he.** page conta
24ce0 69 6e 73 20 63 72 69 74 69 63 61 6c 20 64 61 74 ins critical dat
24cf0 61 2c 20 77 65 20 73 74 69 6c 6c 20 6e 65 65 64 a, we still need
24d00 20 74 6f 20 62 65 20 73 75 72 65 20 69 74 20 67 to be sure it g
24d10 65 74 73 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 ets.** rolled ba
24d20 63 6b 20 69 6e 20 73 70 69 74 65 20 6f 66 20 74 ck in spite of t
24d30 68 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 he sqlite3PagerD
24d40 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 29 20 63 61 ontRollback() ca
24d50 6c 6c 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ll..*/.void sqli
24d60 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 69 74 te3PagerDontWrit
24d70 65 28 44 62 50 61 67 65 20 2a 70 44 62 50 61 67 e(DbPage *pDbPag
24d80 65 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 e){. PgHdr *pPg
24d90 20 3d 20 70 44 62 50 61 67 65 3b 0a 20 20 50 61 = pDbPage;. Pa
24da0 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 ger *pPager = pP
24db0 67 2d 3e 70 50 61 67 65 72 3b 0a 0a 20 20 69 66 g->pPager;.. if
24dc0 28 20 4d 45 4d 44 42 20 29 20 72 65 74 75 72 6e ( MEMDB ) return
24dd0 3b 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 70 ;. pagerEnter(p
24de0 50 61 67 65 72 29 3b 0a 20 20 70 50 67 2d 3e 61 Pager);. pPg->a
24df0 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 3d 20 lwaysRollback =
24e00 31 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e 64 69 1;. if( pPg->di
24e10 72 74 79 20 26 26 20 21 70 50 61 67 65 72 2d 3e rty && !pPager->
24e20 73 74 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20 20 stmtInUse ){.
24e30 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
24e40 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 5f 53 48 >state>=PAGER_SH
24e50 41 52 45 44 20 29 3b 0a 20 20 20 20 69 66 28 20 ARED );. if(
24e60 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d pPager->dbSize==
24e70 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f 20 26 (int)pPg->pgno &
24e80 26 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 & pPager->origDb
24e90 53 69 7a 65 3c 70 50 61 67 65 72 2d 3e 64 62 53 Size<pPager->dbS
24ea0 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 ize ){. /*
24eb0 49 66 20 74 68 69 73 20 70 61 67 65 73 20 69 73 If this pages is
24ec0 20 74 68 65 20 6c 61 73 74 20 70 61 67 65 20 69 the last page i
24ed0 6e 20 74 68 65 20 66 69 6c 65 20 61 6e 64 20 74 n the file and t
24ee0 68 65 20 66 69 6c 65 20 68 61 73 20 67 72 6f 77 he file has grow
24ef0 6e 0a 20 20 20 20 20 20 2a 2a 20 64 75 72 69 6e n. ** durin
24f00 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 g the current tr
24f10 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 6e 20 ansaction, then
24f20 64 6f 20 4e 4f 54 20 6d 61 72 6b 20 74 68 65 20 do NOT mark the
24f30 70 61 67 65 20 61 73 20 63 6c 65 61 6e 2e 0a 20 page as clean..
24f40 20 20 20 20 20 2a 2a 20 57 68 65 6e 20 74 68 65 ** When the
24f50 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 67 database file g
24f60 72 6f 77 73 2c 20 77 65 20 6d 75 73 74 20 6d 61 rows, we must ma
24f70 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 65 ke sure that the
24f80 20 6c 61 73 74 20 70 61 67 65 0a 20 20 20 20 20 last page.
24f90 20 2a 2a 20 67 65 74 73 20 77 72 69 74 74 65 6e ** gets written
24fa0 20 61 74 20 6c 65 61 73 74 20 6f 6e 63 65 20 73 at least once s
24fb0 6f 20 74 68 61 74 20 74 68 65 20 64 69 73 6b 20 o that the disk
24fc0 66 69 6c 65 20 77 69 6c 6c 20 62 65 20 74 68 65 file will be the
24fd0 20 63 6f 72 72 65 63 74 0a 20 20 20 20 20 20 2a correct. *
24fe0 2a 20 73 69 7a 65 2e 20 49 66 20 79 6f 75 20 64 * size. If you d
24ff0 6f 20 6e 6f 74 20 77 72 69 74 65 20 74 68 69 73 o not write this
25000 20 70 61 67 65 20 61 6e 64 20 74 68 65 20 73 69 page and the si
25010 7a 65 20 6f 66 20 74 68 65 20 66 69 6c 65 0a 20 ze of the file.
25020 20 20 20 20 20 2a 2a 20 6f 6e 20 74 68 65 20 64 ** on the d
25030 69 73 6b 20 65 6e 64 73 20 75 70 20 62 65 69 6e isk ends up bein
25040 67 20 74 6f 6f 20 73 6d 61 6c 6c 2c 20 74 68 61 g too small, tha
25050 74 20 63 61 6e 20 6c 65 61 64 20 74 6f 20 64 61 t can lead to da
25060 74 61 62 61 73 65 0a 20 20 20 20 20 20 2a 2a 20 tabase. **
25070 63 6f 72 72 75 70 74 69 6f 6e 20 64 75 72 69 6e corruption durin
25080 67 20 74 68 65 20 6e 65 78 74 20 74 72 61 6e 73 g the next trans
25090 61 63 74 69 6f 6e 2e 0a 20 20 20 20 20 20 2a 2f action.. */
250a0 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
250b0 20 20 50 41 47 45 52 54 52 41 43 45 33 28 22 44 PAGERTRACE3("D
250c0 4f 4e 54 5f 57 52 49 54 45 20 70 61 67 65 20 25 ONT_WRITE page %
250d0 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 50 67 2d d of %d\n", pPg-
250e0 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70 >pgno, PAGERID(p
250f0 50 61 67 65 72 29 29 3b 0a 20 20 20 20 20 20 49 Pager));. I
25100 4f 54 52 41 43 45 28 28 22 43 4c 45 41 4e 20 25 OTRACE(("CLEAN %
25110 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c p %d\n", pPager,
25120 20 70 50 67 2d 3e 70 67 6e 6f 29 29 0a 20 20 20 pPg->pgno)).
25130 20 20 20 6d 61 6b 65 43 6c 65 61 6e 28 70 50 67 makeClean(pPg
25140 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 );.#ifdef SQLITE
25150 5f 43 48 45 43 4b 5f 50 41 47 45 53 0a 20 20 20 _CHECK_PAGES.
25160 20 20 20 70 50 67 2d 3e 70 61 67 65 48 61 73 68 pPg->pageHash
25170 20 3d 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 = pager_pagehas
25180 68 28 70 50 67 29 3b 0a 23 65 6e 64 69 66 0a 20 h(pPg);.#endif.
25190 20 20 20 7d 0a 20 20 7d 0a 20 20 70 61 67 65 72 }. }. pager
251a0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 7d Leave(pPager);.}
251b0 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 61 6c 6c 20 74 ../*.** A call t
251c0 6f 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 o this routine t
251d0 65 6c 6c 73 20 74 68 65 20 70 61 67 65 72 20 74 ells the pager t
251e0 68 61 74 20 69 66 20 61 20 72 6f 6c 6c 62 61 63 hat if a rollbac
251f0 6b 20 6f 63 63 75 72 73 2c 0a 2a 2a 20 69 74 20 k occurs,.** it
25200 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 is not necessary
25210 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 20 to restore the
25220 64 61 74 61 20 6f 6e 20 74 68 65 20 67 69 76 65 data on the give
25230 6e 20 70 61 67 65 2e 20 20 54 68 69 73 0a 2a 2a n page. This.**
25240 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
25250 70 61 67 65 72 20 64 6f 65 73 20 6e 6f 74 20 68 pager does not h
25260 61 76 65 20 74 6f 20 72 65 63 6f 72 64 20 74 68 ave to record th
25270 65 20 67 69 76 65 6e 20 70 61 67 65 20 69 6e 20 e given page in
25280 74 68 65 0a 2a 2a 20 72 6f 6c 6c 62 61 63 6b 20 the.** rollback
25290 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 journal..**.** I
252a0 66 20 77 65 20 68 61 76 65 20 6e 6f 74 20 79 65 f we have not ye
252b0 74 20 61 63 74 75 61 6c 6c 79 20 72 65 61 64 20 t actually read
252c0 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 74 the content of t
252d0 68 69 73 20 70 61 67 65 20 28 69 66 0a 2a 2a 20 his page (if.**
252e0 74 68 65 20 50 67 48 64 72 2e 6e 65 65 64 52 65 the PgHdr.needRe
252f0 61 64 20 66 6c 61 67 20 69 73 20 73 65 74 29 20 ad flag is set)
25300 74 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e then this routin
25310 65 20 61 63 74 73 20 61 73 20 61 20 70 72 6f 6d e acts as a prom
25320 69 73 65 0a 2a 2a 20 74 68 61 74 20 77 65 20 77 ise.** that we w
25330 69 6c 6c 20 6e 65 76 65 72 20 6e 65 65 64 20 74 ill never need t
25340 6f 20 72 65 61 64 20 74 68 65 20 70 61 67 65 20 o read the page
25350 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 65 20 66 content in the f
25360 75 74 75 72 65 2e 0a 2a 2a 20 73 6f 20 74 68 65 uture..** so the
25370 20 6e 65 65 64 52 65 61 64 20 66 6c 61 67 20 63 needRead flag c
25380 61 6e 20 62 65 20 63 6c 65 61 72 65 64 20 61 74 an be cleared at
25390 20 74 68 69 73 20 70 6f 69 6e 74 2e 0a 2a 2f 0a this point..*/.
253a0 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
253b0 72 44 6f 6e 74 52 6f 6c 6c 62 61 63 6b 28 44 62 rDontRollback(Db
253c0 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 50 61 Page *pPg){. Pa
253d0 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 ger *pPager = pP
253e0 67 2d 3e 70 50 61 67 65 72 3b 0a 0a 20 20 70 61 g->pPager;.. pa
253f0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 gerEnter(pPager)
25400 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
25410 65 72 2d 3e 73 74 61 74 65 3e 3d 50 41 47 45 52 er->state>=PAGER
25420 5f 52 45 53 45 52 56 45 44 20 29 3b 0a 0a 20 20 _RESERVED );..
25430 2f 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 /* If the journa
25440 6c 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 6f 70 l file is not op
25450 65 6e 2c 20 6f 72 20 44 6f 6e 74 57 72 69 74 65 en, or DontWrite
25460 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c () has been call
25470 65 64 20 6f 6e 0a 20 20 2a 2a 20 74 68 69 73 20 ed on. ** this
25480 70 61 67 65 20 28 44 6f 6e 74 57 72 69 74 65 28 page (DontWrite(
25490 29 20 73 65 74 73 20 74 68 65 20 61 6c 77 61 79 ) sets the alway
254a0 73 52 6f 6c 6c 62 61 63 6b 20 66 6c 61 67 29 2c sRollback flag),
254b0 20 74 68 65 6e 20 74 68 69 73 0a 20 20 2a 2a 20 then this. **
254c0 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f function is a no
254d0 2d 6f 70 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 -op.. */. if(
254e0 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
254f0 70 65 6e 3d 3d 30 20 7c 7c 20 70 50 67 2d 3e 61 pen==0 || pPg->a
25500 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 7c 7c lwaysRollback ||
25510 20 70 50 61 67 65 72 2d 3e 61 6c 77 61 79 73 52 pPager->alwaysR
25520 6f 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 70 ollback ){. p
25530 61 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 agerLeave(pPager
25540 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 );. return;.
25550 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 4d 45 }. assert( !ME
25560 4d 44 42 20 29 3b 20 20 20 20 2f 2a 20 46 6f 72 MDB ); /* For
25570 20 61 20 6d 65 6d 64 62 2c 20 70 50 61 67 65 72 a memdb, pPager
25580 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 69 73 ->journalOpen is
25590 20 61 6c 77 61 79 73 20 30 20 2a 2f 0a 0a 23 69 always 0 */..#i
255a0 66 64 65 66 20 53 51 4c 49 54 45 5f 53 45 43 55 fdef SQLITE_SECU
255b0 52 45 5f 44 45 4c 45 54 45 0a 20 20 69 66 28 20 RE_DELETE. if(
255c0 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 7c pPg->inJournal |
255d0 7c 20 28 69 6e 74 29 70 50 67 2d 3e 70 67 6e 6f | (int)pPg->pgno
255e0 20 3e 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 > pPager->origD
255f0 62 53 69 7a 65 20 29 7b 0a 20 20 20 20 72 65 74 bSize ){. ret
25600 75 72 6e 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a urn;. }.#endif.
25610 0a 20 20 2f 2a 20 49 66 20 53 45 43 55 52 45 5f . /* If SECURE_
25620 44 45 4c 45 54 45 20 69 73 20 64 69 73 61 62 6c DELETE is disabl
25630 65 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 ed, then there i
25640 73 20 6e 6f 20 77 61 79 20 74 68 61 74 20 74 68 s no way that th
25650 69 73 0a 20 20 2a 2a 20 72 6f 75 74 69 6e 65 20 is. ** routine
25660 63 61 6e 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e can be called on
25670 20 61 20 70 61 67 65 20 66 6f 72 20 77 68 69 63 a page for whic
25680 68 20 73 71 6c 69 74 65 33 50 61 67 65 72 44 6f h sqlite3PagerDo
25690 6e 74 57 72 69 74 65 28 29 0a 20 20 2a 2a 20 68 ntWrite(). ** h
256a0 61 73 20 6e 6f 74 20 62 65 65 6e 20 70 72 65 76 as not been prev
256b0 69 6f 75 73 6c 79 20 63 61 6c 6c 65 64 20 64 75 iously called du
256c0 72 69 6e 67 20 74 68 65 20 73 61 6d 65 20 74 72 ring the same tr
256d0 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a 20 ansaction.. **
256e0 41 6e 64 20 69 66 20 44 6f 6e 74 57 72 69 74 65 And if DontWrite
256f0 28 29 20 68 61 73 20 70 72 65 76 69 6f 75 73 6c () has previousl
25700 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 2c 20 74 y been called, t
25710 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 2a he following. *
25720 2a 20 63 6f 6e 64 69 74 69 6f 6e 73 20 6d 75 73 * conditions mus
25730 74 20 62 65 20 6d 65 74 2e 0a 20 20 2a 2f 0a 20 t be met.. */.
25740 20 61 73 73 65 72 74 28 20 21 70 50 67 2d 3e 69 assert( !pPg->i
25750 6e 4a 6f 75 72 6e 61 6c 20 26 26 20 28 69 6e 74 nJournal && (int
25760 29 70 50 67 2d 3e 70 67 6e 6f 20 3c 3d 20 70 50 )pPg->pgno <= pP
25770 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 ager->origDbSize
25780 20 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 );.. assert( p
25790 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 Pager->pInJourna
257a0 6c 21 3d 30 20 29 3b 0a 20 20 73 71 6c 69 74 65 l!=0 );. sqlite
257b0 33 42 69 74 76 65 63 53 65 74 28 70 50 61 67 65 3BitvecSet(pPage
257c0 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 r->pInJournal, p
257d0 50 67 2d 3e 70 67 6e 6f 29 3b 0a 20 20 70 50 67 Pg->pgno);. pPg
257e0 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b ->inJournal = 1;
257f0 0a 20 20 70 50 67 2d 3e 6e 65 65 64 52 65 61 64 . pPg->needRead
25800 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 50 61 67 = 0;. if( pPag
25810 65 72 2d 3e 73 74 6d 74 49 6e 55 73 65 20 29 7b er->stmtInUse ){
25820 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
25830 67 65 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3e 3d ger->stmtSize >=
25840 20 70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 pPager->origDbS
25850 69 7a 65 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 ize );. sqlit
25860 65 33 42 69 74 76 65 63 53 65 74 28 70 50 61 67 e3BitvecSet(pPag
25870 65 72 2d 3e 70 49 6e 53 74 6d 74 2c 20 70 50 67 er->pInStmt, pPg
25880 2d 3e 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 50 ->pgno);. }. P
25890 41 47 45 52 54 52 41 43 45 33 28 22 44 4f 4e 54 AGERTRACE3("DONT
258a0 5f 52 4f 4c 4c 42 41 43 4b 20 70 61 67 65 20 25 _ROLLBACK page %
258b0 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 50 67 2d d of %d\n", pPg-
258c0 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70 >pgno, PAGERID(p
258d0 50 61 67 65 72 29 29 3b 0a 20 20 49 4f 54 52 41 Pager));. IOTRA
258e0 43 45 28 28 22 47 41 52 42 41 47 45 20 25 70 20 CE(("GARBAGE %p
258f0 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 70 %d\n", pPager, p
25900 50 67 2d 3e 70 67 6e 6f 29 29 0a 20 20 70 61 67 Pg->pgno)). pag
25910 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b erLeave(pPager);
25920 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .}.../*.** This
25930 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 routine is calle
25940 64 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74 d to increment t
25950 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
25960 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 2c change-counter,
25970 0a 2a 2a 20 73 74 6f 72 65 64 20 61 74 20 62 79 .** stored at by
25980 74 65 20 32 34 20 6f 66 20 74 68 65 20 70 61 67 te 24 of the pag
25990 65 72 20 66 69 6c 65 2e 0a 2a 2f 0a 73 74 61 74 er file..*/.stat
259a0 69 63 20 69 6e 74 20 70 61 67 65 72 5f 69 6e 63 ic int pager_inc
259b0 72 5f 63 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 r_changecounter(
259c0 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 Pager *pPager, i
259d0 6e 74 20 69 73 44 69 72 65 63 74 29 7b 0a 20 20 nt isDirect){.
259e0 50 67 48 64 72 20 2a 70 50 67 48 64 72 3b 0a 20 PgHdr *pPgHdr;.
259f0 20 75 33 32 20 63 68 61 6e 67 65 5f 63 6f 75 6e u32 change_coun
25a00 74 65 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 ter;. int rc =
25a10 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69 66 SQLITE_OK;.. if
25a20 28 20 21 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 ( !pPager->chang
25a30 65 43 6f 75 6e 74 44 6f 6e 65 20 29 7b 0a 20 20 eCountDone ){.
25a40 20 20 2f 2a 20 4f 70 65 6e 20 70 61 67 65 20 31 /* Open page 1
25a50 20 6f 66 20 74 68 65 20 66 69 6c 65 20 66 6f 72 of the file for
25a60 20 77 72 69 74 69 6e 67 2e 20 2a 2f 0a 20 20 20 writing. */.
25a70 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 rc = sqlite3Pag
25a80 65 72 47 65 74 28 70 50 61 67 65 72 2c 20 31 2c erGet(pPager, 1,
25a90 20 26 70 50 67 48 64 72 29 3b 0a 20 20 20 20 69 &pPgHdr);. i
25aa0 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
25ab0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 ) return rc;..
25ac0 20 20 20 69 66 28 20 21 69 73 44 69 72 65 63 74 if( !isDirect
25ad0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
25ae0 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 65 qlite3PagerWrite
25af0 28 70 50 67 48 64 72 29 3b 0a 20 20 20 20 20 20 (pPgHdr);.
25b00 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f if( rc!=SQLITE_O
25b10 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c K ){. sql
25b20 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 70 ite3PagerUnref(p
25b30 50 67 48 64 72 29 3b 0a 20 20 20 20 20 20 20 20 PgHdr);.
25b40 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
25b50 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a }. }.. /*
25b60 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 76 Increment the v
25b70 61 6c 75 65 20 6a 75 73 74 20 72 65 61 64 20 61 alue just read a
25b80 6e 64 20 77 72 69 74 65 20 69 74 20 62 61 63 6b nd write it back
25b90 20 74 6f 20 62 79 74 65 20 32 34 2e 20 2a 2f 0a to byte 24. */.
25ba0 20 20 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 change_count
25bb0 65 72 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 er = sqlite3Get4
25bc0 62 79 74 65 28 28 75 38 2a 29 70 50 61 67 65 72 byte((u8*)pPager
25bd0 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 3b 0a 20 ->dbFileVers);.
25be0 20 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e 74 65 change_counte
25bf0 72 2b 2b 3b 0a 20 20 20 20 70 75 74 33 32 62 69 r++;. put32bi
25c00 74 73 28 28 28 63 68 61 72 2a 29 50 47 48 44 52 ts(((char*)PGHDR
25c10 5f 54 4f 5f 44 41 54 41 28 70 50 67 48 64 72 29 _TO_DATA(pPgHdr)
25c20 29 2b 32 34 2c 20 63 68 61 6e 67 65 5f 63 6f 75 )+24, change_cou
25c30 6e 74 65 72 29 3b 0a 0a 20 20 20 20 69 66 28 20 nter);.. if(
25c40 69 73 44 69 72 65 63 74 20 26 26 20 70 50 61 67 isDirect && pPag
25c50 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 6f 64 73 er->fd->pMethods
25c60 20 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 ){. const
25c70 76 6f 69 64 20 2a 7a 42 75 66 20 3d 20 50 47 48 void *zBuf = PGH
25c80 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 48 64 DR_TO_DATA(pPgHd
25c90 72 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 r);. rc = s
25ca0 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 qlite3OsWrite(pP
25cb0 61 67 65 72 2d 3e 66 64 2c 20 7a 42 75 66 2c 20 ager->fd, zBuf,
25cc0 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
25cd0 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 , 0);. }..
25ce0 20 2f 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20 /* Release the
25cf0 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 2e 20 page reference.
25d00 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 50 61 */. sqlite3Pa
25d10 67 65 72 55 6e 72 65 66 28 70 50 67 48 64 72 29 gerUnref(pPgHdr)
25d20 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 63 68 ;. pPager->ch
25d30 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 angeCountDone =
25d40 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 1;. }. return
25d50 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 79 6e rc;.}../*.** Syn
25d60 63 20 74 68 65 20 70 61 67 65 72 20 66 69 6c 65 c the pager file
25d70 20 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e 74 to disk..*/.int
25d80 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 79 6e sqlite3PagerSyn
25d90 63 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 c(Pager *pPager)
25da0 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 61 {. int rc;. pa
25db0 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 gerEnter(pPager)
25dc0 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 ;. rc = sqlite3
25dd0 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 66 OsSync(pPager->f
25de0 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 5f d, pPager->sync_
25df0 66 6c 61 67 73 29 3b 0a 20 20 70 61 67 65 72 4c flags);. pagerL
25e00 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 eave(pPager);.
25e10 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
25e20 0a 2a 2a 20 53 79 6e 63 20 74 68 65 20 64 61 74 .** Sync the dat
25e30 61 62 61 73 65 20 66 69 6c 65 20 66 6f 72 20 74 abase file for t
25e40 68 65 20 70 61 67 65 72 20 70 50 61 67 65 72 2e he pager pPager.
25e50 20 7a 4d 61 73 74 65 72 20 70 6f 69 6e 74 73 20 zMaster points
25e60 74 6f 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f to the name.** o
25e70 66 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e f a master journ
25e80 61 6c 20 66 69 6c 65 20 74 68 61 74 20 73 68 6f al file that sho
25e90 75 6c 64 20 62 65 20 77 72 69 74 74 65 6e 20 69 uld be written i
25ea0 6e 74 6f 20 74 68 65 20 69 6e 64 69 76 69 64 75 nto the individu
25eb0 61 6c 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 al.** journal fi
25ec0 6c 65 2e 20 7a 4d 61 73 74 65 72 20 6d 61 79 20 le. zMaster may
25ed0 62 65 20 4e 55 4c 4c 2c 20 77 68 69 63 68 20 69 be NULL, which i
25ee0 73 20 69 6e 74 65 72 70 72 65 74 65 64 20 61 73 s interpreted as
25ef0 20 6e 6f 20 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f no master.** jo
25f00 75 72 6e 61 6c 20 28 61 20 73 69 6e 67 6c 65 20 urnal (a single
25f10 64 61 74 61 62 61 73 65 20 74 72 61 6e 73 61 63 database transac
25f20 74 69 6f 6e 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 tion)..**.** Thi
25f30 73 20 72 6f 75 74 69 6e 65 20 65 6e 73 75 72 65 s routine ensure
25f40 73 20 74 68 61 74 20 74 68 65 20 6a 6f 75 72 6e s that the journ
25f50 61 6c 20 69 73 20 73 79 6e 63 65 64 2c 20 61 6c al is synced, al
25f60 6c 20 64 69 72 74 79 20 70 61 67 65 73 20 77 72 l dirty pages wr
25f70 69 74 74 65 6e 0a 2a 2a 20 74 6f 20 74 68 65 20 itten.** to the
25f80 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e database file an
25f90 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 d the database f
25fa0 69 6c 65 20 73 79 6e 63 65 64 2e 20 54 68 65 20 ile synced. The
25fb0 6f 6e 6c 79 20 74 68 69 6e 67 20 74 68 61 74 0a only thing that.
25fc0 2a 2a 20 72 65 6d 61 69 6e 73 20 74 6f 20 63 6f ** remains to co
25fd0 6d 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 mmit the transac
25fe0 74 69 6f 6e 20 69 73 20 74 6f 20 64 65 6c 65 74 tion is to delet
25ff0 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 e the journal fi
26000 6c 65 20 28 6f 72 0a 2a 2a 20 6d 61 73 74 65 72 le (or.** master
26010 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 66 journal file if
26020 20 73 70 65 63 69 66 69 65 64 29 2e 0a 2a 2a 0a specified)..**.
26030 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 69 66 20 ** Note that if
26040 7a 4d 61 73 74 65 72 3d 3d 4e 55 4c 4c 2c 20 74 zMaster==NULL, t
26050 68 69 73 20 64 6f 65 73 20 6e 6f 74 20 6f 76 65 his does not ove
26060 72 77 72 69 74 65 20 61 20 70 72 65 76 69 6f 75 rwrite a previou
26070 73 20 76 61 6c 75 65 0a 2a 2a 20 70 61 73 73 65 s value.** passe
26080 64 20 74 6f 20 61 6e 20 73 71 6c 69 74 65 33 50 d to an sqlite3P
26090 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f agerCommitPhaseO
260a0 6e 65 28 29 20 63 61 6c 6c 2e 0a 2a 2a 0a 2a 2a ne() call..**.**
260b0 20 49 66 20 70 61 72 61 6d 65 74 65 72 20 6e 54 If parameter nT
260c0 72 75 6e 63 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f runc is non-zero
260d0 2c 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 72 , then the pager
260e0 20 66 69 6c 65 20 69 73 20 74 72 75 6e 63 61 74 file is truncat
260f0 65 64 20 74 6f 0a 2a 2a 20 6e 54 72 75 6e 63 20 ed to.** nTrunc
26100 70 61 67 65 73 20 28 74 68 69 73 20 69 73 20 75 pages (this is u
26110 73 65 64 20 62 79 20 61 75 74 6f 2d 76 61 63 75 sed by auto-vacu
26120 75 6d 20 64 61 74 61 62 61 73 65 73 29 2e 0a 2a um databases)..*
26130 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 6e 61 *.** If the fina
26140 6c 20 70 61 72 61 6d 65 74 65 72 20 2d 20 6e 6f l parameter - no
26150 53 79 6e 63 20 2d 20 69 73 20 74 72 75 65 2c 20 Sync - is true,
26160 74 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 then the databas
26170 65 20 66 69 6c 65 20 69 74 73 65 6c 66 0a 2a 2a e file itself.**
26180 20 69 73 20 6e 6f 74 20 73 79 6e 63 65 64 2e 20 is not synced.
26190 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 74 20 The caller must
261a0 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 67 65 call sqlite3Page
261b0 72 53 79 6e 63 28 29 20 64 69 72 65 63 74 6c 79 rSync() directly
261c0 20 74 6f 0a 2a 2a 20 73 79 6e 63 20 74 68 65 20 to.** sync the
261d0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 65 database file be
261e0 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 43 6f 6d fore calling Com
261f0 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 74 6f mitPhaseTwo() to
26200 20 64 65 6c 65 74 65 20 74 68 65 0a 2a 2a 20 6a delete the.** j
26210 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 20 74 ournal file in t
26220 68 69 73 20 63 61 73 65 2e 0a 2a 2f 0a 69 6e 74 his case..*/.int
26230 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d sqlite3PagerCom
26240 6d 69 74 50 68 61 73 65 4f 6e 65 28 0a 20 20 50 mitPhaseOne(. P
26250 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 0a 20 ager *pPager, .
26260 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 const char *zMa
26270 73 74 65 72 2c 20 0a 20 20 50 67 6e 6f 20 6e 54 ster, . Pgno nT
26280 72 75 6e 63 2c 0a 20 20 69 6e 74 20 6e 6f 53 79 runc,. int noSy
26290 6e 63 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d nc.){. int rc =
262a0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 50 SQLITE_OK;.. P
262b0 41 47 45 52 54 52 41 43 45 34 28 22 44 41 54 41 AGERTRACE4("DATA
262c0 42 41 53 45 20 53 59 4e 43 3a 20 46 69 6c 65 3d BASE SYNC: File=
262d0 25 73 20 7a 4d 61 73 74 65 72 3d 25 73 20 6e 54 %s zMaster=%s nT
262e0 72 75 6e 63 3d 25 64 5c 6e 22 2c 20 0a 20 20 20 runc=%d\n", .
262f0 20 20 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 pPager->zFile
26300 6e 61 6d 65 2c 20 7a 4d 61 73 74 65 72 2c 20 6e name, zMaster, n
26310 54 72 75 6e 63 29 3b 0a 20 20 70 61 67 65 72 45 Trunc);. pagerE
26320 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 0a 20 nter(pPager);..
26330 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 /* If this is a
26340 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 62 2c 20 n in-memory db,
26350 6f 72 20 6e 6f 20 70 61 67 65 73 20 68 61 76 65 or no pages have
26360 20 62 65 65 6e 20 77 72 69 74 74 65 6e 20 74 6f been written to
26370 2c 20 6f 72 20 74 68 69 73 0a 20 20 2a 2a 20 66 , or this. ** f
26380 75 6e 63 74 69 6f 6e 20 68 61 73 20 61 6c 72 65 unction has alre
26390 61 64 79 20 62 65 65 6e 20 63 61 6c 6c 65 64 2c ady been called,
263a0 20 69 74 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a it is a no-op..
263b0 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 67 65 */. if( pPage
263c0 72 2d 3e 73 74 61 74 65 21 3d 50 41 47 45 52 5f r->state!=PAGER_
263d0 53 59 4e 43 45 44 20 26 26 20 21 4d 45 4d 44 42 SYNCED && !MEMDB
263e0 20 26 26 20 70 50 61 67 65 72 2d 3e 64 69 72 74 && pPager->dirt
263f0 79 43 61 63 68 65 20 29 7b 0a 20 20 20 20 50 67 yCache ){. Pg
26400 48 64 72 20 2a 70 50 67 3b 0a 0a 23 69 66 64 65 Hdr *pPg;..#ifde
26410 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
26420 41 54 4f 4d 49 43 5f 57 52 49 54 45 0a 20 20 20 ATOMIC_WRITE.
26430 20 2f 2a 20 54 68 65 20 61 74 6f 6d 69 63 2d 77 /* The atomic-w
26440 72 69 74 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f rite optimizatio
26450 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 66 n can be used if
26460 20 61 6c 6c 20 6f 66 20 74 68 65 0a 20 20 20 20 all of the.
26470 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 ** following are
26480 20 74 72 75 65 3a 0a 20 20 20 20 2a 2a 0a 20 20 true:. **.
26490 20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 66 69 ** + The fi
264a0 6c 65 2d 73 79 73 74 65 6d 20 73 75 70 70 6f 72 le-system suppor
264b0 74 73 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 72 ts the atomic-wr
264c0 69 74 65 20 70 72 6f 70 65 72 74 79 20 66 6f 72 ite property for
264d0 0a 20 20 20 20 2a 2a 20 20 20 20 20 20 62 6c 6f . ** blo
264e0 63 6b 73 20 6f 66 20 73 69 7a 65 20 70 61 67 65 cks of size page
264f0 2d 73 69 7a 65 2c 20 61 6e 64 0a 20 20 20 20 2a -size, and. *
26500 2a 20 20 20 20 2b 20 54 68 69 73 20 63 6f 6d 6d * + This comm
26510 69 74 20 69 73 20 6e 6f 74 20 70 61 72 74 20 6f it is not part o
26520 66 20 61 20 6d 75 6c 74 69 2d 66 69 6c 65 20 74 f a multi-file t
26530 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64 0a ransaction, and.
26540 20 20 20 20 2a 2a 20 20 20 20 2b 20 45 78 61 63 ** + Exac
26550 74 6c 79 20 6f 6e 65 20 70 61 67 65 20 68 61 73 tly one page has
26560 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 20 61 been modified a
26570 6e 64 20 73 74 6f 72 65 20 69 6e 20 74 68 65 20 nd store in the
26580 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 20 journal file..
26590 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 **. ** If t
265a0 68 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 he optimization
265b0 63 61 6e 20 62 65 20 75 73 65 64 2c 20 74 68 65 can be used, the
265c0 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 n the journal fi
265d0 6c 65 20 77 69 6c 6c 20 6e 65 76 65 72 0a 20 20 le will never.
265e0 20 20 2a 2a 20 62 65 20 63 72 65 61 74 65 64 20 ** be created
265f0 66 6f 72 20 74 68 69 73 20 74 72 61 6e 73 61 63 for this transac
26600 74 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 tion.. */.
26610 20 69 6e 74 20 75 73 65 41 74 6f 6d 69 63 57 72 int useAtomicWr
26620 69 74 65 20 3d 20 28 0a 20 20 20 20 20 20 20 20 ite = (.
26630 21 7a 4d 61 73 74 65 72 20 26 26 20 0a 20 20 20 !zMaster && .
26640 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 pPager->jou
26650 72 6e 61 6c 4f 66 66 3d 3d 6a 72 6e 6c 42 75 66 rnalOff==jrnlBuf
26660 66 65 72 53 69 7a 65 28 70 50 61 67 65 72 29 20 ferSize(pPager)
26670 26 26 20 0a 20 20 20 20 20 20 20 20 6e 54 72 75 && . nTru
26680 6e 63 3d 3d 30 20 26 26 20 0a 20 20 20 20 20 20 nc==0 && .
26690 20 20 28 30 3d 3d 70 50 61 67 65 72 2d 3e 70 44 (0==pPager->pD
266a0 69 72 74 79 20 7c 7c 20 30 3d 3d 70 50 61 67 65 irty || 0==pPage
266b0 72 2d 3e 70 44 69 72 74 79 2d 3e 70 44 69 72 74 r->pDirty->pDirt
266c0 79 29 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66 y). );. if
266d0 28 20 75 73 65 41 74 6f 6d 69 63 57 72 69 74 65 ( useAtomicWrite
266e0 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 55 70 64 ){. /* Upd
266f0 61 74 65 20 74 68 65 20 6e 52 65 63 20 66 69 65 ate the nRec fie
26700 6c 64 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 ld in the journa
26710 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 20 l file. */.
26720 20 69 6e 74 20 6f 66 66 73 65 74 20 3d 20 70 50 int offset = pP
26730 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
26740 20 2b 20 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e + sizeof(aJourn
26750 61 6c 4d 61 67 69 63 29 3b 0a 20 20 20 20 20 20 alMagic);.
26760 61 73 73 65 72 74 28 70 50 61 67 65 72 2d 3e 6e assert(pPager->n
26770 52 65 63 3d 3d 31 29 3b 0a 20 20 20 20 20 20 72 Rec==1);. r
26780 63 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 c = write32bits(
26790 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 6f 66 66 pPager->jfd, off
267a0 73 65 74 2c 20 70 50 61 67 65 72 2d 3e 6e 52 65 set, pPager->nRe
267b0 63 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 55 70 c);.. /* Up
267c0 64 61 74 65 20 74 68 65 20 64 62 20 66 69 6c 65 date the db file
267d0 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e change counter.
267e0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 The following c
267f0 61 6c 6c 20 77 69 6c 6c 20 6d 6f 64 69 66 79 0a all will modify.
26800 20 20 20 20 20 20 2a 2a 20 74 68 65 20 69 6e 2d ** the in-
26810 6d 65 6d 6f 72 79 20 72 65 70 72 65 73 65 6e 74 memory represent
26820 61 74 69 6f 6e 20 6f 66 20 70 61 67 65 20 31 20 ation of page 1
26830 74 6f 20 69 6e 63 6c 75 64 65 20 74 68 65 20 75 to include the u
26840 70 64 61 74 65 64 0a 20 20 20 20 20 20 2a 2a 20 pdated. **
26850 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 61 change counter a
26860 6e 64 20 74 68 65 6e 20 77 72 69 74 65 20 70 61 nd then write pa
26870 67 65 20 31 20 64 69 72 65 63 74 6c 79 20 74 6f ge 1 directly to
26880 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 20 20 the database.
26890 20 20 20 20 2a 2a 20 66 69 6c 65 2e 20 42 65 63 ** file. Bec
268a0 61 75 73 65 20 6f 66 20 74 68 65 20 61 74 6f 6d ause of the atom
268b0 69 63 2d 77 72 69 74 65 20 70 72 6f 70 65 72 74 ic-write propert
268c0 79 20 6f 66 20 74 68 65 20 68 6f 73 74 20 66 69 y of the host fi
268d0 6c 65 2d 73 79 73 74 65 6d 2c 20 0a 20 20 20 20 le-system, .
268e0 20 20 2a 2a 20 74 68 69 73 20 69 73 20 73 61 66 ** this is saf
268f0 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 e.. */.
26900 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
26910 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 72 _OK ){. r
26920 63 20 3d 20 70 61 67 65 72 5f 69 6e 63 72 5f 63 c = pager_incr_c
26930 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 70 50 61 hangecounter(pPa
26940 67 65 72 2c 20 31 29 3b 0a 20 20 20 20 20 20 7d ger, 1);. }
26950 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
26960 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4a 6f rc = sqlite3Jo
26970 75 72 6e 61 6c 43 72 65 61 74 65 28 70 50 61 67 urnalCreate(pPag
26980 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 7d 0a er->jfd);. }.
26990 0a 20 20 20 20 69 66 28 20 21 75 73 65 41 74 6f . if( !useAto
269a0 6d 69 63 57 72 69 74 65 20 26 26 20 72 63 3d 3d micWrite && rc==
269b0 53 51 4c 49 54 45 5f 4f 4b 20 29 0a 23 65 6e 64 SQLITE_OK ).#end
269c0 69 66 0a 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 if.. /* If a
269d0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
269e0 69 6c 65 20 6e 61 6d 65 20 68 61 73 20 61 6c 72 ile name has alr
269f0 65 61 64 79 20 62 65 65 6e 20 77 72 69 74 74 65 eady been writte
26a00 6e 20 74 6f 20 74 68 65 0a 20 20 20 20 2a 2a 20 n to the. **
26a10 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 journal file, th
26a20 65 6e 20 6e 6f 20 73 79 6e 63 20 69 73 20 72 65 en no sync is re
26a30 71 75 69 72 65 64 2e 20 54 68 69 73 20 68 61 70 quired. This hap
26a40 70 65 6e 73 20 77 68 65 6e 20 69 74 20 69 73 0a pens when it is.
26a50 20 20 20 20 2a 2a 20 77 72 69 74 74 65 6e 2c 20 ** written,
26a60 74 68 65 6e 20 74 68 65 20 70 72 6f 63 65 73 73 then the process
26a70 20 66 61 69 6c 73 20 74 6f 20 75 70 67 72 61 64 fails to upgrad
26a80 65 20 66 72 6f 6d 20 61 20 52 45 53 45 52 56 45 e from a RESERVE
26a90 44 20 74 6f 20 61 6e 0a 20 20 20 20 2a 2a 20 45 D to an. ** E
26aa0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 54 XCLUSIVE lock. T
26ab0 68 65 20 6e 65 78 74 20 74 69 6d 65 20 74 68 65 he next time the
26ac0 20 70 72 6f 63 65 73 73 20 74 72 69 65 73 20 74 process tries t
26ad0 6f 20 63 6f 6d 6d 69 74 20 74 68 65 0a 20 20 20 o commit the.
26ae0 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ** transaction
26af0 74 68 65 20 6d 2d 6a 20 6e 61 6d 65 20 77 69 6c the m-j name wil
26b00 6c 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 l have already b
26b10 65 65 6e 20 77 72 69 74 74 65 6e 2e 0a 20 20 20 een written..
26b20 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 70 50 61 */. if( !pPa
26b30 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 29 ger->setMaster )
26b40 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 {. rc = pag
26b50 65 72 5f 69 6e 63 72 5f 63 68 61 6e 67 65 63 6f er_incr_changeco
26b60 75 6e 74 65 72 28 70 50 61 67 65 72 2c 20 30 29 unter(pPager, 0)
26b70 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 3d ;. if( rc!=
26b80 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 6f SQLITE_OK ) goto
26b90 20 73 79 6e 63 5f 65 78 69 74 3b 0a 23 69 66 6e sync_exit;.#ifn
26ba0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
26bb0 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 20 20 20 AUTOVACUUM.
26bc0 20 69 66 28 20 6e 54 72 75 6e 63 21 3d 30 20 29 if( nTrunc!=0 )
26bd0 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 {. /* If
26be0 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e this transaction
26bf0 20 68 61 73 20 6d 61 64 65 20 74 68 65 20 64 61 has made the da
26c00 74 61 62 61 73 65 20 73 6d 61 6c 6c 65 72 2c 20 tabase smaller,
26c10 74 68 65 6e 20 61 6c 6c 20 70 61 67 65 73 0a 20 then all pages.
26c20 20 20 20 20 20 20 20 2a 2a 20 62 65 69 6e 67 20 ** being
26c30 64 69 73 63 61 72 64 65 64 20 62 79 20 74 68 65 discarded by the
26c40 20 74 72 75 6e 63 61 74 69 6f 6e 20 6d 75 73 74 truncation must
26c50 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74 be written to t
26c60 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 he journal.
26c70 20 20 20 2a 2a 20 66 69 6c 65 2e 0a 20 20 20 20 ** file..
26c80 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 50 */. P
26c90 67 6e 6f 20 69 3b 0a 20 20 20 20 20 20 20 20 69 gno i;. i
26ca0 6e 74 20 69 53 6b 69 70 20 3d 20 50 41 47 45 52 nt iSkip = PAGER
26cb0 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 _MJ_PGNO(pPager)
26cc0 3b 0a 20 20 20 20 20 20 20 20 66 6f 72 28 20 69 ;. for( i
26cd0 3d 6e 54 72 75 6e 63 2b 31 3b 20 69 3c 3d 70 50 =nTrunc+1; i<=pP
26ce0 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 ager->origDbSize
26cf0 3b 20 69 2b 2b 20 29 7b 0a 20 20 20 20 20 20 20 ; i++ ){.
26d00 20 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 42 if( !sqlite3B
26d10 69 74 76 65 63 54 65 73 74 28 70 50 61 67 65 72 itvecTest(pPager
26d20 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 69 29 ->pInJournal, i)
26d30 20 26 26 20 69 21 3d 69 53 6b 69 70 20 29 7b 0a && i!=iSkip ){.
26d40 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
26d50 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 sqlite3PagerGet
26d60 28 70 50 61 67 65 72 2c 20 69 2c 20 26 70 50 67 (pPager, i, &pPg
26d70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 );. i
26d80 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
26d90 20 29 20 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69 ) goto sync_exi
26da0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 t;. r
26db0 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 c = sqlite3Pager
26dc0 57 72 69 74 65 28 70 50 67 29 3b 0a 20 20 20 20 Write(pPg);.
26dd0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 sqlite3P
26de0 61 67 65 72 55 6e 72 65 66 28 70 50 67 29 3b 0a agerUnref(pPg);.
26df0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
26e00 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
26e10 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a goto sync_exit;.
26e20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
26e30 20 20 20 20 7d 20 0a 20 20 20 20 20 20 7d 0a 23 } . }.#
26e40 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d endif. rc =
26e50 20 77 72 69 74 65 4d 61 73 74 65 72 4a 6f 75 72 writeMasterJour
26e60 6e 61 6c 28 70 50 61 67 65 72 2c 20 7a 4d 61 73 nal(pPager, zMas
26e70 74 65 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ter);. if(
26e80 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 rc!=SQLITE_OK )
26e90 67 6f 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a goto sync_exit;.
26ea0 20 20 20 20 20 20 72 63 20 3d 20 73 79 6e 63 4a rc = syncJ
26eb0 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 29 3b 0a ournal(pPager);.
26ec0 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 }. if( rc
26ed0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f !=SQLITE_OK ) go
26ee0 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a 0a 23 to sync_exit;..#
26ef0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
26f00 49 54 5f 41 55 54 4f 56 41 43 55 55 4d 0a 20 20 IT_AUTOVACUUM.
26f10 20 20 69 66 28 20 6e 54 72 75 6e 63 21 3d 30 20 if( nTrunc!=0
26f20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 ){. rc = sq
26f30 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 61 lite3PagerTrunca
26f40 74 65 28 70 50 61 67 65 72 2c 20 6e 54 72 75 6e te(pPager, nTrun
26f50 63 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 c);. if( rc
26f60 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f !=SQLITE_OK ) go
26f70 74 6f 20 73 79 6e 63 5f 65 78 69 74 3b 0a 20 20 to sync_exit;.
26f80 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 }.#endif..
26f90 2f 2a 20 57 72 69 74 65 20 61 6c 6c 20 64 69 72 /* Write all dir
26fa0 74 79 20 70 61 67 65 73 20 74 6f 20 74 68 65 20 ty pages to the
26fb0 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f database file */
26fc0 0a 20 20 20 20 70 50 67 20 3d 20 70 61 67 65 72 . pPg = pager
26fd0 5f 67 65 74 5f 61 6c 6c 5f 64 69 72 74 79 5f 70 _get_all_dirty_p
26fe0 61 67 65 73 28 70 50 61 67 65 72 29 3b 0a 20 20 ages(pPager);.
26ff0 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 72 69 rc = pager_wri
27000 74 65 5f 70 61 67 65 6c 69 73 74 28 70 50 67 29 te_pagelist(pPg)
27010 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
27020 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
27030 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c assert( rc!=SQL
27040 49 54 45 5f 49 4f 45 52 52 5f 42 4c 4f 43 4b 45 ITE_IOERR_BLOCKE
27050 44 20 29 3b 0a 20 20 20 20 20 20 2f 2a 20 54 68 D );. /* Th
27060 65 20 65 72 72 6f 72 20 6d 69 67 68 74 20 68 61 e error might ha
27070 76 65 20 6c 65 66 74 20 74 68 65 20 64 69 72 74 ve left the dirt
27080 79 20 6c 69 73 74 20 61 6c 6c 20 66 6f 75 6c 65 y list all foule
27090 64 20 75 70 20 68 65 72 65 2c 0a 20 20 20 20 20 d up here,.
270a0 20 2a 2a 20 62 75 74 20 74 68 61 74 20 64 6f 65 ** but that doe
270b0 73 20 6e 6f 74 20 6d 61 74 74 65 72 20 62 65 63 s not matter bec
270c0 61 75 73 65 20 69 66 20 74 68 65 20 69 66 20 74 ause if the if t
270d0 68 65 20 64 69 72 74 79 20 6c 69 73 74 20 64 69 he dirty list di
270e0 64 0a 20 20 20 20 20 20 2a 2a 20 67 65 74 20 63 d. ** get c
270f0 6f 72 72 75 70 74 65 64 2c 20 74 68 65 6e 20 74 orrupted, then t
27100 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 he transaction w
27110 69 6c 6c 20 72 6f 6c 6c 20 62 61 63 6b 20 61 6e ill roll back an
27120 64 0a 20 20 20 20 20 20 2a 2a 20 64 69 73 63 61 d. ** disca
27130 72 64 20 74 68 65 20 64 69 72 74 79 20 6c 69 73 rd the dirty lis
27140 74 2e 20 20 54 68 65 72 65 20 69 73 20 61 6e 20 t. There is an
27150 61 73 73 65 72 74 20 69 6e 0a 20 20 20 20 20 20 assert in.
27160 2a 2a 20 70 61 67 65 72 5f 67 65 74 5f 61 6c 6c ** pager_get_all
27170 5f 64 69 72 74 79 5f 70 61 67 65 73 28 29 20 74 _dirty_pages() t
27180 68 61 74 20 76 65 72 69 66 69 65 73 20 74 68 61 hat verifies tha
27190 74 20 6e 6f 20 61 74 74 65 6d 70 74 0a 20 20 20 t no attempt.
271a0 20 20 20 2a 2a 20 69 73 20 6d 61 64 65 20 74 6f ** is made to
271b0 20 75 73 65 20 61 6e 20 69 6e 76 61 6c 69 64 20 use an invalid
271c0 64 69 72 74 79 20 6c 69 73 74 2e 0a 20 20 20 20 dirty list..
271d0 20 20 2a 2f 0a 20 20 20 20 20 20 67 6f 74 6f 20 */. goto
271e0 73 79 6e 63 5f 65 78 69 74 3b 0a 20 20 20 20 7d sync_exit;. }
271f0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 44 69 . pPager->pDi
27200 72 74 79 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a rty = 0;.. /*
27210 20 53 79 6e 63 20 74 68 65 20 64 61 74 61 62 61 Sync the databa
27220 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 20 se file. */.
27230 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 if( !pPager->noS
27240 79 6e 63 20 26 26 20 21 6e 6f 53 79 6e 63 20 29 ync && !noSync )
27250 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
27260 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 67 65 ite3OsSync(pPage
27270 72 2d 3e 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 r->fd, pPager->s
27280 79 6e 63 5f 66 6c 61 67 73 29 3b 0a 20 20 20 20 ync_flags);.
27290 7d 0a 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 }. IOTRACE(("
272a0 44 42 53 59 4e 43 20 25 70 5c 6e 22 2c 20 70 50 DBSYNC %p\n", pP
272b0 61 67 65 72 29 29 0a 0a 20 20 20 20 70 50 61 67 ager)).. pPag
272c0 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 45 er->state = PAGE
272d0 52 5f 53 59 4e 43 45 44 3b 0a 20 20 7d 65 6c 73 R_SYNCED;. }els
272e0 65 20 69 66 28 20 4d 45 4d 44 42 20 26 26 20 6e e if( MEMDB && n
272f0 54 72 75 6e 63 21 3d 30 20 29 7b 0a 20 20 20 20 Trunc!=0 ){.
27300 72 63 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 rc = sqlite3Page
27310 72 54 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 rTruncate(pPager
27320 2c 20 6e 54 72 75 6e 63 29 3b 0a 20 20 7d 0a 0a , nTrunc);. }..
27330 73 79 6e 63 5f 65 78 69 74 3a 0a 20 20 69 66 28 sync_exit:. if(
27340 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 rc==SQLITE_IOER
27350 52 5f 42 4c 4f 43 4b 45 44 20 29 7b 0a 20 20 20 R_BLOCKED ){.
27360 20 2f 2a 20 70 61 67 65 72 5f 69 6e 63 72 5f 63 /* pager_incr_c
27370 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 20 6d hangecounter() m
27380 61 79 20 61 74 74 65 6d 70 74 20 74 6f 20 6f 62 ay attempt to ob
27390 74 61 69 6e 20 61 6e 20 65 78 63 6c 75 73 69 76 tain an exclusiv
273a0 65 0a 20 20 20 20 20 2a 20 6c 6f 63 6b 20 74 6f e. * lock to
273b0 20 73 70 69 6c 6c 20 74 68 65 20 63 61 63 68 65 spill the cache
273c0 20 61 6e 64 20 72 65 74 75 72 6e 20 49 4f 45 52 and return IOER
273d0 52 5f 42 4c 4f 43 4b 45 44 2e 20 42 75 74 20 73 R_BLOCKED. But s
273e0 69 6e 63 65 20 0a 20 20 20 20 20 2a 20 74 68 65 ince . * the
273f0 72 65 20 69 73 20 6e 6f 20 63 68 61 6e 63 65 20 re is no chance
27400 74 68 65 20 63 61 63 68 65 20 69 73 20 69 6e 63 the cache is inc
27410 6f 6e 73 69 73 74 65 6e 74 2c 20 69 74 20 69 73 onsistent, it is
27420 0a 20 20 20 20 20 2a 20 62 65 74 74 65 72 20 74 . * better t
27430 6f 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f o return SQLITE_
27440 42 55 53 59 2e 0a 20 20 20 20 20 2a 2f 0a 20 20 BUSY.. */.
27450 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 42 55 rc = SQLITE_BU
27460 53 59 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 4c SY;. }. pagerL
27470 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 eave(pPager);.
27480 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f return rc;.}.../
27490 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 61 6c 6c 20 *.** Commit all
274a0 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 changes to the d
274b0 61 74 61 62 61 73 65 20 61 6e 64 20 72 65 6c 65 atabase and rele
274c0 61 73 65 20 74 68 65 20 77 72 69 74 65 20 6c 6f ase the write lo
274d0 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ck..**.** If the
274e0 20 63 6f 6d 6d 69 74 20 66 61 69 6c 73 20 66 6f commit fails fo
274f0 72 20 61 6e 79 20 72 65 61 73 6f 6e 2c 20 61 20 r any reason, a
27500 72 6f 6c 6c 62 61 63 6b 20 61 74 74 65 6d 70 74 rollback attempt
27510 20 69 73 20 6d 61 64 65 0a 2a 2a 20 61 6e 64 20 is made.** and
27520 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 an error code is
27530 20 72 65 74 75 72 6e 65 64 2e 20 20 49 66 20 74 returned. If t
27540 68 65 20 63 6f 6d 6d 69 74 20 77 6f 72 6b 65 64 he commit worked
27550 2c 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 , SQLITE_OK.** i
27560 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 s returned..*/.i
27570 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 nt sqlite3PagerC
27580 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 50 61 ommitPhaseTwo(Pa
27590 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
275a0 69 6e 74 20 72 63 3b 0a 20 20 50 67 48 64 72 20 int rc;. PgHdr
275b0 2a 70 50 67 3b 0a 0a 20 20 69 66 28 20 70 50 61 *pPg;.. if( pPa
275c0 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 7b 0a ger->errCode ){.
275d0 20 20 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 return pPage
275e0 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 7d 0a r->errCode;. }.
275f0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 if( pPager->st
27600 61 74 65 3c 50 41 47 45 52 5f 52 45 53 45 52 56 ate<PAGER_RESERV
27610 45 44 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e ED ){. return
27620 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 SQLITE_ERROR;.
27630 20 7d 0a 20 20 70 61 67 65 72 45 6e 74 65 72 28 }. pagerEnter(
27640 70 50 61 67 65 72 29 3b 0a 20 20 50 41 47 45 52 pPager);. PAGER
27650 54 52 41 43 45 32 28 22 43 4f 4d 4d 49 54 20 25 TRACE2("COMMIT %
27660 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 d\n", PAGERID(pP
27670 61 67 65 72 29 29 3b 0a 20 20 69 66 28 20 4d 45 ager));. if( ME
27680 4d 44 42 20 29 7b 0a 20 20 20 20 70 50 67 20 3d MDB ){. pPg =
27690 20 70 61 67 65 72 5f 67 65 74 5f 61 6c 6c 5f 64 pager_get_all_d
276a0 69 72 74 79 5f 70 61 67 65 73 28 70 50 61 67 65 irty_pages(pPage
276b0 72 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 70 r);. while( p
276c0 50 67 20 29 7b 0a 20 20 20 20 20 20 50 67 48 69 Pg ){. PgHi
276d0 73 74 6f 72 79 20 2a 70 48 69 73 74 20 3d 20 50 story *pHist = P
276e0 47 48 44 52 5f 54 4f 5f 48 49 53 54 28 70 50 67 GHDR_TO_HIST(pPg
276f0 2c 20 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 , pPager);.
27700 20 63 6c 65 61 72 48 69 73 74 6f 72 79 28 70 48 clearHistory(pH
27710 69 73 74 29 3b 0a 20 20 20 20 20 20 70 50 67 2d ist);. pPg-
27720 3e 64 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 >dirty = 0;.
27730 20 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c pPg->inJournal
27740 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 48 69 73 = 0;. pHis
27750 74 2d 3e 69 6e 53 74 6d 74 20 3d 20 30 3b 0a 20 t->inStmt = 0;.
27760 20 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 79 pPg->needSy
27770 6e 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 48 nc = 0;. pH
27780 69 73 74 2d 3e 70 50 72 65 76 53 74 6d 74 20 3d ist->pPrevStmt =
27790 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53 74 6d pHist->pNextStm
277a0 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 67 t = 0;. pPg
277b0 20 3d 20 70 50 67 2d 3e 70 44 69 72 74 79 3b 0a = pPg->pDirty;.
277c0 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 }. pPager
277d0 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 23 69 ->pDirty = 0;.#i
277e0 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 20 20 fndef NDEBUG.
277f0 20 66 6f 72 28 70 50 67 3d 70 50 61 67 65 72 2d for(pPg=pPager-
27800 3e 70 41 6c 6c 3b 20 70 50 67 3b 20 70 50 67 3d >pAll; pPg; pPg=
27810 70 50 67 2d 3e 70 4e 65 78 74 41 6c 6c 29 7b 0a pPg->pNextAll){.
27820 20 20 20 20 20 20 50 67 48 69 73 74 6f 72 79 20 PgHistory
27830 2a 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 *pHist = PGHDR_T
27840 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 O_HIST(pPg, pPag
27850 65 72 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 er);. asser
27860 74 28 20 21 70 50 67 2d 3e 61 6c 77 61 79 73 52 t( !pPg->alwaysR
27870 6f 6c 6c 62 61 63 6b 20 29 3b 0a 20 20 20 20 20 ollback );.
27880 20 61 73 73 65 72 74 28 20 21 70 48 69 73 74 2d assert( !pHist-
27890 3e 70 4f 72 69 67 20 29 3b 0a 20 20 20 20 20 20 >pOrig );.
278a0 61 73 73 65 72 74 28 20 21 70 48 69 73 74 2d 3e assert( !pHist->
278b0 70 53 74 6d 74 20 29 3b 0a 20 20 20 20 7d 0a 23 pStmt );. }.#
278c0 65 6e 64 69 66 0a 20 20 20 20 70 50 61 67 65 72 endif. pPager
278d0 2d 3e 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 20 ->pStmt = 0;.
278e0 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 20 3d pPager->state =
278f0 20 50 41 47 45 52 5f 53 48 41 52 45 44 3b 0a 20 PAGER_SHARED;.
27900 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 50 pagerLeave(pP
27910 61 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75 72 ager);. retur
27920 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
27930 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
27940 72 2d 3e 73 74 61 74 65 3d 3d 50 41 47 45 52 5f r->state==PAGER_
27950 53 59 4e 43 45 44 20 7c 7c 20 21 70 50 61 67 65 SYNCED || !pPage
27960 72 2d 3e 64 69 72 74 79 43 61 63 68 65 20 29 3b r->dirtyCache );
27970 0a 20 20 72 63 20 3d 20 70 61 67 65 72 5f 65 6e . rc = pager_en
27980 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 d_transaction(pP
27990 61 67 65 72 29 3b 0a 20 20 72 63 20 3d 20 70 61 ager);. rc = pa
279a0 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 72 ger_error(pPager
279b0 2c 20 72 63 29 3b 0a 20 20 70 61 67 65 72 4c 65 , rc);. pagerLe
279c0 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 ave(pPager);. r
279d0 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
279e0 2a 2a 20 52 6f 6c 6c 62 61 63 6b 20 61 6c 6c 20 ** Rollback all
279f0 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20 64 61 changes. The da
27a00 74 61 62 61 73 65 20 66 61 6c 6c 73 20 62 61 63 tabase falls bac
27a10 6b 20 74 6f 20 50 41 47 45 52 5f 53 48 41 52 45 k to PAGER_SHARE
27a20 44 20 6d 6f 64 65 2e 0a 2a 2a 20 41 6c 6c 20 69 D mode..** All i
27a30 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 20 70 n-memory cache p
27a40 61 67 65 73 20 72 65 76 65 72 74 20 74 6f 20 74 ages revert to t
27a50 68 65 69 72 20 6f 72 69 67 69 6e 61 6c 20 64 61 heir original da
27a60 74 61 20 63 6f 6e 74 65 6e 74 73 2e 0a 2a 2a 20 ta contents..**
27a70 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 64 The journal is d
27a80 65 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 eleted..**.** Th
27a90 69 73 20 72 6f 75 74 69 6e 65 20 63 61 6e 6e 6f is routine canno
27aa0 74 20 66 61 69 6c 20 75 6e 6c 65 73 73 20 73 6f t fail unless so
27ab0 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 65 73 73 me other process
27ac0 20 69 73 20 6e 6f 74 20 66 6f 6c 6c 6f 77 69 6e is not followin
27ad0 67 0a 2a 2a 20 74 68 65 20 63 6f 72 72 65 63 74 g.** the correct
27ae0 20 6c 6f 63 6b 69 6e 67 20 70 72 6f 74 6f 63 6f locking protoco
27af0 6c 20 6f 72 20 75 6e 6c 65 73 73 20 73 6f 6d 65 l or unless some
27b00 20 6f 74 68 65 72 0a 2a 2a 20 70 72 6f 63 65 73 other.** proces
27b10 73 20 69 73 20 77 72 69 74 69 6e 67 20 74 72 61 s is writing tra
27b20 73 68 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 sh into the jour
27b30 6e 61 6c 20 66 69 6c 65 20 28 53 51 4c 49 54 45 nal file (SQLITE
27b40 5f 43 4f 52 52 55 50 54 29 20 6f 72 0a 2a 2a 20 _CORRUPT) or.**
27b50 75 6e 6c 65 73 73 20 61 20 70 72 69 6f 72 20 6d unless a prior m
27b60 61 6c 6c 6f 63 28 29 20 66 61 69 6c 65 64 20 28 alloc() failed (
27b70 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 29 2e 20 20 SQLITE_NOMEM).
27b80 41 70 70 72 6f 70 72 69 61 74 65 20 65 72 72 6f Appropriate erro
27b90 72 0a 2a 2a 20 63 6f 64 65 73 20 61 72 65 20 72 r.** codes are r
27ba0 65 74 75 72 6e 65 64 20 66 6f 72 20 61 6c 6c 20 eturned for all
27bb0 74 68 65 73 65 20 6f 63 63 61 73 69 6f 6e 73 2e these occasions.
27bc0 20 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 Otherwise,.**
27bd0 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 SQLITE_OK is ret
27be0 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 urned..*/.int sq
27bf0 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c 62 61 lite3PagerRollba
27c00 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ck(Pager *pPager
27c10 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 50 ){. int rc;. P
27c20 41 47 45 52 54 52 41 43 45 32 28 22 52 4f 4c 4c AGERTRACE2("ROLL
27c30 42 41 43 4b 20 25 64 5c 6e 22 2c 20 50 41 47 45 BACK %d\n", PAGE
27c40 52 49 44 28 70 50 61 67 65 72 29 29 3b 0a 20 20 RID(pPager));.
27c50 69 66 28 20 4d 45 4d 44 42 20 29 7b 0a 20 20 20 if( MEMDB ){.
27c60 20 50 67 48 64 72 20 2a 70 3b 0a 20 20 20 20 66 PgHdr *p;. f
27c70 6f 72 28 70 3d 70 50 61 67 65 72 2d 3e 70 41 6c or(p=pPager->pAl
27c80 6c 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 l; p; p=p->pNext
27c90 41 6c 6c 29 7b 0a 20 20 20 20 20 20 50 67 48 69 All){. PgHi
27ca0 73 74 6f 72 79 20 2a 70 48 69 73 74 3b 0a 20 20 story *pHist;.
27cb0 20 20 20 20 61 73 73 65 72 74 28 20 21 70 2d 3e assert( !p->
27cc0 61 6c 77 61 79 73 52 6f 6c 6c 62 61 63 6b 20 29 alwaysRollback )
27cd0 3b 0a 20 20 20 20 20 20 69 66 28 20 21 70 2d 3e ;. if( !p->
27ce0 64 69 72 74 79 20 29 7b 0a 20 20 20 20 20 20 20 dirty ){.
27cf0 20 61 73 73 65 72 74 28 20 21 28 28 50 67 48 69 assert( !((PgHi
27d00 73 74 6f 72 79 20 2a 29 50 47 48 44 52 5f 54 4f story *)PGHDR_TO
27d10 5f 48 49 53 54 28 70 2c 20 70 50 61 67 65 72 29 _HIST(p, pPager)
27d20 29 2d 3e 70 4f 72 69 67 20 29 3b 0a 20 20 20 20 )->pOrig );.
27d30 20 20 20 20 61 73 73 65 72 74 28 20 21 28 28 50 assert( !((P
27d40 67 48 69 73 74 6f 72 79 20 2a 29 50 47 48 44 52 gHistory *)PGHDR
27d50 5f 54 4f 5f 48 49 53 54 28 70 2c 20 70 50 61 67 _TO_HIST(p, pPag
27d60 65 72 29 29 2d 3e 70 53 74 6d 74 20 29 3b 0a 20 er))->pStmt );.
27d70 20 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b continue;
27d80 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 . }..
27d90 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 4f pHist = PGHDR_TO
27da0 5f 48 49 53 54 28 70 2c 20 70 50 61 67 65 72 29 _HIST(p, pPager)
27db0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 48 69 73 ;. if( pHis
27dc0 74 2d 3e 70 4f 72 69 67 20 29 7b 0a 20 20 20 20 t->pOrig ){.
27dd0 20 20 20 20 6d 65 6d 63 70 79 28 50 47 48 44 52 memcpy(PGHDR
27de0 5f 54 4f 5f 44 41 54 41 28 70 29 2c 20 70 48 69 _TO_DATA(p), pHi
27df0 73 74 2d 3e 70 4f 72 69 67 2c 20 70 50 61 67 65 st->pOrig, pPage
27e00 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a 20 20 r->pageSize);.
27e10 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45 PAGERTRACE
27e20 33 28 22 52 4f 4c 4c 42 41 43 4b 2d 50 41 47 45 3("ROLLBACK-PAGE
27e30 20 25 64 20 6f 66 20 25 64 5c 6e 22 2c 20 70 2d %d of %d\n", p-
27e40 3e 70 67 6e 6f 2c 20 50 41 47 45 52 49 44 28 70 >pgno, PAGERID(p
27e50 50 61 67 65 72 29 29 3b 0a 20 20 20 20 20 20 7d Pager));. }
27e60 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 50 41 else{. PA
27e70 47 45 52 54 52 41 43 45 33 28 22 50 41 47 45 20 GERTRACE3("PAGE
27e80 25 64 20 69 73 20 63 6c 65 61 6e 20 6f 6e 20 25 %d is clean on %
27e90 64 5c 6e 22 2c 20 70 2d 3e 70 67 6e 6f 2c 20 50 d\n", p->pgno, P
27ea0 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 3b AGERID(pPager));
27eb0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 . }. c
27ec0 6c 65 61 72 48 69 73 74 6f 72 79 28 70 48 69 73 learHistory(pHis
27ed0 74 29 3b 0a 20 20 20 20 20 20 70 2d 3e 64 69 72 t);. p->dir
27ee0 74 79 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d ty = 0;. p-
27ef0 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a >inJournal = 0;.
27f00 20 20 20 20 20 20 70 48 69 73 74 2d 3e 69 6e 53 pHist->inS
27f10 74 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 tmt = 0;. p
27f20 48 69 73 74 2d 3e 70 50 72 65 76 53 74 6d 74 20 Hist->pPrevStmt
27f30 3d 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53 74 = pHist->pNextSt
27f40 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 69 66 mt = 0;. if
27f50 28 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 ( pPager->xReini
27f60 74 65 72 20 29 7b 0a 20 20 20 20 20 20 20 20 70 ter ){. p
27f70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 65 72 Pager->xReiniter
27f80 28 70 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 (p, pPager->page
27f90 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 Size);. }.
27fa0 20 20 20 7d 0a 20 20 20 20 70 50 61 67 65 72 2d }. pPager-
27fb0 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 20 20 >pDirty = 0;.
27fc0 20 70 50 61 67 65 72 2d 3e 70 53 74 6d 74 20 3d pPager->pStmt =
27fd0 20 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 0;. pPager->
27fe0 64 62 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d dbSize = pPager-
27ff0 3e 6f 72 69 67 44 62 53 69 7a 65 3b 0a 20 20 20 >origDbSize;.
28000 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 5f pager_truncate_
28010 63 61 63 68 65 28 70 50 61 67 65 72 29 3b 0a 20 cache(pPager);.
28020 20 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 pPager->stmtI
28030 6e 55 73 65 20 3d 20 30 3b 0a 20 20 20 20 70 50 nUse = 0;. pP
28040 61 67 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 ager->state = PA
28050 47 45 52 5f 53 48 41 52 45 44 3b 0a 20 20 20 20 GER_SHARED;.
28060 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
28070 3b 0a 20 20 7d 0a 0a 20 20 70 61 67 65 72 45 6e ;. }.. pagerEn
28080 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 ter(pPager);. i
28090 66 28 20 21 70 50 61 67 65 72 2d 3e 64 69 72 74 f( !pPager->dirt
280a0 79 43 61 63 68 65 20 7c 7c 20 21 70 50 61 67 65 yCache || !pPage
280b0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 65 6e 20 29 r->journalOpen )
280c0 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 {. rc = pager
280d0 5f 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e _end_transaction
280e0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 70 61 (pPager);. pa
280f0 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 gerLeave(pPager)
28100 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b ;. return rc;
28110 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 50 61 67 . }.. if( pPag
28120 65 72 2d 3e 65 72 72 43 6f 64 65 20 26 26 20 70 er->errCode && p
28130 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 21 3d Pager->errCode!=
28140 53 51 4c 49 54 45 5f 46 55 4c 4c 20 29 7b 0a 20 SQLITE_FULL ){.
28150 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 if( pPager->s
28160 74 61 74 65 3e 3d 50 41 47 45 52 5f 45 58 43 4c tate>=PAGER_EXCL
28170 55 53 49 56 45 20 29 7b 0a 20 20 20 20 20 20 70 USIVE ){. p
28180 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 70 50 ager_playback(pP
28190 61 67 65 72 2c 20 30 29 3b 0a 20 20 20 20 7d 0a ager, 0);. }.
281a0 20 20 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 pagerLeave(p
281b0 50 61 67 65 72 29 3b 0a 20 20 20 20 72 65 74 75 Pager);. retu
281c0 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f rn pPager->errCo
281d0 64 65 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 de;. }. if( pP
281e0 61 67 65 72 2d 3e 73 74 61 74 65 3d 3d 50 41 47 ager->state==PAG
281f0 45 52 5f 52 45 53 45 52 56 45 44 20 29 7b 0a 20 ER_RESERVED ){.
28200 20 20 20 69 6e 74 20 72 63 32 3b 0a 20 20 20 20 int rc2;.
28210 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 rc = pager_playb
28220 61 63 6b 28 70 50 61 67 65 72 2c 20 30 29 3b 0a ack(pPager, 0);.
28230 20 20 20 20 72 63 32 20 3d 20 70 61 67 65 72 5f rc2 = pager_
28240 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 end_transaction(
28250 70 50 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 pPager);. if(
28260 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
28270 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 72 63 32 {. rc = rc2
28280 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b ;. }. }else{
28290 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f . rc = pager_
282a0 70 6c 61 79 62 61 63 6b 28 70 50 61 67 65 72 2c playback(pPager,
282b0 20 30 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 61 0);. }. /* pa
282c0 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 ger_reset(pPager
282d0 29 3b 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d 3e ); */. pPager->
282e0 64 62 53 69 7a 65 20 3d 20 2d 31 3b 0a 0a 20 20 dbSize = -1;..
282f0 2f 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f /* If an error o
28300 63 63 75 72 73 20 64 75 72 69 6e 67 20 61 20 52 ccurs during a R
28310 4f 4c 4c 42 41 43 4b 2c 20 77 65 20 63 61 6e 20 OLLBACK, we can
28320 6e 6f 20 6c 6f 6e 67 65 72 20 74 72 75 73 74 20 no longer trust
28330 74 68 65 20 70 61 67 65 72 0a 20 20 2a 2a 20 63 the pager. ** c
28340 61 63 68 65 2e 20 53 6f 20 63 61 6c 6c 20 70 61 ache. So call pa
28350 67 65 72 5f 65 72 72 6f 72 28 29 20 6f 6e 20 74 ger_error() on t
28360 68 65 20 77 61 79 20 6f 75 74 20 74 6f 20 6d 61 he way out to ma
28370 6b 65 20 61 6e 79 20 65 72 72 6f 72 20 0a 20 20 ke any error .
28380 2a 2a 20 70 65 72 73 69 73 74 65 6e 74 2e 0a 20 ** persistent..
28390 20 2a 2f 0a 20 20 72 63 20 3d 20 70 61 67 65 72 */. rc = pager
283a0 5f 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 _error(pPager, r
283b0 63 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 76 65 c);. pagerLeave
283c0 28 70 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 (pPager);. retu
283d0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
283e0 52 65 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 Return TRUE if t
283f0 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
28400 20 69 73 20 6f 70 65 6e 65 64 20 72 65 61 64 2d is opened read-
28410 6f 6e 6c 79 2e 20 20 52 65 74 75 72 6e 20 46 41 only. Return FA
28420 4c 53 45 0a 2a 2a 20 69 66 20 74 68 65 20 64 61 LSE.** if the da
28430 74 61 62 61 73 65 20 69 73 20 28 69 6e 20 74 68 tabase is (in th
28440 65 6f 72 79 29 20 77 72 69 74 61 62 6c 65 2e 0a eory) writable..
28450 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 */.int sqlite3Pa
28460 67 65 72 49 73 72 65 61 64 6f 6e 6c 79 28 50 61 gerIsreadonly(Pa
28470 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
28480 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 72 return pPager->r
28490 65 61 64 4f 6e 6c 79 3b 0a 7d 0a 0a 2f 2a 0a 2a eadOnly;.}../*.*
284a0 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d * Return the num
284b0 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65 ber of reference
284c0 73 20 74 6f 20 74 68 65 20 70 61 67 65 72 2e 0a s to the pager..
284d0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 */.int sqlite3Pa
284e0 67 65 72 52 65 66 63 6f 75 6e 74 28 50 61 67 65 gerRefcount(Page
284f0 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 r *pPager){. re
28500 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 6e 52 65 turn pPager->nRe
28510 66 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c f;.}..#ifdef SQL
28520 49 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 54 ITE_TEST./*.** T
28530 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 his routine is u
28540 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e 67 20 sed for testing
28550 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f 6e 6c and analysis onl
28560 79 2e 0a 2a 2f 0a 69 6e 74 20 2a 73 71 6c 69 74 y..*/.int *sqlit
28570 65 33 50 61 67 65 72 53 74 61 74 73 28 50 61 67 e3PagerStats(Pag
28580 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 73 er *pPager){. s
28590 74 61 74 69 63 20 69 6e 74 20 61 5b 31 31 5d 3b tatic int a[11];
285a0 0a 20 20 61 5b 30 5d 20 3d 20 70 50 61 67 65 72 . a[0] = pPager
285b0 2d 3e 6e 52 65 66 3b 0a 20 20 61 5b 31 5d 20 3d ->nRef;. a[1] =
285c0 20 70 50 61 67 65 72 2d 3e 6e 50 61 67 65 3b 0a pPager->nPage;.
285d0 20 20 61 5b 32 5d 20 3d 20 70 50 61 67 65 72 2d a[2] = pPager-
285e0 3e 6d 78 50 61 67 65 3b 0a 20 20 61 5b 33 5d 20 >mxPage;. a[3]
285f0 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 = pPager->dbSize
28600 3b 0a 20 20 61 5b 34 5d 20 3d 20 70 50 61 67 65 ;. a[4] = pPage
28610 72 2d 3e 73 74 61 74 65 3b 0a 20 20 61 5b 35 5d r->state;. a[5]
28620 20 3d 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f = pPager->errCo
28630 64 65 3b 0a 20 20 61 5b 36 5d 20 3d 20 70 50 61 de;. a[6] = pPa
28640 67 65 72 2d 3e 6e 48 69 74 3b 0a 20 20 61 5b 37 ger->nHit;. a[7
28650 5d 20 3d 20 70 50 61 67 65 72 2d 3e 6e 4d 69 73 ] = pPager->nMis
28660 73 3b 0a 20 20 61 5b 38 5d 20 3d 20 30 3b 20 20 s;. a[8] = 0;
28670 2f 2a 20 55 73 65 64 20 74 6f 20 62 65 20 70 50 /* Used to be pP
28680 61 67 65 72 2d 3e 6e 4f 76 66 6c 20 2a 2f 0a 20 ager->nOvfl */.
28690 20 61 5b 39 5d 20 3d 20 70 50 61 67 65 72 2d 3e a[9] = pPager->
286a0 6e 52 65 61 64 3b 0a 20 20 61 5b 31 30 5d 20 3d nRead;. a[10] =
286b0 20 70 50 61 67 65 72 2d 3e 6e 57 72 69 74 65 3b pPager->nWrite;
286c0 0a 20 20 72 65 74 75 72 6e 20 61 3b 0a 7d 0a 23 . return a;.}.#
286d0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 endif../*.** Set
286e0 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 72 the statement r
286f0 6f 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 2e 0a 2a ollback point..*
28700 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e *.** This routin
28710 65 20 73 68 6f 75 6c 64 20 62 65 20 63 61 6c 6c e should be call
28720 65 64 20 77 69 74 68 20 74 68 65 20 74 72 61 6e ed with the tran
28730 73 61 63 74 69 6f 6e 20 6a 6f 75 72 6e 61 6c 20 saction journal
28740 61 6c 72 65 61 64 79 0a 2a 2a 20 6f 70 65 6e 2e already.** open.
28750 20 20 41 20 6e 65 77 20 73 74 61 74 65 6d 65 6e A new statemen
28760 74 20 6a 6f 75 72 6e 61 6c 20 69 73 20 63 72 65 t journal is cre
28770 61 74 65 64 20 74 68 61 74 20 63 61 6e 20 62 65 ated that can be
28780 20 75 73 65 64 20 74 6f 20 72 6f 6c 6c 62 61 63 used to rollbac
28790 6b 0a 2a 2a 20 63 68 61 6e 67 65 73 20 6f 66 20 k.** changes of
287a0 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 63 6f 6d a single SQL com
287b0 6d 61 6e 64 20 77 69 74 68 69 6e 20 61 20 6c 61 mand within a la
287c0 72 67 65 72 20 74 72 61 6e 73 61 63 74 69 6f 6e rger transaction
287d0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
287e0 70 61 67 65 72 53 74 6d 74 42 65 67 69 6e 28 50 pagerStmtBegin(P
287f0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
28800 20 69 6e 74 20 72 63 3b 0a 20 20 61 73 73 65 72 int rc;. asser
28810 74 28 20 21 70 50 61 67 65 72 2d 3e 73 74 6d 74 t( !pPager->stmt
28820 49 6e 55 73 65 20 29 3b 0a 20 20 61 73 73 65 72 InUse );. asser
28830 74 28 20 70 50 61 67 65 72 2d 3e 73 74 61 74 65 t( pPager->state
28840 3e 3d 50 41 47 45 52 5f 53 48 41 52 45 44 20 29 >=PAGER_SHARED )
28850 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
28860 65 72 2d 3e 64 62 53 69 7a 65 3e 3d 30 20 29 3b er->dbSize>=0 );
28870 0a 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22 . PAGERTRACE2("
28880 53 54 4d 54 2d 42 45 47 49 4e 20 25 64 5c 6e 22 STMT-BEGIN %d\n"
28890 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 65 72 , PAGERID(pPager
288a0 29 29 3b 0a 20 20 69 66 28 20 4d 45 4d 44 42 20 ));. if( MEMDB
288b0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 ){. pPager->s
288c0 74 6d 74 49 6e 55 73 65 20 3d 20 31 3b 0a 20 20 tmtInUse = 1;.
288d0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 69 pPager->stmtSi
288e0 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 ze = pPager->dbS
288f0 69 7a 65 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 ize;. return
28900 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 SQLITE_OK;. }.
28910 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 6a 6f if( !pPager->jo
28920 75 72 6e 61 6c 4f 70 65 6e 20 29 7b 0a 20 20 20 urnalOpen ){.
28930 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 pPager->stmtAut
28940 6f 6f 70 65 6e 20 3d 20 31 3b 0a 20 20 20 20 72 oopen = 1;. r
28950 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
28960 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 . }. assert( p
28970 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 70 Pager->journalOp
28980 65 6e 20 29 3b 0a 20 20 70 61 67 65 72 4c 65 61 en );. pagerLea
28990 76 65 28 70 50 61 67 65 72 29 3b 0a 20 20 61 73 ve(pPager);. as
289a0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 sert( pPager->pI
289b0 6e 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 70 50 nStmt==0 );. pP
289c0 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20 ager->pInStmt =
289d0 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 72 65 sqlite3BitvecCre
289e0 61 74 65 28 70 50 61 67 65 72 2d 3e 64 62 53 69 ate(pPager->dbSi
289f0 7a 65 29 3b 0a 20 20 70 61 67 65 72 45 6e 74 65 ze);. pagerEnte
28a00 72 28 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 r(pPager);. if(
28a10 20 70 50 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 pPager->pInStmt
28a20 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 73 71 ==0 ){. /* sq
28a30 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 70 50 61 67 lite3OsLock(pPag
28a40 65 72 2d 3e 66 64 2c 20 53 48 41 52 45 44 5f 4c er->fd, SHARED_L
28a50 4f 43 4b 29 3b 20 2a 2f 0a 20 20 20 20 72 65 74 OCK); */. ret
28a60 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d urn SQLITE_NOMEM
28a70 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 3e ;. }. pPager->
28a80 73 74 6d 74 4a 53 69 7a 65 20 3d 20 70 50 61 67 stmtJSize = pPag
28a90 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a er->journalOff;.
28aa0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 69 pPager->stmtSi
28ab0 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 62 53 ze = pPager->dbS
28ac0 69 7a 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e 73 ize;. pPager->s
28ad0 74 6d 74 48 64 72 4f 66 66 20 3d 20 30 3b 0a 20 tmtHdrOff = 0;.
28ae0 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 43 6b 73 pPager->stmtCks
28af0 75 6d 20 3d 20 70 50 61 67 65 72 2d 3e 63 6b 73 um = pPager->cks
28b00 75 6d 49 6e 69 74 3b 0a 20 20 69 66 28 20 21 70 umInit;. if( !p
28b10 50 61 67 65 72 2d 3e 73 74 6d 74 4f 70 65 6e 20 Pager->stmtOpen
28b20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
28b30 74 65 33 50 61 67 65 72 4f 70 65 6e 74 65 6d 70 te3PagerOpentemp
28b40 28 70 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 70 (pPager->pVfs, p
28b50 50 61 67 65 72 2d 3e 73 74 66 64 2c 20 70 50 61 Pager->stfd, pPa
28b60 67 65 72 2d 3e 7a 53 74 6d 74 4a 72 6e 6c 2c 0a ger->zStmtJrnl,.
28b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28b80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
28b90 4c 49 54 45 5f 4f 50 45 4e 5f 53 55 42 4a 4f 55 LITE_OPEN_SUBJOU
28ba0 52 4e 41 4c 29 3b 0a 20 20 20 20 69 66 28 20 72 RNAL);. if( r
28bb0 63 20 29 7b 0a 20 20 20 20 20 20 67 6f 74 6f 20 c ){. goto
28bc0 73 74 6d 74 5f 62 65 67 69 6e 5f 66 61 69 6c 65 stmt_begin_faile
28bd0 64 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61 d;. }. pPa
28be0 67 65 72 2d 3e 73 74 6d 74 4f 70 65 6e 20 3d 20 ger->stmtOpen =
28bf0 31 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 1;. pPager->s
28c00 74 6d 74 4e 52 65 63 20 3d 20 30 3b 0a 20 20 7d tmtNRec = 0;. }
28c10 0a 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 . pPager->stmtI
28c20 6e 55 73 65 20 3d 20 31 3b 0a 20 20 72 65 74 75 nUse = 1;. retu
28c30 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 0a rn SQLITE_OK;. .
28c40 73 74 6d 74 5f 62 65 67 69 6e 5f 66 61 69 6c 65 stmt_begin_faile
28c50 64 3a 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d d:. if( pPager-
28c60 3e 70 49 6e 53 74 6d 74 20 29 7b 0a 20 20 20 20 >pInStmt ){.
28c70 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 sqlite3BitvecDes
28c80 74 72 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 6e troy(pPager->pIn
28c90 53 74 6d 74 29 3b 0a 20 20 20 20 70 50 61 67 65 Stmt);. pPage
28ca0 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20 30 3b 0a r->pInStmt = 0;.
28cb0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
28cc0 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 .}.int sqlite3Pa
28cd0 67 65 72 53 74 6d 74 42 65 67 69 6e 28 50 61 67 gerStmtBegin(Pag
28ce0 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 er *pPager){. i
28cf0 6e 74 20 72 63 3b 0a 20 20 70 61 67 65 72 45 6e nt rc;. pagerEn
28d00 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 20 72 ter(pPager);. r
28d10 63 20 3d 20 70 61 67 65 72 53 74 6d 74 42 65 67 c = pagerStmtBeg
28d20 69 6e 28 70 50 61 67 65 72 29 3b 0a 20 20 70 61 in(pPager);. pa
28d30 67 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 gerLeave(pPager)
28d40 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
28d50 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 6d 69 74 20 61 ../*.** Commit a
28d60 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 69 statement..*/.i
28d70 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 nt sqlite3PagerS
28d80 74 6d 74 43 6f 6d 6d 69 74 28 50 61 67 65 72 20 tmtCommit(Pager
28d90 2a 70 50 61 67 65 72 29 7b 0a 20 20 70 61 67 65 *pPager){. page
28da0 72 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a rEnter(pPager);.
28db0 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 73 74 if( pPager->st
28dc0 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20 20 20 50 mtInUse ){. P
28dd0 67 48 64 72 20 2a 70 50 67 2c 20 2a 70 4e 65 78 gHdr *pPg, *pNex
28de0 74 3b 0a 20 20 20 20 50 41 47 45 52 54 52 41 43 t;. PAGERTRAC
28df0 45 32 28 22 53 54 4d 54 2d 43 4f 4d 4d 49 54 20 E2("STMT-COMMIT
28e00 25 64 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 %d\n", PAGERID(p
28e10 50 61 67 65 72 29 29 3b 0a 20 20 20 20 69 66 28 Pager));. if(
28e20 20 21 4d 45 4d 44 42 20 29 7b 0a 20 20 20 20 20 !MEMDB ){.
28e30 20 2f 2a 20 73 71 6c 69 74 65 33 4f 73 54 72 75 /* sqlite3OsTru
28e40 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 73 74 ncate(pPager->st
28e50 66 64 2c 20 30 29 3b 20 2a 2f 0a 20 20 20 20 20 fd, 0); */.
28e60 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 44 65 sqlite3BitvecDe
28e70 73 74 72 6f 79 28 70 50 61 67 65 72 2d 3e 70 49 stroy(pPager->pI
28e80 6e 53 74 6d 74 29 3b 0a 20 20 20 20 20 20 70 50 nStmt);. pP
28e90 61 67 65 72 2d 3e 70 49 6e 53 74 6d 74 20 3d 20 ager->pInStmt =
28ea0 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 0;. }else{.
28eb0 20 20 20 20 66 6f 72 28 70 50 67 3d 70 50 61 67 for(pPg=pPag
28ec0 65 72 2d 3e 70 53 74 6d 74 3b 20 70 50 67 3b 20 er->pStmt; pPg;
28ed0 70 50 67 3d 70 4e 65 78 74 29 7b 0a 20 20 20 20 pPg=pNext){.
28ee0 20 20 20 20 50 67 48 69 73 74 6f 72 79 20 2a 70 PgHistory *p
28ef0 48 69 73 74 20 3d 20 50 47 48 44 52 5f 54 4f 5f Hist = PGHDR_TO_
28f00 48 49 53 54 28 70 50 67 2c 20 70 50 61 67 65 72 HIST(pPg, pPager
28f10 29 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 78 74 );. pNext
28f20 20 3d 20 70 48 69 73 74 2d 3e 70 4e 65 78 74 53 = pHist->pNextS
28f30 74 6d 74 3b 0a 20 20 20 20 20 20 20 20 61 73 73 tmt;. ass
28f40 65 72 74 28 20 70 48 69 73 74 2d 3e 69 6e 53 74 ert( pHist->inSt
28f50 6d 74 20 29 3b 0a 20 20 20 20 20 20 20 20 70 48 mt );. pH
28f60 69 73 74 2d 3e 69 6e 53 74 6d 74 20 3d 20 30 3b ist->inStmt = 0;
28f70 0a 20 20 20 20 20 20 20 20 70 48 69 73 74 2d 3e . pHist->
28f80 70 50 72 65 76 53 74 6d 74 20 3d 20 70 48 69 73 pPrevStmt = pHis
28f90 74 2d 3e 70 4e 65 78 74 53 74 6d 74 20 3d 20 30 t->pNextStmt = 0
28fa0 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 ;. sqlite
28fb0 33 5f 66 72 65 65 28 70 48 69 73 74 2d 3e 70 53 3_free(pHist->pS
28fc0 74 6d 74 29 3b 0a 20 20 20 20 20 20 20 20 70 48 tmt);. pH
28fd0 69 73 74 2d 3e 70 53 74 6d 74 20 3d 20 30 3b 0a ist->pStmt = 0;.
28fe0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
28ff0 20 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 4e 52 pPager->stmtNR
29000 65 63 20 3d 20 30 3b 0a 20 20 20 20 70 50 61 67 ec = 0;. pPag
29010 65 72 2d 3e 73 74 6d 74 49 6e 55 73 65 20 3d 20 er->stmtInUse =
29020 30 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 0;. pPager->p
29030 53 74 6d 74 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Stmt = 0;. }.
29040 70 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f pPager->stmtAuto
29050 6f 70 65 6e 20 3d 20 30 3b 0a 20 20 70 61 67 65 open = 0;. page
29060 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a rLeave(pPager);.
29070 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
29080 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 6f 6c OK;.}../*.** Rol
29090 6c 62 61 63 6b 20 61 20 73 74 61 74 65 6d 65 6e lback a statemen
290a0 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
290b0 33 50 61 67 65 72 53 74 6d 74 52 6f 6c 6c 62 61 3PagerStmtRollba
290c0 63 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ck(Pager *pPager
290d0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 70 ){. int rc;. p
290e0 61 67 65 72 45 6e 74 65 72 28 70 50 61 67 65 72 agerEnter(pPager
290f0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
29100 3e 73 74 6d 74 49 6e 55 73 65 20 29 7b 0a 20 20 >stmtInUse ){.
29110 20 20 50 41 47 45 52 54 52 41 43 45 32 28 22 53 PAGERTRACE2("S
29120 54 4d 54 2d 52 4f 4c 4c 42 41 43 4b 20 25 64 5c TMT-ROLLBACK %d\
29130 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 67 n", PAGERID(pPag
29140 65 72 29 29 3b 0a 20 20 20 20 69 66 28 20 4d 45 er));. if( ME
29150 4d 44 42 20 29 7b 0a 20 20 20 20 20 20 50 67 48 MDB ){. PgH
29160 64 72 20 2a 70 50 67 3b 0a 20 20 20 20 20 20 50 dr *pPg;. P
29170 67 48 69 73 74 6f 72 79 20 2a 70 48 69 73 74 3b gHistory *pHist;
29180 0a 20 20 20 20 20 20 66 6f 72 28 70 50 67 3d 70 . for(pPg=p
29190 50 61 67 65 72 2d 3e 70 53 74 6d 74 3b 20 70 50 Pager->pStmt; pP
291a0 67 3b 20 70 50 67 3d 70 48 69 73 74 2d 3e 70 4e g; pPg=pHist->pN
291b0 65 78 74 53 74 6d 74 29 7b 0a 20 20 20 20 20 20 extStmt){.
291c0 20 20 70 48 69 73 74 20 3d 20 50 47 48 44 52 5f pHist = PGHDR_
291d0 54 4f 5f 48 49 53 54 28 70 50 67 2c 20 70 50 61 TO_HIST(pPg, pPa
291e0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66 ger);. if
291f0 28 20 70 48 69 73 74 2d 3e 70 53 74 6d 74 20 29 ( pHist->pStmt )
29200 7b 0a 20 20 20 20 20 20 20 20 20 20 6d 65 6d 63 {. memc
29210 70 79 28 50 47 48 44 52 5f 54 4f 5f 44 41 54 41 py(PGHDR_TO_DATA
29220 28 70 50 67 29 2c 20 70 48 69 73 74 2d 3e 70 53 (pPg), pHist->pS
29230 74 6d 74 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 tmt, pPager->pag
29240 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 20 20 eSize);.
29250 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
29260 48 69 73 74 2d 3e 70 53 74 6d 74 29 3b 0a 20 20 Hist->pStmt);.
29270 20 20 20 20 20 20 20 20 70 48 69 73 74 2d 3e 70 pHist->p
29280 53 74 6d 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 Stmt = 0;.
29290 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
292a0 20 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 pPager->dbSize
292b0 20 3d 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 53 = pPager->stmtS
292c0 69 7a 65 3b 0a 20 20 20 20 20 20 70 61 67 65 72 ize;. pager
292d0 5f 74 72 75 6e 63 61 74 65 5f 63 61 63 68 65 28 _truncate_cache(
292e0 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 72 pPager);. r
292f0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
29300 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
29310 72 63 20 3d 20 70 61 67 65 72 5f 73 74 6d 74 5f rc = pager_stmt_
29320 70 6c 61 79 62 61 63 6b 28 70 50 61 67 65 72 29 playback(pPager)
29330 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 ;. }. sqli
29340 74 65 33 50 61 67 65 72 53 74 6d 74 43 6f 6d 6d te3PagerStmtComm
29350 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 65 it(pPager);. }e
29360 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 lse{. rc = SQ
29370 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 70 LITE_OK;. }. p
29380 50 61 67 65 72 2d 3e 73 74 6d 74 41 75 74 6f 6f Pager->stmtAutoo
29390 70 65 6e 20 3d 20 30 3b 0a 20 20 70 61 67 65 72 pen = 0;. pager
293a0 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b 0a 20 Leave(pPager);.
293b0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
293c0 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
293d0 66 75 6c 6c 20 70 61 74 68 6e 61 6d 65 20 6f 66 full pathname of
293e0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
293f0 6c 65 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 le..*/.const cha
29400 72 20 2a 73 71 6c 69 74 65 33 50 61 67 65 72 46 r *sqlite3PagerF
29410 69 6c 65 6e 61 6d 65 28 50 61 67 65 72 20 2a 70 ilename(Pager *p
29420 50 61 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e Pager){. return
29430 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 pPager->zFilena
29440 6d 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 me;.}../*.** Ret
29450 75 72 6e 20 74 68 65 20 56 46 53 20 73 74 72 75 urn the VFS stru
29460 63 74 75 72 65 20 66 6f 72 20 74 68 65 20 70 61 cture for the pa
29470 67 65 72 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 73 71 ger..*/.const sq
29480 6c 69 74 65 33 5f 76 66 73 20 2a 73 71 6c 69 74 lite3_vfs *sqlit
29490 65 33 50 61 67 65 72 56 66 73 28 50 61 67 65 72 e3PagerVfs(Pager
294a0 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 74 *pPager){. ret
294b0 75 72 6e 20 70 50 61 67 65 72 2d 3e 70 56 66 73 urn pPager->pVfs
294c0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
294d0 6e 20 74 68 65 20 66 69 6c 65 20 68 61 6e 64 6c n the file handl
294e0 65 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 e for the databa
294f0 73 65 20 66 69 6c 65 20 61 73 73 6f 63 69 61 74 se file associat
29500 65 64 0a 2a 2a 20 77 69 74 68 20 74 68 65 20 70 ed.** with the p
29510 61 67 65 72 2e 20 20 54 68 69 73 20 6d 69 67 68 ager. This migh
29520 74 20 72 65 74 75 72 6e 20 4e 55 4c 4c 20 69 66 t return NULL if
29530 20 74 68 65 20 66 69 6c 65 20 68 61 73 0a 2a 2a the file has.**
29540 20 6e 6f 74 20 79 65 74 20 62 65 65 6e 20 6f 70 not yet been op
29550 65 6e 65 64 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 ened..*/.sqlite3
29560 5f 66 69 6c 65 20 2a 73 71 6c 69 74 65 33 50 61 _file *sqlite3Pa
29570 67 65 72 46 69 6c 65 28 50 61 67 65 72 20 2a 70 gerFile(Pager *p
29580 50 61 67 65 72 29 7b 0a 20 20 72 65 74 75 72 6e Pager){. return
29590 20 70 50 61 67 65 72 2d 3e 66 64 3b 0a 7d 0a 0a pPager->fd;.}..
295a0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
295b0 20 64 69 72 65 63 74 6f 72 79 20 6f 66 20 74 68 directory of th
295c0 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
295d0 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a .*/.const char *
295e0 73 71 6c 69 74 65 33 50 61 67 65 72 44 69 72 6e sqlite3PagerDirn
295f0 61 6d 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 ame(Pager *pPage
29600 72 29 7b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 r){. return pPa
29610 67 65 72 2d 3e 7a 44 69 72 65 63 74 6f 72 79 3b ger->zDirectory;
29620 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e .}../*.** Return
29630 20 74 68 65 20 66 75 6c 6c 20 70 61 74 68 6e 61 the full pathna
29640 6d 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 me of the journa
29650 6c 20 66 69 6c 65 2e 0a 2a 2f 0a 63 6f 6e 73 74 l file..*/.const
29660 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 50 61 char *sqlite3Pa
29670 67 65 72 4a 6f 75 72 6e 61 6c 6e 61 6d 65 28 50 gerJournalname(P
29680 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
29690 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e return pPager->
296a0 7a 4a 6f 75 72 6e 61 6c 3b 0a 7d 0a 0a 2f 2a 0a zJournal;.}../*.
296b0 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 ** Return true i
296c0 66 20 66 73 79 6e 63 28 29 20 63 61 6c 6c 73 20 f fsync() calls
296d0 61 72 65 20 64 69 73 61 62 6c 65 64 20 66 6f 72 are disabled for
296e0 20 74 68 69 73 20 70 61 67 65 72 2e 20 20 52 65 this pager. Re
296f0 74 75 72 6e 20 46 41 4c 53 45 0a 2a 2a 20 69 66 turn FALSE.** if
29700 20 66 73 79 6e 63 28 29 73 20 61 72 65 20 65 78 fsync()s are ex
29710 65 63 75 74 65 64 20 6e 6f 72 6d 61 6c 6c 79 2e ecuted normally.
29720 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 .*/.int sqlite3P
29730 61 67 65 72 4e 6f 73 79 6e 63 28 50 61 67 65 72 agerNosync(Pager
29740 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 74 *pPager){. ret
29750 75 72 6e 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 urn pPager->noSy
29760 6e 63 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 nc;.}..#ifdef SQ
29770 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 2f LITE_HAS_CODEC./
29780 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 63 6f 64 *.** Set the cod
29790 65 63 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 ec for this page
297a0 72 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 r.*/.void sqlite
297b0 33 50 61 67 65 72 53 65 74 43 6f 64 65 63 28 0a 3PagerSetCodec(.
297c0 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c Pager *pPager,
297d0 0a 20 20 76 6f 69 64 20 2a 28 2a 78 43 6f 64 65 . void *(*xCode
297e0 63 29 28 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c 50 c)(void*,void*,P
297f0 67 6e 6f 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 64 gno,int),. void
29800 20 2a 70 43 6f 64 65 63 41 72 67 0a 29 7b 0a 20 *pCodecArg.){.
29810 20 70 50 61 67 65 72 2d 3e 78 43 6f 64 65 63 20 pPager->xCodec
29820 3d 20 78 43 6f 64 65 63 3b 0a 20 20 70 50 61 67 = xCodec;. pPag
29830 65 72 2d 3e 70 43 6f 64 65 63 41 72 67 20 3d 20 er->pCodecArg =
29840 70 43 6f 64 65 63 41 72 67 3b 0a 7d 0a 23 65 6e pCodecArg;.}.#en
29850 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c dif..#ifndef SQL
29860 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 56 41 43 ITE_OMIT_AUTOVAC
29870 55 55 4d 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 UUM./*.** Move t
29880 68 65 20 70 61 67 65 20 70 50 67 20 74 6f 20 6c he page pPg to l
29890 6f 63 61 74 69 6f 6e 20 70 67 6e 6f 20 69 6e 20 ocation pgno in
298a0 74 68 65 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 the file..**.**
298b0 54 68 65 72 65 20 6d 75 73 74 20 62 65 20 6e 6f There must be no
298c0 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 references to t
298d0 68 65 20 70 61 67 65 20 70 72 65 76 69 6f 75 73 he page previous
298e0 6c 79 20 6c 6f 63 61 74 65 64 20 61 74 0a 2a 2a ly located at.**
298f0 20 70 67 6e 6f 20 28 77 68 69 63 68 20 77 65 20 pgno (which we
29900 63 61 6c 6c 20 70 50 67 4f 6c 64 29 20 74 68 6f call pPgOld) tho
29910 75 67 68 20 74 68 61 74 20 70 61 67 65 20 69 73 ugh that page is
29920 20 61 6c 6c 6f 77 65 64 20 74 6f 20 62 65 0a 2a allowed to be.*
29930 2a 20 69 6e 20 63 61 63 68 65 2e 20 20 49 66 20 * in cache. If
29940 74 68 65 20 70 61 67 65 20 70 72 65 76 69 6f 75 the page previou
29950 73 20 6c 6f 63 61 74 65 64 20 61 74 20 70 67 6e s located at pgn
29960 6f 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 o is not already
29970 0a 2a 2a 20 69 6e 20 74 68 65 20 72 6f 6c 6c 62 .** in the rollb
29980 61 63 6b 20 6a 6f 75 72 6e 61 6c 2c 20 69 74 20 ack journal, it
29990 69 73 20 6e 6f 74 20 70 75 74 20 74 68 65 72 65 is not put there
299a0 20 62 79 20 62 79 20 74 68 69 73 20 72 6f 75 74 by by this rout
299b0 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 66 65 72 ine..**.** Refer
299c0 65 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61 67 ences to the pag
299d0 65 20 70 50 67 20 72 65 6d 61 69 6e 20 76 61 6c e pPg remain val
299e0 69 64 2e 20 55 70 64 61 74 69 6e 67 20 61 6e 79 id. Updating any
299f0 0a 2a 2a 20 6d 65 74 61 2d 64 61 74 61 20 61 73 .** meta-data as
29a00 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 50 sociated with pP
29a10 67 20 28 69 2e 65 2e 20 64 61 74 61 20 73 74 6f g (i.e. data sto
29a20 72 65 64 20 69 6e 20 74 68 65 20 6e 45 78 74 72 red in the nExtr
29a30 61 20 62 79 74 65 73 0a 2a 2a 20 61 6c 6c 6f 63 a bytes.** alloc
29a40 61 74 65 64 20 61 6c 6f 6e 67 20 77 69 74 68 20 ated along with
29a50 74 68 65 20 70 61 67 65 29 20 69 73 20 74 68 65 the page) is the
29a60 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 responsibility
29a70 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 2a of the caller..*
29a80 2a 0a 2a 2a 20 41 20 74 72 61 6e 73 61 63 74 69 *.** A transacti
29a90 6f 6e 20 6d 75 73 74 20 62 65 20 61 63 74 69 76 on must be activ
29aa0 65 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 e when this rout
29ab0 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 49 ine is called. I
29ac0 74 20 75 73 65 64 20 74 6f 20 62 65 0a 2a 2a 20 t used to be.**
29ad0 72 65 71 75 69 72 65 64 20 74 68 61 74 20 61 20 required that a
29ae0 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 statement transa
29af0 63 74 69 6f 6e 20 77 61 73 20 6e 6f 74 20 61 63 ction was not ac
29b00 74 69 76 65 2c 20 62 75 74 20 74 68 69 73 20 72 tive, but this r
29b10 65 73 74 72 69 63 74 69 6f 6e 0a 2a 2a 20 68 61 estriction.** ha
29b20 73 20 62 65 65 6e 20 72 65 6d 6f 76 65 64 20 28 s been removed (
29b30 43 52 45 41 54 45 20 49 4e 44 45 58 20 6e 65 65 CREATE INDEX nee
29b40 64 73 20 74 6f 20 6d 6f 76 65 20 61 20 70 61 67 ds to move a pag
29b50 65 20 77 68 65 6e 20 61 20 73 74 61 74 65 6d 65 e when a stateme
29b60 6e 74 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f nt.** transactio
29b70 6e 20 69 73 20 61 63 74 69 76 65 29 2e 0a 2a 2f n is active)..*/
29b80 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 .int sqlite3Page
29b90 72 4d 6f 76 65 70 61 67 65 28 50 61 67 65 72 20 rMovepage(Pager
29ba0 2a 70 50 61 67 65 72 2c 20 44 62 50 61 67 65 20 *pPager, DbPage
29bb0 2a 70 50 67 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 *pPg, Pgno pgno)
29bc0 7b 0a 20 20 50 67 48 64 72 20 2a 70 50 67 4f 6c {. PgHdr *pPgOl
29bd0 64 3b 20 20 2f 2a 20 54 68 65 20 70 61 67 65 20 d; /* The page
29be0 62 65 69 6e 67 20 6f 76 65 72 77 72 69 74 74 65 being overwritte
29bf0 6e 2e 20 2a 2f 0a 20 20 69 6e 74 20 68 3b 0a 20 n. */. int h;.
29c00 20 50 67 6e 6f 20 6e 65 65 64 53 79 6e 63 50 67 Pgno needSyncPg
29c10 6e 6f 20 3d 20 30 3b 0a 0a 20 20 70 61 67 65 72 no = 0;.. pager
29c20 45 6e 74 65 72 28 70 50 61 67 65 72 29 3b 0a 20 Enter(pPager);.
29c30 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 6e 52 assert( pPg->nR
29c40 65 66 3e 30 20 29 3b 0a 0a 20 20 50 41 47 45 52 ef>0 );.. PAGER
29c50 54 52 41 43 45 35 28 22 4d 4f 56 45 20 25 64 20 TRACE5("MOVE %d
29c60 70 61 67 65 20 25 64 20 28 6e 65 65 64 53 79 6e page %d (needSyn
29c70 63 3d 25 64 29 20 6d 6f 76 65 73 20 74 6f 20 25 c=%d) moves to %
29c80 64 5c 6e 22 2c 20 0a 20 20 20 20 20 20 50 41 47 d\n", . PAG
29c90 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50 ERID(pPager), pP
29ca0 67 2d 3e 70 67 6e 6f 2c 20 70 50 67 2d 3e 6e 65 g->pgno, pPg->ne
29cb0 65 64 53 79 6e 63 2c 20 70 67 6e 6f 29 3b 0a 20 edSync, pgno);.
29cc0 20 49 4f 54 52 41 43 45 28 28 22 4d 4f 56 45 20 IOTRACE(("MOVE
29cd0 25 70 20 25 64 20 25 64 5c 6e 22 2c 20 70 50 61 %p %d %d\n", pPa
29ce0 67 65 72 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 ger, pPg->pgno,
29cf0 70 67 6e 6f 29 29 0a 0a 20 20 70 61 67 65 72 5f pgno)).. pager_
29d00 67 65 74 5f 63 6f 6e 74 65 6e 74 28 70 50 67 29 get_content(pPg)
29d10 3b 0a 20 20 69 66 28 20 70 50 67 2d 3e 6e 65 65 ;. if( pPg->nee
29d20 64 53 79 6e 63 20 29 7b 0a 20 20 20 20 6e 65 65 dSync ){. nee
29d30 64 53 79 6e 63 50 67 6e 6f 20 3d 20 70 50 67 2d dSyncPgno = pPg-
29d40 3e 70 67 6e 6f 3b 0a 20 20 20 20 61 73 73 65 72 >pgno;. asser
29d50 74 28 20 70 50 67 2d 3e 69 6e 4a 6f 75 72 6e 61 t( pPg->inJourna
29d60 6c 20 7c 7c 20 28 69 6e 74 29 70 67 6e 6f 3e 70 l || (int)pgno>p
29d70 50 61 67 65 72 2d 3e 6f 72 69 67 44 62 53 69 7a Pager->origDbSiz
29d80 65 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 e );. assert(
29d90 20 70 50 67 2d 3e 64 69 72 74 79 20 29 3b 0a 20 pPg->dirty );.
29da0 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 assert( pPage
29db0 72 2d 3e 6e 65 65 64 53 79 6e 63 20 29 3b 0a 20 r->needSync );.
29dc0 20 7d 0a 0a 20 20 2f 2a 20 55 6e 6c 69 6e 6b 20 }.. /* Unlink
29dd0 70 50 67 20 66 72 6f 6d 20 69 74 73 20 68 61 73 pPg from its has
29de0 68 2d 63 68 61 69 6e 20 2a 2f 0a 20 20 75 6e 6c h-chain */. unl
29df0 69 6e 6b 48 61 73 68 43 68 61 69 6e 28 70 50 61 inkHashChain(pPa
29e00 67 65 72 2c 20 70 50 67 29 3b 0a 0a 20 20 2f 2a ger, pPg);.. /*
29e10 20 49 66 20 74 68 65 20 63 61 63 68 65 20 63 6f If the cache co
29e20 6e 74 61 69 6e 73 20 61 20 70 61 67 65 20 77 69 ntains a page wi
29e30 74 68 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 70 th page-number p
29e40 67 6e 6f 2c 20 72 65 6d 6f 76 65 20 69 74 0a 20 gno, remove it.
29e50 20 2a 2a 20 66 72 6f 6d 20 69 74 73 20 68 61 73 ** from its has
29e60 68 20 63 68 61 69 6e 2e 20 41 6c 73 6f 2c 20 69 h chain. Also, i
29e70 66 20 74 68 65 20 50 67 48 64 72 2e 6e 65 65 64 f the PgHdr.need
29e80 53 79 6e 63 20 77 61 73 20 73 65 74 20 66 6f 72 Sync was set for
29e90 20 0a 20 20 2a 2a 20 70 61 67 65 20 70 67 6e 6f . ** page pgno
29ea0 20 62 65 66 6f 72 65 20 74 68 65 20 27 6d 6f 76 before the 'mov
29eb0 65 27 20 6f 70 65 72 61 74 69 6f 6e 2c 20 69 74 e' operation, it
29ec0 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 65 74 needs to be ret
29ed0 61 69 6e 65 64 20 0a 20 20 2a 2a 20 66 6f 72 20 ained . ** for
29ee0 74 68 65 20 70 61 67 65 20 6d 6f 76 65 64 20 74 the page moved t
29ef0 68 65 72 65 2e 0a 20 20 2a 2f 0a 20 20 70 50 67 here.. */. pPg
29f00 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a ->needSync = 0;.
29f10 20 20 70 50 67 4f 6c 64 20 3d 20 70 61 67 65 72 pPgOld = pager
29f20 5f 6c 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 _lookup(pPager,
29f30 70 67 6e 6f 29 3b 0a 20 20 69 66 28 20 70 50 67 pgno);. if( pPg
29f40 4f 6c 64 20 29 7b 0a 20 20 20 20 61 73 73 65 72 Old ){. asser
29f50 74 28 20 70 50 67 4f 6c 64 2d 3e 6e 52 65 66 3d t( pPgOld->nRef=
29f60 3d 30 20 29 3b 0a 20 20 20 20 75 6e 6c 69 6e 6b =0 );. unlink
29f70 48 61 73 68 43 68 61 69 6e 28 70 50 61 67 65 72 HashChain(pPager
29f80 2c 20 70 50 67 4f 6c 64 29 3b 0a 20 20 20 20 6d , pPgOld);. m
29f90 61 6b 65 43 6c 65 61 6e 28 70 50 67 4f 6c 64 29 akeClean(pPgOld)
29fa0 3b 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 ;. pPg->needS
29fb0 79 6e 63 20 3d 20 70 50 67 4f 6c 64 2d 3e 6e 65 ync = pPgOld->ne
29fc0 65 64 53 79 6e 63 3b 0a 20 20 7d 65 6c 73 65 7b edSync;. }else{
29fd0 0a 20 20 20 20 70 50 67 2d 3e 6e 65 65 64 53 79 . pPg->needSy
29fe0 6e 63 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 70 50 nc = 0;. }. pP
29ff0 67 2d 3e 69 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73 g->inJournal = s
2a000 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74 qlite3BitvecTest
2a010 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 (pPager->pInJour
2a020 6e 61 6c 2c 20 70 67 6e 6f 29 3b 0a 0a 20 20 2f nal, pgno);.. /
2a030 2a 20 43 68 61 6e 67 65 20 74 68 65 20 70 61 67 * Change the pag
2a040 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 70 50 67 e number for pPg
2a050 20 61 6e 64 20 69 6e 73 65 72 74 20 69 74 20 69 and insert it i
2a060 6e 74 6f 20 74 68 65 20 6e 65 77 20 68 61 73 68 nto the new hash
2a070 2d 63 68 61 69 6e 2e 20 2a 2f 0a 20 20 61 73 73 -chain. */. ass
2a080 65 72 74 28 20 70 67 6e 6f 21 3d 30 20 29 3b 0a ert( pgno!=0 );.
2a090 20 20 70 50 67 2d 3e 70 67 6e 6f 20 3d 20 70 67 pPg->pgno = pg
2a0a0 6e 6f 3b 0a 20 20 68 20 3d 20 70 67 6e 6f 20 26 no;. h = pgno &
2a0b0 20 28 70 50 61 67 65 72 2d 3e 6e 48 61 73 68 2d (pPager->nHash-
2a0c0 31 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 1);. if( pPager
2a0d0 2d 3e 61 48 61 73 68 5b 68 5d 20 29 7b 0a 20 20 ->aHash[h] ){.
2a0e0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
2a0f0 2d 3e 61 48 61 73 68 5b 68 5d 2d 3e 70 50 72 65 ->aHash[h]->pPre
2a100 76 48 61 73 68 3d 3d 30 20 29 3b 0a 20 20 20 20 vHash==0 );.
2a110 70 50 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d pPager->aHash[h]
2a120 2d 3e 70 50 72 65 76 48 61 73 68 20 3d 20 70 50 ->pPrevHash = pP
2a130 67 3b 0a 20 20 7d 0a 20 20 70 50 67 2d 3e 70 4e g;. }. pPg->pN
2a140 65 78 74 48 61 73 68 20 3d 20 70 50 61 67 65 72 extHash = pPager
2a150 2d 3e 61 48 61 73 68 5b 68 5d 3b 0a 20 20 70 50 ->aHash[h];. pP
2a160 61 67 65 72 2d 3e 61 48 61 73 68 5b 68 5d 20 3d ager->aHash[h] =
2a170 20 70 50 67 3b 0a 20 20 70 50 67 2d 3e 70 50 72 pPg;. pPg->pPr
2a180 65 76 48 61 73 68 20 3d 20 30 3b 0a 0a 20 20 6d evHash = 0;.. m
2a190 61 6b 65 44 69 72 74 79 28 70 50 67 29 3b 0a 20 akeDirty(pPg);.
2a1a0 20 70 50 61 67 65 72 2d 3e 64 69 72 74 79 43 61 pPager->dirtyCa
2a1b0 63 68 65 20 3d 20 31 3b 0a 0a 20 20 69 66 28 20 che = 1;.. if(
2a1c0 6e 65 65 64 53 79 6e 63 50 67 6e 6f 20 29 7b 0a needSyncPgno ){.
2a1d0 20 20 20 20 2f 2a 20 49 66 20 6e 65 65 64 53 79 /* If needSy
2a1e0 6e 63 50 67 6e 6f 20 69 73 20 6e 6f 6e 2d 7a 65 ncPgno is non-ze
2a1f0 72 6f 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 ro, then the jou
2a200 72 6e 61 6c 20 66 69 6c 65 20 6e 65 65 64 73 20 rnal file needs
2a210 74 6f 20 62 65 20 0a 20 20 20 20 2a 2a 20 73 79 to be . ** sy
2a220 6e 63 28 29 65 64 20 62 65 66 6f 72 65 20 61 6e nc()ed before an
2a230 79 20 64 61 74 61 20 69 73 20 77 72 69 74 74 65 y data is writte
2a240 6e 20 74 6f 20 64 61 74 61 62 61 73 65 20 66 69 n to database fi
2a250 6c 65 20 70 61 67 65 20 6e 65 65 64 53 79 6e 63 le page needSync
2a260 50 67 6e 6f 2e 0a 20 20 20 20 2a 2a 20 43 75 72 Pgno.. ** Cur
2a270 72 65 6e 74 6c 79 2c 20 6e 6f 20 73 75 63 68 20 rently, no such
2a280 70 61 67 65 20 65 78 69 73 74 73 20 69 6e 20 74 page exists in t
2a290 68 65 20 70 61 67 65 2d 63 61 63 68 65 20 61 6e he page-cache an
2a2a0 64 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 50 61 d the . ** Pa
2a2b0 67 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62 ger.pInJournal b
2a2c0 69 74 20 68 61 73 20 62 65 65 6e 20 73 65 74 2e it has been set.
2a2d0 20 54 68 69 73 20 6e 65 65 64 73 20 74 6f 20 62 This needs to b
2a2e0 65 20 72 65 6d 65 64 69 65 64 20 62 79 20 6c 6f e remedied by lo
2a2f0 61 64 69 6e 67 0a 20 20 20 20 2a 2a 20 74 68 65 ading. ** the
2a300 20 70 61 67 65 20 69 6e 74 6f 20 74 68 65 20 70 page into the p
2a310 61 67 65 72 2d 63 61 63 68 65 20 61 6e 64 20 73 ager-cache and s
2a320 65 74 74 69 6e 67 20 74 68 65 20 50 67 48 64 72 etting the PgHdr
2a330 2e 6e 65 65 64 53 79 6e 63 20 66 6c 61 67 2e 0a .needSync flag..
2a340 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66 **. ** If
2a350 20 74 68 65 20 61 74 74 65 6d 70 74 20 74 6f 20 the attempt to
2a360 6c 6f 61 64 20 74 68 65 20 70 61 67 65 20 69 6e load the page in
2a370 74 6f 20 74 68 65 20 70 61 67 65 2d 63 61 63 68 to the page-cach
2a380 65 20 66 61 69 6c 73 2c 20 28 64 75 65 0a 20 20 e fails, (due.
2a390 20 20 2a 2a 20 74 6f 20 61 20 6d 61 6c 6c 6f 63 ** to a malloc
2a3a0 28 29 20 6f 72 20 49 4f 20 66 61 69 6c 75 72 65 () or IO failure
2a3b0 29 2c 20 63 6c 65 61 72 20 74 68 65 20 62 69 74 ), clear the bit
2a3c0 20 69 6e 20 74 68 65 20 70 49 6e 4a 6f 75 72 6e in the pInJourn
2a3d0 61 6c 5b 5d 0a 20 20 20 20 2a 2a 20 61 72 72 61 al[]. ** arra
2a3e0 79 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 y. Otherwise, if
2a3f0 20 74 68 65 20 70 61 67 65 20 69 73 20 6c 6f 61 the page is loa
2a400 64 65 64 20 61 6e 64 20 77 72 69 74 74 65 6e 20 ded and written
2a410 61 67 61 69 6e 20 69 6e 0a 20 20 20 20 2a 2a 20 again in. **
2a420 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e this transaction
2a430 2c 20 69 74 20 6d 61 79 20 62 65 20 77 72 69 74 , it may be writ
2a440 74 65 6e 20 74 6f 20 74 68 65 20 64 61 74 61 62 ten to the datab
2a450 61 73 65 20 66 69 6c 65 20 62 65 66 6f 72 65 0a ase file before.
2a460 20 20 20 20 2a 2a 20 69 74 20 69 73 20 73 79 6e ** it is syn
2a470 63 65 64 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 ced into the jou
2a480 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69 73 20 rnal file. This
2a490 77 61 79 2c 20 69 74 20 6d 61 79 20 65 6e 64 20 way, it may end
2a4a0 75 70 20 69 6e 0a 20 20 20 20 2a 2a 20 74 68 65 up in. ** the
2a4b0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 77 journal file tw
2a4c0 69 63 65 2c 20 62 75 74 20 74 68 61 74 20 69 73 ice, but that is
2a4d0 20 6e 6f 74 20 61 20 70 72 6f 62 6c 65 6d 2e 0a not a problem..
2a4e0 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 **. ** Th
2a4f0 65 20 73 71 6c 69 74 65 33 50 61 67 65 72 47 65 e sqlite3PagerGe
2a500 74 28 29 20 63 61 6c 6c 20 6d 61 79 20 63 61 75 t() call may cau
2a510 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 74 se the journal t
2a520 6f 20 73 79 6e 63 2e 20 53 6f 20 6d 61 6b 65 0a o sync. So make.
2a530 20 20 20 20 2a 2a 20 73 75 72 65 20 74 68 65 20 ** sure the
2a540 50 61 67 65 72 2e 6e 65 65 64 53 79 6e 63 20 66 Pager.needSync f
2a550 6c 61 67 20 69 73 20 73 65 74 20 74 6f 6f 2e 0a lag is set too..
2a560 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 */. int r
2a570 63 3b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 50 c;. PgHdr *pP
2a580 67 48 64 72 3b 0a 20 20 20 20 61 73 73 65 72 74 gHdr;. assert
2a590 28 20 70 50 61 67 65 72 2d 3e 6e 65 65 64 53 79 ( pPager->needSy
2a5a0 6e 63 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 nc );. rc = s
2a5b0 71 6c 69 74 65 33 50 61 67 65 72 47 65 74 28 70 qlite3PagerGet(p
2a5c0 50 61 67 65 72 2c 20 6e 65 65 64 53 79 6e 63 50 Pager, needSyncP
2a5d0 67 6e 6f 2c 20 26 70 50 67 48 64 72 29 3b 0a 20 gno, &pPgHdr);.
2a5e0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
2a5f0 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 66 E_OK ){. if
2a600 28 20 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 ( pPager->pInJou
2a610 72 6e 61 6c 20 26 26 20 28 69 6e 74 29 6e 65 65 rnal && (int)nee
2a620 64 53 79 6e 63 50 67 6e 6f 3c 3d 70 50 61 67 65 dSyncPgno<=pPage
2a630 72 2d 3e 6f 72 69 67 44 62 53 69 7a 65 20 29 7b r->origDbSize ){
2a640 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
2a650 42 69 74 76 65 63 43 6c 65 61 72 28 70 50 61 67 BitvecClear(pPag
2a660 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 2c 20 er->pInJournal,
2a670 6e 65 65 64 53 79 6e 63 50 67 6e 6f 29 3b 0a 20 needSyncPgno);.
2a680 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 61 67 }. pag
2a690 65 72 4c 65 61 76 65 28 70 50 61 67 65 72 29 3b erLeave(pPager);
2a6a0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 . return rc
2a6b0 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 50 61 67 ;. }. pPag
2a6c0 65 72 2d 3e 6e 65 65 64 53 79 6e 63 20 3d 20 31 er->needSync = 1
2a6d0 3b 0a 20 20 20 20 70 50 67 48 64 72 2d 3e 6e 65 ;. pPgHdr->ne
2a6e0 65 64 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 edSync = 1;.
2a6f0 70 50 67 48 64 72 2d 3e 69 6e 4a 6f 75 72 6e 61 pPgHdr->inJourna
2a700 6c 20 3d 20 31 3b 0a 20 20 20 20 6d 61 6b 65 44 l = 1;. makeD
2a710 69 72 74 79 28 70 50 67 48 64 72 29 3b 0a 20 20 irty(pPgHdr);.
2a720 20 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e sqlite3PagerUn
2a730 72 65 66 28 70 50 67 48 64 72 29 3b 0a 20 20 7d ref(pPgHdr);. }
2a740 0a 0a 20 20 70 61 67 65 72 4c 65 61 76 65 28 70 .. pagerLeave(p
2a750 50 61 67 65 72 29 3b 0a 20 20 72 65 74 75 72 6e Pager);. return
2a760 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 23 65 SQLITE_OK;.}.#e
2a770 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 ndif../*.** Retu
2a780 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 rn a pointer to
2a790 74 68 65 20 64 61 74 61 20 66 6f 72 20 74 68 65 the data for the
2a7a0 20 73 70 65 63 69 66 69 65 64 20 70 61 67 65 2e specified page.
2a7b0 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
2a7c0 33 50 61 67 65 72 47 65 74 44 61 74 61 28 44 62 3PagerGetData(Db
2a7d0 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 72 65 Page *pPg){. re
2a7e0 74 75 72 6e 20 50 47 48 44 52 5f 54 4f 5f 44 41 turn PGHDR_TO_DA
2a7f0 54 41 28 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a TA(pPg);.}../*.*
2a800 2a 20 52 65 74 75 72 6e 20 61 20 70 6f 69 6e 74 * Return a point
2a810 65 72 20 74 6f 20 74 68 65 20 50 61 67 65 72 2e er to the Pager.
2a820 6e 45 78 74 72 61 20 62 79 74 65 73 20 6f 66 20 nExtra bytes of
2a830 22 65 78 74 72 61 22 20 73 70 61 63 65 20 0a 2a "extra" space .*
2a840 2a 20 61 6c 6c 6f 63 61 74 65 64 20 61 6c 6f 6e * allocated alon
2a850 67 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69 g with the speci
2a860 66 69 65 64 20 70 61 67 65 2e 0a 2a 2f 0a 76 6f fied page..*/.vo
2a870 69 64 20 2a 73 71 6c 69 74 65 33 50 61 67 65 72 id *sqlite3Pager
2a880 47 65 74 45 78 74 72 61 28 44 62 50 61 67 65 20 GetExtra(DbPage
2a890 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a *pPg){. Pager *
2a8a0 70 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 pPager = pPg->pP
2a8b0 61 67 65 72 3b 0a 20 20 72 65 74 75 72 6e 20 28 ager;. return (
2a8c0 70 50 61 67 65 72 3f 50 47 48 44 52 5f 54 4f 5f pPager?PGHDR_TO_
2a8d0 45 58 54 52 41 28 70 50 67 2c 20 70 50 61 67 65 EXTRA(pPg, pPage
2a8e0 72 29 3a 30 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 r):0);.}../*.**
2a8f0 47 65 74 2f 73 65 74 20 74 68 65 20 6c 6f 63 6b Get/set the lock
2a900 69 6e 67 2d 6d 6f 64 65 20 66 6f 72 20 74 68 69 ing-mode for thi
2a910 73 20 70 61 67 65 72 2e 20 50 61 72 61 6d 65 74 s pager. Paramet
2a920 65 72 20 65 4d 6f 64 65 20 6d 75 73 74 20 62 65 er eMode must be
2a930 20 6f 6e 65 0a 2a 2a 20 6f 66 20 50 41 47 45 52 one.** of PAGER
2a940 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 51 55 45 _LOCKINGMODE_QUE
2a950 52 59 2c 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e RY, PAGER_LOCKIN
2a960 47 4d 4f 44 45 5f 4e 4f 52 4d 41 4c 20 6f 72 20 GMODE_NORMAL or
2a970 0a 2a 2a 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e .** PAGER_LOCKIN
2a980 47 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 2e GMODE_EXCLUSIVE.
2a990 20 49 66 20 74 68 65 20 70 61 72 61 6d 65 74 65 If the paramete
2a9a0 72 20 69 73 20 6e 6f 74 20 5f 51 55 45 52 59 2c r is not _QUERY,
2a9b0 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 6c 6f 63 then.** the loc
2a9c0 6b 69 6e 67 2d 6d 6f 64 65 20 69 73 20 73 65 74 king-mode is set
2a9d0 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 73 70 to the value sp
2a9e0 65 63 69 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 ecified..**.** T
2a9f0 68 65 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 he returned valu
2aa00 65 20 69 73 20 65 69 74 68 65 72 20 50 41 47 45 e is either PAGE
2aa10 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f R_LOCKINGMODE_NO
2aa20 52 4d 41 4c 20 6f 72 0a 2a 2a 20 50 41 47 45 52 RMAL or.** PAGER
2aa30 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 _LOCKINGMODE_EXC
2aa40 4c 55 53 49 56 45 2c 20 69 6e 64 69 63 61 74 69 LUSIVE, indicati
2aa50 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 28 ng the current (
2aa60 70 6f 73 73 69 62 6c 79 20 75 70 64 61 74 65 64 possibly updated
2aa70 29 0a 2a 2a 20 6c 6f 63 6b 69 6e 67 2d 6d 6f 64 ).** locking-mod
2aa80 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 e..*/.int sqlite
2aa90 33 50 61 67 65 72 4c 6f 63 6b 69 6e 67 4d 6f 64 3PagerLockingMod
2aaa0 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c e(Pager *pPager,
2aab0 20 69 6e 74 20 65 4d 6f 64 65 29 7b 0a 20 20 61 int eMode){. a
2aac0 73 73 65 72 74 28 20 65 4d 6f 64 65 3d 3d 50 41 ssert( eMode==PA
2aad0 47 45 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f GER_LOCKINGMODE_
2aae0 51 55 45 52 59 0a 20 20 20 20 20 20 20 20 20 20 QUERY.
2aaf0 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 41 47 45 || eMode==PAGE
2ab00 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f R_LOCKINGMODE_NO
2ab10 52 4d 41 4c 0a 20 20 20 20 20 20 20 20 20 20 20 RMAL.
2ab20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 41 47 45 52 || eMode==PAGER
2ab30 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 _LOCKINGMODE_EXC
2ab40 4c 55 53 49 56 45 20 29 3b 0a 20 20 61 73 73 65 LUSIVE );. asse
2ab50 72 74 28 20 50 41 47 45 52 5f 4c 4f 43 4b 49 4e rt( PAGER_LOCKIN
2ab60 47 4d 4f 44 45 5f 51 55 45 52 59 3c 30 20 29 3b GMODE_QUERY<0 );
2ab70 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 45 52 . assert( PAGER
2ab80 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 4e 4f 52 _LOCKINGMODE_NOR
2ab90 4d 41 4c 3e 3d 30 20 26 26 20 50 41 47 45 52 5f MAL>=0 && PAGER_
2aba0 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 43 4c LOCKINGMODE_EXCL
2abb0 55 53 49 56 45 3e 3d 30 20 29 3b 0a 20 20 69 66 USIVE>=0 );. if
2abc0 28 20 65 4d 6f 64 65 3e 3d 30 20 26 26 20 21 70 ( eMode>=0 && !p
2abd0 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
2abe0 29 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 ){. pPager->e
2abf0 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3d 20 65 xclusiveMode = e
2ac00 4d 6f 64 65 3b 0a 20 20 7d 0a 20 20 72 65 74 75 Mode;. }. retu
2ac10 72 6e 20 28 69 6e 74 29 70 50 61 67 65 72 2d 3e rn (int)pPager->
2ac20 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 3b 0a 7d exclusiveMode;.}
2ac30 0a 0a 2f 2a 0a 2a 2a 20 47 65 74 2f 73 65 74 20 ../*.** Get/set
2ac40 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 the journal-mode
2ac50 20 66 6f 72 20 74 68 69 73 20 70 61 67 65 72 2e for this pager.
2ac60 20 50 61 72 61 6d 65 74 65 72 20 65 4d 6f 64 65 Parameter eMode
2ac70 20 6d 75 73 74 20 62 65 20 6f 6e 65 0a 2a 2a 20 must be one.**
2ac80 6f 66 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c of PAGER_JOURNAL
2ac90 4d 4f 44 45 5f 51 55 45 52 59 2c 20 50 41 47 45 MODE_QUERY, PAGE
2aca0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 R_JOURNALMODE_DE
2acb0 4c 45 54 45 20 6f 72 20 0a 2a 2a 20 50 41 47 45 LETE or .** PAGE
2acc0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 R_JOURNALMODE_PE
2acd0 52 53 49 53 54 2e 20 49 66 20 74 68 65 20 70 61 RSIST. If the pa
2ace0 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 5f rameter is not _
2acf0 51 55 45 52 59 2c 20 74 68 65 6e 0a 2a 2a 20 74 QUERY, then.** t
2ad00 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f 64 65 20 he journal-mode
2ad10 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 76 61 is set to the va
2ad20 6c 75 65 20 73 70 65 63 69 66 69 65 64 2e 0a 2a lue specified..*
2ad30 2a 0a 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 65 *.** The returne
2ad40 64 20 76 61 6c 75 65 20 69 73 20 65 69 74 68 65 d value is eithe
2ad50 72 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d r PAGER_JOURNALM
2ad60 4f 44 45 5f 44 45 4c 45 54 45 20 6f 72 0a 2a 2a ODE_DELETE or.**
2ad70 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f PAGER_JOURNALMO
2ad80 44 45 5f 50 45 52 53 49 53 54 2c 20 69 6e 64 69 DE_PERSIST, indi
2ad90 63 61 74 69 6e 67 20 74 68 65 20 63 75 72 72 65 cating the curre
2ada0 6e 74 20 28 70 6f 73 73 69 62 6c 79 20 75 70 64 nt (possibly upd
2adb0 61 74 65 64 29 0a 2a 2a 20 6a 6f 75 72 6e 61 6c ated).** journal
2adc0 2d 6d 6f 64 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 -mode..*/.int sq
2add0 6c 69 74 65 33 50 61 67 65 72 4a 6f 75 72 6e 61 lite3PagerJourna
2ade0 6c 4d 6f 64 65 28 50 61 67 65 72 20 2a 70 50 61 lMode(Pager *pPa
2adf0 67 65 72 2c 20 69 6e 74 20 65 4d 6f 64 65 29 7b ger, int eMode){
2ae00 0a 20 20 61 73 73 65 72 74 28 20 65 4d 6f 64 65 . assert( eMode
2ae10 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ==PAGER_JOURNALM
2ae20 4f 44 45 5f 51 55 45 52 59 0a 20 20 20 20 20 20 ODE_QUERY.
2ae30 20 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d || eMode==
2ae40 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
2ae50 45 5f 44 45 4c 45 54 45 0a 20 20 20 20 20 20 20 E_DELETE.
2ae60 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 || eMode==P
2ae70 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
2ae80 5f 50 45 52 53 49 53 54 0a 20 20 20 20 20 20 20 _PERSIST.
2ae90 20 20 20 20 20 7c 7c 20 65 4d 6f 64 65 3d 3d 50 || eMode==P
2aea0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
2aeb0 5f 4f 46 46 20 29 3b 0a 20 20 61 73 73 65 72 74 _OFF );. assert
2aec0 28 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d ( PAGER_JOURNALM
2aed0 4f 44 45 5f 51 55 45 52 59 3c 30 20 29 3b 0a 20 ODE_QUERY<0 );.
2aee0 20 61 73 73 65 72 74 28 20 50 41 47 45 52 5f 4a assert( PAGER_J
2aef0 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 4c 45 54 OURNALMODE_DELET
2af00 45 3e 3d 30 20 26 26 20 50 41 47 45 52 5f 4a 4f E>=0 && PAGER_JO
2af10 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 URNALMODE_PERSIS
2af20 54 3e 3d 30 20 29 3b 0a 20 20 69 66 28 20 65 4d T>=0 );. if( eM
2af30 6f 64 65 3e 3d 30 20 29 7b 0a 20 20 20 20 70 50 ode>=0 ){. pP
2af40 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
2af50 65 20 3d 20 65 4d 6f 64 65 3b 0a 20 20 7d 0a 20 e = eMode;. }.
2af60 20 72 65 74 75 72 6e 20 28 69 6e 74 29 70 50 61 return (int)pPa
2af70 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ger->journalMode
2af80 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ;.}..#ifdef SQLI
2af90 54 45 5f 54 45 53 54 0a 2f 2a 0a 2a 2a 20 50 72 TE_TEST./*.** Pr
2afa0 69 6e 74 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 int a listing of
2afb0 20 61 6c 6c 20 72 65 66 65 72 65 6e 63 65 64 20 all referenced
2afc0 70 61 67 65 73 20 61 6e 64 20 74 68 65 69 72 20 pages and their
2afd0 72 65 66 20 63 6f 75 6e 74 2e 0a 2a 2f 0a 76 6f ref count..*/.vo
2afe0 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 id sqlite3PagerR
2aff0 65 66 64 75 6d 70 28 50 61 67 65 72 20 2a 70 50 efdump(Pager *pP
2b000 61 67 65 72 29 7b 0a 20 20 50 67 48 64 72 20 2a ager){. PgHdr *
2b010 70 50 67 3b 0a 20 20 66 6f 72 28 70 50 67 3d 70 pPg;. for(pPg=p
2b020 50 61 67 65 72 2d 3e 70 41 6c 6c 3b 20 70 50 67 Pager->pAll; pPg
2b030 3b 20 70 50 67 3d 70 50 67 2d 3e 70 4e 65 78 74 ; pPg=pPg->pNext
2b040 41 6c 6c 29 7b 0a 20 20 20 20 69 66 28 20 70 50 All){. if( pP
2b050 67 2d 3e 6e 52 65 66 3c 3d 30 20 29 20 63 6f 6e g->nRef<=0 ) con
2b060 74 69 6e 75 65 3b 0a 20 20 20 20 73 71 6c 69 74 tinue;. sqlit
2b070 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 50 e3DebugPrintf("P
2b080 41 47 45 20 25 33 64 20 61 64 64 72 3d 25 70 20 AGE %3d addr=%p
2b090 6e 52 65 66 3d 25 64 5c 6e 22 2c 20 0a 20 20 20 nRef=%d\n", .
2b0a0 20 20 20 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 50 pPg->pgno, P
2b0b0 47 48 44 52 5f 54 4f 5f 44 41 54 41 28 70 50 67 GHDR_TO_DATA(pPg
2b0c0 29 2c 20 70 50 67 2d 3e 6e 52 65 66 29 3b 0a 20 ), pPg->nRef);.
2b0d0 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 23 65 6e }.}.#endif..#en
2b0e0 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d dif /* SQLITE_OM
2b0f0 49 54 5f 44 49 53 4b 49 4f 20 2a 2f 0a IT_DISKIO */.