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 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
0340: 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a ITE_OMIT_DISKIO.
0350: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite
0360: 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 Int.h".#include
0370: 22 77 61 6c 2e 68 22 0a 0a 0a 2f 2a 2a 2a 2a 2a "wal.h".../*****
0380: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 20 4e ************** N
0390: 4f 54 45 53 20 4f 4e 20 54 48 45 20 44 45 53 49 OTES ON THE DESI
03a0: 47 4e 20 4f 46 20 54 48 45 20 50 41 47 45 52 20 GN OF THE PAGER
03b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
03c0: 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 2a 0a 2a 2a 20 54 ********.**.** T
03d0: 68 69 73 20 63 6f 6d 6d 65 6e 74 20 62 6c 6f 63 his comment bloc
03e0: 6b 20 64 65 73 63 72 69 62 65 73 20 69 6e 76 61 k describes inva
03f0: 72 69 61 6e 74 73 20 74 68 61 74 20 68 6f 6c 64 riants that hold
0400: 20 77 68 65 6e 20 75 73 69 6e 67 20 61 20 72 6f when using a ro
0410: 6c 6c 62 61 63 6b 0a 2a 2a 20 6a 6f 75 72 6e 61 llback.** journa
0420: 6c 2e 20 20 54 68 65 73 65 20 69 6e 76 61 72 69 l. These invari
0430: 61 6e 74 73 20 64 6f 20 6e 6f 74 20 61 70 70 6c ants do not appl
0440: 79 20 66 6f 72 20 6a 6f 75 72 6e 61 6c 5f 6d 6f y for journal_mo
0450: 64 65 3d 57 41 4c 2c 0a 2a 2a 20 6a 6f 75 72 6e de=WAL,.** journ
0460: 61 6c 5f 6d 6f 64 65 3d 4d 45 4d 4f 52 59 2c 20 al_mode=MEMORY,
0470: 6f 72 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d or journal_mode=
0480: 4f 46 46 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 69 OFF..**.** Withi
0490: 6e 20 74 68 69 73 20 63 6f 6d 6d 65 6e 74 20 62 n this comment b
04a0: 6c 6f 63 6b 2c 20 61 20 70 61 67 65 20 69 73 20 lock, a page is
04b0: 64 65 65 6d 65 64 20 74 6f 20 68 61 76 65 20 62 deemed to have b
04c0: 65 65 6e 20 73 79 6e 63 65 64 0a 2a 2a 20 61 75 een synced.** au
04d0: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 73 20 73 tomatically as s
04e0: 6f 6f 6e 20 61 73 20 69 74 20 69 73 20 77 72 69 oon as it is wri
04f0: 74 74 65 6e 20 77 68 65 6e 20 50 52 41 47 4d 41 tten when PRAGMA
0500: 20 73 79 6e 63 68 72 6f 6e 6f 75 73 3d 4f 46 46 synchronous=OFF
0510: 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 ..** Otherwise,
0520: 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 the page is not
0530: 73 79 6e 63 65 64 20 75 6e 74 69 6c 20 74 68 65 synced until the
0540: 20 78 53 79 6e 63 20 6d 65 74 68 6f 64 20 6f 66 xSync method of
0550: 20 74 68 65 20 56 46 53 0a 2a 2a 20 69 73 20 63 the VFS.** is c
0560: 61 6c 6c 65 64 20 73 75 63 63 65 73 73 66 75 6c alled successful
0570: 6c 79 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 63 ly on the file c
0580: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 70 61 ontaining the pa
0590: 67 65 2e 0a 2a 2a 0a 2a 2a 20 44 65 66 69 6e 69 ge..**.** Defini
05a0: 74 69 6f 6e 3a 20 20 41 20 70 61 67 65 20 6f 66 tion: A page of
05b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
05c0: 6c 65 20 69 73 20 73 61 69 64 20 74 6f 20 62 65 le is said to be
05d0: 20 22 6f 76 65 72 77 72 69 74 65 61 62 6c 65 22 "overwriteable"
05e0: 20 69 66 0a 2a 2a 20 6f 6e 65 20 6f 72 20 6d 6f if.** one or mo
05f0: 72 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 re of the follow
0600: 69 6e 67 20 61 72 65 20 74 72 75 65 20 61 62 6f ing are true abo
0610: 75 74 20 74 68 65 20 70 61 67 65 3a 0a 2a 2a 20 ut the page:.**
0620: 0a 2a 2a 20 20 20 20 20 28 61 29 20 20 54 68 65 .** (a) The
0630: 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6e 74 65 6e original conten
0640: 74 20 6f 66 20 74 68 65 20 70 61 67 65 20 61 73 t of the page as
0650: 20 69 74 20 77 61 73 20 61 74 20 74 68 65 20 62 it was at the b
0660: 65 67 69 6e 6e 69 6e 67 20 6f 66 0a 2a 2a 20 20 eginning of.**
0670: 20 20 20 20 20 20 20 20 74 68 65 20 74 72 61 6e the tran
0680: 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 65 6e saction has been
0690: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 written into th
06a0: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
06b0: 61 6c 20 61 6e 64 0a 2a 2a 20 20 20 20 20 20 20 al and.**
06c0: 20 20 20 73 79 6e 63 65 64 2e 0a 2a 2a 20 0a 2a synced..** .*
06d0: 2a 20 20 20 20 20 28 62 29 20 20 54 68 65 20 70 * (b) The p
06e0: 61 67 65 20 77 61 73 20 61 20 66 72 65 65 6c 69 age was a freeli
06f0: 73 74 20 6c 65 61 66 20 70 61 67 65 20 61 74 20 st leaf page at
0700: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
0710: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
0720: 20 0a 2a 2a 20 20 20 20 20 28 63 29 20 20 54 68 .** (c) Th
0730: 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 e page number is
0740: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 greater than th
0750: 65 20 6c 61 72 67 65 73 74 20 70 61 67 65 20 74 e largest page t
0760: 68 61 74 20 65 78 69 73 74 65 64 20 69 6e 0a 2a hat existed in.*
0770: 2a 20 20 20 20 20 20 20 20 20 20 74 68 65 20 64 * the d
0780: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 74 20 atabase file at
0790: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
07a0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a transaction..**
07b0: 20 0a 2a 2a 20 28 31 29 20 41 20 70 61 67 65 20 .** (1) A page
07c0: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 of the database
07d0: 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 6f 76 file is never ov
07e0: 65 72 77 72 69 74 74 65 6e 20 75 6e 6c 65 73 73 erwritten unless
07f0: 20 6f 6e 65 20 6f 66 20 74 68 65 0a 2a 2a 20 20 one of the.**
0800: 20 20 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 following are
0810: 20 74 72 75 65 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 true:.** .**
0820: 20 20 28 61 29 20 54 68 65 20 70 61 67 65 20 61 (a) The page a
0830: 6e 64 20 61 6c 6c 20 6f 74 68 65 72 20 70 61 67 nd all other pag
0840: 65 73 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 73 es on the same s
0850: 65 63 74 6f 72 20 61 72 65 20 6f 76 65 72 77 72 ector are overwr
0860: 69 74 65 61 62 6c 65 2e 0a 2a 2a 20 0a 2a 2a 20 iteable..** .**
0870: 20 20 20 20 28 62 29 20 54 68 65 20 61 74 6f 6d (b) The atom
0880: 69 63 20 70 61 67 65 20 77 72 69 74 65 20 6f 70 ic page write op
0890: 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 65 6e timization is en
08a0: 61 62 6c 65 64 2c 20 61 6e 64 20 74 68 65 20 65 abled, and the e
08b0: 6e 74 69 72 65 0a 2a 2a 20 20 20 20 20 20 20 20 ntire.**
08c0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 74 68 transaction oth
08d0: 65 72 20 74 68 61 6e 20 74 68 65 20 75 70 64 61 er than the upda
08e0: 74 65 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 te of the transa
08f0: 63 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 0a 2a ction sequence.*
0900: 2a 20 20 20 20 20 20 20 20 20 6e 75 6d 62 65 72 * number
0910: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 consists of a s
0920: 69 6e 67 6c 65 20 70 61 67 65 20 63 68 61 6e 67 ingle page chang
0930: 65 2e 0a 2a 2a 20 0a 2a 2a 20 28 32 29 20 54 68 e..** .** (2) Th
0940: 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 70 e content of a p
0950: 61 67 65 20 77 72 69 74 74 65 6e 20 69 6e 74 6f age written into
0960: 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f the rollback jo
0970: 75 72 6e 61 6c 20 65 78 61 63 74 6c 79 20 6d 61 urnal exactly ma
0980: 74 63 68 65 73 0a 2a 2a 20 20 20 20 20 62 6f 74 tches.** bot
0990: 68 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 69 6e h the content in
09a0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 77 68 the database wh
09b0: 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 en the rollback
09c0: 6a 6f 75 72 6e 61 6c 20 77 61 73 20 77 72 69 74 journal was writ
09d0: 74 65 6e 0a 2a 2a 20 20 20 20 20 61 6e 64 20 74 ten.** and t
09e0: 68 65 20 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 he content in th
09f0: 65 20 64 61 74 61 62 61 73 65 20 61 74 20 74 68 e database at th
0a00: 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 e beginning of t
0a10: 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 20 20 he current.**
0a20: 20 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a transaction..*
0a30: 2a 20 0a 2a 2a 20 28 33 29 20 57 72 69 74 65 73 * .** (3) Writes
0a40: 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
0a50: 20 66 69 6c 65 20 61 72 65 20 61 6e 20 69 6e 74 file are an int
0a60: 65 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 6f 66 eger multiple of
0a70: 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 0a 2a the page size.*
0a80: 2a 20 20 20 20 20 69 6e 20 6c 65 6e 67 74 68 20 * in length
0a90: 61 6e 64 20 61 72 65 20 61 6c 69 67 6e 65 64 20 and are aligned
0aa0: 6f 6e 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 on a page bounda
0ab0: 72 79 2e 0a 2a 2a 20 0a 2a 2a 20 28 34 29 20 52 ry..** .** (4) R
0ac0: 65 61 64 73 20 66 72 6f 6d 20 74 68 65 20 64 61 eads from the da
0ad0: 74 61 62 61 73 65 20 66 69 6c 65 20 61 72 65 20 tabase file are
0ae0: 65 69 74 68 65 72 20 61 6c 69 67 6e 65 64 20 6f either aligned o
0af0: 6e 20 61 20 70 61 67 65 20 62 6f 75 6e 64 61 72 n a page boundar
0b00: 79 20 61 6e 64 0a 2a 2a 20 20 20 20 20 61 6e 20 y and.** an
0b10: 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 70 6c 65 integer multiple
0b20: 20 6f 66 20 74 68 65 20 70 61 67 65 20 73 69 7a of the page siz
0b30: 65 20 69 6e 20 6c 65 6e 67 74 68 20 6f 72 20 61 e in length or a
0b40: 72 65 20 74 61 6b 65 6e 20 66 72 6f 6d 20 74 68 re taken from th
0b50: 65 0a 2a 2a 20 20 20 20 20 66 69 72 73 74 20 31 e.** first 1
0b60: 30 30 20 62 79 74 65 73 20 6f 66 20 74 68 65 20 00 bytes of the
0b70: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
0b80: 2a 20 0a 2a 2a 20 28 35 29 20 41 6c 6c 20 77 72 * .** (5) All wr
0b90: 69 74 65 73 20 74 6f 20 74 68 65 20 64 61 74 61 ites to the data
0ba0: 62 61 73 65 20 66 69 6c 65 20 61 72 65 20 73 79 base file are sy
0bb0: 6e 63 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 nced prior to th
0bc0: 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
0bd0: 61 6c 0a 2a 2a 20 20 20 20 20 62 65 69 6e 67 20 al.** being
0be0: 64 65 6c 65 74 65 64 2c 20 74 72 75 6e 63 61 74 deleted, truncat
0bf0: 65 64 2c 20 6f 72 20 7a 65 72 6f 65 64 2e 0a 2a ed, or zeroed..*
0c00: 2a 20 0a 2a 2a 20 28 36 29 20 49 66 20 61 20 6d * .** (6) If a m
0c10: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
0c20: 6c 65 20 69 73 20 75 73 65 64 2c 20 74 68 65 6e le is used, then
0c30: 20 61 6c 6c 20 77 72 69 74 65 73 20 74 6f 20 74 all writes to t
0c40: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
0c50: 0a 2a 2a 20 20 20 20 20 61 72 65 20 73 79 6e 63 .** are sync
0c60: 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 ed prior to the
0c70: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 62 master journal b
0c80: 65 69 6e 67 20 64 65 6c 65 74 65 64 2e 0a 2a 2a eing deleted..**
0c90: 20 0a 2a 2a 20 44 65 66 69 6e 69 74 69 6f 6e 3a .** Definition:
0ca0: 20 54 77 6f 20 64 61 74 61 62 61 73 65 73 20 28 Two databases (
0cb0: 6f 72 20 74 68 65 20 73 61 6d 65 20 64 61 74 61 or the same data
0cc0: 62 61 73 65 20 61 74 20 74 77 6f 20 70 6f 69 6e base at two poin
0cd0: 74 73 20 69 74 20 74 69 6d 65 29 0a 2a 2a 20 61 ts it time).** a
0ce0: 72 65 20 73 61 69 64 20 74 6f 20 62 65 20 22 6c re said to be "l
0cf0: 6f 67 69 63 61 6c 6c 79 20 65 71 75 69 76 61 6c ogically equival
0d00: 65 6e 74 22 20 69 66 20 74 68 65 79 20 67 69 76 ent" if they giv
0d10: 65 20 74 68 65 20 73 61 6d 65 20 61 6e 73 77 65 e the same answe
0d20: 72 20 74 6f 0a 2a 2a 20 61 6c 6c 20 71 75 65 72 r to.** all quer
0d30: 69 65 73 2e 20 20 4e 6f 74 65 20 69 6e 20 70 61 ies. Note in pa
0d40: 72 74 69 63 75 6c 61 72 20 74 68 65 20 63 6f 6e rticular the con
0d50: 74 65 6e 74 20 6f 66 20 66 72 65 65 6c 69 73 74 tent of freelist
0d60: 20 6c 65 61 66 0a 2a 2a 20 70 61 67 65 73 20 63 leaf.** pages c
0d70: 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 61 72 an be changed ar
0d80: 62 69 74 72 61 72 69 6c 79 20 77 69 74 68 6f 75 bitrarily withou
0d90: 74 20 61 66 66 65 63 74 69 6e 67 20 74 68 65 20 t affecting the
0da0: 6c 6f 67 69 63 61 6c 20 65 71 75 69 76 61 6c 65 logical equivale
0db0: 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 65 20 64 61 nce.** of the da
0dc0: 74 61 62 61 73 65 2e 0a 2a 2a 20 0a 2a 2a 20 28 tabase..** .** (
0dd0: 37 29 20 41 74 20 61 6e 79 20 74 69 6d 65 2c 20 7) At any time,
0de0: 69 66 20 61 6e 79 20 73 75 62 73 65 74 2c 20 69 if any subset, i
0df0: 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 65 6d 70 ncluding the emp
0e00: 74 79 20 73 65 74 20 61 6e 64 20 74 68 65 20 74 ty set and the t
0e10: 6f 74 61 6c 20 73 65 74 2c 0a 2a 2a 20 20 20 20 otal set,.**
0e20: 20 6f 66 20 74 68 65 20 75 6e 73 79 6e 63 65 64 of the unsynced
0e30: 20 63 68 61 6e 67 65 73 20 74 6f 20 61 20 72 6f changes to a ro
0e40: 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 61 llback journal a
0e50: 72 65 20 72 65 6d 6f 76 65 64 20 61 6e 64 20 74 re removed and t
0e60: 68 65 20 0a 2a 2a 20 20 20 20 20 6a 6f 75 72 6e he .** journ
0e70: 61 6c 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 al is rolled bac
0e80: 6b 2c 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 k, the resulting
0e90: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 77 database file w
0ea0: 69 6c 6c 20 62 65 20 6c 6f 67 69 63 61 6c 6c 79 ill be logically
0eb0: 0a 2a 2a 20 20 20 20 20 65 71 75 69 76 61 6c 65 .** equivale
0ec0: 6e 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 nt to the databa
0ed0: 73 65 20 66 69 6c 65 20 61 74 20 74 68 65 20 62 se file at the b
0ee0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 eginning of the
0ef0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 20 transaction..**
0f00: 0a 2a 2a 20 28 38 29 20 57 68 65 6e 20 61 20 74 .** (8) When a t
0f10: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 72 6f ransaction is ro
0f20: 6c 6c 65 64 20 62 61 63 6b 2c 20 74 68 65 20 78 lled back, the x
0f30: 54 72 75 6e 63 61 74 65 20 6d 65 74 68 6f 64 20 Truncate method
0f40: 6f 66 20 74 68 65 20 56 46 53 0a 2a 2a 20 20 20 of the VFS.**
0f50: 20 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 72 is called to r
0f60: 65 73 74 6f 72 65 20 74 68 65 20 64 61 74 61 62 estore the datab
0f70: 61 73 65 20 66 69 6c 65 20 74 6f 20 74 68 65 20 ase file to the
0f80: 73 61 6d 65 20 73 69 7a 65 20 69 74 20 77 61 73 same size it was
0f90: 20 61 74 0a 2a 2a 20 20 20 20 20 74 68 65 20 62 at.** the b
0fa0: 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 eginning of the
0fb0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 28 49 transaction. (I
0fc0: 6e 20 73 6f 6d 65 20 56 46 53 65 73 2c 20 74 68 n some VFSes, th
0fd0: 65 20 78 54 72 75 6e 63 61 74 65 0a 2a 2a 20 20 e xTruncate.**
0fe0: 20 20 20 6d 65 74 68 6f 64 20 69 73 20 61 20 6e method is a n
0ff0: 6f 2d 6f 70 2c 20 62 75 74 20 74 68 61 74 20 64 o-op, but that d
1000: 6f 65 73 20 6e 6f 74 20 63 68 61 6e 67 65 20 74 oes not change t
1010: 68 65 20 66 61 63 74 20 74 68 65 20 53 51 4c 69 he fact the SQLi
1020: 74 65 20 77 69 6c 6c 0a 2a 2a 20 20 20 20 20 69 te will.** i
1030: 6e 76 6f 6b 65 20 69 74 2e 29 0a 2a 2a 20 0a 2a nvoke it.).** .*
1040: 2a 20 28 39 29 20 57 68 65 6e 65 76 65 72 20 74 * (9) Whenever t
1050: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
1060: 20 69 73 20 6d 6f 64 69 66 69 65 64 2c 20 61 74 is modified, at
1070: 20 6c 65 61 73 74 20 6f 6e 65 20 62 69 74 20 69 least one bit i
1080: 6e 20 74 68 65 20 72 61 6e 67 65 0a 2a 2a 20 20 n the range.**
1090: 20 20 20 6f 66 20 62 79 74 65 73 20 66 72 6f 6d of bytes from
10a0: 20 32 34 20 74 68 72 6f 75 67 68 20 33 39 20 69 24 through 39 i
10b0: 6e 63 6c 75 73 69 76 65 20 77 69 6c 6c 20 62 65 nclusive will be
10c0: 20 63 68 61 6e 67 65 64 20 70 72 69 6f 72 20 74 changed prior t
10d0: 6f 20 72 65 6c 65 61 73 69 6e 67 0a 2a 2a 20 20 o releasing.**
10e0: 20 20 20 74 68 65 20 45 58 43 4c 55 53 49 56 45 the EXCLUSIVE
10f0: 20 6c 6f 63 6b 2c 20 74 68 75 73 20 73 69 67 6e lock, thus sign
1100: 61 6c 69 6e 67 20 6f 74 68 65 72 20 63 6f 6e 6e aling other conn
1110: 65 63 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 73 ections on the s
1120: 61 6d 65 0a 2a 2a 20 20 20 20 20 64 61 74 61 62 ame.** datab
1130: 61 73 65 20 74 6f 20 66 6c 75 73 68 20 74 68 65 ase to flush the
1140: 69 72 20 63 61 63 68 65 73 2e 0a 2a 2a 0a 2a 2a ir caches..**.**
1150: 20 28 31 30 29 20 54 68 65 20 70 61 74 74 65 72 (10) The patter
1160: 6e 20 6f 66 20 62 69 74 73 20 69 6e 20 62 79 74 n of bits in byt
1170: 65 73 20 32 34 20 74 68 72 6f 75 67 68 20 33 39 es 24 through 39
1180: 20 73 68 61 6c 6c 20 6e 6f 74 20 72 65 70 65 61 shall not repea
1190: 74 20 69 6e 20 6c 65 73 73 0a 2a 2a 20 20 20 20 t in less.**
11a0: 20 20 74 68 61 6e 20 6f 6e 65 20 62 69 6c 6c 69 than one billi
11b0: 6f 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e on transactions.
11c0: 0a 2a 2a 0a 2a 2a 20 28 31 31 29 20 41 20 64 61 .**.** (11) A da
11d0: 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 77 tabase file is w
11e0: 65 6c 6c 2d 66 6f 72 6d 65 64 20 61 74 20 74 68 ell-formed at th
11f0: 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 e beginning and
1200: 61 74 20 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f at the conclusio
1210: 6e 0a 2a 2a 20 20 20 20 20 20 6f 66 20 65 76 65 n.** of eve
1220: 72 79 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a ry transaction..
1230: 2a 2a 0a 2a 2a 20 28 31 32 29 20 41 6e 20 45 58 **.** (12) An EX
1240: 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 20 CLUSIVE lock is
1250: 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 held on the data
1260: 62 61 73 65 20 66 69 6c 65 20 77 68 65 6e 20 77 base file when w
1270: 72 69 74 69 6e 67 20 74 6f 0a 2a 2a 20 20 20 20 riting to.**
1280: 20 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 the database f
1290: 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 28 31 33 29 20 ile..**.** (13)
12a0: 41 20 53 48 41 52 45 44 20 6c 6f 63 6b 20 69 73 A SHARED lock is
12b0: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
12c0: 61 62 61 73 65 20 66 69 6c 65 20 77 68 69 6c 65 abase file while
12d0: 20 72 65 61 64 69 6e 67 20 61 6e 79 0a 2a 2a 20 reading any.**
12e0: 20 20 20 20 20 63 6f 6e 74 65 6e 74 20 6f 75 74 content out
12f0: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
1300: 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a file..**.******
1310: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1320: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1330: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1340: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1350: 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 2f 2a 0a 2a 2a ********/../*.**
1360: 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 72 6f 75 Macros for trou
1370: 62 6c 65 73 68 6f 6f 74 69 6e 67 2e 20 20 4e 6f bleshooting. No
1380: 72 6d 61 6c 6c 79 20 74 75 72 6e 65 64 20 6f 66 rmally turned of
1390: 66 0a 2a 2f 0a 23 69 66 20 30 0a 69 6e 74 20 73 f.*/.#if 0.int s
13a0: 71 6c 69 74 65 33 50 61 67 65 72 54 72 61 63 65 qlite3PagerTrace
13b0: 3d 31 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 =1; /* True to
13c0: 65 6e 61 62 6c 65 20 74 72 61 63 69 6e 67 20 2a enable tracing *
13d0: 2f 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 /.#define sqlite
13e0: 33 44 65 62 75 67 50 72 69 6e 74 66 20 70 72 69 3DebugPrintf pri
13f0: 6e 74 66 0a 23 64 65 66 69 6e 65 20 50 41 47 45 ntf.#define PAGE
1400: 52 54 52 41 43 45 28 58 29 20 20 20 20 20 69 66 RTRACE(X) if
1410: 28 20 73 71 6c 69 74 65 33 50 61 67 65 72 54 72 ( sqlite3PagerTr
1420: 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 44 65 ace ){ sqlite3De
1430: 62 75 67 50 72 69 6e 74 66 20 58 3b 20 7d 0a 23 bugPrintf X; }.#
1440: 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 50 41 47 else.#define PAG
1450: 45 52 54 52 41 43 45 28 58 29 0a 23 65 6e 64 69 ERTRACE(X).#endi
1460: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
1470: 6c 6f 77 69 6e 67 20 74 77 6f 20 6d 61 63 72 6f lowing two macro
1480: 73 20 61 72 65 20 75 73 65 64 20 77 69 74 68 69 s are used withi
1490: 6e 20 74 68 65 20 50 41 47 45 52 54 52 41 43 45 n the PAGERTRACE
14a0: 28 29 20 6d 61 63 72 6f 73 20 61 62 6f 76 65 0a () macros above.
14b0: 2a 2a 20 74 6f 20 70 72 69 6e 74 20 6f 75 74 20 ** to print out
14c0: 66 69 6c 65 2d 64 65 73 63 72 69 70 74 6f 72 73 file-descriptors
14d0: 2e 20 0a 2a 2a 0a 2a 2a 20 50 41 47 45 52 49 44 . .**.** PAGERID
14e0: 28 29 20 74 61 6b 65 73 20 61 20 70 6f 69 6e 74 () takes a point
14f0: 65 72 20 74 6f 20 61 20 50 61 67 65 72 20 73 74 er to a Pager st
1500: 72 75 63 74 20 61 73 20 69 74 73 20 61 72 67 75 ruct as its argu
1510: 6d 65 6e 74 2e 20 54 68 65 0a 2a 2a 20 61 73 73 ment. The.** ass
1520: 6f 63 69 61 74 65 64 20 66 69 6c 65 2d 64 65 73 ociated file-des
1530: 63 72 69 70 74 6f 72 20 69 73 20 72 65 74 75 72 criptor is retur
1540: 6e 65 64 2e 20 46 49 4c 45 48 41 4e 44 4c 45 49 ned. FILEHANDLEI
1550: 44 28 29 20 74 61 6b 65 73 20 61 6e 20 73 71 6c D() takes an sql
1560: 69 74 65 33 5f 66 69 6c 65 0a 2a 2a 20 73 74 72 ite3_file.** str
1570: 75 63 74 20 61 73 20 69 74 73 20 61 72 67 75 6d uct as its argum
1580: 65 6e 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ent..*/.#define
1590: 50 41 47 45 52 49 44 28 70 29 20 28 53 51 4c 49 PAGERID(p) (SQLI
15a0: 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 70 2d TE_PTR_TO_INT(p-
15b0: 3e 66 64 29 29 0a 23 64 65 66 69 6e 65 20 46 49 >fd)).#define FI
15c0: 4c 45 48 41 4e 44 4c 45 49 44 28 66 64 29 20 28 LEHANDLEID(fd) (
15d0: 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e SQLITE_PTR_TO_IN
15e0: 54 28 66 64 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 T(fd))../*.** Th
15f0: 65 20 50 61 67 65 72 2e 65 53 74 61 74 65 20 76 e Pager.eState v
1600: 61 72 69 61 62 6c 65 20 73 74 6f 72 65 73 20 74 ariable stores t
1610: 68 65 20 63 75 72 72 65 6e 74 20 27 73 74 61 74 he current 'stat
1620: 65 27 20 6f 66 20 61 20 70 61 67 65 72 2e 20 41 e' of a pager. A
1630: 0a 2a 2a 20 70 61 67 65 72 20 6d 61 79 20 62 65 .** pager may be
1640: 20 69 6e 20 61 6e 79 20 6f 6e 65 20 6f 66 20 74 in any one of t
1650: 68 65 20 73 65 76 65 6e 20 73 74 61 74 65 73 20 he seven states
1660: 73 68 6f 77 6e 20 69 6e 20 74 68 65 20 66 6f 6c shown in the fol
1670: 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 61 74 65 20 lowing.** state
1680: 64 69 61 67 72 61 6d 2e 0a 2a 2a 0a 2a 2a 20 20 diagram..**.**
1690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16a0: 20 20 20 20 20 20 20 20 20 20 4f 50 45 4e 20 3c OPEN <
16b0: 2d 2d 2d 2d 2d 2d 2b 2d 2d 2d 2d 2d 2d 2b 0a 2a ------+------+.*
16c0: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
16d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
16e0: 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 |
16f0: 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 |.**
1700: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1710: 20 20 56 20 20 20 20 20 20 20 20 20 7c 20 20 20 V |
1720: 20 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 |.**
1730: 20 20 20 20 20 20 2b 2d 2d 2d 2d 2d 2d 2d 2d 2d +---------
1740: 3e 20 52 45 41 44 45 52 2d 2d 2d 2d 2d 2d 2d 2b > READER-------+
1750: 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 20 20 |.**
1760: 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 |
1770: 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 |
1780: 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 |.**
1790: 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 |
17a0: 20 20 20 20 20 20 20 20 20 20 20 56 20 20 20 20 V
17b0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a |.**
17c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
17d0: 3c 2d 2d 2d 2d 2d 2d 2d 57 52 49 54 45 52 5f 4c <-------WRITER_L
17e0: 4f 43 4b 45 44 2d 2d 2d 2d 2d 2d 3e 20 45 52 52 OCKED------> ERR
17f0: 4f 52 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 OR.**
1800: 20 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 |
1810: 20 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 |
1820: 20 20 20 20 5e 20 20 0a 2a 2a 20 20 20 20 20 20 ^ .**
1830: 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 |
1840: 20 20 20 20 20 20 20 20 56 20 20 20 20 20 20 20 V
1850: 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 |.**
1860: 20 20 20 20 20 20 20 20 20 20 20 20 7c 3c 2d 2d |<--
1870: 2d 2d 2d 2d 57 52 49 54 45 52 5f 43 41 43 48 45 ----WRITER_CACHE
1880: 4d 4f 44 2d 2d 2d 2d 2d 2d 2d 2d 3e 7c 0a 2a 2a MOD-------->|.**
1890: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
18a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 20 |
18b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7c |
18c0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
18d0: 20 20 7c 20 20 20 20 20 20 20 20 20 20 20 20 20 |
18e0: 20 56 20 20 20 20 20 20 20 20 20 20 20 20 20 20 V
18f0: 20 20 7c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 |.**
1900: 20 20 20 20 20 7c 3c 2d 2d 2d 2d 2d 2d 2d 57 52 |<-------WR
1910: 49 54 45 52 5f 44 42 4d 4f 44 2d 2d 2d 2d 2d 2d ITER_DBMOD------
1920: 2d 2d 2d 2d 3e 7c 0a 2a 2a 20 20 20 20 20 20 20 ---->|.**
1930: 20 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 |
1940: 20 20 20 20 20 20 20 7c 20 20 20 20 20 20 20 20 |
1950: 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 20 20 20 |.**
1960: 20 20 20 20 20 20 20 20 20 20 20 7c 20 20 20 20 |
1970: 20 20 20 20 20 20 20 20 20 20 56 20 20 20 20 20 V
1980: 20 20 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a 20 |.**
1990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2b 3c +<
19a0: 2d 2d 2d 2d 2d 2d 57 52 49 54 45 52 5f 46 49 4e ------WRITER_FIN
19b0: 49 53 48 45 44 2d 2d 2d 2d 2d 2d 2d 2d 3e 2b 0a ISHED-------->+.
19c0: 2a 2a 0a 2a 2a 0a 2a 2a 20 4c 69 73 74 20 6f 66 **.**.** List of
19d0: 20 73 74 61 74 65 20 74 72 61 6e 73 69 74 69 6f state transitio
19e0: 6e 73 20 61 6e 64 20 74 68 65 20 43 20 5b 66 75 ns and the C [fu
19f0: 6e 63 74 69 6f 6e 5d 20 74 68 61 74 20 70 65 72 nction] that per
1a00: 66 6f 72 6d 73 20 65 61 63 68 3a 0a 2a 2a 20 0a forms each:.** .
1a10: 2a 2a 20 20 20 4f 50 45 4e 20 20 20 20 20 20 20 ** OPEN
1a20: 20 20 20 20 20 20 20 2d 3e 20 52 45 41 44 45 52 -> READER
1a30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5b 73 [s
1a40: 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 72 65 qlite3PagerShare
1a50: 64 4c 6f 63 6b 5d 0a 2a 2a 20 20 20 52 45 41 44 dLock].** READ
1a60: 45 52 20 20 20 20 20 20 20 20 20 20 20 20 2d 3e ER ->
1a70: 20 4f 50 45 4e 20 20 20 20 20 20 20 20 20 20 20 OPEN
1a80: 20 20 20 20 20 5b 70 61 67 65 72 5f 75 6e 6c 6f [pager_unlo
1a90: 63 6b 5d 0a 2a 2a 0a 2a 2a 20 20 20 52 45 41 44 ck].**.** READ
1aa0: 45 52 20 20 20 20 20 20 20 20 20 20 20 20 2d 3e ER ->
1ab0: 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 20 WRITER_LOCKED
1ac0: 20 20 20 20 20 5b 73 71 6c 69 74 65 33 50 61 67 [sqlite3Pag
1ad0: 65 72 42 65 67 69 6e 5d 0a 2a 2a 20 20 20 57 52 erBegin].** WR
1ae0: 49 54 45 52 5f 4c 4f 43 4b 45 44 20 20 20 20 20 ITER_LOCKED
1af0: 2d 3e 20 57 52 49 54 45 52 5f 43 41 43 48 45 4d -> WRITER_CACHEM
1b00: 4f 44 20 20 20 20 20 5b 70 61 67 65 72 5f 6f 70 OD [pager_op
1b10: 65 6e 5f 6a 6f 75 72 6e 61 6c 5d 0a 2a 2a 20 20 en_journal].**
1b20: 20 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 WRITER_CACHEMOD
1b30: 20 20 20 2d 3e 20 57 52 49 54 45 52 5f 44 42 4d -> WRITER_DBM
1b40: 4f 44 20 20 20 20 20 20 20 20 5b 73 79 6e 63 4a OD [syncJ
1b50: 6f 75 72 6e 61 6c 5d 0a 2a 2a 20 20 20 57 52 49 ournal].** WRI
1b60: 54 45 52 5f 44 42 4d 4f 44 20 20 20 20 20 20 2d TER_DBMOD -
1b70: 3e 20 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 > WRITER_FINISHE
1b80: 44 20 20 20 20 20 5b 73 71 6c 69 74 65 33 50 61 D [sqlite3Pa
1b90: 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e gerCommitPhaseOn
1ba0: 65 5d 0a 2a 2a 20 20 20 57 52 49 54 45 52 5f 2a e].** WRITER_*
1bb0: 2a 2a 20 20 20 20 20 20 20 20 2d 3e 20 52 45 41 ** -> REA
1bc0: 44 45 52 20 20 20 20 20 20 20 20 20 20 20 20 20 DER
1bd0: 20 5b 70 61 67 65 72 5f 65 6e 64 5f 74 72 61 6e [pager_end_tran
1be0: 73 61 63 74 69 6f 6e 5d 0a 2a 2a 0a 2a 2a 20 20 saction].**.**
1bf0: 20 57 52 49 54 45 52 5f 2a 2a 2a 20 20 20 20 20 WRITER_***
1c00: 20 20 20 2d 3e 20 45 52 52 4f 52 20 20 20 20 20 -> ERROR
1c10: 20 20 20 20 20 20 20 20 20 20 5b 70 61 67 65 72 [pager
1c20: 5f 65 72 72 6f 72 5d 0a 2a 2a 20 20 20 45 52 52 _error].** ERR
1c30: 4f 52 20 20 20 20 20 20 20 20 20 20 20 20 20 2d OR -
1c40: 3e 20 4f 50 45 4e 20 20 20 20 20 20 20 20 20 20 > OPEN
1c50: 20 20 20 20 20 20 5b 70 61 67 65 72 5f 75 6e 6c [pager_unl
1c60: 6f 63 6b 5d 0a 2a 2a 20 0a 2a 2a 0a 2a 2a 20 20 ock].** .**.**
1c70: 4f 50 45 4e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 54 OPEN:.**.** T
1c80: 68 65 20 70 61 67 65 72 20 73 74 61 72 74 73 20 he pager starts
1c90: 75 70 20 69 6e 20 74 68 69 73 20 73 74 61 74 65 up in this state
1ca0: 2e 20 4e 6f 74 68 69 6e 67 20 69 73 20 67 75 61 . Nothing is gua
1cb0: 72 61 6e 74 65 65 64 20 69 6e 20 74 68 69 73 0a ranteed in this.
1cc0: 2a 2a 20 20 20 20 73 74 61 74 65 20 2d 20 74 68 ** state - th
1cd0: 65 20 66 69 6c 65 20 6d 61 79 20 6f 72 20 6d 61 e file may or ma
1ce0: 79 20 6e 6f 74 20 62 65 20 6c 6f 63 6b 65 64 20 y not be locked
1cf0: 61 6e 64 20 74 68 65 20 64 61 74 61 62 61 73 65 and the database
1d00: 20 73 69 7a 65 20 69 73 0a 2a 2a 20 20 20 20 75 size is.** u
1d10: 6e 6b 6e 6f 77 6e 2e 20 54 68 65 20 64 61 74 61 nknown. The data
1d20: 62 61 73 65 20 6d 61 79 20 6e 6f 74 20 62 65 20 base may not be
1d30: 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 2e read or written.
1d40: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 4e 6f 20 72 .**.** * No r
1d50: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 61 ead or write tra
1d60: 6e 73 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 nsaction is acti
1d70: 76 65 2e 0a 2a 2a 20 20 20 20 2a 20 41 6e 79 20 ve..** * Any
1d80: 6c 6f 63 6b 2c 20 6f 72 20 6e 6f 20 6c 6f 63 6b lock, or no lock
1d90: 20 61 74 20 61 6c 6c 2c 20 6d 61 79 20 62 65 20 at all, may be
1da0: 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 held on the data
1db0: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 base file..**
1dc0: 20 2a 20 54 68 65 20 64 62 53 69 7a 65 2c 20 64 * The dbSize, d
1dd0: 62 4f 72 69 67 53 69 7a 65 20 61 6e 64 20 64 62 bOrigSize and db
1de0: 46 69 6c 65 53 69 7a 65 20 76 61 72 69 61 62 6c FileSize variabl
1df0: 65 73 20 6d 61 79 20 6e 6f 74 20 62 65 20 74 72 es may not be tr
1e00: 75 73 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 52 45 usted..**.** RE
1e10: 41 44 45 52 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 49 ADER:.**.** I
1e20: 6e 20 74 68 69 73 20 73 74 61 74 65 20 61 6c 6c n this state all
1e30: 20 74 68 65 20 72 65 71 75 69 72 65 6d 65 6e 74 the requirement
1e40: 73 20 66 6f 72 20 72 65 61 64 69 6e 67 20 74 68 s for reading th
1e50: 65 20 64 61 74 61 62 61 73 65 20 69 6e 20 0a 2a e database in .*
1e60: 2a 20 20 20 20 72 6f 6c 6c 62 61 63 6b 20 28 6e * rollback (n
1e70: 6f 6e 2d 57 41 4c 29 20 6d 6f 64 65 20 61 72 65 on-WAL) mode are
1e80: 20 6d 65 74 2e 20 55 6e 6c 65 73 73 20 74 68 65 met. Unless the
1e90: 20 70 61 67 65 72 20 69 73 20 28 6f 72 20 72 65 pager is (or re
1ea0: 63 65 6e 74 6c 79 0a 2a 2a 20 20 20 20 77 61 73 cently.** was
1eb0: 29 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d 6c ) in exclusive-l
1ec0: 6f 63 6b 69 6e 67 20 6d 6f 64 65 2c 20 61 20 75 ocking mode, a u
1ed0: 73 65 72 2d 6c 65 76 65 6c 20 72 65 61 64 20 74 ser-level read t
1ee0: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 0a 2a ransaction is .*
1ef0: 2a 20 20 20 20 6f 70 65 6e 2e 20 54 68 65 20 64 * open. The d
1f00: 61 74 61 62 61 73 65 20 73 69 7a 65 20 69 73 20 atabase size is
1f10: 6b 6e 6f 77 6e 20 69 6e 20 74 68 69 73 20 73 74 known in this st
1f20: 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 41 20 ate..**.** A
1f30: 63 6f 6e 6e 65 63 74 69 6f 6e 20 72 75 6e 6e 69 connection runni
1f40: 6e 67 20 77 69 74 68 20 6c 6f 63 6b 69 6e 67 5f ng with locking_
1f50: 6d 6f 64 65 3d 6e 6f 72 6d 61 6c 20 65 6e 74 65 mode=normal ente
1f60: 72 73 20 74 68 69 73 20 73 74 61 74 65 20 77 68 rs this state wh
1f70: 65 6e 0a 2a 2a 20 20 20 20 69 74 20 6f 70 65 6e en.** it open
1f80: 73 20 61 20 72 65 61 64 2d 74 72 61 6e 73 61 63 s a read-transac
1f90: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 64 61 74 61 tion on the data
1fa0: 62 61 73 65 20 61 6e 64 20 72 65 74 75 72 6e 73 base and returns
1fb0: 20 74 6f 20 73 74 61 74 65 0a 2a 2a 20 20 20 20 to state.**
1fc0: 4f 50 45 4e 20 61 66 74 65 72 20 74 68 65 20 72 OPEN after the r
1fd0: 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ead-transaction
1fe0: 69 73 20 63 6f 6d 70 6c 65 74 65 64 2e 20 48 6f is completed. Ho
1ff0: 77 65 76 65 72 20 61 20 63 6f 6e 6e 65 63 74 69 wever a connecti
2000: 6f 6e 0a 2a 2a 20 20 20 20 72 75 6e 6e 69 6e 67 on.** running
2010: 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 in locking_mode
2020: 3d 65 78 63 6c 75 73 69 76 65 20 28 69 6e 63 6c =exclusive (incl
2030: 75 64 69 6e 67 20 74 65 6d 70 20 64 61 74 61 62 uding temp datab
2040: 61 73 65 73 29 20 72 65 6d 61 69 6e 73 20 69 6e ases) remains in
2050: 0a 2a 2a 20 20 20 20 74 68 69 73 20 73 74 61 74 .** this stat
2060: 65 20 65 76 65 6e 20 61 66 74 65 72 20 74 68 65 e even after the
2070: 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f read-transactio
2080: 6e 20 69 73 20 63 6c 6f 73 65 64 2e 20 54 68 65 n is closed. The
2090: 20 6f 6e 6c 79 20 77 61 79 0a 2a 2a 20 20 20 20 only way.**
20a0: 61 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 a locking_mode=e
20b0: 78 63 6c 75 73 69 76 65 20 63 6f 6e 6e 65 63 74 xclusive connect
20c0: 69 6f 6e 20 63 61 6e 20 74 72 61 6e 73 69 74 69 ion can transiti
20d0: 6f 6e 20 66 72 6f 6d 20 52 45 41 44 45 52 20 74 on from READER t
20e0: 6f 20 4f 50 45 4e 0a 2a 2a 20 20 20 20 69 73 20 o OPEN.** is
20f0: 76 69 61 20 74 68 65 20 45 52 52 4f 52 20 73 74 via the ERROR st
2100: 61 74 65 20 28 73 65 65 20 62 65 6c 6f 77 29 2e ate (see below).
2110: 0a 2a 2a 20 0a 2a 2a 20 20 20 20 2a 20 41 20 72 .** .** * A r
2120: 65 61 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ead transaction
2130: 6d 61 79 20 62 65 20 61 63 74 69 76 65 20 28 62 may be active (b
2140: 75 74 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 ut a write-trans
2150: 61 63 74 69 6f 6e 20 63 61 6e 6e 6f 74 29 2e 0a action cannot)..
2160: 2a 2a 20 20 20 20 2a 20 41 20 53 48 41 52 45 44 ** * A SHARED
2170: 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f 63 6b or greater lock
2180: 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 is held on the
2190: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
21a0: 2a 20 20 20 20 2a 20 54 68 65 20 64 62 53 69 7a * * The dbSiz
21b0: 65 20 76 61 72 69 61 62 6c 65 20 6d 61 79 20 62 e variable may b
21c0: 65 20 74 72 75 73 74 65 64 20 28 65 76 65 6e 20 e trusted (even
21d0: 69 66 20 61 20 75 73 65 72 2d 6c 65 76 65 6c 20 if a user-level
21e0: 72 65 61 64 20 0a 2a 2a 20 20 20 20 20 20 74 72 read .** tr
21f0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f 74 ansaction is not
2200: 20 61 63 74 69 76 65 29 2e 20 54 68 65 20 64 62 active). The db
2210: 4f 72 69 67 53 69 7a 65 20 61 6e 64 20 64 62 46 OrigSize and dbF
2220: 69 6c 65 53 69 7a 65 20 76 61 72 69 61 62 6c 65 ileSize variable
2230: 73 0a 2a 2a 20 20 20 20 20 20 6d 61 79 20 6e 6f s.** may no
2240: 74 20 62 65 20 74 72 75 73 74 65 64 20 61 74 20 t be trusted at
2250: 74 68 69 73 20 70 6f 69 6e 74 2e 0a 2a 2a 20 20 this point..**
2260: 20 20 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 * If the datab
2270: 61 73 65 20 69 73 20 61 20 57 41 4c 20 64 61 74 ase is a WAL dat
2280: 61 62 61 73 65 2c 20 74 68 65 6e 20 74 68 65 20 abase, then the
2290: 57 41 4c 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 WAL connection i
22a0: 73 20 6f 70 65 6e 2e 0a 2a 2a 20 20 20 20 2a 20 s open..** *
22b0: 45 76 65 6e 20 69 66 20 61 20 72 65 61 64 2d 74 Even if a read-t
22c0: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f ransaction is no
22d0: 74 20 6f 70 65 6e 2c 20 69 74 20 69 73 20 67 75 t open, it is gu
22e0: 61 72 61 6e 74 65 65 64 20 74 68 61 74 20 0a 2a aranteed that .*
22f0: 2a 20 20 20 20 20 20 74 68 65 72 65 20 69 73 20 * there is
2300: 6e 6f 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 69 no hot-journal i
2310: 6e 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 n the file-syste
2320: 6d 2e 0a 2a 2a 0a 2a 2a 20 20 57 52 49 54 45 52 m..**.** WRITER
2330: 5f 4c 4f 43 4b 45 44 3a 0a 2a 2a 0a 2a 2a 20 20 _LOCKED:.**.**
2340: 20 20 54 68 65 20 70 61 67 65 72 20 6d 6f 76 65 The pager move
2350: 73 20 74 6f 20 74 68 69 73 20 73 74 61 74 65 20 s to this state
2360: 66 72 6f 6d 20 52 45 41 44 45 52 20 77 68 65 6e from READER when
2370: 20 61 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 a write-transac
2380: 74 69 6f 6e 0a 2a 2a 20 20 20 20 69 73 20 66 69 tion.** is fi
2390: 72 73 74 20 6f 70 65 6e 65 64 20 6f 6e 20 74 68 rst opened on th
23a0: 65 20 64 61 74 61 62 61 73 65 2e 20 49 6e 20 57 e database. In W
23b0: 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 RITER_LOCKED sta
23c0: 74 65 2c 20 61 6c 6c 20 6c 6f 63 6b 73 20 0a 2a te, all locks .*
23d0: 2a 20 20 20 20 72 65 71 75 69 72 65 64 20 74 6f * required to
23e0: 20 73 74 61 72 74 20 61 20 77 72 69 74 65 2d 74 start a write-t
23f0: 72 61 6e 73 61 63 74 69 6f 6e 20 61 72 65 20 68 ransaction are h
2400: 65 6c 64 2c 20 62 75 74 20 6e 6f 20 61 63 74 75 eld, but no actu
2410: 61 6c 20 0a 2a 2a 20 20 20 20 6d 6f 64 69 66 69 al .** modifi
2420: 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 63 cations to the c
2430: 61 63 68 65 20 6f 72 20 64 61 74 61 62 61 73 65 ache or database
2440: 20 68 61 76 65 20 74 61 6b 65 6e 20 70 6c 61 63 have taken plac
2450: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 49 6e 20 72 e..**.** In r
2460: 6f 6c 6c 62 61 63 6b 20 6d 6f 64 65 2c 20 61 20 ollback mode, a
2470: 52 45 53 45 52 56 45 44 20 6f 72 20 28 69 66 20 RESERVED or (if
2480: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
2490: 77 61 73 20 6f 70 65 6e 65 64 20 77 69 74 68 20 was opened with
24a0: 0a 2a 2a 20 20 20 20 42 45 47 49 4e 20 45 58 43 .** BEGIN EXC
24b0: 4c 55 53 49 56 45 29 20 45 58 43 4c 55 53 49 56 LUSIVE) EXCLUSIV
24c0: 45 20 6c 6f 63 6b 20 69 73 20 6f 62 74 61 69 6e E lock is obtain
24d0: 65 64 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 ed on the databa
24e0: 73 65 20 66 69 6c 65 20 77 68 65 6e 0a 2a 2a 20 se file when.**
24f0: 20 20 20 6d 6f 76 69 6e 67 20 74 6f 20 74 68 69 moving to thi
2500: 73 20 73 74 61 74 65 2c 20 62 75 74 20 74 68 65 s state, but the
2510: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
2520: 20 6e 6f 74 20 77 72 69 74 74 65 6e 20 74 6f 20 not written to
2530: 6f 72 20 6f 70 65 6e 65 64 20 0a 2a 2a 20 20 20 or opened .**
2540: 20 74 6f 20 69 6e 20 74 68 69 73 20 73 74 61 74 to in this stat
2550: 65 2e 20 49 66 20 74 68 65 20 74 72 61 6e 73 61 e. If the transa
2560: 63 74 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 ction is committ
2570: 65 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 ed or rolled bac
2580: 6b 20 77 68 69 6c 65 20 0a 2a 2a 20 20 20 20 69 k while .** i
2590: 6e 20 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 n WRITER_LOCKED
25a0: 73 74 61 74 65 2c 20 61 6c 6c 20 74 68 61 74 20 state, all that
25b0: 69 73 20 72 65 71 75 69 72 65 64 20 69 73 20 74 is required is t
25c0: 6f 20 75 6e 6c 6f 63 6b 20 74 68 65 20 64 61 74 o unlock the dat
25d0: 61 62 61 73 65 20 0a 2a 2a 20 20 20 20 66 69 6c abase .** fil
25e0: 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 49 4e 20 57 e..**.** IN W
25f0: 41 4c 20 6d 6f 64 65 2c 20 57 61 6c 42 65 67 69 AL mode, WalBegi
2600: 6e 57 72 69 74 65 54 72 61 6e 73 61 63 74 69 6f nWriteTransactio
2610: 6e 28 29 20 69 73 20 63 61 6c 6c 65 64 20 74 6f n() is called to
2620: 20 6c 6f 63 6b 20 74 68 65 20 6c 6f 67 20 66 69 lock the log fi
2630: 6c 65 2e 0a 2a 2a 20 20 20 20 49 66 20 74 68 65 le..** If the
2640: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 72 connection is r
2650: 75 6e 6e 69 6e 67 20 77 69 74 68 20 6c 6f 63 6b unning with lock
2660: 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 ing_mode=exclusi
2670: 76 65 2c 20 61 6e 20 61 74 74 65 6d 70 74 0a 2a ve, an attempt.*
2680: 2a 20 20 20 20 69 73 20 6d 61 64 65 20 74 6f 20 * is made to
2690: 6f 62 74 61 69 6e 20 61 6e 20 45 58 43 4c 55 53 obtain an EXCLUS
26a0: 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 IVE lock on the
26b0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
26c0: 2a 0a 2a 2a 20 20 20 20 2a 20 41 20 77 72 69 74 *.** * A writ
26d0: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 e transaction is
26e0: 20 61 63 74 69 76 65 2e 0a 2a 2a 20 20 20 20 2a active..** *
26f0: 20 49 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 If the connecti
2700: 6f 6e 20 69 73 20 6f 70 65 6e 20 69 6e 20 72 6f on is open in ro
2710: 6c 6c 62 61 63 6b 2d 6d 6f 64 65 2c 20 61 20 52 llback-mode, a R
2720: 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 61 74 ESERVED or great
2730: 65 72 20 0a 2a 2a 20 20 20 20 20 20 6c 6f 63 6b er .** lock
2740: 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 is held on the
2750: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a database file..*
2760: 2a 20 20 20 20 2a 20 49 66 20 74 68 65 20 63 6f * * If the co
2770: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e nnection is open
2780: 20 69 6e 20 57 41 4c 2d 6d 6f 64 65 2c 20 61 20 in WAL-mode, a
2790: 57 41 4c 20 77 72 69 74 65 20 74 72 61 6e 73 61 WAL write transa
27a0: 63 74 69 6f 6e 0a 2a 2a 20 20 20 20 20 20 69 73 ction.** is
27b0: 20 6f 70 65 6e 20 28 69 2e 65 2e 20 73 71 6c 69 open (i.e. sqli
27c0: 74 65 33 57 61 6c 42 65 67 69 6e 57 72 69 74 65 te3WalBeginWrite
27d0: 54 72 61 6e 73 61 63 74 69 6f 6e 28 29 20 68 61 Transaction() ha
27e0: 73 20 62 65 65 6e 20 73 75 63 63 65 73 73 66 75 s been successfu
27f0: 6c 6c 79 0a 2a 2a 20 20 20 20 20 20 63 61 6c 6c lly.** call
2800: 65 64 29 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 ed)..** * The
2810: 20 64 62 53 69 7a 65 2c 20 64 62 4f 72 69 67 53 dbSize, dbOrigS
2820: 69 7a 65 20 61 6e 64 20 64 62 46 69 6c 65 53 69 ize and dbFileSi
2830: 7a 65 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 ze variables are
2840: 20 61 6c 6c 20 76 61 6c 69 64 2e 0a 2a 2a 20 20 all valid..**
2850: 20 20 2a 20 54 68 65 20 63 6f 6e 74 65 6e 74 73 * The contents
2860: 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 63 61 of the pager ca
2870: 63 68 65 20 68 61 76 65 20 6e 6f 74 20 62 65 65 che have not bee
2880: 6e 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2a 20 20 n modified..**
2890: 20 20 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 * The journal
28a0: 66 69 6c 65 20 6d 61 79 20 6f 72 20 6d 61 79 20 file may or may
28b0: 6e 6f 74 20 62 65 20 6f 70 65 6e 2e 0a 2a 2a 20 not be open..**
28c0: 20 20 20 2a 20 4e 6f 74 68 69 6e 67 20 28 6e 6f * Nothing (no
28d0: 74 20 65 76 65 6e 20 74 68 65 20 66 69 72 73 74 t even the first
28e0: 20 68 65 61 64 65 72 29 20 68 61 73 20 62 65 65 header) has bee
28f0: 6e 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 n written to the
2900: 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 journal..**.**
2910: 20 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 WRITER_CACHEMOD
2920: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 41 20 70 61 67 :.**.** A pag
2930: 65 72 20 6d 6f 76 65 73 20 66 72 6f 6d 20 57 52 er moves from WR
2940: 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 74 ITER_LOCKED stat
2950: 65 20 74 6f 20 74 68 69 73 20 73 74 61 74 65 20 e to this state
2960: 77 68 65 6e 20 61 20 70 61 67 65 20 69 73 0a 2a when a page is.*
2970: 2a 20 20 20 20 66 69 72 73 74 20 6d 6f 64 69 66 * first modif
2980: 69 65 64 20 62 79 20 74 68 65 20 75 70 70 65 72 ied by the upper
2990: 20 6c 61 79 65 72 2e 20 49 6e 20 72 6f 6c 6c 62 layer. In rollb
29a0: 61 63 6b 20 6d 6f 64 65 20 74 68 65 20 6a 6f 75 ack mode the jou
29b0: 72 6e 61 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 20 rnal file.**
29c0: 69 73 20 6f 70 65 6e 65 64 20 28 69 66 20 69 74 is opened (if it
29d0: 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 is not already
29e0: 6f 70 65 6e 29 20 61 6e 64 20 61 20 68 65 61 64 open) and a head
29f0: 65 72 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 er written to th
2a00: 65 0a 2a 2a 20 20 20 20 73 74 61 72 74 20 6f 66 e.** start of
2a10: 20 69 74 2e 20 54 68 65 20 64 61 74 61 62 61 73 it. The databas
2a20: 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 20 68 e file on disk h
2a30: 61 73 20 6e 6f 74 20 62 65 65 6e 20 6d 6f 64 69 as not been modi
2a40: 66 69 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 2a fied..**.** *
2a50: 20 41 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 A write transac
2a60: 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2e 0a tion is active..
2a70: 2a 2a 20 20 20 20 2a 20 41 20 52 45 53 45 52 56 ** * A RESERV
2a80: 45 44 20 6f 72 20 67 72 65 61 74 65 72 20 6c 6f ED or greater lo
2a90: 63 6b 20 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 ck is held on th
2aa0: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e e database file.
2ab0: 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 6a 6f 75 .** * The jou
2ac0: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 rnal file is ope
2ad0: 6e 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 20 n and the first
2ae0: 68 65 61 64 65 72 20 68 61 73 20 62 65 65 6e 20 header has been
2af0: 77 72 69 74 74 65 6e 20 0a 2a 2a 20 20 20 20 20 written .**
2b00: 20 74 6f 20 69 74 2c 20 62 75 74 20 74 68 65 20 to it, but the
2b10: 68 65 61 64 65 72 20 68 61 73 20 6e 6f 74 20 62 header has not b
2b20: 65 65 6e 20 73 79 6e 63 65 64 20 74 6f 20 64 69 een synced to di
2b30: 73 6b 2e 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 sk..** * The
2b40: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
2b50: 70 61 67 65 20 63 61 63 68 65 20 68 61 76 65 20 page cache have
2b60: 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 2e 0a 2a been modified..*
2b70: 2a 0a 2a 2a 20 20 57 52 49 54 45 52 5f 44 42 4d *.** WRITER_DBM
2b80: 4f 44 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 54 68 65 OD:.**.** The
2b90: 20 70 61 67 65 72 20 74 72 61 6e 73 69 74 69 6f pager transitio
2ba0: 6e 73 20 66 72 6f 6d 20 57 52 49 54 45 52 5f 43 ns from WRITER_C
2bb0: 41 43 48 45 4d 4f 44 20 69 6e 74 6f 20 57 52 49 ACHEMOD into WRI
2bc0: 54 45 52 5f 44 42 4d 4f 44 20 73 74 61 74 65 0a TER_DBMOD state.
2bd0: 2a 2a 20 20 20 20 77 68 65 6e 20 69 74 20 6d 6f ** when it mo
2be0: 64 69 66 69 65 73 20 74 68 65 20 63 6f 6e 74 65 difies the conte
2bf0: 6e 74 73 20 6f 66 20 74 68 65 20 64 61 74 61 62 nts of the datab
2c00: 61 73 65 20 66 69 6c 65 2e 20 57 41 4c 20 63 6f ase file. WAL co
2c10: 6e 6e 65 63 74 69 6f 6e 73 0a 2a 2a 20 20 20 20 nnections.**
2c20: 6e 65 76 65 72 20 65 6e 74 65 72 20 74 68 69 73 never enter this
2c30: 20 73 74 61 74 65 20 28 73 69 6e 63 65 20 74 68 state (since th
2c40: 65 79 20 64 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 ey do not modify
2c50: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
2c60: 6c 65 2c 0a 2a 2a 20 20 20 20 6a 75 73 74 20 74 le,.** just t
2c70: 68 65 20 6c 6f 67 20 66 69 6c 65 29 2e 0a 2a 2a he log file)..**
2c80: 0a 2a 2a 20 20 20 20 2a 20 41 20 77 72 69 74 65 .** * A write
2c90: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
2ca0: 61 63 74 69 76 65 2e 0a 2a 2a 20 20 20 20 2a 20 active..** *
2cb0: 41 6e 20 45 58 43 4c 55 53 49 56 45 20 6f 72 20 An EXCLUSIVE or
2cc0: 67 72 65 61 74 65 72 20 6c 6f 63 6b 20 69 73 20 greater lock is
2cd0: 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 61 held on the data
2ce0: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 base file..**
2cf0: 20 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 * The journal f
2d00: 69 6c 65 20 69 73 20 6f 70 65 6e 20 61 6e 64 20 ile is open and
2d10: 74 68 65 20 66 69 72 73 74 20 68 65 61 64 65 72 the first header
2d20: 20 68 61 73 20 62 65 65 6e 20 77 72 69 74 74 65 has been writte
2d30: 6e 20 0a 2a 2a 20 20 20 20 20 20 61 6e 64 20 73 n .** and s
2d40: 79 6e 63 65 64 20 74 6f 20 64 69 73 6b 2e 0a 2a ynced to disk..*
2d50: 2a 20 20 20 20 2a 20 54 68 65 20 63 6f 6e 74 65 * * The conte
2d60: 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 nts of the page
2d70: 63 61 63 68 65 20 68 61 76 65 20 62 65 65 6e 20 cache have been
2d80: 6d 6f 64 69 66 69 65 64 20 28 61 6e 64 20 70 6f modified (and po
2d90: 73 73 69 62 6c 79 0a 2a 2a 20 20 20 20 20 20 77 ssibly.** w
2da0: 72 69 74 74 65 6e 20 74 6f 20 64 69 73 6b 29 2e ritten to disk).
2db0: 0a 2a 2a 0a 2a 2a 20 20 57 52 49 54 45 52 5f 46 .**.** WRITER_F
2dc0: 49 4e 49 53 48 45 44 3a 0a 2a 2a 0a 2a 2a 20 20 INISHED:.**.**
2dd0: 20 20 49 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 It is not poss
2de0: 69 62 6c 65 20 66 6f 72 20 61 20 57 41 4c 20 63 ible for a WAL c
2df0: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 65 6e 74 onnection to ent
2e00: 65 72 20 74 68 69 73 20 73 74 61 74 65 2e 0a 2a er this state..*
2e10: 2a 0a 2a 2a 20 20 20 20 41 20 72 6f 6c 6c 62 61 *.** A rollba
2e20: 63 6b 2d 6d 6f 64 65 20 70 61 67 65 72 20 63 68 ck-mode pager ch
2e30: 61 6e 67 65 73 20 74 6f 20 57 52 49 54 45 52 5f anges to WRITER_
2e40: 46 49 4e 49 53 48 45 44 20 73 74 61 74 65 20 66 FINISHED state f
2e50: 72 6f 6d 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 rom WRITER_DBMOD
2e60: 0a 2a 2a 20 20 20 20 73 74 61 74 65 20 61 66 74 .** state aft
2e70: 65 72 20 74 68 65 20 65 6e 74 69 72 65 20 74 72 er the entire tr
2e80: 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 62 65 ansaction has be
2e90: 65 6e 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 en successfully
2ea0: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
2eb0: 0a 2a 2a 20 20 20 20 64 61 74 61 62 61 73 65 20 .** database
2ec0: 66 69 6c 65 2e 20 49 6e 20 74 68 69 73 20 73 74 file. In this st
2ed0: 61 74 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 ate the transact
2ee0: 69 6f 6e 20 6d 61 79 20 62 65 20 63 6f 6d 6d 69 ion may be commi
2ef0: 74 74 65 64 20 73 69 6d 70 6c 79 0a 2a 2a 20 20 tted simply.**
2f00: 20 20 62 79 20 66 69 6e 61 6c 69 7a 69 6e 67 20 by finalizing
2f10: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
2f20: 2e 20 4f 6e 63 65 20 69 6e 20 57 52 49 54 45 52 . Once in WRITER
2f30: 5f 46 49 4e 49 53 48 45 44 20 73 74 61 74 65 2c _FINISHED state,
2f40: 20 69 74 20 69 73 20 0a 2a 2a 20 20 20 20 6e 6f it is .** no
2f50: 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 6d 6f t possible to mo
2f60: 64 69 66 79 20 74 68 65 20 64 61 74 61 62 61 73 dify the databas
2f70: 65 20 66 75 72 74 68 65 72 2e 20 41 74 20 74 68 e further. At th
2f80: 69 73 20 70 6f 69 6e 74 2c 20 74 68 65 20 75 70 is point, the up
2f90: 70 65 72 20 0a 2a 2a 20 20 20 20 6c 61 79 65 72 per .** layer
2fa0: 20 6d 75 73 74 20 65 69 74 68 65 72 20 63 6f 6d must either com
2fb0: 6d 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 mit or rollback
2fc0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e the transaction.
2fd0: 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 41 20 77 72 .**.** * A wr
2fe0: 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite transaction
2ff0: 69 73 20 61 63 74 69 76 65 2e 0a 2a 2a 20 20 20 is active..**
3000: 20 2a 20 41 6e 20 45 58 43 4c 55 53 49 56 45 20 * An EXCLUSIVE
3010: 6f 72 20 67 72 65 61 74 65 72 20 6c 6f 63 6b 20 or greater lock
3020: 69 73 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 is held on the d
3030: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a atabase file..**
3040: 20 20 20 20 2a 20 41 6c 6c 20 77 72 69 74 69 6e * All writin
3050: 67 20 61 6e 64 20 73 79 6e 63 69 6e 67 20 6f 66 g and syncing of
3060: 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 64 61 74 journal and dat
3070: 61 62 61 73 65 20 64 61 74 61 20 68 61 73 20 66 abase data has f
3080: 69 6e 69 73 68 65 64 2e 0a 2a 2a 20 20 20 20 20 inished..**
3090: 20 49 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 If no error occ
30a0: 75 72 72 65 64 2c 20 61 6c 6c 20 74 68 61 74 20 urred, all that
30b0: 72 65 6d 61 69 6e 73 20 69 73 20 74 6f 20 66 69 remains is to fi
30c0: 6e 61 6c 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e nalize the journ
30d0: 61 6c 20 74 6f 0a 2a 2a 20 20 20 20 20 20 63 6f al to.** co
30e0: 6d 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 mmit the transac
30f0: 74 69 6f 6e 2e 20 49 66 20 61 6e 20 65 72 72 6f tion. If an erro
3100: 72 20 64 69 64 20 6f 63 63 75 72 2c 20 74 68 65 r did occur, the
3110: 20 63 61 6c 6c 65 72 20 77 69 6c 6c 20 6e 65 65 caller will nee
3120: 64 0a 2a 2a 20 20 20 20 20 20 74 6f 20 72 6f 6c d.** to rol
3130: 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 61 lback the transa
3140: 63 74 69 6f 6e 2e 20 0a 2a 2a 0a 2a 2a 20 20 45 ction. .**.** E
3150: 52 52 4f 52 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 54 RROR:.**.** T
3160: 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 20 69 he ERROR state i
3170: 73 20 65 6e 74 65 72 65 64 20 77 68 65 6e 20 61 s entered when a
3180: 6e 20 49 4f 20 6f 72 20 64 69 73 6b 2d 66 75 6c n IO or disk-ful
3190: 6c 20 65 72 72 6f 72 20 28 69 6e 63 6c 75 64 69 l error (includi
31a0: 6e 67 0a 2a 2a 20 20 20 20 53 51 4c 49 54 45 5f ng.** SQLITE_
31b0: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 29 20 6f 63 63 IOERR_NOMEM) occ
31c0: 75 72 73 20 61 74 20 61 20 70 6f 69 6e 74 20 69 urs at a point i
31d0: 6e 20 74 68 65 20 63 6f 64 65 20 74 68 61 74 20 n the code that
31e0: 6d 61 6b 65 73 20 69 74 20 0a 2a 2a 20 20 20 20 makes it .**
31f0: 64 69 66 66 69 63 75 6c 74 20 74 6f 20 62 65 20 difficult to be
3200: 73 75 72 65 20 74 68 61 74 20 74 68 65 20 69 6e sure that the in
3210: 2d 6d 65 6d 6f 72 79 20 70 61 67 65 72 20 73 74 -memory pager st
3220: 61 74 65 20 28 63 61 63 68 65 20 63 6f 6e 74 65 ate (cache conte
3230: 6e 74 73 2c 20 0a 2a 2a 20 20 20 20 64 62 20 73 nts, .** db s
3240: 69 7a 65 20 65 74 63 2e 29 20 61 72 65 20 63 6f ize etc.) are co
3250: 6e 73 69 73 74 65 6e 74 20 77 69 74 68 20 74 68 nsistent with th
3260: 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 e contents of th
3270: 65 20 66 69 6c 65 2d 73 79 73 74 65 6d 2e 0a 2a e file-system..*
3280: 2a 0a 2a 2a 20 20 20 20 54 65 6d 70 6f 72 61 72 *.** Temporar
3290: 79 20 70 61 67 65 72 20 66 69 6c 65 73 20 6d 61 y pager files ma
32a0: 79 20 65 6e 74 65 72 20 74 68 65 20 45 52 52 4f y enter the ERRO
32b0: 52 20 73 74 61 74 65 2c 20 62 75 74 20 69 6e 2d R state, but in-
32c0: 6d 65 6d 6f 72 79 20 70 61 67 65 72 73 0a 2a 2a memory pagers.**
32d0: 20 20 20 20 63 61 6e 6e 6f 74 2e 0a 2a 2a 0a 2a cannot..**.*
32e0: 2a 20 20 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 * For example
32f0: 2c 20 69 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 , if an IO error
3300: 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 70 65 occurs while pe
3310: 72 66 6f 72 6d 69 6e 67 20 61 20 72 6f 6c 6c 62 rforming a rollb
3320: 61 63 6b 2c 20 0a 2a 2a 20 20 20 20 74 68 65 20 ack, .** the
3330: 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 contents of the
3340: 70 61 67 65 2d 63 61 63 68 65 20 6d 61 79 20 62 page-cache may b
3350: 65 20 6c 65 66 74 20 69 6e 20 61 6e 20 69 6e 63 e left in an inc
3360: 6f 6e 73 69 73 74 65 6e 74 20 73 74 61 74 65 2e onsistent state.
3370: 0a 2a 2a 20 20 20 20 41 74 20 74 68 69 73 20 70 .** At this p
3380: 6f 69 6e 74 20 69 74 20 77 6f 75 6c 64 20 62 65 oint it would be
3390: 20 64 61 6e 67 65 72 6f 75 73 20 74 6f 20 63 68 dangerous to ch
33a0: 61 6e 67 65 20 62 61 63 6b 20 74 6f 20 52 45 41 ange back to REA
33b0: 44 45 52 20 73 74 61 74 65 0a 2a 2a 20 20 20 20 DER state.**
33c0: 28 61 73 20 75 73 75 61 6c 6c 79 20 68 61 70 70 (as usually happ
33d0: 65 6e 73 20 61 66 74 65 72 20 61 20 72 6f 6c 6c ens after a roll
33e0: 62 61 63 6b 29 2e 20 41 6e 79 20 73 75 62 73 65 back). Any subse
33f0: 71 75 65 6e 74 20 72 65 61 64 65 72 73 20 6d 69 quent readers mi
3400: 67 68 74 0a 2a 2a 20 20 20 20 72 65 70 6f 72 74 ght.** report
3410: 20 64 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 database corrup
3420: 74 69 6f 6e 20 28 64 75 65 20 74 6f 20 74 68 65 tion (due to the
3430: 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 63 61 inconsistent ca
3440: 63 68 65 29 2c 20 61 6e 64 20 69 66 0a 2a 2a 20 che), and if.**
3450: 20 20 20 74 68 65 79 20 75 70 67 72 61 64 65 20 they upgrade
3460: 74 6f 20 77 72 69 74 65 72 73 2c 20 74 68 65 79 to writers, they
3470: 20 6d 61 79 20 69 6e 61 64 76 65 72 74 65 6e 74 may inadvertent
3480: 6c 79 20 63 6f 72 72 75 70 74 20 74 68 65 20 64 ly corrupt the d
3490: 61 74 61 62 61 73 65 0a 2a 2a 20 20 20 20 66 69 atabase.** fi
34a0: 6c 65 2e 20 54 6f 20 61 76 6f 69 64 20 74 68 69 le. To avoid thi
34b0: 73 20 68 61 7a 61 72 64 2c 20 74 68 65 20 70 61 s hazard, the pa
34c0: 67 65 72 20 73 77 69 74 63 68 65 73 20 69 6e 74 ger switches int
34d0: 6f 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 o the ERROR stat
34e0: 65 0a 2a 2a 20 20 20 20 69 6e 73 74 65 61 64 20 e.** instead
34f0: 6f 66 20 52 45 41 44 45 52 20 66 6f 6c 6c 6f 77 of READER follow
3500: 69 6e 67 20 73 75 63 68 20 61 6e 20 65 72 72 6f ing such an erro
3510: 72 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 4f 6e 63 65 r..**.** Once
3520: 20 69 74 20 68 61 73 20 65 6e 74 65 72 65 64 20 it has entered
3530: 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 2c the ERROR state,
3540: 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20 any attempt to
3550: 75 73 65 20 74 68 65 20 70 61 67 65 72 0a 2a 2a use the pager.**
3560: 20 20 20 20 74 6f 20 72 65 61 64 20 6f 72 20 77 to read or w
3570: 72 69 74 65 20 64 61 74 61 20 72 65 74 75 72 6e rite data return
3580: 73 20 61 6e 20 65 72 72 6f 72 2e 20 45 76 65 6e s an error. Even
3590: 74 75 61 6c 6c 79 2c 20 6f 6e 63 65 20 61 6c 6c tually, once all
35a0: 20 0a 2a 2a 20 20 20 20 6f 75 74 73 74 61 6e 64 .** outstand
35b0: 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 ing transactions
35c0: 20 68 61 76 65 20 62 65 65 6e 20 61 62 61 6e 64 have been aband
35d0: 6f 6e 65 64 2c 20 74 68 65 20 70 61 67 65 72 20 oned, the pager
35e0: 69 73 20 61 62 6c 65 20 74 6f 0a 2a 2a 20 20 20 is able to.**
35f0: 20 74 72 61 6e 73 69 74 69 6f 6e 20 62 61 63 6b transition back
3600: 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2c 20 to OPEN state,
3610: 64 69 73 63 61 72 64 69 6e 67 20 74 68 65 20 63 discarding the c
3620: 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 0a ontents of the .
3630: 2a 2a 20 20 20 20 70 61 67 65 2d 63 61 63 68 65 ** page-cache
3640: 20 61 6e 64 20 61 6e 79 20 6f 74 68 65 72 20 69 and any other i
3650: 6e 2d 6d 65 6d 6f 72 79 20 73 74 61 74 65 20 61 n-memory state a
3660: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e t the same time.
3670: 20 45 76 65 72 79 74 68 69 6e 67 0a 2a 2a 20 20 Everything.**
3680: 20 20 69 73 20 72 65 6c 6f 61 64 65 64 20 66 72 is reloaded fr
3690: 6f 6d 20 64 69 73 6b 20 28 61 6e 64 2c 20 69 66 om disk (and, if
36a0: 20 6e 65 63 65 73 73 61 72 79 2c 20 68 6f 74 2d necessary, hot-
36b0: 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b journal rollback
36c0: 20 70 65 66 6f 72 6d 65 64 29 0a 2a 2a 20 20 20 peformed).**
36d0: 20 77 68 65 6e 20 61 20 72 65 61 64 2d 74 72 61 when a read-tra
36e0: 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 65 78 74 nsaction is next
36f0: 20 6f 70 65 6e 65 64 20 6f 6e 20 74 68 65 20 70 opened on the p
3700: 61 67 65 72 20 28 74 72 61 6e 73 69 74 69 6f 6e ager (transition
3710: 69 6e 67 0a 2a 2a 20 20 20 20 74 68 65 20 70 61 ing.** the pa
3720: 67 65 72 20 69 6e 74 6f 20 52 45 41 44 45 52 20 ger into READER
3730: 73 74 61 74 65 29 2e 20 41 74 20 74 68 61 74 20 state). At that
3740: 70 6f 69 6e 74 20 74 68 65 20 73 79 73 74 65 6d point the system
3750: 20 68 61 73 20 72 65 63 6f 76 65 72 65 64 20 0a has recovered .
3760: 2a 2a 20 20 20 20 66 72 6f 6d 20 74 68 65 20 65 ** from the e
3770: 72 72 6f 72 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 53 rror..**.** S
3780: 70 65 63 69 66 69 63 61 6c 6c 79 2c 20 74 68 65 pecifically, the
3790: 20 70 61 67 65 72 20 6a 75 6d 70 73 20 69 6e 74 pager jumps int
37a0: 6f 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 o the ERROR stat
37b0: 65 20 69 66 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 e if:.**.**
37c0: 20 31 2e 20 41 6e 20 65 72 72 6f 72 20 6f 63 63 1. An error occ
37d0: 75 72 73 20 77 68 69 6c 65 20 61 74 74 65 6d 70 urs while attemp
37e0: 74 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 6b 2e ting a rollback.
37f0: 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 69 6e This happens in
3800: 0a 2a 2a 20 20 20 20 20 20 20 20 20 66 75 6e 63 .** func
3810: 74 69 6f 6e 20 73 71 6c 69 74 65 33 50 61 67 65 tion sqlite3Page
3820: 72 52 6f 6c 6c 62 61 63 6b 28 29 2e 0a 2a 2a 0a rRollback()..**.
3830: 2a 2a 20 20 20 20 20 20 32 2e 20 41 6e 20 65 72 ** 2. An er
3840: 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 ror occurs while
3850: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 66 attempting to f
3860: 69 6e 61 6c 69 7a 65 20 61 20 6a 6f 75 72 6e 61 inalize a journa
3870: 6c 20 66 69 6c 65 0a 2a 2a 20 20 20 20 20 20 20 l file.**
3880: 20 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 63 6f following a co
3890: 6d 6d 69 74 20 69 6e 20 66 75 6e 63 74 69 6f 6e mmit in function
38a0: 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6f 6d sqlite3PagerCom
38b0: 6d 69 74 50 68 61 73 65 54 77 6f 28 29 2e 0a 2a mitPhaseTwo()..*
38c0: 2a 0a 2a 2a 20 20 20 20 20 20 33 2e 20 41 6e 20 *.** 3. An
38d0: 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 error occurs whi
38e0: 6c 65 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f le attempting to
38f0: 20 77 72 69 74 65 20 74 6f 20 74 68 65 20 6a 6f write to the jo
3900: 75 72 6e 61 6c 20 6f 72 0a 2a 2a 20 20 20 20 20 urnal or.**
3910: 20 20 20 20 64 61 74 61 62 61 73 65 20 66 69 6c database fil
3920: 65 20 69 6e 20 66 75 6e 63 74 69 6f 6e 20 70 61 e in function pa
3930: 67 65 72 53 74 72 65 73 73 28 29 20 69 6e 20 6f gerStress() in o
3940: 72 64 65 72 20 74 6f 20 66 72 65 65 20 75 70 0a rder to free up.
3950: 2a 2a 20 20 20 20 20 20 20 20 20 6d 65 6d 6f 72 ** memor
3960: 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 49 6e 20 6f y..**.** In o
3970: 74 68 65 72 20 63 61 73 65 73 2c 20 74 68 65 20 ther cases, the
3980: 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 error is returne
3990: 64 20 74 6f 20 74 68 65 20 62 2d 74 72 65 65 20 d to the b-tree
39a0: 6c 61 79 65 72 2e 20 54 68 65 20 62 2d 74 72 65 layer. The b-tre
39b0: 65 0a 2a 2a 20 20 20 20 6c 61 79 65 72 20 74 68 e.** layer th
39c0: 65 6e 20 61 74 74 65 6d 70 74 73 20 61 20 72 6f en attempts a ro
39d0: 6c 6c 62 61 63 6b 20 6f 70 65 72 61 74 69 6f 6e llback operation
39e0: 2e 20 49 66 20 74 68 65 20 65 72 72 6f 72 20 63 . If the error c
39f0: 6f 6e 64 69 74 69 6f 6e 20 0a 2a 2a 20 20 20 20 ondition .**
3a00: 70 65 72 73 69 73 74 73 2c 20 74 68 65 20 70 61 persists, the pa
3a10: 67 65 72 20 65 6e 74 65 72 73 20 74 68 65 20 45 ger enters the E
3a20: 52 52 4f 52 20 73 74 61 74 65 20 76 69 61 20 63 RROR state via c
3a30: 6f 6e 64 69 74 69 6f 6e 20 28 31 29 20 61 62 6f ondition (1) abo
3a40: 76 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 43 6f 6e ve..**.** Con
3a50: 64 69 74 69 6f 6e 20 28 33 29 20 69 73 20 6e 65 dition (3) is ne
3a60: 63 65 73 73 61 72 79 20 62 65 63 61 75 73 65 20 cessary because
3a70: 69 74 20 63 61 6e 20 62 65 20 74 72 69 67 67 65 it can be trigge
3a80: 72 65 64 20 62 79 20 61 20 72 65 61 64 2d 6f 6e red by a read-on
3a90: 6c 79 0a 2a 2a 20 20 20 20 73 74 61 74 65 6d 65 ly.** stateme
3aa0: 6e 74 20 65 78 65 63 75 74 65 64 20 77 69 74 68 nt executed with
3ab0: 69 6e 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e in a transaction
3ac0: 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 . In this case,
3ad0: 69 66 20 74 68 65 20 65 72 72 6f 72 0a 2a 2a 20 if the error.**
3ae0: 20 20 20 63 6f 64 65 20 77 65 72 65 20 73 69 6d code were sim
3af0: 70 6c 79 20 72 65 74 75 72 6e 65 64 20 74 6f 20 ply returned to
3b00: 74 68 65 20 75 73 65 72 2c 20 74 68 65 20 62 2d the user, the b-
3b10: 74 72 65 65 20 6c 61 79 65 72 20 77 6f 75 6c 64 tree layer would
3b20: 20 6e 6f 74 0a 2a 2a 20 20 20 20 61 75 74 6f 6d not.** autom
3b30: 61 74 69 63 61 6c 6c 79 20 61 74 74 65 6d 70 74 atically attempt
3b40: 20 61 20 72 6f 6c 6c 62 61 63 6b 2c 20 61 73 20 a rollback, as
3b50: 69 74 20 61 73 73 75 6d 65 73 20 74 68 61 74 20 it assumes that
3b60: 61 6e 20 65 72 72 6f 72 20 69 6e 20 61 0a 2a 2a an error in a.**
3b70: 20 20 20 20 72 65 61 64 2d 6f 6e 6c 79 20 73 74 read-only st
3b80: 61 74 65 6d 65 6e 74 20 63 61 6e 6e 6f 74 20 6c atement cannot l
3b90: 65 61 76 65 20 74 68 65 20 70 61 67 65 72 20 69 eave the pager i
3ba0: 6e 20 61 6e 20 69 6e 74 65 72 6e 61 6c 6c 79 20 n an internally
3bb0: 69 6e 63 6f 6e 73 69 73 74 65 6e 74 20 0a 2a 2a inconsistent .**
3bc0: 20 20 20 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a state..**.**
3bd0: 20 20 20 20 2a 20 54 68 65 20 50 61 67 65 72 2e * The Pager.
3be0: 65 72 72 43 6f 64 65 20 76 61 72 69 61 62 6c 65 errCode variable
3bf0: 20 69 73 20 73 65 74 20 74 6f 20 73 6f 6d 65 74 is set to somet
3c00: 68 69 6e 67 20 6f 74 68 65 72 20 74 68 61 6e 20 hing other than
3c10: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2a 20 20 20 SQLITE_OK..**
3c20: 20 2a 20 54 68 65 72 65 20 61 72 65 20 6f 6e 65 * There are one
3c30: 20 6f 72 20 6d 6f 72 65 20 6f 75 74 73 74 61 6e or more outstan
3c40: 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 ding references
3c50: 74 6f 20 70 61 67 65 73 20 28 61 66 74 65 72 20 to pages (after
3c60: 74 68 65 0a 2a 2a 20 20 20 20 20 20 6c 61 73 74 the.** last
3c70: 20 72 65 66 65 72 65 6e 63 65 20 69 73 20 64 72 reference is dr
3c80: 6f 70 70 65 64 20 74 68 65 20 70 61 67 65 72 20 opped the pager
3c90: 73 68 6f 75 6c 64 20 6d 6f 76 65 20 62 61 63 6b should move back
3ca0: 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 29 2e to OPEN state).
3cb0: 0a 2a 2a 20 20 20 20 2a 20 54 68 65 20 70 61 67 .** * The pag
3cc0: 65 72 20 69 73 20 6e 6f 74 20 61 6e 20 69 6e 2d er is not an in-
3cd0: 6d 65 6d 6f 72 79 20 70 61 67 65 72 2e 0a 2a 2a memory pager..**
3ce0: 20 20 20 20 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 73 .**.** Notes
3cf0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 41 20 70 61 :.**.** * A pa
3d00: 67 65 72 20 69 73 20 6e 65 76 65 72 20 69 6e 20 ger is never in
3d10: 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 6f 72 20 WRITER_DBMOD or
3d20: 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 WRITER_FINISHED
3d30: 73 74 61 74 65 20 69 66 20 74 68 65 0a 2a 2a 20 state if the.**
3d40: 20 20 20 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 connection i
3d50: 73 20 6f 70 65 6e 20 69 6e 20 57 41 4c 20 6d 6f s open in WAL mo
3d60: 64 65 2e 20 41 20 57 41 4c 20 63 6f 6e 6e 65 63 de. A WAL connec
3d70: 74 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 20 69 tion is always i
3d80: 6e 20 6f 6e 65 0a 2a 2a 20 20 20 20 20 6f 66 20 n one.** of
3d90: 74 68 65 20 66 69 72 73 74 20 66 6f 75 72 20 73 the first four s
3da0: 74 61 74 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a tates..**.** *
3db0: 20 4e 6f 72 6d 61 6c 6c 79 2c 20 61 20 63 6f 6e Normally, a con
3dc0: 6e 65 63 74 69 6f 6e 20 6f 70 65 6e 20 69 6e 20 nection open in
3dd0: 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 20 69 exclusive mode i
3de0: 73 20 6e 65 76 65 72 20 69 6e 20 50 41 47 45 52 s never in PAGER
3df0: 5f 4f 50 45 4e 0a 2a 2a 20 20 20 20 20 73 74 61 _OPEN.** sta
3e00: 74 65 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 te. There are tw
3e10: 6f 20 65 78 63 65 70 74 69 6f 6e 73 3a 20 69 6d o exceptions: im
3e20: 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 mediately after
3e30: 65 78 63 6c 75 73 69 76 65 2d 6d 6f 64 65 20 68 exclusive-mode h
3e40: 61 73 0a 2a 2a 20 20 20 20 20 62 65 65 6e 20 74 as.** been t
3e50: 75 72 6e 65 64 20 6f 6e 20 28 61 6e 64 20 62 65 urned on (and be
3e60: 66 6f 72 65 20 61 6e 79 20 72 65 61 64 20 6f 72 fore any read or
3e70: 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
3e80: 6f 6e 73 20 61 72 65 20 0a 2a 2a 20 20 20 20 20 ons are .**
3e90: 65 78 65 63 75 74 65 64 29 2c 20 61 6e 64 20 77 executed), and w
3ea0: 68 65 6e 20 74 68 65 20 70 61 67 65 72 20 69 73 hen the pager is
3eb0: 20 6c 65 61 76 69 6e 67 20 74 68 65 20 22 65 72 leaving the "er
3ec0: 72 6f 72 20 73 74 61 74 65 22 2e 0a 2a 2a 0a 2a ror state"..**.*
3ed0: 2a 20 20 20 2a 20 53 65 65 20 61 6c 73 6f 3a 20 * * See also:
3ee0: 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 assert_pager_sta
3ef0: 74 65 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 te()..*/.#define
3f00: 20 50 41 47 45 52 5f 4f 50 45 4e 20 20 20 20 20 PAGER_OPEN
3f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 23 0.#
3f20: 64 65 66 69 6e 65 20 50 41 47 45 52 5f 52 45 41 define PAGER_REA
3f30: 44 45 52 20 20 20 20 20 20 20 20 20 20 20 20 20 DER
3f40: 20 20 20 31 0a 23 64 65 66 69 6e 65 20 50 41 47 1.#define PAG
3f50: 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 44 ER_WRITER_LOCKED
3f60: 20 20 20 20 20 20 20 20 20 32 0a 23 64 65 66 69 2.#defi
3f70: 6e 65 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f ne PAGER_WRITER_
3f80: 43 41 43 48 45 4d 4f 44 20 20 20 20 20 20 20 33 CACHEMOD 3
3f90: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 57 .#define PAGER_W
3fa0: 52 49 54 45 52 5f 44 42 4d 4f 44 20 20 20 20 20 RITER_DBMOD
3fb0: 20 20 20 20 20 34 0a 23 64 65 66 69 6e 65 20 50 4.#define P
3fc0: 41 47 45 52 5f 57 52 49 54 45 52 5f 46 49 4e 49 AGER_WRITER_FINI
3fd0: 53 48 45 44 20 20 20 20 20 20 20 35 0a 23 64 65 SHED 5.#de
3fe0: 66 69 6e 65 20 50 41 47 45 52 5f 45 52 52 4f 52 fine PAGER_ERROR
3ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4000: 20 36 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 50 61 6../*.** The Pa
4010: 67 65 72 2e 65 4c 6f 63 6b 20 76 61 72 69 61 62 ger.eLock variab
4020: 6c 65 20 69 73 20 61 6c 6d 6f 73 74 20 61 6c 77 le is almost alw
4030: 61 79 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 6f ays set to one o
4040: 66 20 74 68 65 20 0a 2a 2a 20 66 6f 6c 6c 6f 77 f the .** follow
4050: 69 6e 67 20 6c 6f 63 6b 69 6e 67 2d 73 74 61 74 ing locking-stat
4060: 65 73 2c 20 61 63 63 6f 72 64 69 6e 67 20 74 6f es, according to
4070: 20 74 68 65 20 6c 6f 63 6b 20 63 75 72 72 65 6e the lock curren
4080: 74 6c 79 20 68 65 6c 64 20 6f 6e 0a 2a 2a 20 74 tly held on.** t
4090: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
40a0: 3a 20 4e 4f 5f 4c 4f 43 4b 2c 20 53 48 41 52 45 : NO_LOCK, SHARE
40b0: 44 5f 4c 4f 43 4b 2c 20 52 45 53 45 52 56 45 44 D_LOCK, RESERVED
40c0: 5f 4c 4f 43 4b 20 6f 72 20 45 58 43 4c 55 53 49 _LOCK or EXCLUSI
40d0: 56 45 5f 4c 4f 43 4b 2e 0a 2a 2a 20 54 68 69 73 VE_LOCK..** This
40e0: 20 76 61 72 69 61 62 6c 65 20 69 73 20 6b 65 70 variable is kep
40f0: 74 20 75 70 20 74 6f 20 64 61 74 65 20 61 73 20 t up to date as
4100: 6c 6f 63 6b 73 20 61 72 65 20 74 61 6b 65 6e 20 locks are taken
4110: 61 6e 64 20 72 65 6c 65 61 73 65 64 20 62 79 0a and released by.
4120: 2a 2a 20 74 68 65 20 70 61 67 65 72 4c 6f 63 6b ** the pagerLock
4130: 44 62 28 29 20 61 6e 64 20 70 61 67 65 72 55 6e Db() and pagerUn
4140: 6c 6f 63 6b 44 62 28 29 20 77 72 61 70 70 65 72 lockDb() wrapper
4150: 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 s..**.** If the
4160: 56 46 53 20 78 4c 6f 63 6b 28 29 20 6f 72 20 78 VFS xLock() or x
4170: 55 6e 6c 6f 63 6b 28 29 20 72 65 74 75 72 6e 73 Unlock() returns
4180: 20 61 6e 20 65 72 72 6f 72 20 6f 74 68 65 72 20 an error other
4190: 74 68 61 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 than SQLITE_BUSY
41a0: 0a 2a 2a 20 28 69 2e 65 2e 20 6f 6e 65 20 6f 66 .** (i.e. one of
41b0: 20 74 68 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 the SQLITE_IOER
41c0: 52 20 73 75 62 74 79 70 65 73 29 2c 20 69 74 20 R subtypes), it
41d0: 69 73 20 6e 6f 74 20 63 6c 65 61 72 20 77 68 65 is not clear whe
41e0: 74 68 65 72 20 6f 72 20 6e 6f 74 0a 2a 2a 20 74 ther or not.** t
41f0: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 77 61 73 he operation was
4200: 20 73 75 63 63 65 73 73 66 75 6c 2e 20 49 6e 20 successful. In
4210: 74 68 65 73 65 20 63 69 72 63 75 6d 73 74 61 6e these circumstan
4220: 63 65 73 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 ces pagerLockDb(
4230: 29 20 61 6e 64 0a 2a 2a 20 70 61 67 65 72 55 6e ) and.** pagerUn
4240: 6c 6f 63 6b 44 62 28 29 20 74 61 6b 65 20 61 20 lockDb() take a
4250: 63 6f 6e 73 65 72 76 61 74 69 76 65 20 61 70 70 conservative app
4260: 72 6f 61 63 68 20 2d 20 65 4c 6f 63 6b 20 69 73 roach - eLock is
4270: 20 61 6c 77 61 79 73 20 75 70 64 61 74 65 64 0a always updated.
4280: 2a 2a 20 77 68 65 6e 20 75 6e 6c 6f 63 6b 69 6e ** when unlockin
4290: 67 20 74 68 65 20 66 69 6c 65 2c 20 61 6e 64 20 g the file, and
42a0: 6f 6e 6c 79 20 75 70 64 61 74 65 64 20 77 68 65 only updated whe
42b0: 6e 20 6c 6f 63 6b 69 6e 67 20 74 68 65 20 66 69 n locking the fi
42c0: 6c 65 20 69 66 20 74 68 65 0a 2a 2a 20 56 46 53 le if the.** VFS
42d0: 20 63 61 6c 6c 20 69 73 20 73 75 63 63 65 73 73 call is success
42e0: 66 75 6c 2e 20 54 68 69 73 20 77 61 79 2c 20 74 ful. This way, t
42f0: 68 65 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 76 he Pager.eLock v
4300: 61 72 69 61 62 6c 65 20 6d 61 79 20 62 65 20 73 ariable may be s
4310: 65 74 0a 2a 2a 20 74 6f 20 61 20 6c 65 73 73 20 et.** to a less
4320: 65 78 63 6c 75 73 69 76 65 20 28 6c 6f 77 65 72 exclusive (lower
4330: 29 20 76 61 6c 75 65 20 74 68 61 6e 20 74 68 65 ) value than the
4340: 20 6c 6f 63 6b 20 74 68 61 74 20 69 73 20 61 63 lock that is ac
4350: 74 75 61 6c 6c 79 20 68 65 6c 64 0a 2a 2a 20 61 tually held.** a
4360: 74 20 74 68 65 20 73 79 73 74 65 6d 20 6c 65 76 t the system lev
4370: 65 6c 2c 20 62 75 74 20 69 74 20 69 73 20 6e 65 el, but it is ne
4380: 76 65 72 20 73 65 74 20 74 6f 20 61 20 6d 6f 72 ver set to a mor
4390: 65 20 65 78 63 6c 75 73 69 76 65 20 76 61 6c 75 e exclusive valu
43a0: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 e..**.** This is
43b0: 20 75 73 75 61 6c 6c 79 20 73 61 66 65 2e 20 49 usually safe. I
43c0: 66 20 61 6e 20 78 55 6e 6c 6f 63 6b 20 66 61 69 f an xUnlock fai
43d0: 6c 73 20 6f 72 20 61 70 70 65 61 72 73 20 74 6f ls or appears to
43e0: 20 66 61 69 6c 2c 20 74 68 65 72 65 20 6d 61 79 fail, there may
43f0: 20 0a 2a 2a 20 62 65 20 61 20 66 65 77 20 72 65 .** be a few re
4400: 64 75 6e 64 61 6e 74 20 78 4c 6f 63 6b 28 29 20 dundant xLock()
4410: 63 61 6c 6c 73 20 6f 72 20 61 20 6c 6f 63 6b 20 calls or a lock
4420: 6d 61 79 20 62 65 20 68 65 6c 64 20 66 6f 72 20 may be held for
4430: 6c 6f 6e 67 65 72 20 74 68 61 6e 0a 2a 2a 20 72 longer than.** r
4440: 65 71 75 69 72 65 64 2c 20 62 75 74 20 6e 6f 74 equired, but not
4450: 68 69 6e 67 20 72 65 61 6c 6c 79 20 67 6f 65 73 hing really goes
4460: 20 77 72 6f 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 wrong..**.** Th
4470: 65 20 65 78 63 65 70 74 69 6f 6e 20 69 73 20 77 e exception is w
4480: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 hen the database
4490: 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b 65 file is unlocke
44a0: 64 20 61 73 20 74 68 65 20 70 61 67 65 72 20 6d d as the pager m
44b0: 6f 76 65 73 0a 2a 2a 20 66 72 6f 6d 20 45 52 52 oves.** from ERR
44c0: 4f 52 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 OR to OPEN state
44d0: 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 . At this point
44e0: 74 68 65 72 65 20 6d 61 79 20 62 65 20 61 20 68 there may be a h
44f0: 6f 74 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 ot-journal file
4500: 0a 2a 2a 20 69 6e 20 74 68 65 20 66 69 6c 65 2d .** in the file-
4510: 73 79 73 74 65 6d 20 74 68 61 74 20 6e 65 65 64 system that need
4520: 73 20 74 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 s to be rolled b
4530: 61 63 6b 20 28 61 73 20 70 61 72 74 20 6f 66 20 ack (as part of
4540: 61 6e 20 4f 50 45 4e 2d 3e 53 48 41 52 45 44 0a an OPEN->SHARED.
4550: 2a 2a 20 74 72 61 6e 73 69 74 69 6f 6e 2c 20 62 ** transition, b
4560: 79 20 74 68 65 20 73 61 6d 65 20 70 61 67 65 72 y the same pager
4570: 20 6f 72 20 61 6e 79 20 6f 74 68 65 72 29 2e 20 or any other).
4580: 49 66 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 78 If the call to x
4590: 55 6e 6c 6f 63 6b 28 29 0a 2a 2a 20 66 61 69 6c Unlock().** fail
45a0: 73 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 s at this point
45b0: 61 6e 64 20 74 68 65 20 70 61 67 65 72 20 69 73 and the pager is
45c0: 20 6c 65 66 74 20 68 6f 6c 64 69 6e 67 20 61 6e left holding an
45d0: 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2c EXCLUSIVE lock,
45e0: 20 74 68 69 73 0a 2a 2a 20 63 61 6e 20 63 6f 6e this.** can con
45f0: 66 75 73 65 20 74 68 65 20 63 61 6c 6c 20 74 6f fuse the call to
4600: 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c xCheckReservedL
4610: 6f 63 6b 28 29 20 63 61 6c 6c 20 6d 61 64 65 20 ock() call made
4620: 6c 61 74 65 72 20 61 73 20 70 61 72 74 0a 2a 2a later as part.**
4630: 20 6f 66 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 of hot-journal
4640: 64 65 74 65 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a detection..**.**
4650: 20 78 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c xCheckReservedL
4660: 6f 63 6b 28 29 20 69 73 20 64 65 66 69 6e 65 64 ock() is defined
4670: 20 61 73 20 72 65 74 75 72 6e 69 6e 67 20 74 72 as returning tr
4680: 75 65 20 22 69 66 20 74 68 65 72 65 20 69 73 20 ue "if there is
4690: 61 20 52 45 53 45 52 56 45 44 20 0a 2a 2a 20 6c a RESERVED .** l
46a0: 6f 63 6b 20 68 65 6c 64 20 62 79 20 74 68 69 73 ock held by this
46b0: 20 70 72 6f 63 65 73 73 20 6f 72 20 61 6e 79 20 process or any
46c0: 6f 74 68 65 72 73 22 2e 20 53 6f 20 78 43 68 65 others". So xChe
46d0: 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b 20 6d ckReservedLock m
46e0: 61 79 20 0a 2a 2a 20 72 65 74 75 72 6e 20 74 72 ay .** return tr
46f0: 75 65 20 62 65 63 61 75 73 65 20 74 68 65 20 63 ue because the c
4700: 61 6c 6c 65 72 20 69 74 73 65 6c 66 20 69 73 20 aller itself is
4710: 68 6f 6c 64 69 6e 67 20 61 6e 20 45 58 43 4c 55 holding an EXCLU
4720: 53 49 56 45 20 6c 6f 63 6b 20 28 62 75 74 0a 2a SIVE lock (but.*
4730: 2a 20 64 6f 65 73 6e 27 74 20 6b 6e 6f 77 20 69 * doesn't know i
4740: 74 20 62 65 63 61 75 73 65 20 6f 66 20 61 20 70 t because of a p
4750: 72 65 76 69 6f 75 73 20 65 72 72 6f 72 20 69 6e revious error in
4760: 20 78 55 6e 6c 6f 63 6b 29 2e 20 49 66 20 74 68 xUnlock). If th
4770: 69 73 20 68 61 70 70 65 6e 73 0a 2a 2a 20 61 20 is happens.** a
4780: 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 6d 61 79 20 hot-journal may
4790: 62 65 20 6d 69 73 74 61 6b 65 6e 20 66 6f 72 20 be mistaken for
47a0: 61 20 6a 6f 75 72 6e 61 6c 20 62 65 69 6e 67 20 a journal being
47b0: 63 72 65 61 74 65 64 20 62 79 20 61 6e 20 61 63 created by an ac
47c0: 74 69 76 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 tive.** transact
47d0: 69 6f 6e 20 69 6e 20 61 6e 6f 74 68 65 72 20 70 ion in another p
47e0: 72 6f 63 65 73 73 2c 20 63 61 75 73 69 6e 67 20 rocess, causing
47f0: 53 51 4c 69 74 65 20 74 6f 20 72 65 61 64 20 66 SQLite to read f
4800: 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
4810: 0a 2a 2a 20 77 69 74 68 6f 75 74 20 72 6f 6c 6c .** without roll
4820: 69 6e 67 20 69 74 20 62 61 63 6b 2e 0a 2a 2a 0a ing it back..**.
4830: 2a 2a 20 54 6f 20 77 6f 72 6b 20 61 72 6f 75 6e ** To work aroun
4840: 64 20 74 68 69 73 2c 20 69 66 20 61 20 63 61 6c d this, if a cal
4850: 6c 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 29 20 66 l to xUnlock() f
4860: 61 69 6c 73 20 77 68 65 6e 20 75 6e 6c 6f 63 6b ails when unlock
4870: 69 6e 67 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 ing the.** datab
4880: 61 73 65 20 69 6e 20 74 68 65 20 45 52 52 4f 52 ase in the ERROR
4890: 20 73 74 61 74 65 2c 20 50 61 67 65 72 2e 65 4c state, Pager.eL
48a0: 6f 63 6b 20 69 73 20 73 65 74 20 74 6f 20 55 4e ock is set to UN
48b0: 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e 20 49 74 0a 2a KNOWN_LOCK. It.*
48c0: 2a 20 69 73 20 6f 6e 6c 79 20 63 68 61 6e 67 65 * is only change
48d0: 64 20 62 61 63 6b 20 74 6f 20 61 20 72 65 61 6c d back to a real
48e0: 20 6c 6f 63 6b 69 6e 67 20 73 74 61 74 65 20 61 locking state a
48f0: 66 74 65 72 20 61 20 73 75 63 63 65 73 73 66 75 fter a successfu
4900: 6c 20 63 61 6c 6c 0a 2a 2a 20 74 6f 20 78 4c 6f l call.** to xLo
4910: 63 6b 28 45 58 43 4c 55 53 49 56 45 29 2e 20 41 ck(EXCLUSIVE). A
4920: 6c 73 6f 2c 20 74 68 65 20 63 6f 64 65 20 74 6f lso, the code to
4930: 20 64 6f 20 74 68 65 20 4f 50 45 4e 2d 3e 53 48 do the OPEN->SH
4940: 41 52 45 44 20 73 74 61 74 65 20 74 72 61 6e 73 ARED state trans
4950: 69 74 69 6f 6e 0a 2a 2a 20 6f 6d 69 74 73 20 74 ition.** omits t
4960: 68 65 20 63 68 65 63 6b 20 66 6f 72 20 61 20 68 he check for a h
4970: 6f 74 2d 6a 6f 75 72 6e 61 6c 20 69 66 20 50 61 ot-journal if Pa
4980: 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 ger.eLock is set
4990: 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b to UNKNOWN_LOCK
49a0: 20 0a 2a 2a 20 6c 6f 63 6b 2e 20 49 6e 73 74 65 .** lock. Inste
49b0: 61 64 2c 20 69 74 20 61 73 73 75 6d 65 73 20 61 ad, it assumes a
49c0: 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 65 78 69 hot-journal exi
49d0: 73 74 73 20 61 6e 64 20 6f 62 74 61 69 6e 73 20 sts and obtains
49e0: 61 6e 20 45 58 43 4c 55 53 49 56 45 0a 2a 2a 20 an EXCLUSIVE.**
49f0: 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
4a00: 62 61 73 65 20 66 69 6c 65 20 62 65 66 6f 72 65 base file before
4a10: 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 72 attempting to r
4a20: 6f 6c 6c 20 69 74 20 62 61 63 6b 2e 20 53 65 65 oll it back. See
4a30: 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 50 61 67 function.** Pag
4a40: 65 72 53 68 61 72 65 64 4c 6f 63 6b 28 29 20 66 erSharedLock() f
4a50: 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 2e 0a or more detail..
4a60: 2a 2a 0a 2a 2a 20 50 61 67 65 72 2e 65 4c 6f 63 **.** Pager.eLoc
4a70: 6b 20 6d 61 79 20 6f 6e 6c 79 20 62 65 20 73 65 k may only be se
4a80: 74 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 t to UNKNOWN_LOC
4a90: 4b 20 77 68 65 6e 20 74 68 65 20 70 61 67 65 72 K when the pager
4aa0: 20 69 73 20 69 6e 20 0a 2a 2a 20 50 41 47 45 52 is in .** PAGER
4ab0: 5f 4f 50 45 4e 20 73 74 61 74 65 2e 0a 2a 2f 0a _OPEN state..*/.
4ac0: 23 64 65 66 69 6e 65 20 55 4e 4b 4e 4f 57 4e 5f #define UNKNOWN_
4ad0: 4c 4f 43 4b 20 20 20 20 20 20 20 20 20 20 20 20 LOCK
4ae0: 20 20 20 20 28 45 58 43 4c 55 53 49 56 45 5f 4c (EXCLUSIVE_L
4af0: 4f 43 4b 2b 31 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 OCK+1)../*.** A
4b00: 6d 61 63 72 6f 20 75 73 65 64 20 66 6f 72 20 69 macro used for i
4b10: 6e 76 6f 6b 69 6e 67 20 74 68 65 20 63 6f 64 65 nvoking the code
4b20: 63 20 69 66 20 74 68 65 72 65 20 69 73 20 6f 6e c if there is on
4b30: 65 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 e.*/.#ifdef SQLI
4b40: 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 23 20 64 TE_HAS_CODEC.# d
4b50: 65 66 69 6e 65 20 43 4f 44 45 43 31 28 50 2c 44 efine CODEC1(P,D
4b60: 2c 4e 2c 58 2c 45 29 20 5c 0a 20 20 20 20 69 66 ,N,X,E) \. if
4b70: 28 20 50 2d 3e 78 43 6f 64 65 63 20 26 26 20 50 ( P->xCodec && P
4b80: 2d 3e 78 43 6f 64 65 63 28 50 2d 3e 70 43 6f 64 ->xCodec(P->pCod
4b90: 65 63 2c 44 2c 4e 2c 58 29 3d 3d 30 20 29 7b 20 ec,D,N,X)==0 ){
4ba0: 45 3b 20 7d 0a 23 20 64 65 66 69 6e 65 20 43 4f E; }.# define CO
4bb0: 44 45 43 32 28 50 2c 44 2c 4e 2c 58 2c 45 2c 4f DEC2(P,D,N,X,E,O
4bc0: 29 20 5c 0a 20 20 20 20 69 66 28 20 50 2d 3e 78 ) \. if( P->x
4bd0: 43 6f 64 65 63 3d 3d 30 20 29 7b 20 4f 3d 28 63 Codec==0 ){ O=(c
4be0: 68 61 72 2a 29 44 3b 20 7d 65 6c 73 65 20 5c 0a har*)D; }else \.
4bf0: 20 20 20 20 69 66 28 20 28 4f 3d 28 63 68 61 72 if( (O=(char
4c00: 2a 29 28 50 2d 3e 78 43 6f 64 65 63 28 50 2d 3e *)(P->xCodec(P->
4c10: 70 43 6f 64 65 63 2c 44 2c 4e 2c 58 29 29 29 3d pCodec,D,N,X)))=
4c20: 3d 30 20 29 7b 20 45 3b 20 7d 0a 23 65 6c 73 65 =0 ){ E; }.#else
4c30: 0a 23 20 64 65 66 69 6e 65 20 43 4f 44 45 43 31 .# define CODEC1
4c40: 28 50 2c 44 2c 4e 2c 58 2c 45 29 20 20 20 2f 2a (P,D,N,X,E) /*
4c50: 20 4e 4f 2d 4f 50 20 2a 2f 0a 23 20 64 65 66 69 NO-OP */.# defi
4c60: 6e 65 20 43 4f 44 45 43 32 28 50 2c 44 2c 4e 2c ne CODEC2(P,D,N,
4c70: 58 2c 45 2c 4f 29 20 4f 3d 28 63 68 61 72 2a 29 X,E,O) O=(char*)
4c80: 44 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 D.#endif../*.**
4c90: 54 68 65 20 6d 61 78 69 6d 75 6d 20 61 6c 6c 6f The maximum allo
4ca0: 77 65 64 20 73 65 63 74 6f 72 20 73 69 7a 65 2e wed sector size.
4cb0: 20 36 34 4b 69 42 2e 20 49 66 20 74 68 65 20 78 64KiB. If the x
4cc0: 53 65 63 74 6f 72 73 69 7a 65 28 29 20 6d 65 74 Sectorsize() met
4cd0: 68 6f 64 20 0a 2a 2a 20 72 65 74 75 72 6e 73 20 hod .** returns
4ce0: 61 20 76 61 6c 75 65 20 6c 61 72 67 65 72 20 74 a value larger t
4cf0: 68 61 6e 20 74 68 69 73 2c 20 74 68 65 6e 20 4d han this, then M
4d00: 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 20 69 AX_SECTOR_SIZE i
4d10: 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 0a s used instead..
4d20: 2a 2a 20 54 68 69 73 20 63 6f 75 6c 64 20 63 6f ** This could co
4d30: 6e 63 65 69 76 61 62 6c 79 20 63 61 75 73 65 20 nceivably cause
4d40: 63 6f 72 72 75 70 74 69 6f 6e 20 66 6f 6c 6c 6f corruption follo
4d50: 77 69 6e 67 20 61 20 70 6f 77 65 72 20 66 61 69 wing a power fai
4d60: 6c 75 72 65 20 6f 6e 0a 2a 2a 20 73 75 63 68 20 lure on.** such
4d70: 61 20 73 79 73 74 65 6d 2e 20 54 68 69 73 20 69 a system. This i
4d80: 73 20 63 75 72 72 65 6e 74 6c 79 20 61 6e 20 75 s currently an u
4d90: 6e 64 6f 63 75 6d 65 6e 74 65 64 20 6c 69 6d 69 ndocumented limi
4da0: 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 t..*/.#define MA
4db0: 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 20 30 78 X_SECTOR_SIZE 0x
4dc0: 31 30 30 30 30 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6e 10000.../*.** An
4dd0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
4de0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
4df0: 74 75 72 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 ture is allocate
4e00: 64 20 66 6f 72 20 65 61 63 68 20 61 63 74 69 76 d for each activ
4e10: 65 0a 2a 2a 20 73 61 76 65 70 6f 69 6e 74 20 61 e.** savepoint a
4e20: 6e 64 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 nd statement tra
4e30: 6e 73 61 63 74 69 6f 6e 20 69 6e 20 74 68 65 20 nsaction in the
4e40: 73 79 73 74 65 6d 2e 20 41 6c 6c 20 73 75 63 68 system. All such
4e50: 20 73 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 61 structures.** a
4e60: 72 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 re stored in the
4e70: 20 50 61 67 65 72 2e 61 53 61 76 65 70 6f 69 6e Pager.aSavepoin
4e80: 74 5b 5d 20 61 72 72 61 79 2c 20 77 68 69 63 68 t[] array, which
4e90: 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e is allocated an
4ea0: 64 0a 2a 2a 20 72 65 73 69 7a 65 64 20 75 73 69 d.** resized usi
4eb0: 6e 67 20 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f ng sqlite3Reallo
4ec0: 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 c()..**.** When
4ed0: 61 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 63 a savepoint is c
4ee0: 72 65 61 74 65 64 2c 20 74 68 65 20 50 61 67 65 reated, the Page
4ef0: 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f rSavepoint.iHdrO
4f00: 66 66 73 65 74 20 66 69 65 6c 64 20 69 73 0a 2a ffset field is.*
4f10: 2a 20 73 65 74 20 74 6f 20 30 2e 20 49 66 20 61 * set to 0. If a
4f20: 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 journal-header
4f30: 69 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 is written into
4f40: 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c the main journal
4f50: 20 77 68 69 6c 65 0a 2a 2a 20 74 68 65 20 73 61 while.** the sa
4f60: 76 65 70 6f 69 6e 74 20 69 73 20 61 63 74 69 76 vepoint is activ
4f70: 65 2c 20 74 68 65 6e 20 69 48 64 72 4f 66 66 73 e, then iHdrOffs
4f80: 65 74 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 et is set to the
4f90: 20 62 79 74 65 20 6f 66 66 73 65 74 20 0a 2a 2a byte offset .**
4fa0: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 66 6f 6c immediately fol
4fb0: 6c 6f 77 69 6e 67 20 74 68 65 20 6c 61 73 74 20 lowing the last
4fc0: 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 20 77 journal record w
4fd0: 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 ritten into the
4fe0: 6d 61 69 6e 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 main.** journal
4ff0: 62 65 66 6f 72 65 20 74 68 65 20 6a 6f 75 72 6e before the journ
5000: 61 6c 2d 68 65 61 64 65 72 2e 20 54 68 69 73 20 al-header. This
5010: 69 73 20 72 65 71 75 69 72 65 64 20 64 75 72 69 is required duri
5020: 6e 67 20 73 61 76 65 70 6f 69 6e 74 0a 2a 2a 20 ng savepoint.**
5030: 72 6f 6c 6c 62 61 63 6b 20 28 73 65 65 20 70 61 rollback (see pa
5040: 67 65 72 50 6c 61 79 62 61 63 6b 53 61 76 65 70 gerPlaybackSavep
5050: 6f 69 6e 74 28 29 29 2e 0a 2a 2f 0a 74 79 70 65 oint())..*/.type
5060: 64 65 66 20 73 74 72 75 63 74 20 50 61 67 65 72 def struct Pager
5070: 53 61 76 65 70 6f 69 6e 74 20 50 61 67 65 72 53 Savepoint PagerS
5080: 61 76 65 70 6f 69 6e 74 3b 0a 73 74 72 75 63 74 avepoint;.struct
5090: 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 20 PagerSavepoint
50a0: 7b 0a 20 20 69 36 34 20 69 4f 66 66 73 65 74 3b {. i64 iOffset;
50b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
50c0: 20 2f 2a 20 53 74 61 72 74 69 6e 67 20 6f 66 66 /* Starting off
50d0: 73 65 74 20 69 6e 20 6d 61 69 6e 20 6a 6f 75 72 set in main jour
50e0: 6e 61 6c 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 nal */. i64 iHd
50f0: 72 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 rOffset;
5100: 20 20 20 20 20 20 2f 2a 20 53 65 65 20 61 62 6f /* See abo
5110: 76 65 20 2a 2f 0a 20 20 42 69 74 76 65 63 20 2a ve */. Bitvec *
5120: 70 49 6e 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 pInSavepoint;
5130: 20 20 20 20 20 2f 2a 20 53 65 74 20 6f 66 20 70 /* Set of p
5140: 61 67 65 73 20 69 6e 20 74 68 69 73 20 73 61 76 ages in this sav
5150: 65 70 6f 69 6e 74 20 2a 2f 0a 20 20 50 67 6e 6f epoint */. Pgno
5160: 20 6e 4f 72 69 67 3b 20 20 20 20 20 20 20 20 20 nOrig;
5170: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 67 /* Orig
5180: 69 6e 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 70 inal number of p
5190: 61 67 65 73 20 69 6e 20 66 69 6c 65 20 2a 2f 0a ages in file */.
51a0: 20 20 50 67 6e 6f 20 69 53 75 62 52 65 63 3b 20 Pgno iSubRec;
51b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
51c0: 2a 20 49 6e 64 65 78 20 6f 66 20 66 69 72 73 74 * Index of first
51d0: 20 72 65 63 6f 72 64 20 69 6e 20 73 75 62 2d 6a record in sub-j
51e0: 6f 75 72 6e 61 6c 20 2a 2f 0a 23 69 66 6e 64 65 ournal */.#ifnde
51f0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 f SQLITE_OMIT_WA
5200: 4c 0a 20 20 75 33 32 20 61 57 61 6c 44 61 74 61 L. u32 aWalData
5210: 5b 57 41 4c 5f 53 41 56 45 50 4f 49 4e 54 5f 4e [WAL_SAVEPOINT_N
5220: 44 41 54 41 5d 3b 20 20 20 20 20 20 20 20 2f 2a DATA]; /*
5230: 20 57 41 4c 20 73 61 76 65 70 6f 69 6e 74 20 63 WAL savepoint c
5240: 6f 6e 74 65 78 74 20 2a 2f 0a 23 65 6e 64 69 66 ontext */.#endif
5250: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 73 20 .};../*.** Bits
5260: 6f 66 20 74 68 65 20 50 61 67 65 72 2e 64 6f 4e of the Pager.doN
5270: 6f 74 53 70 69 6c 6c 20 66 6c 61 67 2e 20 20 53 otSpill flag. S
5280: 65 65 20 66 75 72 74 68 65 72 20 64 65 73 63 72 ee further descr
5290: 69 70 74 69 6f 6e 20 62 65 6c 6f 77 2e 0a 2a 2f iption below..*/
52a0: 0a 23 64 65 66 69 6e 65 20 53 50 49 4c 4c 46 4c .#define SPILLFL
52b0: 41 47 5f 4f 46 46 20 20 20 20 20 20 20 20 20 30 AG_OFF 0
52c0: 78 30 31 20 2f 2a 20 4e 65 76 65 72 20 73 70 69 x01 /* Never spi
52d0: 6c 6c 20 63 61 63 68 65 2e 20 20 53 65 74 20 76 ll cache. Set v
52e0: 69 61 20 70 72 61 67 6d 61 20 2a 2f 0a 23 64 65 ia pragma */.#de
52f0: 66 69 6e 65 20 53 50 49 4c 4c 46 4c 41 47 5f 52 fine SPILLFLAG_R
5300: 4f 4c 4c 42 41 43 4b 20 20 20 20 30 78 30 32 20 OLLBACK 0x02
5310: 2f 2a 20 43 75 72 72 65 6e 74 20 72 6f 6c 6c 69 /* Current rolli
5320: 6e 67 20 62 61 63 6b 2c 20 73 6f 20 64 6f 20 6e ng back, so do n
5330: 6f 74 20 73 70 69 6c 6c 20 2a 2f 0a 23 64 65 66 ot spill */.#def
5340: 69 6e 65 20 53 50 49 4c 4c 46 4c 41 47 5f 4e 4f ine SPILLFLAG_NO
5350: 53 59 4e 43 20 20 20 20 20 20 30 78 30 34 20 2f SYNC 0x04 /
5360: 2a 20 53 70 69 6c 6c 20 69 73 20 6f 6b 2c 20 62 * Spill is ok, b
5370: 75 74 20 64 6f 20 6e 6f 74 20 73 79 6e 63 20 2a ut do not sync *
5380: 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 6f 70 65 6e /../*.** An open
5390: 20 70 61 67 65 20 63 61 63 68 65 20 69 73 20 61 page cache is a
53a0: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 73 74 n instance of st
53b0: 72 75 63 74 20 50 61 67 65 72 2e 20 41 20 64 65 ruct Pager. A de
53c0: 73 63 72 69 70 74 69 6f 6e 20 6f 66 0a 2a 2a 20 scription of.**
53d0: 73 6f 6d 65 20 6f 66 20 74 68 65 20 6d 6f 72 65 some of the more
53e0: 20 69 6d 70 6f 72 74 61 6e 74 20 6d 65 6d 62 65 important membe
53f0: 72 20 76 61 72 69 61 62 6c 65 73 20 66 6f 6c 6c r variables foll
5400: 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 65 53 74 61 74 ows:.**.** eStat
5410: 65 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 63 75 e.**.** The cu
5420: 72 72 65 6e 74 20 27 73 74 61 74 65 27 20 6f 66 rrent 'state' of
5430: 20 74 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 the pager objec
5440: 74 2e 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 t. See the comme
5450: 6e 74 20 61 6e 64 20 73 74 61 74 65 0a 2a 2a 20 nt and state.**
5460: 20 20 64 69 61 67 72 61 6d 20 61 62 6f 76 65 20 diagram above
5470: 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 69 6f for a descriptio
5480: 6e 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 73 n of the pager s
5490: 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 65 4c 6f 63 tate..**.** eLoc
54a0: 6b 0a 2a 2a 0a 2a 2a 20 20 20 46 6f 72 20 61 20 k.**.** For a
54b0: 72 65 61 6c 20 6f 6e 2d 64 69 73 6b 20 64 61 74 real on-disk dat
54c0: 61 62 61 73 65 2c 20 74 68 65 20 63 75 72 72 65 abase, the curre
54d0: 6e 74 20 6c 6f 63 6b 20 68 65 6c 64 20 6f 6e 20 nt lock held on
54e0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
54f0: 65 20 2d 0a 2a 2a 20 20 20 4e 4f 5f 4c 4f 43 4b e -.** NO_LOCK
5500: 2c 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c 20 52 , SHARED_LOCK, R
5510: 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 6f 72 20 ESERVED_LOCK or
5520: 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 0a EXCLUSIVE_LOCK..
5530: 2a 2a 0a 2a 2a 20 20 20 46 6f 72 20 61 20 74 65 **.** For a te
5540: 6d 70 6f 72 61 72 79 20 6f 72 20 69 6e 2d 6d 65 mporary or in-me
5550: 6d 6f 72 79 20 64 61 74 61 62 61 73 65 20 28 6e mory database (n
5560: 65 69 74 68 65 72 20 6f 66 20 77 68 69 63 68 20 either of which
5570: 72 65 71 75 69 72 65 20 61 6e 79 0a 2a 2a 20 20 require any.**
5580: 20 6c 6f 63 6b 73 29 2c 20 74 68 69 73 20 76 61 locks), this va
5590: 72 69 61 62 6c 65 20 69 73 20 61 6c 77 61 79 73 riable is always
55a0: 20 73 65 74 20 74 6f 20 45 58 43 4c 55 53 49 56 set to EXCLUSIV
55b0: 45 5f 4c 4f 43 4b 2e 20 53 69 6e 63 65 20 73 75 E_LOCK. Since su
55c0: 63 68 0a 2a 2a 20 20 20 64 61 74 61 62 61 73 65 ch.** database
55d0: 73 20 61 6c 77 61 79 73 20 68 61 76 65 20 50 61 s always have Pa
55e0: 67 65 72 2e 65 78 63 6c 75 73 69 76 65 4d 6f 64 ger.exclusiveMod
55f0: 65 3d 3d 31 2c 20 74 68 69 73 20 74 72 69 63 6b e==1, this trick
5600: 73 20 74 68 65 20 70 61 67 65 72 0a 2a 2a 20 20 s the pager.**
5610: 20 6c 6f 67 69 63 20 69 6e 74 6f 20 74 68 69 6e logic into thin
5620: 6b 69 6e 67 20 74 68 61 74 20 69 74 20 61 6c 72 king that it alr
5630: 65 61 64 79 20 68 61 73 20 61 6c 6c 20 74 68 65 eady has all the
5640: 20 6c 6f 63 6b 73 20 69 74 20 77 69 6c 6c 20 65 locks it will e
5650: 76 65 72 0a 2a 2a 20 20 20 6e 65 65 64 20 28 61 ver.** need (a
5660: 6e 64 20 6e 6f 20 72 65 61 73 6f 6e 20 74 6f 20 nd no reason to
5670: 72 65 6c 65 61 73 65 20 74 68 65 6d 29 2e 0a 2a release them)..*
5680: 2a 0a 2a 2a 20 20 20 49 6e 20 73 6f 6d 65 20 28 *.** In some (
5690: 6f 62 73 63 75 72 65 29 20 63 69 72 63 75 6d 73 obscure) circums
56a0: 74 61 6e 63 65 73 2c 20 74 68 69 73 20 76 61 72 tances, this var
56b0: 69 61 62 6c 65 20 6d 61 79 20 61 6c 73 6f 20 62 iable may also b
56c0: 65 20 73 65 74 20 74 6f 0a 2a 2a 20 20 20 55 4e e set to.** UN
56d0: 4b 4e 4f 57 4e 5f 4c 4f 43 4b 2e 20 53 65 65 20 KNOWN_LOCK. See
56e0: 74 68 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 the comment abov
56f0: 65 20 74 68 65 20 23 64 65 66 69 6e 65 20 6f 66 e the #define of
5700: 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f UNKNOWN_LOCK fo
5710: 72 0a 2a 2a 20 20 20 64 65 74 61 69 6c 73 2e 0a r.** details..
5720: 2a 2a 0a 2a 2a 20 63 68 61 6e 67 65 43 6f 75 6e **.** changeCoun
5730: 74 44 6f 6e 65 0a 2a 2a 0a 2a 2a 20 20 20 54 68 tDone.**.** Th
5740: 69 73 20 62 6f 6f 6c 65 61 6e 20 76 61 72 69 61 is boolean varia
5750: 62 6c 65 20 69 73 20 75 73 65 64 20 74 6f 20 6d ble is used to m
5760: 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 ake sure that th
5770: 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 e change-counter
5780: 20 0a 2a 2a 20 20 20 28 74 68 65 20 34 2d 62 79 .** (the 4-by
5790: 74 65 20 68 65 61 64 65 72 20 66 69 65 6c 64 20 te header field
57a0: 61 74 20 62 79 74 65 20 6f 66 66 73 65 74 20 32 at byte offset 2
57b0: 34 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 4 of the databas
57c0: 65 20 66 69 6c 65 29 20 69 73 20 0a 2a 2a 20 20 e file) is .**
57d0: 20 6e 6f 74 20 75 70 64 61 74 65 64 20 6d 6f 72 not updated mor
57e0: 65 20 6f 66 74 65 6e 20 74 68 61 6e 20 6e 65 63 e often than nec
57f0: 65 73 73 61 72 79 2e 20 0a 2a 2a 0a 2a 2a 20 20 essary. .**.**
5800: 20 49 74 20 69 73 20 73 65 74 20 74 6f 20 74 72 It is set to tr
5810: 75 65 20 77 68 65 6e 20 74 68 65 20 63 68 61 6e ue when the chan
5820: 67 65 2d 63 6f 75 6e 74 65 72 20 66 69 65 6c 64 ge-counter field
5830: 20 69 73 20 75 70 64 61 74 65 64 2c 20 77 68 69 is updated, whi
5840: 63 68 20 0a 2a 2a 20 20 20 63 61 6e 20 6f 6e 6c ch .** can onl
5850: 79 20 68 61 70 70 65 6e 20 69 66 20 61 6e 20 65 y happen if an e
5860: 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 69 73 xclusive lock is
5870: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
5880: 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 abase file..**
5890: 20 49 74 20 69 73 20 63 6c 65 61 72 65 64 20 28 It is cleared (
58a0: 73 65 74 20 74 6f 20 66 61 6c 73 65 29 20 77 68 set to false) wh
58b0: 65 6e 65 76 65 72 20 61 6e 20 65 78 63 6c 75 73 enever an exclus
58c0: 69 76 65 20 6c 6f 63 6b 20 69 73 20 0a 2a 2a 20 ive lock is .**
58d0: 20 20 72 65 6c 69 6e 71 75 69 73 68 65 64 20 6f relinquished o
58e0: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 n the database f
58f0: 69 6c 65 2e 20 45 61 63 68 20 74 69 6d 65 20 61 ile. Each time a
5900: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
5910: 63 6f 6d 6d 69 74 74 65 64 2c 0a 2a 2a 20 20 20 committed,.**
5920: 54 68 65 20 63 68 61 6e 67 65 43 6f 75 6e 74 44 The changeCountD
5930: 6f 6e 65 20 66 6c 61 67 20 69 73 20 69 6e 73 70 one flag is insp
5940: 65 63 74 65 64 2e 20 49 66 20 69 74 20 69 73 20 ected. If it is
5950: 74 72 75 65 2c 20 74 68 65 20 77 6f 72 6b 20 6f true, the work o
5960: 66 0a 2a 2a 20 20 20 75 70 64 61 74 69 6e 67 20 f.** updating
5970: 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 the change-count
5980: 65 72 20 69 73 20 6f 6d 69 74 74 65 64 20 66 6f er is omitted fo
5990: 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 r the current tr
59a0: 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a ansaction..**.**
59b0: 20 20 20 54 68 69 73 20 6d 65 63 68 61 6e 69 73 This mechanis
59c0: 6d 20 6d 65 61 6e 73 20 74 68 61 74 20 77 68 65 m means that whe
59d0: 6e 20 72 75 6e 6e 69 6e 67 20 69 6e 20 65 78 63 n running in exc
59e0: 6c 75 73 69 76 65 20 6d 6f 64 65 2c 20 61 20 63 lusive mode, a c
59f0: 6f 6e 6e 65 63 74 69 6f 6e 20 0a 2a 2a 20 20 20 onnection .**
5a00: 6e 65 65 64 20 6f 6e 6c 79 20 75 70 64 61 74 65 need only update
5a10: 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f 75 6e the change-coun
5a20: 74 65 72 20 6f 6e 63 65 2c 20 66 6f 72 20 74 68 ter once, for th
5a30: 65 20 66 69 72 73 74 20 74 72 61 6e 73 61 63 74 e first transact
5a40: 69 6f 6e 0a 2a 2a 20 20 20 63 6f 6d 6d 69 74 74 ion.** committ
5a50: 65 64 2e 0a 2a 2a 0a 2a 2a 20 73 65 74 4d 61 73 ed..**.** setMas
5a60: 74 65 72 0a 2a 2a 0a 2a 2a 20 20 20 57 68 65 6e ter.**.** When
5a70: 20 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 73 PagerCommitPhas
5a80: 65 4f 6e 65 28 29 20 69 73 20 63 61 6c 6c 65 64 eOne() is called
5a90: 20 74 6f 20 63 6f 6d 6d 69 74 20 61 20 74 72 61 to commit a tra
5aa0: 6e 73 61 63 74 69 6f 6e 2c 20 69 74 20 6d 61 79 nsaction, it may
5ab0: 0a 2a 2a 20 20 20 28 6f 72 20 6d 61 79 20 6e 6f .** (or may no
5ac0: 74 29 20 73 70 65 63 69 66 79 20 61 20 6d 61 73 t) specify a mas
5ad0: 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 ter-journal name
5ae0: 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e 20 69 to be written i
5af0: 6e 74 6f 20 74 68 65 20 0a 2a 2a 20 20 20 6a 6f nto the .** jo
5b00: 75 72 6e 61 6c 20 66 69 6c 65 20 62 65 66 6f 72 urnal file befor
5b10: 65 20 69 74 20 69 73 20 73 79 6e 63 65 64 20 74 e it is synced t
5b20: 6f 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a 20 20 20 o disk..**.**
5b30: 57 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 Whether or not a
5b40: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 6f journal file co
5b50: 6e 74 61 69 6e 73 20 61 20 6d 61 73 74 65 72 2d ntains a master-
5b60: 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 journal pointer
5b70: 61 66 66 65 63 74 73 20 0a 2a 2a 20 20 20 74 68 affects .** th
5b80: 65 20 77 61 79 20 69 6e 20 77 68 69 63 68 20 74 e way in which t
5b90: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
5ba0: 69 73 20 66 69 6e 61 6c 69 7a 65 64 20 61 66 74 is finalized aft
5bb0: 65 72 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 er the transacti
5bc0: 6f 6e 20 69 73 20 0a 2a 2a 20 20 20 63 6f 6d 6d on is .** comm
5bd0: 69 74 74 65 64 20 6f 72 20 72 6f 6c 6c 65 64 20 itted or rolled
5be0: 62 61 63 6b 20 77 68 65 6e 20 72 75 6e 6e 69 6e back when runnin
5bf0: 67 20 69 6e 20 22 6a 6f 75 72 6e 61 6c 5f 6d 6f g in "journal_mo
5c00: 64 65 3d 50 45 52 53 49 53 54 22 20 6d 6f 64 65 de=PERSIST" mode
5c10: 2e 0a 2a 2a 20 20 20 49 66 20 61 20 6a 6f 75 72 ..** If a jour
5c20: 6e 61 6c 20 66 69 6c 65 20 64 6f 65 73 20 6e 6f nal file does no
5c30: 74 20 63 6f 6e 74 61 69 6e 20 61 20 6d 61 73 74 t contain a mast
5c40: 65 72 2d 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 er-journal point
5c50: 65 72 2c 20 69 74 20 69 73 0a 2a 2a 20 20 20 66 er, it is.** f
5c60: 69 6e 61 6c 69 7a 65 64 20 62 79 20 6f 76 65 72 inalized by over
5c70: 77 72 69 74 69 6e 67 20 74 68 65 20 66 69 72 73 writing the firs
5c80: 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 t journal header
5c90: 20 77 69 74 68 20 7a 65 72 6f 65 73 2e 20 49 66 with zeroes. If
5ca0: 0a 2a 2a 20 20 20 69 74 20 64 6f 65 73 20 63 6f .** it does co
5cb0: 6e 74 61 69 6e 20 61 20 6d 61 73 74 65 72 2d 6a ntain a master-j
5cc0: 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 74 ournal pointer t
5cd0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
5ce0: 69 73 20 66 69 6e 61 6c 69 7a 65 64 20 0a 2a 2a is finalized .**
5cf0: 20 20 20 62 79 20 74 72 75 6e 63 61 74 69 6e 67 by truncating
5d00: 20 69 74 20 74 6f 20 7a 65 72 6f 20 62 79 74 65 it to zero byte
5d10: 73 2c 20 6a 75 73 74 20 61 73 20 69 66 20 74 68 s, just as if th
5d20: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 65 72 e connection wer
5d30: 65 20 0a 2a 2a 20 20 20 72 75 6e 6e 69 6e 67 20 e .** running
5d40: 69 6e 20 22 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 in "journal_mode
5d50: 3d 74 72 75 6e 63 61 74 65 22 20 6d 6f 64 65 2e =truncate" mode.
5d60: 0a 2a 2a 0a 2a 2a 20 20 20 4a 6f 75 72 6e 61 6c .**.** Journal
5d70: 20 66 69 6c 65 73 20 74 68 61 74 20 63 6f 6e 74 files that cont
5d80: 61 69 6e 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e ain master journ
5d90: 61 6c 20 70 6f 69 6e 74 65 72 73 20 63 61 6e 6e al pointers cann
5da0: 6f 74 20 62 65 20 66 69 6e 61 6c 69 7a 65 64 0a ot be finalized.
5db0: 2a 2a 20 20 20 73 69 6d 70 6c 79 20 62 79 20 6f ** simply by o
5dc0: 76 65 72 77 72 69 74 69 6e 67 20 74 68 65 20 66 verwriting the f
5dd0: 69 72 73 74 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 irst journal-hea
5de0: 64 65 72 20 77 69 74 68 20 7a 65 72 6f 65 73 2c der with zeroes,
5df0: 20 61 73 20 74 68 65 0a 2a 2a 20 20 20 6d 61 73 as the.** mas
5e00: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e ter journal poin
5e10: 74 65 72 20 63 6f 75 6c 64 20 69 6e 74 65 72 66 ter could interf
5e20: 65 72 65 20 77 69 74 68 20 68 6f 74 2d 6a 6f 75 ere with hot-jou
5e30: 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 6f 66 rnal rollback of
5e40: 20 61 6e 79 0a 2a 2a 20 20 20 73 75 62 73 65 71 any.** subseq
5e50: 75 65 6e 74 6c 79 20 69 6e 74 65 72 72 75 70 74 uently interrupt
5e60: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 ed transaction t
5e70: 68 61 74 20 72 65 75 73 65 73 20 74 68 65 20 6a hat reuses the j
5e80: 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 2a 2a 0a ournal file..**.
5e90: 2a 2a 20 20 20 54 68 65 20 66 6c 61 67 20 69 73 ** The flag is
5ea0: 20 63 6c 65 61 72 65 64 20 61 73 20 73 6f 6f 6e cleared as soon
5eb0: 20 61 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 as the journal
5ec0: 66 69 6c 65 20 69 73 20 66 69 6e 61 6c 69 7a 65 file is finalize
5ed0: 64 20 28 65 69 74 68 65 72 0a 2a 2a 20 20 20 62 d (either.** b
5ee0: 79 20 50 61 67 65 72 43 6f 6d 6d 69 74 50 68 61 y PagerCommitPha
5ef0: 73 65 54 77 6f 20 6f 72 20 50 61 67 65 72 52 6f seTwo or PagerRo
5f00: 6c 6c 62 61 63 6b 29 2e 20 49 66 20 61 6e 20 49 llback). If an I
5f10: 4f 20 65 72 72 6f 72 20 70 72 65 76 65 6e 74 73 O error prevents
5f20: 20 74 68 65 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 the.** journa
5f30: 6c 20 66 69 6c 65 20 66 72 6f 6d 20 62 65 69 6e l file from bein
5f40: 67 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 66 g successfully f
5f50: 69 6e 61 6c 69 7a 65 64 2c 20 74 68 65 20 73 65 inalized, the se
5f60: 74 4d 61 73 74 65 72 20 66 6c 61 67 0a 2a 2a 20 tMaster flag.**
5f70: 20 20 69 73 20 63 6c 65 61 72 65 64 20 61 6e 79 is cleared any
5f80: 77 61 79 20 28 61 6e 64 20 74 68 65 20 70 61 67 way (and the pag
5f90: 65 72 20 77 69 6c 6c 20 6d 6f 76 65 20 74 6f 20 er will move to
5fa0: 45 52 52 4f 52 20 73 74 61 74 65 29 2e 0a 2a 2a ERROR state)..**
5fb0: 0a 2a 2a 20 64 6f 4e 6f 74 53 70 69 6c 6c 0a 2a .** doNotSpill.*
5fc0: 2a 0a 2a 2a 20 20 20 54 68 69 73 20 76 61 72 69 *.** This vari
5fd0: 61 62 6c 65 73 20 63 6f 6e 74 72 6f 6c 20 74 68 ables control th
5fe0: 65 20 62 65 68 61 76 69 6f 72 20 6f 66 20 63 61 e behavior of ca
5ff0: 63 68 65 2d 73 70 69 6c 6c 73 20 20 28 63 61 6c che-spills (cal
6000: 6c 73 20 6d 61 64 65 20 62 79 0a 2a 2a 20 20 20 ls made by.**
6010: 74 68 65 20 70 63 61 63 68 65 20 6d 6f 64 75 6c the pcache modul
6020: 65 20 74 6f 20 74 68 65 20 70 61 67 65 72 53 74 e to the pagerSt
6030: 72 65 73 73 28 29 20 72 6f 75 74 69 6e 65 20 74 ress() routine t
6040: 6f 20 77 72 69 74 65 20 63 61 63 68 65 64 20 64 o write cached d
6050: 61 74 61 0a 2a 2a 20 20 20 74 6f 20 74 68 65 20 ata.** to the
6060: 66 69 6c 65 2d 73 79 73 74 65 6d 20 69 6e 20 6f file-system in o
6070: 72 64 65 72 20 74 6f 20 66 72 65 65 20 75 70 20 rder to free up
6080: 6d 65 6d 6f 72 79 29 2e 0a 2a 2a 0a 2a 2a 20 20 memory)..**.**
6090: 20 57 68 65 6e 20 62 69 74 73 20 53 50 49 4c 4c When bits SPILL
60a0: 46 4c 41 47 5f 4f 46 46 20 6f 72 20 53 50 49 4c FLAG_OFF or SPIL
60b0: 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 20 6f LFLAG_ROLLBACK o
60c0: 66 20 64 6f 4e 6f 74 53 70 69 6c 6c 20 61 72 65 f doNotSpill are
60d0: 20 73 65 74 2c 0a 2a 2a 20 20 20 77 72 69 74 69 set,.** writi
60e0: 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ng to the databa
60f0: 73 65 20 66 72 6f 6d 20 70 61 67 65 72 53 74 72 se from pagerStr
6100: 65 73 73 28 29 20 69 73 20 64 69 73 61 62 6c 65 ess() is disable
6110: 64 20 61 6c 74 6f 67 65 74 68 65 72 2e 0a 2a 2a d altogether..**
6120: 20 20 20 54 68 65 20 53 50 49 4c 4c 46 4c 41 47 The SPILLFLAG
6130: 5f 52 4f 4c 4c 42 41 43 4b 20 63 61 73 65 20 69 _ROLLBACK case i
6140: 73 20 64 6f 6e 65 20 69 6e 20 61 20 76 65 72 79 s done in a very
6150: 20 6f 62 73 63 75 72 65 20 63 61 73 65 20 74 68 obscure case th
6160: 61 74 0a 2a 2a 20 20 20 63 6f 6d 65 73 20 75 70 at.** comes up
6170: 20 64 75 72 69 6e 67 20 73 61 76 65 70 6f 69 6e during savepoin
6180: 74 20 72 6f 6c 6c 62 61 63 6b 20 74 68 61 74 20 t rollback that
6190: 72 65 71 75 69 72 65 73 20 74 68 65 20 70 63 61 requires the pca
61a0: 63 68 65 20 6d 6f 64 75 6c 65 0a 2a 2a 20 20 20 che module.**
61b0: 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 20 6e 65 to allocate a ne
61c0: 77 20 70 61 67 65 20 74 6f 20 70 72 65 76 65 6e w page to preven
61d0: 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 t the journal fi
61e0: 6c 65 20 66 72 6f 6d 20 62 65 69 6e 67 20 77 72 le from being wr
61f0: 69 74 74 65 6e 0a 2a 2a 20 20 20 77 68 69 6c 65 itten.** while
6200: 20 69 74 20 69 73 20 62 65 69 6e 67 20 74 72 61 it is being tra
6210: 76 65 72 73 65 64 20 62 79 20 63 6f 64 65 20 69 versed by code i
6220: 6e 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b n pager_playback
6230: 28 29 2e 20 20 54 68 65 20 53 50 49 4c 4c 46 4c (). The SPILLFL
6240: 41 47 5f 4f 46 46 0a 2a 2a 20 20 20 63 61 73 65 AG_OFF.** case
6250: 20 69 73 20 61 20 75 73 65 72 20 70 72 65 66 65 is a user prefe
6260: 72 65 6e 63 65 2e 0a 2a 2a 20 0a 2a 2a 20 20 20 rence..** .**
6270: 49 66 20 74 68 65 20 53 50 49 4c 4c 46 4c 41 47 If the SPILLFLAG
6280: 5f 4e 4f 53 59 4e 43 20 62 69 74 20 69 73 20 73 _NOSYNC bit is s
6290: 65 74 2c 20 77 72 69 74 69 6e 67 20 74 6f 20 74 et, writing to t
62a0: 68 65 20 64 61 74 61 62 61 73 65 20 66 72 6f 6d he database from
62b0: 0a 2a 2a 20 20 20 70 61 67 65 72 53 74 72 65 73 .** pagerStres
62c0: 73 28 29 20 69 73 20 70 65 72 6d 69 74 74 65 64 s() is permitted
62d0: 2c 20 62 75 74 20 73 79 6e 63 69 6e 67 20 74 68 , but syncing th
62e0: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 e journal file i
62f0: 73 20 6e 6f 74 2e 0a 2a 2a 20 20 20 54 68 69 73 s not..** This
6300: 20 66 6c 61 67 20 69 73 20 73 65 74 20 62 79 20 flag is set by
6310: 73 71 6c 69 74 65 33 50 61 67 65 72 57 72 69 74 sqlite3PagerWrit
6320: 65 28 29 20 77 68 65 6e 20 74 68 65 20 66 69 6c e() when the fil
6330: 65 2d 73 79 73 74 65 6d 20 73 65 63 74 6f 72 2d e-system sector-
6340: 73 69 7a 65 0a 2a 2a 20 20 20 69 73 20 6c 61 72 size.** is lar
6350: 67 65 72 20 74 68 61 6e 20 74 68 65 20 64 61 74 ger than the dat
6360: 61 62 61 73 65 20 70 61 67 65 2d 73 69 7a 65 20 abase page-size
6370: 69 6e 20 6f 72 64 65 72 20 74 6f 20 70 72 65 76 in order to prev
6380: 65 6e 74 20 61 20 6a 6f 75 72 6e 61 6c 20 73 79 ent a journal sy
6390: 6e 63 0a 2a 2a 20 20 20 66 72 6f 6d 20 68 61 70 nc.** from hap
63a0: 70 65 6e 69 6e 67 20 69 6e 20 62 65 74 77 65 65 pening in betwee
63b0: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 6c 69 6e n the journallin
63c0: 67 20 6f 66 20 74 77 6f 20 70 61 67 65 73 20 6f g of two pages o
63d0: 6e 20 74 68 65 20 73 61 6d 65 20 73 65 63 74 6f n the same secto
63e0: 72 2e 20 0a 2a 2a 0a 2a 2a 20 73 75 62 6a 49 6e r. .**.** subjIn
63f0: 4d 65 6d 6f 72 79 0a 2a 2a 0a 2a 2a 20 20 20 54 Memory.**.** T
6400: 68 69 73 20 69 73 20 61 20 62 6f 6f 6c 65 61 6e his is a boolean
6410: 20 76 61 72 69 61 62 6c 65 2e 20 49 66 20 74 72 variable. If tr
6420: 75 65 2c 20 74 68 65 6e 20 61 6e 79 20 72 65 71 ue, then any req
6430: 75 69 72 65 64 20 73 75 62 2d 6a 6f 75 72 6e 61 uired sub-journa
6440: 6c 0a 2a 2a 20 20 20 69 73 20 6f 70 65 6e 65 64 l.** is opened
6450: 20 61 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 as an in-memory
6460: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 journal file. I
6470: 66 20 66 61 6c 73 65 2c 20 74 68 65 6e 20 69 6e f false, then in
6480: 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 20 20 73 75 62 -memory.** sub
6490: 2d 6a 6f 75 72 6e 61 6c 73 20 61 72 65 20 6f 6e -journals are on
64a0: 6c 79 20 75 73 65 64 20 66 6f 72 20 69 6e 2d 6d ly used for in-m
64b0: 65 6d 6f 72 79 20 70 61 67 65 72 20 66 69 6c 65 emory pager file
64c0: 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 69 73 20 s..**.** This
64d0: 76 61 72 69 61 62 6c 65 20 69 73 20 75 70 64 61 variable is upda
64e0: 74 65 64 20 62 79 20 74 68 65 20 75 70 70 65 72 ted by the upper
64f0: 20 6c 61 79 65 72 20 65 61 63 68 20 74 69 6d 65 layer each time
6500: 20 61 20 6e 65 77 20 0a 2a 2a 20 20 20 77 72 69 a new .** wri
6510: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 te-transaction i
6520: 73 20 6f 70 65 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 s opened..**.**
6530: 64 62 53 69 7a 65 2c 20 64 62 4f 72 69 67 53 69 dbSize, dbOrigSi
6540: 7a 65 2c 20 64 62 46 69 6c 65 53 69 7a 65 0a 2a ze, dbFileSize.*
6550: 2a 0a 2a 2a 20 20 20 56 61 72 69 61 62 6c 65 20 *.** Variable
6560: 64 62 53 69 7a 65 20 69 73 20 73 65 74 20 74 6f dbSize is set to
6570: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 the number of p
6580: 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 61 ages in the data
6590: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 20 20 base file..**
65a0: 49 74 20 69 73 20 76 61 6c 69 64 20 69 6e 20 50 It is valid in P
65b0: 41 47 45 52 5f 52 45 41 44 45 52 20 61 6e 64 20 AGER_READER and
65c0: 68 69 67 68 65 72 20 73 74 61 74 65 73 20 28 61 higher states (a
65d0: 6c 6c 20 73 74 61 74 65 73 20 65 78 63 65 70 74 ll states except
65e0: 20 66 6f 72 0a 2a 2a 20 20 20 4f 50 45 4e 20 61 for.** OPEN a
65f0: 6e 64 20 45 52 52 4f 52 29 2e 20 0a 2a 2a 0a 2a nd ERROR). .**.*
6600: 2a 20 20 20 64 62 53 69 7a 65 20 69 73 20 73 65 * dbSize is se
6610: 74 20 62 61 73 65 64 20 6f 6e 20 74 68 65 20 73 t based on the s
6620: 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ize of the datab
6630: 61 73 65 20 66 69 6c 65 2c 20 77 68 69 63 68 20 ase file, which
6640: 6d 61 79 20 62 65 20 0a 2a 2a 20 20 20 6c 61 72 may be .** lar
6650: 67 65 72 20 74 68 61 6e 20 74 68 65 20 73 69 7a ger than the siz
6660: 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 e of the databas
6670: 65 20 28 74 68 65 20 76 61 6c 75 65 20 73 74 6f e (the value sto
6680: 72 65 64 20 61 74 20 6f 66 66 73 65 74 0a 2a 2a red at offset.**
6690: 20 20 20 32 38 20 6f 66 20 74 68 65 20 64 61 74 28 of the dat
66a0: 61 62 61 73 65 20 68 65 61 64 65 72 20 62 79 20 abase header by
66b0: 74 68 65 20 62 74 72 65 65 29 2e 20 49 66 20 74 the btree). If t
66c0: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 66 he size of the f
66d0: 69 6c 65 0a 2a 2a 20 20 20 69 73 20 6e 6f 74 20 ile.** is not
66e0: 61 6e 20 69 6e 74 65 67 65 72 20 6d 75 6c 74 69 an integer multi
66f0: 70 6c 65 20 6f 66 20 74 68 65 20 70 61 67 65 2d ple of the page-
6700: 73 69 7a 65 2c 20 74 68 65 20 76 61 6c 75 65 20 size, the value
6710: 73 74 6f 72 65 64 20 69 6e 0a 2a 2a 20 20 20 64 stored in.** d
6720: 62 53 69 7a 65 20 69 73 20 72 6f 75 6e 64 65 64 bSize is rounded
6730: 20 64 6f 77 6e 20 28 69 2e 65 2e 20 61 20 35 4b down (i.e. a 5K
6740: 42 20 66 69 6c 65 20 77 69 74 68 20 32 4b 20 70 B file with 2K p
6750: 61 67 65 2d 73 69 7a 65 20 68 61 73 20 64 62 53 age-size has dbS
6760: 69 7a 65 3d 3d 32 29 2e 0a 2a 2a 20 20 20 45 78 ize==2)..** Ex
6770: 63 65 70 74 2c 20 61 6e 79 20 66 69 6c 65 20 74 cept, any file t
6780: 68 61 74 20 69 73 20 67 72 65 61 74 65 72 20 74 hat is greater t
6790: 68 61 6e 20 30 20 62 79 74 65 73 20 69 6e 20 73 han 0 bytes in s
67a0: 69 7a 65 20 69 73 20 63 6f 6e 73 69 64 65 72 65 ize is considere
67b0: 64 0a 2a 2a 20 20 20 74 6f 20 68 61 76 65 20 61 d.** to have a
67c0: 74 20 6c 65 61 73 74 20 6f 6e 65 20 70 61 67 65 t least one page
67d0: 2e 20 28 69 2e 65 2e 20 61 20 31 4b 42 20 66 69 . (i.e. a 1KB fi
67e0: 6c 65 20 77 69 74 68 20 32 4b 20 70 61 67 65 2d le with 2K page-
67f0: 73 69 7a 65 20 6c 65 61 64 73 0a 2a 2a 20 20 20 size leads.**
6800: 74 6f 20 64 62 53 69 7a 65 3d 3d 31 29 2e 0a 2a to dbSize==1)..*
6810: 2a 0a 2a 2a 20 20 20 44 75 72 69 6e 67 20 61 20 *.** During a
6820: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f write-transactio
6830: 6e 2c 20 69 66 20 70 61 67 65 73 20 77 69 74 68 n, if pages with
6840: 20 70 61 67 65 2d 6e 75 6d 62 65 72 73 20 67 72 page-numbers gr
6850: 65 61 74 65 72 20 74 68 61 6e 0a 2a 2a 20 20 20 eater than.**
6860: 64 62 53 69 7a 65 20 61 72 65 20 6d 6f 64 69 66 dbSize are modif
6870: 69 65 64 20 69 6e 20 74 68 65 20 63 61 63 68 65 ied in the cache
6880: 2c 20 64 62 53 69 7a 65 20 69 73 20 75 70 64 61 , dbSize is upda
6890: 74 65 64 20 61 63 63 6f 72 64 69 6e 67 6c 79 2e ted accordingly.
68a0: 0a 2a 2a 20 20 20 53 69 6d 69 6c 61 72 6c 79 2c .** Similarly,
68b0: 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 if the database
68c0: 20 69 73 20 74 72 75 6e 63 61 74 65 64 20 75 73 is truncated us
68d0: 69 6e 67 20 50 61 67 65 72 54 72 75 6e 63 61 74 ing PagerTruncat
68e0: 65 49 6d 61 67 65 28 29 2c 20 0a 2a 2a 20 20 20 eImage(), .**
68f0: 64 62 53 69 7a 65 20 69 73 20 75 70 64 61 74 65 dbSize is update
6900: 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 56 61 72 69 61 d..**.** Varia
6910: 62 6c 65 73 20 64 62 4f 72 69 67 53 69 7a 65 20 bles dbOrigSize
6920: 61 6e 64 20 64 62 46 69 6c 65 53 69 7a 65 20 61 and dbFileSize a
6930: 72 65 20 76 61 6c 69 64 20 69 6e 20 73 74 61 74 re valid in stat
6940: 65 73 20 0a 2a 2a 20 20 20 50 41 47 45 52 5f 57 es .** PAGER_W
6950: 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 61 6e 64 RITER_LOCKED and
6960: 20 68 69 67 68 65 72 2e 20 64 62 4f 72 69 67 53 higher. dbOrigS
6970: 69 7a 65 20 69 73 20 61 20 63 6f 70 79 20 6f 66 ize is a copy of
6980: 20 74 68 65 20 64 62 53 69 7a 65 0a 2a 2a 20 20 the dbSize.**
6990: 20 76 61 72 69 61 62 6c 65 20 61 74 20 74 68 65 variable at the
69a0: 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 74 72 start of the tr
69b0: 61 6e 73 61 63 74 69 6f 6e 2e 20 49 74 20 69 73 ansaction. It is
69c0: 20 75 73 65 64 20 64 75 72 69 6e 67 20 72 6f 6c used during rol
69d0: 6c 62 61 63 6b 2c 0a 2a 2a 20 20 20 61 6e 64 20 lback,.** and
69e0: 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68 65 to determine whe
69f0: 74 68 65 72 20 6f 72 20 6e 6f 74 20 70 61 67 65 ther or not page
6a00: 73 20 6e 65 65 64 20 74 6f 20 62 65 20 6a 6f 75 s need to be jou
6a10: 72 6e 61 6c 6c 65 64 20 62 65 66 6f 72 65 0a 2a rnalled before.*
6a20: 2a 20 20 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 * being modifi
6a30: 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 54 68 72 6f ed..**.** Thro
6a40: 75 67 68 6f 75 74 20 61 20 77 72 69 74 65 2d 74 ughout a write-t
6a50: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 64 62 46 69 ransaction, dbFi
6a60: 6c 65 53 69 7a 65 20 63 6f 6e 74 61 69 6e 73 20 leSize contains
6a70: 74 68 65 20 73 69 7a 65 20 6f 66 0a 2a 2a 20 20 the size of.**
6a80: 20 74 68 65 20 66 69 6c 65 20 6f 6e 20 64 69 73 the file on dis
6a90: 6b 20 69 6e 20 70 61 67 65 73 2e 20 49 74 20 69 k in pages. It i
6aa0: 73 20 73 65 74 20 74 6f 20 61 20 63 6f 70 79 20 s set to a copy
6ab0: 6f 66 20 64 62 53 69 7a 65 20 77 68 65 6e 20 74 of dbSize when t
6ac0: 68 65 0a 2a 2a 20 20 20 77 72 69 74 65 2d 74 72 he.** write-tr
6ad0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 66 69 72 ansaction is fir
6ae0: 73 74 20 6f 70 65 6e 65 64 2c 20 61 6e 64 20 75 st opened, and u
6af0: 70 64 61 74 65 64 20 77 68 65 6e 20 56 46 53 20 pdated when VFS
6b00: 63 61 6c 6c 73 20 61 72 65 20 6d 61 64 65 0a 2a calls are made.*
6b10: 2a 20 20 20 74 6f 20 77 72 69 74 65 20 6f 72 20 * to write or
6b20: 74 72 75 6e 63 61 74 65 20 74 68 65 20 64 61 74 truncate the dat
6b30: 61 62 61 73 65 20 66 69 6c 65 20 6f 6e 20 64 69 abase file on di
6b40: 73 6b 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 sk. .**.** The
6b50: 20 6f 6e 6c 79 20 72 65 61 73 6f 6e 20 74 68 65 only reason the
6b60: 20 64 62 46 69 6c 65 53 69 7a 65 20 76 61 72 69 dbFileSize vari
6b70: 61 62 6c 65 20 69 73 20 72 65 71 75 69 72 65 64 able is required
6b80: 20 69 73 20 74 6f 20 73 75 70 70 72 65 73 73 20 is to suppress
6b90: 0a 2a 2a 20 20 20 75 6e 6e 65 63 65 73 73 61 72 .** unnecessar
6ba0: 79 20 63 61 6c 6c 73 20 74 6f 20 78 54 72 75 6e y calls to xTrun
6bb0: 63 61 74 65 28 29 20 61 66 74 65 72 20 63 6f 6d cate() after com
6bc0: 6d 69 74 74 69 6e 67 20 61 20 74 72 61 6e 73 61 mitting a transa
6bd0: 63 74 69 6f 6e 2e 20 49 66 2c 20 0a 2a 2a 20 20 ction. If, .**
6be0: 20 77 68 65 6e 20 61 20 74 72 61 6e 73 61 63 74 when a transact
6bf0: 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 ion is committed
6c00: 2c 20 74 68 65 20 64 62 46 69 6c 65 53 69 7a 65 , the dbFileSize
6c10: 20 76 61 72 69 61 62 6c 65 20 69 6e 64 69 63 61 variable indica
6c20: 74 65 73 20 0a 2a 2a 20 20 20 74 68 61 74 20 74 tes .** that t
6c30: 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
6c40: 20 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 20 is larger than
6c50: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 6d 61 the database ima
6c60: 67 65 20 28 50 61 67 65 72 2e 64 62 53 69 7a 65 ge (Pager.dbSize
6c70: 29 2c 20 0a 2a 2a 20 20 20 70 61 67 65 72 5f 74 ), .** pager_t
6c80: 72 75 6e 63 61 74 65 28 29 20 69 73 20 63 61 6c runcate() is cal
6c90: 6c 65 64 2e 20 54 68 65 20 70 61 67 65 72 5f 74 led. The pager_t
6ca0: 72 75 6e 63 61 74 65 28 29 20 63 61 6c 6c 20 75 runcate() call u
6cb0: 73 65 73 20 78 46 69 6c 65 73 69 7a 65 28 29 0a ses xFilesize().
6cc0: 2a 2a 20 20 20 74 6f 20 6d 65 61 73 75 72 65 20 ** to measure
6cd0: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
6ce0: 65 20 6f 6e 20 64 69 73 6b 2c 20 61 6e 64 20 74 e on disk, and t
6cf0: 68 65 6e 20 74 72 75 6e 63 61 74 65 73 20 69 74 hen truncates it
6d00: 20 69 66 20 72 65 71 75 69 72 65 64 2e 0a 2a 2a if required..**
6d10: 20 20 20 64 62 46 69 6c 65 53 69 7a 65 20 69 73 dbFileSize is
6d20: 20 6e 6f 74 20 75 73 65 64 20 77 68 65 6e 20 72 not used when r
6d30: 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 74 72 olling back a tr
6d40: 61 6e 73 61 63 74 69 6f 6e 2e 20 49 6e 20 74 68 ansaction. In th
6d50: 69 73 20 63 61 73 65 0a 2a 2a 20 20 20 70 61 67 is case.** pag
6d60: 65 72 5f 74 72 75 6e 63 61 74 65 28 29 20 69 73 er_truncate() is
6d70: 20 63 61 6c 6c 65 64 20 75 6e 63 6f 6e 64 69 74 called uncondit
6d80: 69 6f 6e 61 6c 6c 79 20 28 77 68 69 63 68 20 6d ionally (which m
6d90: 65 61 6e 73 20 74 68 65 72 65 20 6d 61 79 20 62 eans there may b
6da0: 65 0a 2a 2a 20 20 20 61 20 63 61 6c 6c 20 74 6f e.** a call to
6db0: 20 78 46 69 6c 65 73 69 7a 65 28 29 20 74 68 61 xFilesize() tha
6dc0: 74 20 69 73 20 6e 6f 74 20 73 74 72 69 63 74 6c t is not strictl
6dd0: 79 20 72 65 71 75 69 72 65 64 29 2e 20 49 6e 20 y required). In
6de0: 65 69 74 68 65 72 20 63 61 73 65 2c 0a 2a 2a 20 either case,.**
6df0: 20 20 70 61 67 65 72 5f 74 72 75 6e 63 61 74 65 pager_truncate
6e00: 28 29 20 6d 61 79 20 63 61 75 73 65 20 74 68 65 () may cause the
6e10: 20 66 69 6c 65 20 74 6f 20 62 65 63 6f 6d 65 20 file to become
6e20: 73 6d 61 6c 6c 65 72 20 6f 72 20 6c 61 72 67 65 smaller or large
6e30: 72 2e 0a 2a 2a 0a 2a 2a 20 64 62 48 69 6e 74 53 r..**.** dbHintS
6e40: 69 7a 65 0a 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 ize.**.** The
6e50: 64 62 48 69 6e 74 53 69 7a 65 20 76 61 72 69 61 dbHintSize varia
6e60: 62 6c 65 20 69 73 20 75 73 65 64 20 74 6f 20 6c ble is used to l
6e70: 69 6d 69 74 20 74 68 65 20 6e 75 6d 62 65 72 20 imit the number
6e80: 6f 66 20 63 61 6c 6c 73 20 6d 61 64 65 20 74 6f of calls made to
6e90: 0a 2a 2a 20 20 20 74 68 65 20 56 46 53 20 78 46 .** the VFS xF
6ea0: 69 6c 65 43 6f 6e 74 72 6f 6c 28 46 43 4e 54 4c ileControl(FCNTL
6eb0: 5f 53 49 5a 45 5f 48 49 4e 54 29 20 6d 65 74 68 _SIZE_HINT) meth
6ec0: 6f 64 2e 20 0a 2a 2a 0a 2a 2a 20 20 20 64 62 48 od. .**.** dbH
6ed0: 69 6e 74 53 69 7a 65 20 69 73 20 73 65 74 20 74 intSize is set t
6ee0: 6f 20 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 o a copy of the
6ef0: 64 62 53 69 7a 65 20 76 61 72 69 61 62 6c 65 20 dbSize variable
6f00: 77 68 65 6e 20 61 0a 2a 2a 20 20 20 77 72 69 74 when a.** writ
6f10: 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 e-transaction is
6f20: 20 6f 70 65 6e 65 64 20 28 61 74 20 74 68 65 20 opened (at the
6f30: 73 61 6d 65 20 74 69 6d 65 20 61 73 20 64 62 46 same time as dbF
6f40: 69 6c 65 53 69 7a 65 20 61 6e 64 0a 2a 2a 20 20 ileSize and.**
6f50: 20 64 62 4f 72 69 67 53 69 7a 65 29 2e 20 49 66 dbOrigSize). If
6f60: 20 74 68 65 20 78 46 69 6c 65 43 6f 6e 74 72 6f the xFileContro
6f70: 6c 28 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e l(FCNTL_SIZE_HIN
6f80: 54 29 20 6d 65 74 68 6f 64 20 69 73 20 63 61 6c T) method is cal
6f90: 6c 65 64 2c 0a 2a 2a 20 20 20 64 62 48 69 6e 74 led,.** dbHint
6fa0: 53 69 7a 65 20 69 73 20 69 6e 63 72 65 61 73 65 Size is increase
6fb0: 64 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 d to the number
6fc0: 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 63 6f of pages that co
6fd0: 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 0a rrespond to the.
6fe0: 2a 2a 20 20 20 73 69 7a 65 2d 68 69 6e 74 20 70 ** size-hint p
6ff0: 61 73 73 65 64 20 74 6f 20 74 68 65 20 6d 65 74 assed to the met
7000: 68 6f 64 20 63 61 6c 6c 2e 20 53 65 65 20 70 61 hod call. See pa
7010: 67 65 72 5f 77 72 69 74 65 5f 70 61 67 65 6c 69 ger_write_pageli
7020: 73 74 28 29 20 66 6f 72 20 0a 2a 2a 20 20 20 64 st() for .** d
7030: 65 74 61 69 6c 73 2e 0a 2a 2a 0a 2a 2a 20 65 72 etails..**.** er
7040: 72 43 6f 64 65 0a 2a 2a 0a 2a 2a 20 20 20 54 68 rCode.**.** Th
7050: 65 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 20 e Pager.errCode
7060: 76 61 72 69 61 62 6c 65 20 69 73 20 6f 6e 6c 79 variable is only
7070: 20 65 76 65 72 20 75 73 65 64 20 69 6e 20 50 41 ever used in PA
7080: 47 45 52 5f 45 52 52 4f 52 20 73 74 61 74 65 2e GER_ERROR state.
7090: 20 49 74 0a 2a 2a 20 20 20 69 73 20 73 65 74 20 It.** is set
70a0: 74 6f 20 7a 65 72 6f 20 69 6e 20 61 6c 6c 20 6f to zero in all o
70b0: 74 68 65 72 20 73 74 61 74 65 73 2e 20 49 6e 20 ther states. In
70c0: 50 41 47 45 52 5f 45 52 52 4f 52 20 73 74 61 74 PAGER_ERROR stat
70d0: 65 2c 20 50 61 67 65 72 2e 65 72 72 43 6f 64 65 e, Pager.errCode
70e0: 20 0a 2a 2a 20 20 20 69 73 20 61 6c 77 61 79 73 .** is always
70f0: 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f 46 set to SQLITE_F
7100: 55 4c 4c 2c 20 53 51 4c 49 54 45 5f 49 4f 45 52 ULL, SQLITE_IOER
7110: 52 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 R or one of the
7120: 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 58 58 58 SQLITE_IOERR_XXX
7130: 20 0a 2a 2a 20 20 20 73 75 62 2d 63 6f 64 65 73 .** sub-codes
7140: 2e 0a 2a 2a 0a 2a 2a 20 73 79 6e 63 46 6c 61 67 ..**.** syncFlag
7150: 73 2c 20 77 61 6c 53 79 6e 63 46 6c 61 67 73 0a s, walSyncFlags.
7160: 2a 2a 0a 2a 2a 20 20 20 73 79 6e 63 46 6c 61 67 **.** syncFlag
7170: 73 20 69 73 20 65 69 74 68 65 72 20 53 51 4c 49 s is either SQLI
7180: 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 28 TE_SYNC_NORMAL (
7190: 30 78 30 32 29 20 6f 72 20 53 51 4c 49 54 45 5f 0x02) or SQLITE_
71a0: 53 59 4e 43 5f 46 55 4c 4c 20 28 30 78 30 33 29 SYNC_FULL (0x03)
71b0: 2e 0a 2a 2a 20 20 20 73 79 6e 63 46 6c 61 67 73 ..** syncFlags
71c0: 20 69 73 20 75 73 65 64 20 66 6f 72 20 72 6f 6c is used for rol
71d0: 6c 62 61 63 6b 20 6d 6f 64 65 2e 20 20 77 61 6c lback mode. wal
71e0: 53 79 6e 63 46 6c 61 67 73 20 69 73 20 75 73 65 SyncFlags is use
71f0: 64 20 66 6f 72 20 57 41 4c 20 6d 6f 64 65 0a 2a d for WAL mode.*
7200: 2a 20 20 20 61 6e 64 20 63 6f 6e 74 61 69 6e 73 * and contains
7210: 20 74 68 65 20 66 6c 61 67 73 20 75 73 65 64 20 the flags used
7220: 74 6f 20 73 79 6e 63 20 74 68 65 20 63 68 65 63 to sync the chec
7230: 6b 70 6f 69 6e 74 20 6f 70 65 72 61 74 69 6f 6e kpoint operation
7240: 73 20 69 6e 20 74 68 65 0a 2a 2a 20 20 20 6c 6f s in the.** lo
7250: 77 65 72 20 74 77 6f 20 62 69 74 73 2c 20 61 6e wer two bits, an
7260: 64 20 73 79 6e 63 20 66 6c 61 67 73 20 75 73 65 d sync flags use
7270: 64 20 66 6f 72 20 74 72 61 6e 73 61 63 74 69 6f d for transactio
7280: 6e 20 63 6f 6d 6d 69 74 73 20 69 6e 20 74 68 65 n commits in the
7290: 20 57 41 4c 0a 2a 2a 20 20 20 66 69 6c 65 20 69 WAL.** file i
72a0: 6e 20 62 69 74 73 20 30 78 30 34 20 61 6e 64 20 n bits 0x04 and
72b0: 30 78 30 38 2e 20 20 49 6e 20 6f 74 68 65 72 20 0x08. In other
72c0: 77 6f 72 64 73 2c 20 74 6f 20 67 65 74 20 74 68 words, to get th
72d0: 65 20 63 6f 72 72 65 63 74 20 73 79 6e 63 20 66 e correct sync f
72e0: 6c 61 67 73 0a 2a 2a 20 20 20 66 6f 72 20 63 68 lags.** for ch
72f0: 65 63 6b 70 6f 69 6e 74 20 6f 70 65 72 61 74 69 eckpoint operati
7300: 6f 6e 73 2c 20 75 73 65 20 28 77 61 6c 53 79 6e ons, use (walSyn
7310: 63 46 6c 61 67 73 26 30 78 30 33 29 20 61 6e 64 cFlags&0x03) and
7320: 20 74 6f 20 67 65 74 20 74 68 65 20 63 6f 72 72 to get the corr
7330: 65 63 74 0a 2a 2a 20 20 20 73 79 6e 63 20 66 6c ect.** sync fl
7340: 61 67 73 20 66 6f 72 20 74 72 61 6e 73 61 63 74 ags for transact
7350: 69 6f 6e 20 63 6f 6d 6d 69 74 2c 20 75 73 65 20 ion commit, use
7360: 28 28 77 61 6c 53 79 6e 63 46 6c 61 67 73 3e 3e ((walSyncFlags>>
7370: 32 29 26 30 78 30 33 29 2e 20 20 4e 6f 74 65 0a 2)&0x03). Note.
7380: 2a 2a 20 20 20 74 68 61 74 20 77 69 74 68 20 73 ** that with s
7390: 79 6e 63 68 72 6f 6e 6f 75 73 3d 4e 4f 52 4d 41 ynchronous=NORMA
73a0: 4c 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2c 20 74 L in WAL mode, t
73b0: 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d 69 ransaction commi
73c0: 74 20 69 73 20 6e 6f 74 20 73 79 6e 63 65 64 0a t is not synced.
73d0: 2a 2a 20 20 20 6d 65 61 6e 69 6e 67 20 74 68 61 ** meaning tha
73e0: 74 20 74 68 65 20 30 78 30 34 20 61 6e 64 20 30 t the 0x04 and 0
73f0: 78 30 38 20 62 69 74 73 20 61 72 65 20 62 6f 74 x08 bits are bot
7400: 68 20 7a 65 72 6f 2e 0a 2a 2f 0a 73 74 72 75 63 h zero..*/.struc
7410: 74 20 50 61 67 65 72 20 7b 0a 20 20 73 71 6c 69 t Pager {. sqli
7420: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 3b 20 20 te3_vfs *pVfs;
7430: 20 20 20 20 20 20 20 20 2f 2a 20 4f 53 20 66 75 /* OS fu
7440: 6e 63 74 69 6f 6e 73 20 74 6f 20 75 73 65 20 66 nctions to use f
7450: 6f 72 20 49 4f 20 2a 2f 0a 20 20 75 38 20 65 78 or IO */. u8 ex
7460: 63 6c 75 73 69 76 65 4d 6f 64 65 3b 20 20 20 20 clusiveMode;
7470: 20 20 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 /* Boolea
7480: 6e 2e 20 54 72 75 65 20 69 66 20 6c 6f 63 6b 69 n. True if locki
7490: 6e 67 5f 6d 6f 64 65 3d 3d 45 58 43 4c 55 53 49 ng_mode==EXCLUSI
74a0: 56 45 20 2a 2f 0a 20 20 75 38 20 6a 6f 75 72 6e VE */. u8 journ
74b0: 61 6c 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 alMode;
74c0: 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 /* One of th
74d0: 65 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d e PAGER_JOURNALM
74e0: 4f 44 45 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a ODE_* values */.
74f0: 20 20 75 38 20 75 73 65 4a 6f 75 72 6e 61 6c 3b u8 useJournal;
7500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7510: 20 55 73 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 Use a rollback
7520: 6a 6f 75 72 6e 61 6c 20 6f 6e 20 74 68 69 73 20 journal on this
7530: 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 6e 6f 53 file */. u8 noS
7540: 79 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 ync;
7550: 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 /* Do not
7560: 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c sync the journal
7570: 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 20 75 38 if true */. u8
7580: 20 66 75 6c 6c 53 79 6e 63 3b 20 20 20 20 20 20 fullSync;
7590: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 /* Do
75a0: 65 78 74 72 61 20 73 79 6e 63 73 20 6f 66 20 74 extra syncs of t
75b0: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 20 72 he journal for r
75c0: 6f 62 75 73 74 6e 65 73 73 20 2a 2f 0a 20 20 75 obustness */. u
75d0: 38 20 65 78 74 72 61 53 79 6e 63 3b 20 20 20 20 8 extraSync;
75e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 73 79 /* sy
75f0: 6e 63 20 64 69 72 65 63 74 6f 72 79 20 61 66 74 nc directory aft
7600: 65 72 20 6a 6f 75 72 6e 61 6c 20 64 65 6c 65 74 er journal delet
7610: 65 20 2a 2f 0a 20 20 75 38 20 73 79 6e 63 46 6c e */. u8 syncFl
7620: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
7630: 20 20 20 2f 2a 20 53 59 4e 43 5f 4e 4f 52 4d 41 /* SYNC_NORMA
7640: 4c 20 6f 72 20 53 59 4e 43 5f 46 55 4c 4c 20 6f L or SYNC_FULL o
7650: 74 68 65 72 77 69 73 65 20 2a 2f 0a 20 20 75 38 therwise */. u8
7660: 20 77 61 6c 53 79 6e 63 46 6c 61 67 73 3b 20 20 walSyncFlags;
7670: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 65 /* See
7680: 20 64 65 73 63 72 69 70 74 69 6f 6e 20 61 62 6f description abo
7690: 76 65 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 46 ve */. u8 tempF
76a0: 69 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ile;
76b0: 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 /* zFilename
76c0: 20 69 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 is a temporary
76d0: 6f 72 20 69 6d 6d 75 74 61 62 6c 65 20 66 69 6c or immutable fil
76e0: 65 20 2a 2f 0a 20 20 75 38 20 6e 6f 4c 6f 63 6b e */. u8 noLock
76f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7700: 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 6c 6f 63 /* Do not loc
7710: 6b 20 28 65 78 63 65 70 74 20 69 6e 20 57 41 4c k (except in WAL
7720: 20 6d 6f 64 65 29 20 2a 2f 0a 20 20 75 38 20 72 mode) */. u8 r
7730: 65 61 64 4f 6e 6c 79 3b 20 20 20 20 20 20 20 20 eadOnly;
7740: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
7750: 66 6f 72 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 for a read-only
7760: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 38 database */. u8
7770: 20 6d 65 6d 44 62 3b 20 20 20 20 20 20 20 20 20 memDb;
7780: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
7790: 65 20 74 6f 20 69 6e 68 69 62 69 74 20 61 6c 6c e to inhibit all
77a0: 20 66 69 6c 65 20 49 2f 4f 20 2a 2f 0a 0a 20 20 file I/O */..
77b0: 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a /***************
77c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
77d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
77e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
77f0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a ***********. **
7800: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 The following b
7810: 6c 6f 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 lock contains th
7820: 6f 73 65 20 63 6c 61 73 73 20 6d 65 6d 62 65 72 ose class member
7830: 73 20 74 68 61 74 20 63 68 61 6e 67 65 20 64 75 s that change du
7840: 72 69 6e 67 0a 20 20 2a 2a 20 72 6f 75 74 69 6e ring. ** routin
7850: 65 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 43 6c e operation. Cl
7860: 61 73 73 20 6d 65 6d 62 65 72 73 20 6e 6f 74 20 ass members not
7870: 69 6e 20 74 68 69 73 20 62 6c 6f 63 6b 20 61 72 in this block ar
7880: 65 20 65 69 74 68 65 72 20 66 69 78 65 64 0a 20 e either fixed.
7890: 20 2a 2a 20 77 68 65 6e 20 74 68 65 20 70 61 67 ** when the pag
78a0: 65 72 20 69 73 20 66 69 72 73 74 20 63 72 65 61 er is first crea
78b0: 74 65 64 20 6f 72 20 65 6c 73 65 20 6f 6e 6c 79 ted or else only
78c0: 20 63 68 61 6e 67 65 20 77 68 65 6e 20 74 68 65 change when the
78d0: 72 65 20 69 73 20 61 0a 20 20 2a 2a 20 73 69 67 re is a. ** sig
78e0: 6e 69 66 69 63 61 6e 74 20 6d 6f 64 65 20 63 68 nificant mode ch
78f0: 61 6e 67 65 20 28 73 75 63 68 20 61 73 20 63 68 ange (such as ch
7900: 61 6e 67 69 6e 67 20 74 68 65 20 70 61 67 65 5f anging the page_
7910: 73 69 7a 65 2c 20 6c 6f 63 6b 69 6e 67 5f 6d 6f size, locking_mo
7920: 64 65 2c 0a 20 20 2a 2a 20 6f 72 20 74 68 65 20 de,. ** or the
7930: 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 29 2e 20 20 journal_mode).
7940: 46 72 6f 6d 20 61 6e 6f 74 68 65 72 20 76 69 65 From another vie
7950: 77 2c 20 74 68 65 73 65 20 63 6c 61 73 73 20 6d w, these class m
7960: 65 6d 62 65 72 73 20 64 65 73 63 72 69 62 65 0a embers describe.
7970: 20 20 2a 2a 20 74 68 65 20 22 73 74 61 74 65 22 ** the "state"
7980: 20 6f 66 20 74 68 65 20 70 61 67 65 72 2c 20 77 of the pager, w
7990: 68 69 6c 65 20 6f 74 68 65 72 20 63 6c 61 73 73 hile other class
79a0: 20 6d 65 6d 62 65 72 73 20 64 65 73 63 72 69 62 members describ
79b0: 65 20 74 68 65 0a 20 20 2a 2a 20 22 63 6f 6e 66 e the. ** "conf
79c0: 69 67 75 72 61 74 69 6f 6e 22 20 6f 66 20 74 68 iguration" of th
79d0: 65 20 70 61 67 65 72 2e 0a 20 20 2a 2f 0a 20 20 e pager.. */.
79e0: 75 38 20 65 53 74 61 74 65 3b 20 20 20 20 20 20 u8 eState;
79f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
7a00: 61 67 65 72 20 73 74 61 74 65 20 28 4f 50 45 4e ager state (OPEN
7a10: 2c 20 52 45 41 44 45 52 2c 20 57 52 49 54 45 52 , READER, WRITER
7a20: 5f 4c 4f 43 4b 45 44 2e 2e 29 20 2a 2f 0a 20 20 _LOCKED..) */.
7a30: 75 38 20 65 4c 6f 63 6b 3b 20 20 20 20 20 20 20 u8 eLock;
7a40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
7a50: 75 72 72 65 6e 74 20 6c 6f 63 6b 20 68 65 6c 64 urrent lock held
7a60: 20 6f 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c on database fil
7a70: 65 20 2a 2f 0a 20 20 75 38 20 63 68 61 6e 67 65 e */. u8 change
7a80: 43 6f 75 6e 74 44 6f 6e 65 3b 20 20 20 20 20 20 CountDone;
7a90: 20 20 20 2f 2a 20 53 65 74 20 61 66 74 65 72 20 /* Set after
7aa0: 69 6e 63 72 65 6d 65 6e 74 69 6e 67 20 74 68 65 incrementing the
7ab0: 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 change-counter
7ac0: 2a 2f 0a 20 20 75 38 20 73 65 74 4d 61 73 74 65 */. u8 setMaste
7ad0: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
7ae0: 20 2f 2a 20 54 72 75 65 20 69 66 20 61 20 6d 2d /* True if a m-
7af0: 6a 20 6e 61 6d 65 20 68 61 73 20 62 65 65 6e 20 j name has been
7b00: 77 72 69 74 74 65 6e 20 74 6f 20 6a 72 6e 6c 20 written to jrnl
7b10: 2a 2f 0a 20 20 75 38 20 64 6f 4e 6f 74 53 70 69 */. u8 doNotSpi
7b20: 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ll;
7b30: 20 2f 2a 20 44 6f 20 6e 6f 74 20 73 70 69 6c 6c /* Do not spill
7b40: 20 74 68 65 20 63 61 63 68 65 20 77 68 65 6e 20 the cache when
7b50: 6e 6f 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 20 75 38 non-zero */. u8
7b60: 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 3b 20 20 subjInMemory;
7b70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
7b80: 65 20 74 6f 20 75 73 65 20 69 6e 2d 6d 65 6d 6f e to use in-memo
7b90: 72 79 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 73 20 ry sub-journals
7ba0: 2a 2f 0a 20 20 75 38 20 62 55 73 65 46 65 74 63 */. u8 bUseFetc
7bb0: 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
7bc0: 20 2f 2a 20 54 72 75 65 20 74 6f 20 75 73 65 20 /* True to use
7bd0: 78 46 65 74 63 68 28 29 20 2a 2f 0a 20 20 75 38 xFetch() */. u8
7be0: 20 68 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f hasHeldSharedLo
7bf0: 63 6b 3b 20 20 20 20 20 20 20 2f 2a 20 54 72 75 ck; /* Tru
7c00: 65 20 69 66 20 61 20 73 68 61 72 65 64 20 6c 6f e if a shared lo
7c10: 63 6b 20 68 61 73 20 65 76 65 72 20 62 65 65 6e ck has ever been
7c20: 20 68 65 6c 64 20 2a 2f 0a 20 20 50 67 6e 6f 20 held */. Pgno
7c30: 64 62 53 69 7a 65 3b 20 20 20 20 20 20 20 20 20 dbSize;
7c40: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
7c50: 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 of pages in the
7c60: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 50 database */. P
7c70: 67 6e 6f 20 64 62 4f 72 69 67 53 69 7a 65 3b 20 gno dbOrigSize;
7c80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 64 62 /* db
7c90: 53 69 7a 65 20 62 65 66 6f 72 65 20 74 68 65 20 Size before the
7ca0: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74 current transact
7cb0: 69 6f 6e 20 2a 2f 0a 20 20 50 67 6e 6f 20 64 62 ion */. Pgno db
7cc0: 46 69 6c 65 53 69 7a 65 3b 20 20 20 20 20 20 20 FileSize;
7cd0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
7ce0: 66 20 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 f pages in the d
7cf0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a atabase file */.
7d00: 20 20 50 67 6e 6f 20 64 62 48 69 6e 74 53 69 7a Pgno dbHintSiz
7d10: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
7d20: 20 56 61 6c 75 65 20 70 61 73 73 65 64 20 74 6f Value passed to
7d30: 20 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 49 4e 54 FCNTL_SIZE_HINT
7d40: 20 63 61 6c 6c 20 2a 2f 0a 20 20 69 6e 74 20 65 call */. int e
7d50: 72 72 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 rrCode;
7d60: 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 /* One of
7d70: 20 73 65 76 65 72 61 6c 20 6b 69 6e 64 73 20 6f several kinds o
7d80: 66 20 65 72 72 6f 72 73 20 2a 2f 0a 20 20 69 6e f errors */. in
7d90: 74 20 6e 52 65 63 3b 20 20 20 20 20 20 20 20 20 t nRec;
7da0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
7db0: 65 73 20 6a 6f 75 72 6e 61 6c 6c 65 64 20 73 69 es journalled si
7dc0: 6e 63 65 20 6c 61 73 74 20 6a 2d 68 65 61 64 65 nce last j-heade
7dd0: 72 20 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 75 r written */. u
7de0: 33 32 20 63 6b 73 75 6d 49 6e 69 74 3b 20 20 20 32 cksumInit;
7df0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 51 75 /* Qu
7e00: 61 73 69 2d 72 61 6e 64 6f 6d 20 76 61 6c 75 65 asi-random value
7e10: 20 61 64 64 65 64 20 74 6f 20 65 76 65 72 79 20 added to every
7e20: 63 68 65 63 6b 73 75 6d 20 2a 2f 0a 20 20 75 33 checksum */. u3
7e30: 32 20 6e 53 75 62 52 65 63 3b 20 20 20 20 20 20 2 nSubRec;
7e40: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
7e50: 62 65 72 20 6f 66 20 72 65 63 6f 72 64 73 20 77 ber of records w
7e60: 72 69 74 74 65 6e 20 74 6f 20 73 75 62 2d 6a 6f ritten to sub-jo
7e70: 75 72 6e 61 6c 20 2a 2f 0a 20 20 42 69 74 76 65 urnal */. Bitve
7e80: 63 20 2a 70 49 6e 4a 6f 75 72 6e 61 6c 3b 20 20 c *pInJournal;
7e90: 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 62 69 /* One bi
7ea0: 74 20 66 6f 72 20 65 61 63 68 20 70 61 67 65 20 t for each page
7eb0: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
7ec0: 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 file */. sqlite
7ed0: 33 5f 66 69 6c 65 20 2a 66 64 3b 20 20 20 20 20 3_file *fd;
7ee0: 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 65 /* File de
7ef0: 73 63 72 69 70 74 6f 72 20 66 6f 72 20 64 61 74 scriptor for dat
7f00: 61 62 61 73 65 20 2a 2f 0a 20 20 73 71 6c 69 74 abase */. sqlit
7f10: 65 33 5f 66 69 6c 65 20 2a 6a 66 64 3b 20 20 20 e3_file *jfd;
7f20: 20 20 20 20 20 20 20 2f 2a 20 46 69 6c 65 20 64 /* File d
7f30: 65 73 63 72 69 70 74 6f 72 20 66 6f 72 20 6d 61 escriptor for ma
7f40: 69 6e 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 in journal */.
7f50: 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 73 6a sqlite3_file *sj
7f60: 66 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 46 fd; /* F
7f70: 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 66 ile descriptor f
7f80: 6f 72 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 2a or sub-journal *
7f90: 2f 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61 6c 4f /. i64 journalO
7fa0: 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ff;
7fb0: 2f 2a 20 43 75 72 72 65 6e 74 20 77 72 69 74 65 /* Current write
7fc0: 20 6f 66 66 73 65 74 20 69 6e 20 74 68 65 20 6a offset in the j
7fd0: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 ournal file */.
7fe0: 20 69 36 34 20 6a 6f 75 72 6e 61 6c 48 64 72 3b i64 journalHdr;
7ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8000: 42 79 74 65 20 6f 66 66 73 65 74 20 74 6f 20 70 Byte offset to p
8010: 72 65 76 69 6f 75 73 20 6a 6f 75 72 6e 61 6c 20 revious journal
8020: 68 65 61 64 65 72 20 2a 2f 0a 20 20 73 71 6c 69 header */. sqli
8030: 74 65 33 5f 62 61 63 6b 75 70 20 2a 70 42 61 63 te3_backup *pBac
8040: 6b 75 70 3b 20 20 20 20 2f 2a 20 50 6f 69 6e 74 kup; /* Point
8050: 65 72 20 74 6f 20 6c 69 73 74 20 6f 66 20 6f 6e er to list of on
8060: 67 6f 69 6e 67 20 62 61 63 6b 75 70 20 70 72 6f going backup pro
8070: 63 65 73 73 65 73 20 2a 2f 0a 20 20 50 61 67 65 cesses */. Page
8080: 72 53 61 76 65 70 6f 69 6e 74 20 2a 61 53 61 76 rSavepoint *aSav
8090: 65 70 6f 69 6e 74 3b 20 2f 2a 20 41 72 72 61 79 epoint; /* Array
80a0: 20 6f 66 20 61 63 74 69 76 65 20 73 61 76 65 70 of active savep
80b0: 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e oints */. int n
80c0: 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 20 Savepoint;
80d0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
80e0: 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e 20 of elements in
80f0: 61 53 61 76 65 70 6f 69 6e 74 5b 5d 20 2a 2f 0a aSavepoint[] */.
8100: 20 20 75 33 32 20 69 44 61 74 61 56 65 72 73 69 u32 iDataVersi
8110: 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a on; /*
8120: 20 43 68 61 6e 67 65 73 20 77 68 65 6e 65 76 65 Changes wheneve
8130: 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 65 r database conte
8140: 6e 74 20 63 68 61 6e 67 65 73 20 2a 2f 0a 20 20 nt changes */.
8150: 63 68 61 72 20 64 62 46 69 6c 65 56 65 72 73 5b char dbFileVers[
8160: 31 36 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 43 16]; /* C
8170: 68 61 6e 67 65 73 20 77 68 65 6e 65 76 65 72 20 hanges whenever
8180: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 63 68 database file ch
8190: 61 6e 67 65 73 20 2a 2f 0a 0a 20 20 69 6e 74 20 anges */.. int
81a0: 6e 4d 6d 61 70 4f 75 74 3b 20 20 20 20 20 20 20 nMmapOut;
81b0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
81c0: 72 20 6f 66 20 6d 6d 61 70 20 70 61 67 65 73 20 r of mmap pages
81d0: 63 75 72 72 65 6e 74 6c 79 20 6f 75 74 73 74 61 currently outsta
81e0: 6e 64 69 6e 67 20 2a 2f 0a 20 20 73 71 6c 69 74 nding */. sqlit
81f0: 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 70 3b e3_int64 szMmap;
8200: 20 20 20 20 20 20 20 2f 2a 20 44 65 73 69 72 65 /* Desire
8210: 64 20 6d 61 78 69 6d 75 6d 20 6d 6d 61 70 20 73 d maximum mmap s
8220: 69 7a 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 2a ize */. PgHdr *
8230: 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 3b 20 20 pMmapFreelist;
8240: 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
8250: 66 72 65 65 20 6d 6d 61 70 20 70 61 67 65 20 68 free mmap page h
8260: 65 61 64 65 72 73 20 28 70 44 69 72 74 79 29 20 eaders (pDirty)
8270: 2a 2f 0a 20 20 2f 2a 0a 20 20 2a 2a 20 45 6e 64 */. /*. ** End
8280: 20 6f 66 20 74 68 65 20 72 6f 75 74 69 6e 65 6c of the routinel
8290: 79 2d 63 68 61 6e 67 69 6e 67 20 63 6c 61 73 73 y-changing class
82a0: 20 6d 65 6d 62 65 72 73 0a 20 20 2a 2a 2a 2a 2a members. *****
82b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
82c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
82d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
82e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
82f0: 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 75 31 36 20 6e ******/.. u16 n
8300: 45 78 74 72 61 3b 20 20 20 20 20 20 20 20 20 20 Extra;
8310: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 20 74 68 /* Add th
8320: 69 73 20 6d 61 6e 79 20 62 79 74 65 73 20 74 6f is many bytes to
8330: 20 65 61 63 68 20 69 6e 2d 6d 65 6d 6f 72 79 20 each in-memory
8340: 70 61 67 65 20 2a 2f 0a 20 20 69 31 36 20 6e 52 page */. i16 nR
8350: 65 73 65 72 76 65 3b 20 20 20 20 20 20 20 20 20 eserve;
8360: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
8370: 6f 66 20 75 6e 75 73 65 64 20 62 79 74 65 73 20 of unused bytes
8380: 61 74 20 65 6e 64 20 6f 66 20 65 61 63 68 20 70 at end of each p
8390: 61 67 65 20 2a 2f 0a 20 20 75 33 32 20 76 66 73 age */. u32 vfs
83a0: 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 Flags;
83b0: 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 66 6f /* Flags fo
83c0: 72 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f r sqlite3_vfs.xO
83d0: 70 65 6e 28 29 20 2a 2f 0a 20 20 75 33 32 20 73 pen() */. u32 s
83e0: 65 63 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 ectorSize;
83f0: 20 20 20 20 20 20 20 2f 2a 20 41 73 73 75 6d 65 /* Assume
8400: 64 20 73 65 63 74 6f 72 20 73 69 7a 65 20 64 75 d sector size du
8410: 72 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f ring rollback */
8420: 0a 20 20 69 6e 74 20 70 61 67 65 53 69 7a 65 3b . int pageSize;
8430: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8440: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 * Number of byte
8450: 73 20 69 6e 20 61 20 70 61 67 65 20 2a 2f 0a 20 s in a page */.
8460: 20 50 67 6e 6f 20 6d 78 50 67 6e 6f 3b 20 20 20 Pgno mxPgno;
8470: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8480: 4d 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 Maximum allowed
8490: 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 size of the data
84a0: 62 61 73 65 20 2a 2f 0a 20 20 69 36 34 20 6a 6f base */. i64 jo
84b0: 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 3b 20 urnalSizeLimit;
84c0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6c 69 /* Size li
84d0: 6d 69 74 20 66 6f 72 20 70 65 72 73 69 73 74 65 mit for persiste
84e0: 6e 74 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 nt journal files
84f0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 46 69 6c */. char *zFil
8500: 65 6e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 ename;
8510: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
8520: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a database file *
8530: 2f 0a 20 20 63 68 61 72 20 2a 7a 4a 6f 75 72 6e /. char *zJourn
8540: 61 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 al;
8550: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 6a /* Name of the j
8560: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 ournal file */.
8570: 20 69 6e 74 20 28 2a 78 42 75 73 79 48 61 6e 64 int (*xBusyHand
8580: 6c 65 72 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 ler)(void*); /*
8590: 46 75 6e 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c Function to call
85a0: 20 77 68 65 6e 20 62 75 73 79 20 2a 2f 0a 20 20 when busy */.
85b0: 76 6f 69 64 20 2a 70 42 75 73 79 48 61 6e 64 6c void *pBusyHandl
85c0: 65 72 41 72 67 3b 20 20 20 20 20 20 2f 2a 20 43 erArg; /* C
85d0: 6f 6e 74 65 78 74 20 61 72 67 75 6d 65 6e 74 20 ontext argument
85e0: 66 6f 72 20 78 42 75 73 79 48 61 6e 64 6c 65 72 for xBusyHandler
85f0: 20 2a 2f 0a 20 20 69 6e 74 20 61 53 74 61 74 5b */. int aStat[
8600: 33 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 3];
8610: 20 20 2f 2a 20 54 6f 74 61 6c 20 63 61 63 68 65 /* Total cache
8620: 20 68 69 74 73 2c 20 6d 69 73 73 65 73 20 61 6e hits, misses an
8630: 64 20 77 72 69 74 65 73 20 2a 2f 0a 23 69 66 64 d writes */.#ifd
8640: 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 ef SQLITE_TEST.
8650: 20 69 6e 74 20 6e 52 65 61 64 3b 20 20 20 20 20 int nRead;
8660: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8670: 44 61 74 61 62 61 73 65 20 70 61 67 65 73 20 72 Database pages r
8680: 65 61 64 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 ead */.#endif.
8690: 76 6f 69 64 20 28 2a 78 52 65 69 6e 69 74 65 72 void (*xReiniter
86a0: 29 28 44 62 50 61 67 65 2a 29 3b 20 2f 2a 20 43 )(DbPage*); /* C
86b0: 61 6c 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 all this routine
86c0: 20 77 68 65 6e 20 72 65 6c 6f 61 64 69 6e 67 20 when reloading
86d0: 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 20 28 pages */. int (
86e0: 2a 78 47 65 74 29 28 50 61 67 65 72 2a 2c 50 67 *xGet)(Pager*,Pg
86f0: 6e 6f 2c 44 62 50 61 67 65 2a 2a 2c 69 6e 74 29 no,DbPage**,int)
8700: 3b 20 2f 2a 20 52 6f 75 74 69 6e 65 20 74 6f 20 ; /* Routine to
8710: 66 65 74 63 68 20 61 20 70 61 74 63 68 20 2a 2f fetch a patch */
8720: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 .#ifdef SQLITE_H
8730: 41 53 5f 43 4f 44 45 43 0a 20 20 76 6f 69 64 20 AS_CODEC. void
8740: 2a 28 2a 78 43 6f 64 65 63 29 28 76 6f 69 64 2a *(*xCodec)(void*
8750: 2c 76 6f 69 64 2a 2c 50 67 6e 6f 2c 69 6e 74 29 ,void*,Pgno,int)
8760: 3b 20 2f 2a 20 52 6f 75 74 69 6e 65 20 66 6f 72 ; /* Routine for
8770: 20 65 6e 2f 64 65 63 6f 64 69 6e 67 20 64 61 74 en/decoding dat
8780: 61 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 43 a */. void (*xC
8790: 6f 64 65 63 53 69 7a 65 43 68 6e 67 29 28 76 6f odecSizeChng)(vo
87a0: 69 64 2a 2c 69 6e 74 2c 69 6e 74 29 3b 20 2f 2a id*,int,int); /*
87b0: 20 4e 6f 74 69 66 79 20 6f 66 20 70 61 67 65 20 Notify of page
87c0: 73 69 7a 65 20 63 68 61 6e 67 65 73 20 2a 2f 0a size changes */.
87d0: 20 20 76 6f 69 64 20 28 2a 78 43 6f 64 65 63 46 void (*xCodecF
87e0: 72 65 65 29 28 76 6f 69 64 2a 29 3b 20 20 20 20 ree)(void*);
87f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 73 74 /* Dest
8800: 72 75 63 74 6f 72 20 66 6f 72 20 74 68 65 20 63 ructor for the c
8810: 6f 64 65 63 20 2a 2f 0a 20 20 76 6f 69 64 20 2a odec */. void *
8820: 70 43 6f 64 65 63 3b 20 20 20 20 20 20 20 20 20 pCodec;
8830: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
8840: 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6f 64 65 rgument to xCode
8850: 63 2e 2e 2e 20 6d 65 74 68 6f 64 73 20 2a 2f 0a c... methods */.
8860: 23 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a 70 #endif. char *p
8870: 54 6d 70 53 70 61 63 65 3b 20 20 20 20 20 20 20 TmpSpace;
8880: 20 20 20 20 20 2f 2a 20 50 61 67 65 72 2e 70 61 /* Pager.pa
8890: 67 65 53 69 7a 65 20 62 79 74 65 73 20 6f 66 20 geSize bytes of
88a0: 73 70 61 63 65 20 66 6f 72 20 74 6d 70 20 75 73 space for tmp us
88b0: 65 20 2a 2f 0a 20 20 50 43 61 63 68 65 20 2a 70 e */. PCache *p
88c0: 50 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 20 PCache;
88d0: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
88e0: 20 70 61 67 65 20 63 61 63 68 65 20 6f 62 6a 65 page cache obje
88f0: 63 74 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 ct */.#ifndef SQ
8900: 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 LITE_OMIT_WAL.
8910: 57 61 6c 20 2a 70 57 61 6c 3b 20 20 20 20 20 20 Wal *pWal;
8920: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
8930: 72 69 74 65 2d 61 68 65 61 64 20 6c 6f 67 20 75 rite-ahead log u
8940: 73 65 64 20 62 79 20 22 6a 6f 75 72 6e 61 6c 5f sed by "journal_
8950: 6d 6f 64 65 3d 77 61 6c 22 20 2a 2f 0a 20 20 63 mode=wal" */. c
8960: 68 61 72 20 2a 7a 57 61 6c 3b 20 20 20 20 20 20 har *zWal;
8970: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 /* Fi
8980: 6c 65 20 6e 61 6d 65 20 66 6f 72 20 77 72 69 74 le name for writ
8990: 65 2d 61 68 65 61 64 20 6c 6f 67 20 2a 2f 0a 23 e-ahead log */.#
89a0: 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 endif.};../*.**
89b0: 49 6e 64 65 78 65 73 20 66 6f 72 20 75 73 65 20 Indexes for use
89c0: 77 69 74 68 20 50 61 67 65 72 2e 61 53 74 61 74 with Pager.aStat
89d0: 5b 5d 2e 20 54 68 65 20 50 61 67 65 72 2e 61 53 []. The Pager.aS
89e0: 74 61 74 5b 5d 20 61 72 72 61 79 20 63 6f 6e 74 tat[] array cont
89f0: 61 69 6e 73 0a 2a 2a 20 74 68 65 20 76 61 6c 75 ains.** the valu
8a00: 65 73 20 61 63 63 65 73 73 65 64 20 62 79 20 70 es accessed by p
8a10: 61 73 73 69 6e 67 20 53 51 4c 49 54 45 5f 44 42 assing SQLITE_DB
8a20: 53 54 41 54 55 53 5f 43 41 43 48 45 5f 48 49 54 STATUS_CACHE_HIT
8a30: 2c 20 43 41 43 48 45 5f 4d 49 53 53 20 0a 2a 2a , CACHE_MISS .**
8a40: 20 6f 72 20 43 41 43 48 45 5f 57 52 49 54 45 20 or CACHE_WRITE
8a50: 74 6f 20 73 71 6c 69 74 65 33 5f 64 62 5f 73 74 to sqlite3_db_st
8a60: 61 74 75 73 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 atus()..*/.#defi
8a70: 6e 65 20 50 41 47 45 52 5f 53 54 41 54 5f 48 49 ne PAGER_STAT_HI
8a80: 54 20 20 20 30 0a 23 64 65 66 69 6e 65 20 50 41 T 0.#define PA
8a90: 47 45 52 5f 53 54 41 54 5f 4d 49 53 53 20 20 31 GER_STAT_MISS 1
8aa0: 0a 23 64 65 66 69 6e 65 20 50 41 47 45 52 5f 53 .#define PAGER_S
8ab0: 54 41 54 5f 57 52 49 54 45 20 32 0a 0a 2f 2a 0a TAT_WRITE 2../*.
8ac0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
8ad0: 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 global variable
8ae0: 73 20 68 6f 6c 64 20 63 6f 75 6e 74 65 72 73 20 s hold counters
8af0: 75 73 65 64 20 66 6f 72 0a 2a 2a 20 74 65 73 74 used for.** test
8b00: 69 6e 67 20 70 75 72 70 6f 73 65 73 20 6f 6e 6c ing purposes onl
8b10: 79 2e 20 20 54 68 65 73 65 20 76 61 72 69 61 62 y. These variab
8b20: 6c 65 73 20 64 6f 20 6e 6f 74 20 65 78 69 73 74 les do not exist
8b30: 20 69 6e 0a 2a 2a 20 61 20 6e 6f 6e 2d 74 65 73 in.** a non-tes
8b40: 74 69 6e 67 20 62 75 69 6c 64 2e 20 20 54 68 65 ting build. The
8b50: 73 65 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 se variables are
8b60: 20 6e 6f 74 20 74 68 72 65 61 64 2d 73 61 66 65 not thread-safe
8b70: 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
8b80: 54 45 5f 54 45 53 54 0a 69 6e 74 20 73 71 6c 69 TE_TEST.int sqli
8b90: 74 65 33 5f 70 61 67 65 72 5f 72 65 61 64 64 62 te3_pager_readdb
8ba0: 5f 63 6f 75 6e 74 20 3d 20 30 3b 20 20 20 20 2f _count = 0; /
8bb0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 66 75 6c 6c * Number of full
8bc0: 20 70 61 67 65 73 20 72 65 61 64 20 66 72 6f 6d pages read from
8bd0: 20 44 42 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 DB */.int sqlit
8be0: 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 64 62 e3_pager_writedb
8bf0: 5f 63 6f 75 6e 74 20 3d 20 30 3b 20 20 20 2f 2a _count = 0; /*
8c00: 20 4e 75 6d 62 65 72 20 6f 66 20 66 75 6c 6c 20 Number of full
8c10: 70 61 67 65 73 20 77 72 69 74 74 65 6e 20 74 6f pages written to
8c20: 20 44 42 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 DB */.int sqlit
8c30: 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 6a 5f e3_pager_writej_
8c40: 63 6f 75 6e 74 20 3d 20 30 3b 20 20 20 20 2f 2a count = 0; /*
8c50: 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
8c60: 20 77 72 69 74 74 65 6e 20 74 6f 20 6a 6f 75 72 written to jour
8c70: 6e 61 6c 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 nal */.# define
8c80: 50 41 47 45 52 5f 49 4e 43 52 28 76 29 20 20 76 PAGER_INCR(v) v
8c90: 2b 2b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e ++.#else.# defin
8ca0: 65 20 50 41 47 45 52 5f 49 4e 43 52 28 76 29 0a e PAGER_INCR(v).
8cb0: 23 65 6e 64 69 66 0a 0a 0a 0a 2f 2a 0a 2a 2a 20 #endif..../*.**
8cc0: 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 62 65 Journal files be
8cd0: 67 69 6e 20 77 69 74 68 20 74 68 65 20 66 6f 6c gin with the fol
8ce0: 6c 6f 77 69 6e 67 20 6d 61 67 69 63 20 73 74 72 lowing magic str
8cf0: 69 6e 67 2e 20 20 54 68 65 20 64 61 74 61 0a 2a ing. The data.*
8d00: 2a 20 77 61 73 20 6f 62 74 61 69 6e 65 64 20 66 * was obtained f
8d10: 72 6f 6d 20 2f 64 65 76 2f 72 61 6e 64 6f 6d 2e rom /dev/random.
8d20: 20 20 49 74 20 69 73 20 75 73 65 64 20 6f 6e 6c It is used onl
8d30: 79 20 61 73 20 61 20 73 61 6e 69 74 79 20 63 68 y as a sanity ch
8d40: 65 63 6b 2e 0a 2a 2a 0a 2a 2a 20 53 69 6e 63 65 eck..**.** Since
8d50: 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 30 2c 20 version 2.8.0,
8d60: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d the journal form
8d70: 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 64 64 69 at contains addi
8d80: 74 69 6f 6e 61 6c 20 73 61 6e 69 74 79 0a 2a 2a tional sanity.**
8d90: 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72 6d checking inform
8da0: 61 74 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 70 ation. If the p
8db0: 6f 77 65 72 20 66 61 69 6c 73 20 77 68 69 6c 65 ower fails while
8dc0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 the journal is
8dd0: 62 65 69 6e 67 0a 2a 2a 20 77 72 69 74 74 65 6e being.** written
8de0: 2c 20 73 65 6d 69 2d 72 61 6e 64 6f 6d 20 67 61 , semi-random ga
8df0: 72 62 61 67 65 20 64 61 74 61 20 6d 69 67 68 74 rbage data might
8e00: 20 61 70 70 65 61 72 20 69 6e 20 74 68 65 20 6a appear in the j
8e10: 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 6c 65 20 61 ournal.** file a
8e20: 66 74 65 72 20 70 6f 77 65 72 20 69 73 20 72 65 fter power is re
8e30: 73 74 6f 72 65 64 2e 20 20 49 66 20 61 6e 20 61 stored. If an a
8e40: 74 74 65 6d 70 74 20 69 73 20 74 68 65 6e 20 6d ttempt is then m
8e50: 61 64 65 0a 2a 2a 20 74 6f 20 72 6f 6c 6c 20 74 ade.** to roll t
8e60: 68 65 20 6a 6f 75 72 6e 61 6c 20 62 61 63 6b 2c he journal back,
8e70: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f the database co
8e80: 75 6c 64 20 62 65 20 63 6f 72 72 75 70 74 65 64 uld be corrupted
8e90: 2e 20 20 54 68 65 20 61 64 64 69 74 69 6f 6e 61 . The additiona
8ea0: 6c 0a 2a 2a 20 73 61 6e 69 74 79 20 63 68 65 63 l.** sanity chec
8eb0: 6b 69 6e 67 20 64 61 74 61 20 69 73 20 61 6e 20 king data is an
8ec0: 61 74 74 65 6d 70 74 20 74 6f 20 64 69 73 63 6f attempt to disco
8ed0: 76 65 72 20 74 68 65 20 67 61 72 62 61 67 65 20 ver the garbage
8ee0: 69 6e 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 in the.** journa
8ef0: 6c 20 61 6e 64 20 69 67 6e 6f 72 65 20 69 74 2e l and ignore it.
8f00: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 61 6e 69 74 .**.** The sanit
8f10: 79 20 63 68 65 63 6b 69 6e 67 20 69 6e 66 6f 72 y checking infor
8f20: 6d 61 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 6e mation for the n
8f30: 65 77 20 6a 6f 75 72 6e 61 6c 20 66 6f 72 6d 61 ew journal forma
8f40: 74 20 63 6f 6e 73 69 73 74 73 0a 2a 2a 20 6f 66 t consists.** of
8f50: 20 61 20 33 32 2d 62 69 74 20 63 68 65 63 6b 73 a 32-bit checks
8f60: 75 6d 20 6f 6e 20 65 61 63 68 20 70 61 67 65 20 um on each page
8f70: 6f 66 20 64 61 74 61 2e 20 20 54 68 65 20 63 68 of data. The ch
8f80: 65 63 6b 73 75 6d 20 63 6f 76 65 72 73 20 62 6f ecksum covers bo
8f90: 74 68 0a 2a 2a 20 74 68 65 20 70 61 67 65 20 6e th.** the page n
8fa0: 75 6d 62 65 72 20 61 6e 64 20 74 68 65 20 70 50 umber and the pP
8fb0: 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 20 62 ager->pageSize b
8fc0: 79 74 65 73 20 6f 66 20 64 61 74 61 20 66 6f 72 ytes of data for
8fd0: 20 74 68 65 20 70 61 67 65 2e 0a 2a 2a 20 54 68 the page..** Th
8fe0: 69 73 20 63 6b 73 75 6d 20 69 73 20 69 6e 69 74 is cksum is init
8ff0: 69 61 6c 69 7a 65 64 20 74 6f 20 61 20 33 32 2d ialized to a 32-
9000: 62 69 74 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 bit random value
9010: 20 74 68 61 74 20 61 70 70 65 61 72 73 20 69 6e that appears in
9020: 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 the.** journal
9030: 66 69 6c 65 20 72 69 67 68 74 20 61 66 74 65 72 file right after
9040: 20 74 68 65 20 68 65 61 64 65 72 2e 20 20 54 68 the header. Th
9050: 65 20 72 61 6e 64 6f 6d 20 69 6e 69 74 69 61 6c e random initial
9060: 69 7a 65 72 20 69 73 20 69 6d 70 6f 72 74 61 6e izer is importan
9070: 74 2c 0a 2a 2a 20 62 65 63 61 75 73 65 20 67 61 t,.** because ga
9080: 72 62 61 67 65 20 64 61 74 61 20 74 68 61 74 20 rbage data that
9090: 61 70 70 65 61 72 73 20 61 74 20 74 68 65 20 65 appears at the e
90a0: 6e 64 20 6f 66 20 61 20 6a 6f 75 72 6e 61 6c 20 nd of a journal
90b0: 69 73 20 6c 69 6b 65 6c 79 0a 2a 2a 20 64 61 74 is likely.** dat
90c0: 61 20 74 68 61 74 20 77 61 73 20 6f 6e 63 65 20 a that was once
90d0: 69 6e 20 6f 74 68 65 72 20 66 69 6c 65 73 20 74 in other files t
90e0: 68 61 74 20 68 61 76 65 20 6e 6f 77 20 62 65 65 hat have now bee
90f0: 6e 20 64 65 6c 65 74 65 64 2e 20 20 49 66 20 74 n deleted. If t
9100: 68 65 0a 2a 2a 20 67 61 72 62 61 67 65 20 64 61 he.** garbage da
9110: 74 61 20 63 61 6d 65 20 66 72 6f 6d 20 61 6e 20 ta came from an
9120: 6f 62 73 6f 6c 65 74 65 20 6a 6f 75 72 6e 61 6c obsolete journal
9130: 20 66 69 6c 65 2c 20 74 68 65 20 63 68 65 63 6b file, the check
9140: 73 75 6d 73 20 6d 69 67 68 74 0a 2a 2a 20 62 65 sums might.** be
9150: 20 63 6f 72 72 65 63 74 2e 20 20 42 75 74 20 62 correct. But b
9160: 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 74 y initializing t
9170: 68 65 20 63 68 65 63 6b 73 75 6d 20 74 6f 20 72 he checksum to r
9180: 61 6e 64 6f 6d 20 76 61 6c 75 65 20 77 68 69 63 andom value whic
9190: 68 0a 2a 2a 20 69 73 20 64 69 66 66 65 72 65 6e h.** is differen
91a0: 74 20 66 6f 72 20 65 76 65 72 79 20 6a 6f 75 72 t for every jour
91b0: 6e 61 6c 2c 20 77 65 20 6d 69 6e 69 6d 69 7a 65 nal, we minimize
91c0: 20 74 68 61 74 20 72 69 73 6b 2e 0a 2a 2f 0a 73 that risk..*/.s
91d0: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 6e 73 69 tatic const unsi
91e0: 67 6e 65 64 20 63 68 61 72 20 61 4a 6f 75 72 6e gned char aJourn
91f0: 61 6c 4d 61 67 69 63 5b 5d 20 3d 20 7b 0a 20 20 alMagic[] = {.
9200: 30 78 64 39 2c 20 30 78 64 35 2c 20 30 78 30 35 0xd9, 0xd5, 0x05
9210: 2c 20 30 78 66 39 2c 20 30 78 32 30 2c 20 30 78 , 0xf9, 0x20, 0x
9220: 61 31 2c 20 30 78 36 33 2c 20 30 78 64 37 2c 0a a1, 0x63, 0xd7,.
9230: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 69 };../*.** The si
9240: 7a 65 20 6f 66 20 74 68 65 20 6f 66 20 65 61 63 ze of the of eac
9250: 68 20 70 61 67 65 20 72 65 63 6f 72 64 20 69 6e h page record in
9260: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 the journal is
9270: 67 69 76 65 6e 20 62 79 0a 2a 2a 20 74 68 65 20 given by.** the
9280: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 2e following macro.
9290: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 4f 55 52 .*/.#define JOUR
92a0: 4e 41 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 NAL_PG_SZ(pPager
92b0: 29 20 20 28 28 70 50 61 67 65 72 2d 3e 70 61 67 ) ((pPager->pag
92c0: 65 53 69 7a 65 29 20 2b 20 38 29 0a 0a 2f 2a 0a eSize) + 8)../*.
92d0: 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 68 ** The journal h
92e0: 65 61 64 65 72 20 73 69 7a 65 20 66 6f 72 20 74 eader size for t
92f0: 68 69 73 20 70 61 67 65 72 2e 20 54 68 69 73 20 his pager. This
9300: 69 73 20 75 73 75 61 6c 6c 79 20 74 68 65 20 73 is usually the s
9310: 61 6d 65 20 0a 2a 2a 20 73 69 7a 65 20 61 73 20 ame .** size as
9320: 61 20 73 69 6e 67 6c 65 20 64 69 73 6b 20 73 65 a single disk se
9330: 63 74 6f 72 2e 20 53 65 65 20 61 6c 73 6f 20 73 ctor. See also s
9340: 65 74 53 65 63 74 6f 72 53 69 7a 65 28 29 2e 0a etSectorSize()..
9350: 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 4f 55 52 4e */.#define JOURN
9360: 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 AL_HDR_SZ(pPager
9370: 29 20 28 70 50 61 67 65 72 2d 3e 73 65 63 74 6f ) (pPager->secto
9380: 72 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 rSize)../*.** Th
9390: 65 20 6d 61 63 72 6f 20 4d 45 4d 44 42 20 69 73 e macro MEMDB is
93a0: 20 74 72 75 65 20 69 66 20 77 65 20 61 72 65 20 true if we are
93b0: 64 65 61 6c 69 6e 67 20 77 69 74 68 20 61 6e 20 dealing with an
93c0: 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 in-memory databa
93d0: 73 65 2e 0a 2a 2a 20 57 65 20 64 6f 20 74 68 69 se..** We do thi
93e0: 73 20 61 73 20 61 20 6d 61 63 72 6f 20 73 6f 20 s as a macro so
93f0: 74 68 61 74 20 69 66 20 74 68 65 20 53 51 4c 49 that if the SQLI
9400: 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 44 42 TE_OMIT_MEMORYDB
9410: 20 6d 61 63 72 6f 20 69 73 20 73 65 74 2c 0a 2a macro is set,.*
9420: 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 4d * the value of M
9430: 45 4d 44 42 20 77 69 6c 6c 20 62 65 20 61 20 63 EMDB will be a c
9440: 6f 6e 73 74 61 6e 74 20 61 6e 64 20 74 68 65 20 onstant and the
9450: 63 6f 6d 70 69 6c 65 72 20 77 69 6c 6c 20 6f 70 compiler will op
9460: 74 69 6d 69 7a 65 0a 2a 2a 20 6f 75 74 20 63 6f timize.** out co
9470: 64 65 20 74 68 61 74 20 77 6f 75 6c 64 20 6e 65 de that would ne
9480: 76 65 72 20 65 78 65 63 75 74 65 2e 0a 2a 2f 0a ver execute..*/.
9490: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
94a0: 49 54 5f 4d 45 4d 4f 52 59 44 42 0a 23 20 64 65 IT_MEMORYDB.# de
94b0: 66 69 6e 65 20 4d 45 4d 44 42 20 30 0a 23 65 6c fine MEMDB 0.#el
94c0: 73 65 0a 23 20 64 65 66 69 6e 65 20 4d 45 4d 44 se.# define MEMD
94d0: 42 20 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 0a B pPager->memDb.
94e0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
94f0: 65 20 6d 61 63 72 6f 20 55 53 45 46 45 54 43 48 e macro USEFETCH
9500: 20 69 73 20 74 72 75 65 20 69 66 20 77 65 20 61 is true if we a
9510: 72 65 20 61 6c 6c 6f 77 65 64 20 74 6f 20 75 73 re allowed to us
9520: 65 20 74 68 65 20 78 46 65 74 63 68 20 61 6e 64 e the xFetch and
9530: 20 78 55 6e 66 65 74 63 68 0a 2a 2a 20 69 6e 74 xUnfetch.** int
9540: 65 72 66 61 63 65 73 20 74 6f 20 61 63 63 65 73 erfaces to acces
9550: 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 75 s the database u
9560: 73 69 6e 67 20 6d 65 6d 6f 72 79 2d 6d 61 70 70 sing memory-mapp
9570: 65 64 20 49 2f 4f 2e 0a 2a 2f 0a 23 69 66 20 53 ed I/O..*/.#if S
9580: 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
9590: 49 5a 45 3e 30 0a 23 20 64 65 66 69 6e 65 20 55 IZE>0.# define U
95a0: 53 45 46 45 54 43 48 28 78 29 20 28 28 78 29 2d SEFETCH(x) ((x)-
95b0: 3e 62 55 73 65 46 65 74 63 68 29 0a 23 65 6c 73 >bUseFetch).#els
95c0: 65 0a 23 20 64 65 66 69 6e 65 20 55 53 45 46 45 e.# define USEFE
95d0: 54 43 48 28 78 29 20 30 0a 23 65 6e 64 69 66 0a TCH(x) 0.#endif.
95e0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6d 61 78 69 6d ./*.** The maxim
95f0: 75 6d 20 6c 65 67 61 6c 20 70 61 67 65 20 6e 75 um legal page nu
9600: 6d 62 65 72 20 69 73 20 28 32 5e 33 31 20 2d 20 mber is (2^31 -
9610: 31 29 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50 1)..*/.#define P
9620: 41 47 45 52 5f 4d 41 58 5f 50 47 4e 4f 20 32 31 AGER_MAX_PGNO 21
9630: 34 37 34 38 33 36 34 37 0a 0a 2f 2a 0a 2a 2a 20 47483647../*.**
9640: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 The argument to
9650: 74 68 69 73 20 6d 61 63 72 6f 20 69 73 20 61 20 this macro is a
9660: 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
9670: 28 74 79 70 65 20 73 71 6c 69 74 65 33 5f 66 69 (type sqlite3_fi
9680: 6c 65 2a 29 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 le*)..** Return
9690: 30 20 69 66 20 69 74 20 69 73 20 6e 6f 74 20 6f 0 if it is not o
96a0: 70 65 6e 2c 20 6f 72 20 6e 6f 6e 2d 7a 65 72 6f pen, or non-zero
96b0: 20 28 62 75 74 20 6e 6f 74 20 31 29 20 69 66 20 (but not 1) if
96c0: 69 74 20 69 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 it is..**.** Thi
96d0: 73 20 69 73 20 73 6f 20 74 68 61 74 20 65 78 70 s is so that exp
96e0: 72 65 73 73 69 6f 6e 73 20 63 61 6e 20 62 65 20 ressions can be
96f0: 77 72 69 74 74 65 6e 20 61 73 3a 0a 2a 2a 0a 2a written as:.**.*
9700: 2a 20 20 20 69 66 28 20 69 73 4f 70 65 6e 28 70 * if( isOpen(p
9710: 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 20 2e Pager->jfd) ){ .
9720: 2e 2e 0a 2a 2a 0a 2a 2a 20 69 6e 73 74 65 61 64 ...**.** instead
9730: 20 6f 66 0a 2a 2a 0a 2a 2a 20 20 20 69 66 28 20 of.**.** if(
9740: 70 50 61 67 65 72 2d 3e 6a 66 64 2d 3e 70 4d 65 pPager->jfd->pMe
9750: 74 68 6f 64 73 20 29 7b 20 2e 2e 2e 0a 2a 2f 0a thods ){ ....*/.
9760: 23 64 65 66 69 6e 65 20 69 73 4f 70 65 6e 28 70 #define isOpen(p
9770: 46 64 29 20 28 28 70 46 64 29 2d 3e 70 4d 65 74 Fd) ((pFd)->pMet
9780: 68 6f 64 73 21 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 hods!=0)../*.**
9790: 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 74 Return true if t
97a0: 68 69 73 20 70 61 67 65 72 20 75 73 65 73 20 61 his pager uses a
97b0: 20 77 72 69 74 65 2d 61 68 65 61 64 20 6c 6f 67 write-ahead log
97c0: 20 74 6f 20 72 65 61 64 20 70 61 67 65 20 70 67 to read page pg
97d0: 6e 6f 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 66 61 no..** Return fa
97e0: 6c 73 65 20 69 66 20 74 68 65 20 70 61 67 65 72 lse if the pager
97f0: 20 72 65 61 64 73 20 70 67 6e 6f 20 64 69 72 65 reads pgno dire
9800: 63 74 6c 79 20 66 72 6f 6d 20 74 68 65 20 64 61 ctly from the da
9810: 74 61 62 61 73 65 2e 0a 2a 2f 0a 23 69 66 20 21 tabase..*/.#if !
9820: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
9830: 4d 49 54 5f 57 41 4c 29 20 26 26 20 64 65 66 69 MIT_WAL) && defi
9840: 6e 65 64 28 53 51 4c 49 54 45 5f 44 49 52 45 43 ned(SQLITE_DIREC
9850: 54 5f 4f 56 45 52 46 4c 4f 57 5f 52 45 41 44 29 T_OVERFLOW_READ)
9860: 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 .int sqlite3Page
9870: 72 55 73 65 57 61 6c 28 50 61 67 65 72 20 2a 70 rUseWal(Pager *p
9880: 50 61 67 65 72 2c 20 50 67 6e 6f 20 70 67 6e 6f Pager, Pgno pgno
9890: 29 7b 0a 20 20 75 33 32 20 69 52 65 61 64 20 3d ){. u32 iRead =
98a0: 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 0;. int rc;.
98b0: 69 66 28 20 70 50 61 67 65 72 2d 3e 70 57 61 6c if( pPager->pWal
98c0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a ==0 ) return 0;.
98d0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 61 rc = sqlite3Wa
98e0: 6c 46 69 6e 64 46 72 61 6d 65 28 70 50 61 67 65 lFindFrame(pPage
98f0: 72 2d 3e 70 57 61 6c 2c 20 70 67 6e 6f 2c 20 26 r->pWal, pgno, &
9900: 69 52 65 61 64 29 3b 0a 20 20 72 65 74 75 72 6e iRead);. return
9910: 20 72 63 20 7c 7c 20 69 52 65 61 64 3b 0a 7d 0a rc || iRead;.}.
9920: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
9930: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 23 QLITE_OMIT_WAL.#
9940: 20 64 65 66 69 6e 65 20 70 61 67 65 72 55 73 65 define pagerUse
9950: 57 61 6c 28 78 29 20 28 28 78 29 2d 3e 70 57 61 Wal(x) ((x)->pWa
9960: 6c 21 3d 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 l!=0).#else.# de
9970: 66 69 6e 65 20 70 61 67 65 72 55 73 65 57 61 6c fine pagerUseWal
9980: 28 78 29 20 30 0a 23 20 64 65 66 69 6e 65 20 70 (x) 0.# define p
9990: 61 67 65 72 52 6f 6c 6c 62 61 63 6b 57 61 6c 28 agerRollbackWal(
99a0: 78 29 20 30 0a 23 20 64 65 66 69 6e 65 20 70 61 x) 0.# define pa
99b0: 67 65 72 57 61 6c 46 72 61 6d 65 73 28 76 2c 77 gerWalFrames(v,w
99c0: 2c 78 2c 79 29 20 30 0a 23 20 64 65 66 69 6e 65 ,x,y) 0.# define
99d0: 20 70 61 67 65 72 4f 70 65 6e 57 61 6c 49 66 50 pagerOpenWalIfP
99e0: 72 65 73 65 6e 74 28 7a 29 20 53 51 4c 49 54 45 resent(z) SQLITE
99f0: 5f 4f 4b 0a 23 20 64 65 66 69 6e 65 20 70 61 67 _OK.# define pag
9a00: 65 72 42 65 67 69 6e 52 65 61 64 54 72 61 6e 73 erBeginReadTrans
9a10: 61 63 74 69 6f 6e 28 7a 29 20 53 51 4c 49 54 45 action(z) SQLITE
9a20: 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e _OK.#endif..#ifn
9a30: 64 65 66 20 4e 44 45 42 55 47 20 0a 2f 2a 0a 2a def NDEBUG ./*.*
9a40: 2a 20 55 73 61 67 65 3a 0a 2a 2a 0a 2a 2a 20 20 * Usage:.**.**
9a50: 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 5f assert( assert_
9a60: 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 pager_state(pPag
9a70: 65 72 29 20 29 3b 0a 2a 2a 0a 2a 2a 20 54 68 69 er) );.**.** Thi
9a80: 73 20 66 75 6e 63 74 69 6f 6e 20 72 75 6e 73 20 s function runs
9a90: 6d 61 6e 79 20 61 73 73 65 72 74 73 20 74 6f 20 many asserts to
9aa0: 74 72 79 20 74 6f 20 66 69 6e 64 20 69 6e 63 6f try to find inco
9ab0: 6e 73 69 73 74 65 6e 63 69 65 73 20 69 6e 0a 2a nsistencies in.*
9ac0: 2a 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 73 * the internal s
9ad0: 74 61 74 65 20 6f 66 20 74 68 65 20 50 61 67 65 tate of the Page
9ae0: 72 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 73 74 61 r object..*/.sta
9af0: 74 69 63 20 69 6e 74 20 61 73 73 65 72 74 5f 70 tic int assert_p
9b00: 61 67 65 72 5f 73 74 61 74 65 28 50 61 67 65 72 ager_state(Pager
9b10: 20 2a 70 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 *p){. Pager *p
9b20: 50 61 67 65 72 20 3d 20 70 3b 0a 0a 20 20 2f 2a Pager = p;.. /*
9b30: 20 53 74 61 74 65 20 6d 75 73 74 20 62 65 20 76 State must be v
9b40: 61 6c 69 64 2e 20 2a 2f 0a 20 20 61 73 73 65 72 alid. */. asser
9b50: 74 28 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 t( p->eState==PA
9b60: 47 45 52 5f 4f 50 45 4e 0a 20 20 20 20 20 20 20 GER_OPEN.
9b70: 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 || p->eState==PA
9b80: 47 45 52 5f 52 45 41 44 45 52 0a 20 20 20 20 20 GER_READER.
9b90: 20 20 7c 7c 20 70 2d 3e 65 53 74 61 74 65 3d 3d || p->eState==
9ba0: 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 PAGER_WRITER_LOC
9bb0: 4b 45 44 0a 20 20 20 20 20 20 20 7c 7c 20 70 2d KED. || p-
9bc0: 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 >eState==PAGER_W
9bd0: 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 0a 20 RITER_CACHEMOD.
9be0: 20 20 20 20 20 20 7c 7c 20 70 2d 3e 65 53 74 61 || p->eSta
9bf0: 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
9c00: 5f 44 42 4d 4f 44 0a 20 20 20 20 20 20 20 7c 7c _DBMOD. ||
9c10: 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 p->eState==PAGE
9c20: 52 5f 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 R_WRITER_FINISHE
9c30: 44 0a 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 65 D. || p->e
9c40: 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 45 52 52 State==PAGER_ERR
9c50: 4f 52 0a 20 20 29 3b 0a 0a 20 20 2f 2a 20 52 65 OR. );.. /* Re
9c60: 67 61 72 64 6c 65 73 73 20 6f 66 20 74 68 65 20 gardless of the
9c70: 63 75 72 72 65 6e 74 20 73 74 61 74 65 2c 20 61 current state, a
9c80: 20 74 65 6d 70 2d 66 69 6c 65 20 63 6f 6e 6e 65 temp-file conne
9c90: 63 74 69 6f 6e 20 61 6c 77 61 79 73 20 62 65 68 ction always beh
9ca0: 61 76 65 73 0a 20 20 2a 2a 20 61 73 20 69 66 20 aves. ** as if
9cb0: 69 74 20 68 61 73 20 61 6e 20 65 78 63 6c 75 73 it has an exclus
9cc0: 69 76 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ive lock on the
9cd0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 database file. I
9ce0: 74 20 6e 65 76 65 72 20 75 70 64 61 74 65 73 0a t never updates.
9cf0: 20 20 2a 2a 20 74 68 65 20 63 68 61 6e 67 65 2d ** the change-
9d00: 63 6f 75 6e 74 65 72 20 66 69 65 6c 64 2c 20 73 counter field, s
9d10: 6f 20 74 68 65 20 63 68 61 6e 67 65 43 6f 75 6e o the changeCoun
9d20: 74 44 6f 6e 65 20 66 6c 61 67 20 69 73 20 61 6c tDone flag is al
9d30: 77 61 79 73 20 73 65 74 2e 0a 20 20 2a 2f 0a 20 ways set.. */.
9d40: 20 61 73 73 65 72 74 28 20 70 2d 3e 74 65 6d 70 assert( p->temp
9d50: 46 69 6c 65 3d 3d 30 20 7c 7c 20 70 2d 3e 65 4c File==0 || p->eL
9d60: 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock==EXCLUSIVE_L
9d70: 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 OCK );. assert(
9d80: 20 70 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 p->tempFile==0
9d90: 7c 7c 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 || pPager->chang
9da0: 65 43 6f 75 6e 74 44 6f 6e 65 20 29 3b 0a 0a 20 eCountDone );..
9db0: 20 2f 2a 20 49 66 20 74 68 65 20 75 73 65 4a 6f /* If the useJo
9dc0: 75 72 6e 61 6c 20 66 6c 61 67 20 69 73 20 63 6c urnal flag is cl
9dd0: 65 61 72 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c ear, the journal
9de0: 2d 6d 6f 64 65 20 6d 75 73 74 20 62 65 20 22 4f -mode must be "O
9df0: 46 46 22 2e 20 0a 20 20 2a 2a 20 41 6e 64 20 69 FF". . ** And i
9e00: 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d 6d 6f f the journal-mo
9e10: 64 65 20 69 73 20 22 4f 46 46 22 2c 20 74 68 65 de is "OFF", the
9e20: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6d 75 journal file mu
9e30: 73 74 20 6e 6f 74 20 62 65 20 6f 70 65 6e 2e 0a st not be open..
9e40: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
9e50: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
9e60: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
9e70: 5f 4f 46 46 20 7c 7c 20 70 2d 3e 75 73 65 4a 6f _OFF || p->useJo
9e80: 75 72 6e 61 6c 20 29 3b 0a 20 20 61 73 73 65 72 urnal );. asser
9e90: 74 28 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 t( p->journalMod
9ea0: 65 21 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c e!=PAGER_JOURNAL
9eb0: 4d 4f 44 45 5f 4f 46 46 20 7c 7c 20 21 69 73 4f MODE_OFF || !isO
9ec0: 70 65 6e 28 70 2d 3e 6a 66 64 29 20 29 3b 0a 0a pen(p->jfd) );..
9ed0: 20 20 2f 2a 20 43 68 65 63 6b 20 74 68 61 74 20 /* Check that
9ee0: 4d 45 4d 44 42 20 69 6d 70 6c 69 65 73 20 6e 6f MEMDB implies no
9ef0: 53 79 6e 63 2e 20 41 6e 64 20 61 6e 20 69 6e 2d Sync. And an in-
9f00: 6d 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 2e 20 memory journal.
9f10: 53 69 6e 63 65 20 0a 20 20 2a 2a 20 74 68 69 73 Since . ** this
9f20: 20 6d 65 61 6e 73 20 61 6e 20 69 6e 2d 6d 65 6d means an in-mem
9f30: 6f 72 79 20 70 61 67 65 72 20 70 65 72 66 6f 72 ory pager perfor
9f40: 6d 73 20 6e 6f 20 49 4f 20 61 74 20 61 6c 6c 2c ms no IO at all,
9f50: 20 69 74 20 63 61 6e 6e 6f 74 20 65 6e 63 6f 75 it cannot encou
9f60: 6e 74 65 72 20 0a 20 20 2a 2a 20 65 69 74 68 65 nter . ** eithe
9f70: 72 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 6f r SQLITE_IOERR o
9f80: 72 20 53 51 4c 49 54 45 5f 46 55 4c 4c 20 64 75 r SQLITE_FULL du
9f90: 72 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 20 6f 72 ring rollback or
9fa0: 20 77 68 69 6c 65 20 66 69 6e 61 6c 69 7a 69 6e while finalizin
9fb0: 67 20 0a 20 20 2a 2a 20 61 20 6a 6f 75 72 6e 61 g . ** a journa
9fc0: 6c 20 66 69 6c 65 2e 20 28 61 6c 74 68 6f 75 67 l file. (althoug
9fd0: 68 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 h the in-memory
9fe0: 6a 6f 75 72 6e 61 6c 20 69 6d 70 6c 65 6d 65 6e journal implemen
9ff0: 74 61 74 69 6f 6e 20 6d 61 79 20 0a 20 20 2a 2a tation may . **
a000: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 49 return SQLITE_I
a010: 4f 45 52 52 5f 4e 4f 4d 45 4d 20 77 68 69 6c 65 OERR_NOMEM while
a020: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
a030: 65 20 69 73 20 62 65 69 6e 67 20 77 72 69 74 74 e is being writt
a040: 65 6e 29 2e 20 49 74 20 0a 20 20 2a 2a 20 69 73 en). It . ** is
a050: 20 74 68 65 72 65 66 6f 72 65 20 6e 6f 74 20 70 therefore not p
a060: 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 6e 20 69 ossible for an i
a070: 6e 2d 6d 65 6d 6f 72 79 20 70 61 67 65 72 20 74 n-memory pager t
a080: 6f 20 65 6e 74 65 72 20 74 68 65 20 45 52 52 4f o enter the ERRO
a090: 52 20 0a 20 20 2a 2a 20 73 74 61 74 65 2e 0a 20 R . ** state..
a0a0: 20 2a 2f 0a 20 20 69 66 28 20 4d 45 4d 44 42 20 */. if( MEMDB
a0b0: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 ){. assert( !
a0c0: 69 73 4f 70 65 6e 28 70 2d 3e 66 64 29 20 29 3b isOpen(p->fd) );
a0d0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e . assert( p->
a0e0: 6e 6f 53 79 6e 63 20 29 3b 0a 20 20 20 20 61 73 noSync );. as
a0f0: 73 65 72 74 28 20 70 2d 3e 6a 6f 75 72 6e 61 6c sert( p->journal
a100: 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 Mode==PAGER_JOUR
a110: 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 20 NALMODE_OFF .
a120: 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 || p->jour
a130: 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
a140: 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 OURNALMODE_MEMOR
a150: 59 20 0a 20 20 20 20 29 3b 0a 20 20 20 20 61 73 Y . );. as
a160: 73 65 72 74 28 20 70 2d 3e 65 53 74 61 74 65 21 sert( p->eState!
a170: 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 26 26 20 =PAGER_ERROR &&
a180: 70 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 p->eState!=PAGER
a190: 5f 4f 50 45 4e 20 29 3b 0a 20 20 20 20 61 73 73 _OPEN );. ass
a1a0: 65 72 74 28 20 70 61 67 65 72 55 73 65 57 61 6c ert( pagerUseWal
a1b0: 28 70 29 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 (p)==0 );. }..
a1c0: 20 2f 2a 20 49 66 20 63 68 61 6e 67 65 43 6f 75 /* If changeCou
a1d0: 6e 74 44 6f 6e 65 20 69 73 20 73 65 74 2c 20 61 ntDone is set, a
a1e0: 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f RESERVED lock o
a1f0: 72 20 67 72 65 61 74 65 72 20 6d 75 73 74 20 62 r greater must b
a200: 65 20 68 65 6c 64 0a 20 20 2a 2a 20 6f 6e 20 74 e held. ** on t
a210: 68 65 20 66 69 6c 65 2e 0a 20 20 2a 2f 0a 20 20 he file.. */.
a220: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a230: 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 3d changeCountDone=
a240: 3d 30 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c =0 || pPager->eL
a250: 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c 4f ock>=RESERVED_LO
a260: 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 CK );. assert(
a270: 70 2d 3e 65 4c 6f 63 6b 21 3d 50 45 4e 44 49 4e p->eLock!=PENDIN
a280: 47 5f 4c 4f 43 4b 20 29 3b 0a 0a 20 20 73 77 69 G_LOCK );.. swi
a290: 74 63 68 28 20 70 2d 3e 65 53 74 61 74 65 20 29 tch( p->eState )
a2a0: 7b 0a 20 20 20 20 63 61 73 65 20 50 41 47 45 52 {. case PAGER
a2b0: 5f 4f 50 45 4e 3a 0a 20 20 20 20 20 20 61 73 73 _OPEN:. ass
a2c0: 65 72 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 20 ert( !MEMDB );.
a2d0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a2e0: 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 ger->errCode==SQ
a2f0: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 LITE_OK );.
a300: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
a310: 50 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28 70 PcacheRefCount(p
a320: 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3d Pager->pPCache)=
a330: 3d 30 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 65 =0 || pPager->te
a340: 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 20 20 mpFile );.
a350: 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 break;.. case
a360: 20 50 41 47 45 52 5f 52 45 41 44 45 52 3a 0a 20 PAGER_READER:.
a370: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a380: 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 ger->errCode==SQ
a390: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 LITE_OK );.
a3a0: 20 61 73 73 65 72 74 28 20 70 2d 3e 65 4c 6f 63 assert( p->eLoc
a3b0: 6b 21 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 k!=UNKNOWN_LOCK
a3c0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
a3d0: 20 70 2d 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 p->eLock>=SHARE
a3e0: 44 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 D_LOCK );.
a3f0: 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 break;.. case
a400: 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f PAGER_WRITER_LO
a410: 43 4b 45 44 3a 0a 20 20 20 20 20 20 61 73 73 65 CKED:. asse
a420: 72 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 4e rt( p->eLock!=UN
a430: 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 20 KNOWN_LOCK );.
a440: 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
a450: 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c er->errCode==SQL
a460: 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 ITE_OK );.
a470: 69 66 28 20 21 70 61 67 65 72 55 73 65 57 61 6c if( !pagerUseWal
a480: 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
a490: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 assert( p->e
a4a0: 4c 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 5f 4c Lock>=RESERVED_L
a4b0: 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 OCK );. }.
a4c0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a4d0: 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 70 50 61 ger->dbSize==pPa
a4e0: 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 20 ger->dbOrigSize
a4f0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
a500: 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 pPager->dbOrigS
a510: 69 7a 65 3d 3d 70 50 61 67 65 72 2d 3e 64 62 46 ize==pPager->dbF
a520: 69 6c 65 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 ileSize );.
a530: 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
a540: 3e 64 62 4f 72 69 67 53 69 7a 65 3d 3d 70 50 61 >dbOrigSize==pPa
a550: 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 ger->dbHintSize
a560: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
a570: 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 pPager->setMast
a580: 65 72 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 62 er==0 );. b
a590: 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 20 reak;.. case
a5a0: 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 PAGER_WRITER_CAC
a5b0: 48 45 4d 4f 44 3a 0a 20 20 20 20 20 20 61 73 73 HEMOD:. ass
a5c0: 65 72 74 28 20 70 2d 3e 65 4c 6f 63 6b 21 3d 55 ert( p->eLock!=U
a5d0: 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 29 3b 0a 20 NKNOWN_LOCK );.
a5e0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a5f0: 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 ger->errCode==SQ
a600: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 LITE_OK );.
a610: 20 69 66 28 20 21 70 61 67 65 72 55 73 65 57 61 if( !pagerUseWa
a620: 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 l(pPager) ){.
a630: 20 20 20 20 20 2f 2a 20 49 74 20 69 73 20 70 6f /* It is po
a640: 73 73 69 62 6c 65 20 74 68 61 74 20 69 66 20 6a ssible that if j
a650: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 6c 20 ournal_mode=wal
a660: 68 65 72 65 20 74 68 61 74 20 6e 65 69 74 68 65 here that neithe
a670: 72 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a r the. **
a680: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 6f journal file no
a690: 72 20 74 68 65 20 57 41 4c 20 66 69 6c 65 20 61 r the WAL file a
a6a0: 72 65 20 6f 70 65 6e 2e 20 54 68 69 73 20 68 61 re open. This ha
a6b0: 70 70 65 6e 73 20 64 75 72 69 6e 67 0a 20 20 20 ppens during.
a6c0: 20 20 20 20 20 2a 2a 20 61 20 72 6f 6c 6c 62 61 ** a rollba
a6d0: 63 6b 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 ck transaction t
a6e0: 68 61 74 20 73 77 69 74 63 68 65 73 20 66 72 6f hat switches fro
a6f0: 6d 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 6f m journal_mode=o
a700: 66 66 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f ff. ** to
a710: 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 77 61 journal_mode=wa
a720: 6c 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 l.. */.
a730: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d assert( p-
a740: 3e 65 4c 6f 63 6b 3e 3d 52 45 53 45 52 56 45 44 >eLock>=RESERVED
a750: 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 20 20 _LOCK );.
a760: 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
a770: 70 2d 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 p->jfd) .
a780: 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 || p->jour
a790: 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
a7a0: 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a OURNALMODE_OFF .
a7b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ||
a7c0: 70 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d p->journalMode==
a7d0: 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 PAGER_JOURNALMOD
a7e0: 45 5f 57 41 4c 20 0a 20 20 20 20 20 20 20 20 29 E_WAL . )
a7f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
a800: 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
a810: 64 62 4f 72 69 67 53 69 7a 65 3d 3d 70 50 61 67 dbOrigSize==pPag
a820: 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 29 er->dbFileSize )
a830: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
a840: 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 pPager->dbOrigSi
a850: 7a 65 3d 3d 70 50 61 67 65 72 2d 3e 64 62 48 69 ze==pPager->dbHi
a860: 6e 74 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 20 ntSize );.
a870: 62 72 65 61 6b 3b 0a 0a 20 20 20 20 63 61 73 65 break;.. case
a880: 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 PAGER_WRITER_DB
a890: 4d 4f 44 3a 0a 20 20 20 20 20 20 61 73 73 65 72 MOD:. asser
a8a0: 74 28 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 t( p->eLock==EXC
a8b0: 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 LUSIVE_LOCK );.
a8c0: 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 assert( pPa
a8d0: 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 ger->errCode==SQ
a8e0: 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 LITE_OK );.
a8f0: 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 assert( !pagerU
a900: 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b seWal(pPager) );
a910: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 . assert( p
a920: 2d 3e 65 4c 6f 63 6b 3e 3d 45 58 43 4c 55 53 49 ->eLock>=EXCLUSI
a930: 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 20 VE_LOCK );.
a940: 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
a950: 70 2d 3e 6a 66 64 29 20 0a 20 20 20 20 20 20 20 p->jfd) .
a960: 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 72 6e 61 || p->journa
a970: 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
a980: 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 0a 20 20 RNALMODE_OFF .
a990: 20 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a || p->j
a9a0: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
a9b0: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 R_JOURNALMODE_WA
a9c0: 4c 20 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c L . ||
a9d0: 20 28 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 (sqlite3OsDevic
a9e0: 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
a9f0: 28 70 2d 3e 66 64 29 26 53 51 4c 49 54 45 5f 49 (p->fd)&SQLITE_I
aa00: 4f 43 41 50 5f 42 41 54 43 48 5f 41 54 4f 4d 49 OCAP_BATCH_ATOMI
aa10: 43 29 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 C). );.
aa20: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
aa30: 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3c 3d 70 50 ->dbOrigSize<=pP
aa40: 61 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 ager->dbHintSize
aa50: 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b );. break;
aa60: 0a 0a 20 20 20 20 63 61 73 65 20 50 41 47 45 52 .. case PAGER
aa70: 5f 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 _WRITER_FINISHED
aa80: 3a 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 :. assert(
aa90: 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 p->eLock==EXCLUS
aaa0: 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a 20 20 20 20 IVE_LOCK );.
aab0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
aac0: 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 ->errCode==SQLIT
aad0: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 E_OK );. as
aae0: 73 65 72 74 28 20 21 70 61 67 65 72 55 73 65 57 sert( !pagerUseW
aaf0: 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 al(pPager) );.
ab00: 20 20 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 assert( isOp
ab10: 65 6e 28 70 2d 3e 6a 66 64 29 20 0a 20 20 20 20 en(p->jfd) .
ab20: 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 6a 6f 75 || p->jou
ab30: 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f rnalMode==PAGER_
ab40: 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 JOURNALMODE_OFF
ab50: 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 . || p
ab60: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
ab70: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
ab80: 5f 57 41 4c 20 0a 20 20 20 20 20 20 20 20 20 20 _WAL .
ab90: 20 7c 7c 20 28 73 71 6c 69 74 65 33 4f 73 44 65 || (sqlite3OsDe
aba0: 76 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 viceCharacterist
abb0: 69 63 73 28 70 2d 3e 66 64 29 26 53 51 4c 49 54 ics(p->fd)&SQLIT
abc0: 45 5f 49 4f 43 41 50 5f 42 41 54 43 48 5f 41 54 E_IOCAP_BATCH_AT
abd0: 4f 4d 49 43 29 0a 20 20 20 20 20 20 29 3b 0a 20 OMIC). );.
abe0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 0a 20 20 20 break;..
abf0: 20 63 61 73 65 20 50 41 47 45 52 5f 45 52 52 4f case PAGER_ERRO
ac00: 52 3a 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 72 R:. /* Ther
ac10: 65 20 6d 75 73 74 20 62 65 20 61 74 20 6c 65 61 e must be at lea
ac20: 73 74 20 6f 6e 65 20 6f 75 74 73 74 61 6e 64 69 st one outstandi
ac30: 6e 67 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 ng reference to
ac40: 74 68 65 20 70 61 67 65 72 20 69 66 0a 20 20 20 the pager if.
ac50: 20 20 20 2a 2a 20 69 6e 20 45 52 52 4f 52 20 73 ** in ERROR s
ac60: 74 61 74 65 2e 20 4f 74 68 65 72 77 69 73 65 20 tate. Otherwise
ac70: 74 68 65 20 70 61 67 65 72 20 73 68 6f 75 6c 64 the pager should
ac80: 20 68 61 76 65 20 61 6c 72 65 61 64 79 20 64 72 have already dr
ac90: 6f 70 70 65 64 0a 20 20 20 20 20 20 2a 2a 20 62 opped. ** b
aca0: 61 63 6b 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 ack to OPEN stat
acb0: 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 e.. */.
acc0: 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
acd0: 2d 3e 65 72 72 43 6f 64 65 21 3d 53 51 4c 49 54 ->errCode!=SQLIT
ace0: 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 61 73 E_OK );. as
acf0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 sert( sqlite3Pca
ad00: 63 68 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 cheRefCount(pPag
ad10: 65 72 2d 3e 70 50 43 61 63 68 65 29 3e 30 20 7c er->pPCache)>0 |
ad20: 7c 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 | pPager->tempFi
ad30: 6c 65 20 29 3b 0a 20 20 20 20 20 20 62 72 65 61 le );. brea
ad40: 6b 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e k;. }.. return
ad50: 20 31 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 1;.}.#endif /*
ad60: 69 66 6e 64 65 66 20 4e 44 45 42 55 47 20 2a 2f ifndef NDEBUG */
ad70: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
ad80: 44 45 42 55 47 20 0a 2f 2a 0a 2a 2a 20 52 65 74 DEBUG ./*.** Ret
ad90: 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 6f urn a pointer to
ada0: 20 61 20 68 75 6d 61 6e 20 72 65 61 64 61 62 6c a human readabl
adb0: 65 20 73 74 72 69 6e 67 20 69 6e 20 61 20 73 74 e string in a st
adc0: 61 74 69 63 20 62 75 66 66 65 72 0a 2a 2a 20 63 atic buffer.** c
add0: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 73 74 ontaining the st
ade0: 61 74 65 20 6f 66 20 74 68 65 20 50 61 67 65 72 ate of the Pager
adf0: 20 6f 62 6a 65 63 74 20 70 61 73 73 65 64 20 61 object passed a
ae00: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 2e 20 54 s an argument. T
ae10: 68 69 73 0a 2a 2a 20 69 73 20 69 6e 74 65 6e 64 his.** is intend
ae20: 65 64 20 74 6f 20 62 65 20 75 73 65 64 20 77 69 ed to be used wi
ae30: 74 68 69 6e 20 64 65 62 75 67 67 65 72 73 2e 20 thin debuggers.
ae40: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 61 73 20 For example, as
ae50: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 2a an alternative.*
ae60: 2a 20 74 6f 20 22 70 72 69 6e 74 20 2a 70 50 61 * to "print *pPa
ae70: 67 65 72 22 20 69 6e 20 67 64 62 3a 0a 2a 2a 0a ger" in gdb:.**.
ae80: 2a 2a 20 28 67 64 62 29 20 70 72 69 6e 74 66 20 ** (gdb) printf
ae90: 22 25 73 22 2c 20 70 72 69 6e 74 5f 70 61 67 65 "%s", print_page
aea0: 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 0a r_state(pPager).
aeb0: 2a 2f 0a 73 74 61 74 69 63 20 63 68 61 72 20 2a */.static char *
aec0: 70 72 69 6e 74 5f 70 61 67 65 72 5f 73 74 61 74 print_pager_stat
aed0: 65 28 50 61 67 65 72 20 2a 70 29 7b 0a 20 20 73 e(Pager *p){. s
aee0: 74 61 74 69 63 20 63 68 61 72 20 7a 52 65 74 5b tatic char zRet[
aef0: 31 30 32 34 5d 3b 0a 0a 20 20 73 71 6c 69 74 65 1024];.. sqlite
af00: 33 5f 73 6e 70 72 69 6e 74 66 28 31 30 32 34 2c 3_snprintf(1024,
af10: 20 7a 52 65 74 2c 0a 20 20 20 20 20 20 22 46 69 zRet,. "Fi
af20: 6c 65 6e 61 6d 65 3a 20 20 20 20 20 20 25 73 5c lename: %s\
af30: 6e 22 0a 20 20 20 20 20 20 22 53 74 61 74 65 3a n". "State:
af40: 20 20 20 20 20 20 20 20 20 25 73 20 65 72 72 43 %s errC
af50: 6f 64 65 3d 25 64 5c 6e 22 0a 20 20 20 20 20 20 ode=%d\n".
af60: 22 4c 6f 63 6b 3a 20 20 20 20 20 20 20 20 20 20 "Lock:
af70: 25 73 5c 6e 22 0a 20 20 20 20 20 20 22 4c 6f 63 %s\n". "Loc
af80: 6b 69 6e 67 20 6d 6f 64 65 3a 20 20 6c 6f 63 6b king mode: lock
af90: 69 6e 67 5f 6d 6f 64 65 3d 25 73 5c 6e 22 0a 20 ing_mode=%s\n".
afa0: 20 20 20 20 20 22 4a 6f 75 72 6e 61 6c 20 6d 6f "Journal mo
afb0: 64 65 3a 20 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 de: journal_mod
afc0: 65 3d 25 73 5c 6e 22 0a 20 20 20 20 20 20 22 42 e=%s\n". "B
afd0: 61 63 6b 69 6e 67 20 73 74 6f 72 65 3a 20 74 65 acking store: te
afe0: 6d 70 46 69 6c 65 3d 25 64 20 6d 65 6d 44 62 3d mpFile=%d memDb=
aff0: 25 64 20 75 73 65 4a 6f 75 72 6e 61 6c 3d 25 64 %d useJournal=%d
b000: 5c 6e 22 0a 20 20 20 20 20 20 22 4a 6f 75 72 6e \n". "Journ
b010: 61 6c 3a 20 20 20 20 20 20 20 6a 6f 75 72 6e 61 al: journa
b020: 6c 4f 66 66 3d 25 6c 6c 64 20 6a 6f 75 72 6e 61 lOff=%lld journa
b030: 6c 48 64 72 3d 25 6c 6c 64 5c 6e 22 0a 20 20 20 lHdr=%lld\n".
b040: 20 20 20 22 53 69 7a 65 3a 20 20 20 20 20 20 20 "Size:
b050: 20 20 20 64 62 73 69 7a 65 3d 25 64 20 64 62 4f dbsize=%d dbO
b060: 72 69 67 53 69 7a 65 3d 25 64 20 64 62 46 69 6c rigSize=%d dbFil
b070: 65 53 69 7a 65 3d 25 64 5c 6e 22 0a 20 20 20 20 eSize=%d\n".
b080: 20 20 2c 20 70 2d 3e 7a 46 69 6c 65 6e 61 6d 65 , p->zFilename
b090: 0a 20 20 20 20 20 20 2c 20 70 2d 3e 65 53 74 61 . , p->eSta
b0a0: 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 20 te==PAGER_OPEN
b0b0: 20 20 20 20 20 20 20 20 20 20 3f 20 22 4f 50 45 ? "OPE
b0c0: 4e 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e N" :. p->
b0d0: 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 eState==PAGER_RE
b0e0: 41 44 45 52 20 20 20 20 20 20 20 20 20 20 3f 20 ADER ?
b0f0: 22 52 45 41 44 45 52 22 20 3a 0a 20 20 20 20 20 "READER" :.
b100: 20 20 20 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 p->eState==PA
b110: 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f 43 4b 45 GER_WRITER_LOCKE
b120: 44 20 20 20 3f 20 22 57 52 49 54 45 52 5f 4c 4f D ? "WRITER_LO
b130: 43 4b 45 44 22 20 3a 0a 20 20 20 20 20 20 20 20 CKED" :.
b140: 70 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 p->eState==PAGER
b150: 5f 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 _WRITER_CACHEMOD
b160: 20 3f 20 22 57 52 49 54 45 52 5f 43 41 43 48 45 ? "WRITER_CACHE
b170: 4d 4f 44 22 20 3a 0a 20 20 20 20 20 20 20 20 70 MOD" :. p
b180: 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
b190: 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 20 20 20 WRITER_DBMOD
b1a0: 3f 20 22 57 52 49 54 45 52 5f 44 42 4d 4f 44 22 ? "WRITER_DBMOD"
b1b0: 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 :. p->eS
b1c0: 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
b1d0: 45 52 5f 46 49 4e 49 53 48 45 44 20 3f 20 22 57 ER_FINISHED ? "W
b1e0: 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 22 20 RITER_FINISHED"
b1f0: 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 65 53 74 :. p->eSt
b200: 61 74 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f 52 ate==PAGER_ERROR
b210: 20 20 20 20 20 20 20 20 20 20 20 3f 20 22 45 52 ? "ER
b220: 52 4f 52 22 20 3a 20 22 3f 65 72 72 6f 72 3f 22 ROR" : "?error?"
b230: 0a 20 20 20 20 20 20 2c 20 28 69 6e 74 29 70 2d . , (int)p-
b240: 3e 65 72 72 43 6f 64 65 0a 20 20 20 20 20 20 2c >errCode. ,
b250: 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f p->eLock==NO_LO
b260: 43 4b 20 20 20 20 20 20 20 20 20 3f 20 22 4e 4f CK ? "NO
b270: 5f 4c 4f 43 4b 22 20 3a 0a 20 20 20 20 20 20 20 _LOCK" :.
b280: 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 52 45 53 45 52 p->eLock==RESER
b290: 56 45 44 5f 4c 4f 43 4b 20 20 20 3f 20 22 52 45 VED_LOCK ? "RE
b2a0: 53 45 52 56 45 44 22 20 3a 0a 20 20 20 20 20 20 SERVED" :.
b2b0: 20 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c p->eLock==EXCL
b2c0: 55 53 49 56 45 5f 4c 4f 43 4b 20 20 3f 20 22 45 USIVE_LOCK ? "E
b2d0: 58 43 4c 55 53 49 56 45 22 20 3a 0a 20 20 20 20 XCLUSIVE" :.
b2e0: 20 20 20 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 53 48 p->eLock==SH
b2f0: 41 52 45 44 5f 4c 4f 43 4b 20 20 20 20 20 3f 20 ARED_LOCK ?
b300: 22 53 48 41 52 45 44 22 20 3a 0a 20 20 20 20 20 "SHARED" :.
b310: 20 20 20 70 2d 3e 65 4c 6f 63 6b 3d 3d 55 4e 4b p->eLock==UNK
b320: 4e 4f 57 4e 5f 4c 4f 43 4b 20 20 20 20 3f 20 22 NOWN_LOCK ? "
b330: 55 4e 4b 4e 4f 57 4e 22 20 3a 20 22 3f 65 72 72 UNKNOWN" : "?err
b340: 6f 72 3f 22 0a 20 20 20 20 20 20 2c 20 70 2d 3e or?". , p->
b350: 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 3f 20 exclusiveMode ?
b360: 22 65 78 63 6c 75 73 69 76 65 22 20 3a 20 22 6e "exclusive" : "n
b370: 6f 72 6d 61 6c 22 0a 20 20 20 20 20 20 2c 20 70 ormal". , p
b380: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
b390: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
b3a0: 5f 4d 45 4d 4f 52 59 20 20 20 3f 20 22 6d 65 6d _MEMORY ? "mem
b3b0: 6f 72 79 22 20 3a 0a 20 20 20 20 20 20 20 20 70 ory" :. p
b3c0: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
b3d0: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
b3e0: 5f 4f 46 46 20 20 20 20 20 20 3f 20 22 6f 66 66 _OFF ? "off
b3f0: 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a " :. p->j
b400: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
b410: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 R_JOURNALMODE_DE
b420: 4c 45 54 45 20 20 20 3f 20 22 64 65 6c 65 74 65 LETE ? "delete
b430: 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e 6a " :. p->j
b440: 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 ournalMode==PAGE
b450: 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 R_JOURNALMODE_PE
b460: 52 53 49 53 54 20 20 3f 20 22 70 65 72 73 69 73 RSIST ? "persis
b470: 74 22 20 3a 0a 20 20 20 20 20 20 20 20 70 2d 3e t" :. p->
b480: 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 journalMode==PAG
b490: 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 ER_JOURNALMODE_T
b4a0: 52 55 4e 43 41 54 45 20 3f 20 22 74 72 75 6e 63 RUNCATE ? "trunc
b4b0: 61 74 65 22 20 3a 0a 20 20 20 20 20 20 20 20 70 ate" :. p
b4c0: 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 ->journalMode==P
b4d0: 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
b4e0: 5f 57 41 4c 20 20 20 20 20 20 3f 20 22 77 61 6c _WAL ? "wal
b4f0: 22 20 3a 20 22 3f 65 72 72 6f 72 3f 22 0a 20 20 " : "?error?".
b500: 20 20 20 20 2c 20 28 69 6e 74 29 70 2d 3e 74 65 , (int)p->te
b510: 6d 70 46 69 6c 65 2c 20 28 69 6e 74 29 70 2d 3e mpFile, (int)p->
b520: 6d 65 6d 44 62 2c 20 28 69 6e 74 29 70 2d 3e 75 memDb, (int)p->u
b530: 73 65 4a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 seJournal.
b540: 2c 20 70 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2c , p->journalOff,
b550: 20 70 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 0a 20 p->journalHdr.
b560: 20 20 20 20 20 2c 20 28 69 6e 74 29 70 2d 3e 64 , (int)p->d
b570: 62 53 69 7a 65 2c 20 28 69 6e 74 29 70 2d 3e 64 bSize, (int)p->d
b580: 62 4f 72 69 67 53 69 7a 65 2c 20 28 69 6e 74 29 bOrigSize, (int)
b590: 70 2d 3e 64 62 46 69 6c 65 53 69 7a 65 0a 20 20 p->dbFileSize.
b5a0: 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 7a 52 65 );.. return zRe
b5b0: 74 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 t;.}.#endif../*
b5c0: 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 6e 63 Forward referenc
b5d0: 65 73 20 74 6f 20 74 68 65 20 76 61 72 69 6f 75 es to the variou
b5e0: 73 20 70 61 67 65 20 67 65 74 74 65 72 73 20 2a s page getters *
b5f0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 67 65 74 /.static int get
b600: 50 61 67 65 4e 6f 72 6d 61 6c 28 50 61 67 65 72 PageNormal(Pager
b610: 2a 2c 50 67 6e 6f 2c 44 62 50 61 67 65 2a 2a 2c *,Pgno,DbPage**,
b620: 69 6e 74 29 3b 0a 73 74 61 74 69 63 20 69 6e 74 int);.static int
b630: 20 67 65 74 50 61 67 65 45 72 72 6f 72 28 50 61 getPageError(Pa
b640: 67 65 72 2a 2c 50 67 6e 6f 2c 44 62 50 61 67 65 ger*,Pgno,DbPage
b650: 2a 2a 2c 69 6e 74 29 3b 0a 23 69 66 20 53 51 4c **,int);.#if SQL
b660: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
b670: 45 3e 30 0a 73 74 61 74 69 63 20 69 6e 74 20 67 E>0.static int g
b680: 65 74 50 61 67 65 4d 4d 61 70 28 50 61 67 65 72 etPageMMap(Pager
b690: 2a 2c 50 67 6e 6f 2c 44 62 50 61 67 65 2a 2a 2c *,Pgno,DbPage**,
b6a0: 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a int);.#endif../*
b6b0: 0a 2a 2a 20 53 65 74 20 74 68 65 20 50 61 67 65 .** Set the Page
b6c0: 72 2e 78 47 65 74 20 6d 65 74 68 6f 64 20 66 6f r.xGet method fo
b6d0: 72 20 74 68 65 20 61 70 70 72 6f 70 72 69 61 74 r the appropriat
b6e0: 65 20 72 6f 75 74 69 6e 65 20 75 73 65 64 20 74 e routine used t
b6f0: 6f 20 66 65 74 63 68 0a 2a 2a 20 63 6f 6e 74 65 o fetch.** conte
b700: 6e 74 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 nt from the page
b710: 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 r..*/.static voi
b720: 64 20 73 65 74 47 65 74 74 65 72 4d 65 74 68 6f d setGetterMetho
b730: 64 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 d(Pager *pPager)
b740: 7b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e {. if( pPager->
b750: 65 72 72 43 6f 64 65 20 29 7b 0a 20 20 20 20 70 errCode ){. p
b760: 50 61 67 65 72 2d 3e 78 47 65 74 20 3d 20 67 65 Pager->xGet = ge
b770: 74 50 61 67 65 45 72 72 6f 72 3b 0a 23 69 66 20 tPageError;.#if
b780: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
b790: 53 49 5a 45 3e 30 0a 20 20 7d 65 6c 73 65 20 69 SIZE>0. }else i
b7a0: 66 28 20 55 53 45 46 45 54 43 48 28 70 50 61 67 f( USEFETCH(pPag
b7b0: 65 72 29 0a 23 69 66 64 65 66 20 53 51 4c 49 54 er).#ifdef SQLIT
b7c0: 45 5f 48 41 53 5f 43 4f 44 45 43 0a 20 20 20 26 E_HAS_CODEC. &
b7d0: 26 20 70 50 61 67 65 72 2d 3e 78 43 6f 64 65 63 & pPager->xCodec
b7e0: 3d 3d 30 0a 23 65 6e 64 69 66 0a 20 20 29 7b 0a ==0.#endif. ){.
b7f0: 20 20 20 20 70 50 61 67 65 72 2d 3e 78 47 65 74 pPager->xGet
b800: 20 3d 20 67 65 74 50 61 67 65 4d 4d 61 70 3b 0a = getPageMMap;.
b810: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
b820: 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 _MAX_MMAP_SIZE>0
b830: 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 */. }else{.
b840: 20 70 50 61 67 65 72 2d 3e 78 47 65 74 20 3d 20 pPager->xGet =
b850: 67 65 74 50 61 67 65 4e 6f 72 6d 61 6c 3b 0a 20 getPageNormal;.
b860: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 }.}../*.** Retu
b870: 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 69 73 rn true if it is
b880: 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 77 72 necessary to wr
b890: 69 74 65 20 70 61 67 65 20 2a 70 50 67 20 69 6e ite page *pPg in
b8a0: 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e to the sub-journ
b8b0: 61 6c 2e 0a 2a 2a 20 41 20 70 61 67 65 20 6e 65 al..** A page ne
b8c0: 65 64 73 20 74 6f 20 62 65 20 77 72 69 74 74 65 eds to be writte
b8d0: 6e 20 69 6e 74 6f 20 74 68 65 20 73 75 62 2d 6a n into the sub-j
b8e0: 6f 75 72 6e 61 6c 20 69 66 20 74 68 65 72 65 20 ournal if there
b8f0: 65 78 69 73 74 73 20 6f 6e 65 0a 2a 2a 20 6f 72 exists one.** or
b900: 20 6d 6f 72 65 20 6f 70 65 6e 20 73 61 76 65 70 more open savep
b910: 6f 69 6e 74 73 20 66 6f 72 20 77 68 69 63 68 3a oints for which:
b920: 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 70 .**.** * The p
b930: 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 20 6c 65 age-number is le
b940: 73 73 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c ss than or equal
b950: 20 74 6f 20 50 61 67 65 72 53 61 76 65 70 6f 69 to PagerSavepoi
b960: 6e 74 2e 6e 4f 72 69 67 2c 20 61 6e 64 0a 2a 2a nt.nOrig, and.**
b970: 20 20 20 2a 20 54 68 65 20 62 69 74 20 63 6f 72 * The bit cor
b980: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 responding to th
b990: 65 20 70 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 e page-number is
b9a0: 20 6e 6f 74 20 73 65 74 20 69 6e 0a 2a 2a 20 20 not set in.**
b9b0: 20 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e PagerSavepoin
b9c0: 74 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 2e 0a t.pInSavepoint..
b9d0: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 75 */.static int su
b9e0: 62 6a 52 65 71 75 69 72 65 73 50 61 67 65 28 50 bjRequiresPage(P
b9f0: 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 50 61 gHdr *pPg){. Pa
ba00: 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 ger *pPager = pP
ba10: 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 50 61 67 g->pPager;. Pag
ba20: 65 72 53 61 76 65 70 6f 69 6e 74 20 2a 70 3b 0a erSavepoint *p;.
ba30: 20 20 50 67 6e 6f 20 70 67 6e 6f 20 3d 20 70 50 Pgno pgno = pP
ba40: 67 2d 3e 70 67 6e 6f 3b 0a 20 20 69 6e 74 20 69 g->pgno;. int i
ba50: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 ;. for(i=0; i<p
ba60: 50 61 67 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e Pager->nSavepoin
ba70: 74 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 70 20 3d t; i++){. p =
ba80: 20 26 70 50 61 67 65 72 2d 3e 61 53 61 76 65 70 &pPager->aSavep
ba90: 6f 69 6e 74 5b 69 5d 3b 0a 20 20 20 20 69 66 28 oint[i];. if(
baa0: 20 70 2d 3e 6e 4f 72 69 67 3e 3d 70 67 6e 6f 20 p->nOrig>=pgno
bab0: 26 26 20 30 3d 3d 73 71 6c 69 74 65 33 42 69 74 && 0==sqlite3Bit
bac0: 76 65 63 54 65 73 74 4e 6f 74 4e 75 6c 6c 28 70 vecTestNotNull(p
bad0: 2d 3e 70 49 6e 53 61 76 65 70 6f 69 6e 74 2c 20 ->pInSavepoint,
bae0: 70 67 6e 6f 29 20 29 7b 0a 20 20 20 20 20 20 72 pgno) ){. r
baf0: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20 eturn 1;. }.
bb00: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d }. return 0;.}
bb10: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
bb20: 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 74 75 DEBUG./*.** Retu
bb30: 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 70 rn true if the p
bb40: 61 67 65 20 69 73 20 61 6c 72 65 61 64 79 20 69 age is already i
bb50: 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 n the journal fi
bb60: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e le..*/.static in
bb70: 74 20 70 61 67 65 49 6e 4a 6f 75 72 6e 61 6c 28 t pageInJournal(
bb80: 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 Pager *pPager, P
bb90: 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 72 65 gHdr *pPg){. re
bba0: 74 75 72 6e 20 73 71 6c 69 74 65 33 42 69 74 76 turn sqlite3Bitv
bbb0: 65 63 54 65 73 74 28 70 50 61 67 65 72 2d 3e 70 ecTest(pPager->p
bbc0: 49 6e 4a 6f 75 72 6e 61 6c 2c 20 70 50 67 2d 3e InJournal, pPg->
bbd0: 70 67 6e 6f 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a pgno);.}.#endif.
bbe0: 0a 2f 2a 0a 2a 2a 20 52 65 61 64 20 61 20 33 32 ./*.** Read a 32
bbf0: 2d 62 69 74 20 69 6e 74 65 67 65 72 20 66 72 6f -bit integer fro
bc00: 6d 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c 65 m the given file
bc10: 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 53 74 descriptor. St
bc20: 6f 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 0a ore the integer.
bc30: 2a 2a 20 74 68 61 74 20 69 73 20 72 65 61 64 20 ** that is read
bc40: 69 6e 20 2a 70 52 65 73 2e 20 20 52 65 74 75 72 in *pRes. Retur
bc50: 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 n SQLITE_OK if e
bc60: 76 65 72 79 74 68 69 6e 67 20 77 6f 72 6b 65 64 verything worked
bc70: 2c 20 6f 72 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 , or an.** error
bc80: 20 63 6f 64 65 20 69 73 20 73 6f 6d 65 74 68 69 code is somethi
bc90: 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a ng goes wrong..*
bca0: 2a 0a 2a 2a 20 41 6c 6c 20 76 61 6c 75 65 73 20 *.** All values
bcb0: 61 72 65 20 73 74 6f 72 65 64 20 6f 6e 20 64 69 are stored on di
bcc0: 73 6b 20 61 73 20 62 69 67 2d 65 6e 64 69 61 6e sk as big-endian
bcd0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
bce0: 72 65 61 64 33 32 62 69 74 73 28 73 71 6c 69 74 read32bits(sqlit
bcf0: 65 33 5f 66 69 6c 65 20 2a 66 64 2c 20 69 36 34 e3_file *fd, i64
bd00: 20 6f 66 66 73 65 74 2c 20 75 33 32 20 2a 70 52 offset, u32 *pR
bd10: 65 73 29 7b 0a 20 20 75 6e 73 69 67 6e 65 64 20 es){. unsigned
bd20: 63 68 61 72 20 61 63 5b 34 5d 3b 0a 20 20 69 6e char ac[4];. in
bd30: 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 t rc = sqlite3Os
bd40: 52 65 61 64 28 66 64 2c 20 61 63 2c 20 73 69 7a Read(fd, ac, siz
bd50: 65 6f 66 28 61 63 29 2c 20 6f 66 66 73 65 74 29 eof(ac), offset)
bd60: 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
bd70: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52 TE_OK ){. *pR
bd80: 65 73 20 3d 20 73 71 6c 69 74 65 33 47 65 74 34 es = sqlite3Get4
bd90: 62 79 74 65 28 61 63 29 3b 0a 20 20 7d 0a 20 20 byte(ac);. }.
bda0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
bdb0: 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 32 2d 62 .** Write a 32-b
bdc0: 69 74 20 69 6e 74 65 67 65 72 20 69 6e 74 6f 20 it integer into
bdd0: 61 20 73 74 72 69 6e 67 20 62 75 66 66 65 72 20 a string buffer
bde0: 69 6e 20 62 69 67 2d 65 6e 64 69 61 6e 20 62 79 in big-endian by
bdf0: 74 65 20 6f 72 64 65 72 2e 0a 2a 2f 0a 23 64 65 te order..*/.#de
be00: 66 69 6e 65 20 70 75 74 33 32 62 69 74 73 28 41 fine put32bits(A
be10: 2c 42 29 20 20 73 71 6c 69 74 65 33 50 75 74 34 ,B) sqlite3Put4
be20: 62 79 74 65 28 28 75 38 2a 29 41 2c 42 29 0a 0a byte((u8*)A,B)..
be30: 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 61 20 33 ./*.** Write a 3
be40: 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 69 6e 2-bit integer in
be50: 74 6f 20 74 68 65 20 67 69 76 65 6e 20 66 69 6c to the given fil
be60: 65 20 64 65 73 63 72 69 70 74 6f 72 2e 20 20 52 e descriptor. R
be70: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a eturn SQLITE_OK.
be80: 2a 2a 20 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 ** on success or
be90: 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 an error code i
bea0: 73 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 s something goes
beb0: 20 77 72 6f 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 wrong..*/.stati
bec0: 63 20 69 6e 74 20 77 72 69 74 65 33 32 62 69 74 c int write32bit
bed0: 73 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a s(sqlite3_file *
bee0: 66 64 2c 20 69 36 34 20 6f 66 66 73 65 74 2c 20 fd, i64 offset,
bef0: 75 33 32 20 76 61 6c 29 7b 0a 20 20 63 68 61 72 u32 val){. char
bf00: 20 61 63 5b 34 5d 3b 0a 20 20 70 75 74 33 32 62 ac[4];. put32b
bf10: 69 74 73 28 61 63 2c 20 76 61 6c 29 3b 0a 20 20 its(ac, val);.
bf20: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 4f 73 return sqlite3Os
bf30: 57 72 69 74 65 28 66 64 2c 20 61 63 2c 20 34 2c Write(fd, ac, 4,
bf40: 20 6f 66 66 73 65 74 29 3b 0a 7d 0a 0a 2f 2a 0a offset);.}../*.
bf50: 2a 2a 20 55 6e 6c 6f 63 6b 20 74 68 65 20 64 61 ** Unlock the da
bf60: 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 6c tabase file to l
bf70: 65 76 65 6c 20 65 4c 6f 63 6b 2c 20 77 68 69 63 evel eLock, whic
bf80: 68 20 6d 75 73 74 20 62 65 20 65 69 74 68 65 72 h must be either
bf90: 20 4e 4f 5f 4c 4f 43 4b 0a 2a 2a 20 6f 72 20 53 NO_LOCK.** or S
bfa0: 48 41 52 45 44 5f 4c 4f 43 4b 2e 20 52 65 67 61 HARED_LOCK. Rega
bfb0: 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 rdless of whethe
bfc0: 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 63 61 6c r or not the cal
bfd0: 6c 20 74 6f 20 78 55 6e 6c 6f 63 6b 28 29 0a 2a l to xUnlock().*
bfe0: 2a 20 73 75 63 63 65 65 64 73 2c 20 73 65 74 20 * succeeds, set
bff0: 74 68 65 20 50 61 67 65 72 2e 65 4c 6f 63 6b 20 the Pager.eLock
c000: 76 61 72 69 61 62 6c 65 20 74 6f 20 6d 61 74 63 variable to matc
c010: 68 20 74 68 65 20 28 61 74 74 65 6d 70 74 65 64 h the (attempted
c020: 29 20 6e 65 77 20 6c 6f 63 6b 2e 0a 2a 2a 0a 2a ) new lock..**.*
c030: 2a 20 45 78 63 65 70 74 2c 20 69 66 20 50 61 67 * Except, if Pag
c040: 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 20 er.eLock is set
c050: 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 to UNKNOWN_LOCK
c060: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
c070: 6f 6e 20 69 73 0a 2a 2a 20 63 61 6c 6c 65 64 2c on is.** called,
c080: 20 64 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 20 69 do not modify i
c090: 74 2e 20 53 65 65 20 74 68 65 20 63 6f 6d 6d 65 t. See the comme
c0a0: 6e 74 20 61 62 6f 76 65 20 74 68 65 20 23 64 65 nt above the #de
c0b0: 66 69 6e 65 20 6f 66 20 0a 2a 2a 20 55 4e 4b 4e fine of .** UNKN
c0c0: 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 61 6e 20 OWN_LOCK for an
c0d0: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f 66 20 74 explanation of t
c0e0: 68 69 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 his..*/.static i
c0f0: 6e 74 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 nt pagerUnlockDb
c100: 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
c110: 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 20 69 6e int eLock){. in
c120: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
c130: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 21 70 50 ;.. assert( !pP
c140: 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d ager->exclusiveM
c150: 6f 64 65 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 ode || pPager->e
c160: 4c 6f 63 6b 3d 3d 65 4c 6f 63 6b 20 29 3b 0a 20 Lock==eLock );.
c170: 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b 3d 3d assert( eLock==
c180: 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 65 4c 6f 63 6b NO_LOCK || eLock
c190: 3d 3d 53 48 41 52 45 44 5f 4c 4f 43 4b 20 29 3b ==SHARED_LOCK );
c1a0: 0a 20 20 61 73 73 65 72 74 28 20 65 4c 6f 63 6b . assert( eLock
c1b0: 21 3d 4e 4f 5f 4c 4f 43 4b 20 7c 7c 20 70 61 67 !=NO_LOCK || pag
c1c0: 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
c1d0: 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 69 73 4f ==0 );. if( isO
c1e0: 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
c1f0: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 ){. assert( p
c200: 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e 3d 65 4c Pager->eLock>=eL
c210: 6f 63 6b 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 ock );. rc =
c220: 70 50 61 67 65 72 2d 3e 6e 6f 4c 6f 63 6b 20 3f pPager->noLock ?
c230: 20 53 51 4c 49 54 45 5f 4f 4b 20 3a 20 73 71 6c SQLITE_OK : sql
c240: 69 74 65 33 4f 73 55 6e 6c 6f 63 6b 28 70 50 61 ite3OsUnlock(pPa
c250: 67 65 72 2d 3e 66 64 2c 20 65 4c 6f 63 6b 29 3b ger->fd, eLock);
c260: 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d . if( pPager-
c270: 3e 65 4c 6f 63 6b 21 3d 55 4e 4b 4e 4f 57 4e 5f >eLock!=UNKNOWN_
c280: 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 LOCK ){. pP
c290: 61 67 65 72 2d 3e 65 4c 6f 63 6b 20 3d 20 28 75 ager->eLock = (u
c2a0: 38 29 65 4c 6f 63 6b 3b 0a 20 20 20 20 7d 0a 20 8)eLock;. }.
c2b0: 20 20 20 49 4f 54 52 41 43 45 28 28 22 55 4e 4c IOTRACE(("UNL
c2c0: 4f 43 4b 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 OCK %p %d\n", pP
c2d0: 61 67 65 72 2c 20 65 4c 6f 63 6b 29 29 0a 20 20 ager, eLock)).
c2e0: 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d }. return rc;.}
c2f0: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 63 6b 20 74 68 65 ../*.** Lock the
c300: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
c310: 6f 20 6c 65 76 65 6c 20 65 4c 6f 63 6b 2c 20 77 o level eLock, w
c320: 68 69 63 68 20 6d 75 73 74 20 62 65 20 65 69 74 hich must be eit
c330: 68 65 72 20 53 48 41 52 45 44 5f 4c 4f 43 4b 2c her SHARED_LOCK,
c340: 0a 2a 2a 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 .** RESERVED_LOC
c350: 4b 20 6f 72 20 45 58 43 4c 55 53 49 56 45 5f 4c K or EXCLUSIVE_L
c360: 4f 43 4b 2e 20 49 66 20 74 68 65 20 63 61 6c 6c OCK. If the call
c370: 65 72 20 69 73 20 73 75 63 63 65 73 73 66 75 6c er is successful
c380: 2c 20 73 65 74 20 74 68 65 0a 2a 2a 20 50 61 67 , set the.** Pag
c390: 65 72 2e 65 4c 6f 63 6b 20 76 61 72 69 61 62 6c er.eLock variabl
c3a0: 65 20 74 6f 20 74 68 65 20 6e 65 77 20 6c 6f 63 e to the new loc
c3b0: 6b 69 6e 67 20 73 74 61 74 65 2e 20 0a 2a 2a 0a king state. .**.
c3c0: 2a 2a 20 45 78 63 65 70 74 2c 20 69 66 20 50 61 ** Except, if Pa
c3d0: 67 65 72 2e 65 4c 6f 63 6b 20 69 73 20 73 65 74 ger.eLock is set
c3e0: 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b to UNKNOWN_LOCK
c3f0: 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 when this funct
c400: 69 6f 6e 20 69 73 20 0a 2a 2a 20 63 61 6c 6c 65 ion is .** calle
c410: 64 2c 20 64 6f 20 6e 6f 74 20 6d 6f 64 69 66 79 d, do not modify
c420: 20 69 74 20 75 6e 6c 65 73 73 20 74 68 65 20 6e it unless the n
c430: 65 77 20 6c 6f 63 6b 69 6e 67 20 73 74 61 74 65 ew locking state
c440: 20 69 73 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f is EXCLUSIVE_LO
c450: 43 4b 2e 20 0a 2a 2a 20 53 65 65 20 74 68 65 20 CK. .** See the
c460: 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 68 comment above th
c470: 65 20 23 64 65 66 69 6e 65 20 6f 66 20 55 4e 4b e #define of UNK
c480: 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f 72 20 61 6e NOWN_LOCK for an
c490: 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 0a 2a 2a explanation .**
c4a0: 20 6f 66 20 74 68 69 73 2e 0a 2a 2f 0a 73 74 61 of this..*/.sta
c4b0: 74 69 63 20 69 6e 74 20 70 61 67 65 72 4c 6f 63 tic int pagerLoc
c4c0: 6b 44 62 28 50 61 67 65 72 20 2a 70 50 61 67 65 kDb(Pager *pPage
c4d0: 72 2c 20 69 6e 74 20 65 4c 6f 63 6b 29 7b 0a 20 r, int eLock){.
c4e0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
c4f0: 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 _OK;.. assert(
c500: 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 5f 4c 4f eLock==SHARED_LO
c510: 43 4b 20 7c 7c 20 65 4c 6f 63 6b 3d 3d 52 45 53 CK || eLock==RES
c520: 45 52 56 45 44 5f 4c 4f 43 4b 20 7c 7c 20 65 4c ERVED_LOCK || eL
c530: 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c ock==EXCLUSIVE_L
c540: 4f 43 4b 20 29 3b 0a 20 20 69 66 28 20 70 50 61 OCK );. if( pPa
c550: 67 65 72 2d 3e 65 4c 6f 63 6b 3c 65 4c 6f 63 6b ger->eLock<eLock
c560: 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 || pPager->eLoc
c570: 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 k==UNKNOWN_LOCK
c580: 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 50 61 67 ){. rc = pPag
c590: 65 72 2d 3e 6e 6f 4c 6f 63 6b 20 3f 20 53 51 4c er->noLock ? SQL
c5a0: 49 54 45 5f 4f 4b 20 3a 20 73 71 6c 69 74 65 33 ITE_OK : sqlite3
c5b0: 4f 73 4c 6f 63 6b 28 70 50 61 67 65 72 2d 3e 66 OsLock(pPager->f
c5c0: 64 2c 20 65 4c 6f 63 6b 29 3b 0a 20 20 20 20 69 d, eLock);. i
c5d0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
c5e0: 20 26 26 20 28 70 50 61 67 65 72 2d 3e 65 4c 6f && (pPager->eLo
c5f0: 63 6b 21 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b ck!=UNKNOWN_LOCK
c600: 7c 7c 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 ||eLock==EXCLUSI
c610: 56 45 5f 4c 4f 43 4b 29 20 29 7b 0a 20 20 20 20 VE_LOCK) ){.
c620: 20 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 20 pPager->eLock
c630: 3d 20 28 75 38 29 65 4c 6f 63 6b 3b 0a 20 20 20 = (u8)eLock;.
c640: 20 20 20 49 4f 54 52 41 43 45 28 28 22 4c 4f 43 IOTRACE(("LOC
c650: 4b 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 K %p %d\n", pPag
c660: 65 72 2c 20 65 4c 6f 63 6b 29 29 0a 20 20 20 20 er, eLock)).
c670: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
c680: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
c690: 20 66 75 6e 63 74 69 6f 6e 20 64 65 74 65 72 6d function determ
c6a0: 69 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 ines whether or
c6b0: 6e 6f 74 20 74 68 65 20 61 74 6f 6d 69 63 2d 77 not the atomic-w
c6c0: 72 69 74 65 20 6f 72 0a 2a 2a 20 61 74 6f 6d 69 rite or.** atomi
c6d0: 63 2d 62 61 74 63 68 2d 77 72 69 74 65 20 6f 70 c-batch-write op
c6e0: 74 69 6d 69 7a 61 74 69 6f 6e 73 20 63 61 6e 20 timizations can
c6f0: 62 65 20 75 73 65 64 20 77 69 74 68 20 74 68 69 be used with thi
c700: 73 20 70 61 67 65 72 2e 20 54 68 65 0a 2a 2a 20 s pager. The.**
c710: 61 74 6f 6d 69 63 2d 77 72 69 74 65 20 6f 70 74 atomic-write opt
c720: 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 20 62 65 imization can be
c730: 20 75 73 65 64 20 69 66 3a 0a 2a 2a 0a 2a 2a 20 used if:.**.**
c740: 20 28 61 29 20 74 68 65 20 76 61 6c 75 65 20 72 (a) the value r
c750: 65 74 75 72 6e 65 64 20 62 79 20 4f 73 44 65 76 eturned by OsDev
c760: 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 iceCharacteristi
c770: 63 73 28 29 20 69 6e 64 69 63 61 74 65 73 20 74 cs() indicates t
c780: 68 61 74 0a 2a 2a 20 20 20 20 20 20 61 20 64 61 hat.** a da
c790: 74 61 62 61 73 65 20 70 61 67 65 20 6d 61 79 20 tabase page may
c7a0: 62 65 20 77 72 69 74 74 65 6e 20 61 74 6f 6d 69 be written atomi
c7b0: 63 61 6c 6c 79 2c 20 61 6e 64 0a 2a 2a 20 20 28 cally, and.** (
c7c0: 62 29 20 74 68 65 20 76 61 6c 75 65 20 72 65 74 b) the value ret
c7d0: 75 72 6e 65 64 20 62 79 20 4f 73 53 65 63 74 6f urned by OsSecto
c7e0: 72 53 69 7a 65 28 29 20 69 73 20 6c 65 73 73 20 rSize() is less
c7f0: 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 0a 2a 2a than or equal.**
c800: 20 20 20 20 20 20 74 6f 20 74 68 65 20 70 61 67 to the pag
c810: 65 20 73 69 7a 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 e size..**.** If
c820: 20 69 74 20 63 61 6e 20 62 65 20 75 73 65 64 2c it can be used,
c830: 20 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 then the value
c840: 72 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 returned is the
c850: 73 69 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 size of the jour
c860: 6e 61 6c 20 0a 2a 2a 20 66 69 6c 65 20 77 68 65 nal .** file whe
c870: 6e 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 72 6f n it contains ro
c880: 6c 6c 62 61 63 6b 20 64 61 74 61 20 66 6f 72 20 llback data for
c890: 65 78 61 63 74 6c 79 20 6f 6e 65 20 70 61 67 65 exactly one page
c8a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 74 6f 6d ..**.** The atom
c8b0: 69 63 2d 62 61 74 63 68 2d 77 72 69 74 65 20 6f ic-batch-write o
c8c0: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 63 61 6e 20 ptimization can
c8d0: 62 65 20 75 73 65 64 20 69 66 20 4f 73 44 65 76 be used if OsDev
c8e0: 69 63 65 43 68 61 72 61 63 74 65 72 69 73 74 69 iceCharacteristi
c8f0: 63 73 28 29 0a 2a 2a 20 72 65 74 75 72 6e 73 20 cs().** returns
c900: 61 20 76 61 6c 75 65 20 77 69 74 68 20 74 68 65 a value with the
c910: 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 42 41 SQLITE_IOCAP_BA
c920: 54 43 48 5f 41 54 4f 4d 49 43 20 62 69 74 20 73 TCH_ATOMIC bit s
c930: 65 74 2e 20 2d 31 20 69 73 0a 2a 2a 20 72 65 74 et. -1 is.** ret
c940: 75 72 6e 65 64 20 69 6e 20 74 68 69 73 20 63 61 urned in this ca
c950: 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 65 69 se..**.** If nei
c960: 74 68 65 72 20 6f 70 74 69 6d 69 7a 61 74 69 6f ther optimizatio
c970: 6e 20 63 61 6e 20 62 65 20 75 73 65 64 2c 20 30 n can be used, 0
c980: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f is returned..*/
c990: 0a 73 74 61 74 69 63 20 69 6e 74 20 6a 72 6e 6c .static int jrnl
c9a0: 42 75 66 66 65 72 53 69 7a 65 28 50 61 67 65 72 BufferSize(Pager
c9b0: 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 61 73 73 *pPager){. ass
c9c0: 65 72 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 0a ert( !MEMDB );..
c9d0: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
c9e0: 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 TE_ENABLE_ATOMIC
c9f0: 5f 57 52 49 54 45 29 20 5c 0a 20 7c 7c 20 64 65 _WRITE) \. || de
ca00: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
ca10: 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43 BLE_BATCH_ATOMIC
ca20: 5f 57 52 49 54 45 29 0a 20 20 69 6e 74 20 64 63 _WRITE). int dc
ca30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
ca40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
ca50: 65 76 69 63 65 20 63 68 61 72 61 63 74 65 72 69 evice characteri
ca60: 73 74 69 63 73 20 2a 2f 0a 0a 20 20 61 73 73 65 stics */.. asse
ca70: 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
ca80: 72 2d 3e 66 64 29 20 29 3b 0a 20 20 64 63 20 3d r->fd) );. dc =
ca90: 20 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 sqlite3OsDevice
caa0: 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 Characteristics(
cab0: 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 23 65 6c pPager->fd);.#el
cac0: 73 65 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 se. UNUSED_PARA
cad0: 4d 45 54 45 52 28 70 50 61 67 65 72 29 3b 0a 23 METER(pPager);.#
cae0: 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 endif..#ifdef SQ
caf0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 54 43 LITE_ENABLE_BATC
cb00: 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 0a 20 H_ATOMIC_WRITE.
cb10: 20 69 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 if( pPager->dbS
cb20: 69 7a 65 3e 30 20 26 26 20 28 64 63 26 53 51 4c ize>0 && (dc&SQL
cb30: 49 54 45 5f 49 4f 43 41 50 5f 42 41 54 43 48 5f ITE_IOCAP_BATCH_
cb40: 41 54 4f 4d 49 43 29 20 29 7b 0a 20 20 20 20 72 ATOMIC) ){. r
cb50: 65 74 75 72 6e 20 2d 31 3b 0a 20 20 7d 0a 23 65 eturn -1;. }.#e
cb60: 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
cb70: 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 ITE_ENABLE_ATOMI
cb80: 43 5f 57 52 49 54 45 0a 20 20 7b 0a 20 20 20 20 C_WRITE. {.
cb90: 69 6e 74 20 6e 53 65 63 74 6f 72 20 3d 20 70 50 int nSector = pP
cba0: 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 ager->sectorSize
cbb0: 3b 0a 20 20 20 20 69 6e 74 20 73 7a 50 61 67 65 ;. int szPage
cbc0: 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 = pPager->pageS
cbd0: 69 7a 65 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 ize;.. assert
cbe0: 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 (SQLITE_IOCAP_AT
cbf0: 4f 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e 38 OMIC512==(512>>8
cc00: 29 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 53 ));. assert(S
cc10: 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d QLITE_IOCAP_ATOM
cc20: 49 43 36 34 4b 3d 3d 28 36 35 35 33 36 3e 3e 38 IC64K==(65536>>8
cc30: 29 29 3b 0a 20 20 20 20 69 66 28 20 30 3d 3d 28 ));. if( 0==(
cc40: 64 63 26 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 dc&(SQLITE_IOCAP
cc50: 5f 41 54 4f 4d 49 43 7c 28 73 7a 50 61 67 65 3e _ATOMIC|(szPage>
cc60: 3e 38 29 29 20 7c 7c 20 6e 53 65 63 74 6f 72 3e >8)) || nSector>
cc70: 73 7a 50 61 67 65 29 20 29 7b 0a 20 20 20 20 20 szPage) ){.
cc80: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d return 0;. }
cc90: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 4a . }.. return J
cca0: 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 OURNAL_HDR_SZ(pP
ccb0: 61 67 65 72 29 20 2b 20 4a 4f 55 52 4e 41 4c 5f ager) + JOURNAL_
ccc0: 50 47 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a 23 PG_SZ(pPager);.#
ccd0: 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 endif.. return
cce0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 53 0;.}../*.** If S
ccf0: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
cd00: 53 20 69 73 20 64 65 66 69 6e 65 64 20 74 68 65 S is defined the
cd10: 6e 20 77 65 20 64 6f 20 73 6f 6d 65 20 73 61 6e n we do some san
cd20: 69 74 79 20 63 68 65 63 6b 69 6e 67 0a 2a 2a 20 ity checking.**
cd30: 6f 6e 20 74 68 65 20 63 61 63 68 65 20 75 73 69 on the cache usi
cd40: 6e 67 20 61 20 68 61 73 68 20 66 75 6e 63 74 69 ng a hash functi
cd50: 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 on. This is use
cd60: 64 20 66 6f 72 20 74 65 73 74 69 6e 67 0a 2a 2a d for testing.**
cd70: 20 61 6e 64 20 64 65 62 75 67 67 69 6e 67 20 6f and debugging o
cd80: 6e 6c 79 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 nly..*/.#ifdef S
cd90: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
cda0: 53 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 S./*.** Return a
cdb0: 20 33 32 2d 62 69 74 20 68 61 73 68 20 6f 66 20 32-bit hash of
cdc0: 74 68 65 20 70 61 67 65 20 64 61 74 61 20 66 6f the page data fo
cdd0: 72 20 70 50 61 67 65 2e 0a 2a 2f 0a 73 74 61 74 r pPage..*/.stat
cde0: 69 63 20 75 33 32 20 70 61 67 65 72 5f 64 61 74 ic u32 pager_dat
cdf0: 61 68 61 73 68 28 69 6e 74 20 6e 42 79 74 65 2c ahash(int nByte,
ce00: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
ce10: 70 44 61 74 61 29 7b 0a 20 20 75 33 32 20 68 61 pData){. u32 ha
ce20: 73 68 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 3b sh = 0;. int i;
ce30: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 42 . for(i=0; i<nB
ce40: 79 74 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 68 yte; i++){. h
ce50: 61 73 68 20 3d 20 28 68 61 73 68 2a 31 30 33 39 ash = (hash*1039
ce60: 29 20 2b 20 70 44 61 74 61 5b 69 5d 3b 0a 20 20 ) + pData[i];.
ce70: 7d 0a 20 20 72 65 74 75 72 6e 20 68 61 73 68 3b }. return hash;
ce80: 0a 7d 0a 73 74 61 74 69 63 20 75 33 32 20 70 61 .}.static u32 pa
ce90: 67 65 72 5f 70 61 67 65 68 61 73 68 28 50 67 48 ger_pagehash(PgH
cea0: 64 72 20 2a 70 50 61 67 65 29 7b 0a 20 20 72 65 dr *pPage){. re
ceb0: 74 75 72 6e 20 70 61 67 65 72 5f 64 61 74 61 68 turn pager_datah
cec0: 61 73 68 28 70 50 61 67 65 2d 3e 70 50 61 67 65 ash(pPage->pPage
ced0: 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 28 75 6e r->pageSize, (un
cee0: 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 70 50 signed char *)pP
cef0: 61 67 65 2d 3e 70 44 61 74 61 29 3b 0a 7d 0a 73 age->pData);.}.s
cf00: 74 61 74 69 63 20 76 6f 69 64 20 70 61 67 65 72 tatic void pager
cf10: 5f 73 65 74 5f 70 61 67 65 68 61 73 68 28 50 67 _set_pagehash(Pg
cf20: 48 64 72 20 2a 70 50 61 67 65 29 7b 0a 20 20 70 Hdr *pPage){. p
cf30: 50 61 67 65 2d 3e 70 61 67 65 48 61 73 68 20 3d Page->pageHash =
cf40: 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 68 28 pager_pagehash(
cf50: 70 50 61 67 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a pPage);.}../*.**
cf60: 20 54 68 65 20 43 48 45 43 4b 5f 50 41 47 45 20 The CHECK_PAGE
cf70: 6d 61 63 72 6f 20 74 61 6b 65 73 20 61 20 50 67 macro takes a Pg
cf80: 48 64 72 2a 20 61 73 20 61 6e 20 61 72 67 75 6d Hdr* as an argum
cf90: 65 6e 74 2e 20 49 66 20 53 51 4c 49 54 45 5f 43 ent. If SQLITE_C
cfa0: 48 45 43 4b 5f 50 41 47 45 53 0a 2a 2a 20 69 73 HECK_PAGES.** is
cfb0: 20 64 65 66 69 6e 65 64 2c 20 61 6e 64 20 4e 44 defined, and ND
cfc0: 45 42 55 47 20 69 73 20 6e 6f 74 20 64 65 66 69 EBUG is not defi
cfd0: 6e 65 64 2c 20 61 6e 20 61 73 73 65 72 74 28 29 ned, an assert()
cfe0: 20 73 74 61 74 65 6d 65 6e 74 20 63 68 65 63 6b statement check
cff0: 73 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 70 61 s.** that the pa
d000: 67 65 20 69 73 20 65 69 74 68 65 72 20 64 69 72 ge is either dir
d010: 74 79 20 6f 72 20 73 74 69 6c 6c 20 6d 61 74 63 ty or still matc
d020: 68 65 73 20 74 68 65 20 63 61 6c 63 75 6c 61 74 hes the calculat
d030: 65 64 20 70 61 67 65 2d 68 61 73 68 2e 0a 2a 2f ed page-hash..*/
d040: 0a 23 64 65 66 69 6e 65 20 43 48 45 43 4b 5f 50 .#define CHECK_P
d050: 41 47 45 28 78 29 20 63 68 65 63 6b 50 61 67 65 AGE(x) checkPage
d060: 28 78 29 0a 73 74 61 74 69 63 20 76 6f 69 64 20 (x).static void
d070: 63 68 65 63 6b 50 61 67 65 28 50 67 48 64 72 20 checkPage(PgHdr
d080: 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a *pPg){. Pager *
d090: 70 50 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 pPager = pPg->pP
d0a0: 61 67 65 72 3b 0a 20 20 61 73 73 65 72 74 28 20 ager;. assert(
d0b0: 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 3d pPager->eState!=
d0c0: 50 41 47 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 PAGER_ERROR );.
d0d0: 20 61 73 73 65 72 74 28 20 28 70 50 67 2d 3e 66 assert( (pPg->f
d0e0: 6c 61 67 73 26 50 47 48 44 52 5f 44 49 52 54 59 lags&PGHDR_DIRTY
d0f0: 29 20 7c 7c 20 70 50 67 2d 3e 70 61 67 65 48 61 ) || pPg->pageHa
d100: 73 68 3d 3d 70 61 67 65 72 5f 70 61 67 65 68 61 sh==pager_pageha
d110: 73 68 28 70 50 67 29 20 29 3b 0a 7d 0a 0a 23 65 sh(pPg) );.}..#e
d120: 6c 73 65 0a 23 64 65 66 69 6e 65 20 70 61 67 65 lse.#define page
d130: 72 5f 64 61 74 61 68 61 73 68 28 58 2c 59 29 20 r_datahash(X,Y)
d140: 20 30 0a 23 64 65 66 69 6e 65 20 70 61 67 65 72 0.#define pager
d150: 5f 70 61 67 65 68 61 73 68 28 58 29 20 20 30 0a _pagehash(X) 0.
d160: 23 64 65 66 69 6e 65 20 70 61 67 65 72 5f 73 65 #define pager_se
d170: 74 5f 70 61 67 65 68 61 73 68 28 58 29 0a 23 64 t_pagehash(X).#d
d180: 65 66 69 6e 65 20 43 48 45 43 4b 5f 50 41 47 45 efine CHECK_PAGE
d190: 28 78 29 0a 23 65 6e 64 69 66 20 20 2f 2a 20 53 (x).#endif /* S
d1a0: 51 4c 49 54 45 5f 43 48 45 43 4b 5f 50 41 47 45 QLITE_CHECK_PAGE
d1b0: 53 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e S */../*.** When
d1c0: 20 74 68 69 73 20 69 73 20 63 61 6c 6c 65 64 20 this is called
d1d0: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
d1e0: 20 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65 for pager pPage
d1f0: 72 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 2e 0a r must be open..
d200: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e ** This function
d210: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 72 65 61 attempts to rea
d220: 64 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e d a master journ
d230: 61 6c 20 66 69 6c 65 20 6e 61 6d 65 20 66 72 6f al file name fro
d240: 6d 20 74 68 65 20 0a 2a 2a 20 65 6e 64 20 6f 66 m the .** end of
d250: 20 74 68 65 20 66 69 6c 65 20 61 6e 64 2c 20 69 the file and, i
d260: 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 63 6f f successful, co
d270: 70 69 65 73 20 69 74 20 69 6e 74 6f 20 6d 65 6d pies it into mem
d280: 6f 72 79 20 73 75 70 70 6c 69 65 64 20 0a 2a 2a ory supplied .**
d290: 20 62 79 20 74 68 65 20 63 61 6c 6c 65 72 2e 20 by the caller.
d2a0: 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 61 62 6f See comments abo
d2b0: 76 65 20 77 72 69 74 65 4d 61 73 74 65 72 4a 6f ve writeMasterJo
d2c0: 75 72 6e 61 6c 28 29 20 66 6f 72 20 74 68 65 20 urnal() for the
d2d0: 66 6f 72 6d 61 74 0a 2a 2a 20 75 73 65 64 20 74 format.** used t
d2e0: 6f 20 73 74 6f 72 65 20 61 20 6d 61 73 74 65 72 o store a master
d2f0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 journal file na
d300: 6d 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 me at the end of
d310: 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e a journal file.
d320: 0a 2a 2a 0a 2a 2a 20 7a 4d 61 73 74 65 72 20 6d .**.** zMaster m
d330: 75 73 74 20 70 6f 69 6e 74 20 74 6f 20 61 20 62 ust point to a b
d340: 75 66 66 65 72 20 6f 66 20 61 74 20 6c 65 61 73 uffer of at leas
d350: 74 20 6e 4d 61 73 74 65 72 20 62 79 74 65 73 20 t nMaster bytes
d360: 61 6c 6c 6f 63 61 74 65 64 20 62 79 0a 2a 2a 20 allocated by.**
d370: 74 68 65 20 63 61 6c 6c 65 72 2e 20 54 68 69 73 the caller. This
d380: 20 73 68 6f 75 6c 64 20 62 65 20 73 71 6c 69 74 should be sqlit
d390: 65 33 5f 76 66 73 2e 6d 78 50 61 74 68 6e 61 6d e3_vfs.mxPathnam
d3a0: 65 2b 31 20 28 74 6f 20 65 6e 73 75 72 65 20 74 e+1 (to ensure t
d3b0: 68 65 72 65 20 69 73 0a 2a 2a 20 65 6e 6f 75 67 here is.** enoug
d3c0: 68 20 73 70 61 63 65 20 74 6f 20 77 72 69 74 65 h space to write
d3d0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 the master jour
d3e0: 6e 61 6c 20 6e 61 6d 65 29 2e 20 49 66 20 74 68 nal name). If th
d3f0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
d400: 0a 2a 2a 20 6e 61 6d 65 20 69 6e 20 74 68 65 20 .** name in the
d410: 6a 6f 75 72 6e 61 6c 20 69 73 20 6c 6f 6e 67 65 journal is longe
d420: 72 20 74 68 61 6e 20 6e 4d 61 73 74 65 72 20 62 r than nMaster b
d430: 79 74 65 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 ytes (including
d440: 61 0a 2a 2a 20 6e 75 6c 2d 74 65 72 6d 69 6e 61 a.** nul-termina
d450: 74 6f 72 29 2c 20 74 68 65 6e 20 74 68 69 73 20 tor), then this
d460: 69 73 20 68 61 6e 64 6c 65 64 20 61 73 20 69 66 is handled as if
d470: 20 6e 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e no master journ
d480: 61 6c 20 6e 61 6d 65 0a 2a 2a 20 77 65 72 65 20 al name.** were
d490: 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 6a present in the j
d4a0: 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 ournal..**.** If
d4b0: 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 a master journa
d4c0: 6c 20 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 70 l file name is p
d4d0: 72 65 73 65 6e 74 20 61 74 20 74 68 65 20 65 6e resent at the en
d4e0: 64 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c d of the journal
d4f0: 0a 2a 2a 20 66 69 6c 65 2c 20 74 68 65 6e 20 69 .** file, then i
d500: 74 20 69 73 20 63 6f 70 69 65 64 20 69 6e 74 6f t is copied into
d510: 20 74 68 65 20 62 75 66 66 65 72 20 70 6f 69 6e the buffer poin
d520: 74 65 64 20 74 6f 20 62 79 20 7a 4d 61 73 74 65 ted to by zMaste
d530: 72 2e 20 41 0a 2a 2a 20 6e 75 6c 2d 74 65 72 6d r. A.** nul-term
d540: 69 6e 61 74 6f 72 20 62 79 74 65 20 69 73 20 61 inator byte is a
d550: 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 62 ppended to the b
d560: 75 66 66 65 72 20 66 6f 6c 6c 6f 77 69 6e 67 20 uffer following
d570: 74 68 65 20 6d 61 73 74 65 72 0a 2a 2a 20 6a 6f the master.** jo
d580: 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65 2e urnal file name.
d590: 0a 2a 2a 0a 2a 2a 20 49 66 20 69 74 20 69 73 20 .**.** If it is
d5a0: 64 65 74 65 72 6d 69 6e 65 64 20 74 68 61 74 20 determined that
d5b0: 6e 6f 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 no master journa
d5c0: 6c 20 66 69 6c 65 20 6e 61 6d 65 20 69 73 20 70 l file name is p
d5d0: 72 65 73 65 6e 74 20 0a 2a 2a 20 7a 4d 61 73 74 resent .** zMast
d5e0: 65 72 5b 30 5d 20 69 73 20 73 65 74 20 74 6f 20 er[0] is set to
d5f0: 30 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f 4b 20 0 and SQLITE_OK
d600: 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 returned..**.**
d610: 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 If an error occu
d620: 72 73 20 77 68 69 6c 65 20 72 65 61 64 69 6e 67 rs while reading
d630: 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 from the journa
d640: 6c 20 66 69 6c 65 2c 20 61 6e 20 53 51 4c 69 74 l file, an SQLit
d650: 65 0a 2a 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 e.** error code
d660: 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a is returned..*/.
d670: 73 74 61 74 69 63 20 69 6e 74 20 72 65 61 64 4d static int readM
d680: 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 73 71 6c asterJournal(sql
d690: 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 72 6e 6c ite3_file *pJrnl
d6a0: 2c 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 2c , char *zMaster,
d6b0: 20 75 33 32 20 6e 4d 61 73 74 65 72 29 7b 0a 20 u32 nMaster){.
d6c0: 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
d6d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
d6e0: 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
d6f0: 75 33 32 20 6c 65 6e 3b 20 20 20 20 20 20 20 20 u32 len;
d700: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 /* Le
d710: 6e 67 74 68 20 69 6e 20 62 79 74 65 73 20 6f 66 ngth in bytes of
d720: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
d730: 6e 61 6d 65 20 2a 2f 0a 20 20 69 36 34 20 73 7a name */. i64 sz
d740: 4a 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 J;
d750: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 73 69 /* Total si
d760: 7a 65 20 69 6e 20 62 79 74 65 73 20 6f 66 20 6a ze in bytes of j
d770: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 70 4a 72 6e ournal file pJrn
d780: 6c 20 2a 2f 0a 20 20 75 33 32 20 63 6b 73 75 6d l */. u32 cksum
d790: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
d7a0: 20 20 2f 2a 20 4d 4a 20 63 68 65 63 6b 73 75 6d /* MJ checksum
d7b0: 20 76 61 6c 75 65 20 72 65 61 64 20 66 72 6f 6d value read from
d7c0: 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 33 journal */. u3
d7d0: 32 20 75 3b 20 20 20 20 20 20 20 20 20 20 20 20 2 u;
d7e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 6e 73 69 /* Unsi
d7f0: 67 6e 65 64 20 6c 6f 6f 70 20 63 6f 75 6e 74 65 gned loop counte
d800: 72 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 r */. unsigned
d810: 63 68 61 72 20 61 4d 61 67 69 63 5b 38 5d 3b 20 char aMagic[8];
d820: 20 20 2f 2a 20 41 20 62 75 66 66 65 72 20 74 6f /* A buffer to
d830: 20 68 6f 6c 64 20 74 68 65 20 6d 61 67 69 63 20 hold the magic
d840: 68 65 61 64 65 72 20 2a 2f 0a 20 20 7a 4d 61 73 header */. zMas
d850: 74 65 72 5b 30 5d 20 3d 20 27 5c 30 27 3b 0a 0a ter[0] = '\0';..
d860: 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 if( SQLITE_OK!
d870: 3d 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 =(rc = sqlite3Os
d880: 46 69 6c 65 53 69 7a 65 28 70 4a 72 6e 6c 2c 20 FileSize(pJrnl,
d890: 26 73 7a 4a 29 29 0a 20 20 20 7c 7c 20 73 7a 4a &szJ)). || szJ
d8a0: 3c 31 36 0a 20 20 20 7c 7c 20 53 51 4c 49 54 45 <16. || SQLITE
d8b0: 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 64 33 _OK!=(rc = read3
d8c0: 32 62 69 74 73 28 70 4a 72 6e 6c 2c 20 73 7a 4a 2bits(pJrnl, szJ
d8d0: 2d 31 36 2c 20 26 6c 65 6e 29 29 0a 20 20 20 7c -16, &len)). |
d8e0: 7c 20 6c 65 6e 3e 3d 6e 4d 61 73 74 65 72 20 0a | len>=nMaster .
d8f0: 20 20 20 7c 7c 20 6c 65 6e 3e 73 7a 4a 2d 31 36 || len>szJ-16
d900: 0a 20 20 20 7c 7c 20 6c 65 6e 3d 3d 30 20 0a 20 . || len==0 .
d910: 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d || SQLITE_OK!=
d920: 28 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 (rc = read32bits
d930: 28 70 4a 72 6e 6c 2c 20 73 7a 4a 2d 31 32 2c 20 (pJrnl, szJ-12,
d940: 26 63 6b 73 75 6d 29 29 0a 20 20 20 7c 7c 20 53 &cksum)). || S
d950: 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 QLITE_OK!=(rc =
d960: 73 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 4a sqlite3OsRead(pJ
d970: 72 6e 6c 2c 20 61 4d 61 67 69 63 2c 20 38 2c 20 rnl, aMagic, 8,
d980: 73 7a 4a 2d 38 29 29 0a 20 20 20 7c 7c 20 6d 65 szJ-8)). || me
d990: 6d 63 6d 70 28 61 4d 61 67 69 63 2c 20 61 4a 6f mcmp(aMagic, aJo
d9a0: 75 72 6e 61 6c 4d 61 67 69 63 2c 20 38 29 0a 20 urnalMagic, 8).
d9b0: 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d || SQLITE_OK!=
d9c0: 28 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 (rc = sqlite3OsR
d9d0: 65 61 64 28 70 4a 72 6e 6c 2c 20 7a 4d 61 73 74 ead(pJrnl, zMast
d9e0: 65 72 2c 20 6c 65 6e 2c 20 73 7a 4a 2d 31 36 2d er, len, szJ-16-
d9f0: 6c 65 6e 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 len)). ){. r
da00: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 eturn rc;. }..
da10: 20 2f 2a 20 53 65 65 20 69 66 20 74 68 65 20 63 /* See if the c
da20: 68 65 63 6b 73 75 6d 20 6d 61 74 63 68 65 73 20 hecksum matches
da30: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e the master journ
da40: 61 6c 20 6e 61 6d 65 20 2a 2f 0a 20 20 66 6f 72 al name */. for
da50: 28 75 3d 30 3b 20 75 3c 6c 65 6e 3b 20 75 2b 2b (u=0; u<len; u++
da60: 29 7b 0a 20 20 20 20 63 6b 73 75 6d 20 2d 3d 20 ){. cksum -=
da70: 7a 4d 61 73 74 65 72 5b 75 5d 3b 0a 20 20 7d 0a zMaster[u];. }.
da80: 20 20 69 66 28 20 63 6b 73 75 6d 20 29 7b 0a 20 if( cksum ){.
da90: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 63 68 65 /* If the che
daa0: 63 6b 73 75 6d 20 64 6f 65 73 6e 27 74 20 61 64 cksum doesn't ad
dab0: 64 20 75 70 2c 20 74 68 65 6e 20 6f 6e 65 20 6f d up, then one o
dac0: 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 64 69 r more of the di
dad0: 73 6b 20 73 65 63 74 6f 72 73 0a 20 20 20 20 2a sk sectors. *
dae0: 2a 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 * containing the
daf0: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
db00: 66 69 6c 65 6e 61 6d 65 20 69 73 20 63 6f 72 72 filename is corr
db10: 75 70 74 65 64 2e 20 54 68 69 73 20 6d 65 61 6e upted. This mean
db20: 73 0a 20 20 20 20 2a 2a 20 64 65 66 69 6e 69 74 s. ** definit
db30: 65 6c 79 20 72 6f 6c 6c 20 62 61 63 6b 2c 20 73 ely roll back, s
db40: 6f 20 6a 75 73 74 20 72 65 74 75 72 6e 20 53 51 o just return SQ
db50: 4c 49 54 45 5f 4f 4b 20 61 6e 64 20 72 65 70 6f LITE_OK and repo
db60: 72 74 20 61 20 28 6e 75 6c 29 0a 20 20 20 20 2a rt a (nul). *
db70: 2a 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e 61 6c * master-journal
db80: 20 66 69 6c 65 6e 61 6d 65 2e 0a 20 20 20 20 2a filename.. *
db90: 2f 0a 20 20 20 20 6c 65 6e 20 3d 20 30 3b 0a 20 /. len = 0;.
dba0: 20 7d 0a 20 20 7a 4d 61 73 74 65 72 5b 6c 65 6e }. zMaster[len
dbb0: 5d 20 3d 20 27 5c 30 27 3b 0a 20 20 20 0a 20 20 ] = '\0';. .
dbc0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b return SQLITE_OK
dbd0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
dbe0: 6e 20 74 68 65 20 6f 66 66 73 65 74 20 6f 66 20 n the offset of
dbf0: 74 68 65 20 73 65 63 74 6f 72 20 62 6f 75 6e 64 the sector bound
dc00: 61 72 79 20 61 74 20 6f 72 20 69 6d 6d 65 64 69 ary at or immedi
dc10: 61 74 65 6c 79 20 0a 2a 2a 20 66 6f 6c 6c 6f 77 ately .** follow
dc20: 69 6e 67 20 74 68 65 20 76 61 6c 75 65 20 69 6e ing the value in
dc30: 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
dc40: 4f 66 66 2c 20 61 73 73 75 6d 69 6e 67 20 61 20 Off, assuming a
dc50: 73 65 63 74 6f 72 20 0a 2a 2a 20 73 69 7a 65 20 sector .** size
dc60: 6f 66 20 70 50 61 67 65 72 2d 3e 73 65 63 74 6f of pPager->secto
dc70: 72 53 69 7a 65 20 62 79 74 65 73 2e 0a 2a 2a 0a rSize bytes..**.
dc80: 2a 2a 20 69 2e 65 20 66 6f 72 20 61 20 73 65 63 ** i.e for a sec
dc90: 74 6f 72 20 73 69 7a 65 20 6f 66 20 35 31 32 3a tor size of 512:
dca0: 0a 2a 2a 0a 2a 2a 20 20 20 50 61 67 65 72 2e 6a .**.** Pager.j
dcb0: 6f 75 72 6e 61 6c 4f 66 66 20 20 20 20 20 20 20 ournalOff
dcc0: 20 20 20 52 65 74 75 72 6e 20 76 61 6c 75 65 0a Return value.
dcd0: 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ** -----------
dce0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
dcf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 ------------.**
dd00: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 0
dd10: 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 2a 2a 0.**
dd20: 20 20 20 35 31 32 20 20 20 20 20 20 20 20 20 20 512
dd30: 20 20 20 20 20 20 20 20 20 20 20 20 20 35 31 32 512
dd40: 0a 2a 2a 20 20 20 31 30 30 20 20 20 20 20 20 20 .** 100
dd50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dd60: 35 31 32 0a 2a 2a 20 20 20 32 30 30 30 20 20 20 512.** 2000
dd70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dd80: 20 20 20 32 30 34 38 0a 2a 2a 20 0a 2a 2f 0a 73 2048.** .*/.s
dd90: 74 61 74 69 63 20 69 36 34 20 6a 6f 75 72 6e 61 tatic i64 journa
dda0: 6c 48 64 72 4f 66 66 73 65 74 28 50 61 67 65 72 lHdrOffset(Pager
ddb0: 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 36 34 *pPager){. i64
ddc0: 20 6f 66 66 73 65 74 20 3d 20 30 3b 0a 20 20 69 offset = 0;. i
ddd0: 36 34 20 63 20 3d 20 70 50 61 67 65 72 2d 3e 6a 64 c = pPager->j
dde0: 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 69 66 28 ournalOff;. if(
ddf0: 20 63 20 29 7b 0a 20 20 20 20 6f 66 66 73 65 74 c ){. offset
de00: 20 3d 20 28 28 63 2d 31 29 2f 4a 4f 55 52 4e 41 = ((c-1)/JOURNA
de10: 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 L_HDR_SZ(pPager)
de20: 20 2b 20 31 29 20 2a 20 4a 4f 55 52 4e 41 4c 5f + 1) * JOURNAL_
de30: 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a HDR_SZ(pPager);.
de40: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6f 66 }. assert( of
de50: 66 73 65 74 25 4a 4f 55 52 4e 41 4c 5f 48 44 52 fset%JOURNAL_HDR
de60: 5f 53 5a 28 70 50 61 67 65 72 29 3d 3d 30 20 29 _SZ(pPager)==0 )
de70: 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 66 66 73 ;. assert( offs
de80: 65 74 3e 3d 63 20 29 3b 0a 20 20 61 73 73 65 72 et>=c );. asser
de90: 74 28 20 28 6f 66 66 73 65 74 2d 63 29 3c 4a 4f t( (offset-c)<JO
dea0: 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 URNAL_HDR_SZ(pPa
deb0: 67 65 72 29 20 29 3b 0a 20 20 72 65 74 75 72 6e ger) );. return
dec0: 20 6f 66 66 73 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a offset;.}../*.*
ded0: 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 * The journal fi
dee0: 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 65 6e 20 le must be open
def0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 when this functi
df00: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2e 0a 2a 2a on is called..**
df10: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
df20: 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 n is a no-op if
df30: 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
df40: 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 77 72 has not been wr
df50: 69 74 74 65 6e 20 74 6f 0a 2a 2a 20 77 69 74 68 itten to.** with
df60: 69 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 in the current t
df70: 72 61 6e 73 61 63 74 69 6f 6e 20 28 69 2e 65 2e ransaction (i.e.
df80: 20 69 66 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 if Pager.journa
df90: 6c 4f 66 66 3d 3d 30 29 2e 0a 2a 2a 0a 2a 2a 20 lOff==0)..**.**
dfa0: 49 66 20 64 6f 54 72 75 6e 63 61 74 65 20 69 73 If doTruncate is
dfb0: 20 6e 6f 6e 2d 7a 65 72 6f 20 6f 72 20 74 68 65 non-zero or the
dfc0: 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 53 69 Pager.journalSi
dfd0: 7a 65 4c 69 6d 69 74 20 76 61 72 69 61 62 6c 65 zeLimit variable
dfe0: 20 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 30 2c is.** set to 0,
dff0: 20 74 68 65 6e 20 74 72 75 6e 63 61 74 65 20 74 then truncate t
e000: 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
e010: 74 6f 20 7a 65 72 6f 20 62 79 74 65 73 20 69 6e to zero bytes in
e020: 20 73 69 7a 65 2e 20 4f 74 68 65 72 77 69 73 65 size. Otherwise
e030: 2c 0a 2a 2a 20 7a 65 72 6f 20 74 68 65 20 32 38 ,.** zero the 28
e040: 2d 62 79 74 65 20 68 65 61 64 65 72 20 61 74 20 -byte header at
e050: 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
e060: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 journal file. I
e070: 6e 20 65 69 74 68 65 72 20 63 61 73 65 2c 20 0a n either case, .
e080: 2a 2a 20 69 66 20 74 68 65 20 70 61 67 65 72 20 ** if the pager
e090: 69 73 20 6e 6f 74 20 69 6e 20 6e 6f 2d 73 79 6e is not in no-syn
e0a0: 63 20 6d 6f 64 65 2c 20 73 79 6e 63 20 74 68 65 c mode, sync the
e0b0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 6d journal file im
e0c0: 6d 65 64 69 61 74 65 6c 79 20 0a 2a 2a 20 61 66 mediately .** af
e0d0: 74 65 72 20 77 72 69 74 69 6e 67 20 6f 72 20 74 ter writing or t
e0e0: 72 75 6e 63 61 74 69 6e 67 20 69 74 2e 0a 2a 2a runcating it..**
e0f0: 0a 2a 2a 20 49 66 20 50 61 67 65 72 2e 6a 6f 75 .** If Pager.jou
e100: 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 20 69 73 rnalSizeLimit is
e110: 20 73 65 74 20 74 6f 20 61 20 70 6f 73 69 74 69 set to a positi
e120: 76 65 2c 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c ve, non-zero val
e130: 75 65 2c 20 61 6e 64 0a 2a 2a 20 66 6f 6c 6c 6f ue, and.** follo
e140: 77 69 6e 67 20 74 68 65 20 74 72 75 6e 63 61 74 wing the truncat
e150: 69 6f 6e 20 6f 72 20 7a 65 72 6f 69 6e 67 20 64 ion or zeroing d
e160: 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 20 74 escribed above t
e170: 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 0a he size of the .
e180: 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 ** journal file
e190: 69 6e 20 62 79 74 65 73 20 69 73 20 6c 61 72 67 in bytes is larg
e1a0: 65 72 20 74 68 61 6e 20 74 68 69 73 20 76 61 6c er than this val
e1b0: 75 65 2c 20 74 68 65 6e 20 74 72 75 6e 63 61 74 ue, then truncat
e1c0: 65 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c e the.** journal
e1d0: 20 66 69 6c 65 20 74 6f 20 50 61 67 65 72 2e 6a file to Pager.j
e1e0: 6f 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 74 20 ournalSizeLimit
e1f0: 62 79 74 65 73 2e 20 54 68 65 20 6a 6f 75 72 6e bytes. The journ
e200: 61 6c 20 66 69 6c 65 20 64 6f 65 73 0a 2a 2a 20 al file does.**
e210: 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 20 73 not need to be s
e220: 79 6e 63 65 64 20 66 6f 6c 6c 6f 77 69 6e 67 20 ynced following
e230: 74 68 69 73 20 6f 70 65 72 61 74 69 6f 6e 2e 0a this operation..
e240: 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 49 4f 20 65 **.** If an IO e
e250: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 61 62 61 rror occurs, aba
e260: 6e 64 6f 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 ndon processing
e270: 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 49 and return the I
e280: 4f 20 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a O error code..**
e290: 20 4f 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 Otherwise, retu
e2a0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f rn SQLITE_OK..*/
e2b0: 0a 73 74 61 74 69 63 20 69 6e 74 20 7a 65 72 6f .static int zero
e2c0: 4a 6f 75 72 6e 61 6c 48 64 72 28 50 61 67 65 72 JournalHdr(Pager
e2d0: 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 64 6f *pPager, int do
e2e0: 54 72 75 6e 63 61 74 65 29 7b 0a 20 20 69 6e 74 Truncate){. int
e2f0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
e300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
e320: 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f * Return code */
e330: 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 . assert( isOpe
e340: 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 n(pPager->jfd) )
e350: 3b 0a 20 20 61 73 73 65 72 74 28 20 21 73 71 6c ;. assert( !sql
e360: 69 74 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d ite3JournalIsInM
e370: 65 6d 6f 72 79 28 70 50 61 67 65 72 2d 3e 6a 66 emory(pPager->jf
e380: 64 29 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 d) );. if( pPag
e390: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 er->journalOff )
e3a0: 7b 0a 20 20 20 20 63 6f 6e 73 74 20 69 36 34 20 {. const i64
e3b0: 69 4c 69 6d 69 74 20 3d 20 70 50 61 67 65 72 2d iLimit = pPager-
e3c0: 3e 6a 6f 75 72 6e 61 6c 53 69 7a 65 4c 69 6d 69 >journalSizeLimi
e3d0: 74 3b 20 20 20 20 2f 2a 20 4c 6f 63 61 6c 20 63 t; /* Local c
e3e0: 61 63 68 65 20 6f 66 20 6a 73 6c 20 2a 2f 0a 0a ache of jsl */..
e3f0: 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a 5a IOTRACE(("JZ
e400: 45 52 4f 48 44 52 20 25 70 5c 6e 22 2c 20 70 50 EROHDR %p\n", pP
e410: 61 67 65 72 29 29 0a 20 20 20 20 69 66 28 20 64 ager)). if( d
e420: 6f 54 72 75 6e 63 61 74 65 20 7c 7c 20 69 4c 69 oTruncate || iLi
e430: 6d 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 mit==0 ){.
e440: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 rc = sqlite3OsTr
e450: 75 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 6a uncate(pPager->j
e460: 66 64 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73 fd, 0);. }els
e470: 65 7b 0a 20 20 20 20 20 20 73 74 61 74 69 63 20 e{. static
e480: 63 6f 6e 73 74 20 63 68 61 72 20 7a 65 72 6f 48 const char zeroH
e490: 64 72 5b 32 38 5d 20 3d 20 7b 30 7d 3b 0a 20 20 dr[28] = {0};.
e4a0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
e4b0: 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 2d 3e OsWrite(pPager->
e4c0: 6a 66 64 2c 20 7a 65 72 6f 48 64 72 2c 20 73 69 jfd, zeroHdr, si
e4d0: 7a 65 6f 66 28 7a 65 72 6f 48 64 72 29 2c 20 30 zeof(zeroHdr), 0
e4e0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 );. }. if(
e4f0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
e500: 26 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e & !pPager->noSyn
e510: 63 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 c ){. rc =
e520: 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 50 sqlite3OsSync(pP
e530: 61 67 65 72 2d 3e 6a 66 64 2c 20 53 51 4c 49 54 ager->jfd, SQLIT
e540: 45 5f 53 59 4e 43 5f 44 41 54 41 4f 4e 4c 59 7c E_SYNC_DATAONLY|
e550: 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 pPager->syncFlag
e560: 73 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f s);. }.. /
e570: 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 * At this point
e580: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
e590: 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 62 75 74 is committed but
e5a0: 20 74 68 65 20 77 72 69 74 65 20 6c 6f 63 6b 20 the write lock
e5b0: 0a 20 20 20 20 2a 2a 20 69 73 20 73 74 69 6c 6c . ** is still
e5c0: 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 66 69 6c held on the fil
e5d0: 65 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 61 e. If there is a
e5e0: 20 73 69 7a 65 20 6c 69 6d 69 74 20 63 6f 6e 66 size limit conf
e5f0: 69 67 75 72 65 64 20 66 6f 72 20 0a 20 20 20 20 igured for .
e600: 2a 2a 20 74 68 65 20 70 65 72 73 69 73 74 65 6e ** the persisten
e610: 74 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 74 68 t journal and th
e620: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 e journal file c
e630: 75 72 72 65 6e 74 6c 79 20 63 6f 6e 73 75 6d 65 urrently consume
e640: 73 20 6d 6f 72 65 0a 20 20 20 20 2a 2a 20 73 70 s more. ** sp
e650: 61 63 65 20 74 68 61 6e 20 74 68 61 74 20 6c 69 ace than that li
e660: 6d 69 74 20 61 6c 6c 6f 77 73 20 66 6f 72 2c 20 mit allows for,
e670: 74 72 75 6e 63 61 74 65 20 69 74 20 6e 6f 77 2e truncate it now.
e680: 20 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 There is no nee
e690: 64 0a 20 20 20 20 2a 2a 20 74 6f 20 73 79 6e 63 d. ** to sync
e6a0: 20 74 68 65 20 66 69 6c 65 20 66 6f 6c 6c 6f 77 the file follow
e6b0: 69 6e 67 20 74 68 69 73 20 6f 70 65 72 61 74 69 ing this operati
e6c0: 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 on.. */. i
e6d0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
e6e0: 20 26 26 20 69 4c 69 6d 69 74 3e 30 20 29 7b 0a && iLimit>0 ){.
e6f0: 20 20 20 20 20 20 69 36 34 20 73 7a 3b 0a 20 20 i64 sz;.
e700: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
e710: 4f 73 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 OsFileSize(pPage
e720: 72 2d 3e 6a 66 64 2c 20 26 73 7a 29 3b 0a 20 20 r->jfd, &sz);.
e730: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
e740: 54 45 5f 4f 4b 20 26 26 20 73 7a 3e 69 4c 69 6d TE_OK && sz>iLim
e750: 69 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 it ){. rc
e760: 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 75 6e = sqlite3OsTrun
e770: 63 61 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 cate(pPager->jfd
e780: 2c 20 69 4c 69 6d 69 74 29 3b 0a 20 20 20 20 20 , iLimit);.
e790: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 }. }. }. r
e7a0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a eturn rc;.}../*.
e7b0: 2a 2a 20 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ** The journal f
e7c0: 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 65 6e ile must be open
e7d0: 20 77 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 when this routi
e7e0: 6e 65 20 69 73 20 63 61 6c 6c 65 64 2e 20 41 20 ne is called. A
e7f0: 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 68 65 61 64 65 journal.** heade
e800: 72 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 r (JOURNAL_HDR_S
e810: 5a 20 62 79 74 65 73 29 20 69 73 20 77 72 69 74 Z bytes) is writ
e820: 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a 6f 75 ten into the jou
e830: 72 6e 61 6c 20 66 69 6c 65 20 61 74 20 74 68 65 rnal file at the
e840: 0a 2a 2a 20 63 75 72 72 65 6e 74 20 6c 6f 63 61 .** current loca
e850: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 tion..**.** The
e860: 66 6f 72 6d 61 74 20 66 6f 72 20 74 68 65 20 6a format for the j
e870: 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 69 73 ournal header is
e880: 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 20 as follows:.**
e890: 2d 20 38 20 62 79 74 65 73 3a 20 4d 61 67 69 63 - 8 bytes: Magic
e8a0: 20 69 64 65 6e 74 69 66 79 69 6e 67 20 6a 6f 75 identifying jou
e8b0: 72 6e 61 6c 20 66 6f 72 6d 61 74 2e 0a 2a 2a 20 rnal format..**
e8c0: 2d 20 34 20 62 79 74 65 73 3a 20 4e 75 6d 62 65 - 4 bytes: Numbe
e8d0: 72 20 6f 66 20 72 65 63 6f 72 64 73 20 69 6e 20 r of records in
e8e0: 6a 6f 75 72 6e 61 6c 2c 20 6f 72 20 2d 31 20 6e journal, or -1 n
e8f0: 6f 2d 73 79 6e 63 20 6d 6f 64 65 20 69 73 20 6f o-sync mode is o
e900: 6e 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a n..** - 4 bytes:
e910: 20 52 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 75 Random number u
e920: 73 65 64 20 66 6f 72 20 70 61 67 65 20 68 61 73 sed for page has
e930: 68 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 73 3a h..** - 4 bytes:
e940: 20 49 6e 69 74 69 61 6c 20 64 61 74 61 62 61 73 Initial databas
e950: 65 20 70 61 67 65 20 63 6f 75 6e 74 2e 0a 2a 2a e page count..**
e960: 20 2d 20 34 20 62 79 74 65 73 3a 20 53 65 63 74 - 4 bytes: Sect
e970: 6f 72 20 73 69 7a 65 20 75 73 65 64 20 62 79 20 or size used by
e980: 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 74 the process that
e990: 20 77 72 6f 74 65 20 74 68 69 73 20 6a 6f 75 72 wrote this jour
e9a0: 6e 61 6c 2e 0a 2a 2a 20 2d 20 34 20 62 79 74 65 nal..** - 4 byte
e9b0: 73 3a 20 44 61 74 61 62 61 73 65 20 70 61 67 65 s: Database page
e9c0: 20 73 69 7a 65 2e 0a 2a 2a 20 0a 2a 2a 20 46 6f size..** .** Fo
e9d0: 6c 6c 6f 77 65 64 20 62 79 20 28 4a 4f 55 52 4e llowed by (JOURN
e9e0: 41 4c 5f 48 44 52 5f 53 5a 20 2d 20 32 38 29 20 AL_HDR_SZ - 28)
e9f0: 62 79 74 65 73 20 6f 66 20 75 6e 75 73 65 64 20 bytes of unused
ea00: 73 70 61 63 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 space..*/.static
ea10: 20 69 6e 74 20 77 72 69 74 65 4a 6f 75 72 6e 61 int writeJourna
ea20: 6c 48 64 72 28 50 61 67 65 72 20 2a 70 50 61 67 lHdr(Pager *pPag
ea30: 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 er){. int rc =
ea40: 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
ea50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
ea60: 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 63 turn code */. c
ea70: 68 61 72 20 2a 7a 48 65 61 64 65 72 20 3d 20 70 har *zHeader = p
ea80: 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 Pager->pTmpSpace
ea90: 3b 20 20 2f 2a 20 54 65 6d 70 6f 72 61 72 79 20 ; /* Temporary
eaa0: 73 70 61 63 65 20 75 73 65 64 20 74 6f 20 62 75 space used to bu
eab0: 69 6c 64 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 ild header */.
eac0: 75 33 32 20 6e 48 65 61 64 65 72 20 3d 20 28 75 u32 nHeader = (u
ead0: 33 32 29 70 50 61 67 65 72 2d 3e 70 61 67 65 53 32)pPager->pageS
eae0: 69 7a 65 3b 2f 2a 20 53 69 7a 65 20 6f 66 20 62 ize;/* Size of b
eaf0: 75 66 66 65 72 20 70 6f 69 6e 74 65 64 20 74 6f uffer pointed to
eb00: 20 62 79 20 7a 48 65 61 64 65 72 20 2a 2f 0a 20 by zHeader */.
eb10: 20 75 33 32 20 6e 57 72 69 74 65 3b 20 20 20 20 u32 nWrite;
eb20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb30: 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 /* Bytes of
eb40: 20 68 65 61 64 65 72 20 73 65 63 74 6f 72 20 77 header sector w
eb50: 72 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 ritten */. int
eb60: 69 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ii;
eb70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb80: 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 /* Loop counter
eb90: 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 69 73 */.. assert( is
eba0: 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 Open(pPager->jfd
ebb0: 29 20 29 3b 20 20 20 20 20 20 2f 2a 20 4a 6f 75 ) ); /* Jou
ebc0: 72 6e 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 62 rnal file must b
ebd0: 65 20 6f 70 65 6e 2e 20 2a 2f 0a 0a 20 20 69 66 e open. */.. if
ebe0: 28 20 6e 48 65 61 64 65 72 3e 4a 4f 55 52 4e 41 ( nHeader>JOURNA
ebf0: 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 L_HDR_SZ(pPager)
ec00: 20 29 7b 0a 20 20 20 20 6e 48 65 61 64 65 72 20 ){. nHeader
ec10: 3d 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a = JOURNAL_HDR_SZ
ec20: 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 (pPager);. }..
ec30: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 /* If there are
ec40: 20 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e active savepoin
ec50: 74 73 20 61 6e 64 20 61 6e 79 20 6f 66 20 74 68 ts and any of th
ec60: 65 6d 20 77 65 72 65 20 63 72 65 61 74 65 64 20 em were created
ec70: 0a 20 20 2a 2a 20 73 69 6e 63 65 20 74 68 65 20 . ** since the
ec80: 6d 6f 73 74 20 72 65 63 65 6e 74 20 6a 6f 75 72 most recent jour
ec90: 6e 61 6c 20 68 65 61 64 65 72 20 77 61 73 20 77 nal header was w
eca0: 72 69 74 74 65 6e 2c 20 75 70 64 61 74 65 20 74 ritten, update t
ecb0: 68 65 20 0a 20 20 2a 2a 20 50 61 67 65 72 53 61 he . ** PagerSa
ecc0: 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 73 vepoint.iHdrOffs
ecd0: 65 74 20 66 69 65 6c 64 73 20 6e 6f 77 2e 0a 20 et fields now..
ece0: 20 2a 2f 0a 20 20 66 6f 72 28 69 69 3d 30 3b 20 */. for(ii=0;
ecf0: 69 69 3c 70 50 61 67 65 72 2d 3e 6e 53 61 76 65 ii<pPager->nSave
ed00: 70 6f 69 6e 74 3b 20 69 69 2b 2b 29 7b 0a 20 20 point; ii++){.
ed10: 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 61 53 if( pPager->aS
ed20: 61 76 65 70 6f 69 6e 74 5b 69 69 5d 2e 69 48 64 avepoint[ii].iHd
ed30: 72 4f 66 66 73 65 74 3d 3d 30 20 29 7b 0a 20 20 rOffset==0 ){.
ed40: 20 20 20 20 70 50 61 67 65 72 2d 3e 61 53 61 76 pPager->aSav
ed50: 65 70 6f 69 6e 74 5b 69 69 5d 2e 69 48 64 72 4f epoint[ii].iHdrO
ed60: 66 66 73 65 74 20 3d 20 70 50 61 67 65 72 2d 3e ffset = pPager->
ed70: 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 20 20 journalOff;.
ed80: 7d 0a 20 20 7d 0a 0a 20 20 70 50 61 67 65 72 2d }. }.. pPager-
ed90: 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 70 50 >journalHdr = pP
eda0: 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
edb0: 20 3d 20 6a 6f 75 72 6e 61 6c 48 64 72 4f 66 66 = journalHdrOff
edc0: 73 65 74 28 70 50 61 67 65 72 29 3b 0a 0a 20 20 set(pPager);..
edd0: 2f 2a 20 0a 20 20 2a 2a 20 57 72 69 74 65 20 74 /* . ** Write t
ede0: 68 65 20 6e 52 65 63 20 46 69 65 6c 64 20 2d 20 he nRec Field -
edf0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 the number of pa
ee00: 67 65 20 72 65 63 6f 72 64 73 20 74 68 61 74 20 ge records that
ee10: 66 6f 6c 6c 6f 77 20 74 68 69 73 0a 20 20 2a 2a follow this. **
ee20: 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e journal header.
ee30: 20 4e 6f 72 6d 61 6c 6c 79 2c 20 7a 65 72 6f 20 Normally, zero
ee40: 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 is written to th
ee50: 69 73 20 76 61 6c 75 65 20 61 74 20 74 68 69 73 is value at this
ee60: 20 74 69 6d 65 2e 0a 20 20 2a 2a 20 41 66 74 65 time.. ** Afte
ee70: 72 20 74 68 65 20 72 65 63 6f 72 64 73 20 61 72 r the records ar
ee80: 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 6a e added to the j
ee90: 6f 75 72 6e 61 6c 20 28 61 6e 64 20 74 68 65 20 ournal (and the
eea0: 6a 6f 75 72 6e 61 6c 20 73 79 6e 63 65 64 2c 20 journal synced,
eeb0: 0a 20 20 2a 2a 20 69 66 20 69 6e 20 66 75 6c 6c . ** if in full
eec0: 2d 73 79 6e 63 20 6d 6f 64 65 29 2c 20 74 68 65 -sync mode), the
eed0: 20 7a 65 72 6f 20 69 73 20 6f 76 65 72 77 72 69 zero is overwri
eee0: 74 74 65 6e 20 77 69 74 68 20 74 68 65 20 74 72 tten with the tr
eef0: 75 65 20 6e 75 6d 62 65 72 0a 20 20 2a 2a 20 6f ue number. ** o
ef00: 66 20 72 65 63 6f 72 64 73 20 28 73 65 65 20 73 f records (see s
ef10: 79 6e 63 4a 6f 75 72 6e 61 6c 28 29 29 2e 0a 20 yncJournal())..
ef20: 20 2a 2a 0a 20 20 2a 2a 20 41 20 66 61 73 74 65 **. ** A faste
ef30: 72 20 61 6c 74 65 72 6e 61 74 69 76 65 20 69 73 r alternative is
ef40: 20 74 6f 20 77 72 69 74 65 20 30 78 46 46 46 46 to write 0xFFFF
ef50: 46 46 46 46 20 74 6f 20 74 68 65 20 6e 52 65 63 FFFF to the nRec
ef60: 20 66 69 65 6c 64 2e 20 57 68 65 6e 0a 20 20 2a field. When. *
ef70: 2a 20 72 65 61 64 69 6e 67 20 74 68 65 20 6a 6f * reading the jo
ef80: 75 72 6e 61 6c 20 74 68 69 73 20 76 61 6c 75 65 urnal this value
ef90: 20 74 65 6c 6c 73 20 53 51 4c 69 74 65 20 74 6f tells SQLite to
efa0: 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 assume that the
efb0: 0a 20 20 2a 2a 20 72 65 73 74 20 6f 66 20 74 68 . ** rest of th
efc0: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 63 e journal file c
efd0: 6f 6e 74 61 69 6e 73 20 76 61 6c 69 64 20 70 61 ontains valid pa
efe0: 67 65 20 72 65 63 6f 72 64 73 2e 20 54 68 69 73 ge records. This
eff0: 20 61 73 73 75 6d 70 74 69 6f 6e 0a 20 20 2a 2a assumption. **
f000: 20 69 73 20 64 61 6e 67 65 72 6f 75 73 2c 20 61 is dangerous, a
f010: 73 20 69 66 20 61 20 66 61 69 6c 75 72 65 20 6f s if a failure o
f020: 63 63 75 72 72 65 64 20 77 68 69 6c 73 74 20 77 ccurred whilst w
f030: 72 69 74 69 6e 67 20 74 6f 20 74 68 65 20 6a 6f riting to the jo
f040: 75 72 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 urnal. ** file
f050: 69 74 20 6d 61 79 20 63 6f 6e 74 61 69 6e 20 73 it may contain s
f060: 6f 6d 65 20 67 61 72 62 61 67 65 20 64 61 74 61 ome garbage data
f070: 2e 20 54 68 65 72 65 20 61 72 65 20 74 77 6f 20 . There are two
f080: 73 63 65 6e 61 72 69 6f 73 0a 20 20 2a 2a 20 77 scenarios. ** w
f090: 68 65 72 65 20 74 68 69 73 20 72 69 73 6b 20 63 here this risk c
f0a0: 61 6e 20 62 65 20 69 67 6e 6f 72 65 64 3a 0a 20 an be ignored:.
f0b0: 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 57 68 65 **. ** * Whe
f0c0: 6e 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69 n the pager is i
f0d0: 6e 20 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2e 20 n no-sync mode.
f0e0: 43 6f 72 72 75 70 74 69 6f 6e 20 63 61 6e 20 66 Corruption can f
f0f0: 6f 6c 6c 6f 77 20 61 0a 20 20 2a 2a 20 20 20 20 ollow a. **
f100: 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 69 power failure i
f110: 6e 20 74 68 69 73 20 63 61 73 65 20 61 6e 79 77 n this case anyw
f120: 61 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 ay.. **. **
f130: 2a 20 57 68 65 6e 20 74 68 65 20 53 51 4c 49 54 * When the SQLIT
f140: 45 5f 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 E_IOCAP_SAFE_APP
f150: 45 4e 44 20 66 6c 61 67 20 69 73 20 73 65 74 2e END flag is set.
f160: 20 54 68 69 73 20 67 75 61 72 61 6e 74 65 65 73 This guarantees
f170: 0a 20 20 2a 2a 20 20 20 20 20 74 68 61 74 20 67 . ** that g
f180: 61 72 62 61 67 65 20 64 61 74 61 20 69 73 20 6e arbage data is n
f190: 65 76 65 72 20 61 70 70 65 6e 64 65 64 20 74 6f ever appended to
f1a0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
f1b0: 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 e.. */. assert
f1c0: 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
f1d0: 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d 3e >fd) || pPager->
f1e0: 6e 6f 53 79 6e 63 20 29 3b 0a 20 20 69 66 28 20 noSync );. if(
f1f0: 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 20 7c pPager->noSync |
f200: 7c 20 28 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e | (pPager->journ
f210: 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
f220: 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
f230: 29 0a 20 20 20 7c 7c 20 28 73 71 6c 69 74 65 33 ). || (sqlite3
f240: 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 65 OsDeviceCharacte
f250: 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d 3e ristics(pPager->
f260: 66 64 29 26 53 51 4c 49 54 45 5f 49 4f 43 41 50 fd)&SQLITE_IOCAP
f270: 5f 53 41 46 45 5f 41 50 50 45 4e 44 29 20 0a 20 _SAFE_APPEND) .
f280: 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70 79 28 7a ){. memcpy(z
f290: 48 65 61 64 65 72 2c 20 61 4a 6f 75 72 6e 61 6c Header, aJournal
f2a0: 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4a Magic, sizeof(aJ
f2b0: 6f 75 72 6e 61 6c 4d 61 67 69 63 29 29 3b 0a 20 ournalMagic));.
f2c0: 20 20 20 70 75 74 33 32 62 69 74 73 28 26 7a 48 put32bits(&zH
f2d0: 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f eader[sizeof(aJo
f2e0: 75 72 6e 61 6c 4d 61 67 69 63 29 5d 2c 20 30 78 urnalMagic)], 0x
f2f0: 66 66 66 66 66 66 66 66 29 3b 0a 20 20 7d 65 6c ffffffff);. }el
f300: 73 65 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 7a se{. memset(z
f310: 48 65 61 64 65 72 2c 20 30 2c 20 73 69 7a 65 6f Header, 0, sizeo
f320: 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
f330: 2b 34 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 +4);. }.. /* T
f340: 68 65 20 72 61 6e 64 6f 6d 20 63 68 65 63 6b 2d he random check-
f350: 68 61 73 68 20 69 6e 69 74 69 61 6c 69 7a 65 72 hash initializer
f360: 20 2a 2f 20 0a 20 20 73 71 6c 69 74 65 33 5f 72 */ . sqlite3_r
f370: 61 6e 64 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 andomness(sizeof
f380: 28 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e (pPager->cksumIn
f390: 69 74 29 2c 20 26 70 50 61 67 65 72 2d 3e 63 6b it), &pPager->ck
f3a0: 73 75 6d 49 6e 69 74 29 3b 0a 20 20 70 75 74 33 sumInit);. put3
f3b0: 32 62 69 74 73 28 26 7a 48 65 61 64 65 72 5b 73 2bits(&zHeader[s
f3c0: 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 izeof(aJournalMa
f3d0: 67 69 63 29 2b 34 5d 2c 20 70 50 61 67 65 72 2d gic)+4], pPager-
f3e0: 3e 63 6b 73 75 6d 49 6e 69 74 29 3b 0a 20 20 2f >cksumInit);. /
f3f0: 2a 20 54 68 65 20 69 6e 69 74 69 61 6c 20 64 61 * The initial da
f400: 74 61 62 61 73 65 20 73 69 7a 65 20 2a 2f 0a 20 tabase size */.
f410: 20 70 75 74 33 32 62 69 74 73 28 26 7a 48 65 61 put32bits(&zHea
f420: 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 der[sizeof(aJour
f430: 6e 61 6c 4d 61 67 69 63 29 2b 38 5d 2c 20 70 50 nalMagic)+8], pP
f440: 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 ager->dbOrigSize
f450: 29 3b 0a 20 20 2f 2a 20 54 68 65 20 61 73 73 75 );. /* The assu
f460: 6d 65 64 20 73 65 63 74 6f 72 20 73 69 7a 65 20 med sector size
f470: 66 6f 72 20 74 68 69 73 20 70 72 6f 63 65 73 73 for this process
f480: 20 2a 2f 0a 20 20 70 75 74 33 32 62 69 74 73 28 */. put32bits(
f490: 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 &zHeader[sizeof(
f4a0: 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 2b 31 aJournalMagic)+1
f4b0: 32 5d 2c 20 70 50 61 67 65 72 2d 3e 73 65 63 74 2], pPager->sect
f4c0: 6f 72 53 69 7a 65 29 3b 0a 0a 20 20 2f 2a 20 54 orSize);.. /* T
f4d0: 68 65 20 70 61 67 65 20 73 69 7a 65 20 2a 2f 0a he page size */.
f4e0: 20 20 70 75 74 33 32 62 69 74 73 28 26 7a 48 65 put32bits(&zHe
f4f0: 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 ader[sizeof(aJou
f500: 72 6e 61 6c 4d 61 67 69 63 29 2b 31 36 5d 2c 20 rnalMagic)+16],
f510: 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 pPager->pageSize
f520: 29 3b 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c );.. /* Initial
f530: 69 7a 69 6e 67 20 74 68 65 20 74 61 69 6c 20 6f izing the tail o
f540: 66 20 74 68 65 20 62 75 66 66 65 72 20 69 73 20 f the buffer is
f550: 6e 6f 74 20 6e 65 63 65 73 73 61 72 79 2e 20 20 not necessary.
f560: 45 76 65 72 79 74 68 69 6e 67 0a 20 20 2a 2a 20 Everything. **
f570: 77 6f 72 6b 73 20 66 69 6e 64 20 69 66 20 74 68 works find if th
f580: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 65 6d 73 e following mems
f590: 65 74 28 29 20 69 73 20 6f 6d 69 74 74 65 64 2e et() is omitted.
f5a0: 20 20 42 75 74 20 69 6e 69 74 69 61 6c 69 7a 69 But initializi
f5b0: 6e 67 0a 20 20 2a 2a 20 74 68 65 20 6d 65 6d 6f ng. ** the memo
f5c0: 72 79 20 70 72 65 76 65 6e 74 73 20 76 61 6c 67 ry prevents valg
f5d0: 72 69 6e 64 20 66 72 6f 6d 20 63 6f 6d 70 6c 61 rind from compla
f5e0: 69 6e 69 6e 67 2c 20 73 6f 20 77 65 20 61 72 65 ining, so we are
f5f0: 20 77 69 6c 6c 69 6e 67 20 74 6f 0a 20 20 2a 2a willing to. **
f600: 20 74 61 6b 65 20 74 68 65 20 70 65 72 66 6f 72 take the perfor
f610: 6d 61 6e 63 65 20 68 69 74 2e 0a 20 20 2a 2f 0a mance hit.. */.
f620: 20 20 6d 65 6d 73 65 74 28 26 7a 48 65 61 64 65 memset(&zHeade
f630: 72 5b 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 r[sizeof(aJourna
f640: 6c 4d 61 67 69 63 29 2b 32 30 5d 2c 20 30 2c 0a lMagic)+20], 0,.
f650: 20 20 20 20 20 20 20 20 20 6e 48 65 61 64 65 72 nHeader
f660: 2d 28 73 69 7a 65 6f 66 28 61 4a 6f 75 72 6e 61 -(sizeof(aJourna
f670: 6c 4d 61 67 69 63 29 2b 32 30 29 29 3b 0a 0a 20 lMagic)+20));..
f680: 20 2f 2a 20 49 6e 20 74 68 65 6f 72 79 2c 20 69 /* In theory, i
f690: 74 20 69 73 20 6f 6e 6c 79 20 6e 65 63 65 73 73 t is only necess
f6a0: 61 72 79 20 74 6f 20 77 72 69 74 65 20 74 68 65 ary to write the
f6b0: 20 32 38 20 62 79 74 65 73 20 74 68 61 74 20 74 28 bytes that t
f6c0: 68 65 20 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c he . ** journal
f6d0: 20 68 65 61 64 65 72 20 63 6f 6e 73 75 6d 65 73 header consumes
f6e0: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 to the journal
f6f0: 66 69 6c 65 20 68 65 72 65 2e 20 54 68 65 6e 20 file here. Then
f700: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 0a 20 increment the .
f710: 20 2a 2a 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 ** Pager.journa
f720: 6c 4f 66 66 20 76 61 72 69 61 62 6c 65 20 62 79 lOff variable by
f730: 20 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 JOURNAL_HDR_SZ
f740: 73 6f 20 74 68 61 74 20 74 68 65 20 6e 65 78 74 so that the next
f750: 20 0a 20 20 2a 2a 20 72 65 63 6f 72 64 20 69 73 . ** record is
f760: 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 written to the
f770: 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 63 74 6f 72 following sector
f780: 20 28 6c 65 61 76 69 6e 67 20 61 20 67 61 70 20 (leaving a gap
f790: 69 6e 20 74 68 65 20 66 69 6c 65 0a 20 20 2a 2a in the file. **
f7a0: 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 69 6d that will be im
f7b0: 70 6c 69 63 69 74 6c 79 20 66 69 6c 6c 65 64 20 plicitly filled
f7c0: 69 6e 20 62 79 20 74 68 65 20 4f 53 29 2e 0a 20 in by the OS)..
f7d0: 20 2a 2a 0a 20 20 2a 2a 20 48 6f 77 65 76 65 72 **. ** However
f7e0: 20 69 74 20 68 61 73 20 62 65 65 6e 20 64 69 73 it has been dis
f7f0: 63 6f 76 65 72 65 64 20 74 68 61 74 20 6f 6e 20 covered that on
f800: 73 6f 6d 65 20 73 79 73 74 65 6d 73 20 74 68 69 some systems thi
f810: 73 20 70 61 74 74 65 72 6e 20 63 61 6e 20 0a 20 s pattern can .
f820: 20 2a 2a 20 62 65 20 73 69 67 6e 69 66 69 63 61 ** be significa
f830: 6e 74 6c 79 20 73 6c 6f 77 65 72 20 74 68 61 6e ntly slower than
f840: 20 63 6f 6e 74 69 67 75 6f 75 73 6c 79 20 77 72 contiguously wr
f850: 69 74 69 6e 67 20 64 61 74 61 20 74 6f 20 74 68 iting data to th
f860: 65 20 66 69 6c 65 2c 0a 20 20 2a 2a 20 65 76 65 e file,. ** eve
f870: 6e 20 69 66 20 74 68 61 74 20 6d 65 61 6e 73 20 n if that means
f880: 65 78 70 6c 69 63 69 74 6c 79 20 77 72 69 74 69 explicitly writi
f890: 6e 67 20 64 61 74 61 20 74 6f 20 74 68 65 20 62 ng data to the b
f8a0: 6c 6f 63 6b 20 6f 66 20 0a 20 20 2a 2a 20 28 4a lock of . ** (J
f8b0: 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 2d 20 OURNAL_HDR_SZ -
f8c0: 32 38 29 20 62 79 74 65 73 20 74 68 61 74 20 77 28) bytes that w
f8d0: 69 6c 6c 20 6e 6f 74 20 62 65 20 75 73 65 64 2e ill not be used.
f8e0: 20 53 6f 20 74 68 61 74 20 69 73 20 77 68 61 74 So that is what
f8f0: 0a 20 20 2a 2a 20 69 73 20 64 6f 6e 65 2e 20 0a . ** is done. .
f900: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 6c 6f **. ** The lo
f910: 6f 70 20 69 73 20 72 65 71 75 69 72 65 64 20 68 op is required h
f920: 65 72 65 20 69 6e 20 63 61 73 65 20 74 68 65 20 ere in case the
f930: 73 65 63 74 6f 72 2d 73 69 7a 65 20 69 73 20 6c sector-size is l
f940: 61 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 0a arger than the .
f950: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 70 61 ** database pa
f960: 67 65 20 73 69 7a 65 2e 20 53 69 6e 63 65 20 74 ge size. Since t
f970: 68 65 20 7a 48 65 61 64 65 72 20 62 75 66 66 65 he zHeader buffe
f980: 72 20 69 73 20 6f 6e 6c 79 20 50 61 67 65 72 2e r is only Pager.
f990: 70 61 67 65 53 69 7a 65 0a 20 20 2a 2a 20 62 79 pageSize. ** by
f9a0: 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 6d 6f 72 tes in size, mor
f9b0: 65 20 74 68 61 6e 20 6f 6e 65 20 63 61 6c 6c 20 e than one call
f9c0: 74 6f 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 to sqlite3OsWrit
f9d0: 65 28 29 20 6d 61 79 20 62 65 20 72 65 71 75 69 e() may be requi
f9e0: 72 65 64 0a 20 20 2a 2a 20 74 6f 20 70 6f 70 75 red. ** to popu
f9f0: 6c 61 74 65 20 74 68 65 20 65 6e 74 69 72 65 20 late the entire
fa00: 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 73 journal header s
fa10: 65 63 74 6f 72 2e 0a 20 20 2a 2f 20 0a 20 20 66 ector.. */ . f
fa20: 6f 72 28 6e 57 72 69 74 65 3d 30 3b 20 72 63 3d or(nWrite=0; rc=
fa30: 3d 53 51 4c 49 54 45 5f 4f 4b 26 26 6e 57 72 69 =SQLITE_OK&&nWri
fa40: 74 65 3c 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 te<JOURNAL_HDR_S
fa50: 5a 28 70 50 61 67 65 72 29 3b 20 6e 57 72 69 74 Z(pPager); nWrit
fa60: 65 2b 3d 6e 48 65 61 64 65 72 29 7b 0a 20 20 20 e+=nHeader){.
fa70: 20 49 4f 54 52 41 43 45 28 28 22 4a 48 44 52 20 IOTRACE(("JHDR
fa80: 25 70 20 25 6c 6c 64 20 25 64 5c 6e 22 2c 20 70 %p %lld %d\n", p
fa90: 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e 6a Pager, pPager->j
faa0: 6f 75 72 6e 61 6c 48 64 72 2c 20 6e 48 65 61 64 ournalHdr, nHead
fab0: 65 72 29 29 0a 20 20 20 20 72 63 20 3d 20 73 71 er)). rc = sq
fac0: 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
fad0: 67 65 72 2d 3e 6a 66 64 2c 20 7a 48 65 61 64 65 ger->jfd, zHeade
fae0: 72 2c 20 6e 48 65 61 64 65 72 2c 20 70 50 61 67 r, nHeader, pPag
faf0: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 29 3b er->journalOff);
fb00: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
fb10: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 ger->journalHdr
fb20: 3c 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e <= pPager->journ
fb30: 61 6c 4f 66 66 20 29 3b 0a 20 20 20 20 70 50 61 alOff );. pPa
fb40: 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
fb50: 2b 3d 20 6e 48 65 61 64 65 72 3b 0a 20 20 7d 0a += nHeader;. }.
fb60: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
fb70: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6a 6f 75 72 6e ./*.** The journ
fb80: 61 6c 20 66 69 6c 65 20 6d 75 73 74 20 62 65 20 al file must be
fb90: 6f 70 65 6e 20 77 68 65 6e 20 74 68 69 73 20 69 open when this i
fba0: 73 20 63 61 6c 6c 65 64 2e 20 41 20 6a 6f 75 72 s called. A jour
fbb0: 6e 61 6c 20 68 65 61 64 65 72 20 66 69 6c 65 0a nal header file.
fbc0: 2a 2a 20 28 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f ** (JOURNAL_HDR_
fbd0: 53 5a 20 62 79 74 65 73 29 20 69 73 20 72 65 61 SZ bytes) is rea
fbe0: 64 20 66 72 6f 6d 20 74 68 65 20 63 75 72 72 65 d from the curre
fbf0: 6e 74 20 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 74 nt location in t
fc00: 68 65 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 he journal.** fi
fc10: 6c 65 2e 20 54 68 65 20 63 75 72 72 65 6e 74 20 le. The current
fc20: 6c 6f 63 61 74 69 6f 6e 20 69 6e 20 74 68 65 20 location in the
fc30: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 journal file is
fc40: 67 69 76 65 6e 20 62 79 0a 2a 2a 20 70 50 61 67 given by.** pPag
fc50: 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 2e 20 er->journalOff.
fc60: 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 61 62 6f See comments abo
fc70: 76 65 20 66 75 6e 63 74 69 6f 6e 20 77 72 69 74 ve function writ
fc80: 65 4a 6f 75 72 6e 61 6c 48 64 72 28 29 20 66 6f eJournalHdr() fo
fc90: 72 0a 2a 2a 20 61 20 64 65 73 63 72 69 70 74 69 r.** a descripti
fca0: 6f 6e 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 on of the journa
fcb0: 6c 20 68 65 61 64 65 72 20 66 6f 72 6d 61 74 2e l header format.
fcc0: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 68 65 .**.** If the he
fcd0: 61 64 65 72 20 69 73 20 72 65 61 64 20 73 75 63 ader is read suc
fce0: 63 65 73 73 66 75 6c 6c 79 2c 20 2a 70 4e 52 65 cessfully, *pNRe
fcf0: 63 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 c is set to the
fd00: 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 70 61 67 number of.** pag
fd10: 65 20 72 65 63 6f 72 64 73 20 66 6f 6c 6c 6f 77 e records follow
fd20: 69 6e 67 20 74 68 69 73 20 68 65 61 64 65 72 20 ing this header
fd30: 61 6e 64 20 2a 70 44 62 53 69 7a 65 20 69 73 20 and *pDbSize is
fd40: 73 65 74 20 74 6f 20 74 68 65 20 73 69 7a 65 20 set to the size
fd50: 6f 66 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 of the.** databa
fd60: 73 65 20 62 65 66 6f 72 65 20 74 68 65 20 74 72 se before the tr
fd70: 61 6e 73 61 63 74 69 6f 6e 20 62 65 67 61 6e 2c ansaction began,
fd80: 20 69 6e 20 70 61 67 65 73 2e 20 41 6c 73 6f 2c in pages. Also,
fd90: 20 70 50 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e pPager->cksumIn
fda0: 69 74 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 it.** is set to
fdb0: 74 68 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 the value read f
fdc0: 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 rom the journal
fdd0: 68 65 61 64 65 72 2e 20 53 51 4c 49 54 45 5f 4f header. SQLITE_O
fde0: 4b 20 69 73 20 72 65 74 75 72 6e 65 64 0a 2a 2a K is returned.**
fdf0: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a in this case..*
fe00: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 *.** If the jour
fe10: 6e 61 6c 20 68 65 61 64 65 72 20 66 69 6c 65 20 nal header file
fe20: 61 70 70 65 61 72 73 20 74 6f 20 62 65 20 63 6f appears to be co
fe30: 72 72 75 70 74 65 64 2c 20 53 51 4c 49 54 45 5f rrupted, SQLITE_
fe40: 44 4f 4e 45 20 69 73 0a 2a 2a 20 72 65 74 75 72 DONE is.** retur
fe50: 6e 65 64 20 61 6e 64 20 2a 70 4e 52 65 63 20 61 ned and *pNRec a
fe60: 6e 64 20 2a 50 44 62 53 69 7a 65 20 61 72 65 20 nd *PDbSize are
fe70: 75 6e 64 65 66 69 6e 65 64 2e 20 20 49 66 20 4a undefined. If J
fe80: 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a 20 62 79 OURNAL_HDR_SZ by
fe90: 74 65 73 0a 2a 2a 20 63 61 6e 6e 6f 74 20 62 65 tes.** cannot be
fea0: 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6a read from the j
feb0: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 61 6e 20 65 ournal file an e
fec0: 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 rror code is ret
fed0: 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 urned..*/.static
fee0: 20 69 6e 74 20 72 65 61 64 4a 6f 75 72 6e 61 6c int readJournal
fef0: 48 64 72 28 0a 20 20 50 61 67 65 72 20 2a 70 50 Hdr(. Pager *pP
ff00: 61 67 65 72 2c 20 20 20 20 20 20 20 20 20 20 20 ager,
ff10: 20 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a /* Pager obj
ff20: 65 63 74 20 2a 2f 0a 20 20 69 6e 74 20 69 73 48 ect */. int isH
ff30: 6f 74 2c 0a 20 20 69 36 34 20 6a 6f 75 72 6e 61 ot,. i64 journa
ff40: 6c 53 69 7a 65 2c 20 20 20 20 20 20 20 20 20 20 lSize,
ff50: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 /* Size of th
ff60: 65 20 6f 70 65 6e 20 6a 6f 75 72 6e 61 6c 20 66 e open journal f
ff70: 69 6c 65 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a ile in bytes */.
ff80: 20 20 75 33 32 20 2a 70 4e 52 65 63 2c 20 20 20 u32 *pNRec,
ff90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
ffa0: 2a 20 4f 55 54 3a 20 56 61 6c 75 65 20 72 65 61 * OUT: Value rea
ffb0: 64 20 66 72 6f 6d 20 74 68 65 20 6e 52 65 63 20 d from the nRec
ffc0: 66 69 65 6c 64 20 2a 2f 0a 20 20 75 33 32 20 2a field */. u32 *
ffd0: 70 44 62 53 69 7a 65 20 20 20 20 20 20 20 20 20 pDbSize
ffe0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 /* OUT:
fff0: 56 61 6c 75 65 20 6f 66 20 6f 72 69 67 69 6e 61 Value of origina
10000 6c 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 20 l database size
10010 66 69 65 6c 64 20 2a 2f 0a 29 7b 0a 20 20 69 6e field */.){. in
10020 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
10030 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
10040 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 75 turn code */. u
10050 6e 73 69 67 6e 65 64 20 63 68 61 72 20 61 4d 61 nsigned char aMa
10060 67 69 63 5b 38 5d 3b 20 20 20 20 20 2f 2a 20 41 gic[8]; /* A
10070 20 62 75 66 66 65 72 20 74 6f 20 68 6f 6c 64 20 buffer to hold
10080 74 68 65 20 6d 61 67 69 63 20 68 65 61 64 65 72 the magic header
10090 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 72 4f 66 */. i64 iHdrOf
100a0 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f;
100b0 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 20 /* Offset of
100c0 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 62 journal header b
100d0 65 69 6e 67 20 72 65 61 64 20 2a 2f 0a 0a 20 20 eing read */..
100e0 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 assert( isOpen(p
100f0 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 20 20 Pager->jfd) );
10100 20 20 20 20 2f 2a 20 4a 6f 75 72 6e 61 6c 20 66 /* Journal f
10110 69 6c 65 20 6d 75 73 74 20 62 65 20 6f 70 65 6e ile must be open
10120 2e 20 2a 2f 0a 0a 20 20 2f 2a 20 41 64 76 61 6e . */.. /* Advan
10130 63 65 20 50 61 67 65 72 2e 6a 6f 75 72 6e 61 6c ce Pager.journal
10140 4f 66 66 20 74 6f 20 74 68 65 20 73 74 61 72 74 Off to the start
10150 20 6f 66 20 74 68 65 20 6e 65 78 74 20 73 65 63 of the next sec
10160 74 6f 72 2e 20 49 66 20 74 68 65 0a 20 20 2a 2a tor. If the. **
10170 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
10180 20 74 6f 6f 20 73 6d 61 6c 6c 20 66 6f 72 20 74 too small for t
10190 68 65 72 65 20 74 6f 20 62 65 20 61 20 68 65 61 here to be a hea
101a0 64 65 72 20 73 74 6f 72 65 64 20 61 74 20 74 68 der stored at th
101b0 69 73 0a 20 20 2a 2a 20 70 6f 69 6e 74 2c 20 72 is. ** point, r
101c0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e eturn SQLITE_DON
101d0 45 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 67 65 72 E.. */. pPager
101e0 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 6a ->journalOff = j
101f0 6f 75 72 6e 61 6c 48 64 72 4f 66 66 73 65 74 28 ournalHdrOffset(
10200 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 70 pPager);. if( p
10210 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
10220 66 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 5a f+JOURNAL_HDR_SZ
10230 28 70 50 61 67 65 72 29 20 3e 20 6a 6f 75 72 6e (pPager) > journ
10240 61 6c 53 69 7a 65 20 29 7b 0a 20 20 20 20 72 65 alSize ){. re
10250 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e 45 turn SQLITE_DONE
10260 3b 0a 20 20 7d 0a 20 20 69 48 64 72 4f 66 66 20 ;. }. iHdrOff
10270 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 = pPager->journa
10280 6c 4f 66 66 3b 0a 0a 20 20 2f 2a 20 52 65 61 64 lOff;.. /* Read
10290 20 69 6e 20 74 68 65 20 66 69 72 73 74 20 38 20 in the first 8
102a0 62 79 74 65 73 20 6f 66 20 74 68 65 20 6a 6f 75 bytes of the jou
102b0 72 6e 61 6c 20 68 65 61 64 65 72 2e 20 49 66 20 rnal header. If
102c0 74 68 65 79 20 64 6f 20 6e 6f 74 20 6d 61 74 63 they do not matc
102d0 68 0a 20 20 2a 2a 20 74 68 65 20 20 6d 61 67 69 h. ** the magi
102e0 63 20 73 74 72 69 6e 67 20 66 6f 75 6e 64 20 61 c string found a
102f0 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 t the start of e
10300 61 63 68 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 ach journal head
10310 65 72 2c 20 72 65 74 75 72 6e 0a 20 20 2a 2a 20 er, return. **
10320 53 51 4c 49 54 45 5f 44 4f 4e 45 2e 20 49 66 20 SQLITE_DONE. If
10330 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 an IO error occu
10340 72 73 2c 20 72 65 74 75 72 6e 20 61 6e 20 65 72 rs, return an er
10350 72 6f 72 20 63 6f 64 65 2e 20 4f 74 68 65 72 77 ror code. Otherw
10360 69 73 65 2c 0a 20 20 2a 2a 20 70 72 6f 63 65 65 ise,. ** procee
10370 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 73 d.. */. if( is
10380 48 6f 74 20 7c 7c 20 69 48 64 72 4f 66 66 21 3d Hot || iHdrOff!=
10390 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
103a0 64 72 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 dr ){. rc = s
103b0 71 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 61 qlite3OsRead(pPa
103c0 67 65 72 2d 3e 6a 66 64 2c 20 61 4d 61 67 69 63 ger->jfd, aMagic
103d0 2c 20 73 69 7a 65 6f 66 28 61 4d 61 67 69 63 29 , sizeof(aMagic)
103e0 2c 20 69 48 64 72 4f 66 66 29 3b 0a 20 20 20 20 , iHdrOff);.
103f0 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 if( rc ){.
10400 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
10410 0a 20 20 20 20 69 66 28 20 6d 65 6d 63 6d 70 28 . if( memcmp(
10420 61 4d 61 67 69 63 2c 20 61 4a 6f 75 72 6e 61 6c aMagic, aJournal
10430 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 4d Magic, sizeof(aM
10440 61 67 69 63 29 29 21 3d 30 20 29 7b 0a 20 20 20 agic))!=0 ){.
10450 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
10460 5f 44 4f 4e 45 3b 0a 20 20 20 20 7d 0a 20 20 7d _DONE;. }. }
10470 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 .. /* Read the
10480 66 69 72 73 74 20 74 68 72 65 65 20 33 32 2d 62 first three 32-b
10490 69 74 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 it fields of the
104a0 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 3a journal header:
104b0 20 54 68 65 20 6e 52 65 63 0a 20 20 2a 2a 20 66 The nRec. ** f
104c0 69 65 6c 64 2c 20 74 68 65 20 63 68 65 63 6b 73 ield, the checks
104d0 75 6d 2d 69 6e 69 74 69 61 6c 69 7a 65 72 20 61 um-initializer a
104e0 6e 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 nd the database
104f0 73 69 7a 65 20 61 74 20 74 68 65 20 73 74 61 72 size at the star
10500 74 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 74 72 t. ** of the tr
10510 61 6e 73 61 63 74 69 6f 6e 2e 20 52 65 74 75 72 ansaction. Retur
10520 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 n an error code
10530 69 66 20 61 6e 79 74 68 69 6e 67 20 67 6f 65 73 if anything goes
10540 20 77 72 6f 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 wrong.. */. i
10550 66 28 20 53 51 4c 49 54 45 5f 4f 4b 21 3d 28 72 f( SQLITE_OK!=(r
10560 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 28 70 c = read32bits(p
10570 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 Pager->jfd, iHdr
10580 4f 66 66 2b 38 2c 20 70 4e 52 65 63 29 29 0a 20 Off+8, pNRec)).
10590 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d || SQLITE_OK!=
105a0 28 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 (rc = read32bits
105b0 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 (pPager->jfd, iH
105c0 64 72 4f 66 66 2b 31 32 2c 20 26 70 50 61 67 65 drOff+12, &pPage
105d0 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 29 0a 20 r->cksumInit)).
105e0 20 20 7c 7c 20 53 51 4c 49 54 45 5f 4f 4b 21 3d || SQLITE_OK!=
105f0 28 72 63 20 3d 20 72 65 61 64 33 32 62 69 74 73 (rc = read32bits
10600 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 (pPager->jfd, iH
10610 64 72 4f 66 66 2b 31 36 2c 20 70 44 62 53 69 7a drOff+16, pDbSiz
10620 65 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 e)). ){. ret
10630 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 69 urn rc;. }.. i
10640 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e f( pPager->journ
10650 61 6c 4f 66 66 3d 3d 30 20 29 7b 0a 20 20 20 20 alOff==0 ){.
10660 75 33 32 20 69 50 61 67 65 53 69 7a 65 3b 20 20 u32 iPageSize;
10670 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10680 50 61 67 65 2d 73 69 7a 65 20 66 69 65 6c 64 20 Page-size field
10690 6f 66 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 of journal heade
106a0 72 20 2a 2f 0a 20 20 20 20 75 33 32 20 69 53 65 r */. u32 iSe
106b0 63 74 6f 72 53 69 7a 65 3b 20 20 20 20 20 20 20 ctorSize;
106c0 20 20 20 20 20 20 2f 2a 20 53 65 63 74 6f 72 2d /* Sector-
106d0 73 69 7a 65 20 66 69 65 6c 64 20 6f 66 20 6a 6f size field of jo
106e0 75 72 6e 61 6c 20 68 65 61 64 65 72 20 2a 2f 0a urnal header */.
106f0 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 . /* Read the
10700 20 70 61 67 65 2d 73 69 7a 65 20 61 6e 64 20 73 page-size and s
10710 65 63 74 6f 72 2d 73 69 7a 65 20 6a 6f 75 72 6e ector-size journ
10720 61 6c 20 68 65 61 64 65 72 20 66 69 65 6c 64 73 al header fields
10730 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 53 51 4c . */. if( SQL
10740 49 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 72 65 ITE_OK!=(rc = re
10750 61 64 33 32 62 69 74 73 28 70 50 61 67 65 72 2d ad32bits(pPager-
10760 3e 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 32 30 >jfd, iHdrOff+20
10770 2c 20 26 69 53 65 63 74 6f 72 53 69 7a 65 29 29 , &iSectorSize))
10780 0a 20 20 20 20 20 7c 7c 20 53 51 4c 49 54 45 5f . || SQLITE_
10790 4f 4b 21 3d 28 72 63 20 3d 20 72 65 61 64 33 32 OK!=(rc = read32
107a0 62 69 74 73 28 70 50 61 67 65 72 2d 3e 6a 66 64 bits(pPager->jfd
107b0 2c 20 69 48 64 72 4f 66 66 2b 32 34 2c 20 26 69 , iHdrOff+24, &i
107c0 50 61 67 65 53 69 7a 65 29 29 0a 20 20 20 20 29 PageSize)). )
107d0 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 {. return r
107e0 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a c;. }.. /*
107f0 20 56 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c Versions of SQL
10800 69 74 65 20 70 72 69 6f 72 20 74 6f 20 33 2e 35 ite prior to 3.5
10810 2e 38 20 73 65 74 20 74 68 65 20 70 61 67 65 2d .8 set the page-
10820 73 69 7a 65 20 66 69 65 6c 64 20 6f 66 20 74 68 size field of th
10830 65 0a 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c e. ** journal
10840 20 68 65 61 64 65 72 20 74 6f 20 7a 65 72 6f 2e header to zero.
10850 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 61 In this case, a
10860 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 20 50 ssume that the P
10870 61 67 65 72 2e 70 61 67 65 53 69 7a 65 0a 20 20 ager.pageSize.
10880 20 20 2a 2a 20 76 61 72 69 61 62 6c 65 20 69 73 ** variable is
10890 20 61 6c 72 65 61 64 79 20 73 65 74 20 74 6f 20 already set to
108a0 74 68 65 20 63 6f 72 72 65 63 74 20 70 61 67 65 the correct page
108b0 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 size.. */.
108c0 20 20 69 66 28 20 69 50 61 67 65 53 69 7a 65 3d if( iPageSize=
108d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 50 61 67 =0 ){. iPag
108e0 65 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e eSize = pPager->
108f0 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 7d 0a pageSize;. }.
10900 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 74 68 . /* Check th
10910 61 74 20 74 68 65 20 76 61 6c 75 65 73 20 72 65 at the values re
10920 61 64 20 66 72 6f 6d 20 74 68 65 20 70 61 67 65 ad from the page
10930 2d 73 69 7a 65 20 61 6e 64 20 73 65 63 74 6f 72 -size and sector
10940 2d 73 69 7a 65 20 66 69 65 6c 64 73 0a 20 20 20 -size fields.
10950 20 2a 2a 20 61 72 65 20 77 69 74 68 69 6e 20 72 ** are within r
10960 61 6e 67 65 2e 20 54 6f 20 62 65 20 27 69 6e 20 ange. To be 'in
10970 72 61 6e 67 65 27 2c 20 62 6f 74 68 20 76 61 6c range', both val
10980 75 65 73 20 6e 65 65 64 20 74 6f 20 62 65 20 61 ues need to be a
10990 20 70 6f 77 65 72 0a 20 20 20 20 2a 2a 20 6f 66 power. ** of
109a0 20 74 77 6f 20 67 72 65 61 74 65 72 20 74 68 61 two greater tha
109b0 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 35 31 n or equal to 51
109c0 32 20 6f 72 20 33 32 2c 20 61 6e 64 20 6e 6f 74 2 or 32, and not
109d0 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 74 68 greater than th
109e0 65 69 72 20 0a 20 20 20 20 2a 2a 20 72 65 73 70 eir . ** resp
109f0 65 63 74 69 76 65 20 63 6f 6d 70 69 6c 65 20 74 ective compile t
10a00 69 6d 65 20 6d 61 78 69 6d 75 6d 20 6c 69 6d 69 ime maximum limi
10a10 74 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ts.. */. i
10a20 66 28 20 69 50 61 67 65 53 69 7a 65 3c 35 31 32 f( iPageSize<512
10a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10a40 20 20 7c 7c 20 69 53 65 63 74 6f 72 53 69 7a 65 || iSectorSize
10a50 3c 33 32 0a 20 20 20 20 20 7c 7c 20 69 50 61 67 <32. || iPag
10a60 65 53 69 7a 65 3e 53 51 4c 49 54 45 5f 4d 41 58 eSize>SQLITE_MAX
10a70 5f 50 41 47 45 5f 53 49 5a 45 20 7c 7c 20 69 53 _PAGE_SIZE || iS
10a80 65 63 74 6f 72 53 69 7a 65 3e 4d 41 58 5f 53 45 ectorSize>MAX_SE
10a90 43 54 4f 52 5f 53 49 5a 45 0a 20 20 20 20 20 7c CTOR_SIZE. |
10aa0 7c 20 28 28 69 50 61 67 65 53 69 7a 65 2d 31 29 | ((iPageSize-1)
10ab0 26 69 50 61 67 65 53 69 7a 65 29 21 3d 30 20 20 &iPageSize)!=0
10ac0 20 7c 7c 20 28 28 69 53 65 63 74 6f 72 53 69 7a || ((iSectorSiz
10ad0 65 2d 31 29 26 69 53 65 63 74 6f 72 53 69 7a 65 e-1)&iSectorSize
10ae0 29 21 3d 30 20 0a 20 20 20 20 29 7b 0a 20 20 20 )!=0 . ){.
10af0 20 20 20 2f 2a 20 49 66 20 74 68 65 20 65 69 74 /* If the eit
10b00 68 65 72 20 74 68 65 20 70 61 67 65 2d 73 69 7a her the page-siz
10b10 65 20 6f 72 20 73 65 63 74 6f 72 2d 73 69 7a 65 e or sector-size
10b20 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d in the journal-
10b30 68 65 61 64 65 72 20 69 73 20 0a 20 20 20 20 20 header is .
10b40 20 2a 2a 20 69 6e 76 61 6c 69 64 2c 20 74 68 65 ** invalid, the
10b50 6e 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 n the process th
10b60 61 74 20 77 72 6f 74 65 20 74 68 65 20 6a 6f 75 at wrote the jou
10b70 72 6e 61 6c 2d 68 65 61 64 65 72 20 6d 75 73 74 rnal-header must
10b80 20 68 61 76 65 20 0a 20 20 20 20 20 20 2a 2a 20 have . **
10b90 63 72 61 73 68 65 64 20 62 65 66 6f 72 65 20 74 crashed before t
10ba0 68 65 20 68 65 61 64 65 72 20 77 61 73 20 73 79 he header was sy
10bb0 6e 63 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 nced. In this ca
10bc0 73 65 20 73 74 6f 70 20 72 65 61 64 69 6e 67 20 se stop reading
10bd0 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 6a 6f . ** the jo
10be0 75 72 6e 61 6c 20 66 69 6c 65 20 68 65 72 65 2e urnal file here.
10bf0 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
10c00 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f return SQLITE_DO
10c10 4e 45 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f NE;. }.. /
10c20 2a 20 55 70 64 61 74 65 20 74 68 65 20 70 61 67 * Update the pag
10c30 65 2d 73 69 7a 65 20 74 6f 20 6d 61 74 63 68 20 e-size to match
10c40 74 68 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 the value read f
10c50 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e rom the journal.
10c60 20 0a 20 20 20 20 2a 2a 20 55 73 65 20 61 20 74 . ** Use a t
10c70 65 73 74 63 61 73 65 28 29 20 6d 61 63 72 6f 20 estcase() macro
10c80 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 to make sure tha
10c90 74 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 t malloc failure
10ca0 20 77 69 74 68 69 6e 20 0a 20 20 20 20 2a 2a 20 within . **
10cb0 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 65 PagerSetPagesize
10cc0 28 29 20 69 73 20 74 65 73 74 65 64 2e 0a 20 20 () is tested..
10cd0 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 */. rc = sq
10ce0 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 67 lite3PagerSetPag
10cf0 65 73 69 7a 65 28 70 50 61 67 65 72 2c 20 26 69 esize(pPager, &i
10d00 50 61 67 65 53 69 7a 65 2c 20 2d 31 29 3b 0a 20 PageSize, -1);.
10d10 20 20 20 74 65 73 74 63 61 73 65 28 20 72 63 21 testcase( rc!
10d20 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 0a 20 =SQLITE_OK );..
10d30 20 20 20 2f 2a 20 55 70 64 61 74 65 20 74 68 65 /* Update the
10d40 20 61 73 73 75 6d 65 64 20 73 65 63 74 6f 72 2d assumed sector-
10d50 73 69 7a 65 20 74 6f 20 6d 61 74 63 68 20 74 68 size to match th
10d60 65 20 76 61 6c 75 65 20 75 73 65 64 20 62 79 20 e value used by
10d70 0a 20 20 20 20 2a 2a 20 74 68 65 20 70 72 6f 63 . ** the proc
10d80 65 73 73 20 74 68 61 74 20 63 72 65 61 74 65 64 ess that created
10d90 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c 2e 20 49 this journal. I
10da0 66 20 74 68 69 73 20 6a 6f 75 72 6e 61 6c 20 77 f this journal w
10db0 61 73 0a 20 20 20 20 2a 2a 20 63 72 65 61 74 65 as. ** create
10dc0 64 20 62 79 20 61 20 70 72 6f 63 65 73 73 20 6f d by a process o
10dd0 74 68 65 72 20 74 68 61 6e 20 74 68 69 73 20 6f ther than this o
10de0 6e 65 2c 20 74 68 65 6e 20 74 68 69 73 20 72 6f ne, then this ro
10df0 75 74 69 6e 65 0a 20 20 20 20 2a 2a 20 69 73 20 utine. ** is
10e00 62 65 69 6e 67 20 63 61 6c 6c 65 64 20 66 72 6f being called fro
10e10 6d 20 77 69 74 68 69 6e 20 70 61 67 65 72 5f 70 m within pager_p
10e20 6c 61 79 62 61 63 6b 28 29 2e 20 54 68 65 20 6c layback(). The l
10e30 6f 63 61 6c 20 76 61 6c 75 65 0a 20 20 20 20 2a ocal value. *
10e40 2a 20 6f 66 20 50 61 67 65 72 2e 73 65 63 74 6f * of Pager.secto
10e50 72 53 69 7a 65 20 69 73 20 72 65 73 74 6f 72 65 rSize is restore
10e60 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 d at the end of
10e70 74 68 61 74 20 72 6f 75 74 69 6e 65 2e 0a 20 20 that routine..
10e80 20 20 2a 2f 0a 20 20 20 20 70 50 61 67 65 72 2d */. pPager-
10e90 3e 73 65 63 74 6f 72 53 69 7a 65 20 3d 20 69 53 >sectorSize = iS
10ea0 65 63 74 6f 72 53 69 7a 65 3b 0a 20 20 7d 0a 0a ectorSize;. }..
10eb0 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
10ec0 6c 4f 66 66 20 2b 3d 20 4a 4f 55 52 4e 41 4c 5f lOff += JOURNAL_
10ed0 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3b 0a HDR_SZ(pPager);.
10ee0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
10ef0 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 65 ./*.** Write the
10f00 20 73 75 70 70 6c 69 65 64 20 6d 61 73 74 65 72 supplied master
10f10 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 69 6e journal name in
10f20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 to the journal f
10f30 69 6c 65 20 66 6f 72 20 70 61 67 65 72 0a 2a 2a ile for pager.**
10f40 20 70 50 61 67 65 72 20 61 74 20 74 68 65 20 63 pPager at the c
10f50 75 72 72 65 6e 74 20 6c 6f 63 61 74 69 6f 6e 2e urrent location.
10f60 20 54 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 The master jour
10f70 6e 61 6c 20 6e 61 6d 65 20 6d 75 73 74 20 62 65 nal name must be
10f80 20 74 68 65 20 6c 61 73 74 0a 2a 2a 20 74 68 69 the last.** thi
10f90 6e 67 20 77 72 69 74 74 65 6e 20 74 6f 20 61 20 ng written to a
10fa0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 66 journal file. If
10fb0 20 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e the pager is in
10fc0 20 66 75 6c 6c 2d 73 79 6e 63 20 6d 6f 64 65 2c full-sync mode,
10fd0 20 74 68 65 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 the.** journal
10fe0 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
10ff0 69 73 20 61 64 76 61 6e 63 65 64 20 74 6f 20 74 is advanced to t
11000 68 65 20 6e 65 78 74 20 73 65 63 74 6f 72 20 62 he next sector b
11010 6f 75 6e 64 61 72 79 20 62 65 66 6f 72 65 0a 2a oundary before.*
11020 2a 20 61 6e 79 74 68 69 6e 67 20 69 73 20 77 72 * anything is wr
11030 69 74 74 65 6e 2e 20 54 68 65 20 66 6f 72 6d 61 itten. The forma
11040 74 20 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2b 20 t is:.**.** +
11050 34 20 62 79 74 65 73 3a 20 50 41 47 45 52 5f 4d 4 bytes: PAGER_M
11060 4a 5f 50 47 4e 4f 2e 0a 2a 2a 20 20 20 2b 20 4e J_PGNO..** + N
11070 20 62 79 74 65 73 3a 20 4d 61 73 74 65 72 20 6a bytes: Master j
11080 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 20 ournal filename
11090 69 6e 20 75 74 66 2d 38 2e 0a 2a 2a 20 20 20 2b in utf-8..** +
110a0 20 34 20 62 79 74 65 73 3a 20 4e 20 28 6c 65 6e 4 bytes: N (len
110b0 67 74 68 20 6f 66 20 6d 61 73 74 65 72 20 6a 6f gth of master jo
110c0 75 72 6e 61 6c 20 6e 61 6d 65 20 69 6e 20 62 79 urnal name in by
110d0 74 65 73 2c 20 6e 6f 20 6e 75 6c 2d 74 65 72 6d tes, no nul-term
110e0 69 6e 61 74 6f 72 29 2e 0a 2a 2a 20 20 20 2b 20 inator)..** +
110f0 34 20 62 79 74 65 73 3a 20 4d 61 73 74 65 72 20 4 bytes: Master
11100 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 63 68 65 journal name che
11110 63 6b 73 75 6d 2e 0a 2a 2a 20 20 20 2b 20 38 20 cksum..** + 8
11120 62 79 74 65 73 3a 20 61 4a 6f 75 72 6e 61 6c 4d bytes: aJournalM
11130 61 67 69 63 5b 5d 2e 0a 2a 2a 0a 2a 2a 20 54 68 agic[]..**.** Th
11140 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
11150 20 70 61 67 65 20 63 68 65 63 6b 73 75 6d 20 69 page checksum i
11160 73 20 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 s the sum of the
11170 20 62 79 74 65 73 20 69 6e 20 74 68 65 20 6d 61 bytes in the ma
11180 73 74 65 72 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 ster.** journal
11190 6e 61 6d 65 2c 20 77 68 65 72 65 20 65 61 63 68 name, where each
111a0 20 62 79 74 65 20 69 73 20 69 6e 74 65 72 70 72 byte is interpr
111b0 65 74 65 64 20 61 73 20 61 20 73 69 67 6e 65 64 eted as a signed
111c0 20 38 2d 62 69 74 20 69 6e 74 65 67 65 72 2e 0a 8-bit integer..
111d0 2a 2a 0a 2a 2a 20 49 66 20 7a 4d 61 73 74 65 72 **.** If zMaster
111e0 20 69 73 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 is a NULL point
111f0 65 72 20 28 6f 63 63 75 72 73 20 66 6f 72 20 61 er (occurs for a
11200 20 73 69 6e 67 6c 65 20 64 61 74 61 62 61 73 65 single database
11210 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2c 20 0a transaction), .
11220 2a 2a 20 74 68 69 73 20 63 61 6c 6c 20 69 73 20 ** this call is
11230 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74 a no-op..*/.stat
11240 69 63 20 69 6e 74 20 77 72 69 74 65 4d 61 73 74 ic int writeMast
11250 65 72 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 erJournal(Pager
11260 2a 70 50 61 67 65 72 2c 20 63 6f 6e 73 74 20 63 *pPager, const c
11270 68 61 72 20 2a 7a 4d 61 73 74 65 72 29 7b 0a 20 har *zMaster){.
11280 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
11290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
112a0 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 /* Return code
112b0 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 73 74 65 */. int nMaste
112c0 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
112d0 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
112e0 20 6f 66 20 73 74 72 69 6e 67 20 7a 4d 61 73 74 of string zMast
112f0 65 72 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 72 er */. i64 iHdr
11300 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 Off;
11310 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 /* Offs
11320 65 74 20 6f 66 20 68 65 61 64 65 72 20 69 6e 20 et of header in
11330 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a journal file */.
11340 20 20 69 36 34 20 6a 72 6e 6c 53 69 7a 65 3b 20 i64 jrnlSize;
11350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11360 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6a 6f /* Size of jo
11370 75 72 6e 61 6c 20 66 69 6c 65 20 6f 6e 20 64 69 urnal file on di
11380 73 6b 20 2a 2f 0a 20 20 75 33 32 20 63 6b 73 75 sk */. u32 cksu
11390 6d 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 m = 0;
113a0 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 65 63 /* Chec
113b0 6b 73 75 6d 20 6f 66 20 73 74 72 69 6e 67 20 7a ksum of string z
113c0 4d 61 73 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 Master */.. ass
113d0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 73 65 74 ert( pPager->set
113e0 4d 61 73 74 65 72 3d 3d 30 20 29 3b 0a 20 20 61 Master==0 );. a
113f0 73 73 65 72 74 28 20 21 70 61 67 65 72 55 73 65 ssert( !pagerUse
11400 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 0a Wal(pPager) );..
11410 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 20 0a if( !zMaster .
11420 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f || pPager->jo
11430 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
11440 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d _JOURNALMODE_MEM
11450 4f 52 59 20 0a 20 20 20 7c 7c 20 21 69 73 4f 70 ORY . || !isOp
11460 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 0a en(pPager->jfd).
11470 20 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 ){. return
11480 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 SQLITE_OK;. }.
11490 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 pPager->setMast
114a0 65 72 20 3d 20 31 3b 0a 20 20 61 73 73 65 72 74 er = 1;. assert
114b0 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ( pPager->journa
114c0 6c 48 64 72 20 3c 3d 20 70 50 61 67 65 72 2d 3e lHdr <= pPager->
114d0 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 3b 0a 0a 20 journalOff );..
114e0 20 2f 2a 20 43 61 6c 63 75 6c 61 74 65 20 74 68 /* Calculate th
114f0 65 20 6c 65 6e 67 74 68 20 69 6e 20 62 79 74 65 e length in byte
11500 73 20 61 6e 64 20 74 68 65 20 63 68 65 63 6b 73 s and the checks
11510 75 6d 20 6f 66 20 7a 4d 61 73 74 65 72 20 2a 2f um of zMaster */
11520 0a 20 20 66 6f 72 28 6e 4d 61 73 74 65 72 3d 30 . for(nMaster=0
11530 3b 20 7a 4d 61 73 74 65 72 5b 6e 4d 61 73 74 65 ; zMaster[nMaste
11540 72 5d 3b 20 6e 4d 61 73 74 65 72 2b 2b 29 7b 0a r]; nMaster++){.
11550 20 20 20 20 63 6b 73 75 6d 20 2b 3d 20 7a 4d 61 cksum += zMa
11560 73 74 65 72 5b 6e 4d 61 73 74 65 72 5d 3b 0a 20 ster[nMaster];.
11570 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 69 6e 20 66 }.. /* If in f
11580 75 6c 6c 2d 73 79 6e 63 20 6d 6f 64 65 2c 20 61 ull-sync mode, a
11590 64 76 61 6e 63 65 20 74 6f 20 74 68 65 20 6e 65 dvance to the ne
115a0 78 74 20 64 69 73 6b 20 73 65 63 74 6f 72 20 62 xt disk sector b
115b0 65 66 6f 72 65 20 77 72 69 74 69 6e 67 0a 20 20 efore writing.
115c0 2a 2a 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f ** the master jo
115d0 75 72 6e 61 6c 20 6e 61 6d 65 2e 20 54 68 69 73 urnal name. This
115e0 20 69 73 20 69 6e 20 63 61 73 65 20 74 68 65 20 is in case the
115f0 70 72 65 76 69 6f 75 73 20 70 61 67 65 20 77 72 previous page wr
11600 69 74 74 65 6e 20 74 6f 0a 20 20 2a 2a 20 74 68 itten to. ** th
11610 65 20 6a 6f 75 72 6e 61 6c 20 68 61 73 20 61 6c e journal has al
11620 72 65 61 64 79 20 62 65 65 6e 20 73 79 6e 63 65 ready been synce
11630 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 d.. */. if( pP
11640 61 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 ager->fullSync )
11650 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f {. pPager->jo
11660 75 72 6e 61 6c 4f 66 66 20 3d 20 6a 6f 75 72 6e urnalOff = journ
11670 61 6c 48 64 72 4f 66 66 73 65 74 28 70 50 61 67 alHdrOffset(pPag
11680 65 72 29 3b 0a 20 20 7d 0a 20 20 69 48 64 72 4f er);. }. iHdrO
11690 66 66 20 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 ff = pPager->jou
116a0 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 2f 2a 20 57 rnalOff;.. /* W
116b0 72 69 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 rite the master
116c0 6a 6f 75 72 6e 61 6c 20 64 61 74 61 20 74 6f 20 journal data to
116d0 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6a the end of the j
116e0 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 66 0a ournal file. If.
116f0 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63 ** an error oc
11700 63 75 72 73 2c 20 72 65 74 75 72 6e 20 74 68 65 curs, return the
11710 20 65 72 72 6f 72 20 63 6f 64 65 20 74 6f 20 74 error code to t
11720 68 65 20 63 61 6c 6c 65 72 2e 0a 20 20 2a 2f 0a he caller.. */.
11730 20 20 69 66 28 20 28 30 20 21 3d 20 28 72 63 20 if( (0 != (rc
11740 3d 20 77 72 69 74 65 33 32 62 69 74 73 28 70 50 = write32bits(pP
11750 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 64 72 4f ager->jfd, iHdrO
11760 66 66 2c 20 50 41 47 45 52 5f 4d 4a 5f 50 47 4e ff, PAGER_MJ_PGN
11770 4f 28 70 50 61 67 65 72 29 29 29 29 0a 20 20 20 O(pPager)))).
11780 7c 7c 20 28 30 20 21 3d 20 28 72 63 20 3d 20 73 || (0 != (rc = s
11790 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 qlite3OsWrite(pP
117a0 61 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 ager->jfd, zMast
117b0 65 72 2c 20 6e 4d 61 73 74 65 72 2c 20 69 48 64 er, nMaster, iHd
117c0 72 4f 66 66 2b 34 29 29 29 0a 20 20 20 7c 7c 20 rOff+4))). ||
117d0 28 30 20 21 3d 20 28 72 63 20 3d 20 77 72 69 74 (0 != (rc = writ
117e0 65 33 32 62 69 74 73 28 70 50 61 67 65 72 2d 3e e32bits(pPager->
117f0 6a 66 64 2c 20 69 48 64 72 4f 66 66 2b 34 2b 6e jfd, iHdrOff+4+n
11800 4d 61 73 74 65 72 2c 20 6e 4d 61 73 74 65 72 29 Master, nMaster)
11810 29 29 0a 20 20 20 7c 7c 20 28 30 20 21 3d 20 28 )). || (0 != (
11820 72 63 20 3d 20 77 72 69 74 65 33 32 62 69 74 73 rc = write32bits
11830 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 69 48 (pPager->jfd, iH
11840 64 72 4f 66 66 2b 34 2b 6e 4d 61 73 74 65 72 2b drOff+4+nMaster+
11850 34 2c 20 63 6b 73 75 6d 29 29 29 0a 20 20 20 7c 4, cksum))). |
11860 7c 20 28 30 20 21 3d 20 28 72 63 20 3d 20 73 71 | (0 != (rc = sq
11870 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
11880 67 65 72 2d 3e 6a 66 64 2c 20 61 4a 6f 75 72 6e ger->jfd, aJourn
11890 61 6c 4d 61 67 69 63 2c 20 38 2c 0a 20 20 20 20 alMagic, 8,.
118a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
118b0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 48 64 iHd
118c0 72 4f 66 66 2b 34 2b 6e 4d 61 73 74 65 72 2b 38 rOff+4+nMaster+8
118d0 29 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 65 74 ))). ){. ret
118e0 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 70 50 urn rc;. }. pP
118f0 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
11900 20 2b 3d 20 28 6e 4d 61 73 74 65 72 2b 32 30 29 += (nMaster+20)
11910 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 70 ;.. /* If the p
11920 61 67 65 72 20 69 73 20 69 6e 20 70 65 72 69 73 ager is in peris
11930 74 65 6e 74 2d 6a 6f 75 72 6e 61 6c 20 6d 6f 64 tent-journal mod
11940 65 2c 20 74 68 65 6e 20 74 68 65 20 70 68 79 73 e, then the phys
11950 69 63 61 6c 20 0a 20 20 2a 2a 20 6a 6f 75 72 6e ical . ** journ
11960 61 6c 2d 66 69 6c 65 20 6d 61 79 20 65 78 74 65 al-file may exte
11970 6e 64 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 nd past the end
11980 6f 66 20 74 68 65 20 6d 61 73 74 65 72 2d 6a 6f of the master-jo
11990 75 72 6e 61 6c 20 6e 61 6d 65 0a 20 20 2a 2a 20 urnal name. **
119a0 61 6e 64 20 38 20 62 79 74 65 73 20 6f 66 20 6d and 8 bytes of m
119b0 61 67 69 63 20 64 61 74 61 20 6a 75 73 74 20 77 agic data just w
119c0 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20 66 69 ritten to the fi
119d0 6c 65 2e 20 54 68 69 73 20 69 73 20 0a 20 20 2a le. This is . *
119e0 2a 20 64 61 6e 67 65 72 6f 75 73 20 62 65 63 61 * dangerous beca
119f0 75 73 65 20 74 68 65 20 63 6f 64 65 20 74 6f 20 use the code to
11a00 72 6f 6c 6c 62 61 63 6b 20 61 20 68 6f 74 2d 6a rollback a hot-j
11a10 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 20 20 2a 2a ournal file. **
11a20 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 61 62 6c will not be abl
11a30 65 20 74 6f 20 66 69 6e 64 20 74 68 65 20 6d 61 e to find the ma
11a40 73 74 65 72 2d 6a 6f 75 72 6e 61 6c 20 6e 61 6d ster-journal nam
11a50 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 0a e to determine .
11a60 20 20 2a 2a 20 77 68 65 74 68 65 72 20 6f 72 20 ** whether or
11a70 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 not the journal
11a80 69 73 20 68 6f 74 2e 20 0a 20 20 2a 2a 0a 20 20 is hot. . **.
11a90 2a 2a 20 45 61 73 69 65 73 74 20 74 68 69 6e 67 ** Easiest thing
11aa0 20 74 6f 20 64 6f 20 69 6e 20 74 68 69 73 20 73 to do in this s
11ab0 63 65 6e 61 72 69 6f 20 69 73 20 74 6f 20 74 72 cenario is to tr
11ac0 75 6e 63 61 74 65 20 74 68 65 20 6a 6f 75 72 6e uncate the journ
11ad0 61 6c 20 0a 20 20 2a 2a 20 66 69 6c 65 20 74 6f al . ** file to
11ae0 20 74 68 65 20 72 65 71 75 69 72 65 64 20 73 69 the required si
11af0 7a 65 2e 0a 20 20 2a 2f 20 0a 20 20 69 66 28 20 ze.. */ . if(
11b00 53 51 4c 49 54 45 5f 4f 4b 3d 3d 28 72 63 20 3d SQLITE_OK==(rc =
11b10 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 sqlite3OsFileSi
11b20 7a 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 ze(pPager->jfd,
11b30 26 6a 72 6e 6c 53 69 7a 65 29 29 0a 20 20 20 26 &jrnlSize)). &
11b40 26 20 6a 72 6e 6c 53 69 7a 65 3e 70 50 61 67 65 & jrnlSize>pPage
11b50 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 0a 20 20 r->journalOff.
11b60 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
11b70 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 50 te3OsTruncate(pP
11b80 61 67 65 72 2d 3e 6a 66 64 2c 20 70 50 61 67 65 ager->jfd, pPage
11b90 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 29 3b 0a r->journalOff);.
11ba0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
11bb0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 63 61 72 .}../*.** Discar
11bc0 64 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e d the entire con
11bd0 74 65 6e 74 73 20 6f 66 20 74 68 65 20 69 6e 2d tents of the in-
11be0 6d 65 6d 6f 72 79 20 70 61 67 65 2d 63 61 63 68 memory page-cach
11bf0 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 e..*/.static voi
11c00 64 20 70 61 67 65 72 5f 72 65 73 65 74 28 50 61 d pager_reset(Pa
11c10 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 ger *pPager){.
11c20 70 50 61 67 65 72 2d 3e 69 44 61 74 61 56 65 72 pPager->iDataVer
11c30 73 69 6f 6e 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 sion++;. sqlite
11c40 33 42 61 63 6b 75 70 52 65 73 74 61 72 74 28 70 3BackupRestart(p
11c50 50 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 29 3b Pager->pBackup);
11c60 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 . sqlite3Pcache
11c70 43 6c 65 61 72 28 70 50 61 67 65 72 2d 3e 70 50 Clear(pPager->pP
11c80 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Cache);.}../*.**
11c90 20 52 65 74 75 72 6e 20 74 68 65 20 70 50 61 67 Return the pPag
11ca0 65 72 2d 3e 69 44 61 74 61 56 65 72 73 69 6f 6e er->iDataVersion
11cb0 20 76 61 6c 75 65 0a 2a 2f 0a 75 33 32 20 73 71 value.*/.u32 sq
11cc0 6c 69 74 65 33 50 61 67 65 72 44 61 74 61 56 65 lite3PagerDataVe
11cd0 72 73 69 6f 6e 28 50 61 67 65 72 20 2a 70 50 61 rsion(Pager *pPa
11ce0 67 65 72 29 7b 0a 20 20 61 73 73 65 72 74 28 20 ger){. assert(
11cf0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 50 pPager->eState>P
11d00 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 72 AGER_OPEN );. r
11d10 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 69 44 eturn pPager->iD
11d20 61 74 61 56 65 72 73 69 6f 6e 3b 0a 7d 0a 0a 2f ataVersion;.}../
11d30 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 73 74 *.** Free all st
11d40 72 75 63 74 75 72 65 73 20 69 6e 20 74 68 65 20 ructures in the
11d50 50 61 67 65 72 2e 61 53 61 76 65 70 6f 69 6e 74 Pager.aSavepoint
11d60 5b 5d 20 61 72 72 61 79 20 61 6e 64 20 73 65 74 [] array and set
11d70 20 62 6f 74 68 0a 2a 2a 20 50 61 67 65 72 2e 61 both.** Pager.a
11d80 53 61 76 65 70 6f 69 6e 74 20 61 6e 64 20 50 61 Savepoint and Pa
11d90 67 65 72 2e 6e 53 61 76 65 70 6f 69 6e 74 20 74 ger.nSavepoint t
11da0 6f 20 7a 65 72 6f 2e 20 43 6c 6f 73 65 20 74 68 o zero. Close th
11db0 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a e sub-journal.**
11dc0 20 69 66 20 69 74 20 69 73 20 6f 70 65 6e 20 61 if it is open a
11dd0 6e 64 20 74 68 65 20 70 61 67 65 72 20 69 73 20 nd the pager is
11de0 6e 6f 74 20 69 6e 20 65 78 63 6c 75 73 69 76 65 not in exclusive
11df0 20 6d 6f 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 mode..*/.static
11e00 20 76 6f 69 64 20 72 65 6c 65 61 73 65 41 6c 6c void releaseAll
11e10 53 61 76 65 70 6f 69 6e 74 73 28 50 61 67 65 72 Savepoints(Pager
11e20 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 *pPager){. int
11e30 20 69 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 ii;
11e40 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 66 /* Iterator f
11e50 6f 72 20 6c 6f 6f 70 69 6e 67 20 74 68 72 6f 75 or looping throu
11e60 67 68 20 50 61 67 65 72 2e 61 53 61 76 65 70 6f gh Pager.aSavepo
11e70 69 6e 74 20 2a 2f 0a 20 20 66 6f 72 28 69 69 3d int */. for(ii=
11e80 30 3b 20 69 69 3c 70 50 61 67 65 72 2d 3e 6e 53 0; ii<pPager->nS
11e90 61 76 65 70 6f 69 6e 74 3b 20 69 69 2b 2b 29 7b avepoint; ii++){
11ea0 0a 20 20 20 20 73 71 6c 69 74 65 33 42 69 74 76 . sqlite3Bitv
11eb0 65 63 44 65 73 74 72 6f 79 28 70 50 61 67 65 72 ecDestroy(pPager
11ec0 2d 3e 61 53 61 76 65 70 6f 69 6e 74 5b 69 69 5d ->aSavepoint[ii]
11ed0 2e 70 49 6e 53 61 76 65 70 6f 69 6e 74 29 3b 0a .pInSavepoint);.
11ee0 20 20 7d 0a 20 20 69 66 28 20 21 70 50 61 67 65 }. if( !pPage
11ef0 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f 64 65 r->exclusiveMode
11f00 20 7c 7c 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e || sqlite3Journ
11f10 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 50 61 alIsInMemory(pPa
11f20 67 65 72 2d 3e 73 6a 66 64 29 20 29 7b 0a 20 20 ger->sjfd) ){.
11f30 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 sqlite3OsClose
11f40 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 29 3b 0a (pPager->sjfd);.
11f50 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 }. sqlite3_fr
11f60 65 65 28 70 50 61 67 65 72 2d 3e 61 53 61 76 65 ee(pPager->aSave
11f70 70 6f 69 6e 74 29 3b 0a 20 20 70 50 61 67 65 72 point);. pPager
11f80 2d 3e 61 53 61 76 65 70 6f 69 6e 74 20 3d 20 30 ->aSavepoint = 0
11f90 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6e 53 61 76 ;. pPager->nSav
11fa0 65 70 6f 69 6e 74 20 3d 20 30 3b 0a 20 20 70 50 epoint = 0;. pP
11fb0 61 67 65 72 2d 3e 6e 53 75 62 52 65 63 20 3d 20 ager->nSubRec =
11fc0 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 0;.}../*.** Set
11fd0 74 68 65 20 62 69 74 20 6e 75 6d 62 65 72 20 70 the bit number p
11fe0 67 6e 6f 20 69 6e 20 74 68 65 20 50 61 67 65 72 gno in the Pager
11ff0 53 61 76 65 70 6f 69 6e 74 2e 70 49 6e 53 61 76 Savepoint.pInSav
12000 65 70 6f 69 6e 74 20 0a 2a 2a 20 62 69 74 76 65 epoint .** bitve
12010 63 73 20 6f 66 20 61 6c 6c 20 6f 70 65 6e 20 73 cs of all open s
12020 61 76 65 70 6f 69 6e 74 73 2e 20 52 65 74 75 72 avepoints. Retur
12030 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 73 n SQLITE_OK if s
12040 75 63 63 65 73 73 66 75 6c 0a 2a 2a 20 6f 72 20 uccessful.** or
12050 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 66 20 SQLITE_NOMEM if
12060 61 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 a malloc failure
12070 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 73 74 61 74 occurs..*/.stat
12080 69 63 20 69 6e 74 20 61 64 64 54 6f 53 61 76 65 ic int addToSave
12090 70 6f 69 6e 74 42 69 74 76 65 63 73 28 50 61 67 pointBitvecs(Pag
120a0 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e 6f er *pPager, Pgno
120b0 20 70 67 6e 6f 29 7b 0a 20 20 69 6e 74 20 69 69 pgno){. int ii
120c0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
120d0 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
120e0 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 ter */. int rc
120f0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
12100 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 /* Result cod
12110 65 20 2a 2f 0a 0a 20 20 66 6f 72 28 69 69 3d 30 e */.. for(ii=0
12120 3b 20 69 69 3c 70 50 61 67 65 72 2d 3e 6e 53 61 ; ii<pPager->nSa
12130 76 65 70 6f 69 6e 74 3b 20 69 69 2b 2b 29 7b 0a vepoint; ii++){.
12140 20 20 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 PagerSavepoi
12150 6e 74 20 2a 70 20 3d 20 26 70 50 61 67 65 72 2d nt *p = &pPager-
12160 3e 61 53 61 76 65 70 6f 69 6e 74 5b 69 69 5d 3b >aSavepoint[ii];
12170 0a 20 20 20 20 69 66 28 20 70 67 6e 6f 3c 3d 70 . if( pgno<=p
12180 2d 3e 6e 4f 72 69 67 20 29 7b 0a 20 20 20 20 20 ->nOrig ){.
12190 20 72 63 20 7c 3d 20 73 71 6c 69 74 65 33 42 69 rc |= sqlite3Bi
121a0 74 76 65 63 53 65 74 28 70 2d 3e 70 49 6e 53 61 tvecSet(p->pInSa
121b0 76 65 70 6f 69 6e 74 2c 20 70 67 6e 6f 29 3b 0a vepoint, pgno);.
121c0 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
121d0 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc==SQLITE_NOMEM
121e0 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 );. assert
121f0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
12200 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f || rc==SQLITE_NO
12210 4d 45 4d 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d MEM );. }. }
12220 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
12230 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
12240 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 tion is a no-op
12250 69 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 if the pager is
12260 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
12270 65 20 61 6e 64 20 6e 6f 74 0a 2a 2a 20 69 6e 20 e and not.** in
12280 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 65 2e the ERROR state.
12290 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 73 Otherwise, it s
122a0 77 69 74 63 68 65 73 20 74 68 65 20 70 61 67 65 witches the page
122b0 72 20 74 6f 20 50 41 47 45 52 5f 4f 50 45 4e 0a r to PAGER_OPEN.
122c0 2a 2a 20 73 74 61 74 65 2e 0a 2a 2a 0a 2a 2a 20 ** state..**.**
122d0 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 If the pager is
122e0 6e 6f 74 20 69 6e 20 65 78 63 6c 75 73 69 76 65 not in exclusive
122f0 2d 61 63 63 65 73 73 20 6d 6f 64 65 2c 20 74 68 -access mode, th
12300 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
12310 69 73 0a 2a 2a 20 63 6f 6d 70 6c 65 74 65 6c 79 is.** completely
12320 20 75 6e 6c 6f 63 6b 65 64 2e 20 49 66 20 74 68 unlocked. If th
12330 65 20 66 69 6c 65 20 69 73 20 75 6e 6c 6f 63 6b e file is unlock
12340 65 64 20 61 6e 64 20 74 68 65 20 66 69 6c 65 2d ed and the file-
12350 73 79 73 74 65 6d 20 64 6f 65 73 0a 2a 2a 20 6e system does.** n
12360 6f 74 20 65 78 68 69 62 69 74 20 74 68 65 20 55 ot exhibit the U
12370 4e 44 45 4c 45 54 41 42 4c 45 5f 57 48 45 4e 5f NDELETABLE_WHEN_
12380 4f 50 45 4e 20 70 72 6f 70 65 72 74 79 2c 20 74 OPEN property, t
12390 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
123a0 69 73 0a 2a 2a 20 63 6c 6f 73 65 64 20 28 69 66 is.** closed (if
123b0 20 69 74 20 69 73 20 6f 70 65 6e 29 2e 0a 2a 2a it is open)..**
123c0 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 .** If the pager
123d0 20 69 73 20 69 6e 20 45 52 52 4f 52 20 73 74 61 is in ERROR sta
123e0 74 65 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e te when this fun
123f0 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c ction is called,
12400 20 74 68 65 20 0a 2a 2a 20 63 6f 6e 74 65 6e 74 the .** content
12410 73 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 63 s of the pager c
12420 61 63 68 65 20 61 72 65 20 64 69 73 63 61 72 64 ache are discard
12430 65 64 20 62 65 66 6f 72 65 20 73 77 69 74 63 68 ed before switch
12440 69 6e 67 20 62 61 63 6b 20 74 6f 20 0a 2a 2a 20 ing back to .**
12450 74 68 65 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 the OPEN state.
12460 52 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 Regardless of wh
12470 65 74 68 65 72 20 74 68 65 20 70 61 67 65 72 20 ether the pager
12480 69 73 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d is in exclusive-
12490 6d 6f 64 65 0a 2a 2a 20 6f 72 20 6e 6f 74 2c 20 mode.** or not,
124a0 61 6e 79 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 any journal file
124b0 20 6c 65 66 74 20 69 6e 20 74 68 65 20 66 69 6c left in the fil
124c0 65 2d 73 79 73 74 65 6d 20 77 69 6c 6c 20 62 65 e-system will be
124d0 20 74 72 65 61 74 65 64 0a 2a 2a 20 61 73 20 61 treated.** as a
124e0 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 61 6e 64 hot-journal and
124f0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 74 68 65 rolled back the
12500 20 6e 65 78 74 20 74 69 6d 65 20 61 20 72 65 61 next time a rea
12510 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a d-transaction.**
12520 20 69 73 20 6f 70 65 6e 65 64 20 28 62 79 20 74 is opened (by t
12530 68 69 73 20 6f 72 20 62 79 20 61 6e 79 20 6f 74 his or by any ot
12540 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 29 2e her connection).
12550 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
12560 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 50 61 67 pager_unlock(Pag
12570 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 0a 20 20 er *pPager){..
12580 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
12590 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 eState==PAGER_RE
125a0 41 44 45 52 20 0a 20 20 20 20 20 20 20 7c 7c 20 ADER . ||
125b0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d pPager->eState==
125c0 50 41 47 45 52 5f 4f 50 45 4e 20 0a 20 20 20 20 PAGER_OPEN .
125d0 20 20 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 || pPager->eS
125e0 74 61 74 65 3d 3d 50 41 47 45 52 5f 45 52 52 4f tate==PAGER_ERRO
125f0 52 20 0a 20 20 29 3b 0a 0a 20 20 73 71 6c 69 74 R . );.. sqlit
12600 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 e3BitvecDestroy(
12610 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e pPager->pInJourn
12620 61 6c 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e 70 al);. pPager->p
12630 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b 0a 20 InJournal = 0;.
12640 20 72 65 6c 65 61 73 65 41 6c 6c 53 61 76 65 70 releaseAllSavep
12650 6f 69 6e 74 73 28 70 50 61 67 65 72 29 3b 0a 0a oints(pPager);..
12660 20 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 if( pagerUseWa
12670 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 l(pPager) ){.
12680 20 61 73 73 65 72 74 28 20 21 69 73 4f 70 65 6e assert( !isOpen
12690 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b (pPager->jfd) );
126a0 0a 20 20 20 20 73 71 6c 69 74 65 33 57 61 6c 45 . sqlite3WalE
126b0 6e 64 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f ndReadTransactio
126c0 6e 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 29 3b n(pPager->pWal);
126d0 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 . pPager->eSt
126e0 61 74 65 20 3d 20 50 41 47 45 52 5f 4f 50 45 4e ate = PAGER_OPEN
126f0 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 21 70 ;. }else if( !p
12700 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 Pager->exclusive
12710 4d 6f 64 65 20 29 7b 0a 20 20 20 20 69 6e 74 20 Mode ){. int
12720 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
12730 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 /* Err
12740 6f 72 20 63 6f 64 65 20 72 65 74 75 72 6e 65 64 or code returned
12750 20 62 79 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 by pagerUnlockD
12760 62 28 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 b() */. int i
12770 44 63 20 3d 20 69 73 4f 70 65 6e 28 70 50 61 67 Dc = isOpen(pPag
12780 65 72 2d 3e 66 64 29 3f 73 71 6c 69 74 65 33 4f er->fd)?sqlite3O
12790 73 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 sDeviceCharacter
127a0 69 73 74 69 63 73 28 70 50 61 67 65 72 2d 3e 66 istics(pPager->f
127b0 64 29 3a 30 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 d):0;.. /* If
127c0 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 the operating s
127d0 79 73 74 65 6d 20 73 75 70 70 6f 72 74 20 64 65 ystem support de
127e0 6c 65 74 69 6f 6e 20 6f 66 20 6f 70 65 6e 20 66 letion of open f
127f0 69 6c 65 73 2c 20 74 68 65 6e 0a 20 20 20 20 2a iles, then. *
12800 2a 20 63 6c 6f 73 65 20 74 68 65 20 6a 6f 75 72 * close the jour
12810 6e 61 6c 20 66 69 6c 65 20 77 68 65 6e 20 64 72 nal file when dr
12820 6f 70 70 69 6e 67 20 74 68 65 20 64 61 74 61 62 opping the datab
12830 61 73 65 20 6c 6f 63 6b 2e 20 20 4f 74 68 65 72 ase lock. Other
12840 77 69 73 65 0a 20 20 20 20 2a 2a 20 61 6e 6f 74 wise. ** anot
12850 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 her connection w
12860 69 74 68 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 ith journal_mode
12870 3d 64 65 6c 65 74 65 20 6d 69 67 68 74 20 64 65 =delete might de
12880 6c 65 74 65 20 74 68 65 20 66 69 6c 65 0a 20 20 lete the file.
12890 20 20 2a 2a 20 6f 75 74 20 66 72 6f 6d 20 75 6e ** out from un
128a0 64 65 72 20 75 73 2e 0a 20 20 20 20 2a 2f 0a 20 der us.. */.
128b0 20 20 20 61 73 73 65 72 74 28 20 28 50 41 47 45 assert( (PAGE
128c0 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 R_JOURNALMODE_ME
128d0 4d 4f 52 59 20 20 20 26 20 35 29 21 3d 31 20 29 MORY & 5)!=1 )
128e0 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 50 ;. assert( (P
128f0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
12900 5f 4f 46 46 20 20 20 20 20 20 26 20 35 29 21 3d _OFF & 5)!=
12910 31 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 1 );. assert(
12920 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d (PAGER_JOURNALM
12930 4f 44 45 5f 57 41 4c 20 20 20 20 20 20 26 20 35 ODE_WAL & 5
12940 29 21 3d 31 20 29 3b 0a 20 20 20 20 61 73 73 65 )!=1 );. asse
12950 72 74 28 20 28 50 41 47 45 52 5f 4a 4f 55 52 4e rt( (PAGER_JOURN
12960 41 4c 4d 4f 44 45 5f 44 45 4c 45 54 45 20 20 20 ALMODE_DELETE
12970 26 20 35 29 21 3d 31 20 29 3b 0a 20 20 20 20 61 & 5)!=1 );. a
12980 73 73 65 72 74 28 20 28 50 41 47 45 52 5f 4a 4f ssert( (PAGER_JO
12990 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e 43 41 URNALMODE_TRUNCA
129a0 54 45 20 26 20 35 29 3d 3d 31 20 29 3b 0a 20 20 TE & 5)==1 );.
129b0 20 20 61 73 73 65 72 74 28 20 28 50 41 47 45 52 assert( (PAGER
129c0 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 _JOURNALMODE_PER
129d0 53 49 53 54 20 20 26 20 35 29 3d 3d 31 20 29 3b SIST & 5)==1 );
129e0 0a 20 20 20 20 69 66 28 20 30 3d 3d 28 69 44 63 . if( 0==(iDc
129f0 20 26 20 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f & SQLITE_IOCAP_
12a00 55 4e 44 45 4c 45 54 41 42 4c 45 5f 57 48 45 4e UNDELETABLE_WHEN
12a10 5f 4f 50 45 4e 29 0a 20 20 20 20 20 7c 7c 20 31 _OPEN). || 1
12a20 21 3d 28 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e !=(pPager->journ
12a30 61 6c 4d 6f 64 65 20 26 20 35 29 0a 20 20 20 20 alMode & 5).
12a40 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
12a50 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e OsClose(pPager->
12a60 6a 66 64 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 jfd);. }..
12a70 20 2f 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 /* If the pager
12a80 20 69 73 20 69 6e 20 74 68 65 20 45 52 52 4f 52 is in the ERROR
12a90 20 73 74 61 74 65 20 61 6e 64 20 74 68 65 20 63 state and the c
12aa0 61 6c 6c 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 all to unlock th
12ab0 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 2a e database. *
12ac0 2a 20 66 69 6c 65 20 66 61 69 6c 73 2c 20 73 65 * file fails, se
12ad0 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c 6f t the current lo
12ae0 63 6b 20 74 6f 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f ck to UNKNOWN_LO
12af0 43 4b 2e 20 53 65 65 20 74 68 65 20 63 6f 6d 6d CK. See the comm
12b00 65 6e 74 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 ent. ** above
12b10 20 74 68 65 20 23 64 65 66 69 6e 65 20 66 6f 72 the #define for
12b20 20 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 20 66 6f UNKNOWN_LOCK fo
12b30 72 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e r an explanation
12b40 20 6f 66 20 77 68 79 20 74 68 69 73 0a 20 20 20 of why this.
12b50 20 2a 2a 20 69 73 20 6e 65 63 65 73 73 61 72 79 ** is necessary
12b60 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 .. */. rc
12b70 3d 20 70 61 67 65 72 55 6e 6c 6f 63 6b 44 62 28 = pagerUnlockDb(
12b80 70 50 61 67 65 72 2c 20 4e 4f 5f 4c 4f 43 4b 29 pPager, NO_LOCK)
12b90 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 ;. if( rc!=SQ
12ba0 4c 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 LITE_OK && pPage
12bb0 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
12bc0 5f 45 52 52 4f 52 20 29 7b 0a 20 20 20 20 20 20 _ERROR ){.
12bd0 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 20 3d 20 pPager->eLock =
12be0 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 4b 3b 0a 20 20 UNKNOWN_LOCK;.
12bf0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 54 68 65 20 }.. /* The
12c00 70 61 67 65 72 20 73 74 61 74 65 20 6d 61 79 20 pager state may
12c10 62 65 20 63 68 61 6e 67 65 64 20 66 72 6f 6d 20 be changed from
12c20 50 41 47 45 52 5f 45 52 52 4f 52 20 74 6f 20 50 PAGER_ERROR to P
12c30 41 47 45 52 5f 4f 50 45 4e 20 68 65 72 65 0a 20 AGER_OPEN here.
12c40 20 20 20 2a 2a 20 77 69 74 68 6f 75 74 20 63 6c ** without cl
12c50 65 61 72 69 6e 67 20 74 68 65 20 65 72 72 6f 72 earing the error
12c60 20 63 6f 64 65 2e 20 54 68 69 73 20 69 73 20 69 code. This is i
12c70 6e 74 65 6e 74 69 6f 6e 61 6c 20 2d 20 74 68 65 ntentional - the
12c80 20 65 72 72 6f 72 0a 20 20 20 20 2a 2a 20 63 6f error. ** co
12c90 64 65 20 69 73 20 63 6c 65 61 72 65 64 20 61 6e de is cleared an
12ca0 64 20 74 68 65 20 63 61 63 68 65 20 72 65 73 65 d the cache rese
12cb0 74 20 69 6e 20 74 68 65 20 62 6c 6f 63 6b 20 62 t in the block b
12cc0 65 6c 6f 77 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 elow.. */.
12cd0 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
12ce0 3e 65 72 72 43 6f 64 65 20 7c 7c 20 70 50 61 67 >errCode || pPag
12cf0 65 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 er->eState!=PAGE
12d00 52 5f 45 52 52 4f 52 20 29 3b 0a 20 20 20 20 70 R_ERROR );. p
12d10 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 Pager->changeCou
12d20 6e 74 44 6f 6e 65 20 3d 20 30 3b 0a 20 20 20 20 ntDone = 0;.
12d30 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d pPager->eState =
12d40 20 50 41 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 7d PAGER_OPEN;. }
12d50 0a 0a 20 20 2f 2a 20 49 66 20 50 61 67 65 72 2e .. /* If Pager.
12d60 65 72 72 43 6f 64 65 20 69 73 20 73 65 74 2c 20 errCode is set,
12d70 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
12d80 74 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 the pager cache
12d90 63 61 6e 6e 6f 74 20 62 65 0a 20 20 2a 2a 20 74 cannot be. ** t
12da0 72 75 73 74 65 64 2e 20 4e 6f 77 20 74 68 61 74 rusted. Now that
12db0 20 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 75 there are no ou
12dc0 74 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 tstanding refere
12dd0 6e 63 65 73 20 74 6f 20 74 68 65 20 70 61 67 65 nces to the page
12de0 72 2c 0a 20 20 2a 2a 20 69 74 20 63 61 6e 20 73 r,. ** it can s
12df0 61 66 65 6c 79 20 6d 6f 76 65 20 62 61 63 6b 20 afely move back
12e00 74 6f 20 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 to PAGER_OPEN st
12e10 61 74 65 2e 20 54 68 69 73 20 68 61 70 70 65 6e ate. This happen
12e20 73 20 69 6e 20 62 6f 74 68 0a 20 20 2a 2a 20 6e s in both. ** n
12e30 6f 72 6d 61 6c 20 61 6e 64 20 65 78 63 6c 75 73 ormal and exclus
12e40 69 76 65 2d 6c 6f 63 6b 69 6e 67 20 6d 6f 64 65 ive-locking mode
12e50 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 .. */. assert(
12e60 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
12e70 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 21 ==SQLITE_OK || !
12e80 4d 45 4d 44 42 20 29 3b 0a 20 20 69 66 28 20 70 MEMDB );. if( p
12e90 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 Pager->errCode )
12ea0 7b 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 {. if( pPager
12eb0 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 29 7b ->tempFile==0 ){
12ec0 0a 20 20 20 20 20 20 70 61 67 65 72 5f 72 65 73 . pager_res
12ed0 65 74 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 et(pPager);.
12ee0 20 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 pPager->change
12ef0 43 6f 75 6e 74 44 6f 6e 65 20 3d 20 30 3b 0a 20 CountDone = 0;.
12f00 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 pPager->eSt
12f10 61 74 65 20 3d 20 50 41 47 45 52 5f 4f 50 45 4e ate = PAGER_OPEN
12f20 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
12f30 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 pPager->eStat
12f40 65 20 3d 20 28 69 73 4f 70 65 6e 28 70 50 61 67 e = (isOpen(pPag
12f50 65 72 2d 3e 6a 66 64 29 20 3f 20 50 41 47 45 52 er->jfd) ? PAGER
12f60 5f 4f 50 45 4e 20 3a 20 50 41 47 45 52 5f 52 45 _OPEN : PAGER_RE
12f70 41 44 45 52 29 3b 0a 20 20 20 20 7d 0a 20 20 20 ADER);. }.
12f80 20 69 66 28 20 55 53 45 46 45 54 43 48 28 70 50 if( USEFETCH(pP
12f90 61 67 65 72 29 20 29 20 73 71 6c 69 74 65 33 4f ager) ) sqlite3O
12fa0 73 55 6e 66 65 74 63 68 28 70 50 61 67 65 72 2d sUnfetch(pPager-
12fb0 3e 66 64 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 >fd, 0, 0);.
12fc0 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 pPager->errCode
12fd0 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
12fe0 20 73 65 74 47 65 74 74 65 72 4d 65 74 68 6f 64 setGetterMethod
12ff0 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 (pPager);. }..
13000 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c pPager->journal
13010 4f 66 66 20 3d 20 30 3b 0a 20 20 70 50 61 67 65 Off = 0;. pPage
13020 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 r->journalHdr =
13030 30 3b 0a 20 20 70 50 61 67 65 72 2d 3e 73 65 74 0;. pPager->set
13040 4d 61 73 74 65 72 20 3d 20 30 3b 0a 7d 0a 0a 2f Master = 0;.}../
13050 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
13060 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 on is called whe
13070 6e 65 76 65 72 20 61 6e 20 49 4f 45 52 52 20 6f never an IOERR o
13080 72 20 46 55 4c 4c 20 65 72 72 6f 72 20 74 68 61 r FULL error tha
13090 74 20 72 65 71 75 69 72 65 73 0a 2a 2a 20 74 68 t requires.** th
130a0 65 20 70 61 67 65 72 20 74 6f 20 74 72 61 6e 73 e pager to trans
130b0 69 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 45 ition into the E
130c0 52 52 4f 52 20 73 74 61 74 65 20 6d 61 79 20 61 RROR state may a
130d0 68 76 65 20 6f 63 63 75 72 72 65 64 2e 0a 2a 2a hve occurred..**
130e0 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d The first argum
130f0 65 6e 74 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ent is a pointer
13100 20 74 6f 20 74 68 65 20 70 61 67 65 72 20 73 74 to the pager st
13110 72 75 63 74 75 72 65 2c 20 74 68 65 20 73 65 63 ructure, the sec
13120 6f 6e 64 20 0a 2a 2a 20 74 68 65 20 65 72 72 6f ond .** the erro
13130 72 2d 63 6f 64 65 20 61 62 6f 75 74 20 74 6f 20 r-code about to
13140 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 61 be returned by a
13150 20 70 61 67 65 72 20 41 50 49 20 66 75 6e 63 74 pager API funct
13160 69 6f 6e 2e 20 54 68 65 20 0a 2a 2a 20 76 61 6c ion. The .** val
13170 75 65 20 72 65 74 75 72 6e 65 64 20 69 73 20 61 ue returned is a
13180 20 63 6f 70 79 20 6f 66 20 74 68 65 20 73 65 63 copy of the sec
13190 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 ond argument to
131a0 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 0a this function. .
131b0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 65 63 **.** If the sec
131c0 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ond argument is
131d0 53 51 4c 49 54 45 5f 46 55 4c 4c 2c 20 53 51 4c SQLITE_FULL, SQL
131e0 49 54 45 5f 49 4f 45 52 52 20 6f 72 20 6f 6e 65 ITE_IOERR or one
131f0 20 6f 66 20 74 68 65 0a 2a 2a 20 49 4f 45 52 52 of the.** IOERR
13200 20 73 75 62 2d 63 6f 64 65 73 2c 20 74 68 65 20 sub-codes, the
13210 70 61 67 65 72 20 65 6e 74 65 72 73 20 74 68 65 pager enters the
13220 20 45 52 52 4f 52 20 73 74 61 74 65 20 61 6e 64 ERROR state and
13230 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 0a the error code.
13240 2a 2a 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 ** is stored in
13250 50 61 67 65 72 2e 65 72 72 43 6f 64 65 2e 20 57 Pager.errCode. W
13260 68 69 6c 65 20 74 68 65 20 70 61 67 65 72 20 72 hile the pager r
13270 65 6d 61 69 6e 73 20 69 6e 20 74 68 65 20 45 52 emains in the ER
13280 52 4f 52 20 73 74 61 74 65 2c 0a 2a 2a 20 61 6c ROR state,.** al
13290 6c 20 6d 61 6a 6f 72 20 41 50 49 20 63 61 6c 6c l major API call
132a0 73 20 6f 6e 20 74 68 65 20 50 61 67 65 72 20 77 s on the Pager w
132b0 69 6c 6c 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 ill immediately
132c0 72 65 74 75 72 6e 20 50 61 67 65 72 2e 65 72 72 return Pager.err
132d0 43 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 Code..**.** The
132e0 45 52 52 4f 52 20 73 74 61 74 65 20 69 6e 64 69 ERROR state indi
132f0 63 61 74 65 73 20 74 68 61 74 20 74 68 65 20 63 cates that the c
13300 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 ontents of the p
13310 61 67 65 72 2d 63 61 63 68 65 20 0a 2a 2a 20 63 ager-cache .** c
13320 61 6e 6e 6f 74 20 62 65 20 74 72 75 73 74 65 64 annot be trusted
13330 2e 20 54 68 69 73 20 73 74 61 74 65 20 63 61 6e . This state can
13340 20 62 65 20 63 6c 65 61 72 65 64 20 62 79 20 63 be cleared by c
13350 6f 6d 70 6c 65 74 65 6c 79 20 64 69 73 63 61 72 ompletely discar
13360 64 69 6e 67 20 0a 2a 2a 20 74 68 65 20 63 6f 6e ding .** the con
13370 74 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 tents of the pag
13380 65 72 2d 63 61 63 68 65 2e 20 49 66 20 61 20 74 er-cache. If a t
13390 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 61 ransaction was a
133a0 63 74 69 76 65 20 77 68 65 6e 0a 2a 2a 20 74 68 ctive when.** th
133b0 65 20 70 65 72 73 69 73 74 65 6e 74 20 65 72 72 e persistent err
133c0 6f 72 20 6f 63 63 75 72 72 65 64 2c 20 74 68 65 or occurred, the
133d0 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a n the rollback j
133e0 6f 75 72 6e 61 6c 20 6d 61 79 20 6e 65 65 64 0a ournal may need.
133f0 2a 2a 20 74 6f 20 62 65 20 72 65 70 6c 61 79 65 ** to be replaye
13400 64 20 74 6f 20 72 65 73 74 6f 72 65 20 74 68 65 d to restore the
13410 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
13420 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 28 database file (
13430 61 73 20 69 66 0a 2a 2a 20 69 74 20 77 65 72 65 as if.** it were
13440 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 29 2e a hot-journal).
13450 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
13460 61 67 65 72 5f 65 72 72 6f 72 28 50 61 67 65 72 ager_error(Pager
13470 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 72 63 *pPager, int rc
13480 29 7b 0a 20 20 69 6e 74 20 72 63 32 20 3d 20 72 ){. int rc2 = r
13490 63 20 26 20 30 78 66 66 3b 0a 20 20 61 73 73 65 c & 0xff;. asse
134a0 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f rt( rc==SQLITE_O
134b0 4b 20 7c 7c 20 21 4d 45 4d 44 42 20 29 3b 0a 20 K || !MEMDB );.
134c0 20 61 73 73 65 72 74 28 0a 20 20 20 20 20 20 20 assert(.
134d0 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d pPager->errCode=
134e0 3d 53 51 4c 49 54 45 5f 46 55 4c 4c 20 7c 7c 0a =SQLITE_FULL ||.
134f0 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 65 pPager->e
13500 72 72 43 6f 64 65 3d 3d 53 51 4c 49 54 45 5f 4f rrCode==SQLITE_O
13510 4b 20 7c 7c 0a 20 20 20 20 20 20 20 28 70 50 61 K ||. (pPa
13520 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 26 20 30 ger->errCode & 0
13530 78 66 66 29 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 xff)==SQLITE_IOE
13540 52 52 0a 20 20 29 3b 0a 20 20 69 66 28 20 72 63 RR. );. if( rc
13550 32 3d 3d 53 51 4c 49 54 45 5f 46 55 4c 4c 20 7c 2==SQLITE_FULL |
13560 7c 20 72 63 32 3d 3d 53 51 4c 49 54 45 5f 49 4f | rc2==SQLITE_IO
13570 45 52 52 20 29 7b 0a 20 20 20 20 70 50 61 67 65 ERR ){. pPage
13580 72 2d 3e 65 72 72 43 6f 64 65 20 3d 20 72 63 3b r->errCode = rc;
13590 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 . pPager->eSt
135a0 61 74 65 20 3d 20 50 41 47 45 52 5f 45 52 52 4f ate = PAGER_ERRO
135b0 52 3b 0a 20 20 20 20 73 65 74 47 65 74 74 65 72 R;. setGetter
135c0 4d 65 74 68 6f 64 28 70 50 61 67 65 72 29 3b 0a Method(pPager);.
135d0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b }. return rc;
135e0 0a 7d 0a 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .}..static int p
135f0 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 50 61 ager_truncate(Pa
13600 67 65 72 20 2a 70 50 61 67 65 72 2c 20 50 67 6e ger *pPager, Pgn
13610 6f 20 6e 50 61 67 65 29 3b 0a 0a 2f 2a 0a 2a 2a o nPage);../*.**
13620 20 54 68 65 20 77 72 69 74 65 20 74 72 61 6e 73 The write trans
13630 61 63 74 69 6f 6e 20 6f 70 65 6e 20 6f 6e 20 70 action open on p
13640 50 61 67 65 72 20 69 73 20 62 65 69 6e 67 20 63 Pager is being c
13650 6f 6d 6d 69 74 74 65 64 20 28 62 43 6f 6d 6d 69 ommitted (bCommi
13660 74 3d 3d 31 29 0a 2a 2a 20 6f 72 20 72 6f 6c 6c t==1).** or roll
13670 65 64 20 62 61 63 6b 20 28 62 43 6f 6d 6d 69 74 ed back (bCommit
13680 3d 3d 30 29 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 ==0)..**.** Retu
13690 72 6e 20 54 52 55 45 20 69 66 20 61 6e 64 20 6f rn TRUE if and o
136a0 6e 6c 79 20 69 66 20 61 6c 6c 20 64 69 72 74 79 nly if all dirty
136b0 20 70 61 67 65 73 20 73 68 6f 75 6c 64 20 62 65 pages should be
136c0 20 66 6c 75 73 68 65 64 20 74 6f 20 64 69 73 6b flushed to disk
136d0 2e 0a 2a 2a 0a 2a 2a 20 52 75 6c 65 73 3a 0a 2a ..**.** Rules:.*
136e0 2a 0a 2a 2a 20 20 20 2a 20 20 46 6f 72 20 6e 6f *.** * For no
136f0 6e 2d 54 45 4d 50 20 64 61 74 61 62 61 73 65 73 n-TEMP databases
13700 2c 20 61 6c 77 61 79 73 20 73 79 6e 63 20 74 6f , always sync to
13710 20 64 69 73 6b 2e 20 20 54 68 69 73 20 69 73 20 disk. This is
13720 6e 65 63 65 73 73 61 72 79 0a 2a 2a 20 20 20 20 necessary.**
13730 20 20 66 6f 72 20 74 72 61 6e 73 61 63 74 69 6f for transactio
13740 6e 73 20 74 6f 20 62 65 20 64 75 72 61 62 6c 65 ns to be durable
13750 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 20 53 79 6e ..**.** * Syn
13760 63 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 20 c TEMP database
13770 6f 6e 6c 79 20 6f 6e 20 61 20 43 4f 4d 4d 49 54 only on a COMMIT
13780 20 28 6e 6f 74 20 61 20 52 4f 4c 4c 42 41 43 4b (not a ROLLBACK
13790 29 20 77 68 65 6e 20 74 68 65 20 62 61 63 6b 69 ) when the backi
137a0 6e 67 0a 2a 2a 20 20 20 20 20 20 66 69 6c 65 20 ng.** file
137b0 68 61 73 20 62 65 65 6e 20 63 72 65 61 74 65 64 has been created
137c0 20 61 6c 72 65 61 64 79 20 28 76 69 61 20 61 20 already (via a
137d0 73 70 69 6c 6c 20 6f 6e 20 70 61 67 65 72 53 74 spill on pagerSt
137e0 72 65 73 73 28 29 29 20 61 6e 64 0a 2a 2a 20 20 ress()) and.**
137f0 20 20 20 20 77 68 65 6e 20 74 68 65 20 6e 75 6d when the num
13800 62 65 72 20 6f 66 20 64 69 72 74 79 20 70 61 67 ber of dirty pag
13810 65 73 20 69 6e 20 6d 65 6d 6f 72 79 20 65 78 63 es in memory exc
13820 65 65 64 73 20 32 35 25 20 6f 66 20 74 68 65 20 eeds 25% of the
13830 74 6f 74 61 6c 0a 2a 2a 20 20 20 20 20 20 63 61 total.** ca
13840 63 68 65 20 73 69 7a 65 2e 0a 2a 2f 0a 73 74 61 che size..*/.sta
13850 74 69 63 20 69 6e 74 20 70 61 67 65 72 46 6c 75 tic int pagerFlu
13860 73 68 4f 6e 43 6f 6d 6d 69 74 28 50 61 67 65 72 shOnCommit(Pager
13870 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 62 43 *pPager, int bC
13880 6f 6d 6d 69 74 29 7b 0a 20 20 69 66 28 20 70 50 ommit){. if( pP
13890 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d ager->tempFile==
138a0 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 0 ) return 1;.
138b0 69 66 28 20 21 62 43 6f 6d 6d 69 74 20 29 20 72 if( !bCommit ) r
138c0 65 74 75 72 6e 20 30 3b 0a 20 20 69 66 28 20 21 eturn 0;. if( !
138d0 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 isOpen(pPager->f
138e0 64 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 d) ) return 0;.
138f0 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65 33 return (sqlite3
13900 50 43 61 63 68 65 50 65 72 63 65 6e 74 44 69 72 PCachePercentDir
13910 74 79 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 ty(pPager->pPCac
13920 68 65 29 3e 3d 32 35 29 3b 0a 7d 0a 0a 2f 2a 0a he)>=25);.}../*.
13930 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
13940 65 6e 64 73 20 61 20 74 72 61 6e 73 61 63 74 69 ends a transacti
13950 6f 6e 2e 20 41 20 74 72 61 6e 73 61 63 74 69 6f on. A transactio
13960 6e 20 69 73 20 75 73 75 61 6c 6c 79 20 65 6e 64 n is usually end
13970 65 64 20 62 79 20 0a 2a 2a 20 65 69 74 68 65 72 ed by .** either
13980 20 61 20 43 4f 4d 4d 49 54 20 6f 72 20 61 20 52 a COMMIT or a R
13990 4f 4c 4c 42 41 43 4b 20 6f 70 65 72 61 74 69 6f OLLBACK operatio
139a0 6e 2e 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 n. This routine
139b0 6d 61 79 20 62 65 20 63 61 6c 6c 65 64 20 0a 2a may be called .*
139c0 2a 20 61 66 74 65 72 20 72 6f 6c 6c 62 61 63 6b * after rollback
139d0 20 6f 66 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 of a hot-journa
139e0 6c 2c 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f l, or if an erro
139f0 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 6f r occurs while o
13a00 70 65 6e 69 6e 67 0a 2a 2a 20 74 68 65 20 6a 6f pening.** the jo
13a10 75 72 6e 61 6c 20 66 69 6c 65 20 6f 72 20 77 72 urnal file or wr
13a20 69 74 69 6e 67 20 74 68 65 20 76 65 72 79 20 66 iting the very f
13a30 69 72 73 74 20 6a 6f 75 72 6e 61 6c 2d 68 65 61 irst journal-hea
13a40 64 65 72 20 6f 66 20 61 0a 2a 2a 20 64 61 74 61 der of a.** data
13a50 62 61 73 65 20 74 72 61 6e 73 61 63 74 69 6f 6e base transaction
13a60 2e 0a 2a 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f ..** .** This ro
13a70 75 74 69 6e 65 20 69 73 20 6e 65 76 65 72 20 63 utine is never c
13a80 61 6c 6c 65 64 20 69 6e 20 50 41 47 45 52 5f 45 alled in PAGER_E
13a90 52 52 4f 52 20 73 74 61 74 65 2e 20 49 66 20 69 RROR state. If i
13aa0 74 20 69 73 20 63 61 6c 6c 65 64 0a 2a 2a 20 69 t is called.** i
13ab0 6e 20 50 41 47 45 52 5f 4e 4f 4e 45 20 6f 72 20 n PAGER_NONE or
13ac0 50 41 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 PAGER_SHARED sta
13ad0 74 65 20 61 6e 64 20 74 68 65 20 6c 6f 63 6b 20 te and the lock
13ae0 68 65 6c 64 20 69 73 20 6c 65 73 73 0a 2a 2a 20 held is less.**
13af0 65 78 63 6c 75 73 69 76 65 20 74 68 61 6e 20 61 exclusive than a
13b00 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 2c 20 RESERVED lock,
13b10 69 74 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a it is a no-op..*
13b20 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 *.** Otherwise,
13b30 61 6e 79 20 61 63 74 69 76 65 20 73 61 76 65 70 any active savep
13b40 6f 69 6e 74 73 20 61 72 65 20 72 65 6c 65 61 73 oints are releas
13b50 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
13b60 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
13b70 20 6f 70 65 6e 2c 20 74 68 65 6e 20 69 74 20 69 open, then it i
13b80 73 20 22 66 69 6e 61 6c 69 7a 65 64 22 2e 20 4f s "finalized". O
13b90 6e 63 65 20 61 20 6a 6f 75 72 6e 61 6c 20 0a 2a nce a journal .*
13ba0 2a 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 * file has been
13bb0 66 69 6e 61 6c 69 7a 65 64 20 69 74 20 69 73 20 finalized it is
13bc0 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 not possible to
13bd0 75 73 65 20 69 74 20 74 6f 20 72 6f 6c 6c 20 62 use it to roll b
13be0 61 63 6b 20 61 20 0a 2a 2a 20 74 72 61 6e 73 61 ack a .** transa
13bf0 63 74 69 6f 6e 2e 20 4e 6f 72 20 77 69 6c 6c 20 ction. Nor will
13c00 69 74 20 62 65 20 63 6f 6e 73 69 64 65 72 65 64 it be considered
13c10 20 74 6f 20 62 65 20 61 20 68 6f 74 2d 6a 6f 75 to be a hot-jou
13c20 72 6e 61 6c 20 62 79 20 74 68 69 73 0a 2a 2a 20 rnal by this.**
13c30 6f 72 20 61 6e 79 20 6f 74 68 65 72 20 64 61 74 or any other dat
13c40 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
13c50 2e 20 45 78 61 63 74 6c 79 20 68 6f 77 20 61 20 . Exactly how a
13c60 6a 6f 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c journal is final
13c70 69 7a 65 64 0a 2a 2a 20 64 65 70 65 6e 64 73 20 ized.** depends
13c80 6f 6e 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f on whether or no
13c90 74 20 74 68 65 20 70 61 67 65 72 20 69 73 20 72 t the pager is r
13ca0 75 6e 6e 69 6e 67 20 69 6e 20 65 78 63 6c 75 73 unning in exclus
13cb0 69 76 65 20 6d 6f 64 65 20 61 6e 64 0a 2a 2a 20 ive mode and.**
13cc0 74 68 65 20 63 75 72 72 65 6e 74 20 6a 6f 75 72 the current jour
13cd0 6e 61 6c 2d 6d 6f 64 65 20 28 50 61 67 65 72 2e nal-mode (Pager.
13ce0 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 76 61 6c 75 journalMode valu
13cf0 65 29 2c 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a e), as follows:.
13d00 2a 2a 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d **.** journalM
13d10 6f 64 65 3d 3d 4d 45 4d 4f 52 59 0a 2a 2a 20 20 ode==MEMORY.**
13d20 20 20 20 4a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 Journal file
13d30 64 65 73 63 72 69 70 74 6f 72 20 69 73 20 73 69 descriptor is si
13d40 6d 70 6c 79 20 63 6c 6f 73 65 64 2e 20 54 68 69 mply closed. Thi
13d50 73 20 64 65 73 74 72 6f 79 73 20 61 6e 20 0a 2a s destroys an .*
13d60 2a 20 20 20 20 20 69 6e 2d 6d 65 6d 6f 72 79 20 * in-memory
13d70 6a 6f 75 72 6e 61 6c 2e 0a 2a 2a 0a 2a 2a 20 20 journal..**.**
13d80 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 54 52 journalMode==TR
13d90 55 4e 43 41 54 45 0a 2a 2a 20 20 20 20 20 4a 6f UNCATE.** Jo
13da0 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 74 72 urnal file is tr
13db0 75 6e 63 61 74 65 64 20 74 6f 20 7a 65 72 6f 20 uncated to zero
13dc0 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e 0a 2a bytes in size..*
13dd0 2a 0a 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f *.** journalMo
13de0 64 65 3d 3d 50 45 52 53 49 53 54 0a 2a 2a 20 20 de==PERSIST.**
13df0 20 20 20 54 68 65 20 66 69 72 73 74 20 32 38 20 The first 28
13e00 62 79 74 65 73 20 6f 66 20 74 68 65 20 6a 6f 75 bytes of the jou
13e10 72 6e 61 6c 20 66 69 6c 65 20 61 72 65 20 7a 65 rnal file are ze
13e20 72 6f 65 64 2e 20 54 68 69 73 20 69 6e 76 61 6c roed. This inval
13e30 69 64 61 74 65 73 0a 2a 2a 20 20 20 20 20 74 68 idates.** th
13e40 65 20 66 69 72 73 74 20 6a 6f 75 72 6e 61 6c 20 e first journal
13e50 68 65 61 64 65 72 20 69 6e 20 74 68 65 20 66 69 header in the fi
13e60 6c 65 2c 20 61 6e 64 20 68 65 6e 63 65 20 74 68 le, and hence th
13e70 65 20 65 6e 74 69 72 65 20 6a 6f 75 72 6e 61 6c e entire journal
13e80 0a 2a 2a 20 20 20 20 20 66 69 6c 65 2e 20 41 6e .** file. An
13e90 20 69 6e 76 61 6c 69 64 20 6a 6f 75 72 6e 61 6c invalid journal
13ea0 20 66 69 6c 65 20 63 61 6e 6e 6f 74 20 62 65 20 file cannot be
13eb0 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a 0a rolled back..**.
13ec0 2a 2a 20 20 20 6a 6f 75 72 6e 61 6c 4d 6f 64 65 ** journalMode
13ed0 3d 3d 44 45 4c 45 54 45 0a 2a 2a 20 20 20 20 20 ==DELETE.**
13ee0 54 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 The journal file
13ef0 20 69 73 20 63 6c 6f 73 65 64 20 61 6e 64 20 64 is closed and d
13f00 65 6c 65 74 65 64 20 75 73 69 6e 67 20 73 71 6c eleted using sql
13f10 69 74 65 33 4f 73 44 65 6c 65 74 65 28 29 2e 0a ite3OsDelete()..
13f20 2a 2a 0a 2a 2a 20 20 20 20 20 49 66 20 74 68 65 **.** If the
13f30 20 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 6e pager is runnin
13f40 67 20 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d g in exclusive m
13f50 6f 64 65 2c 20 74 68 69 73 20 6d 65 74 68 6f 64 ode, this method
13f60 20 6f 66 20 66 69 6e 61 6c 69 7a 69 6e 67 0a 2a of finalizing.*
13f70 2a 20 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 * the journa
13f80 6c 20 66 69 6c 65 20 69 73 20 6e 65 76 65 72 20 l file is never
13f90 75 73 65 64 2e 20 49 6e 73 74 65 61 64 2c 20 69 used. Instead, i
13fa0 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 4d 6f 64 f the journalMod
13fb0 65 20 69 73 0a 2a 2a 20 20 20 20 20 44 45 4c 45 e is.** DELE
13fc0 54 45 20 61 6e 64 20 74 68 65 20 70 61 67 65 72 TE and the pager
13fd0 20 69 73 20 69 6e 20 65 78 63 6c 75 73 69 76 65 is in exclusive
13fe0 20 6d 6f 64 65 2c 20 74 68 65 20 6d 65 74 68 6f mode, the metho
13ff0 64 20 64 65 73 63 72 69 62 65 64 20 75 6e 64 65 d described unde
14000 72 0a 2a 2a 20 20 20 20 20 6a 6f 75 72 6e 61 6c r.** journal
14010 4d 6f 64 65 3d 3d 50 45 52 53 49 53 54 20 69 73 Mode==PERSIST is
14020 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e 0a 2a used instead..*
14030 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 65 20 6a *.** After the j
14040 6f 75 72 6e 61 6c 20 69 73 20 66 69 6e 61 6c 69 ournal is finali
14050 7a 65 64 2c 20 74 68 65 20 70 61 67 65 72 20 6d zed, the pager m
14060 6f 76 65 73 20 74 6f 20 50 41 47 45 52 5f 52 45 oves to PAGER_RE
14070 41 44 45 52 20 73 74 61 74 65 2e 0a 2a 2a 20 49 ADER state..** I
14080 66 20 72 75 6e 6e 69 6e 67 20 69 6e 20 6e 6f 6e f running in non
14090 2d 65 78 63 6c 75 73 69 76 65 20 72 6f 6c 6c 62 -exclusive rollb
140a0 61 63 6b 20 6d 6f 64 65 2c 20 74 68 65 20 6c 6f ack mode, the lo
140b0 63 6b 20 6f 6e 20 74 68 65 20 66 69 6c 65 20 69 ck on the file i
140c0 73 20 0a 2a 2a 20 64 6f 77 6e 67 72 61 64 65 64 s .** downgraded
140d0 20 74 6f 20 61 20 53 48 41 52 45 44 5f 4c 4f 43 to a SHARED_LOC
140e0 4b 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f K..**.** SQLITE_
140f0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 OK is returned i
14100 66 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 f no error occur
14110 73 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f s. If an error o
14120 63 63 75 72 73 20 64 75 72 69 6e 67 0a 2a 2a 20 ccurs during.**
14130 61 6e 79 20 6f 66 20 74 68 65 20 49 4f 20 6f 70 any of the IO op
14140 65 72 61 74 69 6f 6e 73 20 74 6f 20 66 69 6e 61 erations to fina
14150 6c 69 7a 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c lize the journal
14160 20 66 69 6c 65 20 6f 72 20 75 6e 6c 6f 63 6b 20 file or unlock
14170 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 the.** database
14180 74 68 65 6e 20 74 68 65 20 49 4f 20 65 72 72 6f then the IO erro
14190 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e r code is return
141a0 65 64 20 74 6f 20 74 68 65 20 75 73 65 72 2e 20 ed to the user.
141b0 49 66 20 74 68 65 20 0a 2a 2a 20 6f 70 65 72 61 If the .** opera
141c0 74 69 6f 6e 20 74 6f 20 66 69 6e 61 6c 69 7a 65 tion to finalize
141d0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
141e0 65 20 66 61 69 6c 73 2c 20 74 68 65 6e 20 74 68 e fails, then th
141f0 65 20 63 6f 64 65 20 73 74 69 6c 6c 0a 2a 2a 20 e code still.**
14200 74 72 69 65 73 20 74 6f 20 75 6e 6c 6f 63 6b 20 tries to unlock
14210 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
14220 65 20 69 66 20 6e 6f 74 20 69 6e 20 65 78 63 6c e if not in excl
14230 75 73 69 76 65 20 6d 6f 64 65 2e 20 49 66 20 74 usive mode. If t
14240 68 65 0a 2a 2a 20 75 6e 6c 6f 63 6b 20 6f 70 65 he.** unlock ope
14250 72 61 74 69 6f 6e 20 66 61 69 6c 73 20 61 73 20 ration fails as
14260 77 65 6c 6c 2c 20 74 68 65 6e 20 74 68 65 20 66 well, then the f
14270 69 72 73 74 20 65 72 72 6f 72 20 63 6f 64 65 20 irst error code
14280 72 65 6c 61 74 65 64 0a 2a 2a 20 74 6f 20 74 68 related.** to th
14290 65 20 66 69 72 73 74 20 65 72 72 6f 72 20 65 6e e first error en
142a0 63 6f 75 6e 74 65 72 65 64 20 28 74 68 65 20 6a countered (the j
142b0 6f 75 72 6e 61 6c 20 66 69 6e 61 6c 69 7a 61 74 ournal finalizat
142c0 69 6f 6e 20 6f 6e 65 29 20 69 73 0a 2a 2a 20 72 ion one) is.** r
142d0 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 eturned..*/.stat
142e0 69 63 20 69 6e 74 20 70 61 67 65 72 5f 65 6e 64 ic int pager_end
142f0 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 67 _transaction(Pag
14300 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 er *pPager, int
14310 68 61 73 4d 61 73 74 65 72 2c 20 69 6e 74 20 62 hasMaster, int b
14320 43 6f 6d 6d 69 74 29 7b 0a 20 20 69 6e 74 20 72 Commit){. int r
14330 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 c = SQLITE_OK;
14340 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 /* Error cod
14350 65 20 66 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 66 e from journal f
14360 69 6e 61 6c 69 7a 61 74 69 6f 6e 20 6f 70 65 72 inalization oper
14370 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 ation */. int r
14380 63 32 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 c2 = SQLITE_OK;
14390 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 63 6f 64 /* Error cod
143a0 65 20 66 72 6f 6d 20 64 62 20 66 69 6c 65 20 75 e from db file u
143b0 6e 6c 6f 63 6b 20 6f 70 65 72 61 74 69 6f 6e 20 nlock operation
143c0 2a 2f 0a 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 68 */.. /* Do noth
143d0 69 6e 67 20 69 66 20 74 68 65 20 70 61 67 65 72 ing if the pager
143e0 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 does not have a
143f0 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61 n open write tra
14400 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20 6f 72 nsaction. ** or
14410 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 at least a RESE
14420 52 56 45 44 20 6c 6f 63 6b 2e 20 54 68 69 73 20 RVED lock. This
14430 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 20 function may be
14440 63 61 6c 6c 65 64 20 77 68 65 6e 20 74 68 65 72 called when ther
14450 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 20 77 72 69 e. ** is no wri
14460 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 te-transaction a
14470 63 74 69 76 65 20 62 75 74 20 61 20 52 45 53 45 ctive but a RESE
14480 52 56 45 44 20 6f 72 20 67 72 65 61 74 65 72 20 RVED or greater
14490 6c 6f 63 6b 20 69 73 0a 20 20 2a 2a 20 68 65 6c lock is. ** hel
144a0 64 20 75 6e 64 65 72 20 74 77 6f 20 63 69 72 63 d under two circ
144b0 75 6d 73 74 61 6e 63 65 73 3a 0a 20 20 2a 2a 0a umstances:. **.
144c0 20 20 2a 2a 20 20 20 31 2e 20 41 66 74 65 72 20 ** 1. After
144d0 61 20 73 75 63 63 65 73 73 66 75 6c 20 68 6f 74 a successful hot
144e0 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 -journal rollbac
144f0 6b 2c 20 69 74 20 69 73 20 63 61 6c 6c 65 64 20 k, it is called
14500 77 69 74 68 0a 20 20 2a 2a 20 20 20 20 20 20 65 with. ** e
14510 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4e 4f 4e State==PAGER_NON
14520 45 20 61 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 E and eLock==EXC
14530 4c 55 53 49 56 45 5f 4c 4f 43 4b 2e 0a 20 20 2a LUSIVE_LOCK.. *
14540 2a 0a 20 20 2a 2a 20 20 20 32 2e 20 49 66 20 61 *. ** 2. If a
14550 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 69 74 68 connection with
14560 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 locking_mode=ex
14570 63 6c 75 73 69 76 65 20 68 6f 6c 64 69 6e 67 20 clusive holding
14580 61 6e 20 45 58 43 4c 55 53 49 56 45 20 0a 20 20 an EXCLUSIVE .
14590 2a 2a 20 20 20 20 20 20 6c 6f 63 6b 20 73 77 69 ** lock swi
145a0 74 63 68 65 73 20 62 61 63 6b 20 74 6f 20 6c 6f tches back to lo
145b0 63 6b 69 6e 67 5f 6d 6f 64 65 3d 6e 6f 72 6d 61 cking_mode=norma
145c0 6c 20 61 6e 64 20 74 68 65 6e 20 65 78 65 63 75 l and then execu
145d0 74 65 73 20 61 0a 20 20 2a 2a 20 20 20 20 20 20 tes a. **
145e0 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 6f 6e read-transaction
145f0 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 , this function
14600 69 73 20 63 61 6c 6c 65 64 20 77 69 74 68 20 65 is called with e
14610 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 State==PAGER_REA
14620 44 45 52 20 0a 20 20 2a 2a 20 20 20 20 20 20 61 DER . ** a
14630 6e 64 20 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 nd eLock==EXCLUS
14640 49 56 45 5f 4c 4f 43 4b 20 77 68 65 6e 20 74 68 IVE_LOCK when th
14650 65 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74 69 e read-transacti
14660 6f 6e 20 69 73 20 63 6c 6f 73 65 64 2e 0a 20 20 on is closed..
14670 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 */. assert( ass
14680 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
14690 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 pPager) );. ass
146a0 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
146b0 61 74 65 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 ate!=PAGER_ERROR
146c0 20 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 );. if( pPager
146d0 2d 3e 65 53 74 61 74 65 3c 50 41 47 45 52 5f 57 ->eState<PAGER_W
146e0 52 49 54 45 52 5f 4c 4f 43 4b 45 44 20 26 26 20 RITER_LOCKED &&
146f0 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3c 52 45 pPager->eLock<RE
14700 53 45 52 56 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 SERVED_LOCK ){.
14710 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
14720 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 72 65 6c 65 _OK;. }.. rele
14730 61 73 65 41 6c 6c 53 61 76 65 70 6f 69 6e 74 73 aseAllSavepoints
14740 28 70 50 61 67 65 72 29 3b 0a 20 20 61 73 73 65 (pPager);. asse
14750 72 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 rt( isOpen(pPage
14760 72 2d 3e 6a 66 64 29 20 7c 7c 20 70 50 61 67 65 r->jfd) || pPage
14770 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 r->pInJournal==0
14780 20 0a 20 20 20 20 20 20 7c 7c 20 28 73 71 6c 69 . || (sqli
14790 74 65 33 4f 73 44 65 76 69 63 65 43 68 61 72 61 te3OsDeviceChara
147a0 63 74 65 72 69 73 74 69 63 73 28 70 50 61 67 65 cteristics(pPage
147b0 72 2d 3e 66 64 29 26 53 51 4c 49 54 45 5f 49 4f r->fd)&SQLITE_IO
147c0 43 41 50 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43 CAP_BATCH_ATOMIC
147d0 29 0a 20 20 29 3b 0a 20 20 69 66 28 20 69 73 4f ). );. if( isO
147e0 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 pen(pPager->jfd)
147f0 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 ){. assert(
14800 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
14810 67 65 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 ger) );.. /*
14820 46 69 6e 61 6c 69 7a 65 20 74 68 65 20 6a 6f 75 Finalize the jou
14830 72 6e 61 6c 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 rnal file. */.
14840 20 20 69 66 28 20 73 71 6c 69 74 65 33 4a 6f 75 if( sqlite3Jou
14850 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 28 70 rnalIsInMemory(p
14860 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 Pager->jfd) ){.
14870 20 20 20 20 20 2f 2a 20 61 73 73 65 72 74 28 20 /* assert(
14880 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
14890 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
148a0 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 3b ALMODE_MEMORY );
148b0 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
148c0 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 2d 3OsClose(pPager-
148d0 3e 6a 66 64 29 3b 0a 20 20 20 20 7d 65 6c 73 65 >jfd);. }else
148e0 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 if( pPager->jou
148f0 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f rnalMode==PAGER_
14900 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 55 4e JOURNALMODE_TRUN
14910 43 41 54 45 20 29 7b 0a 20 20 20 20 20 20 69 66 CATE ){. if
14920 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ( pPager->journa
14930 6c 4f 66 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 lOff==0 ){.
14940 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
14950 4b 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a K;. }else{.
14960 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
14970 69 74 65 33 4f 73 54 72 75 6e 63 61 74 65 28 70 ite3OsTruncate(p
14980 50 61 67 65 72 2d 3e 6a 66 64 2c 20 30 29 3b 0a Pager->jfd, 0);.
14990 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d if( rc==
149a0 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 SQLITE_OK && pPa
149b0 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 29 7b ger->fullSync ){
149c0 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 . /* Ma
149d0 6b 65 20 73 75 72 65 20 74 68 65 20 6e 65 77 20 ke sure the new
149e0 66 69 6c 65 20 73 69 7a 65 20 69 73 20 77 72 69 file size is wri
149f0 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 69 6e tten into the in
14a00 6f 64 65 20 72 69 67 68 74 20 61 77 61 79 2e 0a ode right away..
14a10 20 20 20 20 20 20 20 20 20 20 2a 2a 20 4f 74 68 ** Oth
14a20 65 72 77 69 73 65 20 74 68 65 20 6a 6f 75 72 6e erwise the journ
14a30 61 6c 20 6d 69 67 68 74 20 72 65 73 75 72 72 65 al might resurre
14a40 63 74 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 70 ct following a p
14a50 6f 77 65 72 20 6c 6f 73 73 20 61 6e 64 0a 20 20 ower loss and.
14a60 20 20 20 20 20 20 20 20 2a 2a 20 63 61 75 73 65 ** cause
14a70 20 74 68 65 20 6c 61 73 74 20 74 72 61 6e 73 61 the last transa
14a80 63 74 69 6f 6e 20 74 6f 20 72 6f 6c 6c 20 62 61 ction to roll ba
14a90 63 6b 2e 20 20 53 65 65 0a 20 20 20 20 20 20 20 ck. See.
14aa0 20 20 20 2a 2a 20 68 74 74 70 73 3a 2f 2f 62 75 ** https://bu
14ab0 67 7a 69 6c 6c 61 2e 6d 6f 7a 69 6c 6c 61 2e 6f gzilla.mozilla.o
14ac0 72 67 2f 73 68 6f 77 5f 62 75 67 2e 63 67 69 3f rg/show_bug.cgi?
14ad0 69 64 3d 31 30 37 32 37 37 33 0a 20 20 20 20 20 id=1072773.
14ae0 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
14af0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
14b00 53 79 6e 63 28 70 50 61 67 65 72 2d 3e 6a 66 64 Sync(pPager->jfd
14b10 2c 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c , pPager->syncFl
14b20 61 67 73 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a ags);. }.
14b30 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 50 }. pP
14b40 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
14b50 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 = 0;. }else
14b60 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 if( pPager->jour
14b70 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a nalMode==PAGER_J
14b80 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 49 OURNALMODE_PERSI
14b90 53 54 0a 20 20 20 20 20 20 7c 7c 20 28 70 50 61 ST. || (pPa
14ba0 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
14bb0 64 65 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f de && pPager->jo
14bc0 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 urnalMode!=PAGER
14bd0 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c _JOURNALMODE_WAL
14be0 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 72 ). ){. r
14bf0 63 20 3d 20 7a 65 72 6f 4a 6f 75 72 6e 61 6c 48 c = zeroJournalH
14c00 64 72 28 70 50 61 67 65 72 2c 20 68 61 73 4d 61 dr(pPager, hasMa
14c10 73 74 65 72 7c 7c 70 50 61 67 65 72 2d 3e 74 65 ster||pPager->te
14c20 6d 70 46 69 6c 65 29 3b 0a 20 20 20 20 20 20 70 mpFile);. p
14c30 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 Pager->journalOf
14c40 66 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 f = 0;. }else
14c50 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 {. /* This
14c60 62 72 61 6e 63 68 20 6d 61 79 20 62 65 20 65 78 branch may be ex
14c70 65 63 75 74 65 64 20 77 69 74 68 20 50 61 67 65 ecuted with Page
14c80 72 2e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 3d 3d 4d r.journalMode==M
14c90 45 4d 4f 52 59 20 69 66 0a 20 20 20 20 20 20 2a EMORY if. *
14ca0 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 * a hot-journal
14cb0 77 61 73 20 6a 75 73 74 20 72 6f 6c 6c 65 64 20 was just rolled
14cc0 62 61 63 6b 2e 20 49 6e 20 74 68 69 73 20 63 61 back. In this ca
14cd0 73 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 se the journal.
14ce0 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 73 68 6f ** file sho
14cf0 75 6c 64 20 62 65 20 63 6c 6f 73 65 64 20 61 6e uld be closed an
14d00 64 20 64 65 6c 65 74 65 64 2e 20 49 66 20 74 68 d deleted. If th
14d10 69 73 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 77 72 is connection wr
14d20 69 74 65 73 20 74 6f 0a 20 20 20 20 20 20 2a 2a ites to. **
14d30 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
14d40 6c 65 2c 20 69 74 20 77 69 6c 6c 20 64 6f 20 73 le, it will do s
14d50 6f 20 75 73 69 6e 67 20 61 6e 20 69 6e 2d 6d 65 o using an in-me
14d60 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 2e 0a 20 20 mory journal..
14d70 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 */. int
14d80 20 62 44 65 6c 65 74 65 20 3d 20 21 70 50 61 67 bDelete = !pPag
14d90 65 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 20 20 er->tempFile;.
14da0 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 assert( sqli
14db0 74 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d 65 te3JournalIsInMe
14dc0 6d 6f 72 79 28 70 50 61 67 65 72 2d 3e 6a 66 64 mory(pPager->jfd
14dd0 29 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 61 73 )==0 );. as
14de0 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f sert( pPager->jo
14df0 75 72 6e 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 urnalMode==PAGER
14e00 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 44 45 4c _JOURNALMODE_DEL
14e10 45 54 45 20 0a 20 20 20 20 20 20 20 20 20 20 20 ETE .
14e20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e || pPager->journ
14e30 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
14e40 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
14e50 20 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 . ||
14e60 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d pPager->journalM
14e70 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e ode==PAGER_JOURN
14e80 41 4c 4d 4f 44 45 5f 57 41 4c 20 0a 20 20 20 20 ALMODE_WAL .
14e90 20 20 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 );. sqlit
14ea0 65 33 4f 73 43 6c 6f 73 65 28 70 50 61 67 65 72 e3OsClose(pPager
14eb0 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 20 20 69 66 ->jfd);. if
14ec0 28 20 62 44 65 6c 65 74 65 20 29 7b 0a 20 20 20 ( bDelete ){.
14ed0 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
14ee0 33 4f 73 44 65 6c 65 74 65 28 70 50 61 67 65 72 3OsDelete(pPager
14ef0 2d 3e 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e ->pVfs, pPager->
14f00 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 67 65 72 zJournal, pPager
14f10 2d 3e 65 78 74 72 61 53 79 6e 63 29 3b 0a 20 20 ->extraSync);.
14f20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
14f30 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43 .#ifdef SQLITE_C
14f40 48 45 43 4b 5f 50 41 47 45 53 0a 20 20 73 71 6c HECK_PAGES. sql
14f50 69 74 65 33 50 63 61 63 68 65 49 74 65 72 61 74 ite3PcacheIterat
14f60 65 44 69 72 74 79 28 70 50 61 67 65 72 2d 3e 70 eDirty(pPager->p
14f70 50 43 61 63 68 65 2c 20 70 61 67 65 72 5f 73 65 PCache, pager_se
14f80 74 5f 70 61 67 65 68 61 73 68 29 3b 0a 20 20 69 t_pagehash);. i
14f90 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a f( pPager->dbSiz
14fa0 65 3d 3d 30 20 26 26 20 73 71 6c 69 74 65 33 50 e==0 && sqlite3P
14fb0 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28 70 50 cacheRefCount(pP
14fc0 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3e 30 ager->pPCache)>0
14fd0 20 29 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 ){. PgHdr *p
14fe0 20 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c = sqlite3PagerL
14ff0 6f 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 31 29 ookup(pPager, 1)
15000 3b 0a 20 20 20 20 69 66 28 20 70 20 29 7b 0a 20 ;. if( p ){.
15010 20 20 20 20 20 70 2d 3e 70 61 67 65 48 61 73 68 p->pageHash
15020 20 3d 20 30 3b 0a 20 20 20 20 20 20 73 71 6c 69 = 0;. sqli
15030 74 65 33 50 61 67 65 72 55 6e 72 65 66 4e 6f 74 te3PagerUnrefNot
15040 4e 75 6c 6c 28 70 29 3b 0a 20 20 20 20 7d 0a 20 Null(p);. }.
15050 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 73 71 6c }.#endif.. sql
15060 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f ite3BitvecDestro
15070 79 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 y(pPager->pInJou
15080 72 6e 61 6c 29 3b 0a 20 20 70 50 61 67 65 72 2d rnal);. pPager-
15090 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b >pInJournal = 0;
150a0 0a 20 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 20 . pPager->nRec
150b0 3d 20 30 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 = 0;. if( rc==S
150c0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
150d0 69 66 28 20 4d 45 4d 44 42 20 7c 7c 20 70 61 67 if( MEMDB || pag
150e0 65 72 46 6c 75 73 68 4f 6e 43 6f 6d 6d 69 74 28 erFlushOnCommit(
150f0 70 50 61 67 65 72 2c 20 62 43 6f 6d 6d 69 74 29 pPager, bCommit)
15100 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
15110 33 50 63 61 63 68 65 43 6c 65 61 6e 41 6c 6c 28 3PcacheCleanAll(
15120 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 pPager->pPCache)
15130 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
15140 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 sqlite3Pcache
15150 43 6c 65 61 72 57 72 69 74 61 62 6c 65 28 70 50 ClearWritable(pP
15160 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a ager->pPCache);.
15170 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
15180 33 50 63 61 63 68 65 54 72 75 6e 63 61 74 65 28 3PcacheTruncate(
15190 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c pPager->pPCache,
151a0 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 pPager->dbSize)
151b0 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 70 61 67 ;. }.. if( pag
151c0 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
151d0 20 29 7b 0a 20 20 20 20 2f 2a 20 44 72 6f 70 20 ){. /* Drop
151e0 74 68 65 20 57 41 4c 20 77 72 69 74 65 2d 6c 6f the WAL write-lo
151f0 63 6b 2c 20 69 66 20 61 6e 79 2e 20 41 6c 73 6f ck, if any. Also
15200 2c 20 69 66 20 74 68 65 20 63 6f 6e 6e 65 63 74 , if the connect
15210 69 6f 6e 20 77 61 73 20 69 6e 20 0a 20 20 20 20 ion was in .
15220 2a 2a 20 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d ** locking_mode=
15230 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 65 20 62 exclusive mode b
15240 75 74 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 2c ut is no longer,
15250 20 64 72 6f 70 20 74 68 65 20 45 58 43 4c 55 53 drop the EXCLUS
15260 49 56 45 20 0a 20 20 20 20 2a 2a 20 6c 6f 63 6b IVE . ** lock
15270 20 68 65 6c 64 20 6f 6e 20 74 68 65 20 64 61 74 held on the dat
15280 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 abase file..
15290 2a 2f 0a 20 20 20 20 72 63 32 20 3d 20 73 71 6c */. rc2 = sql
152a0 69 74 65 33 57 61 6c 45 6e 64 57 72 69 74 65 54 ite3WalEndWriteT
152b0 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 67 65 ransaction(pPage
152c0 72 2d 3e 70 57 61 6c 29 3b 0a 20 20 20 20 61 73 r->pWal);. as
152d0 73 65 72 74 28 20 72 63 32 3d 3d 53 51 4c 49 54 sert( rc2==SQLIT
152e0 45 5f 4f 4b 20 29 3b 0a 20 20 7d 65 6c 73 65 20 E_OK );. }else
152f0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
15300 4b 20 26 26 20 62 43 6f 6d 6d 69 74 20 26 26 20 K && bCommit &&
15310 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 pPager->dbFileSi
15320 7a 65 3e 70 50 61 67 65 72 2d 3e 64 62 53 69 7a ze>pPager->dbSiz
15330 65 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 69 73 e ){. /* This
15340 20 62 72 61 6e 63 68 20 69 73 20 74 61 6b 65 6e branch is taken
15350 20 77 68 65 6e 20 63 6f 6d 6d 69 74 74 69 6e 67 when committing
15360 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 a transaction i
15370 6e 20 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e n rollback-journ
15380 61 6c 0a 20 20 20 20 2a 2a 20 6d 6f 64 65 20 69 al. ** mode i
15390 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
153a0 69 6c 65 20 6f 6e 20 64 69 73 6b 20 69 73 20 6c ile on disk is l
153b0 61 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 64 arger than the d
153c0 61 74 61 62 61 73 65 20 69 6d 61 67 65 2e 0a 20 atabase image..
153d0 20 20 20 2a 2a 20 41 74 20 74 68 69 73 20 70 6f ** At this po
153e0 69 6e 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 int the journal
153f0 68 61 73 20 62 65 65 6e 20 66 69 6e 61 6c 69 7a has been finaliz
15400 65 64 20 61 6e 64 20 74 68 65 20 74 72 61 6e 73 ed and the trans
15410 61 63 74 69 6f 6e 20 0a 20 20 20 20 2a 2a 20 73 action . ** s
15420 75 63 63 65 73 73 66 75 6c 6c 79 20 63 6f 6d 6d uccessfully comm
15430 69 74 74 65 64 2c 20 62 75 74 20 74 68 65 20 45 itted, but the E
15440 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 69 73 XCLUSIVE lock is
15450 20 73 74 69 6c 6c 20 68 65 6c 64 20 6f 6e 20 74 still held on t
15460 68 65 0a 20 20 20 20 2a 2a 20 66 69 6c 65 2e 20 he. ** file.
15470 53 6f 20 69 74 20 69 73 20 73 61 66 65 20 74 6f So it is safe to
15480 20 74 72 75 6e 63 61 74 65 20 74 68 65 20 64 61 truncate the da
15490 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 69 tabase file to i
154a0 74 73 20 6d 69 6e 69 6d 75 6d 0a 20 20 20 20 2a ts minimum. *
154b0 2a 20 72 65 71 75 69 72 65 64 20 73 69 7a 65 2e * required size.
154c0 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 */. assert(
154d0 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
154e0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 EXCLUSIVE_LOCK )
154f0 3b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 ;. rc = pager
15500 5f 74 72 75 6e 63 61 74 65 28 70 50 61 67 65 72 _truncate(pPager
15510 2c 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 , pPager->dbSize
15520 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 );. }.. if( rc
15530 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 62 ==SQLITE_OK && b
15540 43 6f 6d 6d 69 74 20 26 26 20 69 73 4f 70 65 6e Commit && isOpen
15550 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 7b 0a (pPager->fd) ){.
15560 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
15570 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 70 50 OsFileControl(pP
15580 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 ager->fd, SQLITE
15590 5f 46 43 4e 54 4c 5f 43 4f 4d 4d 49 54 5f 50 48 _FCNTL_COMMIT_PH
155a0 41 53 45 54 57 4f 2c 20 30 29 3b 0a 20 20 20 20 ASETWO, 0);.
155b0 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e if( rc==SQLITE_N
155c0 4f 54 46 4f 55 4e 44 20 29 20 72 63 20 3d 20 53 OTFOUND ) rc = S
155d0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 QLITE_OK;. }..
155e0 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 if( !pPager->ex
155f0 63 6c 75 73 69 76 65 4d 6f 64 65 20 0a 20 20 20 clusiveMode .
15600 26 26 20 28 21 70 61 67 65 72 55 73 65 57 61 6c && (!pagerUseWal
15610 28 70 50 61 67 65 72 29 20 7c 7c 20 73 71 6c 69 (pPager) || sqli
15620 74 65 33 57 61 6c 45 78 63 6c 75 73 69 76 65 4d te3WalExclusiveM
15630 6f 64 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c ode(pPager->pWal
15640 2c 20 30 29 29 0a 20 20 29 7b 0a 20 20 20 20 72 , 0)). ){. r
15650 63 32 20 3d 20 70 61 67 65 72 55 6e 6c 6f 63 6b c2 = pagerUnlock
15660 44 62 28 70 50 61 67 65 72 2c 20 53 48 41 52 45 Db(pPager, SHARE
15670 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 70 50 61 D_LOCK);. pPa
15680 67 65 72 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 ger->changeCount
15690 44 6f 6e 65 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 Done = 0;. }.
156a0 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d pPager->eState =
156b0 20 50 41 47 45 52 5f 52 45 41 44 45 52 3b 0a 20 PAGER_READER;.
156c0 20 70 50 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 pPager->setMast
156d0 65 72 20 3d 20 30 3b 0a 0a 20 20 72 65 74 75 72 er = 0;.. retur
156e0 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b n (rc==SQLITE_OK
156f0 3f 72 63 32 3a 72 63 29 3b 0a 7d 0a 0a 2f 2a 0a ?rc2:rc);.}../*.
15700 2a 2a 20 45 78 65 63 75 74 65 20 61 20 72 6f 6c ** Execute a rol
15710 6c 62 61 63 6b 20 69 66 20 61 20 74 72 61 6e 73 lback if a trans
15720 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 action is active
15730 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 and unlock the
15740 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c .** database fil
15750 65 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 e. .**.** If the
15760 20 70 61 67 65 72 20 68 61 73 20 61 6c 72 65 61 pager has alrea
15770 64 79 20 65 6e 74 65 72 65 64 20 74 68 65 20 45 dy entered the E
15780 52 52 4f 52 20 73 74 61 74 65 2c 20 64 6f 20 6e RROR state, do n
15790 6f 74 20 61 74 74 65 6d 70 74 20 0a 2a 2a 20 74 ot attempt .** t
157a0 68 65 20 72 6f 6c 6c 62 61 63 6b 20 61 74 20 74 he rollback at t
157b0 68 69 73 20 74 69 6d 65 2e 20 49 6e 73 74 65 61 his time. Instea
157c0 64 2c 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 d, pager_unlock(
157d0 29 20 69 73 20 63 61 6c 6c 65 64 2e 20 54 68 65 ) is called. The
157e0 0a 2a 2a 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 .** call to page
157f0 72 5f 75 6e 6c 6f 63 6b 28 29 20 77 69 6c 6c 20 r_unlock() will
15800 64 69 73 63 61 72 64 20 61 6c 6c 20 69 6e 2d 6d discard all in-m
15810 65 6d 6f 72 79 20 70 61 67 65 73 2c 20 75 6e 6c emory pages, unl
15820 6f 63 6b 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 ock.** the datab
15830 61 73 65 20 66 69 6c 65 20 61 6e 64 20 6d 6f 76 ase file and mov
15840 65 20 74 68 65 20 70 61 67 65 72 20 62 61 63 6b e the pager back
15850 20 74 6f 20 4f 50 45 4e 20 73 74 61 74 65 2e 20 to OPEN state.
15860 49 66 20 74 68 69 73 20 0a 2a 2a 20 6d 65 61 6e If this .** mean
15870 73 20 74 68 61 74 20 74 68 65 72 65 20 69 73 20 s that there is
15880 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 6c 65 a hot-journal le
15890 66 74 20 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 ft in the file-s
158a0 79 73 74 65 6d 2c 20 74 68 65 20 6e 65 78 74 20 ystem, the next
158b0 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 .** connection t
158c0 6f 20 6f 62 74 61 69 6e 20 61 20 73 68 61 72 65 o obtain a share
158d0 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 70 61 d lock on the pa
158e0 67 65 72 20 28 77 68 69 63 68 20 6d 61 79 20 62 ger (which may b
158f0 65 20 74 68 69 73 20 6f 6e 65 29 20 0a 2a 2a 20 e this one) .**
15900 77 69 6c 6c 20 72 6f 6c 6c 20 69 74 20 62 61 63 will roll it bac
15910 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 k..**.** If the
15920 70 61 67 65 72 20 68 61 73 20 6e 6f 74 20 61 6c pager has not al
15930 72 65 61 64 79 20 65 6e 74 65 72 65 64 20 74 68 ready entered th
15940 65 20 45 52 52 4f 52 20 73 74 61 74 65 2c 20 62 e ERROR state, b
15950 75 74 20 61 6e 20 49 4f 20 6f 72 0a 2a 2a 20 6d ut an IO or.** m
15960 61 6c 6c 6f 63 20 65 72 72 6f 72 20 6f 63 63 75 alloc error occu
15970 72 73 20 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c rs during a roll
15980 62 61 63 6b 2c 20 74 68 65 6e 20 74 68 69 73 20 back, then this
15990 77 69 6c 6c 20 69 74 73 65 6c 66 20 63 61 75 73 will itself caus
159a0 65 20 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 20 e .** the pager
159b0 74 6f 20 65 6e 74 65 72 20 74 68 65 20 45 52 52 to enter the ERR
159c0 4f 52 20 73 74 61 74 65 2e 20 57 68 69 63 68 20 OR state. Which
159d0 77 69 6c 6c 20 62 65 20 63 6c 65 61 72 65 64 20 will be cleared
159e0 62 79 20 74 68 65 0a 2a 2a 20 63 61 6c 6c 20 74 by the.** call t
159f0 6f 20 70 61 67 65 72 5f 75 6e 6c 6f 63 6b 28 29 o pager_unlock()
15a00 2c 20 61 73 20 64 65 73 63 72 69 62 65 64 20 61 , as described a
15a10 62 6f 76 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 bove..*/.static
15a20 76 6f 69 64 20 70 61 67 65 72 55 6e 6c 6f 63 6b void pagerUnlock
15a30 41 6e 64 52 6f 6c 6c 62 61 63 6b 28 50 61 67 65 AndRollback(Page
15a40 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 66 r *pPager){. if
15a50 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
15a60 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 26 26 !=PAGER_ERROR &&
15a70 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 21 pPager->eState!
15a80 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 7b 0a 20 =PAGER_OPEN ){.
15a90 20 20 20 61 73 73 65 72 74 28 20 61 73 73 65 72 assert( asser
15aa0 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 t_pager_state(pP
15ab0 61 67 65 72 29 20 29 3b 0a 20 20 20 20 69 66 28 ager) );. if(
15ac0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e pPager->eState>
15ad0 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f =PAGER_WRITER_LO
15ae0 43 4b 45 44 20 29 7b 0a 20 20 20 20 20 20 73 71 CKED ){. sq
15af0 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
15b00 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 Malloc();.
15b10 73 71 6c 69 74 65 33 50 61 67 65 72 52 6f 6c 6c sqlite3PagerRoll
15b20 62 61 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 20 back(pPager);.
15b30 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 sqlite3EndBe
15b40 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 nignMalloc();.
15b50 20 20 7d 65 6c 73 65 20 69 66 28 20 21 70 50 61 }else if( !pPa
15b60 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 65 4d 6f ger->exclusiveMo
15b70 64 65 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 de ){. asse
15b80 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
15b90 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 te==PAGER_READER
15ba0 20 29 3b 0a 20 20 20 20 20 20 70 61 67 65 72 5f );. pager_
15bb0 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f 6e 28 end_transaction(
15bc0 70 50 61 67 65 72 2c 20 30 2c 20 30 29 3b 0a 20 pPager, 0, 0);.
15bd0 20 20 20 7d 0a 20 20 7d 0a 20 20 70 61 67 65 72 }. }. pager
15be0 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 3b _unlock(pPager);
15bf0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 61 72 61 6d 65 .}../*.** Parame
15c00 74 65 72 20 61 44 61 74 61 20 6d 75 73 74 20 70 ter aData must p
15c10 6f 69 6e 74 20 74 6f 20 61 20 62 75 66 66 65 72 oint to a buffer
15c20 20 6f 66 20 70 50 61 67 65 72 2d 3e 70 61 67 65 of pPager->page
15c30 53 69 7a 65 20 62 79 74 65 73 0a 2a 2a 20 6f 66 Size bytes.** of
15c40 20 64 61 74 61 2e 20 43 6f 6d 70 75 74 65 20 61 data. Compute a
15c50 6e 64 20 72 65 74 75 72 6e 20 61 20 63 68 65 63 nd return a chec
15c60 6b 73 75 6d 20 62 61 73 65 64 20 6f 6e 74 20 74 ksum based ont t
15c70 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 he contents of t
15c80 68 65 20 0a 2a 2a 20 70 61 67 65 20 6f 66 20 64 he .** page of d
15c90 61 74 61 20 61 6e 64 20 74 68 65 20 63 75 72 72 ata and the curr
15ca0 65 6e 74 20 76 61 6c 75 65 20 6f 66 20 70 50 61 ent value of pPa
15cb0 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 2e 0a ger->cksumInit..
15cc0 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 6e 6f **.** This is no
15cd0 74 20 61 20 72 65 61 6c 20 63 68 65 63 6b 73 75 t a real checksu
15ce0 6d 2e 20 49 74 20 69 73 20 72 65 61 6c 6c 79 20 m. It is really
15cf0 6a 75 73 74 20 74 68 65 20 73 75 6d 20 6f 66 20 just the sum of
15d00 74 68 65 20 0a 2a 2a 20 72 61 6e 64 6f 6d 20 69 the .** random i
15d10 6e 69 74 69 61 6c 20 76 61 6c 75 65 20 28 70 50 nitial value (pP
15d20 61 67 65 72 2d 3e 63 6b 73 75 6d 49 6e 69 74 29 ager->cksumInit)
15d30 20 61 6e 64 20 65 76 65 72 79 20 32 30 30 74 68 and every 200th
15d40 20 62 79 74 65 0a 2a 2a 20 6f 66 20 74 68 65 20 byte.** of the
15d50 70 61 67 65 20 64 61 74 61 2c 20 73 74 61 72 74 page data, start
15d60 69 6e 67 20 77 69 74 68 20 62 79 74 65 20 6f 66 ing with byte of
15d70 66 73 65 74 20 28 70 50 61 67 65 72 2d 3e 70 61 fset (pPager->pa
15d80 67 65 53 69 7a 65 25 32 30 30 29 2e 0a 2a 2a 20 geSize%200)..**
15d90 45 61 63 68 20 62 79 74 65 20 69 73 20 69 6e 74 Each byte is int
15da0 65 72 70 72 65 74 65 64 20 61 73 20 61 6e 20 38 erpreted as an 8
15db0 2d 62 69 74 20 75 6e 73 69 67 6e 65 64 20 69 6e -bit unsigned in
15dc0 74 65 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 teger..**.** Cha
15dd0 6e 67 69 6e 67 20 74 68 65 20 66 6f 72 6d 75 6c nging the formul
15de0 61 20 75 73 65 64 20 74 6f 20 63 6f 6d 70 75 74 a used to comput
15df0 65 20 74 68 69 73 20 63 68 65 63 6b 73 75 6d 20 e this checksum
15e00 72 65 73 75 6c 74 73 20 69 6e 20 61 6e 0a 2a 2a results in an.**
15e10 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 6a 6f incompatible jo
15e20 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 6d 61 urnal file forma
15e30 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6a 6f 75 72 t..**.** If jour
15e40 6e 61 6c 20 63 6f 72 72 75 70 74 69 6f 6e 20 6f nal corruption o
15e50 63 63 75 72 73 20 64 75 65 20 74 6f 20 61 20 70 ccurs due to a p
15e60 6f 77 65 72 20 66 61 69 6c 75 72 65 2c 20 74 68 ower failure, th
15e70 65 20 6d 6f 73 74 20 6c 69 6b 65 6c 79 20 0a 2a e most likely .*
15e80 2a 20 73 63 65 6e 61 72 69 6f 20 69 73 20 74 68 * scenario is th
15e90 61 74 20 6f 6e 65 20 65 6e 64 20 6f 72 20 74 68 at one end or th
15ea0 65 20 6f 74 68 65 72 20 6f 66 20 74 68 65 20 72 e other of the r
15eb0 65 63 6f 72 64 20 77 69 6c 6c 20 62 65 20 63 68 ecord will be ch
15ec0 61 6e 67 65 64 2e 20 0a 2a 2a 20 49 74 20 69 73 anged. .** It is
15ed0 20 6d 75 63 68 20 6c 65 73 73 20 6c 69 6b 65 6c much less likel
15ee0 79 20 74 68 61 74 20 74 68 65 20 74 77 6f 20 65 y that the two e
15ef0 6e 64 73 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e nds of the journ
15f00 61 6c 20 72 65 63 6f 72 64 20 77 69 6c 6c 20 62 al record will b
15f10 65 0a 2a 2a 20 63 6f 72 72 65 63 74 20 61 6e 64 e.** correct and
15f20 20 74 68 65 20 6d 69 64 64 6c 65 20 62 65 20 63 the middle be c
15f30 6f 72 72 75 70 74 2e 20 20 54 68 75 73 2c 20 74 orrupt. Thus, t
15f40 68 69 73 20 22 63 68 65 63 6b 73 75 6d 22 20 73 his "checksum" s
15f50 63 68 65 6d 65 2c 0a 2a 2a 20 74 68 6f 75 67 68 cheme,.** though
15f60 20 66 61 73 74 20 61 6e 64 20 73 69 6d 70 6c 65 fast and simple
15f70 2c 20 63 61 74 63 68 65 73 20 74 68 65 20 6d 6f , catches the mo
15f80 73 74 6c 79 20 6c 69 6b 65 6c 79 20 6b 69 6e 64 stly likely kind
15f90 20 6f 66 20 63 6f 72 72 75 70 74 69 6f 6e 2e 0a of corruption..
15fa0 2a 2f 0a 73 74 61 74 69 63 20 75 33 32 20 70 61 */.static u32 pa
15fb0 67 65 72 5f 63 6b 73 75 6d 28 50 61 67 65 72 20 ger_cksum(Pager
15fc0 2a 70 50 61 67 65 72 2c 20 63 6f 6e 73 74 20 75 *pPager, const u
15fd0 38 20 2a 61 44 61 74 61 29 7b 0a 20 20 75 33 32 8 *aData){. u32
15fe0 20 63 6b 73 75 6d 20 3d 20 70 50 61 67 65 72 2d cksum = pPager-
15ff0 3e 63 6b 73 75 6d 49 6e 69 74 3b 20 20 20 20 20 >cksumInit;
16000 20 20 20 20 2f 2a 20 43 68 65 63 6b 73 75 6d 20 /* Checksum
16010 76 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 value to return
16020 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20 70 50 61 */. int i = pPa
16030 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2d 32 30 ger->pageSize-20
16040 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 0; /* L
16050 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 oop counter */.
16060 20 77 68 69 6c 65 28 20 69 3e 30 20 29 7b 0a 20 while( i>0 ){.
16070 20 20 20 63 6b 73 75 6d 20 2b 3d 20 61 44 61 74 cksum += aDat
16080 61 5b 69 5d 3b 0a 20 20 20 20 69 20 2d 3d 20 32 a[i];. i -= 2
16090 30 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 00;. }. return
160a0 20 63 6b 73 75 6d 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a cksum;.}../*.**
160b0 20 52 65 70 6f 72 74 20 74 68 65 20 63 75 72 72 Report the curr
160c0 65 6e 74 20 70 61 67 65 20 73 69 7a 65 20 61 6e ent page size an
160d0 64 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 d number of rese
160e0 72 76 65 64 20 62 79 74 65 73 20 62 61 63 6b 0a rved bytes back.
160f0 2a 2a 20 74 6f 20 74 68 65 20 63 6f 64 65 63 2e ** to the codec.
16100 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
16110 45 5f 48 41 53 5f 43 4f 44 45 43 0a 73 74 61 74 E_HAS_CODEC.stat
16120 69 63 20 76 6f 69 64 20 70 61 67 65 72 52 65 70 ic void pagerRep
16130 6f 72 74 53 69 7a 65 28 50 61 67 65 72 20 2a 70 ortSize(Pager *p
16140 50 61 67 65 72 29 7b 0a 20 20 69 66 28 20 70 50 Pager){. if( pP
16150 61 67 65 72 2d 3e 78 43 6f 64 65 63 53 69 7a 65 ager->xCodecSize
16160 43 68 6e 67 20 29 7b 0a 20 20 20 20 70 50 61 67 Chng ){. pPag
16170 65 72 2d 3e 78 43 6f 64 65 63 53 69 7a 65 43 68 er->xCodecSizeCh
16180 6e 67 28 70 50 61 67 65 72 2d 3e 70 43 6f 64 65 ng(pPager->pCode
16190 63 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 c, pPager->pageS
161a0 69 7a 65 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ize,.
161b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
161c0 28 69 6e 74 29 70 50 61 67 65 72 2d 3e 6e 52 65 (int)pPager->nRe
161d0 73 65 72 76 65 29 3b 0a 20 20 7d 0a 7d 0a 23 65 serve);. }.}.#e
161e0 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 70 61 67 lse.# define pag
161f0 65 72 52 65 70 6f 72 74 53 69 7a 65 28 58 29 20 erReportSize(X)
16200 20 20 20 20 2f 2a 20 4e 6f 2d 6f 70 20 69 66 20 /* No-op if
16210 77 65 20 64 6f 20 6e 6f 74 20 73 75 70 70 6f 72 we do not suppor
16220 74 20 61 20 63 6f 64 65 63 20 2a 2f 0a 23 65 6e t a codec */.#en
16230 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
16240 54 45 5f 48 41 53 5f 43 4f 44 45 43 0a 2f 2a 0a TE_HAS_CODEC./*.
16250 2a 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 65 ** Make sure the
16260 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 65 72 number of reser
16270 76 65 64 20 62 69 74 73 20 69 73 20 74 68 65 20 ved bits is the
16280 73 61 6d 65 20 69 6e 20 74 68 65 20 64 65 73 74 same in the dest
16290 69 6e 61 74 69 6f 6e 0a 2a 2a 20 70 61 67 65 72 ination.** pager
162a0 20 61 73 20 69 74 20 69 73 20 69 6e 20 74 68 65 as it is in the
162b0 20 73 6f 75 72 63 65 2e 20 20 54 68 69 73 20 63 source. This c
162c0 6f 6d 65 73 20 75 70 20 77 68 65 6e 20 61 20 56 omes up when a V
162d0 41 43 55 55 4d 20 63 68 61 6e 67 65 73 20 74 68 ACUUM changes th
162e0 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 72 e.** number of r
162f0 65 73 65 72 76 65 64 20 62 69 74 73 20 74 6f 20 eserved bits to
16300 74 68 65 20 22 6f 70 74 69 6d 61 6c 22 20 61 6d the "optimal" am
16310 6f 75 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 ount..*/.void sq
16320 6c 69 74 65 33 50 61 67 65 72 41 6c 69 67 6e 52 lite3PagerAlignR
16330 65 73 65 72 76 65 28 50 61 67 65 72 20 2a 70 44 eserve(Pager *pD
16340 65 73 74 2c 20 50 61 67 65 72 20 2a 70 53 72 63 est, Pager *pSrc
16350 29 7b 0a 20 20 69 66 28 20 70 44 65 73 74 2d 3e ){. if( pDest->
16360 6e 52 65 73 65 72 76 65 21 3d 70 53 72 63 2d 3e nReserve!=pSrc->
16370 6e 52 65 73 65 72 76 65 20 29 7b 0a 20 20 20 20 nReserve ){.
16380 70 44 65 73 74 2d 3e 6e 52 65 73 65 72 76 65 20 pDest->nReserve
16390 3d 20 70 53 72 63 2d 3e 6e 52 65 73 65 72 76 65 = pSrc->nReserve
163a0 3b 0a 20 20 20 20 70 61 67 65 72 52 65 70 6f 72 ;. pagerRepor
163b0 74 53 69 7a 65 28 70 44 65 73 74 29 3b 0a 20 20 tSize(pDest);.
163c0 7d 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a }.}.#endif../*.*
163d0 2a 20 52 65 61 64 20 61 20 73 69 6e 67 6c 65 20 * Read a single
163e0 70 61 67 65 20 66 72 6f 6d 20 65 69 74 68 65 72 page from either
163f0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
16400 65 20 28 69 66 20 69 73 4d 61 69 6e 4a 72 6e 6c e (if isMainJrnl
16410 3d 3d 31 29 20 6f 72 0a 2a 2a 20 66 72 6f 6d 20 ==1) or.** from
16420 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 the sub-journal
16430 28 69 66 20 69 73 4d 61 69 6e 4a 72 6e 6c 3d 3d (if isMainJrnl==
16440 30 29 20 61 6e 64 20 70 6c 61 79 62 61 63 6b 20 0) and playback
16450 74 68 61 74 20 70 61 67 65 2e 0a 2a 2a 20 54 68 that page..** Th
16460 65 20 70 61 67 65 20 62 65 67 69 6e 73 20 61 74 e page begins at
16470 20 6f 66 66 73 65 74 20 2a 70 4f 66 66 73 65 74 offset *pOffset
16480 20 69 6e 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 into the file.
16490 54 68 65 20 2a 70 4f 66 66 73 65 74 0a 2a 2a 20 The *pOffset.**
164a0 76 61 6c 75 65 20 69 73 20 69 6e 63 72 65 61 73 value is increas
164b0 65 64 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 ed to the start
164c0 6f 66 20 74 68 65 20 6e 65 78 74 20 70 61 67 65 of the next page
164d0 20 69 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e in the journal.
164e0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 61 69 6e 20 .**.** The main
164f0 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c rollback journal
16500 20 75 73 65 73 20 63 68 65 63 6b 73 75 6d 73 20 uses checksums
16510 2d 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 - the statement
16520 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 20 0a 2a 2a journal does .**
16530 20 6e 6f 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 not..**.** If t
16540 68 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f he page number o
16550 66 20 74 68 65 20 70 61 67 65 20 72 65 63 6f 72 f the page recor
16560 64 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 d read from the
16570 28 73 75 62 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 (sub-)journal fi
16580 6c 65 0a 2a 2a 20 69 73 20 67 72 65 61 74 65 72 le.** is greater
16590 20 74 68 61 6e 20 74 68 65 20 63 75 72 72 65 6e than the curren
165a0 74 20 76 61 6c 75 65 20 6f 66 20 50 61 67 65 72 t value of Pager
165b0 2e 64 62 53 69 7a 65 2c 20 74 68 65 6e 20 70 6c .dbSize, then pl
165c0 61 79 62 61 63 6b 20 69 73 0a 2a 2a 20 73 6b 69 ayback is.** ski
165d0 70 70 65 64 20 61 6e 64 20 53 51 4c 49 54 45 5f pped and SQLITE_
165e0 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a OK is returned..
165f0 2a 2a 0a 2a 2a 20 49 66 20 70 44 6f 6e 65 20 69 **.** If pDone i
16600 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e s not NULL, then
16610 20 69 74 20 69 73 20 61 20 72 65 63 6f 72 64 20 it is a record
16620 6f 66 20 70 61 67 65 73 20 74 68 61 74 20 68 61 of pages that ha
16630 76 65 20 61 6c 72 65 61 64 79 0a 2a 2a 20 62 65 ve already.** be
16640 65 6e 20 70 6c 61 79 65 64 20 62 61 63 6b 2e 20 en played back.
16650 20 49 66 20 74 68 65 20 70 61 67 65 20 61 74 20 If the page at
16660 2a 70 4f 66 66 73 65 74 20 68 61 73 20 61 6c 72 *pOffset has alr
16670 65 61 64 79 20 62 65 65 6e 20 70 6c 61 79 65 64 eady been played
16680 20 62 61 63 6b 0a 2a 2a 20 28 69 66 20 74 68 65 back.** (if the
16690 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 70 corresponding p
166a0 44 6f 6e 65 20 62 69 74 20 69 73 20 73 65 74 29 Done bit is set)
166b0 20 74 68 65 6e 20 73 6b 69 70 20 74 68 65 20 70 then skip the p
166c0 6c 61 79 62 61 63 6b 2e 0a 2a 2a 20 4d 61 6b 65 layback..** Make
166d0 20 73 75 72 65 20 74 68 65 20 70 44 6f 6e 65 20 sure the pDone
166e0 62 69 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e bit correspondin
166f0 67 20 74 6f 20 74 68 65 20 2a 70 4f 66 66 73 65 g to the *pOffse
16700 74 20 70 61 67 65 20 69 73 20 73 65 74 0a 2a 2a t page is set.**
16710 20 70 72 69 6f 72 20 74 6f 20 72 65 74 75 72 6e prior to return
16720 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ing..**.** If th
16730 65 20 70 61 67 65 20 72 65 63 6f 72 64 20 69 73 e page record is
16740 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 72 65 successfully re
16750 61 64 20 66 72 6f 6d 20 74 68 65 20 28 73 75 62 ad from the (sub
16760 2d 29 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 0a 2a -)journal file.*
16770 2a 20 61 6e 64 20 70 6c 61 79 65 64 20 62 61 63 * and played bac
16780 6b 2c 20 74 68 65 6e 20 53 51 4c 49 54 45 5f 4f k, then SQLITE_O
16790 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 K is returned. I
167a0 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 f an IO error oc
167b0 63 75 72 73 0a 2a 2a 20 77 68 69 6c 65 20 72 65 curs.** while re
167c0 61 64 69 6e 67 20 74 68 65 20 72 65 63 6f 72 64 ading the record
167d0 20 66 72 6f 6d 20 74 68 65 20 28 73 75 62 2d 29 from the (sub-)
167e0 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 72 20 journal file or
167f0 77 68 69 6c 65 20 77 72 69 74 69 6e 67 0a 2a 2a while writing.**
16800 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
16810 20 66 69 6c 65 2c 20 74 68 65 6e 20 74 68 65 20 file, then the
16820 49 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 IO error code is
16830 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 64 61 returned. If da
16840 74 61 0a 2a 2a 20 69 73 20 73 75 63 63 65 73 73 ta.** is success
16850 66 75 6c 6c 79 20 72 65 61 64 20 66 72 6f 6d 20 fully read from
16860 74 68 65 20 28 73 75 62 2d 29 6a 6f 75 72 6e 61 the (sub-)journa
16870 6c 20 66 69 6c 65 20 62 75 74 20 61 70 70 65 61 l file but appea
16880 72 73 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 72 72 rs to be.** corr
16890 75 70 74 65 64 2c 20 53 51 4c 49 54 45 5f 44 4f upted, SQLITE_DO
168a0 4e 45 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 NE is returned.
168b0 44 61 74 61 20 69 73 20 63 6f 6e 73 69 64 65 72 Data is consider
168c0 65 64 20 63 6f 72 72 75 70 74 65 64 20 69 6e 0a ed corrupted in.
168d0 2a 2a 20 74 77 6f 20 63 69 72 63 75 6d 73 74 61 ** two circumsta
168e0 6e 63 65 73 3a 0a 2a 2a 20 0a 2a 2a 20 20 20 2a nces:.** .** *
168f0 20 49 66 20 74 68 65 20 72 65 63 6f 72 64 20 70 If the record p
16900 61 67 65 2d 6e 75 6d 62 65 72 20 69 73 20 69 6c age-number is il
16910 6c 65 67 61 6c 20 28 30 20 6f 72 20 50 41 47 45 legal (0 or PAGE
16920 52 5f 4d 4a 5f 50 47 4e 4f 29 2c 20 6f 72 0a 2a R_MJ_PGNO), or.*
16930 2a 20 20 20 2a 20 49 66 20 74 68 65 20 72 65 63 * * If the rec
16940 6f 72 64 20 69 73 20 62 65 69 6e 67 20 72 6f 6c ord is being rol
16950 6c 65 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 led back from th
16960 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 e main journal f
16970 69 6c 65 0a 2a 2a 20 20 20 20 20 61 6e 64 20 74 ile.** and t
16980 68 65 20 63 68 65 63 6b 73 75 6d 20 66 69 65 6c he checksum fiel
16990 64 20 64 6f 65 73 20 6e 6f 74 20 6d 61 74 63 68 d does not match
169a0 20 74 68 65 20 72 65 63 6f 72 64 20 63 6f 6e 74 the record cont
169b0 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 4e 65 69 74 68 ent..**.** Neith
169c0 65 72 20 6f 66 20 74 68 65 73 65 20 74 77 6f 20 er of these two
169d0 73 63 65 6e 61 72 69 6f 73 20 61 72 65 20 70 6f scenarios are po
169e0 73 73 69 62 6c 65 20 64 75 72 69 6e 67 20 61 20 ssible during a
169f0 73 61 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 savepoint rollba
16a00 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 69 ck..**.** If thi
16a10 73 20 69 73 20 61 20 73 61 76 65 70 6f 69 6e 74 s is a savepoint
16a20 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 6e 20 rollback, then
16a30 6d 65 6d 6f 72 79 20 6d 61 79 20 68 61 76 65 20 memory may have
16a40 74 6f 20 62 65 20 64 79 6e 61 6d 69 63 61 6c 6c to be dynamicall
16a50 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 20 62 y.** allocated b
16a60 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e y this function.
16a70 20 49 66 20 74 68 69 73 20 69 73 20 74 68 65 20 If this is the
16a80 63 61 73 65 20 61 6e 64 20 61 6e 20 61 6c 6c 6f case and an allo
16a90 63 61 74 69 6f 6e 20 66 61 69 6c 73 2c 0a 2a 2a cation fails,.**
16aa0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 73 SQLITE_NOMEM is
16ab0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 returned..*/.st
16ac0 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 70 atic int pager_p
16ad0 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 layback_one_page
16ae0 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 (. Pager *pPage
16af0 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r,
16b00 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 62 /* The pager b
16b10 65 69 6e 67 20 70 6c 61 79 65 64 20 62 61 63 6b eing played back
16b20 20 2a 2f 0a 20 20 69 36 34 20 2a 70 4f 66 66 73 */. i64 *pOffs
16b30 65 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 et,
16b40 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 6f 66 /* Offset of
16b50 20 72 65 63 6f 72 64 20 74 6f 20 70 6c 61 79 62 record to playb
16b60 61 63 6b 20 2a 2f 0a 20 20 42 69 74 76 65 63 20 ack */. Bitvec
16b70 2a 70 44 6f 6e 65 2c 20 20 20 20 20 20 20 20 20 *pDone,
16b80 20 20 20 20 20 20 20 2f 2a 20 42 69 74 76 65 63 /* Bitvec
16b90 20 6f 66 20 70 61 67 65 73 20 61 6c 72 65 61 64 of pages alread
16ba0 79 20 70 6c 61 79 65 64 20 62 61 63 6b 20 2a 2f y played back */
16bb0 0a 20 20 69 6e 74 20 69 73 4d 61 69 6e 4a 72 6e . int isMainJrn
16bc0 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l,
16bd0 20 2f 2a 20 31 20 2d 3e 20 6d 61 69 6e 20 6a 6f /* 1 -> main jo
16be0 75 72 6e 61 6c 2e 20 30 20 2d 3e 20 73 75 62 2d urnal. 0 -> sub-
16bf0 6a 6f 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20 69 6e journal. */. in
16c00 74 20 69 73 53 61 76 65 70 6e 74 20 20 20 20 20 t isSavepnt
16c10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
16c20 72 75 65 20 66 6f 72 20 61 20 73 61 76 65 70 6f rue for a savepo
16c30 69 6e 74 20 72 6f 6c 6c 62 61 63 6b 20 2a 2f 0a int rollback */.
16c40 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 50 ){. int rc;. P
16c50 67 48 64 72 20 2a 70 50 67 3b 20 20 20 20 20 20 gHdr *pPg;
16c60 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
16c70 41 6e 20 65 78 69 73 74 69 6e 67 20 70 61 67 65 An existing page
16c80 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 2a 2f in the cache */
16c90 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 3b 20 20 20 . Pgno pgno;
16ca0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16cb0 20 2f 2a 20 54 68 65 20 70 61 67 65 20 6e 75 6d /* The page num
16cc0 62 65 72 20 6f 66 20 61 20 70 61 67 65 20 69 6e ber of a page in
16cd0 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 75 33 journal */. u3
16ce0 32 20 63 6b 73 75 6d 3b 20 20 20 20 20 20 20 20 2 cksum;
16cf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
16d00 68 65 63 6b 73 75 6d 20 75 73 65 64 20 66 6f 72 hecksum used for
16d10 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e 67 sanity checking
16d20 20 2a 2f 0a 20 20 63 68 61 72 20 2a 61 44 61 74 */. char *aDat
16d30 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a;
16d40 20 20 20 20 2f 2a 20 54 65 6d 70 6f 72 61 72 79 /* Temporary
16d50 20 73 74 6f 72 61 67 65 20 66 6f 72 20 74 68 65 storage for the
16d60 20 70 61 67 65 20 2a 2f 0a 20 20 73 71 6c 69 74 page */. sqlit
16d70 65 33 5f 66 69 6c 65 20 2a 6a 66 64 3b 20 20 20 e3_file *jfd;
16d80 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
16d90 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 20 file descriptor
16da0 66 6f 72 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 for the journal
16db0 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 file */. int is
16dc0 53 79 6e 63 65 64 3b 20 20 20 20 20 20 20 20 20 Synced;
16dd0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
16de0 69 66 20 6a 6f 75 72 6e 61 6c 20 70 61 67 65 20 if journal page
16df0 69 73 20 73 79 6e 63 65 64 20 2a 2f 0a 23 69 66 is synced */.#if
16e00 64 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 def SQLITE_HAS_C
16e10 4f 44 45 43 0a 20 20 2f 2a 20 54 68 65 20 6a 72 ODEC. /* The jr
16e20 6e 6c 45 6e 63 20 66 6c 61 67 20 69 73 20 74 72 nlEnc flag is tr
16e30 75 65 20 69 66 20 4a 6f 75 72 6e 61 6c 20 70 61 ue if Journal pa
16e40 67 65 73 20 73 68 6f 75 6c 64 20 62 65 20 70 61 ges should be pa
16e50 73 73 65 64 20 74 68 72 6f 75 67 68 0a 20 20 2a ssed through. *
16e60 2a 20 74 68 65 20 63 6f 64 65 63 2e 20 20 49 74 * the codec. It
16e70 20 69 73 20 66 61 6c 73 65 20 66 6f 72 20 70 75 is false for pu
16e80 72 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f 75 re in-memory jou
16e90 72 6e 61 6c 73 2e 20 2a 2f 0a 20 20 63 6f 6e 73 rnals. */. cons
16ea0 74 20 69 6e 74 20 6a 72 6e 6c 45 6e 63 20 3d 20 t int jrnlEnc =
16eb0 28 69 73 4d 61 69 6e 4a 72 6e 6c 20 7c 7c 20 70 (isMainJrnl || p
16ec0 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e 4d 65 6d Pager->subjInMem
16ed0 6f 72 79 3d 3d 30 29 3b 0a 23 65 6e 64 69 66 0a ory==0);.#endif.
16ee0 0a 20 20 61 73 73 65 72 74 28 20 28 69 73 4d 61 . assert( (isMa
16ef0 69 6e 4a 72 6e 6c 26 7e 31 29 3d 3d 30 20 29 3b inJrnl&~1)==0 );
16f00 20 20 20 20 20 20 2f 2a 20 69 73 4d 61 69 6e 4a /* isMainJ
16f10 72 6e 6c 20 69 73 20 30 20 6f 72 20 31 20 2a 2f rnl is 0 or 1 */
16f20 0a 20 20 61 73 73 65 72 74 28 20 28 69 73 53 61 . assert( (isSa
16f30 76 65 70 6e 74 26 7e 31 29 3d 3d 30 20 29 3b 20 vepnt&~1)==0 );
16f40 20 20 20 20 20 20 2f 2a 20 69 73 53 61 76 65 70 /* isSavep
16f50 6e 74 20 69 73 20 30 20 6f 72 20 31 20 2a 2f 0a nt is 0 or 1 */.
16f60 20 20 61 73 73 65 72 74 28 20 69 73 4d 61 69 6e assert( isMain
16f70 4a 72 6e 6c 20 7c 7c 20 70 44 6f 6e 65 20 29 3b Jrnl || pDone );
16f80 20 20 20 20 20 2f 2a 20 70 44 6f 6e 65 20 61 6c /* pDone al
16f90 77 61 79 73 20 75 73 65 64 20 6f 6e 20 73 75 62 ways used on sub
16fa0 2d 6a 6f 75 72 6e 61 6c 73 20 2a 2f 0a 20 20 61 -journals */. a
16fb0 73 73 65 72 74 28 20 69 73 53 61 76 65 70 6e 74 ssert( isSavepnt
16fc0 20 7c 7c 20 70 44 6f 6e 65 3d 3d 30 20 29 3b 20 || pDone==0 );
16fd0 20 20 2f 2a 20 70 44 6f 6e 65 20 6e 65 76 65 72 /* pDone never
16fe0 20 75 73 65 64 20 6f 6e 20 6e 6f 6e 2d 73 61 76 used on non-sav
16ff0 65 70 6f 69 6e 74 20 2a 2f 0a 0a 20 20 61 44 61 epoint */.. aDa
17000 74 61 20 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d ta = pPager->pTm
17010 70 53 70 61 63 65 3b 0a 20 20 61 73 73 65 72 74 pSpace;. assert
17020 28 20 61 44 61 74 61 20 29 3b 20 20 20 20 20 20 ( aData );
17030 20 20 20 2f 2a 20 54 65 6d 70 20 73 74 6f 72 61 /* Temp stora
17040 67 65 20 6d 75 73 74 20 68 61 76 65 20 61 6c 72 ge must have alr
17050 65 61 64 79 20 62 65 65 6e 20 61 6c 6c 6f 63 61 eady been alloca
17060 74 65 64 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 ted */. assert(
17070 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 pagerUseWal(pPa
17080 67 65 72 29 3d 3d 30 20 7c 7c 20 28 21 69 73 4d ger)==0 || (!isM
17090 61 69 6e 4a 72 6e 6c 20 26 26 20 69 73 53 61 76 ainJrnl && isSav
170a0 65 70 6e 74 29 20 29 3b 0a 0a 20 20 2f 2a 20 45 epnt) );.. /* E
170b0 69 74 68 65 72 20 74 68 65 20 73 74 61 74 65 20 ither the state
170c0 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
170d0 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 PAGER_WRITER_CAC
170e0 48 45 4d 4f 44 20 28 61 20 74 72 61 6e 73 61 63 HEMOD (a transac
170f0 74 69 6f 6e 20 0a 20 20 2a 2a 20 6f 72 20 73 61 tion . ** or sa
17100 76 65 70 6f 69 6e 74 20 72 6f 6c 6c 62 61 63 6b vepoint rollback
17110 20 64 6f 6e 65 20 61 74 20 74 68 65 20 72 65 71 done at the req
17120 75 65 73 74 20 6f 66 20 74 68 65 20 63 61 6c 6c uest of the call
17130 65 72 29 20 6f 72 20 74 68 69 73 20 69 73 0a 20 er) or this is.
17140 20 2a 2a 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 ** a hot-journa
17150 6c 20 72 6f 6c 6c 62 61 63 6b 2e 20 49 66 20 69 l rollback. If i
17160 74 20 69 73 20 61 20 68 6f 74 2d 6a 6f 75 72 6e t is a hot-journ
17170 61 6c 20 72 6f 6c 6c 62 61 63 6b 2c 20 74 68 65 al rollback, the
17180 20 70 61 67 65 72 0a 20 20 2a 2a 20 69 73 20 69 pager. ** is i
17190 6e 20 73 74 61 74 65 20 4f 50 45 4e 20 61 6e 64 n state OPEN and
171a0 20 68 6f 6c 64 73 20 61 6e 20 45 58 43 4c 55 53 holds an EXCLUS
171b0 49 56 45 20 6c 6f 63 6b 2e 20 48 6f 74 2d 6a 6f IVE lock. Hot-jo
171c0 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 0a 20 urnal rollback.
171d0 20 2a 2a 20 6f 6e 6c 79 20 72 65 61 64 73 20 66 ** only reads f
171e0 72 6f 6d 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 rom the main jou
171f0 72 6e 61 6c 2c 20 6e 6f 74 20 74 68 65 20 73 75 rnal, not the su
17200 62 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2f 0a b-journal.. */.
17210 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
17220 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 5f ->eState>=PAGER_
17230 57 52 49 54 45 52 5f 43 41 43 48 45 4d 4f 44 0a WRITER_CACHEMOD.
17240 20 20 20 20 20 20 20 7c 7c 20 28 70 50 61 67 65 || (pPage
17250 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 r->eState==PAGER
17260 5f 4f 50 45 4e 20 26 26 20 70 50 61 67 65 72 2d _OPEN && pPager-
17270 3e 65 4c 6f 63 6b 3d 3d 45 58 43 4c 55 53 49 56 >eLock==EXCLUSIV
17280 45 5f 4c 4f 43 4b 29 0a 20 20 29 3b 0a 20 20 61 E_LOCK). );. a
17290 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
172a0 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 State>=PAGER_WRI
172b0 54 45 52 5f 43 41 43 48 45 4d 4f 44 20 7c 7c 20 TER_CACHEMOD ||
172c0 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 3b 0a 0a 20 isMainJrnl );..
172d0 20 2f 2a 20 52 65 61 64 20 74 68 65 20 70 61 67 /* Read the pag
172e0 65 20 6e 75 6d 62 65 72 20 61 6e 64 20 70 61 67 e number and pag
172f0 65 20 64 61 74 61 20 66 72 6f 6d 20 74 68 65 20 e data from the
17300 6a 6f 75 72 6e 61 6c 20 6f 72 20 73 75 62 2d 6a journal or sub-j
17310 6f 75 72 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 ournal. ** file
17320 2e 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72 6f . Return an erro
17330 72 20 63 6f 64 65 20 74 6f 20 74 68 65 20 63 61 r code to the ca
17340 6c 6c 65 72 20 69 66 20 61 6e 20 49 4f 20 65 72 ller if an IO er
17350 72 6f 72 20 6f 63 63 75 72 73 2e 0a 20 20 2a 2f ror occurs.. */
17360 0a 20 20 6a 66 64 20 3d 20 69 73 4d 61 69 6e 4a . jfd = isMainJ
17370 72 6e 6c 20 3f 20 70 50 61 67 65 72 2d 3e 6a 66 rnl ? pPager->jf
17380 64 20 3a 20 70 50 61 67 65 72 2d 3e 73 6a 66 64 d : pPager->sjfd
17390 3b 0a 20 20 72 63 20 3d 20 72 65 61 64 33 32 62 ;. rc = read32b
173a0 69 74 73 28 6a 66 64 2c 20 2a 70 4f 66 66 73 65 its(jfd, *pOffse
173b0 74 2c 20 26 70 67 6e 6f 29 3b 0a 20 20 69 66 28 t, &pgno);. if(
173c0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
173d0 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 72 63 return rc;. rc
173e0 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 = sqlite3OsRead
173f0 28 6a 66 64 2c 20 28 75 38 2a 29 61 44 61 74 61 (jfd, (u8*)aData
17400 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 , pPager->pageSi
17410 7a 65 2c 20 28 2a 70 4f 66 66 73 65 74 29 2b 34 ze, (*pOffset)+4
17420 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c );. if( rc!=SQL
17430 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 ITE_OK ) return
17440 72 63 3b 0a 20 20 2a 70 4f 66 66 73 65 74 20 2b rc;. *pOffset +
17450 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
17460 7a 65 20 2b 20 34 20 2b 20 69 73 4d 61 69 6e 4a ze + 4 + isMainJ
17470 72 6e 6c 2a 34 3b 0a 0a 20 20 2f 2a 20 53 61 6e rnl*4;.. /* San
17480 69 74 79 20 63 68 65 63 6b 69 6e 67 20 6f 6e 20 ity checking on
17490 74 68 65 20 70 61 67 65 2e 20 20 54 68 69 73 20 the page. This
174a0 69 73 20 6d 6f 72 65 20 69 6d 70 6f 72 74 61 6e is more importan
174b0 74 20 74 68 61 74 20 49 20 6f 72 69 67 69 6e 61 t that I origina
174c0 6c 6c 79 0a 20 20 2a 2a 20 74 68 6f 75 67 68 74 lly. ** thought
174d0 2e 20 20 49 66 20 61 20 70 6f 77 65 72 20 66 61 . If a power fa
174e0 69 6c 75 72 65 20 6f 63 63 75 72 73 20 77 68 69 ilure occurs whi
174f0 6c 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 le the journal i
17500 73 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e 2c s being written,
17510 0a 20 20 2a 2a 20 69 74 20 63 6f 75 6c 64 20 63 . ** it could c
17520 61 75 73 65 20 69 6e 76 61 6c 69 64 20 64 61 74 ause invalid dat
17530 61 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e 20 a to be written
17540 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c into the journal
17550 2e 20 20 57 65 20 6e 65 65 64 20 74 6f 0a 20 20 . We need to.
17560 2a 2a 20 64 65 74 65 63 74 20 74 68 69 73 20 69 ** detect this i
17570 6e 76 61 6c 69 64 20 64 61 74 61 20 28 77 69 74 nvalid data (wit
17580 68 20 68 69 67 68 20 70 72 6f 62 61 62 69 6c 69 h high probabili
17590 74 79 29 20 61 6e 64 20 69 67 6e 6f 72 65 20 69 ty) and ignore i
175a0 74 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 67 t.. */. if( pg
175b0 6e 6f 3d 3d 30 20 7c 7c 20 70 67 6e 6f 3d 3d 50 no==0 || pgno==P
175c0 41 47 45 52 5f 4d 4a 5f 50 47 4e 4f 28 70 50 61 AGER_MJ_PGNO(pPa
175d0 67 65 72 29 20 29 7b 0a 20 20 20 20 61 73 73 65 ger) ){. asse
175e0 72 74 28 20 21 69 73 53 61 76 65 70 6e 74 20 29 rt( !isSavepnt )
175f0 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c ;. return SQL
17600 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 0a 20 20 ITE_DONE;. }.
17610 69 66 28 20 70 67 6e 6f 3e 28 50 67 6e 6f 29 70 if( pgno>(Pgno)p
17620 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 7c 7c Pager->dbSize ||
17630 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 sqlite3BitvecTe
17640 73 74 28 70 44 6f 6e 65 2c 20 70 67 6e 6f 29 20 st(pDone, pgno)
17650 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
17660 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 69 LITE_OK;. }. i
17670 66 28 20 69 73 4d 61 69 6e 4a 72 6e 6c 20 29 7b f( isMainJrnl ){
17680 0a 20 20 20 20 72 63 20 3d 20 72 65 61 64 33 32 . rc = read32
17690 62 69 74 73 28 6a 66 64 2c 20 28 2a 70 4f 66 66 bits(jfd, (*pOff
176a0 73 65 74 29 2d 34 2c 20 26 63 6b 73 75 6d 29 3b set)-4, &cksum);
176b0 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65 . if( rc ) re
176c0 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 69 66 28 turn rc;. if(
176d0 20 21 69 73 53 61 76 65 70 6e 74 20 26 26 20 70 !isSavepnt && p
176e0 61 67 65 72 5f 63 6b 73 75 6d 28 70 50 61 67 65 ager_cksum(pPage
176f0 72 2c 20 28 75 38 2a 29 61 44 61 74 61 29 21 3d r, (u8*)aData)!=
17700 63 6b 73 75 6d 20 29 7b 0a 20 20 20 20 20 20 72 cksum ){. r
17710 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 44 4f 4e eturn SQLITE_DON
17720 45 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 E;. }. }..
17730 2f 2a 20 49 66 20 74 68 69 73 20 70 61 67 65 20 /* If this page
17740 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
17750 20 70 6c 61 79 65 64 20 62 61 63 6b 20 62 65 66 played back bef
17760 6f 72 65 20 64 75 72 69 6e 67 20 74 68 65 20 63 ore during the c
17770 75 72 72 65 6e 74 0a 20 20 2a 2a 20 72 6f 6c 6c urrent. ** roll
17780 62 61 63 6b 2c 20 74 68 65 6e 20 64 6f 6e 27 74 back, then don't
17790 20 62 6f 74 68 65 72 20 74 6f 20 70 6c 61 79 20 bother to play
177a0 69 74 20 62 61 63 6b 20 61 67 61 69 6e 2e 0a 20 it back again..
177b0 20 2a 2f 0a 20 20 69 66 28 20 70 44 6f 6e 65 20 */. if( pDone
177c0 26 26 20 28 72 63 20 3d 20 73 71 6c 69 74 65 33 && (rc = sqlite3
177d0 42 69 74 76 65 63 53 65 74 28 70 44 6f 6e 65 2c BitvecSet(pDone,
177e0 20 70 67 6e 6f 29 29 21 3d 53 51 4c 49 54 45 5f pgno))!=SQLITE_
177f0 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e OK ){. return
17800 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57 rc;. }.. /* W
17810 68 65 6e 20 70 6c 61 79 69 6e 67 20 62 61 63 6b hen playing back
17820 20 70 61 67 65 20 31 2c 20 72 65 73 74 6f 72 65 page 1, restore
17830 20 74 68 65 20 6e 52 65 73 65 72 76 65 20 73 65 the nReserve se
17840 74 74 69 6e 67 0a 20 20 2a 2f 0a 20 20 69 66 28 tting. */. if(
17850 20 70 67 6e 6f 3d 3d 31 20 26 26 20 70 50 61 67 pgno==1 && pPag
17860 65 72 2d 3e 6e 52 65 73 65 72 76 65 21 3d 28 28 er->nReserve!=((
17870 75 38 2a 29 61 44 61 74 61 29 5b 32 30 5d 20 29 u8*)aData)[20] )
17880 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 52 {. pPager->nR
17890 65 73 65 72 76 65 20 3d 20 28 28 75 38 2a 29 61 eserve = ((u8*)a
178a0 44 61 74 61 29 5b 32 30 5d 3b 0a 20 20 20 20 70 Data)[20];. p
178b0 61 67 65 72 52 65 70 6f 72 74 53 69 7a 65 28 70 agerReportSize(p
178c0 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 20 2f Pager);. }.. /
178d0 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 * If the pager i
178e0 73 20 69 6e 20 43 41 43 48 45 4d 4f 44 20 73 74 s in CACHEMOD st
178f0 61 74 65 2c 20 74 68 65 6e 20 74 68 65 72 65 20 ate, then there
17900 6d 75 73 74 20 62 65 20 61 20 63 6f 70 79 20 6f must be a copy o
17910 66 20 74 68 69 73 0a 20 20 2a 2a 20 70 61 67 65 f this. ** page
17920 20 69 6e 20 74 68 65 20 70 61 67 65 72 20 63 61 in the pager ca
17930 63 68 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 che. In this cas
17940 65 20 6a 75 73 74 20 75 70 64 61 74 65 20 74 68 e just update th
17950 65 20 70 61 67 65 72 20 63 61 63 68 65 2c 0a 20 e pager cache,.
17960 20 2a 2a 20 6e 6f 74 20 74 68 65 20 64 61 74 61 ** not the data
17970 62 61 73 65 20 66 69 6c 65 2e 20 54 68 65 20 70 base file. The p
17980 61 67 65 20 69 73 20 6c 65 66 74 20 6d 61 72 6b age is left mark
17990 65 64 20 64 69 72 74 79 20 69 6e 20 74 68 69 73 ed dirty in this
179a0 20 63 61 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a case.. **. **
179b0 20 41 6e 20 65 78 63 65 70 74 69 6f 6e 20 74 6f An exception to
179c0 20 74 68 65 20 61 62 6f 76 65 20 72 75 6c 65 3a the above rule:
179d0 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 If the database
179e0 20 69 73 20 69 6e 20 6e 6f 2d 73 79 6e 63 20 6d is in no-sync m
179f0 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20 61 20 70 ode. ** and a p
17a00 61 67 65 20 69 73 20 6d 6f 76 65 64 20 64 75 72 age is moved dur
17a10 69 6e 67 20 61 6e 20 69 6e 63 72 65 6d 65 6e 74 ing an increment
17a20 61 6c 20 76 61 63 75 75 6d 20 74 68 65 6e 20 74 al vacuum then t
17a30 68 65 20 70 61 67 65 20 6d 61 79 0a 20 20 2a 2a he page may. **
17a40 20 6e 6f 74 20 62 65 20 69 6e 20 74 68 65 20 70 not be in the p
17a50 61 67 65 72 20 63 61 63 68 65 2e 20 4c 61 74 65 ager cache. Late
17a60 72 3a 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 r: if a malloc()
17a70 20 6f 72 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 or IO error occ
17a80 75 72 73 0a 20 20 2a 2a 20 64 75 72 69 6e 67 20 urs. ** during
17a90 61 20 4d 6f 76 65 70 61 67 65 28 29 20 63 61 6c a Movepage() cal
17aa0 6c 2c 20 74 68 65 6e 20 74 68 65 20 70 61 67 65 l, then the page
17ab0 20 6d 61 79 20 6e 6f 74 20 62 65 20 69 6e 20 74 may not be in t
17ac0 68 65 20 63 61 63 68 65 0a 20 20 2a 2a 20 65 69 he cache. ** ei
17ad0 74 68 65 72 2e 20 53 6f 20 74 68 65 20 63 6f 6e ther. So the con
17ae0 64 69 74 69 6f 6e 20 64 65 73 63 72 69 62 65 64 dition described
17af0 20 69 6e 20 74 68 65 20 61 62 6f 76 65 20 70 61 in the above pa
17b00 72 61 67 72 61 70 68 20 69 73 20 6e 6f 74 0a 20 ragraph is not.
17b10 20 2a 2a 20 61 73 73 65 72 74 28 29 61 62 6c 65 ** assert()able
17b20 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 69 .. **. ** If i
17b30 6e 20 57 52 49 54 45 52 5f 44 42 4d 4f 44 2c 20 n WRITER_DBMOD,
17b40 57 52 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 WRITER_FINISHED
17b50 6f 72 20 4f 50 45 4e 20 73 74 61 74 65 2c 20 74 or OPEN state, t
17b60 68 65 6e 20 77 65 20 75 70 64 61 74 65 20 74 68 hen we update th
17b70 65 0a 20 20 2a 2a 20 70 61 67 65 72 20 63 61 63 e. ** pager cac
17b80 68 65 20 69 66 20 69 74 20 65 78 69 73 74 73 20 he if it exists
17b90 61 6e 64 20 74 68 65 20 6d 61 69 6e 20 66 69 6c and the main fil
17ba0 65 2e 20 54 68 65 20 70 61 67 65 20 69 73 20 74 e. The page is t
17bb0 68 65 6e 20 6d 61 72 6b 65 64 20 0a 20 20 2a 2a hen marked . **
17bc0 20 6e 6f 74 20 64 69 72 74 79 2e 20 53 69 6e 63 not dirty. Sinc
17bd0 65 20 74 68 69 73 20 63 6f 64 65 20 69 73 20 6f e this code is o
17be0 6e 6c 79 20 65 78 65 63 75 74 65 64 20 69 6e 20 nly executed in
17bf0 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 65 PAGER_OPEN state
17c00 20 66 6f 72 0a 20 20 2a 2a 20 61 20 68 6f 74 2d for. ** a hot-
17c10 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b journal rollback
17c20 2c 20 69 74 20 69 73 20 67 75 61 72 61 6e 74 65 , it is guarante
17c30 65 64 20 74 68 61 74 20 74 68 65 20 70 61 67 65 ed that the page
17c40 2d 63 61 63 68 65 20 69 73 20 65 6d 70 74 79 0a -cache is empty.
17c50 20 20 2a 2a 20 69 66 20 74 68 65 20 70 61 67 65 ** if the page
17c60 72 20 69 73 20 69 6e 20 4f 50 45 4e 20 73 74 61 r is in OPEN sta
17c70 74 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 69 te.. **. ** Ti
17c80 63 6b 65 74 20 23 31 31 37 31 3a 20 20 54 68 65 cket #1171: The
17c90 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e statement journ
17ca0 61 6c 20 6d 69 67 68 74 20 63 6f 6e 74 61 69 6e al might contain
17cb0 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 74 68 page content th
17cc0 61 74 20 69 73 0a 20 20 2a 2a 20 64 69 66 66 65 at is. ** diffe
17cd0 72 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 70 61 rent from the pa
17ce0 67 65 20 63 6f 6e 74 65 6e 74 20 61 74 20 74 68 ge content at th
17cf0 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 74 e start of the t
17d00 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2a ransaction.. **
17d10 20 54 68 69 73 20 6f 63 63 75 72 73 20 77 68 65 This occurs whe
17d20 6e 20 61 20 70 61 67 65 20 69 73 20 63 68 61 6e n a page is chan
17d30 67 65 64 20 70 72 69 6f 72 20 74 6f 20 74 68 65 ged prior to the
17d40 20 73 74 61 72 74 20 6f 66 20 61 20 73 74 61 74 start of a stat
17d50 65 6d 65 6e 74 0a 20 20 2a 2a 20 74 68 65 6e 20 ement. ** then
17d60 63 68 61 6e 67 65 64 20 61 67 61 69 6e 20 77 69 changed again wi
17d70 74 68 69 6e 20 74 68 65 20 73 74 61 74 65 6d 65 thin the stateme
17d80 6e 74 2e 20 20 57 68 65 6e 20 72 6f 6c 6c 69 6e nt. When rollin
17d90 67 20 62 61 63 6b 20 73 75 63 68 20 61 0a 20 20 g back such a.
17da0 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 77 65 20 ** statement we
17db0 6d 75 73 74 20 6e 6f 74 20 77 72 69 74 65 20 74 must not write t
17dc0 6f 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 64 o the original d
17dd0 61 74 61 62 61 73 65 20 75 6e 6c 65 73 73 20 77 atabase unless w
17de0 65 20 6b 6e 6f 77 0a 20 20 2a 2a 20 66 6f 72 20 e know. ** for
17df0 63 65 72 74 61 69 6e 20 74 68 61 74 20 6f 72 69 certain that ori
17e00 67 69 6e 61 6c 20 70 61 67 65 20 63 6f 6e 74 65 ginal page conte
17e10 6e 74 73 20 61 72 65 20 73 79 6e 63 65 64 20 69 nts are synced i
17e20 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 72 6f 6c nto the main rol
17e30 6c 62 61 63 6b 0a 20 20 2a 2a 20 6a 6f 75 72 6e lback. ** journ
17e40 61 6c 2e 20 20 4f 74 68 65 72 77 69 73 65 2c 20 al. Otherwise,
17e50 61 20 70 6f 77 65 72 20 6c 6f 73 73 20 6d 69 67 a power loss mig
17e60 68 74 20 6c 65 61 76 65 20 6d 6f 64 69 66 69 65 ht leave modifie
17e70 64 20 64 61 74 61 20 69 6e 20 74 68 65 0a 20 20 d data in the.
17e80 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ** database file
17e90 20 77 69 74 68 6f 75 74 20 61 6e 20 65 6e 74 72 without an entr
17ea0 79 20 69 6e 20 74 68 65 20 72 6f 6c 6c 62 61 63 y in the rollbac
17eb0 6b 20 6a 6f 75 72 6e 61 6c 20 74 68 61 74 20 63 k journal that c
17ec0 61 6e 0a 20 20 2a 2a 20 72 65 73 74 6f 72 65 20 an. ** restore
17ed0 74 68 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 the database to
17ee0 69 74 73 20 6f 72 69 67 69 6e 61 6c 20 66 6f 72 its original for
17ef0 6d 2e 20 20 54 77 6f 20 63 6f 6e 64 69 74 69 6f m. Two conditio
17f00 6e 73 20 6d 75 73 74 20 62 65 0a 20 20 2a 2a 20 ns must be. **
17f10 6d 65 74 20 62 65 66 6f 72 65 20 77 72 69 74 69 met before writi
17f20 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ng to the databa
17f30 73 65 20 66 69 6c 65 73 2e 20 28 31 29 20 74 68 se files. (1) th
17f40 65 20 64 61 74 61 62 61 73 65 20 6d 75 73 74 20 e database must
17f50 62 65 0a 20 20 2a 2a 20 6c 6f 63 6b 65 64 2e 20 be. ** locked.
17f60 20 28 32 29 20 77 65 20 6b 6e 6f 77 20 74 68 61 (2) we know tha
17f70 74 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 70 t the original p
17f80 61 67 65 20 63 6f 6e 74 65 6e 74 20 69 73 20 66 age content is f
17f90 75 6c 6c 79 20 73 79 6e 63 65 64 0a 20 20 2a 2a ully synced. **
17fa0 20 69 6e 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 in the main jou
17fb0 72 6e 61 6c 20 65 69 74 68 65 72 20 62 65 63 61 rnal either beca
17fc0 75 73 65 20 74 68 65 20 70 61 67 65 20 69 73 20 use the page is
17fd0 6e 6f 74 20 69 6e 20 63 61 63 68 65 20 6f 72 20 not in cache or
17fe0 65 6c 73 65 0a 20 20 2a 2a 20 74 68 65 20 70 61 else. ** the pa
17ff0 67 65 20 69 73 20 6d 61 72 6b 65 64 20 61 73 20 ge is marked as
18000 6e 65 65 64 53 79 6e 63 3d 3d 30 2e 0a 20 20 2a needSync==0.. *
18010 2a 0a 20 20 2a 2a 20 32 30 30 38 2d 30 34 2d 31 *. ** 2008-04-1
18020 34 3a 20 20 57 68 65 6e 20 61 74 74 65 6d 70 74 4: When attempt
18030 69 6e 67 20 74 6f 20 76 61 63 75 75 6d 20 61 20 ing to vacuum a
18040 63 6f 72 72 75 70 74 20 64 61 74 61 62 61 73 65 corrupt database
18050 20 66 69 6c 65 2c 20 69 74 0a 20 20 2a 2a 20 69 file, it. ** i
18060 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 66 61 s possible to fa
18070 69 6c 20 61 20 73 74 61 74 65 6d 65 6e 74 20 6f il a statement o
18080 6e 20 61 20 64 61 74 61 62 61 73 65 20 74 68 61 n a database tha
18090 74 20 64 6f 65 73 20 6e 6f 74 20 79 65 74 20 65 t does not yet e
180a0 78 69 73 74 2e 0a 20 20 2a 2a 20 44 6f 20 6e 6f xist.. ** Do no
180b0 74 20 61 74 74 65 6d 70 74 20 74 6f 20 77 72 69 t attempt to wri
180c0 74 65 20 69 66 20 64 61 74 61 62 61 73 65 20 66 te if database f
180d0 69 6c 65 20 68 61 73 20 6e 65 76 65 72 20 62 65 ile has never be
180e0 65 6e 20 6f 70 65 6e 65 64 2e 0a 20 20 2a 2f 0a en opened.. */.
180f0 20 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 if( pagerUseWa
18100 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 l(pPager) ){.
18110 20 70 50 67 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 pPg = 0;. }els
18120 65 7b 0a 20 20 20 20 70 50 67 20 3d 20 73 71 6c e{. pPg = sql
18130 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 ite3PagerLookup(
18140 70 50 61 67 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 pPager, pgno);.
18150 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 }. assert( pPg
18160 20 7c 7c 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 || !MEMDB );.
18170 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
18180 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 4f 50 eState!=PAGER_OP
18190 45 4e 20 7c 7c 20 70 50 67 3d 3d 30 20 7c 7c 20 EN || pPg==0 ||
181a0 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 pPager->tempFile
181b0 20 29 3b 0a 20 20 50 41 47 45 52 54 52 41 43 45 );. PAGERTRACE
181c0 28 28 22 50 4c 41 59 42 41 43 4b 20 25 64 20 70 (("PLAYBACK %d p
181d0 61 67 65 20 25 64 20 68 61 73 68 28 25 30 38 78 age %d hash(%08x
181e0 29 20 25 73 5c 6e 22 2c 0a 20 20 20 20 20 20 20 ) %s\n",.
181f0 20 20 20 20 50 41 47 45 52 49 44 28 70 50 61 67 PAGERID(pPag
18200 65 72 29 2c 20 70 67 6e 6f 2c 20 70 61 67 65 72 er), pgno, pager
18210 5f 64 61 74 61 68 61 73 68 28 70 50 61 67 65 72 _datahash(pPager
18220 2d 3e 70 61 67 65 53 69 7a 65 2c 20 28 75 38 2a ->pageSize, (u8*
18230 29 61 44 61 74 61 29 2c 0a 20 20 20 20 20 20 20 )aData),.
18240 20 20 20 20 28 69 73 4d 61 69 6e 4a 72 6e 6c 3f (isMainJrnl?
18250 22 6d 61 69 6e 2d 6a 6f 75 72 6e 61 6c 22 3a 22 "main-journal":"
18260 73 75 62 2d 6a 6f 75 72 6e 61 6c 22 29 0a 20 20 sub-journal").
18270 29 29 3b 0a 20 20 69 66 28 20 69 73 4d 61 69 6e ));. if( isMain
18280 4a 72 6e 6c 20 29 7b 0a 20 20 20 20 69 73 53 79 Jrnl ){. isSy
18290 6e 63 65 64 20 3d 20 70 50 61 67 65 72 2d 3e 6e nced = pPager->n
182a0 6f 53 79 6e 63 20 7c 7c 20 28 2a 70 4f 66 66 73 oSync || (*pOffs
182b0 65 74 20 3c 3d 20 70 50 61 67 65 72 2d 3e 6a 6f et <= pPager->jo
182c0 75 72 6e 61 6c 48 64 72 29 3b 0a 20 20 7d 65 6c urnalHdr);. }el
182d0 73 65 7b 0a 20 20 20 20 69 73 53 79 6e 63 65 64 se{. isSynced
182e0 20 3d 20 28 70 50 67 3d 3d 30 20 7c 7c 20 30 3d = (pPg==0 || 0=
182f0 3d 28 70 50 67 2d 3e 66 6c 61 67 73 20 26 20 50 =(pPg->flags & P
18300 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 29 GHDR_NEED_SYNC))
18310 3b 0a 20 20 7d 0a 20 20 69 66 28 20 69 73 4f 70 ;. }. if( isOp
18320 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 0a 20 en(pPager->fd).
18330 20 20 26 26 20 28 70 50 61 67 65 72 2d 3e 65 53 && (pPager->eS
18340 74 61 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 tate>=PAGER_WRIT
18350 45 52 5f 44 42 4d 4f 44 20 7c 7c 20 70 50 61 67 ER_DBMOD || pPag
18360 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
18370 52 5f 4f 50 45 4e 29 0a 20 20 20 26 26 20 69 73 R_OPEN). && is
18380 53 79 6e 63 65 64 0a 20 20 29 7b 0a 20 20 20 20 Synced. ){.
18390 69 36 34 20 6f 66 73 74 20 3d 20 28 70 67 6e 6f i64 ofst = (pgno
183a0 2d 31 29 2a 28 69 36 34 29 70 50 61 67 65 72 2d -1)*(i64)pPager-
183b0 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 74 >pageSize;. t
183c0 65 73 74 63 61 73 65 28 20 21 69 73 53 61 76 65 estcase( !isSave
183d0 70 6e 74 20 26 26 20 70 50 67 21 3d 30 20 26 26 pnt && pPg!=0 &&
183e0 20 28 70 50 67 2d 3e 66 6c 61 67 73 26 50 47 48 (pPg->flags&PGH
183f0 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 21 3d 30 DR_NEED_SYNC)!=0
18400 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 );. assert(
18410 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
18420 67 65 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 ger) );.. /*
18430 57 72 69 74 65 20 74 68 65 20 64 61 74 61 20 72 Write the data r
18440 65 61 64 20 66 72 6f 6d 20 74 68 65 20 6a 6f 75 ead from the jou
18450 72 6e 61 6c 20 62 61 63 6b 20 69 6e 74 6f 20 74 rnal back into t
18460 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
18470 2e 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 69 73 .. ** This is
18480 20 75 73 75 61 6c 6c 79 20 73 61 66 65 20 65 76 usually safe ev
18490 65 6e 20 66 6f 72 20 61 6e 20 65 6e 63 72 79 70 en for an encryp
184a0 74 65 64 20 64 61 74 61 62 61 73 65 20 2d 20 61 ted database - a
184b0 73 20 74 68 65 20 64 61 74 61 0a 20 20 20 20 2a s the data. *
184c0 2a 20 77 61 73 20 65 6e 63 72 79 70 74 65 64 20 * was encrypted
184d0 62 65 66 6f 72 65 20 69 74 20 77 61 73 20 77 72 before it was wr
184e0 69 74 74 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 itten to the jou
184f0 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 65 20 65 rnal file. The e
18500 78 63 65 70 74 69 6f 6e 0a 20 20 20 20 2a 2a 20 xception. **
18510 69 73 20 69 66 20 74 68 65 20 64 61 74 61 20 77 is if the data w
18520 61 73 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f as just read fro
18530 6d 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 m an in-memory s
18540 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 49 6e 20 74 ub-journal. In t
18550 68 61 74 0a 20 20 20 20 2a 2a 20 63 61 73 65 20 hat. ** case
18560 69 74 20 6d 75 73 74 20 62 65 20 65 6e 63 72 79 it must be encry
18570 70 74 65 64 20 68 65 72 65 20 62 65 66 6f 72 65 pted here before
18580 20 69 74 20 69 73 20 63 6f 70 69 65 64 20 69 6e it is copied in
18590 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 0a to the database.
185a0 20 20 20 20 2a 2a 20 66 69 6c 65 2e 20 20 2a 2f ** file. */
185b0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 48 .#ifdef SQLITE_H
185c0 41 53 5f 43 4f 44 45 43 0a 20 20 20 20 69 66 28 AS_CODEC. if(
185d0 20 21 6a 72 6e 6c 45 6e 63 20 29 7b 0a 20 20 20 !jrnlEnc ){.
185e0 20 20 20 43 4f 44 45 43 32 28 70 50 61 67 65 72 CODEC2(pPager
185f0 2c 20 61 44 61 74 61 2c 20 70 67 6e 6f 2c 20 37 , aData, pgno, 7
18600 2c 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 , rc=SQLITE_NOME
18610 4d 5f 42 4b 50 54 2c 20 61 44 61 74 61 29 3b 0a M_BKPT, aData);.
18620 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
18630 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 72 e3OsWrite(pPager
18640 2d 3e 66 64 2c 20 28 75 38 20 2a 29 61 44 61 74 ->fd, (u8 *)aDat
18650 61 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 a, pPager->pageS
18660 69 7a 65 2c 20 6f 66 73 74 29 3b 0a 20 20 20 20 ize, ofst);.
18670 20 20 43 4f 44 45 43 31 28 70 50 61 67 65 72 2c CODEC1(pPager,
18680 20 61 44 61 74 61 2c 20 70 67 6e 6f 2c 20 33 2c aData, pgno, 3,
18690 20 72 63 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc=SQLITE_NOMEM
186a0 5f 42 4b 50 54 29 3b 0a 20 20 20 20 7d 65 6c 73 _BKPT);. }els
186b0 65 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 63 20 e.#endif. rc
186c0 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 = sqlite3OsWrite
186d0 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 28 75 38 (pPager->fd, (u8
186e0 20 2a 29 61 44 61 74 61 2c 20 70 50 61 67 65 72 *)aData, pPager
186f0 2d 3e 70 61 67 65 53 69 7a 65 2c 20 6f 66 73 74 ->pageSize, ofst
18700 29 3b 0a 0a 20 20 20 20 69 66 28 20 70 67 6e 6f );.. if( pgno
18710 3e 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 53 >pPager->dbFileS
18720 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 70 50 61 ize ){. pPa
18730 67 65 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 ger->dbFileSize
18740 3d 20 70 67 6e 6f 3b 0a 20 20 20 20 7d 0a 20 20 = pgno;. }.
18750 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 70 42 if( pPager->pB
18760 61 63 6b 75 70 20 29 7b 0a 23 69 66 64 65 66 20 ackup ){.#ifdef
18770 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 43 SQLITE_HAS_CODEC
18780 0a 20 20 20 20 20 20 69 66 28 20 6a 72 6e 6c 45 . if( jrnlE
18790 6e 63 20 29 7b 0a 20 20 20 20 20 20 20 20 43 4f nc ){. CO
187a0 44 45 43 31 28 70 50 61 67 65 72 2c 20 61 44 61 DEC1(pPager, aDa
187b0 74 61 2c 20 70 67 6e 6f 2c 20 33 2c 20 72 63 3d ta, pgno, 3, rc=
187c0 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
187d0 54 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 T);. sqli
187e0 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 te3BackupUpdate(
187f0 70 50 61 67 65 72 2d 3e 70 42 61 63 6b 75 70 2c pPager->pBackup,
18800 20 70 67 6e 6f 2c 20 28 75 38 2a 29 61 44 61 74 pgno, (u8*)aDat
18810 61 29 3b 0a 20 20 20 20 20 20 20 20 43 4f 44 45 a);. CODE
18820 43 32 28 70 50 61 67 65 72 2c 20 61 44 61 74 61 C2(pPager, aData
18830 2c 20 70 67 6e 6f 2c 20 37 2c 20 72 63 3d 53 51 , pgno, 7, rc=SQ
18840 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 2c LITE_NOMEM_BKPT,
18850 61 44 61 74 61 29 3b 0a 20 20 20 20 20 20 7d 65 aData);. }e
18860 6c 73 65 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 lse.#endif.
18870 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 sqlite3BackupUp
18880 64 61 74 65 28 70 50 61 67 65 72 2d 3e 70 42 61 date(pPager->pBa
18890 63 6b 75 70 2c 20 70 67 6e 6f 2c 20 28 75 38 2a ckup, pgno, (u8*
188a0 29 61 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 )aData);. }.
188b0 20 7d 65 6c 73 65 20 69 66 28 20 21 69 73 4d 61 }else if( !isMa
188c0 69 6e 4a 72 6e 6c 20 26 26 20 70 50 67 3d 3d 30 inJrnl && pPg==0
188d0 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 ){. /* If th
188e0 69 73 20 69 73 20 61 20 72 6f 6c 6c 62 61 63 6b is is a rollback
188f0 20 6f 66 20 61 20 73 61 76 65 70 6f 69 6e 74 20 of a savepoint
18900 61 6e 64 20 64 61 74 61 20 77 61 73 20 6e 6f 74 and data was not
18910 20 77 72 69 74 74 65 6e 20 74 6f 0a 20 20 20 20 written to.
18920 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ** the database
18930 61 6e 64 20 74 68 65 20 70 61 67 65 20 69 73 20 and the page is
18940 6e 6f 74 20 69 6e 2d 6d 65 6d 6f 72 79 2c 20 74 not in-memory, t
18950 68 65 72 65 20 69 73 20 61 20 70 6f 74 65 6e 74 here is a potent
18960 69 61 6c 0a 20 20 20 20 2a 2a 20 70 72 6f 62 6c ial. ** probl
18970 65 6d 2e 20 57 68 65 6e 20 74 68 65 20 70 61 67 em. When the pag
18980 65 20 69 73 20 6e 65 78 74 20 66 65 74 63 68 65 e is next fetche
18990 64 20 62 79 20 74 68 65 20 62 2d 74 72 65 65 20 d by the b-tree
189a0 6c 61 79 65 72 2c 20 69 74 20 0a 20 20 20 20 2a layer, it . *
189b0 2a 20 77 69 6c 6c 20 62 65 20 72 65 61 64 20 66 * will be read f
189c0 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
189d0 20 66 69 6c 65 2c 20 77 68 69 63 68 20 6d 61 79 file, which may
189e0 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 0a or may not be .
189f0 20 20 20 20 2a 2a 20 63 75 72 72 65 6e 74 2e 20 ** current.
18a00 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 54 . **. ** T
18a10 68 65 72 65 20 61 72 65 20 61 20 63 6f 75 70 6c here are a coupl
18a20 65 20 6f 66 20 64 69 66 66 65 72 65 6e 74 20 77 e of different w
18a30 61 79 73 20 74 68 69 73 20 63 61 6e 20 68 61 70 ays this can hap
18a40 70 65 6e 2e 20 41 6c 6c 20 61 72 65 20 71 75 69 pen. All are qui
18a50 74 65 0a 20 20 20 20 2a 2a 20 6f 62 73 63 75 72 te. ** obscur
18a60 65 2e 20 57 68 65 6e 20 72 75 6e 6e 69 6e 67 20 e. When running
18a70 69 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 6d in synchronous m
18a80 6f 64 65 2c 20 74 68 69 73 20 63 61 6e 20 6f 6e ode, this can on
18a90 6c 79 20 68 61 70 70 65 6e 20 0a 20 20 20 20 2a ly happen . *
18aa0 2a 20 69 66 20 74 68 65 20 70 61 67 65 20 69 73 * if the page is
18ab0 20 6f 6e 20 74 68 65 20 66 72 65 65 2d 6c 69 73 on the free-lis
18ac0 74 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f t at the start o
18ad0 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f f the transactio
18ae0 6e 2c 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 70 n, then. ** p
18af0 6f 70 75 6c 61 74 65 64 2c 20 74 68 65 6e 20 6d opulated, then m
18b00 6f 76 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 oved using sqlit
18b10 65 33 50 61 67 65 72 4d 6f 76 65 70 61 67 65 28 e3PagerMovepage(
18b20 29 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a ).. **. **
18b30 20 54 68 65 20 73 6f 6c 75 74 69 6f 6e 20 69 73 The solution is
18b40 20 74 6f 20 61 64 64 20 61 6e 20 69 6e 2d 6d 65 to add an in-me
18b50 6d 6f 72 79 20 70 61 67 65 20 74 6f 20 74 68 65 mory page to the
18b60 20 63 61 63 68 65 20 63 6f 6e 74 61 69 6e 69 6e cache containin
18b70 67 0a 20 20 20 20 2a 2a 20 74 68 65 20 64 61 74 g. ** the dat
18b80 61 20 6a 75 73 74 20 72 65 61 64 20 66 72 6f 6d a just read from
18b90 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c the sub-journal
18ba0 2e 20 4d 61 72 6b 20 74 68 65 20 70 61 67 65 20 . Mark the page
18bb0 61 73 20 64 69 72 74 79 20 0a 20 20 20 20 2a 2a as dirty . **
18bc0 20 61 6e 64 20 69 66 20 74 68 65 20 70 61 67 65 and if the page
18bd0 72 20 72 65 71 75 69 72 65 73 20 61 20 6a 6f 75 r requires a jou
18be0 72 6e 61 6c 2d 73 79 6e 63 2c 20 74 68 65 6e 20 rnal-sync, then
18bf0 6d 61 72 6b 20 74 68 65 20 70 61 67 65 20 61 73 mark the page as
18c00 20 0a 20 20 20 20 2a 2a 20 72 65 71 75 69 72 69 . ** requiri
18c10 6e 67 20 61 20 6a 6f 75 72 6e 61 6c 2d 73 79 6e ng a journal-syn
18c20 63 20 62 65 66 6f 72 65 20 69 74 20 69 73 20 77 c before it is w
18c30 72 69 74 74 65 6e 2e 0a 20 20 20 20 2a 2f 0a 20 ritten.. */.
18c40 20 20 20 61 73 73 65 72 74 28 20 69 73 53 61 76 assert( isSav
18c50 65 70 6e 74 20 29 3b 0a 20 20 20 20 61 73 73 65 epnt );. asse
18c60 72 74 28 20 28 70 50 61 67 65 72 2d 3e 64 6f 4e rt( (pPager->doN
18c70 6f 74 53 70 69 6c 6c 20 26 20 53 50 49 4c 4c 46 otSpill & SPILLF
18c80 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 29 3d 3d 30 LAG_ROLLBACK)==0
18c90 20 29 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e );. pPager->
18ca0 64 6f 4e 6f 74 53 70 69 6c 6c 20 7c 3d 20 53 50 doNotSpill |= SP
18cb0 49 4c 4c 46 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b ILLFLAG_ROLLBACK
18cc0 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 ;. rc = sqlit
18cd0 65 33 50 61 67 65 72 47 65 74 28 70 50 61 67 65 e3PagerGet(pPage
18ce0 72 2c 20 70 67 6e 6f 2c 20 26 70 50 67 2c 20 31 r, pgno, &pPg, 1
18cf0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 28 );. assert( (
18d00 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 pPager->doNotSpi
18d10 6c 6c 20 26 20 53 50 49 4c 4c 46 4c 41 47 5f 52 ll & SPILLFLAG_R
18d20 4f 4c 4c 42 41 43 4b 29 21 3d 30 20 29 3b 0a 20 OLLBACK)!=0 );.
18d30 20 20 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 pPager->doNot
18d40 53 70 69 6c 6c 20 26 3d 20 7e 53 50 49 4c 4c 46 Spill &= ~SPILLF
18d50 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 3b 0a 20 20 LAG_ROLLBACK;.
18d60 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
18d70 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b _OK ) return rc;
18d80 0a 20 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 . sqlite3Pcac
18d90 68 65 4d 61 6b 65 44 69 72 74 79 28 70 50 67 29 heMakeDirty(pPg)
18da0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 67 20 ;. }. if( pPg
18db0 29 7b 0a 20 20 20 20 2f 2a 20 4e 6f 20 70 61 67 ){. /* No pag
18dc0 65 20 73 68 6f 75 6c 64 20 65 76 65 72 20 62 65 e should ever be
18dd0 20 65 78 70 6c 69 63 69 74 6c 79 20 72 6f 6c 6c explicitly roll
18de0 65 64 20 62 61 63 6b 20 74 68 61 74 20 69 73 20 ed back that is
18df0 69 6e 20 75 73 65 2c 20 65 78 63 65 70 74 0a 20 in use, except.
18e00 20 20 20 2a 2a 20 66 6f 72 20 70 61 67 65 20 31 ** for page 1
18e10 20 77 68 69 63 68 20 69 73 20 68 65 6c 64 20 69 which is held i
18e20 6e 20 75 73 65 20 69 6e 20 6f 72 64 65 72 20 74 n use in order t
18e30 6f 20 6b 65 65 70 20 74 68 65 20 6c 6f 63 6b 20 o keep the lock
18e40 6f 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 on the. ** da
18e50 74 61 62 61 73 65 20 61 63 74 69 76 65 2e 20 48 tabase active. H
18e60 6f 77 65 76 65 72 20 73 75 63 68 20 61 20 70 61 owever such a pa
18e70 67 65 20 6d 61 79 20 62 65 20 72 6f 6c 6c 65 64 ge may be rolled
18e80 20 62 61 63 6b 20 61 73 20 61 20 72 65 73 75 6c back as a resul
18e90 74 0a 20 20 20 20 2a 2a 20 6f 66 20 61 6e 20 69 t. ** of an i
18ea0 6e 74 65 72 6e 61 6c 20 65 72 72 6f 72 20 72 65 nternal error re
18eb0 73 75 6c 74 69 6e 67 20 69 6e 20 61 6e 20 61 75 sulting in an au
18ec0 74 6f 6d 61 74 69 63 20 63 61 6c 6c 20 74 6f 0a tomatic call to.
18ed0 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 50 61 ** sqlite3Pa
18ee0 67 65 72 52 6f 6c 6c 62 61 63 6b 28 29 2e 0a 20 gerRollback()..
18ef0 20 20 20 2a 2f 0a 20 20 20 20 76 6f 69 64 20 2a */. void *
18f00 70 44 61 74 61 3b 0a 20 20 20 20 70 44 61 74 61 pData;. pData
18f10 20 3d 20 70 50 67 2d 3e 70 44 61 74 61 3b 0a 20 = pPg->pData;.
18f20 20 20 20 6d 65 6d 63 70 79 28 70 44 61 74 61 2c memcpy(pData,
18f30 20 28 75 38 2a 29 61 44 61 74 61 2c 20 70 50 61 (u8*)aData, pPa
18f40 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a ger->pageSize);.
18f50 20 20 20 20 70 50 61 67 65 72 2d 3e 78 52 65 69 pPager->xRei
18f60 6e 69 74 65 72 28 70 50 67 29 3b 0a 20 20 20 20 niter(pPg);.
18f70 2f 2a 20 49 74 20 75 73 65 64 20 74 6f 20 62 65 /* It used to be
18f80 20 74 68 61 74 20 73 71 6c 69 74 65 33 50 63 61 that sqlite3Pca
18f90 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 70 50 67 cheMakeClean(pPg
18fa0 29 20 77 61 73 20 63 61 6c 6c 65 64 20 68 65 72 ) was called her
18fb0 65 2e 20 20 42 75 74 0a 20 20 20 20 2a 2a 20 74 e. But. ** t
18fc0 68 61 74 20 63 61 6c 6c 20 77 61 73 20 64 61 6e hat call was dan
18fd0 67 65 72 6f 75 73 20 61 6e 64 20 68 61 64 20 6e gerous and had n
18fe0 6f 20 64 65 74 65 63 74 61 62 6c 65 20 62 65 6e o detectable ben
18ff0 65 66 69 74 20 73 69 6e 63 65 20 74 68 65 20 63 efit since the c
19000 61 63 68 65 0a 20 20 20 20 2a 2a 20 69 73 20 6e ache. ** is n
19010 6f 72 6d 61 6c 6c 79 20 63 6c 65 61 6e 65 64 20 ormally cleaned
19020 62 79 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 by sqlite3Pcache
19030 43 6c 65 61 6e 41 6c 6c 28 29 20 61 66 74 65 72 CleanAll() after
19040 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 73 6f rollback and so
19050 0a 20 20 20 20 2a 2a 20 68 61 73 20 62 65 65 6e . ** has been
19060 20 72 65 6d 6f 76 65 64 2e 20 2a 2f 0a 20 20 20 removed. */.
19070 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 pager_set_pageh
19080 61 73 68 28 70 50 67 29 3b 0a 0a 20 20 20 20 2f ash(pPg);.. /
19090 2a 20 49 66 20 74 68 69 73 20 77 61 73 20 70 61 * If this was pa
190a0 67 65 20 31 2c 20 74 68 65 6e 20 72 65 73 74 6f ge 1, then resto
190b0 72 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 re the value of
190c0 50 61 67 65 72 2e 64 62 46 69 6c 65 56 65 72 73 Pager.dbFileVers
190d0 2e 0a 20 20 20 20 2a 2a 20 44 6f 20 74 68 69 73 .. ** Do this
190e0 20 62 65 66 6f 72 65 20 61 6e 79 20 64 65 63 6f before any deco
190f0 64 69 6e 67 2e 20 2a 2f 0a 20 20 20 20 69 66 28 ding. */. if(
19100 20 70 67 6e 6f 3d 3d 31 20 29 7b 0a 20 20 20 20 pgno==1 ){.
19110 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 memcpy(&pPager
19120 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 26 28 ->dbFileVers, &(
19130 28 75 38 2a 29 70 44 61 74 61 29 5b 32 34 5d 2c (u8*)pData)[24],
19140 73 69 7a 65 6f 66 28 70 50 61 67 65 72 2d 3e 64 sizeof(pPager->d
19150 62 46 69 6c 65 56 65 72 73 29 29 3b 0a 20 20 20 bFileVers));.
19160 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 65 63 6f 64 }.. /* Decod
19170 65 20 74 68 65 20 70 61 67 65 20 6a 75 73 74 20 e the page just
19180 72 65 61 64 20 66 72 6f 6d 20 64 69 73 6b 20 2a read from disk *
19190 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 48 41 53 /.#if SQLITE_HAS
191a0 5f 43 4f 44 45 43 0a 20 20 20 20 69 66 28 20 6a _CODEC. if( j
191b0 72 6e 6c 45 6e 63 20 29 7b 20 43 4f 44 45 43 31 rnlEnc ){ CODEC1
191c0 28 70 50 61 67 65 72 2c 20 70 44 61 74 61 2c 20 (pPager, pData,
191d0 70 50 67 2d 3e 70 67 6e 6f 2c 20 33 2c 20 72 63 pPg->pgno, 3, rc
191e0 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b =SQLITE_NOMEM_BK
191f0 50 54 29 3b 20 7d 0a 23 65 6e 64 69 66 0a 20 20 PT); }.#endif.
19200 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 sqlite3PcacheR
19210 65 6c 65 61 73 65 28 70 50 67 29 3b 0a 20 20 7d elease(pPg);. }
19220 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
19230 0a 2f 2a 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 ./*.** Parameter
19240 20 7a 4d 61 73 74 65 72 20 69 73 20 74 68 65 20 zMaster is the
19250 6e 61 6d 65 20 6f 66 20 61 20 6d 61 73 74 65 72 name of a master
19260 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 41 journal file. A
19270 20 73 69 6e 67 6c 65 20 6a 6f 75 72 6e 61 6c 0a single journal.
19280 2a 2a 20 66 69 6c 65 20 74 68 61 74 20 72 65 66 ** file that ref
19290 65 72 72 65 64 20 74 6f 20 74 68 65 20 6d 61 73 erred to the mas
192a0 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ter journal file
192b0 20 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 72 has just been r
192c0 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 2a 2a 20 54 olled back..** T
192d0 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68 65 63 his routine chec
192e0 6b 73 20 69 66 20 69 74 20 69 73 20 70 6f 73 73 ks if it is poss
192f0 69 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 20 74 ible to delete t
19300 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 he master journa
19310 6c 20 66 69 6c 65 2c 0a 2a 2a 20 61 6e 64 20 64 l file,.** and d
19320 6f 65 73 20 73 6f 20 69 66 20 69 74 20 69 73 2e oes so if it is.
19330 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 .**.** Argument
19340 7a 4d 61 73 74 65 72 20 6d 61 79 20 70 6f 69 6e zMaster may poin
19350 74 20 74 6f 20 50 61 67 65 72 2e 70 54 6d 70 53 t to Pager.pTmpS
19360 70 61 63 65 2e 20 53 6f 20 74 68 61 74 20 62 75 pace. So that bu
19370 66 66 65 72 20 69 73 20 6e 6f 74 20 0a 2a 2a 20 ffer is not .**
19380 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 75 73 available for us
19390 65 20 77 69 74 68 69 6e 20 74 68 69 73 20 66 75 e within this fu
193a0 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 57 68 nction..**.** Wh
193b0 65 6e 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 en a master jour
193c0 6e 61 6c 20 66 69 6c 65 20 69 73 20 63 72 65 61 nal file is crea
193d0 74 65 64 2c 20 69 74 20 69 73 20 70 6f 70 75 6c ted, it is popul
193e0 61 74 65 64 20 77 69 74 68 20 74 68 65 20 6e 61 ated with the na
193f0 6d 65 73 20 0a 2a 2a 20 6f 66 20 61 6c 6c 20 6f mes .** of all o
19400 66 20 69 74 73 20 63 68 69 6c 64 20 6a 6f 75 72 f its child jour
19410 6e 61 6c 73 2c 20 6f 6e 65 20 61 66 74 65 72 20 nals, one after
19420 61 6e 6f 74 68 65 72 2c 20 66 6f 72 6d 61 74 74 another, formatt
19430 65 64 20 61 73 20 75 74 66 2d 38 20 0a 2a 2a 20 ed as utf-8 .**
19440 65 6e 63 6f 64 65 64 20 74 65 78 74 2e 20 54 68 encoded text. Th
19450 65 20 65 6e 64 20 6f 66 20 65 61 63 68 20 63 68 e end of each ch
19460 69 6c 64 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ild journal file
19470 20 69 73 20 6d 61 72 6b 65 64 20 77 69 74 68 20 is marked with
19480 61 20 0a 2a 2a 20 6e 75 6c 2d 74 65 72 6d 69 6e a .** nul-termin
19490 61 74 6f 72 20 62 79 74 65 20 28 30 78 30 30 29 ator byte (0x00)
194a0 2e 20 69 2e 65 2e 20 74 68 65 20 65 6e 74 69 72 . i.e. the entir
194b0 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 61 20 e contents of a
194c0 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 0a 2a master journal.*
194d0 2a 20 66 69 6c 65 20 66 6f 72 20 61 20 74 72 61 * file for a tra
194e0 6e 73 61 63 74 69 6f 6e 20 69 6e 76 6f 6c 76 69 nsaction involvi
194f0 6e 67 20 74 77 6f 20 64 61 74 61 62 61 73 65 73 ng two databases
19500 20 6d 69 67 68 74 20 62 65 3a 0a 2a 2a 0a 2a 2a might be:.**.**
19510 20 20 20 22 2f 68 6f 6d 65 2f 62 69 6c 6c 2f 61 "/home/bill/a
19520 2e 64 62 2d 6a 6f 75 72 6e 61 6c 5c 78 30 30 2f .db-journal\x00/
19530 68 6f 6d 65 2f 62 69 6c 6c 2f 62 2e 64 62 2d 6a home/bill/b.db-j
19540 6f 75 72 6e 61 6c 5c 78 30 30 22 0a 2a 2a 0a 2a ournal\x00".**.*
19550 2a 20 41 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e * A master journ
19560 61 6c 20 66 69 6c 65 20 6d 61 79 20 6f 6e 6c 79 al file may only
19570 20 62 65 20 64 65 6c 65 74 65 64 20 6f 6e 63 65 be deleted once
19580 20 61 6c 6c 20 6f 66 20 69 74 73 20 63 68 69 6c all of its chil
19590 64 20 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 73 20 68 d .** journals h
195a0 61 76 65 20 62 65 65 6e 20 72 6f 6c 6c 65 64 20 ave been rolled
195b0 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 back..**.** This
195c0 20 66 75 6e 63 74 69 6f 6e 20 72 65 61 64 73 20 function reads
195d0 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
195e0 74 68 65 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e the master-journ
195f0 61 6c 20 66 69 6c 65 20 69 6e 74 6f 20 0a 2a 2a al file into .**
19600 20 6d 65 6d 6f 72 79 20 61 6e 64 20 6c 6f 6f 70 memory and loop
19610 73 20 74 68 72 6f 75 67 68 20 65 61 63 68 20 6f s through each o
19620 66 20 74 68 65 20 63 68 69 6c 64 20 6a 6f 75 72 f the child jour
19630 6e 61 6c 20 6e 61 6d 65 73 2e 20 46 6f 72 0a 2a nal names. For.*
19640 2a 20 65 61 63 68 20 63 68 69 6c 64 20 6a 6f 75 * each child jou
19650 72 6e 61 6c 2c 20 69 74 20 63 68 65 63 6b 73 20 rnal, it checks
19660 69 66 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 69 66 if:.**.** * if
19670 20 74 68 65 20 63 68 69 6c 64 20 6a 6f 75 72 6e the child journ
19680 61 6c 20 65 78 69 73 74 73 2c 20 61 6e 64 20 69 al exists, and i
19690 66 20 73 6f 0a 2a 2a 20 20 20 2a 20 69 66 20 74 f so.** * if t
196a0 68 65 20 63 68 69 6c 64 20 6a 6f 75 72 6e 61 6c he child journal
196b0 20 63 6f 6e 74 61 69 6e 73 20 61 20 72 65 66 65 contains a refe
196c0 72 65 6e 63 65 20 74 6f 20 6d 61 73 74 65 72 20 rence to master
196d0 6a 6f 75 72 6e 61 6c 20 0a 2a 2a 20 20 20 20 20 journal .**
196e0 66 69 6c 65 20 7a 4d 61 73 74 65 72 0a 2a 2a 0a file zMaster.**.
196f0 2a 2a 20 49 66 20 61 20 63 68 69 6c 64 20 6a 6f ** If a child jo
19700 75 72 6e 61 6c 20 63 61 6e 20 62 65 20 66 6f 75 urnal can be fou
19710 6e 64 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 nd that matches
19720 62 6f 74 68 20 6f 66 20 74 68 65 20 63 72 69 74 both of the crit
19730 65 72 69 61 0a 2a 2a 20 61 62 6f 76 65 2c 20 74 eria.** above, t
19740 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 his function ret
19750 75 72 6e 73 20 77 69 74 68 6f 75 74 20 64 6f 69 urns without doi
19760 6e 67 20 61 6e 79 74 68 69 6e 67 2e 20 4f 74 68 ng anything. Oth
19770 65 72 77 69 73 65 2c 20 69 66 0a 2a 2a 20 6e 6f erwise, if.** no
19780 20 73 75 63 68 20 63 68 69 6c 64 20 6a 6f 75 72 such child jour
19790 6e 61 6c 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 nal can be found
197a0 2c 20 66 69 6c 65 20 7a 4d 61 73 74 65 72 20 69 , file zMaster i
197b0 73 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 0a 2a s deleted from.*
197c0 2a 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 * the file-syste
197d0 6d 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 4f m using sqlite3O
197e0 73 44 65 6c 65 74 65 28 29 2e 0a 2a 2a 0a 2a 2a sDelete()..**.**
197f0 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 If an IO error
19800 77 69 74 68 69 6e 20 74 68 69 73 20 66 75 6e 63 within this func
19810 74 69 6f 6e 2c 20 61 6e 20 65 72 72 6f 72 20 63 tion, an error c
19820 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e ode is returned.
19830 20 54 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f This.** functio
19840 6e 20 61 6c 6c 6f 63 61 74 65 73 20 6d 65 6d 6f n allocates memo
19850 72 79 20 62 79 20 63 61 6c 6c 69 6e 67 20 73 71 ry by calling sq
19860 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 2e 20 49 lite3Malloc(). I
19870 66 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a f an allocation.
19880 2a 2a 20 66 61 69 6c 73 2c 20 53 51 4c 49 54 45 ** fails, SQLITE
19890 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 74 75 72 6e _NOMEM is return
198a0 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 ed. Otherwise, i
198b0 66 20 6e 6f 20 49 4f 20 6f 72 20 6d 61 6c 6c 6f f no IO or mallo
198c0 63 20 65 72 72 6f 72 73 20 0a 2a 2a 20 6f 63 63 c errors .** occ
198d0 75 72 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 ur, SQLITE_OK is
198e0 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a returned..**.**
198f0 20 54 4f 44 4f 3a 20 54 68 69 73 20 66 75 6e 63 TODO: This func
19900 74 69 6f 6e 20 61 6c 6c 6f 63 61 74 65 73 20 61 tion allocates a
19910 20 73 69 6e 67 6c 65 20 62 6c 6f 63 6b 20 6f 66 single block of
19920 20 6d 65 6d 6f 72 79 20 74 6f 20 6c 6f 61 64 0a memory to load.
19930 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f ** the entire co
19940 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 20 6d 61 ntents of the ma
19950 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
19960 65 2e 20 54 68 69 73 20 63 6f 75 6c 64 20 62 65 e. This could be
19970 0a 2a 2a 20 61 20 63 6f 75 70 6c 65 20 6f 66 20 .** a couple of
19980 6b 69 6c 6f 62 79 74 65 73 20 6f 72 20 73 6f 20 kilobytes or so
19990 2d 20 70 6f 74 65 6e 74 69 61 6c 6c 79 20 6c 61 - potentially la
199a0 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 70 61 rger than the pa
199b0 67 65 20 0a 2a 2a 20 73 69 7a 65 2e 0a 2a 2f 0a ge .** size..*/.
199c0 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
199d0 5f 64 65 6c 6d 61 73 74 65 72 28 50 61 67 65 72 _delmaster(Pager
199e0 20 2a 70 50 61 67 65 72 2c 20 63 6f 6e 73 74 20 *pPager, const
199f0 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 29 7b 0a char *zMaster){.
19a00 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 sqlite3_vfs *p
19a10 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e 70 56 Vfs = pPager->pV
19a20 66 73 3b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 fs;. int rc;
19a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19a40 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
19a50 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 /. sqlite3_file
19a60 20 2a 70 4d 61 73 74 65 72 3b 20 20 20 20 2f 2a *pMaster; /*
19a70 20 4d 61 6c 6c 6f 63 27 64 20 6d 61 73 74 65 72 Malloc'd master
19a80 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 64 65 -journal file de
19a90 73 63 72 69 70 74 6f 72 20 2a 2f 0a 20 20 73 71 scriptor */. sq
19aa0 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 4a 6f 75 lite3_file *pJou
19ab0 72 6e 61 6c 3b 20 20 20 2f 2a 20 4d 61 6c 6c 6f rnal; /* Mallo
19ac0 63 27 64 20 63 68 69 6c 64 2d 6a 6f 75 72 6e 61 c'd child-journa
19ad0 6c 20 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f l file descripto
19ae0 72 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4d 61 r */. char *zMa
19af0 73 74 65 72 4a 6f 75 72 6e 61 6c 20 3d 20 30 3b sterJournal = 0;
19b00 20 2f 2a 20 43 6f 6e 74 65 6e 74 73 20 6f 66 20 /* Contents of
19b10 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 master journal f
19b20 69 6c 65 20 2a 2f 0a 20 20 69 36 34 20 6e 4d 61 ile */. i64 nMa
19b30 73 74 65 72 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 sterJournal;
19b40 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6d 61 /* Size of ma
19b50 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
19b60 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4a 6f e */. char *zJo
19b70 75 72 6e 61 6c 3b 20 20 20 20 20 20 20 20 20 20 urnal;
19b80 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6f /* Pointer to o
19b90 6e 65 20 6a 6f 75 72 6e 61 6c 20 77 69 74 68 69 ne journal withi
19ba0 6e 20 4d 4a 20 66 69 6c 65 20 2a 2f 0a 20 20 63 n MJ file */. c
19bb0 68 61 72 20 2a 7a 4d 61 73 74 65 72 50 74 72 3b har *zMasterPtr;
19bc0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 /* Spac
19bd0 65 20 74 6f 20 68 6f 6c 64 20 4d 4a 20 66 69 6c e to hold MJ fil
19be0 65 6e 61 6d 65 20 66 72 6f 6d 20 61 20 6a 6f 75 ename from a jou
19bf0 72 6e 61 6c 20 66 69 6c 65 20 2a 2f 0a 20 20 69 rnal file */. i
19c00 6e 74 20 6e 4d 61 73 74 65 72 50 74 72 3b 20 20 nt nMasterPtr;
19c10 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 /* Amou
19c20 6e 74 20 6f 66 20 73 70 61 63 65 20 61 6c 6c 6f nt of space allo
19c30 63 61 74 65 64 20 74 6f 20 7a 4d 61 73 74 65 72 cated to zMaster
19c40 50 74 72 5b 5d 20 2a 2f 0a 0a 20 20 2f 2a 20 41 Ptr[] */.. /* A
19c50 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 6f llocate space fo
19c60 72 20 62 6f 74 68 20 74 68 65 20 70 4a 6f 75 72 r both the pJour
19c70 6e 61 6c 20 61 6e 64 20 70 4d 61 73 74 65 72 20 nal and pMaster
19c80 66 69 6c 65 20 64 65 73 63 72 69 70 74 6f 72 73 file descriptors
19c90 2e 0a 20 20 2a 2a 20 49 66 20 73 75 63 63 65 73 .. ** If succes
19ca0 73 66 75 6c 2c 20 6f 70 65 6e 20 74 68 65 20 6d sful, open the m
19cb0 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 aster journal fi
19cc0 6c 65 20 66 6f 72 20 72 65 61 64 69 6e 67 2e 0a le for reading..
19cd0 20 20 2a 2f 0a 20 20 70 4d 61 73 74 65 72 20 3d */. pMaster =
19ce0 20 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a (sqlite3_file *
19cf0 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 )sqlite3MallocZe
19d00 72 6f 28 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c ro(pVfs->szOsFil
19d10 65 20 2a 20 32 29 3b 0a 20 20 70 4a 6f 75 72 6e e * 2);. pJourn
19d20 61 6c 20 3d 20 28 73 71 6c 69 74 65 33 5f 66 69 al = (sqlite3_fi
19d30 6c 65 20 2a 29 28 28 28 75 38 20 2a 29 70 4d 61 le *)(((u8 *)pMa
19d40 73 74 65 72 29 20 2b 20 70 56 66 73 2d 3e 73 7a ster) + pVfs->sz
19d50 4f 73 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 21 OsFile);. if( !
19d60 70 4d 61 73 74 65 72 20 29 7b 0a 20 20 20 20 72 pMaster ){. r
19d70 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
19d80 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a _BKPT;. }else{.
19d90 20 20 20 20 63 6f 6e 73 74 20 69 6e 74 20 66 6c const int fl
19da0 61 67 73 20 3d 20 28 53 51 4c 49 54 45 5f 4f 50 ags = (SQLITE_OP
19db0 45 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 EN_READONLY|SQLI
19dc0 54 45 5f 4f 50 45 4e 5f 4d 41 53 54 45 52 5f 4a TE_OPEN_MASTER_J
19dd0 4f 55 52 4e 41 4c 29 3b 0a 20 20 20 20 72 63 20 OURNAL);. rc
19de0 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 = sqlite3OsOpen(
19df0 70 56 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 70 pVfs, zMaster, p
19e00 4d 61 73 74 65 72 2c 20 66 6c 61 67 73 2c 20 30 Master, flags, 0
19e10 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 21 );. }. if( rc!
19e20 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 67 6f 74 =SQLITE_OK ) got
19e30 6f 20 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b o delmaster_out;
19e40 0a 0a 20 20 2f 2a 20 4c 6f 61 64 20 74 68 65 20 .. /* Load the
19e50 65 6e 74 69 72 65 20 6d 61 73 74 65 72 20 6a 6f entire master jo
19e60 75 72 6e 61 6c 20 66 69 6c 65 20 69 6e 74 6f 20 urnal file into
19e70 73 70 61 63 65 20 6f 62 74 61 69 6e 65 64 20 66 space obtained f
19e80 72 6f 6d 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 rom. ** sqlite3
19e90 5f 6d 61 6c 6c 6f 63 28 29 20 61 6e 64 20 70 6f _malloc() and po
19ea0 69 6e 74 65 64 20 74 6f 20 62 79 20 7a 4d 61 73 inted to by zMas
19eb0 74 65 72 4a 6f 75 72 6e 61 6c 2e 20 20 20 41 6c terJournal. Al
19ec0 73 6f 20 6f 62 74 61 69 6e 0a 20 20 2a 2a 20 73 so obtain. ** s
19ed0 75 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 20 ufficient space
19ee0 28 69 6e 20 7a 4d 61 73 74 65 72 50 74 72 29 20 (in zMasterPtr)
19ef0 74 6f 20 68 6f 6c 64 20 74 68 65 20 6e 61 6d 65 to hold the name
19f00 73 20 6f 66 20 6d 61 73 74 65 72 0a 20 20 2a 2a s of master. **
19f10 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 65 journal files e
19f20 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 72 65 xtracted from re
19f30 67 75 6c 61 72 20 72 6f 6c 6c 62 61 63 6b 2d 6a gular rollback-j
19f40 6f 75 72 6e 61 6c 73 2e 0a 20 20 2a 2f 0a 20 20 ournals.. */.
19f50 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 rc = sqlite3OsFi
19f60 6c 65 53 69 7a 65 28 70 4d 61 73 74 65 72 2c 20 leSize(pMaster,
19f70 26 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 29 &nMasterJournal)
19f80 3b 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 ;. if( rc!=SQLI
19f90 54 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 64 65 6c TE_OK ) goto del
19fa0 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 6e 4d master_out;. nM
19fb0 61 73 74 65 72 50 74 72 20 3d 20 70 56 66 73 2d asterPtr = pVfs-
19fc0 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 3b 0a 20 >mxPathname+1;.
19fd0 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 20 zMasterJournal
19fe0 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 = sqlite3Malloc(
19ff0 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c 20 2b nMasterJournal +
1a000 20 6e 4d 61 73 74 65 72 50 74 72 20 2b 20 31 29 nMasterPtr + 1)
1a010 3b 0a 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 ;. if( !zMaster
1a020 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 72 Journal ){. r
1a030 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d c = SQLITE_NOMEM
1a040 5f 42 4b 50 54 3b 0a 20 20 20 20 67 6f 74 6f 20 _BKPT;. goto
1a050 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 delmaster_out;.
1a060 20 7d 0a 20 20 7a 4d 61 73 74 65 72 50 74 72 20 }. zMasterPtr
1a070 3d 20 26 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 = &zMasterJourna
1a080 6c 5b 6e 4d 61 73 74 65 72 4a 6f 75 72 6e 61 6c l[nMasterJournal
1a090 2b 31 5d 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 +1];. rc = sqli
1a0a0 74 65 33 4f 73 52 65 61 64 28 70 4d 61 73 74 65 te3OsRead(pMaste
1a0b0 72 2c 20 7a 4d 61 73 74 65 72 4a 6f 75 72 6e 61 r, zMasterJourna
1a0c0 6c 2c 20 28 69 6e 74 29 6e 4d 61 73 74 65 72 4a l, (int)nMasterJ
1a0d0 6f 75 72 6e 61 6c 2c 20 30 29 3b 0a 20 20 69 66 ournal, 0);. if
1a0e0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1a0f0 29 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 72 ) goto delmaster
1a100 5f 6f 75 74 3b 0a 20 20 7a 4d 61 73 74 65 72 4a _out;. zMasterJ
1a110 6f 75 72 6e 61 6c 5b 6e 4d 61 73 74 65 72 4a 6f ournal[nMasterJo
1a120 75 72 6e 61 6c 5d 20 3d 20 30 3b 0a 0a 20 20 7a urnal] = 0;.. z
1a130 4a 6f 75 72 6e 61 6c 20 3d 20 7a 4d 61 73 74 65 Journal = zMaste
1a140 72 4a 6f 75 72 6e 61 6c 3b 0a 20 20 77 68 69 6c rJournal;. whil
1a150 65 28 20 28 7a 4a 6f 75 72 6e 61 6c 2d 7a 4d 61 e( (zJournal-zMa
1a160 73 74 65 72 4a 6f 75 72 6e 61 6c 29 3c 6e 4d 61 sterJournal)<nMa
1a170 73 74 65 72 4a 6f 75 72 6e 61 6c 20 29 7b 0a 20 sterJournal ){.
1a180 20 20 20 69 6e 74 20 65 78 69 73 74 73 3b 0a 20 int exists;.
1a190 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
1a1a0 73 41 63 63 65 73 73 28 70 56 66 73 2c 20 7a 4a sAccess(pVfs, zJ
1a1b0 6f 75 72 6e 61 6c 2c 20 53 51 4c 49 54 45 5f 41 ournal, SQLITE_A
1a1c0 43 43 45 53 53 5f 45 58 49 53 54 53 2c 20 26 65 CCESS_EXISTS, &e
1a1d0 78 69 73 74 73 29 3b 0a 20 20 20 20 69 66 28 20 xists);. if(
1a1e0 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc!=SQLITE_OK ){
1a1f0 0a 20 20 20 20 20 20 67 6f 74 6f 20 64 65 6c 6d . goto delm
1a200 61 73 74 65 72 5f 6f 75 74 3b 0a 20 20 20 20 7d aster_out;. }
1a210 0a 20 20 20 20 69 66 28 20 65 78 69 73 74 73 20 . if( exists
1a220 29 7b 0a 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 ){. /* One
1a230 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 73 20 of the journals
1a240 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 20 74 68 pointed to by th
1a250 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c e master journal
1a260 20 65 78 69 73 74 73 2e 0a 20 20 20 20 20 20 2a exists.. *
1a270 2a 20 4f 70 65 6e 20 69 74 20 61 6e 64 20 63 68 * Open it and ch
1a280 65 63 6b 20 69 66 20 69 74 20 70 6f 69 6e 74 73 eck if it points
1a290 20 61 74 20 74 68 65 20 6d 61 73 74 65 72 20 6a at the master j
1a2a0 6f 75 72 6e 61 6c 2e 20 49 66 0a 20 20 20 20 20 ournal. If.
1a2b0 20 2a 2a 20 73 6f 2c 20 72 65 74 75 72 6e 20 77 ** so, return w
1a2c0 69 74 68 6f 75 74 20 64 65 6c 65 74 69 6e 67 20 ithout deleting
1a2d0 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e the master journ
1a2e0 61 6c 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 2a al file.. *
1a2f0 2f 0a 20 20 20 20 20 20 69 6e 74 20 63 3b 0a 20 /. int c;.
1a300 20 20 20 20 20 69 6e 74 20 66 6c 61 67 73 20 3d int flags =
1a310 20 28 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 (SQLITE_OPEN_RE
1a320 41 44 4f 4e 4c 59 7c 53 51 4c 49 54 45 5f 4f 50 ADONLY|SQLITE_OP
1a330 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 29 EN_MAIN_JOURNAL)
1a340 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c ;. rc = sql
1a350 69 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c ite3OsOpen(pVfs,
1a360 20 7a 4a 6f 75 72 6e 61 6c 2c 20 70 4a 6f 75 72 zJournal, pJour
1a370 6e 61 6c 2c 20 66 6c 61 67 73 2c 20 30 29 3b 0a nal, flags, 0);.
1a380 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
1a390 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1a3a0 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 goto delmaste
1a3b0 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a 0a r_out;. }..
1a3c0 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 64 4d rc = readM
1a3d0 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 70 4a 6f asterJournal(pJo
1a3e0 75 72 6e 61 6c 2c 20 7a 4d 61 73 74 65 72 50 74 urnal, zMasterPt
1a3f0 72 2c 20 6e 4d 61 73 74 65 72 50 74 72 29 3b 0a r, nMasterPtr);.
1a400 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 sqlite3OsC
1a410 6c 6f 73 65 28 70 4a 6f 75 72 6e 61 6c 29 3b 0a lose(pJournal);.
1a420 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
1a430 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
1a440 20 20 20 67 6f 74 6f 20 64 65 6c 6d 61 73 74 65 goto delmaste
1a450 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d 0a 0a r_out;. }..
1a460 20 20 20 20 20 20 63 20 3d 20 7a 4d 61 73 74 65 c = zMaste
1a470 72 50 74 72 5b 30 5d 21 3d 30 20 26 26 20 73 74 rPtr[0]!=0 && st
1a480 72 63 6d 70 28 7a 4d 61 73 74 65 72 50 74 72 2c rcmp(zMasterPtr,
1a490 20 7a 4d 61 73 74 65 72 29 3d 3d 30 3b 0a 20 20 zMaster)==0;.
1a4a0 20 20 20 20 69 66 28 20 63 20 29 7b 0a 20 20 20 if( c ){.
1a4b0 20 20 20 20 20 2f 2a 20 57 65 20 68 61 76 65 20 /* We have
1a4c0 61 20 6d 61 74 63 68 2e 20 44 6f 20 6e 6f 74 20 a match. Do not
1a4d0 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 delete the maste
1a4e0 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 r journal file.
1a4f0 2a 2f 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 */. goto
1a500 64 65 6c 6d 61 73 74 65 72 5f 6f 75 74 3b 0a 20 delmaster_out;.
1a510 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
1a520 20 7a 4a 6f 75 72 6e 61 6c 20 2b 3d 20 28 73 71 zJournal += (sq
1a530 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 4a lite3Strlen30(zJ
1a540 6f 75 72 6e 61 6c 29 2b 31 29 3b 0a 20 20 7d 0a ournal)+1);. }.
1a550 20 0a 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f . sqlite3OsClo
1a560 73 65 28 70 4d 61 73 74 65 72 29 3b 0a 20 20 72 se(pMaster);. r
1a570 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65 6c c = sqlite3OsDel
1a580 65 74 65 28 70 56 66 73 2c 20 7a 4d 61 73 74 65 ete(pVfs, zMaste
1a590 72 2c 20 30 29 3b 0a 0a 64 65 6c 6d 61 73 74 65 r, 0);..delmaste
1a5a0 72 5f 6f 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 r_out:. sqlite3
1a5b0 5f 66 72 65 65 28 7a 4d 61 73 74 65 72 4a 6f 75 _free(zMasterJou
1a5c0 72 6e 61 6c 29 3b 0a 20 20 69 66 28 20 70 4d 61 rnal);. if( pMa
1a5d0 73 74 65 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 ster ){. sqli
1a5e0 74 65 33 4f 73 43 6c 6f 73 65 28 70 4d 61 73 74 te3OsClose(pMast
1a5f0 65 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 er);. assert(
1a600 20 21 69 73 4f 70 65 6e 28 70 4a 6f 75 72 6e 61 !isOpen(pJourna
1a610 6c 29 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 l) );. sqlite
1a620 33 5f 66 72 65 65 28 70 4d 61 73 74 65 72 29 3b 3_free(pMaster);
1a630 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
1a640 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ;.}.../*.** This
1a650 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65 function is use
1a660 64 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 d to change the
1a670 61 63 74 75 61 6c 20 73 69 7a 65 20 6f 66 20 74 actual size of t
1a680 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 he database .**
1a690 66 69 6c 65 20 69 6e 20 74 68 65 20 66 69 6c 65 file in the file
1a6a0 2d 73 79 73 74 65 6d 2e 20 54 68 69 73 20 6f 6e -system. This on
1a6b0 6c 79 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20 ly happens when
1a6c0 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 74 72 61 committing a tra
1a6d0 6e 73 61 63 74 69 6f 6e 2c 0a 2a 2a 20 6f 72 20 nsaction,.** or
1a6e0 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 74 rolling back a t
1a6f0 72 61 6e 73 61 63 74 69 6f 6e 20 28 69 6e 63 6c ransaction (incl
1a700 75 64 69 6e 67 20 72 6f 6c 6c 69 6e 67 20 62 61 uding rolling ba
1a710 63 6b 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c ck a hot-journal
1a720 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 )..**.** If the
1a730 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 main database fi
1a740 6c 65 20 69 73 20 6e 6f 74 20 6f 70 65 6e 2c 20 le is not open,
1a750 6f 72 20 74 68 65 20 70 61 67 65 72 20 69 73 20 or the pager is
1a760 6e 6f 74 20 69 6e 20 65 69 74 68 65 72 0a 2a 2a not in either.**
1a770 20 44 42 4d 4f 44 20 6f 72 20 4f 50 45 4e 20 73 DBMOD or OPEN s
1a780 74 61 74 65 2c 20 74 68 69 73 20 66 75 6e 63 74 tate, this funct
1a790 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20 ion is a no-op.
1a7a0 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 73 Otherwise, the s
1a7b0 69 7a 65 20 0a 2a 2a 20 6f 66 20 74 68 65 20 66 ize .** of the f
1a7c0 69 6c 65 20 69 73 20 63 68 61 6e 67 65 64 20 74 ile is changed t
1a7d0 6f 20 6e 50 61 67 65 20 70 61 67 65 73 20 28 6e o nPage pages (n
1a7e0 50 61 67 65 2a 70 50 61 67 65 72 2d 3e 70 61 67 Page*pPager->pag
1a7f0 65 53 69 7a 65 20 62 79 74 65 73 29 2e 20 0a 2a eSize bytes). .*
1a800 2a 20 49 66 20 74 68 65 20 66 69 6c 65 20 6f 6e * If the file on
1a810 20 64 69 73 6b 20 69 73 20 63 75 72 72 65 6e 74 disk is current
1a820 6c 79 20 6c 61 72 67 65 72 20 74 68 61 6e 20 6e ly larger than n
1a830 50 61 67 65 20 70 61 67 65 73 2c 20 74 68 65 6e Page pages, then
1a840 20 75 73 65 20 74 68 65 20 56 46 53 0a 2a 2a 20 use the VFS.**
1a850 78 54 72 75 6e 63 61 74 65 28 29 20 6d 65 74 68 xTruncate() meth
1a860 6f 64 20 74 6f 20 74 72 75 6e 63 61 74 65 20 69 od to truncate i
1a870 74 2e 0a 2a 2a 0a 2a 2a 20 4f 72 2c 20 69 74 20 t..**.** Or, it
1a880 6d 69 67 68 74 20 62 65 20 74 68 65 20 63 61 73 might be the cas
1a890 65 20 74 68 61 74 20 74 68 65 20 66 69 6c 65 20 e that the file
1a8a0 6f 6e 20 64 69 73 6b 20 69 73 20 73 6d 61 6c 6c on disk is small
1a8b0 65 72 20 74 68 61 6e 20 0a 2a 2a 20 6e 50 61 67 er than .** nPag
1a8c0 65 20 70 61 67 65 73 2e 20 53 6f 6d 65 20 6f 70 e pages. Some op
1a8d0 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69 erating system i
1a8e0 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 63 mplementations c
1a8f0 61 6e 20 67 65 74 20 63 6f 6e 66 75 73 65 64 20 an get confused
1a900 69 66 20 0a 2a 2a 20 79 6f 75 20 74 72 79 20 74 if .** you try t
1a910 6f 20 74 72 75 6e 63 61 74 65 20 61 20 66 69 6c o truncate a fil
1a920 65 20 74 6f 20 73 6f 6d 65 20 73 69 7a 65 20 74 e to some size t
1a930 68 61 74 20 69 73 20 6c 61 72 67 65 72 20 74 68 hat is larger th
1a940 61 6e 20 69 74 20 0a 2a 2a 20 63 75 72 72 65 6e an it .** curren
1a950 74 6c 79 20 69 73 2c 20 73 6f 20 64 65 74 65 63 tly is, so detec
1a960 74 20 74 68 69 73 20 63 61 73 65 20 61 6e 64 20 t this case and
1a970 77 72 69 74 65 20 61 20 73 69 6e 67 6c 65 20 7a write a single z
1a980 65 72 6f 20 62 79 74 65 20 74 6f 20 0a 2a 2a 20 ero byte to .**
1a990 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6e the end of the n
1a9a0 65 77 20 66 69 6c 65 20 69 6e 73 74 65 61 64 2e ew file instead.
1a9b0 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 .**.** If succes
1a9c0 73 66 75 6c 2c 20 72 65 74 75 72 6e 20 53 51 4c sful, return SQL
1a9d0 49 54 45 5f 4f 4b 2e 20 49 66 20 61 6e 20 49 4f ITE_OK. If an IO
1a9e0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 error occurs wh
1a9f0 69 6c 65 20 6d 6f 64 69 66 79 69 6e 67 0a 2a 2a ile modifying.**
1aa00 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
1aa10 6c 65 2c 20 72 65 74 75 72 6e 20 74 68 65 20 65 le, return the e
1aa20 72 72 6f 72 20 63 6f 64 65 20 74 6f 20 74 68 65 rror code to the
1aa30 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 73 74 61 74 caller..*/.stat
1aa40 69 63 20 69 6e 74 20 70 61 67 65 72 5f 74 72 75 ic int pager_tru
1aa50 6e 63 61 74 65 28 50 61 67 65 72 20 2a 70 50 61 ncate(Pager *pPa
1aa60 67 65 72 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 ger, Pgno nPage)
1aa70 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c {. int rc = SQL
1aa80 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 ITE_OK;. assert
1aa90 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
1aaa0 21 3d 50 41 47 45 52 5f 45 52 52 4f 52 20 29 3b !=PAGER_ERROR );
1aab0 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
1aac0 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 r->eState!=PAGER
1aad0 5f 52 45 41 44 45 52 20 29 3b 0a 20 20 0a 20 20 _READER );. .
1aae0 69 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 if( isOpen(pPage
1aaf0 72 2d 3e 66 64 29 20 0a 20 20 20 26 26 20 28 70 r->fd) . && (p
1ab00 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 Pager->eState>=P
1ab10 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
1ab20 44 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 D || pPager->eSt
1ab30 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 29 ate==PAGER_OPEN)
1ab40 20 0a 20 20 29 7b 0a 20 20 20 20 69 36 34 20 63 . ){. i64 c
1ab50 75 72 72 65 6e 74 53 69 7a 65 2c 20 6e 65 77 53 urrentSize, newS
1ab60 69 7a 65 3b 0a 20 20 20 20 69 6e 74 20 73 7a 50 ize;. int szP
1ab70 61 67 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 age = pPager->pa
1ab80 67 65 53 69 7a 65 3b 0a 20 20 20 20 61 73 73 65 geSize;. asse
1ab90 72 74 28 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 rt( pPager->eLoc
1aba0 6b 3d 3d 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 k==EXCLUSIVE_LOC
1abb0 4b 20 29 3b 0a 20 20 20 20 2f 2a 20 54 4f 44 4f K );. /* TODO
1abc0 3a 20 49 73 20 69 74 20 73 61 66 65 20 74 6f 20 : Is it safe to
1abd0 75 73 65 20 50 61 67 65 72 2e 64 62 46 69 6c 65 use Pager.dbFile
1abe0 53 69 7a 65 20 68 65 72 65 3f 20 2a 2f 0a 20 20 Size here? */.
1abf0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
1ac00 46 69 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d FileSize(pPager-
1ac10 3e 66 64 2c 20 26 63 75 72 72 65 6e 74 53 69 7a >fd, ¤tSiz
1ac20 65 29 3b 0a 20 20 20 20 6e 65 77 53 69 7a 65 20 e);. newSize
1ac30 3d 20 73 7a 50 61 67 65 2a 28 69 36 34 29 6e 50 = szPage*(i64)nP
1ac40 61 67 65 3b 0a 20 20 20 20 69 66 28 20 72 63 3d age;. if( rc=
1ac50 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 63 75 =SQLITE_OK && cu
1ac60 72 72 65 6e 74 53 69 7a 65 21 3d 6e 65 77 53 69 rrentSize!=newSi
1ac70 7a 65 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 ze ){. if(
1ac80 63 75 72 72 65 6e 74 53 69 7a 65 3e 6e 65 77 53 currentSize>newS
1ac90 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 72 ize ){. r
1aca0 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 54 72 75 c = sqlite3OsTru
1acb0 6e 63 61 74 65 28 70 50 61 67 65 72 2d 3e 66 64 ncate(pPager->fd
1acc0 2c 20 6e 65 77 53 69 7a 65 29 3b 0a 20 20 20 20 , newSize);.
1acd0 20 20 7d 65 6c 73 65 20 69 66 28 20 28 63 75 72 }else if( (cur
1ace0 72 65 6e 74 53 69 7a 65 2b 73 7a 50 61 67 65 29 rentSize+szPage)
1acf0 3c 3d 6e 65 77 53 69 7a 65 20 29 7b 0a 20 20 20 <=newSize ){.
1ad00 20 20 20 20 20 63 68 61 72 20 2a 70 54 6d 70 20 char *pTmp
1ad10 3d 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 = pPager->pTmpSp
1ad20 61 63 65 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d ace;. mem
1ad30 73 65 74 28 70 54 6d 70 2c 20 30 2c 20 73 7a 50 set(pTmp, 0, szP
1ad40 61 67 65 29 3b 0a 20 20 20 20 20 20 20 20 74 65 age);. te
1ad50 73 74 63 61 73 65 28 20 28 6e 65 77 53 69 7a 65 stcase( (newSize
1ad60 2d 73 7a 50 61 67 65 29 20 3d 3d 20 63 75 72 72 -szPage) == curr
1ad70 65 6e 74 53 69 7a 65 20 29 3b 0a 20 20 20 20 20 entSize );.
1ad80 20 20 20 74 65 73 74 63 61 73 65 28 20 28 6e 65 testcase( (ne
1ad90 77 53 69 7a 65 2d 73 7a 50 61 67 65 29 20 3e 20 wSize-szPage) >
1ada0 20 63 75 72 72 65 6e 74 53 69 7a 65 20 29 3b 0a currentSize );.
1adb0 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
1adc0 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 ite3OsWrite(pPag
1add0 65 72 2d 3e 66 64 2c 20 70 54 6d 70 2c 20 73 7a er->fd, pTmp, sz
1ade0 50 61 67 65 2c 20 6e 65 77 53 69 7a 65 2d 73 7a Page, newSize-sz
1adf0 50 61 67 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 Page);. }.
1ae00 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
1ae10 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
1ae20 20 20 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 pPager->dbFile
1ae30 53 69 7a 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 Size = nPage;.
1ae40 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
1ae50 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1ae60 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 73 /*.** Return a s
1ae70 61 6e 69 74 69 7a 65 64 20 76 65 72 73 69 6f 6e anitized version
1ae80 20 6f 66 20 74 68 65 20 73 65 63 74 6f 72 2d 73 of the sector-s
1ae90 69 7a 65 20 6f 66 20 4f 53 20 66 69 6c 65 20 70 ize of OS file p
1aea0 46 69 6c 65 2e 20 54 68 65 0a 2a 2a 20 72 65 74 File. The.** ret
1aeb0 75 72 6e 20 76 61 6c 75 65 20 69 73 20 67 75 61 urn value is gua
1aec0 72 61 6e 74 65 65 64 20 74 6f 20 6c 69 65 20 62 ranteed to lie b
1aed0 65 74 77 65 65 6e 20 33 32 20 61 6e 64 20 4d 41 etween 32 and MA
1aee0 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 2e 0a 2a X_SECTOR_SIZE..*
1aef0 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 63 /.int sqlite3Sec
1af00 74 6f 72 53 69 7a 65 28 73 71 6c 69 74 65 33 5f torSize(sqlite3_
1af10 66 69 6c 65 20 2a 70 46 69 6c 65 29 7b 0a 20 20 file *pFile){.
1af20 69 6e 74 20 69 52 65 74 20 3d 20 73 71 6c 69 74 int iRet = sqlit
1af30 65 33 4f 73 53 65 63 74 6f 72 53 69 7a 65 28 70 e3OsSectorSize(p
1af40 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 69 52 65 File);. if( iRe
1af50 74 3c 33 32 20 29 7b 0a 20 20 20 20 69 52 65 74 t<32 ){. iRet
1af60 20 3d 20 35 31 32 3b 0a 20 20 7d 65 6c 73 65 20 = 512;. }else
1af70 69 66 28 20 69 52 65 74 3e 4d 41 58 5f 53 45 43 if( iRet>MAX_SEC
1af80 54 4f 52 5f 53 49 5a 45 20 29 7b 0a 20 20 20 20 TOR_SIZE ){.
1af90 61 73 73 65 72 74 28 20 4d 41 58 5f 53 45 43 54 assert( MAX_SECT
1afa0 4f 52 5f 53 49 5a 45 3e 3d 35 31 32 20 29 3b 0a OR_SIZE>=512 );.
1afb0 20 20 20 20 69 52 65 74 20 3d 20 4d 41 58 5f 53 iRet = MAX_S
1afc0 45 43 54 4f 52 5f 53 49 5a 45 3b 0a 20 20 7d 0a ECTOR_SIZE;. }.
1afd0 20 20 72 65 74 75 72 6e 20 69 52 65 74 3b 0a 7d return iRet;.}
1afe0 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 ../*.** Set the
1aff0 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50 61 67 value of the Pag
1b000 65 72 2e 73 65 63 74 6f 72 53 69 7a 65 20 76 61 er.sectorSize va
1b010 72 69 61 62 6c 65 20 66 6f 72 20 74 68 65 20 67 riable for the g
1b020 69 76 65 6e 0a 2a 2a 20 70 61 67 65 72 20 62 61 iven.** pager ba
1b030 73 65 64 20 6f 6e 20 74 68 65 20 76 61 6c 75 65 sed on the value
1b040 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 returned by the
1b050 20 78 53 65 63 74 6f 72 53 69 7a 65 20 6d 65 74 xSectorSize met
1b060 68 6f 64 0a 2a 2a 20 6f 66 20 74 68 65 20 6f 70 hod.** of the op
1b070 65 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 en database file
1b080 2e 20 54 68 65 20 73 65 63 74 6f 72 20 73 69 7a . The sector siz
1b090 65 20 77 69 6c 6c 20 62 65 20 75 73 65 64 20 0a e will be used .
1b0a0 2a 2a 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 ** to determine
1b0b0 74 68 65 20 73 69 7a 65 20 61 6e 64 20 61 6c 69 the size and ali
1b0c0 67 6e 6d 65 6e 74 20 6f 66 20 6a 6f 75 72 6e 61 gnment of journa
1b0d0 6c 20 68 65 61 64 65 72 20 61 6e 64 20 0a 2a 2a l header and .**
1b0e0 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
1b0f0 70 6f 69 6e 74 65 72 73 20 77 69 74 68 69 6e 20 pointers within
1b100 63 72 65 61 74 65 64 20 6a 6f 75 72 6e 61 6c 20 created journal
1b110 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 files..**.** For
1b120 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 temporary files
1b130 20 74 68 65 20 65 66 66 65 63 74 69 76 65 20 73 the effective s
1b140 65 63 74 6f 72 20 73 69 7a 65 20 69 73 20 61 6c ector size is al
1b150 77 61 79 73 20 35 31 32 20 62 79 74 65 73 2e 0a ways 512 bytes..
1b160 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c **.** Otherwise,
1b170 20 66 6f 72 20 6e 6f 6e 2d 74 65 6d 70 6f 72 61 for non-tempora
1b180 72 79 20 66 69 6c 65 73 2c 20 74 68 65 20 65 66 ry files, the ef
1b190 66 65 63 74 69 76 65 20 73 65 63 74 6f 72 20 73 fective sector s
1b1a0 69 7a 65 20 69 73 0a 2a 2a 20 74 68 65 20 76 61 ize is.** the va
1b1b0 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 lue returned by
1b1c0 74 68 65 20 78 53 65 63 74 6f 72 53 69 7a 65 28 the xSectorSize(
1b1d0 29 20 6d 65 74 68 6f 64 20 72 6f 75 6e 64 65 64 ) method rounded
1b1e0 20 75 70 20 74 6f 20 33 32 20 69 66 0a 2a 2a 20 up to 32 if.**
1b1f0 69 74 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 it is less than
1b200 33 32 2c 20 6f 72 20 72 6f 75 6e 64 65 64 20 64 32, or rounded d
1b210 6f 77 6e 20 74 6f 20 4d 41 58 5f 53 45 43 54 4f own to MAX_SECTO
1b220 52 5f 53 49 5a 45 20 69 66 20 69 74 0a 2a 2a 20 R_SIZE if it.**
1b230 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 is greater than
1b240 4d 41 58 5f 53 45 43 54 4f 52 5f 53 49 5a 45 2e MAX_SECTOR_SIZE.
1b250 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 .**.** If the fi
1b260 6c 65 20 68 61 73 20 74 68 65 20 53 51 4c 49 54 le has the SQLIT
1b270 45 5f 49 4f 43 41 50 5f 50 4f 57 45 52 53 41 46 E_IOCAP_POWERSAF
1b280 45 5f 4f 56 45 52 57 52 49 54 45 20 70 72 6f 70 E_OVERWRITE prop
1b290 65 72 74 79 2c 20 74 68 65 6e 20 73 65 74 0a 2a erty, then set.*
1b2a0 2a 20 74 68 65 20 65 66 66 65 63 74 69 76 65 20 * the effective
1b2b0 73 65 63 74 6f 72 20 73 69 7a 65 20 74 6f 20 69 sector size to i
1b2c0 74 73 20 6d 69 6e 69 6d 75 6d 20 76 61 6c 75 65 ts minimum value
1b2d0 20 28 35 31 32 29 2e 20 20 54 68 65 20 70 75 72 (512). The pur
1b2e0 70 6f 73 65 20 6f 66 0a 2a 2a 20 70 50 61 67 65 pose of.** pPage
1b2f0 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 69 73 r->sectorSize is
1b300 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 22 to define the "
1b310 62 6c 61 73 74 20 72 61 64 69 75 73 22 20 6f 66 blast radius" of
1b320 20 62 79 74 65 73 20 74 68 61 74 0a 2a 2a 20 6d bytes that.** m
1b330 69 67 68 74 20 63 68 61 6e 67 65 20 69 66 20 61 ight change if a
1b340 20 63 72 61 73 68 20 6f 63 63 75 72 73 20 77 68 crash occurs wh
1b350 69 6c 65 20 77 72 69 74 69 6e 67 20 74 6f 20 61 ile writing to a
1b360 20 73 69 6e 67 6c 65 20 62 79 74 65 20 69 6e 0a single byte in.
1b370 2a 2a 20 74 68 61 74 20 72 61 6e 67 65 2e 20 20 ** that range.
1b380 42 75 74 20 77 69 74 68 20 50 4f 57 45 52 53 41 But with POWERSA
1b390 46 45 5f 4f 56 45 52 57 52 49 54 45 2c 20 74 68 FE_OVERWRITE, th
1b3a0 65 20 62 6c 61 73 74 20 72 61 64 69 75 73 20 69 e blast radius i
1b3b0 73 20 7a 65 72 6f 0a 2a 2a 20 28 74 68 61 74 20 s zero.** (that
1b3c0 69 73 20 77 68 61 74 20 50 4f 57 45 52 53 41 46 is what POWERSAF
1b3d0 45 5f 4f 56 45 52 57 52 49 54 45 20 6d 65 61 6e E_OVERWRITE mean
1b3e0 73 29 2c 20 73 6f 20 77 65 20 6d 69 6e 69 6d 69 s), so we minimi
1b3f0 7a 65 20 74 68 65 20 73 65 63 74 6f 72 0a 2a 2a ze the sector.**
1b400 20 73 69 7a 65 2e 20 20 46 6f 72 20 62 61 63 6b size. For back
1b410 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 6c wards compatibil
1b420 69 74 79 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 ity of the rollb
1b430 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 ack journal file
1b440 20 66 6f 72 6d 61 74 2c 0a 2a 2a 20 77 65 20 63 format,.** we c
1b450 61 6e 6e 6f 74 20 72 65 64 75 63 65 20 74 68 65 annot reduce the
1b460 20 65 66 66 65 63 74 69 76 65 20 73 65 63 74 6f effective secto
1b470 72 20 73 69 7a 65 20 62 65 6c 6f 77 20 35 31 32 r size below 512
1b480 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
1b490 20 73 65 74 53 65 63 74 6f 72 53 69 7a 65 28 50 setSectorSize(P
1b4a0 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 ager *pPager){.
1b4b0 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 assert( isOpen(
1b4c0 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 pPager->fd) || p
1b4d0 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
1b4e0 29 3b 0a 0a 20 20 69 66 28 20 70 50 61 67 65 72 );.. if( pPager
1b4f0 2d 3e 74 65 6d 70 46 69 6c 65 0a 20 20 20 7c 7c ->tempFile. ||
1b500 20 28 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 (sqlite3OsDevic
1b510 65 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 eCharacteristics
1b520 28 70 50 61 67 65 72 2d 3e 66 64 29 20 26 20 0a (pPager->fd) & .
1b530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
1b540 4c 49 54 45 5f 49 4f 43 41 50 5f 50 4f 57 45 52 LITE_IOCAP_POWER
1b550 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 29 21 SAFE_OVERWRITE)!
1b560 3d 30 0a 20 20 29 7b 0a 20 20 20 20 2f 2a 20 53 =0. ){. /* S
1b570 65 63 74 6f 72 20 73 69 7a 65 20 64 6f 65 73 6e ector size doesn
1b580 27 74 20 6d 61 74 74 65 72 20 66 6f 72 20 74 65 't matter for te
1b590 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 2e 20 41 mporary files. A
1b5a0 6c 73 6f 2c 20 74 68 65 20 66 69 6c 65 0a 20 20 lso, the file.
1b5b0 20 20 2a 2a 20 6d 61 79 20 6e 6f 74 20 68 61 76 ** may not hav
1b5c0 65 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 79 65 e been opened ye
1b5d0 74 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 t, in which case
1b5e0 20 74 68 65 20 4f 73 53 65 63 74 6f 72 53 69 7a the OsSectorSiz
1b5f0 65 28 29 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 e(). ** call
1b600 77 69 6c 6c 20 73 65 67 66 61 75 6c 74 2e 20 2a will segfault. *
1b610 2f 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 65 /. pPager->se
1b620 63 74 6f 72 53 69 7a 65 20 3d 20 35 31 32 3b 0a ctorSize = 512;.
1b630 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 }else{. pPa
1b640 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 ger->sectorSize
1b650 3d 20 73 71 6c 69 74 65 33 53 65 63 74 6f 72 53 = sqlite3SectorS
1b660 69 7a 65 28 70 50 61 67 65 72 2d 3e 66 64 29 3b ize(pPager->fd);
1b670 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 50 6c . }.}../*.** Pl
1b680 61 79 62 61 63 6b 20 74 68 65 20 6a 6f 75 72 6e ayback the journ
1b690 61 6c 20 61 6e 64 20 74 68 75 73 20 72 65 73 74 al and thus rest
1b6a0 6f 72 65 20 74 68 65 20 64 61 74 61 62 61 73 65 ore the database
1b6b0 20 66 69 6c 65 20 74 6f 0a 2a 2a 20 74 68 65 20 file to.** the
1b6c0 73 74 61 74 65 20 69 74 20 77 61 73 20 69 6e 20 state it was in
1b6d0 62 65 66 6f 72 65 20 77 65 20 73 74 61 72 74 65 before we starte
1b6e0 64 20 6d 61 6b 69 6e 67 20 63 68 61 6e 67 65 73 d making changes
1b6f0 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6a 6f . .**.** The jo
1b700 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 6d 61 urnal file forma
1b710 74 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 3a t is as follows:
1b720 20 0a 2a 2a 0a 2a 2a 20 20 28 31 29 20 20 38 20 .**.** (1) 8
1b730 62 79 74 65 20 70 72 65 66 69 78 2e 20 20 41 20 byte prefix. A
1b740 63 6f 70 79 20 6f 66 20 61 4a 6f 75 72 6e 61 6c copy of aJournal
1b750 4d 61 67 69 63 5b 5d 2e 0a 2a 2a 20 20 28 32 29 Magic[]..** (2)
1b760 20 20 34 20 62 79 74 65 20 62 69 67 2d 65 6e 64 4 byte big-end
1b770 69 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 ian integer whic
1b780 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 h is the number
1b790 6f 66 20 76 61 6c 69 64 20 70 61 67 65 20 72 65 of valid page re
1b7a0 63 6f 72 64 73 0a 2a 2a 20 20 20 20 20 20 20 69 cords.** i
1b7b0 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 n the journal.
1b7c0 49 66 20 74 68 69 73 20 76 61 6c 75 65 20 69 73 If this value is
1b7d0 20 30 78 66 66 66 66 66 66 66 66 2c 20 74 68 65 0xffffffff, the
1b7e0 6e 20 63 6f 6d 70 75 74 65 20 74 68 65 0a 2a 2a n compute the.**
1b7f0 20 20 20 20 20 20 20 6e 75 6d 62 65 72 20 6f 66 number of
1b800 20 70 61 67 65 20 72 65 63 6f 72 64 73 20 66 72 page records fr
1b810 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 73 om the journal s
1b820 69 7a 65 2e 0a 2a 2a 20 20 28 33 29 20 20 34 20 ize..** (3) 4
1b830 62 79 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 byte big-endian
1b840 69 6e 74 65 67 65 72 20 77 68 69 63 68 20 69 73 integer which is
1b850 20 74 68 65 20 69 6e 69 74 69 61 6c 20 76 61 6c the initial val
1b860 75 65 20 66 6f 72 20 74 68 65 20 0a 2a 2a 20 20 ue for the .**
1b870 20 20 20 20 20 73 61 6e 69 74 79 20 63 68 65 63 sanity chec
1b880 6b 73 75 6d 2e 0a 2a 2a 20 20 28 34 29 20 20 34 ksum..** (4) 4
1b890 20 62 79 74 65 20 69 6e 74 65 67 65 72 20 77 68 byte integer wh
1b8a0 69 63 68 20 69 73 20 74 68 65 20 6e 75 6d 62 65 ich is the numbe
1b8b0 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20 74 72 r of pages to tr
1b8c0 75 6e 63 61 74 65 20 74 68 65 0a 2a 2a 20 20 20 uncate the.**
1b8d0 20 20 20 20 64 61 74 61 62 61 73 65 20 74 6f 20 database to
1b8e0 64 75 72 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 during a rollbac
1b8f0 6b 2e 0a 2a 2a 20 20 28 35 29 20 20 34 20 62 79 k..** (5) 4 by
1b900 74 65 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e te big-endian in
1b910 74 65 67 65 72 20 77 68 69 63 68 20 69 73 20 74 teger which is t
1b920 68 65 20 73 65 63 74 6f 72 20 73 69 7a 65 2e 20 he sector size.
1b930 20 54 68 65 20 68 65 61 64 65 72 0a 2a 2a 20 20 The header.**
1b940 20 20 20 20 20 69 73 20 74 68 69 73 20 6d 61 6e is this man
1b950 79 20 62 79 74 65 73 20 69 6e 20 73 69 7a 65 2e y bytes in size.
1b960 0a 2a 2a 20 20 28 36 29 20 20 34 20 62 79 74 65 .** (6) 4 byte
1b970 20 62 69 67 2d 65 6e 64 69 61 6e 20 69 6e 74 65 big-endian inte
1b980 67 65 72 20 77 68 69 63 68 20 69 73 20 74 68 65 ger which is the
1b990 20 70 61 67 65 20 73 69 7a 65 2e 0a 2a 2a 20 20 page size..**
1b9a0 28 37 29 20 20 7a 65 72 6f 20 70 61 64 64 69 6e (7) zero paddin
1b9b0 67 20 6f 75 74 20 74 6f 20 74 68 65 20 6e 65 78 g out to the nex
1b9c0 74 20 73 65 63 74 6f 72 20 73 69 7a 65 2e 0a 2a t sector size..*
1b9d0 2a 20 20 28 38 29 20 20 5a 65 72 6f 20 6f 72 20 * (8) Zero or
1b9e0 6d 6f 72 65 20 70 61 67 65 73 20 69 6e 73 74 61 more pages insta
1b9f0 6e 63 65 73 2c 20 65 61 63 68 20 61 73 20 66 6f nces, each as fo
1ba00 6c 6c 6f 77 73 3a 0a 2a 2a 20 20 20 20 20 20 20 llows:.**
1ba10 20 2b 20 20 34 20 62 79 74 65 20 70 61 67 65 20 + 4 byte page
1ba20 6e 75 6d 62 65 72 2e 0a 2a 2a 20 20 20 20 20 20 number..**
1ba30 20 20 2b 20 20 70 50 61 67 65 72 2d 3e 70 61 67 + pPager->pag
1ba40 65 53 69 7a 65 20 62 79 74 65 73 20 6f 66 20 64 eSize bytes of d
1ba50 61 74 61 2e 0a 2a 2a 20 20 20 20 20 20 20 20 2b ata..** +
1ba60 20 20 34 20 62 79 74 65 20 63 68 65 63 6b 73 75 4 byte checksu
1ba70 6d 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 77 65 20 m.**.** When we
1ba80 73 70 65 61 6b 20 6f 66 20 74 68 65 20 6a 6f 75 speak of the jou
1ba90 72 6e 61 6c 20 68 65 61 64 65 72 2c 20 77 65 20 rnal header, we
1baa0 6d 65 61 6e 20 74 68 65 20 66 69 72 73 74 20 37 mean the first 7
1bab0 20 69 74 65 6d 73 20 61 62 6f 76 65 2e 0a 2a 2a items above..**
1bac0 20 45 61 63 68 20 65 6e 74 72 79 20 69 6e 20 74 Each entry in t
1bad0 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 61 6e he journal is an
1bae0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
1baf0 20 38 74 68 20 69 74 65 6d 2e 0a 2a 2a 0a 2a 2a 8th item..**.**
1bb00 20 43 61 6c 6c 20 74 68 65 20 76 61 6c 75 65 20 Call the value
1bb10 66 72 6f 6d 20 74 68 65 20 73 65 63 6f 6e 64 20 from the second
1bb20 62 75 6c 6c 65 74 20 22 6e 52 65 63 22 2e 20 20 bullet "nRec".
1bb30 6e 52 65 63 20 69 73 20 74 68 65 20 6e 75 6d 62 nRec is the numb
1bb40 65 72 20 6f 66 0a 2a 2a 20 76 61 6c 69 64 20 70 er of.** valid p
1bb50 61 67 65 20 65 6e 74 72 69 65 73 20 69 6e 20 74 age entries in t
1bb60 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 49 6e 20 he journal. In
1bb70 6d 6f 73 74 20 63 61 73 65 73 2c 20 79 6f 75 20 most cases, you
1bb80 63 61 6e 20 63 6f 6d 70 75 74 65 20 74 68 65 0a can compute the.
1bb90 2a 2a 20 76 61 6c 75 65 20 6f 66 20 6e 52 65 63 ** value of nRec
1bba0 20 66 72 6f 6d 20 74 68 65 20 73 69 7a 65 20 6f from the size o
1bbb0 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 f the journal fi
1bbc0 6c 65 2e 20 20 42 75 74 20 69 66 20 61 20 70 6f le. But if a po
1bbd0 77 65 72 0a 2a 2a 20 66 61 69 6c 75 72 65 20 6f wer.** failure o
1bbe0 63 63 75 72 72 65 64 20 77 68 69 6c 65 20 74 68 ccurred while th
1bbf0 65 20 6a 6f 75 72 6e 61 6c 20 77 61 73 20 62 65 e journal was be
1bc00 69 6e 67 20 77 72 69 74 74 65 6e 2c 20 69 74 20 ing written, it
1bc10 63 6f 75 6c 64 20 62 65 20 74 68 65 0a 2a 2a 20 could be the.**
1bc20 63 61 73 65 20 74 68 61 74 20 74 68 65 20 73 69 case that the si
1bc30 7a 65 20 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 ze of the journa
1bc40 6c 20 66 69 6c 65 20 68 61 64 20 61 6c 72 65 61 l file had alrea
1bc50 64 79 20 62 65 65 6e 20 69 6e 63 72 65 61 73 65 dy been increase
1bc60 64 20 62 75 74 0a 2a 2a 20 74 68 65 20 65 78 74 d but.** the ext
1bc70 72 61 20 65 6e 74 72 69 65 73 20 68 61 64 20 6e ra entries had n
1bc80 6f 74 20 79 65 74 20 6d 61 64 65 20 69 74 20 73 ot yet made it s
1bc90 61 66 65 6c 79 20 74 6f 20 64 69 73 6b 2e 20 20 afely to disk.
1bca0 49 6e 20 73 75 63 68 20 61 20 63 61 73 65 2c 0a In such a case,.
1bcb0 2a 2a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 ** the value of
1bcc0 6e 52 65 63 20 63 6f 6d 70 75 74 65 64 20 66 72 nRec computed fr
1bcd0 6f 6d 20 74 68 65 20 66 69 6c 65 20 73 69 7a 65 om the file size
1bce0 20 77 6f 75 6c 64 20 62 65 20 74 6f 6f 20 6c 61 would be too la
1bcf0 72 67 65 2e 20 20 46 6f 72 0a 2a 2a 20 74 68 61 rge. For.** tha
1bd00 74 20 72 65 61 73 6f 6e 2c 20 77 65 20 61 6c 77 t reason, we alw
1bd10 61 79 73 20 75 73 65 20 74 68 65 20 6e 52 65 63 ays use the nRec
1bd20 20 76 61 6c 75 65 20 69 6e 20 74 68 65 20 68 65 value in the he
1bd30 61 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ader..**.** If t
1bd40 68 65 20 6e 52 65 63 20 76 61 6c 75 65 20 69 73 he nRec value is
1bd50 20 30 78 66 66 66 66 66 66 66 66 20 69 74 20 6d 0xffffffff it m
1bd60 65 61 6e 73 20 74 68 61 74 20 6e 52 65 63 20 73 eans that nRec s
1bd70 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 75 74 65 hould be compute
1bd80 64 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 66 69 d.** from the fi
1bd90 6c 65 20 73 69 7a 65 2e 20 20 54 68 69 73 20 76 le size. This v
1bda0 61 6c 75 65 20 69 73 20 75 73 65 64 20 77 68 65 alue is used whe
1bdb0 6e 20 74 68 65 20 75 73 65 72 20 73 65 6c 65 63 n the user selec
1bdc0 74 73 20 74 68 65 0a 2a 2a 20 6e 6f 2d 73 79 6e ts the.** no-syn
1bdd0 63 20 6f 70 74 69 6f 6e 20 66 6f 72 20 74 68 65 c option for the
1bde0 20 6a 6f 75 72 6e 61 6c 2e 20 20 41 20 70 6f 77 journal. A pow
1bdf0 65 72 20 66 61 69 6c 75 72 65 20 63 6f 75 6c 64 er failure could
1be00 20 6c 65 61 64 20 74 6f 20 63 6f 72 72 75 70 74 lead to corrupt
1be10 69 6f 6e 0a 2a 2a 20 69 6e 20 74 68 69 73 20 63 ion.** in this c
1be20 61 73 65 2e 20 20 42 75 74 20 66 6f 72 20 74 68 ase. But for th
1be30 69 6e 67 73 20 6c 69 6b 65 20 74 65 6d 70 6f 72 ings like tempor
1be40 61 72 79 20 74 61 62 6c 65 20 28 77 68 69 63 68 ary table (which
1be50 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 64 65 6c 65 will be.** dele
1be60 74 65 64 20 77 68 65 6e 20 74 68 65 20 70 6f 77 ted when the pow
1be70 65 72 20 69 73 20 72 65 73 74 6f 72 65 64 29 20 er is restored)
1be80 77 65 20 64 6f 6e 27 74 20 63 61 72 65 2e 20 20 we don't care.
1be90 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 66 69 .**.** If the fi
1bea0 6c 65 20 6f 70 65 6e 65 64 20 61 73 20 74 68 65 le opened as the
1beb0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
1bec0 20 6e 6f 74 20 61 20 77 65 6c 6c 2d 66 6f 72 6d not a well-form
1bed0 65 64 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 ed.** journal fi
1bee0 6c 65 20 74 68 65 6e 20 61 6c 6c 20 70 61 67 65 le then all page
1bef0 73 20 75 70 20 74 6f 20 74 68 65 20 66 69 72 73 s up to the firs
1bf00 74 20 63 6f 72 72 75 70 74 65 64 20 70 61 67 65 t corrupted page
1bf10 20 61 72 65 20 72 6f 6c 6c 65 64 0a 2a 2a 20 62 are rolled.** b
1bf20 61 63 6b 20 28 6f 72 20 6e 6f 20 70 61 67 65 73 ack (or no pages
1bf30 20 69 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 if the journal
1bf40 68 65 61 64 65 72 20 69 73 20 63 6f 72 72 75 70 header is corrup
1bf50 74 65 64 29 2e 20 54 68 65 20 6a 6f 75 72 6e 61 ted). The journa
1bf60 6c 20 66 69 6c 65 0a 2a 2a 20 69 73 20 74 68 65 l file.** is the
1bf70 6e 20 64 65 6c 65 74 65 64 20 61 6e 64 20 53 51 n deleted and SQ
1bf80 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
1bf90 2c 20 6a 75 73 74 20 61 73 20 69 66 20 6e 6f 20 , just as if no
1bfa0 63 6f 72 72 75 70 74 69 6f 6e 20 68 61 64 0a 2a corruption had.*
1bfb0 2a 20 62 65 65 6e 20 65 6e 63 6f 75 6e 74 65 72 * been encounter
1bfc0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 20 ed..**.** If an
1bfd0 49 2f 4f 20 6f 72 20 6d 61 6c 6c 6f 63 28 29 20 I/O or malloc()
1bfe0 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 68 error occurs, th
1bff0 65 20 6a 6f 75 72 6e 61 6c 2d 66 69 6c 65 20 69 e journal-file i
1c000 73 20 6e 6f 74 20 64 65 6c 65 74 65 64 0a 2a 2a s not deleted.**
1c010 20 61 6e 64 20 61 6e 20 65 72 72 6f 72 20 63 6f and an error co
1c020 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a de is returned..
1c030 2a 2a 0a 2a 2a 20 54 68 65 20 69 73 48 6f 74 20 **.** The isHot
1c040 70 61 72 61 6d 65 74 65 72 20 69 6e 64 69 63 61 parameter indica
1c050 74 65 73 20 74 68 61 74 20 77 65 20 61 72 65 20 tes that we are
1c060 74 72 79 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 61 trying to rollba
1c070 63 6b 20 61 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 ck a journal.**
1c080 74 68 61 74 20 6d 69 67 68 74 20 62 65 20 61 20 that might be a
1c090 68 6f 74 20 6a 6f 75 72 6e 61 6c 2e 20 20 4f 72 hot journal. Or
1c0a0 2c 20 69 74 20 63 6f 75 6c 64 20 62 65 20 74 68 , it could be th
1c0b0 61 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 at the journal i
1c0c0 73 20 0a 2a 2a 20 70 72 65 73 65 72 76 65 64 20 s .** preserved
1c0d0 62 65 63 61 75 73 65 20 6f 66 20 4a 4f 55 52 4e because of JOURN
1c0e0 41 4c 4d 4f 44 45 5f 50 45 52 53 49 53 54 20 6f ALMODE_PERSIST o
1c0f0 72 20 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 r JOURNALMODE_TR
1c100 55 4e 43 41 54 45 2e 0a 2a 2a 20 49 66 20 74 68 UNCATE..** If th
1c110 65 20 6a 6f 75 72 6e 61 6c 20 72 65 61 6c 6c 79 e journal really
1c120 20 69 73 20 68 6f 74 2c 20 72 65 73 65 74 20 74 is hot, reset t
1c130 68 65 20 70 61 67 65 72 20 63 61 63 68 65 20 70 he pager cache p
1c140 72 69 6f 72 20 72 6f 6c 6c 69 6e 67 0a 2a 2a 20 rior rolling.**
1c150 62 61 63 6b 20 61 6e 79 20 63 6f 6e 74 65 6e 74 back any content
1c160 2e 20 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 . If the journa
1c170 6c 20 69 73 20 6d 65 72 65 6c 79 20 70 65 72 73 l is merely pers
1c180 69 73 74 65 6e 74 2c 20 6e 6f 20 72 65 73 65 74 istent, no reset
1c190 20 69 73 0a 2a 2a 20 6e 65 65 64 65 64 2e 0a 2a is.** needed..*
1c1a0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 /.static int pag
1c1b0 65 72 5f 70 6c 61 79 62 61 63 6b 28 50 61 67 65 er_playback(Page
1c1c0 72 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 69 r *pPager, int i
1c1d0 73 48 6f 74 29 7b 0a 20 20 73 71 6c 69 74 65 33 sHot){. sqlite3
1c1e0 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 70 50 61 _vfs *pVfs = pPa
1c1f0 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 69 36 34 ger->pVfs;. i64
1c200 20 73 7a 4a 3b 20 20 20 20 20 20 20 20 20 20 20 szJ;
1c210 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
1c220 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
1c230 65 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 e in bytes */.
1c240 75 33 32 20 6e 52 65 63 3b 20 20 20 20 20 20 20 u32 nRec;
1c250 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1c260 65 72 20 6f 66 20 52 65 63 6f 72 64 73 20 69 6e er of Records in
1c270 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a the journal */.
1c280 20 20 75 33 32 20 75 3b 20 20 20 20 20 20 20 20 u32 u;
1c290 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 6e /* Un
1c2a0 73 69 67 6e 65 64 20 6c 6f 6f 70 20 63 6f 75 6e signed loop coun
1c2b0 74 65 72 20 2a 2f 0a 20 20 50 67 6e 6f 20 6d 78 ter */. Pgno mx
1c2c0 50 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 Pg = 0;
1c2d0 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 /* Size of the
1c2e0 20 6f 72 69 67 69 6e 61 6c 20 66 69 6c 65 20 69 original file i
1c2f0 6e 20 70 61 67 65 73 20 2a 2f 0a 20 20 69 6e 74 n pages */. int
1c300 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 rc;
1c310 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
1c320 63 6f 64 65 20 6f 66 20 61 20 73 75 62 72 6f 75 code of a subrou
1c330 74 69 6e 65 20 2a 2f 0a 20 20 69 6e 74 20 72 65 tine */. int re
1c340 73 20 3d 20 31 3b 20 20 20 20 20 20 20 20 20 20 s = 1;
1c350 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 /* Value retu
1c360 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 4f rned by sqlite3O
1c370 73 41 63 63 65 73 73 28 29 20 2a 2f 0a 20 20 63 sAccess() */. c
1c380 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30 har *zMaster = 0
1c390 3b 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 ; /* Name
1c3a0 6f 66 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 of master journa
1c3b0 6c 20 66 69 6c 65 20 69 66 20 61 6e 79 20 2a 2f l file if any */
1c3c0 0a 20 20 69 6e 74 20 6e 65 65 64 50 61 67 65 72 . int needPager
1c3d0 52 65 73 65 74 3b 20 20 20 20 20 20 2f 2a 20 54 Reset; /* T
1c3e0 72 75 65 20 74 6f 20 72 65 73 65 74 20 70 61 67 rue to reset pag
1c3f0 65 20 70 72 69 6f 72 20 74 6f 20 66 69 72 73 74 e prior to first
1c400 20 70 61 67 65 20 72 6f 6c 6c 62 61 63 6b 20 2a page rollback *
1c410 2f 0a 20 20 69 6e 74 20 6e 50 6c 61 79 62 61 63 /. int nPlaybac
1c420 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 k = 0; /*
1c430 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 Total number of
1c440 70 61 67 65 73 20 72 65 73 74 6f 72 65 64 20 66 pages restored f
1c450 72 6f 6d 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 rom journal */.
1c460 20 75 33 32 20 73 61 76 65 64 50 61 67 65 53 69 u32 savedPageSi
1c470 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 ze = pPager->pag
1c480 65 53 69 7a 65 3b 0a 0a 20 20 2f 2a 20 46 69 67 eSize;.. /* Fig
1c490 75 72 65 20 6f 75 74 20 68 6f 77 20 6d 61 6e 79 ure out how many
1c4a0 20 72 65 63 6f 72 64 73 20 61 72 65 20 69 6e 20 records are in
1c4b0 74 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 20 41 62 the journal. Ab
1c4c0 6f 72 74 20 65 61 72 6c 79 20 69 66 0a 20 20 2a ort early if. *
1c4d0 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 * the journal is
1c4e0 20 65 6d 70 74 79 2e 0a 20 20 2a 2f 0a 20 20 61 empty.. */. a
1c4f0 73 73 65 72 74 28 20 69 73 4f 70 65 6e 28 70 50 ssert( isOpen(pP
1c500 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a 20 20 ager->jfd) );.
1c510 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 rc = sqlite3OsFi
1c520 6c 65 53 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a leSize(pPager->j
1c530 66 64 2c 20 26 73 7a 4a 29 3b 0a 20 20 69 66 28 fd, &szJ);. if(
1c540 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
1c550 7b 0a 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f 70 {. goto end_p
1c560 6c 61 79 62 61 63 6b 3b 0a 20 20 7d 0a 0a 20 20 layback;. }..
1c570 2f 2a 20 52 65 61 64 20 74 68 65 20 6d 61 73 74 /* Read the mast
1c580 65 72 20 6a 6f 75 72 6e 61 6c 20 6e 61 6d 65 20 er journal name
1c590 66 72 6f 6d 20 74 68 65 20 6a 6f 75 72 6e 61 6c from the journal
1c5a0 2c 20 69 66 20 69 74 20 69 73 20 70 72 65 73 65 , if it is prese
1c5b0 6e 74 2e 0a 20 20 2a 2a 20 49 66 20 61 20 6d 61 nt.. ** If a ma
1c5c0 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ster journal fil
1c5d0 65 20 6e 61 6d 65 20 69 73 20 73 70 65 63 69 66 e name is specif
1c5e0 69 65 64 2c 20 62 75 74 20 74 68 65 20 66 69 6c ied, but the fil
1c5f0 65 20 69 73 20 6e 6f 74 0a 20 20 2a 2a 20 70 72 e is not. ** pr
1c600 65 73 65 6e 74 20 6f 6e 20 64 69 73 6b 2c 20 74 esent on disk, t
1c610 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
1c620 69 73 20 6e 6f 74 20 68 6f 74 20 61 6e 64 20 64 is not hot and d
1c630 6f 65 73 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 oes not need to
1c640 62 65 0a 20 20 2a 2a 20 70 6c 61 79 65 64 20 62 be. ** played b
1c650 61 63 6b 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 ack.. **. ** T
1c660 4f 44 4f 3a 20 54 65 63 68 6e 69 63 61 6c 6c 79 ODO: Technically
1c670 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 the following i
1c680 73 20 61 6e 20 65 72 72 6f 72 20 62 65 63 61 75 s an error becau
1c690 73 65 20 69 74 20 61 73 73 75 6d 65 73 20 74 68 se it assumes th
1c6a0 61 74 0a 20 20 2a 2a 20 62 75 66 66 65 72 20 50 at. ** buffer P
1c6b0 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 20 69 ager.pTmpSpace i
1c6c0 73 20 28 6d 78 50 61 74 68 6e 61 6d 65 2b 31 29 s (mxPathname+1)
1c6d0 20 62 79 74 65 73 20 6f 72 20 6c 61 72 67 65 72 bytes or larger
1c6e0 2e 20 69 2e 65 2e 20 74 68 61 74 0a 20 20 2a 2a . i.e. that. **
1c6f0 20 28 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 (pPager->pageSi
1c700 7a 65 20 3e 3d 20 70 50 61 67 65 72 2d 3e 70 56 ze >= pPager->pV
1c710 66 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 fs->mxPathname+1
1c720 29 2e 20 55 73 69 6e 67 20 6f 73 5f 75 6e 69 78 ). Using os_unix
1c730 2e 63 2c 0a 20 20 2a 2a 20 6d 78 50 61 74 68 6e .c,. ** mxPathn
1c740 61 6d 65 20 69 73 20 35 31 32 2c 20 77 68 69 63 ame is 512, whic
1c750 68 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 h is the same as
1c760 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 61 6c 6c the minimum all
1c770 6f 77 61 62 6c 65 20 76 61 6c 75 65 0a 20 20 2a owable value. *
1c780 2a 20 66 6f 72 20 70 61 67 65 53 69 7a 65 2e 0a * for pageSize..
1c790 20 20 2a 2f 0a 20 20 7a 4d 61 73 74 65 72 20 3d */. zMaster =
1c7a0 20 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 pPager->pTmpSpa
1c7b0 63 65 3b 0a 20 20 72 63 20 3d 20 72 65 61 64 4d ce;. rc = readM
1c7c0 61 73 74 65 72 4a 6f 75 72 6e 61 6c 28 70 50 61 asterJournal(pPa
1c7d0 67 65 72 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 65 ger->jfd, zMaste
1c7e0 72 2c 20 70 50 61 67 65 72 2d 3e 70 56 66 73 2d r, pPager->pVfs-
1c7f0 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 29 3b 0a >mxPathname+1);.
1c800 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1c810 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 65 72 5b 30 _OK && zMaster[0
1c820 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 ] ){. rc = sq
1c830 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 56 lite3OsAccess(pV
1c840 66 73 2c 20 7a 4d 61 73 74 65 72 2c 20 53 51 4c fs, zMaster, SQL
1c850 49 54 45 5f 41 43 43 45 53 53 5f 45 58 49 53 54 ITE_ACCESS_EXIST
1c860 53 2c 20 26 72 65 73 29 3b 0a 20 20 7d 0a 20 20 S, &res);. }.
1c870 7a 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 69 zMaster = 0;. i
1c880 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
1c890 20 7c 7c 20 21 72 65 73 20 29 7b 0a 20 20 20 20 || !res ){.
1c8a0 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 goto end_playbac
1c8b0 6b 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d k;. }. pPager-
1c8c0 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 3b >journalOff = 0;
1c8d0 0a 20 20 6e 65 65 64 50 61 67 65 72 52 65 73 65 . needPagerRese
1c8e0 74 20 3d 20 69 73 48 6f 74 3b 0a 0a 20 20 2f 2a t = isHot;.. /*
1c8f0 20 54 68 69 73 20 6c 6f 6f 70 20 74 65 72 6d 69 This loop termi
1c900 6e 61 74 65 73 20 65 69 74 68 65 72 20 77 68 65 nates either whe
1c910 6e 20 61 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 n a readJournalH
1c920 64 72 28 29 20 6f 72 20 0a 20 20 2a 2a 20 70 61 dr() or . ** pa
1c930 67 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 ger_playback_one
1c940 5f 70 61 67 65 28 29 20 63 61 6c 6c 20 72 65 74 _page() call ret
1c950 75 72 6e 73 20 53 51 4c 49 54 45 5f 44 4f 4e 45 urns SQLITE_DONE
1c960 20 6f 72 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 or an IO error
1c970 0a 20 20 2a 2a 20 6f 63 63 75 72 73 2e 20 0a 20 . ** occurs. .
1c980 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 31 20 29 */. while( 1 )
1c990 7b 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 {. /* Read th
1c9a0 65 20 6e 65 78 74 20 6a 6f 75 72 6e 61 6c 20 68 e next journal h
1c9b0 65 61 64 65 72 20 66 72 6f 6d 20 74 68 65 20 6a eader from the j
1c9c0 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 20 49 66 ournal file. If
1c9d0 20 74 68 65 72 65 20 61 72 65 0a 20 20 20 20 2a there are. *
1c9e0 2a 20 6e 6f 74 20 65 6e 6f 75 67 68 20 62 79 74 * not enough byt
1c9f0 65 73 20 6c 65 66 74 20 69 6e 20 74 68 65 20 6a es left in the j
1ca00 6f 75 72 6e 61 6c 20 66 69 6c 65 20 66 6f 72 20 ournal file for
1ca10 61 20 63 6f 6d 70 6c 65 74 65 20 68 65 61 64 65 a complete heade
1ca20 72 2c 20 6f 72 0a 20 20 20 20 2a 2a 20 69 74 20 r, or. ** it
1ca30 69 73 20 63 6f 72 72 75 70 74 65 64 2c 20 74 68 is corrupted, th
1ca40 65 6e 20 61 20 70 72 6f 63 65 73 73 20 6d 75 73 en a process mus
1ca50 74 20 68 61 76 65 20 66 61 69 6c 65 64 20 77 68 t have failed wh
1ca60 69 6c 65 20 77 72 69 74 69 6e 67 20 69 74 2e 0a ile writing it..
1ca70 20 20 20 20 2a 2a 20 54 68 69 73 20 69 6e 64 69 ** This indi
1ca80 63 61 74 65 73 20 6e 6f 74 68 69 6e 67 20 6d 6f cates nothing mo
1ca90 72 65 20 6e 65 65 64 73 20 74 6f 20 62 65 20 72 re needs to be r
1caa0 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 20 20 olled back..
1cab0 2a 2f 0a 20 20 20 20 72 63 20 3d 20 72 65 61 64 */. rc = read
1cac0 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 67 65 JournalHdr(pPage
1cad0 72 2c 20 69 73 48 6f 74 2c 20 73 7a 4a 2c 20 26 r, isHot, szJ, &
1cae0 6e 52 65 63 2c 20 26 6d 78 50 67 29 3b 0a 20 20 nRec, &mxPg);.
1caf0 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
1cb00 5f 4f 4b 20 29 7b 20 0a 20 20 20 20 20 20 69 66 _OK ){ . if
1cb10 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e ( rc==SQLITE_DON
1cb20 45 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 E ){. rc
1cb30 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 = SQLITE_OK;.
1cb40 20 20 20 7d 0a 20 20 20 20 20 20 67 6f 74 6f 20 }. goto
1cb50 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a 20 20 end_playback;.
1cb60 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 6e }.. /* If n
1cb70 52 65 63 20 69 73 20 30 78 66 66 66 66 66 66 66 Rec is 0xfffffff
1cb80 66 2c 20 74 68 65 6e 20 74 68 69 73 20 6a 6f 75 f, then this jou
1cb90 72 6e 61 6c 20 77 61 73 20 63 72 65 61 74 65 64 rnal was created
1cba0 20 62 79 20 61 20 70 72 6f 63 65 73 73 0a 20 20 by a process.
1cbb0 20 20 2a 2a 20 77 6f 72 6b 69 6e 67 20 69 6e 20 ** working in
1cbc0 6e 6f 2d 73 79 6e 63 20 6d 6f 64 65 2e 20 54 68 no-sync mode. Th
1cbd0 69 73 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 is means that th
1cbe0 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 6a 6f e rest of the jo
1cbf0 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 66 69 6c urnal. ** fil
1cc00 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 70 61 e consists of pa
1cc10 67 65 73 2c 20 74 68 65 72 65 20 61 72 65 20 6e ges, there are n
1cc20 6f 20 6d 6f 72 65 20 6a 6f 75 72 6e 61 6c 20 68 o more journal h
1cc30 65 61 64 65 72 73 2e 20 43 6f 6d 70 75 74 65 0a eaders. Compute.
1cc40 20 20 20 20 2a 2a 20 74 68 65 20 76 61 6c 75 65 ** the value
1cc50 20 6f 66 20 6e 52 65 63 20 62 61 73 65 64 20 6f of nRec based o
1cc60 6e 20 74 68 69 73 20 61 73 73 75 6d 70 74 69 6f n this assumptio
1cc70 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 n.. */. if
1cc80 28 20 6e 52 65 63 3d 3d 30 78 66 66 66 66 66 66 ( nRec==0xffffff
1cc90 66 66 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 ff ){. asse
1cca0 72 74 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 rt( pPager->jour
1ccb0 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e 41 4c 5f nalOff==JOURNAL_
1ccc0 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 20 29 HDR_SZ(pPager) )
1ccd0 3b 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 28 ;. nRec = (
1cce0 69 6e 74 29 28 28 73 7a 4a 20 2d 20 4a 4f 55 52 int)((szJ - JOUR
1ccf0 4e 41 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 NAL_HDR_SZ(pPage
1cd00 72 29 29 2f 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 r))/JOURNAL_PG_S
1cd10 5a 28 70 50 61 67 65 72 29 29 3b 0a 20 20 20 20 Z(pPager));.
1cd20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 6e 52 65 }.. /* If nRe
1cd30 63 20 69 73 20 30 20 61 6e 64 20 74 68 69 73 20 c is 0 and this
1cd40 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6f 66 20 61 rollback is of a
1cd50 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 72 65 transaction cre
1cd60 61 74 65 64 20 62 79 20 74 68 69 73 0a 20 20 20 ated by this.
1cd70 20 2a 2a 20 70 72 6f 63 65 73 73 20 61 6e 64 20 ** process and
1cd80 69 66 20 74 68 69 73 20 69 73 20 74 68 65 20 66 if this is the f
1cd90 69 6e 61 6c 20 68 65 61 64 65 72 20 69 6e 20 74 inal header in t
1cda0 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 74 68 65 6e he journal, then
1cdb0 20 69 74 20 6d 65 61 6e 73 0a 20 20 20 20 2a 2a it means. **
1cdc0 20 74 68 61 74 20 74 68 69 73 20 70 61 72 74 20 that this part
1cdd0 6f 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 of the journal w
1cde0 61 73 20 62 65 69 6e 67 20 66 69 6c 6c 65 64 20 as being filled
1cdf0 62 75 74 20 68 61 73 20 6e 6f 74 20 79 65 74 20 but has not yet
1ce00 62 65 65 6e 0a 20 20 20 20 2a 2a 20 73 79 6e 63 been. ** sync
1ce10 65 64 20 74 6f 20 64 69 73 6b 2e 20 20 43 6f 6d ed to disk. Com
1ce20 70 75 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 pute the number
1ce30 6f 66 20 70 61 67 65 73 20 62 61 73 65 64 20 6f of pages based o
1ce40 6e 20 74 68 65 20 72 65 6d 61 69 6e 69 6e 67 0a n the remaining.
1ce50 20 20 20 20 2a 2a 20 73 69 7a 65 20 6f 66 20 74 ** size of t
1ce60 68 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a he file.. **.
1ce70 20 20 20 20 2a 2a 20 54 68 65 20 74 68 69 72 64 ** The third
1ce80 20 74 65 72 6d 20 6f 66 20 74 68 65 20 74 65 73 term of the tes
1ce90 74 20 77 61 73 20 61 64 64 65 64 20 74 6f 20 66 t was added to f
1cea0 69 78 20 74 69 63 6b 65 74 20 23 32 35 36 35 2e ix ticket #2565.
1ceb0 0a 20 20 20 20 2a 2a 20 57 68 65 6e 20 72 6f 6c . ** When rol
1cec0 6c 69 6e 67 20 62 61 63 6b 20 61 20 68 6f 74 20 ling back a hot
1ced0 6a 6f 75 72 6e 61 6c 2c 20 6e 52 65 63 3d 3d 30 journal, nRec==0
1cee0 20 61 6c 77 61 79 73 20 6d 65 61 6e 73 20 74 68 always means th
1cef0 61 74 20 74 68 65 20 6e 65 78 74 0a 20 20 20 20 at the next.
1cf00 2a 2a 20 63 68 75 6e 6b 20 6f 66 20 74 68 65 20 ** chunk of the
1cf10 6a 6f 75 72 6e 61 6c 20 63 6f 6e 74 61 69 6e 73 journal contains
1cf20 20 7a 65 72 6f 20 70 61 67 65 73 20 74 6f 20 62 zero pages to b
1cf30 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 e rolled back.
1cf40 42 75 74 0a 20 20 20 20 2a 2a 20 77 68 65 6e 20 But. ** when
1cf50 64 6f 69 6e 67 20 61 20 52 4f 4c 4c 42 41 43 4b doing a ROLLBACK
1cf60 20 61 6e 64 20 74 68 65 20 6e 52 65 63 3d 3d 30 and the nRec==0
1cf70 20 63 68 75 6e 6b 20 69 73 20 74 68 65 20 6c 61 chunk is the la
1cf80 73 74 20 63 68 75 6e 6b 20 69 6e 0a 20 20 20 20 st chunk in.
1cf90 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2c 20 ** the journal,
1cfa0 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 it means that th
1cfb0 65 20 6a 6f 75 72 6e 61 6c 20 6d 69 67 68 74 20 e journal might
1cfc0 63 6f 6e 74 61 69 6e 20 61 64 64 69 74 69 6f 6e contain addition
1cfd0 61 6c 0a 20 20 20 20 2a 2a 20 70 61 67 65 73 20 al. ** pages
1cfe0 74 68 61 74 20 6e 65 65 64 20 74 6f 20 62 65 20 that need to be
1cff0 72 6f 6c 6c 65 64 20 62 61 63 6b 20 61 6e 64 20 rolled back and
1d000 74 68 61 74 20 74 68 65 20 6e 75 6d 62 65 72 20 that the number
1d010 6f 66 20 70 61 67 65 73 20 0a 20 20 20 20 2a 2a of pages . **
1d020 20 73 68 6f 75 6c 64 20 62 65 20 63 6f 6d 70 75 should be compu
1d030 74 65 64 20 62 61 73 65 64 20 6f 6e 20 74 68 65 ted based on the
1d040 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 69 journal file si
1d050 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ze.. */. i
1d060 66 28 20 6e 52 65 63 3d 3d 30 20 26 26 20 21 69 f( nRec==0 && !i
1d070 73 48 6f 74 20 26 26 0a 20 20 20 20 20 20 20 20 sHot &&.
1d080 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 pPager->journalH
1d090 64 72 2b 4a 4f 55 52 4e 41 4c 5f 48 44 52 5f 53 dr+JOURNAL_HDR_S
1d0a0 5a 28 70 50 61 67 65 72 29 3d 3d 70 50 61 67 65 Z(pPager)==pPage
1d0b0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 29 7b r->journalOff ){
1d0c0 0a 20 20 20 20 20 20 6e 52 65 63 20 3d 20 28 69 . nRec = (i
1d0d0 6e 74 29 28 28 73 7a 4a 20 2d 20 70 50 61 67 65 nt)((szJ - pPage
1d0e0 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 29 20 2f r->journalOff) /
1d0f0 20 4a 4f 55 52 4e 41 4c 5f 50 47 5f 53 5a 28 70 JOURNAL_PG_SZ(p
1d100 50 61 67 65 72 29 29 3b 0a 20 20 20 20 7d 0a 0a Pager));. }..
1d110 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 /* If this i
1d120 73 20 74 68 65 20 66 69 72 73 74 20 68 65 61 64 s the first head
1d130 65 72 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 er read from the
1d140 20 6a 6f 75 72 6e 61 6c 2c 20 74 72 75 6e 63 61 journal, trunca
1d150 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 te the. ** da
1d160 74 61 62 61 73 65 20 66 69 6c 65 20 62 61 63 6b tabase file back
1d170 20 74 6f 20 69 74 73 20 6f 72 69 67 69 6e 61 6c to its original
1d180 20 73 69 7a 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 size.. */.
1d190 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f if( pPager->jo
1d1a0 75 72 6e 61 6c 4f 66 66 3d 3d 4a 4f 55 52 4e 41 urnalOff==JOURNA
1d1b0 4c 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 L_HDR_SZ(pPager)
1d1c0 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 ){. rc = p
1d1d0 61 67 65 72 5f 74 72 75 6e 63 61 74 65 28 70 50 ager_truncate(pP
1d1e0 61 67 65 72 2c 20 6d 78 50 67 29 3b 0a 20 20 20 ager, mxPg);.
1d1f0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
1d200 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
1d210 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 goto end_playbac
1d220 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 k;. }.
1d230 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 pPager->dbSize
1d240 3d 20 6d 78 50 67 3b 0a 20 20 20 20 7d 0a 0a 20 = mxPg;. }..
1d250 20 20 20 2f 2a 20 43 6f 70 79 20 6f 72 69 67 69 /* Copy origi
1d260 6e 61 6c 20 70 61 67 65 73 20 6f 75 74 20 6f 66 nal pages out of
1d270 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 the journal and
1d280 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 0a back into the .
1d290 20 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 ** database
1d2a0 66 69 6c 65 20 61 6e 64 2f 6f 72 20 70 61 67 65 file and/or page
1d2b0 20 63 61 63 68 65 2e 0a 20 20 20 20 2a 2f 0a 20 cache.. */.
1d2c0 20 20 20 66 6f 72 28 75 3d 30 3b 20 75 3c 6e 52 for(u=0; u<nR
1d2d0 65 63 3b 20 75 2b 2b 29 7b 0a 20 20 20 20 20 20 ec; u++){.
1d2e0 69 66 28 20 6e 65 65 64 50 61 67 65 72 52 65 73 if( needPagerRes
1d2f0 65 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 61 et ){. pa
1d300 67 65 72 5f 72 65 73 65 74 28 70 50 61 67 65 72 ger_reset(pPager
1d310 29 3b 0a 20 20 20 20 20 20 20 20 6e 65 65 64 50 );. needP
1d320 61 67 65 72 52 65 73 65 74 20 3d 20 30 3b 0a 20 agerReset = 0;.
1d330 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 20 }. rc
1d340 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b = pager_playback
1d350 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 67 65 72 _one_page(pPager
1d360 2c 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ,&pPager->journa
1d370 6c 4f 66 66 2c 30 2c 31 2c 30 29 3b 0a 20 20 20 lOff,0,1,0);.
1d380 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 if( rc==SQLIT
1d390 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 E_OK ){.
1d3a0 6e 50 6c 61 79 62 61 63 6b 2b 2b 3b 0a 20 20 20 nPlayback++;.
1d3b0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1d3c0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1d3d0 5f 44 4f 4e 45 20 29 7b 0a 20 20 20 20 20 20 20 _DONE ){.
1d3e0 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e pPager->journ
1d3f0 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a 20 20 20 alOff = szJ;.
1d400 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 break;.
1d410 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
1d420 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 rc==SQLITE_IOERR
1d430 5f 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a 20 _SHORT_READ ){.
1d440 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 /* If t
1d450 68 65 20 6a 6f 75 72 6e 61 6c 20 68 61 73 20 62 he journal has b
1d460 65 65 6e 20 74 72 75 6e 63 61 74 65 64 2c 20 73 een truncated, s
1d470 69 6d 70 6c 79 20 73 74 6f 70 20 72 65 61 64 69 imply stop readi
1d480 6e 67 20 61 6e 64 0a 20 20 20 20 20 20 20 20 20 ng and.
1d490 20 2a 2a 20 70 72 6f 63 65 73 73 69 6e 67 20 74 ** processing t
1d4a0 68 65 20 6a 6f 75 72 6e 61 6c 2e 20 54 68 69 73 he journal. This
1d4b0 20 6d 69 67 68 74 20 68 61 70 70 65 6e 20 69 66 might happen if
1d4c0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 77 61 73 the journal was
1d4d0 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 6e 6f . ** no
1d4e0 74 20 63 6f 6d 70 6c 65 74 65 6c 79 20 77 72 69 t completely wri
1d4f0 74 74 65 6e 20 61 6e 64 20 73 79 6e 63 65 64 20 tten and synced
1d500 70 72 69 6f 72 20 74 6f 20 61 20 63 72 61 73 68 prior to a crash
1d510 2e 20 20 49 6e 20 74 68 61 74 0a 20 20 20 20 20 . In that.
1d520 20 20 20 20 20 2a 2a 20 63 61 73 65 2c 20 74 68 ** case, th
1d530 65 20 64 61 74 61 62 61 73 65 20 73 68 6f 75 6c e database shoul
1d540 64 20 68 61 76 65 20 6e 65 76 65 72 20 62 65 65 d have never bee
1d550 6e 20 77 72 69 74 74 65 6e 20 69 6e 20 74 68 65 n written in the
1d560 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 66 69 . ** fi
1d570 72 73 74 20 70 6c 61 63 65 20 73 6f 20 69 74 20 rst place so it
1d580 69 73 20 4f 4b 20 74 6f 20 73 69 6d 70 6c 79 20 is OK to simply
1d590 61 62 61 6e 64 6f 6e 20 74 68 65 20 72 6f 6c 6c abandon the roll
1d5a0 62 61 63 6b 2e 20 2a 2f 0a 20 20 20 20 20 20 20 back. */.
1d5b0 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f rc = SQLITE_O
1d5c0 4b 3b 0a 20 20 20 20 20 20 20 20 20 20 67 6f 74 K;. got
1d5d0 6f 20 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3b 0a o end_playback;.
1d5e0 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
1d5f0 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 77 /* If w
1d600 65 20 61 72 65 20 75 6e 61 62 6c 65 20 74 6f 20 e are unable to
1d610 72 6f 6c 6c 62 61 63 6b 2c 20 71 75 69 74 20 61 rollback, quit a
1d620 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 65 72 nd return the er
1d630 72 6f 72 0a 20 20 20 20 20 20 20 20 20 20 2a 2a ror. **
1d640 20 63 6f 64 65 2e 20 20 54 68 69 73 20 77 69 6c code. This wil
1d650 6c 20 63 61 75 73 65 20 74 68 65 20 70 61 67 65 l cause the page
1d660 72 20 74 6f 20 65 6e 74 65 72 20 74 68 65 20 65 r to enter the e
1d670 72 72 6f 72 20 73 74 61 74 65 0a 20 20 20 20 20 rror state.
1d680 20 20 20 20 20 2a 2a 20 73 6f 20 74 68 61 74 20 ** so that
1d690 6e 6f 20 66 75 72 74 68 65 72 20 68 61 72 6d 20 no further harm
1d6a0 77 69 6c 6c 20 62 65 20 64 6f 6e 65 2e 20 20 50 will be done. P
1d6b0 65 72 68 61 70 73 20 74 68 65 20 6e 65 78 74 0a erhaps the next.
1d6c0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 70 72 6f ** pro
1d6d0 63 65 73 73 20 74 6f 20 63 6f 6d 65 20 61 6c 6f cess to come alo
1d6e0 6e 67 20 77 69 6c 6c 20 62 65 20 61 62 6c 65 20 ng will be able
1d6f0 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 20 to rollback the
1d700 64 61 74 61 62 61 73 65 2e 0a 20 20 20 20 20 20 database..
1d710 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 */.
1d720 20 67 6f 74 6f 20 65 6e 64 5f 70 6c 61 79 62 61 goto end_playba
1d730 63 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 ck;. }.
1d740 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
1d750 20 20 2f 2a 4e 4f 54 52 45 41 43 48 45 44 2a 2f /*NOTREACHED*/
1d760 0a 20 20 61 73 73 65 72 74 28 20 30 20 29 3b 0a . assert( 0 );.
1d770 0a 65 6e 64 5f 70 6c 61 79 62 61 63 6b 3a 0a 20 .end_playback:.
1d780 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1d790 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 OK ){. rc = s
1d7a0 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
1d7b0 67 65 73 69 7a 65 28 70 50 61 67 65 72 2c 20 26 gesize(pPager, &
1d7c0 73 61 76 65 64 50 61 67 65 53 69 7a 65 2c 20 2d savedPageSize, -
1d7d0 31 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 46 6f 6c 1);. }. /* Fol
1d7e0 6c 6f 77 69 6e 67 20 61 20 72 6f 6c 6c 62 61 63 lowing a rollbac
1d7f0 6b 2c 20 74 68 65 20 64 61 74 61 62 61 73 65 20 k, the database
1d800 66 69 6c 65 20 73 68 6f 75 6c 64 20 62 65 20 62 file should be b
1d810 61 63 6b 20 69 6e 20 69 74 73 20 6f 72 69 67 69 ack in its origi
1d820 6e 61 6c 0a 20 20 2a 2a 20 73 74 61 74 65 20 70 nal. ** state p
1d830 72 69 6f 72 20 74 6f 20 74 68 65 20 73 74 61 72 rior to the star
1d840 74 20 6f 66 20 74 68 65 20 74 72 61 6e 73 61 63 t of the transac
1d850 74 69 6f 6e 2c 20 73 6f 20 69 6e 76 6f 6b 65 20 tion, so invoke
1d860 74 68 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f the. ** SQLITE_
1d870 46 43 4e 54 4c 5f 44 42 5f 55 4e 43 48 41 4e 47 FCNTL_DB_UNCHANG
1d880 45 44 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 ED file-control
1d890 6d 65 74 68 6f 64 20 74 6f 20 64 69 73 61 62 6c method to disabl
1d8a0 65 20 74 68 65 0a 20 20 2a 2a 20 61 73 73 65 72 e the. ** asser
1d8b0 74 69 6f 6e 20 74 68 61 74 20 74 68 65 20 74 72 tion that the tr
1d8c0 61 6e 73 61 63 74 69 6f 6e 20 63 6f 75 6e 74 65 ansaction counte
1d8d0 72 20 77 61 73 20 6d 6f 64 69 66 69 65 64 2e 0a r was modified..
1d8e0 20 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 */.#ifdef SQLI
1d8f0 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 70 TE_DEBUG. if( p
1d900 50 61 67 65 72 2d 3e 66 64 2d 3e 70 4d 65 74 68 Pager->fd->pMeth
1d910 6f 64 73 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ods ){. sqlit
1d920 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 e3OsFileControlH
1d930 69 6e 74 28 70 50 61 67 65 72 2d 3e 66 64 2c 53 int(pPager->fd,S
1d940 51 4c 49 54 45 5f 46 43 4e 54 4c 5f 44 42 5f 55 QLITE_FCNTL_DB_U
1d950 4e 43 48 41 4e 47 45 44 2c 30 29 3b 0a 20 20 7d NCHANGED,0);. }
1d960 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 49 66 .#endif.. /* If
1d970 20 74 68 69 73 20 70 6c 61 79 62 61 63 6b 20 69 this playback i
1d980 73 20 68 61 70 70 65 6e 69 6e 67 20 61 75 74 6f s happening auto
1d990 6d 61 74 69 63 61 6c 6c 79 20 61 73 20 61 20 72 matically as a r
1d9a0 65 73 75 6c 74 20 6f 66 20 61 6e 20 49 4f 20 6f esult of an IO o
1d9b0 72 20 0a 20 20 2a 2a 20 6d 61 6c 6c 6f 63 20 65 r . ** malloc e
1d9c0 72 72 6f 72 20 74 68 61 74 20 6f 63 63 75 72 72 rror that occurr
1d9d0 65 64 20 61 66 74 65 72 20 74 68 65 20 63 68 61 ed after the cha
1d9e0 6e 67 65 2d 63 6f 75 6e 74 65 72 20 77 61 73 20 nge-counter was
1d9f0 75 70 64 61 74 65 64 20 62 75 74 20 0a 20 20 2a updated but . *
1da00 2a 20 62 65 66 6f 72 65 20 74 68 65 20 74 72 61 * before the tra
1da10 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 63 6f 6d nsaction was com
1da20 6d 69 74 74 65 64 2c 20 74 68 65 6e 20 74 68 65 mitted, then the
1da30 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 change-counter
1da40 0a 20 20 2a 2a 20 6d 6f 64 69 66 69 63 61 74 69 . ** modificati
1da50 6f 6e 20 6d 61 79 20 6a 75 73 74 20 68 61 76 65 on may just have
1da60 20 62 65 65 6e 20 72 65 76 65 72 74 65 64 2e 20 been reverted.
1da70 49 66 20 74 68 69 73 20 68 61 70 70 65 6e 73 20 If this happens
1da80 69 6e 20 65 78 63 6c 75 73 69 76 65 20 0a 20 20 in exclusive .
1da90 2a 2a 20 6d 6f 64 65 2c 20 74 68 65 6e 20 73 75 ** mode, then su
1daa0 62 73 65 71 75 65 6e 74 20 74 72 61 6e 73 61 63 bsequent transac
1dab0 74 69 6f 6e 73 20 70 65 72 66 6f 72 6d 65 64 20 tions performed
1dac0 62 79 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f by the connectio
1dad0 6e 20 77 69 6c 6c 20 6e 6f 74 0a 20 20 2a 2a 20 n will not. **
1dae0 75 70 64 61 74 65 20 74 68 65 20 63 68 61 6e 67 update the chang
1daf0 65 2d 63 6f 75 6e 74 65 72 20 61 74 20 61 6c 6c e-counter at all
1db00 2e 20 54 68 69 73 20 6d 61 79 20 6c 65 61 64 20 . This may lead
1db10 74 6f 20 63 61 63 68 65 20 69 6e 63 6f 6e 73 69 to cache inconsi
1db20 73 74 65 6e 63 79 0a 20 20 2a 2a 20 70 72 6f 62 stency. ** prob
1db30 6c 65 6d 73 20 66 6f 72 20 6f 74 68 65 72 20 70 lems for other p
1db40 72 6f 63 65 73 73 65 73 20 61 74 20 73 6f 6d 65 rocesses at some
1db50 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 point in the fu
1db60 74 75 72 65 2e 20 53 6f 2c 20 6a 75 73 74 0a 20 ture. So, just.
1db70 20 2a 2a 20 69 6e 20 63 61 73 65 20 74 68 69 73 ** in case this
1db80 20 68 61 73 20 68 61 70 70 65 6e 65 64 2c 20 63 has happened, c
1db90 6c 65 61 72 20 74 68 65 20 63 68 61 6e 67 65 43 lear the changeC
1dba0 6f 75 6e 74 44 6f 6e 65 20 66 6c 61 67 20 6e 6f ountDone flag no
1dbb0 77 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 67 65 72 w.. */. pPager
1dbc0 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e ->changeCountDon
1dbd0 65 20 3d 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 e = pPager->temp
1dbe0 46 69 6c 65 3b 0a 0a 20 20 69 66 28 20 72 63 3d File;.. if( rc=
1dbf0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1dc00 20 20 7a 4d 61 73 74 65 72 20 3d 20 70 50 61 67 zMaster = pPag
1dc10 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 3b 0a 20 er->pTmpSpace;.
1dc20 20 20 20 72 63 20 3d 20 72 65 61 64 4d 61 73 74 rc = readMast
1dc30 65 72 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 72 erJournal(pPager
1dc40 2d 3e 6a 66 64 2c 20 7a 4d 61 73 74 65 72 2c 20 ->jfd, zMaster,
1dc50 70 50 61 67 65 72 2d 3e 70 56 66 73 2d 3e 6d 78 pPager->pVfs->mx
1dc60 50 61 74 68 6e 61 6d 65 2b 31 29 3b 0a 20 20 20 Pathname+1);.
1dc70 20 74 65 73 74 63 61 73 65 28 20 72 63 21 3d 53 testcase( rc!=S
1dc80 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 7d 0a QLITE_OK );. }.
1dc90 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1dca0 5f 4f 4b 0a 20 20 20 26 26 20 28 70 50 61 67 65 _OK. && (pPage
1dcb0 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 47 45 52 r->eState>=PAGER
1dcc0 5f 57 52 49 54 45 52 5f 44 42 4d 4f 44 20 7c 7c _WRITER_DBMOD ||
1dcd0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
1dce0 3d 50 41 47 45 52 5f 4f 50 45 4e 29 0a 20 20 29 =PAGER_OPEN). )
1dcf0 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
1dd00 65 33 50 61 67 65 72 53 79 6e 63 28 70 50 61 67 e3PagerSync(pPag
1dd10 65 72 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 er, 0);. }. if
1dd20 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
1dd30 29 7b 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 ){. rc = page
1dd40 72 5f 65 6e 64 5f 74 72 61 6e 73 61 63 74 69 6f r_end_transactio
1dd50 6e 28 70 50 61 67 65 72 2c 20 7a 4d 61 73 74 65 n(pPager, zMaste
1dd60 72 5b 30 5d 21 3d 27 5c 30 27 2c 20 30 29 3b 0a r[0]!='\0', 0);.
1dd70 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 63 testcase( rc
1dd80 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 !=SQLITE_OK );.
1dd90 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c }. if( rc==SQL
1dda0 49 54 45 5f 4f 4b 20 26 26 20 7a 4d 61 73 74 65 ITE_OK && zMaste
1ddb0 72 5b 30 5d 20 26 26 20 72 65 73 20 29 7b 0a 20 r[0] && res ){.
1ddc0 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 77 /* If there w
1ddd0 61 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 as a master jour
1dde0 6e 61 6c 20 61 6e 64 20 74 68 69 73 20 72 6f 75 nal and this rou
1ddf0 74 69 6e 65 20 77 69 6c 6c 20 72 65 74 75 72 6e tine will return
1de00 20 73 75 63 63 65 73 73 2c 0a 20 20 20 20 2a 2a success,. **
1de10 20 73 65 65 20 69 66 20 69 74 20 69 73 20 70 6f see if it is po
1de20 73 73 69 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 ssible to delete
1de30 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 the master jour
1de40 6e 61 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 nal.. */.
1de50 72 63 20 3d 20 70 61 67 65 72 5f 64 65 6c 6d 61 rc = pager_delma
1de60 73 74 65 72 28 70 50 61 67 65 72 2c 20 7a 4d 61 ster(pPager, zMa
1de70 73 74 65 72 29 3b 0a 20 20 20 20 74 65 73 74 63 ster);. testc
1de80 61 73 65 28 20 72 63 21 3d 53 51 4c 49 54 45 5f ase( rc!=SQLITE_
1de90 4f 4b 20 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 OK );. }. if(
1dea0 69 73 48 6f 74 20 26 26 20 6e 50 6c 61 79 62 61 isHot && nPlayba
1deb0 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ck ){. sqlite
1dec0 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 4e 4f 54 3_log(SQLITE_NOT
1ded0 49 43 45 5f 52 45 43 4f 56 45 52 5f 52 4f 4c 4c ICE_RECOVER_ROLL
1dee0 42 41 43 4b 2c 20 22 72 65 63 6f 76 65 72 65 64 BACK, "recovered
1def0 20 25 64 20 70 61 67 65 73 20 66 72 6f 6d 20 25 %d pages from %
1df00 73 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 s",.
1df10 20 20 20 20 6e 50 6c 61 79 62 61 63 6b 2c 20 70 nPlayback, p
1df20 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 29 Pager->zJournal)
1df30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 ;. }.. /* The
1df40 50 61 67 65 72 2e 73 65 63 74 6f 72 53 69 7a 65 Pager.sectorSize
1df50 20 76 61 72 69 61 62 6c 65 20 6d 61 79 20 68 61 variable may ha
1df60 76 65 20 62 65 65 6e 20 75 70 64 61 74 65 64 20 ve been updated
1df70 77 68 69 6c 65 20 72 6f 6c 6c 69 6e 67 0a 20 20 while rolling.
1df80 2a 2a 20 62 61 63 6b 20 61 20 6a 6f 75 72 6e 61 ** back a journa
1df90 6c 20 63 72 65 61 74 65 64 20 62 79 20 61 20 70 l created by a p
1dfa0 72 6f 63 65 73 73 20 77 69 74 68 20 61 20 64 69 rocess with a di
1dfb0 66 66 65 72 65 6e 74 20 73 65 63 74 6f 72 20 73 fferent sector s
1dfc0 69 7a 65 0a 20 20 2a 2a 20 76 61 6c 75 65 2e 20 ize. ** value.
1dfd0 52 65 73 65 74 20 69 74 20 74 6f 20 74 68 65 20 Reset it to the
1dfe0 63 6f 72 72 65 63 74 20 76 61 6c 75 65 20 66 6f correct value fo
1dff0 72 20 74 68 69 73 20 70 72 6f 63 65 73 73 2e 0a r this process..
1e000 20 20 2a 2f 0a 20 20 73 65 74 53 65 63 74 6f 72 */. setSector
1e010 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 20 Size(pPager);.
1e020 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f return rc;.}.../
1e030 2a 0a 2a 2a 20 52 65 61 64 20 74 68 65 20 63 6f *.** Read the co
1e040 6e 74 65 6e 74 20 66 6f 72 20 70 61 67 65 20 70 ntent for page p
1e050 50 67 20 6f 75 74 20 6f 66 20 74 68 65 20 64 61 Pg out of the da
1e060 74 61 62 61 73 65 20 66 69 6c 65 20 28 6f 72 20 tabase file (or
1e070 6f 75 74 20 6f 66 0a 2a 2a 20 74 68 65 20 57 41 out of.** the WA
1e080 4c 20 69 66 20 74 68 61 74 20 69 73 20 77 68 65 L if that is whe
1e090 72 65 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 re the most rece
1e0a0 6e 74 20 63 6f 70 79 20 69 66 20 66 6f 75 6e 64 nt copy if found
1e0b0 29 20 69 6e 74 6f 20 0a 2a 2a 20 70 50 67 2d 3e ) into .** pPg->
1e0c0 70 44 61 74 61 2e 20 41 20 73 68 61 72 65 64 20 pData. A shared
1e0d0 6c 6f 63 6b 20 6f 72 20 67 72 65 61 74 65 72 20 lock or greater
1e0e0 6d 75 73 74 20 62 65 20 68 65 6c 64 20 6f 6e 20 must be held on
1e0f0 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
1e100 66 69 6c 65 20 62 65 66 6f 72 65 20 74 68 69 73 file before this
1e110 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
1e120 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 61 led..**.** If pa
1e130 67 65 20 31 20 69 73 20 72 65 61 64 2c 20 74 68 ge 1 is read, th
1e140 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 en the value of
1e150 50 61 67 65 72 2e 64 62 46 69 6c 65 56 65 72 73 Pager.dbFileVers
1e160 5b 5d 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 [] is set to.**
1e170 74 68 65 20 76 61 6c 75 65 20 72 65 61 64 20 66 the value read f
1e180 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 rom the database
1e190 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 file..**.** If
1e1a0 61 6e 20 49 4f 20 65 72 72 6f 72 20 6f 63 63 75 an IO error occu
1e1b0 72 73 2c 20 74 68 65 6e 20 74 68 65 20 49 4f 20 rs, then the IO
1e1c0 65 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 error is returne
1e1d0 64 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 2e d to the caller.
1e1e0 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 53 .** Otherwise, S
1e1f0 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74 75 QLITE_OK is retu
1e200 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 rned..*/.static
1e210 69 6e 74 20 72 65 61 64 44 62 50 61 67 65 28 50 int readDbPage(P
1e220 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 50 61 gHdr *pPg){. Pa
1e230 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 50 ger *pPager = pP
1e240 67 2d 3e 70 50 61 67 65 72 3b 20 2f 2a 20 50 61 g->pPager; /* Pa
1e250 67 65 72 20 6f 62 6a 65 63 74 20 61 73 73 6f 63 ger object assoc
1e260 69 61 74 65 64 20 77 69 74 68 20 70 61 67 65 20 iated with page
1e270 70 50 67 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 pPg */. int rc
1e280 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 = SQLITE_OK;
1e290 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
1e2a0 63 6f 64 65 20 2a 2f 0a 0a 23 69 66 6e 64 65 66 code */..#ifndef
1e2b0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c SQLITE_OMIT_WAL
1e2c0 0a 20 20 75 33 32 20 69 46 72 61 6d 65 20 3d 20 . u32 iFrame =
1e2d0 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
1e2e0 2f 2a 20 46 72 61 6d 65 20 6f 66 20 57 41 4c 20 /* Frame of WAL
1e2f0 63 6f 6e 74 61 69 6e 69 6e 67 20 70 67 6e 6f 20 containing pgno
1e300 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 */.. assert( pP
1e310 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 ager->eState>=PA
1e320 47 45 52 5f 52 45 41 44 45 52 20 26 26 20 21 4d GER_READER && !M
1e330 45 4d 44 42 20 29 3b 0a 20 20 61 73 73 65 72 74 EMDB );. assert
1e340 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d ( isOpen(pPager-
1e350 3e 66 64 29 20 29 3b 0a 0a 20 20 69 66 28 20 70 >fd) );.. if( p
1e360 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 agerUseWal(pPage
1e370 72 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 r) ){. rc = s
1e380 71 6c 69 74 65 33 57 61 6c 46 69 6e 64 46 72 61 qlite3WalFindFra
1e390 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c me(pPager->pWal,
1e3a0 20 70 50 67 2d 3e 70 67 6e 6f 2c 20 26 69 46 72 pPg->pgno, &iFr
1e3b0 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 ame);. if( rc
1e3c0 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 ) return rc;.
1e3d0 7d 0a 20 20 69 66 28 20 69 46 72 61 6d 65 20 29 }. if( iFrame )
1e3e0 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
1e3f0 65 33 57 61 6c 52 65 61 64 46 72 61 6d 65 28 70 e3WalReadFrame(p
1e400 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 69 46 72 Pager->pWal, iFr
1e410 61 6d 65 2c 70 50 61 67 65 72 2d 3e 70 61 67 65 ame,pPager->page
1e420 53 69 7a 65 2c 70 50 67 2d 3e 70 44 61 74 61 29 Size,pPg->pData)
1e430 3b 0a 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 ;. }else.#endif
1e440 0a 20 20 7b 0a 20 20 20 20 69 36 34 20 69 4f 66 . {. i64 iOf
1e450 66 73 65 74 20 3d 20 28 70 50 67 2d 3e 70 67 6e fset = (pPg->pgn
1e460 6f 2d 31 29 2a 28 69 36 34 29 70 50 61 67 65 72 o-1)*(i64)pPager
1e470 2d 3e 70 61 67 65 53 69 7a 65 3b 0a 20 20 20 20 ->pageSize;.
1e480 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 rc = sqlite3OsRe
1e490 61 64 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 70 ad(pPager->fd, p
1e4a0 50 67 2d 3e 70 44 61 74 61 2c 20 70 50 61 67 65 Pg->pData, pPage
1e4b0 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 69 4f 66 r->pageSize, iOf
1e4c0 66 73 65 74 29 3b 0a 20 20 20 20 69 66 28 20 72 fset);. if( r
1e4d0 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f c==SQLITE_IOERR_
1e4e0 53 48 4f 52 54 5f 52 45 41 44 20 29 7b 0a 20 20 SHORT_READ ){.
1e4f0 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
1e500 4f 4b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 OK;. }. }..
1e510 20 69 66 28 20 70 50 67 2d 3e 70 67 6e 6f 3d 3d if( pPg->pgno==
1e520 31 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 20 1 ){. if( rc
1e530 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 ){. /* If t
1e540 68 65 20 72 65 61 64 20 69 73 20 75 6e 73 75 63 he read is unsuc
1e550 63 65 73 73 66 75 6c 2c 20 73 65 74 20 74 68 65 cessful, set the
1e560 20 64 62 46 69 6c 65 56 65 72 73 5b 5d 20 74 6f dbFileVers[] to
1e570 20 73 6f 6d 65 74 68 69 6e 67 0a 20 20 20 20 20 something.
1e580 20 2a 2a 20 74 68 61 74 20 77 69 6c 6c 20 6e 65 ** that will ne
1e590 76 65 72 20 62 65 20 61 20 76 61 6c 69 64 20 66 ver be a valid f
1e5a0 69 6c 65 20 76 65 72 73 69 6f 6e 2e 20 20 64 62 ile version. db
1e5b0 46 69 6c 65 56 65 72 73 5b 5d 20 69 73 20 61 20 FileVers[] is a
1e5c0 63 6f 70 79 0a 20 20 20 20 20 20 2a 2a 20 6f 66 copy. ** of
1e5d0 20 62 79 74 65 73 20 32 34 2e 2e 33 39 20 6f 66 bytes 24..39 of
1e5e0 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20 the database.
1e5f0 42 79 74 65 73 20 32 38 2e 2e 33 31 20 73 68 6f Bytes 28..31 sho
1e600 75 6c 64 20 61 6c 77 61 79 73 20 62 65 0a 20 20 uld always be.
1e610 20 20 20 20 2a 2a 20 7a 65 72 6f 20 6f 72 20 74 ** zero or t
1e620 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 64 he size of the d
1e630 61 74 61 62 61 73 65 20 69 6e 20 70 61 67 65 2e atabase in page.
1e640 20 42 79 74 65 73 20 33 32 2e 2e 33 35 20 61 6e Bytes 32..35 an
1e650 64 20 33 35 2e 2e 33 39 0a 20 20 20 20 20 20 2a d 35..39. *
1e660 2a 20 73 68 6f 75 6c 64 20 62 65 20 70 61 67 65 * should be page
1e670 20 6e 75 6d 62 65 72 73 20 77 68 69 63 68 20 61 numbers which a
1e680 72 65 20 6e 65 76 65 72 20 30 78 66 66 66 66 66 re never 0xfffff
1e690 66 66 66 2e 20 20 53 6f 20 66 69 6c 6c 69 6e 67 fff. So filling
1e6a0 0a 20 20 20 20 20 20 2a 2a 20 70 50 61 67 65 72 . ** pPager
1e6b0 2d 3e 64 62 46 69 6c 65 56 65 72 73 5b 5d 20 77 ->dbFileVers[] w
1e6c0 69 74 68 20 61 6c 6c 20 30 78 66 66 20 62 79 74 ith all 0xff byt
1e6d0 65 73 20 73 68 6f 75 6c 64 20 73 75 66 66 69 63 es should suffic
1e6e0 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 e.. **.
1e6f0 20 20 2a 2a 20 46 6f 72 20 61 6e 20 65 6e 63 72 ** For an encr
1e700 79 70 74 65 64 20 64 61 74 61 62 61 73 65 2c 20 ypted database,
1e710 74 68 65 20 73 69 74 75 61 74 69 6f 6e 20 69 73 the situation is
1e720 20 6d 6f 72 65 20 63 6f 6d 70 6c 65 78 3a 20 20 more complex:
1e730 62 79 74 65 73 0a 20 20 20 20 20 20 2a 2a 20 32 bytes. ** 2
1e740 34 2e 2e 33 39 20 6f 66 20 74 68 65 20 64 61 74 4..39 of the dat
1e750 61 62 61 73 65 20 61 72 65 20 77 68 69 74 65 20 abase are white
1e760 6e 6f 69 73 65 2e 20 20 42 75 74 20 74 68 65 20 noise. But the
1e770 70 72 6f 62 61 62 69 6c 69 74 79 20 6f 66 0a 20 probability of.
1e780 20 20 20 20 20 2a 2a 20 77 68 69 74 65 20 6e 6f ** white no
1e790 69 73 65 20 65 71 75 61 6c 69 6e 67 20 31 36 20 ise equaling 16
1e7a0 62 79 74 65 73 20 6f 66 20 30 78 66 66 20 69 73 bytes of 0xff is
1e7b0 20 76 61 6e 69 73 68 69 6e 67 6c 79 20 73 6d 61 vanishingly sma
1e7c0 6c 6c 20 73 6f 0a 20 20 20 20 20 20 2a 2a 20 77 ll so. ** w
1e7d0 65 20 73 68 6f 75 6c 64 20 73 74 69 6c 6c 20 62 e should still b
1e7e0 65 20 6f 6b 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 e ok.. */.
1e7f0 20 20 20 20 20 6d 65 6d 73 65 74 28 70 50 61 67 memset(pPag
1e800 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 er->dbFileVers,
1e810 30 78 66 66 2c 20 73 69 7a 65 6f 66 28 70 50 61 0xff, sizeof(pPa
1e820 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 ger->dbFileVers)
1e830 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
1e840 20 20 20 20 75 38 20 2a 64 62 46 69 6c 65 56 65 u8 *dbFileVe
1e850 72 73 20 3d 20 26 28 28 75 38 2a 29 70 50 67 2d rs = &((u8*)pPg-
1e860 3e 70 44 61 74 61 29 5b 32 34 5d 3b 0a 20 20 20 >pData)[24];.
1e870 20 20 20 6d 65 6d 63 70 79 28 26 70 50 61 67 65 memcpy(&pPage
1e880 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 2c 20 64 r->dbFileVers, d
1e890 62 46 69 6c 65 56 65 72 73 2c 20 73 69 7a 65 6f bFileVers, sizeo
1e8a0 66 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 f(pPager->dbFile
1e8b0 56 65 72 73 29 29 3b 0a 20 20 20 20 7d 0a 20 20 Vers));. }.
1e8c0 7d 0a 20 20 43 4f 44 45 43 31 28 70 50 61 67 65 }. CODEC1(pPage
1e8d0 72 2c 20 70 50 67 2d 3e 70 44 61 74 61 2c 20 70 r, pPg->pData, p
1e8e0 50 67 2d 3e 70 67 6e 6f 2c 20 33 2c 20 72 63 20 Pg->pgno, 3, rc
1e8f0 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 = SQLITE_NOMEM_B
1e900 4b 50 54 29 3b 0a 0a 20 20 50 41 47 45 52 5f 49 KPT);.. PAGER_I
1e910 4e 43 52 28 73 71 6c 69 74 65 33 5f 70 61 67 65 NCR(sqlite3_page
1e920 72 5f 72 65 61 64 64 62 5f 63 6f 75 6e 74 29 3b r_readdb_count);
1e930 0a 20 20 50 41 47 45 52 5f 49 4e 43 52 28 70 50 . PAGER_INCR(pP
1e940 61 67 65 72 2d 3e 6e 52 65 61 64 29 3b 0a 20 20 ager->nRead);.
1e950 49 4f 54 52 41 43 45 28 28 22 50 47 49 4e 20 25 IOTRACE(("PGIN %
1e960 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c p %d\n", pPager,
1e970 20 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 pPg->pgno));.
1e980 50 41 47 45 52 54 52 41 43 45 28 28 22 46 45 54 PAGERTRACE(("FET
1e990 43 48 20 25 64 20 70 61 67 65 20 25 64 20 68 61 CH %d page %d ha
1e9a0 73 68 28 25 30 38 78 29 5c 6e 22 2c 0a 20 20 20 sh(%08x)\n",.
1e9b0 20 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 PAGE
1e9c0 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 50 67 RID(pPager), pPg
1e9d0 2d 3e 70 67 6e 6f 2c 20 70 61 67 65 72 5f 70 61 ->pgno, pager_pa
1e9e0 67 65 68 61 73 68 28 70 50 67 29 29 29 3b 0a 0a gehash(pPg)));..
1e9f0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
1ea00 2f 2a 0a 2a 2a 20 55 70 64 61 74 65 20 74 68 65 /*.** Update the
1ea10 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 63 68 value of the ch
1ea20 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 61 74 20 ange-counter at
1ea30 6f 66 66 73 65 74 73 20 32 34 20 61 6e 64 20 39 offsets 24 and 9
1ea40 32 20 69 6e 0a 2a 2a 20 74 68 65 20 68 65 61 64 2 in.** the head
1ea50 65 72 20 61 6e 64 20 74 68 65 20 73 71 6c 69 74 er and the sqlit
1ea60 65 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 e version number
1ea70 20 61 74 20 6f 66 66 73 65 74 20 39 36 2e 0a 2a at offset 96..*
1ea80 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 6e 20 *.** This is an
1ea90 75 6e 63 6f 6e 64 69 74 69 6f 6e 61 6c 20 75 70 unconditional up
1eaa0 64 61 74 65 2e 20 20 53 65 65 20 61 6c 73 6f 20 date. See also
1eab0 74 68 65 20 70 61 67 65 72 5f 69 6e 63 72 5f 63 the pager_incr_c
1eac0 68 61 6e 67 65 63 6f 75 6e 74 65 72 28 29 0a 2a hangecounter().*
1ead0 2a 20 72 6f 75 74 69 6e 65 20 77 68 69 63 68 20 * routine which
1eae0 6f 6e 6c 79 20 75 70 64 61 74 65 73 20 74 68 65 only updates the
1eaf0 20 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 change-counter
1eb00 69 66 20 74 68 65 20 75 70 64 61 74 65 20 69 73 if the update is
1eb10 20 61 63 74 75 61 6c 6c 79 0a 2a 2a 20 6e 65 65 actually.** nee
1eb20 64 65 64 2c 20 61 73 20 64 65 74 65 72 6d 69 6e ded, as determin
1eb30 65 64 20 62 79 20 74 68 65 20 70 50 61 67 65 72 ed by the pPager
1eb40 2d 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e ->changeCountDon
1eb50 65 20 73 74 61 74 65 20 76 61 72 69 61 62 6c 65 e state variable
1eb60 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 ..*/.static void
1eb70 20 70 61 67 65 72 5f 77 72 69 74 65 5f 63 68 61 pager_write_cha
1eb80 6e 67 65 63 6f 75 6e 74 65 72 28 50 67 48 64 72 ngecounter(PgHdr
1eb90 20 2a 70 50 67 29 7b 0a 20 20 75 33 32 20 63 68 *pPg){. u32 ch
1eba0 61 6e 67 65 5f 63 6f 75 6e 74 65 72 3b 0a 0a 20 ange_counter;..
1ebb0 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 /* Increment th
1ebc0 65 20 76 61 6c 75 65 20 6a 75 73 74 20 72 65 61 e value just rea
1ebd0 64 20 61 6e 64 20 77 72 69 74 65 20 69 74 20 62 d and write it b
1ebe0 61 63 6b 20 74 6f 20 62 79 74 65 20 32 34 2e 20 ack to byte 24.
1ebf0 2a 2f 0a 20 20 63 68 61 6e 67 65 5f 63 6f 75 6e */. change_coun
1ec00 74 65 72 20 3d 20 73 71 6c 69 74 65 33 47 65 74 ter = sqlite3Get
1ec10 34 62 79 74 65 28 28 75 38 2a 29 70 50 67 2d 3e 4byte((u8*)pPg->
1ec20 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 pPager->dbFileVe
1ec30 72 73 29 2b 31 3b 0a 20 20 70 75 74 33 32 62 69 rs)+1;. put32bi
1ec40 74 73 28 28 28 63 68 61 72 2a 29 70 50 67 2d 3e ts(((char*)pPg->
1ec50 70 44 61 74 61 29 2b 32 34 2c 20 63 68 61 6e 67 pData)+24, chang
1ec60 65 5f 63 6f 75 6e 74 65 72 29 3b 0a 0a 20 20 2f e_counter);.. /
1ec70 2a 20 41 6c 73 6f 20 73 74 6f 72 65 20 74 68 65 * Also store the
1ec80 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 SQLite version
1ec90 6e 75 6d 62 65 72 20 69 6e 20 62 79 74 65 73 20 number in bytes
1eca0 39 36 2e 2e 39 39 20 61 6e 64 20 69 6e 0a 20 20 96..99 and in.
1ecb0 2a 2a 20 62 79 74 65 73 20 39 32 2e 2e 39 35 20 ** bytes 92..95
1ecc0 73 74 6f 72 65 20 74 68 65 20 63 68 61 6e 67 65 store the change
1ecd0 20 63 6f 75 6e 74 65 72 20 66 6f 72 20 77 68 69 counter for whi
1ece0 63 68 20 74 68 65 20 76 65 72 73 69 6f 6e 20 6e ch the version n
1ecf0 75 6d 62 65 72 0a 20 20 2a 2a 20 69 73 20 76 61 umber. ** is va
1ed00 6c 69 64 2e 20 2a 2f 0a 20 20 70 75 74 33 32 62 lid. */. put32b
1ed10 69 74 73 28 28 28 63 68 61 72 2a 29 70 50 67 2d its(((char*)pPg-
1ed20 3e 70 44 61 74 61 29 2b 39 32 2c 20 63 68 61 6e >pData)+92, chan
1ed30 67 65 5f 63 6f 75 6e 74 65 72 29 3b 0a 20 20 70 ge_counter);. p
1ed40 75 74 33 32 62 69 74 73 28 28 28 63 68 61 72 2a ut32bits(((char*
1ed50 29 70 50 67 2d 3e 70 44 61 74 61 29 2b 39 36 2c )pPg->pData)+96,
1ed60 20 53 51 4c 49 54 45 5f 56 45 52 53 49 4f 4e 5f SQLITE_VERSION_
1ed70 4e 55 4d 42 45 52 29 3b 0a 7d 0a 0a 23 69 66 6e NUMBER);.}..#ifn
1ed80 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1ed90 57 41 4c 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 WAL./*.** This f
1eda0 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b unction is invok
1edb0 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 ed once for each
1edc0 20 70 61 67 65 20 74 68 61 74 20 68 61 73 20 61 page that has a
1edd0 6c 72 65 61 64 79 20 62 65 65 6e 20 0a 2a 2a 20 lready been .**
1ede0 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 written into the
1edf0 20 6c 6f 67 20 66 69 6c 65 20 77 68 65 6e 20 61 log file when a
1ee00 20 57 41 4c 20 74 72 61 6e 73 61 63 74 69 6f 6e WAL transaction
1ee10 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e is rolled back.
1ee20 0a 2a 2a 20 50 61 72 61 6d 65 74 65 72 20 69 50 .** Parameter iP
1ee30 67 20 69 73 20 74 68 65 20 70 61 67 65 20 6e 75 g is the page nu
1ee40 6d 62 65 72 20 6f 66 20 73 61 69 64 20 70 61 67 mber of said pag
1ee50 65 2e 20 54 68 65 20 70 43 74 78 20 61 72 67 75 e. The pCtx argu
1ee60 6d 65 6e 74 20 0a 2a 2a 20 69 73 20 61 63 74 75 ment .** is actu
1ee70 61 6c 6c 79 20 61 20 70 6f 69 6e 74 65 72 20 74 ally a pointer t
1ee80 6f 20 74 68 65 20 50 61 67 65 72 20 73 74 72 75 o the Pager stru
1ee90 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 cture..**.** If
1eea0 70 61 67 65 20 69 50 67 20 69 73 20 70 72 65 73 page iPg is pres
1eeb0 65 6e 74 20 69 6e 20 74 68 65 20 63 61 63 68 65 ent in the cache
1eec0 2c 20 61 6e 64 20 68 61 73 20 6e 6f 20 6f 75 74 , and has no out
1eed0 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e standing referen
1eee0 63 65 73 2c 0a 2a 2a 20 69 74 20 69 73 20 64 69 ces,.** it is di
1eef0 73 63 61 72 64 65 64 2e 20 4f 74 68 65 72 77 69 scarded. Otherwi
1ef00 73 65 2c 20 69 66 20 74 68 65 72 65 20 61 72 65 se, if there are
1ef10 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 75 74 one or more out
1ef20 73 74 61 6e 64 69 6e 67 0a 2a 2a 20 72 65 66 65 standing.** refe
1ef30 72 65 6e 63 65 73 2c 20 74 68 65 20 70 61 67 65 rences, the page
1ef40 20 63 6f 6e 74 65 6e 74 20 69 73 20 72 65 6c 6f content is relo
1ef50 61 64 65 64 20 66 72 6f 6d 20 74 68 65 20 64 61 aded from the da
1ef60 74 61 62 61 73 65 2e 20 49 66 20 74 68 65 0a 2a tabase. If the.*
1ef70 2a 20 61 74 74 65 6d 70 74 20 74 6f 20 72 65 6c * attempt to rel
1ef80 6f 61 64 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d oad content from
1ef90 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 the database is
1efa0 20 72 65 71 75 69 72 65 64 20 61 6e 64 20 66 61 required and fa
1efb0 69 6c 73 2c 20 0a 2a 2a 20 72 65 74 75 72 6e 20 ils, .** return
1efc0 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 an SQLite error
1efd0 63 6f 64 65 2e 20 4f 74 68 65 72 77 69 73 65 2c code. Otherwise,
1efe0 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 73 SQLITE_OK..*/.s
1eff0 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 55 tatic int pagerU
1f000 6e 64 6f 43 61 6c 6c 62 61 63 6b 28 76 6f 69 64 ndoCallback(void
1f010 20 2a 70 43 74 78 2c 20 50 67 6e 6f 20 69 50 67 *pCtx, Pgno iPg
1f020 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 ){. int rc = SQ
1f030 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 61 67 65 72 LITE_OK;. Pager
1f040 20 2a 70 50 61 67 65 72 20 3d 20 28 50 61 67 65 *pPager = (Page
1f050 72 20 2a 29 70 43 74 78 3b 0a 20 20 50 67 48 64 r *)pCtx;. PgHd
1f060 72 20 2a 70 50 67 3b 0a 0a 20 20 61 73 73 65 72 r *pPg;.. asser
1f070 74 28 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 t( pagerUseWal(p
1f080 50 61 67 65 72 29 20 29 3b 0a 20 20 70 50 67 20 Pager) );. pPg
1f090 3d 20 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f = sqlite3PagerLo
1f0a0 6f 6b 75 70 28 70 50 61 67 65 72 2c 20 69 50 67 okup(pPager, iPg
1f0b0 29 3b 0a 20 20 69 66 28 20 70 50 67 20 29 7b 0a );. if( pPg ){.
1f0c0 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 50 if( sqlite3P
1f0d0 63 61 63 68 65 50 61 67 65 52 65 66 63 6f 75 6e cachePageRefcoun
1f0e0 74 28 70 50 67 29 3d 3d 31 20 29 7b 0a 20 20 20 t(pPg)==1 ){.
1f0f0 20 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 sqlite3Pcache
1f100 44 72 6f 70 28 70 50 67 29 3b 0a 20 20 20 20 7d Drop(pPg);. }
1f110 65 6c 73 65 7b 0a 20 20 20 20 20 20 72 63 20 3d else{. rc =
1f120 20 72 65 61 64 44 62 50 61 67 65 28 70 50 67 29 readDbPage(pPg)
1f130 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
1f140 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
1f150 20 20 20 20 20 70 50 61 67 65 72 2d 3e 78 52 65 pPager->xRe
1f160 69 6e 69 74 65 72 28 70 50 67 29 3b 0a 20 20 20 initer(pPg);.
1f170 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 }. sqlit
1f180 65 33 50 61 67 65 72 55 6e 72 65 66 4e 6f 74 4e e3PagerUnrefNotN
1f190 75 6c 6c 28 70 50 67 29 3b 0a 20 20 20 20 7d 0a ull(pPg);. }.
1f1a0 20 20 7d 0a 0a 20 20 2f 2a 20 4e 6f 72 6d 61 6c }.. /* Normal
1f1b0 6c 79 2c 20 69 66 20 61 20 74 72 61 6e 73 61 63 ly, if a transac
1f1c0 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 64 20 62 tion is rolled b
1f1d0 61 63 6b 2c 20 61 6e 79 20 62 61 63 6b 75 70 20 ack, any backup
1f1e0 70 72 6f 63 65 73 73 65 73 20 61 72 65 0a 20 20 processes are.
1f1f0 2a 2a 20 75 70 64 61 74 65 64 20 61 73 20 64 61 ** updated as da
1f200 74 61 20 69 73 20 63 6f 70 69 65 64 20 6f 75 74 ta is copied out
1f210 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b of the rollback
1f220 20 6a 6f 75 72 6e 61 6c 20 61 6e 64 20 69 6e 74 journal and int
1f230 6f 20 74 68 65 0a 20 20 2a 2a 20 64 61 74 61 62 o the. ** datab
1f240 61 73 65 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 ase. This is not
1f250 20 67 65 6e 65 72 61 6c 6c 79 20 70 6f 73 73 69 generally possi
1f260 62 6c 65 20 77 69 74 68 20 61 20 57 41 4c 20 64 ble with a WAL d
1f270 61 74 61 62 61 73 65 2c 20 61 73 0a 20 20 2a 2a atabase, as. **
1f280 20 72 6f 6c 6c 62 61 63 6b 20 69 6e 76 6f 6c 76 rollback involv
1f290 65 73 20 73 69 6d 70 6c 79 20 74 72 75 6e 63 61 es simply trunca
1f2a0 74 69 6e 67 20 74 68 65 20 6c 6f 67 20 66 69 6c ting the log fil
1f2b0 65 2e 20 54 68 65 72 65 66 6f 72 65 2c 20 69 66 e. Therefore, if
1f2c0 20 6f 6e 65 0a 20 20 2a 2a 20 6f 72 20 6d 6f 72 one. ** or mor
1f2d0 65 20 66 72 61 6d 65 73 20 68 61 76 65 20 61 6c e frames have al
1f2e0 72 65 61 64 79 20 62 65 65 6e 20 77 72 69 74 74 ready been writt
1f2f0 65 6e 20 74 6f 20 74 68 65 20 6c 6f 67 20 28 61 en to the log (a
1f300 6e 64 20 74 68 65 72 65 66 6f 72 65 20 0a 20 20 nd therefore .
1f310 2a 2a 20 61 6c 73 6f 20 63 6f 70 69 65 64 20 69 ** also copied i
1f320 6e 74 6f 20 74 68 65 20 62 61 63 6b 75 70 20 64 nto the backup d
1f330 61 74 61 62 61 73 65 73 29 20 61 73 20 70 61 72 atabases) as par
1f340 74 20 6f 66 20 74 68 69 73 20 74 72 61 6e 73 61 t of this transa
1f350 63 74 69 6f 6e 2c 0a 20 20 2a 2a 20 74 68 65 20 ction,. ** the
1f360 62 61 63 6b 75 70 73 20 6d 75 73 74 20 62 65 20 backups must be
1f370 72 65 73 74 61 72 74 65 64 2e 0a 20 20 2a 2f 0a restarted.. */.
1f380 20 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 52 sqlite3BackupR
1f390 65 73 74 61 72 74 28 70 50 61 67 65 72 2d 3e 70 estart(pPager->p
1f3a0 42 61 63 6b 75 70 29 3b 0a 0a 20 20 72 65 74 75 Backup);.. retu
1f3b0 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 rn rc;.}../*.**
1f3c0 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 This function is
1f3d0 20 63 61 6c 6c 65 64 20 74 6f 20 72 6f 6c 6c 62 called to rollb
1f3e0 61 63 6b 20 61 20 74 72 61 6e 73 61 63 74 69 6f ack a transactio
1f3f0 6e 20 6f 6e 20 61 20 57 41 4c 20 64 61 74 61 62 n on a WAL datab
1f400 61 73 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ase..*/.static i
1f410 6e 74 20 70 61 67 65 72 52 6f 6c 6c 62 61 63 6b nt pagerRollback
1f420 57 61 6c 28 50 61 67 65 72 20 2a 70 50 61 67 65 Wal(Pager *pPage
1f430 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 r){. int rc;
1f440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f450 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
1f460 43 6f 64 65 20 2a 2f 0a 20 20 50 67 48 64 72 20 Code */. PgHdr
1f470 2a 70 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 *pList;
1f480 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 /* Lis
1f490 74 20 6f 66 20 64 69 72 74 79 20 70 61 67 65 73 t of dirty pages
1f4a0 20 74 6f 20 72 65 76 65 72 74 20 2a 2f 0a 0a 20 to revert */..
1f4b0 20 2f 2a 20 46 6f 72 20 61 6c 6c 20 70 61 67 65 /* For all page
1f4c0 73 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 74 s in the cache t
1f4d0 68 61 74 20 61 72 65 20 63 75 72 72 65 6e 74 6c hat are currentl
1f4e0 79 20 64 69 72 74 79 20 6f 72 20 68 61 76 65 20 y dirty or have
1f4f0 61 6c 72 65 61 64 79 0a 20 20 2a 2a 20 62 65 65 already. ** bee
1f500 6e 20 77 72 69 74 74 65 6e 20 28 62 75 74 20 6e n written (but n
1f510 6f 74 20 63 6f 6d 6d 69 74 74 65 64 29 20 74 6f ot committed) to
1f520 20 74 68 65 20 6c 6f 67 20 66 69 6c 65 2c 20 64 the log file, d
1f530 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 0a 20 20 o one of the .
1f540 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a 20 20 ** following:.
1f550 2a 2a 0a 20 20 2a 2a 20 20 20 2b 20 44 69 73 63 **. ** + Disc
1f560 61 72 64 20 74 68 65 20 63 61 63 68 65 64 20 70 ard the cached p
1f570 61 67 65 20 28 69 66 20 72 65 66 63 6f 75 6e 74 age (if refcount
1f580 3d 3d 30 29 2c 20 6f 72 0a 20 20 2a 2a 20 20 20 ==0), or. **
1f590 2b 20 52 65 6c 6f 61 64 20 70 61 67 65 20 63 6f + Reload page co
1f5a0 6e 74 65 6e 74 20 66 72 6f 6d 20 74 68 65 20 64 ntent from the d
1f5b0 61 74 61 62 61 73 65 20 28 69 66 20 72 65 66 63 atabase (if refc
1f5c0 6f 75 6e 74 3e 30 29 2e 0a 20 20 2a 2f 0a 20 20 ount>0).. */.
1f5d0 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 20 3d pPager->dbSize =
1f5e0 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 53 pPager->dbOrigS
1f5f0 69 7a 65 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 ize;. rc = sqli
1f600 74 65 33 57 61 6c 55 6e 64 6f 28 70 50 61 67 65 te3WalUndo(pPage
1f610 72 2d 3e 70 57 61 6c 2c 20 70 61 67 65 72 55 6e r->pWal, pagerUn
1f620 64 6f 43 61 6c 6c 62 61 63 6b 2c 20 28 76 6f 69 doCallback, (voi
1f630 64 20 2a 29 70 50 61 67 65 72 29 3b 0a 20 20 70 d *)pPager);. p
1f640 4c 69 73 74 20 3d 20 73 71 6c 69 74 65 33 50 63 List = sqlite3Pc
1f650 61 63 68 65 44 69 72 74 79 4c 69 73 74 28 70 50 acheDirtyList(pP
1f660 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a ager->pPCache);.
1f670 20 20 77 68 69 6c 65 28 20 70 4c 69 73 74 20 26 while( pList &
1f680 26 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 & rc==SQLITE_OK
1f690 29 7b 0a 20 20 20 20 50 67 48 64 72 20 2a 70 4e ){. PgHdr *pN
1f6a0 65 78 74 20 3d 20 70 4c 69 73 74 2d 3e 70 44 69 ext = pList->pDi
1f6b0 72 74 79 3b 0a 20 20 20 20 72 63 20 3d 20 70 61 rty;. rc = pa
1f6c0 67 65 72 55 6e 64 6f 43 61 6c 6c 62 61 63 6b 28 gerUndoCallback(
1f6d0 28 76 6f 69 64 20 2a 29 70 50 61 67 65 72 2c 20 (void *)pPager,
1f6e0 70 4c 69 73 74 2d 3e 70 67 6e 6f 29 3b 0a 20 20 pList->pgno);.
1f6f0 20 20 70 4c 69 73 74 20 3d 20 70 4e 65 78 74 3b pList = pNext;
1f700 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 . }.. return r
1f710 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
1f720 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 77 function is a w
1f730 72 61 70 70 65 72 20 61 72 6f 75 6e 64 20 73 71 rapper around sq
1f740 6c 69 74 65 33 57 61 6c 46 72 61 6d 65 73 28 29 lite3WalFrames()
1f750 2e 20 41 73 20 77 65 6c 6c 20 61 73 20 6c 6f 67 . As well as log
1f760 67 69 6e 67 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 ging.** the cont
1f770 65 6e 74 73 20 6f 66 20 74 68 65 20 6c 69 73 74 ents of the list
1f780 20 6f 66 20 70 61 67 65 73 20 68 65 61 64 65 64 of pages headed
1f790 20 62 79 20 70 4c 69 73 74 20 28 63 6f 6e 6e 65 by pList (conne
1f7a0 63 74 65 64 20 62 79 20 70 44 69 72 74 79 29 2c cted by pDirty),
1f7b0 0a 2a 2a 20 74 68 69 73 20 66 75 6e 63 74 69 6f .** this functio
1f7c0 6e 20 6e 6f 74 69 66 69 65 73 20 61 6e 79 20 61 n notifies any a
1f7d0 63 74 69 76 65 20 62 61 63 6b 75 70 20 70 72 6f ctive backup pro
1f7e0 63 65 73 73 65 73 20 74 68 61 74 20 74 68 65 20 cesses that the
1f7f0 70 61 67 65 73 20 68 61 76 65 0a 2a 2a 20 63 68 pages have.** ch
1f800 61 6e 67 65 64 2e 20 0a 2a 2a 0a 2a 2a 20 54 68 anged. .**.** Th
1f810 65 20 6c 69 73 74 20 6f 66 20 70 61 67 65 73 20 e list of pages
1f820 70 61 73 73 65 64 20 69 6e 74 6f 20 74 68 69 73 passed into this
1f830 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6c 77 61 routine is alwa
1f840 79 73 20 73 6f 72 74 65 64 20 62 79 20 70 61 67 ys sorted by pag
1f850 65 20 6e 75 6d 62 65 72 2e 0a 2a 2a 20 48 65 6e e number..** Hen
1f860 63 65 2c 20 69 66 20 70 61 67 65 20 31 20 61 70 ce, if page 1 ap
1f870 70 65 61 72 73 20 61 6e 79 77 68 65 72 65 20 6f pears anywhere o
1f880 6e 20 74 68 65 20 6c 69 73 74 2c 20 69 74 20 77 n the list, it w
1f890 69 6c 6c 20 62 65 20 74 68 65 20 66 69 72 73 74 ill be the first
1f8a0 20 70 61 67 65 2e 0a 2a 2f 20 0a 73 74 61 74 69 page..*/ .stati
1f8b0 63 20 69 6e 74 20 70 61 67 65 72 57 61 6c 46 72 c int pagerWalFr
1f8c0 61 6d 65 73 28 0a 20 20 50 61 67 65 72 20 2a 70 ames(. Pager *p
1f8d0 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 20 20 Pager,
1f8e0 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 72 /* Pager
1f8f0 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 50 67 48 object */. PgH
1f900 64 72 20 2a 70 4c 69 73 74 2c 20 20 20 20 20 20 dr *pList,
1f910 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f920 4c 69 73 74 20 6f 66 20 66 72 61 6d 65 73 20 74 List of frames t
1f930 6f 20 6c 6f 67 20 2a 2f 0a 20 20 50 67 6e 6f 20 o log */. Pgno
1f940 6e 54 72 75 6e 63 61 74 65 2c 20 20 20 20 20 20 nTruncate,
1f950 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 /* Da
1f960 74 61 62 61 73 65 20 73 69 7a 65 20 61 66 74 65 tabase size afte
1f970 72 20 74 68 69 73 20 63 6f 6d 6d 69 74 20 2a 2f r this commit */
1f980 0a 20 20 69 6e 74 20 69 73 43 6f 6d 6d 69 74 20 . int isCommit
1f990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f9a0 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 /* True if th
1f9b0 69 73 20 69 73 20 61 20 63 6f 6d 6d 69 74 20 2a is is a commit *
1f9c0 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 /.){. int rc;
1f9d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f9e0 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
1f9f0 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 6e code */. int n
1fa00 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 List;
1fa10 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
1fa20 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e mber of pages in
1fa30 20 70 4c 69 73 74 20 2a 2f 0a 20 20 50 67 48 64 pList */. PgHd
1fa40 72 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 20 r *p;
1fa50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
1fa60 6f 72 20 6c 6f 6f 70 69 6e 67 20 6f 76 65 72 20 or looping over
1fa70 70 61 67 65 73 20 2a 2f 0a 0a 20 20 61 73 73 65 pages */.. asse
1fa80 72 74 28 20 70 50 61 67 65 72 2d 3e 70 57 61 6c rt( pPager->pWal
1fa90 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 4c );. assert( pL
1faa0 69 73 74 20 29 3b 0a 23 69 66 64 65 66 20 53 51 ist );.#ifdef SQ
1fab0 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 2f 2a 20 LITE_DEBUG. /*
1fac0 56 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 Verify that the
1fad0 70 61 67 65 20 6c 69 73 74 20 69 73 20 69 6e 20 page list is in
1fae0 61 63 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 accending order
1faf0 2a 2f 0a 20 20 66 6f 72 28 70 3d 70 4c 69 73 74 */. for(p=pList
1fb00 3b 20 70 20 26 26 20 70 2d 3e 70 44 69 72 74 79 ; p && p->pDirty
1fb10 3b 20 70 3d 70 2d 3e 70 44 69 72 74 79 29 7b 0a ; p=p->pDirty){.
1fb20 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 70 assert( p->p
1fb30 67 6e 6f 20 3c 20 70 2d 3e 70 44 69 72 74 79 2d gno < p->pDirty-
1fb40 3e 70 67 6e 6f 20 29 3b 0a 20 20 7d 0a 23 65 6e >pgno );. }.#en
1fb50 64 69 66 0a 0a 20 20 61 73 73 65 72 74 28 20 70 dif.. assert( p
1fb60 4c 69 73 74 2d 3e 70 44 69 72 74 79 3d 3d 30 20 List->pDirty==0
1fb70 7c 7c 20 69 73 43 6f 6d 6d 69 74 20 29 3b 0a 20 || isCommit );.
1fb80 20 69 66 28 20 69 73 43 6f 6d 6d 69 74 20 29 7b if( isCommit ){
1fb90 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 57 41 4c . /* If a WAL
1fba0 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
1fbb0 62 65 69 6e 67 20 63 6f 6d 6d 69 74 74 65 64 2c being committed,
1fbc0 20 74 68 65 72 65 20 69 73 20 6e 6f 20 70 6f 69 there is no poi
1fbd0 6e 74 20 69 6e 20 77 72 69 74 69 6e 67 0a 20 20 nt in writing.
1fbe0 20 20 2a 2a 20 61 6e 79 20 70 61 67 65 73 20 77 ** any pages w
1fbf0 69 74 68 20 70 61 67 65 20 6e 75 6d 62 65 72 73 ith page numbers
1fc00 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6e 54 greater than nT
1fc10 72 75 6e 63 61 74 65 20 69 6e 74 6f 20 74 68 65 runcate into the
1fc20 20 57 41 4c 20 66 69 6c 65 2e 0a 20 20 20 20 2a WAL file.. *
1fc30 2a 20 54 68 65 79 20 77 69 6c 6c 20 6e 65 76 65 * They will neve
1fc40 72 20 62 65 20 72 65 61 64 20 62 79 20 61 6e 79 r be read by any
1fc50 20 63 6c 69 65 6e 74 2e 20 53 6f 20 72 65 6d 6f client. So remo
1fc60 76 65 20 74 68 65 6d 20 66 72 6f 6d 20 74 68 65 ve them from the
1fc70 20 70 44 69 72 74 79 0a 20 20 20 20 2a 2a 20 6c pDirty. ** l
1fc80 69 73 74 20 68 65 72 65 2e 20 2a 2f 0a 20 20 20 ist here. */.
1fc90 20 50 67 48 64 72 20 2a 2a 70 70 4e 65 78 74 20 PgHdr **ppNext
1fca0 3d 20 26 70 4c 69 73 74 3b 0a 20 20 20 20 6e 4c = &pList;. nL
1fcb0 69 73 74 20 3d 20 30 3b 0a 20 20 20 20 66 6f 72 ist = 0;. for
1fcc0 28 70 3d 70 4c 69 73 74 3b 20 28 2a 70 70 4e 65 (p=pList; (*ppNe
1fcd0 78 74 20 3d 20 70 29 21 3d 30 3b 20 70 3d 70 2d xt = p)!=0; p=p-
1fce0 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 20 20 >pDirty){.
1fcf0 69 66 28 20 70 2d 3e 70 67 6e 6f 3c 3d 6e 54 72 if( p->pgno<=nTr
1fd00 75 6e 63 61 74 65 20 29 7b 0a 20 20 20 20 20 20 uncate ){.
1fd10 20 20 70 70 4e 65 78 74 20 3d 20 26 70 2d 3e 70 ppNext = &p->p
1fd20 44 69 72 74 79 3b 0a 20 20 20 20 20 20 20 20 6e Dirty;. n
1fd30 4c 69 73 74 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a List++;. }.
1fd40 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
1fd50 28 20 70 4c 69 73 74 20 29 3b 0a 20 20 7d 65 6c ( pList );. }el
1fd60 73 65 7b 0a 20 20 20 20 6e 4c 69 73 74 20 3d 20 se{. nList =
1fd70 31 3b 0a 20 20 7d 0a 20 20 70 50 61 67 65 72 2d 1;. }. pPager-
1fd80 3e 61 53 74 61 74 5b 50 41 47 45 52 5f 53 54 41 >aStat[PAGER_STA
1fd90 54 5f 57 52 49 54 45 5d 20 2b 3d 20 6e 4c 69 73 T_WRITE] += nLis
1fda0 74 3b 0a 0a 20 20 69 66 28 20 70 4c 69 73 74 2d t;.. if( pList-
1fdb0 3e 70 67 6e 6f 3d 3d 31 20 29 20 70 61 67 65 72 >pgno==1 ) pager
1fdc0 5f 77 72 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 _write_changecou
1fdd0 6e 74 65 72 28 70 4c 69 73 74 29 3b 0a 20 20 72 nter(pList);. r
1fde0 63 20 3d 20 73 71 6c 69 74 65 33 57 61 6c 46 72 c = sqlite3WalFr
1fdf0 61 6d 65 73 28 70 50 61 67 65 72 2d 3e 70 57 61 ames(pPager->pWa
1fe00 6c 2c 20 0a 20 20 20 20 20 20 70 50 61 67 65 72 l, . pPager
1fe10 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 4c 69 73 ->pageSize, pLis
1fe20 74 2c 20 6e 54 72 75 6e 63 61 74 65 2c 20 69 73 t, nTruncate, is
1fe30 43 6f 6d 6d 69 74 2c 20 70 50 61 67 65 72 2d 3e Commit, pPager->
1fe40 77 61 6c 53 79 6e 63 46 6c 61 67 73 0a 20 20 29 walSyncFlags. )
1fe50 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 ;. if( rc==SQLI
1fe60 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 65 72 2d TE_OK && pPager-
1fe70 3e 70 42 61 63 6b 75 70 20 29 7b 0a 20 20 20 20 >pBackup ){.
1fe80 66 6f 72 28 70 3d 70 4c 69 73 74 3b 20 70 3b 20 for(p=pList; p;
1fe90 70 3d 70 2d 3e 70 44 69 72 74 79 29 7b 0a 20 20 p=p->pDirty){.
1fea0 20 20 20 20 73 71 6c 69 74 65 33 42 61 63 6b 75 sqlite3Backu
1feb0 70 55 70 64 61 74 65 28 70 50 61 67 65 72 2d 3e pUpdate(pPager->
1fec0 70 42 61 63 6b 75 70 2c 20 70 2d 3e 70 67 6e 6f pBackup, p->pgno
1fed0 2c 20 28 75 38 20 2a 29 70 2d 3e 70 44 61 74 61 , (u8 *)p->pData
1fee0 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 23 69 );. }. }..#i
1fef0 66 64 65 66 20 53 51 4c 49 54 45 5f 43 48 45 43 fdef SQLITE_CHEC
1ff00 4b 5f 50 41 47 45 53 0a 20 20 70 4c 69 73 74 20 K_PAGES. pList
1ff10 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 44 = sqlite3PcacheD
1ff20 69 72 74 79 4c 69 73 74 28 70 50 61 67 65 72 2d irtyList(pPager-
1ff30 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 66 6f 72 >pPCache);. for
1ff40 28 70 3d 70 4c 69 73 74 3b 20 70 3b 20 70 3d 70 (p=pList; p; p=p
1ff50 2d 3e 70 44 69 72 74 79 29 7b 0a 20 20 20 20 70 ->pDirty){. p
1ff60 61 67 65 72 5f 73 65 74 5f 70 61 67 65 68 61 73 ager_set_pagehas
1ff70 68 28 70 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 h(p);. }.#endif
1ff80 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
1ff90 0a 0a 2f 2a 0a 2a 2a 20 42 65 67 69 6e 20 61 20 ../*.** Begin a
1ffa0 72 65 61 64 20 74 72 61 6e 73 61 63 74 69 6f 6e read transaction
1ffb0 20 6f 6e 20 74 68 65 20 57 41 4c 2e 0a 2a 2a 0a on the WAL..**.
1ffc0 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
1ffd0 75 73 65 64 20 74 6f 20 62 65 20 63 61 6c 6c 65 used to be calle
1ffe0 64 20 22 70 61 67 65 72 4f 70 65 6e 53 6e 61 70 d "pagerOpenSnap
1fff0 73 68 6f 74 28 29 22 20 62 65 63 61 75 73 65 20 shot()" because
20000 69 74 20 65 73 73 65 6e 74 69 61 6c 6c 79 0a 2a it essentially.*
20010 2a 20 6d 61 6b 65 73 20 61 20 73 6e 61 70 73 68 * makes a snapsh
20020 6f 74 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ot of the databa
20030 73 65 20 61 74 20 74 68 65 20 63 75 72 72 65 6e se at the curren
20040 74 20 70 6f 69 6e 74 20 69 6e 20 74 69 6d 65 20 t point in time
20050 61 6e 64 20 70 72 65 73 65 72 76 65 73 0a 2a 2a and preserves.**
20060 20 74 68 61 74 20 73 6e 61 70 73 68 6f 74 20 66 that snapshot f
20070 6f 72 20 75 73 65 20 62 79 20 74 68 65 20 72 65 or use by the re
20080 61 64 65 72 20 69 6e 20 73 70 69 74 65 20 6f 66 ader in spite of
20090 20 63 6f 6e 63 75 72 72 65 6e 74 6c 79 20 63 68 concurrently ch
200a0 61 6e 67 65 73 20 62 79 0a 2a 2a 20 6f 74 68 65 anges by.** othe
200b0 72 20 77 72 69 74 65 72 73 20 6f 72 20 63 68 65 r writers or che
200c0 63 6b 70 6f 69 6e 74 65 72 73 2e 0a 2a 2f 0a 73 ckpointers..*/.s
200d0 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 42 tatic int pagerB
200e0 65 67 69 6e 52 65 61 64 54 72 61 6e 73 61 63 74 eginReadTransact
200f0 69 6f 6e 28 50 61 67 65 72 20 2a 70 50 61 67 65 ion(Pager *pPage
20100 72 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 r){. int rc;
20110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20120 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
20130 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 63 68 code */. int ch
20140 61 6e 67 65 64 20 3d 20 30 3b 20 20 20 20 20 20 anged = 0;
20150 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
20160 65 20 69 66 20 63 61 63 68 65 20 6d 75 73 74 20 e if cache must
20170 62 65 20 72 65 73 65 74 20 2a 2f 0a 0a 20 20 61 be reset */.. a
20180 73 73 65 72 74 28 20 70 61 67 65 72 55 73 65 57 ssert( pagerUseW
20190 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 al(pPager) );.
201a0 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
201b0 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f 50 eState==PAGER_OP
201c0 45 4e 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 EN || pPager->eS
201d0 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 41 44 tate==PAGER_READ
201e0 45 52 20 29 3b 0a 0a 20 20 2f 2a 20 73 71 6c 69 ER );.. /* sqli
201f0 74 65 33 57 61 6c 45 6e 64 52 65 61 64 54 72 61 te3WalEndReadTra
20200 6e 73 61 63 74 69 6f 6e 28 29 20 77 61 73 20 6e nsaction() was n
20210 6f 74 20 63 61 6c 6c 65 64 20 66 6f 72 20 74 68 ot called for th
20220 65 20 70 72 65 76 69 6f 75 73 0a 20 20 2a 2a 20 e previous. **
20230 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 20 6c transaction in l
20240 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 45 58 43 4c ocking_mode=EXCL
20250 55 53 49 56 45 2e 20 20 53 6f 20 63 61 6c 6c 20 USIVE. So call
20260 69 74 20 6e 6f 77 2e 20 20 49 66 20 77 65 0a 20 it now. If we.
20270 20 2a 2a 20 61 72 65 20 69 6e 20 6c 6f 63 6b 69 ** are in locki
20280 6e 67 5f 6d 6f 64 65 3d 4e 4f 52 4d 41 4c 20 61 ng_mode=NORMAL a
20290 6e 64 20 45 6e 64 52 65 61 64 28 29 20 77 61 73 nd EndRead() was
202a0 20 70 72 65 76 69 6f 75 73 6c 79 20 63 61 6c 6c previously call
202b0 65 64 2c 0a 20 20 2a 2a 20 74 68 65 20 64 75 70 ed,. ** the dup
202c0 6c 69 63 61 74 65 20 63 61 6c 6c 20 69 73 20 68 licate call is h
202d0 61 72 6d 6c 65 73 73 2e 0a 20 20 2a 2f 0a 20 20 armless.. */.
202e0 73 71 6c 69 74 65 33 57 61 6c 45 6e 64 52 65 61 sqlite3WalEndRea
202f0 64 54 72 61 6e 73 61 63 74 69 6f 6e 28 70 50 61 dTransaction(pPa
20300 67 65 72 2d 3e 70 57 61 6c 29 3b 0a 0a 20 20 72 ger->pWal);.. r
20310 63 20 3d 20 73 71 6c 69 74 65 33 57 61 6c 42 65 c = sqlite3WalBe
20320 67 69 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 ginReadTransacti
20330 6f 6e 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c on(pPager->pWal,
20340 20 26 63 68 61 6e 67 65 64 29 3b 0a 20 20 69 66 &changed);. if
20350 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
20360 7c 7c 20 63 68 61 6e 67 65 64 20 29 7b 0a 20 20 || changed ){.
20370 20 20 70 61 67 65 72 5f 72 65 73 65 74 28 70 50 pager_reset(pP
20380 61 67 65 72 29 3b 0a 20 20 20 20 69 66 28 20 55 ager);. if( U
20390 53 45 46 45 54 43 48 28 70 50 61 67 65 72 29 20 SEFETCH(pPager)
203a0 29 20 73 71 6c 69 74 65 33 4f 73 55 6e 66 65 74 ) sqlite3OsUnfet
203b0 63 68 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 30 ch(pPager->fd, 0
203c0 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 , 0);. }.. ret
203d0 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 urn rc;.}.#endif
203e0 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
203f0 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
20400 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 74 as part of the t
20410 72 61 6e 73 69 74 69 6f 6e 20 66 72 6f 6d 20 50 ransition from P
20420 41 47 45 52 5f 4f 50 45 4e 0a 2a 2a 20 74 6f 20 AGER_OPEN.** to
20430 50 41 47 45 52 5f 52 45 41 44 45 52 20 73 74 61 PAGER_READER sta
20440 74 65 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 te to determine
20450 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 the size of the
20460 64 61 74 61 62 61 73 65 20 66 69 6c 65 0a 2a 2a database file.**
20470 20 69 6e 20 70 61 67 65 73 20 28 61 73 73 75 6d in pages (assum
20480 69 6e 67 20 74 68 65 20 70 61 67 65 20 73 69 7a ing the page siz
20490 65 20 63 75 72 72 65 6e 74 6c 79 20 73 74 6f 72 e currently stor
204a0 65 64 20 69 6e 20 50 61 67 65 72 2e 70 61 67 65 ed in Pager.page
204b0 53 69 7a 65 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 Size)..**.** If
204c0 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c no error occurs,
204d0 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 SQLITE_OK is re
204e0 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 73 turned and the s
204f0 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ize of the datab
20500 61 73 65 0a 2a 2a 20 69 6e 20 70 61 67 65 73 20 ase.** in pages
20510 69 73 20 73 74 6f 72 65 64 20 69 6e 20 2a 70 6e is stored in *pn
20520 50 61 67 65 2e 20 4f 74 68 65 72 77 69 73 65 2c Page. Otherwise,
20530 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 28 an error code (
20540 70 65 72 68 61 70 73 0a 2a 2a 20 53 51 4c 49 54 perhaps.** SQLIT
20550 45 5f 49 4f 45 52 52 5f 46 53 54 41 54 29 20 69 E_IOERR_FSTAT) i
20560 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a s returned and *
20570 70 6e 50 61 67 65 20 69 73 20 6c 65 66 74 20 75 pnPage is left u
20580 6e 6d 6f 64 69 66 69 65 64 2e 0a 2a 2f 0a 73 74 nmodified..*/.st
20590 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 50 61 atic int pagerPa
205a0 67 65 63 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 gecount(Pager *p
205b0 50 61 67 65 72 2c 20 50 67 6e 6f 20 2a 70 6e 50 Pager, Pgno *pnP
205c0 61 67 65 29 7b 0a 20 20 50 67 6e 6f 20 6e 50 61 age){. Pgno nPa
205d0 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
205e0 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 /* Value
205f0 20 74 6f 20 72 65 74 75 72 6e 20 76 69 61 20 2a to return via *
20600 70 6e 50 61 67 65 20 2a 2f 0a 0a 20 20 2f 2a 20 pnPage */.. /*
20610 51 75 65 72 79 20 74 68 65 20 57 41 4c 20 73 75 Query the WAL su
20620 62 2d 73 79 73 74 65 6d 20 66 6f 72 20 74 68 65 b-system for the
20630 20 64 61 74 61 62 61 73 65 20 73 69 7a 65 2e 20 database size.
20640 54 68 65 20 57 61 6c 44 62 73 69 7a 65 28 29 0a The WalDbsize().
20650 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72 65 ** function re
20660 74 75 72 6e 73 20 7a 65 72 6f 20 69 66 20 74 68 turns zero if th
20670 65 20 57 41 4c 20 69 73 20 6e 6f 74 20 6f 70 65 e WAL is not ope
20680 6e 20 28 69 2e 65 2e 20 50 61 67 65 72 2e 70 57 n (i.e. Pager.pW
20690 61 6c 3d 3d 30 29 2c 20 6f 72 0a 20 20 2a 2a 20 al==0), or. **
206a0 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 if the database
206b0 73 69 7a 65 20 69 73 20 6e 6f 74 20 61 76 61 69 size is not avai
206c0 6c 61 62 6c 65 2e 20 54 68 65 20 64 61 74 61 62 lable. The datab
206d0 61 73 65 20 73 69 7a 65 20 69 73 20 6e 6f 74 0a ase size is not.
206e0 20 20 2a 2a 20 61 76 61 69 6c 61 62 6c 65 20 66 ** available f
206f0 72 6f 6d 20 74 68 65 20 57 41 4c 20 73 75 62 2d rom the WAL sub-
20700 73 79 73 74 65 6d 20 69 66 20 74 68 65 20 6c 6f system if the lo
20710 67 20 66 69 6c 65 20 69 73 20 65 6d 70 74 79 20 g file is empty
20720 6f 72 0a 20 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 or. ** contains
20730 20 6e 6f 20 76 61 6c 69 64 20 63 6f 6d 6d 69 74 no valid commit
20740 74 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 ted transactions
20750 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 .. */. assert(
20760 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
20770 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 =PAGER_OPEN );.
20780 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
20790 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c >eLock>=SHARED_L
207a0 4f 43 4b 20 29 3b 0a 20 20 61 73 73 65 72 74 28 OCK );. assert(
207b0 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
207c0 66 64 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 fd) );. assert(
207d0 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c pPager->tempFil
207e0 65 3d 3d 30 20 29 3b 0a 20 20 6e 50 61 67 65 20 e==0 );. nPage
207f0 3d 20 73 71 6c 69 74 65 33 57 61 6c 44 62 73 69 = sqlite3WalDbsi
20800 7a 65 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 29 ze(pPager->pWal)
20810 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 6e ;.. /* If the n
20820 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 umber of pages i
20830 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 n the database i
20840 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 s not available
20850 66 72 6f 6d 20 74 68 65 0a 20 20 2a 2a 20 57 41 from the. ** WA
20860 4c 20 73 75 62 2d 73 79 73 74 65 6d 2c 20 64 65 L sub-system, de
20870 74 65 72 6d 69 6e 65 20 74 68 65 20 70 61 67 65 termine the page
20880 20 63 6f 75 6e 74 20 62 61 73 65 64 20 6f 6e 20 count based on
20890 74 68 65 20 73 69 7a 65 20 6f 66 0a 20 20 2a 2a the size of. **
208a0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
208b0 6c 65 2e 20 20 49 66 20 74 68 65 20 73 69 7a 65 le. If the size
208c0 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 of the database
208d0 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 6e 0a file is not an.
208e0 20 20 2a 2a 20 69 6e 74 65 67 65 72 20 6d 75 6c ** integer mul
208f0 74 69 70 6c 65 20 6f 66 20 74 68 65 20 70 61 67 tiple of the pag
20900 65 2d 73 69 7a 65 2c 20 72 6f 75 6e 64 20 75 70 e-size, round up
20910 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 20 20 2a the result.. *
20920 2f 0a 20 20 69 66 28 20 6e 50 61 67 65 3d 3d 30 /. if( nPage==0
20930 20 26 26 20 41 4c 57 41 59 53 28 69 73 4f 70 65 && ALWAYS(isOpe
20940 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 29 20 29 n(pPager->fd)) )
20950 7b 0a 20 20 20 20 69 36 34 20 6e 20 3d 20 30 3b {. i64 n = 0;
20960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20970 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 64 /* Size of d
20980 62 20 66 69 6c 65 20 69 6e 20 62 79 74 65 73 20 b file in bytes
20990 2a 2f 0a 20 20 20 20 69 6e 74 20 72 63 20 3d 20 */. int rc =
209a0 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 69 7a sqlite3OsFileSiz
209b0 65 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 6e e(pPager->fd, &n
209c0 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
209d0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
209e0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 return rc;.
209f0 20 7d 0a 20 20 20 20 6e 50 61 67 65 20 3d 20 28 }. nPage = (
20a00 50 67 6e 6f 29 28 28 6e 2b 70 50 61 67 65 72 2d Pgno)((n+pPager-
20a10 3e 70 61 67 65 53 69 7a 65 2d 31 29 20 2f 20 70 >pageSize-1) / p
20a20 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 Pager->pageSize)
20a30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 ;. }.. /* If t
20a40 68 65 20 63 75 72 72 65 6e 74 20 6e 75 6d 62 65 he current numbe
20a50 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 74 68 r of pages in th
20a60 65 20 66 69 6c 65 20 69 73 20 67 72 65 61 74 65 e file is greate
20a70 72 20 74 68 61 6e 20 74 68 65 0a 20 20 2a 2a 20 r than the. **
20a80 63 6f 6e 66 69 67 75 72 65 64 20 6d 61 78 69 6d configured maxim
20a90 75 6d 20 70 61 67 65 72 20 6e 75 6d 62 65 72 2c um pager number,
20aa0 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 61 6c increase the al
20ab0 6c 6f 77 65 64 20 6c 69 6d 69 74 20 73 6f 0a 20 lowed limit so.
20ac0 20 2a 2a 20 74 68 61 74 20 74 68 65 20 66 69 6c ** that the fil
20ad0 65 20 63 61 6e 20 62 65 20 72 65 61 64 2e 0a 20 e can be read..
20ae0 20 2a 2f 0a 20 20 69 66 28 20 6e 50 61 67 65 3e */. if( nPage>
20af0 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 29 pPager->mxPgno )
20b00 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6d 78 {. pPager->mx
20b10 50 67 6e 6f 20 3d 20 28 50 67 6e 6f 29 6e 50 61 Pgno = (Pgno)nPa
20b20 67 65 3b 0a 20 20 7d 0a 0a 20 20 2a 70 6e 50 61 ge;. }.. *pnPa
20b30 67 65 20 3d 20 6e 50 61 67 65 3b 0a 20 20 72 65 ge = nPage;. re
20b40 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a turn SQLITE_OK;.
20b50 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 }..#ifndef SQLIT
20b60 45 5f 4f 4d 49 54 5f 57 41 4c 0a 2f 2a 0a 2a 2a E_OMIT_WAL./*.**
20b70 20 43 68 65 63 6b 20 69 66 20 74 68 65 20 2a 2d Check if the *-
20b80 77 61 6c 20 66 69 6c 65 20 74 68 61 74 20 63 6f wal file that co
20b90 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 rresponds to the
20ba0 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 65 64 database opened
20bb0 20 62 79 20 70 50 61 67 65 72 0a 2a 2a 20 65 78 by pPager.** ex
20bc0 69 73 74 73 20 69 66 20 74 68 65 20 64 61 74 61 ists if the data
20bd0 62 61 73 65 20 69 73 20 6e 6f 74 20 65 6d 70 79 base is not empy
20be0 2c 20 6f 72 20 76 65 72 69 66 79 20 74 68 61 74 , or verify that
20bf0 20 74 68 65 20 2a 2d 77 61 6c 20 66 69 6c 65 20 the *-wal file
20c00 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 78 69 73 does.** not exis
20c10 74 20 28 62 79 20 64 65 6c 65 74 69 6e 67 20 69 t (by deleting i
20c20 74 29 20 69 66 20 74 68 65 20 64 61 74 61 62 61 t) if the databa
20c30 73 65 20 66 69 6c 65 20 69 73 20 65 6d 70 74 79 se file is empty
20c40 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 ..**.** If the d
20c50 61 74 61 62 61 73 65 20 69 73 20 6e 6f 74 20 65 atabase is not e
20c60 6d 70 74 79 20 61 6e 64 20 74 68 65 20 2a 2d 77 mpty and the *-w
20c70 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 al file exists,
20c80 6f 70 65 6e 20 74 68 65 20 70 61 67 65 72 0a 2a open the pager.*
20c90 2a 20 69 6e 20 57 41 4c 20 6d 6f 64 65 2e 20 20 * in WAL mode.
20ca0 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
20cb0 69 73 20 65 6d 70 74 79 20 6f 72 20 69 66 20 6e is empty or if n
20cc0 6f 20 2a 2d 77 61 6c 20 66 69 6c 65 20 65 78 69 o *-wal file exi
20cd0 73 74 73 20 61 6e 64 0a 2a 2a 20 69 66 20 6e 6f sts and.** if no
20ce0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 6d error occurs, m
20cf0 61 6b 65 20 73 75 72 65 20 50 61 67 65 72 2e 6a ake sure Pager.j
20d00 6f 75 72 6e 61 6c 4d 6f 64 65 20 69 73 20 6e 6f ournalMode is no
20d10 74 20 73 65 74 20 74 6f 0a 2a 2a 20 50 41 47 45 t set to.** PAGE
20d20 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 57 41 R_JOURNALMODE_WA
20d30 4c 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 L..**.** Return
20d40 53 51 4c 49 54 45 5f 4f 4b 20 6f 72 20 61 6e 20 SQLITE_OK or an
20d50 65 72 72 6f 72 20 63 6f 64 65 2e 0a 2a 2a 0a 2a error code..**.*
20d60 2a 20 54 68 65 20 63 61 6c 6c 65 72 20 6d 75 73 * The caller mus
20d70 74 20 68 6f 6c 64 20 61 20 53 48 41 52 45 44 20 t hold a SHARED
20d80 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 61 lock on the data
20d90 62 61 73 65 20 66 69 6c 65 20 74 6f 20 63 61 6c base file to cal
20da0 6c 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 l this.** functi
20db0 6f 6e 2e 20 42 65 63 61 75 73 65 20 61 6e 20 45 on. Because an E
20dc0 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e XCLUSIVE lock on
20dd0 20 74 68 65 20 64 62 20 66 69 6c 65 20 69 73 20 the db file is
20de0 72 65 71 75 69 72 65 64 20 74 6f 20 64 65 6c 65 required to dele
20df0 74 65 20 0a 2a 2a 20 61 20 57 41 4c 20 6f 6e 20 te .** a WAL on
20e00 61 20 6e 6f 6e 65 2d 65 6d 70 74 79 20 64 61 74 a none-empty dat
20e10 61 62 61 73 65 2c 20 74 68 69 73 20 65 6e 73 75 abase, this ensu
20e20 72 65 73 20 74 68 65 72 65 20 69 73 20 6e 6f 20 res there is no
20e30 72 61 63 65 20 63 6f 6e 64 69 74 69 6f 6e 20 0a race condition .
20e40 2a 2a 20 62 65 74 77 65 65 6e 20 74 68 65 20 78 ** between the x
20e50 41 63 63 65 73 73 28 29 20 62 65 6c 6f 77 20 61 Access() below a
20e60 6e 64 20 61 6e 20 78 44 65 6c 65 74 65 28 29 20 nd an xDelete()
20e70 62 65 69 6e 67 20 65 78 65 63 75 74 65 64 20 62 being executed b
20e80 79 20 73 6f 6d 65 20 0a 2a 2a 20 6f 74 68 65 72 y some .** other
20e90 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a connection..*/.
20ea0 73 74 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 static int pager
20eb0 4f 70 65 6e 57 61 6c 49 66 50 72 65 73 65 6e 74 OpenWalIfPresent
20ec0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
20ed0 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 . int rc = SQLI
20ee0 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28 TE_OK;. assert(
20ef0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
20f00 3d 50 41 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 =PAGER_OPEN );.
20f10 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
20f20 3e 65 4c 6f 63 6b 3e 3d 53 48 41 52 45 44 5f 4c >eLock>=SHARED_L
20f30 4f 43 4b 20 29 3b 0a 0a 20 20 69 66 28 20 21 70 OCK );.. if( !p
20f40 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 Pager->tempFile
20f50 29 7b 0a 20 20 20 20 69 6e 74 20 69 73 57 61 6c ){. int isWal
20f60 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
20f70 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
20f80 57 41 4c 20 66 69 6c 65 20 65 78 69 73 74 73 20 WAL file exists
20f90 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 */. rc = sqli
20fa0 74 65 33 4f 73 41 63 63 65 73 73 28 0a 20 20 20 te3OsAccess(.
20fb0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 56 66 pPager->pVf
20fc0 73 2c 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 2c s, pPager->zWal,
20fd0 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 5f 45 SQLITE_ACCESS_E
20fe0 58 49 53 54 53 2c 20 26 69 73 57 61 6c 0a 20 20 XISTS, &isWal.
20ff0 20 20 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d );. if( rc=
21000 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
21010 20 20 20 20 69 66 28 20 69 73 57 61 6c 20 29 7b if( isWal ){
21020 0a 20 20 20 20 20 20 20 20 50 67 6e 6f 20 6e 50 . Pgno nP
21030 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
21040 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
21050 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 f the database f
21060 69 6c 65 20 2a 2f 0a 0a 20 20 20 20 20 20 20 20 ile */..
21070 72 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f rc = pagerPageco
21080 75 6e 74 28 70 50 61 67 65 72 2c 20 26 6e 50 61 unt(pPager, &nPa
21090 67 65 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ge);. if(
210a0 20 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b rc ) return rc;
210b0 0a 20 20 20 20 20 20 20 20 69 66 28 20 6e 50 61 . if( nPa
210c0 67 65 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 ge==0 ){.
210d0 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
210e0 73 44 65 6c 65 74 65 28 70 50 61 67 65 72 2d 3e sDelete(pPager->
210f0 70 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 57 pVfs, pPager->zW
21100 61 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 al, 0);.
21110 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
21120 20 74 65 73 74 63 61 73 65 28 20 73 71 6c 69 74 testcase( sqlit
21130 65 33 50 63 61 63 68 65 50 61 67 65 63 6f 75 6e e3PcachePagecoun
21140 74 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 t(pPager->pPCach
21150 65 29 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 e)==0 );.
21160 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 rc = sqlite3P
21170 61 67 65 72 4f 70 65 6e 57 61 6c 28 70 50 61 67 agerOpenWal(pPag
21180 65 72 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 er, 0);.
21190 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }. }else if
211a0 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ( pPager->journa
211b0 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 lMode==PAGER_JOU
211c0 52 4e 41 4c 4d 4f 44 45 5f 57 41 4c 20 29 7b 0a RNALMODE_WAL ){.
211d0 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e pPager->
211e0 6a 6f 75 72 6e 61 6c 4d 6f 64 65 20 3d 20 50 41 journalMode = PA
211f0 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f GER_JOURNALMODE_
21200 44 45 4c 45 54 45 3b 0a 20 20 20 20 20 20 7d 0a DELETE;. }.
21210 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 }. }. retu
21220 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 0a rn rc;.}.#endif.
21230 0a 2f 2a 0a 2a 2a 20 50 6c 61 79 62 61 63 6b 20 ./*.** Playback
21240 73 61 76 65 70 6f 69 6e 74 20 70 53 61 76 65 70 savepoint pSavep
21250 6f 69 6e 74 2e 20 4f 72 2c 20 69 66 20 70 53 61 oint. Or, if pSa
21260 76 65 70 6f 69 6e 74 3d 3d 4e 55 4c 4c 2c 20 74 vepoint==NULL, t
21270 68 65 6e 20 70 6c 61 79 62 61 63 6b 0a 2a 2a 20 hen playback.**
21280 74 68 65 20 65 6e 74 69 72 65 20 6d 61 73 74 65 the entire maste
21290 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 r journal file.
212a0 54 68 65 20 63 61 73 65 20 70 53 61 76 65 70 6f The case pSavepo
212b0 69 6e 74 3d 3d 4e 55 4c 4c 20 6f 63 63 75 72 73 int==NULL occurs
212c0 20 77 68 65 6e 20 0a 2a 2a 20 61 20 52 4f 4c 4c when .** a ROLL
212d0 42 41 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 20 BACK TO command
212e0 69 73 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 61 20 is invoked on a
212f0 53 41 56 45 50 4f 49 4e 54 20 74 68 61 74 20 69 SAVEPOINT that i
21300 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 s a transaction
21310 0a 2a 2a 20 73 61 76 65 70 6f 69 6e 74 2e 0a 2a .** savepoint..*
21320 2a 0a 2a 2a 20 57 68 65 6e 20 70 53 61 76 65 70 *.** When pSavep
21330 6f 69 6e 74 20 69 73 20 6e 6f 74 20 4e 55 4c 4c oint is not NULL
21340 20 28 6d 65 61 6e 69 6e 67 20 61 20 6e 6f 6e 2d (meaning a non-
21350 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 transaction save
21360 70 6f 69 6e 74 20 69 73 20 0a 2a 2a 20 62 65 69 point is .** bei
21370 6e 67 20 72 6f 6c 6c 65 64 20 62 61 63 6b 29 2c ng rolled back),
21380 20 74 68 65 6e 20 74 68 65 20 72 6f 6c 6c 62 61 then the rollba
21390 63 6b 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 75 ck consists of u
213a0 70 20 74 6f 20 74 68 72 65 65 20 73 74 61 67 65 p to three stage
213b0 73 2c 0a 2a 2a 20 70 65 72 66 6f 72 6d 65 64 20 s,.** performed
213c0 69 6e 20 74 68 65 20 6f 72 64 65 72 20 73 70 65 in the order spe
213d0 63 69 66 69 65 64 3a 0a 2a 2a 0a 2a 2a 20 20 20 cified:.**.**
213e0 2a 20 50 61 67 65 73 20 61 72 65 20 70 6c 61 79 * Pages are play
213f0 65 64 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 ed back from the
21400 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 main journal st
21410 61 72 74 69 6e 67 20 61 74 20 62 79 74 65 0a 2a arting at byte.*
21420 2a 20 20 20 20 20 6f 66 66 73 65 74 20 50 61 67 * offset Pag
21430 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 4f 66 66 erSavepoint.iOff
21440 73 65 74 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 set and continui
21450 6e 67 20 74 6f 20 0a 2a 2a 20 20 20 20 20 50 61 ng to .** Pa
21460 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 48 64 gerSavepoint.iHd
21470 72 4f 66 66 73 65 74 2c 20 6f 72 20 74 6f 20 74 rOffset, or to t
21480 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 he end of the ma
21490 69 6e 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 in journal.**
214a0 20 20 66 69 6c 65 20 69 66 20 50 61 67 65 72 53 file if PagerS
214b0 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 avepoint.iHdrOff
214c0 73 65 74 20 69 73 20 7a 65 72 6f 2e 0a 2a 2a 0a set is zero..**.
214d0 2a 2a 20 20 20 2a 20 49 66 20 50 61 67 65 72 53 ** * If PagerS
214e0 61 76 65 70 6f 69 6e 74 2e 69 48 64 72 4f 66 66 avepoint.iHdrOff
214f0 73 65 74 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c set is not zero,
21500 20 74 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 then pages are
21510 70 6c 61 79 65 64 0a 2a 2a 20 20 20 20 20 62 61 played.** ba
21520 63 6b 20 73 74 61 72 74 69 6e 67 20 66 72 6f 6d ck starting from
21530 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 68 65 61 the journal hea
21540 64 65 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 der immediately
21550 66 6f 6c 6c 6f 77 69 6e 67 20 0a 2a 2a 20 20 20 following .**
21560 20 20 50 61 67 65 72 53 61 76 65 70 6f 69 6e 74 PagerSavepoint
21570 2e 69 48 64 72 4f 66 66 73 65 74 20 74 6f 20 74 .iHdrOffset to t
21580 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 6d 61 he end of the ma
21590 69 6e 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e in journal file.
215a0 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 50 61 67 65 73 .**.** * Pages
215b0 20 61 72 65 20 74 68 65 6e 20 70 6c 61 79 65 64 are then played
215c0 20 62 61 63 6b 20 66 72 6f 6d 20 74 68 65 20 73 back from the s
215d0 75 62 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c ub-journal file,
215e0 20 73 74 61 72 74 69 6e 67 0a 2a 2a 20 20 20 20 starting.**
215f0 20 77 69 74 68 20 74 68 65 20 50 61 67 65 72 53 with the PagerS
21600 61 76 65 70 6f 69 6e 74 2e 69 53 75 62 52 65 63 avepoint.iSubRec
21610 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 and continuing
21620 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 0a 2a 2a to the end of.**
21630 20 20 20 20 20 74 68 65 20 6a 6f 75 72 6e 61 6c the journal
21640 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 72 file..**.** Thr
21650 6f 75 67 68 6f 75 74 20 74 68 65 20 72 6f 6c 6c oughout the roll
21660 62 61 63 6b 20 70 72 6f 63 65 73 73 2c 20 65 61 back process, ea
21670 63 68 20 74 69 6d 65 20 61 20 70 61 67 65 20 69 ch time a page i
21680 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 74 s rolled back, t
21690 68 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 he.** correspond
216a0 69 6e 67 20 62 69 74 20 69 73 20 73 65 74 20 69 ing bit is set i
216b0 6e 20 61 20 62 69 74 76 65 63 20 73 74 72 75 63 n a bitvec struc
216c0 74 75 72 65 20 28 76 61 72 69 61 62 6c 65 20 70 ture (variable p
216d0 44 6f 6e 65 20 69 6e 20 74 68 65 0a 2a 2a 20 69 Done in the.** i
216e0 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 62 65 mplementation be
216f0 6c 6f 77 29 2e 20 54 68 69 73 20 69 73 20 75 73 low). This is us
21700 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68 61 ed to ensure tha
21710 74 20 61 20 70 61 67 65 20 69 73 20 6f 6e 6c 79 t a page is only
21720 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 .** rolled back
21730 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 69 the first time i
21740 74 20 69 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 t is encountered
21750 20 69 6e 20 65 69 74 68 65 72 20 6a 6f 75 72 6e in either journ
21760 61 6c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 53 61 al..**.** If pSa
21770 76 65 70 6f 69 6e 74 20 69 73 20 4e 55 4c 4c 2c vepoint is NULL,
21780 20 74 68 65 6e 20 70 61 67 65 73 20 61 72 65 20 then pages are
21790 6f 6e 6c 79 20 70 6c 61 79 65 64 20 62 61 63 6b only played back
217a0 20 66 72 6f 6d 20 74 68 65 20 6d 61 69 6e 0a 2a from the main.*
217b0 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 * journal file.
217c0 54 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 There is no need
217d0 20 66 6f 72 20 61 20 62 69 74 76 65 63 20 69 6e for a bitvec in
217e0 20 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a this case..**.*
217f0 2a 20 49 6e 20 65 69 74 68 65 72 20 63 61 73 65 * In either case
21800 2c 20 62 65 66 6f 72 65 20 70 6c 61 79 62 61 63 , before playbac
21810 6b 20 63 6f 6d 6d 65 6e 63 65 73 20 74 68 65 20 k commences the
21820 50 61 67 65 72 2e 64 62 53 69 7a 65 20 76 61 72 Pager.dbSize var
21830 69 61 62 6c 65 0a 2a 2a 20 69 73 20 72 65 73 65 iable.** is rese
21840 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 74 t to the value t
21850 68 61 74 20 69 74 20 68 65 6c 64 20 61 74 20 74 hat it held at t
21860 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 he start of the
21870 73 61 76 65 70 6f 69 6e 74 20 0a 2a 2a 20 28 6f savepoint .** (o
21880 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2e 20 r transaction).
21890 4e 6f 20 70 61 67 65 20 77 69 74 68 20 61 20 70 No page with a p
218a0 61 67 65 2d 6e 75 6d 62 65 72 20 67 72 65 61 74 age-number great
218b0 65 72 20 74 68 61 6e 20 74 68 69 73 20 76 61 6c er than this val
218c0 75 65 0a 2a 2a 20 69 73 20 70 6c 61 79 65 64 20 ue.** is played
218d0 62 61 63 6b 2e 20 49 66 20 6f 6e 65 20 69 73 20 back. If one is
218e0 65 6e 63 6f 75 6e 74 65 72 65 64 20 69 74 20 69 encountered it i
218f0 73 20 73 69 6d 70 6c 79 20 73 6b 69 70 70 65 64 s simply skipped
21900 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
21910 70 61 67 65 72 50 6c 61 79 62 61 63 6b 53 61 76 pagerPlaybackSav
21920 65 70 6f 69 6e 74 28 50 61 67 65 72 20 2a 70 50 epoint(Pager *pP
21930 61 67 65 72 2c 20 50 61 67 65 72 53 61 76 65 70 ager, PagerSavep
21940 6f 69 6e 74 20 2a 70 53 61 76 65 70 6f 69 6e 74 oint *pSavepoint
21950 29 7b 0a 20 20 69 36 34 20 73 7a 4a 3b 20 20 20 ){. i64 szJ;
21960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21970 20 45 66 66 65 63 74 69 76 65 20 73 69 7a 65 20 Effective size
21980 6f 66 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 of the main jour
21990 6e 61 6c 20 2a 2f 0a 20 20 69 36 34 20 69 48 64 nal */. i64 iHd
219a0 72 4f 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 rOff;
219b0 20 20 2f 2a 20 45 6e 64 20 6f 66 20 66 69 72 73 /* End of firs
219c0 74 20 73 65 67 6d 65 6e 74 20 6f 66 20 6d 61 69 t segment of mai
219d0 6e 2d 6a 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 n-journal record
219e0 73 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 s */. int rc =
219f0 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
21a00 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
21a10 2f 0a 20 20 42 69 74 76 65 63 20 2a 70 44 6f 6e /. Bitvec *pDon
21a20 65 20 3d 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 e = 0; /*
21a30 42 69 74 76 65 63 20 74 6f 20 65 6e 73 75 72 65 Bitvec to ensure
21a40 20 70 61 67 65 73 20 70 6c 61 79 65 64 20 62 61 pages played ba
21a50 63 6b 20 6f 6e 6c 79 20 6f 6e 63 65 20 2a 2f 0a ck only once */.
21a60 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
21a70 72 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 r->eState!=PAGER
21a80 5f 45 52 52 4f 52 20 29 3b 0a 20 20 61 73 73 65 _ERROR );. asse
21a90 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
21aa0 74 65 3e 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te>=PAGER_WRITER
21ab0 5f 4c 4f 43 4b 45 44 20 29 3b 0a 0a 20 20 2f 2a _LOCKED );.. /*
21ac0 20 41 6c 6c 6f 63 61 74 65 20 61 20 62 69 74 76 Allocate a bitv
21ad0 65 63 20 74 6f 20 75 73 65 20 74 6f 20 73 74 6f ec to use to sto
21ae0 72 65 20 74 68 65 20 73 65 74 20 6f 66 20 70 61 re the set of pa
21af0 67 65 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 ges rolled back
21b00 2a 2f 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f */. if( pSavepo
21b10 69 6e 74 20 29 7b 0a 20 20 20 20 70 44 6f 6e 65 int ){. pDone
21b20 20 3d 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 = sqlite3Bitvec
21b30 43 72 65 61 74 65 28 70 53 61 76 65 70 6f 69 6e Create(pSavepoin
21b40 74 2d 3e 6e 4f 72 69 67 29 3b 0a 20 20 20 20 69 t->nOrig);. i
21b50 66 28 20 21 70 44 6f 6e 65 20 29 7b 0a 20 20 20 f( !pDone ){.
21b60 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
21b70 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
21b80 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 65 74 }. }.. /* Set
21b90 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 69 the database si
21ba0 7a 65 20 62 61 63 6b 20 74 6f 20 74 68 65 20 76 ze back to the v
21bb0 61 6c 75 65 20 69 74 20 77 61 73 20 62 65 66 6f alue it was befo
21bc0 72 65 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 re the savepoint
21bd0 20 0a 20 20 2a 2a 20 62 65 69 6e 67 20 72 65 76 . ** being rev
21be0 65 72 74 65 64 20 77 61 73 20 6f 70 65 6e 65 64 erted was opened
21bf0 2e 0a 20 20 2a 2f 0a 20 20 70 50 61 67 65 72 2d .. */. pPager-
21c00 3e 64 62 53 69 7a 65 20 3d 20 70 53 61 76 65 70 >dbSize = pSavep
21c10 6f 69 6e 74 20 3f 20 70 53 61 76 65 70 6f 69 6e oint ? pSavepoin
21c20 74 2d 3e 6e 4f 72 69 67 20 3a 20 70 50 61 67 65 t->nOrig : pPage
21c30 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 3b 0a 20 r->dbOrigSize;.
21c40 20 70 50 61 67 65 72 2d 3e 63 68 61 6e 67 65 43 pPager->changeC
21c50 6f 75 6e 74 44 6f 6e 65 20 3d 20 70 50 61 67 65 ountDone = pPage
21c60 72 2d 3e 74 65 6d 70 46 69 6c 65 3b 0a 0a 20 20 r->tempFile;..
21c70 69 66 28 20 21 70 53 61 76 65 70 6f 69 6e 74 20 if( !pSavepoint
21c80 26 26 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 && pagerUseWal(p
21c90 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 72 65 Pager) ){. re
21ca0 74 75 72 6e 20 70 61 67 65 72 52 6f 6c 6c 62 61 turn pagerRollba
21cb0 63 6b 57 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 ckWal(pPager);.
21cc0 20 7d 0a 0a 20 20 2f 2a 20 55 73 65 20 70 50 61 }.. /* Use pPa
21cd0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
21ce0 61 73 20 74 68 65 20 65 66 66 65 63 74 69 76 65 as the effective
21cf0 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6d 61 69 size of the mai
21d00 6e 20 72 6f 6c 6c 62 61 63 6b 0a 20 20 2a 2a 20 n rollback. **
21d10 6a 6f 75 72 6e 61 6c 2e 20 20 54 68 65 20 61 63 journal. The ac
21d20 74 75 61 6c 20 66 69 6c 65 20 6d 69 67 68 74 20 tual file might
21d30 62 65 20 6c 61 72 67 65 72 20 74 68 61 6e 20 74 be larger than t
21d40 68 69 73 20 69 6e 0a 20 20 2a 2a 20 50 41 47 45 his in. ** PAGE
21d50 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 54 52 R_JOURNALMODE_TR
21d60 55 4e 43 41 54 45 20 6f 72 20 50 41 47 45 52 5f UNCATE or PAGER_
21d70 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 50 45 52 53 JOURNALMODE_PERS
21d80 49 53 54 2e 20 20 42 75 74 20 61 6e 79 74 68 69 IST. But anythi
21d90 6e 67 0a 20 20 2a 2a 20 70 61 73 74 20 70 50 61 ng. ** past pPa
21da0 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
21db0 69 73 20 6f 66 66 2d 6c 69 6d 69 74 73 20 74 6f is off-limits to
21dc0 20 75 73 2e 0a 20 20 2a 2f 0a 20 20 73 7a 4a 20 us.. */. szJ
21dd0 3d 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 = pPager->journa
21de0 6c 4f 66 66 3b 0a 20 20 61 73 73 65 72 74 28 20 lOff;. assert(
21df0 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 67 pagerUseWal(pPag
21e00 65 72 29 3d 3d 30 20 7c 7c 20 73 7a 4a 3d 3d 30 er)==0 || szJ==0
21e10 20 29 3b 0a 0a 20 20 2f 2a 20 42 65 67 69 6e 20 );.. /* Begin
21e20 62 79 20 72 6f 6c 6c 69 6e 67 20 62 61 63 6b 20 by rolling back
21e30 72 65 63 6f 72 64 73 20 66 72 6f 6d 20 74 68 65 records from the
21e40 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c 20 73 74 main journal st
21e50 61 72 74 69 6e 67 20 61 74 0a 20 20 2a 2a 20 50 arting at. ** P
21e60 61 67 65 72 53 61 76 65 70 6f 69 6e 74 2e 69 4f agerSavepoint.iO
21e70 66 66 73 65 74 20 61 6e 64 20 63 6f 6e 74 69 6e ffset and contin
21e80 75 69 6e 67 20 74 6f 20 74 68 65 20 6e 65 78 74 uing to the next
21e90 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 2e journal header.
21ea0 0a 20 20 2a 2a 20 54 68 65 72 65 20 6d 69 67 68 . ** There migh
21eb0 74 20 62 65 20 72 65 63 6f 72 64 73 20 69 6e 20 t be records in
21ec0 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c the main journal
21ed0 20 74 68 61 74 20 68 61 76 65 20 61 20 70 61 67 that have a pag
21ee0 65 20 6e 75 6d 62 65 72 0a 20 20 2a 2a 20 67 72 e number. ** gr
21ef0 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 63 eater than the c
21f00 75 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 urrent database
21f10 73 69 7a 65 20 28 70 50 61 67 65 72 2d 3e 64 62 size (pPager->db
21f20 53 69 7a 65 29 20 62 75 74 20 74 68 6f 73 65 0a Size) but those.
21f30 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 73 6b 69 ** will be ski
21f40 70 70 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c pped automatical
21f50 6c 79 2e 20 20 50 61 67 65 73 20 61 72 65 20 61 ly. Pages are a
21f60 64 64 65 64 20 74 6f 20 70 44 6f 6e 65 20 61 73 dded to pDone as
21f70 20 74 68 65 79 0a 20 20 2a 2a 20 61 72 65 20 70 they. ** are p
21f80 6c 61 79 65 64 20 62 61 63 6b 2e 0a 20 20 2a 2f layed back.. */
21f90 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f 69 6e . if( pSavepoin
21fa0 74 20 26 26 20 21 70 61 67 65 72 55 73 65 57 61 t && !pagerUseWa
21fb0 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 l(pPager) ){.
21fc0 20 69 48 64 72 4f 66 66 20 3d 20 70 53 61 76 65 iHdrOff = pSave
21fd0 70 6f 69 6e 74 2d 3e 69 48 64 72 4f 66 66 73 65 point->iHdrOffse
21fe0 74 20 3f 20 70 53 61 76 65 70 6f 69 6e 74 2d 3e t ? pSavepoint->
21ff0 69 48 64 72 4f 66 66 73 65 74 20 3a 20 73 7a 4a iHdrOffset : szJ
22000 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f ;. pPager->jo
22010 75 72 6e 61 6c 4f 66 66 20 3d 20 70 53 61 76 65 urnalOff = pSave
22020 70 6f 69 6e 74 2d 3e 69 4f 66 66 73 65 74 3b 0a point->iOffset;.
22030 20 20 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 while( rc==S
22040 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70 50 61 67 QLITE_OK && pPag
22050 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3c 69 er->journalOff<i
22060 48 64 72 4f 66 66 20 29 7b 0a 20 20 20 20 20 20 HdrOff ){.
22070 72 63 20 3d 20 70 61 67 65 72 5f 70 6c 61 79 62 rc = pager_playb
22080 61 63 6b 5f 6f 6e 65 5f 70 61 67 65 28 70 50 61 ack_one_page(pPa
22090 67 65 72 2c 20 26 70 50 61 67 65 72 2d 3e 6a 6f ger, &pPager->jo
220a0 75 72 6e 61 6c 4f 66 66 2c 20 70 44 6f 6e 65 2c urnalOff, pDone,
220b0 20 31 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 1, 1);. }.
220c0 20 20 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 assert( rc!=SQ
220d0 4c 49 54 45 5f 44 4f 4e 45 20 29 3b 0a 20 20 7d LITE_DONE );. }
220e0 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 else{. pPager
220f0 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 3d 20 30 ->journalOff = 0
22100 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e 74 ;. }.. /* Cont
22110 69 6e 75 65 20 72 6f 6c 6c 69 6e 67 20 62 61 63 inue rolling bac
22120 6b 20 72 65 63 6f 72 64 73 20 6f 75 74 20 6f 66 k records out of
22130 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 the main journa
22140 6c 20 73 74 61 72 74 69 6e 67 20 61 74 0a 20 20 l starting at.
22150 2a 2a 20 74 68 65 20 66 69 72 73 74 20 6a 6f 75 ** the first jou
22160 72 6e 61 6c 20 68 65 61 64 65 72 20 73 65 65 6e rnal header seen
22170 20 61 6e 64 20 63 6f 6e 74 69 6e 75 69 6e 67 20 and continuing
22180 75 6e 74 69 6c 20 74 68 65 20 65 66 66 65 63 74 until the effect
22190 69 76 65 20 65 6e 64 0a 20 20 2a 2a 20 6f 66 20 ive end. ** of
221a0 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e 61 6c the main journal
221b0 20 66 69 6c 65 2e 20 20 43 6f 6e 74 69 6e 75 65 file. Continue
221c0 20 74 6f 20 73 6b 69 70 20 6f 75 74 2d 6f 66 2d to skip out-of-
221d0 72 61 6e 67 65 20 70 61 67 65 73 20 61 6e 64 0a range pages and.
221e0 20 20 2a 2a 20 63 6f 6e 74 69 6e 75 65 20 61 64 ** continue ad
221f0 64 69 6e 67 20 70 61 67 65 73 20 72 6f 6c 6c 65 ding pages rolle
22200 64 20 62 61 63 6b 20 74 6f 20 70 44 6f 6e 65 2e d back to pDone.
22210 0a 20 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 72 . */. while( r
22220 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
22230 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
22240 66 66 3c 73 7a 4a 20 29 7b 0a 20 20 20 20 75 33 ff<szJ ){. u3
22250 32 20 69 69 3b 20 20 20 20 20 20 20 20 20 20 20 2 ii;
22260 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 /* Loop counter
22270 20 2a 2f 0a 20 20 20 20 75 33 32 20 6e 4a 52 65 */. u32 nJRe
22280 63 20 3d 20 30 3b 20 20 20 20 20 2f 2a 20 4e 75 c = 0; /* Nu
22290 6d 62 65 72 20 6f 66 20 4a 6f 75 72 6e 61 6c 20 mber of Journal
222a0 52 65 63 6f 72 64 73 20 2a 2f 0a 20 20 20 20 75 Records */. u
222b0 33 32 20 64 75 6d 6d 79 3b 0a 20 20 20 20 72 63 32 dummy;. rc
222c0 20 3d 20 72 65 61 64 4a 6f 75 72 6e 61 6c 48 64 = readJournalHd
222d0 72 28 70 50 61 67 65 72 2c 20 30 2c 20 73 7a 4a r(pPager, 0, szJ
222e0 2c 20 26 6e 4a 52 65 63 2c 20 26 64 75 6d 6d 79 , &nJRec, &dummy
222f0 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 );. assert( r
22300 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 c!=SQLITE_DONE )
22310 3b 0a 0a 20 20 20 20 2f 2a 0a 20 20 20 20 2a 2a ;.. /*. **
22320 20 54 68 65 20 22 70 50 61 67 65 72 2d 3e 6a 6f The "pPager->jo
22330 75 72 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c urnalHdr+JOURNAL
22340 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3d _HDR_SZ(pPager)=
22350 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c =pPager->journal
22360 4f 66 66 22 0a 20 20 20 20 2a 2a 20 74 65 73 74 Off". ** test
22370 20 69 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 is related to t
22380 69 63 6b 65 74 20 23 32 35 36 35 2e 20 20 53 65 icket #2565. Se
22390 65 20 74 68 65 20 64 69 73 63 75 73 73 69 6f 6e e the discussion
223a0 20 69 6e 20 74 68 65 0a 20 20 20 20 2a 2a 20 70 in the. ** p
223b0 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 20 ager_playback()
223c0 66 75 6e 63 74 69 6f 6e 20 66 6f 72 20 61 64 64 function for add
223d0 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 itional informat
223e0 69 6f 6e 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ion.. */.
223f0 69 66 28 20 6e 4a 52 65 63 3d 3d 30 20 0a 20 20 if( nJRec==0 .
22400 20 20 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f && pPager->jo
22410 75 72 6e 61 6c 48 64 72 2b 4a 4f 55 52 4e 41 4c urnalHdr+JOURNAL
22420 5f 48 44 52 5f 53 5a 28 70 50 61 67 65 72 29 3d _HDR_SZ(pPager)=
22430 3d 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c =pPager->journal
22440 4f 66 66 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 Off. ){.
22450 20 6e 4a 52 65 63 20 3d 20 28 75 33 32 29 28 28 nJRec = (u32)((
22460 73 7a 4a 20 2d 20 70 50 61 67 65 72 2d 3e 6a 6f szJ - pPager->jo
22470 75 72 6e 61 6c 4f 66 66 29 2f 4a 4f 55 52 4e 41 urnalOff)/JOURNA
22480 4c 5f 50 47 5f 53 5a 28 70 50 61 67 65 72 29 29 L_PG_SZ(pPager))
22490 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 ;. }. for(
224a0 69 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 ii=0; rc==SQLITE
224b0 5f 4f 4b 20 26 26 20 69 69 3c 6e 4a 52 65 63 20 _OK && ii<nJRec
224c0 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e && pPager->journ
224d0 61 6c 4f 66 66 3c 73 7a 4a 3b 20 69 69 2b 2b 29 alOff<szJ; ii++)
224e0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 {. rc = pag
224f0 65 72 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f er_playback_one_
22500 70 61 67 65 28 70 50 61 67 65 72 2c 20 26 70 50 page(pPager, &pP
22510 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 ager->journalOff
22520 2c 20 70 44 6f 6e 65 2c 20 31 2c 20 31 29 3b 0a , pDone, 1, 1);.
22530 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 }. assert
22540 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 4f 4e ( rc!=SQLITE_DON
22550 45 20 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 E );. }. asser
22560 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b t( rc!=SQLITE_OK
22570 20 7c 7c 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 || pPager->jour
22580 6e 61 6c 4f 66 66 3e 3d 73 7a 4a 20 29 3b 0a 0a nalOff>=szJ );..
22590 20 20 2f 2a 20 46 69 6e 61 6c 6c 79 2c 20 20 72 /* Finally, r
225a0 6f 6c 6c 62 61 63 6b 20 70 61 67 65 73 20 66 72 ollback pages fr
225b0 6f 6d 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e om the sub-journ
225c0 61 6c 2e 20 20 50 61 67 65 20 74 68 61 74 20 77 al. Page that w
225d0 65 72 65 0a 20 20 2a 2a 20 70 72 65 76 69 6f 75 ere. ** previou
225e0 73 6c 79 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 sly rolled back
225f0 6f 75 74 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 out of the main
22600 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 20 61 72 65 journal (and are
22610 20 68 65 6e 63 65 20 69 6e 20 70 44 6f 6e 65 29 hence in pDone)
22620 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 73 6b . ** will be sk
22630 69 70 70 65 64 2e 20 20 4f 75 74 2d 6f 66 2d 72 ipped. Out-of-r
22640 61 6e 67 65 20 70 61 67 65 73 20 61 72 65 20 61 ange pages are a
22650 6c 73 6f 20 73 6b 69 70 70 65 64 2e 0a 20 20 2a lso skipped.. *
22660 2f 0a 20 20 69 66 28 20 70 53 61 76 65 70 6f 69 /. if( pSavepoi
22670 6e 74 20 29 7b 0a 20 20 20 20 75 33 32 20 69 69 nt ){. u32 ii
22680 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
22690 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
226a0 20 20 20 20 69 36 34 20 6f 66 66 73 65 74 20 3d i64 offset =
226b0 20 28 69 36 34 29 70 53 61 76 65 70 6f 69 6e 74 (i64)pSavepoint
226c0 2d 3e 69 53 75 62 52 65 63 2a 28 34 2b 70 50 61 ->iSubRec*(4+pPa
226d0 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 29 3b 0a ger->pageSize);.
226e0 0a 20 20 20 20 69 66 28 20 70 61 67 65 72 55 73 . if( pagerUs
226f0 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a eWal(pPager) ){.
22700 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
22710 65 33 57 61 6c 53 61 76 65 70 6f 69 6e 74 55 6e e3WalSavepointUn
22720 64 6f 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c do(pPager->pWal,
22730 20 70 53 61 76 65 70 6f 69 6e 74 2d 3e 61 57 61 pSavepoint->aWa
22740 6c 44 61 74 61 29 3b 0a 20 20 20 20 7d 0a 20 20 lData);. }.
22750 20 20 66 6f 72 28 69 69 3d 70 53 61 76 65 70 6f for(ii=pSavepo
22760 69 6e 74 2d 3e 69 53 75 62 52 65 63 3b 20 72 63 int->iSubRec; rc
22770 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 ==SQLITE_OK && i
22780 69 3c 70 50 61 67 65 72 2d 3e 6e 53 75 62 52 65 i<pPager->nSubRe
22790 63 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 20 c; ii++){.
227a0 61 73 73 65 72 74 28 20 6f 66 66 73 65 74 3d 3d assert( offset==
227b0 28 69 36 34 29 69 69 2a 28 34 2b 70 50 61 67 65 (i64)ii*(4+pPage
227c0 72 2d 3e 70 61 67 65 53 69 7a 65 29 20 29 3b 0a r->pageSize) );.
227d0 20 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 rc = pager
227e0 5f 70 6c 61 79 62 61 63 6b 5f 6f 6e 65 5f 70 61 _playback_one_pa
227f0 67 65 28 70 50 61 67 65 72 2c 20 26 6f 66 66 73 ge(pPager, &offs
22800 65 74 2c 20 70 44 6f 6e 65 2c 20 30 2c 20 31 29 et, pDone, 0, 1)
22810 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
22820 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 44 rt( rc!=SQLITE_D
22830 4f 4e 45 20 29 3b 0a 20 20 7d 0a 0a 20 20 73 71 ONE );. }.. sq
22840 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
22850 6f 79 28 70 44 6f 6e 65 29 3b 0a 20 20 69 66 28 oy(pDone);. if(
22860 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
22870 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f {. pPager->jo
22880 75 72 6e 61 6c 4f 66 66 20 3d 20 73 7a 4a 3b 0a urnalOff = szJ;.
22890 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 }.. return rc
228a0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 ;.}../*.** Chang
228b0 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 e the maximum nu
228c0 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d 6f 72 mber of in-memor
228d0 79 20 70 61 67 65 73 20 74 68 61 74 20 61 72 65 y pages that are
228e0 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 62 65 66 6f allowed.** befo
228f0 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f re attempting to
22900 20 72 65 63 79 63 6c 65 20 63 6c 65 61 6e 20 61 recycle clean a
22910 6e 64 20 75 6e 75 73 65 64 20 70 61 67 65 73 2e nd unused pages.
22920 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .*/.void sqlite3
22930 50 61 67 65 72 53 65 74 43 61 63 68 65 73 69 7a PagerSetCachesiz
22940 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c e(Pager *pPager,
22950 20 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 int mxPage){.
22960 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 sqlite3PcacheSet
22970 43 61 63 68 65 73 69 7a 65 28 70 50 61 67 65 72 Cachesize(pPager
22980 2d 3e 70 50 43 61 63 68 65 2c 20 6d 78 50 61 67 ->pPCache, mxPag
22990 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 e);.}../*.** Cha
229a0 6e 67 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 nge the maximum
229b0 6e 75 6d 62 65 72 20 6f 66 20 69 6e 2d 6d 65 6d number of in-mem
229c0 6f 72 79 20 70 61 67 65 73 20 74 68 61 74 20 61 ory pages that a
229d0 72 65 20 61 6c 6c 6f 77 65 64 0a 2a 2a 20 62 65 re allowed.** be
229e0 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 20 fore attempting
229f0 74 6f 20 73 70 69 6c 6c 20 70 61 67 65 73 20 74 to spill pages t
22a00 6f 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 69 6e o journal..*/.in
22a10 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 65 t sqlite3PagerSe
22a20 74 53 70 69 6c 6c 73 69 7a 65 28 50 61 67 65 72 tSpillsize(Pager
22a30 20 2a 70 50 61 67 65 72 2c 20 69 6e 74 20 6d 78 *pPager, int mx
22a40 50 61 67 65 29 7b 0a 20 20 72 65 74 75 72 6e 20 Page){. return
22a50 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 65 74 sqlite3PcacheSet
22a60 53 70 69 6c 6c 73 69 7a 65 28 70 50 61 67 65 72 Spillsize(pPager
22a70 2d 3e 70 50 43 61 63 68 65 2c 20 6d 78 50 61 67 ->pPCache, mxPag
22a80 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 76 e);.}../*.** Inv
22a90 6f 6b 65 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c oke SQLITE_FCNTL
22aa0 5f 4d 4d 41 50 5f 53 49 5a 45 20 62 61 73 65 64 _MMAP_SIZE based
22ab0 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 on the current
22ac0 76 61 6c 75 65 20 6f 66 20 73 7a 4d 6d 61 70 2e value of szMmap.
22ad0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
22ae0 70 61 67 65 72 46 69 78 4d 61 70 6c 69 6d 69 74 pagerFixMaplimit
22af0 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b (Pager *pPager){
22b00 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
22b10 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 20 20 73 71 MMAP_SIZE>0. sq
22b20 6c 69 74 65 33 5f 66 69 6c 65 20 2a 66 64 20 3d lite3_file *fd =
22b30 20 70 50 61 67 65 72 2d 3e 66 64 3b 0a 20 20 69 pPager->fd;. i
22b40 66 28 20 69 73 4f 70 65 6e 28 66 64 29 20 26 26 f( isOpen(fd) &&
22b50 20 66 64 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 69 fd->pMethods->i
22b60 56 65 72 73 69 6f 6e 3e 3d 33 20 29 7b 0a 20 20 Version>=3 ){.
22b70 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
22b80 73 7a 3b 0a 20 20 20 20 73 7a 20 3d 20 70 50 61 sz;. sz = pPa
22b90 67 65 72 2d 3e 73 7a 4d 6d 61 70 3b 0a 20 20 20 ger->szMmap;.
22ba0 20 70 50 61 67 65 72 2d 3e 62 55 73 65 46 65 74 pPager->bUseFet
22bb0 63 68 20 3d 20 28 73 7a 3e 30 29 3b 0a 20 20 20 ch = (sz>0);.
22bc0 20 73 65 74 47 65 74 74 65 72 4d 65 74 68 6f 64 setGetterMethod
22bd0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 73 71 (pPager);. sq
22be0 6c 69 74 65 33 4f 73 46 69 6c 65 43 6f 6e 74 72 lite3OsFileContr
22bf0 6f 6c 48 69 6e 74 28 70 50 61 67 65 72 2d 3e 66 olHint(pPager->f
22c00 64 2c 20 53 51 4c 49 54 45 5f 46 43 4e 54 4c 5f d, SQLITE_FCNTL_
22c10 4d 4d 41 50 5f 53 49 5a 45 2c 20 26 73 7a 29 3b MMAP_SIZE, &sz);
22c20 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f . }.#endif.}../
22c30 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 *.** Change the
22c40 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 maximum size of
22c50 61 6e 79 20 6d 65 6d 6f 72 79 20 6d 61 70 70 69 any memory mappi
22c60 6e 67 20 6d 61 64 65 20 6f 66 20 74 68 65 20 64 ng made of the d
22c70 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2f atabase file..*/
22c80 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 .void sqlite3Pag
22c90 65 72 53 65 74 4d 6d 61 70 4c 69 6d 69 74 28 50 erSetMmapLimit(P
22ca0 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 73 71 ager *pPager, sq
22cb0 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d lite3_int64 szMm
22cc0 61 70 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e 73 ap){. pPager->s
22cd0 7a 4d 6d 61 70 20 3d 20 73 7a 4d 6d 61 70 3b 0a zMmap = szMmap;.
22ce0 20 20 70 61 67 65 72 46 69 78 4d 61 70 6c 69 6d pagerFixMaplim
22cf0 69 74 28 70 50 61 67 65 72 29 3b 0a 7d 0a 0a 2f it(pPager);.}../
22d00 2a 0a 2a 2a 20 46 72 65 65 20 61 73 20 6d 75 63 *.** Free as muc
22d10 68 20 6d 65 6d 6f 72 79 20 61 73 20 70 6f 73 73 h memory as poss
22d20 69 62 6c 65 20 66 72 6f 6d 20 74 68 65 20 70 61 ible from the pa
22d30 67 65 72 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c ger..*/.void sql
22d40 69 74 65 33 50 61 67 65 72 53 68 72 69 6e 6b 28 ite3PagerShrink(
22d50 50 61 67 65 72 20 2a 70 50 61 67 65 72 29 7b 0a Pager *pPager){.
22d60 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 sqlite3PcacheS
22d70 68 72 69 6e 6b 28 70 50 61 67 65 72 2d 3e 70 50 hrink(pPager->pP
22d80 43 61 63 68 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a Cache);.}../*.**
22d90 20 41 64 6a 75 73 74 20 73 65 74 74 69 6e 67 73 Adjust settings
22da0 20 6f 66 20 74 68 65 20 70 61 67 65 72 20 74 6f of the pager to
22db0 20 74 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 those specified
22dc0 20 69 6e 20 74 68 65 20 70 67 46 6c 61 67 73 20 in the pgFlags
22dd0 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2a 0a 2a 2a parameter..**.**
22de0 20 54 68 65 20 22 6c 65 76 65 6c 22 20 69 6e 20 The "level" in
22df0 70 67 46 6c 61 67 73 20 26 20 50 41 47 45 52 5f pgFlags & PAGER_
22e00 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4d 41 53 4b SYNCHRONOUS_MASK
22e10 20 73 65 74 73 20 74 68 65 20 72 6f 62 75 73 74 sets the robust
22e20 6e 65 73 73 0a 2a 2a 20 6f 66 20 74 68 65 20 64 ness.** of the d
22e30 61 74 61 62 61 73 65 20 74 6f 20 64 61 6d 61 67 atabase to damag
22e40 65 20 64 75 65 20 74 6f 20 4f 53 20 63 72 61 73 e due to OS cras
22e50 68 65 73 20 6f 72 20 70 6f 77 65 72 20 66 61 69 hes or power fai
22e60 6c 75 72 65 73 20 62 79 0a 2a 2a 20 63 68 61 6e lures by.** chan
22e70 67 69 6e 67 20 74 68 65 20 6e 75 6d 62 65 72 20 ging the number
22e80 6f 66 20 73 79 6e 63 73 28 29 73 20 77 68 65 6e of syncs()s when
22e90 20 77 72 69 74 69 6e 67 20 74 68 65 20 6a 6f 75 writing the jou
22ea0 72 6e 61 6c 73 2e 0a 2a 2a 20 54 68 65 72 65 20 rnals..** There
22eb0 61 72 65 20 66 6f 75 72 20 6c 65 76 65 6c 73 3a are four levels:
22ec0 0a 2a 2a 0a 2a 2a 20 20 20 20 4f 46 46 20 20 20 .**.** OFF
22ed0 20 20 20 20 73 71 6c 69 74 65 33 4f 73 53 79 6e sqlite3OsSyn
22ee0 63 28 29 20 69 73 20 6e 65 76 65 72 20 63 61 6c c() is never cal
22ef0 6c 65 64 2e 20 20 54 68 69 73 20 69 73 20 74 68 led. This is th
22f00 65 20 64 65 66 61 75 6c 74 0a 2a 2a 20 20 20 20 e default.**
22f10 20 20 20 20 20 20 20 20 20 20 66 6f 72 20 74 65 for te
22f20 6d 70 6f 72 61 72 79 20 61 6e 64 20 74 72 61 6e mporary and tran
22f30 73 69 65 6e 74 20 66 69 6c 65 73 2e 0a 2a 2a 0a sient files..**.
22f40 2a 2a 20 20 20 20 4e 4f 52 4d 41 4c 20 20 20 20 ** NORMAL
22f50 54 68 65 20 6a 6f 75 72 6e 61 6c 20 69 73 20 73 The journal is s
22f60 79 6e 63 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 ynced once befor
22f70 65 20 77 72 69 74 65 73 20 62 65 67 69 6e 20 6f e writes begin o
22f80 6e 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 n the.**
22f90 20 20 20 20 20 20 64 61 74 61 62 61 73 65 2e 20 database.
22fa0 20 54 68 69 73 20 69 73 20 6e 6f 72 6d 61 6c 6c This is normall
22fb0 79 20 61 64 65 71 75 61 74 65 20 70 72 6f 74 65 y adequate prote
22fc0 63 74 69 6f 6e 2c 20 62 75 74 0a 2a 2a 20 20 20 ction, but.**
22fd0 20 20 20 20 20 20 20 20 20 20 20 69 74 20 69 73 it is
22fe0 20 74 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 70 theoretically p
22ff0 6f 73 73 69 62 6c 65 2c 20 74 68 6f 75 67 68 20 ossible, though
23000 76 65 72 79 20 75 6e 6c 69 6b 65 6c 79 2c 0a 2a very unlikely,.*
23010 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 * t
23020 68 61 74 20 61 6e 20 69 6e 6f 70 65 72 74 75 6e hat an inopertun
23030 65 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 e power failure
23040 63 6f 75 6c 64 20 6c 65 61 76 65 20 74 68 65 20 could leave the
23050 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 20 journal.**
23060 20 20 20 20 20 20 20 20 69 6e 20 61 20 73 74 61 in a sta
23070 74 65 20 77 68 69 63 68 20 77 6f 75 6c 64 20 63 te which would c
23080 61 75 73 65 20 64 61 6d 61 67 65 20 74 6f 20 74 ause damage to t
23090 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 20 he database.**
230a0 20 20 20 20 20 20 20 20 20 20 20 20 77 68 65 6e when
230b0 20 69 74 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 it is rolled ba
230c0 63 6b 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 46 55 4c ck..**.** FUL
230d0 4c 20 20 20 20 20 20 54 68 65 20 6a 6f 75 72 6e L The journ
230e0 61 6c 20 69 73 20 73 79 6e 63 65 64 20 74 77 69 al is synced twi
230f0 63 65 20 62 65 66 6f 72 65 20 77 72 69 74 65 73 ce before writes
23100 20 62 65 67 69 6e 20 6f 6e 20 74 68 65 0a 2a 2a begin on the.**
23110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 64 61 da
23120 74 61 62 61 73 65 20 28 77 69 74 68 20 73 6f 6d tabase (with som
23130 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 e additional inf
23140 6f 72 6d 61 74 69 6f 6e 20 2d 20 74 68 65 20 6e ormation - the n
23150 52 65 63 20 66 69 65 6c 64 0a 2a 2a 20 20 20 20 Rec field.**
23160 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 of the
23170 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 72 20 journal header
23180 2d 20 62 65 69 6e 67 20 77 72 69 74 74 65 6e 20 - being written
23190 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 74 in between the t
231a0 77 6f 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 wo.**
231b0 20 20 20 73 79 6e 63 73 29 2e 20 20 49 66 20 77 syncs). If w
231c0 65 20 61 73 73 75 6d 65 20 74 68 61 74 20 77 72 e assume that wr
231d0 69 74 69 6e 67 20 61 0a 2a 2a 20 20 20 20 20 20 iting a.**
231e0 20 20 20 20 20 20 20 20 73 69 6e 67 6c 65 20 64 single d
231f0 69 73 6b 20 73 65 63 74 6f 72 20 69 73 20 61 74 isk sector is at
23200 6f 6d 69 63 2c 20 74 68 65 6e 20 74 68 69 73 20 omic, then this
23210 6d 6f 64 65 20 70 72 6f 76 69 64 65 73 0a 2a 2a mode provides.**
23220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 73 as
23230 73 75 72 61 6e 63 65 20 74 68 61 74 20 74 68 65 surance that the
23240 20 6a 6f 75 72 6e 61 6c 20 77 69 6c 6c 20 6e 6f journal will no
23250 74 20 62 65 20 63 6f 72 72 75 70 74 65 64 20 74 t be corrupted t
23260 6f 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 o the.**
23270 20 20 20 20 20 20 70 6f 69 6e 74 20 6f 66 20 63 point of c
23280 61 75 73 69 6e 67 20 64 61 6d 61 67 65 20 74 6f ausing damage to
23290 20 74 68 65 20 64 61 74 61 62 61 73 65 20 64 75 the database du
232a0 72 69 6e 67 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a ring rollback..*
232b0 2a 0a 2a 2a 20 20 20 20 45 58 54 52 41 20 20 20 *.** EXTRA
232c0 20 20 54 68 69 73 20 69 73 20 6c 69 6b 65 20 46 This is like F
232d0 55 4c 4c 20 65 78 63 65 70 74 20 74 68 61 74 20 ULL except that
232e0 69 73 20 61 6c 73 6f 20 73 79 6e 63 73 20 74 68 is also syncs th
232f0 65 20 64 69 72 65 63 74 6f 72 79 0a 2a 2a 20 20 e directory.**
23300 20 20 20 20 20 20 20 20 20 20 20 20 74 68 61 74 that
23310 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 72 6f contains the ro
23320 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 61 llback journal a
23330 66 74 65 72 20 74 68 65 20 72 6f 6c 6c 62 61 63 fter the rollbac
23340 6b 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 k.**
23350 20 20 6a 6f 75 72 6e 61 6c 20 69 73 20 75 6e 6c journal is unl
23360 69 6e 6b 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 inked..**.** The
23370 20 61 62 6f 76 65 20 69 73 20 66 6f 72 20 61 20 above is for a
23380 72 6f 6c 6c 62 61 63 6b 2d 6a 6f 75 72 6e 61 6c rollback-journal
23390 20 6d 6f 64 65 2e 20 20 46 6f 72 20 57 41 4c 20 mode. For WAL
233a0 6d 6f 64 65 2c 20 4f 46 46 20 63 6f 6e 74 69 6e mode, OFF contin
233b0 75 65 73 0a 2a 2a 20 74 6f 20 6d 65 61 6e 20 74 ues.** to mean t
233c0 68 61 74 20 6e 6f 20 73 79 6e 63 73 20 65 76 65 hat no syncs eve
233d0 72 20 6f 63 63 75 72 2e 20 20 4e 4f 52 4d 41 4c r occur. NORMAL
233e0 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 means that the
233f0 57 41 4c 20 69 73 20 73 79 6e 63 65 64 0a 2a 2a WAL is synced.**
23400 20 70 72 69 6f 72 20 74 6f 20 74 68 65 20 73 74 prior to the st
23410 61 72 74 20 6f 66 20 63 68 65 63 6b 70 6f 69 6e art of checkpoin
23420 74 20 61 6e 64 20 74 68 61 74 20 74 68 65 20 64 t and that the d
23430 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 20 atabase file is
23440 73 79 6e 63 65 64 0a 2a 2a 20 61 74 20 74 68 65 synced.** at the
23450 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20 74 conclusion of t
23460 68 65 20 63 68 65 63 6b 70 6f 69 6e 74 20 69 66 he checkpoint if
23470 20 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 the entire cont
23480 65 6e 74 20 6f 66 20 74 68 65 20 57 41 4c 0a 2a ent of the WAL.*
23490 2a 20 77 61 73 20 77 72 69 74 74 65 6e 20 62 61 * was written ba
234a0 63 6b 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 ck into the data
234b0 62 61 73 65 2e 20 20 42 75 74 20 6e 6f 20 73 79 base. But no sy
234c0 6e 63 20 6f 70 65 72 61 74 69 6f 6e 73 20 6f 63 nc operations oc
234d0 63 75 72 20 66 6f 72 0a 2a 2a 20 61 6e 20 6f 72 cur for.** an or
234e0 64 69 6e 61 72 79 20 63 6f 6d 6d 69 74 20 69 6e dinary commit in
234f0 20 4e 4f 52 4d 41 4c 20 6d 6f 64 65 20 77 69 74 NORMAL mode wit
23500 68 20 57 41 4c 2e 20 20 46 55 4c 4c 20 6d 65 61 h WAL. FULL mea
23510 6e 73 20 74 68 61 74 20 74 68 65 20 57 41 4c 0a ns that the WAL.
23520 2a 2a 20 66 69 6c 65 20 69 73 20 73 79 6e 63 65 ** file is synce
23530 64 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 61 63 68 d following each
23540 20 63 6f 6d 6d 69 74 20 6f 70 65 72 61 74 69 6f commit operatio
23550 6e 2c 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 n, in addition t
23560 6f 20 74 68 65 0a 2a 2a 20 73 79 6e 63 73 20 61 o the.** syncs a
23570 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 4e ssociated with N
23580 4f 52 4d 41 4c 2e 20 20 54 68 65 72 65 20 69 73 ORMAL. There is
23590 20 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 no difference b
235a0 65 74 77 65 65 6e 20 46 55 4c 4c 0a 2a 2a 20 61 etween FULL.** a
235b0 6e 64 20 45 58 54 52 41 20 66 6f 72 20 57 41 4c nd EXTRA for WAL
235c0 20 6d 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 44 6f 20 mode..**.** Do
235d0 6e 6f 74 20 63 6f 6e 66 75 73 65 20 73 79 6e 63 not confuse sync
235e0 68 72 6f 6e 6f 75 73 3d 46 55 4c 4c 20 77 69 74 hronous=FULL wit
235f0 68 20 53 51 4c 49 54 45 5f 53 59 4e 43 5f 46 55 h SQLITE_SYNC_FU
23600 4c 4c 2e 20 20 54 68 65 0a 2a 2a 20 53 51 4c 49 LL. The.** SQLI
23610 54 45 5f 53 59 4e 43 5f 46 55 4c 4c 20 6d 61 63 TE_SYNC_FULL mac
23620 72 6f 20 6d 65 61 6e 73 20 74 6f 20 75 73 65 20 ro means to use
23630 74 68 65 20 4d 61 63 4f 53 58 2d 73 74 79 6c 65 the MacOSX-style
23640 20 66 75 6c 6c 2d 66 73 79 6e 63 0a 2a 2a 20 75 full-fsync.** u
23650 73 69 6e 67 20 66 63 6e 74 6c 28 46 5f 46 55 4c sing fcntl(F_FUL
23660 4c 46 53 59 4e 43 29 2e 20 20 53 51 4c 49 54 45 LFSYNC). SQLITE
23670 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 20 6d 65 61 _SYNC_NORMAL mea
23680 6e 73 20 74 6f 20 64 6f 20 61 6e 0a 2a 2a 20 6f ns to do an.** o
23690 72 64 69 6e 61 72 79 20 66 73 79 6e 63 28 29 20 rdinary fsync()
236a0 63 61 6c 6c 2e 20 20 54 68 65 72 65 20 69 73 20 call. There is
236b0 6e 6f 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 no difference be
236c0 74 77 65 65 6e 20 53 51 4c 49 54 45 5f 53 59 4e tween SQLITE_SYN
236d0 43 5f 46 55 4c 4c 0a 2a 2a 20 61 6e 64 20 53 51 C_FULL.** and SQ
236e0 4c 49 54 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c LITE_SYNC_NORMAL
236f0 20 6f 6e 20 70 6c 61 74 66 6f 72 6d 73 20 6f 74 on platforms ot
23700 68 65 72 20 74 68 61 6e 20 4d 61 63 4f 53 58 2e her than MacOSX.
23710 20 20 42 75 74 20 74 68 65 0a 2a 2a 20 73 79 6e But the.** syn
23720 63 68 72 6f 6e 6f 75 73 3d 46 55 4c 4c 20 76 65 chronous=FULL ve
23730 72 73 75 73 20 73 79 6e 63 68 72 6f 6e 6f 75 73 rsus synchronous
23740 3d 4e 4f 52 4d 41 4c 20 73 65 74 74 69 6e 67 20 =NORMAL setting
23750 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 6e 0a determines when.
23760 2a 2a 20 74 68 65 20 78 53 79 6e 63 20 70 72 69 ** the xSync pri
23770 6d 69 74 69 76 65 20 69 73 20 63 61 6c 6c 65 64 mitive is called
23780 20 61 6e 64 20 69 73 20 72 65 6c 65 76 61 6e 74 and is relevant
23790 20 74 6f 20 61 6c 6c 20 70 6c 61 74 66 6f 72 6d to all platform
237a0 73 2e 0a 2a 2a 0a 2a 2a 20 4e 75 6d 65 72 69 63 s..**.** Numeric
237b0 20 76 61 6c 75 65 73 20 61 73 73 6f 63 69 61 74 values associat
237c0 65 64 20 77 69 74 68 20 74 68 65 73 65 20 73 74 ed with these st
237d0 61 74 65 73 20 61 72 65 20 4f 46 46 3d 3d 31 2c ates are OFF==1,
237e0 20 4e 4f 52 4d 41 4c 3d 32 2c 0a 2a 2a 20 61 6e NORMAL=2,.** an
237f0 64 20 46 55 4c 4c 3d 33 2e 0a 2a 2f 0a 23 69 66 d FULL=3..*/.#if
23800 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
23810 5f 50 41 47 45 52 5f 50 52 41 47 4d 41 53 0a 76 _PAGER_PRAGMAS.v
23820 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 oid sqlite3Pager
23830 53 65 74 46 6c 61 67 73 28 0a 20 20 50 61 67 65 SetFlags(. Page
23840 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 r *pPager,
23850 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 20 74 /* The pager t
23860 6f 20 73 65 74 20 73 61 66 65 74 79 20 6c 65 76 o set safety lev
23870 65 6c 20 66 6f 72 20 2a 2f 0a 20 20 75 6e 73 69 el for */. unsi
23880 67 6e 65 64 20 70 67 46 6c 61 67 73 20 20 20 20 gned pgFlags
23890 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 66 6c 61 /* Various fla
238a0 67 73 20 2a 2f 0a 29 7b 0a 20 20 75 6e 73 69 67 gs */.){. unsig
238b0 6e 65 64 20 6c 65 76 65 6c 20 3d 20 70 67 46 6c ned level = pgFl
238c0 61 67 73 20 26 20 50 41 47 45 52 5f 53 59 4e 43 ags & PAGER_SYNC
238d0 48 52 4f 4e 4f 55 53 5f 4d 41 53 4b 3b 0a 20 20 HRONOUS_MASK;.
238e0 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 if( pPager->temp
238f0 46 69 6c 65 20 29 7b 0a 20 20 20 20 70 50 61 67 File ){. pPag
23900 65 72 2d 3e 6e 6f 53 79 6e 63 20 3d 20 31 3b 0a er->noSync = 1;.
23910 20 20 20 20 70 50 61 67 65 72 2d 3e 66 75 6c 6c pPager->full
23920 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 70 50 Sync = 0;. pP
23930 61 67 65 72 2d 3e 65 78 74 72 61 53 79 6e 63 20 ager->extraSync
23940 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 = 0;. }else{.
23950 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e 63 pPager->noSync
23960 20 3d 20 20 6c 65 76 65 6c 3d 3d 50 41 47 45 52 = level==PAGER
23970 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 4f 46 46 _SYNCHRONOUS_OFF
23980 20 3f 31 3a 30 3b 0a 20 20 20 20 70 50 61 67 65 ?1:0;. pPage
23990 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 6c 65 r->fullSync = le
239a0 76 65 6c 3e 3d 50 41 47 45 52 5f 53 59 4e 43 48 vel>=PAGER_SYNCH
239b0 52 4f 4e 4f 55 53 5f 46 55 4c 4c 20 3f 31 3a 30 RONOUS_FULL ?1:0
239c0 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 78 ;. pPager->ex
239d0 74 72 61 53 79 6e 63 20 3d 20 6c 65 76 65 6c 3d traSync = level=
239e0 3d 50 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e 4f =PAGER_SYNCHRONO
239f0 55 53 5f 45 58 54 52 41 20 3f 31 3a 30 3b 0a 20 US_EXTRA ?1:0;.
23a00 20 7d 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d }. if( pPager-
23a10 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 70 >noSync ){. p
23a20 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 Pager->syncFlags
23a30 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 = 0;. }else if
23a40 28 20 70 67 46 6c 61 67 73 20 26 20 50 41 47 45 ( pgFlags & PAGE
23a50 52 5f 46 55 4c 4c 46 53 59 4e 43 20 29 7b 0a 20 R_FULLFSYNC ){.
23a60 20 20 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 pPager->syncF
23a70 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 lags = SQLITE_SY
23a80 4e 43 5f 46 55 4c 4c 3b 0a 20 20 7d 65 6c 73 65 NC_FULL;. }else
23a90 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 73 79 {. pPager->sy
23aa0 6e 63 46 6c 61 67 73 20 3d 20 53 51 4c 49 54 45 ncFlags = SQLITE
23ab0 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 3b 0a 20 20 _SYNC_NORMAL;.
23ac0 7d 0a 20 20 70 50 61 67 65 72 2d 3e 77 61 6c 53 }. pPager->walS
23ad0 79 6e 63 46 6c 61 67 73 20 3d 20 28 70 50 61 67 yncFlags = (pPag
23ae0 65 72 2d 3e 73 79 6e 63 46 6c 61 67 73 3c 3c 32 er->syncFlags<<2
23af0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
23b00 3e 66 75 6c 6c 53 79 6e 63 20 29 7b 0a 20 20 20 >fullSync ){.
23b10 20 70 50 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 pPager->walSync
23b20 46 6c 61 67 73 20 7c 3d 20 70 50 61 67 65 72 2d Flags |= pPager-
23b30 3e 73 79 6e 63 46 6c 61 67 73 3b 0a 20 20 7d 0a >syncFlags;. }.
23b40 20 20 69 66 28 20 28 70 67 46 6c 61 67 73 20 26 if( (pgFlags &
23b50 20 50 41 47 45 52 5f 43 4b 50 54 5f 46 55 4c 4c PAGER_CKPT_FULL
23b60 46 53 59 4e 43 29 20 26 26 20 21 70 50 61 67 65 FSYNC) && !pPage
23b70 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 r->noSync ){.
23b80 20 70 50 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 pPager->walSync
23b90 46 6c 61 67 73 20 7c 3d 20 28 53 51 4c 49 54 45 Flags |= (SQLITE
23ba0 5f 53 59 4e 43 5f 46 55 4c 4c 3c 3c 32 29 3b 0a _SYNC_FULL<<2);.
23bb0 20 20 7d 0a 20 20 69 66 28 20 70 67 46 6c 61 67 }. if( pgFlag
23bc0 73 20 26 20 50 41 47 45 52 5f 43 41 43 48 45 53 s & PAGER_CACHES
23bd0 50 49 4c 4c 20 29 7b 0a 20 20 20 20 70 50 61 67 PILL ){. pPag
23be0 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 er->doNotSpill &
23bf0 3d 20 7e 53 50 49 4c 4c 46 4c 41 47 5f 4f 46 46 = ~SPILLFLAG_OFF
23c00 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 ;. }else{. p
23c10 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 69 6c Pager->doNotSpil
23c20 6c 20 7c 3d 20 53 50 49 4c 4c 46 4c 41 47 5f 4f l |= SPILLFLAG_O
23c30 46 46 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 FF;. }.}.#endif
23c40 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
23c50 6f 77 69 6e 67 20 67 6c 6f 62 61 6c 20 76 61 72 owing global var
23c60 69 61 62 6c 65 20 69 73 20 69 6e 63 72 65 6d 65 iable is increme
23c70 6e 74 65 64 20 77 68 65 6e 65 76 65 72 20 74 68 nted whenever th
23c80 65 20 6c 69 62 72 61 72 79 0a 2a 2a 20 61 74 74 e library.** att
23c90 65 6d 70 74 73 20 74 6f 20 6f 70 65 6e 20 61 20 empts to open a
23ca0 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2e 20 temporary file.
23cb0 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f This informatio
23cc0 6e 20 69 73 20 75 73 65 64 20 66 6f 72 0a 2a 2a n is used for.**
23cd0 20 74 65 73 74 69 6e 67 20 61 6e 64 20 61 6e 61 testing and ana
23ce0 6c 79 73 69 73 20 6f 6e 6c 79 2e 20 20 0a 2a 2f lysis only. .*/
23cf0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 .#ifdef SQLITE_T
23d00 45 53 54 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f EST.int sqlite3_
23d10 6f 70 65 6e 74 65 6d 70 5f 63 6f 75 6e 74 20 3d opentemp_count =
23d20 20 30 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 0;.#endif../*.*
23d30 2a 20 4f 70 65 6e 20 61 20 74 65 6d 70 6f 72 61 * Open a tempora
23d40 72 79 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 57 ry file..**.** W
23d50 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 64 65 rite the file de
23d60 73 63 72 69 70 74 6f 72 20 69 6e 74 6f 20 2a 70 scriptor into *p
23d70 46 69 6c 65 2e 20 52 65 74 75 72 6e 20 53 51 4c File. Return SQL
23d80 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 ITE_OK on succes
23d90 73 20 0a 2a 2a 20 6f 72 20 73 6f 6d 65 20 6f 74 s .** or some ot
23da0 68 65 72 20 65 72 72 6f 72 20 63 6f 64 65 20 69 her error code i
23db0 66 20 77 65 20 66 61 69 6c 2e 20 54 68 65 20 4f f we fail. The O
23dc0 53 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 S will automatic
23dd0 61 6c 6c 79 20 0a 2a 2a 20 64 65 6c 65 74 65 20 ally .** delete
23de0 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 66 69 the temporary fi
23df0 6c 65 20 77 68 65 6e 20 69 74 20 69 73 20 63 6c le when it is cl
23e00 6f 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 osed..**.** The
23e10 66 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f 20 flags passed to
23e20 74 68 65 20 56 46 53 20 6c 61 79 65 72 20 78 4f the VFS layer xO
23e30 70 65 6e 28 29 20 63 61 6c 6c 20 61 72 65 20 74 pen() call are t
23e40 68 6f 73 65 20 73 70 65 63 69 66 69 65 64 0a 2a hose specified.*
23e50 2a 20 62 79 20 70 61 72 61 6d 65 74 65 72 20 76 * by parameter v
23e60 66 73 46 6c 61 67 73 20 4f 52 65 64 20 77 69 74 fsFlags ORed wit
23e70 68 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a h the following:
23e80 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 .**.** SQLIT
23e90 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 54 45 E_OPEN_READWRITE
23ea0 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 4f .** SQLITE_O
23eb0 50 45 4e 5f 43 52 45 41 54 45 0a 2a 2a 20 20 20 PEN_CREATE.**
23ec0 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 SQLITE_OPEN_EX
23ed0 43 4c 55 53 49 56 45 0a 2a 2a 20 20 20 20 20 53 CLUSIVE.** S
23ee0 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 QLITE_OPEN_DELET
23ef0 45 4f 4e 43 4c 4f 53 45 0a 2a 2f 0a 73 74 61 74 EONCLOSE.*/.stat
23f00 69 63 20 69 6e 74 20 70 61 67 65 72 4f 70 65 6e ic int pagerOpen
23f10 74 65 6d 70 28 0a 20 20 50 61 67 65 72 20 2a 70 temp(. Pager *p
23f20 50 61 67 65 72 2c 20 20 20 20 20 20 20 20 2f 2a Pager, /*
23f30 20 54 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 The pager objec
23f40 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 66 t */. sqlite3_f
23f50 69 6c 65 20 2a 70 46 69 6c 65 2c 20 20 2f 2a 20 ile *pFile, /*
23f60 57 72 69 74 65 20 74 68 65 20 66 69 6c 65 20 64 Write the file d
23f70 65 73 63 72 69 70 74 6f 72 20 68 65 72 65 20 2a escriptor here *
23f80 2f 0a 20 20 69 6e 74 20 76 66 73 46 6c 61 67 73 /. int vfsFlags
23f90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 /* Fla
23fa0 67 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 gs passed throug
23fb0 68 20 74 6f 20 74 68 65 20 56 46 53 20 2a 2f 0a h to the VFS */.
23fc0 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
23fd0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 /* Re
23fe0 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 23 69 turn code */..#i
23ff0 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45 53 54 fdef SQLITE_TEST
24000 0a 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 74 . sqlite3_opent
24010 65 6d 70 5f 63 6f 75 6e 74 2b 2b 3b 20 20 2f 2a emp_count++; /*
24020 20 55 73 65 64 20 66 6f 72 20 74 65 73 74 69 6e Used for testin
24030 67 20 61 6e 64 20 61 6e 61 6c 79 73 69 73 20 6f g and analysis o
24040 6e 6c 79 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 20 nly */.#endif..
24050 20 76 66 73 46 6c 61 67 73 20 7c 3d 20 20 53 51 vfsFlags |= SQ
24060 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
24070 49 54 45 20 7c 20 53 51 4c 49 54 45 5f 4f 50 45 ITE | SQLITE_OPE
24080 4e 5f 43 52 45 41 54 45 20 7c 0a 20 20 20 20 20 N_CREATE |.
24090 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f 4f 50 SQLITE_OP
240a0 45 4e 5f 45 58 43 4c 55 53 49 56 45 20 7c 20 53 EN_EXCLUSIVE | S
240b0 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 54 QLITE_OPEN_DELET
240c0 45 4f 4e 43 4c 4f 53 45 3b 0a 20 20 72 63 20 3d EONCLOSE;. rc =
240d0 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 70 sqlite3OsOpen(p
240e0 50 61 67 65 72 2d 3e 70 56 66 73 2c 20 30 2c 20 Pager->pVfs, 0,
240f0 70 46 69 6c 65 2c 20 76 66 73 46 6c 61 67 73 2c pFile, vfsFlags,
24100 20 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 0);. assert( r
24110 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c!=SQLITE_OK ||
24120 69 73 4f 70 65 6e 28 70 46 69 6c 65 29 20 29 3b isOpen(pFile) );
24130 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
24140 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 62 ./*.** Set the b
24150 75 73 79 20 68 61 6e 64 6c 65 72 20 66 75 6e 63 usy handler func
24160 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 tion..**.** The
24170 70 61 67 65 72 20 69 6e 76 6f 6b 65 73 20 74 68 pager invokes th
24180 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 69 e busy-handler i
24190 66 20 73 71 6c 69 74 65 33 4f 73 4c 6f 63 6b 28 f sqlite3OsLock(
241a0 29 20 72 65 74 75 72 6e 73 20 0a 2a 2a 20 53 51 ) returns .** SQ
241b0 4c 49 54 45 5f 42 55 53 59 20 77 68 65 6e 20 74 LITE_BUSY when t
241c0 72 79 69 6e 67 20 74 6f 20 75 70 67 72 61 64 65 rying to upgrade
241d0 20 66 72 6f 6d 20 6e 6f 2d 6c 6f 63 6b 20 74 6f from no-lock to
241e0 20 61 20 53 48 41 52 45 44 20 6c 6f 63 6b 2c 0a a SHARED lock,.
241f0 2a 2a 20 6f 72 20 77 68 65 6e 20 74 72 79 69 6e ** or when tryin
24200 67 20 74 6f 20 75 70 67 72 61 64 65 20 66 72 6f g to upgrade fro
24210 6d 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 m a RESERVED loc
24220 6b 20 74 6f 20 61 6e 20 45 58 43 4c 55 53 49 56 k to an EXCLUSIV
24230 45 20 0a 2a 2a 20 6c 6f 63 6b 2e 20 49 74 20 64 E .** lock. It d
24240 6f 65 73 20 2a 6e 6f 74 2a 20 69 6e 76 6f 6b 65 oes *not* invoke
24250 20 74 68 65 20 62 75 73 79 20 68 61 6e 64 6c 65 the busy handle
24260 72 20 77 68 65 6e 20 75 70 67 72 61 64 69 6e 67 r when upgrading
24270 20 66 72 6f 6d 0a 2a 2a 20 53 48 41 52 45 44 20 from.** SHARED
24280 74 6f 20 52 45 53 45 52 56 45 44 2c 20 6f 72 20 to RESERVED, or
24290 77 68 65 6e 20 75 70 67 72 61 64 69 6e 67 20 66 when upgrading f
242a0 72 6f 6d 20 53 48 41 52 45 44 20 74 6f 20 45 58 rom SHARED to EX
242b0 43 4c 55 53 49 56 45 0a 2a 2a 20 28 77 68 69 63 CLUSIVE.** (whic
242c0 68 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20 h occurs during
242d0 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c hot-journal roll
242e0 62 61 63 6b 29 2e 20 53 75 6d 6d 61 72 79 3a 0a back). Summary:.
242f0 2a 2a 0a 2a 2a 20 20 20 54 72 61 6e 73 69 74 69 **.** Transiti
24300 6f 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 20 on
24310 20 20 20 20 20 20 20 20 20 20 7c 20 49 6e 76 6f | Invo
24320 6b 65 73 20 78 42 75 73 79 48 61 6e 64 6c 65 72 kes xBusyHandler
24330 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d .** ----------
24340 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
24350 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
24360 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a --------------.*
24370 2a 20 20 20 4e 4f 5f 4c 4f 43 4b 20 20 20 20 20 * NO_LOCK
24380 20 20 2d 3e 20 53 48 41 52 45 44 5f 4c 4f 43 4b -> SHARED_LOCK
24390 20 20 20 20 20 20 7c 20 59 65 73 0a 2a 2a 20 20 | Yes.**
243a0 20 53 48 41 52 45 44 5f 4c 4f 43 4b 20 20 20 2d SHARED_LOCK -
243b0 3e 20 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 > RESERVED_LOCK
243c0 20 20 20 7c 20 4e 6f 0a 2a 2a 20 20 20 53 48 41 | No.** SHA
243d0 52 45 44 5f 4c 4f 43 4b 20 20 20 2d 3e 20 45 58 RED_LOCK -> EX
243e0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 20 20 7c CLUSIVE_LOCK |
243f0 20 4e 6f 0a 2a 2a 20 20 20 52 45 53 45 52 56 45 No.** RESERVE
24400 44 5f 4c 4f 43 4b 20 2d 3e 20 45 58 43 4c 55 53 D_LOCK -> EXCLUS
24410 49 56 45 5f 4c 4f 43 4b 20 20 20 7c 20 59 65 73 IVE_LOCK | Yes
24420 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 75 .**.** If the bu
24430 73 79 2d 68 61 6e 64 6c 65 72 20 63 61 6c 6c 62 sy-handler callb
24440 61 63 6b 20 72 65 74 75 72 6e 73 20 6e 6f 6e 2d ack returns non-
24450 7a 65 72 6f 2c 20 74 68 65 20 6c 6f 63 6b 20 69 zero, the lock i
24460 73 20 0a 2a 2a 20 72 65 74 72 69 65 64 2e 20 49 s .** retried. I
24470 66 20 69 74 20 72 65 74 75 72 6e 73 20 7a 65 72 f it returns zer
24480 6f 2c 20 74 68 65 6e 20 74 68 65 20 53 51 4c 49 o, then the SQLI
24490 54 45 5f 42 55 53 59 20 65 72 72 6f 72 20 69 73 TE_BUSY error is
244a0 0a 2a 2a 20 72 65 74 75 72 6e 65 64 20 74 6f 20 .** returned to
244b0 74 68 65 20 63 61 6c 6c 65 72 20 6f 66 20 74 68 the caller of th
244c0 65 20 70 61 67 65 72 20 41 50 49 20 66 75 6e 63 e pager API func
244d0 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 tion..*/.void sq
244e0 6c 69 74 65 33 50 61 67 65 72 53 65 74 42 75 73 lite3PagerSetBus
244f0 79 68 61 6e 64 6c 65 72 28 0a 20 20 50 61 67 65 yhandler(. Page
24500 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 20 r *pPager,
24510 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24520 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a 65 63 74 /* Pager object
24530 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 */. int (*xBus
24540 79 48 61 6e 64 6c 65 72 29 28 76 6f 69 64 20 2a yHandler)(void *
24550 29 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f ), /* Po
24560 69 6e 74 65 72 20 74 6f 20 62 75 73 79 2d 68 61 inter to busy-ha
24570 6e 64 6c 65 72 20 66 75 6e 63 74 69 6f 6e 20 2a ndler function *
24580 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 73 79 48 /. void *pBusyH
24590 61 6e 64 6c 65 72 41 72 67 20 20 20 20 20 20 20 andlerArg
245a0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 /* Argu
245b0 6d 65 6e 74 20 74 6f 20 70 61 73 73 20 74 6f 20 ment to pass to
245c0 78 42 75 73 79 48 61 6e 64 6c 65 72 20 2a 2f 0a xBusyHandler */.
245d0 29 7b 0a 20 20 70 50 61 67 65 72 2d 3e 78 42 75 ){. pPager->xBu
245e0 73 79 48 61 6e 64 6c 65 72 20 3d 20 78 42 75 73 syHandler = xBus
245f0 79 48 61 6e 64 6c 65 72 3b 0a 20 20 70 50 61 67 yHandler;. pPag
24600 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 6c 65 72 er->pBusyHandler
24610 41 72 67 20 3d 20 70 42 75 73 79 48 61 6e 64 6c Arg = pBusyHandl
24620 65 72 41 72 67 3b 0a 0a 20 20 69 66 28 20 69 73 erArg;.. if( is
24630 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 Open(pPager->fd)
24640 20 29 7b 0a 20 20 20 20 76 6f 69 64 20 2a 2a 61 ){. void **a
24650 70 20 3d 20 28 76 6f 69 64 20 2a 2a 29 26 70 50 p = (void **)&pP
24660 61 67 65 72 2d 3e 78 42 75 73 79 48 61 6e 64 6c ager->xBusyHandl
24670 65 72 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 er;. assert(
24680 28 28 69 6e 74 28 2a 29 28 76 6f 69 64 20 2a 29 ((int(*)(void *)
24690 29 28 61 70 5b 30 5d 29 29 3d 3d 78 42 75 73 79 )(ap[0]))==xBusy
246a0 48 61 6e 64 6c 65 72 20 29 3b 0a 20 20 20 20 61 Handler );. a
246b0 73 73 65 72 74 28 20 61 70 5b 31 5d 3d 3d 70 42 ssert( ap[1]==pB
246c0 75 73 79 48 61 6e 64 6c 65 72 41 72 67 20 29 3b usyHandlerArg );
246d0 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73 46 69 . sqlite3OsFi
246e0 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 28 70 50 leControlHint(pP
246f0 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 ager->fd, SQLITE
24700 5f 46 43 4e 54 4c 5f 42 55 53 59 48 41 4e 44 4c _FCNTL_BUSYHANDL
24710 45 52 2c 20 28 76 6f 69 64 20 2a 29 61 70 29 3b ER, (void *)ap);
24720 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 . }.}../*.** Ch
24730 61 6e 67 65 20 74 68 65 20 70 61 67 65 20 73 69 ange the page si
24740 7a 65 20 75 73 65 64 20 62 79 20 74 68 65 20 50 ze used by the P
24750 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 54 68 65 ager object. The
24760 20 6e 65 77 20 70 61 67 65 20 73 69 7a 65 20 0a new page size .
24770 2a 2a 20 69 73 20 70 61 73 73 65 64 20 69 6e 20 ** is passed in
24780 2a 70 50 61 67 65 53 69 7a 65 2e 0a 2a 2a 0a 2a *pPageSize..**.*
24790 2a 20 49 66 20 74 68 65 20 70 61 67 65 72 20 69 * If the pager i
247a0 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 73 s in the error s
247b0 74 61 74 65 20 77 68 65 6e 20 74 68 69 73 20 66 tate when this f
247c0 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 unction is calle
247d0 64 2c 20 69 74 0a 2a 2a 20 69 73 20 61 20 6e 6f d, it.** is a no
247e0 2d 6f 70 2e 20 54 68 65 20 76 61 6c 75 65 20 72 -op. The value r
247f0 65 74 75 72 6e 65 64 20 69 73 20 74 68 65 20 65 eturned is the e
24800 72 72 6f 72 20 73 74 61 74 65 20 65 72 72 6f 72 rror state error
24810 20 63 6f 64 65 20 28 69 2e 65 2e 20 0a 2a 2a 20 code (i.e. .**
24820 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 5f 49 4f one of SQLITE_IO
24830 45 52 52 2c 20 61 6e 20 53 51 4c 49 54 45 5f 49 ERR, an SQLITE_I
24840 4f 45 52 52 5f 78 78 78 20 73 75 62 2d 63 6f 64 OERR_xxx sub-cod
24850 65 20 6f 72 20 53 51 4c 49 54 45 5f 46 55 4c 4c e or SQLITE_FULL
24860 29 2e 0a 2a 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 )..**.** Otherwi
24870 73 65 2c 20 69 66 20 61 6c 6c 20 6f 66 20 74 68 se, if all of th
24880 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
24890 74 72 75 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 true:.**.** *
248a0 74 68 65 20 6e 65 77 20 70 61 67 65 20 73 69 7a the new page siz
248b0 65 20 28 76 61 6c 75 65 20 6f 66 20 2a 70 50 61 e (value of *pPa
248c0 67 65 53 69 7a 65 29 20 69 73 20 76 61 6c 69 64 geSize) is valid
248d0 20 28 61 20 70 6f 77 65 72 20 0a 2a 2a 20 20 20 (a power .**
248e0 20 20 6f 66 20 74 77 6f 20 62 65 74 77 65 65 6e of two between
248f0 20 35 31 32 20 61 6e 64 20 53 51 4c 49 54 45 5f 512 and SQLITE_
24900 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 2c 20 69 MAX_PAGE_SIZE, i
24910 6e 63 6c 75 73 69 76 65 29 2c 20 61 6e 64 0a 2a nclusive), and.*
24920 2a 0a 2a 2a 20 20 20 2a 20 74 68 65 72 65 20 61 *.** * there a
24930 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e re no outstandin
24940 67 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 g page reference
24950 73 2c 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 2a s, and.**.** *
24960 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 the database is
24970 20 65 69 74 68 65 72 20 6e 6f 74 20 61 6e 20 69 either not an i
24980 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
24990 65 20 6f 72 20 69 74 20 69 73 0a 2a 2a 20 20 20 e or it is.**
249a0 20 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 an in-memory d
249b0 61 74 61 62 61 73 65 20 74 68 61 74 20 63 75 72 atabase that cur
249c0 72 65 6e 74 6c 79 20 63 6f 6e 73 69 73 74 73 20 rently consists
249d0 6f 66 20 7a 65 72 6f 20 70 61 67 65 73 2e 0a 2a of zero pages..*
249e0 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 70 61 *.** then the pa
249f0 67 65 72 20 6f 62 6a 65 63 74 20 70 61 67 65 20 ger object page
24a00 73 69 7a 65 20 69 73 20 73 65 74 20 74 6f 20 2a size is set to *
24a10 70 50 61 67 65 53 69 7a 65 2e 0a 2a 2a 0a 2a 2a pPageSize..**.**
24a20 20 49 66 20 74 68 65 20 70 61 67 65 20 73 69 7a If the page siz
24a30 65 20 69 73 20 63 68 61 6e 67 65 64 2c 20 74 68 e is changed, th
24a40 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e en this function
24a50 20 75 73 65 73 20 73 71 6c 69 74 65 33 50 61 67 uses sqlite3Pag
24a60 65 72 4d 61 6c 6c 6f 63 28 29 20 0a 2a 2a 20 74 erMalloc() .** t
24a70 6f 20 6f 62 74 61 69 6e 20 61 20 6e 65 77 20 50 o obtain a new P
24a80 61 67 65 72 2e 70 54 6d 70 53 70 61 63 65 20 62 ager.pTmpSpace b
24a90 75 66 66 65 72 2e 20 49 66 20 74 68 69 73 20 61 uffer. If this a
24aa0 6c 6c 6f 63 61 74 69 6f 6e 20 61 74 74 65 6d 70 llocation attemp
24ab0 74 20 0a 2a 2a 20 66 61 69 6c 73 2c 20 53 51 4c t .** fails, SQL
24ac0 49 54 45 5f 4e 4f 4d 45 4d 20 69 73 20 72 65 74 ITE_NOMEM is ret
24ad0 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 70 61 urned and the pa
24ae0 67 65 20 73 69 7a 65 20 72 65 6d 61 69 6e 73 20 ge size remains
24af0 75 6e 63 68 61 6e 67 65 64 2e 20 0a 2a 2a 20 49 unchanged. .** I
24b00 6e 20 61 6c 6c 20 6f 74 68 65 72 20 63 61 73 65 n all other case
24b10 73 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 s, SQLITE_OK is
24b20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 returned..**.**
24b30 49 66 20 74 68 65 20 70 61 67 65 20 73 69 7a 65 If the page size
24b40 20 69 73 20 6e 6f 74 20 63 68 61 6e 67 65 64 2c is not changed,
24b50 20 65 69 74 68 65 72 20 62 65 63 61 75 73 65 20 either because
24b60 6f 6e 65 20 6f 66 20 74 68 65 20 65 6e 75 6d 65 one of the enume
24b70 72 61 74 65 64 0a 2a 2a 20 63 6f 6e 64 69 74 69 rated.** conditi
24b80 6f 6e 73 20 61 62 6f 76 65 20 69 73 20 6e 6f 74 ons above is not
24b90 20 74 72 75 65 2c 20 74 68 65 20 70 61 67 65 72 true, the pager
24ba0 20 77 61 73 20 69 6e 20 65 72 72 6f 72 20 73 74 was in error st
24bb0 61 74 65 20 77 68 65 6e 20 74 68 69 73 0a 2a 2a ate when this.**
24bc0 20 66 75 6e 63 74 69 6f 6e 20 77 61 73 20 63 61 function was ca
24bd0 6c 6c 65 64 2c 20 6f 72 20 62 65 63 61 75 73 65 lled, or because
24be0 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f the memory allo
24bf0 63 61 74 69 6f 6e 20 61 74 74 65 6d 70 74 20 66 cation attempt f
24c00 61 69 6c 65 64 2c 20 0a 2a 2a 20 74 68 65 6e 20 ailed, .** then
24c10 2a 70 50 61 67 65 53 69 7a 65 20 69 73 20 73 65 *pPageSize is se
24c20 74 20 74 6f 20 74 68 65 20 6f 6c 64 2c 20 72 65 t to the old, re
24c30 74 61 69 6e 65 64 20 70 61 67 65 20 73 69 7a 65 tained page size
24c40 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e before returnin
24c50 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 g..*/.int sqlite
24c60 33 50 61 67 65 72 53 65 74 50 61 67 65 73 69 7a 3PagerSetPagesiz
24c70 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c e(Pager *pPager,
24c80 20 75 33 32 20 2a 70 50 61 67 65 53 69 7a 65 2c u32 *pPageSize,
24c90 20 69 6e 74 20 6e 52 65 73 65 72 76 65 29 7b 0a int nReserve){.
24ca0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
24cb0 45 5f 4f 4b 3b 0a 0a 20 20 2f 2a 20 49 74 20 69 E_OK;.. /* It i
24cc0 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 74 s not possible t
24cd0 6f 20 64 6f 20 61 20 66 75 6c 6c 20 61 73 73 65 o do a full asse
24ce0 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 29 rt_pager_state()
24cf0 20 68 65 72 65 2c 20 61 73 20 74 68 69 73 0a 20 here, as this.
24d00 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 ** function may
24d10 20 62 65 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 be called from
24d20 77 69 74 68 69 6e 20 50 61 67 65 72 4f 70 65 6e within PagerOpen
24d30 28 29 2c 20 62 65 66 6f 72 65 20 74 68 65 20 73 (), before the s
24d40 74 61 74 65 0a 20 20 2a 2a 20 6f 66 20 74 68 65 tate. ** of the
24d50 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 69 73 Pager object is
24d60 20 69 6e 74 65 72 6e 61 6c 6c 79 20 63 6f 6e 73 internally cons
24d70 69 73 74 65 6e 74 2e 0a 20 20 2a 2a 0a 20 20 2a istent.. **. *
24d80 2a 20 41 74 20 6f 6e 65 20 70 6f 69 6e 74 20 74 * At one point t
24d90 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 his function ret
24da0 75 72 6e 65 64 20 61 6e 20 65 72 72 6f 72 20 69 urned an error i
24db0 66 20 74 68 65 20 70 61 67 65 72 20 77 61 73 20 f the pager was
24dc0 69 6e 20 0a 20 20 2a 2a 20 50 41 47 45 52 5f 45 in . ** PAGER_E
24dd0 52 52 4f 52 20 73 74 61 74 65 2e 20 42 75 74 20 RROR state. But
24de0 73 69 6e 63 65 20 50 41 47 45 52 5f 45 52 52 4f since PAGER_ERRO
24df0 52 20 73 74 61 74 65 20 67 75 61 72 61 6e 74 65 R state guarante
24e00 65 73 20 74 68 61 74 0a 20 20 2a 2a 20 74 68 65 es that. ** the
24e10 72 65 20 69 73 20 61 74 20 6c 65 61 73 74 20 6f re is at least o
24e20 6e 65 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 ne outstanding p
24e30 61 67 65 20 72 65 66 65 72 65 6e 63 65 2c 20 74 age reference, t
24e40 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 20 20 2a his function. *
24e50 2a 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f 72 * is a no-op for
24e60 20 74 68 61 74 20 63 61 73 65 20 61 6e 79 68 6f that case anyho
24e70 77 2e 0a 20 20 2a 2f 0a 0a 20 20 75 33 32 20 70 w.. */.. u32 p
24e80 61 67 65 53 69 7a 65 20 3d 20 2a 70 50 61 67 65 ageSize = *pPage
24e90 53 69 7a 65 3b 0a 20 20 61 73 73 65 72 74 28 20 Size;. assert(
24ea0 70 61 67 65 53 69 7a 65 3d 3d 30 20 7c 7c 20 28 pageSize==0 || (
24eb0 70 61 67 65 53 69 7a 65 3e 3d 35 31 32 20 26 26 pageSize>=512 &&
24ec0 20 70 61 67 65 53 69 7a 65 3c 3d 53 51 4c 49 54 pageSize<=SQLIT
24ed0 45 5f 4d 41 58 5f 50 41 47 45 5f 53 49 5a 45 29 E_MAX_PAGE_SIZE)
24ee0 20 29 3b 0a 20 20 69 66 28 20 28 70 50 61 67 65 );. if( (pPage
24ef0 72 2d 3e 6d 65 6d 44 62 3d 3d 30 20 7c 7c 20 70 r->memDb==0 || p
24f00 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3d 3d 30 Pager->dbSize==0
24f10 29 0a 20 20 20 26 26 20 73 71 6c 69 74 65 33 50 ). && sqlite3P
24f20 63 61 63 68 65 52 65 66 43 6f 75 6e 74 28 70 50 cacheRefCount(pP
24f30 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d ager->pPCache)==
24f40 30 20 0a 20 20 20 26 26 20 70 61 67 65 53 69 7a 0 . && pageSiz
24f50 65 20 26 26 20 70 61 67 65 53 69 7a 65 21 3d 28 e && pageSize!=(
24f60 75 33 32 29 70 50 61 67 65 72 2d 3e 70 61 67 65 u32)pPager->page
24f70 53 69 7a 65 20 0a 20 20 29 7b 0a 20 20 20 20 63 Size . ){. c
24f80 68 61 72 20 2a 70 4e 65 77 20 3d 20 4e 55 4c 4c har *pNew = NULL
24f90 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
24fa0 20 4e 65 77 20 74 65 6d 70 20 73 70 61 63 65 20 New temp space
24fb0 2a 2f 0a 20 20 20 20 69 36 34 20 6e 42 79 74 65 */. i64 nByte
24fc0 20 3d 20 30 3b 0a 0a 20 20 20 20 69 66 28 20 70 = 0;.. if( p
24fd0 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 50 41 Pager->eState>PA
24fe0 47 45 52 5f 4f 50 45 4e 20 26 26 20 69 73 4f 70 GER_OPEN && isOp
24ff0 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 29 en(pPager->fd) )
25000 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c {. rc = sql
25010 69 74 65 33 4f 73 46 69 6c 65 53 69 7a 65 28 70 ite3OsFileSize(p
25020 50 61 67 65 72 2d 3e 66 64 2c 20 26 6e 42 79 74 Pager->fd, &nByt
25030 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 e);. }. if
25040 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
25050 29 7b 0a 20 20 20 20 20 20 70 4e 65 77 20 3d 20 ){. pNew =
25060 28 63 68 61 72 20 2a 29 73 71 6c 69 74 65 33 50 (char *)sqlite3P
25070 61 67 65 4d 61 6c 6c 6f 63 28 70 61 67 65 53 69 ageMalloc(pageSi
25080 7a 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 ze);. if( !
25090 70 4e 65 77 20 29 20 72 63 20 3d 20 53 51 4c 49 pNew ) rc = SQLI
250a0 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 TE_NOMEM_BKPT;.
250b0 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 72 63 }.. if( rc
250c0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 ==SQLITE_OK ){.
250d0 20 20 20 20 20 70 61 67 65 72 5f 72 65 73 65 74 pager_reset
250e0 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 (pPager);.
250f0 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 rc = sqlite3Pcac
25100 68 65 53 65 74 50 61 67 65 53 69 7a 65 28 70 50 heSetPageSize(pP
25110 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 70 ager->pPCache, p
25120 61 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 7d 0a ageSize);. }.
25130 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
25140 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 TE_OK ){. s
25150 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 70 qlite3PageFree(p
25160 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 63 65 Pager->pTmpSpace
25170 29 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d );. pPager-
25180 3e 70 54 6d 70 53 70 61 63 65 20 3d 20 70 4e 65 >pTmpSpace = pNe
25190 77 3b 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d w;. pPager-
251a0 3e 64 62 53 69 7a 65 20 3d 20 28 50 67 6e 6f 29 >dbSize = (Pgno)
251b0 28 28 6e 42 79 74 65 2b 70 61 67 65 53 69 7a 65 ((nByte+pageSize
251c0 2d 31 29 2f 70 61 67 65 53 69 7a 65 29 3b 0a 20 -1)/pageSize);.
251d0 20 20 20 20 20 70 50 61 67 65 72 2d 3e 70 61 67 pPager->pag
251e0 65 53 69 7a 65 20 3d 20 70 61 67 65 53 69 7a 65 eSize = pageSize
251f0 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ;. }else{.
25200 20 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 sqlite3PageFr
25210 65 65 28 70 4e 65 77 29 3b 0a 20 20 20 20 7d 0a ee(pNew);. }.
25220 20 20 7d 0a 0a 20 20 2a 70 50 61 67 65 53 69 7a }.. *pPageSiz
25230 65 20 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 e = pPager->page
25240 53 69 7a 65 3b 0a 20 20 69 66 28 20 72 63 3d 3d Size;. if( rc==
25250 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
25260 20 69 66 28 20 6e 52 65 73 65 72 76 65 3c 30 20 if( nReserve<0
25270 29 20 6e 52 65 73 65 72 76 65 20 3d 20 70 50 61 ) nReserve = pPa
25280 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 3b 0a 20 ger->nReserve;.
25290 20 20 20 61 73 73 65 72 74 28 20 6e 52 65 73 65 assert( nRese
252a0 72 76 65 3e 3d 30 20 26 26 20 6e 52 65 73 65 72 rve>=0 && nReser
252b0 76 65 3c 31 30 30 30 20 29 3b 0a 20 20 20 20 70 ve<1000 );. p
252c0 50 61 67 65 72 2d 3e 6e 52 65 73 65 72 76 65 20 Pager->nReserve
252d0 3d 20 28 69 31 36 29 6e 52 65 73 65 72 76 65 3b = (i16)nReserve;
252e0 0a 20 20 20 20 70 61 67 65 72 52 65 70 6f 72 74 . pagerReport
252f0 53 69 7a 65 28 70 50 61 67 65 72 29 3b 0a 20 20 Size(pPager);.
25300 20 20 70 61 67 65 72 46 69 78 4d 61 70 6c 69 6d pagerFixMaplim
25310 69 74 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a it(pPager);. }.
25320 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
25330 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 20 70 /*.** Return a p
25340 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 22 74 ointer to the "t
25350 65 6d 70 6f 72 61 72 79 20 70 61 67 65 22 20 62 emporary page" b
25360 75 66 66 65 72 20 68 65 6c 64 20 69 6e 74 65 72 uffer held inter
25370 6e 61 6c 6c 79 0a 2a 2a 20 62 79 20 74 68 65 20 nally.** by the
25380 70 61 67 65 72 2e 20 20 54 68 69 73 20 69 73 20 pager. This is
25390 61 20 62 75 66 66 65 72 20 74 68 61 74 20 69 73 a buffer that is
253a0 20 62 69 67 20 65 6e 6f 75 67 68 20 74 6f 20 68 big enough to h
253b0 6f 6c 64 20 74 68 65 0a 2a 2a 20 65 6e 74 69 72 old the.** entir
253c0 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 64 e content of a d
253d0 61 74 61 62 61 73 65 20 70 61 67 65 2e 20 20 54 atabase page. T
253e0 68 69 73 20 62 75 66 66 65 72 20 69 73 20 75 73 his buffer is us
253f0 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 0a 2a 2a ed internally.**
25400 20 64 75 72 69 6e 67 20 72 6f 6c 6c 62 61 63 6b during rollback
25410 20 61 6e 64 20 77 69 6c 6c 20 62 65 20 6f 76 65 and will be ove
25420 72 77 72 69 74 74 65 6e 20 77 68 65 6e 65 76 65 rwritten wheneve
25430 72 20 61 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 r a rollback.**
25440 6f 63 63 75 72 73 2e 20 20 42 75 74 20 6f 74 68 occurs. But oth
25450 65 72 20 6d 6f 64 75 6c 65 73 20 61 72 65 20 66 er modules are f
25460 72 65 65 20 74 6f 20 75 73 65 20 69 74 20 74 6f ree to use it to
25470 6f 2c 20 61 73 20 6c 6f 6e 67 20 61 73 0a 2a 2a o, as long as.**
25480 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 73 20 61 72 no rollbacks ar
25490 65 20 68 61 70 70 65 6e 69 6e 67 2e 0a 2a 2f 0a e happening..*/.
254a0 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 61 67 void *sqlite3Pag
254b0 65 72 54 65 6d 70 53 70 61 63 65 28 50 61 67 65 erTempSpace(Page
254c0 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 72 65 r *pPager){. re
254d0 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 70 54 6d turn pPager->pTm
254e0 70 53 70 61 63 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a pSpace;.}../*.**
254f0 20 41 74 74 65 6d 70 74 20 74 6f 20 73 65 74 20 Attempt to set
25500 74 68 65 20 6d 61 78 69 6d 75 6d 20 64 61 74 61 the maximum data
25510 62 61 73 65 20 70 61 67 65 20 63 6f 75 6e 74 20 base page count
25520 69 66 20 6d 78 50 61 67 65 20 69 73 20 70 6f 73 if mxPage is pos
25530 69 74 69 76 65 2e 20 0a 2a 2a 20 4d 61 6b 65 20 itive. .** Make
25540 6e 6f 20 63 68 61 6e 67 65 73 20 69 66 20 6d 78 no changes if mx
25550 50 61 67 65 20 69 73 20 7a 65 72 6f 20 6f 72 20 Page is zero or
25560 6e 65 67 61 74 69 76 65 2e 20 20 41 6e 64 20 6e negative. And n
25570 65 76 65 72 20 72 65 64 75 63 65 20 74 68 65 0a ever reduce the.
25580 2a 2a 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 ** maximum page
25590 63 6f 75 6e 74 20 62 65 6c 6f 77 20 74 68 65 20 count below the
255a0 63 75 72 72 65 6e 74 20 73 69 7a 65 20 6f 66 20 current size of
255b0 74 68 65 20 64 61 74 61 62 61 73 65 2e 0a 2a 2a the database..**
255c0 0a 2a 2a 20 52 65 67 61 72 64 6c 65 73 73 20 6f .** Regardless o
255d0 66 20 6d 78 50 61 67 65 2c 20 72 65 74 75 72 6e f mxPage, return
255e0 20 74 68 65 20 63 75 72 72 65 6e 74 20 6d 61 78 the current max
255f0 69 6d 75 6d 20 70 61 67 65 20 63 6f 75 6e 74 2e imum page count.
25600 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 .*/.int sqlite3P
25610 61 67 65 72 4d 61 78 50 61 67 65 43 6f 75 6e 74 agerMaxPageCount
25620 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 (Pager *pPager,
25630 69 6e 74 20 6d 78 50 61 67 65 29 7b 0a 20 20 69 int mxPage){. i
25640 66 28 20 6d 78 50 61 67 65 3e 30 20 29 7b 0a 20 f( mxPage>0 ){.
25650 20 20 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e pPager->mxPgn
25660 6f 20 3d 20 6d 78 50 61 67 65 3b 0a 20 20 7d 0a o = mxPage;. }.
25670 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
25680 2d 3e 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f ->eState!=PAGER_
25690 4f 50 45 4e 20 29 3b 20 20 20 20 20 20 2f 2a 20 OPEN ); /*
256a0 43 61 6c 6c 65 64 20 6f 6e 6c 79 20 62 79 20 4f Called only by O
256b0 50 5f 4d 61 78 50 67 63 6e 74 20 2a 2f 0a 20 20 P_MaxPgcnt */.
256c0 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
256d0 6d 78 50 67 6e 6f 3e 3d 70 50 61 67 65 72 2d 3e mxPgno>=pPager->
256e0 64 62 53 69 7a 65 20 29 3b 20 20 2f 2a 20 4f 50 dbSize ); /* OP
256f0 5f 4d 61 78 50 67 63 6e 74 20 65 6e 66 6f 72 63 _MaxPgcnt enforc
25700 65 73 20 74 68 69 73 20 2a 2f 0a 20 20 72 65 74 es this */. ret
25710 75 72 6e 20 70 50 61 67 65 72 2d 3e 6d 78 50 67 urn pPager->mxPg
25720 6e 6f 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 no;.}../*.** The
25730 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 74 20 6f following set o
25740 66 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 75 f routines are u
25750 73 65 64 20 74 6f 20 64 69 73 61 62 6c 65 20 74 sed to disable t
25760 68 65 20 73 69 6d 75 6c 61 74 65 64 0a 2a 2a 20 he simulated.**
25770 49 2f 4f 20 65 72 72 6f 72 20 6d 65 63 68 61 6e I/O error mechan
25780 69 73 6d 2e 20 20 54 68 65 73 65 20 72 6f 75 74 ism. These rout
25790 69 6e 65 73 20 61 72 65 20 75 73 65 64 20 74 6f ines are used to
257a0 20 61 76 6f 69 64 20 73 69 6d 75 6c 61 74 65 64 avoid simulated
257b0 0a 2a 2a 20 65 72 72 6f 72 73 20 69 6e 20 70 6c .** errors in pl
257c0 61 63 65 73 20 77 68 65 72 65 20 77 65 20 64 6f aces where we do
257d0 20 6e 6f 74 20 63 61 72 65 20 61 62 6f 75 74 20 not care about
257e0 65 72 72 6f 72 73 2e 0a 2a 2a 0a 2a 2a 20 55 6e errors..**.** Un
257f0 6c 65 73 73 20 2d 44 53 51 4c 49 54 45 5f 54 45 less -DSQLITE_TE
25800 53 54 3d 31 20 69 73 20 75 73 65 64 2c 20 74 68 ST=1 is used, th
25810 65 73 65 20 72 6f 75 74 69 6e 65 73 20 61 72 65 ese routines are
25820 20 61 6c 6c 20 6e 6f 2d 6f 70 73 0a 2a 2a 20 61 all no-ops.** a
25830 6e 64 20 67 65 6e 65 72 61 74 65 20 6e 6f 20 63 nd generate no c
25840 6f 64 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ode..*/.#ifdef S
25850 51 4c 49 54 45 5f 54 45 53 54 0a 65 78 74 65 72 QLITE_TEST.exter
25860 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 69 6f n int sqlite3_io
25870 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e 67 3b 0a _error_pending;.
25880 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 extern int sqlit
25890 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 68 69 74 3b e3_io_error_hit;
258a0 0a 73 74 61 74 69 63 20 69 6e 74 20 73 61 76 65 .static int save
258b0 64 5f 63 6e 74 3b 0a 76 6f 69 64 20 64 69 73 61 d_cnt;.void disa
258c0 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f ble_simulated_io
258d0 5f 65 72 72 6f 72 73 28 76 6f 69 64 29 7b 0a 20 _errors(void){.
258e0 20 73 61 76 65 64 5f 63 6e 74 20 3d 20 73 71 6c saved_cnt = sql
258f0 69 74 65 33 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 ite3_io_error_pe
25900 6e 64 69 6e 67 3b 0a 20 20 73 71 6c 69 74 65 33 nding;. sqlite3
25910 5f 69 6f 5f 65 72 72 6f 72 5f 70 65 6e 64 69 6e _io_error_pendin
25920 67 20 3d 20 2d 31 3b 0a 7d 0a 76 6f 69 64 20 65 g = -1;.}.void e
25930 6e 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f nable_simulated_
25940 69 6f 5f 65 72 72 6f 72 73 28 76 6f 69 64 29 7b io_errors(void){
25950 0a 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 65 72 . sqlite3_io_er
25960 72 6f 72 5f 70 65 6e 64 69 6e 67 20 3d 20 73 61 ror_pending = sa
25970 76 65 64 5f 63 6e 74 3b 0a 7d 0a 23 65 6c 73 65 ved_cnt;.}.#else
25980 0a 23 20 64 65 66 69 6e 65 20 64 69 73 61 62 6c .# define disabl
25990 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 e_simulated_io_e
259a0 72 72 6f 72 73 28 29 0a 23 20 64 65 66 69 6e 65 rrors().# define
259b0 20 65 6e 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 enable_simulate
259c0 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29 0a 23 65 d_io_errors().#e
259d0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 61 64 ndif../*.** Read
259e0 20 74 68 65 20 66 69 72 73 74 20 4e 20 62 79 74 the first N byt
259f0 65 73 20 66 72 6f 6d 20 74 68 65 20 62 65 67 69 es from the begi
25a00 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 66 69 6c nning of the fil
25a10 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 0a 2a 2a e into memory.**
25a20 20 74 68 61 74 20 70 44 65 73 74 20 70 6f 69 6e that pDest poin
25a30 74 73 20 74 6f 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 ts to. .**.** If
25a40 20 74 68 65 20 70 61 67 65 72 20 77 61 73 20 6f the pager was o
25a50 70 65 6e 65 64 20 6f 6e 20 61 20 74 72 61 6e 73 pened on a trans
25a60 69 65 6e 74 20 66 69 6c 65 20 28 7a 46 69 6c 65 ient file (zFile
25a70 6e 61 6d 65 3d 3d 22 22 29 2c 20 6f 72 0a 2a 2a name==""), or.**
25a80 20 6f 70 65 6e 65 64 20 6f 6e 20 61 20 66 69 6c opened on a fil
25a90 65 20 6c 65 73 73 20 74 68 61 6e 20 4e 20 62 79 e less than N by
25aa0 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 74 68 65 tes in size, the
25ab0 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 20 69 output buffer i
25ac0 73 0a 2a 2a 20 7a 65 72 6f 65 64 20 61 6e 64 20 s.** zeroed and
25ad0 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e SQLITE_OK return
25ae0 65 64 2e 20 54 68 65 20 72 61 74 69 6f 6e 61 6c ed. The rational
25af0 65 20 66 6f 72 20 74 68 69 73 20 69 73 20 74 68 e for this is th
25b00 61 74 20 74 68 69 73 20 0a 2a 2a 20 66 75 6e 63 at this .** func
25b10 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20 tion is used to
25b20 72 65 61 64 20 64 61 74 61 62 61 73 65 20 68 65 read database he
25b30 61 64 65 72 73 2c 20 61 6e 64 20 61 20 6e 65 77 aders, and a new
25b40 20 74 72 61 6e 73 69 65 6e 74 20 6f 72 0a 2a 2a transient or.**
25b50 20 7a 65 72 6f 20 73 69 7a 65 64 20 64 61 74 61 zero sized data
25b60 62 61 73 65 20 68 61 73 20 61 20 68 65 61 64 65 base has a heade
25b70 72 20 74 68 61 6e 20 63 6f 6e 73 69 73 74 73 20 r than consists
25b80 65 6e 74 69 72 65 6c 79 20 6f 66 20 7a 65 72 6f entirely of zero
25b90 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 79 es..**.** If any
25ba0 20 49 4f 20 65 72 72 6f 72 20 61 70 61 72 74 20 IO error apart
25bb0 66 72 6f 6d 20 53 51 4c 49 54 45 5f 49 4f 45 52 from SQLITE_IOER
25bc0 52 5f 53 48 4f 52 54 5f 52 45 41 44 20 69 73 20 R_SHORT_READ is
25bd0 65 6e 63 6f 75 6e 74 65 72 65 64 2c 0a 2a 2a 20 encountered,.**
25be0 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 20 69 the error code i
25bf0 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20 74 68 s returned to th
25c00 65 20 63 61 6c 6c 65 72 20 61 6e 64 20 74 68 65 e caller and the
25c10 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74 68 65 contents of the
25c20 0a 2a 2a 20 6f 75 74 70 75 74 20 62 75 66 66 65 .** output buffe
25c30 72 20 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a r undefined..*/.
25c40 69 6e 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 int sqlite3Pager
25c50 52 65 61 64 46 69 6c 65 68 65 61 64 65 72 28 50 ReadFileheader(P
25c60 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 69 6e ager *pPager, in
25c70 74 20 4e 2c 20 75 6e 73 69 67 6e 65 64 20 63 68 t N, unsigned ch
25c80 61 72 20 2a 70 44 65 73 74 29 7b 0a 20 20 69 6e ar *pDest){. in
25c90 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
25ca0 3b 0a 20 20 6d 65 6d 73 65 74 28 70 44 65 73 74 ;. memset(pDest
25cb0 2c 20 30 2c 20 4e 29 3b 0a 20 20 61 73 73 65 72 , 0, N);. asser
25cc0 74 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 t( isOpen(pPager
25cd0 2d 3e 66 64 29 20 7c 7c 20 70 50 61 67 65 72 2d ->fd) || pPager-
25ce0 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 0a 20 20 >tempFile );..
25cf0 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 /* This routine
25d00 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 62 is only called b
25d10 79 20 62 74 72 65 65 20 69 6d 6d 65 64 69 61 74 y btree immediat
25d20 65 6c 79 20 61 66 74 65 72 20 63 72 65 61 74 69 ely after creati
25d30 6e 67 0a 20 20 2a 2a 20 74 68 65 20 50 61 67 65 ng. ** the Page
25d40 72 20 6f 62 6a 65 63 74 2e 20 20 54 68 65 72 65 r object. There
25d50 20 68 61 73 20 6e 6f 74 20 62 65 65 6e 20 61 6e has not been an
25d60 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 6f 20 opportunity to
25d70 74 72 61 6e 73 69 74 69 6f 6e 0a 20 20 2a 2a 20 transition. **
25d80 74 6f 20 57 41 4c 20 6d 6f 64 65 20 79 65 74 2e to WAL mode yet.
25d90 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 . */. assert(
25da0 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 !pagerUseWal(pPa
25db0 67 65 72 29 20 29 3b 0a 0a 20 20 69 66 28 20 69 ger) );.. if( i
25dc0 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 sOpen(pPager->fd
25dd0 29 20 29 7b 0a 20 20 20 20 49 4f 54 52 41 43 45 ) ){. IOTRACE
25de0 28 28 22 44 42 48 44 52 20 25 70 20 30 20 25 64 (("DBHDR %p 0 %d
25df0 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 4e 29 29 \n", pPager, N))
25e00 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 . rc = sqlite
25e10 33 4f 73 52 65 61 64 28 70 50 61 67 65 72 2d 3e 3OsRead(pPager->
25e20 66 64 2c 20 70 44 65 73 74 2c 20 4e 2c 20 30 29 fd, pDest, N, 0)
25e30 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 ;. if( rc==SQ
25e40 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 LITE_IOERR_SHORT
25e50 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 72 _READ ){. r
25e60 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
25e70 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
25e80 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
25e90 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 his function may
25ea0 20 6f 6e 6c 79 20 62 65 20 63 61 6c 6c 65 64 20 only be called
25eb0 77 68 65 6e 20 61 20 72 65 61 64 2d 74 72 61 6e when a read-tran
25ec0 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 20 saction is open
25ed0 6f 6e 0a 2a 2a 20 74 68 65 20 70 61 67 65 72 2e on.** the pager.
25ee0 20 49 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 It returns the
25ef0 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 total number of
25f00 70 61 67 65 73 20 69 6e 20 74 68 65 20 64 61 74 pages in the dat
25f10 61 62 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 48 6f 77 abase..**.** How
25f20 65 76 65 72 2c 20 69 66 20 74 68 65 20 66 69 6c ever, if the fil
25f30 65 20 69 73 20 62 65 74 77 65 65 6e 20 31 20 61 e is between 1 a
25f40 6e 64 20 3c 70 61 67 65 2d 73 69 7a 65 3e 20 62 nd <page-size> b
25f50 79 74 65 73 20 69 6e 20 73 69 7a 65 2c 20 74 68 ytes in size, th
25f60 65 6e 20 0a 2a 2a 20 74 68 69 73 20 69 73 20 63 en .** this is c
25f70 6f 6e 73 69 64 65 72 65 64 20 61 20 31 20 70 61 onsidered a 1 pa
25f80 67 65 20 66 69 6c 65 2e 0a 2a 2f 0a 76 6f 69 64 ge file..*/.void
25f90 20 73 71 6c 69 74 65 33 50 61 67 65 72 50 61 67 sqlite3PagerPag
25fa0 65 63 6f 75 6e 74 28 50 61 67 65 72 20 2a 70 50 ecount(Pager *pP
25fb0 61 67 65 72 2c 20 69 6e 74 20 2a 70 6e 50 61 67 ager, int *pnPag
25fc0 65 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70 50 e){. assert( pP
25fd0 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 ager->eState>=PA
25fe0 47 45 52 5f 52 45 41 44 45 52 20 29 3b 0a 20 20 GER_READER );.
25ff0 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
26000 65 53 74 61 74 65 21 3d 50 41 47 45 52 5f 57 52 eState!=PAGER_WR
26010 49 54 45 52 5f 46 49 4e 49 53 48 45 44 20 29 3b ITER_FINISHED );
26020 0a 20 20 2a 70 6e 50 61 67 65 20 3d 20 28 69 6e . *pnPage = (in
26030 74 29 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 t)pPager->dbSize
26040 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 ;.}.../*.** Try
26050 74 6f 20 6f 62 74 61 69 6e 20 61 20 6c 6f 63 6b to obtain a lock
26060 20 6f 66 20 74 79 70 65 20 6c 6f 63 6b 74 79 70 of type locktyp
26070 65 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 e on the databas
26080 65 20 66 69 6c 65 2e 20 49 66 0a 2a 2a 20 61 20 e file. If.** a
26090 73 69 6d 69 6c 61 72 20 6f 72 20 67 72 65 61 74 similar or great
260a0 65 72 20 6c 6f 63 6b 20 69 73 20 61 6c 72 65 61 er lock is alrea
260b0 64 79 20 68 65 6c 64 2c 20 74 68 69 73 20 66 75 dy held, this fu
260c0 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f nction is a no-o
260d0 70 0a 2a 2a 20 28 72 65 74 75 72 6e 69 6e 67 20 p.** (returning
260e0 53 51 4c 49 54 45 5f 4f 4b 20 69 6d 6d 65 64 69 SQLITE_OK immedi
260f0 61 74 65 6c 79 29 2e 0a 2a 2a 0a 2a 2a 20 4f 74 ately)..**.** Ot
26100 68 65 72 77 69 73 65 2c 20 61 74 74 65 6d 70 74 herwise, attempt
26110 20 74 6f 20 6f 62 74 61 69 6e 20 74 68 65 20 6c to obtain the l
26120 6f 63 6b 20 75 73 69 6e 67 20 73 71 6c 69 74 65 ock using sqlite
26130 33 4f 73 4c 6f 63 6b 28 29 2e 20 49 6e 76 6f 6b 3OsLock(). Invok
26140 65 20 0a 2a 2a 20 74 68 65 20 62 75 73 79 20 63 e .** the busy c
26150 61 6c 6c 62 61 63 6b 20 69 66 20 74 68 65 20 6c allback if the l
26160 6f 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c 79 ock is currently
26170 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 not available.
26180 52 65 70 65 61 74 20 0a 2a 2a 20 75 6e 74 69 6c Repeat .** until
26190 20 74 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 the busy callba
261a0 63 6b 20 72 65 74 75 72 6e 73 20 66 61 6c 73 65 ck returns false
261b0 20 6f 72 20 75 6e 74 69 6c 20 74 68 65 20 61 74 or until the at
261c0 74 65 6d 70 74 20 74 6f 20 0a 2a 2a 20 6f 62 74 tempt to .** obt
261d0 61 69 6e 20 74 68 65 20 6c 6f 63 6b 20 73 75 63 ain the lock suc
261e0 63 65 65 64 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 ceeds..**.** Ret
261f0 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e urn SQLITE_OK on
26200 20 73 75 63 63 65 73 73 20 61 6e 64 20 61 6e 20 success and an
26210 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 77 65 error code if we
26220 20 63 61 6e 6e 6f 74 20 6f 62 74 61 69 6e 0a 2a cannot obtain.*
26230 2a 20 74 68 65 20 6c 6f 63 6b 2e 20 49 66 20 74 * the lock. If t
26240 68 65 20 6c 6f 63 6b 20 69 73 20 6f 62 74 61 69 he lock is obtai
26250 6e 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c 79 ned successfully
26260 2c 20 73 65 74 20 74 68 65 20 50 61 67 65 72 2e , set the Pager.
26270 73 74 61 74 65 20 0a 2a 2a 20 76 61 72 69 61 62 state .** variab
26280 6c 65 20 74 6f 20 6c 6f 63 6b 74 79 70 65 20 62 le to locktype b
26290 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e efore returning.
262a0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 70 .*/.static int p
262b0 61 67 65 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 ager_wait_on_loc
262c0 6b 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c k(Pager *pPager,
262d0 20 69 6e 74 20 6c 6f 63 6b 74 79 70 65 29 7b 0a int locktype){.
262e0 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
262f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26300 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
26310 20 63 6f 64 65 20 2a 2f 0a 0a 20 20 2f 2a 20 43 code */.. /* C
26320 68 65 63 6b 20 74 68 61 74 20 74 68 69 73 20 69 heck that this i
26330 73 20 65 69 74 68 65 72 20 61 20 6e 6f 2d 6f 70 s either a no-op
26340 20 28 62 65 63 61 75 73 65 20 74 68 65 20 72 65 (because the re
26350 71 75 65 73 74 65 64 20 6c 6f 63 6b 20 69 73 20 quested lock is
26360 0a 20 20 2a 2a 20 61 6c 72 65 61 64 79 20 68 65 . ** already he
26370 6c 64 29 2c 20 6f 72 20 6f 6e 65 20 6f 66 20 74 ld), or one of t
26380 68 65 20 74 72 61 6e 73 69 74 69 6f 6e 73 20 74 he transitions t
26390 68 61 74 20 74 68 65 20 62 75 73 79 2d 68 61 6e hat the busy-han
263a0 64 6c 65 72 0a 20 20 2a 2a 20 6d 61 79 20 62 65 dler. ** may be
263b0 20 69 6e 76 6f 6b 65 64 20 64 75 72 69 6e 67 2c invoked during,
263c0 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 according to th
263d0 65 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 0a e comment above.
263e0 20 20 2a 2a 20 73 71 6c 69 74 65 33 50 61 67 65 ** sqlite3Page
263f0 72 53 65 74 42 75 73 79 68 61 6e 64 6c 65 72 28 rSetBusyhandler(
26400 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 ).. */. assert
26410 28 20 28 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b ( (pPager->eLock
26420 3e 3d 6c 6f 63 6b 74 79 70 65 29 0a 20 20 20 20 >=locktype).
26430 20 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 65 || (pPager->e
26440 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f 43 4b 20 26 26 Lock==NO_LOCK &&
26450 20 6c 6f 63 6b 74 79 70 65 3d 3d 53 48 41 52 45 locktype==SHARE
26460 44 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 20 7c D_LOCK). |
26470 7c 20 28 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b | (pPager->eLock
26480 3d 3d 52 45 53 45 52 56 45 44 5f 4c 4f 43 4b 20 ==RESERVED_LOCK
26490 26 26 20 6c 6f 63 6b 74 79 70 65 3d 3d 45 58 43 && locktype==EXC
264a0 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 0a 20 20 29 LUSIVE_LOCK). )
264b0 3b 0a 0a 20 20 64 6f 20 7b 0a 20 20 20 20 72 63 ;.. do {. rc
264c0 20 3d 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 = pagerLockDb(p
264d0 50 61 67 65 72 2c 20 6c 6f 63 6b 74 79 70 65 29 Pager, locktype)
264e0 3b 0a 20 20 7d 77 68 69 6c 65 28 20 72 63 3d 3d ;. }while( rc==
264f0 53 51 4c 49 54 45 5f 42 55 53 59 20 26 26 20 70 SQLITE_BUSY && p
26500 50 61 67 65 72 2d 3e 78 42 75 73 79 48 61 6e 64 Pager->xBusyHand
26510 6c 65 72 28 70 50 61 67 65 72 2d 3e 70 42 75 73 ler(pPager->pBus
26520 79 48 61 6e 64 6c 65 72 41 72 67 29 20 29 3b 0a yHandlerArg) );.
26530 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
26540 2f 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 61 /*.** Function a
26550 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e ssertTruncateCon
26560 73 74 72 61 69 6e 74 28 70 50 61 67 65 72 29 20 straint(pPager)
26570 63 68 65 63 6b 73 20 74 68 61 74 20 6f 6e 65 20 checks that one
26580 6f 66 20 74 68 65 20 0a 2a 2a 20 66 6f 6c 6c 6f of the .** follo
26590 77 69 6e 67 20 69 73 20 74 72 75 65 20 66 6f 72 wing is true for
265a0 20 61 6c 6c 20 64 69 72 74 79 20 70 61 67 65 73 all dirty pages
265b0 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 74 68 currently in th
265c0 65 20 70 61 67 65 2d 63 61 63 68 65 3a 0a 2a 2a e page-cache:.**
265d0 0a 2a 2a 20 20 20 61 29 20 54 68 65 20 70 61 67 .** a) The pag
265e0 65 20 6e 75 6d 62 65 72 20 69 73 20 6c 65 73 73 e number is less
265f0 20 74 68 61 6e 20 6f 72 20 65 71 75 61 6c 20 74 than or equal t
26600 6f 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 68 o the size of th
26610 65 20 0a 2a 2a 20 20 20 20 20 20 63 75 72 72 65 e .** curre
26620 6e 74 20 64 61 74 61 62 61 73 65 20 69 6d 61 67 nt database imag
26630 65 2c 20 69 6e 20 70 61 67 65 73 2c 20 4f 52 0a e, in pages, OR.
26640 2a 2a 0a 2a 2a 20 20 20 62 29 20 69 66 20 74 68 **.** b) if th
26650 65 20 70 61 67 65 20 63 6f 6e 74 65 6e 74 20 77 e page content w
26660 65 72 65 20 77 72 69 74 74 65 6e 20 61 74 20 74 ere written at t
26670 68 69 73 20 74 69 6d 65 2c 20 69 74 20 77 6f 75 his time, it wou
26680 6c 64 20 6e 6f 74 0a 2a 2a 20 20 20 20 20 20 62 ld not.** b
26690 65 20 6e 65 63 65 73 73 61 72 79 20 74 6f 20 77 e necessary to w
266a0 72 69 74 65 20 74 68 65 20 63 75 72 72 65 6e 74 rite the current
266b0 20 63 6f 6e 74 65 6e 74 20 6f 75 74 20 74 6f 20 content out to
266c0 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 0a the sub-journal.
266d0 2a 2a 20 20 20 20 20 20 28 61 73 20 64 65 74 65 ** (as dete
266e0 72 6d 69 6e 65 64 20 62 79 20 66 75 6e 63 74 69 rmined by functi
266f0 6f 6e 20 73 75 62 6a 52 65 71 75 69 72 65 73 50 on subjRequiresP
26700 61 67 65 28 29 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 age())..**.** If
26710 20 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 20 61 the condition a
26720 73 73 65 72 74 65 64 20 62 79 20 74 68 69 73 20 sserted by this
26730 66 75 6e 63 74 69 6f 6e 20 77 65 72 65 20 6e 6f function were no
26740 74 20 74 72 75 65 2c 20 61 6e 64 20 74 68 65 0a t true, and the.
26750 2a 2a 20 64 69 72 74 79 20 70 61 67 65 20 77 65 ** dirty page we
26760 72 65 20 74 6f 20 62 65 20 64 69 73 63 61 72 64 re to be discard
26770 65 64 20 66 72 6f 6d 20 74 68 65 20 63 61 63 68 ed from the cach
26780 65 20 76 69 61 20 74 68 65 20 70 61 67 65 72 53 e via the pagerS
26790 74 72 65 73 73 28 29 0a 2a 2a 20 72 6f 75 74 69 tress().** routi
267a0 6e 65 2c 20 70 61 67 65 72 53 74 72 65 73 73 28 ne, pagerStress(
267b0 29 20 77 6f 75 6c 64 20 6e 6f 74 20 77 72 69 74 ) would not writ
267c0 65 20 74 68 65 20 63 75 72 72 65 6e 74 20 70 61 e the current pa
267d0 67 65 20 63 6f 6e 74 65 6e 74 20 74 6f 0a 2a 2a ge content to.**
267e0 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
267f0 6c 65 2e 20 49 66 20 61 20 73 61 76 65 70 6f 69 le. If a savepoi
26800 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 nt transaction w
26810 65 72 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 20 ere rolled back
26820 61 66 74 65 72 0a 2a 2a 20 74 68 69 73 20 68 61 after.** this ha
26830 70 70 65 6e 65 64 2c 20 74 68 65 20 63 6f 72 72 ppened, the corr
26840 65 63 74 20 62 65 68 61 76 69 6f 72 20 77 6f 75 ect behavior wou
26850 6c 64 20 62 65 20 74 6f 20 72 65 73 74 6f 72 65 ld be to restore
26860 20 74 68 65 20 63 75 72 72 65 6e 74 0a 2a 2a 20 the current.**
26870 63 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 70 content of the p
26880 61 67 65 2e 20 48 6f 77 65 76 65 72 2c 20 73 69 age. However, si
26890 6e 63 65 20 74 68 69 73 20 63 6f 6e 74 65 6e 74 nce this content
268a0 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 20 is not present
268b0 69 6e 20 65 69 74 68 65 72 0a 2a 2a 20 74 68 65 in either.** the
268c0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f database file o
268d0 72 20 74 68 65 20 70 6f 72 74 69 6f 6e 20 6f 66 r the portion of
268e0 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f the rollback jo
268f0 75 72 6e 61 6c 20 61 6e 64 20 0a 2a 2a 20 73 75 urnal and .** su
26900 62 2d 6a 6f 75 72 6e 61 6c 20 72 6f 6c 6c 65 64 b-journal rolled
26910 20 62 61 63 6b 20 74 68 65 20 63 6f 6e 74 65 6e back the conten
26920 74 20 63 6f 75 6c 64 20 6e 6f 74 20 62 65 20 72 t could not be r
26930 65 73 74 6f 72 65 64 20 61 6e 64 20 74 68 65 0a estored and the.
26940 2a 2a 20 64 61 74 61 62 61 73 65 20 69 6d 61 67 ** database imag
26950 65 20 77 6f 75 6c 64 20 62 65 63 6f 6d 65 20 63 e would become c
26960 6f 72 72 75 70 74 2e 20 49 74 20 69 73 20 74 68 orrupt. It is th
26970 65 72 65 66 6f 72 65 20 66 6f 72 74 75 6e 61 74 erefore fortunat
26980 65 20 74 68 61 74 20 0a 2a 2a 20 74 68 69 73 20 e that .** this
26990 63 69 72 63 75 6d 73 74 61 6e 63 65 20 63 61 6e circumstance can
269a0 6e 6f 74 20 61 72 69 73 65 2e 0a 2a 2f 0a 23 69 not arise..*/.#i
269b0 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
269c0 5f 44 45 42 55 47 29 0a 73 74 61 74 69 63 20 76 _DEBUG).static v
269d0 6f 69 64 20 61 73 73 65 72 74 54 72 75 6e 63 61 oid assertTrunca
269e0 74 65 43 6f 6e 73 74 72 61 69 6e 74 43 62 28 50 teConstraintCb(P
269f0 67 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 61 73 gHdr *pPg){. as
26a00 73 65 72 74 28 20 70 50 67 2d 3e 66 6c 61 67 73 sert( pPg->flags
26a10 26 50 47 48 44 52 5f 44 49 52 54 59 20 29 3b 0a &PGHDR_DIRTY );.
26a20 20 20 61 73 73 65 72 74 28 20 21 73 75 62 6a 52 assert( !subjR
26a30 65 71 75 69 72 65 73 50 61 67 65 28 70 50 67 29 equiresPage(pPg)
26a40 20 7c 7c 20 70 50 67 2d 3e 70 67 6e 6f 3c 3d 70 || pPg->pgno<=p
26a50 50 67 2d 3e 70 50 61 67 65 72 2d 3e 64 62 53 69 Pg->pPager->dbSi
26a60 7a 65 20 29 3b 0a 7d 0a 73 74 61 74 69 63 20 76 ze );.}.static v
26a70 6f 69 64 20 61 73 73 65 72 74 54 72 75 6e 63 61 oid assertTrunca
26a80 74 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 67 teConstraint(Pag
26a90 65 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 73 er *pPager){. s
26aa0 71 6c 69 74 65 33 50 63 61 63 68 65 49 74 65 72 qlite3PcacheIter
26ab0 61 74 65 44 69 72 74 79 28 70 50 61 67 65 72 2d ateDirty(pPager-
26ac0 3e 70 50 43 61 63 68 65 2c 20 61 73 73 65 72 74 >pPCache, assert
26ad0 54 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 TruncateConstrai
26ae0 6e 74 43 62 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 ntCb);.}.#else.#
26af0 20 64 65 66 69 6e 65 20 61 73 73 65 72 74 54 72 define assertTr
26b00 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 uncateConstraint
26b10 28 70 50 61 67 65 72 29 0a 23 65 6e 64 69 66 0a (pPager).#endif.
26b20 0a 2f 2a 0a 2a 2a 20 54 72 75 6e 63 61 74 65 20 ./*.** Truncate
26b30 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 the in-memory da
26b40 74 61 62 61 73 65 20 66 69 6c 65 20 69 6d 61 67 tabase file imag
26b50 65 20 74 6f 20 6e 50 61 67 65 20 70 61 67 65 73 e to nPage pages
26b60 2e 20 54 68 69 73 20 0a 2a 2a 20 66 75 6e 63 74 . This .** funct
26b70 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 20 61 63 74 ion does not act
26b80 75 61 6c 6c 79 20 6d 6f 64 69 66 79 20 74 68 65 ually modify the
26b90 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f database file o
26ba0 6e 20 64 69 73 6b 2e 20 49 74 20 0a 2a 2a 20 6a n disk. It .** j
26bb0 75 73 74 20 73 65 74 73 20 74 68 65 20 69 6e 74 ust sets the int
26bc0 65 72 6e 61 6c 20 73 74 61 74 65 20 6f 66 20 74 ernal state of t
26bd0 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 20 he pager object
26be0 73 6f 20 74 68 61 74 20 74 68 65 20 0a 2a 2a 20 so that the .**
26bf0 74 72 75 6e 63 61 74 69 6f 6e 20 77 69 6c 6c 20 truncation will
26c00 62 65 20 64 6f 6e 65 20 77 68 65 6e 20 74 68 65 be done when the
26c10 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 current transac
26c20 74 69 6f 6e 20 69 73 20 63 6f 6d 6d 69 74 74 65 tion is committe
26c30 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 d..**.** This fu
26c40 6e 63 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 63 nction is only c
26c50 61 6c 6c 65 64 20 72 69 67 68 74 20 62 65 66 6f alled right befo
26c60 72 65 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 re committing a
26c70 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 2a 2a 20 transaction..**
26c80 4f 6e 63 65 20 74 68 69 73 20 66 75 6e 63 74 69 Once this functi
26c90 6f 6e 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c on has been call
26ca0 65 64 2c 20 74 68 65 20 74 72 61 6e 73 61 63 74 ed, the transact
26cb0 69 6f 6e 20 6d 75 73 74 20 65 69 74 68 65 72 20 ion must either
26cc0 62 65 0a 2a 2a 20 72 6f 6c 6c 65 64 20 62 61 63 be.** rolled bac
26cd0 6b 20 6f 72 20 63 6f 6d 6d 69 74 74 65 64 2e 20 k or committed.
26ce0 49 74 20 69 73 20 6e 6f 74 20 73 61 66 65 20 74 It is not safe t
26cf0 6f 20 63 61 6c 6c 20 74 68 69 73 20 66 75 6e 63 o call this func
26d00 74 69 6f 6e 20 61 6e 64 0a 2a 2a 20 74 68 65 6e tion and.** then
26d10 20 63 6f 6e 74 69 6e 75 65 20 77 72 69 74 69 6e continue writin
26d20 67 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 g to the databas
26d30 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 e..*/.void sqlit
26d40 65 33 50 61 67 65 72 54 72 75 6e 63 61 74 65 49 e3PagerTruncateI
26d50 6d 61 67 65 28 50 61 67 65 72 20 2a 70 50 61 67 mage(Pager *pPag
26d60 65 72 2c 20 50 67 6e 6f 20 6e 50 61 67 65 29 7b er, Pgno nPage){
26d70 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
26d80 72 2d 3e 64 62 53 69 7a 65 3e 3d 6e 50 61 67 65 r->dbSize>=nPage
26d90 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 );. assert( pP
26da0 61 67 65 72 2d 3e 65 53 74 61 74 65 3e 3d 50 41 ager->eState>=PA
26db0 47 45 52 5f 57 52 49 54 45 52 5f 43 41 43 48 45 GER_WRITER_CACHE
26dc0 4d 4f 44 20 29 3b 0a 20 20 70 50 61 67 65 72 2d MOD );. pPager-
26dd0 3e 64 62 53 69 7a 65 20 3d 20 6e 50 61 67 65 3b >dbSize = nPage;
26de0 0a 0a 20 20 2f 2a 20 41 74 20 6f 6e 65 20 70 6f .. /* At one po
26df0 69 6e 74 20 74 68 65 20 63 6f 64 65 20 68 65 72 int the code her
26e00 65 20 63 61 6c 6c 65 64 20 61 73 73 65 72 74 54 e called assertT
26e10 72 75 6e 63 61 74 65 43 6f 6e 73 74 72 61 69 6e runcateConstrain
26e20 74 28 29 20 74 6f 0a 20 20 2a 2a 20 65 6e 73 75 t() to. ** ensu
26e30 72 65 20 74 68 61 74 20 61 6c 6c 20 70 61 67 65 re that all page
26e40 73 20 62 65 69 6e 67 20 74 72 75 6e 63 61 74 65 s being truncate
26e50 64 20 61 77 61 79 20 62 79 20 74 68 69 73 20 6f d away by this o
26e60 70 65 72 61 74 69 6f 6e 20 61 72 65 2c 0a 20 20 peration are,.
26e70 2a 2a 20 69 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 ** if one or mor
26e80 65 20 73 61 76 65 70 6f 69 6e 74 73 20 61 72 65 e savepoints are
26e90 20 6f 70 65 6e 2c 20 70 72 65 73 65 6e 74 20 69 open, present i
26ea0 6e 20 74 68 65 20 73 61 76 65 70 6f 69 6e 74 20 n the savepoint
26eb0 0a 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 20 73 6f . ** journal so
26ec0 20 74 68 61 74 20 74 68 65 79 20 63 61 6e 20 62 that they can b
26ed0 65 20 72 65 73 74 6f 72 65 64 20 69 66 20 74 68 e restored if th
26ee0 65 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 72 e savepoint is r
26ef0 6f 6c 6c 65 64 0a 20 20 2a 2a 20 62 61 63 6b 2e olled. ** back.
26f00 20 54 68 69 73 20 69 73 20 6e 6f 20 6c 6f 6e 67 This is no long
26f10 65 72 20 6e 65 63 65 73 73 61 72 79 20 61 73 20 er necessary as
26f20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 this function is
26f30 20 6e 6f 77 20 6f 6e 6c 79 0a 20 20 2a 2a 20 63 now only. ** c
26f40 61 6c 6c 65 64 20 72 69 67 68 74 20 62 65 66 6f alled right befo
26f50 72 65 20 63 6f 6d 6d 69 74 74 69 6e 67 20 61 20 re committing a
26f60 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 53 6f 20 transaction. So
26f70 61 6c 74 68 6f 75 67 68 20 74 68 65 20 0a 20 20 although the .
26f80 2a 2a 20 50 61 67 65 72 20 6f 62 6a 65 63 74 20 ** Pager object
26f90 6d 61 79 20 73 74 69 6c 6c 20 68 61 76 65 20 6f may still have o
26fa0 70 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 28 pen savepoints (
26fb0 50 61 67 65 72 2e 6e 53 61 76 65 70 6f 69 6e 74 Pager.nSavepoint
26fc0 21 3d 30 29 2c 20 0a 20 20 2a 2a 20 74 68 65 79 !=0), . ** they
26fd0 20 63 61 6e 6e 6f 74 20 62 65 20 72 6f 6c 6c 65 cannot be rolle
26fe0 64 20 62 61 63 6b 2e 20 53 6f 20 74 68 65 20 61 d back. So the a
26ff0 73 73 65 72 74 54 72 75 6e 63 61 74 65 43 6f 6e ssertTruncateCon
27000 73 74 72 61 69 6e 74 28 29 20 63 61 6c 6c 0a 20 straint() call.
27010 20 2a 2a 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 ** is no longer
27020 20 63 6f 72 72 65 63 74 2e 20 2a 2f 0a 7d 0a 0a correct. */.}..
27030 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
27040 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 tion is called b
27050 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 efore attempting
27060 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 72 a hot-journal r
27070 6f 6c 6c 62 61 63 6b 2e 20 49 74 0a 2a 2a 20 73 ollback. It.** s
27080 79 6e 63 73 20 74 68 65 20 6a 6f 75 72 6e 61 6c yncs the journal
27090 20 66 69 6c 65 20 74 6f 20 64 69 73 6b 2c 20 74 file to disk, t
270a0 68 65 6e 20 73 65 74 73 20 70 50 61 67 65 72 2d hen sets pPager-
270b0 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 74 6f 20 74 >journalHdr to t
270c0 68 65 0a 2a 2a 20 73 69 7a 65 20 6f 66 20 74 68 he.** size of th
270d0 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 73 e journal file s
270e0 6f 20 74 68 61 74 20 74 68 65 20 70 61 67 65 72 o that the pager
270f0 5f 70 6c 61 79 62 61 63 6b 28 29 20 72 6f 75 74 _playback() rout
27100 69 6e 65 20 6b 6e 6f 77 73 0a 2a 2a 20 74 68 61 ine knows.** tha
27110 74 20 74 68 65 20 65 6e 74 69 72 65 20 6a 6f 75 t the entire jou
27120 72 6e 61 6c 20 66 69 6c 65 20 68 61 73 20 62 65 rnal file has be
27130 65 6e 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a en synced..**.**
27140 20 53 79 6e 63 69 6e 67 20 61 20 68 6f 74 2d 6a Syncing a hot-j
27150 6f 75 72 6e 61 6c 20 74 6f 20 64 69 73 6b 20 62 ournal to disk b
27160 65 66 6f 72 65 20 61 74 74 65 6d 70 74 69 6e 67 efore attempting
27170 20 74 6f 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b to roll it back
27180 20 65 6e 73 75 72 65 73 20 0a 2a 2a 20 74 68 61 ensures .** tha
27190 74 20 69 66 20 61 20 70 6f 77 65 72 2d 66 61 69 t if a power-fai
271a0 6c 75 72 65 20 6f 63 63 75 72 73 20 64 75 72 69 lure occurs duri
271b0 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 2c ng the rollback,
271c0 20 74 68 65 20 70 72 6f 63 65 73 73 20 74 68 61 the process tha
271d0 74 0a 2a 2a 20 61 74 74 65 6d 70 74 73 20 72 6f t.** attempts ro
271e0 6c 6c 62 61 63 6b 20 66 6f 6c 6c 6f 77 69 6e 67 llback following
271f0 20 73 79 73 74 65 6d 20 72 65 63 6f 76 65 72 79 system recovery
27200 20 73 65 65 73 20 74 68 65 20 73 61 6d 65 20 6a sees the same j
27210 6f 75 72 6e 61 6c 0a 2a 2a 20 63 6f 6e 74 65 6e ournal.** conten
27220 74 20 61 73 20 74 68 69 73 20 70 72 6f 63 65 73 t as this proces
27230 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 65 76 65 72 s..**.** If ever
27240 79 74 68 69 6e 67 20 67 6f 65 73 20 61 73 20 70 ything goes as p
27250 6c 61 6e 6e 65 64 2c 20 53 51 4c 49 54 45 5f 4f lanned, SQLITE_O
27260 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 4f K is returned. O
27270 74 68 65 72 77 69 73 65 2c 20 0a 2a 2a 20 61 6e therwise, .** an
27280 20 53 51 4c 69 74 65 20 65 72 72 6f 72 20 63 6f SQLite error co
27290 64 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e de..*/.static in
272a0 74 20 70 61 67 65 72 53 79 6e 63 48 6f 74 4a 6f t pagerSyncHotJo
272b0 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 61 urnal(Pager *pPa
272c0 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d ger){. int rc =
272d0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 SQLITE_OK;. if
272e0 28 20 21 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e ( !pPager->noSyn
272f0 63 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 c ){. rc = sq
27300 6c 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 67 lite3OsSync(pPag
27310 65 72 2d 3e 6a 66 64 2c 20 53 51 4c 49 54 45 5f er->jfd, SQLITE_
27320 53 59 4e 43 5f 4e 4f 52 4d 41 4c 29 3b 0a 20 20 SYNC_NORMAL);.
27330 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 }. if( rc==SQLI
27340 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 TE_OK ){. rc
27350 3d 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 53 = sqlite3OsFileS
27360 69 7a 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ize(pPager->jfd,
27370 20 26 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 &pPager->journa
27380 6c 48 64 72 29 3b 0a 20 20 7d 0a 20 20 72 65 74 lHdr);. }. ret
27390 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 69 66 20 53 urn rc;.}..#if S
273a0 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
273b0 49 5a 45 3e 30 0a 2f 2a 0a 2a 2a 20 4f 62 74 61 IZE>0./*.** Obta
273c0 69 6e 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 in a reference t
273d0 6f 20 61 20 6d 65 6d 6f 72 79 20 6d 61 70 70 65 o a memory mappe
273e0 64 20 70 61 67 65 20 6f 62 6a 65 63 74 20 66 6f d page object fo
273f0 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 70 67 r page number pg
27400 6e 6f 2e 20 0a 2a 2a 20 54 68 65 20 6e 65 77 20 no. .** The new
27410 6f 62 6a 65 63 74 20 77 69 6c 6c 20 75 73 65 20 object will use
27420 74 68 65 20 70 6f 69 6e 74 65 72 20 70 44 61 74 the pointer pDat
27430 61 2c 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d a, obtained from
27440 20 78 46 65 74 63 68 28 29 2e 0a 2a 2a 20 49 66 xFetch()..** If
27450 20 73 75 63 63 65 73 73 66 75 6c 2c 20 73 65 74 successful, set
27460 20 2a 70 70 50 61 67 65 20 74 6f 20 70 6f 69 6e *ppPage to poin
27470 74 20 74 6f 20 74 68 65 20 6e 65 77 20 70 61 67 t to the new pag
27480 65 20 72 65 66 65 72 65 6e 63 65 0a 2a 2a 20 61 e reference.** a
27490 6e 64 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 nd return SQLITE
274a0 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 _OK. Otherwise,
274b0 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65 return an SQLite
274c0 20 65 72 72 6f 72 20 63 6f 64 65 20 61 6e 64 20 error code and
274d0 73 65 74 0a 2a 2a 20 2a 70 70 50 61 67 65 20 74 set.** *ppPage t
274e0 6f 20 7a 65 72 6f 2e 0a 2a 2a 0a 2a 2a 20 50 61 o zero..**.** Pa
274f0 67 65 20 72 65 66 65 72 65 6e 63 65 73 20 6f 62 ge references ob
27500 74 61 69 6e 65 64 20 62 79 20 63 61 6c 6c 69 6e tained by callin
27510 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 g this function
27520 73 68 6f 75 6c 64 20 62 65 20 72 65 6c 65 61 73 should be releas
27530 65 64 0a 2a 2a 20 62 79 20 63 61 6c 6c 69 6e 67 ed.** by calling
27540 20 70 61 67 65 72 52 65 6c 65 61 73 65 4d 61 70 pagerReleaseMap
27550 50 61 67 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 Page()..*/.stati
27560 63 20 69 6e 74 20 70 61 67 65 72 41 63 71 75 69 c int pagerAcqui
27570 72 65 4d 61 70 50 61 67 65 28 0a 20 20 50 61 67 reMapPage(. Pag
27580 65 72 20 2a 70 50 61 67 65 72 2c 20 20 20 20 20 er *pPager,
27590 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
275a0 50 61 67 65 72 20 6f 62 6a 65 63 74 20 2a 2f 0a Pager object */.
275b0 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 Pgno pgno,
275c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
275d0 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 65 72 /* Page number
275e0 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 44 61 74 */. void *pDat
275f0 61 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a,
27600 20 20 20 20 20 20 2f 2a 20 78 46 65 74 63 68 28 /* xFetch(
27610 29 27 64 20 64 61 74 61 20 66 6f 72 20 74 68 69 )'d data for thi
27620 73 20 70 61 67 65 20 2a 2f 0a 20 20 50 67 48 64 s page */. PgHd
27630 72 20 2a 2a 70 70 50 61 67 65 20 20 20 20 20 20 r **ppPage
27640 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
27650 55 54 3a 20 41 63 71 75 69 72 65 64 20 70 61 67 UT: Acquired pag
27660 65 20 6f 62 6a 65 63 74 20 2a 2f 0a 29 7b 0a 20 e object */.){.
27670 20 50 67 48 64 72 20 2a 70 3b 20 20 20 20 20 20 PgHdr *p;
27680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27690 20 2f 2a 20 4d 65 6d 6f 72 79 20 6d 61 70 70 65 /* Memory mappe
276a0 64 20 70 61 67 65 20 74 6f 20 72 65 74 75 72 6e d page to return
276b0 20 2a 2f 0a 20 20 0a 20 20 69 66 28 20 70 50 61 */. . if( pPa
276c0 67 65 72 2d 3e 70 4d 6d 61 70 46 72 65 65 6c 69 ger->pMmapFreeli
276d0 73 74 20 29 7b 0a 20 20 20 20 2a 70 70 50 61 67 st ){. *ppPag
276e0 65 20 3d 20 70 20 3d 20 70 50 61 67 65 72 2d 3e e = p = pPager->
276f0 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 3b 0a 20 pMmapFreelist;.
27700 20 20 20 70 50 61 67 65 72 2d 3e 70 4d 6d 61 70 pPager->pMmap
27710 46 72 65 65 6c 69 73 74 20 3d 20 70 2d 3e 70 44 Freelist = p->pD
27720 69 72 74 79 3b 0a 20 20 20 20 70 2d 3e 70 44 69 irty;. p->pDi
27730 72 74 79 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 rty = 0;. ass
27740 65 72 74 28 20 70 50 61 67 65 72 2d 3e 6e 45 78 ert( pPager->nEx
27750 74 72 61 3e 3d 38 20 29 3b 0a 20 20 20 20 6d 65 tra>=8 );. me
27760 6d 73 65 74 28 70 2d 3e 70 45 78 74 72 61 2c 20 mset(p->pExtra,
27770 30 2c 20 38 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 0, 8);. }else{.
27780 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 70 20 *ppPage = p
27790 3d 20 28 50 67 48 64 72 20 2a 29 73 71 6c 69 74 = (PgHdr *)sqlit
277a0 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 69 7a e3MallocZero(siz
277b0 65 6f 66 28 50 67 48 64 72 29 20 2b 20 70 50 61 eof(PgHdr) + pPa
277c0 67 65 72 2d 3e 6e 45 78 74 72 61 29 3b 0a 20 20 ger->nExtra);.
277d0 20 20 69 66 28 20 70 3d 3d 30 20 29 7b 0a 20 20 if( p==0 ){.
277e0 20 20 20 20 73 71 6c 69 74 65 33 4f 73 55 6e 66 sqlite3OsUnf
277f0 65 74 63 68 28 70 50 61 67 65 72 2d 3e 66 64 2c etch(pPager->fd,
27800 20 28 69 36 34 29 28 70 67 6e 6f 2d 31 29 20 2a (i64)(pgno-1) *
27810 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 7a pPager->pageSiz
27820 65 2c 20 70 44 61 74 61 29 3b 0a 20 20 20 20 20 e, pData);.
27830 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
27840 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 7d OMEM_BKPT;. }
27850 0a 20 20 20 20 70 2d 3e 70 45 78 74 72 61 20 3d . p->pExtra =
27860 20 28 76 6f 69 64 20 2a 29 26 70 5b 31 5d 3b 0a (void *)&p[1];.
27870 20 20 20 20 70 2d 3e 66 6c 61 67 73 20 3d 20 50 p->flags = P
27880 47 48 44 52 5f 4d 4d 41 50 3b 0a 20 20 20 20 70 GHDR_MMAP;. p
27890 2d 3e 6e 52 65 66 20 3d 20 31 3b 0a 20 20 20 20 ->nRef = 1;.
278a0 70 2d 3e 70 50 61 67 65 72 20 3d 20 70 50 61 67 p->pPager = pPag
278b0 65 72 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 er;. }.. asser
278c0 74 28 20 70 2d 3e 70 45 78 74 72 61 3d 3d 28 76 t( p->pExtra==(v
278d0 6f 69 64 20 2a 29 26 70 5b 31 5d 20 29 3b 0a 20 oid *)&p[1] );.
278e0 20 61 73 73 65 72 74 28 20 70 2d 3e 70 50 61 67 assert( p->pPag
278f0 65 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 e==0 );. assert
27900 28 20 70 2d 3e 66 6c 61 67 73 3d 3d 50 47 48 44 ( p->flags==PGHD
27910 52 5f 4d 4d 41 50 20 29 3b 0a 20 20 61 73 73 65 R_MMAP );. asse
27920 72 74 28 20 70 2d 3e 70 50 61 67 65 72 3d 3d 70 rt( p->pPager==p
27930 50 61 67 65 72 20 29 3b 0a 20 20 61 73 73 65 72 Pager );. asser
27940 74 28 20 70 2d 3e 6e 52 65 66 3d 3d 31 20 29 3b t( p->nRef==1 );
27950 0a 0a 20 20 70 2d 3e 70 67 6e 6f 20 3d 20 70 67 .. p->pgno = pg
27960 6e 6f 3b 0a 20 20 70 2d 3e 70 44 61 74 61 20 3d no;. p->pData =
27970 20 70 44 61 74 61 3b 0a 20 20 70 50 61 67 65 72 pData;. pPager
27980 2d 3e 6e 4d 6d 61 70 4f 75 74 2b 2b 3b 0a 0a 20 ->nMmapOut++;..
27990 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
279a0 4b 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a K;.}.#endif../*.
279b0 2a 2a 20 52 65 6c 65 61 73 65 20 61 20 72 65 66 ** Release a ref
279c0 65 72 65 6e 63 65 20 74 6f 20 70 61 67 65 20 70 erence to page p
279d0 50 67 2e 20 70 50 67 20 6d 75 73 74 20 68 61 76 Pg. pPg must hav
279e0 65 20 62 65 65 6e 20 72 65 74 75 72 6e 65 64 20 e been returned
279f0 62 79 20 61 6e 20 0a 2a 2a 20 65 61 72 6c 69 65 by an .** earlie
27a00 72 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 41 r call to pagerA
27a10 63 71 75 69 72 65 4d 61 70 50 61 67 65 28 29 2e cquireMapPage().
27a20 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
27a30 70 61 67 65 72 52 65 6c 65 61 73 65 4d 61 70 50 pagerReleaseMapP
27a40 61 67 65 28 50 67 48 64 72 20 2a 70 50 67 29 7b age(PgHdr *pPg){
27a50 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 . Pager *pPager
27a60 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 0a = pPg->pPager;.
27a70 20 20 70 50 61 67 65 72 2d 3e 6e 4d 6d 61 70 4f pPager->nMmapO
27a80 75 74 2d 2d 3b 0a 20 20 70 50 67 2d 3e 70 44 69 ut--;. pPg->pDi
27a90 72 74 79 20 3d 20 70 50 61 67 65 72 2d 3e 70 4d rty = pPager->pM
27aa0 6d 61 70 46 72 65 65 6c 69 73 74 3b 0a 20 20 70 mapFreelist;. p
27ab0 50 61 67 65 72 2d 3e 70 4d 6d 61 70 46 72 65 65 Pager->pMmapFree
27ac0 6c 69 73 74 20 3d 20 70 50 67 3b 0a 0a 20 20 61 list = pPg;.. a
27ad0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 66 ssert( pPager->f
27ae0 64 2d 3e 70 4d 65 74 68 6f 64 73 2d 3e 69 56 65 d->pMethods->iVe
27af0 72 73 69 6f 6e 3e 3d 33 20 29 3b 0a 20 20 73 71 rsion>=3 );. sq
27b00 6c 69 74 65 33 4f 73 55 6e 66 65 74 63 68 28 70 lite3OsUnfetch(p
27b10 50 61 67 65 72 2d 3e 66 64 2c 20 28 69 36 34 29 Pager->fd, (i64)
27b20 28 70 50 67 2d 3e 70 67 6e 6f 2d 31 29 2a 70 50 (pPg->pgno-1)*pP
27b30 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 ager->pageSize,
27b40 70 50 67 2d 3e 70 44 61 74 61 29 3b 0a 7d 0a 0a pPg->pData);.}..
27b50 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 50 /*.** Free all P
27b60 67 48 64 72 20 6f 62 6a 65 63 74 73 20 73 74 6f gHdr objects sto
27b70 72 65 64 20 69 6e 20 74 68 65 20 50 61 67 65 72 red in the Pager
27b80 2e 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 20 6c .pMmapFreelist l
27b90 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 ist..*/.static v
27ba0 6f 69 64 20 70 61 67 65 72 46 72 65 65 4d 61 70 oid pagerFreeMap
27bb0 48 64 72 73 28 50 61 67 65 72 20 2a 70 50 61 67 Hdrs(Pager *pPag
27bc0 65 72 29 7b 0a 20 20 50 67 48 64 72 20 2a 70 3b er){. PgHdr *p;
27bd0 0a 20 20 50 67 48 64 72 20 2a 70 4e 65 78 74 3b . PgHdr *pNext;
27be0 0a 20 20 66 6f 72 28 70 3d 70 50 61 67 65 72 2d . for(p=pPager-
27bf0 3e 70 4d 6d 61 70 46 72 65 65 6c 69 73 74 3b 20 >pMmapFreelist;
27c00 70 3b 20 70 3d 70 4e 65 78 74 29 7b 0a 20 20 20 p; p=pNext){.
27c10 20 70 4e 65 78 74 20 3d 20 70 2d 3e 70 44 69 72 pNext = p->pDir
27c20 74 79 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f ty;. sqlite3_
27c30 66 72 65 65 28 70 29 3b 0a 20 20 7d 0a 7d 0a 0a free(p);. }.}..
27c40 0a 2f 2a 0a 2a 2a 20 53 68 75 74 64 6f 77 6e 20 ./*.** Shutdown
27c50 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 20 the page cache.
27c60 20 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 Free all memory
27c70 20 61 6e 64 20 63 6c 6f 73 65 20 61 6c 6c 20 66 and close all f
27c80 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61 iles..**.** If a
27c90 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 transaction was
27ca0 20 69 6e 20 70 72 6f 67 72 65 73 73 20 77 68 65 in progress whe
27cb0 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 n this routine i
27cc0 73 20 63 61 6c 6c 65 64 2c 20 74 68 61 74 0a 2a s called, that.*
27cd0 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 * transaction is
27ce0 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 rolled back. A
27cf0 6c 6c 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 70 ll outstanding p
27d00 61 67 65 73 20 61 72 65 20 69 6e 76 61 6c 69 64 ages are invalid
27d10 61 74 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 69 ated.** and thei
27d20 72 20 6d 65 6d 6f 72 79 20 69 73 20 66 72 65 65 r memory is free
27d30 64 2e 20 20 41 6e 79 20 61 74 74 65 6d 70 74 20 d. Any attempt
27d40 74 6f 20 75 73 65 20 61 20 70 61 67 65 20 61 73 to use a page as
27d50 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 sociated.** with
27d60 20 74 68 69 73 20 70 61 67 65 20 63 61 63 68 65 this page cache
27d70 20 61 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 after this func
27d80 74 69 6f 6e 20 72 65 74 75 72 6e 73 20 77 69 6c tion returns wil
27d90 6c 20 6c 69 6b 65 6c 79 0a 2a 2a 20 72 65 73 75 l likely.** resu
27da0 6c 74 20 69 6e 20 61 20 63 6f 72 65 64 75 6d 70 lt in a coredump
27db0 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ..**.** This fun
27dc0 63 74 69 6f 6e 20 61 6c 77 61 79 73 20 73 75 63 ction always suc
27dd0 63 65 65 64 73 2e 20 49 66 20 61 20 74 72 61 6e ceeds. If a tran
27de0 73 61 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 saction is activ
27df0 65 20 61 6e 20 61 74 74 65 6d 70 74 0a 2a 2a 20 e an attempt.**
27e00 69 73 20 6d 61 64 65 20 74 6f 20 72 6f 6c 6c 20 is made to roll
27e10 69 74 20 62 61 63 6b 2e 20 49 66 20 61 6e 20 65 it back. If an e
27e20 72 72 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 rror occurs duri
27e30 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20 ng the rollback
27e40 0a 2a 2a 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 .** a hot journa
27e50 6c 20 6d 61 79 20 62 65 20 6c 65 66 74 20 69 6e l may be left in
27e60 20 74 68 65 20 66 69 6c 65 73 79 73 74 65 6d 20 the filesystem
27e70 62 75 74 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 but no error is
27e80 72 65 74 75 72 6e 65 64 0a 2a 2a 20 74 6f 20 74 returned.** to t
27e90 68 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a 69 6e he caller..*/.in
27ea0 74 20 73 71 6c 69 74 65 33 50 61 67 65 72 43 6c t sqlite3PagerCl
27eb0 6f 73 65 28 50 61 67 65 72 20 2a 70 50 61 67 65 ose(Pager *pPage
27ec0 72 2c 20 73 71 6c 69 74 65 33 20 2a 64 62 29 7b r, sqlite3 *db){
27ed0 0a 20 20 75 38 20 2a 70 54 6d 70 20 3d 20 28 75 . u8 *pTmp = (u
27ee0 38 20 2a 29 70 50 61 67 65 72 2d 3e 70 54 6d 70 8 *)pPager->pTmp
27ef0 53 70 61 63 65 3b 0a 0a 20 20 61 73 73 65 72 74 Space;.. assert
27f00 28 20 64 62 20 7c 7c 20 70 61 67 65 72 55 73 65 ( db || pagerUse
27f10 57 61 6c 28 70 50 61 67 65 72 29 3d 3d 30 20 29 Wal(pPager)==0 )
27f20 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 ;. assert( asse
27f30 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 rt_pager_state(p
27f40 50 61 67 65 72 29 20 29 3b 0a 20 20 64 69 73 61 Pager) );. disa
27f50 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f ble_simulated_io
27f60 5f 65 72 72 6f 72 73 28 29 3b 0a 20 20 73 71 6c _errors();. sql
27f70 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d ite3BeginBenignM
27f80 61 6c 6c 6f 63 28 29 3b 0a 20 20 70 61 67 65 72 alloc();. pager
27f90 46 72 65 65 4d 61 70 48 64 72 73 28 70 50 61 67 FreeMapHdrs(pPag
27fa0 65 72 29 3b 0a 20 20 2f 2a 20 70 50 61 67 65 72 er);. /* pPager
27fb0 2d 3e 65 72 72 43 6f 64 65 20 3d 20 30 3b 20 2a ->errCode = 0; *
27fc0 2f 0a 20 20 70 50 61 67 65 72 2d 3e 65 78 63 6c /. pPager->excl
27fd0 75 73 69 76 65 4d 6f 64 65 20 3d 20 30 3b 0a 23 usiveMode = 0;.#
27fe0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
27ff0 49 54 5f 57 41 4c 0a 20 20 61 73 73 65 72 74 28 IT_WAL. assert(
28000 20 64 62 20 7c 7c 20 70 50 61 67 65 72 2d 3e 70 db || pPager->p
28010 57 61 6c 3d 3d 30 20 29 3b 0a 20 20 73 71 6c 69 Wal==0 );. sqli
28020 74 65 33 57 61 6c 43 6c 6f 73 65 28 70 50 61 67 te3WalClose(pPag
28030 65 72 2d 3e 70 57 61 6c 2c 20 64 62 2c 20 70 50 er->pWal, db, pP
28040 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 ager->walSyncFla
28050 67 73 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 gs, pPager->page
28060 53 69 7a 65 2c 0a 20 20 20 20 20 20 28 64 62 20 Size,. (db
28070 26 26 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 && (db->flags &
28080 53 51 4c 49 54 45 5f 4e 6f 43 6b 70 74 4f 6e 43 SQLITE_NoCkptOnC
28090 6c 6f 73 65 29 20 3f 20 30 20 3a 20 70 54 6d 70 lose) ? 0 : pTmp
280a0 29 0a 20 20 29 3b 0a 20 20 70 50 61 67 65 72 2d ). );. pPager-
280b0 3e 70 57 61 6c 20 3d 20 30 3b 0a 23 65 6e 64 69 >pWal = 0;.#endi
280c0 66 0a 20 20 70 61 67 65 72 5f 72 65 73 65 74 28 f. pager_reset(
280d0 70 50 61 67 65 72 29 3b 0a 20 20 69 66 28 20 4d pPager);. if( M
280e0 45 4d 44 42 20 29 7b 0a 20 20 20 20 70 61 67 65 EMDB ){. page
280f0 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 r_unlock(pPager)
28100 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f ;. }else{. /
28110 2a 20 49 66 20 69 74 20 69 73 20 6f 70 65 6e 2c * If it is open,
28120 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 sync the journa
28130 6c 20 66 69 6c 65 20 62 65 66 6f 72 65 20 63 61 l file before ca
28140 6c 6c 69 6e 67 20 55 6e 6c 6f 63 6b 41 6e 64 52 lling UnlockAndR
28150 6f 6c 6c 62 61 63 6b 2e 0a 20 20 20 20 2a 2a 20 ollback.. **
28160 49 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 64 If this is not d
28170 6f 6e 65 2c 20 74 68 65 6e 20 61 6e 20 75 6e 73 one, then an uns
28180 79 6e 63 65 64 20 70 6f 72 74 69 6f 6e 20 6f 66 ynced portion of
28190 20 74 68 65 20 6f 70 65 6e 20 6a 6f 75 72 6e 61 the open journa
281a0 6c 20 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 6d l . ** file m
281b0 61 79 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 ay be played bac
281c0 6b 20 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 k into the datab
281d0 61 73 65 2e 20 49 66 20 61 20 70 6f 77 65 72 20 ase. If a power
281e0 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 20 0a failure occurs .
281f0 20 20 20 20 2a 2a 20 77 68 69 6c 65 20 74 68 69 ** while thi
28200 73 20 69 73 20 68 61 70 70 65 6e 69 6e 67 2c 20 s is happening,
28210 74 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 75 the database cou
28220 6c 64 20 62 65 63 6f 6d 65 20 63 6f 72 72 75 70 ld become corrup
28230 74 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a t.. **. **
28240 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
28250 75 72 73 20 77 68 69 6c 65 20 74 72 79 69 6e 67 urs while trying
28260 20 74 6f 20 73 79 6e 63 20 74 68 65 20 6a 6f 75 to sync the jou
28270 72 6e 61 6c 2c 20 73 68 69 66 74 20 74 68 65 20 rnal, shift the
28280 70 61 67 65 72 0a 20 20 20 20 2a 2a 20 69 6e 74 pager. ** int
28290 6f 20 74 68 65 20 45 52 52 4f 52 20 73 74 61 74 o the ERROR stat
282a0 65 2e 20 54 68 69 73 20 63 61 75 73 65 73 20 55 e. This causes U
282b0 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b nlockAndRollback
282c0 20 74 6f 20 75 6e 6c 6f 63 6b 20 74 68 65 0a 20 to unlock the.
282d0 20 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 61 ** database a
282e0 6e 64 20 63 6c 6f 73 65 20 74 68 65 20 6a 6f 75 nd close the jou
282f0 72 6e 61 6c 20 66 69 6c 65 20 77 69 74 68 6f 75 rnal file withou
28300 74 20 61 74 74 65 6d 70 74 69 6e 67 20 74 6f 20 t attempting to
28310 72 6f 6c 6c 20 69 74 0a 20 20 20 20 2a 2a 20 62 roll it. ** b
28320 61 63 6b 20 6f 72 20 66 69 6e 61 6c 69 7a 65 20 ack or finalize
28330 69 74 2e 20 54 68 65 20 6e 65 78 74 20 64 61 74 it. The next dat
28340 61 62 61 73 65 20 75 73 65 72 20 77 69 6c 6c 20 abase user will
28350 68 61 76 65 20 74 6f 20 64 6f 20 68 6f 74 2d 6a have to do hot-j
28360 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 72 6f ournal. ** ro
28370 6c 6c 62 61 63 6b 20 62 65 66 6f 72 65 20 61 63 llback before ac
28380 63 65 73 73 69 6e 67 20 74 68 65 20 64 61 74 61 cessing the data
28390 62 61 73 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a base file.. *
283a0 2f 0a 20 20 20 20 69 66 28 20 69 73 4f 70 65 6e /. if( isOpen
283b0 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 7b (pPager->jfd) ){
283c0 0a 20 20 20 20 20 20 70 61 67 65 72 5f 65 72 72 . pager_err
283d0 6f 72 28 70 50 61 67 65 72 2c 20 70 61 67 65 72 or(pPager, pager
283e0 53 79 6e 63 48 6f 74 4a 6f 75 72 6e 61 6c 28 70 SyncHotJournal(p
283f0 50 61 67 65 72 29 29 3b 0a 20 20 20 20 7d 0a 20 Pager));. }.
28400 20 20 20 70 61 67 65 72 55 6e 6c 6f 63 6b 41 6e pagerUnlockAn
28410 64 52 6f 6c 6c 62 61 63 6b 28 70 50 61 67 65 72 dRollback(pPager
28420 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
28430 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 EndBenignMalloc(
28440 29 3b 0a 20 20 65 6e 61 62 6c 65 5f 73 69 6d 75 );. enable_simu
28450 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 lated_io_errors(
28460 29 3b 0a 20 20 50 41 47 45 52 54 52 41 43 45 28 );. PAGERTRACE(
28470 28 22 43 4c 4f 53 45 20 25 64 5c 6e 22 2c 20 50 ("CLOSE %d\n", P
28480 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 29 AGERID(pPager)))
28490 3b 0a 20 20 49 4f 54 52 41 43 45 28 28 22 43 4c ;. IOTRACE(("CL
284a0 4f 53 45 20 25 70 5c 6e 22 2c 20 70 50 61 67 65 OSE %p\n", pPage
284b0 72 29 29 0a 20 20 73 71 6c 69 74 65 33 4f 73 43 r)). sqlite3OsC
284c0 6c 6f 73 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 lose(pPager->jfd
284d0 29 3b 0a 20 20 73 71 6c 69 74 65 33 4f 73 43 6c );. sqlite3OsCl
284e0 6f 73 65 28 70 50 61 67 65 72 2d 3e 66 64 29 3b ose(pPager->fd);
284f0 0a 20 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 . sqlite3PageFr
28500 65 65 28 70 54 6d 70 29 3b 0a 20 20 73 71 6c 69 ee(pTmp);. sqli
28510 74 65 33 50 63 61 63 68 65 43 6c 6f 73 65 28 70 te3PcacheClose(p
28520 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 29 3b Pager->pPCache);
28530 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
28540 48 41 53 5f 43 4f 44 45 43 0a 20 20 69 66 28 20 HAS_CODEC. if(
28550 70 50 61 67 65 72 2d 3e 78 43 6f 64 65 63 46 72 pPager->xCodecFr
28560 65 65 20 29 20 70 50 61 67 65 72 2d 3e 78 43 6f ee ) pPager->xCo
28570 64 65 63 46 72 65 65 28 70 50 61 67 65 72 2d 3e decFree(pPager->
28580 70 43 6f 64 65 63 29 3b 0a 23 65 6e 64 69 66 0a pCodec);.#endif.
28590 0a 20 20 61 73 73 65 72 74 28 20 21 70 50 61 67 . assert( !pPag
285a0 65 72 2d 3e 61 53 61 76 65 70 6f 69 6e 74 20 26 er->aSavepoint &
285b0 26 20 21 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f & !pPager->pInJo
285c0 75 72 6e 61 6c 20 29 3b 0a 20 20 61 73 73 65 72 urnal );. asser
285d0 74 28 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 t( !isOpen(pPage
285e0 72 2d 3e 6a 66 64 29 20 26 26 20 21 69 73 4f 70 r->jfd) && !isOp
285f0 65 6e 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 29 en(pPager->sjfd)
28600 20 29 3b 0a 0a 20 20 73 71 6c 69 74 65 33 5f 66 );.. sqlite3_f
28610 72 65 65 28 70 50 61 67 65 72 29 3b 0a 20 20 72 ree(pPager);. r
28620 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
28630 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .}..#if !defined
28640 28 4e 44 45 42 55 47 29 20 7c 7c 20 64 65 66 69 (NDEBUG) || defi
28650 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 ned(SQLITE_TEST)
28660 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 ./*.** Return th
28670 65 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f e page number fo
28680 72 20 70 61 67 65 20 70 50 67 2e 0a 2a 2f 0a 50 r page pPg..*/.P
28690 67 6e 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 gno sqlite3Pager
286a0 50 61 67 65 6e 75 6d 62 65 72 28 44 62 50 61 67 Pagenumber(DbPag
286b0 65 20 2a 70 50 67 29 7b 0a 20 20 72 65 74 75 72 e *pPg){. retur
286c0 6e 20 70 50 67 2d 3e 70 67 6e 6f 3b 0a 7d 0a 23 n pPg->pgno;.}.#
286d0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 endif../*.** Inc
286e0 72 65 6d 65 6e 74 20 74 68 65 20 72 65 66 65 72 rement the refer
286f0 65 6e 63 65 20 63 6f 75 6e 74 20 66 6f 72 20 70 ence count for p
28700 61 67 65 20 70 50 67 2e 0a 2a 2f 0a 76 6f 69 64 age pPg..*/.void
28710 20 73 71 6c 69 74 65 33 50 61 67 65 72 52 65 66 sqlite3PagerRef
28720 28 44 62 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 (DbPage *pPg){.
28730 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 65 sqlite3PcacheRe
28740 66 28 70 50 67 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a f(pPg);.}../*.**
28750 20 53 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 Sync the journa
28760 6c 2e 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 l. In other word
28770 73 2c 20 6d 61 6b 65 20 73 75 72 65 20 61 6c 6c s, make sure all
28780 20 74 68 65 20 70 61 67 65 73 20 74 68 61 74 20 the pages that
28790 68 61 76 65 0a 2a 2a 20 62 65 65 6e 20 77 72 69 have.** been wri
287a0 74 74 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75 72 tten to the jour
287b0 6e 61 6c 20 68 61 76 65 20 61 63 74 75 61 6c 6c nal have actuall
287c0 79 20 72 65 61 63 68 65 64 20 74 68 65 20 73 75 y reached the su
287d0 72 66 61 63 65 20 6f 66 20 74 68 65 0a 2a 2a 20 rface of the.**
287e0 64 69 73 6b 20 61 6e 64 20 63 61 6e 20 62 65 20 disk and can be
287f0 72 65 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 restored in the
28800 65 76 65 6e 74 20 6f 66 20 61 20 68 6f 74 2d 6a event of a hot-j
28810 6f 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 2e ournal rollback.
28820 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 50 61 .**.** If the Pa
28830 67 65 72 2e 6e 6f 53 79 6e 63 20 66 6c 61 67 20 ger.noSync flag
28840 69 73 20 73 65 74 2c 20 74 68 65 6e 20 74 68 69 is set, then thi
28850 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 s function is a
28860 6e 6f 2d 6f 70 2e 0a 2a 2a 20 4f 74 68 65 72 77 no-op..** Otherw
28870 69 73 65 2c 20 74 68 65 20 61 63 74 69 6f 6e 73 ise, the actions
28880 20 72 65 71 75 69 72 65 64 20 64 65 70 65 6e 64 required depend
28890 20 6f 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 2d on the journal-
288a0 6d 6f 64 65 20 61 6e 64 20 74 68 65 20 0a 2a 2a mode and the .**
288b0 20 64 65 76 69 63 65 20 63 68 61 72 61 63 74 65 device characte
288c0 72 69 73 74 69 63 73 20 6f 66 20 74 68 65 20 66 ristics of the f
288d0 69 6c 65 2d 73 79 73 74 65 6d 2c 20 61 73 20 66 ile-system, as f
288e0 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 ollows:.**.**
288f0 2a 20 49 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c * If the journal
28900 20 66 69 6c 65 20 69 73 20 61 6e 20 69 6e 2d 6d file is an in-m
28910 65 6d 6f 72 79 20 6a 6f 75 72 6e 61 6c 20 66 69 emory journal fi
28920 6c 65 2c 20 6e 6f 20 61 63 74 69 6f 6e 20 6e 65 le, no action ne
28930 65 64 0a 2a 2a 20 20 20 20 20 62 65 20 74 61 6b ed.** be tak
28940 65 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 4f 74 en..**.** * Ot
28950 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 65 20 herwise, if the
28960 64 65 76 69 63 65 20 64 6f 65 73 20 6e 6f 74 20 device does not
28970 73 75 70 70 6f 72 74 20 74 68 65 20 53 41 46 45 support the SAFE
28980 5f 41 50 50 45 4e 44 20 70 72 6f 70 65 72 74 79 _APPEND property
28990 2c 0a 2a 2a 20 20 20 20 20 74 68 65 6e 20 74 68 ,.** then th
289a0 65 20 6e 52 65 63 20 66 69 65 6c 64 20 6f 66 20 e nRec field of
289b0 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c the most recentl
289c0 79 20 77 72 69 74 74 65 6e 20 6a 6f 75 72 6e 61 y written journa
289d0 6c 20 68 65 61 64 65 72 0a 2a 2a 20 20 20 20 20 l header.**
289e0 69 73 20 75 70 64 61 74 65 64 20 74 6f 20 63 6f is updated to co
289f0 6e 74 61 69 6e 20 74 68 65 20 6e 75 6d 62 65 72 ntain the number
28a00 20 6f 66 20 6a 6f 75 72 6e 61 6c 20 72 65 63 6f of journal reco
28a10 72 64 73 20 74 68 61 74 20 68 61 76 65 0a 2a 2a rds that have.**
28a20 20 20 20 20 20 62 65 65 6e 20 77 72 69 74 74 65 been writte
28a30 6e 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 74 2e 20 n following it.
28a40 49 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 If the pager is
28a50 6f 70 65 72 61 74 69 6e 67 20 69 6e 20 66 75 6c operating in ful
28a60 6c 2d 73 79 6e 63 0a 2a 2a 20 20 20 20 20 6d 6f l-sync.** mo
28a70 64 65 2c 20 74 68 65 6e 20 74 68 65 20 6a 6f 75 de, then the jou
28a80 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 73 79 6e rnal file is syn
28a90 63 65 64 20 62 65 66 6f 72 65 20 74 68 69 73 20 ced before this
28aa0 66 69 65 6c 64 20 69 73 20 75 70 64 61 74 65 64 field is updated
28ab0 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 49 66 20 74 ..**.** * If t
28ac0 68 65 20 64 65 76 69 63 65 20 64 6f 65 73 20 6e he device does n
28ad0 6f 74 20 73 75 70 70 6f 72 74 20 74 68 65 20 53 ot support the S
28ae0 45 51 55 45 4e 54 49 41 4c 20 70 72 6f 70 65 72 EQUENTIAL proper
28af0 74 79 2c 20 74 68 65 6e 20 0a 2a 2a 20 20 20 20 ty, then .**
28b00 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
28b10 20 73 79 6e 63 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f synced..**.** O
28b20 72 2c 20 69 6e 20 70 73 65 75 64 6f 2d 63 6f 64 r, in pseudo-cod
28b30 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 69 66 28 20 4e e:.**.** if( N
28b40 4f 54 20 3c 69 6e 2d 6d 65 6d 6f 72 79 20 6a 6f OT <in-memory jo
28b50 75 72 6e 61 6c 3e 20 29 7b 0a 2a 2a 20 20 20 20 urnal> ){.**
28b60 20 69 66 28 20 4e 4f 54 20 53 41 46 45 5f 41 50 if( NOT SAFE_AP
28b70 50 45 4e 44 20 29 7b 0a 2a 2a 20 20 20 20 20 20 PEND ){.**
28b80 20 69 66 28 20 3c 66 75 6c 6c 2d 73 79 6e 63 20 if( <full-sync
28b90 6d 6f 64 65 3e 20 29 20 78 53 79 6e 63 28 3c 6a mode> ) xSync(<j
28ba0 6f 75 72 6e 61 6c 20 66 69 6c 65 3e 29 3b 0a 2a ournal file>);.*
28bb0 2a 20 20 20 20 20 20 20 3c 75 70 64 61 74 65 20 * <update
28bc0 6e 52 65 63 20 66 69 65 6c 64 3e 0a 2a 2a 20 20 nRec field>.**
28bd0 20 20 20 7d 20 0a 2a 2a 20 20 20 20 20 69 66 28 } .** if(
28be0 20 4e 4f 54 20 53 45 51 55 45 4e 54 49 41 4c 20 NOT SEQUENTIAL
28bf0 29 20 78 53 79 6e 63 28 3c 6a 6f 75 72 6e 61 6c ) xSync(<journal
28c00 20 66 69 6c 65 3e 29 3b 0a 2a 2a 20 20 20 7d 0a file>);.** }.
28c10 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73 73 **.** If success
28c20 66 75 6c 2c 20 74 68 69 73 20 72 6f 75 74 69 6e ful, this routin
28c30 65 20 63 6c 65 61 72 73 20 74 68 65 20 50 47 48 e clears the PGH
28c40 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c 61 DR_NEED_SYNC fla
28c50 67 20 6f 66 20 65 76 65 72 79 20 0a 2a 2a 20 70 g of every .** p
28c60 61 67 65 20 63 75 72 72 65 6e 74 6c 79 20 68 65 age currently he
28c70 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 62 65 66 ld in memory bef
28c80 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 53 51 ore returning SQ
28c90 4c 49 54 45 5f 4f 4b 2e 20 49 66 20 61 6e 20 49 LITE_OK. If an I
28ca0 4f 0a 2a 2a 20 65 72 72 6f 72 20 69 73 20 65 6e O.** error is en
28cb0 63 6f 75 6e 74 65 72 65 64 2c 20 74 68 65 6e 20 countered, then
28cc0 74 68 65 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 the IO error cod
28cd0 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f e is returned to
28ce0 20 74 68 65 20 63 61 6c 6c 65 72 2e 0a 2a 2f 0a the caller..*/.
28cf0 73 74 61 74 69 63 20 69 6e 74 20 73 79 6e 63 4a static int syncJ
28d00 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 ournal(Pager *pP
28d10 61 67 65 72 2c 20 69 6e 74 20 6e 65 77 48 64 72 ager, int newHdr
28d20 29 7b 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 ){. int rc;
28d30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28d40 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
28d50 6f 64 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 ode */.. assert
28d60 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 ( pPager->eState
28d70 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 ==PAGER_WRITER_C
28d80 41 43 48 45 4d 4f 44 0a 20 20 20 20 20 20 20 7c ACHEMOD. |
28d90 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
28da0 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 44 ==PAGER_WRITER_D
28db0 42 4d 4f 44 0a 20 20 29 3b 0a 20 20 61 73 73 65 BMOD. );. asse
28dc0 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 72 rt( assert_pager
28dd0 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 29 _state(pPager) )
28de0 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 61 67 ;. assert( !pag
28df0 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
28e00 20 29 3b 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 );.. rc = sqli
28e10 74 65 33 50 61 67 65 72 45 78 63 6c 75 73 69 76 te3PagerExclusiv
28e20 65 4c 6f 63 6b 28 70 50 61 67 65 72 29 3b 0a 20 eLock(pPager);.
28e30 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
28e40 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a OK ) return rc;.
28e50 0a 20 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e . if( !pPager->
28e60 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 20 20 61 73 noSync ){. as
28e70 73 65 72 74 28 20 21 70 50 61 67 65 72 2d 3e 74 sert( !pPager->t
28e80 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 20 69 empFile );. i
28e90 66 28 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 f( isOpen(pPager
28ea0 2d 3e 6a 66 64 29 20 26 26 20 70 50 61 67 65 72 ->jfd) && pPager
28eb0 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 65 21 3d 50 ->journalMode!=P
28ec0 41 47 45 52 5f 4a 4f 55 52 4e 41 4c 4d 4f 44 45 AGER_JOURNALMODE
28ed0 5f 4d 45 4d 4f 52 59 20 29 7b 0a 20 20 20 20 20 _MEMORY ){.
28ee0 20 63 6f 6e 73 74 20 69 6e 74 20 69 44 63 20 3d const int iDc =
28ef0 20 73 71 6c 69 74 65 33 4f 73 44 65 76 69 63 65 sqlite3OsDevice
28f00 43 68 61 72 61 63 74 65 72 69 73 74 69 63 73 28 Characteristics(
28f10 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 pPager->fd);.
28f20 20 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 assert( isOpe
28f30 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 n(pPager->jfd) )
28f40 3b 0a 0a 20 20 20 20 20 20 69 66 28 20 30 3d 3d ;.. if( 0==
28f50 28 69 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 (iDc&SQLITE_IOCA
28f60 50 5f 53 41 46 45 5f 41 50 50 45 4e 44 29 20 29 P_SAFE_APPEND) )
28f70 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 68 69 {. /* Thi
28f80 73 20 62 6c 6f 63 6b 20 64 65 61 6c 73 20 77 69 s block deals wi
28f90 74 68 20 61 6e 20 6f 62 73 63 75 72 65 20 70 72 th an obscure pr
28fa0 6f 62 6c 65 6d 2e 20 49 66 20 74 68 65 20 6c 61 oblem. If the la
28fb0 73 74 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 20 20 st connection.
28fc0 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20 77 72 ** that wr
28fd0 6f 74 65 20 74 6f 20 74 68 69 73 20 64 61 74 61 ote to this data
28fe0 62 61 73 65 20 77 61 73 20 6f 70 65 72 61 74 69 base was operati
28ff0 6e 67 20 69 6e 20 70 65 72 73 69 73 74 65 6e 74 ng in persistent
29000 2d 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 20 -journal.
29010 20 2a 2a 20 6d 6f 64 65 2c 20 74 68 65 6e 20 74 ** mode, then t
29020 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
29030 6d 61 79 20 61 74 20 74 68 69 73 20 70 6f 69 6e may at this poin
29040 74 20 61 63 74 75 61 6c 6c 79 20 62 65 20 6c 61 t actually be la
29050 72 67 65 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 rger. **
29060 74 68 61 6e 20 50 61 67 65 72 2e 6a 6f 75 72 6e than Pager.journ
29070 61 6c 4f 66 66 20 62 79 74 65 73 2e 20 49 66 20 alOff bytes. If
29080 74 68 65 20 6e 65 78 74 20 74 68 69 6e 67 20 69 the next thing i
29090 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20 20 n the journal.
290a0 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 20 68 61 ** file ha
290b0 70 70 65 6e 73 20 74 6f 20 62 65 20 61 20 6a 6f ppens to be a jo
290c0 75 72 6e 61 6c 2d 68 65 61 64 65 72 20 28 77 72 urnal-header (wr
290d0 69 74 74 65 6e 20 61 73 20 70 61 72 74 20 6f 66 itten as part of
290e0 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 the. **
290f0 70 72 65 76 69 6f 75 73 20 63 6f 6e 6e 65 63 74 previous connect
29100 69 6f 6e 27 73 20 74 72 61 6e 73 61 63 74 69 6f ion's transactio
29110 6e 29 2c 20 61 6e 64 20 61 20 63 72 61 73 68 20 n), and a crash
29120 6f 72 20 70 6f 77 65 72 2d 66 61 69 6c 75 72 65 or power-failure
29130 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 63 63 . ** occ
29140 75 72 73 20 61 66 74 65 72 20 6e 52 65 63 20 69 urs after nRec i
29150 73 20 75 70 64 61 74 65 64 20 62 75 74 20 62 65 s updated but be
29160 66 6f 72 65 20 74 68 69 73 20 63 6f 6e 6e 65 63 fore this connec
29170 74 69 6f 6e 20 77 72 69 74 65 73 20 0a 20 20 20 tion writes .
29180 20 20 20 20 20 2a 2a 20 61 6e 79 74 68 69 6e 67 ** anything
29190 20 65 6c 73 65 20 74 6f 20 74 68 65 20 6a 6f 75 else to the jou
291a0 72 6e 61 6c 20 66 69 6c 65 20 28 6f 72 20 63 6f rnal file (or co
291b0 6d 6d 69 74 73 2f 72 6f 6c 6c 73 20 62 61 63 6b mmits/rolls back
291c0 20 69 74 73 20 0a 20 20 20 20 20 20 20 20 2a 2a its . **
291d0 20 74 72 61 6e 73 61 63 74 69 6f 6e 29 2c 20 74 transaction), t
291e0 68 65 6e 20 53 51 4c 69 74 65 20 6d 61 79 20 62 hen SQLite may b
291f0 65 63 6f 6d 65 20 63 6f 6e 66 75 73 65 64 20 77 ecome confused w
29200 68 65 6e 20 64 6f 69 6e 67 20 74 68 65 20 0a 20 hen doing the .
29210 20 20 20 20 20 20 20 2a 2a 20 68 6f 74 2d 6a 6f ** hot-jo
29220 75 72 6e 61 6c 20 72 6f 6c 6c 62 61 63 6b 20 66 urnal rollback f
29230 6f 6c 6c 6f 77 69 6e 67 20 72 65 63 6f 76 65 72 ollowing recover
29240 79 2e 20 49 74 20 6d 61 79 20 72 6f 6c 6c 20 62 y. It may roll b
29250 61 63 6b 20 61 6c 6c 0a 20 20 20 20 20 20 20 20 ack all.
29260 2a 2a 20 6f 66 20 74 68 69 73 20 63 6f 6e 6e 65 ** of this conne
29270 63 74 69 6f 6e 73 20 64 61 74 61 2c 20 74 68 65 ctions data, the
29280 6e 20 70 72 6f 63 65 65 64 20 74 6f 20 72 6f 6c n proceed to rol
29290 6c 69 6e 67 20 62 61 63 6b 20 74 68 65 20 6f 6c ling back the ol
292a0 64 2c 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 75 d,. ** ou
292b0 74 2d 6f 66 2d 64 61 74 65 20 64 61 74 61 20 74 t-of-date data t
292c0 68 61 74 20 66 6f 6c 6c 6f 77 73 20 69 74 2e 20 hat follows it.
292d0 44 61 74 61 62 61 73 65 20 63 6f 72 72 75 70 74 Database corrupt
292e0 69 6f 6e 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a ion.. **.
292f0 20 20 20 20 20 20 20 20 2a 2a 20 54 6f 20 77 6f ** To wo
29300 72 6b 20 61 72 6f 75 6e 64 20 74 68 69 73 2c 20 rk around this,
29310 69 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 if the journal f
29320 69 6c 65 20 64 6f 65 73 20 61 70 70 65 61 72 20 ile does appear
29330 74 6f 20 63 6f 6e 74 61 69 6e 0a 20 20 20 20 20 to contain.
29340 20 20 20 2a 2a 20 61 20 76 61 6c 69 64 20 68 65 ** a valid he
29350 61 64 65 72 20 66 6f 6c 6c 6f 77 69 6e 67 20 50 ader following P
29360 61 67 65 72 2e 6a 6f 75 72 6e 61 6c 4f 66 66 2c ager.journalOff,
29370 20 74 68 65 6e 20 77 72 69 74 65 20 61 20 30 78 then write a 0x
29380 30 30 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 79 00. ** by
29390 74 65 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 te to the start
293a0 6f 66 20 69 74 20 74 6f 20 70 72 65 76 65 6e 74 of it to prevent
293b0 20 69 74 20 66 72 6f 6d 20 62 65 69 6e 67 20 72 it from being r
293c0 65 63 6f 67 6e 69 7a 65 64 2e 0a 20 20 20 20 20 ecognized..
293d0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
293e0 20 56 61 72 69 61 62 6c 65 20 69 4e 65 78 74 48 Variable iNextH
293f0 64 72 4f 66 66 73 65 74 20 69 73 20 73 65 74 20 drOffset is set
29400 74 6f 20 74 68 65 20 6f 66 66 73 65 74 20 61 74 to the offset at
29410 20 77 68 69 63 68 20 74 68 69 73 0a 20 20 20 20 which this.
29420 20 20 20 20 2a 2a 20 70 72 6f 62 6c 65 6d 61 74 ** problemat
29430 69 63 20 68 65 61 64 65 72 20 77 69 6c 6c 20 6f ic header will o
29440 63 63 75 72 2c 20 69 66 20 69 74 20 65 78 69 73 ccur, if it exis
29450 74 73 2e 20 61 4d 61 67 69 63 20 69 73 20 75 73 ts. aMagic is us
29460 65 64 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 ed . ** a
29470 73 20 61 20 74 65 6d 70 6f 72 61 72 79 20 62 75 s a temporary bu
29480 66 66 65 72 20 74 6f 20 69 6e 73 70 65 63 74 20 ffer to inspect
29490 74 68 65 20 66 69 72 73 74 20 63 6f 75 70 6c 65 the first couple
294a0 20 6f 66 20 62 79 74 65 73 20 6f 66 0a 20 20 20 of bytes of.
294b0 20 20 20 20 20 2a 2a 20 74 68 65 20 70 6f 74 65 ** the pote
294c0 6e 74 69 61 6c 20 6a 6f 75 72 6e 61 6c 20 68 65 ntial journal he
294d0 61 64 65 72 2e 0a 20 20 20 20 20 20 20 20 2a 2f ader.. */
294e0 0a 20 20 20 20 20 20 20 20 69 36 34 20 69 4e 65 . i64 iNe
294f0 78 74 48 64 72 4f 66 66 73 65 74 3b 0a 20 20 20 xtHdrOffset;.
29500 20 20 20 20 20 75 38 20 61 4d 61 67 69 63 5b 38 u8 aMagic[8
29510 5d 3b 0a 20 20 20 20 20 20 20 20 75 38 20 7a 48 ];. u8 zH
29520 65 61 64 65 72 5b 73 69 7a 65 6f 66 28 61 4a 6f eader[sizeof(aJo
29530 75 72 6e 61 6c 4d 61 67 69 63 29 2b 34 5d 3b 0a urnalMagic)+4];.
29540 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 . memcpy(
29550 7a 48 65 61 64 65 72 2c 20 61 4a 6f 75 72 6e 61 zHeader, aJourna
29560 6c 4d 61 67 69 63 2c 20 73 69 7a 65 6f 66 28 61 lMagic, sizeof(a
29570 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 29 3b 0a JournalMagic));.
29580 20 20 20 20 20 20 20 20 70 75 74 33 32 62 69 74 put32bit
29590 73 28 26 7a 48 65 61 64 65 72 5b 73 69 7a 65 6f s(&zHeader[sizeo
295a0 66 28 61 4a 6f 75 72 6e 61 6c 4d 61 67 69 63 29 f(aJournalMagic)
295b0 5d 2c 20 70 50 61 67 65 72 2d 3e 6e 52 65 63 29 ], pPager->nRec)
295c0 3b 0a 0a 20 20 20 20 20 20 20 20 69 4e 65 78 74 ;.. iNext
295d0 48 64 72 4f 66 66 73 65 74 20 3d 20 6a 6f 75 72 HdrOffset = jour
295e0 6e 61 6c 48 64 72 4f 66 66 73 65 74 28 70 50 61 nalHdrOffset(pPa
295f0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 72 63 ger);. rc
29600 20 3d 20 73 71 6c 69 74 65 33 4f 73 52 65 61 64 = sqlite3OsRead
29610 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 61 4d (pPager->jfd, aM
29620 61 67 69 63 2c 20 38 2c 20 69 4e 65 78 74 48 64 agic, 8, iNextHd
29630 72 4f 66 66 73 65 74 29 3b 0a 20 20 20 20 20 20 rOffset);.
29640 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
29650 5f 4f 4b 20 26 26 20 30 3d 3d 6d 65 6d 63 6d 70 _OK && 0==memcmp
29660 28 61 4d 61 67 69 63 2c 20 61 4a 6f 75 72 6e 61 (aMagic, aJourna
29670 6c 4d 61 67 69 63 2c 20 38 29 20 29 7b 0a 20 20 lMagic, 8) ){.
29680 20 20 20 20 20 20 20 20 73 74 61 74 69 63 20 63 static c
29690 6f 6e 73 74 20 75 38 20 7a 65 72 6f 62 79 74 65 onst u8 zerobyte
296a0 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
296b0 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 57 72 rc = sqlite3OsWr
296c0 69 74 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 2c ite(pPager->jfd,
296d0 20 26 7a 65 72 6f 62 79 74 65 2c 20 31 2c 20 69 &zerobyte, 1, i
296e0 4e 65 78 74 48 64 72 4f 66 66 73 65 74 29 3b 0a NextHdrOffset);.
296f0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
29700 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
29710 5f 4f 4b 20 26 26 20 72 63 21 3d 53 51 4c 49 54 _OK && rc!=SQLIT
29720 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 E_IOERR_SHORT_RE
29730 41 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 AD ){.
29740 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 return rc;.
29750 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 20 2f 2a }.. /*
29760 20 57 72 69 74 65 20 74 68 65 20 6e 52 65 63 20 Write the nRec
29770 76 61 6c 75 65 20 69 6e 74 6f 20 74 68 65 20 6a value into the j
29780 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 65 61 64 ournal file head
29790 65 72 2e 20 49 66 20 69 6e 0a 20 20 20 20 20 20 er. If in.
297a0 20 20 2a 2a 20 66 75 6c 6c 2d 73 79 6e 63 68 72 ** full-synchr
297b0 6f 6e 6f 75 73 20 6d 6f 64 65 2c 20 73 79 6e 63 onous mode, sync
297c0 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 72 the journal fir
297d0 73 74 2e 20 54 68 69 73 20 65 6e 73 75 72 65 73 st. This ensures
297e0 20 74 68 61 74 0a 20 20 20 20 20 20 20 20 2a 2a that. **
297f0 20 61 6c 6c 20 64 61 74 61 20 68 61 73 20 72 65 all data has re
29800 61 6c 6c 79 20 68 69 74 20 74 68 65 20 64 69 73 ally hit the dis
29810 6b 20 62 65 66 6f 72 65 20 6e 52 65 63 20 69 73 k before nRec is
29820 20 75 70 64 61 74 65 64 20 74 6f 20 6d 61 72 6b updated to mark
29830 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 74 20 61 . ** it a
29840 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 66 6f s a candidate fo
29850 72 20 72 6f 6c 6c 62 61 63 6b 2e 0a 20 20 20 20 r rollback..
29860 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a **. *
29870 2a 20 54 68 69 73 20 69 73 20 6e 6f 74 20 72 65 * This is not re
29880 71 75 69 72 65 64 20 69 66 20 74 68 65 20 70 65 quired if the pe
29890 72 73 69 73 74 65 6e 74 20 6d 65 64 69 61 20 73 rsistent media s
298a0 75 70 70 6f 72 74 73 20 74 68 65 0a 20 20 20 20 upports the.
298b0 20 20 20 20 2a 2a 20 53 41 46 45 5f 41 50 50 45 ** SAFE_APPE
298c0 4e 44 20 70 72 6f 70 65 72 74 79 2e 20 42 65 63 ND property. Bec
298d0 61 75 73 65 20 69 6e 20 74 68 69 73 20 63 61 73 ause in this cas
298e0 65 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 e it is not poss
298f0 69 62 6c 65 20 0a 20 20 20 20 20 20 20 20 2a 2a ible . **
29900 20 66 6f 72 20 67 61 72 62 61 67 65 20 64 61 74 for garbage dat
29910 61 20 74 6f 20 62 65 20 61 70 70 65 6e 64 65 64 a to be appended
29920 20 74 6f 20 74 68 65 20 66 69 6c 65 2c 20 74 68 to the file, th
29930 65 20 6e 52 65 63 20 66 69 65 6c 64 0a 20 20 20 e nRec field.
29940 20 20 20 20 20 2a 2a 20 69 73 20 70 6f 70 75 6c ** is popul
29950 61 74 65 64 20 77 69 74 68 20 30 78 46 46 46 46 ated with 0xFFFF
29960 46 46 46 46 20 77 68 65 6e 20 74 68 65 20 6a 6f FFFF when the jo
29970 75 72 6e 61 6c 20 68 65 61 64 65 72 20 69 73 20 urnal header is
29980 77 72 69 74 74 65 6e 0a 20 20 20 20 20 20 20 20 written.
29990 2a 2a 20 61 6e 64 20 6e 65 76 65 72 20 6e 65 65 ** and never nee
299a0 64 73 20 74 6f 20 62 65 20 75 70 64 61 74 65 64 ds to be updated
299b0 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 .. */.
299c0 20 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d if( pPager-
299d0 3e 66 75 6c 6c 53 79 6e 63 20 26 26 20 30 3d 3d >fullSync && 0==
299e0 28 69 44 63 26 53 51 4c 49 54 45 5f 49 4f 43 41 (iDc&SQLITE_IOCA
299f0 50 5f 53 45 51 55 45 4e 54 49 41 4c 29 20 29 7b P_SEQUENTIAL) ){
29a00 0a 20 20 20 20 20 20 20 20 20 20 50 41 47 45 52 . PAGER
29a10 54 52 41 43 45 28 28 22 53 59 4e 43 20 6a 6f 75 TRACE(("SYNC jou
29a20 72 6e 61 6c 20 6f 66 20 25 64 5c 6e 22 2c 20 50 rnal of %d\n", P
29a30 41 47 45 52 49 44 28 70 50 61 67 65 72 29 29 29 AGERID(pPager)))
29a40 3b 0a 20 20 20 20 20 20 20 20 20 20 49 4f 54 52 ;. IOTR
29a50 41 43 45 28 28 22 4a 53 59 4e 43 20 25 70 5c 6e ACE(("JSYNC %p\n
29a60 22 2c 20 70 50 61 67 65 72 29 29 0a 20 20 20 20 ", pPager)).
29a70 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
29a80 65 33 4f 73 53 79 6e 63 28 70 50 61 67 65 72 2d e3OsSync(pPager-
29a90 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e 73 79 >jfd, pPager->sy
29aa0 6e 63 46 6c 61 67 73 29 3b 0a 20 20 20 20 20 20 ncFlags);.
29ab0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
29ac0 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
29ad0 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 c;. }.
29ae0 20 20 20 20 20 49 4f 54 52 41 43 45 28 28 22 4a IOTRACE(("J
29af0 48 44 52 20 25 70 20 25 6c 6c 64 5c 6e 22 2c 20 HDR %p %lld\n",
29b00 70 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e pPager, pPager->
29b10 6a 6f 75 72 6e 61 6c 48 64 72 29 29 3b 0a 20 20 journalHdr));.
29b20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
29b30 65 33 4f 73 57 72 69 74 65 28 0a 20 20 20 20 20 e3OsWrite(.
29b40 20 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a pPager->j
29b50 66 64 2c 20 7a 48 65 61 64 65 72 2c 20 73 69 7a fd, zHeader, siz
29b60 65 6f 66 28 7a 48 65 61 64 65 72 29 2c 20 70 50 eof(zHeader), pP
29b70 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 ager->journalHdr
29b80 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 . );.
29b90 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
29ba0 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72 TE_OK ) return r
29bb0 63 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 c;. }.
29bc0 20 69 66 28 20 30 3d 3d 28 69 44 63 26 53 51 4c if( 0==(iDc&SQL
29bd0 49 54 45 5f 49 4f 43 41 50 5f 53 45 51 55 45 4e ITE_IOCAP_SEQUEN
29be0 54 49 41 4c 29 20 29 7b 0a 20 20 20 20 20 20 20 TIAL) ){.
29bf0 20 50 41 47 45 52 54 52 41 43 45 28 28 22 53 59 PAGERTRACE(("SY
29c00 4e 43 20 6a 6f 75 72 6e 61 6c 20 6f 66 20 25 64 NC journal of %d
29c10 5c 6e 22 2c 20 50 41 47 45 52 49 44 28 70 50 61 \n", PAGERID(pPa
29c20 67 65 72 29 29 29 3b 0a 20 20 20 20 20 20 20 20 ger)));.
29c30 49 4f 54 52 41 43 45 28 28 22 4a 53 59 4e 43 20 IOTRACE(("JSYNC
29c40 25 70 5c 6e 22 2c 20 70 50 61 67 65 72 29 29 0a %p\n", pPager)).
29c50 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c rc = sql
29c60 69 74 65 33 4f 73 53 79 6e 63 28 70 50 61 67 65 ite3OsSync(pPage
29c70 72 2d 3e 6a 66 64 2c 20 70 50 61 67 65 72 2d 3e r->jfd, pPager->
29c80 73 79 6e 63 46 6c 61 67 73 7c 20 0a 20 20 20 20 syncFlags| .
29c90 20 20 20 20 20 20 28 70 50 61 67 65 72 2d 3e 73 (pPager->s
29ca0 79 6e 63 46 6c 61 67 73 3d 3d 53 51 4c 49 54 45 yncFlags==SQLITE
29cb0 5f 53 59 4e 43 5f 46 55 4c 4c 3f 53 51 4c 49 54 _SYNC_FULL?SQLIT
29cc0 45 5f 53 59 4e 43 5f 44 41 54 41 4f 4e 4c 59 3a E_SYNC_DATAONLY:
29cd0 30 29 0a 20 20 20 20 20 20 20 20 29 3b 0a 20 20 0). );.
29ce0 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 if( rc!=SQ
29cf0 4c 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e LITE_OK ) return
29d00 20 72 63 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 rc;. }..
29d10 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
29d20 6e 61 6c 48 64 72 20 3d 20 70 50 61 67 65 72 2d nalHdr = pPager-
29d30 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 20 20 >journalOff;.
29d40 20 20 20 69 66 28 20 6e 65 77 48 64 72 20 26 26 if( newHdr &&
29d50 20 30 3d 3d 28 69 44 63 26 53 51 4c 49 54 45 5f 0==(iDc&SQLITE_
29d60 49 4f 43 41 50 5f 53 41 46 45 5f 41 50 50 45 4e IOCAP_SAFE_APPEN
29d70 44 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 50 D) ){. pP
29d80 61 67 65 72 2d 3e 6e 52 65 63 20 3d 20 30 3b 0a ager->nRec = 0;.
29d90 20 20 20 20 20 20 20 20 72 63 20 3d 20 77 72 69 rc = wri
29da0 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 61 teJournalHdr(pPa
29db0 67 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69 66 ger);. if
29dc0 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
29dd0 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 ) return rc;.
29de0 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
29df0 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f pPager->jo
29e00 75 72 6e 61 6c 48 64 72 20 3d 20 70 50 61 67 65 urnalHdr = pPage
29e10 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 20 r->journalOff;.
29e20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 55 }. }.. /* U
29e30 6e 6c 65 73 73 20 74 68 65 20 70 61 67 65 72 20 nless the pager
29e40 69 73 20 69 6e 20 6e 6f 53 79 6e 63 20 6d 6f 64 is in noSync mod
29e50 65 2c 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 e, the journal f
29e60 69 6c 65 20 77 61 73 20 6a 75 73 74 20 0a 20 20 ile was just .
29e70 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 ** successfully
29e80 73 79 6e 63 65 64 2e 20 45 69 74 68 65 72 20 77 synced. Either w
29e90 61 79 2c 20 63 6c 65 61 72 20 74 68 65 20 50 47 ay, clear the PG
29ea0 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 20 66 6c HDR_NEED_SYNC fl
29eb0 61 67 20 6f 6e 20 0a 20 20 2a 2a 20 61 6c 6c 20 ag on . ** all
29ec0 70 61 67 65 73 2e 0a 20 20 2a 2f 0a 20 20 73 71 pages.. */. sq
29ed0 6c 69 74 65 33 50 63 61 63 68 65 43 6c 65 61 72 lite3PcacheClear
29ee0 53 79 6e 63 46 6c 61 67 73 28 70 50 61 67 65 72 SyncFlags(pPager
29ef0 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 70 50 ->pPCache);. pP
29f00 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 ager->eState = P
29f10 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
29f20 44 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 D;. assert( ass
29f30 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 ert_pager_state(
29f40 70 50 61 67 65 72 29 20 29 3b 0a 20 20 72 65 74 pPager) );. ret
29f50 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d urn SQLITE_OK;.}
29f60 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 ../*.** The argu
29f70 6d 65 6e 74 20 69 73 20 74 68 65 20 66 69 72 73 ment is the firs
29f80 74 20 69 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 t in a linked li
29f90 73 74 20 6f 66 20 64 69 72 74 79 20 70 61 67 65 st of dirty page
29fa0 73 20 63 6f 6e 6e 65 63 74 65 64 0a 2a 2a 20 62 s connected.** b
29fb0 79 20 74 68 65 20 50 67 48 64 72 2e 70 44 69 72 y the PgHdr.pDir
29fc0 74 79 20 70 6f 69 6e 74 65 72 2e 20 54 68 69 73 ty pointer. This
29fd0 20 66 75 6e 63 74 69 6f 6e 20 77 72 69 74 65 73 function writes
29fe0 20 65 61 63 68 20 6f 6e 65 20 6f 66 20 74 68 65 each one of the
29ff0 0a 2a 2a 20 69 6e 2d 6d 65 6d 6f 72 79 20 70 61 .** in-memory pa
2a000 67 65 73 20 69 6e 20 74 68 65 20 6c 69 73 74 20 ges in the list
2a010 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 to the database
2a020 66 69 6c 65 2e 20 54 68 65 20 61 72 67 75 6d 65 file. The argume
2a030 6e 74 20 6d 61 79 0a 2a 2a 20 62 65 20 4e 55 4c nt may.** be NUL
2a040 4c 2c 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 L, representing
2a050 61 6e 20 65 6d 70 74 79 20 6c 69 73 74 2e 20 49 an empty list. I
2a060 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 69 73 n this case this
2a070 20 66 75 6e 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 function is.**
2a080 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 a no-op..**.** T
2a090 68 65 20 70 61 67 65 72 20 6d 75 73 74 20 68 6f he pager must ho
2a0a0 6c 64 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 ld at least a RE
2a0b0 53 45 52 56 45 44 20 6c 6f 63 6b 20 77 68 65 6e SERVED lock when
2a0c0 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a this function.*
2a0d0 2a 20 69 73 20 63 61 6c 6c 65 64 2e 20 42 65 66 * is called. Bef
2a0e0 6f 72 65 20 77 72 69 74 69 6e 67 20 61 6e 79 74 ore writing anyt
2a0f0 68 69 6e 67 20 74 6f 20 74 68 65 20 64 61 74 61 hing to the data
2a100 62 61 73 65 20 66 69 6c 65 2c 20 74 68 69 73 20 base file, this
2a110 6c 6f 63 6b 0a 2a 2a 20 69 73 20 75 70 67 72 61 lock.** is upgra
2a120 64 65 64 20 74 6f 20 61 6e 20 45 58 43 4c 55 53 ded to an EXCLUS
2a130 49 56 45 20 6c 6f 63 6b 2e 20 49 66 20 74 68 65 IVE lock. If the
2a140 20 6c 6f 63 6b 20 63 61 6e 6e 6f 74 20 62 65 20 lock cannot be
2a150 6f 62 74 61 69 6e 65 64 2c 0a 2a 2a 20 53 51 4c obtained,.** SQL
2a160 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 ITE_BUSY is retu
2a170 72 6e 65 64 20 61 6e 64 20 6e 6f 20 64 61 74 61 rned and no data
2a180 20 69 73 20 77 72 69 74 74 65 6e 20 74 6f 20 74 is written to t
2a190 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
2a1a0 2e 0a 2a 2a 20 0a 2a 2a 20 49 66 20 74 68 65 20 ..** .** If the
2a1b0 70 61 67 65 72 20 69 73 20 61 20 74 65 6d 70 2d pager is a temp-
2a1c0 66 69 6c 65 20 70 61 67 65 72 20 61 6e 64 20 74 file pager and t
2a1d0 68 65 20 61 63 74 75 61 6c 20 66 69 6c 65 2d 73 he actual file-s
2a1e0 79 73 74 65 6d 20 66 69 6c 65 0a 2a 2a 20 69 73 ystem file.** is
2a1f0 20 6e 6f 74 20 79 65 74 20 6f 70 65 6e 2c 20 69 not yet open, i
2a200 74 20 69 73 20 63 72 65 61 74 65 64 20 61 6e 64 t is created and
2a210 20 6f 70 65 6e 65 64 20 62 65 66 6f 72 65 20 61 opened before a
2a220 6e 79 20 64 61 74 61 20 69 73 20 0a 2a 2a 20 77 ny data is .** w
2a230 72 69 74 74 65 6e 20 6f 75 74 2e 0a 2a 2a 0a 2a ritten out..**.*
2a240 2a 20 4f 6e 63 65 20 74 68 65 20 6c 6f 63 6b 20 * Once the lock
2a250 68 61 73 20 62 65 65 6e 20 75 70 67 72 61 64 65 has been upgrade
2a260 64 20 61 6e 64 2c 20 69 66 20 6e 65 63 65 73 73 d and, if necess
2a270 61 72 79 2c 20 74 68 65 20 66 69 6c 65 20 6f 70 ary, the file op
2a280 65 6e 65 64 2c 0a 2a 2a 20 74 68 65 20 70 61 67 ened,.** the pag
2a290 65 73 20 61 72 65 20 77 72 69 74 74 65 6e 20 6f es are written o
2a2a0 75 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 ut to the databa
2a2b0 73 65 20 66 69 6c 65 20 69 6e 20 6c 69 73 74 20 se file in list
2a2c0 6f 72 64 65 72 2e 20 57 72 69 74 69 6e 67 0a 2a order. Writing.*
2a2d0 2a 20 61 20 70 61 67 65 20 69 73 20 73 6b 69 70 * a page is skip
2a2e0 70 65 64 20 69 66 20 69 74 20 6d 65 65 74 73 20 ped if it meets
2a2f0 65 69 74 68 65 72 20 6f 66 20 74 68 65 20 66 6f either of the fo
2a300 6c 6c 6f 77 69 6e 67 20 63 72 69 74 65 72 69 61 llowing criteria
2a310 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65 20 :.**.** * The
2a320 70 61 67 65 20 6e 75 6d 62 65 72 20 69 73 20 67 page number is g
2a330 72 65 61 74 65 72 20 74 68 61 6e 20 50 61 67 65 reater than Page
2a340 72 2e 64 62 53 69 7a 65 2c 20 6f 72 0a 2a 2a 20 r.dbSize, or.**
2a350 20 20 2a 20 54 68 65 20 50 47 48 44 52 5f 44 4f * The PGHDR_DO
2a360 4e 54 5f 57 52 49 54 45 20 66 6c 61 67 20 69 73 NT_WRITE flag is
2a370 20 73 65 74 20 6f 6e 20 74 68 65 20 70 61 67 65 set on the page
2a380 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 77 72 69 74 69 ..**.** If writi
2a390 6e 67 20 6f 75 74 20 61 20 70 61 67 65 20 63 61 ng out a page ca
2a3a0 75 73 65 73 20 74 68 65 20 64 61 74 61 62 61 73 uses the databas
2a3b0 65 20 66 69 6c 65 20 74 6f 20 67 72 6f 77 2c 20 e file to grow,
2a3c0 50 61 67 65 72 2e 64 62 46 69 6c 65 53 69 7a 65 Pager.dbFileSize
2a3d0 0a 2a 2a 20 69 73 20 75 70 64 61 74 65 64 20 61 .** is updated a
2a3e0 63 63 6f 72 64 69 6e 67 6c 79 2e 20 49 66 20 70 ccordingly. If p
2a3f0 61 67 65 20 31 20 69 73 20 77 72 69 74 74 65 6e age 1 is written
2a400 20 6f 75 74 2c 20 74 68 65 6e 20 74 68 65 20 76 out, then the v
2a410 61 6c 75 65 20 63 61 63 68 65 64 0a 2a 2a 20 69 alue cached.** i
2a420 6e 20 50 61 67 65 72 2e 64 62 46 69 6c 65 56 65 n Pager.dbFileVe
2a430 72 73 5b 5d 20 69 73 20 75 70 64 61 74 65 64 20 rs[] is updated
2a440 74 6f 20 6d 61 74 63 68 20 74 68 65 20 6e 65 77 to match the new
2a450 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e value stored in
2a460 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 61 73 65 .** the database
2a470 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 file..**.** If
2a480 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 everything is su
2a490 63 63 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 ccessful, SQLITE
2a4a0 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e _OK is returned.
2a4b0 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 If an IO error
2a4c0 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 61 6e 20 49 .** occurs, an I
2a4d0 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 O error code is
2a4e0 72 65 74 75 72 6e 65 64 2e 20 4f 72 2c 20 69 66 returned. Or, if
2a4f0 20 74 68 65 20 45 58 43 4c 55 53 49 56 45 20 6c the EXCLUSIVE l
2a500 6f 63 6b 20 63 61 6e 6e 6f 74 0a 2a 2a 20 62 65 ock cannot.** be
2a510 20 6f 62 74 61 69 6e 65 64 2c 20 53 51 4c 49 54 obtained, SQLIT
2a520 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e E_BUSY is return
2a530 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e ed..*/.static in
2a540 74 20 70 61 67 65 72 5f 77 72 69 74 65 5f 70 61 t pager_write_pa
2a550 67 65 6c 69 73 74 28 50 61 67 65 72 20 2a 70 50 gelist(Pager *pP
2a560 61 67 65 72 2c 20 50 67 48 64 72 20 2a 70 4c 69 ager, PgHdr *pLi
2a570 73 74 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 st){. int rc =
2a580 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
2a590 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
2a5a0 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a 20 eturn code */..
2a5b0 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f /* This functio
2a5c0 6e 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 n is only called
2a5d0 20 66 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 70 61 for rollback pa
2a5e0 67 65 72 73 20 69 6e 20 57 52 49 54 45 52 5f 44 gers in WRITER_D
2a5f0 42 4d 4f 44 20 73 74 61 74 65 2e 20 2a 2f 0a 20 BMOD state. */.
2a600 20 61 73 73 65 72 74 28 20 21 70 61 67 65 72 55 assert( !pagerU
2a610 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b seWal(pPager) );
2a620 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 . assert( pPage
2a630 72 2d 3e 74 65 6d 70 46 69 6c 65 20 7c 7c 20 70 r->tempFile || p
2a640 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 Pager->eState==P
2a650 41 47 45 52 5f 57 52 49 54 45 52 5f 44 42 4d 4f AGER_WRITER_DBMO
2a660 44 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 D );. assert( p
2a670 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 45 58 Pager->eLock==EX
2a680 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 3b 0a CLUSIVE_LOCK );.
2a690 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e assert( isOpen
2a6a0 28 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 (pPager->fd) ||
2a6b0 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 3d 3d 30 pList->pDirty==0
2a6c0 20 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 );.. /* If the
2a6d0 20 66 69 6c 65 20 69 73 20 61 20 74 65 6d 70 2d file is a temp-
2a6e0 66 69 6c 65 20 68 61 73 20 6e 6f 74 20 79 65 74 file has not yet
2a6f0 20 62 65 65 6e 20 6f 70 65 6e 65 64 2c 20 6f 70 been opened, op
2a700 65 6e 20 69 74 20 6e 6f 77 2e 20 49 74 0a 20 20 en it now. It.
2a710 2a 2a 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 ** is not possib
2a720 6c 65 20 66 6f 72 20 72 63 20 74 6f 20 62 65 20 le for rc to be
2a730 6f 74 68 65 72 20 74 68 61 6e 20 53 51 4c 49 54 other than SQLIT
2a740 45 5f 4f 4b 20 69 66 20 74 68 69 73 20 62 72 61 E_OK if this bra
2a750 6e 63 68 0a 20 20 2a 2a 20 69 73 20 74 61 6b 65 nch. ** is take
2a760 6e 2c 20 61 73 20 70 61 67 65 72 5f 77 61 69 74 n, as pager_wait
2a770 5f 6f 6e 5f 6c 6f 63 6b 28 29 20 69 73 20 61 20 _on_lock() is a
2a780 6e 6f 2d 6f 70 20 66 6f 72 20 74 65 6d 70 2d 66 no-op for temp-f
2a790 69 6c 65 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 iles.. */. if(
2a7a0 20 21 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d !isOpen(pPager-
2a7b0 3e 66 64 29 20 29 7b 0a 20 20 20 20 61 73 73 65 >fd) ){. asse
2a7c0 72 74 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 rt( pPager->temp
2a7d0 46 69 6c 65 20 26 26 20 72 63 3d 3d 53 51 4c 49 File && rc==SQLI
2a7e0 54 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 72 63 20 TE_OK );. rc
2a7f0 3d 20 70 61 67 65 72 4f 70 65 6e 74 65 6d 70 28 = pagerOpentemp(
2a800 70 50 61 67 65 72 2c 20 70 50 61 67 65 72 2d 3e pPager, pPager->
2a810 66 64 2c 20 70 50 61 67 65 72 2d 3e 76 66 73 46 fd, pPager->vfsF
2a820 6c 61 67 73 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a lags);. }.. /*
2a830 20 42 65 66 6f 72 65 20 74 68 65 20 66 69 72 73 Before the firs
2a840 74 20 77 72 69 74 65 2c 20 67 69 76 65 20 74 68 t write, give th
2a850 65 20 56 46 53 20 61 20 68 69 6e 74 20 6f 66 20 e VFS a hint of
2a860 77 68 61 74 20 74 68 65 20 66 69 6e 61 6c 0a 20 what the final.
2a870 20 2a 2a 20 66 69 6c 65 20 73 69 7a 65 20 77 69 ** file size wi
2a880 6c 6c 20 62 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 ll be.. */. as
2a890 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 sert( rc!=SQLITE
2a8a0 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e 28 70 50 _OK || isOpen(pP
2a8b0 61 67 65 72 2d 3e 66 64 29 20 29 3b 0a 20 20 69 ager->fd) );. i
2a8c0 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
2a8d0 20 0a 20 20 20 26 26 20 70 50 61 67 65 72 2d 3e . && pPager->
2a8e0 64 62 48 69 6e 74 53 69 7a 65 3c 70 50 61 67 65 dbHintSize<pPage
2a8f0 72 2d 3e 64 62 53 69 7a 65 0a 20 20 20 26 26 20 r->dbSize. &&
2a900 28 70 4c 69 73 74 2d 3e 70 44 69 72 74 79 20 7c (pList->pDirty |
2a910 7c 20 70 4c 69 73 74 2d 3e 70 67 6e 6f 3e 70 50 | pList->pgno>pP
2a920 61 67 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 ager->dbHintSize
2a930 29 0a 20 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ). ){. sqlit
2a940 65 33 5f 69 6e 74 36 34 20 73 7a 46 69 6c 65 20 e3_int64 szFile
2a950 3d 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 69 = pPager->pageSi
2a960 7a 65 20 2a 20 28 73 71 6c 69 74 65 33 5f 69 6e ze * (sqlite3_in
2a970 74 36 34 29 70 50 61 67 65 72 2d 3e 64 62 53 69 t64)pPager->dbSi
2a980 7a 65 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 4f ze;. sqlite3O
2a990 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 48 69 6e 74 sFileControlHint
2a9a0 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 53 51 4c (pPager->fd, SQL
2a9b0 49 54 45 5f 46 43 4e 54 4c 5f 53 49 5a 45 5f 48 ITE_FCNTL_SIZE_H
2a9c0 49 4e 54 2c 20 26 73 7a 46 69 6c 65 29 3b 0a 20 INT, &szFile);.
2a9d0 20 20 20 70 50 61 67 65 72 2d 3e 64 62 48 69 6e pPager->dbHin
2a9e0 74 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e tSize = pPager->
2a9f0 64 62 53 69 7a 65 3b 0a 20 20 7d 0a 0a 20 20 77 dbSize;. }.. w
2aa00 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 hile( rc==SQLITE
2aa10 5f 4f 4b 20 26 26 20 70 4c 69 73 74 20 29 7b 0a _OK && pList ){.
2aa20 20 20 20 20 50 67 6e 6f 20 70 67 6e 6f 20 3d 20 Pgno pgno =
2aa30 70 4c 69 73 74 2d 3e 70 67 6e 6f 3b 0a 0a 20 20 pList->pgno;..
2aa40 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 /* If there ar
2aa50 65 20 64 69 72 74 79 20 70 61 67 65 73 20 69 6e e dirty pages in
2aa60 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 20 the page cache
2aa70 77 69 74 68 20 70 61 67 65 20 6e 75 6d 62 65 72 with page number
2aa80 73 20 67 72 65 61 74 65 72 0a 20 20 20 20 2a 2a s greater. **
2aa90 20 74 68 61 6e 20 50 61 67 65 72 2e 64 62 53 69 than Pager.dbSi
2aaa0 7a 65 2c 20 74 68 69 73 20 6d 65 61 6e 73 20 73 ze, this means s
2aab0 71 6c 69 74 65 33 50 61 67 65 72 54 72 75 6e 63 qlite3PagerTrunc
2aac0 61 74 65 49 6d 61 67 65 28 29 20 77 61 73 20 63 ateImage() was c
2aad0 61 6c 6c 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 alled to. **
2aae0 6d 61 6b 65 20 74 68 65 20 66 69 6c 65 20 73 6d make the file sm
2aaf0 61 6c 6c 65 72 20 28 70 72 65 73 75 6d 61 62 6c aller (presumabl
2ab00 79 20 62 79 20 61 75 74 6f 2d 76 61 63 75 75 6d y by auto-vacuum
2ab10 20 63 6f 64 65 29 2e 20 44 6f 20 6e 6f 74 20 77 code). Do not w
2ab20 72 69 74 65 0a 20 20 20 20 2a 2a 20 61 6e 79 20 rite. ** any
2ab30 73 75 63 68 20 70 61 67 65 73 20 74 6f 20 74 68 such pages to th
2ab40 65 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20 e file.. **.
2ab50 20 20 20 2a 2a 20 41 6c 73 6f 2c 20 64 6f 20 6e ** Also, do n
2ab60 6f 74 20 77 72 69 74 65 20 6f 75 74 20 61 6e 79 ot write out any
2ab70 20 70 61 67 65 20 74 68 61 74 20 68 61 73 20 74 page that has t
2ab80 68 65 20 50 47 48 44 52 5f 44 4f 4e 54 5f 57 52 he PGHDR_DONT_WR
2ab90 49 54 45 20 66 6c 61 67 0a 20 20 20 20 2a 2a 20 ITE flag. **
2aba0 73 65 74 20 28 73 65 74 20 62 79 20 73 71 6c 69 set (set by sqli
2abb0 74 65 33 50 61 67 65 72 44 6f 6e 74 57 72 69 74 te3PagerDontWrit
2abc0 65 28 29 29 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 e()).. */.
2abd0 20 69 66 28 20 70 67 6e 6f 3c 3d 70 50 61 67 65 if( pgno<=pPage
2abe0 72 2d 3e 64 62 53 69 7a 65 20 26 26 20 30 3d 3d r->dbSize && 0==
2abf0 28 70 4c 69 73 74 2d 3e 66 6c 61 67 73 26 50 47 (pList->flags&PG
2ac00 48 44 52 5f 44 4f 4e 54 5f 57 52 49 54 45 29 20 HDR_DONT_WRITE)
2ac10 29 7b 0a 20 20 20 20 20 20 69 36 34 20 6f 66 66 ){. i64 off
2ac20 73 65 74 20 3d 20 28 70 67 6e 6f 2d 31 29 2a 28 set = (pgno-1)*(
2ac30 69 36 34 29 70 50 61 67 65 72 2d 3e 70 61 67 65 i64)pPager->page
2ac40 53 69 7a 65 3b 20 20 20 2f 2a 20 4f 66 66 73 65 Size; /* Offse
2ac50 74 20 74 6f 20 77 72 69 74 65 20 2a 2f 0a 20 20 t to write */.
2ac60 20 20 20 20 63 68 61 72 20 2a 70 44 61 74 61 3b char *pData;
2ac70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ac80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ac90 20 20 20 2f 2a 20 44 61 74 61 20 74 6f 20 77 72 /* Data to wr
2aca0 69 74 65 20 2a 2f 20 20 20 20 0a 0a 20 20 20 20 ite */ ..
2acb0 20 20 61 73 73 65 72 74 28 20 28 70 4c 69 73 74 assert( (pList
2acc0 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 ->flags&PGHDR_NE
2acd0 45 44 5f 53 59 4e 43 29 3d 3d 30 20 29 3b 0a 20 ED_SYNC)==0 );.
2ace0 20 20 20 20 20 69 66 28 20 70 4c 69 73 74 2d 3e if( pList->
2acf0 70 67 6e 6f 3d 3d 31 20 29 20 70 61 67 65 72 5f pgno==1 ) pager_
2ad00 77 72 69 74 65 5f 63 68 61 6e 67 65 63 6f 75 6e write_changecoun
2ad10 74 65 72 28 70 4c 69 73 74 29 3b 0a 0a 20 20 20 ter(pList);..
2ad20 20 20 20 2f 2a 20 45 6e 63 6f 64 65 20 74 68 65 /* Encode the
2ad30 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 20 database */.
2ad40 20 20 20 43 4f 44 45 43 32 28 70 50 61 67 65 72 CODEC2(pPager
2ad50 2c 20 70 4c 69 73 74 2d 3e 70 44 61 74 61 2c 20 , pList->pData,
2ad60 70 67 6e 6f 2c 20 36 2c 20 72 65 74 75 72 6e 20 pgno, 6, return
2ad70 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
2ad80 54 2c 20 70 44 61 74 61 29 3b 0a 0a 20 20 20 20 T, pData);..
2ad90 20 20 2f 2a 20 57 72 69 74 65 20 6f 75 74 20 74 /* Write out t
2ada0 68 65 20 70 61 67 65 20 64 61 74 61 2e 20 2a 2f he page data. */
2adb0 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
2adc0 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 67 65 te3OsWrite(pPage
2add0 72 2d 3e 66 64 2c 20 70 44 61 74 61 2c 20 70 50 r->fd, pData, pP
2ade0 61 67 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 ager->pageSize,
2adf0 6f 66 66 73 65 74 29 3b 0a 0a 20 20 20 20 20 20 offset);..
2ae00 2f 2a 20 49 66 20 70 61 67 65 20 31 20 77 61 73 /* If page 1 was
2ae10 20 6a 75 73 74 20 77 72 69 74 74 65 6e 2c 20 75 just written, u
2ae20 70 64 61 74 65 20 50 61 67 65 72 2e 64 62 46 69 pdate Pager.dbFi
2ae30 6c 65 56 65 72 73 20 74 6f 20 6d 61 74 63 68 0a leVers to match.
2ae40 20 20 20 20 20 20 2a 2a 20 74 68 65 20 76 61 6c ** the val
2ae50 75 65 20 6e 6f 77 20 73 74 6f 72 65 64 20 69 6e ue now stored in
2ae60 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
2ae70 6c 65 2e 20 49 66 20 77 72 69 74 69 6e 67 20 74 le. If writing t
2ae80 68 69 73 20 0a 20 20 20 20 20 20 2a 2a 20 70 61 his . ** pa
2ae90 67 65 20 63 61 75 73 65 64 20 74 68 65 20 64 61 ge caused the da
2aea0 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 67 tabase file to g
2aeb0 72 6f 77 2c 20 75 70 64 61 74 65 20 64 62 46 69 row, update dbFi
2aec0 6c 65 53 69 7a 65 2e 20 0a 20 20 20 20 20 20 2a leSize. . *
2aed0 2f 0a 20 20 20 20 20 20 69 66 28 20 70 67 6e 6f /. if( pgno
2aee0 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 6d ==1 ){. m
2aef0 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e 64 emcpy(&pPager->d
2af00 62 46 69 6c 65 56 65 72 73 2c 20 26 70 44 61 74 bFileVers, &pDat
2af10 61 5b 32 34 5d 2c 20 73 69 7a 65 6f 66 28 70 50 a[24], sizeof(pP
2af20 61 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 ager->dbFileVers
2af30 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ));. }.
2af40 20 20 69 66 28 20 70 67 6e 6f 3e 70 50 61 67 65 if( pgno>pPage
2af50 72 2d 3e 64 62 46 69 6c 65 53 69 7a 65 20 29 7b r->dbFileSize ){
2af60 0a 20 20 20 20 20 20 20 20 70 50 61 67 65 72 2d . pPager-
2af70 3e 64 62 46 69 6c 65 53 69 7a 65 20 3d 20 70 67 >dbFileSize = pg
2af80 6e 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 no;. }.
2af90 20 20 70 50 61 67 65 72 2d 3e 61 53 74 61 74 5b pPager->aStat[
2afa0 50 41 47 45 52 5f 53 54 41 54 5f 57 52 49 54 45 PAGER_STAT_WRITE
2afb0 5d 2b 2b 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 55 ]++;.. /* U
2afc0 70 64 61 74 65 20 61 6e 79 20 62 61 63 6b 75 70 pdate any backup
2afd0 20 6f 62 6a 65 63 74 73 20 63 6f 70 79 69 6e 67 objects copying
2afe0 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 the contents of
2aff0 20 74 68 69 73 20 70 61 67 65 72 2e 20 2a 2f 0a this pager. */.
2b000 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 61 63 sqlite3Bac
2b010 6b 75 70 55 70 64 61 74 65 28 70 50 61 67 65 72 kupUpdate(pPager
2b020 2d 3e 70 42 61 63 6b 75 70 2c 20 70 67 6e 6f 2c ->pBackup, pgno,
2b030 20 28 75 38 2a 29 70 4c 69 73 74 2d 3e 70 44 61 (u8*)pList->pDa
2b040 74 61 29 3b 0a 0a 20 20 20 20 20 20 50 41 47 45 ta);.. PAGE
2b050 52 54 52 41 43 45 28 28 22 53 54 4f 52 45 20 25 RTRACE(("STORE %
2b060 64 20 70 61 67 65 20 25 64 20 68 61 73 68 28 25 d page %d hash(%
2b070 30 38 78 29 5c 6e 22 2c 0a 20 20 20 20 20 20 20 08x)\n",.
2b080 20 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 PAGE
2b090 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 67 6e RID(pPager), pgn
2b0a0 6f 2c 20 70 61 67 65 72 5f 70 61 67 65 68 61 73 o, pager_pagehas
2b0b0 68 28 70 4c 69 73 74 29 29 29 3b 0a 20 20 20 20 h(pList)));.
2b0c0 20 20 49 4f 54 52 41 43 45 28 28 22 50 47 4f 55 IOTRACE(("PGOU
2b0d0 54 20 25 70 20 25 64 5c 6e 22 2c 20 70 50 61 67 T %p %d\n", pPag
2b0e0 65 72 2c 20 70 67 6e 6f 29 29 3b 0a 20 20 20 20 er, pgno));.
2b0f0 20 20 50 41 47 45 52 5f 49 4e 43 52 28 73 71 6c PAGER_INCR(sql
2b100 69 74 65 33 5f 70 61 67 65 72 5f 77 72 69 74 65 ite3_pager_write
2b110 64 62 5f 63 6f 75 6e 74 29 3b 0a 20 20 20 20 7d db_count);. }
2b120 65 6c 73 65 7b 0a 20 20 20 20 20 20 50 41 47 45 else{. PAGE
2b130 52 54 52 41 43 45 28 28 22 4e 4f 53 54 4f 52 45 RTRACE(("NOSTORE
2b140 20 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 %d page %d\n",
2b150 50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c PAGERID(pPager),
2b160 20 70 67 6e 6f 29 29 3b 0a 20 20 20 20 7d 0a 20 pgno));. }.
2b170 20 20 20 70 61 67 65 72 5f 73 65 74 5f 70 61 67 pager_set_pag
2b180 65 68 61 73 68 28 70 4c 69 73 74 29 3b 0a 20 20 ehash(pList);.
2b190 20 20 70 4c 69 73 74 20 3d 20 70 4c 69 73 74 2d pList = pList-
2b1a0 3e 70 44 69 72 74 79 3b 0a 20 20 7d 0a 0a 20 20 >pDirty;. }..
2b1b0 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a return rc;.}../*
2b1c0 0a 2a 2a 20 45 6e 73 75 72 65 20 74 68 61 74 20 .** Ensure that
2b1d0 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 the sub-journal
2b1e0 66 69 6c 65 20 69 73 20 6f 70 65 6e 2e 20 49 66 file is open. If
2b1f0 20 69 74 20 69 73 20 61 6c 72 65 61 64 79 20 6f it is already o
2b200 70 65 6e 2c 20 74 68 69 73 20 0a 2a 2a 20 66 75 pen, this .** fu
2b210 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f nction is a no-o
2b220 70 2e 0a 2a 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f p..**.** SQLITE_
2b230 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 20 69 OK is returned i
2b240 66 20 65 76 65 72 79 74 68 69 6e 67 20 67 6f 65 f everything goe
2b250 73 20 61 63 63 6f 72 64 69 6e 67 20 74 6f 20 70 s according to p
2b260 6c 61 6e 2e 20 41 6e 20 0a 2a 2a 20 53 51 4c 49 lan. An .** SQLI
2b270 54 45 5f 49 4f 45 52 52 5f 58 58 58 20 65 72 72 TE_IOERR_XXX err
2b280 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
2b290 6e 65 64 20 69 66 20 61 20 63 61 6c 6c 20 74 6f ned if a call to
2b2a0 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 28 29 sqlite3OsOpen()
2b2b0 20 0a 2a 2a 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 .** fails..*/.s
2b2c0 74 61 74 69 63 20 69 6e 74 20 6f 70 65 6e 53 75 tatic int openSu
2b2d0 62 4a 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a bJournal(Pager *
2b2e0 70 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 pPager){. int r
2b2f0 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
2b300 20 69 66 28 20 21 69 73 4f 70 65 6e 28 70 50 61 if( !isOpen(pPa
2b310 67 65 72 2d 3e 73 6a 66 64 29 20 29 7b 0a 20 20 ger->sjfd) ){.
2b320 20 20 63 6f 6e 73 74 20 69 6e 74 20 66 6c 61 67 const int flag
2b330 73 20 3d 20 20 53 51 4c 49 54 45 5f 4f 50 45 4e s = SQLITE_OPEN
2b340 5f 53 55 42 4a 4f 55 52 4e 41 4c 20 7c 20 53 51 _SUBJOURNAL | SQ
2b350 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 LITE_OPEN_READWR
2b360 49 54 45 20 0a 20 20 20 20 20 20 7c 20 53 51 4c ITE . | SQL
2b370 49 54 45 5f 4f 50 45 4e 5f 43 52 45 41 54 45 20 ITE_OPEN_CREATE
2b380 7c 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 45 58 | SQLITE_OPEN_EX
2b390 43 4c 55 53 49 56 45 20 0a 20 20 20 20 20 20 7c CLUSIVE . |
2b3a0 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c SQLITE_OPEN_DEL
2b3b0 45 54 45 4f 4e 43 4c 4f 53 45 3b 0a 20 20 20 20 ETEONCLOSE;.
2b3c0 69 6e 74 20 6e 53 74 6d 74 53 70 69 6c 6c 20 3d int nStmtSpill =
2b3d0 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e 6e sqlite3Config.n
2b3e0 53 74 6d 74 53 70 69 6c 6c 3b 0a 20 20 20 20 69 StmtSpill;. i
2b3f0 66 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e f( pPager->journ
2b400 61 6c 4d 6f 64 65 3d 3d 50 41 47 45 52 5f 4a 4f alMode==PAGER_JO
2b410 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 URNALMODE_MEMORY
2b420 20 7c 7c 20 70 50 61 67 65 72 2d 3e 73 75 62 6a || pPager->subj
2b430 49 6e 4d 65 6d 6f 72 79 20 29 7b 0a 20 20 20 20 InMemory ){.
2b440 20 20 6e 53 74 6d 74 53 70 69 6c 6c 20 3d 20 2d nStmtSpill = -
2b450 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 1;. }. rc
2b460 3d 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c = sqlite3Journal
2b470 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 70 56 66 Open(pPager->pVf
2b480 73 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e 73 6a s, 0, pPager->sj
2b490 66 64 2c 20 66 6c 61 67 73 2c 20 6e 53 74 6d 74 fd, flags, nStmt
2b4a0 53 70 69 6c 6c 29 3b 0a 20 20 7d 0a 20 20 72 65 Spill);. }. re
2b4b0 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a turn rc;.}../*.*
2b4c0 2a 20 41 70 70 65 6e 64 20 61 20 72 65 63 6f 72 * Append a recor
2b4d0 64 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 d of the current
2b4e0 20 73 74 61 74 65 20 6f 66 20 70 61 67 65 20 70 state of page p
2b4f0 50 67 20 74 6f 20 74 68 65 20 73 75 62 2d 6a 6f Pg to the sub-jo
2b500 75 72 6e 61 6c 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 urnal. .**.** If
2b510 20 73 75 63 63 65 73 73 66 75 6c 2c 20 73 65 74 successful, set
2b520 20 74 68 65 20 62 69 74 20 63 6f 72 72 65 73 70 the bit corresp
2b530 6f 6e 64 69 6e 67 20 74 6f 20 70 50 67 2d 3e 70 onding to pPg->p
2b540 67 6e 6f 20 69 6e 20 74 68 65 20 62 69 74 76 65 gno in the bitve
2b550 63 73 0a 2a 2a 20 66 6f 72 20 61 6c 6c 20 6f 70 cs.** for all op
2b560 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 62 65 en savepoints be
2b570 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 2e 0a fore returning..
2b580 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 **.** This funct
2b590 69 6f 6e 20 72 65 74 75 72 6e 73 20 53 51 4c 49 ion returns SQLI
2b5a0 54 45 5f 4f 4b 20 69 66 20 65 76 65 72 79 74 68 TE_OK if everyth
2b5b0 69 6e 67 20 69 73 20 73 75 63 63 65 73 73 66 75 ing is successfu
2b5c0 6c 2c 20 61 6e 20 49 4f 0a 2a 2a 20 65 72 72 6f l, an IO.** erro
2b5d0 72 20 63 6f 64 65 20 69 66 20 74 68 65 20 61 74 r code if the at
2b5e0 74 65 6d 70 74 20 74 6f 20 77 72 69 74 65 20 74 tempt to write t
2b5f0 6f 20 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 o the sub-journa
2b600 6c 20 66 61 69 6c 73 2c 20 6f 72 20 0a 2a 2a 20 l fails, or .**
2b610 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 69 66 20 SQLITE_NOMEM if
2b620 61 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 73 20 77 a malloc fails w
2b630 68 69 6c 65 20 73 65 74 74 69 6e 67 20 61 20 62 hile setting a b
2b640 69 74 20 69 6e 20 61 20 73 61 76 65 70 6f 69 6e it in a savepoin
2b650 74 0a 2a 2a 20 62 69 74 76 65 63 2e 0a 2a 2f 0a t.** bitvec..*/.
2b660 73 74 61 74 69 63 20 69 6e 74 20 73 75 62 6a 6f static int subjo
2b670 75 72 6e 61 6c 50 61 67 65 28 50 67 48 64 72 20 urnalPage(PgHdr
2b680 2a 70 50 67 29 7b 0a 20 20 69 6e 74 20 72 63 20 *pPg){. int rc
2b690 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 = SQLITE_OK;. P
2b6a0 61 67 65 72 20 2a 70 50 61 67 65 72 20 3d 20 70 ager *pPager = p
2b6b0 50 67 2d 3e 70 50 61 67 65 72 3b 0a 20 20 69 66 Pg->pPager;. if
2b6c0 28 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 ( pPager->journa
2b6d0 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a 4f 55 lMode!=PAGER_JOU
2b6e0 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 7b 0a RNALMODE_OFF ){.
2b6f0 0a 20 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 . /* Open the
2b700 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 2c 20 69 66 sub-journal, if
2b710 20 69 74 20 68 61 73 20 6e 6f 74 20 61 6c 72 65 it has not alre
2b720 61 64 79 20 62 65 65 6e 20 6f 70 65 6e 65 64 20 ady been opened
2b730 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 */. assert( p
2b740 50 61 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 Pager->useJourna
2b750 6c 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 l );. assert(
2b760 20 69 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e isOpen(pPager->
2b770 6a 66 64 29 20 7c 7c 20 70 61 67 65 72 55 73 65 jfd) || pagerUse
2b780 57 61 6c 28 70 50 61 67 65 72 29 20 29 3b 0a 20 Wal(pPager) );.
2b790 20 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 assert( isOpe
2b7a0 6e 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 29 20 n(pPager->sjfd)
2b7b0 7c 7c 20 70 50 61 67 65 72 2d 3e 6e 53 75 62 52 || pPager->nSubR
2b7c0 65 63 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 ec==0 );. ass
2b7d0 65 72 74 28 20 70 61 67 65 72 55 73 65 57 61 6c ert( pagerUseWal
2b7e0 28 70 50 61 67 65 72 29 20 0a 20 20 20 20 20 20 (pPager) .
2b7f0 20 20 20 7c 7c 20 70 61 67 65 49 6e 4a 6f 75 72 || pageInJour
2b800 6e 61 6c 28 70 50 61 67 65 72 2c 20 70 50 67 29 nal(pPager, pPg)
2b810 20 0a 20 20 20 20 20 20 20 20 20 7c 7c 20 70 50 . || pP
2b820 67 2d 3e 70 67 6e 6f 3e 70 50 61 67 65 72 2d 3e g->pgno>pPager->
2b830 64 62 4f 72 69 67 53 69 7a 65 20 0a 20 20 20 20 dbOrigSize .
2b840 29 3b 0a 20 20 20 20 72 63 20 3d 20 6f 70 65 6e );. rc = open
2b850 53 75 62 4a 6f 75 72 6e 61 6c 28 70 50 61 67 65 SubJournal(pPage
2b860 72 29 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 r);.. /* If t
2b870 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 77 he sub-journal w
2b880 61 73 20 6f 70 65 6e 65 64 20 73 75 63 63 65 73 as opened succes
2b890 73 66 75 6c 6c 79 20 28 6f 72 20 77 61 73 20 61 sfully (or was a
2b8a0 6c 72 65 61 64 79 20 6f 70 65 6e 29 2c 0a 20 20 lready open),.
2b8b0 20 20 2a 2a 20 77 72 69 74 65 20 74 68 65 20 6a ** write the j
2b8c0 6f 75 72 6e 61 6c 20 72 65 63 6f 72 64 20 69 6e ournal record in
2b8d0 74 6f 20 74 68 65 20 66 69 6c 65 2e 20 20 2a 2f to the file. */
2b8e0 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c . if( rc==SQL
2b8f0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
2b900 76 6f 69 64 20 2a 70 44 61 74 61 20 3d 20 70 50 void *pData = pP
2b910 67 2d 3e 70 44 61 74 61 3b 0a 20 20 20 20 20 20 g->pData;.
2b920 69 36 34 20 6f 66 66 73 65 74 20 3d 20 28 69 36 i64 offset = (i6
2b930 34 29 70 50 61 67 65 72 2d 3e 6e 53 75 62 52 65 4)pPager->nSubRe
2b940 63 2a 28 34 2b 70 50 61 67 65 72 2d 3e 70 61 67 c*(4+pPager->pag
2b950 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 63 68 eSize);. ch
2b960 61 72 20 2a 70 44 61 74 61 32 3b 0a 0a 23 69 66 ar *pData2;..#if
2b970 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f 44 45 SQLITE_HAS_CODE
2b980 43 20 20 20 0a 20 20 20 20 20 20 69 66 28 20 21 C . if( !
2b990 70 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e 4d 65 pPager->subjInMe
2b9a0 6d 6f 72 79 20 29 7b 0a 20 20 20 20 20 20 20 20 mory ){.
2b9b0 43 4f 44 45 43 32 28 70 50 61 67 65 72 2c 20 70 CODEC2(pPager, p
2b9c0 44 61 74 61 2c 20 70 50 67 2d 3e 70 67 6e 6f 2c Data, pPg->pgno,
2b9d0 20 37 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 7, return SQLIT
2b9e0 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 2c 20 70 44 E_NOMEM_BKPT, pD
2b9f0 61 74 61 32 29 3b 0a 20 20 20 20 20 20 7d 65 6c ata2);. }el
2ba00 73 65 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 se.#endif.
2ba10 70 44 61 74 61 32 20 3d 20 70 44 61 74 61 3b 0a pData2 = pData;.
2ba20 20 20 20 20 20 20 50 41 47 45 52 54 52 41 43 45 PAGERTRACE
2ba30 28 28 22 53 54 4d 54 2d 4a 4f 55 52 4e 41 4c 20 (("STMT-JOURNAL
2ba40 25 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 50 %d page %d\n", P
2ba50 41 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 AGERID(pPager),
2ba60 70 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 pPg->pgno));.
2ba70 20 20 20 72 63 20 3d 20 77 72 69 74 65 33 32 62 rc = write32b
2ba80 69 74 73 28 70 50 61 67 65 72 2d 3e 73 6a 66 64 its(pPager->sjfd
2ba90 2c 20 6f 66 66 73 65 74 2c 20 70 50 67 2d 3e 70 , offset, pPg->p
2baa0 67 6e 6f 29 3b 0a 20 20 20 20 20 20 69 66 28 20 gno);. if(
2bab0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
2bac0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
2bad0 6c 69 74 65 33 4f 73 57 72 69 74 65 28 70 50 61 lite3OsWrite(pPa
2bae0 67 65 72 2d 3e 73 6a 66 64 2c 20 70 44 61 74 61 ger->sjfd, pData
2baf0 32 2c 20 70 50 61 67 65 72 2d 3e 70 61 67 65 53 2, pPager->pageS
2bb00 69 7a 65 2c 20 6f 66 66 73 65 74 2b 34 29 3b 0a ize, offset+4);.
2bb10 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
2bb20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 }. if( rc==SQLI
2bb30 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 50 61 TE_OK ){. pPa
2bb40 67 65 72 2d 3e 6e 53 75 62 52 65 63 2b 2b 3b 0a ger->nSubRec++;.
2bb50 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
2bb60 65 72 2d 3e 6e 53 61 76 65 70 6f 69 6e 74 3e 30 er->nSavepoint>0
2bb70 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 61 64 64 );. rc = add
2bb80 54 6f 53 61 76 65 70 6f 69 6e 74 42 69 74 76 65 ToSavepointBitve
2bb90 63 73 28 70 50 61 67 65 72 2c 20 70 50 67 2d 3e cs(pPager, pPg->
2bba0 70 67 6e 6f 29 3b 0a 20 20 7d 0a 20 20 72 65 74 pgno);. }. ret
2bbb0 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 urn rc;.}.static
2bbc0 20 69 6e 74 20 73 75 62 6a 6f 75 72 6e 61 6c 50 int subjournalP
2bbd0 61 67 65 49 66 52 65 71 75 69 72 65 64 28 50 67 ageIfRequired(Pg
2bbe0 48 64 72 20 2a 70 50 67 29 7b 0a 20 20 69 66 28 Hdr *pPg){. if(
2bbf0 20 73 75 62 6a 52 65 71 75 69 72 65 73 50 61 67 subjRequiresPag
2bc00 65 28 70 50 67 29 20 29 7b 0a 20 20 20 20 72 65 e(pPg) ){. re
2bc10 74 75 72 6e 20 73 75 62 6a 6f 75 72 6e 61 6c 50 turn subjournalP
2bc20 61 67 65 28 70 50 67 29 3b 0a 20 20 7d 65 6c 73 age(pPg);. }els
2bc30 65 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 e{. return SQ
2bc40 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 7d 0a 0a LITE_OK;. }.}..
2bc50 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
2bc60 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 79 ion is called by
2bc70 20 74 68 65 20 70 63 61 63 68 65 20 6c 61 79 65 the pcache laye
2bc80 72 20 77 68 65 6e 20 69 74 20 68 61 73 20 72 65 r when it has re
2bc90 61 63 68 65 64 20 73 6f 6d 65 0a 2a 2a 20 73 6f ached some.** so
2bca0 66 74 20 6d 65 6d 6f 72 79 20 6c 69 6d 69 74 2e ft memory limit.
2bcb0 20 54 68 65 20 66 69 72 73 74 20 61 72 67 75 6d The first argum
2bcc0 65 6e 74 20 69 73 20 61 20 70 6f 69 6e 74 65 72 ent is a pointer
2bcd0 20 74 6f 20 61 20 50 61 67 65 72 20 6f 62 6a 65 to a Pager obje
2bce0 63 74 0a 2a 2a 20 28 63 61 73 74 20 61 73 20 61 ct.** (cast as a
2bcf0 20 76 6f 69 64 2a 29 2e 20 54 68 65 20 70 61 67 void*). The pag
2bd00 65 72 20 69 73 20 61 6c 77 61 79 73 20 27 70 75 er is always 'pu
2bd10 72 67 65 61 62 6c 65 27 20 28 6e 6f 74 20 61 6e rgeable' (not an
2bd20 20 69 6e 2d 6d 65 6d 6f 72 79 0a 2a 2a 20 64 61 in-memory.** da
2bd30 74 61 62 61 73 65 29 2e 20 54 68 65 20 73 65 63 tabase). The sec
2bd40 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 ond argument is
2bd50 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 a reference to a
2bd60 20 70 61 67 65 20 74 68 61 74 20 69 73 20 0a 2a page that is .*
2bd70 2a 20 63 75 72 72 65 6e 74 6c 79 20 64 69 72 74 * currently dirt
2bd80 79 20 62 75 74 20 68 61 73 20 6e 6f 20 6f 75 74 y but has no out
2bd90 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e standing referen
2bda0 63 65 73 2e 20 54 68 65 20 70 61 67 65 0a 2a 2a ces. The page.**
2bdb0 20 69 73 20 61 6c 77 61 79 73 20 61 73 73 6f 63 is always assoc
2bdc0 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20 50 iated with the P
2bdd0 61 67 65 72 20 6f 62 6a 65 63 74 20 70 61 73 73 ager object pass
2bde0 65 64 20 61 73 20 74 68 65 20 66 69 72 73 74 20 ed as the first
2bdf0 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a .** argument..**
2be00 0a 2a 2a 20 54 68 65 20 6a 6f 62 20 6f 66 20 74 .** The job of t
2be10 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
2be20 74 6f 20 6d 61 6b 65 20 70 50 67 20 63 6c 65 61 to make pPg clea
2be30 6e 20 62 79 20 77 72 69 74 69 6e 67 20 69 74 73 n by writing its
2be40 20 63 6f 6e 74 65 6e 74 73 0a 2a 2a 20 6f 75 74 contents.** out
2be50 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 to the database
2be60 20 66 69 6c 65 2c 20 69 66 20 70 6f 73 73 69 62 file, if possib
2be70 6c 65 2e 20 54 68 69 73 20 6d 61 79 20 69 6e 76 le. This may inv
2be80 6f 6c 76 65 20 73 79 6e 63 69 6e 67 20 74 68 65 olve syncing the
2be90 0a 2a 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 .** journal file
2bea0 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 . .**.** If succ
2beb0 65 73 73 66 75 6c 2c 20 73 71 6c 69 74 65 33 50 essful, sqlite3P
2bec0 63 61 63 68 65 4d 61 6b 65 43 6c 65 61 6e 28 29 cacheMakeClean()
2bed0 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 is called on th
2bee0 65 20 70 61 67 65 20 61 6e 64 0a 2a 2a 20 53 51 e page and.** SQ
2bef0 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
2bf00 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 . If an IO error
2bf10 20 6f 63 63 75 72 73 20 77 68 69 6c 65 20 74 72 occurs while tr
2bf20 79 69 6e 67 20 74 6f 20 6d 61 6b 65 20 74 68 65 ying to make the
2bf30 0a 2a 2a 20 70 61 67 65 20 63 6c 65 61 6e 2c 20 .** page clean,
2bf40 74 68 65 20 49 4f 20 65 72 72 6f 72 20 63 6f 64 the IO error cod
2bf50 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 49 e is returned. I
2bf60 66 20 74 68 65 20 70 61 67 65 20 63 61 6e 6e 6f f the page canno
2bf70 74 20 62 65 0a 2a 2a 20 6d 61 64 65 20 63 6c 65 t be.** made cle
2bf80 61 6e 20 66 6f 72 20 73 6f 6d 65 20 6f 74 68 65 an for some othe
2bf90 72 20 72 65 61 73 6f 6e 2c 20 62 75 74 20 6e 6f r reason, but no
2bfa0 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 74 error occurs, t
2bfb0 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4b 0a 2a 2a hen SQLITE_OK.**
2bfc0 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 is returned by
2bfd0 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 6b sqlite3PcacheMak
2bfe0 65 43 6c 65 61 6e 28 29 20 69 73 20 6e 6f 74 20 eClean() is not
2bff0 63 61 6c 6c 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 called..*/.stati
2c000 63 20 69 6e 74 20 70 61 67 65 72 53 74 72 65 73 c int pagerStres
2c010 73 28 76 6f 69 64 20 2a 70 2c 20 50 67 48 64 72 s(void *p, PgHdr
2c020 20 2a 70 50 67 29 7b 0a 20 20 50 61 67 65 72 20 *pPg){. Pager
2c030 2a 70 50 61 67 65 72 20 3d 20 28 50 61 67 65 72 *pPager = (Pager
2c040 20 2a 29 70 3b 0a 20 20 69 6e 74 20 72 63 20 3d *)p;. int rc =
2c050 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 SQLITE_OK;.. a
2c060 73 73 65 72 74 28 20 70 50 67 2d 3e 70 50 61 67 ssert( pPg->pPag
2c070 65 72 3d 3d 70 50 61 67 65 72 20 29 3b 0a 20 20 er==pPager );.
2c080 61 73 73 65 72 74 28 20 70 50 67 2d 3e 66 6c 61 assert( pPg->fla
2c090 67 73 26 50 47 48 44 52 5f 44 49 52 54 59 20 29 gs&PGHDR_DIRTY )
2c0a0 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 64 6f 4e 6f ;.. /* The doNo
2c0b0 74 53 70 69 6c 6c 20 4e 4f 53 59 4e 43 20 62 69 tSpill NOSYNC bi
2c0c0 74 20 69 73 20 73 65 74 20 64 75 72 69 6e 67 20 t is set during
2c0d0 74 69 6d 65 73 20 77 68 65 6e 20 64 6f 69 6e 67 times when doing
2c0e0 20 61 20 73 79 6e 63 20 6f 66 0a 20 20 2a 2a 20 a sync of. **
2c0f0 6a 6f 75 72 6e 61 6c 20 28 61 6e 64 20 61 64 64 journal (and add
2c100 69 6e 67 20 61 20 6e 65 77 20 68 65 61 64 65 72 ing a new header
2c110 29 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 ) is not allowed
2c120 2e 20 20 54 68 69 73 20 6f 63 63 75 72 73 0a 20 . This occurs.
2c130 20 2a 2a 20 64 75 72 69 6e 67 20 63 61 6c 6c 73 ** during calls
2c140 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
2c150 57 72 69 74 65 28 29 20 77 68 69 6c 65 20 74 72 Write() while tr
2c160 79 69 6e 67 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 ying to journal
2c170 6d 75 6c 74 69 70 6c 65 0a 20 20 2a 2a 20 70 61 multiple. ** pa
2c180 67 65 73 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f ges belonging to
2c190 20 74 68 65 20 73 61 6d 65 20 73 65 63 74 6f 72 the same sector
2c1a0 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 .. **. ** The
2c1b0 64 6f 4e 6f 74 53 70 69 6c 6c 20 52 4f 4c 4c 42 doNotSpill ROLLB
2c1c0 41 43 4b 20 61 6e 64 20 4f 46 46 20 62 69 74 73 ACK and OFF bits
2c1d0 20 69 6e 68 69 62 69 74 73 20 61 6c 6c 20 63 61 inhibits all ca
2c1e0 63 68 65 20 73 70 69 6c 6c 69 6e 67 0a 20 20 2a che spilling. *
2c1f0 2a 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 * regardless of
2c200 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 whether or not a
2c210 20 73 79 6e 63 20 69 73 20 72 65 71 75 69 72 65 sync is require
2c220 64 2e 20 20 54 68 69 73 20 69 73 20 73 65 74 20 d. This is set
2c230 64 75 72 69 6e 67 0a 20 20 2a 2a 20 61 20 72 6f during. ** a ro
2c240 6c 6c 62 61 63 6b 20 6f 72 20 62 79 20 75 73 65 llback or by use
2c250 72 20 72 65 71 75 65 73 74 2c 20 72 65 73 70 65 r request, respe
2c260 63 74 69 76 65 6c 79 2e 0a 20 20 2a 2a 0a 20 20 ctively.. **.
2c270 2a 2a 20 53 70 69 6c 6c 69 6e 67 20 69 73 20 61 ** Spilling is a
2c280 6c 73 6f 20 70 72 6f 68 69 62 69 74 65 64 20 77 lso prohibited w
2c290 68 65 6e 20 69 6e 20 61 6e 20 65 72 72 6f 72 20 hen in an error
2c2a0 73 74 61 74 65 20 73 69 6e 63 65 20 74 68 61 74 state since that
2c2b0 20 63 6f 75 6c 64 0a 20 20 2a 2a 20 6c 65 61 64 could. ** lead
2c2c0 20 74 6f 20 64 61 74 61 62 61 73 65 20 63 6f 72 to database cor
2c2d0 72 75 70 74 69 6f 6e 2e 20 20 20 49 6e 20 74 68 ruption. In th
2c2e0 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d e current implem
2c2f0 65 6e 74 61 74 69 6f 6e 20 69 74 20 0a 20 20 2a entation it . *
2c300 2a 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 * is impossible
2c310 66 6f 72 20 73 71 6c 69 74 65 33 50 63 61 63 68 for sqlite3Pcach
2c320 65 46 65 74 63 68 28 29 20 74 6f 20 62 65 20 63 eFetch() to be c
2c330 61 6c 6c 65 64 20 77 69 74 68 20 63 72 65 61 74 alled with creat
2c340 65 46 6c 61 67 3d 3d 33 0a 20 20 2a 2a 20 77 68 eFlag==3. ** wh
2c350 69 6c 65 20 69 6e 20 74 68 65 20 65 72 72 6f 72 ile in the error
2c360 20 73 74 61 74 65 2c 20 68 65 6e 63 65 20 69 74 state, hence it
2c370 20 69 73 20 69 6d 70 6f 73 73 69 62 6c 65 20 66 is impossible f
2c380 6f 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 or this routine
2c390 74 6f 0a 20 20 2a 2a 20 62 65 20 63 61 6c 6c 65 to. ** be calle
2c3a0 64 20 69 6e 20 74 68 65 20 65 72 72 6f 72 20 73 d in the error s
2c3b0 74 61 74 65 2e 20 20 4e 65 76 65 72 74 68 65 6c tate. Neverthel
2c3c0 65 73 73 2c 20 77 65 20 69 6e 63 6c 75 64 65 20 ess, we include
2c3d0 61 20 4e 45 56 45 52 28 29 0a 20 20 2a 2a 20 74 a NEVER(). ** t
2c3e0 65 73 74 20 66 6f 72 20 74 68 65 20 65 72 72 6f est for the erro
2c3f0 72 20 73 74 61 74 65 20 61 73 20 61 20 73 61 66 r state as a saf
2c400 65 67 75 61 72 64 20 61 67 61 69 6e 73 74 20 66 eguard against f
2c410 75 74 75 72 65 20 63 68 61 6e 67 65 73 2e 0a 20 uture changes..
2c420 20 2a 2f 0a 20 20 69 66 28 20 4e 45 56 45 52 28 */. if( NEVER(
2c430 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 29 pPager->errCode)
2c440 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
2c450 5f 4f 4b 3b 0a 20 20 74 65 73 74 63 61 73 65 28 _OK;. testcase(
2c460 20 70 50 61 67 65 72 2d 3e 64 6f 4e 6f 74 53 70 pPager->doNotSp
2c470 69 6c 6c 20 26 20 53 50 49 4c 4c 46 4c 41 47 5f ill & SPILLFLAG_
2c480 52 4f 4c 4c 42 41 43 4b 20 29 3b 0a 20 20 74 65 ROLLBACK );. te
2c490 73 74 63 61 73 65 28 20 70 50 61 67 65 72 2d 3e stcase( pPager->
2c4a0 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 50 49 doNotSpill & SPI
2c4b0 4c 4c 46 4c 41 47 5f 4f 46 46 20 29 3b 0a 20 20 LLFLAG_OFF );.
2c4c0 74 65 73 74 63 61 73 65 28 20 70 50 61 67 65 72 testcase( pPager
2c4d0 2d 3e 64 6f 4e 6f 74 53 70 69 6c 6c 20 26 20 53 ->doNotSpill & S
2c4e0 50 49 4c 4c 46 4c 41 47 5f 4e 4f 53 59 4e 43 20 PILLFLAG_NOSYNC
2c4f0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d );. if( pPager-
2c500 3e 64 6f 4e 6f 74 53 70 69 6c 6c 0a 20 20 20 26 >doNotSpill. &
2c510 26 20 28 28 70 50 61 67 65 72 2d 3e 64 6f 4e 6f & ((pPager->doNo
2c520 74 53 70 69 6c 6c 20 26 20 28 53 50 49 4c 4c 46 tSpill & (SPILLF
2c530 4c 41 47 5f 52 4f 4c 4c 42 41 43 4b 7c 53 50 49 LAG_ROLLBACK|SPI
2c540 4c 4c 46 4c 41 47 5f 4f 46 46 29 29 21 3d 30 0a LLFLAG_OFF))!=0.
2c550 20 20 20 20 20 20 7c 7c 20 28 70 50 67 2d 3e 66 || (pPg->f
2c560 6c 61 67 73 20 26 20 50 47 48 44 52 5f 4e 45 45 lags & PGHDR_NEE
2c570 44 5f 53 59 4e 43 29 21 3d 30 29 0a 20 20 29 7b D_SYNC)!=0). ){
2c580 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
2c590 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 70 50 TE_OK;. }.. pP
2c5a0 67 2d 3e 70 44 69 72 74 79 20 3d 20 30 3b 0a 20 g->pDirty = 0;.
2c5b0 20 69 66 28 20 70 61 67 65 72 55 73 65 57 61 6c if( pagerUseWal
2c5c0 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 20 20 (pPager) ){.
2c5d0 2f 2a 20 57 72 69 74 65 20 61 20 73 69 6e 67 6c /* Write a singl
2c5e0 65 20 66 72 61 6d 65 20 66 6f 72 20 74 68 69 73 e frame for this
2c5f0 20 70 61 67 65 20 74 6f 20 74 68 65 20 6c 6f 67 page to the log
2c600 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 75 . */. rc = su
2c610 62 6a 6f 75 72 6e 61 6c 50 61 67 65 49 66 52 65 bjournalPageIfRe
2c620 71 75 69 72 65 64 28 70 50 67 29 3b 20 0a 20 20 quired(pPg); .
2c630 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2c640 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 72 63 20 _OK ){. rc
2c650 3d 20 70 61 67 65 72 57 61 6c 46 72 61 6d 65 73 = pagerWalFrames
2c660 28 70 50 61 67 65 72 2c 20 70 50 67 2c 20 30 2c (pPager, pPg, 0,
2c670 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 0);. }. }el
2c680 73 65 7b 0a 20 20 20 20 0a 23 69 66 64 65 66 20 se{. .#ifdef
2c690 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 SQLITE_ENABLE_BA
2c6a0 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 TCH_ATOMIC_WRITE
2c6b0 0a 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d . if( pPager-
2c6c0 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 29 7b 0a >tempFile==0 ){.
2c6d0 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 rc = sqlit
2c6e0 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 e3JournalCreate(
2c6f0 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 pPager->jfd);.
2c700 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
2c710 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 70 TE_OK ) return p
2c720 61 67 65 72 5f 65 72 72 6f 72 28 70 50 61 67 65 ager_error(pPage
2c730 72 2c 20 72 63 29 3b 0a 20 20 20 20 7d 0a 23 65 r, rc);. }.#e
2c740 6e 64 69 66 0a 20 20 0a 20 20 20 20 2f 2a 20 53 ndif. . /* S
2c750 79 6e 63 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ync the journal
2c760 66 69 6c 65 20 69 66 20 72 65 71 75 69 72 65 64 file if required
2c770 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 67 . */. if( pPg
2c780 2d 3e 66 6c 61 67 73 26 50 47 48 44 52 5f 4e 45 ->flags&PGHDR_NE
2c790 45 44 5f 53 59 4e 43 20 0a 20 20 20 20 20 7c 7c ED_SYNC . ||
2c7a0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3d pPager->eState=
2c7b0 3d 50 41 47 45 52 5f 57 52 49 54 45 52 5f 43 41 =PAGER_WRITER_CA
2c7c0 43 48 45 4d 4f 44 0a 20 20 20 20 29 7b 0a 20 20 CHEMOD. ){.
2c7d0 20 20 20 20 72 63 20 3d 20 73 79 6e 63 4a 6f 75 rc = syncJou
2c7e0 72 6e 61 6c 28 70 50 61 67 65 72 2c 20 31 29 3b rnal(pPager, 1);
2c7f0 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a . }. . /*
2c800 20 57 72 69 74 65 20 74 68 65 20 63 6f 6e 74 65 Write the conte
2c810 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 20 nts of the page
2c820 6f 75 74 20 74 6f 20 74 68 65 20 64 61 74 61 62 out to the datab
2c830 61 73 65 20 66 69 6c 65 2e 20 2a 2f 0a 20 20 20 ase file. */.
2c840 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2c850 4f 4b 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 OK ){. asse
2c860 72 74 28 20 28 70 50 67 2d 3e 66 6c 61 67 73 26 rt( (pPg->flags&
2c870 50 47 48 44 52 5f 4e 45 45 44 5f 53 59 4e 43 29 PGHDR_NEED_SYNC)
2c880 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 72 63 20 ==0 );. rc
2c890 3d 20 70 61 67 65 72 5f 77 72 69 74 65 5f 70 61 = pager_write_pa
2c8a0 67 65 6c 69 73 74 28 70 50 61 67 65 72 2c 20 70 gelist(pPager, p
2c8b0 50 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a Pg);. }. }..
2c8c0 20 20 2f 2a 20 4d 61 72 6b 20 74 68 65 20 70 61 /* Mark the pa
2c8d0 67 65 20 61 73 20 63 6c 65 61 6e 2e 20 2a 2f 0a ge as clean. */.
2c8e0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2c8f0 5f 4f 4b 20 29 7b 0a 20 20 20 20 50 41 47 45 52 _OK ){. PAGER
2c900 54 52 41 43 45 28 28 22 53 54 52 45 53 53 20 25 TRACE(("STRESS %
2c910 64 20 70 61 67 65 20 25 64 5c 6e 22 2c 20 50 41 d page %d\n", PA
2c920 47 45 52 49 44 28 70 50 61 67 65 72 29 2c 20 70 GERID(pPager), p
2c930 50 67 2d 3e 70 67 6e 6f 29 29 3b 0a 20 20 20 20 Pg->pgno));.
2c940 73 71 6c 69 74 65 33 50 63 61 63 68 65 4d 61 6b sqlite3PcacheMak
2c950 65 43 6c 65 61 6e 28 70 50 67 29 3b 0a 20 20 7d eClean(pPg);. }
2c960 0a 0a 20 20 72 65 74 75 72 6e 20 70 61 67 65 72 .. return pager
2c970 5f 65 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 _error(pPager, r
2c980 63 29 3b 20 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 6c c); .}../*.** Fl
2c990 75 73 68 20 61 6c 6c 20 75 6e 72 65 66 65 72 65 ush all unrefere
2c9a0 6e 63 65 64 20 64 69 72 74 79 20 70 61 67 65 73 nced dirty pages
2c9b0 20 74 6f 20 64 69 73 6b 2e 0a 2a 2f 0a 69 6e 74 to disk..*/.int
2c9c0 20 73 71 6c 69 74 65 33 50 61 67 65 72 46 6c 75 sqlite3PagerFlu
2c9d0 73 68 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 sh(Pager *pPager
2c9e0 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 70 50 ){. int rc = pP
2c9f0 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 ager->errCode;.
2ca00 20 69 66 28 20 21 4d 45 4d 44 42 20 29 7b 0a 20 if( !MEMDB ){.
2ca10 20 20 20 50 67 48 64 72 20 2a 70 4c 69 73 74 20 PgHdr *pList
2ca20 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 44 = sqlite3PcacheD
2ca30 69 72 74 79 4c 69 73 74 28 70 50 61 67 65 72 2d irtyList(pPager-
2ca40 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 20 20 61 >pPCache);. a
2ca50 73 73 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 ssert( assert_pa
2ca60 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 ger_state(pPager
2ca70 29 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 ) );. while(
2ca80 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
2ca90 20 70 4c 69 73 74 20 29 7b 0a 20 20 20 20 20 20 pList ){.
2caa0 50 67 48 64 72 20 2a 70 4e 65 78 74 20 3d 20 70 PgHdr *pNext = p
2cab0 4c 69 73 74 2d 3e 70 44 69 72 74 79 3b 0a 20 20 List->pDirty;.
2cac0 20 20 20 20 69 66 28 20 70 4c 69 73 74 2d 3e 6e if( pList->n
2cad0 52 65 66 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 Ref==0 ){.
2cae0 20 20 72 63 20 3d 20 70 61 67 65 72 53 74 72 65 rc = pagerStre
2caf0 73 73 28 28 76 6f 69 64 2a 29 70 50 61 67 65 72 ss((void*)pPager
2cb00 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 20 20 20 , pList);.
2cb10 7d 0a 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 }. pList =
2cb20 70 4e 65 78 74 3b 0a 20 20 20 20 7d 0a 20 20 7d pNext;. }. }
2cb30 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
2cb40 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 61 74 65 ../*.** Allocate
2cb50 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65 20 and initialize
2cb60 61 20 6e 65 77 20 50 61 67 65 72 20 6f 62 6a 65 a new Pager obje
2cb70 63 74 20 61 6e 64 20 70 75 74 20 61 20 70 6f 69 ct and put a poi
2cb80 6e 74 65 72 20 74 6f 20 69 74 0a 2a 2a 20 69 6e nter to it.** in
2cb90 20 2a 70 70 50 61 67 65 72 2e 20 54 68 65 20 70 *ppPager. The p
2cba0 61 67 65 72 20 73 68 6f 75 6c 64 20 65 76 65 6e ager should even
2cbb0 74 75 61 6c 6c 79 20 62 65 20 66 72 65 65 64 20 tually be freed
2cbc0 62 79 20 70 61 73 73 69 6e 67 20 69 74 0a 2a 2a by passing it.**
2cbd0 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 65 72 to sqlite3Pager
2cbe0 43 6c 6f 73 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 Close()..**.** T
2cbf0 68 65 20 7a 46 69 6c 65 6e 61 6d 65 20 61 72 67 he zFilename arg
2cc00 75 6d 65 6e 74 20 69 73 20 74 68 65 20 70 61 74 ument is the pat
2cc10 68 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 h to the databas
2cc20 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e 2e 0a e file to open..
2cc30 2a 2a 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 20 ** If zFilename
2cc40 69 73 20 4e 55 4c 4c 20 74 68 65 6e 20 61 20 72 is NULL then a r
2cc50 61 6e 64 6f 6d 6c 79 2d 6e 61 6d 65 64 20 74 65 andomly-named te
2cc60 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20 mporary file is
2cc70 63 72 65 61 74 65 64 0a 2a 2a 20 61 6e 64 20 75 created.** and u
2cc80 73 65 64 20 61 73 20 74 68 65 20 66 69 6c 65 20 sed as the file
2cc90 74 6f 20 62 65 20 63 61 63 68 65 64 2e 20 54 65 to be cached. Te
2cca0 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 20 61 72 mporary files ar
2ccb0 65 20 62 65 20 64 65 6c 65 74 65 64 0a 2a 2a 20 e be deleted.**
2ccc0 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 automatically wh
2ccd0 65 6e 20 74 68 65 79 20 61 72 65 20 63 6c 6f 73 en they are clos
2cce0 65 64 2e 20 49 66 20 7a 46 69 6c 65 6e 61 6d 65 ed. If zFilename
2ccf0 20 69 73 20 22 3a 6d 65 6d 6f 72 79 3a 22 20 74 is ":memory:" t
2cd00 68 65 6e 20 0a 2a 2a 20 61 6c 6c 20 69 6e 66 6f hen .** all info
2cd10 72 6d 61 74 69 6f 6e 20 69 73 20 68 65 6c 64 20 rmation is held
2cd20 69 6e 20 63 61 63 68 65 2e 20 49 74 20 69 73 20 in cache. It is
2cd30 6e 65 76 65 72 20 77 72 69 74 74 65 6e 20 74 6f never written to
2cd40 20 64 69 73 6b 2e 20 0a 2a 2a 20 54 68 69 73 20 disk. .** This
2cd50 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 69 can be used to i
2cd60 6d 70 6c 65 6d 65 6e 74 20 61 6e 20 69 6e 2d 6d mplement an in-m
2cd70 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e 0a emory database..
2cd80 2a 2a 0a 2a 2a 20 54 68 65 20 6e 45 78 74 72 61 **.** The nExtra
2cd90 20 70 61 72 61 6d 65 74 65 72 20 73 70 65 63 69 parameter speci
2cda0 66 69 65 73 20 74 68 65 20 6e 75 6d 62 65 72 20 fies the number
2cdb0 6f 66 20 62 79 74 65 73 20 6f 66 20 73 70 61 63 of bytes of spac
2cdc0 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 61 e allocated.** a
2cdd0 6c 6f 6e 67 20 77 69 74 68 20 65 61 63 68 20 70 long with each p
2cde0 61 67 65 20 72 65 66 65 72 65 6e 63 65 2e 20 54 age reference. T
2cdf0 68 69 73 20 73 70 61 63 65 20 69 73 20 61 76 61 his space is ava
2ce00 69 6c 61 62 6c 65 20 74 6f 20 74 68 65 20 75 73 ilable to the us
2ce10 65 72 0a 2a 2a 20 76 69 61 20 74 68 65 20 73 71 er.** via the sq
2ce20 6c 69 74 65 33 50 61 67 65 72 47 65 74 45 78 74 lite3PagerGetExt
2ce30 72 61 28 29 20 41 50 49 2e 20 20 57 68 65 6e 20 ra() API. When
2ce40 61 20 6e 65 77 20 70 61 67 65 20 69 73 20 61 6c a new page is al
2ce50 6c 6f 63 61 74 65 64 2c 20 74 68 65 0a 2a 2a 20 located, the.**
2ce60 66 69 72 73 74 20 38 20 62 79 74 65 73 20 6f 66 first 8 bytes of
2ce70 20 74 68 69 73 20 73 70 61 63 65 20 61 72 65 20 this space are
2ce80 7a 65 72 6f 65 64 20 62 75 74 20 74 68 65 20 72 zeroed but the r
2ce90 65 6d 61 69 6e 64 65 72 20 69 73 20 75 6e 69 6e emainder is unin
2cea0 69 74 69 61 6c 69 7a 65 64 2e 0a 2a 2a 20 28 54 itialized..** (T
2ceb0 68 65 20 65 78 74 72 61 20 73 70 61 63 65 20 69 he extra space i
2cec0 73 20 75 73 65 64 20 62 79 20 62 74 72 65 65 20 s used by btree
2ced0 61 73 20 74 68 65 20 4d 65 6d 50 61 67 65 20 6f as the MemPage o
2cee0 62 6a 65 63 74 2e 29 0a 2a 2a 0a 2a 2a 20 54 68 bject.).**.** Th
2cef0 65 20 66 6c 61 67 73 20 61 72 67 75 6d 65 6e 74 e flags argument
2cf00 20 69 73 20 75 73 65 64 20 74 6f 20 73 70 65 63 is used to spec
2cf10 69 66 79 20 70 72 6f 70 65 72 74 69 65 73 20 74 ify properties t
2cf20 68 61 74 20 61 66 66 65 63 74 20 74 68 65 0a 2a hat affect the.*
2cf30 2a 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 74 * operation of t
2cf40 68 65 20 70 61 67 65 72 2e 20 49 74 20 73 68 6f he pager. It sho
2cf50 75 6c 64 20 62 65 20 70 61 73 73 65 64 20 73 6f uld be passed so
2cf60 6d 65 20 62 69 74 77 69 73 65 20 63 6f 6d 62 69 me bitwise combi
2cf70 6e 61 74 69 6f 6e 0a 2a 2a 20 6f 66 20 74 68 65 nation.** of the
2cf80 20 50 41 47 45 52 5f 2a 20 66 6c 61 67 73 2e 0a PAGER_* flags..
2cf90 2a 2a 0a 2a 2a 20 54 68 65 20 76 66 73 46 6c 61 **.** The vfsFla
2cfa0 67 73 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 gs parameter is
2cfb0 61 20 62 69 74 6d 61 73 6b 20 74 6f 20 70 61 73 a bitmask to pas
2cfc0 73 20 74 6f 20 74 68 65 20 66 6c 61 67 73 20 70 s to the flags p
2cfd0 61 72 61 6d 65 74 65 72 0a 2a 2a 20 6f 66 20 74 arameter.** of t
2cfe0 68 65 20 78 4f 70 65 6e 28 29 20 6d 65 74 68 6f he xOpen() metho
2cff0 64 20 6f 66 20 74 68 65 20 73 75 70 70 6c 69 65 d of the supplie
2d000 64 20 56 46 53 20 77 68 65 6e 20 6f 70 65 6e 69 d VFS when openi
2d010 6e 67 20 66 69 6c 65 73 2e 20 0a 2a 2a 0a 2a 2a ng files. .**.**
2d020 20 49 66 20 74 68 65 20 70 61 67 65 72 20 6f 62 If the pager ob
2d030 6a 65 63 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 ject is allocate
2d040 64 20 61 6e 64 20 74 68 65 20 73 70 65 63 69 66 d and the specif
2d050 69 65 64 20 66 69 6c 65 20 6f 70 65 6e 65 64 20 ied file opened
2d060 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 6c 79 .** successfully
2d070 2c 20 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 , SQLITE_OK is r
2d080 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70 70 50 eturned and *ppP
2d090 61 67 65 72 20 73 65 74 20 74 6f 20 70 6f 69 6e ager set to poin
2d0a0 74 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 65 77 20 t to.** the new
2d0b0 70 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 49 66 pager object. If
2d0c0 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
2d0d0 2c 20 2a 70 70 50 61 67 65 72 20 69 73 20 73 65 , *ppPager is se
2d0e0 74 20 74 6f 20 4e 55 4c 4c 0a 2a 2a 20 61 6e 64 t to NULL.** and
2d0f0 20 65 72 72 6f 72 20 63 6f 64 65 20 72 65 74 75 error code retu
2d100 72 6e 65 64 2e 20 54 68 69 73 20 66 75 6e 63 74 rned. This funct
2d110 69 6f 6e 20 6d 61 79 20 72 65 74 75 72 6e 20 53 ion may return S
2d120 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 2a 2a 20 28 QLITE_NOMEM.** (
2d130 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 29 20 sqlite3Malloc()
2d140 69 73 20 75 73 65 64 20 74 6f 20 61 6c 6c 6f 63 is used to alloc
2d150 61 74 65 20 6d 65 6d 6f 72 79 29 2c 20 53 51 4c ate memory), SQL
2d160 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 6f 72 20 ITE_CANTOPEN or
2d170 0a 2a 2a 20 76 61 72 69 6f 75 73 20 53 51 4c 49 .** various SQLI
2d180 54 45 5f 49 4f 5f 58 58 58 20 65 72 72 6f 72 73 TE_IO_XXX errors
2d190 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
2d1a0 50 61 67 65 72 4f 70 65 6e 28 0a 20 20 73 71 6c PagerOpen(. sql
2d1b0 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 2c 20 ite3_vfs *pVfs,
2d1c0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 76 69 72 /* The vir
2d1d0 74 75 61 6c 20 66 69 6c 65 20 73 79 73 74 65 6d tual file system
2d1e0 20 74 6f 20 75 73 65 20 2a 2f 0a 20 20 50 61 67 to use */. Pag
2d1f0 65 72 20 2a 2a 70 70 50 61 67 65 72 2c 20 20 20 er **ppPager,
2d200 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 52 65 /* OUT: Re
2d210 74 75 72 6e 20 74 68 65 20 50 61 67 65 72 20 73 turn the Pager s
2d220 74 72 75 63 74 75 72 65 20 68 65 72 65 20 2a 2f tructure here */
2d230 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
2d240 46 69 6c 65 6e 61 6d 65 2c 20 20 20 2f 2a 20 4e Filename, /* N
2d250 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62 ame of the datab
2d260 61 73 65 20 66 69 6c 65 20 74 6f 20 6f 70 65 6e ase file to open
2d270 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 72 61 */. int nExtra
2d280 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
2d290 2a 20 45 78 74 72 61 20 62 79 74 65 73 20 61 70 * Extra bytes ap
2d2a0 70 65 6e 64 20 74 6f 20 65 61 63 68 20 69 6e 2d pend to each in-
2d2b0 6d 65 6d 6f 72 79 20 70 61 67 65 20 2a 2f 0a 20 memory page */.
2d2c0 20 69 6e 74 20 66 6c 61 67 73 2c 20 20 20 20 20 int flags,
2d2d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 /* fla
2d2e0 67 73 20 63 6f 6e 74 72 6f 6c 6c 69 6e 67 20 74 gs controlling t
2d2f0 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e his file */. in
2d300 74 20 76 66 73 46 6c 61 67 73 2c 20 20 20 20 20 t vfsFlags,
2d310 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 67 73 20 /* flags
2d320 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 20 74 passed through t
2d330 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f o sqlite3_vfs.xO
2d340 70 65 6e 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 pen() */. void
2d350 28 2a 78 52 65 69 6e 69 74 29 28 44 62 50 61 67 (*xReinit)(DbPag
2d360 65 2a 29 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 e*) /* Function
2d370 74 6f 20 72 65 69 6e 69 74 69 61 6c 69 7a 65 20 to reinitialize
2d380 70 61 67 65 73 20 2a 2f 0a 29 7b 0a 20 20 75 38 pages */.){. u8
2d390 20 2a 70 50 74 72 3b 0a 20 20 50 61 67 65 72 20 *pPtr;. Pager
2d3a0 2a 70 50 61 67 65 72 20 3d 20 30 3b 20 20 20 20 *pPager = 0;
2d3b0 20 20 20 2f 2a 20 50 61 67 65 72 20 6f 62 6a 65 /* Pager obje
2d3c0 63 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 ct to allocate a
2d3d0 6e 64 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 69 nd return */. i
2d3e0 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
2d3f0 4b 3b 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 K; /* Retur
2d400 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 n code */. int
2d410 74 65 6d 70 46 69 6c 65 20 3d 20 30 3b 20 20 20 tempFile = 0;
2d420 20 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 /* True for
2d430 20 74 65 6d 70 20 66 69 6c 65 73 20 28 69 6e 63 temp files (inc
2d440 6c 2e 20 69 6e 2d 6d 65 6d 6f 72 79 20 66 69 6c l. in-memory fil
2d450 65 73 29 20 2a 2f 0a 20 20 69 6e 74 20 6d 65 6d es) */. int mem
2d460 44 62 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 Db = 0;
2d470 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 69 /* True if thi
2d480 73 20 69 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 s is an in-memor
2d490 79 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 y file */. int
2d4a0 72 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 20 20 20 readOnly = 0;
2d4b0 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
2d4c0 74 68 69 73 20 69 73 20 61 20 72 65 61 64 2d 6f this is a read-o
2d4d0 6e 6c 79 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e nly file */. in
2d4e0 74 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a t journalFileSiz
2d4f0 65 3b 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 e; /* Bytes
2d500 74 6f 20 61 6c 6c 6f 63 61 74 65 20 66 6f 72 20 to allocate for
2d510 65 61 63 68 20 6a 6f 75 72 6e 61 6c 20 66 64 20 each journal fd
2d520 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 50 61 74 68 */. char *zPath
2d530 6e 61 6d 65 20 3d 20 30 3b 20 20 20 20 20 2f 2a name = 0; /*
2d540 20 46 75 6c 6c 20 70 61 74 68 20 74 6f 20 64 61 Full path to da
2d550 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
2d560 20 69 6e 74 20 6e 50 61 74 68 6e 61 6d 65 20 3d int nPathname =
2d570 20 30 3b 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 0; /* Num
2d580 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
2d590 7a 50 61 74 68 6e 61 6d 65 20 2a 2f 0a 20 20 69 zPathname */. i
2d5a0 6e 74 20 75 73 65 4a 6f 75 72 6e 61 6c 20 3d 20 nt useJournal =
2d5b0 28 66 6c 61 67 73 20 26 20 50 41 47 45 52 5f 4f (flags & PAGER_O
2d5c0 4d 49 54 5f 4a 4f 55 52 4e 41 4c 29 3d 3d 30 3b MIT_JOURNAL)==0;
2d5d0 20 2f 2a 20 46 61 6c 73 65 20 74 6f 20 6f 6d 69 /* False to omi
2d5e0 74 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 69 t journal */. i
2d5f0 6e 74 20 70 63 61 63 68 65 53 69 7a 65 20 3d 20 nt pcacheSize =
2d600 73 71 6c 69 74 65 33 50 63 61 63 68 65 53 69 7a sqlite3PcacheSiz
2d610 65 28 29 3b 20 20 20 20 20 20 20 2f 2a 20 42 79 e(); /* By
2d620 74 65 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 tes to allocate
2d630 66 6f 72 20 50 43 61 63 68 65 20 2a 2f 0a 20 20 for PCache */.
2d640 75 33 32 20 73 7a 50 61 67 65 44 66 6c 74 20 3d u32 szPageDflt =
2d650 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
2d660 50 41 47 45 5f 53 49 5a 45 3b 20 20 2f 2a 20 44 PAGE_SIZE; /* D
2d670 65 66 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65 efault page size
2d680 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
2d690 20 2a 7a 55 72 69 20 3d 20 30 3b 20 20 20 20 2f *zUri = 0; /
2d6a0 2a 20 55 52 49 20 61 72 67 73 20 74 6f 20 63 6f * URI args to co
2d6b0 70 79 20 2a 2f 0a 20 20 69 6e 74 20 6e 55 72 69 py */. int nUri
2d6c0 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 = 0;
2d6d0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 /* Number of by
2d6e0 74 65 73 20 6f 66 20 55 52 49 20 61 72 67 73 20 tes of URI args
2d6f0 61 74 20 2a 7a 55 72 69 20 2a 2f 0a 0a 20 20 2f at *zUri */.. /
2d700 2a 20 46 69 67 75 72 65 20 6f 75 74 20 68 6f 77 * Figure out how
2d710 20 6d 75 63 68 20 73 70 61 63 65 20 69 73 20 72 much space is r
2d720 65 71 75 69 72 65 64 20 66 6f 72 20 65 61 63 68 equired for each
2d730 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2d 68 61 journal file-ha
2d740 6e 64 6c 65 0a 20 20 2a 2a 20 28 74 68 65 72 65 ndle. ** (there
2d750 20 61 72 65 20 74 77 6f 20 6f 66 20 74 68 65 6d are two of them
2d760 2c 20 74 68 65 20 6d 61 69 6e 20 6a 6f 75 72 6e , the main journ
2d770 61 6c 20 61 6e 64 20 74 68 65 20 73 75 62 2d 6a al and the sub-j
2d780 6f 75 72 6e 61 6c 29 2e 20 20 2a 2f 0a 20 20 6a ournal). */. j
2d790 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 3d ournalFileSize =
2d7a0 20 52 4f 55 4e 44 38 28 73 71 6c 69 74 65 33 4a ROUND8(sqlite3J
2d7b0 6f 75 72 6e 61 6c 53 69 7a 65 28 70 56 66 73 29 ournalSize(pVfs)
2d7c0 29 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 );.. /* Set the
2d7d0 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65 output variable
2d7e0 20 74 6f 20 4e 55 4c 4c 20 69 6e 20 63 61 73 65 to NULL in case
2d7f0 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 an error occurs
2d800 2e 20 2a 2f 0a 20 20 2a 70 70 50 61 67 65 72 20 . */. *ppPager
2d810 3d 20 30 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 = 0;..#ifndef SQ
2d820 4c 49 54 45 5f 4f 4d 49 54 5f 4d 45 4d 4f 52 59 LITE_OMIT_MEMORY
2d830 44 42 0a 20 20 69 66 28 20 66 6c 61 67 73 20 26 DB. if( flags &
2d840 20 50 41 47 45 52 5f 4d 45 4d 4f 52 59 20 29 7b PAGER_MEMORY ){
2d850 0a 20 20 20 20 6d 65 6d 44 62 20 3d 20 31 3b 0a . memDb = 1;.
2d860 20 20 20 20 69 66 28 20 7a 46 69 6c 65 6e 61 6d if( zFilenam
2d870 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65 5b 30 e && zFilename[0
2d880 5d 20 29 7b 0a 20 20 20 20 20 20 7a 50 61 74 68 ] ){. zPath
2d890 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 44 62 name = sqlite3Db
2d8a0 53 74 72 44 75 70 28 30 2c 20 7a 46 69 6c 65 6e StrDup(0, zFilen
2d8b0 61 6d 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 ame);. if(
2d8c0 7a 50 61 74 68 6e 61 6d 65 3d 3d 30 20 20 29 20 zPathname==0 )
2d8d0 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
2d8e0 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 MEM_BKPT;.
2d8f0 6e 50 61 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 nPathname = sqli
2d900 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 50 61 74 te3Strlen30(zPat
2d910 68 6e 61 6d 65 29 3b 0a 20 20 20 20 20 20 7a 46 hname);. zF
2d920 69 6c 65 6e 61 6d 65 20 3d 20 30 3b 0a 20 20 20 ilename = 0;.
2d930 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 }. }.#endif..
2d940 20 2f 2a 20 43 6f 6d 70 75 74 65 20 61 6e 64 20 /* Compute and
2d950 73 74 6f 72 65 20 74 68 65 20 66 75 6c 6c 20 70 store the full p
2d960 61 74 68 6e 61 6d 65 20 69 6e 20 61 6e 20 61 6c athname in an al
2d970 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 20 70 located buffer p
2d980 6f 69 6e 74 65 64 0a 20 20 2a 2a 20 74 6f 20 62 ointed. ** to b
2d990 79 20 7a 50 61 74 68 6e 61 6d 65 2c 20 6c 65 6e y zPathname, len
2d9a0 67 74 68 20 6e 50 61 74 68 6e 61 6d 65 2e 20 4f gth nPathname. O
2d9b0 72 2c 20 69 66 20 74 68 69 73 20 69 73 20 61 20 r, if this is a
2d9c0 74 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 2c 0a temporary file,.
2d9d0 20 20 2a 2a 20 6c 65 61 76 65 20 62 6f 74 68 20 ** leave both
2d9e0 6e 50 61 74 68 6e 61 6d 65 20 61 6e 64 20 7a 50 nPathname and zP
2d9f0 61 74 68 6e 61 6d 65 20 73 65 74 20 74 6f 20 30 athname set to 0
2da00 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 .. */. if( zFi
2da10 6c 65 6e 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e lename && zFilen
2da20 61 6d 65 5b 30 5d 20 29 7b 0a 20 20 20 20 63 6f ame[0] ){. co
2da30 6e 73 74 20 63 68 61 72 20 2a 7a 3b 0a 20 20 20 nst char *z;.
2da40 20 6e 50 61 74 68 6e 61 6d 65 20 3d 20 70 56 66 nPathname = pVf
2da50 73 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 2b 31 3b s->mxPathname+1;
2da60 0a 20 20 20 20 7a 50 61 74 68 6e 61 6d 65 20 3d . zPathname =
2da70 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 sqlite3DbMalloc
2da80 52 61 77 28 30 2c 20 6e 50 61 74 68 6e 61 6d 65 Raw(0, nPathname
2da90 2a 32 29 3b 0a 20 20 20 20 69 66 28 20 7a 50 61 *2);. if( zPa
2daa0 74 68 6e 61 6d 65 3d 3d 30 20 29 7b 0a 20 20 20 thname==0 ){.
2dab0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
2dac0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 _NOMEM_BKPT;.
2dad0 20 7d 0a 20 20 20 20 7a 50 61 74 68 6e 61 6d 65 }. zPathname
2dae0 5b 30 5d 20 3d 20 30 3b 20 2f 2a 20 4d 61 6b 65 [0] = 0; /* Make
2daf0 20 73 75 72 65 20 69 6e 69 74 69 61 6c 69 7a 65 sure initialize
2db00 64 20 65 76 65 6e 20 69 66 20 46 75 6c 6c 50 61 d even if FullPa
2db10 74 68 6e 61 6d 65 28 29 20 66 61 69 6c 73 20 2a thname() fails *
2db20 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 /. rc = sqlit
2db30 65 33 4f 73 46 75 6c 6c 50 61 74 68 6e 61 6d 65 e3OsFullPathname
2db40 28 70 56 66 73 2c 20 7a 46 69 6c 65 6e 61 6d 65 (pVfs, zFilename
2db50 2c 20 6e 50 61 74 68 6e 61 6d 65 2c 20 7a 50 61 , nPathname, zPa
2db60 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 6e 50 61 thname);. nPa
2db70 74 68 6e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 thname = sqlite3
2db80 53 74 72 6c 65 6e 33 30 28 7a 50 61 74 68 6e 61 Strlen30(zPathna
2db90 6d 65 29 3b 0a 20 20 20 20 7a 20 3d 20 7a 55 72 me);. z = zUr
2dba0 69 20 3d 20 26 7a 46 69 6c 65 6e 61 6d 65 5b 73 i = &zFilename[s
2dbb0 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a qlite3Strlen30(z
2dbc0 46 69 6c 65 6e 61 6d 65 29 2b 31 5d 3b 0a 20 20 Filename)+1];.
2dbd0 20 20 77 68 69 6c 65 28 20 2a 7a 20 29 7b 0a 20 while( *z ){.
2dbe0 20 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 74 65 z += sqlite
2dbf0 33 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 3b 0a 3Strlen30(z)+1;.
2dc00 20 20 20 20 20 20 7a 20 2b 3d 20 73 71 6c 69 74 z += sqlit
2dc10 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 2b 31 3b e3Strlen30(z)+1;
2dc20 0a 20 20 20 20 7d 0a 20 20 20 20 6e 55 72 69 20 . }. nUri
2dc30 3d 20 28 69 6e 74 29 28 26 7a 5b 31 5d 20 2d 20 = (int)(&z[1] -
2dc40 7a 55 72 69 29 3b 0a 20 20 20 20 61 73 73 65 72 zUri);. asser
2dc50 74 28 20 6e 55 72 69 3e 3d 30 20 29 3b 0a 20 20 t( nUri>=0 );.
2dc60 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
2dc70 5f 4f 4b 20 26 26 20 6e 50 61 74 68 6e 61 6d 65 _OK && nPathname
2dc80 2b 38 3e 70 56 66 73 2d 3e 6d 78 50 61 74 68 6e +8>pVfs->mxPathn
2dc90 61 6d 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 ame ){. /*
2dca0 54 68 69 73 20 62 72 61 6e 63 68 20 69 73 20 74 This branch is t
2dcb0 61 6b 65 6e 20 77 68 65 6e 20 74 68 65 20 6a 6f aken when the jo
2dcc0 75 72 6e 61 6c 20 70 61 74 68 20 72 65 71 75 69 urnal path requi
2dcd0 72 65 64 20 62 79 0a 20 20 20 20 20 20 2a 2a 20 red by. **
2dce0 74 68 65 20 64 61 74 61 62 61 73 65 20 62 65 69 the database bei
2dcf0 6e 67 20 6f 70 65 6e 65 64 20 77 69 6c 6c 20 62 ng opened will b
2dd00 65 20 6d 6f 72 65 20 74 68 61 6e 20 70 56 66 73 e more than pVfs
2dd10 2d 3e 6d 78 50 61 74 68 6e 61 6d 65 0a 20 20 20 ->mxPathname.
2dd20 20 20 20 2a 2a 20 62 79 74 65 73 20 69 6e 20 6c ** bytes in l
2dd30 65 6e 67 74 68 2e 20 54 68 69 73 20 6d 65 61 6e ength. This mean
2dd40 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 63 s the database c
2dd50 61 6e 6e 6f 74 20 62 65 20 6f 70 65 6e 65 64 2c annot be opened,
2dd60 0a 20 20 20 20 20 20 2a 2a 20 61 73 20 69 74 20 . ** as it
2dd70 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 73 will not be poss
2dd80 69 62 6c 65 20 74 6f 20 6f 70 65 6e 20 74 68 65 ible to open the
2dd90 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6f 72 journal file or
2dda0 20 65 76 65 6e 0a 20 20 20 20 20 20 2a 2a 20 63 even. ** c
2ddb0 68 65 63 6b 20 66 6f 72 20 61 20 68 6f 74 2d 6a heck for a hot-j
2ddc0 6f 75 72 6e 61 6c 20 62 65 66 6f 72 65 20 72 65 ournal before re
2ddd0 61 64 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2f 0a ading.. */.
2dde0 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
2ddf0 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 3b E_CANTOPEN_BKPT;
2de00 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
2de10 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
2de20 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 sqlite3DbF
2de30 72 65 65 28 30 2c 20 7a 50 61 74 68 6e 61 6d 65 ree(0, zPathname
2de40 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 );. return
2de50 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 rc;. }. }..
2de60 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 6d 65 6d /* Allocate mem
2de70 6f 72 79 20 66 6f 72 20 74 68 65 20 50 61 67 65 ory for the Page
2de80 72 20 73 74 72 75 63 74 75 72 65 2c 20 50 43 61 r structure, PCa
2de90 63 68 65 20 6f 62 6a 65 63 74 2c 20 74 68 65 0a che object, the.
2dea0 20 20 2a 2a 20 74 68 72 65 65 20 66 69 6c 65 20 ** three file
2deb0 64 65 73 63 72 69 70 74 6f 72 73 2c 20 74 68 65 descriptors, the
2dec0 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6e database file n
2ded0 61 6d 65 20 61 6e 64 20 74 68 65 20 6a 6f 75 72 ame and the jour
2dee0 6e 61 6c 20 0a 20 20 2a 2a 20 66 69 6c 65 20 6e nal . ** file n
2def0 61 6d 65 2e 20 54 68 65 20 6c 61 79 6f 75 74 20 ame. The layout
2df00 69 6e 20 6d 65 6d 6f 72 79 20 69 73 20 61 73 20 in memory is as
2df10 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 0a 20 20 follows:. **.
2df20 2a 2a 20 20 20 20 20 50 61 67 65 72 20 6f 62 6a ** Pager obj
2df30 65 63 74 20 20 20 20 20 20 20 20 20 20 20 20 20 ect
2df40 20 20 20 20 20 20 20 28 73 69 7a 65 6f 66 28 50 (sizeof(P
2df50 61 67 65 72 29 20 62 79 74 65 73 29 0a 20 20 2a ager) bytes). *
2df60 2a 20 20 20 20 20 50 43 61 63 68 65 20 6f 62 6a * PCache obj
2df70 65 63 74 20 20 20 20 20 20 20 20 20 20 20 20 20 ect
2df80 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 50 63 (sqlite3Pc
2df90 61 63 68 65 53 69 7a 65 28 29 20 62 79 74 65 73 acheSize() bytes
2dfa0 29 0a 20 20 2a 2a 20 20 20 20 20 44 61 74 61 62 ). ** Datab
2dfb0 61 73 65 20 66 69 6c 65 20 68 61 6e 64 6c 65 20 ase file handle
2dfc0 20 20 20 20 20 20 20 20 20 20 20 28 70 56 66 73 (pVfs
2dfd0 2d 3e 73 7a 4f 73 46 69 6c 65 20 62 79 74 65 73 ->szOsFile bytes
2dfe0 29 0a 20 20 2a 2a 20 20 20 20 20 53 75 62 2d 6a ). ** Sub-j
2dff0 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 6e 64 ournal file hand
2e000 6c 65 20 20 20 20 20 20 20 20 20 28 6a 6f 75 72 le (jour
2e010 6e 61 6c 46 69 6c 65 53 69 7a 65 20 62 79 74 65 nalFileSize byte
2e020 73 29 0a 20 20 2a 2a 20 20 20 20 20 4d 61 69 6e s). ** Main
2e030 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61 journal file ha
2e040 6e 64 6c 65 20 20 20 20 20 20 20 20 28 6a 6f 75 ndle (jou
2e050 72 6e 61 6c 46 69 6c 65 53 69 7a 65 20 62 79 74 rnalFileSize byt
2e060 65 73 29 0a 20 20 2a 2a 20 20 20 20 20 44 61 74 es). ** Dat
2e070 61 62 61 73 65 20 66 69 6c 65 20 6e 61 6d 65 20 abase file name
2e080 20 20 20 20 20 20 20 20 20 20 20 20 20 28 6e 50 (nP
2e090 61 74 68 6e 61 6d 65 2b 31 20 62 79 74 65 73 29 athname+1 bytes)
2e0a0 0a 20 20 2a 2a 20 20 20 20 20 4a 6f 75 72 6e 61 . ** Journa
2e0b0 6c 20 66 69 6c 65 20 6e 61 6d 65 20 20 20 20 20 l file name
2e0c0 20 20 20 20 20 20 20 20 20 20 28 6e 50 61 74 68 (nPath
2e0d0 6e 61 6d 65 2b 38 2b 31 20 62 79 74 65 73 29 0a name+8+1 bytes).
2e0e0 20 20 2a 2f 0a 20 20 70 50 74 72 20 3d 20 28 75 */. pPtr = (u
2e0f0 38 20 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 8 *)sqlite3Mallo
2e100 63 5a 65 72 6f 28 0a 20 20 20 20 52 4f 55 4e 44 cZero(. ROUND
2e110 38 28 73 69 7a 65 6f 66 28 2a 70 50 61 67 65 72 8(sizeof(*pPager
2e120 29 29 20 2b 20 20 20 20 20 20 2f 2a 20 50 61 67 )) + /* Pag
2e130 65 72 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a er structure */.
2e140 20 20 20 20 52 4f 55 4e 44 38 28 70 63 61 63 68 ROUND8(pcach
2e150 65 53 69 7a 65 29 20 2b 20 20 20 20 20 20 20 20 eSize) +
2e160 20 20 20 2f 2a 20 50 43 61 63 68 65 20 6f 62 6a /* PCache obj
2e170 65 63 74 20 2a 2f 0a 20 20 20 20 52 4f 55 4e 44 ect */. ROUND
2e180 38 28 70 56 66 73 2d 3e 73 7a 4f 73 46 69 6c 65 8(pVfs->szOsFile
2e190 29 20 2b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ) + /* The
2e1a0 20 6d 61 69 6e 20 64 62 20 66 69 6c 65 20 2a 2f main db file */
2e1b0 0a 20 20 20 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 . journalFile
2e1c0 53 69 7a 65 20 2a 20 32 20 2b 20 20 20 20 20 20 Size * 2 +
2e1d0 20 20 20 20 2f 2a 20 54 68 65 20 74 77 6f 20 6a /* The two j
2e1e0 6f 75 72 6e 61 6c 20 66 69 6c 65 73 20 2a 2f 20 ournal files */
2e1f0 0a 20 20 20 20 6e 50 61 74 68 6e 61 6d 65 20 2b . nPathname +
2e200 20 31 20 2b 20 6e 55 72 69 20 2b 20 20 20 20 20 1 + nUri +
2e210 20 20 20 20 2f 2a 20 7a 46 69 6c 65 6e 61 6d 65 /* zFilename
2e220 20 2a 2f 0a 20 20 20 20 6e 50 61 74 68 6e 61 6d */. nPathnam
2e230 65 20 2b 20 38 20 2b 20 32 20 20 20 20 20 20 20 e + 8 + 2
2e240 20 20 20 20 20 20 20 2f 2a 20 7a 4a 6f 75 72 6e /* zJourn
2e250 61 6c 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 al */.#ifndef SQ
2e260 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 LITE_OMIT_WAL.
2e270 20 20 2b 20 6e 50 61 74 68 6e 61 6d 65 20 2b 20 + nPathname +
2e280 34 20 2b 20 32 20 20 20 20 20 20 20 20 20 20 20 4 + 2
2e290 20 2f 2a 20 7a 57 61 6c 20 2a 2f 0a 23 65 6e 64 /* zWal */.#end
2e2a0 69 66 0a 20 20 29 3b 0a 20 20 61 73 73 65 72 74 if. );. assert
2e2b0 28 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 ( EIGHT_BYTE_ALI
2e2c0 47 4e 4d 45 4e 54 28 53 51 4c 49 54 45 5f 49 4e GNMENT(SQLITE_IN
2e2d0 54 5f 54 4f 5f 50 54 52 28 6a 6f 75 72 6e 61 6c T_TO_PTR(journal
2e2e0 46 69 6c 65 53 69 7a 65 29 29 20 29 3b 0a 20 20 FileSize)) );.
2e2f0 69 66 28 20 21 70 50 74 72 20 29 7b 0a 20 20 20 if( !pPtr ){.
2e300 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 30 sqlite3DbFree(0
2e310 2c 20 7a 50 61 74 68 6e 61 6d 65 29 3b 0a 20 20 , zPathname);.
2e320 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
2e330 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a NOMEM_BKPT;. }.
2e340 20 20 70 50 61 67 65 72 20 3d 20 20 20 20 20 20 pPager =
2e350 20 20 20 20 20 20 20 20 28 50 61 67 65 72 2a 29 (Pager*)
2e360 28 70 50 74 72 29 3b 0a 20 20 70 50 61 67 65 72 (pPtr);. pPager
2e370 2d 3e 70 50 43 61 63 68 65 20 3d 20 20 20 20 28 ->pPCache = (
2e380 50 43 61 63 68 65 2a 29 28 70 50 74 72 20 2b 3d PCache*)(pPtr +=
2e390 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 28 2a ROUND8(sizeof(*
2e3a0 70 50 61 67 65 72 29 29 29 3b 0a 20 20 70 50 61 pPager)));. pPa
2e3b0 67 65 72 2d 3e 66 64 20 3d 20 20 20 28 73 71 6c ger->fd = (sql
2e3c0 69 74 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 72 ite3_file*)(pPtr
2e3d0 20 2b 3d 20 52 4f 55 4e 44 38 28 70 63 61 63 68 += ROUND8(pcach
2e3e0 65 53 69 7a 65 29 29 3b 0a 20 20 70 50 61 67 65 eSize));. pPage
2e3f0 72 2d 3e 73 6a 66 64 20 3d 20 28 73 71 6c 69 74 r->sjfd = (sqlit
2e400 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 72 20 2b e3_file*)(pPtr +
2e410 3d 20 52 4f 55 4e 44 38 28 70 56 66 73 2d 3e 73 = ROUND8(pVfs->s
2e420 7a 4f 73 46 69 6c 65 29 29 3b 0a 20 20 70 50 61 zOsFile));. pPa
2e430 67 65 72 2d 3e 6a 66 64 20 3d 20 20 28 73 71 6c ger->jfd = (sql
2e440 69 74 65 33 5f 66 69 6c 65 2a 29 28 70 50 74 72 ite3_file*)(pPtr
2e450 20 2b 3d 20 6a 6f 75 72 6e 61 6c 46 69 6c 65 53 += journalFileS
2e460 69 7a 65 29 3b 0a 20 20 70 50 61 67 65 72 2d 3e ize);. pPager->
2e470 7a 46 69 6c 65 6e 61 6d 65 20 3d 20 20 20 20 28 zFilename = (
2e480 63 68 61 72 2a 29 28 70 50 74 72 20 2b 3d 20 6a char*)(pPtr += j
2e490 6f 75 72 6e 61 6c 46 69 6c 65 53 69 7a 65 29 3b ournalFileSize);
2e4a0 0a 20 20 61 73 73 65 72 74 28 20 45 49 47 48 54 . assert( EIGHT
2e4b0 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 _BYTE_ALIGNMENT(
2e4c0 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a pPager->jfd) );.
2e4d0 0a 20 20 2f 2a 20 46 69 6c 6c 20 69 6e 20 74 68 . /* Fill in th
2e4e0 65 20 50 61 67 65 72 2e 7a 46 69 6c 65 6e 61 6d e Pager.zFilenam
2e4f0 65 20 61 6e 64 20 50 61 67 65 72 2e 7a 4a 6f 75 e and Pager.zJou
2e500 72 6e 61 6c 20 62 75 66 66 65 72 73 2c 20 69 66 rnal buffers, if
2e510 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a 20 20 required. */.
2e520 69 66 28 20 7a 50 61 74 68 6e 61 6d 65 20 29 7b if( zPathname ){
2e530 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 50 61 . assert( nPa
2e540 74 68 6e 61 6d 65 3e 30 20 29 3b 0a 20 20 20 20 thname>0 );.
2e550 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c pPager->zJournal
2e560 20 3d 20 20 20 28 63 68 61 72 2a 29 28 70 50 74 = (char*)(pPt
2e570 72 20 2b 3d 20 6e 50 61 74 68 6e 61 6d 65 20 2b r += nPathname +
2e580 20 31 20 2b 20 6e 55 72 69 29 3b 0a 20 20 20 20 1 + nUri);.
2e590 6d 65 6d 63 70 79 28 70 50 61 67 65 72 2d 3e 7a memcpy(pPager->z
2e5a0 46 69 6c 65 6e 61 6d 65 2c 20 7a 50 61 74 68 6e Filename, zPathn
2e5b0 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 29 3b ame, nPathname);
2e5c0 0a 20 20 20 20 69 66 28 20 6e 55 72 69 20 29 20 . if( nUri )
2e5d0 6d 65 6d 63 70 79 28 26 70 50 61 67 65 72 2d 3e memcpy(&pPager->
2e5e0 7a 46 69 6c 65 6e 61 6d 65 5b 6e 50 61 74 68 6e zFilename[nPathn
2e5f0 61 6d 65 2b 31 5d 2c 20 7a 55 72 69 2c 20 6e 55 ame+1], zUri, nU
2e600 72 69 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 ri);. memcpy(
2e610 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c pPager->zJournal
2e620 2c 20 7a 50 61 74 68 6e 61 6d 65 2c 20 6e 50 61 , zPathname, nPa
2e630 74 68 6e 61 6d 65 29 3b 0a 20 20 20 20 6d 65 6d thname);. mem
2e640 63 70 79 28 26 70 50 61 67 65 72 2d 3e 7a 4a 6f cpy(&pPager->zJo
2e650 75 72 6e 61 6c 5b 6e 50 61 74 68 6e 61 6d 65 5d urnal[nPathname]
2e660 2c 20 22 2d 6a 6f 75 72 6e 61 6c 5c 30 30 30 22 , "-journal\000"
2e670 2c 20 38 2b 32 29 3b 0a 20 20 20 20 73 71 6c 69 , 8+2);. sqli
2e680 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 70 te3FileSuffix3(p
2e690 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 Pager->zFilename
2e6a0 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e , pPager->zJourn
2e6b0 61 6c 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c al);.#ifndef SQL
2e6c0 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 20 ITE_OMIT_WAL.
2e6d0 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 20 3d 20 pPager->zWal =
2e6e0 26 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 &pPager->zJourna
2e6f0 6c 5b 6e 50 61 74 68 6e 61 6d 65 2b 38 2b 31 5d l[nPathname+8+1]
2e700 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 70 50 61 ;. memcpy(pPa
2e710 67 65 72 2d 3e 7a 57 61 6c 2c 20 7a 50 61 74 68 ger->zWal, zPath
2e720 6e 61 6d 65 2c 20 6e 50 61 74 68 6e 61 6d 65 29 name, nPathname)
2e730 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 26 70 50 ;. memcpy(&pP
2e740 61 67 65 72 2d 3e 7a 57 61 6c 5b 6e 50 61 74 68 ager->zWal[nPath
2e750 6e 61 6d 65 5d 2c 20 22 2d 77 61 6c 5c 30 30 30 name], "-wal\000
2e760 22 2c 20 34 2b 31 29 3b 0a 20 20 20 20 73 71 6c ", 4+1);. sql
2e770 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 ite3FileSuffix3(
2e780 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d pPager->zFilenam
2e790 65 2c 20 70 50 61 67 65 72 2d 3e 7a 57 61 6c 29 e, pPager->zWal)
2e7a0 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c ;.#endif. sql
2e7b0 69 74 65 33 44 62 46 72 65 65 28 30 2c 20 7a 50 ite3DbFree(0, zP
2e7c0 61 74 68 6e 61 6d 65 29 3b 0a 20 20 7d 0a 20 20 athname);. }.
2e7d0 70 50 61 67 65 72 2d 3e 70 56 66 73 20 3d 20 70 pPager->pVfs = p
2e7e0 56 66 73 3b 0a 20 20 70 50 61 67 65 72 2d 3e 76 Vfs;. pPager->v
2e7f0 66 73 46 6c 61 67 73 20 3d 20 76 66 73 46 6c 61 fsFlags = vfsFla
2e800 67 73 3b 0a 0a 20 20 2f 2a 20 4f 70 65 6e 20 74 gs;.. /* Open t
2e810 68 65 20 70 61 67 65 72 20 66 69 6c 65 2e 0a 20 he pager file..
2e820 20 2a 2f 0a 20 20 69 66 28 20 7a 46 69 6c 65 6e */. if( zFilen
2e830 61 6d 65 20 26 26 20 7a 46 69 6c 65 6e 61 6d 65 ame && zFilename
2e840 5b 30 5d 20 29 7b 0a 20 20 20 20 69 6e 74 20 66 [0] ){. int f
2e850 6f 75 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20 out = 0;
2e860 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
2e870 46 53 20 66 6c 61 67 73 20 72 65 74 75 72 6e 65 FS flags returne
2e880 64 20 62 79 20 78 4f 70 65 6e 28 29 20 2a 2f 0a d by xOpen() */.
2e890 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 rc = sqlite3
2e8a0 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 OsOpen(pVfs, pPa
2e8b0 67 65 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 2c 20 ger->zFilename,
2e8c0 70 50 61 67 65 72 2d 3e 66 64 2c 20 76 66 73 46 pPager->fd, vfsF
2e8d0 6c 61 67 73 2c 20 26 66 6f 75 74 29 3b 0a 20 20 lags, &fout);.
2e8e0 20 20 61 73 73 65 72 74 28 20 21 6d 65 6d 44 62 assert( !memDb
2e8f0 20 29 3b 0a 20 20 20 20 72 65 61 64 4f 6e 6c 79 );. readOnly
2e900 20 3d 20 28 66 6f 75 74 26 53 51 4c 49 54 45 5f = (fout&SQLITE_
2e910 4f 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 29 3b 0a OPEN_READONLY);.
2e920 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 66 . /* If the f
2e930 69 6c 65 20 77 61 73 20 73 75 63 63 65 73 73 66 ile was successf
2e940 75 6c 6c 79 20 6f 70 65 6e 65 64 20 66 6f 72 20 ully opened for
2e950 72 65 61 64 2f 77 72 69 74 65 20 61 63 63 65 73 read/write acces
2e960 73 2c 0a 20 20 20 20 2a 2a 20 63 68 6f 6f 73 65 s,. ** choose
2e970 20 61 20 64 65 66 61 75 6c 74 20 70 61 67 65 20 a default page
2e980 73 69 7a 65 20 69 6e 20 63 61 73 65 20 77 65 20 size in case we
2e990 68 61 76 65 20 74 6f 20 63 72 65 61 74 65 20 74 have to create t
2e9a0 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 62 61 he. ** databa
2e9b0 73 65 20 66 69 6c 65 2e 20 54 68 65 20 64 65 66 se file. The def
2e9c0 61 75 6c 74 20 70 61 67 65 20 73 69 7a 65 20 69 ault page size i
2e9d0 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6f 66 s the maximum of
2e9e0 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 :. **. **
2e9f0 20 20 20 2b 20 53 51 4c 49 54 45 5f 44 45 46 41 + SQLITE_DEFA
2ea00 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 2c 0a 20 ULT_PAGE_SIZE,.
2ea10 20 20 20 2a 2a 20 20 20 20 2b 20 54 68 65 20 76 ** + The v
2ea20 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
2ea30 20 73 71 6c 69 74 65 33 4f 73 53 65 63 74 6f 72 sqlite3OsSector
2ea40 53 69 7a 65 28 29 0a 20 20 20 20 2a 2a 20 20 20 Size(). **
2ea50 20 2b 20 54 68 65 20 6c 61 72 67 65 73 74 20 70 + The largest p
2ea60 61 67 65 20 73 69 7a 65 20 74 68 61 74 20 63 61 age size that ca
2ea70 6e 20 62 65 20 77 72 69 74 74 65 6e 20 61 74 6f n be written ato
2ea80 6d 69 63 61 6c 6c 79 2e 0a 20 20 20 20 2a 2f 0a mically.. */.
2ea90 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
2eaa0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69 TE_OK ){. i
2eab0 6e 74 20 69 44 63 20 3d 20 73 71 6c 69 74 65 33 nt iDc = sqlite3
2eac0 4f 73 44 65 76 69 63 65 43 68 61 72 61 63 74 65 OsDeviceCharacte
2ead0 72 69 73 74 69 63 73 28 70 50 61 67 65 72 2d 3e ristics(pPager->
2eae0 66 64 29 3b 0a 20 20 20 20 20 20 69 66 28 20 21 fd);. if( !
2eaf0 72 65 61 64 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 readOnly ){.
2eb00 20 20 20 20 73 65 74 53 65 63 74 6f 72 53 69 7a setSectorSiz
2eb10 65 28 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 e(pPager);.
2eb20 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 45 assert(SQLITE
2eb30 5f 44 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 _DEFAULT_PAGE_SI
2eb40 5a 45 3c 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 44 ZE<=SQLITE_MAX_D
2eb50 45 46 41 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 EFAULT_PAGE_SIZE
2eb60 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 73 );. if( s
2eb70 7a 50 61 67 65 44 66 6c 74 3c 70 50 61 67 65 72 zPageDflt<pPager
2eb80 2d 3e 73 65 63 74 6f 72 53 69 7a 65 20 29 7b 0a ->sectorSize ){.
2eb90 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 50 if( pP
2eba0 61 67 65 72 2d 3e 73 65 63 74 6f 72 53 69 7a 65 ager->sectorSize
2ebb0 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 >SQLITE_MAX_DEFA
2ebc0 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 20 29 7b ULT_PAGE_SIZE ){
2ebd0 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 7a 50 . szP
2ebe0 61 67 65 44 66 6c 74 20 3d 20 53 51 4c 49 54 45 ageDflt = SQLITE
2ebf0 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 47 _MAX_DEFAULT_PAG
2ec00 45 5f 53 49 5a 45 3b 0a 20 20 20 20 20 20 20 20 E_SIZE;.
2ec10 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
2ec20 20 20 20 20 20 73 7a 50 61 67 65 44 66 6c 74 20 szPageDflt
2ec30 3d 20 28 75 33 32 29 70 50 61 67 65 72 2d 3e 73 = (u32)pPager->s
2ec40 65 63 74 6f 72 53 69 7a 65 3b 0a 20 20 20 20 20 ectorSize;.
2ec50 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
2ec60 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
2ec70 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 49 NABLE_ATOMIC_WRI
2ec80 54 45 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 20 TE. {.
2ec90 20 20 20 20 20 20 20 69 6e 74 20 69 69 3b 0a 20 int ii;.
2eca0 20 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 assert(
2ecb0 53 51 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f SQLITE_IOCAP_ATO
2ecc0 4d 49 43 35 31 32 3d 3d 28 35 31 32 3e 3e 38 29 MIC512==(512>>8)
2ecd0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73 );. ass
2ece0 65 72 74 28 53 51 4c 49 54 45 5f 49 4f 43 41 50 ert(SQLITE_IOCAP
2ecf0 5f 41 54 4f 4d 49 43 36 34 4b 3d 3d 28 36 35 35 _ATOMIC64K==(655
2ed00 33 36 3e 3e 38 29 29 3b 0a 20 20 20 20 20 20 20 36>>8));.
2ed10 20 20 20 61 73 73 65 72 74 28 53 51 4c 49 54 45 assert(SQLITE
2ed20 5f 4d 41 58 5f 44 45 46 41 55 4c 54 5f 50 41 47 _MAX_DEFAULT_PAG
2ed30 45 5f 53 49 5a 45 3c 3d 36 35 35 33 36 29 3b 0a E_SIZE<=65536);.
2ed40 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 69 for(ii
2ed50 3d 73 7a 50 61 67 65 44 66 6c 74 3b 20 69 69 3c =szPageDflt; ii<
2ed60 3d 53 51 4c 49 54 45 5f 4d 41 58 5f 44 45 46 41 =SQLITE_MAX_DEFA
2ed70 55 4c 54 5f 50 41 47 45 5f 53 49 5a 45 3b 20 69 ULT_PAGE_SIZE; i
2ed80 69 3d 69 69 2a 32 29 7b 0a 20 20 20 20 20 20 20 i=ii*2){.
2ed90 20 20 20 20 20 69 66 28 20 69 44 63 26 28 53 51 if( iDc&(SQ
2eda0 4c 49 54 45 5f 49 4f 43 41 50 5f 41 54 4f 4d 49 LITE_IOCAP_ATOMI
2edb0 43 7c 28 69 69 3e 3e 38 29 29 20 29 7b 0a 20 20 C|(ii>>8)) ){.
2edc0 20 20 20 20 20 20 20 20 20 20 20 20 73 7a 50 61 szPa
2edd0 67 65 44 66 6c 74 20 3d 20 69 69 3b 0a 20 20 20 geDflt = ii;.
2ede0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2edf0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d }. }
2ee00 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 7d 0a .#endif. }.
2ee10 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 6f pPager->no
2ee20 4c 6f 63 6b 20 3d 20 73 71 6c 69 74 65 33 5f 75 Lock = sqlite3_u
2ee30 72 69 5f 62 6f 6f 6c 65 61 6e 28 7a 46 69 6c 65 ri_boolean(zFile
2ee40 6e 61 6d 65 2c 20 22 6e 6f 6c 6f 63 6b 22 2c 20 name, "nolock",
2ee50 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20 28 69 0);. if( (i
2ee60 44 63 20 26 20 53 51 4c 49 54 45 5f 49 4f 43 41 Dc & SQLITE_IOCA
2ee70 50 5f 49 4d 4d 55 54 41 42 4c 45 29 21 3d 30 0a P_IMMUTABLE)!=0.
2ee80 20 20 20 20 20 20 20 7c 7c 20 73 71 6c 69 74 65 || sqlite
2ee90 33 5f 75 72 69 5f 62 6f 6f 6c 65 61 6e 28 7a 46 3_uri_boolean(zF
2eea0 69 6c 65 6e 61 6d 65 2c 20 22 69 6d 6d 75 74 61 ilename, "immuta
2eeb0 62 6c 65 22 2c 20 30 29 20 29 7b 0a 20 20 20 20 ble", 0) ){.
2eec0 20 20 20 20 20 20 76 66 73 46 6c 61 67 73 20 7c vfsFlags |
2eed0 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 52 45 = SQLITE_OPEN_RE
2eee0 41 44 4f 4e 4c 59 3b 0a 20 20 20 20 20 20 20 20 ADONLY;.
2eef0 20 20 67 6f 74 6f 20 61 63 74 5f 6c 69 6b 65 5f goto act_like_
2ef00 74 65 6d 70 5f 66 69 6c 65 3b 0a 20 20 20 20 20 temp_file;.
2ef10 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 }. }. }else
2ef20 7b 0a 20 20 20 20 2f 2a 20 49 66 20 61 20 74 65 {. /* If a te
2ef30 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 69 73 20 mporary file is
2ef40 72 65 71 75 65 73 74 65 64 2c 20 69 74 20 69 73 requested, it is
2ef50 20 6e 6f 74 20 6f 70 65 6e 65 64 20 69 6d 6d 65 not opened imme
2ef60 64 69 61 74 65 6c 79 2e 0a 20 20 20 20 2a 2a 20 diately.. **
2ef70 49 6e 20 74 68 69 73 20 63 61 73 65 20 77 65 20 In this case we
2ef80 61 63 63 65 70 74 20 74 68 65 20 64 65 66 61 75 accept the defau
2ef90 6c 74 20 70 61 67 65 20 73 69 7a 65 20 61 6e 64 lt page size and
2efa0 20 64 65 6c 61 79 20 61 63 74 75 61 6c 6c 79 0a delay actually.
2efb0 20 20 20 20 2a 2a 20 6f 70 65 6e 69 6e 67 20 74 ** opening t
2efc0 68 65 20 66 69 6c 65 20 75 6e 74 69 6c 20 74 68 he file until th
2efd0 65 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20 e first call to
2efe0 4f 73 57 72 69 74 65 28 29 2e 0a 20 20 20 20 2a OsWrite().. *
2eff0 2a 0a 20 20 20 20 2a 2a 20 54 68 69 73 20 62 72 *. ** This br
2f000 61 6e 63 68 20 69 73 20 61 6c 73 6f 20 72 75 6e anch is also run
2f010 20 66 6f 72 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 for an in-memor
2f020 79 20 64 61 74 61 62 61 73 65 2e 20 41 6e 20 69 y database. An i
2f030 6e 2d 6d 65 6d 6f 72 79 0a 20 20 20 20 2a 2a 20 n-memory. **
2f040 64 61 74 61 62 61 73 65 20 69 73 20 74 68 65 20 database is the
2f050 73 61 6d 65 20 61 73 20 61 20 74 65 6d 70 2d 66 same as a temp-f
2f060 69 6c 65 20 74 68 61 74 20 69 73 20 6e 65 76 65 ile that is neve
2f070 72 20 77 72 69 74 74 65 6e 20 6f 75 74 20 74 6f r written out to
2f080 0a 20 20 20 20 2a 2a 20 64 69 73 6b 20 61 6e 64 . ** disk and
2f090 20 75 73 65 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f uses an in-memo
2f0a0 72 79 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 ry rollback jour
2f0b0 6e 61 6c 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 nal.. **.
2f0c0 2a 2a 20 54 68 69 73 20 62 72 61 6e 63 68 20 61 ** This branch a
2f0d0 6c 73 6f 20 72 75 6e 73 20 66 6f 72 20 66 69 6c lso runs for fil
2f0e0 65 73 20 6d 61 72 6b 65 64 20 61 73 20 69 6d 6d es marked as imm
2f0f0 75 74 61 62 6c 65 2e 0a 20 20 20 20 2a 2f 20 0a utable.. */ .
2f100 61 63 74 5f 6c 69 6b 65 5f 74 65 6d 70 5f 66 69 act_like_temp_fi
2f110 6c 65 3a 0a 20 20 20 20 74 65 6d 70 46 69 6c 65 le:. tempFile
2f120 20 3d 20 31 3b 0a 20 20 20 20 70 50 61 67 65 72 = 1;. pPager
2f130 2d 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 ->eState = PAGER
2f140 5f 52 45 41 44 45 52 3b 20 20 20 20 20 2f 2a 20 _READER; /*
2f150 50 72 65 74 65 6e 64 20 77 65 20 61 6c 72 65 61 Pretend we alrea
2f160 64 79 20 68 61 76 65 20 61 20 6c 6f 63 6b 20 2a dy have a lock *
2f170 2f 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 4c /. pPager->eL
2f180 6f 63 6b 20 3d 20 45 58 43 4c 55 53 49 56 45 5f ock = EXCLUSIVE_
2f190 4c 4f 43 4b 3b 20 20 20 20 2f 2a 20 50 72 65 74 LOCK; /* Pret
2f1a0 65 6e 64 20 77 65 20 61 72 65 20 69 6e 20 45 58 end we are in EX
2f1b0 43 4c 55 53 49 56 45 20 6d 6f 64 65 20 2a 2f 0a CLUSIVE mode */.
2f1c0 20 20 20 20 70 50 61 67 65 72 2d 3e 6e 6f 4c 6f pPager->noLo
2f1d0 63 6b 20 3d 20 31 3b 20 20 20 20 20 20 20 20 20 ck = 1;
2f1e0 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 20 /* Do no
2f1f0 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 20 20 20 20 72 locking */. r
2f200 65 61 64 4f 6e 6c 79 20 3d 20 28 76 66 73 46 6c eadOnly = (vfsFl
2f210 61 67 73 26 53 51 4c 49 54 45 5f 4f 50 45 4e 5f ags&SQLITE_OPEN_
2f220 52 45 41 44 4f 4e 4c 59 29 3b 0a 20 20 7d 0a 0a READONLY);. }..
2f230 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 /* The followi
2f240 6e 67 20 63 61 6c 6c 20 74 6f 20 50 61 67 65 72 ng call to Pager
2f250 53 65 74 50 61 67 65 73 69 7a 65 28 29 20 73 65 SetPagesize() se
2f260 72 76 65 73 20 74 6f 20 73 65 74 20 74 68 65 20 rves to set the
2f270 76 61 6c 75 65 20 6f 66 20 0a 20 20 2a 2a 20 50 value of . ** P
2f280 61 67 65 72 2e 70 61 67 65 53 69 7a 65 20 61 6e ager.pageSize an
2f290 64 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 74 68 d to allocate th
2f2a0 65 20 50 61 67 65 72 2e 70 54 6d 70 53 70 61 63 e Pager.pTmpSpac
2f2b0 65 20 62 75 66 66 65 72 2e 0a 20 20 2a 2f 0a 20 e buffer.. */.
2f2c0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2f2d0 4f 4b 20 29 7b 0a 20 20 20 20 61 73 73 65 72 74 OK ){. assert
2f2e0 28 20 70 50 61 67 65 72 2d 3e 6d 65 6d 44 62 3d ( pPager->memDb=
2f2f0 3d 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 =0 );. rc = s
2f300 71 6c 69 74 65 33 50 61 67 65 72 53 65 74 50 61 qlite3PagerSetPa
2f310 67 65 73 69 7a 65 28 70 50 61 67 65 72 2c 20 26 gesize(pPager, &
2f320 73 7a 50 61 67 65 44 66 6c 74 2c 20 2d 31 29 3b szPageDflt, -1);
2f330 0a 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 . testcase( r
2f340 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a c!=SQLITE_OK );.
2f350 20 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 }.. /* Initia
2f360 6c 69 7a 65 20 74 68 65 20 50 43 61 63 68 65 20 lize the PCache
2f370 6f 62 6a 65 63 74 2e 20 2a 2f 0a 20 20 69 66 28 object. */. if(
2f380 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc==SQLITE_OK )
2f390 7b 0a 20 20 20 20 6e 45 78 74 72 61 20 3d 20 52 {. nExtra = R
2f3a0 4f 55 4e 44 38 28 6e 45 78 74 72 61 29 3b 0a 20 OUND8(nExtra);.
2f3b0 20 20 20 61 73 73 65 72 74 28 20 6e 45 78 74 72 assert( nExtr
2f3c0 61 3e 3d 38 20 26 26 20 6e 45 78 74 72 61 3c 31 a>=8 && nExtra<1
2f3d0 30 30 30 20 29 3b 0a 20 20 20 20 72 63 20 3d 20 000 );. rc =
2f3e0 73 71 6c 69 74 65 33 50 63 61 63 68 65 4f 70 65 sqlite3PcacheOpe
2f3f0 6e 28 73 7a 50 61 67 65 44 66 6c 74 2c 20 6e 45 n(szPageDflt, nE
2f400 78 74 72 61 2c 20 21 6d 65 6d 44 62 2c 0a 20 20 xtra, !memDb,.
2f410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f420 20 20 20 20 20 21 6d 65 6d 44 62 3f 70 61 67 65 !memDb?page
2f430 72 53 74 72 65 73 73 3a 30 2c 20 28 76 6f 69 64 rStress:0, (void
2f440 20 2a 29 70 50 61 67 65 72 2c 20 70 50 61 67 65 *)pPager, pPage
2f450 72 2d 3e 70 50 43 61 63 68 65 29 3b 0a 20 20 7d r->pPCache);. }
2f460 0a 0a 20 20 2f 2a 20 49 66 20 61 6e 20 65 72 72 .. /* If an err
2f470 6f 72 20 6f 63 63 75 72 72 65 64 20 61 62 6f 76 or occurred abov
2f480 65 2c 20 66 72 65 65 20 74 68 65 20 20 50 61 67 e, free the Pag
2f490 65 72 20 73 74 72 75 63 74 75 72 65 20 61 6e 64 er structure and
2f4a0 20 63 6c 6f 73 65 20 74 68 65 20 66 69 6c 65 2e close the file.
2f4b0 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 21 3d . */. if( rc!=
2f4c0 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
2f4d0 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 sqlite3OsClose(
2f4e0 70 50 61 67 65 72 2d 3e 66 64 29 3b 0a 20 20 20 pPager->fd);.
2f4f0 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 sqlite3PageFree
2f500 28 70 50 61 67 65 72 2d 3e 70 54 6d 70 53 70 61 (pPager->pTmpSpa
2f510 63 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 ce);. sqlite3
2f520 5f 66 72 65 65 28 70 50 61 67 65 72 29 3b 0a 20 _free(pPager);.
2f530 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
2f540 7d 0a 0a 20 20 50 41 47 45 52 54 52 41 43 45 28 }.. PAGERTRACE(
2f550 28 22 4f 50 45 4e 20 25 64 20 25 73 5c 6e 22 2c ("OPEN %d %s\n",
2f560 20 46 49 4c 45 48 41 4e 44 4c 45 49 44 28 70 50 FILEHANDLEID(pP
2f570 61 67 65 72 2d 3e 66 64 29 2c 20 70 50 61 67 65 ager->fd), pPage
2f580 72 2d 3e 7a 46 69 6c 65 6e 61 6d 65 29 29 3b 0a r->zFilename));.
2f590 20 20 49 4f 54 52 41 43 45 28 28 22 4f 50 45 4e IOTRACE(("OPEN
2f5a0 20 25 70 20 25 73 5c 6e 22 2c 20 70 50 61 67 65 %p %s\n", pPage
2f5b0 72 2c 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c 65 r, pPager->zFile
2f5c0 6e 61 6d 65 29 29 0a 0a 20 20 70 50 61 67 65 72 name)).. pPager
2f5d0 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 3d 20 28 ->useJournal = (
2f5e0 75 38 29 75 73 65 4a 6f 75 72 6e 61 6c 3b 0a 20 u8)useJournal;.
2f5f0 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 /* pPager->stmt
2f600 4f 70 65 6e 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f Open = 0; */. /
2f610 2a 20 70 50 61 67 65 72 2d 3e 73 74 6d 74 49 6e * pPager->stmtIn
2f620 55 73 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a Use = 0; */. /*
2f630 20 70 50 61 67 65 72 2d 3e 6e 52 65 66 20 3d 20 pPager->nRef =
2f640 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 0; */. /* pPage
2f650 72 2d 3e 73 74 6d 74 53 69 7a 65 20 3d 20 30 3b r->stmtSize = 0;
2f660 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d */. /* pPager-
2f670 3e 73 74 6d 74 4a 53 69 7a 65 20 3d 20 30 3b 20 >stmtJSize = 0;
2f680 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e */. /* pPager->
2f690 6e 50 61 67 65 20 3d 20 30 3b 20 2a 2f 0a 20 20 nPage = 0; */.
2f6a0 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 3d pPager->mxPgno =
2f6b0 20 53 51 4c 49 54 45 5f 4d 41 58 5f 50 41 47 45 SQLITE_MAX_PAGE
2f6c0 5f 43 4f 55 4e 54 3b 0a 20 20 2f 2a 20 70 50 61 _COUNT;. /* pPa
2f6d0 67 65 72 2d 3e 73 74 61 74 65 20 3d 20 50 41 47 ger->state = PAG
2f6e0 45 52 5f 55 4e 4c 4f 43 4b 3b 20 2a 2f 0a 20 20 ER_UNLOCK; */.
2f6f0 2f 2a 20 70 50 61 67 65 72 2d 3e 65 72 72 4d 61 /* pPager->errMa
2f700 73 6b 20 3d 20 30 3b 20 2a 2f 0a 20 20 70 50 61 sk = 0; */. pPa
2f710 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 3d 20 ger->tempFile =
2f720 28 75 38 29 74 65 6d 70 46 69 6c 65 3b 0a 20 20 (u8)tempFile;.
2f730 61 73 73 65 72 74 28 20 74 65 6d 70 46 69 6c 65 assert( tempFile
2f740 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e 47 4d ==PAGER_LOCKINGM
2f750 4f 44 45 5f 4e 4f 52 4d 41 4c 20 0a 20 20 20 20 ODE_NORMAL .
2f760 20 20 20 20 20 20 7c 7c 20 74 65 6d 70 46 69 6c || tempFil
2f770 65 3d 3d 50 41 47 45 52 5f 4c 4f 43 4b 49 4e 47 e==PAGER_LOCKING
2f780 4d 4f 44 45 5f 45 58 43 4c 55 53 49 56 45 20 29 MODE_EXCLUSIVE )
2f790 3b 0a 20 20 61 73 73 65 72 74 28 20 50 41 47 45 ;. assert( PAGE
2f7a0 52 5f 4c 4f 43 4b 49 4e 47 4d 4f 44 45 5f 45 58 R_LOCKINGMODE_EX
2f7b0 43 4c 55 53 49 56 45 3d 3d 31 20 29 3b 0a 20 20 CLUSIVE==1 );.
2f7c0 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 69 76 pPager->exclusiv
2f7d0 65 4d 6f 64 65 20 3d 20 28 75 38 29 74 65 6d 70 eMode = (u8)temp
2f7e0 46 69 6c 65 3b 20 0a 20 20 70 50 61 67 65 72 2d File; . pPager-
2f7f0 3e 63 68 61 6e 67 65 43 6f 75 6e 74 44 6f 6e 65 >changeCountDone
2f800 20 3d 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 = pPager->tempF
2f810 69 6c 65 3b 0a 20 20 70 50 61 67 65 72 2d 3e 6d ile;. pPager->m
2f820 65 6d 44 62 20 3d 20 28 75 38 29 6d 65 6d 44 62 emDb = (u8)memDb
2f830 3b 0a 20 20 70 50 61 67 65 72 2d 3e 72 65 61 64 ;. pPager->read
2f840 4f 6e 6c 79 20 3d 20 28 75 38 29 72 65 61 64 4f Only = (u8)readO
2f850 6e 6c 79 3b 0a 20 20 61 73 73 65 72 74 28 20 75 nly;. assert( u
2f860 73 65 4a 6f 75 72 6e 61 6c 20 7c 7c 20 70 50 61 seJournal || pPa
2f870 67 65 72 2d 3e 74 65 6d 70 46 69 6c 65 20 29 3b ger->tempFile );
2f880 0a 20 20 70 50 61 67 65 72 2d 3e 6e 6f 53 79 6e . pPager->noSyn
2f890 63 20 3d 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 c = pPager->temp
2f8a0 46 69 6c 65 3b 0a 20 20 69 66 28 20 70 50 61 67 File;. if( pPag
2f8b0 65 72 2d 3e 6e 6f 53 79 6e 63 20 29 7b 0a 20 20 er->noSync ){.
2f8c0 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
2f8d0 2d 3e 66 75 6c 6c 53 79 6e 63 3d 3d 30 20 29 3b ->fullSync==0 );
2f8e0 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 . assert( pPa
2f8f0 67 65 72 2d 3e 65 78 74 72 61 53 79 6e 63 3d 3d ger->extraSync==
2f900 30 20 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 0 );. assert(
2f910 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c 61 pPager->syncFla
2f920 67 73 3d 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 gs==0 );. ass
2f930 65 72 74 28 20 70 50 61 67 65 72 2d 3e 77 61 6c ert( pPager->wal
2f940 53 79 6e 63 46 6c 61 67 73 3d 3d 30 20 29 3b 0a SyncFlags==0 );.
2f950 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 70 50 61 }else{. pPa
2f960 67 65 72 2d 3e 66 75 6c 6c 53 79 6e 63 20 3d 20 ger->fullSync =
2f970 31 3b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 65 1;. pPager->e
2f980 78 74 72 61 53 79 6e 63 20 3d 20 30 3b 0a 20 20 xtraSync = 0;.
2f990 20 20 70 50 61 67 65 72 2d 3e 73 79 6e 63 46 6c pPager->syncFl
2f9a0 61 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e ags = SQLITE_SYN
2f9b0 43 5f 4e 4f 52 4d 41 4c 3b 0a 20 20 20 20 70 50 C_NORMAL;. pP
2f9c0 61 67 65 72 2d 3e 77 61 6c 53 79 6e 63 46 6c 61 ager->walSyncFla
2f9d0 67 73 20 3d 20 53 51 4c 49 54 45 5f 53 59 4e 43 gs = SQLITE_SYNC
2f9e0 5f 4e 4f 52 4d 41 4c 20 7c 20 28 53 51 4c 49 54 _NORMAL | (SQLIT
2f9f0 45 5f 53 59 4e 43 5f 4e 4f 52 4d 41 4c 3c 3c 32 E_SYNC_NORMAL<<2
2fa00 29 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 61 67 );. }. /* pPag
2fa10 65 72 2d 3e 70 46 69 72 73 74 20 3d 20 30 3b 20 er->pFirst = 0;
2fa20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e */. /* pPager->
2fa30 70 46 69 72 73 74 53 79 6e 63 65 64 20 3d 20 30 pFirstSynced = 0
2fa40 3b 20 2a 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 ; */. /* pPager
2fa50 2d 3e 70 4c 61 73 74 20 3d 20 30 3b 20 2a 2f 0a ->pLast = 0; */.
2fa60 20 20 70 50 61 67 65 72 2d 3e 6e 45 78 74 72 61 pPager->nExtra
2fa70 20 3d 20 28 75 31 36 29 6e 45 78 74 72 61 3b 0a = (u16)nExtra;.
2fa80 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 pPager->journa
2fa90 6c 53 69 7a 65 4c 69 6d 69 74 20 3d 20 53 51 4c lSizeLimit = SQL
2faa0 49 54 45 5f 44 45 46 41 55 4c 54 5f 4a 4f 55 52 ITE_DEFAULT_JOUR
2fab0 4e 41 4c 5f 53 49 5a 45 5f 4c 49 4d 49 54 3b 0a NAL_SIZE_LIMIT;.
2fac0 20 20 61 73 73 65 72 74 28 20 69 73 4f 70 65 6e assert( isOpen
2fad0 28 70 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 (pPager->fd) ||
2fae0 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 73 65 tempFile );. se
2faf0 74 53 65 63 74 6f 72 53 69 7a 65 28 70 50 61 67 tSectorSize(pPag
2fb00 65 72 29 3b 0a 20 20 69 66 28 20 21 75 73 65 4a er);. if( !useJ
2fb10 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 70 50 ournal ){. pP
2fb20 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f 64 ager->journalMod
2fb30 65 20 3d 20 50 41 47 45 52 5f 4a 4f 55 52 4e 41 e = PAGER_JOURNA
2fb40 4c 4d 4f 44 45 5f 4f 46 46 3b 0a 20 20 7d 65 6c LMODE_OFF;. }el
2fb50 73 65 20 69 66 28 20 6d 65 6d 44 62 20 29 7b 0a se if( memDb ){.
2fb60 20 20 20 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 pPager->jour
2fb70 6e 61 6c 4d 6f 64 65 20 3d 20 50 41 47 45 52 5f nalMode = PAGER_
2fb80 4a 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4d 45 4d 4f JOURNALMODE_MEMO
2fb90 52 59 3b 0a 20 20 7d 0a 20 20 2f 2a 20 70 50 61 RY;. }. /* pPa
2fba0 67 65 72 2d 3e 78 42 75 73 79 48 61 6e 64 6c 65 ger->xBusyHandle
2fbb0 72 20 3d 20 30 3b 20 2a 2f 0a 20 20 2f 2a 20 70 r = 0; */. /* p
2fbc0 50 61 67 65 72 2d 3e 70 42 75 73 79 48 61 6e 64 Pager->pBusyHand
2fbd0 6c 65 72 41 72 67 20 3d 20 30 3b 20 2a 2f 0a 20 lerArg = 0; */.
2fbe0 20 70 50 61 67 65 72 2d 3e 78 52 65 69 6e 69 74 pPager->xReinit
2fbf0 65 72 20 3d 20 78 52 65 69 6e 69 74 3b 0a 20 20 er = xReinit;.
2fc00 73 65 74 47 65 74 74 65 72 4d 65 74 68 6f 64 28 setGetterMethod(
2fc10 70 50 61 67 65 72 29 3b 0a 20 20 2f 2a 20 6d 65 pPager);. /* me
2fc20 6d 73 65 74 28 70 50 61 67 65 72 2d 3e 61 48 61 mset(pPager->aHa
2fc30 73 68 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 50 sh, 0, sizeof(pP
2fc40 61 67 65 72 2d 3e 61 48 61 73 68 29 29 3b 20 2a ager->aHash)); *
2fc50 2f 0a 20 20 2f 2a 20 70 50 61 67 65 72 2d 3e 73 /. /* pPager->s
2fc60 7a 4d 6d 61 70 20 3d 20 53 51 4c 49 54 45 5f 44 zMmap = SQLITE_D
2fc70 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
2fc80 20 2f 2f 20 77 69 6c 6c 20 62 65 20 73 65 74 20 // will be set
2fc90 62 79 20 62 74 72 65 65 2e 63 20 2a 2f 0a 0a 20 by btree.c */..
2fca0 20 2a 70 70 50 61 67 65 72 20 3d 20 70 50 61 67 *ppPager = pPag
2fcb0 65 72 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c er;. return SQL
2fcc0 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 20 56 ITE_OK;.}.../* V
2fcd0 65 72 69 66 79 20 74 68 61 74 20 74 68 65 20 64 erify that the d
2fce0 61 74 61 62 61 73 65 20 66 69 6c 65 20 68 61 73 atabase file has
2fcf0 20 6e 6f 74 20 62 65 20 64 65 6c 65 74 65 64 20 not be deleted
2fd00 6f 72 20 72 65 6e 61 6d 65 64 20 6f 75 74 20 66 or renamed out f
2fd10 72 6f 6d 0a 2a 2a 20 75 6e 64 65 72 20 74 68 65 rom.** under the
2fd20 20 70 61 67 65 72 2e 20 20 52 65 74 75 72 6e 20 pager. Return
2fd30 53 51 4c 49 54 45 5f 4f 4b 20 69 66 20 74 68 65 SQLITE_OK if the
2fd40 20 64 61 74 61 62 61 73 65 20 69 73 20 73 74 69 database is sti
2fd50 6c 6c 20 77 65 72 65 20 69 74 20 6f 75 67 68 74 ll were it ought
2fd60 0a 2a 2a 20 74 6f 20 62 65 20 6f 6e 20 64 69 73 .** to be on dis
2fd70 6b 2e 20 20 52 65 74 75 72 6e 20 6e 6f 6e 2d 7a k. Return non-z
2fd80 65 72 6f 20 28 53 51 4c 49 54 45 5f 52 45 41 44 ero (SQLITE_READ
2fd90 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 20 6f 72 20 ONLY_DBMOVED or
2fda0 73 6f 6d 65 20 6f 74 68 65 72 20 65 72 72 6f 72 some other error
2fdb0 0a 2a 2a 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 .** code from sq
2fdc0 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 29 lite3OsAccess())
2fdd0 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 if the database
2fde0 20 68 61 73 20 67 6f 6e 65 20 6d 69 73 73 69 6e has gone missin
2fdf0 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 g..*/.static int
2fe00 20 64 61 74 61 62 61 73 65 49 73 55 6e 6d 6f 76 databaseIsUnmov
2fe10 65 64 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 ed(Pager *pPager
2fe20 29 7b 0a 20 20 69 6e 74 20 62 48 61 73 4d 6f 76 ){. int bHasMov
2fe30 65 64 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 ed = 0;. int rc
2fe40 3b 0a 0a 20 20 69 66 28 20 70 50 61 67 65 72 2d ;.. if( pPager-
2fe50 3e 74 65 6d 70 46 69 6c 65 20 29 20 72 65 74 75 >tempFile ) retu
2fe60 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 rn SQLITE_OK;.
2fe70 69 66 28 20 70 50 61 67 65 72 2d 3e 64 62 53 69 if( pPager->dbSi
2fe80 7a 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 ze==0 ) return S
2fe90 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 QLITE_OK;. asse
2fea0 72 74 28 20 70 50 61 67 65 72 2d 3e 7a 46 69 6c rt( pPager->zFil
2feb0 65 6e 61 6d 65 20 26 26 20 70 50 61 67 65 72 2d ename && pPager-
2fec0 3e 7a 46 69 6c 65 6e 61 6d 65 5b 30 5d 20 29 3b >zFilename[0] );
2fed0 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f . rc = sqlite3O
2fee0 73 46 69 6c 65 43 6f 6e 74 72 6f 6c 28 70 50 61 sFileControl(pPa
2fef0 67 65 72 2d 3e 66 64 2c 20 53 51 4c 49 54 45 5f ger->fd, SQLITE_
2ff00 46 43 4e 54 4c 5f 48 41 53 5f 4d 4f 56 45 44 2c FCNTL_HAS_MOVED,
2ff10 20 26 62 48 61 73 4d 6f 76 65 64 29 3b 0a 20 20 &bHasMoved);.
2ff20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e if( rc==SQLITE_N
2ff30 4f 54 46 4f 55 4e 44 20 29 7b 0a 20 20 20 20 2f OTFOUND ){. /
2ff40 2a 20 49 66 20 74 68 65 20 48 41 53 5f 4d 4f 56 * If the HAS_MOV
2ff50 45 44 20 66 69 6c 65 2d 63 6f 6e 74 72 6f 6c 20 ED file-control
2ff60 69 73 20 75 6e 69 6d 70 6c 65 6d 65 6e 74 65 64 is unimplemented
2ff70 2c 20 61 73 73 75 6d 65 20 74 68 61 74 20 74 68 , assume that th
2ff80 65 20 66 69 6c 65 0a 20 20 20 20 2a 2a 20 68 61 e file. ** ha
2ff90 73 20 6e 6f 74 20 62 65 65 6e 20 6d 6f 76 65 64 s not been moved
2ffa0 2e 20 20 54 68 61 74 20 69 73 20 74 68 65 20 68 . That is the h
2ffb0 69 73 74 6f 72 69 63 61 6c 20 62 65 68 61 76 69 istorical behavi
2ffc0 6f 72 20 6f 66 20 53 51 4c 69 74 65 3a 20 70 72 or of SQLite: pr
2ffd0 69 6f 72 20 74 6f 0a 20 20 20 20 2a 2a 20 76 65 ior to. ** ve
2ffe0 72 73 69 6f 6e 20 33 2e 38 2e 33 2c 20 69 74 20 rsion 3.8.3, it
2fff0 6e 65 76 65 72 20 63 68 65 63 6b 65 64 20 2a 2f never checked */
30000 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 . rc = SQLITE
30010 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 _OK;. }else if(
30020 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
30030 26 20 62 48 61 73 4d 6f 76 65 64 20 29 7b 0a 20 & bHasMoved ){.
30040 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 rc = SQLITE_R
30050 45 41 44 4f 4e 4c 59 5f 44 42 4d 4f 56 45 44 3b EADONLY_DBMOVED;
30060 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 . }. return rc
30070 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ;.}.../*.** This
30080 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
30090 6c 65 64 20 61 66 74 65 72 20 74 72 61 6e 73 69 led after transi
300a0 74 69 6f 6e 69 6e 67 20 66 72 6f 6d 20 50 41 47 tioning from PAG
300b0 45 52 5f 55 4e 4c 4f 43 4b 20 74 6f 0a 2a 2a 20 ER_UNLOCK to.**
300c0 50 41 47 45 52 5f 53 48 41 52 45 44 20 73 74 61 PAGER_SHARED sta
300d0 74 65 2e 20 49 74 20 74 65 73 74 73 20 69 66 20 te. It tests if
300e0 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 20 6a there is a hot j
300f0 6f 75 72 6e 61 6c 20 70 72 65 73 65 6e 74 20 69 ournal present i
30100 6e 0a 2a 2a 20 74 68 65 20 66 69 6c 65 2d 73 79 n.** the file-sy
30110 73 74 65 6d 20 66 6f 72 20 74 68 65 20 67 69 76 stem for the giv
30120 65 6e 20 70 61 67 65 72 2e 20 41 20 68 6f 74 20 en pager. A hot
30130 6a 6f 75 72 6e 61 6c 20 69 73 20 6f 6e 65 20 74 journal is one t
30140 68 61 74 20 0a 2a 2a 20 6e 65 65 64 73 20 74 6f hat .** needs to
30150 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 6b 2e be played back.
30160 20 41 63 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 According to th
30170 69 73 20 66 75 6e 63 74 69 6f 6e 2c 20 61 20 68 is function, a h
30180 6f 74 2d 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 66 69 ot-journal.** fi
30190 6c 65 20 65 78 69 73 74 73 20 69 66 20 74 68 65 le exists if the
301a0 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 72 69 74 65 following crite
301b0 72 69 61 20 61 72 65 20 6d 65 74 3a 0a 2a 2a 0a ria are met:.**.
301c0 2a 2a 20 20 20 2a 20 54 68 65 20 6a 6f 75 72 6e ** * The journ
301d0 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 20 69 al file exists i
301e0 6e 20 74 68 65 20 66 69 6c 65 20 73 79 73 74 65 n the file syste
301f0 6d 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 4e 6f m, and.** * No
30200 20 70 72 6f 63 65 73 73 20 68 6f 6c 64 73 20 61 process holds a
30210 20 52 45 53 45 52 56 45 44 20 6f 72 20 67 72 65 RESERVED or gre
30220 61 74 65 72 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 ater lock on the
30230 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
30240 61 6e 64 0a 2a 2a 20 20 20 2a 20 54 68 65 20 64 and.** * The d
30250 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 74 73 atabase file its
30260 65 6c 66 20 69 73 20 67 72 65 61 74 65 72 20 74 elf is greater t
30270 68 61 6e 20 30 20 62 79 74 65 73 20 69 6e 20 73 han 0 bytes in s
30280 69 7a 65 2c 20 61 6e 64 0a 2a 2a 20 20 20 2a 20 ize, and.** *
30290 54 68 65 20 66 69 72 73 74 20 62 79 74 65 20 6f The first byte o
302a0 66 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 f the journal fi
302b0 6c 65 20 65 78 69 73 74 73 20 61 6e 64 20 69 73 le exists and is
302c0 20 6e 6f 74 20 30 78 30 30 2e 0a 2a 2a 0a 2a 2a not 0x00..**.**
302d0 20 49 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 If the current
302e0 73 69 7a 65 20 6f 66 20 74 68 65 20 64 61 74 61 size of the data
302f0 62 61 73 65 20 66 69 6c 65 20 69 73 20 30 20 62 base file is 0 b
30300 75 74 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c ut a journal fil
30310 65 0a 2a 2a 20 65 78 69 73 74 73 2c 20 74 68 61 e.** exists, tha
30320 74 20 69 73 20 70 72 6f 62 61 62 6c 79 20 61 6e t is probably an
30330 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 6c 65 66 old journal lef
30340 74 20 6f 76 65 72 20 66 72 6f 6d 20 61 20 70 72 t over from a pr
30350 69 6f 72 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 ior.** database
30360 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61 with the same na
30370 6d 65 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 me. In this case
30380 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
30390 65 20 69 73 0a 2a 2a 20 6a 75 73 74 20 64 65 6c e is.** just del
303a0 65 74 65 64 20 75 73 69 6e 67 20 4f 73 44 65 6c eted using OsDel
303b0 65 74 65 2c 20 2a 70 45 78 69 73 74 73 20 69 73 ete, *pExists is
303c0 20 73 65 74 20 74 6f 20 30 20 61 6e 64 20 53 51 set to 0 and SQ
303d0 4c 49 54 45 5f 4f 4b 0a 2a 2a 20 69 73 20 72 65 LITE_OK.** is re
303e0 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 turned..**.** Th
303f0 69 73 20 72 6f 75 74 69 6e 65 20 64 6f 65 73 20 is routine does
30400 6e 6f 74 20 63 68 65 63 6b 20 69 66 20 74 68 65 not check if the
30410 72 65 20 69 73 20 61 20 6d 61 73 74 65 72 20 6a re is a master j
30420 6f 75 72 6e 61 6c 20 66 69 6c 65 6e 61 6d 65 0a ournal filename.
30430 2a 2a 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 ** at the end of
30440 20 74 68 65 20 66 69 6c 65 2e 20 49 66 20 74 68 the file. If th
30450 65 72 65 20 69 73 2c 20 61 6e 64 20 74 68 61 74 ere is, and that
30460 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 master journal
30470 66 69 6c 65 0a 2a 2a 20 64 6f 65 73 20 6e 6f 74 file.** does not
30480 20 65 78 69 73 74 2c 20 74 68 65 6e 20 74 68 65 exist, then the
30490 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 journal file is
304a0 20 6e 6f 74 20 72 65 61 6c 6c 79 20 68 6f 74 2e not really hot.
304b0 20 49 6e 20 74 68 69 73 0a 2a 2a 20 63 61 73 65 In this.** case
304c0 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 this routine wi
304d0 6c 6c 20 72 65 74 75 72 6e 20 61 20 66 61 6c 73 ll return a fals
304e0 65 2d 70 6f 73 69 74 69 76 65 2e 20 54 68 65 20 e-positive. The
304f0 70 61 67 65 72 5f 70 6c 61 79 62 61 63 6b 28 29 pager_playback()
30500 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c .** routine will
30510 20 64 69 73 63 6f 76 65 72 20 74 68 61 74 20 74 discover that t
30520 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
30530 69 73 20 6e 6f 74 20 72 65 61 6c 6c 79 20 68 6f is not really ho
30540 74 20 61 6e 64 20 0a 2a 2a 20 77 69 6c 6c 20 6e t and .** will n
30550 6f 74 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b 2e ot roll it back.
30560 20 0a 2a 2a 0a 2a 2a 20 49 66 20 61 20 68 6f 74 .**.** If a hot
30570 2d 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 -journal file is
30580 20 66 6f 75 6e 64 20 74 6f 20 65 78 69 73 74 2c found to exist,
30590 20 2a 70 45 78 69 73 74 73 20 69 73 20 73 65 74 *pExists is set
305a0 20 74 6f 20 31 20 61 6e 64 20 0a 2a 2a 20 53 51 to 1 and .** SQ
305b0 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 6e 65 64 LITE_OK returned
305c0 2e 20 49 66 20 6e 6f 20 68 6f 74 2d 6a 6f 75 72 . If no hot-jour
305d0 6e 61 6c 20 66 69 6c 65 20 69 73 20 70 72 65 73 nal file is pres
305e0 65 6e 74 2c 20 2a 70 45 78 69 73 74 73 20 69 73 ent, *pExists is
305f0 0a 2a 2a 20 73 65 74 20 74 6f 20 30 20 61 6e 64 .** set to 0 and
30600 20 53 51 4c 49 54 45 5f 4f 4b 20 72 65 74 75 72 SQLITE_OK retur
30610 6e 65 64 2e 20 49 66 20 61 6e 20 49 4f 20 65 72 ned. If an IO er
30620 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c 65 ror occurs while
30630 20 74 72 79 69 6e 67 0a 2a 2a 20 74 6f 20 64 65 trying.** to de
30640 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 termine whether
30650 6f 72 20 6e 6f 74 20 61 20 68 6f 74 2d 6a 6f 75 or not a hot-jou
30660 72 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 rnal file exists
30670 2c 20 74 68 65 20 49 4f 20 65 72 72 6f 72 0a 2a , the IO error.*
30680 2a 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e * code is return
30690 65 64 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 ed and the value
306a0 20 6f 66 20 2a 70 45 78 69 73 74 73 20 69 73 20 of *pExists is
306b0 75 6e 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 73 74 undefined..*/.st
306c0 61 74 69 63 20 69 6e 74 20 68 61 73 48 6f 74 4a atic int hasHotJ
306d0 6f 75 72 6e 61 6c 28 50 61 67 65 72 20 2a 70 50 ournal(Pager *pP
306e0 61 67 65 72 2c 20 69 6e 74 20 2a 70 45 78 69 73 ager, int *pExis
306f0 74 73 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 ts){. sqlite3_v
30700 66 73 20 2a 20 63 6f 6e 73 74 20 70 56 66 73 20 fs * const pVfs
30710 3d 20 70 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a = pPager->pVfs;.
30720 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
30730 45 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 E_OK;
30740 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 2a /* Return code *
30750 2f 0a 20 20 69 6e 74 20 65 78 69 73 74 73 20 3d /. int exists =
30760 20 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 1;
30770 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 20 6a /* True if a j
30780 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 70 ournal file is p
30790 72 65 73 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 resent */. int
307a0 6a 72 6e 6c 4f 70 65 6e 20 3d 20 21 21 69 73 4f jrnlOpen = !!isO
307b0 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 pen(pPager->jfd)
307c0 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 ;.. assert( pPa
307d0 67 65 72 2d 3e 75 73 65 4a 6f 75 72 6e 61 6c 20 ger->useJournal
307e0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 73 4f );. assert( isO
307f0 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 29 20 pen(pPager->fd)
30800 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
30810 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 ger->eState==PAG
30820 45 52 5f 4f 50 45 4e 20 29 3b 0a 0a 20 20 61 73 ER_OPEN );.. as
30830 73 65 72 74 28 20 6a 72 6e 6c 4f 70 65 6e 3d 3d sert( jrnlOpen==
30840 30 20 7c 7c 20 28 20 73 71 6c 69 74 65 33 4f 73 0 || ( sqlite3Os
30850 44 65 76 69 63 65 43 68 61 72 61 63 74 65 72 69 DeviceCharacteri
30860 73 74 69 63 73 28 70 50 61 67 65 72 2d 3e 6a 66 stics(pPager->jf
30870 64 29 20 26 0a 20 20 20 20 53 51 4c 49 54 45 5f d) &. SQLITE_
30880 49 4f 43 41 50 5f 55 4e 44 45 4c 45 54 41 42 4c IOCAP_UNDELETABL
30890 45 5f 57 48 45 4e 5f 4f 50 45 4e 0a 20 20 29 29 E_WHEN_OPEN. ))
308a0 3b 0a 0a 20 20 2a 70 45 78 69 73 74 73 20 3d 20 ;.. *pExists =
308b0 30 3b 0a 20 20 69 66 28 20 21 6a 72 6e 6c 4f 70 0;. if( !jrnlOp
308c0 65 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 en ){. rc = s
308d0 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 70 qlite3OsAccess(p
308e0 56 66 73 2c 20 70 50 61 67 65 72 2d 3e 7a 4a 6f Vfs, pPager->zJo
308f0 75 72 6e 61 6c 2c 20 53 51 4c 49 54 45 5f 41 43 urnal, SQLITE_AC
30900 43 45 53 53 5f 45 58 49 53 54 53 2c 20 26 65 78 CESS_EXISTS, &ex
30910 69 73 74 73 29 3b 0a 20 20 7d 0a 20 20 69 66 28 ists);. }. if(
30920 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
30930 26 20 65 78 69 73 74 73 20 29 7b 0a 20 20 20 20 & exists ){.
30940 69 6e 74 20 6c 6f 63 6b 65 64 20 3d 20 30 3b 20 int locked = 0;
30950 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
30960 72 75 65 20 69 66 20 73 6f 6d 65 20 70 72 6f 63 rue if some proc
30970 65 73 73 20 68 6f 6c 64 73 20 61 20 52 45 53 45 ess holds a RESE
30980 52 56 45 44 20 6c 6f 63 6b 20 2a 2f 0a 0a 20 20 RVED lock */..
30990 20 20 2f 2a 20 52 61 63 65 20 63 6f 6e 64 69 74 /* Race condit
309a0 69 6f 6e 20 68 65 72 65 3a 20 20 41 6e 6f 74 68 ion here: Anoth
309b0 65 72 20 70 72 6f 63 65 73 73 20 6d 69 67 68 74 er process might
309c0 20 68 61 76 65 20 62 65 65 6e 20 68 6f 6c 64 69 have been holdi
309d0 6e 67 20 74 68 65 0a 20 20 20 20 2a 2a 20 74 68 ng the. ** th
309e0 65 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 e RESERVED lock
309f0 61 6e 64 20 68 61 76 65 20 61 20 6a 6f 75 72 6e and have a journ
30a00 61 6c 20 6f 70 65 6e 20 61 74 20 74 68 65 20 73 al open at the s
30a10 71 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 29 qlite3OsAccess()
30a20 20 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 20 61 62 . ** call ab
30a30 6f 76 65 2c 20 62 75 74 20 74 68 65 6e 20 64 65 ove, but then de
30a40 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c lete the journal
30a50 20 61 6e 64 20 64 72 6f 70 20 74 68 65 20 6c 6f and drop the lo
30a60 63 6b 20 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a ck before. **
30a70 20 77 65 20 67 65 74 20 74 6f 20 74 68 65 20 66 we get to the f
30a80 6f 6c 6c 6f 77 69 6e 67 20 73 71 6c 69 74 65 33 ollowing sqlite3
30a90 4f 73 43 68 65 63 6b 52 65 73 65 72 76 65 64 4c OsCheckReservedL
30aa0 6f 63 6b 28 29 20 63 61 6c 6c 2e 20 20 49 66 20 ock() call. If
30ab0 74 68 61 74 0a 20 20 20 20 2a 2a 20 69 73 20 74 that. ** is t
30ac0 68 65 20 63 61 73 65 2c 20 74 68 69 73 20 72 6f he case, this ro
30ad0 75 74 69 6e 65 20 6d 69 67 68 74 20 74 68 69 6e utine might thin
30ae0 6b 20 74 68 65 72 65 20 69 73 20 61 20 68 6f 74 k there is a hot
30af0 20 6a 6f 75 72 6e 61 6c 20 77 68 65 6e 0a 20 20 journal when.
30b00 20 20 2a 2a 20 69 6e 20 66 61 63 74 20 74 68 65 ** in fact the
30b10 72 65 20 69 73 20 6e 6f 6e 65 2e 20 20 54 68 69 re is none. Thi
30b20 73 20 72 65 73 75 6c 74 73 20 69 6e 20 61 20 66 s results in a f
30b30 61 6c 73 65 2d 70 6f 73 69 74 69 76 65 20 77 68 alse-positive wh
30b40 69 63 68 20 77 69 6c 6c 0a 20 20 20 20 2a 2a 20 ich will. **
30b50 62 65 20 64 65 61 6c 74 20 77 69 74 68 20 62 79 be dealt with by
30b60 20 74 68 65 20 70 6c 61 79 62 61 63 6b 20 72 6f the playback ro
30b70 75 74 69 6e 65 2e 20 20 54 69 63 6b 65 74 20 23 utine. Ticket #
30b80 33 38 38 33 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 3883.. */.
30b90 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 43 rc = sqlite3OsC
30ba0 68 65 63 6b 52 65 73 65 72 76 65 64 4c 6f 63 6b heckReservedLock
30bb0 28 70 50 61 67 65 72 2d 3e 66 64 2c 20 26 6c 6f (pPager->fd, &lo
30bc0 63 6b 65 64 29 3b 0a 20 20 20 20 69 66 28 20 72 cked);. if( r
30bd0 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
30be0 21 6c 6f 63 6b 65 64 20 29 7b 0a 20 20 20 20 20 !locked ){.
30bf0 20 50 67 6e 6f 20 6e 50 61 67 65 3b 20 20 20 20 Pgno nPage;
30c00 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
30c10 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
30c20 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 in database file
30c30 20 2a 2f 0a 0a 20 20 20 20 20 20 61 73 73 65 72 */.. asser
30c40 74 28 20 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 t( pPager->tempF
30c50 69 6c 65 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 ile==0 );.
30c60 72 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f rc = pagerPageco
30c70 75 6e 74 28 70 50 61 67 65 72 2c 20 26 6e 50 61 unt(pPager, &nPa
30c80 67 65 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 ge);. if( r
30c90 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
30ca0 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 /* If th
30cb0 65 20 64 61 74 61 62 61 73 65 20 69 73 20 7a 65 e database is ze
30cc0 72 6f 20 70 61 67 65 73 20 69 6e 20 73 69 7a 65 ro pages in size
30cd0 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 , that means tha
30ce0 74 20 65 69 74 68 65 72 20 28 31 29 20 74 68 65 t either (1) the
30cf0 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f 75 72 . ** jour
30d00 6e 61 6c 20 69 73 20 61 20 72 65 6d 6e 61 6e 74 nal is a remnant
30d10 20 66 72 6f 6d 20 61 20 70 72 69 6f 72 20 64 61 from a prior da
30d20 74 61 62 61 73 65 20 77 69 74 68 20 74 68 65 20 tabase with the
30d30 73 61 6d 65 20 6e 61 6d 65 20 77 68 65 72 65 0a same name where.
30d40 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 64 ** the d
30d50 61 74 61 62 61 73 65 20 66 69 6c 65 20 62 75 74 atabase file but
30d60 20 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c not the journal
30d70 20 77 61 73 20 64 65 6c 65 74 65 64 2c 20 6f 72 was deleted, or
30d80 20 28 32 29 20 74 68 65 20 69 6e 69 74 69 61 6c (2) the initial
30d90 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 72 61 6e . ** tran
30da0 73 61 63 74 69 6f 6e 20 74 68 61 74 20 70 6f 70 saction that pop
30db0 75 6c 61 74 65 73 20 61 20 6e 65 77 20 64 61 74 ulates a new dat
30dc0 61 62 61 73 65 20 69 73 20 62 65 69 6e 67 20 72 abase is being r
30dd0 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 20 20 olled back..
30de0 20 20 20 20 2a 2a 20 49 6e 20 65 69 74 68 65 72 ** In either
30df0 20 63 61 73 65 2c 20 74 68 65 20 6a 6f 75 72 6e case, the journ
30e00 61 6c 20 66 69 6c 65 20 63 61 6e 20 62 65 20 64 al file can be d
30e10 65 6c 65 74 65 64 2e 20 20 48 6f 77 65 76 65 72 eleted. However
30e20 2c 20 74 61 6b 65 20 63 61 72 65 0a 20 20 20 20 , take care.
30e30 20 20 20 20 2a 2a 20 6e 6f 74 20 74 6f 20 64 65 ** not to de
30e40 6c 65 74 65 20 74 68 65 20 6a 6f 75 72 6e 61 6c lete the journal
30e50 20 66 69 6c 65 20 69 66 20 69 74 20 69 73 20 61 file if it is a
30e60 6c 72 65 61 64 79 20 6f 70 65 6e 20 64 75 65 20 lready open due
30e70 74 6f 0a 20 20 20 20 20 20 20 20 2a 2a 20 6a 6f to. ** jo
30e80 75 72 6e 61 6c 5f 6d 6f 64 65 3d 50 45 52 53 49 urnal_mode=PERSI
30e90 53 54 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 ST.. */.
30ea0 20 20 20 20 20 20 20 69 66 28 20 6e 50 61 67 65 if( nPage
30eb0 3d 3d 30 20 26 26 20 21 6a 72 6e 6c 4f 70 65 6e ==0 && !jrnlOpen
30ec0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 ){. sq
30ed0 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
30ee0 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 20 Malloc();.
30ef0 20 20 20 20 69 66 28 20 70 61 67 65 72 4c 6f 63 if( pagerLoc
30f00 6b 44 62 28 70 50 61 67 65 72 2c 20 52 45 53 45 kDb(pPager, RESE
30f10 52 56 45 44 5f 4c 4f 43 4b 29 3d 3d 53 51 4c 49 RVED_LOCK)==SQLI
30f20 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
30f30 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 sqlite3OsDe
30f40 6c 65 74 65 28 70 56 66 73 2c 20 70 50 61 67 65 lete(pVfs, pPage
30f50 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 30 29 3b r->zJournal, 0);
30f60 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 . if(
30f70 20 21 70 50 61 67 65 72 2d 3e 65 78 63 6c 75 73 !pPager->exclus
30f80 69 76 65 4d 6f 64 65 20 29 20 70 61 67 65 72 55 iveMode ) pagerU
30f90 6e 6c 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 nlockDb(pPager,
30fa0 53 48 41 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 SHARED_LOCK);.
30fb0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
30fc0 20 20 20 20 73 71 6c 69 74 65 33 45 6e 64 42 65 sqlite3EndBe
30fd0 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 nignMalloc();.
30fe0 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
30ff0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6a 6f /* The jo
31000 75 72 6e 61 6c 20 66 69 6c 65 20 65 78 69 73 74 urnal file exist
31010 73 20 61 6e 64 20 6e 6f 20 6f 74 68 65 72 20 63 s and no other c
31020 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 61 20 onnection has a
31030 72 65 73 65 72 76 65 64 0a 20 20 20 20 20 20 20 reserved.
31040 20 20 20 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 ** or greater
31050 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 74 lock on the dat
31060 61 62 61 73 65 20 66 69 6c 65 2e 20 4e 6f 77 20 abase file. Now
31070 63 68 65 63 6b 20 74 68 61 74 20 74 68 65 72 65 check that there
31080 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a is. **
31090 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 6e 6f at least one no
310a0 6e 2d 7a 65 72 6f 20 62 79 74 65 73 20 61 74 20 n-zero bytes at
310b0 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 the start of the
310c0 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a 20 journal file..
310d0 20 20 20 20 20 20 20 20 20 2a 2a 20 49 66 20 74 ** If t
310e0 68 65 72 65 20 69 73 2c 20 74 68 65 6e 20 77 65 here is, then we
310f0 20 63 6f 6e 73 69 64 65 72 20 74 68 69 73 20 6a consider this j
31100 6f 75 72 6e 61 6c 20 74 6f 20 62 65 20 68 6f 74 ournal to be hot
31110 2e 20 49 66 20 6e 6f 74 2c 20 0a 20 20 20 20 20 . If not, .
31120 20 20 20 20 20 2a 2a 20 69 74 20 63 61 6e 20 62 ** it can b
31130 65 20 69 67 6e 6f 72 65 64 2e 0a 20 20 20 20 20 e ignored..
31140 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 */.
31150 20 20 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 if( !jrnlOpen
31160 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 ){. i
31170 6e 74 20 66 20 3d 20 53 51 4c 49 54 45 5f 4f 50 nt f = SQLITE_OP
31180 45 4e 5f 52 45 41 44 4f 4e 4c 59 7c 53 51 4c 49 EN_READONLY|SQLI
31190 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 TE_OPEN_MAIN_JOU
311a0 52 4e 41 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 RNAL;.
311b0 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 rc = sqlite3Os
311c0 4f 70 65 6e 28 70 56 66 73 2c 20 70 50 61 67 65 Open(pVfs, pPage
311d0 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 70 50 61 r->zJournal, pPa
311e0 67 65 72 2d 3e 6a 66 64 2c 20 66 2c 20 26 66 29 ger->jfd, f, &f)
311f0 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
31200 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d if( rc==
31210 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
31220 20 20 20 20 20 20 20 20 20 75 38 20 66 69 72 73 u8 firs
31230 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 t = 0;.
31240 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f rc = sqlite3O
31250 73 52 65 61 64 28 70 50 61 67 65 72 2d 3e 6a 66 sRead(pPager->jf
31260 64 2c 20 28 76 6f 69 64 20 2a 29 26 66 69 72 73 d, (void *)&firs
31270 74 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 t, 1, 0);.
31280 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 if( rc==SQ
31290 4c 49 54 45 5f 49 4f 45 52 52 5f 53 48 4f 52 54 LITE_IOERR_SHORT
312a0 5f 52 45 41 44 20 29 7b 0a 20 20 20 20 20 20 20 _READ ){.
312b0 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 rc = SQLI
312c0 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 20 20 TE_OK;.
312d0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 }.
312e0 20 69 66 28 20 21 6a 72 6e 6c 4f 70 65 6e 20 29 if( !jrnlOpen )
312f0 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {.
31300 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 70 sqlite3OsClose(p
31310 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 Pager->jfd);.
31320 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
31330 20 20 20 20 20 20 20 2a 70 45 78 69 73 74 73 20 *pExists
31340 3d 20 28 66 69 72 73 74 21 3d 30 29 3b 0a 20 20 = (first!=0);.
31350 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 }else if
31360 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 43 41 4e ( rc==SQLITE_CAN
31370 54 4f 50 45 4e 20 29 7b 0a 20 20 20 20 20 20 20 TOPEN ){.
31380 20 20 20 20 20 2f 2a 20 49 66 20 77 65 20 63 61 /* If we ca
31390 6e 6e 6f 74 20 6f 70 65 6e 20 74 68 65 20 72 6f nnot open the ro
313a0 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e 61 6c 20 66 llback journal f
313b0 69 6c 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ile in order to
313c0 73 65 65 20 69 66 0a 20 20 20 20 20 20 20 20 20 see if.
313d0 20 20 20 2a 2a 20 69 74 20 68 61 73 20 61 20 7a ** it has a z
313e0 65 72 6f 20 68 65 61 64 65 72 2c 20 74 68 61 74 ero header, that
313f0 20 6d 69 67 68 74 20 62 65 20 64 75 65 20 74 6f might be due to
31400 20 61 6e 20 49 2f 4f 20 65 72 72 6f 72 2c 20 6f an I/O error, o
31410 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a r. **
31420 20 69 74 20 6d 69 67 68 74 20 62 65 20 64 75 65 it might be due
31430 20 74 6f 20 74 68 65 20 72 61 63 65 20 63 6f 6e to the race con
31440 64 69 74 69 6f 6e 20 64 65 73 63 72 69 62 65 64 dition described
31450 20 61 62 6f 76 65 20 61 6e 64 20 69 6e 0a 20 20 above and in.
31460 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 69 63 ** tic
31470 6b 65 74 20 23 33 38 38 33 2e 20 20 45 69 74 68 ket #3883. Eith
31480 65 72 20 77 61 79 2c 20 61 73 73 75 6d 65 20 74 er way, assume t
31490 68 61 74 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hat the journal
314a0 69 73 20 68 6f 74 2e 0a 20 20 20 20 20 20 20 20 is hot..
314b0 20 20 20 20 2a 2a 20 54 68 69 73 20 6d 69 67 68 ** This migh
314c0 74 20 62 65 20 61 20 66 61 6c 73 65 20 70 6f 73 t be a false pos
314d0 69 74 69 76 65 2e 20 20 42 75 74 20 69 66 20 69 itive. But if i
314e0 74 20 69 73 2c 20 74 68 65 6e 20 74 68 65 0a 20 t is, then the.
314f0 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 75 ** au
31500 74 6f 6d 61 74 69 63 20 6a 6f 75 72 6e 61 6c 20 tomatic journal
31510 70 6c 61 79 62 61 63 6b 20 61 6e 64 20 72 65 63 playback and rec
31520 6f 76 65 72 79 20 6d 65 63 68 61 6e 69 73 6d 20 overy mechanism
31530 77 69 6c 6c 20 64 65 61 6c 0a 20 20 20 20 20 20 will deal.
31540 20 20 20 20 20 20 2a 2a 20 77 69 74 68 20 69 74 ** with it
31550 20 75 6e 64 65 72 20 61 6e 20 45 58 43 4c 55 53 under an EXCLUS
31560 49 56 45 20 6c 6f 63 6b 20 77 68 65 72 65 20 77 IVE lock where w
31570 65 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f e do not need to
31580 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 . **
31590 77 6f 72 72 79 20 73 6f 20 6d 75 63 68 20 77 69 worry so much wi
315a0 74 68 20 72 61 63 65 20 63 6f 6e 64 69 74 69 6f th race conditio
315b0 6e 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 ns..
315c0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a */. *
315d0 70 45 78 69 73 74 73 20 3d 20 31 3b 0a 20 20 20 pExists = 1;.
315e0 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 rc = SQ
315f0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 20 LITE_OK;.
31600 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
31610 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
31620 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d .. return rc;.}
31630 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
31640 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
31650 74 6f 20 6f 62 74 61 69 6e 20 61 20 73 68 61 72 to obtain a shar
31660 65 64 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 ed lock on the d
31670 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a atabase file..**
31680 20 49 74 20 69 73 20 69 6c 6c 65 67 61 6c 20 74 It is illegal t
31690 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 50 61 o call sqlite3Pa
316a0 67 65 72 47 65 74 28 29 20 75 6e 74 69 6c 20 61 gerGet() until a
316b0 66 74 65 72 20 74 68 69 73 20 66 75 6e 63 74 69 fter this functi
316c0 6f 6e 0a 2a 2a 20 68 61 73 20 62 65 65 6e 20 73 on.** has been s
316d0 75 63 63 65 73 73 66 75 6c 6c 79 20 63 61 6c 6c uccessfully call
316e0 65 64 2e 20 49 66 20 61 20 73 68 61 72 65 64 2d ed. If a shared-
316f0 6c 6f 63 6b 20 69 73 20 61 6c 72 65 61 64 79 20 lock is already
31700 68 65 6c 64 20 77 68 65 6e 0a 2a 2a 20 74 68 69 held when.** thi
31710 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 s function is ca
31720 6c 6c 65 64 2c 20 69 74 20 69 73 20 61 20 6e 6f lled, it is a no
31730 2d 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 -op..**.** The f
31740 6f 6c 6c 6f 77 69 6e 67 20 6f 70 65 72 61 74 69 ollowing operati
31750 6f 6e 73 20 61 72 65 20 61 6c 73 6f 20 70 65 72 ons are also per
31760 66 6f 72 6d 65 64 20 62 79 20 74 68 69 73 20 66 formed by this f
31770 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 unction..**.**
31780 20 31 29 20 49 66 20 74 68 65 20 70 61 67 65 72 1) If the pager
31790 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e is currently in
317a0 20 50 41 47 45 52 5f 4f 50 45 4e 20 73 74 61 74 PAGER_OPEN stat
317b0 65 20 28 6e 6f 20 6c 6f 63 6b 20 68 65 6c 64 0a e (no lock held.
317c0 2a 2a 20 20 20 20 20 20 6f 6e 20 74 68 65 20 64 ** on the d
317d0 61 74 61 62 61 73 65 20 66 69 6c 65 29 2c 20 74 atabase file), t
317e0 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 20 69 hen an attempt i
317f0 73 20 6d 61 64 65 20 74 6f 20 6f 62 74 61 69 6e s made to obtain
31800 20 61 0a 2a 2a 20 20 20 20 20 20 53 48 41 52 45 a.** SHARE
31810 44 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 64 61 D lock on the da
31820 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 6d 6d tabase file. Imm
31830 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 6f ediately after o
31840 62 74 61 69 6e 69 6e 67 0a 2a 2a 20 20 20 20 20 btaining.**
31850 20 74 68 65 20 53 48 41 52 45 44 20 6c 6f 63 6b the SHARED lock
31860 2c 20 74 68 65 20 66 69 6c 65 2d 73 79 73 74 65 , the file-syste
31870 6d 20 69 73 20 63 68 65 63 6b 65 64 20 66 6f 72 m is checked for
31880 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 2c 0a a hot-journal,.
31890 2a 2a 20 20 20 20 20 20 77 68 69 63 68 20 69 73 ** which is
318a0 20 70 6c 61 79 65 64 20 62 61 63 6b 20 69 66 20 played back if
318b0 70 72 65 73 65 6e 74 2e 20 46 6f 6c 6c 6f 77 69 present. Followi
318c0 6e 67 20 61 6e 79 20 68 6f 74 2d 6a 6f 75 72 6e ng any hot-journ
318d0 61 6c 20 0a 2a 2a 20 20 20 20 20 20 72 6f 6c 6c al .** roll
318e0 62 61 63 6b 2c 20 74 68 65 20 63 6f 6e 74 65 6e back, the conten
318f0 74 73 20 6f 66 20 74 68 65 20 63 61 63 68 65 20 ts of the cache
31900 61 72 65 20 76 61 6c 69 64 61 74 65 64 20 62 79 are validated by
31910 20 63 68 65 63 6b 69 6e 67 0a 2a 2a 20 20 20 20 checking.**
31920 20 20 74 68 65 20 27 63 68 61 6e 67 65 2d 63 6f the 'change-co
31930 75 6e 74 65 72 27 20 66 69 65 6c 64 20 6f 66 20 unter' field of
31940 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
31950 65 20 68 65 61 64 65 72 20 61 6e 64 0a 2a 2a 20 e header and.**
31960 20 20 20 20 20 64 69 73 63 61 72 64 65 64 20 69 discarded i
31970 66 20 74 68 65 79 20 61 72 65 20 66 6f 75 6e 64 f they are found
31980 20 74 6f 20 62 65 20 69 6e 76 61 6c 69 64 2e 0a to be invalid..
31990 2a 2a 0a 2a 2a 20 20 20 32 29 20 49 66 20 74 68 **.** 2) If th
319a0 65 20 70 61 67 65 72 20 69 73 20 72 75 6e 6e 69 e pager is runni
319b0 6e 67 20 69 6e 20 65 78 63 6c 75 73 69 76 65 2d ng in exclusive-
319c0 6d 6f 64 65 2c 20 61 6e 64 20 74 68 65 72 65 20 mode, and there
319d0 61 72 65 20 63 75 72 72 65 6e 74 6c 79 0a 2a 2a are currently.**
319e0 20 20 20 20 20 20 6e 6f 20 6f 75 74 73 74 61 6e no outstan
319f0 64 69 6e 67 20 72 65 66 65 72 65 6e 63 65 73 20 ding references
31a00 74 6f 20 61 6e 79 20 70 61 67 65 73 2c 20 61 6e to any pages, an
31a10 64 20 69 73 20 69 6e 20 74 68 65 20 65 72 72 6f d is in the erro
31a20 72 20 73 74 61 74 65 2c 0a 2a 2a 20 20 20 20 20 r state,.**
31a30 20 74 68 65 6e 20 61 6e 20 61 74 74 65 6d 70 74 then an attempt
31a40 20 69 73 20 6d 61 64 65 20 74 6f 20 63 6c 65 61 is made to clea
31a50 72 20 74 68 65 20 65 72 72 6f 72 20 73 74 61 74 r the error stat
31a60 65 20 62 79 20 64 69 73 63 61 72 64 69 6e 67 0a e by discarding.
31a70 2a 2a 20 20 20 20 20 20 74 68 65 20 63 6f 6e 74 ** the cont
31a80 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 ents of the page
31a90 20 63 61 63 68 65 20 61 6e 64 20 72 6f 6c 6c 69 cache and rolli
31aa0 6e 67 20 62 61 63 6b 20 61 6e 79 20 6f 70 65 6e ng back any open
31ab0 20 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 20 20 20 20 journal.**
31ac0 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 file..**.** If
31ad0 65 76 65 72 79 74 68 69 6e 67 20 69 73 20 73 75 everything is su
31ae0 63 63 65 73 73 66 75 6c 2c 20 53 51 4c 49 54 45 ccessful, SQLITE
31af0 5f 4f 4b 20 69 73 20 72 65 74 75 72 6e 65 64 2e _OK is returned.
31b00 20 49 66 20 61 6e 20 49 4f 20 65 72 72 6f 72 20 If an IO error
31b10 0a 2a 2a 20 6f 63 63 75 72 73 20 77 68 69 6c 65 .** occurs while
31b20 20 6c 6f 63 6b 69 6e 67 20 74 68 65 20 64 61 74 locking the dat
31b30 61 62 61 73 65 2c 20 63 68 65 63 6b 69 6e 67 20 abase, checking
31b40 66 6f 72 20 61 20 68 6f 74 2d 6a 6f 75 72 6e 61 for a hot-journa
31b50 6c 20 66 69 6c 65 20 6f 72 20 0a 2a 2a 20 72 6f l file or .** ro
31b60 6c 6c 69 6e 67 20 62 61 63 6b 20 61 20 6a 6f 75 lling back a jou
31b70 72 6e 61 6c 20 66 69 6c 65 2c 20 74 68 65 20 49 rnal file, the I
31b80 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20 O error code is
31b90 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 returned..*/.int
31ba0 20 73 71 6c 69 74 65 33 50 61 67 65 72 53 68 61 sqlite3PagerSha
31bb0 72 65 64 4c 6f 63 6b 28 50 61 67 65 72 20 2a 70 redLock(Pager *p
31bc0 50 61 67 65 72 29 7b 0a 20 20 69 6e 74 20 72 63 Pager){. int rc
31bd0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 = SQLITE_OK;
31be0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
31bf0 52 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 0a Return code */..
31c00 20 20 2f 2a 20 54 68 69 73 20 72 6f 75 74 69 6e /* This routin
31c10 65 20 69 73 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 e is only called
31c20 20 66 72 6f 6d 20 62 2d 74 72 65 65 20 61 6e 64 from b-tree and
31c30 20 6f 6e 6c 79 20 77 68 65 6e 20 74 68 65 72 65 only when there
31c40 20 61 72 65 20 6e 6f 0a 20 20 2a 2a 20 6f 75 74 are no. ** out
31c50 73 74 61 6e 64 69 6e 67 20 70 61 67 65 73 2e 20 standing pages.
31c60 54 68 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 This implies tha
31c70 74 20 74 68 65 20 70 61 67 65 72 20 73 74 61 74 t the pager stat
31c80 65 20 73 68 6f 75 6c 64 20 65 69 74 68 65 72 0a e should either.
31c90 20 20 2a 2a 20 62 65 20 4f 50 45 4e 20 6f 72 20 ** be OPEN or
31ca0 52 45 41 44 45 52 2e 20 52 45 41 44 45 52 20 69 READER. READER i
31cb0 73 20 6f 6e 6c 79 20 70 6f 73 73 69 62 6c 65 20 s only possible
31cc0 69 66 20 74 68 65 20 70 61 67 65 72 20 69 73 20 if the pager is
31cd0 6f 72 20 77 61 73 20 69 6e 20 0a 20 20 2a 2a 20 or was in . **
31ce0 65 78 63 6c 75 73 69 76 65 20 61 63 63 65 73 73 exclusive access
31cf0 20 6d 6f 64 65 2e 20 20 2a 2f 0a 20 20 61 73 73 mode. */. ass
31d00 65 72 74 28 20 73 71 6c 69 74 65 33 50 63 61 63 ert( sqlite3Pcac
31d10 68 65 52 65 66 43 6f 75 6e 74 28 70 50 61 67 65 heRefCount(pPage
31d20 72 2d 3e 70 50 43 61 63 68 65 29 3d 3d 30 20 29 r->pPCache)==0 )
31d30 3b 0a 20 20 61 73 73 65 72 74 28 20 61 73 73 65 ;. assert( asse
31d40 72 74 5f 70 61 67 65 72 5f 73 74 61 74 65 28 70 rt_pager_state(p
31d50 50 61 67 65 72 29 20 29 3b 0a 20 20 61 73 73 65 Pager) );. asse
31d60 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
31d70 74 65 3d 3d 50 41 47 45 52 5f 4f 50 45 4e 20 7c te==PAGER_OPEN |
31d80 7c 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 | pPager->eState
31d90 3d 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 29 ==PAGER_READER )
31da0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 67 ;. assert( pPag
31db0 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d 53 51 4c er->errCode==SQL
31dc0 49 54 45 5f 4f 4b 20 29 3b 0a 0a 20 20 69 66 28 ITE_OK );.. if(
31dd0 20 21 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 !pagerUseWal(pP
31de0 61 67 65 72 29 20 26 26 20 70 50 61 67 65 72 2d ager) && pPager-
31df0 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 4f >eState==PAGER_O
31e00 50 45 4e 20 29 7b 0a 20 20 20 20 69 6e 74 20 62 PEN ){. int b
31e10 48 6f 74 4a 6f 75 72 6e 61 6c 20 3d 20 31 3b 20 HotJournal = 1;
31e20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
31e30 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73 if there exists
31e40 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 2d 66 a hot journal-f
31e50 69 6c 65 20 2a 2f 0a 0a 20 20 20 20 61 73 73 65 ile */.. asse
31e60 72 74 28 20 21 4d 45 4d 44 42 20 29 3b 0a 20 20 rt( !MEMDB );.
31e70 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 assert( pPager
31e80 2d 3e 74 65 6d 70 46 69 6c 65 3d 3d 30 20 7c 7c ->tempFile==0 ||
31e90 20 70 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3d 3d pPager->eLock==
31ea0 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 20 29 EXCLUSIVE_LOCK )
31eb0 3b 0a 0a 20 20 20 20 72 63 20 3d 20 70 61 67 65 ;.. rc = page
31ec0 72 5f 77 61 69 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 r_wait_on_lock(p
31ed0 50 61 67 65 72 2c 20 53 48 41 52 45 44 5f 4c 4f Pager, SHARED_LO
31ee0 43 4b 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 CK);. if( rc!
31ef0 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
31f00 20 20 20 20 61 73 73 65 72 74 28 20 70 50 61 67 assert( pPag
31f10 65 72 2d 3e 65 4c 6f 63 6b 3d 3d 4e 4f 5f 4c 4f er->eLock==NO_LO
31f20 43 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 4c CK || pPager->eL
31f30 6f 63 6b 3d 3d 55 4e 4b 4e 4f 57 4e 5f 4c 4f 43 ock==UNKNOWN_LOC
31f40 4b 20 29 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 K );. goto
31f50 66 61 69 6c 65 64 3b 0a 20 20 20 20 7d 0a 0a 20 failed;. }..
31f60 20 20 20 2f 2a 20 49 66 20 61 20 6a 6f 75 72 6e /* If a journ
31f70 61 6c 20 66 69 6c 65 20 65 78 69 73 74 73 2c 20 al file exists,
31f80 61 6e 64 20 74 68 65 72 65 20 69 73 20 6e 6f 20 and there is no
31f90 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 6f 6e RESERVED lock on
31fa0 20 74 68 65 0a 20 20 20 20 2a 2a 20 64 61 74 61 the. ** data
31fb0 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 6e 20 base file, then
31fc0 69 74 20 65 69 74 68 65 72 20 6e 65 65 64 73 20 it either needs
31fd0 74 6f 20 62 65 20 70 6c 61 79 65 64 20 62 61 63 to be played bac
31fe0 6b 20 6f 72 20 64 65 6c 65 74 65 64 2e 0a 20 20 k or deleted..
31ff0 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 61 */. if( pPa
32000 67 65 72 2d 3e 65 4c 6f 63 6b 3c 3d 53 48 41 52 ger->eLock<=SHAR
32010 45 44 5f 4c 4f 43 4b 20 29 7b 0a 20 20 20 20 20 ED_LOCK ){.
32020 20 72 63 20 3d 20 68 61 73 48 6f 74 4a 6f 75 72 rc = hasHotJour
32030 6e 61 6c 28 70 50 61 67 65 72 2c 20 26 62 48 6f nal(pPager, &bHo
32040 74 4a 6f 75 72 6e 61 6c 29 3b 0a 20 20 20 20 7d tJournal);. }
32050 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c . if( rc!=SQL
32060 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
32070 67 6f 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20 goto failed;.
32080 20 7d 0a 20 20 20 20 69 66 28 20 62 48 6f 74 4a }. if( bHotJ
32090 6f 75 72 6e 61 6c 20 29 7b 0a 20 20 20 20 20 20 ournal ){.
320a0 69 66 28 20 70 50 61 67 65 72 2d 3e 72 65 61 64 if( pPager->read
320b0 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 20 20 20 20 Only ){.
320c0 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 45 41 44 rc = SQLITE_READ
320d0 4f 4e 4c 59 5f 52 4f 4c 4c 42 41 43 4b 3b 0a 20 ONLY_ROLLBACK;.
320e0 20 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c goto fail
320f0 65 64 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 ed;. }..
32100 20 20 20 2f 2a 20 47 65 74 20 61 6e 20 45 58 43 /* Get an EXC
32110 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e 20 74 LUSIVE lock on t
32120 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 he database file
32130 2e 20 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 . At this point
32140 69 74 20 69 73 0a 20 20 20 20 20 20 2a 2a 20 69 it is. ** i
32150 6d 70 6f 72 74 61 6e 74 20 74 68 61 74 20 61 20 mportant that a
32160 52 45 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 RESERVED lock is
32170 20 6e 6f 74 20 6f 62 74 61 69 6e 65 64 20 6f 6e not obtained on
32180 20 74 68 65 20 77 61 79 20 74 6f 20 74 68 65 0a the way to the.
32190 20 20 20 20 20 20 2a 2a 20 45 58 43 4c 55 53 49 ** EXCLUSI
321a0 56 45 20 6c 6f 63 6b 2e 20 49 66 20 69 74 20 77 VE lock. If it w
321b0 65 72 65 2c 20 61 6e 6f 74 68 65 72 20 70 72 6f ere, another pro
321c0 63 65 73 73 20 6d 69 67 68 74 20 6f 70 65 6e 20 cess might open
321d0 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 64 61 74 the. ** dat
321e0 61 62 61 73 65 20 66 69 6c 65 2c 20 64 65 74 65 abase file, dete
321f0 63 74 20 74 68 65 20 52 45 53 45 52 56 45 44 20 ct the RESERVED
32200 6c 6f 63 6b 2c 20 61 6e 64 20 63 6f 6e 63 6c 75 lock, and conclu
32210 64 65 20 74 68 61 74 20 74 68 65 0a 20 20 20 20 de that the.
32220 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 73 ** database is
32230 20 73 61 66 65 20 74 6f 20 72 65 61 64 20 77 68 safe to read wh
32240 69 6c 65 20 74 68 69 73 20 70 72 6f 63 65 73 73 ile this process
32250 20 69 73 20 73 74 69 6c 6c 20 72 6f 6c 6c 69 6e is still rollin
32260 67 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 g the . **
32270 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 62 61 63 6b hot-journal back
32280 2e 0a 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 .. ** .
32290 20 20 2a 2a 20 42 65 63 61 75 73 65 20 74 68 65 ** Because the
322a0 20 69 6e 74 65 72 6d 65 64 69 61 74 65 20 52 45 intermediate RE
322b0 53 45 52 56 45 44 20 6c 6f 63 6b 20 69 73 20 6e SERVED lock is n
322c0 6f 74 20 72 65 71 75 65 73 74 65 64 2c 20 61 6e ot requested, an
322d0 79 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 72 y. ** other
322e0 20 70 72 6f 63 65 73 73 20 61 74 74 65 6d 70 74 process attempt
322f0 69 6e 67 20 74 6f 20 61 63 63 65 73 73 20 74 68 ing to access th
32300 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
32310 77 69 6c 6c 20 67 65 74 20 74 6f 20 0a 20 20 20 will get to .
32320 20 20 20 2a 2a 20 74 68 69 73 20 70 6f 69 6e 74 ** this point
32330 20 69 6e 20 74 68 65 20 63 6f 64 65 20 61 6e 64 in the code and
32340 20 66 61 69 6c 20 74 6f 20 6f 62 74 61 69 6e 20 fail to obtain
32350 69 74 73 20 6f 77 6e 20 45 58 43 4c 55 53 49 56 its own EXCLUSIV
32360 45 20 6c 6f 63 6b 20 0a 20 20 20 20 20 20 2a 2a E lock . **
32370 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
32380 20 66 69 6c 65 2e 0a 20 20 20 20 20 20 2a 2a 0a file.. **.
32390 20 20 20 20 20 20 2a 2a 20 55 6e 6c 65 73 73 20 ** Unless
323a0 74 68 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 the pager is in
323b0 6c 6f 63 6b 69 6e 67 5f 6d 6f 64 65 3d 65 78 63 locking_mode=exc
323c0 6c 75 73 69 76 65 20 6d 6f 64 65 2c 20 74 68 65 lusive mode, the
323d0 20 6c 6f 63 6b 20 69 73 0a 20 20 20 20 20 20 2a lock is. *
323e0 2a 20 64 6f 77 6e 67 72 61 64 65 64 20 74 6f 20 * downgraded to
323f0 53 48 41 52 45 44 5f 4c 4f 43 4b 20 62 65 66 6f SHARED_LOCK befo
32400 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e re this function
32410 20 72 65 74 75 72 6e 73 2e 0a 20 20 20 20 20 20 returns..
32420 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d 20 70 61 */. rc = pa
32430 67 65 72 4c 6f 63 6b 44 62 28 70 50 61 67 65 72 gerLockDb(pPager
32440 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b , EXCLUSIVE_LOCK
32450 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 21 );. if( rc!
32460 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
32470 20 20 20 20 20 20 67 6f 74 6f 20 66 61 69 6c 65 goto faile
32480 64 3b 0a 20 20 20 20 20 20 7d 0a 20 0a 20 20 20 d;. }. .
32490 20 20 20 2f 2a 20 49 66 20 69 74 20 69 73 20 6e /* If it is n
324a0 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 20 ot already open
324b0 61 6e 64 20 74 68 65 20 66 69 6c 65 20 65 78 69 and the file exi
324c0 73 74 73 20 6f 6e 20 64 69 73 6b 2c 20 6f 70 65 sts on disk, ope
324d0 6e 20 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 n the . **
324e0 6a 6f 75 72 6e 61 6c 20 66 6f 72 20 72 65 61 64 journal for read
324f0 2f 77 72 69 74 65 20 61 63 63 65 73 73 2e 20 57 /write access. W
32500 72 69 74 65 20 61 63 63 65 73 73 20 69 73 20 72 rite access is r
32510 65 71 75 69 72 65 64 20 62 65 63 61 75 73 65 20 equired because
32520 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 65 78 63 . ** in exc
32530 6c 75 73 69 76 65 2d 61 63 63 65 73 73 20 6d 6f lusive-access mo
32540 64 65 20 74 68 65 20 66 69 6c 65 20 64 65 73 63 de the file desc
32550 72 69 70 74 6f 72 20 77 69 6c 6c 20 62 65 20 6b riptor will be k
32560 65 70 74 20 6f 70 65 6e 20 0a 20 20 20 20 20 20 ept open .
32570 2a 2a 20 61 6e 64 20 70 6f 73 73 69 62 6c 79 20 ** and possibly
32580 75 73 65 64 20 66 6f 72 20 61 20 74 72 61 6e 73 used for a trans
32590 61 63 74 69 6f 6e 20 6c 61 74 65 72 20 6f 6e 2e action later on.
325a0 20 41 6c 73 6f 2c 20 77 72 69 74 65 2d 61 63 63 Also, write-acc
325b0 65 73 73 20 0a 20 20 20 20 20 20 2a 2a 20 69 73 ess . ** is
325c0 20 75 73 75 61 6c 6c 79 20 72 65 71 75 69 72 65 usually require
325d0 64 20 74 6f 20 66 69 6e 61 6c 69 7a 65 20 74 68 d to finalize th
325e0 65 20 6a 6f 75 72 6e 61 6c 20 69 6e 20 6a 6f 75 e journal in jou
325f0 72 6e 61 6c 5f 6d 6f 64 65 3d 70 65 72 73 69 73 rnal_mode=persis
32600 74 20 0a 20 20 20 20 20 20 2a 2a 20 6d 6f 64 65 t . ** mode
32610 20 28 61 6e 64 20 61 6c 73 6f 20 66 6f 72 20 6a (and also for j
32620 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 74 72 75 6e ournal_mode=trun
32630 63 61 74 65 20 6f 6e 20 73 6f 6d 65 20 73 79 73 cate on some sys
32640 74 65 6d 73 29 2e 0a 20 20 20 20 20 20 2a 2a 0a tems).. **.
32650 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20 ** If the
32660 6a 6f 75 72 6e 61 6c 20 64 6f 65 73 20 6e 6f 74 journal does not
32670 20 65 78 69 73 74 2c 20 69 74 20 75 73 75 61 6c exist, it usual
32680 6c 79 20 6d 65 61 6e 73 20 74 68 61 74 20 73 6f ly means that so
32690 6d 65 20 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 me . ** oth
326a0 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 61 er connection ma
326b0 6e 61 67 65 64 20 74 6f 20 67 65 74 20 69 6e 20 naged to get in
326c0 61 6e 64 20 72 6f 6c 6c 20 69 74 20 62 61 63 6b and roll it back
326d0 20 62 65 66 6f 72 65 20 0a 20 20 20 20 20 20 2a before . *
326e0 2a 20 74 68 69 73 20 63 6f 6e 6e 65 63 74 69 6f * this connectio
326f0 6e 20 6f 62 74 61 69 6e 65 64 20 74 68 65 20 65 n obtained the e
32700 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 61 62 xclusive lock ab
32710 6f 76 65 2e 20 4f 72 2c 20 69 74 20 0a 20 20 20 ove. Or, it .
32720 20 20 20 2a 2a 20 6d 61 79 20 6d 65 61 6e 20 74 ** may mean t
32730 68 61 74 20 74 68 65 20 70 61 67 65 72 20 77 61 hat the pager wa
32740 73 20 69 6e 20 74 68 65 20 65 72 72 6f 72 2d 73 s in the error-s
32750 74 61 74 65 20 77 68 65 6e 20 74 68 69 73 0a 20 tate when this.
32760 20 20 20 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e ** function
32770 20 77 61 73 20 63 61 6c 6c 65 64 20 61 6e 64 20 was called and
32780 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 the journal file
32790 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2e does not exist.
327a0 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
327b0 69 66 28 20 21 69 73 4f 70 65 6e 28 70 50 61 67 if( !isOpen(pPag
327c0 65 72 2d 3e 6a 66 64 29 20 29 7b 0a 20 20 20 20 er->jfd) ){.
327d0 20 20 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 sqlite3_vfs
327e0 2a 20 63 6f 6e 73 74 20 70 56 66 73 20 3d 20 70 * const pVfs = p
327f0 50 61 67 65 72 2d 3e 70 56 66 73 3b 0a 20 20 20 Pager->pVfs;.
32800 20 20 20 20 20 69 6e 74 20 62 45 78 69 73 74 73 int bExists
32810 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
32820 2a 20 54 72 75 65 20 69 66 20 6a 6f 75 72 6e 61 * True if journa
32830 6c 20 66 69 6c 65 20 65 78 69 73 74 73 20 2a 2f l file exists */
32840 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 . rc = sq
32850 6c 69 74 65 33 4f 73 41 63 63 65 73 73 28 0a 20 lite3OsAccess(.
32860 20 20 20 20 20 20 20 20 20 20 20 70 56 66 73 2c pVfs,
32870 20 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 pPager->zJourna
32880 6c 2c 20 53 51 4c 49 54 45 5f 41 43 43 45 53 53 l, SQLITE_ACCESS
32890 5f 45 58 49 53 54 53 2c 20 26 62 45 78 69 73 74 _EXISTS, &bExist
328a0 73 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 s);. if(
328b0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
328c0 20 62 45 78 69 73 74 73 20 29 7b 0a 20 20 20 20 bExists ){.
328d0 20 20 20 20 20 20 69 6e 74 20 66 6f 75 74 20 3d int fout =
328e0 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 0;. in
328f0 74 20 66 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 t f = SQLITE_OPE
32900 4e 5f 52 45 41 44 57 52 49 54 45 7c 53 51 4c 49 N_READWRITE|SQLI
32910 54 45 5f 4f 50 45 4e 5f 4d 41 49 4e 5f 4a 4f 55 TE_OPEN_MAIN_JOU
32920 52 4e 41 4c 3b 0a 20 20 20 20 20 20 20 20 20 20 RNAL;.
32930 61 73 73 65 72 74 28 20 21 70 50 61 67 65 72 2d assert( !pPager-
32940 3e 74 65 6d 70 46 69 6c 65 20 29 3b 0a 20 20 20 >tempFile );.
32950 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
32960 74 65 33 4f 73 4f 70 65 6e 28 70 56 66 73 2c 20 te3OsOpen(pVfs,
32970 70 50 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c pPager->zJournal
32980 2c 20 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 66 , pPager->jfd, f
32990 2c 20 26 66 6f 75 74 29 3b 0a 20 20 20 20 20 20 , &fout);.
329a0 20 20 20 20 61 73 73 65 72 74 28 20 72 63 21 3d assert( rc!=
329b0 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f SQLITE_OK || isO
329c0 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 pen(pPager->jfd)
329d0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 );. if
329e0 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
329f0 26 26 20 66 6f 75 74 26 53 51 4c 49 54 45 5f 4f && fout&SQLITE_O
32a00 50 45 4e 5f 52 45 41 44 4f 4e 4c 59 20 29 7b 0a PEN_READONLY ){.
32a10 20 20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d rc =
32a20 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e SQLITE_CANTOPEN
32a30 5f 42 4b 50 54 3b 0a 20 20 20 20 20 20 20 20 20 _BKPT;.
32a40 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 sqlite3OsClos
32a50 65 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 3b 0a e(pPager->jfd);.
32a60 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
32a70 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 0a }. }. .
32a80 20 20 20 20 20 20 2f 2a 20 50 6c 61 79 62 61 63 /* Playbac
32a90 6b 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 k and delete the
32aa0 20 6a 6f 75 72 6e 61 6c 2e 20 20 44 72 6f 70 20 journal. Drop
32ab0 74 68 65 20 64 61 74 61 62 61 73 65 20 77 72 69 the database wri
32ac0 74 65 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 63 6b te. ** lock
32ad0 20 61 6e 64 20 72 65 61 63 71 75 69 72 65 20 74 and reacquire t
32ae0 68 65 20 72 65 61 64 20 6c 6f 63 6b 2e 20 50 75 he read lock. Pu
32af0 72 67 65 20 74 68 65 20 63 61 63 68 65 20 62 65 rge the cache be
32b00 66 6f 72 65 0a 20 20 20 20 20 20 2a 2a 20 70 6c fore. ** pl
32b10 61 79 69 6e 67 20 62 61 63 6b 20 74 68 65 20 68 aying back the h
32b20 6f 74 2d 6a 6f 75 72 6e 61 6c 20 73 6f 20 74 68 ot-journal so th
32b30 61 74 20 77 65 20 64 6f 6e 27 74 20 65 6e 64 20 at we don't end
32b40 75 70 20 77 69 74 68 0a 20 20 20 20 20 20 2a 2a up with. **
32b50 20 61 6e 20 69 6e 63 6f 6e 73 69 73 74 65 6e 74 an inconsistent
32b60 20 63 61 63 68 65 2e 20 20 53 79 6e 63 20 74 68 cache. Sync th
32b70 65 20 68 6f 74 20 6a 6f 75 72 6e 61 6c 20 62 65 e hot journal be
32b80 66 6f 72 65 20 70 6c 61 79 69 6e 67 0a 20 20 20 fore playing.
32b90 20 20 20 2a 2a 20 69 74 20 62 61 63 6b 20 73 69 ** it back si
32ba0 6e 63 65 20 74 68 65 20 70 72 6f 63 65 73 73 20 nce the process
32bb0 74 68 61 74 20 63 72 61 73 68 65 64 20 61 6e 64 that crashed and
32bc0 20 6c 65 66 74 20 74 68 65 20 68 6f 74 20 6a 6f left the hot jo
32bd0 75 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 70 urnal. ** p
32be0 72 6f 62 61 62 6c 79 20 64 69 64 20 6e 6f 74 20 robably did not
32bf0 73 79 6e 63 20 69 74 20 61 6e 64 20 77 65 20 61 sync it and we a
32c00 72 65 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 re required to a
32c10 6c 77 61 79 73 20 73 79 6e 63 0a 20 20 20 20 20 lways sync.
32c20 20 2a 2a 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 ** the journal
32c30 62 65 66 6f 72 65 20 70 6c 61 79 69 6e 67 20 69 before playing i
32c40 74 20 62 61 63 6b 2e 0a 20 20 20 20 20 20 2a 2f t back.. */
32c50 0a 20 20 20 20 20 20 69 66 28 20 69 73 4f 70 65 . if( isOpe
32c60 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 n(pPager->jfd) )
32c70 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 {. assert
32c80 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
32c90 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 );. rc =
32ca0 70 61 67 65 72 53 79 6e 63 48 6f 74 4a 6f 75 72 pagerSyncHotJour
32cb0 6e 61 6c 28 70 50 61 67 65 72 29 3b 0a 20 20 20 nal(pPager);.
32cc0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
32cd0 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 ITE_OK ){.
32ce0 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 5f 70 rc = pager_p
32cf0 6c 61 79 62 61 63 6b 28 70 50 61 67 65 72 2c 20 layback(pPager,
32d00 21 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 69 6c !pPager->tempFil
32d10 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 50 e);. pP
32d20 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d 20 50 ager->eState = P
32d30 41 47 45 52 5f 4f 50 45 4e 3b 0a 20 20 20 20 20 AGER_OPEN;.
32d40 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 }. }else
32d50 20 69 66 28 20 21 70 50 61 67 65 72 2d 3e 65 78 if( !pPager->ex
32d60 63 6c 75 73 69 76 65 4d 6f 64 65 20 29 7b 0a 20 clusiveMode ){.
32d70 20 20 20 20 20 20 20 70 61 67 65 72 55 6e 6c 6f pagerUnlo
32d80 63 6b 44 62 28 70 50 61 67 65 72 2c 20 53 48 41 ckDb(pPager, SHA
32d90 52 45 44 5f 4c 4f 43 4b 29 3b 0a 20 20 20 20 20 RED_LOCK);.
32da0 20 7d 0a 0a 20 20 20 20 20 20 69 66 28 20 72 63 }.. if( rc
32db0 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 !=SQLITE_OK ){.
32dc0 20 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 62 /* This b
32dd0 72 61 6e 63 68 20 69 73 20 74 61 6b 65 6e 20 69 ranch is taken i
32de0 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 f an error occur
32df0 73 20 77 68 69 6c 65 20 74 72 79 69 6e 67 20 74 s while trying t
32e00 6f 20 6f 70 65 6e 0a 20 20 20 20 20 20 20 20 2a o open. *
32e10 2a 20 6f 72 20 72 6f 6c 6c 20 62 61 63 6b 20 61 * or roll back a
32e20 20 68 6f 74 2d 6a 6f 75 72 6e 61 6c 20 77 68 69 hot-journal whi
32e30 6c 65 20 68 6f 6c 64 69 6e 67 20 61 6e 20 45 58 le holding an EX
32e40 43 4c 55 53 49 56 45 20 6c 6f 63 6b 2e 20 54 68 CLUSIVE lock. Th
32e50 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 e. ** pag
32e60 65 72 5f 75 6e 6c 6f 63 6b 28 29 20 72 6f 75 74 er_unlock() rout
32e70 69 6e 65 20 77 69 6c 6c 20 62 65 20 63 61 6c 6c ine will be call
32e80 65 64 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e ed before return
32e90 69 6e 67 20 74 6f 20 75 6e 6c 6f 63 6b 0a 20 20 ing to unlock.
32ea0 20 20 20 20 20 20 2a 2a 20 74 68 65 20 66 69 6c ** the fil
32eb0 65 2e 20 49 66 20 74 68 65 20 75 6e 6c 6f 63 6b e. If the unlock
32ec0 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2c 20 attempt fails,
32ed0 74 68 65 6e 20 50 61 67 65 72 2e 65 4c 6f 63 6b then Pager.eLock
32ee0 20 6d 75 73 74 20 62 65 0a 20 20 20 20 20 20 20 must be.
32ef0 20 2a 2a 20 73 65 74 20 74 6f 20 55 4e 4b 4e 4f ** set to UNKNO
32f00 57 4e 5f 4c 4f 43 4b 20 28 73 65 65 20 74 68 65 WN_LOCK (see the
32f10 20 63 6f 6d 6d 65 6e 74 20 61 62 6f 76 65 20 74 comment above t
32f20 68 65 20 23 64 65 66 69 6e 65 20 66 6f 72 20 0a he #define for .
32f30 20 20 20 20 20 20 20 20 2a 2a 20 55 4e 4b 4e 4f ** UNKNO
32f40 57 4e 5f 4c 4f 43 4b 20 61 62 6f 76 65 20 66 6f WN_LOCK above fo
32f50 72 20 61 6e 20 65 78 70 6c 61 6e 61 74 69 6f 6e r an explanation
32f60 29 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 ). . **.
32f70 20 20 20 20 20 20 20 2a 2a 20 49 6e 20 6f 72 64 ** In ord
32f80 65 72 20 74 6f 20 67 65 74 20 70 61 67 65 72 5f er to get pager_
32f90 75 6e 6c 6f 63 6b 28 29 20 74 6f 20 64 6f 20 74 unlock() to do t
32fa0 68 69 73 2c 20 73 65 74 20 50 61 67 65 72 2e 65 his, set Pager.e
32fb0 53 74 61 74 65 20 74 6f 0a 20 20 20 20 20 20 20 State to.
32fc0 20 2a 2a 20 50 41 47 45 52 5f 45 52 52 4f 52 20 ** PAGER_ERROR
32fd0 6e 6f 77 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 now. This is not
32fe0 20 61 63 74 75 61 6c 6c 79 20 63 6f 75 6e 74 65 actually counte
32ff0 64 20 61 73 20 61 20 74 72 61 6e 73 69 74 69 6f d as a transitio
33000 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 n. ** to
33010 45 52 52 4f 52 20 73 74 61 74 65 20 69 6e 20 74 ERROR state in t
33020 68 65 20 73 74 61 74 65 20 64 69 61 67 72 61 6d he state diagram
33030 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 74 at the top of t
33040 68 69 73 20 66 69 6c 65 2c 0a 20 20 20 20 20 20 his file,.
33050 20 20 2a 2a 20 73 69 6e 63 65 20 77 65 20 6b 6e ** since we kn
33060 6f 77 20 74 68 61 74 20 74 68 65 20 73 61 6d 65 ow that the same
33070 20 63 61 6c 6c 20 74 6f 20 70 61 67 65 72 5f 75 call to pager_u
33080 6e 6c 6f 63 6b 28 29 20 77 69 6c 6c 20 76 65 72 nlock() will ver
33090 79 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 68 6f y. ** sho
330a0 72 74 6c 79 20 74 72 61 6e 73 69 74 69 6f 6e 20 rtly transition
330b0 74 68 65 20 70 61 67 65 72 20 6f 62 6a 65 63 74 the pager object
330c0 20 74 6f 20 74 68 65 20 4f 50 45 4e 20 73 74 61 to the OPEN sta
330d0 74 65 2e 20 43 61 6c 6c 69 6e 67 0a 20 20 20 20 te. Calling.
330e0 20 20 20 20 2a 2a 20 61 73 73 65 72 74 5f 70 61 ** assert_pa
330f0 67 65 72 5f 73 74 61 74 65 28 29 20 77 6f 75 6c ger_state() woul
33100 64 20 66 61 69 6c 20 6e 6f 77 2c 20 61 73 20 69 d fail now, as i
33110 74 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 20 t should not be
33120 70 6f 73 73 69 62 6c 65 0a 20 20 20 20 20 20 20 possible.
33130 20 2a 2a 20 74 6f 20 62 65 20 69 6e 20 45 52 52 ** to be in ERR
33140 4f 52 20 73 74 61 74 65 20 77 68 65 6e 20 74 68 OR state when th
33150 65 72 65 20 61 72 65 20 7a 65 72 6f 20 6f 75 74 ere are zero out
33160 73 74 61 6e 64 69 6e 67 20 70 61 67 65 20 0a 20 standing page .
33170 20 20 20 20 20 20 20 2a 2a 20 72 65 66 65 72 65 ** refere
33180 6e 63 65 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f nces.. */
33190 0a 20 20 20 20 20 20 20 20 70 61 67 65 72 5f 65 . pager_e
331a0 72 72 6f 72 28 70 50 61 67 65 72 2c 20 72 63 29 rror(pPager, rc)
331b0 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 66 ;. goto f
331c0 61 69 6c 65 64 3b 0a 20 20 20 20 20 20 7d 0a 0a ailed;. }..
331d0 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 50 assert( pP
331e0 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 ager->eState==PA
331f0 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 20 20 GER_OPEN );.
33200 20 20 61 73 73 65 72 74 28 20 28 70 50 61 67 65 assert( (pPage
33210 72 2d 3e 65 4c 6f 63 6b 3d 3d 53 48 41 52 45 44 r->eLock==SHARED
33220 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 20 20 20 _LOCK).
33230 20 20 7c 7c 20 28 70 50 61 67 65 72 2d 3e 65 78 || (pPager->ex
33240 63 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 20 70 clusiveMode && p
33250 50 61 67 65 72 2d 3e 65 4c 6f 63 6b 3e 53 48 41 Pager->eLock>SHA
33260 52 45 44 5f 4c 4f 43 4b 29 0a 20 20 20 20 20 20 RED_LOCK).
33270 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 );. }.. if
33280 28 20 21 70 50 61 67 65 72 2d 3e 74 65 6d 70 46 ( !pPager->tempF
33290 69 6c 65 20 26 26 20 70 50 61 67 65 72 2d 3e 68 ile && pPager->h
332a0 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b asHeldSharedLock
332b0 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 65 ){. /* The
332c0 20 73 68 61 72 65 64 2d 6c 6f 63 6b 20 68 61 73 shared-lock has
332d0 20 6a 75 73 74 20 62 65 65 6e 20 61 63 71 75 69 just been acqui
332e0 72 65 64 20 74 68 65 6e 20 63 68 65 63 6b 20 74 red then check t
332f0 6f 0a 20 20 20 20 20 20 2a 2a 20 73 65 65 20 69 o. ** see i
33300 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 f the database h
33310 61 73 20 62 65 65 6e 20 6d 6f 64 69 66 69 65 64 as been modified
33320 2e 20 20 49 66 20 74 68 65 20 64 61 74 61 62 61 . If the databa
33330 73 65 20 68 61 73 20 63 68 61 6e 67 65 64 2c 0a se has changed,.
33340 20 20 20 20 20 20 2a 2a 20 66 6c 75 73 68 20 74 ** flush t
33350 68 65 20 63 61 63 68 65 2e 20 20 54 68 65 20 68 he cache. The h
33360 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b asHeldSharedLock
33370 20 66 6c 61 67 20 70 72 65 76 65 6e 74 73 20 74 flag prevents t
33380 68 69 73 20 66 72 6f 6d 0a 20 20 20 20 20 20 2a his from. *
33390 2a 20 6f 63 63 75 72 72 69 6e 67 20 6f 6e 20 74 * occurring on t
333a0 68 65 20 76 65 72 79 20 66 69 72 73 74 20 61 63 he very first ac
333b0 63 65 73 73 20 74 6f 20 61 20 66 69 6c 65 2c 20 cess to a file,
333c0 69 6e 20 6f 72 64 65 72 20 74 6f 20 73 61 76 65 in order to save
333d0 20 61 0a 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 a. ** sing
333e0 6c 65 20 75 6e 6e 65 63 65 73 73 61 72 79 20 73 le unnecessary s
333f0 71 6c 69 74 65 33 4f 73 52 65 61 64 28 29 20 63 qlite3OsRead() c
33400 61 6c 6c 20 61 74 20 74 68 65 20 73 74 61 72 74 all at the start
33410 2d 75 70 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 -up.. **.
33420 20 20 20 20 2a 2a 20 44 61 74 61 62 61 73 65 20 ** Database
33430 63 68 61 6e 67 65 73 20 61 72 65 20 64 65 74 65 changes are dete
33440 63 74 65 64 20 62 79 20 6c 6f 6f 6b 69 6e 67 20 cted by looking
33450 61 74 20 31 35 20 62 79 74 65 73 20 62 65 67 69 at 15 bytes begi
33460 6e 6e 69 6e 67 0a 20 20 20 20 20 20 2a 2a 20 61 nning. ** a
33470 74 20 6f 66 66 73 65 74 20 32 34 20 69 6e 74 6f t offset 24 into
33480 20 74 68 65 20 66 69 6c 65 2e 20 20 54 68 65 20 the file. The
33490 66 69 72 73 74 20 34 20 6f 66 20 74 68 65 73 65 first 4 of these
334a0 20 31 36 20 62 79 74 65 73 20 61 72 65 0a 20 20 16 bytes are.
334b0 20 20 20 20 2a 2a 20 61 20 33 32 2d 62 69 74 20 ** a 32-bit
334c0 63 6f 75 6e 74 65 72 20 74 68 61 74 20 69 73 20 counter that is
334d0 69 6e 63 72 65 6d 65 6e 74 65 64 20 77 69 74 68 incremented with
334e0 20 65 61 63 68 20 63 68 61 6e 67 65 2e 20 20 54 each change. T
334f0 68 65 0a 20 20 20 20 20 20 2a 2a 20 6f 74 68 65 he. ** othe
33500 72 20 62 79 74 65 73 20 63 68 61 6e 67 65 20 72 r bytes change r
33510 61 6e 64 6f 6d 6c 79 20 77 69 74 68 20 65 61 63 andomly with eac
33520 68 20 66 69 6c 65 20 63 68 61 6e 67 65 20 77 68 h file change wh
33530 65 6e 0a 20 20 20 20 20 20 2a 2a 20 61 20 63 6f en. ** a co
33540 64 65 63 20 69 73 20 69 6e 20 75 73 65 2e 0a 20 dec is in use..
33550 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 2a ** . *
33560 2a 20 54 68 65 72 65 20 69 73 20 61 20 76 61 6e * There is a van
33570 69 73 68 69 6e 67 6c 79 20 73 6d 61 6c 6c 20 63 ishingly small c
33580 68 61 6e 63 65 20 74 68 61 74 20 61 20 63 68 61 hance that a cha
33590 6e 67 65 20 77 69 6c 6c 20 6e 6f 74 20 62 65 20 nge will not be
335a0 0a 20 20 20 20 20 20 2a 2a 20 64 65 74 65 63 74 . ** detect
335b0 65 64 2e 20 20 54 68 65 20 63 68 61 6e 63 65 20 ed. The chance
335c0 6f 66 20 61 6e 20 75 6e 64 65 74 65 63 74 65 64 of an undetected
335d0 20 63 68 61 6e 67 65 20 69 73 20 73 6f 20 73 6d change is so sm
335e0 61 6c 6c 20 74 68 61 74 0a 20 20 20 20 20 20 2a all that. *
335f0 2a 20 69 74 20 63 61 6e 20 62 65 20 6e 65 67 6c * it can be negl
33600 65 63 74 65 64 2e 0a 20 20 20 20 20 20 2a 2f 0a ected.. */.
33610 20 20 20 20 20 20 63 68 61 72 20 64 62 46 69 6c char dbFil
33620 65 56 65 72 73 5b 73 69 7a 65 6f 66 28 70 50 61 eVers[sizeof(pPa
33630 67 65 72 2d 3e 64 62 46 69 6c 65 56 65 72 73 29 ger->dbFileVers)
33640 5d 3b 0a 0a 20 20 20 20 20 20 49 4f 54 52 41 43 ];.. IOTRAC
33650 45 28 28 22 43 4b 56 45 52 53 20 25 70 20 25 64 E(("CKVERS %p %d
33660 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 73 69 7a \n", pPager, siz
33670 65 6f 66 28 64 62 46 69 6c 65 56 65 72 73 29 29 eof(dbFileVers))
33680 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
33690 6c 69 74 65 33 4f 73 52 65 61 64 28 70 50 61 67 lite3OsRead(pPag
336a0 65 72 2d 3e 66 64 2c 20 26 64 62 46 69 6c 65 56 er->fd, &dbFileV
336b0 65 72 73 2c 20 73 69 7a 65 6f 66 28 64 62 46 69 ers, sizeof(dbFi
336c0 6c 65 56 65 72 73 29 2c 20 32 34 29 3b 0a 20 20 leVers), 24);.
336d0 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 if( rc!=SQLI
336e0 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 TE_OK ){.
336f0 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f if( rc!=SQLITE_
33700 49 4f 45 52 52 5f 53 48 4f 52 54 5f 52 45 41 44 IOERR_SHORT_READ
33710 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 67 6f ){. go
33720 74 6f 20 66 61 69 6c 65 64 3b 0a 20 20 20 20 20 to failed;.
33730 20 20 20 7d 0a 20 20 20 20 20 20 20 20 6d 65 6d }. mem
33740 73 65 74 28 64 62 46 69 6c 65 56 65 72 73 2c 20 set(dbFileVers,
33750 30 2c 20 73 69 7a 65 6f 66 28 64 62 46 69 6c 65 0, sizeof(dbFile
33760 56 65 72 73 29 29 3b 0a 20 20 20 20 20 20 7d 0a Vers));. }.
33770 0a 20 20 20 20 20 20 69 66 28 20 6d 65 6d 63 6d . if( memcm
33780 70 28 70 50 61 67 65 72 2d 3e 64 62 46 69 6c 65 p(pPager->dbFile
33790 56 65 72 73 2c 20 64 62 46 69 6c 65 56 65 72 73 Vers, dbFileVers
337a0 2c 20 73 69 7a 65 6f 66 28 64 62 46 69 6c 65 56 , sizeof(dbFileV
337b0 65 72 73 29 29 21 3d 30 20 29 7b 0a 20 20 20 20 ers))!=0 ){.
337c0 20 20 20 20 70 61 67 65 72 5f 72 65 73 65 74 28 pager_reset(
337d0 70 50 61 67 65 72 29 3b 0a 0a 20 20 20 20 20 20 pPager);..
337e0 20 20 2f 2a 20 55 6e 6d 61 70 20 74 68 65 20 64 /* Unmap the d
337f0 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 49 74 atabase file. It
33800 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 68 61 is possible tha
33810 74 20 65 78 74 65 72 6e 61 6c 20 70 72 6f 63 65 t external proce
33820 73 73 65 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 sses. **
33830 6d 61 79 20 68 61 76 65 20 74 72 75 6e 63 61 74 may have truncat
33840 65 64 20 74 68 65 20 64 61 74 61 62 61 73 65 20 ed the database
33850 66 69 6c 65 20 61 6e 64 20 74 68 65 6e 20 65 78 file and then ex
33860 74 65 6e 64 65 64 20 69 74 20 62 61 63 6b 0a 20 tended it back.
33870 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 69 74 73 ** to its
33880 20 6f 72 69 67 69 6e 61 6c 20 73 69 7a 65 20 77 original size w
33890 68 69 6c 65 20 74 68 69 73 20 70 72 6f 63 65 73 hile this proces
338a0 73 20 77 61 73 20 6e 6f 74 20 68 6f 6c 64 69 6e s was not holdin
338b0 67 20 61 20 6c 6f 63 6b 2e 0a 20 20 20 20 20 20 g a lock..
338c0 20 20 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 ** In this cas
338d0 65 20 74 68 65 72 65 20 6d 61 79 20 65 78 69 73 e there may exis
338e0 74 20 61 20 50 61 67 65 72 2e 70 4d 61 70 20 6d t a Pager.pMap m
338f0 61 70 70 69 6e 67 20 74 68 61 74 20 61 70 70 65 apping that appe
33900 61 72 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 ars. ** t
33910 6f 20 62 65 20 74 68 65 20 72 69 67 68 74 20 73 o be the right s
33920 69 7a 65 20 62 75 74 20 69 73 20 6e 6f 74 20 61 ize but is not a
33930 63 74 75 61 6c 6c 79 20 76 61 6c 69 64 2e 20 41 ctually valid. A
33940 76 6f 69 64 20 74 68 69 73 0a 20 20 20 20 20 20 void this.
33950 20 20 2a 2a 20 70 6f 73 73 69 62 69 6c 69 74 79 ** possibility
33960 20 62 79 20 75 6e 6d 61 70 70 69 6e 67 20 74 68 by unmapping th
33970 65 20 64 62 20 68 65 72 65 2e 20 2a 2f 0a 20 20 e db here. */.
33980 20 20 20 20 20 20 69 66 28 20 55 53 45 46 45 54 if( USEFET
33990 43 48 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 CH(pPager) ){.
339a0 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f sqlite3O
339b0 73 55 6e 66 65 74 63 68 28 70 50 61 67 65 72 2d sUnfetch(pPager-
339c0 3e 66 64 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 >fd, 0, 0);.
339d0 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
339e0 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 }.. /* If t
339f0 68 65 72 65 20 69 73 20 61 20 57 41 4c 20 66 69 here is a WAL fi
33a00 6c 65 20 69 6e 20 74 68 65 20 66 69 6c 65 2d 73 le in the file-s
33a10 79 73 74 65 6d 2c 20 6f 70 65 6e 20 74 68 69 73 ystem, open this
33a20 20 64 61 74 61 62 61 73 65 20 69 6e 20 57 41 4c database in WAL
33a30 0a 20 20 20 20 2a 2a 20 6d 6f 64 65 2e 20 4f 74 . ** mode. Ot
33a40 68 65 72 77 69 73 65 2c 20 74 68 65 20 66 6f 6c herwise, the fol
33a50 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 lowing function
33a60 63 61 6c 6c 20 69 73 20 61 20 6e 6f 2d 6f 70 2e call is a no-op.
33a70 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 63 20 3d . */. rc =
33a80 20 70 61 67 65 72 4f 70 65 6e 57 61 6c 49 66 50 pagerOpenWalIfP
33a90 72 65 73 65 6e 74 28 70 50 61 67 65 72 29 3b 0a resent(pPager);.
33aa0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
33ab0 4d 49 54 5f 57 41 4c 0a 20 20 20 20 61 73 73 65 MIT_WAL. asse
33ac0 72 74 28 20 70 50 61 67 65 72 2d 3e 70 57 61 6c rt( pPager->pWal
33ad0 3d 3d 30 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 ==0 || rc==SQLIT
33ae0 45 5f 4f 4b 20 29 3b 0a 23 65 6e 64 69 66 0a 20 E_OK );.#endif.
33af0 20 7d 0a 0a 20 20 69 66 28 20 70 61 67 65 72 55 }.. if( pagerU
33b00 73 65 57 61 6c 28 70 50 61 67 65 72 29 20 29 7b seWal(pPager) ){
33b10 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63 3d . assert( rc=
33b20 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 =SQLITE_OK );.
33b30 20 20 72 63 20 3d 20 70 61 67 65 72 42 65 67 69 rc = pagerBegi
33b40 6e 52 65 61 64 54 72 61 6e 73 61 63 74 69 6f 6e nReadTransaction
33b50 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 0a 20 (pPager);. }..
33b60 20 69 66 28 20 70 50 61 67 65 72 2d 3e 74 65 6d if( pPager->tem
33b70 70 46 69 6c 65 3d 3d 30 20 26 26 20 70 50 61 67 pFile==0 && pPag
33b80 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 er->eState==PAGE
33b90 52 5f 4f 50 45 4e 20 26 26 20 72 63 3d 3d 53 51 R_OPEN && rc==SQ
33ba0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
33bb0 63 20 3d 20 70 61 67 65 72 50 61 67 65 63 6f 75 c = pagerPagecou
33bc0 6e 74 28 70 50 61 67 65 72 2c 20 26 70 50 61 67 nt(pPager, &pPag
33bd0 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a 20 20 7d er->dbSize);. }
33be0 0a 0a 20 66 61 69 6c 65 64 3a 0a 20 20 69 66 28 .. failed:. if(
33bf0 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 rc!=SQLITE_OK )
33c00 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 4d {. assert( !M
33c10 45 4d 44 42 20 29 3b 0a 20 20 20 20 70 61 67 65 EMDB );. page
33c20 72 5f 75 6e 6c 6f 63 6b 28 70 50 61 67 65 72 29 r_unlock(pPager)
33c30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 50 ;. assert( pP
33c40 61 67 65 72 2d 3e 65 53 74 61 74 65 3d 3d 50 41 ager->eState==PA
33c50 47 45 52 5f 4f 50 45 4e 20 29 3b 0a 20 20 7d 65 GER_OPEN );. }e
33c60 6c 73 65 7b 0a 20 20 20 20 70 50 61 67 65 72 2d lse{. pPager-
33c70 3e 65 53 74 61 74 65 20 3d 20 50 41 47 45 52 5f >eState = PAGER_
33c80 52 45 41 44 45 52 3b 0a 20 20 20 20 70 50 61 67 READER;. pPag
33c90 65 72 2d 3e 68 61 73 48 65 6c 64 53 68 61 72 65 er->hasHeldShare
33ca0 64 4c 6f 63 6b 20 3d 20 31 3b 0a 20 20 7d 0a 20 dLock = 1;. }.
33cb0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
33cc0 2a 0a 2a 2a 20 49 66 20 74 68 65 20 72 65 66 65 *.** If the refe
33cd0 72 65 6e 63 65 20 63 6f 75 6e 74 20 68 61 73 20 rence count has
33ce0 72 65 61 63 68 65 64 20 7a 65 72 6f 2c 20 72 6f reached zero, ro
33cf0 6c 6c 62 61 63 6b 20 61 6e 79 20 61 63 74 69 76 llback any activ
33d00 65 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e e.** transaction
33d10 20 61 6e 64 20 75 6e 6c 6f 63 6b 20 74 68 65 20 and unlock the
33d20 70 61 67 65 72 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 pager..**.** Exc
33d30 65 70 74 2c 20 69 6e 20 6c 6f 63 6b 69 6e 67 5f ept, in locking_
33d40 6d 6f 64 65 3d 45 58 43 4c 55 53 49 56 45 20 77 mode=EXCLUSIVE w
33d50 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e 6f 74 hen there is not
33d60 68 69 6e 67 20 74 6f 20 69 6e 0a 2a 2a 20 74 68 hing to in.** th
33d70 65 20 72 6f 6c 6c 62 61 63 6b 20 6a 6f 75 72 6e e rollback journ
33d80 61 6c 2c 20 74 68 65 20 75 6e 6c 6f 63 6b 20 69 al, the unlock i
33d90 73 20 6e 6f 74 20 70 65 72 66 6f 72 6d 65 64 20 s not performed
33da0 61 6e 64 20 74 68 65 72 65 20 69 73 0a 2a 2a 20 and there is.**
33db0 6e 6f 74 68 69 6e 67 20 74 6f 20 72 6f 6c 6c 62 nothing to rollb
33dc0 61 63 6b 2c 20 73 6f 20 74 68 69 73 20 72 6f 75 ack, so this rou
33dd0 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 2e tine is a no-op.
33de0 0a 2a 2f 20 0a 73 74 61 74 69 63 20 76 6f 69 64 .*/ .static void
33df0 20 70 61 67 65 72 55 6e 6c 6f 63 6b 49 66 55 6e pagerUnlockIfUn
33e00 75 73 65 64 28 50 61 67 65 72 20 2a 70 50 61 67 used(Pager *pPag
33e10 65 72 29 7b 0a 20 20 69 66 28 20 73 71 6c 69 74 er){. if( sqlit
33e20 65 33 50 63 61 63 68 65 52 65 66 43 6f 75 6e 74 e3PcacheRefCount
33e30 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 (pPager->pPCache
33e40 29 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 )==0 ){. asse
33e50 72 74 28 20 70 50 61 67 65 72 2d 3e 6e 4d 6d 61 rt( pPager->nMma
33e60 70 4f 75 74 3d 3d 30 20 29 3b 20 2f 2a 20 62 65 pOut==0 ); /* be
33e70 63 61 75 73 65 20 70 61 67 65 31 20 69 73 20 6e cause page1 is n
33e80 65 76 65 72 20 6d 65 6d 6f 72 79 20 6d 61 70 70 ever memory mapp
33e90 65 64 20 2a 2f 0a 20 20 20 20 70 61 67 65 72 55 ed */. pagerU
33ea0 6e 6c 6f 63 6b 41 6e 64 52 6f 6c 6c 62 61 63 6b nlockAndRollback
33eb0 28 70 50 61 67 65 72 29 3b 0a 20 20 7d 0a 7d 0a (pPager);. }.}.
33ec0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 70 61 67 65 20 ./*.** The page
33ed0 67 65 74 74 65 72 20 6d 65 74 68 6f 64 73 20 65 getter methods e
33ee0 61 63 68 20 74 72 79 20 74 6f 20 61 63 71 75 69 ach try to acqui
33ef0 72 65 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 re a reference t
33f00 6f 20 61 0a 2a 2a 20 70 61 67 65 20 77 69 74 68 o a.** page with
33f10 20 70 61 67 65 20 6e 75 6d 62 65 72 20 70 67 6e page number pgn
33f20 6f 2e 20 49 66 20 74 68 65 20 72 65 71 75 65 73 o. If the reques
33f30 74 65 64 20 72 65 66 65 72 65 6e 63 65 20 69 73 ted reference is
33f40 20 0a 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 6c .** successfull
33f50 79 20 6f 62 74 61 69 6e 65 64 2c 20 69 74 20 69 y obtained, it i
33f60 73 20 63 6f 70 69 65 64 20 74 6f 20 2a 70 70 50 s copied to *ppP
33f70 61 67 65 20 61 6e 64 20 53 51 4c 49 54 45 5f 4f age and SQLITE_O
33f80 4b 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2a 0a 2a K returned..**.*
33f90 2a 20 54 68 65 72 65 20 61 72 65 20 64 69 66 66 * There are diff
33fa0 65 72 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 erent implementa
33fb0 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 67 65 74 tions of the get
33fc0 74 65 72 20 6d 65 74 68 6f 64 20 64 65 70 65 6e ter method depen
33fd0 64 69 6e 67 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 ding.** on the c
33fe0 75 72 72 65 6e 74 20 73 74 61 74 65 20 6f 66 20 urrent state of
33ff0 74 68 65 20 70 61 67 65 72 2e 0a 2a 2a 0a 2a 2a the pager..**.**
34000 20 20 20 20 20 67 65 74 50 61 67 65 4e 6f 72 6d getPageNorm
34010 61 6c 28 29 20 20 20 20 20 20 20 20 20 2d 2d 20 al() --
34020 20 54 68 65 20 6e 6f 72 6d 61 6c 20 67 65 74 74 The normal gett
34030 65 72 0a 2a 2a 20 20 20 20 20 67 65 74 50 61 67 er.** getPag
34040 65 45 72 72 6f 72 28 29 20 20 20 20 20 20 20 20 eError()
34050 20 20 2d 2d 20 20 55 73 65 64 20 69 66 20 74 68 -- Used if th
34060 65 20 70 61 67 65 72 20 69 73 20 69 6e 20 61 6e e pager is in an
34070 20 65 72 72 6f 72 20 73 74 61 74 65 0a 2a 2a 20 error state.**
34080 20 20 20 20 67 65 74 50 61 67 65 4d 6d 61 70 28 getPageMmap(
34090 29 20 20 20 20 20 20 20 20 20 20 20 2d 2d 20 20 ) --
340a0 55 73 65 64 20 69 66 20 6d 65 6d 6f 72 79 2d 6d Used if memory-m
340b0 61 70 70 65 64 20 49 2f 4f 20 69 73 20 65 6e 61 apped I/O is ena
340c0 62 6c 65 64 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 bled.**.** If th
340d0 65 20 72 65 71 75 65 73 74 65 64 20 70 61 67 65 e requested page
340e0 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 is already in t
340f0 68 65 20 63 61 63 68 65 2c 20 69 74 20 69 73 20 he cache, it is
34100 72 65 74 75 72 6e 65 64 2e 20 0a 2a 2a 20 4f 74 returned. .** Ot
34110 68 65 72 77 69 73 65 2c 20 61 20 6e 65 77 20 70 herwise, a new p
34120 61 67 65 20 6f 62 6a 65 63 74 20 69 73 20 61 6c age object is al
34130 6c 6f 63 61 74 65 64 20 61 6e 64 20 70 6f 70 75 located and popu
34140 6c 61 74 65 64 20 77 69 74 68 20 64 61 74 61 0a lated with data.
34150 2a 2a 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65 ** read from the
34160 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
34170 49 6e 20 73 6f 6d 65 20 63 61 73 65 73 2c 20 74 In some cases, t
34180 68 65 20 70 63 61 63 68 65 20 6d 6f 64 75 6c 65 he pcache module
34190 20 6d 61 79 0a 2a 2a 20 63 68 6f 6f 73 65 20 6e may.** choose n
341a0 6f 74 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 ot to allocate a
341b0 20 6e 65 77 20 70 61 67 65 20 6f 62 6a 65 63 74 new page object
341c0 20 61 6e 64 20 6d 61 79 20 72 65 75 73 65 20 61 and may reuse a
341d0 6e 20 65 78 69 73 74 69 6e 67 0a 2a 2a 20 6f 62 n existing.** ob
341e0 6a 65 63 74 20 77 69 74 68 20 6e 6f 20 6f 75 74 ject with no out
341f0 73 74 61 6e 64 69 6e 67 20 72 65 66 65 72 65 6e standing referen
34200 63 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 65 ces..**.** The e
34210 78 74 72 61 20 64 61 74 61 20 61 70 70 65 6e 64 xtra data append
34220 65 64 20 74 6f 20 61 20 70 61 67 65 20 69 73 20 ed to a page is
34230 61 6c 77 61 79 73 20 69 6e 69 74 69 61 6c 69 7a always initializ
34240 65 64 20 74 6f 20 7a 65 72 6f 73 20 74 68 65 20 ed to zeros the
34250 0a 2a 2a 20 66 69 72 73 74 20 74 69 6d 65 20 61 .** first time a
34260 20 70 61 67 65 20 69 73 20 6c 6f 61 64 65 64 20 page is loaded
34270 69 6e 74 6f 20 6d 65 6d 6f 72 79 2e 20 49 66 20 into memory. If
34280 74 68 65 20 70 61 67 65 20 72 65 71 75 65 73 74 the page request
34290 65 64 20 69 73 20 0a 2a 2a 20 61 6c 72 65 61 64 ed is .** alread
342a0 79 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 77 y in the cache w
342b0 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f hen this functio
342c0 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 n is called, the
342d0 6e 20 74 68 65 20 65 78 74 72 61 0a 2a 2a 20 64 n the extra.** d
342e0 61 74 61 20 69 73 20 6c 65 66 74 20 61 73 20 69 ata is left as i
342f0 74 20 77 61 73 20 77 68 65 6e 20 74 68 65 20 70 t was when the p
34300 61 67 65 20 6f 62 6a 65 63 74 20 77 61 73 20 6c age object was l
34310 61 73 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 ast used..**.**
34320 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20 If the database
34330 69 6d 61 67 65 20 69 73 20 73 6d 61 6c 6c 65 72 image is smaller
34340 20 74 68 61 6e 20 74 68 65 20 72 65 71 75 65 73 than the reques
34350 74 65 64 20 70 61 67 65 20 6f 72 20 69 66 20 0a ted page or if .
34360 2a 2a 20 74 68 65 20 66 6c 61 67 73 20 70 61 72 ** the flags par
34370 61 6d 65 74 65 72 20 63 6f 6e 74 61 69 6e 73 20 ameter contains
34380 74 68 65 20 50 41 47 45 52 5f 47 45 54 5f 4e 4f the PAGER_GET_NO
34390 43 4f 4e 54 45 4e 54 20 62 69 74 20 61 6e 64 20 CONTENT bit and
343a0 74 68 65 20 0a 2a 2a 20 72 65 71 75 65 73 74 65 the .** requeste
343b0 64 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c d page is not al
343c0 72 65 61 64 79 20 73 74 6f 72 65 64 20 69 6e 20 ready stored in
343d0 74 68 65 20 63 61 63 68 65 2c 20 74 68 65 6e 20 the cache, then
343e0 6e 6f 20 0a 2a 2a 20 61 63 74 75 61 6c 20 64 69 no .** actual di
343f0 73 6b 20 72 65 61 64 20 6f 63 63 75 72 73 2e 20 sk read occurs.
34400 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
34410 20 6d 65 6d 6f 72 79 20 69 6d 61 67 65 20 6f 66 memory image of
34420 20 74 68 65 20 0a 2a 2a 20 70 61 67 65 20 69 73 the .** page is
34430 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 initialized to
34440 61 6c 6c 20 7a 65 72 6f 73 2e 20 0a 2a 2a 0a 2a all zeros. .**.*
34450 2a 20 49 66 20 50 41 47 45 52 5f 47 45 54 5f 4e * If PAGER_GET_N
34460 4f 43 4f 4e 54 45 4e 54 20 69 73 20 74 72 75 65 OCONTENT is true
34470 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 , it means that
34480 77 65 20 64 6f 20 6e 6f 74 20 63 61 72 65 20 61 we do not care a
34490 62 6f 75 74 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 bout.** the cont
344a0 65 6e 74 73 20 6f 66 20 74 68 65 20 70 61 67 65 ents of the page
344b0 2e 20 54 68 69 73 20 6f 63 63 75 72 73 20 69 6e . This occurs in
344c0 20 74 77 6f 20 73 63 65 6e 61 72 69 6f 73 3a 0a two scenarios:.
344d0 2a 2a 0a 2a 2a 20 20 20 61 29 20 57 68 65 6e 20 **.** a) When
344e0 72 65 61 64 69 6e 67 20 61 20 66 72 65 65 2d 6c reading a free-l
344f0 69 73 74 20 6c 65 61 66 20 70 61 67 65 20 66 72 ist leaf page fr
34500 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2c om the database,
34510 20 61 6e 64 0a 2a 2a 0a 2a 2a 20 20 20 62 29 20 and.**.** b)
34520 57 68 65 6e 20 61 20 73 61 76 65 70 6f 69 6e 74 When a savepoint
34530 20 69 73 20 62 65 69 6e 67 20 72 6f 6c 6c 65 64 is being rolled
34540 20 62 61 63 6b 20 61 6e 64 20 77 65 20 6e 65 65 back and we nee
34550 64 20 74 6f 20 6c 6f 61 64 0a 2a 2a 20 20 20 20 d to load.**
34560 20 20 61 20 6e 65 77 20 70 61 67 65 20 69 6e 74 a new page int
34570 6f 20 74 68 65 20 63 61 63 68 65 20 74 6f 20 62 o the cache to b
34580 65 20 66 69 6c 6c 65 64 20 77 69 74 68 20 74 68 e filled with th
34590 65 20 64 61 74 61 20 72 65 61 64 0a 2a 2a 20 20 e data read.**
345a0 20 20 20 20 66 72 6f 6d 20 74 68 65 20 73 61 76 from the sav
345b0 65 70 6f 69 6e 74 20 6a 6f 75 72 6e 61 6c 2e 0a epoint journal..
345c0 2a 2a 0a 2a 2a 20 49 66 20 50 41 47 45 52 5f 47 **.** If PAGER_G
345d0 45 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 69 73 20 ET_NOCONTENT is
345e0 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 64 true, then the d
345f0 61 74 61 20 72 65 74 75 72 6e 65 64 20 69 73 20 ata returned is
34600 7a 65 72 6f 65 64 20 69 6e 73 74 65 61 64 0a 2a zeroed instead.*
34610 2a 20 6f 66 20 62 65 69 6e 67 20 72 65 61 64 20 * of being read
34620 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 from the databas
34630 65 2e 20 41 64 64 69 74 69 6f 6e 61 6c 6c 79 2c e. Additionally,
34640 20 74 68 65 20 62 69 74 73 20 63 6f 72 72 65 73 the bits corres
34650 70 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20 70 67 ponding.** to pg
34660 6e 6f 20 69 6e 20 50 61 67 65 72 2e 70 49 6e 4a no in Pager.pInJ
34670 6f 75 72 6e 61 6c 20 28 62 69 74 76 65 63 20 6f ournal (bitvec o
34680 66 20 70 61 67 65 73 20 61 6c 72 65 61 64 79 20 f pages already
34690 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 0a 2a written to the.*
346a0 2a 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 29 20 * journal file)
346b0 61 6e 64 20 74 68 65 20 50 61 67 65 72 53 61 76 and the PagerSav
346c0 65 70 6f 69 6e 74 2e 70 49 6e 53 61 76 65 70 6f epoint.pInSavepo
346d0 69 6e 74 20 62 69 74 76 65 63 73 20 6f 66 20 61 int bitvecs of a
346e0 6e 79 20 6f 70 65 6e 0a 2a 2a 20 73 61 76 65 70 ny open.** savep
346f0 6f 69 6e 74 73 20 61 72 65 20 73 65 74 2e 20 54 oints are set. T
34700 68 69 73 20 6d 65 61 6e 73 20 69 66 20 74 68 65 his means if the
34710 20 70 61 67 65 20 69 73 20 6d 61 64 65 20 77 72 page is made wr
34720 69 74 61 62 6c 65 20 61 74 20 61 6e 79 0a 2a 2a itable at any.**
34730 20 70 6f 69 6e 74 20 69 6e 20 74 68 65 20 66 75 point in the fu
34740 74 75 72 65 2c 20 75 73 69 6e 67 20 61 20 63 61 ture, using a ca
34750 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 50 61 67 ll to sqlite3Pag
34760 65 72 57 72 69 74 65 28 29 2c 20 69 74 73 20 63 erWrite(), its c
34770 6f 6e 74 65 6e 74 73 0a 2a 2a 20 77 69 6c 6c 20 ontents.** will
34780 6e 6f 74 20 62 65 20 6a 6f 75 72 6e 61 6c 65 64 not be journaled
34790 2e 20 54 68 69 73 20 73 61 76 65 73 20 49 4f 2e . This saves IO.
347a0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 63 71 75 69 .**.** The acqui
347b0 73 69 74 69 6f 6e 20 6d 69 67 68 74 20 66 61 69 sition might fai
347c0 6c 20 66 6f 72 20 73 65 76 65 72 61 6c 20 72 65 l for several re
347d0 61 73 6f 6e 73 2e 20 20 49 6e 20 61 6c 6c 20 63 asons. In all c
347e0 61 73 65 73 2c 0a 2a 2a 20 61 6e 20 61 70 70 72 ases,.** an appr
347f0 6f 70 72 69 61 74 65 20 65 72 72 6f 72 20 63 6f opriate error co
34800 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 20 61 de is returned a
34810 6e 64 20 2a 70 70 50 61 67 65 20 69 73 20 73 65 nd *ppPage is se
34820 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a t to NULL..**.**
34830 20 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 74 65 See also sqlite
34840 33 50 61 67 65 72 4c 6f 6f 6b 75 70 28 29 2e 20 3PagerLookup().
34850 20 42 6f 74 68 20 74 68 69 73 20 72 6f 75 74 69 Both this routi
34860 6e 65 20 61 6e 64 20 4c 6f 6f 6b 75 70 28 29 20 ne and Lookup()
34870 61 74 74 65 6d 70 74 0a 2a 2a 20 74 6f 20 66 69 attempt.** to fi
34880 6e 64 20 61 20 70 61 67 65 20 69 6e 20 74 68 65 nd a page in the
34890 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 68 65 in-memory cache
348a0 20 66 69 72 73 74 2e 20 20 49 66 20 74 68 65 20 first. If the
348b0 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 page is not alre
348c0 61 64 79 0a 2a 2a 20 69 6e 20 6d 65 6d 6f 72 79 ady.** in memory
348d0 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 67 , this routine g
348e0 6f 65 73 20 74 6f 20 64 69 73 6b 20 74 6f 20 72 oes to disk to r
348f0 65 61 64 20 69 74 20 69 6e 20 77 68 65 72 65 61 ead it in wherea
34900 73 20 4c 6f 6f 6b 75 70 28 29 0a 2a 2a 20 6a 75 s Lookup().** ju
34910 73 74 20 72 65 74 75 72 6e 73 20 30 2e 20 20 54 st returns 0. T
34920 68 69 73 20 72 6f 75 74 69 6e 65 20 61 63 71 75 his routine acqu
34930 69 72 65 73 20 61 20 72 65 61 64 2d 6c 6f 63 6b ires a read-lock
34940 20 74 68 65 20 66 69 72 73 74 20 74 69 6d 65 20 the first time
34950 69 74 0a 2a 2a 20 68 61 73 20 74 6f 20 67 6f 20 it.** has to go
34960 74 6f 20 64 69 73 6b 2c 20 61 6e 64 20 63 6f 75 to disk, and cou
34970 6c 64 20 61 6c 73 6f 20 70 6c 61 79 62 61 63 6b ld also playback
34980 20 61 6e 20 6f 6c 64 20 6a 6f 75 72 6e 61 6c 20 an old journal
34990 69 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2a if necessary..**
349a0 20 53 69 6e 63 65 20 4c 6f 6f 6b 75 70 28 29 20 Since Lookup()
349b0 6e 65 76 65 72 20 67 6f 65 73 20 74 6f 20 64 69 never goes to di
349c0 73 6b 2c 20 69 74 20 6e 65 76 65 72 20 68 61 73 sk, it never has
349d0 20 74 6f 20 64 65 61 6c 20 77 69 74 68 20 6c 6f to deal with lo
349e0 63 6b 73 0a 2a 2a 20 6f 72 20 6a 6f 75 72 6e 61 cks.** or journa
349f0 6c 20 66 69 6c 65 73 2e 0a 2a 2f 0a 73 74 61 74 l files..*/.stat
34a00 69 63 20 69 6e 74 20 67 65 74 50 61 67 65 4e 6f ic int getPageNo
34a10 72 6d 61 6c 28 0a 20 20 50 61 67 65 72 20 2a 70 rmal(. Pager *p
34a20 50 61 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 Pager, /* T
34a30 68 65 20 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e he pager open on
34a40 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 the database fi
34a50 6c 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e le */. Pgno pgn
34a60 6f 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 o, /* P
34a70 61 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 age number to fe
34a80 74 63 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 tch */. DbPage
34a90 2a 2a 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 **ppPage, /*
34aa0 57 72 69 74 65 20 61 20 70 6f 69 6e 74 65 72 20 Write a pointer
34ab0 74 6f 20 74 68 65 20 70 61 67 65 20 68 65 72 65 to the page here
34ac0 20 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 */. int flags
34ad0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 /* PAG
34ae0 45 52 5f 47 45 54 5f 58 58 58 20 66 6c 61 67 73 ER_GET_XXX flags
34af0 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 */.){. int rc
34b00 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 = SQLITE_OK;. P
34b10 67 48 64 72 20 2a 70 50 67 3b 0a 20 20 75 38 20 gHdr *pPg;. u8
34b20 6e 6f 43 6f 6e 74 65 6e 74 3b 20 20 20 20 20 20 noContent;
34b30 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
34b40 54 72 75 65 20 69 66 20 50 41 47 45 52 5f 47 45 True if PAGER_GE
34b50 54 5f 4e 4f 43 4f 4e 54 45 4e 54 20 69 73 20 73 T_NOCONTENT is s
34b60 65 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f et */. sqlite3_
34b70 70 63 61 63 68 65 5f 70 61 67 65 20 2a 70 42 61 pcache_page *pBa
34b80 73 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 se;.. assert( p
34b90 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 3d 3d Pager->errCode==
34ba0 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20 20 61 SQLITE_OK );. a
34bb0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 ssert( pPager->e
34bc0 53 74 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 41 State>=PAGER_REA
34bd0 44 45 52 20 29 3b 0a 20 20 61 73 73 65 72 74 28 DER );. assert(
34be0 20 61 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 assert_pager_st
34bf0 61 74 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 ate(pPager) );.
34c00 20 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d assert( pPager-
34c10 3e 68 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f >hasHeldSharedLo
34c20 63 6b 3d 3d 31 20 29 3b 0a 0a 20 20 69 66 28 20 ck==1 );.. if(
34c30 70 67 6e 6f 3d 3d 30 20 29 20 72 65 74 75 72 6e pgno==0 ) return
34c40 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
34c50 42 4b 50 54 3b 0a 20 20 70 42 61 73 65 20 3d 20 BKPT;. pBase =
34c60 73 71 6c 69 74 65 33 50 63 61 63 68 65 46 65 74 sqlite3PcacheFet
34c70 63 68 28 70 50 61 67 65 72 2d 3e 70 50 43 61 63 ch(pPager->pPCac
34c80 68 65 2c 20 70 67 6e 6f 2c 20 33 29 3b 0a 20 20 he, pgno, 3);.
34c90 69 66 28 20 70 42 61 73 65 3d 3d 30 20 29 7b 0a if( pBase==0 ){.
34ca0 20 20 20 20 70 50 67 20 3d 20 30 3b 0a 20 20 20 pPg = 0;.
34cb0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 63 61 rc = sqlite3Pca
34cc0 63 68 65 46 65 74 63 68 53 74 72 65 73 73 28 70 cheFetchStress(p
34cd0 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c 20 Pager->pPCache,
34ce0 70 67 6e 6f 2c 20 26 70 42 61 73 65 29 3b 0a 20 pgno, &pBase);.
34cf0 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
34d00 45 5f 4f 4b 20 29 20 67 6f 74 6f 20 70 61 67 65 E_OK ) goto page
34d10 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 r_acquire_err;.
34d20 20 20 20 69 66 28 20 70 42 61 73 65 3d 3d 30 20 if( pBase==0
34d30 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 ){. rc = SQ
34d40 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
34d50 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 . goto page
34d60 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 r_acquire_err;.
34d70 20 20 20 7d 0a 20 20 7d 0a 20 20 70 50 67 20 3d }. }. pPg =
34d80 20 2a 70 70 50 61 67 65 20 3d 20 73 71 6c 69 74 *ppPage = sqlit
34d90 65 33 50 63 61 63 68 65 46 65 74 63 68 46 69 6e e3PcacheFetchFin
34da0 69 73 68 28 70 50 61 67 65 72 2d 3e 70 50 43 61 ish(pPager->pPCa
34db0 63 68 65 2c 20 70 67 6e 6f 2c 20 70 42 61 73 65 che, pgno, pBase
34dc0 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 );. assert( pPg
34dd0 3d 3d 28 2a 70 70 50 61 67 65 29 20 29 3b 0a 20 ==(*ppPage) );.
34de0 20 61 73 73 65 72 74 28 20 70 50 67 2d 3e 70 67 assert( pPg->pg
34df0 6e 6f 3d 3d 70 67 6e 6f 20 29 3b 0a 20 20 61 73 no==pgno );. as
34e00 73 65 72 74 28 20 70 50 67 2d 3e 70 50 61 67 65 sert( pPg->pPage
34e10 72 3d 3d 70 50 61 67 65 72 20 7c 7c 20 70 50 67 r==pPager || pPg
34e20 2d 3e 70 50 61 67 65 72 3d 3d 30 20 29 3b 0a 0a ->pPager==0 );..
34e30 20 20 6e 6f 43 6f 6e 74 65 6e 74 20 3d 20 28 66 noContent = (f
34e40 6c 61 67 73 20 26 20 50 41 47 45 52 5f 47 45 54 lags & PAGER_GET
34e50 5f 4e 4f 43 4f 4e 54 45 4e 54 29 21 3d 30 3b 0a _NOCONTENT)!=0;.
34e60 20 20 69 66 28 20 70 50 67 2d 3e 70 50 61 67 65 if( pPg->pPage
34e70 72 20 26 26 20 21 6e 6f 43 6f 6e 74 65 6e 74 20 r && !noContent
34e80 29 7b 0a 20 20 20 20 2f 2a 20 49 6e 20 74 68 69 ){. /* In thi
34e90 73 20 63 61 73 65 20 74 68 65 20 70 63 61 63 68 s case the pcach
34ea0 65 20 61 6c 72 65 61 64 79 20 63 6f 6e 74 61 69 e already contai
34eb0 6e 73 20 61 6e 20 69 6e 69 74 69 61 6c 69 7a 65 ns an initialize
34ec0 64 20 63 6f 70 79 20 6f 66 0a 20 20 20 20 2a 2a d copy of. **
34ed0 20 74 68 65 20 70 61 67 65 2e 20 52 65 74 75 72 the page. Retur
34ee0 6e 20 77 69 74 68 6f 75 74 20 66 75 72 74 68 65 n without furthe
34ef0 72 20 61 64 6f 2e 20 20 2a 2f 0a 20 20 20 20 61 r ado. */. a
34f00 73 73 65 72 74 28 20 70 67 6e 6f 3c 3d 50 41 47 ssert( pgno<=PAG
34f10 45 52 5f 4d 41 58 5f 50 47 4e 4f 20 26 26 20 70 ER_MAX_PGNO && p
34f20 67 6e 6f 21 3d 50 41 47 45 52 5f 4d 4a 5f 50 47 gno!=PAGER_MJ_PG
34f30 4e 4f 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 NO(pPager) );.
34f40 20 20 70 50 61 67 65 72 2d 3e 61 53 74 61 74 5b pPager->aStat[
34f50 50 41 47 45 52 5f 53 54 41 54 5f 48 49 54 5d 2b PAGER_STAT_HIT]+
34f60 2b 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 +;. return SQ
34f70 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 7d 65 6c 73 LITE_OK;.. }els
34f80 65 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 70 61 e{. /* The pa
34f90 67 65 72 20 63 61 63 68 65 20 68 61 73 20 63 72 ger cache has cr
34fa0 65 61 74 65 64 20 61 20 6e 65 77 20 70 61 67 65 eated a new page
34fb0 2e 20 49 74 73 20 63 6f 6e 74 65 6e 74 20 6e 65 . Its content ne
34fc0 65 64 73 20 74 6f 20 0a 20 20 20 20 2a 2a 20 62 eds to . ** b
34fd0 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e 20 42 e initialized. B
34fe0 75 74 20 66 69 72 73 74 20 73 6f 6d 65 20 65 72 ut first some er
34ff0 72 6f 72 20 63 68 65 63 6b 73 3a 0a 20 20 20 20 ror checks:.
35000 2a 2a 0a 20 20 20 20 2a 2a 20 28 31 29 20 54 68 **. ** (1) Th
35010 65 20 6d 61 78 69 6d 75 6d 20 70 61 67 65 20 6e e maximum page n
35020 75 6d 62 65 72 20 69 73 20 32 5e 33 31 0a 20 20 umber is 2^31.
35030 20 20 2a 2a 20 28 32 29 20 4e 65 76 65 72 20 74 ** (2) Never t
35040 72 79 20 74 6f 20 66 65 74 63 68 20 74 68 65 20 ry to fetch the
35050 6c 6f 63 6b 69 6e 67 20 70 61 67 65 0a 20 20 20 locking page.
35060 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 67 6e 6f */. if( pgno
35070 3e 50 41 47 45 52 5f 4d 41 58 5f 50 47 4e 4f 20 >PAGER_MAX_PGNO
35080 7c 7c 20 70 67 6e 6f 3d 3d 50 41 47 45 52 5f 4d || pgno==PAGER_M
35090 4a 5f 50 47 4e 4f 28 70 50 61 67 65 72 29 20 29 J_PGNO(pPager) )
350a0 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c {. rc = SQL
350b0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
350c0 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 70 61 67 ;. goto pag
350d0 65 72 5f 61 63 71 75 69 72 65 5f 65 72 72 3b 0a er_acquire_err;.
350e0 20 20 20 20 7d 0a 0a 20 20 20 20 70 50 67 2d 3e }.. pPg->
350f0 70 50 61 67 65 72 20 3d 20 70 50 61 67 65 72 3b pPager = pPager;
35100 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 21 69 .. assert( !i
35110 73 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 66 64 sOpen(pPager->fd
35120 29 20 7c 7c 20 21 4d 45 4d 44 42 20 29 3b 0a 20 ) || !MEMDB );.
35130 20 20 20 69 66 28 20 21 69 73 4f 70 65 6e 28 70 if( !isOpen(p
35140 50 61 67 65 72 2d 3e 66 64 29 20 7c 7c 20 70 50 Pager->fd) || pP
35150 61 67 65 72 2d 3e 64 62 53 69 7a 65 3c 70 67 6e ager->dbSize<pgn
35160 6f 20 7c 7c 20 6e 6f 43 6f 6e 74 65 6e 74 20 29 o || noContent )
35170 7b 0a 20 20 20 20 20 20 69 66 28 20 70 67 6e 6f {. if( pgno
35180 3e 70 50 61 67 65 72 2d 3e 6d 78 50 67 6e 6f 20 >pPager->mxPgno
35190 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 ){. rc =
351a0 53 51 4c 49 54 45 5f 46 55 4c 4c 3b 0a 20 20 20 SQLITE_FULL;.
351b0 20 20 20 20 20 67 6f 74 6f 20 70 61 67 65 72 5f goto pager_
351c0 61 63 71 75 69 72 65 5f 65 72 72 3b 0a 20 20 20 acquire_err;.
351d0 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 6e }. if( n
351e0 6f 43 6f 6e 74 65 6e 74 20 29 7b 0a 20 20 20 20 oContent ){.
351f0 20 20 20 20 2f 2a 20 46 61 69 6c 75 72 65 20 74 /* Failure t
35200 6f 20 73 65 74 20 74 68 65 20 62 69 74 73 20 69 o set the bits i
35210 6e 20 74 68 65 20 49 6e 4a 6f 75 72 6e 61 6c 20 n the InJournal
35220 62 69 74 2d 76 65 63 74 6f 72 73 20 69 73 20 62 bit-vectors is b
35230 65 6e 69 67 6e 2e 0a 20 20 20 20 20 20 20 20 2a enign.. *
35240 2a 20 49 74 20 6d 65 72 65 6c 79 20 6d 65 61 6e * It merely mean
35250 73 20 74 68 61 74 20 77 65 20 6d 69 67 68 74 20 s that we might
35260 64 6f 20 73 6f 6d 65 20 65 78 74 72 61 20 77 6f do some extra wo
35270 72 6b 20 74 6f 20 6a 6f 75 72 6e 61 6c 20 61 20 rk to journal a
35280 0a 20 20 20 20 20 20 20 20 2a 2a 20 70 61 67 65 . ** page
35290 20 74 68 61 74 20 64 6f 65 73 20 6e 6f 74 20 6e that does not n
352a0 65 65 64 20 74 6f 20 62 65 20 6a 6f 75 72 6e 61 eed to be journa
352b0 6c 65 64 2e 20 20 4e 65 76 65 72 74 68 65 6c 65 led. Neverthele
352c0 73 73 2c 20 62 65 20 73 75 72 65 20 0a 20 20 20 ss, be sure .
352d0 20 20 20 20 20 2a 2a 20 74 6f 20 74 65 73 74 20 ** to test
352e0 74 68 65 20 63 61 73 65 20 77 68 65 72 65 20 61 the case where a
352f0 20 6d 61 6c 6c 6f 63 20 65 72 72 6f 72 20 6f 63 malloc error oc
35300 63 75 72 73 20 77 68 69 6c 65 20 74 72 79 69 6e curs while tryin
35310 67 20 74 6f 20 73 65 74 20 0a 20 20 20 20 20 20 g to set .
35320 20 20 2a 2a 20 61 20 62 69 74 20 69 6e 20 61 20 ** a bit in a
35330 62 69 74 20 76 65 63 74 6f 72 2e 0a 20 20 20 20 bit vector..
35340 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 73 */. s
35350 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 qlite3BeginBenig
35360 6e 4d 61 6c 6c 6f 63 28 29 3b 0a 20 20 20 20 20 nMalloc();.
35370 20 20 20 69 66 28 20 70 67 6e 6f 3c 3d 70 50 61 if( pgno<=pPa
35380 67 65 72 2d 3e 64 62 4f 72 69 67 53 69 7a 65 20 ger->dbOrigSize
35390 29 7b 0a 20 20 20 20 20 20 20 20 20 20 54 45 53 ){. TES
353a0 54 4f 4e 4c 59 28 20 72 63 20 3d 20 29 20 73 71 TONLY( rc = ) sq
353b0 6c 69 74 65 33 42 69 74 76 65 63 53 65 74 28 70 lite3BitvecSet(p
353c0 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 Pager->pInJourna
353d0 6c 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 l, pgno);.
353e0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 72 63 testcase( rc
353f0 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 ==SQLITE_NOMEM )
35400 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 ;. }.
35410 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 20 72 63 TESTONLY( rc
35420 20 3d 20 29 20 61 64 64 54 6f 53 61 76 65 70 6f = ) addToSavepo
35430 69 6e 74 42 69 74 76 65 63 73 28 70 50 61 67 65 intBitvecs(pPage
35440 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 20 r, pgno);.
35450 20 20 74 65 73 74 63 61 73 65 28 20 72 63 3d 3d testcase( rc==
35460 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 3b 0a SQLITE_NOMEM );.
35470 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 sqlite3E
35480 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 ndBenignMalloc()
35490 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
354a0 6d 65 6d 73 65 74 28 70 50 67 2d 3e 70 44 61 74 memset(pPg->pDat
354b0 61 2c 20 30 2c 20 70 50 61 67 65 72 2d 3e 70 61 a, 0, pPager->pa
354c0 67 65 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 49 geSize);. I
354d0 4f 54 52 41 43 45 28 28 22 5a 45 52 4f 20 25 70 OTRACE(("ZERO %p
354e0 20 25 64 5c 6e 22 2c 20 70 50 61 67 65 72 2c 20 %d\n", pPager,
354f0 70 67 6e 6f 29 29 3b 0a 20 20 20 20 7d 65 6c 73 pgno));. }els
35500 65 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 e{. assert(
35510 20 70 50 67 2d 3e 70 50 61 67 65 72 3d 3d 70 50 pPg->pPager==pP
35520 61 67 65 72 20 29 3b 0a 20 20 20 20 20 20 70 50 ager );. pP
35530 61 67 65 72 2d 3e 61 53 74 61 74 5b 50 41 47 45 ager->aStat[PAGE
35540 52 5f 53 54 41 54 5f 4d 49 53 53 5d 2b 2b 3b 0a R_STAT_MISS]++;.
35550 20 20 20 20 20 20 72 63 20 3d 20 72 65 61 64 44 rc = readD
35560 62 50 61 67 65 28 70 50 67 29 3b 0a 20 20 20 20 bPage(pPg);.
35570 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
35580 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 67 _OK ){. g
35590 6f 74 6f 20 70 61 67 65 72 5f 61 63 71 75 69 72 oto pager_acquir
355a0 65 5f 65 72 72 3b 0a 20 20 20 20 20 20 7d 0a 20 e_err;. }.
355b0 20 20 20 7d 0a 20 20 20 20 70 61 67 65 72 5f 73 }. pager_s
355c0 65 74 5f 70 61 67 65 68 61 73 68 28 70 50 67 29 et_pagehash(pPg)
355d0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 ;. }. return S
355e0 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 70 61 67 65 72 QLITE_OK;..pager
355f0 5f 61 63 71 75 69 72 65 5f 65 72 72 3a 0a 20 20 _acquire_err:.
35600 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
35610 54 45 5f 4f 4b 20 29 3b 0a 20 20 69 66 28 20 70 TE_OK );. if( p
35620 50 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 Pg ){. sqlite
35630 33 50 63 61 63 68 65 44 72 6f 70 28 70 50 67 29 3PcacheDrop(pPg)
35640 3b 0a 20 20 7d 0a 20 20 70 61 67 65 72 55 6e 6c ;. }. pagerUnl
35650 6f 63 6b 49 66 55 6e 75 73 65 64 28 70 50 61 67 ockIfUnused(pPag
35660 65 72 29 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d er);. *ppPage =
35670 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0;. return rc;
35680 0a 7d 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d .}..#if SQLITE_M
35690 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 3e 30 0a 2f AX_MMAP_SIZE>0./
356a0 2a 20 54 68 65 20 70 61 67 65 20 67 65 74 74 65 * The page gette
356b0 72 20 66 6f 72 20 77 68 65 6e 20 6d 65 6d 6f 72 r for when memor
356c0 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 69 73 20 y-mapped I/O is
356d0 65 6e 61 62 6c 65 64 20 2a 2f 0a 73 74 61 74 69 enabled */.stati
356e0 63 20 69 6e 74 20 67 65 74 50 61 67 65 4d 4d 61 c int getPageMMa
356f0 70 28 0a 20 20 50 61 67 65 72 20 2a 70 50 61 67 p(. Pager *pPag
35700 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 20 er, /* The
35710 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e 20 74 68 pager open on th
35720 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
35730 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f 2c 20 */. Pgno pgno,
35740 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
35750 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 74 63 68 number to fetch
35760 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a 2a 70 */. DbPage **p
35770 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 57 72 69 pPage, /* Wri
35780 74 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 te a pointer to
35790 74 68 65 20 70 61 67 65 20 68 65 72 65 20 2a 2f the page here */
357a0 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 20 20 . int flags
357b0 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 52 5f /* PAGER_
357c0 47 45 54 5f 58 58 58 20 66 6c 61 67 73 20 2a 2f GET_XXX flags */
357d0 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 .){. int rc = S
357e0 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 50 67 48 64 QLITE_OK;. PgHd
357f0 72 20 2a 70 50 67 20 3d 20 30 3b 0a 20 20 75 33 r *pPg = 0;. u3
35800 32 20 69 46 72 61 6d 65 20 3d 20 30 3b 20 20 20 2 iFrame = 0;
35810 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
35820 20 46 72 61 6d 65 20 74 6f 20 72 65 61 64 20 66 Frame to read f
35830 72 6f 6d 20 57 41 4c 20 66 69 6c 65 20 2a 2f 0a rom WAL file */.
35840 0a 20 20 2f 2a 20 49 74 20 69 73 20 61 63 63 65 . /* It is acce
35850 70 74 61 62 6c 65 20 74 6f 20 75 73 65 20 61 20 ptable to use a
35860 72 65 61 64 2d 6f 6e 6c 79 20 28 6d 6d 61 70 29 read-only (mmap)
35870 20 70 61 67 65 20 66 6f 72 20 61 6e 79 20 70 61 page for any pa
35880 67 65 20 65 78 63 65 70 74 0a 20 20 2a 2a 20 70 ge except. ** p
35890 61 67 65 20 31 20 69 66 20 74 68 65 72 65 20 69 age 1 if there i
358a0 73 20 6e 6f 20 77 72 69 74 65 2d 74 72 61 6e 73 s no write-trans
358b0 61 63 74 69 6f 6e 20 6f 70 65 6e 20 6f 72 20 74 action open or t
358c0 68 65 20 41 43 51 55 49 52 45 5f 52 45 41 44 4f he ACQUIRE_READO
358d0 4e 4c 59 0a 20 20 2a 2a 20 66 6c 61 67 20 77 61 NLY. ** flag wa
358e0 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 74 s specified by t
358f0 68 65 20 63 61 6c 6c 65 72 2e 20 41 6e 64 20 73 he caller. And s
35900 6f 20 6c 6f 6e 67 20 61 73 20 74 68 65 20 64 62 o long as the db
35910 20 69 73 20 6e 6f 74 20 61 20 0a 20 20 2a 2a 20 is not a . **
35920 74 65 6d 70 6f 72 61 72 79 20 6f 72 20 69 6e 2d temporary or in-
35930 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2e memory database.
35940 20 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 69 6e 74 */. const int
35950 20 62 4d 6d 61 70 4f 6b 20 3d 20 28 70 67 6e 6f bMmapOk = (pgno
35960 3e 31 0a 20 20 20 26 26 20 28 70 50 61 67 65 72 >1. && (pPager
35970 2d 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f ->eState==PAGER_
35980 52 45 41 44 45 52 20 7c 7c 20 28 66 6c 61 67 73 READER || (flags
35990 20 26 20 50 41 47 45 52 5f 47 45 54 5f 52 45 41 & PAGER_GET_REA
359a0 44 4f 4e 4c 59 29 29 0a 20 20 29 3b 0a 0a 20 20 DONLY)). );..
359b0 61 73 73 65 72 74 28 20 55 53 45 46 45 54 43 48 assert( USEFETCH
359c0 28 70 50 61 67 65 72 29 20 29 3b 0a 23 69 66 64 (pPager) );.#ifd
359d0 65 66 20 53 51 4c 49 54 45 5f 48 41 53 5f 43 4f ef SQLITE_HAS_CO
359e0 44 45 43 0a 20 20 61 73 73 65 72 74 28 20 70 50 DEC. assert( pP
359f0 61 67 65 72 2d 3e 78 43 6f 64 65 63 3d 3d 30 20 ager->xCodec==0
35a00 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 2f 2a 20 );.#endif.. /*
35a10 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 6e 6f 74 Optimization not
35a20 65 3a 20 20 41 64 64 69 6e 67 20 74 68 65 20 22 e: Adding the "
35a30 70 67 6e 6f 3c 3d 31 22 20 74 65 72 6d 20 62 65 pgno<=1" term be
35a40 66 6f 72 65 20 22 70 67 6e 6f 3d 3d 30 22 20 68 fore "pgno==0" h
35a50 65 72 65 0a 20 20 2a 2a 20 61 6c 6c 6f 77 73 20 ere. ** allows
35a60 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 6f 70 74 the compiler opt
35a70 69 6d 69 7a 65 72 20 74 6f 20 72 65 75 73 65 20 imizer to reuse
35a80 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 the results of t
35a90 68 65 20 22 70 67 6e 6f 3e 31 22 0a 20 20 2a 2a he "pgno>1". **
35aa0 20 74 65 73 74 20 69 6e 20 74 68 65 20 70 72 65 test in the pre
35ab0 76 69 6f 75 73 20 73 74 61 74 65 6d 65 6e 74 2c vious statement,
35ac0 20 61 6e 64 20 61 76 6f 69 64 20 74 65 73 74 69 and avoid testi
35ad0 6e 67 20 70 67 6e 6f 3d 3d 30 20 69 6e 20 74 68 ng pgno==0 in th
35ae0 65 0a 20 20 2a 2a 20 63 6f 6d 6d 6f 6e 20 63 61 e. ** common ca
35af0 73 65 20 77 68 65 72 65 20 70 67 6e 6f 20 69 73 se where pgno is
35b00 20 6c 61 72 67 65 2e 20 2a 2f 0a 20 20 69 66 28 large. */. if(
35b10 20 70 67 6e 6f 3c 3d 31 20 26 26 20 70 67 6e 6f pgno<=1 && pgno
35b20 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 ==0 ){. retur
35b30 6e 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 n SQLITE_CORRUPT
35b40 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 61 73 73 _BKPT;. }. ass
35b50 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 ert( pPager->eSt
35b60 61 74 65 3e 3d 50 41 47 45 52 5f 52 45 41 44 45 ate>=PAGER_READE
35b70 52 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 R );. assert( a
35b80 73 73 65 72 74 5f 70 61 67 65 72 5f 73 74 61 74 ssert_pager_stat
35b90 65 28 70 50 61 67 65 72 29 20 29 3b 0a 20 20 61 e(pPager) );. a
35ba0 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e 68 ssert( pPager->h
35bb0 61 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b asHeldSharedLock
35bc0 3d 3d 31 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ==1 );. assert(
35bd0 20 70 50 61 67 65 72 2d 3e 65 72 72 43 6f 64 65 pPager->errCode
35be0 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 0a ==SQLITE_OK );..
35bf0 20 20 69 66 28 20 62 4d 6d 61 70 4f 6b 20 26 26 if( bMmapOk &&
35c00 20 70 61 67 65 72 55 73 65 57 61 6c 28 70 50 61 pagerUseWal(pPa
35c10 67 65 72 29 20 29 7b 0a 20 20 20 20 72 63 20 3d ger) ){. rc =
35c20 20 73 71 6c 69 74 65 33 57 61 6c 46 69 6e 64 46 sqlite3WalFindF
35c30 72 61 6d 65 28 70 50 61 67 65 72 2d 3e 70 57 61 rame(pPager->pWa
35c40 6c 2c 20 70 67 6e 6f 2c 20 26 69 46 72 61 6d 65 l, pgno, &iFrame
35c50 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 );. if( rc!=S
35c60 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
35c70 20 20 2a 70 70 50 61 67 65 20 3d 20 30 3b 0a 20 *ppPage = 0;.
35c80 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a return rc;.
35c90 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 }. }. if(
35ca0 62 4d 6d 61 70 4f 6b 20 26 26 20 69 46 72 61 6d bMmapOk && iFram
35cb0 65 3d 3d 30 20 29 7b 0a 20 20 20 20 76 6f 69 64 e==0 ){. void
35cc0 20 2a 70 44 61 74 61 20 3d 20 30 3b 0a 20 20 20 *pData = 0;.
35cd0 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 46 rc = sqlite3OsF
35ce0 65 74 63 68 28 70 50 61 67 65 72 2d 3e 66 64 2c etch(pPager->fd,
35cf0 20 0a 20 20 20 20 20 20 20 20 28 69 36 34 29 28 . (i64)(
35d00 70 67 6e 6f 2d 31 29 20 2a 20 70 50 61 67 65 72 pgno-1) * pPager
35d10 2d 3e 70 61 67 65 53 69 7a 65 2c 20 70 50 61 67 ->pageSize, pPag
35d20 65 72 2d 3e 70 61 67 65 53 69 7a 65 2c 20 26 70 er->pageSize, &p
35d30 44 61 74 61 0a 20 20 20 20 29 3b 0a 20 20 20 20 Data. );.
35d40 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
35d50 4b 20 26 26 20 70 44 61 74 61 20 29 7b 0a 20 20 K && pData ){.
35d60 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
35d70 65 53 74 61 74 65 3e 50 41 47 45 52 5f 52 45 41 eState>PAGER_REA
35d80 44 45 52 20 7c 7c 20 70 50 61 67 65 72 2d 3e 74 DER || pPager->t
35d90 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 20 empFile ){.
35da0 20 20 20 70 50 67 20 3d 20 73 71 6c 69 74 65 33 pPg = sqlite3
35db0 50 61 67 65 72 4c 6f 6f 6b 75 70 28 70 50 61 67 PagerLookup(pPag
35dc0 65 72 2c 20 70 67 6e 6f 29 3b 0a 20 20 20 20 20 er, pgno);.
35dd0 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 50 67 }. if( pPg
35de0 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 72 ==0 ){. r
35df0 63 20 3d 20 70 61 67 65 72 41 63 71 75 69 72 65 c = pagerAcquire
35e00 4d 61 70 50 61 67 65 28 70 50 61 67 65 72 2c 20 MapPage(pPager,
35e10 70 67 6e 6f 2c 20 70 44 61 74 61 2c 20 26 70 50 pgno, pData, &pP
35e20 67 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b g);. }else{
35e30 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
35e40 4f 73 55 6e 66 65 74 63 68 28 70 50 61 67 65 72 OsUnfetch(pPager
35e50 2d 3e 66 64 2c 20 28 69 36 34 29 28 70 67 6e 6f ->fd, (i64)(pgno
35e60 2d 31 29 2a 70 50 61 67 65 72 2d 3e 70 61 67 65 -1)*pPager->page
35e70 53 69 7a 65 2c 20 70 44 61 74 61 29 3b 0a 20 20 Size, pData);.
35e80 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 }. if(
35e90 70 50 67 20 29 7b 0a 20 20 20 20 20 20 20 20 61 pPg ){. a
35ea0 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 ssert( rc==SQLIT
35eb0 45 5f 4f 4b 20 29 3b 0a 20 20 20 20 20 20 20 20 E_OK );.
35ec0 2a 70 70 50 61 67 65 20 3d 20 70 50 67 3b 0a 20 *ppPage = pPg;.
35ed0 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 return SQ
35ee0 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20 20 20 7d LITE_OK;. }
35ef0 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
35f00 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c!=SQLITE_OK ){.
35f10 20 20 20 20 20 20 2a 70 70 50 61 67 65 20 3d 20 *ppPage =
35f20 30 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 0;. return
35f30 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 rc;. }. }.
35f40 72 65 74 75 72 6e 20 67 65 74 50 61 67 65 4e 6f return getPageNo
35f50 72 6d 61 6c 28 70 50 61 67 65 72 2c 20 70 67 6e rmal(pPager, pgn
35f60 6f 2c 20 70 70 50 61 67 65 2c 20 66 6c 61 67 73 o, ppPage, flags
35f70 29 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 );.}.#endif /* S
35f80 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
35f90 49 5a 45 3e 30 20 2a 2f 0a 0a 2f 2a 20 54 68 65 IZE>0 */../* The
35fa0 20 70 61 67 65 20 67 65 74 74 65 72 20 6d 65 74 page getter met
35fb0 68 6f 64 20 66 6f 72 20 77 68 65 6e 20 74 68 65 hod for when the
35fc0 20 70 61 67 65 72 20 69 73 20 61 6e 20 65 72 72 pager is an err
35fd0 6f 72 20 73 74 61 74 65 20 2a 2f 0a 73 74 61 74 or state */.stat
35fe0 69 63 20 69 6e 74 20 67 65 74 50 61 67 65 45 72 ic int getPageEr
35ff0 72 6f 72 28 0a 20 20 50 61 67 65 72 20 2a 70 50 ror(. Pager *pP
36000 61 67 65 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 ager, /* Th
36010 65 20 70 61 67 65 72 20 6f 70 65 6e 20 6f 6e 20 e pager open on
36020 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
36030 65 20 2a 2f 0a 20 20 50 67 6e 6f 20 70 67 6e 6f e */. Pgno pgno
36040 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 , /* Pa
36050 67 65 20 6e 75 6d 62 65 72 20 74 6f 20 66 65 74 ge number to fet
36060 63 68 20 2a 2f 0a 20 20 44 62 50 61 67 65 20 2a ch */. DbPage *
36070 2a 70 70 50 61 67 65 2c 20 20 20 20 2f 2a 20 57 *ppPage, /* W
36080 72 69 74 65 20 61 20 70 6f 69 6e 74 65 72 20 74 rite a pointer t
36090 6f 20 74 68 65 20 70 61 67 65 20 68 65 72 65 20 o the page here
360a0 2a 2f 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 20 */. int flags
360b0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 41 47 45 /* PAGE
360c0 52 5f 47 45 54 5f 58 58 58 20 66 6c 61 67 73 20 R_GET_XXX flags
360d0 2a 2f 0a 29 7b 0a 20 20 55 4e 55 53 45 44 5f 50 */.){. UNUSED_P
360e0 41 52 41 4d 45 54 45 52 28 70 67 6e 6f 29 3b 0a ARAMETER(pgno);.
360f0 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 UNUSED_PARAMET
36100 45 52 28 66 6c 61 67 73 29 3b 0a 20 20 61 73 73 ER(flags);. ass
36110 65 72 74 28 20 70 50 61 67 65 72 2d 3e 65 72 72 ert( pPager->err
36120 43 6f 64 65 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 Code!=SQLITE_OK
36130 29 3b 0a 20 20 2a 70 70 50 61 67 65 20 3d 20 30 );. *ppPage = 0
36140 3b 0a 20 20 72 65 74 75 72 6e 20 70 50 61 67 65 ;. return pPage
36150 72 2d 3e 65 72 72 43 6f 64 65 3b 0a 7d 0a 0a 0a r->errCode;.}...
36160 2f 2a 20 44 69 73 70 61 74 63 68 20 61 6c 6c 20 /* Dispatch all
36170 70 61 67 65 20 66 65 74 63 68 20 72 65 71 75 65 page fetch reque
36180 73 74 73 20 74 6f 20 74 68 65 20 61 70 70 72 6f sts to the appro
36190 70 72 69 61 74 65 20 67 65 74 74 65 72 20 6d 65 priate getter me
361a0 74 68 6f 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c thod..*/.int sql
361b0 69 74 65 33 50 61 67 65 72 47 65 74 28 0a 20 20 ite3PagerGet(.
361c0 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c 20 20 Pager *pPager,
361d0 20 20 20 20 2f 2a 20 54 68 65 20 70 61 67 65 72 /* The pager
361e0 20 6f 70 65 6e 20 6f 6e 20 74 68 65 20 64 61 74 open on the dat
361f0 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
36200 50 67 6e 6f 20 70 67 6e 6f 2c 20 20 20 20 20 20 Pgno pgno,
36210 20 20 20 20 2f 2a 20 50 61 67 65 20 6e 75 6d 62 /* Page numb
36220 65 72 20 74 6f 20 66 65 74 63 68 20 2a 2f 0a 20 er to fetch */.
36230 20 44 62 50 61 67 65 20 2a 2a 70 70 50 61 67 65 DbPage **ppPage
36240 2c 20 20 20 20 2f 2a 20 57 72 69 74 65 20 61 20 , /* Write a
36250 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 pointer to the p
36260 61 67 65 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e age here */. in
36270 74 20 66 6c 61 67 73 20 20 20 20 20 20 20 20 20 t flags
36280 20 20 2f 2a 20 50 41 47 45 52 5f 47 45 54 5f 58 /* PAGER_GET_X
36290 58 58 20 66 6c 61 67 73 20 2a 2f 0a 29 7b 0a 20 XX flags */.){.
362a0 20 72 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e return pPager->
362b0 78 47 65 74 28 70 50 61 67 65 72 2c 20 70 67 6e xGet(pPager, pgn
362c0 6f 2c 20 70 70 50 61 67 65 2c 20 66 6c 61 67 73 o, ppPage, flags
362d0 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 63 71 75 );.}../*.** Acqu
362e0 69 72 65 20 61 20 70 61 67 65 20 69 66 20 69 74 ire a page if it
362f0 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e 20 74 is already in t
36300 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 63 61 63 he in-memory cac
36310 68 65 2e 20 20 44 6f 0a 2a 2a 20 6e 6f 74 20 72 he. Do.** not r
36320 65 61 64 20 74 68 65 20 70 61 67 65 20 66 72 6f ead the page fro
36330 6d 20 64 69 73 6b 2e 20 20 52 65 74 75 72 6e 20 m disk. Return
36340 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
36350 20 70 61 67 65 2c 0a 2a 2a 20 6f 72 20 30 20 69 page,.** or 0 i
36360 66 20 74 68 65 20 70 61 67 65 20 69 73 20 6e 6f f the page is no
36370 74 20 69 6e 20 63 61 63 68 65 2e 20 0a 2a 2a 0a t in cache. .**.
36380 2a 2a 20 53 65 65 20 61 6c 73 6f 20 73 71 6c 69 ** See also sqli
36390 74 65 33 50 61 67 65 72 47 65 74 28 29 2e 20 20 te3PagerGet().
363a0 54 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 The difference b
363b0 65 74 77 65 65 6e 20 74 68 69 73 20 72 6f 75 74 etween this rout
363c0 69 6e 65 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 ine.** and sqlit
363d0 65 33 50 61 67 65 72 47 65 74 28 29 20 69 73 20 e3PagerGet() is
363e0 74 68 61 74 20 5f 67 65 74 28 29 20 77 69 6c 6c that _get() will
363f0 20 67 6f 20 74 6f 20 74 68 65 20 64 69 73 6b 20 go to the disk
36400 61 6e 64 20 72 65 61 64 0a 2a 2a 20 69 6e 20 74 and read.** in t
36410 68 65 20 70 61 67 65 20 69 66 20 74 68 65 20 70 he page if the p
36420 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 age is not alrea
36430 64 79 20 69 6e 20 63 61 63 68 65 2e 20 20 54 68 dy in cache. Th
36440 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 72 65 is routine.** re
36450 74 75 72 6e 73 20 4e 55 4c 4c 20 69 66 20 74 68 turns NULL if th
36460 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 69 6e e page is not in
36470 20 63 61 63 68 65 20 6f 72 20 69 66 20 61 20 64 cache or if a d
36480 69 73 6b 20 49 2f 4f 20 65 72 72 6f 72 20 0a 2a isk I/O error .*
36490 2a 20 68 61 73 20 65 76 65 72 20 68 61 70 70 65 * has ever happe
364a0 6e 65 64 2e 0a 2a 2f 0a 44 62 50 61 67 65 20 2a ned..*/.DbPage *
364b0 73 71 6c 69 74 65 33 50 61 67 65 72 4c 6f 6f 6b sqlite3PagerLook
364c0 75 70 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 up(Pager *pPager
364d0 2c 20 50 67 6e 6f 20 70 67 6e 6f 29 7b 0a 20 20 , Pgno pgno){.
364e0 73 71 6c 69 74 65 33 5f 70 63 61 63 68 65 5f 70 sqlite3_pcache_p
364f0 61 67 65 20 2a 70 50 61 67 65 3b 0a 20 20 61 73 age *pPage;. as
36500 73 65 72 74 28 20 70 50 61 67 65 72 21 3d 30 20 sert( pPager!=0
36510 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 67 6e );. assert( pgn
36520 6f 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 o!=0 );. assert
36530 28 20 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 ( pPager->pPCach
36540 65 21 3d 30 20 29 3b 0a 20 20 70 50 61 67 65 20 e!=0 );. pPage
36550 3d 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 46 = sqlite3PcacheF
36560 65 74 63 68 28 70 50 61 67 65 72 2d 3e 70 50 43 etch(pPager->pPC
36570 61 63 68 65 2c 20 70 67 6e 6f 2c 20 30 29 3b 0a ache, pgno, 0);.
36580 20 20 61 73 73 65 72 74 28 20 70 50 61 67 65 3d assert( pPage=
36590 3d 30 20 7c 7c 20 70 50 61 67 65 72 2d 3e 68 61 =0 || pPager->ha
365a0 73 48 65 6c 64 53 68 61 72 65 64 4c 6f 63 6b 20 sHeldSharedLock
365b0 29 3b 0a 20 20 69 66 28 20 70 50 61 67 65 3d 3d );. if( pPage==
365c0 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
365d0 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 50 63 return sqlite3Pc
365e0 61 63 68 65 46 65 74 63 68 46 69 6e 69 73 68 28 acheFetchFinish(
365f0 70 50 61 67 65 72 2d 3e 70 50 43 61 63 68 65 2c pPager->pPCache,
36600 20 70 67 6e 6f 2c 20 70 50 61 67 65 29 3b 0a 7d pgno, pPage);.}
36610 0a 0a 2f 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 ../*.** Release
36620 61 20 70 61 67 65 20 72 65 66 65 72 65 6e 63 65 a page reference
36630 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 ..**.** The sqli
36640 74 65 33 50 61 67 65 72 55 6e 72 65 66 28 29 20 te3PagerUnref()
36650 61 6e 64 20 73 71 6c 69 74 65 33 50 61 67 65 72 and sqlite3Pager
36660 55 6e 72 65 66 4e 6f 74 4e 75 6c 6c 28 29 20 6d UnrefNotNull() m
36670 61 79 20 6f 6e 6c 79 20 62 65 0a 2a 2a 20 75 73 ay only be.** us
36680 65 64 20 69 66 20 77 65 20 6b 6e 6f 77 20 74 68 ed if we know th
36690 61 74 20 74 68 65 20 70 61 67 65 20 62 65 69 6e at the page bein
366a0 67 20 72 65 6c 65 61 73 65 64 20 69 73 20 6e 6f g released is no
366b0 74 20 74 68 65 20 6c 61 73 74 20 70 61 67 65 2e t the last page.
366c0 0a 2a 2a 20 54 68 65 20 62 74 72 65 65 20 6c 61 .** The btree la
366d0 79 65 72 20 61 6c 77 61 79 73 20 68 6f 6c 64 73 yer always holds
366e0 20 70 61 67 65 31 20 6f 70 65 6e 20 75 6e 74 69 page1 open unti
366f0 6c 20 74 68 65 20 65 6e 64 2c 20 73 6f 20 74 68 l the end, so th
36700 65 73 65 20 66 69 72 73 74 0a 2a 2a 20 74 6f 20 ese first.** to
36710 72 6f 75 74 69 6e 65 73 20 63 61 6e 20 62 65 20 routines can be
36720 75 73 65 64 20 74 6f 20 72 65 6c 65 61 73 65 20 used to release
36730 61 6e 79 20 70 61 67 65 20 6f 74 68 65 72 20 74 any page other t
36740 68 61 6e 20 42 74 53 68 61 72 65 64 2e 70 50 61 han BtShared.pPa
36750 67 65 31 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 73 ge1..**.** Use s
36760 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 66 qlite3PagerUnref
36770 50 61 67 65 4f 6e 65 28 29 20 74 6f 20 72 65 6c PageOne() to rel
36780 65 61 73 65 20 70 61 67 65 31 2e 20 20 54 68 69 ease page1. Thi
36790 73 20 6c 61 74 74 65 72 20 72 6f 75 74 69 6e 65 s latter routine
367a0 0a 2a 2a 20 63 68 65 63 6b 73 20 74 68 65 20 74 .** checks the t
367b0 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 6f otal number of o
367c0 75 74 73 74 61 6e 64 69 6e 67 20 70 61 67 65 73 utstanding pages
367d0 20 61 6e 64 20 69 66 20 74 68 65 20 6e 75 6d 62 and if the numb
367e0 65 72 20 6f 66 0a 2a 2a 20 70 61 67 65 73 20 72 er of.** pages r
367f0 65 61 63 68 65 73 20 7a 65 72 6f 20 69 74 20 64 eaches zero it d
36800 72 6f 70 73 20 74 68 65 20 64 61 74 61 62 61 73 rops the databas
36810 65 20 6c 6f 63 6b 2e 0a 2a 2f 0a 76 6f 69 64 20 e lock..*/.void
36820 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 65 sqlite3PagerUnre
36830 66 4e 6f 74 4e 75 6c 6c 28 44 62 50 61 67 65 20 fNotNull(DbPage
36840 2a 70 50 67 29 7b 0a 20 20 54 45 53 54 4f 4e 4c *pPg){. TESTONL
36850 59 28 20 50 61 67 65 72 20 2a 70 50 61 67 65 72 Y( Pager *pPager
36860 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 3b 20 = pPg->pPager;
36870 29 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 21 ). assert( pPg!
36880 3d 30 20 29 3b 0a 20 20 69 66 28 20 70 50 67 2d =0 );. if( pPg-
36890 3e 66 6c 61 67 73 20 26 20 50 47 48 44 52 5f 4d >flags & PGHDR_M
368a0 4d 41 50 20 29 7b 0a 20 20 20 20 61 73 73 65 72 MAP ){. asser
368b0 74 28 20 70 50 67 2d 3e 70 67 6e 6f 21 3d 31 20 t( pPg->pgno!=1
368c0 29 3b 20 20 2f 2a 20 50 61 67 65 31 20 69 73 20 ); /* Page1 is
368d0 6e 65 76 65 72 20 6d 65 6d 6f 72 79 20 6d 61 70 never memory map
368e0 70 65 64 20 2a 2f 0a 20 20 20 20 70 61 67 65 72 ped */. pager
368f0 52 65 6c 65 61 73 65 4d 61 70 50 61 67 65 28 70 ReleaseMapPage(p
36900 50 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 Pg);. }else{.
36910 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 sqlite3PcacheR
36920 65 6c 65 61 73 65 28 70 50 67 29 3b 0a 20 20 7d elease(pPg);. }
36930 0a 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 75 73 65 . /* Do not use
36940 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 74 6f this routine to
36950 20 72 65 6c 65 61 73 65 20 74 68 65 20 6c 61 73 release the las
36960 74 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 70 t reference to p
36970 61 67 65 31 20 2a 2f 0a 20 20 61 73 73 65 72 74 age1 */. assert
36980 28 20 73 71 6c 69 74 65 33 50 63 61 63 68 65 52 ( sqlite3PcacheR
36990 65 66 43 6f 75 6e 74 28 70 50 61 67 65 72 2d 3e efCount(pPager->
369a0 70 50 43 61 63 68 65 29 3e 30 20 29 3b 0a 7d 0a pPCache)>0 );.}.
369b0 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 67 65 void sqlite3Page
369c0 72 55 6e 72 65 66 28 44 62 50 61 67 65 20 2a 70 rUnref(DbPage *p
369d0 50 67 29 7b 0a 20 20 69 66 28 20 70 50 67 20 29 Pg){. if( pPg )
369e0 20 73 71 6c 69 74 65 33 50 61 67 65 72 55 6e 72 sqlite3PagerUnr
369f0 65 66 4e 6f 74 4e 75 6c 6c 28 70 50 67 29 3b 0a efNotNull(pPg);.
36a00 7d 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 }.void sqlite3Pa
36a10 67 65 72 55 6e 72 65 66 50 61 67 65 4f 6e 65 28 gerUnrefPageOne(
36a20 44 62 50 61 67 65 20 2a 70 50 67 29 7b 0a 20 20 DbPage *pPg){.
36a30 50 61 67 65 72 20 2a 70 50 61 67 65 72 3b 0a 20 Pager *pPager;.
36a40 20 61 73 73 65 72 74 28 20 70 50 67 21 3d 30 20 assert( pPg!=0
36a50 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 67 );. assert( pPg
36a60 2d 3e 70 67 6e 6f 3d 3d 31 20 29 3b 0a 20 20 61 ->pgno==1 );. a
36a70 73 73 65 72 74 28 20 28 70 50 67 2d 3e 66 6c 61 ssert( (pPg->fla
36a80 67 73 20 26 20 50 47 48 44 52 5f 4d 4d 41 50 29 gs & PGHDR_MMAP)
36a90 3d 3d 30 20 29 3b 20 2f 2a 20 50 61 67 65 31 20 ==0 ); /* Page1
36aa0 69 73 20 6e 65 76 65 72 20 6d 65 6d 6f 72 79 20 is never memory
36ab0 6d 61 70 70 65 64 20 2a 2f 0a 20 20 70 50 61 67 mapped */. pPag
36ac0 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 65 72 er = pPg->pPager
36ad0 3b 0a 20 20 73 71 6c 69 74 65 33 50 63 61 63 68 ;. sqlite3Pcach
36ae0 65 52 65 6c 65 61 73 65 28 70 50 67 29 3b 0a 20 eRelease(pPg);.
36af0 20 70 61 67 65 72 55 6e 6c 6f 63 6b 49 66 55 6e pagerUnlockIfUn
36b00 75 73 65 64 28 70 50 61 67 65 72 29 3b 0a 7d 0a used(pPager);.}.
36b10 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 ./*.** This func
36b20 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 61 tion is called a
36b30 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 65 t the start of e
36b40 76 65 72 79 20 77 72 69 74 65 20 74 72 61 6e 73 very write trans
36b50 61 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 65 72 65 action..** There
36b60 20 6d 75 73 74 20 61 6c 72 65 61 64 79 20 62 65 must already be
36b70 20 61 20 52 45 53 45 52 56 45 44 20 6f 72 20 45 a RESERVED or E
36b80 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b 20 6f 6e XCLUSIVE lock on
36b90 20 74 68 65 20 64 61 74 61 62 61 73 65 20 0a 2a the database .*
36ba0 2a 20 66 69 6c 65 20 77 68 65 6e 20 74 68 69 73 * file when this
36bb0 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c routine is call
36bc0 65 64 2e 0a 2a 2a 0a 2a 2a 20 4f 70 65 6e 20 74 ed..**.** Open t
36bd0 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 he journal file
36be0 66 6f 72 20 70 61 67 65 72 20 70 50 61 67 65 72 for pager pPager
36bf0 20 61 6e 64 20 77 72 69 74 65 20 61 20 6a 6f 75 and write a jou
36c00 72 6e 61 6c 20 68 65 61 64 65 72 0a 2a 2a 20 74 rnal header.** t
36c10 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 69 o the start of i
36c20 74 2e 20 49 66 20 74 68 65 72 65 20 61 72 65 20 t. If there are
36c30 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e 74 active savepoint
36c40 73 2c 20 6f 70 65 6e 20 74 68 65 20 73 75 62 2d s, open the sub-
36c50 6a 6f 75 72 6e 61 6c 0a 2a 2a 20 61 73 20 77 65 journal.** as we
36c60 6c 6c 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f ll. This functio
36c70 6e 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 77 n is only used w
36c80 68 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 hen the journal
36c90 66 69 6c 65 20 69 73 20 62 65 69 6e 67 20 0a 2a file is being .*
36ca0 2a 20 6f 70 65 6e 65 64 20 74 6f 20 77 72 69 74 * opened to writ
36cb0 65 20 61 20 72 6f 6c 6c 62 61 63 6b 20 6c 6f 67 e a rollback log
36cc0 20 66 6f 72 20 61 20 74 72 61 6e 73 61 63 74 69 for a transacti
36cd0 6f 6e 2e 20 49 74 20 69 73 20 6e 6f 74 20 75 73 on. It is not us
36ce0 65 64 20 0a 2a 2a 20 77 68 65 6e 20 6f 70 65 6e ed .** when open
36cf0 69 6e 67 20 61 20 68 6f 74 20 6a 6f 75 72 6e 61 ing a hot journa
36d00 6c 20 66 69 6c 65 20 74 6f 20 72 6f 6c 6c 20 69 l file to roll i
36d10 74 20 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 49 66 t back..**.** If
36d20 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c the journal fil
36d30 65 20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 e is already ope
36d40 6e 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 n (as it may be
36d50 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
36d60 65 29 2c 0a 2a 2a 20 74 68 65 6e 20 74 68 69 73 e),.** then this
36d70 20 66 75 6e 63 74 69 6f 6e 20 6a 75 73 74 20 77 function just w
36d80 72 69 74 65 73 20 61 20 6a 6f 75 72 6e 61 6c 20 rites a journal
36d90 68 65 61 64 65 72 20 74 6f 20 74 68 65 20 73 74 header to the st
36da0 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 6c art of the.** al
36db0 72 65 61 64 79 20 6f 70 65 6e 20 66 69 6c 65 2e ready open file.
36dc0 20 0a 2a 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 .**.** Whether
36dd0 6f 72 20 6e 6f 74 20 74 68 65 20 6a 6f 75 72 6e or not the journ
36de0 61 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 al file is opene
36df0 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 d by this functi
36e00 6f 6e 2c 20 74 68 65 0a 2a 2a 20 50 61 67 65 72 on, the.** Pager
36e10 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 62 69 74 76 .pInJournal bitv
36e20 65 63 20 73 74 72 75 63 74 75 72 65 20 69 73 20 ec structure is
36e30 61 6c 6c 6f 63 61 74 65 64 2e 0a 2a 2a 0a 2a 2a allocated..**.**
36e40 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f Return SQLITE_O
36e50 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67 20 K if everything
36e60 69 73 20 73 75 63 63 65 73 73 66 75 6c 2e 20 4f is successful. O
36e70 74 68 65 72 77 69 73 65 2c 20 72 65 74 75 72 6e therwise, return
36e80 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 .** SQLITE_NOME
36e90 4d 20 69 66 20 74 68 65 20 61 74 74 65 6d 70 74 M if the attempt
36ea0 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 50 61 67 to allocate Pag
36eb0 65 72 2e 70 49 6e 4a 6f 75 72 6e 61 6c 20 66 61 er.pInJournal fa
36ec0 69 6c 73 2c 20 6f 72 20 0a 2a 2a 20 61 6e 20 49 ils, or .** an I
36ed0 4f 20 65 72 72 6f 72 20 63 6f 64 65 20 69 66 20 O error code if
36ee0 6f 70 65 6e 69 6e 67 20 6f 72 20 77 72 69 74 69 opening or writi
36ef0 6e 67 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 ng the journal f
36f00 69 6c 65 20 66 61 69 6c 73 2e 0a 2a 2f 0a 73 74 ile fails..*/.st
36f10 61 74 69 63 20 69 6e 74 20 70 61 67 65 72 5f 6f atic int pager_o
36f20 70 65 6e 5f 6a 6f 75 72 6e 61 6c 28 50 61 67 65 pen_journal(Page
36f30 72 20 2a 70 50 61 67 65 72 29 7b 0a 20 20 69 6e r *pPager){. in
36f40 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
36f50 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
36f60 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
36f70 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 73 71 6c rn code */. sql
36f80 69 74 65 33 5f 76 66 73 20 2a 20 63 6f 6e 73 74 ite3_vfs * const
36f90 20 70 56 66 73 20 3d 20 70 50 61 67 65 72 2d 3e pVfs = pPager->
36fa0 70 56 66 73 3b 20 20 20 2f 2a 20 4c 6f 63 61 6c pVfs; /* Local
36fb0 20 63 61 63 68 65 20 6f 66 20 76 66 73 20 70 6f cache of vfs po
36fc0 69 6e 74 65 72 20 2a 2f 0a 0a 20 20 61 73 73 65 inter */.. asse
36fd0 72 74 28 20 70 50 61 67 65 72 2d 3e 65 53 74 61 rt( pPager->eSta
36fe0 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 45 52 te==PAGER_WRITER
36ff0 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 61 73 73 _LOCKED );. ass
37000 65 72 74 28 20 61 73 73 65 72 74 5f 70 61 67 65 ert( assert_page
37010 72 5f 73 74 61 74 65 28 70 50 61 67 65 72 29 20 r_state(pPager)
37020 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 50 61 );. assert( pPa
37030 67 65 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 3d ger->pInJournal=
37040 3d 30 20 29 3b 0a 20 20 0a 20 20 2f 2a 20 49 66 =0 );. . /* If
37050 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
37060 65 72 72 6f 72 20 73 74 61 74 65 2c 20 74 68 69 error state, thi
37070 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 s function is a
37080 6e 6f 2d 6f 70 2e 20 20 42 75 74 20 6f 6e 0a 20 no-op. But on.
37090 20 2a 2a 20 74 68 65 20 6f 74 68 65 72 20 68 61 ** the other ha
370a0 6e 64 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 nd, this routine
370b0 20 69 73 20 6e 65 76 65 72 20 63 61 6c 6c 65 64 is never called
370c0 20 69 66 20 77 65 20 61 72 65 20 61 6c 72 65 61 if we are alrea
370d0 64 79 20 69 6e 0a 20 20 2a 2a 20 61 6e 20 65 72 dy in. ** an er
370e0 72 6f 72 20 73 74 61 74 65 2e 20 2a 2f 0a 20 20 ror state. */.
370f0 69 66 28 20 4e 45 56 45 52 28 70 50 61 67 65 72 if( NEVER(pPager
37100 2d 3e 65 72 72 43 6f 64 65 29 20 29 20 72 65 74 ->errCode) ) ret
37110 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 72 43 urn pPager->errC
37120 6f 64 65 3b 0a 0a 20 20 69 66 28 20 21 70 61 67 ode;.. if( !pag
37130 65 72 55 73 65 57 61 6c 28 70 50 61 67 65 72 29 erUseWal(pPager)
37140 20 26 26 20 70 50 61 67 65 72 2d 3e 6a 6f 75 72 && pPager->jour
37150 6e 61 6c 4d 6f 64 65 21 3d 50 41 47 45 52 5f 4a nalMode!=PAGER_J
37160 4f 55 52 4e 41 4c 4d 4f 44 45 5f 4f 46 46 20 29 OURNALMODE_OFF )
37170 7b 0a 20 20 20 20 70 50 61 67 65 72 2d 3e 70 49 {. pPager->pI
37180 6e 4a 6f 75 72 6e 61 6c 20 3d 20 73 71 6c 69 74 nJournal = sqlit
37190 65 33 42 69 74 76 65 63 43 72 65 61 74 65 28 70 e3BitvecCreate(p
371a0 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 29 3b 0a Pager->dbSize);.
371b0 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
371c0 70 49 6e 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 7b pInJournal==0 ){
371d0 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 . return SQ
371e0 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
371f0 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a . }. . /*
37200 20 4f 70 65 6e 20 74 68 65 20 6a 6f 75 72 6e 61 Open the journa
37210 6c 20 66 69 6c 65 20 69 66 20 69 74 20 69 73 20 l file if it is
37220 6e 6f 74 20 61 6c 72 65 61 64 79 20 6f 70 65 6e not already open
37230 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 69 73 . */. if( !is
37240 4f 70 65 6e 28 70 50 61 67 65 72 2d 3e 6a 66 64 Open(pPager->jfd
37250 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 ) ){. if( p
37260 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4d 6f Pager->journalMo
37270 64 65 3d 3d 50 41 47 45 52 5f 4a 4f 55 52 4e 41 de==PAGER_JOURNA
37280 4c 4d 4f 44 45 5f 4d 45 4d 4f 52 59 20 29 7b 0a LMODE_MEMORY ){.
37290 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d sqlite3M
372a0 65 6d 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 70 50 emJournalOpen(pP
372b0 61 67 65 72 2d 3e 6a 66 64 29 3b 0a 20 20 20 20 ager->jfd);.
372c0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
372d0 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 53 51 4c int flags = SQL
372e0 49 54 45 5f 4f 50 45 4e 5f 52 45 41 44 57 52 49 ITE_OPEN_READWRI
372f0 54 45 7c 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 43 TE|SQLITE_OPEN_C
37300 52 45 41 54 45 3b 0a 20 20 20 20 20 20 20 20 69 REATE;. i
37310 6e 74 20 6e 53 70 69 6c 6c 3b 0a 0a 20 20 20 20 nt nSpill;..
37320 20 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e if( pPager->
37330 74 65 6d 70 46 69 6c 65 20 29 7b 0a 20 20 20 20 tempFile ){.
37340 20 20 20 20 20 20 66 6c 61 67 73 20 7c 3d 20 28 flags |= (
37350 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 44 45 4c 45 SQLITE_OPEN_DELE
37360 54 45 4f 4e 43 4c 4f 53 45 7c 53 51 4c 49 54 45 TEONCLOSE|SQLITE
37370 5f 4f 50 45 4e 5f 54 45 4d 50 5f 4a 4f 55 52 4e _OPEN_TEMP_JOURN
37380 41 4c 29 3b 0a 20 20 20 20 20 20 20 20 20 20 6e AL);. n
37390 53 70 69 6c 6c 20 3d 20 73 71 6c 69 74 65 33 43 Spill = sqlite3C
373a0 6f 6e 66 69 67 2e 6e 53 74 6d 74 53 70 69 6c 6c onfig.nStmtSpill
373b0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
373c0 0a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 73 . flags
373d0 20 7c 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f |= SQLITE_OPEN_
373e0 4d 41 49 4e 5f 4a 4f 55 52 4e 41 4c 3b 0a 20 20 MAIN_JOURNAL;.
373f0 20 20 20 20 20 20 20 20 6e 53 70 69 6c 6c 20 3d nSpill =
37400 20 6a 72 6e 6c 42 75 66 66 65 72 53 69 7a 65 28 jrnlBufferSize(
37410 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 pPager);.
37420 20 7d 0a 20 20 20 20 20 20 20 20 20 20 0a 20 20 }. .
37430 20 20 20 20 20 20 2f 2a 20 56 65 72 69 66 79 20 /* Verify
37440 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 that the databas
37450 65 20 73 74 69 6c 6c 20 68 61 73 20 74 68 65 20 e still has the
37460 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 69 74 20 same name as it
37470 64 69 64 20 77 68 65 6e 0a 20 20 20 20 20 20 20 did when.
37480 20 2a 2a 20 69 74 20 77 61 73 20 6f 72 69 67 69 ** it was origi
37490 6e 61 6c 6c 79 20 6f 70 65 6e 65 64 2e 20 2a 2f nally opened. */
374a0 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 64 61 . rc = da
374b0 74 61 62 61 73 65 49 73 55 6e 6d 6f 76 65 64 28 tabaseIsUnmoved(
374c0 70 50 61 67 65 72 29 3b 0a 20 20 20 20 20 20 20 pPager);.
374d0 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
374e0 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 OK ){.
374f0 72 63 20 3d 20 73 71 6c 69 74 65 33 4a 6f 75 72 rc = sqlite3Jour
37500 6e 61 6c 4f 70 65 6e 20 28 0a 20 20 20 20 20 20 nalOpen (.
37510 20 20 20 20 20 20 20 20 70 56 66 73 2c 20 70 50 pVfs, pP
37520 61 67 65 72 2d 3e 7a 4a 6f 75 72 6e 61 6c 2c 20 ager->zJournal,
37530 70 50 61 67 65 72 2d 3e 6a 66 64 2c 20 66 6c 61 pPager->jfd, fla
37540 67 73 2c 20 6e 53 70 69 6c 6c 0a 20 20 20 20 20 gs, nSpill.
37550 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 );.
37560 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }. }.
37570 61 73 73 65 72 74 28 20 72 63 21 3d 53 51 4c 49 assert( rc!=SQLI
37580 54 45 5f 4f 4b 20 7c 7c 20 69 73 4f 70 65 6e 28 TE_OK || isOpen(
37590 70 50 61 67 65 72 2d 3e 6a 66 64 29 20 29 3b 0a pPager->jfd) );.
375a0 20 20 20 20 7d 0a 20 20 0a 20 20 0a 20 20 20 20 }. . .
375b0 2f 2a 20 57 72 69 74 65 20 74 68 65 20 66 69 72 /* Write the fir
375c0 73 74 20 6a 6f 75 72 6e 61 6c 20 68 65 61 64 65 st journal heade
375d0 72 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c r to the journal
375e0 20 66 69 6c 65 20 61 6e 64 20 6f 70 65 6e 20 0a file and open .
375f0 20 20 20 20 2a 2a 20 74 68 65 20 73 75 62 2d 6a ** the sub-j
37600 6f 75 72 6e 61 6c 20 69 66 20 6e 65 63 65 73 73 ournal if necess
37610 61 72 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 ary.. */.
37620 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f if( rc==SQLITE_O
37630 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 4f K ){. /* TO
37640 44 4f 3a 20 43 68 65 63 6b 20 69 66 20 61 6c 6c DO: Check if all
37650 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 72 65 of these are re
37660 61 6c 6c 79 20 72 65 71 75 69 72 65 64 2e 20 2a ally required. *
37670 2f 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e /. pPager->
37680 6e 52 65 63 20 3d 20 30 3b 0a 20 20 20 20 20 20 nRec = 0;.
37690 70 50 61 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f pPager->journalO
376a0 66 66 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 ff = 0;. pP
376b0 61 67 65 72 2d 3e 73 65 74 4d 61 73 74 65 72 20 ager->setMaster
376c0 3d 20 30 3b 0a 20 20 20 20 20 20 70 50 61 67 65 = 0;. pPage
376d0 72 2d 3e 6a 6f 75 72 6e 61 6c 48 64 72 20 3d 20 r->journalHdr =
376e0 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 77 72 0;. rc = wr
376f0 69 74 65 4a 6f 75 72 6e 61 6c 48 64 72 28 70 50 iteJournalHdr(pP
37700 61 67 65 72 29 3b 0a 20 20 20 20 7d 0a 20 20 7d ager);. }. }
37710 0a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 .. if( rc!=SQLI
37720 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 71 6c TE_OK ){. sql
37730 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f ite3BitvecDestro
37740 79 28 70 50 61 67 65 72 2d 3e 70 49 6e 4a 6f 75 y(pPager->pInJou
37750 72 6e 61 6c 29 3b 0a 20 20 20 20 70 50 61 67 65 rnal);. pPage
37760 72 2d 3e 70 49 6e 4a 6f 75 72 6e 61 6c 20 3d 20 r->pInJournal =
37770 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 0;. }else{.
37780 61 73 73 65 72 74 28 20 70 50 61 67 65 72 2d 3e assert( pPager->
37790 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 eState==PAGER_WR
377a0 49 54 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 ITER_LOCKED );.
377b0 20 20 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 pPager->eStat
377c0 65 20 3d 20 50 41 47 45 52 5f 57 52 49 54 45 52 e = PAGER_WRITER
377d0 5f 43 41 43 48 45 4d 4f 44 3b 0a 20 20 7d 0a 0a _CACHEMOD;. }..
377e0 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a return rc;.}..
377f0 2f 2a 0a 2a 2a 20 42 65 67 69 6e 20 61 20 77 72 /*.** Begin a wr
37800 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 ite-transaction
37810 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 on the specified
37820 20 70 61 67 65 72 20 6f 62 6a 65 63 74 2e 20 49 pager object. I
37830 66 20 61 20 0a 2a 2a 20 77 72 69 74 65 2d 74 72 f a .** write-tr
37840 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20 61 6c ansaction has al
37850 72 65 61 64 79 20 62 65 65 6e 20 6f 70 65 6e 65 ready been opene
37860 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e d, this function
37870 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2a 0a is a no-op..**.
37880 2a 2a 20 49 66 20 74 68 65 20 65 78 46 6c 61 67 ** If the exFlag
37890 20 61 72 67 75 6d 65 6e 74 20 69 73 20 66 61 6c argument is fal
378a0 73 65 2c 20 74 68 65 6e 20 61 63 71 75 69 72 65 se, then acquire
378b0 20 61 74 20 6c 65 61 73 74 20 61 20 52 45 53 45 at least a RESE
378c0 52 56 45 44 0a 2a 2a 20 6c 6f 63 6b 20 6f 6e 20 RVED.** lock on
378d0 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c the database fil
378e0 65 2e 20 49 66 20 65 78 46 6c 61 67 20 69 73 20 e. If exFlag is
378f0 74 72 75 65 2c 20 74 68 65 6e 20 61 63 71 75 69 true, then acqui
37900 72 65 20 61 74 20 6c 65 61 73 74 0a 2a 2a 20 61 re at least.** a
37910 6e 20 45 58 43 4c 55 53 49 56 45 20 6c 6f 63 6b n EXCLUSIVE lock
37920 2e 20 49 66 20 73 75 63 68 20 61 20 6c 6f 63 6b . If such a lock
37930 20 69 73 20 61 6c 72 65 61 64 79 20 68 65 6c 64 is already held
37940 2c 20 6e 6f 20 6c 6f 63 6b 69 6e 67 20 0a 2a 2a , no locking .**
37950 20 66 75 6e 63 74 69 6f 6e 73 20 6e 65 65 64 20 functions need
37960 62 65 20 63 61 6c 6c 65 64 2e 0a 2a 2a 0a 2a 2a be called..**.**
37970 20 49 66 20 74 68 65 20 73 75 62 6a 49 6e 4d 65 If the subjInMe
37980 6d 6f 72 79 20 61 72 67 75 6d 65 6e 74 20 69 73 mory argument is
37990 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 68 65 6e 20 non-zero, then
379a0 61 6e 79 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 any sub-journal
379b0 6f 70 65 6e 65 64 0a 2a 2a 20 77 69 74 68 69 6e opened.** within
379c0 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f this transactio
379d0 6e 20 77 69 6c 6c 20 62 65 20 6f 70 65 6e 65 64 n will be opened
379e0 20 61 73 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 79 as an in-memory
379f0 20 66 69 6c 65 2e 20 54 68 69 73 0a 2a 2a 20 68 file. This.** h
37a00 61 73 20 6e 6f 20 65 66 66 65 63 74 20 69 66 20 as no effect if
37a10 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 the sub-journal
37a20 69 73 20 61 6c 72 65 61 64 79 20 6f 70 65 6e 65 is already opene
37a30 64 20 28 61 73 20 69 74 20 6d 61 79 20 62 65 20 d (as it may be
37a40 77 68 65 6e 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 when.** running
37a50 69 6e 20 65 78 63 6c 75 73 69 76 65 20 6d 6f 64 in exclusive mod
37a60 65 29 20 6f 72 20 69 66 20 74 68 65 20 74 72 61 e) or if the tra
37a70 6e 73 61 63 74 69 6f 6e 20 64 6f 65 73 20 6e 6f nsaction does no
37a80 74 20 72 65 71 75 69 72 65 20 61 0a 2a 2a 20 73 t require a.** s
37a90 75 62 2d 6a 6f 75 72 6e 61 6c 2e 20 49 66 20 74 ub-journal. If t
37aa0 68 65 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 20 he subjInMemory
37ab0 61 72 67 75 6d 65 6e 74 20 69 73 20 7a 65 72 6f argument is zero
37ac0 2c 20 74 68 65 6e 20 61 6e 79 20 72 65 71 75 69 , then any requi
37ad0 72 65 64 0a 2a 2a 20 73 75 62 2d 6a 6f 75 72 6e red.** sub-journ
37ae0 61 6c 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 al is implemente
37af0 64 20 69 6e 2d 6d 65 6d 6f 72 79 20 69 66 20 70 d in-memory if p
37b00 50 61 67 65 72 20 69 73 20 61 6e 20 69 6e 2d 6d Pager is an in-m
37b10 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 2c 20 emory database,
37b20 0a 2a 2a 20 6f 72 20 75 73 69 6e 67 20 61 20 74 .** or using a t
37b30 65 6d 70 6f 72 61 72 79 20 66 69 6c 65 20 6f 74 emporary file ot
37b40 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 herwise..*/.int
37b50 73 71 6c 69 74 65 33 50 61 67 65 72 42 65 67 69 sqlite3PagerBegi
37b60 6e 28 50 61 67 65 72 20 2a 70 50 61 67 65 72 2c n(Pager *pPager,
37b70 20 69 6e 74 20 65 78 46 6c 61 67 2c 20 69 6e 74 int exFlag, int
37b80 20 73 75 62 6a 49 6e 4d 65 6d 6f 72 79 29 7b 0a subjInMemory){.
37b90 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
37ba0 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 50 61 E_OK;.. if( pPa
37bb0 67 65 72 2d 3e 65 72 72 43 6f 64 65 20 29 20 72 ger->errCode ) r
37bc0 65 74 75 72 6e 20 70 50 61 67 65 72 2d 3e 65 72 eturn pPager->er
37bd0 72 43 6f 64 65 3b 0a 20 20 61 73 73 65 72 74 28 rCode;. assert(
37be0 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3e pPager->eState>
37bf0 3d 50 41 47 45 52 5f 52 45 41 44 45 52 20 26 26 =PAGER_READER &&
37c00 20 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 3c pPager->eState<
37c10 50 41 47 45 52 5f 45 52 52 4f 52 20 29 3b 0a 20 PAGER_ERROR );.
37c20 20 70 50 61 67 65 72 2d 3e 73 75 62 6a 49 6e 4d pPager->subjInM
37c30 65 6d 6f 72 79 20 3d 20 28 75 38 29 73 75 62 6a emory = (u8)subj
37c40 49 6e 4d 65 6d 6f 72 79 3b 0a 0a 20 20 69 66 28 InMemory;.. if(
37c50 20 41 4c 57 41 59 53 28 70 50 61 67 65 72 2d 3e ALWAYS(pPager->
37c60 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 45 eState==PAGER_RE
37c70 41 44 45 52 29 20 29 7b 0a 20 20 20 20 61 73 73 ADER) ){. ass
37c80 65 72 74 28 20 70 50 61 67 65 72 2d 3e 70 49 6e ert( pPager->pIn
37c90 4a 6f 75 72 6e 61 6c 3d 3d 30 20 29 3b 0a 0a 20 Journal==0 );..
37ca0 20 20 20 69 66 28 20 70 61 67 65 72 55 73 65 57 if( pagerUseW
37cb0 61 6c 28 70 50 61 67 65 72 29 20 29 7b 0a 20 20 al(pPager) ){.
37cc0 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 /* If the pa
37cd0 67 65 72 20 69 73 20 63 6f 6e 66 69 67 75 72 65 ger is configure
37ce0 64 20 74 6f 20 75 73 65 20 6c 6f 63 6b 69 6e 67 d to use locking
37cf0 5f 6d 6f 64 65 3d 65 78 63 6c 75 73 69 76 65 2c _mode=exclusive,
37d00 20 61 6e 64 20 61 6e 0a 20 20 20 20 20 20 2a 2a and an. **
37d10 20 65 78 63 6c 75 73 69 76 65 20 6c 6f 63 6b 20 exclusive lock
37d20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 on the database
37d30 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 68 is not already h
37d40 65 6c 64 2c 20 6f 62 74 61 69 6e 20 69 74 20 6e eld, obtain it n
37d50 6f 77 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 ow.. */.
37d60 20 20 20 69 66 28 20 70 50 61 67 65 72 2d 3e 65 if( pPager->e
37d70 78 63 6c 75 73 69 76 65 4d 6f 64 65 20 26 26 20 xclusiveMode &&
37d80 73 71 6c 69 74 65 33 57 61 6c 45 78 63 6c 75 73 sqlite3WalExclus
37d90 69 76 65 4d 6f 64 65 28 70 50 61 67 65 72 2d 3e iveMode(pPager->
37da0 70 57 61 6c 2c 20 2d 31 29 20 29 7b 0a 20 20 20 pWal, -1) ){.
37db0 20 20 20 20 20 72 63 20 3d 20 70 61 67 65 72 4c rc = pagerL
37dc0 6f 63 6b 44 62 28 70 50 61 67 65 72 2c 20 45 58 ockDb(pPager, EX
37dd0 43 4c 55 53 49 56 45 5f 4c 4f 43 4b 29 3b 0a 20 CLUSIVE_LOCK);.
37de0 20 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 if( rc!=S
37df0 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
37e00 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b return rc;
37e10 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
37e20 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 (void)sqlite3
37e30 57 61 6c 45 78 63 6c 75 73 69 76 65 4d 6f 64 65 WalExclusiveMode
37e40 28 70 50 61 67 65 72 2d 3e 70 57 61 6c 2c 20 31 (pPager->pWal, 1
37e50 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 );. }..
37e60 20 20 2f 2a 20 47 72 61 62 20 74 68 65 20 77 72 /* Grab the wr
37e70 69 74 65 20 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 ite lock on the
37e80 6c 6f 67 20 66 69 6c 65 2e 20 49 66 20 73 75 63 log file. If suc
37e90 63 65 73 73 66 75 6c 2c 20 75 70 67 72 61 64 65 cessful, upgrade
37ea0 20 74 6f 0a 20 20 20 20 20 20 2a 2a 20 50 41 47 to. ** PAG
37eb0 45 52 5f 52 45 53 45 52 56 45 44 20 73 74 61 74 ER_RESERVED stat
37ec0 65 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 72 65 e. Otherwise, re
37ed0 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f turn an error co
37ee0 64 65 20 74 6f 20 74 68 65 20 63 61 6c 6c 65 72 de to the caller
37ef0 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 62 .. ** The b
37f00 75 73 79 2d 68 61 6e 64 6c 65 72 20 69 73 20 6e usy-handler is n
37f10 6f 74 20 69 6e 76 6f 6b 65 64 20 69 66 20 61 6e ot invoked if an
37f20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e other connection
37f30 20 61 6c 72 65 61 64 79 0a 20 20 20 20 20 20 2a already. *
37f40 2a 20 68 6f 6c 64 73 20 74 68 65 20 77 72 69 74 * holds the writ
37f50 65 2d 6c 6f 63 6b 2e 20 49 66 20 70 6f 73 73 69 e-lock. If possi
37f60 62 6c 65 2c 20 74 68 65 20 75 70 70 65 72 20 6c ble, the upper l
37f70 61 79 65 72 20 77 69 6c 6c 20 63 61 6c 6c 20 69 ayer will call i
37f80 74 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 t.. */.
37f90 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 57 61 rc = sqlite3Wa
37fa0 6c 42 65 67 69 6e 57 72 69 74 65 54 72 61 6e 73 lBeginWriteTrans
37fb0 61 63 74 69 6f 6e 28 70 50 61 67 65 72 2d 3e 70 action(pPager->p
37fc0 57 61 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b Wal);. }else{
37fd0 0a 20 20 20 20 20 20 2f 2a 20 4f 62 74 61 69 6e . /* Obtain
37fe0 20 61 20 52 45 53 45 52 56 45 44 20 6c 6f 63 6b a RESERVED lock
37ff0 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 on the database
38000 20 66 69 6c 65 2e 20 49 66 20 74 68 65 20 65 78 file. If the ex
38010 46 6c 61 67 20 70 61 72 61 6d 65 74 65 72 0a 20 Flag parameter.
38020 20 20 20 20 20 2a 2a 20 69 73 20 74 72 75 65 2c ** is true,
38030 20 74 68 65 6e 20 69 6d 6d 65 64 69 61 74 65 6c then immediatel
38040 79 20 75 70 67 72 61 64 65 20 74 68 69 73 20 74 y upgrade this t
38050 6f 20 61 6e 20 45 58 43 4c 55 53 49 56 45 20 6c o an EXCLUSIVE l
38060 6f 63 6b 2e 20 54 68 65 0a 20 20 20 20 20 20 2a ock. The. *
38070 2a 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 20 63 * busy-handler c
38080 61 6c 6c 62 61 63 6b 20 63 61 6e 20 62 65 20 75 allback can be u
38090 73 65 64 20 77 68 65 6e 20 75 70 67 72 61 64 69 sed when upgradi
380a0 6e 67 20 74 6f 20 74 68 65 20 45 58 43 4c 55 53 ng to the EXCLUS
380b0 49 56 45 0a 20 20 20 20 20 20 2a 2a 20 6c 6f 63 IVE. ** loc
380c0 6b 2c 20 62 75 74 20 6e 6f 74 20 77 68 65 6e 20 k, but not when
380d0 6f 62 74 61 69 6e 69 6e 67 20 74 68 65 20 52 45 obtaining the RE
380e0 53 45 52 56 45 44 20 6c 6f 63 6b 2e 0a 20 20 20 SERVED lock..
380f0 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 63 20 3d */. rc =
38100 20 70 61 67 65 72 4c 6f 63 6b 44 62 28 70 50 61 pagerLockDb(pPa
38110 67 65 72 2c 20 52 45 53 45 52 56 45 44 5f 4c 4f ger, RESERVED_LO
38120 43 4b 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 CK);. if( r
38130 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
38140 65 78 46 6c 61 67 20 29 7b 0a 20 20 20 20 20 20 exFlag ){.
38150 20 20 72 63 20 3d 20 70 61 67 65 72 5f 77 61 69 rc = pager_wai
38160 74 5f 6f 6e 5f 6c 6f 63 6b 28 70 50 61 67 65 72 t_on_lock(pPager
38170 2c 20 45 58 43 4c 55 53 49 56 45 5f 4c 4f 43 4b , EXCLUSIVE_LOCK
38180 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d );. }. }
38190 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 .. if( rc==SQ
381a0 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 LITE_OK ){.
381b0 20 2f 2a 20 43 68 61 6e 67 65 20 74 6f 20 57 52 /* Change to WR
381c0 49 54 45 52 5f 4c 4f 43 4b 45 44 20 73 74 61 74 ITER_LOCKED stat
381d0 65 2e 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 e.. **.
381e0 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 20 73 65 ** WAL mode se
381f0 74 73 20 50 61 67 65 72 2e 65 53 74 61 74 65 20 ts Pager.eState
38200 74 6f 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f to PAGER_WRITER_
38210 4c 4f 43 4b 45 44 20 6f 72 20 43 41 43 48 45 4d LOCKED or CACHEM
38220 4f 44 0a 20 20 20 20 20 20 2a 2a 20 77 68 65 6e OD. ** when
38230 20 69 74 20 68 61 73 20 61 6e 20 6f 70 65 6e 20 it has an open
38240 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 62 75 74 transaction, but
38250 20 6e 65 76 65 72 20 74 6f 20 44 42 4d 4f 44 20 never to DBMOD
38260 6f 72 20 46 49 4e 49 53 48 45 44 2e 0a 20 20 20 or FINISHED..
38270 20 20 20 2a 2a 20 54 68 69 73 20 69 73 20 62 65 ** This is be
38280 63 61 75 73 65 20 69 6e 20 74 68 6f 73 65 20 73 cause in those s
38290 74 61 74 65 73 20 74 68 65 20 63 6f 64 65 20 74 tates the code t
382a0 6f 20 72 6f 6c 6c 20 62 61 63 6b 20 73 61 76 65 o roll back save
382b0 70 6f 69 6e 74 20 0a 20 20 20 20 20 20 2a 2a 20 point . **
382c0 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 6d 61 79 transactions may
382d0 20 63 6f 70 79 20 64 61 74 61 20 66 72 6f 6d 20 copy data from
382e0 74 68 65 20 73 75 62 2d 6a 6f 75 72 6e 61 6c 20 the sub-journal
382f0 69 6e 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 into the databas
38300 65 20 0a 20 20 20 20 20 20 2a 2a 20 66 69 6c 65 e . ** file
38310 20 61 73 20 77 65 6c 6c 20 61 73 20 69 6e 74 6f as well as into
38320 20 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e the page cache.
38330 20 57 68 69 63 68 20 77 6f 75 6c 64 20 62 65 20 Which would be
38340 69 6e 63 6f 72 72 65 63 74 20 69 6e 20 0a 20 20 incorrect in .
38350 20 20 20 20 2a 2a 20 57 41 4c 20 6d 6f 64 65 2e ** WAL mode.
38360 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
38370 70 50 61 67 65 72 2d 3e 65 53 74 61 74 65 20 3d pPager->eState =
38380 20 50 41 47 45 52 5f 57 52 49 54 45 52 5f 4c 4f PAGER_WRITER_LO
38390 43 4b 45 44 3b 0a 20 20 20 20 20 20 70 50 61 67 CKED;. pPag
383a0 65 72 2d 3e 64 62 48 69 6e 74 53 69 7a 65 20 3d er->dbHintSize =
383b0 20 70 50 61 67 65 72 2d 3e 64 62 53 69 7a 65 3b pPager->dbSize;
383c0 0a 20 20 20 20 20 20 70 50 61 67 65 72 2d 3e 64 . pPager->d
383d0 62 46 69 6c 65 53 69 7a 65 20 3d 20 70 50 61 67 bFileSize = pPag
383e0 65 72 2d 3e 64 62 53 69 7a 65 3b 0a 20 20 20 20 er->dbSize;.
383f0 20 20 70 50 61 67 65 72 2d 3e 64 62 4f 72 69 67 pPager->dbOrig
38400 53 69 7a 65 20 3d 20 70 50 61 67 65 72 2d 3e 64 Size = pPager->d
38410 62 53 69 7a 65 3b 0a 20 20 20 20 20 20 70 50 61 bSize;. pPa
38420 67 65 72 2d 3e 6a 6f 75 72 6e 61 6c 4f 66 66 20 ger->journalOff
38430 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 = 0;. }..
38440 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 assert( rc==SQLI
38450 54 45 5f 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d TE_OK || pPager-
38460 3e 65 53 74 61 74 65 3d 3d 50 41 47 45 52 5f 52 >eState==PAGER_R
38470 45 41 44 45 52 20 29 3b 0a 20 20 20 20 61 73 73 EADER );. ass
38480 65 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f ert( rc!=SQLITE_
38490 4f 4b 20 7c 7c 20 70 50 61 67 65 72 2d 3e 65 53 OK || pPager->eS
384a0 74 61 74 65 3d 3d 50 41 47 45 52 5f 57 52 49 54 tate==PAGER_WRIT
384b0 45 52 5f 4c 4f 43 4b 45 44 20 29 3b 0a 20 20 20 ER_LOCKED );.
384c0 20 61 73 73 65 72 74 28 20 61 73 73 65 72 74 5f assert( assert_
384d0 70 61 67 65 72 5f 73 74 61 74 65 28 70 50 61 67 pager_state(pPag
384e0 65 72 29 20 29 3b 0a 20 20 7d 0a 0a 20 20 50 41 er) );. }.. PA
384f0 47 45 52 54 52 41 43 45 28 28 22 54 52 41 4e 53 GERTRACE(("TRANS
38500 41 43 54 49 4f 4e 20 25 64 5c 6e 22 2c 20 50 41 ACTION %d\n", PA
38510 47 45 52 49 44 28 70 50 61 67 65 72 29 29 29 3b GERID(pPager)));
38520 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
38530 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 70 61 67 ./*.** Write pag
38540 65 20 70 50 67 20 6f 6e 74 6f 20 74 68 65 20 65 e pPg onto the e
38550 6e 64 20 6f 66 20 74 68 65 20 72 6f 6c 6c 62 61 nd of the rollba
38560 63 6b 20 6a 6f 75 72 6e 61 6c 2e 0a 2a 2f 0a 73 ck journal..*/.s
38570 74 61 74 69 63 20 53 51 4c 49 54 45 5f 4e 4f 49 tatic SQLITE_NOI
38580 4e 4c 49 4e 45 20 69 6e 74 20 70 61 67 65 72 41 NLINE int pagerA
38590 64 64 50 61 67 65 54 6f 52 6f 6c 6c 62 61 63 6b ddPageToRollback
385a0 4a 6f 75 72 6e 61 6c 28 50 67 48 64 72 20 2a 70 Journal(PgHdr *p
385b0 50 67 29 7b 0a 20 20 50 61 67 65 72 20 2a 70 50 Pg){. Pager *pP
385c0 61 67 65 72 20 3d 20 70 50 67 2d 3e 70 50 61 67 ager = pPg->pPag
385d0 65 72 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 er;. int rc;.
385e0 75 33 32 20 63 6b 73 75 6d 3b 0a 20 20 63 68 61 u32 cksum;. cha
385f0 72 20 2a 70 44 61 74 61 32 3b 0a 20 20 69 36 34 r *pData2;. i64
38600 20 69 4f 66 66 20 3d 20 70 50 61 67 65 72 2d 3e iOff = pPager->
38610 6a 6f 75 72 6e 61 6c 4f 66 66 3b 0a 0a 20 20 2f journalOff;.. /
38620 2a 20 57 65 20 73 68 6f 75 6c 64 20 6e 65 76 65 * We should neve
38630 72 20 77 72 69 74 65 20 74 6f 20 74 68 65 20 6a r write to the j
38640 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 68 65 20 ournal file the
38650 70 61 67 65 20 74 68 61 74 0a 20 20 2a 2a 20 63 page that. ** c
38660 6f 6e 74 61 69 6e 73 20 74 68 65 20 64 61 74 61 ontains the data
38670 62 61 73 65 20 6c 6f 63 6b 73 2e 20 20 54 68 65 base locks. The
38680 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 65 72 following asser
38690 74 20 76 65 72 69 66 69 65 73 0a 20 20 2a 2a 20 t verifies. **
386a0 74 68 61 74 20 77 65 20 64 6f 20 6e 6f 74 2e 20 that we do not.
386b0 2a 2f